@cluesmith/codev-core 3.3.4 → 3.3.6

package/dist/agent-state.d.ts

@@ -0,0 +1,36 @@
+import type { AgentActivity, NeedsInputDetail, ServedAgentState } from '@cluesmith/codev-types';
+/** Tower's liveness verdict for an agent. */
+export interface AgentLivenessFact {
+    /** `null` when liveness could not be determined. */
+    alive: boolean | null;
+    /** ISO time the current `alive` value was first published. */
+    since: string;
+}
+/** The latest accepted lifecycle report for an agent. */
+export interface ReportedActivityFact {
+    activity: AgentActivity;
+    /** ISO time the current activity began. */
+    since: string;
+    /** ISO hook time of the latest accepted report. */
+    at: string;
+    backgroundWork: boolean;
+    /** Held only while `activity` is `needs-input`. */
+    needsInput?: NeedsInputDetail;
+}
+export interface AgentStateFacts {
+    /** Whether porch reports a requested, pending gate (the overview's `detectBlocked`). */
+    blocked: boolean;
+    /** ISO time the gate was requested, when known. */
+    blockedSince: string | null;
+    /**
+     * The builder's display `phase` (the field the sdk predicate reads). Pass `''` for
+     * an architect, which has no porch phase.
+     */
+    phase: string;
+    liveness: AgentLivenessFact | null;
+    reported: ReportedActivityFact | null;
+    /** ISO time to use when a `since` is otherwise unknown. */
+    now: string;
+}
+export declare function projectAgentState(facts: AgentStateFacts): ServedAgentState | null;
+//# sourceMappingURL=agent-state.d.ts.map

package/dist/agent-state.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"agent-state.d.ts","sourceRoot":"","sources":["../src/agent-state.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,aAAa,EACb,gBAAgB,EAChB,gBAAgB,EACjB,MAAM,wBAAwB,CAAC;AAqBhC,6CAA6C;AAC7C,MAAM,WAAW,iBAAiB;IAChC,oDAAoD;IACpD,KAAK,EAAE,OAAO,GAAG,IAAI,CAAC;IACtB,8DAA8D;IAC9D,KAAK,EAAE,MAAM,CAAC;CACf;AAED,yDAAyD;AACzD,MAAM,WAAW,oBAAoB;IACnC,QAAQ,EAAE,aAAa,CAAC;IACxB,2CAA2C;IAC3C,KAAK,EAAE,MAAM,CAAC;IACd,mDAAmD;IACnD,EAAE,EAAE,MAAM,CAAC;IACX,cAAc,EAAE,OAAO,CAAC;IACxB,mDAAmD;IACnD,UAAU,CAAC,EAAE,gBAAgB,CAAC;CAC/B;AAED,MAAM,WAAW,eAAe;IAC9B,wFAAwF;IACxF,OAAO,EAAE,OAAO,CAAC;IACjB,mDAAmD;IACnD,YAAY,EAAE,MAAM,GAAG,IAAI,CAAC;IAC5B;;;OAGG;IACH,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,EAAE,iBAAiB,GAAG,IAAI,CAAC;IACnC,QAAQ,EAAE,oBAAoB,GAAG,IAAI,CAAC;IACtC,2DAA2D;IAC3D,GAAG,EAAE,MAAM,CAAC;CACb;AAED,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,eAAe,GAAG,gBAAgB,GAAG,IAAI,CA8BjF"}

package/dist/agent-state.js

@@ -0,0 +1,44 @@
+/**
+ * Agent-state projection (Spec 1595): the one policy that turns Tower's facts about
+ * an agent into the `ServedAgentState` served on the overview.
+ *
+ * Precedence, first match wins:
+ *   1. `blocked` — porch reports a requested, pending gate. The caller computes this
+ *      with the overview's existing `detectBlocked`; nothing here parses `status.yaml`
+ *      or holds a gate list (Constraint 14).
+ *   2. `dead` — the agent process is gone, unless the builder is `complete` or
+ *      `verified` (the normal end of a lane, not an alert).
+ *   3. the reported activity — `needs-input`, `working` or `idle`.
+ *   4. otherwise `null` (unknown).
+ *
+ * Pure: no I/O, no clock reads (the caller passes `now`).
+ */
+/** Porch phases at which a builder's lane is finished. Mirrors the sdk predicate's check. */
+const FINISHED_PHASES = new Set(['complete', 'verified']);
+export function projectAgentState(facts) {
+    const alive = facts.liveness?.alive ?? null;
+    const reported = facts.reported;
+    // The raw inputs ride on every served row, whatever wins precedence, so a consumer
+    // (#1672) can build its own chain from the same facts. The needs-input detail is part
+    // of them: it follows the raw `activity`, not the served `state`.
+    const raw = {
+        alive,
+        activity: reported?.activity ?? null,
+        activityAt: reported?.at ?? null,
+        backgroundWork: reported?.backgroundWork ?? false,
+    };
+    if (reported?.activity === 'needs-input' && reported.needsInput) {
+        raw.needsInput = reported.needsInput;
+    }
+    if (facts.blocked) {
+        return { state: 'blocked', since: facts.blockedSince ?? facts.now, source: 'tower', ...raw };
+    }
+    if (alive === false && !FINISHED_PHASES.has(facts.phase)) {
+        return { state: 'dead', since: facts.liveness.since, source: 'tower', ...raw };
+    }
+    if (reported) {
+        return { state: reported.activity, since: reported.since, source: 'harness', ...raw };
+    }
+    return null;
+}
+//# sourceMappingURL=agent-state.js.map

