@awak-app/simy-cli 0.5.21 → 0.5.22

package/README.md

@@ -32,8 +32,8 @@ simy --daemon
 ```
 
 When an interactive `simy --daemon` starts without managed SIMY workflows,
-the CLI asks once before installing the Codex plugin
-marketplace and Codex/Claude opt-in SQM skills. Existing unrelated plugins
+the CLI asks once before installing the Codex and Claude Code plugin
+sources and Codex/Claude opt-in SQM skills. Existing unrelated plugins
 and hooks are preserved. Use `--install-workflows` for explicit non-interactive
 installation or `--no-workflow-prompt` to start the daemon without asking.
 
@@ -49,10 +49,24 @@ period in each Codex session, then rearms after the CLI reconnects. The hook doe
 not start or install the CLI, read session tokens, enable SQM, or send email.
 Review and enable the plugin hooks through Codex's `/hooks` command.
 
+For Claude Code, register the generated local marketplace and explicitly enable SIMY:
+
+```sh
+claude plugin marketplace add ~/.simy/integrations/claude-marketplace
+claude plugin install simy@simy-local
+```
+
+Use `/simy:sqm-loop` or `/simy:pr-review` in Claude Code. The workflows are generated
+from the same maintained source as Codex; only provider terminology and hook/manifest
+format differ. Installing source files does not imply that either provider has enabled
+the plugin. Existing Claude settings, unrelated marketplaces, and plugins are preserved.
+
 After that first installation, the daemon checks installed workflows at startup
 and every hour, including after a CLI automatic upgrade. It updates only existing
 platform installations and refreshes an already enabled SIMY Codex plugin through
-`codex plugin add`. Plugin versions include a content digest so changed bundles
+`codex plugin add`. Enabled user-scope Claude plugins are refreshed with
+`claude plugin update simy@simy-local --scope user`, after verifying that the
+marketplace still points to SIMY’s generated local source. Plugin versions include a content digest so changed bundles
 receive a fresh cache. Use a new Codex task to pick up updated skills; running
 tasks are not restarted. Missing or disabled plugins are not enabled automatically.
 Failed refreshes retry on the next check without blocking daemon startup.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@awak-app/simy-cli",
-  "version": "0.5.21",
+  "version": "0.5.22",
   "description": "Local SIMY executor for non-coding Local Tasks and Agentic Loop runs.",
   "type": "module",
   "bin": {
@@ -39,13 +39,15 @@
     "check": "npm run check:auto-update && node --check ./src/desktop-executor.js && node --check ./src/local-task.js && node --check ./scripts/desktop-executor-e2e.js && node --check ./scripts/pre-guardrail-e2e.js && node --check ./scripts/fixtures/fake-desktop-provider.js && npm run check:syntax && npm run check:real-provider-syntax && npm test && npm run check:package",
     "check:auto-update": "node --check ./src/auto-update.js && node --check ./scripts/auto-update-e2e.js && npm run check:sqm",
     "check:sqm": "node --check ./src/sqm/canonical.js && node --check ./src/sqm/validation.js && node --check ./src/sqm/reliability.js && node --check ./src/sqm/repository.js && node --check ./src/sqm/checkers.js && node --check ./src/sqm/bundle-store.js && node --check ./src/sqm/proof.js && node --check ./src/sqm/evidence-client.js && node --check ./src/sqm/session.js && node --check ./src/sqm/index.js && node --check ./src/sqm/command.js && node --check ./src/sqm/agent-skill.js && node --check ./src/sqm/workflow-onboarding.js && node --check ./src/sqm/workflow-update.js && node --check ./src/sqm/review-worker.js && node --check ./scripts/sqm-complete-loop-e2e.js && node --check ./scripts/sqm-local-review-e2e.js",
-    "check:real-provider-syntax": "node --check ./scripts/real-codex-probe.js && node --check ./scripts/real-claude-probe.js && node --check ./scripts/real-provider-console-fixture.js && node --check ./scripts/real-provider-console-e2e.js",
+    "check:real-provider-syntax": "node --check ./scripts/real-codex-probe.js && node --check ./scripts/real-claude-probe.js && node --check ./scripts/real-provider-console-fixture.js && node --check ./scripts/real-provider-console-e2e.js && node --check ./scripts/claude-parity-runtime-e2e.js && node --check ./scripts/claude-plugin-runtime-e2e.js",
     "check:syntax": "node --check ./src/index.js && node --check ./src/install-update.js && node --check ./src/agent.js && node --check ./src/connection-discovery.js && node --check ./src/codex-plugins/simy/hooks/connection-reminder.mjs && node --check ./src/browser.js && node --check ./src/web-api.js && node --check ./src/durable-local-task-worker.js && node --check ./src/durable-local-task-steps-contract.js && node --check ./src/bounded-local-task-subtasks-contract.js && node --check ./src/bounded-local-task-subtask-pool.js && node --check ./src/local-task-artifact-contract.js && node --check ./src/execution-capability-contract.js && node --check ./src/shutdown.js && node --check ./src/run-registry.js && node --check ./src/direct-executor.js && node --check ./src/execution-guardrail.js && node --check ./src/backend-executable.js && node --check ./src/provider-stream.js && node --check ./src/console/index.js && node --check ./src/console/app.js && node --check ./src/console/commands.js && node --check ./src/local-attachments.js && node --check ./src/repository-inventory.js && node --check ./src/session-store.js && node --check ./src/web-origin.js && node --check ./src/workspace-context.js && node --check ./src/orchestrator/index.js && node --check ./src/orchestrator/shared.js && node --check ./src/orchestrator/recovery.js && node --check ./src/orchestrator/risk.js && node --check ./src/orchestrator/contract.js && node --check ./src/orchestrator/completion-contract.js && node --check ./src/orchestrator/pr-preparation.js && node --check ./src/orchestrator/minimum-completion.js && node --check ./src/orchestrator/delivery/scripts/check-minimum-completion.mjs && node --check ./src/orchestrator/instruction.js && node --check ./src/orchestrator/problem-solving.js && node --check ./src/orchestrator/budget.js && node --check ./src/orchestrator/execution-io.js && node --check ./src/orchestrator/presentation.js && node --check ./src/orchestrator/result.js && node --check ./src/orchestrator/retry.js && node --check ./src/orchestrator/evidence.js && node --check ./src/orchestrator/independent-audit.js && node --check ./src/orchestrator/audit.js && node --check ./src/orchestrator/loop.js && node --check ./src/runner.js && node --check ./scripts/fixtures/completion-contract-fixture.js && node --check ./scripts/fixtures/fake-coding-backend.js && node --check ./scripts/e2e-terminal-evidence.js && node --check ./scripts/audit-gate-e2e.js && node --check ./scripts/completion-contract-e2e.js && node --check ./scripts/retry-circuit-e2e.js && node --check ./scripts/follow-up-charter-e2e.js && node --check ./scripts/task-routing-e2e.js && node --check ./scripts/executor-version-preflight-e2e.js && node --check ./scripts/blocked-recovery-e2e.js && node --check ./scripts/process-localization-e2e.js && node --check ./scripts/hypothesis-retries-e2e.js && node --check ./scripts/budget-enforcement-e2e.js && node --check ./scripts/local-task-default-workspace-e2e.js && node --check ./scripts/local-task-idempotency-e2e.js && node --check ./scripts/console-e2e-fixture.js && node --check ./scripts/console-e2e.js && node --check ./scripts/console-recovery-e2e-fixture.js && node --check ./scripts/console-recovery-e2e.js && node --check ./scripts/real-provider-console-fixture.js && node --check ./scripts/real-provider-console-e2e.js && node --check ./scripts/fullstack-cli-smoke.js && node --check ./scripts/check-package-contents.js",
     "check:package": "node ./scripts/check-package-contents.js",
     "build:macos-installer:dev": "bash packaging/build-macos-arm64.sh --unsigned-dev",
     "build:macos-installer": "bash packaging/build-macos-arm64.sh --production",
     "test:macos-installer": "node --test packaging/test-macos-packaging.mjs",
-    "build:macos-installer:production": "bash packaging/build-macos-arm64.sh --production"
+    "build:macos-installer:production": "bash packaging/build-macos-arm64.sh --production",
+    "test:e2e:claude-parity": "node ./scripts/claude-parity-runtime-e2e.js",
+    "test:e2e:claude-plugin": "node ./scripts/claude-plugin-runtime-e2e.js"
   },
   "engines": {
     "node": ">=20"

package/src/agent.js

@@ -50,6 +50,7 @@ import {
 } from "./desktop-executor.js";
 import {
   createCodexStatusInspector,
+  createProviderStatusInspector,
   createConnectionStatusTracker,
   desktopAuthStatus,
   desktopTaskStatus,
@@ -187,46 +188,11 @@ export async function startAgent({
       : [],
   );
   const installMode = updateManager?.snapshot?.()?.install_mode ?? null;
-  const inspectedCapabilities = await readCapabilities(dependencies);
-  const durableControlPlane =
-    inspectedCapabilities?.features?.local_task_control_plane === true;
-  const hasSqmLocalReview = Object.hasOwn(
-    inspectedCapabilities?.features || {},
-    "sqm_local_review",
-  );
-  const contractSourceCapabilities =
-    durableControlPlane || hasSqmLocalReview
-      ? {
-          ...inspectedCapabilities,
-          features: {
-            ...inspectedCapabilities?.features,
-            ...(durableControlPlane
-              ? {
-                  local_task_control_plane: daemon,
-                  pipeline_local_task_artifacts:
-                    daemon &&
-                    inspectedCapabilities.features.pipeline_local_task_artifacts === true,
-                  durable_local_task_attachments: daemon,
-                  durable_local_task_steps:
-                    daemon &&
-                    inspectedCapabilities.features.durable_local_task_steps === true,
-                  bounded_local_task_subtasks:
-                    daemon &&
-                    inspectedCapabilities.features.bounded_local_task_subtasks === true,
-                }
-              : {}),
-            ...(hasSqmLocalReview
-              ? {
-                  sqm_local_review:
-                    daemon && inspectedCapabilities?.features?.sqm_local_review === true,
-                }
-              : {}),
-          },
-        }
-      : inspectedCapabilities;
+  let contractSourceCapabilities = daemonCapabilities(await readCapabilities(dependencies), daemon);
   let availableCapabilities;
+  let providerStatuses = { codex: { state: "unknown" }, claude: { state: "unknown" } };
   const refreshAvailableCapabilities = () => {
-    availableCapabilities = withCliContract(contractSourceCapabilities, installMode, {
+    availableCapabilities = withCliContract({ ...contractSourceCapabilities, ...(providerStatuses ? { provider_statuses: providerStatuses } : {}) }, installMode, {
       authenticated:
         isSessionValid(session, Date.now(), apiOrigin) && Boolean(session?.device_id),
     });
@@ -255,6 +221,46 @@ export async function startAgent({
     now: dependencies.statusNowMs,
   });
 
+  const claudeStatus = createProviderStatusInspector("claude", {
+    inspect: dependencies.inspectClaudeStatus,
+    now: dependencies.statusNowMs,
+  });
+
+  const readProviderStatuses = async ({ force = false } = {}) => {
+    const [codex, claude] = await Promise.all([codexStatus({ force }), claudeStatus({ force })]);
+    const binaryStateChanged = ["codex", "claude"].some((provider) => {
+      const next = provider === "codex" ? codex : claude;
+      return providerStatuses[provider]?.version !== next.version ||
+        providerStatuses[provider]?.state !== next.state;
+    });
+    if (force || binaryStateChanged) {
+      contractSourceCapabilities = daemonCapabilities(await readCapabilities(dependencies), daemon);
+    }
+    providerStatuses = { codex, claude };
+    refreshAvailableCapabilities();
+    return providerStatuses;
+  };
+
+  const inspectReadyBackend = async (backend, options) => {
+    await readProviderStatuses(options);
+    const inspection = normalizeBackendInspection(backend, availableCapabilities);
+    if (inspection.compatible) {
+      const failure = providerAuthenticationFailure(backend, providerStatuses[backend]);
+      if (failure) throw Object.assign(new Error(failure.summary), failure);
+    }
+    return inspection;
+  };
+
+  const requireRunProvider = async (run) => {
+    const backend = run.request.backend;
+    const inspection = await inspectReadyBackend(backend, { force: true });
+    if (!inspection.compatible) {
+      throw Object.assign(new Error(backendPreflightSummary(backend, inspection)), {
+        code: `desktop_executor_${inspection.status}`,
+      });
+    }
+  };
+
   const requestDesktopLogin = () => {
     if (isSessionValid(session, Date.now(), apiOrigin)) return null;
     if (!loginUrl) {
@@ -300,6 +306,7 @@ export async function startAgent({
     if (heartbeatInFlight) return heartbeatInFlight;
     connectionStatus.attempt();
     let deviceHeartbeatSucceeded = false;
+    const advertisedProviders = JSON.stringify(providerStatuses);
     heartbeatInFlight = Promise.resolve()
       .then(() =>
         heartbeatDevice({
@@ -314,6 +321,13 @@ export async function startAgent({
       .then(async () => {
         deviceHeartbeatSucceeded = true;
         connectionStatus.success();
+        // Register the device immediately; provider subprocesses must not delay
+        // browser authorization. Publish verified readiness after their probe.
+        await readProviderStatuses();
+        if (JSON.stringify(providerStatuses) !== advertisedProviders) {
+          await heartbeatDevice({ apiOrigin, apiBaseUrl: session.api_base_url, token: session.token,
+            port, capabilities: refreshAvailableCapabilities(), repoInventory: repositoryInventory });
+        }
         const sqmResult = sqmLocalReviewWorker
           ? await sqmLocalReviewWorker.poll()
           : null;
@@ -429,7 +443,15 @@ export async function startAgent({
       storageRoot: taskStorageRoot,
       workspaceRoot: dependencies.localTaskWorkspaceRoot,
       resolveRepository: ensureRepositoryIndexed,
-      runLocalTask: dependencies.runLocalTask || startLocalTask,
+      runLocalTask: async (task, options) => {
+        const inspection = await inspectReadyBackend(task.backend);
+        if (!inspection.compatible) {
+          throw Object.assign(new Error(backendPreflightSummary(task.backend, inspection)), {
+            code: `desktop_executor_${inspection.status}`,
+          });
+        }
+        return (dependencies.runLocalTask || startLocalTask)(task, options);
+      },
       attachmentStore: localTaskAttachmentStore,
       getDeviceId: () => session?.device_id || null,
       beginWork: () => acquireUpdateWork(updateManager),
@@ -437,7 +459,7 @@ export async function startAgent({
     });
   }
 
-  if (daemon && availableCapabilities?.features?.sqm_local_review === true) {
+  if (daemon && Object.hasOwn(availableCapabilities?.features || {}, "sqm_local_review")) {
     const sqmApi =
       dependencies.sqmLocalReviewApi ||
       createSqmLocalReviewApi({
@@ -454,6 +476,10 @@ export async function startAgent({
       api: sqmApi,
       beginWork: () => acquireUpdateWork(updateManager),
       runReview: dependencies.runSqmLocalReview,
+      getProvider: () => ["codex", "claude"].find(
+        (provider) => availableCapabilities?.backends?.[provider] === true &&
+          providerStatuses[provider]?.state === "ready",
+      ) || null,
       onError: (error) => reportSqmLocalReviewError(error, quiet),
     });
   }
@@ -472,6 +498,7 @@ export async function startAgent({
       throw new Error(`This run requires ${run.request.repository}; select that local repository.`);
     }
     if (!run) return selected;
+    await requireRunProvider(run);
     return withUpdateWork(
       updateManager,
       () =>
@@ -659,6 +686,7 @@ export async function startAgent({
               ? body.local_path
               : indexedRepository?.local_path || null,
           dependencies,
+          providerStatus: (await readProviderStatuses())[backend],
         });
         json(res, 200, environment);
         return;
@@ -904,6 +932,7 @@ export async function startAgent({
           requestFingerprint = createLocalTaskRequestFingerprint({
             instruction,
             backend: body.backend,
+            model: body.model,
             operation: guardrail.operation,
             permissionMode: guardrail.permission_mode,
             workspaceMode,
@@ -965,7 +994,7 @@ export async function startAgent({
             json(res, 503, updateInProgressResponse(updateManager));
             return;
           }
-          const inspection = normalizeBackendInspection(body.backend, availableCapabilities);
+          const inspection = await inspectReadyBackend(body.backend);
           if (!inspection.compatible) {
             const summary = backendPreflightSummary(body.backend, inspection);
             json(res, 409, {
@@ -1020,6 +1049,7 @@ export async function startAgent({
             id: workspace.id,
             instruction,
             backend: body.backend,
+            model: body.model,
             operation: guardrail.operation,
             permissionMode: guardrail.permission_mode,
             workspaceMode,
@@ -1127,7 +1157,7 @@ export async function startAgent({
           });
           return;
         }
-        const inspection = normalizeBackendInspection(body.backend, availableCapabilities);
+        const inspection = await inspectReadyBackend(body.backend);
         if (!inspection.compatible) {
           const summary = backendPreflightSummary(body.backend, inspection);
           json(res, 409, {
@@ -1242,22 +1272,20 @@ export async function startAgent({
           json(res, 400, { error: "backend must be codex or claude" });
           return;
         }
-        if (body.execution_target != null) {
-          const inspection = normalizeBackendInspection(body.backend, availableCapabilities);
-          if (!inspection.compatible) {
-            const summary = backendPreflightSummary(body.backend, inspection);
-            json(res, 409, {
-              error: summary,
-              code: `desktop_executor_${inspection.status}`,
-              execution_target: executionTarget,
-              recovery: recoveryContractForPreflight({
-                key: "backend",
-                summary,
-                details: inspection,
-              }),
-            });
-            return;
-          }
+        const inspection = await inspectReadyBackend(body.backend);
+        if (!inspection.compatible) {
+          const summary = backendPreflightSummary(body.backend, inspection);
+          json(res, 409, {
+            error: summary,
+            code: `desktop_executor_${inspection.status}`,
+            execution_target: executionTarget,
+            recovery: recoveryContractForPreflight({
+              key: "backend",
+              summary,
+              details: inspection,
+            }),
+          });
+          return;
         }
         let stagedAttachments = [];
         try {
@@ -1359,6 +1387,7 @@ export async function startAgent({
             json(res, 503, updateInProgressResponse(updateManager));
             return;
           }
+          await requireRunProvider(run);
           resumeLocalCodingRun(run);
         } else {
           json(res, 400, { error: "action must be pause, resume, or stop" });
@@ -1393,6 +1422,7 @@ export async function startAgent({
           return;
         }
         const body = await readJson(req);
+        await requireRunProvider(run);
         let budget;
         try {
           budget = await increaseLocalCodingRunProviderTokenBudget(
@@ -1518,6 +1548,7 @@ export async function startAgent({
             return;
           }
 
+          await requireRunProvider(run);
           const continuation = continueLocalCodingRunAfterRepositoryApproval(
             run,
             { repository: selected.repository, localPath: selected.local_path },
@@ -1566,6 +1597,11 @@ export async function startAgent({
 
       json(res, 404, { error: "not found" });
     } catch (err) {
+      if (err?.code === "provider_login_required" || err?.code === "provider_status_unknown" ||
+          (typeof err?.code === "string" && err.code.startsWith("desktop_executor_"))) {
+        json(res, 409, { error: err.message, code: err.code, recovery: err.recovery });
+        return;
+      }
       if (err instanceof LocalTaskFileCapabilityError) {
         json(res, 400, localTaskFileErrorPayload(err));
         return;
@@ -1634,6 +1670,7 @@ export async function startAgent({
   });
   const getDesktopStatus = async () => {
     const auth = desktopAuthStatus(session, { webOrigin: apiOrigin });
+    const { codex, claude } = await readProviderStatuses();
     return {
       schemaVersion: 1,
       sampledAt: new Date().toISOString(),
@@ -1643,7 +1680,9 @@ export async function startAgent({
       connection: connectionStatus.snapshot({ authenticated: auth.state === "signed_in" }),
       tasks: desktopTaskStatus([registry, directRegistry, localTaskRegistry]),
       update: updateManager?.snapshot?.() ?? null,
-      codex: await codexStatus(),
+      codex,
+      claude,
+      providers: { codex, claude },
       loginUrl: auth.state === "signed_in" ? null : requestDesktopLogin(),
     };
   };
@@ -1670,6 +1709,7 @@ export async function startAgent({
       return getDesktopStatus();
     },
     refreshCodexStatus: () => codexStatus({ force: true }),
+    refreshProviderStatus: () => readProviderStatuses({ force: true }),
     workspace,
     repositoryScanRoot,
     get capabilities() {
@@ -1690,7 +1730,7 @@ export async function startAgent({
         const executionTarget = normalizeDesktopExecutionTarget(input.executionTarget);
         if (!requirement) throw new Error("Describe the coding task first.");
         if (!repository) throw new Error("Set a repository with /repo owner/name.");
-        if (availableCapabilities?.backends?.[backend] !== true) {
+        if (!(await inspectReadyBackend(backend)).compatible) {
           throw new Error(`${backend === "claude" ? "Claude Code" : "Codex"} is not available on PATH.`);
         }
         const indexedRepository = await ensureRepositoryIndexed(repository);
@@ -1730,12 +1770,21 @@ export async function startAgent({
         return run;
       }),
       continue: (run, guidance) =>
-        withUpdateWork(updateManager, () => continueLocalCodingRun(run, guidance, runOptions)),
+        withUpdateWork(updateManager, async () => {
+          await requireRunProvider(run);
+          return continueLocalCodingRun(run, guidance, runOptions);
+        }),
       applyDecision: (run, decision) =>
-        withUpdateWork(updateManager, () => applyLocalHumanDecision(run, decision, runOptions)),
+        withUpdateWork(updateManager, async () => {
+          await requireRunProvider(run);
+          return applyLocalHumanDecision(run, decision, runOptions);
+        }),
       queueGuidance: queueLocalCodingGuidance,
       pause: pauseLocalCodingRun,
-      resume: (run) => withUpdateWorkSync(updateManager, () => resumeLocalCodingRun(run)),
+      resume: (run) => withUpdateWork(updateManager, async () => {
+        await requireRunProvider(run);
+        return resumeLocalCodingRun(run);
+      }),
       stop: stopLocalCodingRun,
       recheck: (run) =>
         withUpdateWork(updateManager, () =>
@@ -1772,16 +1821,6 @@ async function withUpdateWork(updateManager, action) {
   }
 }
 
-function withUpdateWorkSync(updateManager, action) {
-  const release = acquireUpdateWork(updateManager);
-  if (!release) ensureAcceptingNewWork(updateManager);
-  try {
-    return action();
-  } finally {
-    release?.();
-  }
-}
-
 function updateInProgressResponse(updateManager) {
   return {
     error:
@@ -1983,15 +2022,17 @@ async function capabilities() {
       local_task_artifacts: true,
       local_task_streaming: true,
       local_task_idempotency: true,
+      local_task_model: true,
       local_task_reconciliation: true,
       local_task_control_plane: true,
       pipeline_local_task_artifacts: true,
       durable_local_task_attachments: true,
       durable_local_task_scenario_packs: true,
       durable_local_task_steps: true,
+      durable_local_task_step_model: true,
       bounded_local_task_subtasks: true,
       sqm_agent_skill_management: true,
-      sqm_local_review: codex.compatible,
+      sqm_local_review: codex.compatible || claude.compatible,
     },
     session_ttl_hours: 48,
   };
@@ -2007,6 +2048,7 @@ async function inspectCodingLoopEnvironment({
   executionTarget,
   localPath,
   dependencies,
+  providerStatus,
 }) {
   const checks = [
     {
@@ -2063,8 +2105,17 @@ async function inspectCodingLoopEnvironment({
         }),
   });
 
+  const authFailure = inspection.compatible ? providerAuthenticationFailure(backend, providerStatus) : null;
+  if (inspection.compatible) {
+    checks.push({
+      key: "provider_auth",
+      status: authFailure ? "failed" : "passed",
+      summary: authFailure?.summary || `${backend === "claude" ? "Claude Code" : "Codex"} is signed in.`,
+      ...(authFailure ? { recovery: authFailure.recovery } : {}),
+    });
+  }
   return {
-    ready: Boolean(repositoryPath && inspection.compatible),
+    ready: Boolean(repositoryPath && inspection.compatible && !authFailure),
     repository,
     backend,
     execution_target: executionTarget,
@@ -2332,3 +2383,61 @@ function multipartTooLargeError() {
     },
   );
 }
+
+function daemonCapabilities(inspectedCapabilities, daemon) {
+  const durableControlPlane =
+    inspectedCapabilities?.features?.local_task_control_plane === true;
+  const hasSqmLocalReview = Object.hasOwn(
+    inspectedCapabilities?.features || {},
+    "sqm_local_review",
+  );
+  return durableControlPlane || hasSqmLocalReview
+      ? {
+          ...inspectedCapabilities,
+          features: {
+            ...inspectedCapabilities?.features,
+            ...(durableControlPlane
+              ? {
+                  local_task_control_plane: daemon,
+                  pipeline_local_task_artifacts:
+                    daemon &&
+                    inspectedCapabilities.features.pipeline_local_task_artifacts === true,
+                  durable_local_task_attachments: daemon,
+                  durable_local_task_steps:
+                    daemon &&
+                    inspectedCapabilities.features.durable_local_task_steps === true,
+                  durable_local_task_step_model:
+                    daemon &&
+                    inspectedCapabilities.features.durable_local_task_step_model === true,
+                  bounded_local_task_subtasks:
+                    daemon &&
+                    inspectedCapabilities.features.bounded_local_task_subtasks === true,
+                }
+              : {}),
+            ...(hasSqmLocalReview
+              ? {
+                  sqm_local_review:
+                    daemon && inspectedCapabilities?.features?.sqm_local_review === true,
+                }
+              : {}),
+          },
+        }
+      : inspectedCapabilities;
+}
+
+function providerAuthenticationFailure(provider, status) {
+  if (status?.state === "ready") return null;
+  const label = provider === "claude" ? "Claude Code" : "Codex";
+  const loginRequired = status?.state === "signed_out";
+  const code = loginRequired ? "provider_login_required" : "provider_status_unknown";
+  const summary = loginRequired
+    ? `Sign in to ${label} before starting this task.`
+    : `SIMY could not confirm ${label} authentication. Refresh the connection status before starting this task.`;
+  return {
+    code, summary,
+    recovery: recoveryContractForPreflight({
+      key: "provider_auth", summary,
+      details: { provider, status: status?.state || "unknown" },
+    }),
+  };
+}

package/src/backend-executable.js

@@ -1,4 +1,6 @@
 import spawn from "cross-spawn";
+import os from "node:os";
+import path from "node:path";
 
 const MACOS_CODEX_BINARY = "/Applications/ChatGPT.app/Contents/Resources/codex";
 
@@ -22,7 +24,7 @@ export async function resolveBackendExecutable(backend, options = {}) {
 
 export async function inspectBackendExecutable(
   backend,
-  { spawnImpl = spawn, candidates = backendCandidates(backend), timeoutMs = 1_500 } = {},
+  { spawnImpl = spawn, candidates = backendCandidates(backend), timeoutMs = 5_000 } = {},
 ) {
   const policy = versionPolicy(backend);
   for (const candidate of [...new Set(candidates.filter(Boolean))]) {
@@ -65,14 +67,26 @@ export async function inspectBackendExecutable(
   };
 }
 
-export function backendCandidates(backend) {
+export function backendCandidates(backend, {
+  platform = process.platform,
+  environment = process.env,
+  home = os.homedir(),
+} = {}) {
   if (backend === "claude") {
-    return [process.env.SIMY_CLAUDE_BIN, "claude"];
+    const paths = platform === "win32" ? path.win32 : path.posix;
+    const userHome = platform === "win32" ? environment.USERPROFILE || home : home;
+    return [
+      environment.SIMY_CLAUDE_BIN,
+      "claude",
+      // Desktop launch environments may predate the installer's PATH update.
+      paths.join(userHome, ".local", "bin", platform === "win32" ? "claude.exe" : "claude"),
+      ...(platform === "darwin" ? ["/opt/homebrew/bin/claude", "/usr/local/bin/claude"] : []),
+    ];
   }
   return [
-    process.env.SIMY_CODEX_BIN,
+    environment.SIMY_CODEX_BIN,
     "codex",
-    ...(process.platform === "darwin" ? [MACOS_CODEX_BINARY] : []),
+    ...(platform === "darwin" ? [MACOS_CODEX_BINARY] : []),
   ];
 }
 

package/src/cli-contract.js

@@ -13,7 +13,7 @@ import {
 } from "./durable-local-task-steps-contract.js";
 import { buildExecutionCapabilityContract } from "./execution-capability-contract.js";
 
-export const CLI_VERSION = "0.5.21";
+export const CLI_VERSION = "0.5.22";
 export const CLI_API_CONTRACT_VERSION = 10;
 
 export function withCliContract(
@@ -43,6 +43,7 @@ export function withCliContract(
       installMode,
       backends: capabilities.backends,
       backendVersions: capabilities.backend_versions,
+      providerStatuses: capabilities.provider_statuses,
       authenticated,
     }),
     ...(installMode ? { install_mode: installMode } : {}),

package/src/codex-plugins/simy/hooks/connection-reminder.mjs

@@ -19,7 +19,7 @@ export async function runConnectionReminder({
 } = {}) {
   const explicitWebOrigin = resolveExplicitWebOrigin(env);
   const sessionRoot = env.SIMY_HOME?.trim() || join(homedir(), ".simy");
-  const pluginData = env.PLUGIN_DATA?.trim() || join(sessionRoot, "plugin-data", "simy");
+  const pluginData = env.PLUGIN_DATA?.trim() || env.CLAUDE_PLUGIN_DATA?.trim() || join(sessionRoot, "plugin-data", "simy");
   const sessionId = String(input.session_id || input.sessionId || env.CODEX_THREAD_ID || "unknown");
   const statePath = reminderStatePath(pluginData, explicitWebOrigin || "any-origin", sessionId);
   const connected = explicitWebOrigin

package/src/console/app.js

@@ -215,7 +215,7 @@ export function AgenticLoopConsole({ agent, onQuit = () => {} }) {
           setNotice("Executor paused.");
           break;
         case "resume":
-          agent.controls.resume(selectedRun);
+          await agent.controls.resume(selectedRun);
           setNotice("Executor resumed.");
           break;
         case "stop":