@sagentlab/navarch-runtime 0.1.64 → 0.1.66

package/README.md

@@ -6,6 +6,11 @@ it. Plain Node/TypeScript, no Next.js coupling, and no shared app-code coupling
 — this directory is a self-contained package you can `npx` on any fresh
 machine.
 
+During a connected run, the runtime reports preparation, agent start, output
+activity, and completion checks to the control plane. Project members can see
+these phase updates in the task view. The activity signal contains no prompt
+or CLI output; the redacted transcript is uploaded when the run finishes.
+
 The machine operator selects **Claude Code**, **OpenAI Codex**, **Google
 Gemini CLI**, **OpenCode**, or an **Agent Client Protocol (ACP)** agent when connecting a worker. Any selected agent can
 run any unpinned project task; task eligibility depends on capabilities and

package/dist/adapters/opencode.cjs

@@ -36,11 +36,30 @@ async function runOpenCodeAdapter(options) {
         };
     }
     const env = { ...options.env };
+    // V2 resolves its workspace from PWD. spawn({ cwd }) alone leaves the
+    // supervisor's PWD in the inherited environment (often the home directory).
+    if (!options.dockerExec && options.cwd)
+        env.PWD = node_path_1.default.resolve(options.cwd);
     await prepareOpenCodeConfig(options.mcpConfigPath, env, Boolean(options.dockerExec));
+    // V2's default background service owns its own cwd, environment and MCP
+    // configuration. A client process's isolated config does not isolate that
+    // service. Probe help without starting a turn, so older in-process CLIs
+    // remain supported and upgrades are detected on the next session.
+    const runOptions = { ...options, env };
+    const probeOptions = { ...runOptions, timeoutMs: 10_000, onProcessStarted: undefined };
+    const help = options.dockerExec
+        ? await runViaDocker(probeOptions, ["run", "--help"])
+        : await runOnHost(probeOptions, ["run", "--help"]);
+    if (help.exitCode !== 0 || help.timedOut || help.killedByLeaseLoss) {
+        return { ...help, stderr: `OpenCode CLI capability check failed. ${help.stderr}` };
+    }
     const binaryKey = `${options.dockerExec ? "docker:" : ""}${options.bin ?? "opencode"}`;
     const defaultLogLevel = !hasArg(options.extraArgs, "--log-level");
     const logLevel = defaultLogLevel ? (openCodeLogLevels.get(binaryKey) ?? "ERROR") : null;
     const args = ["run", options.prompt];
+    if (/^\s*--standalone\b/m.test(help.stdout) && !hasArg(options.extraArgs, "--standalone")) {
+        args.push("--standalone");
+    }
     // Provider failures may only appear in logs, absent from assistant events.
     if (!hasArg(options.extraArgs, "--print-logs"))
         args.push("--print-logs");
@@ -57,7 +76,6 @@ async function runOpenCodeAdapter(options) {
         // use the model's own default.
         args.push("--model", options.reasoningEffort ? `${options.model}#${options.reasoningEffort}` : options.model);
     }