package/dist/agent-state.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"agent-state.js","sourceRoot":"","sources":["../src/agent-state.ts"],"names":[],"mappings":"AAMA;;;;;;;;;;;;;;GAcG;AAEH,6FAA6F;AAC7F,MAAM,eAAe,GAAwB,IAAI,GAAG,CAAC,CAAC,UAAU,EAAE,UAAU,CAAC,CAAC,CAAC;AAsC/E,MAAM,UAAU,iBAAiB,CAAC,KAAsB;IACtD,MAAM,KAAK,GAAG,KAAK,CAAC,QAAQ,EAAE,KAAK,IAAI,IAAI,CAAC;IAC5C,MAAM,QAAQ,GAAG,KAAK,CAAC,QAAQ,CAAC;IAEhC,mFAAmF;IACnF,sFAAsF;IACtF,kEAAkE;IAClE,MAAM,GAAG,GAAyD;QAChE,KAAK;QACL,QAAQ,EAAE,QAAQ,EAAE,QAAQ,IAAI,IAAI;QACpC,UAAU,EAAE,QAAQ,EAAE,EAAE,IAAI,IAAI;QAChC,cAAc,EAAE,QAAQ,EAAE,cAAc,IAAI,KAAK;KAClD,CAAC;IACF,IAAI,QAAQ,EAAE,QAAQ,KAAK,aAAa,IAAI,QAAQ,CAAC,UAAU,EAAE,CAAC;QAChE,GAAG,CAAC,UAAU,GAAG,QAAQ,CAAC,UAAU,CAAC;IACvC,CAAC;IAED,IAAI,KAAK,CAAC,OAAO,EAAE,CAAC;QAClB,OAAO,EAAE,KAAK,EAAE,SAAS,EAAE,KAAK,EAAE,KAAK,CAAC,YAAY,IAAI,KAAK,CAAC,GAAG,EAAE,MAAM,EAAE,OAAO,EAAE,GAAG,GAAG,EAAE,CAAC;IAC/F,CAAC;IAED,IAAI,KAAK,KAAK,KAAK,IAAI,CAAC,eAAe,CAAC,GAAG,CAAC,KAAK,CAAC,KAAK,CAAC,EAAE,CAAC;QACzD,OAAO,EAAE,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,KAAK,CAAC,QAAS,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,GAAG,GAAG,EAAE,CAAC;IAClF,CAAC;IAED,IAAI,QAAQ,EAAE,CAAC;QACb,OAAO,EAAE,KAAK,EAAE,QAAQ,CAAC,QAAQ,EAAE,KAAK,EAAE,QAAQ,CAAC,KAAK,EAAE,MAAM,EAAE,SAAS,EAAE,GAAG,GAAG,EAAE,CAAC;IACxF,CAAC;IAED,OAAO,IAAI,CAAC;AACd,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@cluesmith/codev-core",
-  "version": "3.3.4",
+  "version": "3.3.6",
   "description": "Server-side runtime for Codev — local-key issuance and homedir-derived paths. Client-side Tower access lives in @cluesmith/codev-sdk; the two packages never import each other.",
   "type": "module",
   "exports": {
@@ -11,6 +11,10 @@
     "./constants": {
       "types": "./dist/constants.d.ts",
       "default": "./dist/constants.js"
+    },
+    "./agent-state": {
+      "types": "./dist/agent-state.d.ts",
+      "default": "./dist/agent-state.js"
     }
   },
   "files": [
@@ -19,10 +23,12 @@
   "devDependencies": {
     "@types/node": "22.x",
     "typescript": "^6.0.3",
-    "vitest": "^4.0.15",
-    "@cluesmith/codev-types": "3.3.4"
+    "vitest": "^4.0.15"
   },
   "license": "Apache-2.0",
+  "dependencies": {
+    "@cluesmith/codev-types": "3.3.6"
+  },
   "scripts": {
     "build": "tsc",
     "check-types": "tsc --noEmit",