paperclipai/paperclip · error

Execution workspace not found before starting runtime servic

Error message

Execution workspace not found before starting runtime services

What it means

lockWorkspaceRuntimeStartParents took a FOR UPDATE lock on the execution workspace row referenced by executionWorkspaceId and found no row in this company. The workspace was deleted or belongs to another company before runtime services could start.

Source

Thrown at server/src/services/workspace-runtime.ts:7143

}

async function lockWorkspaceRuntimeStartParents(
  db: Db,
  input: StartRuntimeServicesForWorkspaceControlInput,
) {
  let allowFixedPortFallback = false;
  if (input.executionWorkspaceId) {
    const [lockedExecutionWorkspace] = await db
      .select({ id: executionWorkspaces.id, mode: executionWorkspaces.mode })
      .from(executionWorkspaces)
      .where(
        and(
          eq(executionWorkspaces.id, input.executionWorkspaceId),
          eq(executionWorkspaces.companyId, input.actor.companyId),
        ),
      )
      .for("update");
    if (!lockedExecutionWorkspace) throw new Error("Execution workspace not found before starting runtime services");
    allowFixedPortFallback = lockedExecutionWorkspace.mode === "isolated_workspace";
  }

  if (input.workspace.workspaceId) {
    const [lockedProjectWorkspace] = await db
      .select({ id: projectWorkspaces.id })
      .from(projectWorkspaces)
      .where(
        and(
          eq(projectWorkspaces.id, input.workspace.workspaceId),
          eq(projectWorkspaces.companyId, input.actor.companyId),
        ),
      )
      .for("update");
    if (!lockedProjectWorkspace) throw new Error("Project workspace not found before starting runtime services");
  }

  return allowFixedPortFallback;

View on GitHub (pinned to a7e689b3c3)

Solutions

1. Ensure the execution workspace exists before starting runtime services; create or re-link it, then retry.
2. Check that the workspace id being referenced is still valid and not deleted.

When it happens

Trigger: Thrown at server/src/services/workspace-runtime.ts:6505 when the library encounters an invalid state.

Common situations: See trigger scenarios.

AI-assisted analysis of paperclipai/paperclip@a7e689b3c3 (2026-08-18). Data as JSON: /api/errors/c71da8114c073303. Report an issue: GitHub.