paperclipai/paperclip · error

Runtime service "${identity.serviceName}" is missing command

Error message

Runtime service "${identity.serviceName}" is missing command

What it means

The runtime provision path resolved a service identity but the service definition carries no command to execute. Same missing-command guard as spawn, hit on the provision-coordinator reuse path when runtimeProvisionCommand is set.

Source

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

): Promise<RuntimeServiceRecord | null> {
  const runtimeProvisionCommand = asString(input.runtimeProvisionCommand, "").trim();
  if (!runtimeProvisionCommand) return null;
  const coordinator = input.provisionCoordinator ?? createRuntimeProvisionCoordinator();
  if (coordinator.promise) {
    await coordinator.promise;
    return null;
  }

  const identity = resolveRuntimeServiceReuseIdentity({
    service: input.service,
    workspace: input.workspace,
    agent: input.agent,
    issue: input.issue,
    adapterEnv: input.adapterEnv,
    scopeType: input.scopeType,
    scopeId: input.scopeId,
  });
  if (!identity.command) throw new Error(`Runtime service "${identity.serviceName}" is missing command`);
  const provisioningRecord = createProvisioningRuntimeServiceRecord(input, identity);
  await persistRuntimeServiceRecord(input.db, provisioningRecord);
  if (input.onLog) {
    await input.onLog(
      "stdout",
      `[service:${identity.serviceName}] provisioning runtime dependencies...\n`,
    );
  }

  try {
    coordinator.promise = runRuntimeProvisionWithWorkspaceMutex(input);
    await coordinator.promise;
    provisioningRecord.status = "starting";
    provisioningRecord.lastUsedAt = new Date().toISOString();
    await persistRuntimeServiceRecord(input.db, provisioningRecord);
    return provisioningRecord;
  } catch (error) {
    const nowIso = new Date().toISOString();

View on GitHub (pinned to a7e689b3c3)

Solutions

1. Add a command for the runtime service in its configuration before starting it.
2. Remove the service entry if it is not meant to run.

When it happens

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