-    const runOptions = { ...options, env };
     const run = (runArgs) => runOptions.dockerExec ? runViaDocker(runOptions, runArgs) : runOnHost(runOptions, runArgs);
     let raw = await run(args);
     if (logLevel && raw.exitCode !== 0 && isLogLevelRejection(raw.stderr)) {

package/dist/api.cjs

@@ -141,6 +141,10 @@ class NavarchApiClient {
             throw new Error("heartbeatLease: empty response from control plane.");
         return result;
     }
+    /** Best-effort, lease-scoped activity signal for connected machines. */
+    async reportActivity(leaseId, phase) {
+        await this.request("POST", `/api/dispatch/${encodeURIComponent(leaseId)}/activity`, { phase }, { allowEmpty: true });
+    }
     /** schema-design.md §7 — `POST /api/dispatch/:leaseId/complete {status, report, evidence_urls, cost}`. */
     async completeLease(leaseId, req) {
         await this.request("POST", `/api/dispatch/${encodeURIComponent(leaseId)}/complete`, req, {

package/dist/prompt.cjs

@@ -4,6 +4,7 @@ exports.renderPrompt = renderPrompt;
 exports.renderGuidanceCorrectionPrompt = renderGuidanceCorrectionPrompt;
 exports.renderHostedCheckpointNote = renderHostedCheckpointNote;
 const CODE_GRAPH_GUIDANCE = "For JS/TS dependency inspection, the runtime provides `navarch-runtime code-graph --query <symbol-or-file> --mode search|callers|callees|impact --commit HEAD`. If the runtime is not on PATH, use its installed entry point; do not install another copy mid-task. Results describe committed source and include commit/freshness warnings; inspect current files for uncommitted changes and unresolved dependencies.";
+const PROCESS_GUIDANCE = "Process management: this host may run other agent sessions. Keep the PID or tool handle of each preview server you start and stop only that owned process. Never use broad process-name or command-line matching (pkill, killall) to clean up servers: the agent launcher carries the task prompt in its arguments and can match those patterns, terminating your own session. Use a different port when a port is occupied by a process you do not own. Keep scratch files in the current worktree; paths in previous transcripts belong to earlier sessions.";
 /**
  * Renders the four-layer context bundle (project-plan.md §3.8: steering docs,
  * task itself, task-type playbook, depends_on reports) into the single prompt
@@ -16,13 +17,14 @@ function renderPrompt(task, bundle) {
         const repositoryContext = bundle.repository
             ? `Repository: ${bundle.repository.full_name} (${bundle.repository.url})\nLocal checkout: this session's isolated git worktree (current working directory).`
             : null;
-        return [repositoryContext, bundle.task_context.trim(), CODE_GRAPH_GUIDANCE, bundle.retry_context?.trim()]
+        return [repositoryContext, PROCESS_GUIDANCE, bundle.task_context.trim(), CODE_GRAPH_GUIDANCE, bundle.retry_context?.trim()]
             .filter((section) => Boolean(section))
             .join("\n\n") + "\n";
     }
     const sections = [];
     sections.push(`# Task: ${task.summary}`);
     sections.push(`Type: ${task.task_type} | Repo: ${task.repo} | Environment: ${task.environment_scope}`);
+    sections.push(PROCESS_GUIDANCE);
     if (bundle.repository) {
         sections.push(`Repository URL: ${bundle.repository.url}\nLocal checkout: this session's isolated git worktree (current working directory).`);
     }

package/dist/session.cjs

@@ -395,6 +395,23 @@ async function runClaimedSession(deps, claimed, sessionId, lifecycle) {
     // session actually produced instead of zeroing it.
     let lastCompletion = null;
     let adapterStarted = false;
+    // Activity is metadata only: no prompt, model output, or secret-bearing CLI
+    // text crosses this path. Failures never affect lease ownership or delivery.
+    let activityPending = Promise.resolve();
+    let outputObservedAt = 0;
+    let outputReportedAt = 0;
+    let adapterRunning = false;
+    const reportActivity = (phase) => {
+        activityPending = activityPending.then(() => api.reportActivity(leaseId, phase)).catch((error) => {
+            log.warn(`activity update failed for ${leaseId}: ${(0, redact_cjs_1.redactText)(String(error), registry.list())}`);
+        });
+    };
+    const activityTimer = setInterval(() => {
+        if (adapterRunning && outputObservedAt > outputReportedAt && Date.now() - outputReportedAt >= 60_000) {
+            outputReportedAt = Date.now();
+            reportActivity("output");
+        }
+    }, 15_000);
     const heartbeatGuard = new lease_heartbeat_cjs_1.LeaseHeartbeatGuard(claimed.expires_at, () => {
         log.warn(`confirmed lease expired for ${leaseId} without renewal — killing session.`);
         leaseLost = true;
@@ -407,6 +424,7 @@ async function runClaimedSession(deps, claimed, sessionId, lifecycle) {
         abortForRuntimeShutdown();
     lifecycle.enteredMainSessionTry = true;
     try {
+        reportActivity("preparing");
         await gitWorktree.prepare();
         if (gitWorktree.hostedCheckpointRestoreFailure) {
             log.warn(`hosted checkpoint for ${leaseId} could not be restored: ` +
@@ -465,6 +483,8 @@ async function runClaimedSession(deps, claimed, sessionId, lifecycle) {
             nextPrompt = null;
             await node_fs_1.promises.writeFile(node_path_1.default.join(workDir, "prompt.md"), runPrompt, "utf8");
             adapterStarted = true;
+            adapterRunning = true;
+            reportActivity("running");
             const remainingRuntimeMs = maxRuntimeMs > 0
                 ? maxRuntimeMs - (node_perf_hooks_1.performance.now() - agentBudgetStartedAt)
                 : 0;
@@ -488,8 +508,10 @@ async function runClaimedSession(deps, claimed, sessionId, lifecycle) {
                     cwd: gitWorktree.worktreePath,
                     dockerExec: sandbox ? { containerName: sandbox.name, runner: sandbox_cjs_1.nodeCommandRunner } : undefined,
                     signal: activeAbortController.signal,
+                    onActivity: () => { outputObservedAt = Date.now(); },
                 }, task.idle_timeout_ms ?? config.sessionIdleTimeoutMs ?? 45 * 60_000, runtime === "opencode" ? config.opencodeStartupTimeoutMs : 0);
             activeAbortController = null;
+            adapterRunning = false;
             if (turnResult.timedOut || leaseLost)
                 await checkpointForRecovery(turnResult);
             if (turnResult.model) {
@@ -497,6 +519,7 @@ async function runClaimedSession(deps, claimed, sessionId, lifecycle) {
                 executionReport = { ...executionReport, model: turnResult.model };
             }
             attempts.push(turnResult);
+            reportActivity("finishing");
             const capacityLimit = (0, adapter_capacity_cjs_1.detectAdapterCapacityLimit)(turnResult);
             if (capacityLimit) {
                 await checkpointForRecovery(turnResult);
@@ -750,6 +773,7 @@ async function runClaimedSession(deps, claimed, sessionId, lifecycle) {
         deps.shutdownSignal?.removeEventListener("abort", abortForRuntimeShutdown);
         sessionClosing = true;
         clearInterval(heartbeatTimer);
+        clearInterval(activityTimer);
         heartbeatGuard.stop();
         activeAbortController?.abort();
         // Drain only an already-started filesystem update, never a stalled network

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@sagentlab/navarch-runtime",
-  "version": "0.1.64",
+  "version": "0.1.66",
   "description": "Navarch machine-side session manager: claims delivery tasks and runs them through local coding agents.",
   "type": "commonjs",
   "license": "MIT",