{"record":{"id":"a99b1775476f1727","repo":"stablyai/orca","slug":"incompatible-runtime-a99b17","errorCode":"incompatible_runtime","errorMessage":"The connected Orca runtime does not support worker model or effort overrides. Update or restart Orca and try again.","messagePattern":"The connected Orca runtime does not support worker model or effort overrides\\. Update or restart Orca and try again\\.","errorType":"exception","errorClass":"RuntimeClientError","httpStatus":null,"severity":"error","filePath":"src/cli/handlers/orchestration.ts","lineNumber":863,"sourceCode":"        result: getOptionalStringFlag(flags, 'result'),\n        run: getOptionalStringFlag(flags, 'run'),\n        callerTerminalHandle: await resolveCoordinatorTerminalHandle(flags, cwd, client)\n      }\n    )\n    printResult(result, json, (r) => `Updated ${r.task.id} -> ${r.task.status}`)\n  },\n\n  'orchestration worker-start': async ({ flags, client, cwd, json }) => {\n    const model = getOptionalStringFlag(flags, 'model')\n    const effort = getOptionalStringFlag(flags, 'effort')\n    if (model || effort) {\n      const status = await client.call<RuntimeStatus>('status.get')\n      if (\n        !status.result.capabilities?.includes(\n          ORCHESTRATION_WORKER_LAUNCH_PREFERENCES_RUNTIME_CAPABILITY\n        )\n      ) {\n        throw new RuntimeClientError(\n          'incompatible_runtime',\n          'The connected Orca runtime does not support worker model or effort overrides. Update or restart Orca and try again.'\n        )\n      }\n    }\n    const result = await callMutation<{\n      runId: string\n      taskId: string\n      dispatchId: string\n      state: string\n      failedStage?: string\n      lastError?: string\n      warning?: string\n      effects: unknown[]\n      residualResources: unknown[]\n    }>(client, flags, 'orchestration.workerStart', {\n      task: getRequiredStringFlag(flags, 'task'),\n      on: getOptionalStringFlag(flags, 'on'),","sourceCodeStart":845,"sourceCodeEnd":881,"githubUrl":"https://github.com/stablyai/orca/blob/1136503c6a231a16dce8f921f6fadb63d181e8db/src/cli/handlers/orchestration.ts#L845-L881","documentation":"Thrown in 'orchestration worker-start' (line 863) when --model or --effort is passed but the connected runtime does not advertise the ORCHESTRATION_WORKER_LAUNCH_PREFERENCES_RUNTIME_CAPABILITY in its status.get capabilities list (lines 856-862). This is a capability negotiation failure: the worker-launch-preferences feature is newer than the runtime, so the CLI refuses to send overrides the runtime would silently ignore or misinterpret.","triggerScenarios":"Calling 'orchestration worker-start --model <m>' or '--effort <e>' against a runtime whose status.get response lacks the worker-launch-preferences capability string. Checked via client.call('status.get') then capabilities?.includes(...).","commonSituations":"Client newer than the runtime after a partial upgrade; connecting to an older remote Orca server; runtime restarted with an older binary still in PATH; side-loaded runtime without the feature flag.","solutions":["Update or restart Orca to a runtime version that supports worker model/effort overrides.","Drop --model and --effort to launch the worker with the runtime's defaults until you upgrade.","Verify the capability with 'orca status' (or status.get) and confirm ORCHESTRATION_WORKER_LAUNCH_PREFERENCES_RUNTIME_CAPABILITY is listed."],"exampleFix":"// before\norca orchestration worker-start --task t1 --model gpt-x   (runtime lacks capability)\n// after\norca orchestration worker-start --task t1   # use runtime defaults until upgraded","handlingStrategy":"fallback","validationCode":"const status = await client.call('status.get')\nconst supportsPrefs = status.result.capabilities?.includes(ORCHESTRATION_WORKER_LAUNCH_PREFERENCES_RUNTIME_CAPABILITY)\nif ((model || effort) && !supportsPrefs) {\n  // drop --model/--effort or abort with a clear message before worker-start\n}","typeGuard":"function runtimeSupportsWorkerLaunchPrefs(status: { result: { capabilities?: string[] } }): boolean {\n  return !!status.result.capabilities?.includes(ORCHESTRATION_WORKER_LAUNCH_PREFERENCES_RUNTIME_CAPABILITY)\n}","tryCatchPattern":"try {\n  await runWorkerStart(['--model', m])\n} catch (err) {\n  if (err instanceof RuntimeClientError && err.code === 'incompatible_runtime') {\n    // retry worker-start without --model/--effort using runtime defaults\n  } else { throw err }\n}","preventionTips":["Keep client and runtime versions aligned.","Gate --model/--effort behind a capability check when targeting mixed runtimes.","Run 'orca status' after upgrades to confirm capabilities are advertised."],"tags":["cli","orchestration","runtime-compat","version","capability","worker"],"backgroundTag":null,"analyzedSha":"1136503c6a231a16dce8f921f6fadb63d181e8db","analyzedAt":"2026-08-12T23:15:58.167Z","schemaVersion":2},"datasetVersion":"2026-08-12T23:17:12.415Z"}