@proagentstore/cli 0.4.102 → 0.4.104

package/dist/browser-runner/coding/headless.js

@@ -1,3 +1,4 @@
+import { runObjectiveBlock } from "./run-objective.js";
 import { spawn } from "node:child_process";
 import { classifyCommand, commandFromToolInput, fillTargetFromResult, toolCallOk, toolResultMark } from "./engine-acts.js";
 import { parseEngineUsage } from "./engine-usage.js";
@@ -521,6 +522,10 @@ export class HeadlessSession {
             this.push("[pags] this engine keeps no memory between turns, so ProAgentStore's record of the conversation so far was delivered with this turn — a reconstruction, not the engine's own memory");
         else if (seed)
             this.push("[pags] a context brief from ProAgentStore's record was delivered with this turn — a reconstruction, not the previous conversation");
+        // The run's objective (#1019): to the ENGINE in full, the pane a one-line marker (same budget as the brief).
+        const objective = opts.objective ? runObjectiveBlock(opts.objective) : null;
+        if (opts.objective)
+            this.push(`[pags] the run's objective (${opts.objective.text.length} characters, verbatim) was delivered with this turn`);
         this.push(`\n❯ [${stamp()}] ${authorTag(opts.author)}${text}`); // ❯ — your turn, timestamped
         this.run = "thinking";
         const now = Date.now();
@@ -531,7 +536,8 @@ export class HeadlessSession {
         try {
             // Brief first, instruction second, and never the other way round: it is background for
             // the request, and an engine that reads the request last acts on the request.
-            const withSeed = seed ? `${seed}\n\n${sent}` : sent;
+            // The objective sits between them: background like the brief, and above the instruction it frames.
+            const withSeed = [seed, objective, sent].filter(Boolean).join("\n\n");
             if (this.adapter.persistent) {
                 // `role` stays "user" — the only role this protocol accepts, which is why the
                 // disambiguation rides in the text instead (#505).

package/dist/browser-runner/coding/run-objective.js

@@ -0,0 +1,18 @@
+// The run's objective, delivered verbatim with a turn and attributed to the platform (#1019).
+/** A run objective as the cloud sent it, or undefined — narrowed, because any caller can POST here (#1019). */
+export function runObjective(raw) {
+    const o = raw;
+    return o && typeof o.runId === "string" && o.runId.length <= 128 && typeof o.text === "string" && o.text.trim() ? { runId: o.runId, text: o.text } : undefined;
+}
+/**
+ * The run's objective as the engine reads it (#1019): verbatim, fenced, and attributed to the platform —
+ * the Pilot's instruction that follows is its own turn, and owner directives sent later outrank both.
+ */
+export function runObjectiveBlock(o) {
+    return [
+        `[pags] RUN OBJECTIVE — the owner's objective for run ${o.runId}, exactly as ProAgentStore accepted it. It was not written by the Pilot. Owner instructions sent later in this run take precedence over it.`,
+        "<<<OBJECTIVE",
+        o.text,
+        "OBJECTIVE>>>",
+    ].join("\n");
+}

package/dist/browser-runner/coding/runtime.js

@@ -1,3 +1,4 @@
+import { runObjective } from "./run-objective.js";
 import { homedir } from "node:os";
 import { join, resolve } from "node:path";
 import { RunnerInputError } from "../errors.js";
@@ -65,7 +66,9 @@ export class CodingRuntime {
         // a reader of the registration can see which machines can restore a branch invariant; the
         // cloud still never trusts it, because an older runner simply 404s and the policy reports
         // that it asked and was not answered.
-        return ["coding.sessions", "coding.stream", "human.takeover", "coding.inspect", "coding.repo-write"];
+        // `coding.run-objective` (#1019): a message may carry the run's objective, delivered verbatim and
+        // attributed to the platform. Advertised so the cloud never claims delivery to a runner without it.
+        return ["coding.sessions", "coding.stream", "human.takeover", "coding.inspect", "coding.repo-write", "coding.run-objective"];
     }
     /**
      * Resolve the workDir for a read-only inspection. Prefer the tracked session's real
@@ -255,6 +258,7 @@ export class CodingRuntime {
                     author: asTurnAuthor(action.author),
                     replay: typeof action.replay === "string" ? action.replay : undefined,
                     inputId: typeof action.inputId === "string" && action.inputId.length <= 128 ? action.inputId : undefined,
+                    objective: runObjective(action.objective),
                 });
                 break;
             case "keys": {

package/dist/index.js

@@ -1766,10 +1766,12 @@ var AutomaticUpdateController = class {
     if (action === "cancel") return this.cancel();
     if (action === "start") this.schedule(true);
   }
-  /** Testable immediate entry point; production reaches it through the scheduled timer. */
+  /**
+   * Testable immediate entry point; production reaches it through the scheduled timer. Authority is
+   * NOT required to get here: a failed refresh clears it, and the retry is what re-establishes it.
+   */
   async runNow() {
-    const current = this.deps.policy();
-    if (this.checking || this.waiting || !current.authoritative || !current.value.autoUpdate) return;
+    if (this.checking || this.waiting || !this.retryable()) return;
     this.checking = true;
     try {
       if (!await this.deps.refreshPolicy() || !this.enabled()) {
@@ -1787,12 +1789,22 @@ var AutomaticUpdateController = class {
   async installManually(plan) {
     return this.install(plan, false);
   }
+  /** May observe work, install or restart: only a freshly confirmed owner ON. */
   enabled() {
     const { value, authoritative } = this.deps.policy();
     return authoritative && value.autoUpdate;
   }
+  /**
+   * May keep a timer to re-read the policy: anything but an explicit OFF (#1020). The relay clears
+   * authority before every refresh, so a failed one left `enabled()` false and `schedule` refused —
+   * no timer, until a heartbeat happened to restore authority. The retry only refreshes; every
+   * install still passes `enabled()` and the relay's final admission.
+   */
+  retryable() {
+    return this.deps.policy().value.autoUpdate;
+  }
   schedule(initial = false) {
-    if (!this.enabled() || this.timer || this.waiting) return;
+    if (!this.retryable() || this.timer || this.waiting) return;
     const delay = initial ? Math.round(5e3 + (this.deps.random ?? Math.random)() * 25e3) : nextAutoUpdateDelayMs(this.failures, this.deps.random);
     this.timer = this.setTimer(() => {
       this.timer = null;
@@ -1813,6 +1825,7 @@ var AutomaticUpdateController = class {
    * until the next policy transition. `schedule` itself refuses once the policy is disabled.
    */
   offline() {
+    if (!this.retryable()) return;
     this.failures++;
     this.deps.status("offline", { reason: "The owner policy could not be refreshed; automatic update is deferred." });
     this.schedule();
@@ -1826,7 +1839,7 @@ var AutomaticUpdateController = class {
     const facts = await this.deps.facts();
     this.checkAt = this.now();
     if (facts.observations?.length) this.observations = [...this.observations, ...facts.observations].slice(-MAX_OBSERVATIONS);
-    if (!this.enabled()) return;
+    if (!this.enabled()) return this.offline();
     const plan = this.deps.plan(facts);
     this.decisionAt = this.now();
     this.blockerClass = plan.action === "wait" ? blockerClassFor(plan.waitingFor) : null;
@@ -1858,6 +1871,7 @@ var AutomaticUpdateController = class {
   defer(latest) {
     if (this.waiting) return;
     this.waiting = true;
+    if (this.timer) this.clearTimer(this.timer);
     this.timer = this.setTimer(() => {
       this.timer = null;
       this.nextRetryDueAt = null;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@proagentstore/cli",
-  "version": "0.4.102",
+  "version": "0.4.104",
   "description": "CLI for creating, publishing, and running ProAgentStore agents",
   "license": "MIT",
   "type": "module",