@nifrajs/agent-protocol 3.2.0

package/dist/run-lifecycle.js

@@ -0,0 +1,302 @@
+/**
+ * Additive run-lifecycle contracts: content-free run snapshots, evidence-event envelopes, handoff
+ * snapshots, feature negotiation, and cursor resume. These layer on top of the orchestration value
+ * contracts without changing `AGENT_PROTOCOL_VERSION`, and - like the evidence contract - carry no
+ * payload content.
+ *
+ * Two decoder disciplines live here on purpose:
+ *  - Transport decoders ({@link parseRunSnapshot}, {@link parseHandoffSnapshot},
+ *    {@link parseRunPlanRef}, and the envelope of {@link parseRunEvidenceEvent}) are lenient about
+ *    unknown additive fields so a newer host can add optional metadata without breaking an older
+ *    client. They still reject any {@link FORBIDDEN_CONTENT_KEYS} so a payload can never ride along.
+ *  - The evidence sink stays strict: the inner record of a {@link RunEvidenceEvent} is validated by
+ *    {@link parseRunEvidence}, which accepts only the declared content-free keys.
+ */
+import { FORBIDDEN_CONTENT_KEYS, parseRunEvidence, RunContractError, } from "./orchestration.js";
+/** Run-lifecycle contract version. Additive to the session `AGENT_PROTOCOL_VERSION`. */
+export const RUN_LIFECYCLE_VERSION = 1;
+const RUN_LIFECYCLE_STATES = [
+    "submitted",
+    "running",
+    "paused",
+    "succeeded",
+    "failed",
+    "cancelled",
+];
+const HANDOFF_STATUSES = ["pending", "accepted", "declined"];
+/** The stable dedupe identity for an evidence record. */
+export function evidenceEventId(runId, seq) {
+    return `${runId}:${seq}`;
+}
+/**
+ * Reconcile requested features against the offered set. A requested feature the host does not offer
+ * is reported as unsupported rather than silently dropped, so a client can degrade deliberately.
+ */
+export function negotiateFeatures(offered, requested) {
+    const offeredSet = new Set(offered);
+    const granted = new Set();
+    const unsupported = new Set();
+    for (const feature of requested) {
+        if (offeredSet.has(feature))
+            granted.add(feature);
+        else
+            unsupported.add(feature);
+    }
+    return {
+        granted: Object.freeze([...granted].sort()),
+        unsupported: Object.freeze([...unsupported].sort()),
+    };
+}
+/** Sentinel cursor meaning "before any record". A fresh subscription passes this or `undefined`. */
+export const CURSOR_BEFORE_ALL = -1;
+/**
+ * Resume an ordered, seq-keyed window from a cursor.
+ *
+ * The window must be sorted by ascending, strictly increasing `seq`. `cursor` is the last seq the
+ * client already holds; `undefined` (or {@link CURSOR_BEFORE_ALL}) means the client holds nothing.
+ * If the record immediately after the cursor was already evicted from the bounded window, a gap
+ * exists and this returns `resync_required` with reason `stale_cursor` rather than silently skipping.
+ */
+export function resumeFromCursor(window, cursor) {
+    let previous = Number.NEGATIVE_INFINITY;
+    for (const entry of window) {
+        if (!Number.isSafeInteger(entry.seq) || entry.seq < 0)
+            throw new RunContractError("cursor window seq must be a non-negative integer");
+        if (entry.seq <= previous)
+            throw new RunContractError("cursor window must be sorted by strictly increasing seq");
+        previous = entry.seq;
+    }
+    const from = cursor === undefined ? CURSOR_BEFORE_ALL : cursor;
+    if (!Number.isSafeInteger(from) || from < CURSOR_BEFORE_ALL)
+        throw new RunContractError("cursor must be a safe integer >= -1");
+    if (window.length === 0)
+        return {
+            status: "ok",
+            events: Object.freeze([]),
+            nextCursor: Math.max(from, CURSOR_BEFORE_ALL),
+        };
+    const earliest = window[0].seq;
+    const latest = window[window.length - 1].seq;
+    // A real cursor whose next record (from + 1) predates our window lost a gap to eviction. A fresh
+    // subscriber (CURSOR_BEFORE_ALL) has no continuity expectation and always takes the whole window.
+    if (from >= 0 && from + 1 < earliest)
+        return { status: "resync_required", reason: "stale_cursor", earliest, latest };
+    const events = window.filter((entry) => entry.seq > from);
+    const nextCursor = events.length > 0 ? events[events.length - 1].seq : from;
+    return { status: "ok", events: Object.freeze(events), nextCursor };
+}
+// ── Decoders ──────────────────────────────────────────────────────────────────────────────────
+const HEX64 = /^[0-9a-f]{64}$/;
+function isRecord(value) {
+    return typeof value === "object" && value !== null && !Array.isArray(value);
+}
+function assertNoForbiddenKeys(record, where) {
+    for (const key of FORBIDDEN_CONTENT_KEYS) {
+        if (key in record)
+            throw new RunContractError(`${where} carries forbidden content key '${key}'`);
+    }
+}
+function str(record, key, where) {
+    const value = record[key];
+    if (typeof value !== "string" || value.length === 0)
+        throw new RunContractError(`${where}.${key} must be a non-empty string`);
+    return value;
+}
+function nonNegInt(record, key, where) {
+    const value = record[key];
+    if (typeof value !== "number" || !Number.isSafeInteger(value) || value < 0)
+        throw new RunContractError(`${where}.${key} must be a non-negative integer`);
+    return value;
+}
+/** Decode a content-free plan reference. Lenient about unknown additive keys, never content. */
+export function parseRunPlanRef(value) {
+    if (!isRecord(value))
+        throw new RunContractError("run plan ref must be an object");
+    assertNoForbiddenKeys(value, "run plan ref");
+    const digest = str(value, "digest", "run plan ref");
+    if (!HEX64.test(digest))
+        throw new RunContractError("run plan ref.digest must be sha256 hex");
+    return {
+        id: str(value, "id", "run plan ref"),
+        digest,
+        nodeCount: nonNegInt(value, "nodeCount", "run plan ref"),
+    };
+}
+function parseCounters(value) {
+    if (!isRecord(value))
+        throw new RunContractError("run snapshot.counters must be an object");
+    assertNoForbiddenKeys(value, "run snapshot.counters");
+    return {
+        total: nonNegInt(value, "total", "run snapshot.counters"),
+        completed: nonNegInt(value, "completed", "run snapshot.counters"),
+        failed: nonNegInt(value, "failed", "run snapshot.counters"),
+    };
+}
+/**
+ * Decode a bounded run snapshot. Forward-compatible: unknown additive fields are ignored so an
+ * older client tolerates a newer host. Forbidden content keys are still rejected.
+ */
+export function parseRunSnapshot(value) {
+    if (!isRecord(value))
+        throw new RunContractError("run snapshot must be an object");
+    assertNoForbiddenKeys(value, "run snapshot");
+    if (value.version !== RUN_LIFECYCLE_VERSION)
+        throw new RunContractError(`run snapshot.version must be ${RUN_LIFECYCLE_VERSION}`);
+    const state = value.state;
+    if (typeof state !== "string" || !RUN_LIFECYCLE_STATES.includes(state))
+        throw new RunContractError("run snapshot.state is invalid");
+    const cursor = value.cursor;
+    if (typeof cursor !== "number" || !Number.isSafeInteger(cursor) || cursor < CURSOR_BEFORE_ALL)
+        throw new RunContractError("run snapshot.cursor must be a safe integer >= -1");
+    const snapshot = {
+        version: RUN_LIFECYCLE_VERSION,
+        runId: str(value, "runId", "run snapshot"),
+        plan: parseRunPlanRef(value.plan),
+        state: state,
+        cursor,
+        counters: parseCounters(value.counters),
+        updatedAt: nonNegInt(value, "updatedAt", "run snapshot"),
+        ...(value.failureCode !== undefined
+            ? { failureCode: str(value, "failureCode", "run snapshot") }
+            : {}),
+    };
+    return snapshot;
+}
+/**
+ * Decode an evidence-event envelope. The envelope is forward-compatible, but the inner record is
+ * validated strictly by {@link parseRunEvidence}, and its identity must match `${runId}:${seq}`.
+ */
+export function parseRunEvidenceEvent(value) {
+    if (!isRecord(value))
+        throw new RunContractError("run evidence event must be an object");
+    assertNoForbiddenKeys(value, "run evidence event");
+    if (value.version !== RUN_LIFECYCLE_VERSION)
+        throw new RunContractError(`run evidence event.version must be ${RUN_LIFECYCLE_VERSION}`);
+    const evidence = parseRunEvidence(value.evidence);
+    const expected = evidenceEventId(evidence.runId, evidence.seq);
+    if (value.eventId !== undefined && value.eventId !== expected)
+        throw new RunContractError("run evidence event.eventId must match the inner record identity");
+    return { version: RUN_LIFECYCLE_VERSION, eventId: expected, evidence };
+}
+/**
+ * Decode a handoff snapshot. Forward-compatible about unknown additive fields; forbidden content
+ * keys are rejected.
+ */
+export function parseHandoffSnapshot(value) {
+    if (!isRecord(value))
+        throw new RunContractError("handoff snapshot must be an object");
+    assertNoForbiddenKeys(value, "handoff snapshot");
+    if (value.version !== RUN_LIFECYCLE_VERSION)
+        throw new RunContractError(`handoff snapshot.version must be ${RUN_LIFECYCLE_VERSION}`);
+    const status = value.status;
+    if (typeof status !== "string" || !HANDOFF_STATUSES.includes(status))
+        throw new RunContractError("handoff snapshot.status is invalid");
+    const snapshot = {
+        version: RUN_LIFECYCLE_VERSION,
+        runId: str(value, "runId", "handoff snapshot"),
+        nodeId: str(value, "nodeId", "handoff snapshot"),
+        seq: nonNegInt(value, "seq", "handoff snapshot"),
+        from: str(value, "from", "handoff snapshot"),
+        to: str(value, "to", "handoff snapshot"),
+        status: status,
+        ...(value.reason !== undefined ? { reason: str(value, "reason", "handoff snapshot") } : {}),
+    };
+    return snapshot;
+}
+/**
+ * The negotiated command surface for the inbox: a superset of {@link BoundaryOp} plus the read verbs
+ * `list` and `inspect`. A host advertises the subset it supports; a client drives only the granted
+ * commands. Order here is the canonical advertisement order.
+ */
+export const BOUNDARY_COMMANDS = [
+    "list",
+    "inspect",
+    "approve",
+    "deny",
+    "assign",
+    "resolve",
+    "expire",
+    "cancel",
+];
+/** True when both coordinates address the same boundary at the same child vector. */
+export function coordinatesMatch(a, b) {
+    return (a.runId === b.runId &&
+        a.nodeId === b.nodeId &&
+        a.capability === b.capability &&
+        a.requestId === b.requestId &&
+        a.vector === b.vector);
+}
+/** True while `now` is strictly before the coordinate's expiry. At or past expiry fails closed. */
+export function coordinateIsFresh(coordinate, now) {
+    return now < coordinate.expiresAt;
+}
+/**
+ * Monotonic child-vector check: a newly opened boundary must advance strictly past the run's last
+ * allocated vector. A non-advancing vector is a replay and is refused. `last` is `-1` before any
+ * boundary has opened for the run.
+ */
+export function vectorAdvances(last, next) {
+    return Number.isSafeInteger(next) && next > last;
+}
+const APPROVAL_TRANSITIONS = {
+    pending: { approve: "approved", deny: "denied", expire: "expired", cancel: "cancelled" },
+    approved: {},
+    denied: {},
+    expired: {},
+    cancelled: {},
+};
+const HANDOFF_TRANSITIONS = {
+    pending: {
+        assign: "assigned",
+        accept: "accepted",
+        decline: "declined",
+        expire: "expired",
+        cancel: "cancelled",
+    },
+    assigned: {
+        accept: "accepted",
+        decline: "declined",
+        resolve: "resolved",
+        expire: "expired",
+        cancel: "cancelled",
+    },
+    accepted: { resolve: "resolved", expire: "expired", cancel: "cancelled" },
+    declined: {},
+    resolved: {},
+    expired: {},
+    cancelled: {},
+};
+/** The next approval state for an op, or `undefined` when the transition is illegal. */
+export function nextApprovalState(from, op) {
+    return APPROVAL_TRANSITIONS[from][op];
+}
+/** The next handoff state for an op, or `undefined` when the transition is illegal. */
+export function nextHandoffState(from, op) {
+    return HANDOFF_TRANSITIONS[from][op];
+}
+/** True once a boundary state accepts no further op. */
+export function isTerminalApprovalState(state) {
+    return Object.keys(APPROVAL_TRANSITIONS[state]).length === 0;
+}
+/** True once a handoff state accepts no further op. */
+export function isTerminalHandoffState(state) {
+    return Object.keys(HANDOFF_TRANSITIONS[state]).length === 0;
+}
+/**
+ * Decode a decision coordinate. Content-free: forbidden payload keys are rejected, and only the
+ * declared structural fields are read. `vector` and `expiresAt` must be non-negative safe integers.
+ */
+export function parseDecisionCoordinate(value) {
+    if (!isRecord(value))
+        throw new RunContractError("decision coordinate must be an object");
+    assertNoForbiddenKeys(value, "decision coordinate");
+    return {
+        runId: str(value, "runId", "decision coordinate"),
+        nodeId: str(value, "nodeId", "decision coordinate"),
+        capability: str(value, "capability", "decision coordinate"),
+        requestId: str(value, "requestId", "decision coordinate"),
+        vector: nonNegInt(value, "vector", "decision coordinate"),
+        expiresAt: nonNegInt(value, "expiresAt", "decision coordinate"),
+    };
+}
+//# sourceMappingURL=run-lifecycle.js.map

package/dist/run-lifecycle.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"run-lifecycle.js","sourceRoot":"","sources":["../src/run-lifecycle.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -0,0 +1,45 @@
+{
+  "name": "@nifrajs/agent-protocol",
+  "version": "3.2.0",
+  "description": "Small backend-neutral session and event protocol for Nifra coding agents.",
+  "keywords": [
+    "bun",
+    "typescript",
+    "nifra",
+    "agent",
+    "protocol",
+    "rpc"
+  ],
+  "type": "module",
+  "main": "./dist/index.js",
+  "module": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "bun": "./src/index.ts",
+      "types": "./dist/index.d.ts",
+      "default": "./dist/index.js"
+    }
+  },
+  "files": [
+    "dist",
+    "src"
+  ],
+  "sideEffects": false,
+  "scripts": {
+    "build": "tsc -p tsconfig.build.json && bun run ../../scripts/fix-dts.ts dist"
+  },
+  "license": "MIT",
+  "publishConfig": {
+    "access": "public"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/nifrajs/nifra.git",
+    "directory": "packages/agent-protocol"
+  },
+  "bugs": {
+    "url": "https://github.com/nifrajs/nifra/issues"
+  },
+  "homepage": "https://github.com/nifrajs/nifra#readme"
+}