paperclipai/paperclip · error

Workspace job "${resolved.name}" is missing command

Error message

Workspace job "${resolved.name}" is missing command

What it means

resolveWorkspaceCommandExecution produced no command for the named workspace job. The job configuration for that name lacks a command entry, so there is nothing to execute for the control action.

Source

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

export async function runWorkspaceJobForControl(input: {
  actor: ExecutionWorkspaceAgentRef;
  issue: ExecutionWorkspaceIssueRef | null;
  workspace: RealizedExecutionWorkspace;
  command: Record<string, unknown>;
  adapterEnv?: Record<string, string>;
  recorder?: WorkspaceOperationRecorder | null;
  metadata?: Record<string, unknown> | null;
}) {
  const resolved = resolveWorkspaceCommandExecution({
    command: input.command,
    workspace: input.workspace,
    agent: input.actor,
    issue: input.issue,
    adapterEnv: input.adapterEnv ?? {},
  });
  if (!resolved.command) {
    throw new Error(`Workspace job "${resolved.name}" is missing command`);
  }

  await ensureServerWorkspaceLinksCurrent(resolved.cwd);
  return await recordWorkspaceCommandOperation(input.recorder, {
    phase: "workspace_provision",
    command: resolved.command,
    cwd: resolved.cwd,
    env: resolved.env,
    label: `Workspace job "${resolved.name}"`,
    metadata: {
      workspaceCommandKind: "job",
      workspaceCommandName: resolved.name,
      ...(input.metadata ?? {}),
    },
    successMessage: `Completed workspace job "${resolved.name}"\n`,
  });
}

View on GitHub (pinned to a7e689b3c3)

Solutions

1. Add a command to the workspace job definition for "${resolved.name}" in the workspace commands configuration.
2. Remove the job entry if it is not meant to run.

When it happens

Trigger: Thrown at server/src/services/workspace-runtime.ts:4542 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/404e4f60104eb675. Report an issue: GitHub.