wavetermdev/waveterm · error

error creating block

Error message

error creating block: %w

What it means

This wraps failures from createBlockObj, which persists the new Block object under the given tab in a store transaction. The %w-wrapped inner error carries the actual reason (tab missing, DB failure, etc.).

Solutions

1. Read the wrapped inner error for the root cause
2. Verify tabId refers to an existing tab (re-fetch if the UI may have closed it)
3. Retry after fixing DB-level issues (locks, disk space)

tab, _ := wstore.DBGet[*waveobj.Tab](ctx, tabId)
if tab == nil { return errors.New("tab missing, aborting block creation") }

block, err := wcore.CreateBlock(ctx, tabId, blockDef, rtOpts)
if err != nil {
    if strings.Contains(err.Error(), "error creating block") {
        // unwrap/log inner cause, optionally retry
    }
}

When it happens

Trigger: CreateBlockWithTelemetry called with valid blockDef but createBlockObj fails: nonexistent tabId, database/transaction error, or invalid runtime options.

Common situations: Creating a block against a tab that was just closed; SQLite lock or corruption; invalid RtOpts values rejected during persistence.

Related errors

• error creating sub block
• error getting tab blocks
• error updating object
• parent block not found
• blockDef is nil

AI-assisted analysis of wavetermdev/waveterm@a4447c1563 (2026-09-01). Data as JSON: /api/errors/d23b3f2c9d9bb924. Report an issue: GitHub.

Appendix: source

Thrown at pkg/wcore/block.go:86

	defer func() {
		if rtnErr == nil {
			return
		}
		// if there was an error, and we created the block, clean it up since the function failed
		if blockCreated && newBlockOID != "" {
			deleteBlockObj(ctx, newBlockOID)
			filestore.WFS.DeleteZone(ctx, newBlockOID)
		}
	}()
	if blockDef == nil {
		return nil, fmt.Errorf("blockDef is nil")
	}
	if blockDef.Meta == nil || blockDef.Meta.GetString(waveobj.MetaKey_View, "") == "" {
		return nil, fmt.Errorf("no view provided for new block")
	}
	blockData, err := createBlockObj(ctx, tabId, blockDef, rtOpts)
	if err != nil {
		return nil, fmt.Errorf("error creating block: %w", err)
	}
	blockCreated = true
	newBlockOID = blockData.OID
	// upload the files if present
	if len(blockDef.Files) > 0 {
		for fileName, fileDef := range blockDef.Files {
			err := filestore.WFS.MakeFile(ctx, newBlockOID, fileName, fileDef.Meta, wshrpc.FileOpts{})
			if err != nil {
				return nil, fmt.Errorf("error making blockfile %q: %w", fileName, err)
			}
			err = filestore.WFS.WriteFile(ctx, newBlockOID, fileName, []byte(fileDef.Content))
			if err != nil {
				return nil, fmt.Errorf("error writing blockfile %q: %w", fileName, err)
			}
		}
	}
	if recordTelemetry {
		blockView := blockDef.Meta.GetString(waveobj.MetaKey_View, "")

View on GitHub (pinned to a4447c1563)