@agenticprimitives/service-host 0.0.0-alpha.0 → 0.0.0-stage

package/README.md

@@ -1,28 +1,3 @@
-# @agenticprimitives/service-host
+# Temporary Holding Version
 
-**A service agent's run is a harness run, or it is not a run of that agent** ([spec 433](../../specs/433-service-apps-run-the-harness-service-host.md)).
-
-This package is the harness run pipeline a service built as its own app embeds, so it runs the same harness the
-Agentic Primitives runtime hosts: runs checkpointed in the agent's own DO, receipts and provenance in the agent's own
-vault, the `/harness/*` routes its Home reads. It is being promoted out of the runtime in the order the
-[census](../../docs/architecture/service-host-census.md) §8 sets.
-
-**W1 step 1 (this release): the run store.** `RunStore` is the port; the checkpoint shape, the listing rule (expiry,
-never the keyring), the turn merge, the progress lines and the canceled record are pure and shared; `./cloudflare`
-binds the port to Durable Object storage on the DO side and to a per-agent stub on the Worker side.
-
-```ts
-import { mergeTurn, isExpired, liveRuns, progressLine } from '@agenticprimitives/service-host';
-import { durableObjectRunStorage, durableObjectRunStore } from '@agenticprimitives/service-host/cloudflare';
-
-// Inside the agent's DO: one handler for every `/internal/harness-run/<op>` call.
-const runs = durableObjectRunStorage(state.storage);
-return Response.json(await runs.handle(op, body));
-
-// In the Worker: the store over the agent's stub, in-Worker only (the marker is the app's).
-const store = durableObjectRunStore(env.A2A_TASKS, () => internalHeaders(env));
-await store.save(checkpoint);
-```
-
-Nothing here grants authority: a checkpoint holds what a person already gave and decides nothing; every resume
-re-verifies every mandate (spec 350 W3).
+This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.

package/package.json

@@ -1,68 +1,6 @@
 {
   "name": "@agenticprimitives/service-host",
-  "version": "0.0.0-alpha.0",
-  "description": "The Service Host (spec 433): the harness run pipeline a service agent embeds — run store, progress, routes, tools, provenance sink — so a service built as an app runs the same harness the runtime hosts. W1 step 1: the run store behind a port.",
-  "homepage": "https://agenticprimitives.dev",
-  "bugs": {
-    "url": "https://github.com/agentictrustlabs/agenticprimitives/issues"
-  },
-  "author": {
-    "name": "Agentic Trust Labs",
-    "url": "https://agenticprimitives.dev"
-  },
-  "type": "module",
-  "exports": {
-    ".": {
-      "types": "./dist/index.d.ts",
-      "import": "./dist/index.js"
-    },
-    "./cloudflare": {
-      "types": "./dist/cloudflare/index.d.ts",
-      "import": "./dist/cloudflare/index.js"
-    }
-  },
-  "files": [
-    "LICENSE",
-    "dist",
-    "spec.md",
-    "README.md"
-  ],
-  "dependencies": {
-    "@agenticprimitives/types": "1.0.0-alpha.30",
-    "@agenticprimitives/a2a": "0.0.0-alpha.28",
-    "@agenticprimitives/orchestration": "0.0.0-alpha.9"
-  },
-  "devDependencies": {
-    "@cloudflare/workers-types": "^4.20240117.0",
-    "vitest": "^4.1.11"
-  },
-  "publishConfig": {
-    "access": "public"
-  },
-  "repository": {
-    "type": "git",
-    "url": "git+https://github.com/agentictrustlabs/agenticprimitives.git",
-    "directory": "packages/service-host"
-  },
-  "license": "MIT",
-  "keywords": [
-    "agentic",
-    "primitives",
-    "harness",
-    "service-agent",
-    "service-host",
-    "agentic-primitives",
-    "agenticprimitives",
-    "ai-agents",
-    "agent-authority",
-    "agentic-trust"
-  ],
-  "scripts": {
-    "build": "tsc -p tsconfig.build.json",
-    "typecheck": "tsc -p tsconfig.json --noEmit",
-    "test": "vitest run",
-    "test:unit": "vitest run test/unit --passWithNoTests",
-    "test:watch": "vitest",
-    "clean": "rm -rf dist"
-  }
+  "version": "0.0.0-stage",
+  "stub": true,
+  "description": "Temporary package placeholder for staged publishing"
 }

package/LICENSE

@@ -1,21 +0,0 @@
-MIT License
-
-Copyright (c) 2026 Agentic Trust Labs
-
-Permission is hereby granted, free of charge, to any person obtaining a copy
-of this software and associated documentation files (the "Software"), to deal
-in the Software without restriction, including without limitation the rights
-to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
-copies of the Software, and to permit persons to whom the Software is
-furnished to do so, subject to the following conditions:
-
-The above copyright notice and this permission notice shall be included in all
-copies or substantial portions of the Software.
-
-THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
-IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
-FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
-AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
-LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
-OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
-SOFTWARE.

package/dist/cloudflare/index.d.ts

@@ -1,14 +0,0 @@
-import { type RunStorage } from '../storage.js';
-import { type RunStore } from '../run-store.js';
-/** The path a DO answers the store on. The Worker-side client posts here; a DO's `fetch` routes it to `handle`. */
-export declare const RUN_STORE_PATH = "/internal/harness-run/";
-/** Inside the agent's Durable Object: the checkpoint + progress storage over `state.storage`. */
-export declare function durableObjectRunStorage(storage: DurableObjectStorage): RunStorage;
-/** The DO-side route: `fetch(request)` → `handleRunStoreRequest(request, runs)` for any `/internal/harness-run/<op>`.
- *  Returns `null` when the request is not a run-store call, so the DO's own routing continues. The in-Worker marker that
- *  gates this path is the app's (spec 341 §7) and is checked BEFORE this is called. */
-export declare function handleRunStoreRequest(request: Request, runs: RunStorage): Promise<Response | null>;
-/** In the Worker: the `RunStore` over the agent's own stub, one DO per agent (`idFromName(agent)`). `headers` supplies
- *  the in-Worker marker the DO requires — the app's secret, read through a function so it is never captured here. */
-export declare function durableObjectRunStore(ns: DurableObjectNamespace, headers: () => Record<string, string>): RunStore;
-//# sourceMappingURL=index.d.ts.map

package/dist/cloudflare/index.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/cloudflare/index.ts"],"names":[],"mappings":"AAIA,OAAO,EAAc,KAAK,UAAU,EAAE,MAAM,eAAe,CAAC;AAC5D,OAAO,EAAgB,KAAK,QAAQ,EAAmB,MAAM,iBAAiB,CAAC;AAG/E,mHAAmH;AACnH,eAAO,MAAM,cAAc,2BAA2B,CAAC;AAEvD,iGAAiG;AACjG,wBAAgB,uBAAuB,CAAC,OAAO,EAAE,oBAAoB,GAAG,UAAU,CAEjF;AAED;;uFAEuF;AACvF,wBAAsB,qBAAqB,CAAC,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,UAAU,GAAG,OAAO,CAAC,QAAQ,GAAG,IAAI,CAAC,CAOxG;AAED;qHACqH;AACrH,wBAAgB,qBAAqB,CAAC,EAAE,EAAE,sBAAsB,EAAE,OAAO,EAAE,MAAM,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,QAAQ,CAUjH"}

package/dist/cloudflare/index.js

@@ -1,39 +0,0 @@
-// THE CLOUDFLARE BINDING of the run store (census §2): the Durable Object's storage on the store's side, a per-agent stub
-// on the Worker's side. The core ships NO Cloudflare coupling (ADR-0034); this subpath takes the namespace as a VALUE —
-// the binding name (`A2A_TASKS`, `CATALOG_RUNS`, …) is the app's and is never named here.
-/// <reference types="@cloudflare/workers-types" />
-import { runStorage } from '../storage.js';
-import { runStoreOver } from '../run-store.js';
-/** The path a DO answers the store on. The Worker-side client posts here; a DO's `fetch` routes it to `handle`. */
-export const RUN_STORE_PATH = '/internal/harness-run/';
-/** Inside the agent's Durable Object: the checkpoint + progress storage over `state.storage`. */
-export function durableObjectRunStorage(storage) {
-    return runStorage(storage);
-}
-/** The DO-side route: `fetch(request)` → `handleRunStoreRequest(request, runs)` for any `/internal/harness-run/<op>`.
- *  Returns `null` when the request is not a run-store call, so the DO's own routing continues. The in-Worker marker that
- *  gates this path is the app's (spec 341 §7) and is checked BEFORE this is called. */
-export async function handleRunStoreRequest(request, runs) {
-    const url = new URL(request.url);
-    if (!url.pathname.startsWith(RUN_STORE_PATH))
-        return null;
-    const op = url.pathname.slice(RUN_STORE_PATH.length);
-    const body = (await request.json().catch(() => null));
-    const r = await runs.handle(op, body);
-    return r.ok ? Response.json(r) : Response.json({ ok: false, error: r.error }, { status: r.status });
-}
-/** In the Worker: the `RunStore` over the agent's own stub, one DO per agent (`idFromName(agent)`). `headers` supplies
- *  the in-Worker marker the DO requires — the app's secret, read through a function so it is never captured here. */
-export function durableObjectRunStore(ns, headers) {
-    return runStoreOver(async (agent, op, body) => {
-        const stub = ns.get(ns.idFromName(agent.toLowerCase()));
-        const res = await stub.fetch(new Request(`https://harness-run-do${RUN_STORE_PATH}${op}`, {
-            method: 'POST', headers: { 'content-type': 'application/json', ...headers() }, body: JSON.stringify(body),
-        }));
-        const out = (await res.json().catch(() => ({})));
-        if (!res.ok || out.ok === false)
-            throw new Error(String(out.error ?? `harness-run/${op} failed (${res.status})`));
-        return out;
-    });
-}
-//# sourceMappingURL=index.js.map

package/dist/cloudflare/index.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/cloudflare/index.ts"],"names":[],"mappings":"AAAA,0HAA0H;AAC1H,wHAAwH;AACxH,0FAA0F;AAC1F,mDAAmD;AACnD,OAAO,EAAE,UAAU,EAAmB,MAAM,eAAe,CAAC;AAC5D,OAAO,EAAE,YAAY,EAAkC,MAAM,iBAAiB,CAAC;AAG/E,mHAAmH;AACnH,MAAM,CAAC,MAAM,cAAc,GAAG,wBAAwB,CAAC;AAEvD,iGAAiG;AACjG,MAAM,UAAU,uBAAuB,CAAC,OAA6B;IACnE,OAAO,UAAU,CAAC,OAAO,CAAC,CAAC;AAC7B,CAAC;AAED;;uFAEuF;AACvF,MAAM,CAAC,KAAK,UAAU,qBAAqB,CAAC,OAAgB,EAAE,IAAgB;IAC5E,MAAM,GAAG,GAAG,IAAI,GAAG,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC;IACjC,IAAI,CAAC,GAAG,CAAC,QAAQ,CAAC,UAAU,CAAC,cAAc,CAAC;QAAE,OAAO,IAAI,CAAC;IAC1D,MAAM,EAAE,GAAG,GAAG,CAAC,QAAQ,CAAC,KAAK,CAAC,cAAc,CAAC,MAAM,CAAe,CAAC;IACnE,MAAM,IAAI,GAAG,CAAC,MAAM,OAAO,CAAC,IAAI,EAAE,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,IAAI,CAAC,CAAmC,CAAC;IACxF,MAAM,CAAC,GAAG,MAAM,IAAI,CAAC,MAAM,CAAC,EAAE,EAAE,IAAI,CAAC,CAAC;IACtC,OAAO,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,IAAI,CAAC,EAAE,EAAE,EAAE,KAAK,EAAE,KAAK,EAAE,CAAC,CAAC,KAAK,EAAE,EAAE,EAAE,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC;AACtG,CAAC;AAED;qHACqH;AACrH,MAAM,UAAU,qBAAqB,CAAC,EAA0B,EAAE,OAAqC;IACrG,OAAO,YAAY,CAAC,KAAK,EAAE,KAAc,EAAE,EAAE,EAAE,IAAI,EAAE,EAAE;QACrD,MAAM,IAAI,GAAG,EAAE,CAAC,GAAG,CAAC,EAAE,CAAC,UAAU,CAAC,KAAK,CAAC,WAAW,EAAE,CAAC,CAAC,CAAC;QACxD,MAAM,GAAG,GAAG,MAAM,IAAI,CAAC,KAAK,CAAC,IAAI,OAAO,CAAC,yBAAyB,cAAc,GAAG,EAAE,EAAE,EAAE;YACvF,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,EAAE,cAAc,EAAE,kBAAkB,EAAE,GAAG,OAAO,EAAE,EAAE,EAAE,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC;SAC1G,CAAC,CAAC,CAAC;QACJ,MAAM,GAAG,GAAG,CAAC,MAAM,GAAG,CAAC,IAAI,EAAE,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,CAAC,EAAE,CAAC,CAAC,CAA+D,CAAC;QAC/G,IAAI,CAAC,GAAG,CAAC,EAAE,IAAI,GAAG,CAAC,EAAE,KAAK,KAAK;YAAE,MAAM,IAAI,KAAK,CAAC,MAAM,CAAC,GAAG,CAAC,KAAK,IAAI,eAAe,EAAE,YAAY,GAAG,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC;QAClH,OAAO,GAAG,CAAC;IACb,CAAC,CAAC,CAAC;AACL,CAAC"}

package/dist/index.d.ts

@@ -1,10 +0,0 @@
-export declare const PACKAGE_NAME: "@agenticprimitives/service-host";
-export declare const PACKAGE_STATUS: "w1-run-store";
-export declare const SPEC_REF: "specs/433-service-apps-run-the-harness-service-host.md";
-export { mergeTurn, isExpired, expiryFor, liveRuns, completedStepsOf, canceledRecord, openRunOnThread, runStoreOver, AWAIT_WINDOW_MS, RUN_TTL_MS, } from './run-store.js';
-export type { HarnessRunCheckpointV1, SuspendedRunV1, SelectedOfferBindingV1, AwaitingKind, RunStore, RunStoreOp, RunStoreCall } from './run-store.js';
-export { toolWords, progressLine, PROGRESS_TTL_MS, PROGRESS_MAX_LINES } from './progress.js';
-export type { ProgressLineV1 } from './progress.js';
-export { runStorage, memoryRunKv, memoryRunStoreCall, RUN_KEY_PREFIX, PROGRESS_KEY_PREFIX } from './storage.js';
-export type { RunKv, RunStorage, RunStorageResult } from './storage.js';
-//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAEA,eAAO,MAAM,YAAY,EAAG,iCAA0C,CAAC;AACvE,eAAO,MAAM,cAAc,EAAG,cAAuB,CAAC;AACtD,eAAO,MAAM,QAAQ,EAAG,wDAAiE,CAAC;AAE1F,OAAO,EACL,SAAS,EAAE,SAAS,EAAE,SAAS,EAAE,QAAQ,EAAE,gBAAgB,EAAE,cAAc,EAAE,eAAe,EAAE,YAAY,EAC1G,eAAe,EAAE,UAAU,GAC5B,MAAM,gBAAgB,CAAC;AACxB,YAAY,EAAE,sBAAsB,EAAE,cAAc,EAAE,sBAAsB,EAAE,YAAY,EAAE,QAAQ,EAAE,UAAU,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAEvJ,OAAO,EAAE,SAAS,EAAE,YAAY,EAAE,eAAe,EAAE,kBAAkB,EAAE,MAAM,eAAe,CAAC;AAC7F,YAAY,EAAE,cAAc,EAAE,MAAM,eAAe,CAAC;AAEpD,OAAO,EAAE,UAAU,EAAE,WAAW,EAAE,kBAAkB,EAAE,cAAc,EAAE,mBAAmB,EAAE,MAAM,cAAc,CAAC;AAChH,YAAY,EAAE,KAAK,EAAE,UAAU,EAAE,gBAAgB,EAAE,MAAM,cAAc,CAAC"}

package/dist/index.js

@@ -1,9 +0,0 @@
-// @agenticprimitives/service-host — spec 433. The harness run pipeline a service agent embeds, promoted out of the
-// ap-home runtime in the census order (docs/architecture/service-host-census.md §8). W1 step 1: the run store.
-export const PACKAGE_NAME = '@agenticprimitives/service-host';
-export const PACKAGE_STATUS = 'w1-run-store';
-export const SPEC_REF = 'specs/433-service-apps-run-the-harness-service-host.md';
-export { mergeTurn, isExpired, expiryFor, liveRuns, completedStepsOf, canceledRecord, openRunOnThread, runStoreOver, AWAIT_WINDOW_MS, RUN_TTL_MS, } from './run-store.js';
-export { toolWords, progressLine, PROGRESS_TTL_MS, PROGRESS_MAX_LINES } from './progress.js';
-export { runStorage, memoryRunKv, memoryRunStoreCall, RUN_KEY_PREFIX, PROGRESS_KEY_PREFIX } from './storage.js';
-//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,mHAAmH;AACnH,+GAA+G;AAC/G,MAAM,CAAC,MAAM,YAAY,GAAG,iCAA0C,CAAC;AACvE,MAAM,CAAC,MAAM,cAAc,GAAG,cAAuB,CAAC;AACtD,MAAM,CAAC,MAAM,QAAQ,GAAG,wDAAiE,CAAC;AAE1F,OAAO,EACL,SAAS,EAAE,SAAS,EAAE,SAAS,EAAE,QAAQ,EAAE,gBAAgB,EAAE,cAAc,EAAE,eAAe,EAAE,YAAY,EAC1G,eAAe,EAAE,UAAU,GAC5B,MAAM,gBAAgB,CAAC;AAGxB,OAAO,EAAE,SAAS,EAAE,YAAY,EAAE,eAAe,EAAE,kBAAkB,EAAE,MAAM,eAAe,CAAC;AAG7F,OAAO,EAAE,UAAU,EAAE,WAAW,EAAE,kBAAkB,EAAE,cAAc,EAAE,mBAAmB,EAAE,MAAM,cAAc,CAAC"}

package/dist/progress.d.ts

@@ -1,33 +0,0 @@
-import type { RunEvent, ToolSpec } from '@agenticprimitives/orchestration';
-export interface ProgressLineV1 {
-    /** Monotonic within the run, assigned by the store as lines arrive. */
-    seq: number;
-    at: number;
-    type: RunEvent['type'] | 'ReplyReady' | 'Relayed' | 'AnswerDraft';
-    /** Spec 418 A1 — the growing answer of a streamed step (`AnswerDraft`): a surface REPLACES the previous draft with it. */
-    draft?: string;
-    /** Spec 374 / appendix M8 — a line RELAYED from the subject agent's own run (a routed step): the words are the
-     *  receiver's, prefixed with its name; `from` says whose. */
-    from?: {
-        agent: string;
-        name?: string;
-    };
-    stepRef?: string;
-    toolId?: string;
-    /** One sentence for a screen or a voice. */
-    said: string;
-    /** The run reached its reply; the surface may stop reading. */
-    terminal?: boolean;
-}
-/** A run's progress is kept this long past its last line (a surface reads the tail after the reply). */
-export declare const PROGRESS_TTL_MS = 3600000;
-/** Lines per run, capped: a run is several turns and nothing a person needs is line 401. */
-export declare const PROGRESS_MAX_LINES = 400;
-/**
- * The words for a tool: the capability's plain phrase where one is published ("create organizations"), else the
- * tool's own description. Never the id — "organization.create" is not a thing a voice says.
- */
-export declare function toolWords(tool: ToolSpec | undefined, words: (capabilityId: string) => string | undefined): string;
-/** One sentence per loop event. `null` for events that say nothing a person needs mid-turn. */
-export declare function progressLine(e: RunEvent, tools: ReadonlyArray<ToolSpec>, words: (capabilityId: string) => string | undefined): Omit<ProgressLineV1, 'seq' | 'at'> | null;
-//# sourceMappingURL=progress.d.ts.map

package/dist/progress.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"progress.d.ts","sourceRoot":"","sources":["../src/progress.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,QAAQ,EAAE,QAAQ,EAAE,MAAM,kCAAkC,CAAC;AAE3E,MAAM,WAAW,cAAc;IAC7B,uEAAuE;IACvE,GAAG,EAAE,MAAM,CAAC;IACZ,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,QAAQ,CAAC,MAAM,CAAC,GAAG,YAAY,GAAG,SAAS,GAAG,aAAa,CAAC;IAClE,0HAA0H;IAC1H,KAAK,CAAC,EAAE,MAAM,CAAC;IACf;iEAC6D;IAC7D,IAAI,CAAC,EAAE;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,IAAI,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;IACxC,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,4CAA4C;IAC5C,IAAI,EAAE,MAAM,CAAC;IACb,+DAA+D;IAC/D,QAAQ,CAAC,EAAE,OAAO,CAAC;CACpB;AAED,wGAAwG;AACxG,eAAO,MAAM,eAAe,UAAW,CAAC;AACxC,4FAA4F;AAC5F,eAAO,MAAM,kBAAkB,MAAM,CAAC;AAItC;;;GAGG;AACH,wBAAgB,SAAS,CAAC,IAAI,EAAE,QAAQ,GAAG,SAAS,EAAE,KAAK,EAAE,CAAC,YAAY,EAAE,MAAM,KAAK,MAAM,GAAG,SAAS,GAAG,MAAM,CAUjH;AAED,+FAA+F;AAC/F,wBAAgB,YAAY,CAAC,CAAC,EAAE,QAAQ,EAAE,KAAK,EAAE,aAAa,CAAC,QAAQ,CAAC,EAAE,KAAK,EAAE,CAAC,YAAY,EAAE,MAAM,KAAK,MAAM,GAAG,SAAS,GAAG,IAAI,CAAC,cAAc,EAAE,KAAK,GAAG,IAAI,CAAC,GAAG,IAAI,CAuBxK"}

package/dist/progress.js

@@ -1,49 +0,0 @@
-/** A run's progress is kept this long past its last line (a surface reads the tail after the reply). */
-export const PROGRESS_TTL_MS = 3600_000;
-/** Lines per run, capped: a run is several turns and nothing a person needs is line 401. */
-export const PROGRESS_MAX_LINES = 400;
-const cap = (s) => (s ? s[0].toUpperCase() + s.slice(1) : s);
-/**
- * The words for a tool: the capability's plain phrase where one is published ("create organizations"), else the
- * tool's own description. Never the id — "organization.create" is not a thing a voice says.
- */
-export function toolWords(tool, words) {
-    if (!tool)
-        return 'the next step';
-    const w = tool.capability?.id ? words(tool.capability.id) : undefined;
-    if (w)
-        return w;
-    // A READ has no capability words. Its `answer`/`answers` say what it answers; failing that, the first clause of its
-    // description — never the whole description, which once put a paragraph of planner guidance into a progress line.
-    const q = tool.answer ?? tool.answers?.[0];
-    if (q)
-        return q.replace(/[?.]+$/, '').toLowerCase();
-    const d = (tool.description ?? '').replace(/^ANSWERS A QUESTION:\s*/i, '').split(/\s[—–]\s|\.\s|:\s/)[0]?.trim() ?? '';
-    return d ? (d.length > 72 ? `${d.slice(0, 69)}…` : d) : tool.id;
-}
-/** One sentence per loop event. `null` for events that say nothing a person needs mid-turn. */
-export function progressLine(e, tools, words) {
-    const tool = (id) => tools.find((t) => t.id === id);
-    const w = (id) => toolWords(tool(id), words);
-    // A tool with no capability exercises no authority: reading, never acting (the loop's own rule).
-    const informational = (id) => !tool(id)?.capability;
-    switch (e.type) {
-        case 'PlanCreated': return { type: e.type, said: e.steps === 1 ? 'Working out how — one step.' : `Working out how — ${e.steps} steps.` };
-        case 'PlanRefused': return { type: e.type, said: e.replanning ? 'That plan did not fit — trying again.' : 'That plan did not fit.' };
-        case 'StepProposed': return { type: e.type, stepRef: e.stepRef, toolId: e.toolId, said: e.risk === 'informational' || informational(e.toolId) ? `Reading ${w(e.toolId)}…` : `Checking your authority to ${w(e.toolId)}…` };
-        case 'MandateChecked': return e.decision === 'allow' ? { type: e.type, stepRef: e.stepRef, said: e.afterApproval ? 'Approved and confirmed — going ahead.' : 'Authority confirmed — going ahead.' } : null;
-        case 'MandateDenied': return { type: e.type, stepRef: e.stepRef, said: `Refused: ${e.reasons[0]?.message ?? 'the authority does not cover this'}.` };
-        case 'ApprovalRequested': return { type: e.type, stepRef: e.stepRef, said: 'This needs an approval — asking.' };
-        case 'ApprovalDischarged': return { type: e.type, stepRef: e.stepRef, said: 'Approved.' };
-        case 'ApprovalRefused': return { type: e.type, stepRef: e.stepRef, said: `Approval refused${e.reason ? `: ${e.reason}` : ''}.` };
-        case 'StepReplayed': return { type: e.type, stepRef: e.stepRef, toolId: e.toolId, said: `${cap(w(e.toolId))}: already done.` };
-        case 'ToolInvoked': return { type: e.type, stepRef: e.stepRef, toolId: e.toolId, said: e.ok ? (informational(e.toolId) ? `Read ${w(e.toolId)}.` : `${cap(w(e.toolId))} — done.`) : `${cap(w(e.toolId))} failed.` };
-        case 'RunSuspended': return { type: e.type, stepRef: e.stepRef, said: 'I need something from you.' };
-        case 'EffectFailed': return { type: e.type, stepRef: e.stepRef, said: 'The act stood, but telling the other side failed.' };
-        case 'RunCompleted': return { type: e.type, said: 'Done.', terminal: true };
-        case 'RunFailed': return { type: e.type, said: `That did not go through: ${e.error.split(/[:\n]/)[0]}.`, terminal: true };
-        case 'StepCompensated': return { type: e.type, stepRef: e.stepRef, said: e.ok ? 'Undone.' : 'Could not undo.' };
-        default: return null;
-    }
-}
-//# sourceMappingURL=progress.js.map

package/dist/progress.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"progress.js","sourceRoot":"","sources":["../src/progress.ts"],"names":[],"mappings":"AAuBA,wGAAwG;AACxG,MAAM,CAAC,MAAM,eAAe,GAAG,QAAQ,CAAC;AACxC,4FAA4F;AAC5F,MAAM,CAAC,MAAM,kBAAkB,GAAG,GAAG,CAAC;AAEtC,MAAM,GAAG,GAAG,CAAC,CAAS,EAAU,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAE,CAAC,WAAW,EAAE,GAAG,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;AAE9E;;;GAGG;AACH,MAAM,UAAU,SAAS,CAAC,IAA0B,EAAE,KAAmD;IACvG,IAAI,CAAC,IAAI;QAAE,OAAO,eAAe,CAAC;IAClC,MAAM,CAAC,GAAG,IAAI,CAAC,UAAU,EAAE,EAAE,CAAC,CAAC,CAAC,KAAK,CAAC,IAAI,CAAC,UAAU,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;IACtE,IAAI,CAAC;QAAE,OAAO,CAAC,CAAC;IAChB,oHAAoH;IACpH,kHAAkH;IAClH,MAAM,CAAC,GAAG,IAAI,CAAC,MAAM,IAAI,IAAI,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC,CAAC;IAC3C,IAAI,CAAC;QAAE,OAAO,CAAC,CAAC,OAAO,CAAC,QAAQ,EAAE,EAAE,CAAC,CAAC,WAAW,EAAE,CAAC;IACpD,MAAM,CAAC,GAAG,CAAC,IAAI,CAAC,WAAW,IAAI,EAAE,CAAC,CAAC,OAAO,CAAC,0BAA0B,EAAE,EAAE,CAAC,CAAC,KAAK,CAAC,mBAAmB,CAAC,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC;IACvH,OAAO,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,MAAM,GAAG,EAAE,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,EAAE,CAAC;AAClE,CAAC;AAED,+FAA+F;AAC/F,MAAM,UAAU,YAAY,CAAC,CAAW,EAAE,KAA8B,EAAE,KAAmD;IAC3H,MAAM,IAAI,GAAG,CAAC,EAAU,EAAE,EAAE,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,CAAC;IAC5D,MAAM,CAAC,GAAG,CAAC,EAAU,EAAE,EAAE,CAAC,SAAS,CAAC,IAAI,CAAC,EAAE,CAAC,EAAE,KAAK,CAAC,CAAC;IACrD,iGAAiG;IACjG,MAAM,aAAa,GAAG,CAAC,EAAU,EAAE,EAAE,CAAC,CAAC,IAAI,CAAC,EAAE,CAAC,EAAE,UAAU,CAAC;IAC5D,QAAQ,CAAC,CAAC,IAAI,EAAE,CAAC;QACf,KAAK,aAAa,CAAC,CAAC,OAAO,EAAE,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC,KAAK,KAAK,CAAC,CAAC,CAAC,CAAC,6BAA6B,CAAC,CAAC,CAAC,qBAAqB,CAAC,CAAC,KAAK,SAAS,EAAE,CAAC;QACzI,KAAK,aAAa,CAAC,CAAC,OAAO,EAAE,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC,uCAAuC,CAAC,CAAC,CAAC,wBAAwB,EAAE,CAAC;QACrI,KAAK,cAAc,CAAC,CAAC,OAAO,EAAE,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,OAAO,EAAE,CAAC,CAAC,OAAO,EAAE,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC,IAAI,KAAK,eAAe,IAAI,aAAa,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,WAAW,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,8BAA8B,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,EAAE,CAAC;QAC3N,KAAK,gBAAgB,CAAC,CAAC,OAAO,CAAC,CAAC,QAAQ,KAAK,OAAO,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,OAAO,EAAE,CAAC,CAAC,OAAO,EAAE,IAAI,EAAE,CAAC,CAAC,aAAa,CAAC,CAAC,CAAC,uCAAuC,CAAC,CAAC,CAAC,oCAAoC,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC;QAC3M,KAAK,eAAe,CAAC,CAAC,OAAO,EAAE,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,OAAO,EAAE,CAAC,CAAC,OAAO,EAAE,IAAI,EAAE,YAAY,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,OAAO,IAAI,mCAAmC,GAAG,EAAE,CAAC;QACrJ,KAAK,mBAAmB,CAAC,CAAC,OAAO,EAAE,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,OAAO,EAAE,CAAC,CAAC,OAAO,EAAE,IAAI,EAAE,kCAAkC,EAAE,CAAC;QAChH,KAAK,oBAAoB,CAAC,CAAC,OAAO,EAAE,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,OAAO,EAAE,CAAC,CAAC,OAAO,EAAE,IAAI,EAAE,WAAW,EAAE,CAAC;QAC1F,KAAK,iBAAiB,CAAC,CAAC,OAAO,EAAE,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,OAAO,EAAE,CAAC,CAAC,OAAO,EAAE,IAAI,EAAE,mBAAmB,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC,EAAE,GAAG,EAAE,CAAC;QACjI,KAAK,cAAc,CAAC,CAAC,OAAO,EAAE,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,OAAO,EAAE,CAAC,CAAC,OAAO,EAAE,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,IAAI,EAAE,GAAG,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,iBAAiB,EAAE,CAAC;QAC/H,KAAK,aAAa,CAAC,CAAC,OAAO,EAAE,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,OAAO,EAAE,CAAC,CAAC,OAAO,EAAE,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,aAAa,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,GAAG,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,GAAG,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,UAAU,EAAE,CAAC;QACnN,KAAK,cAAc,CAAC,CAAC,OAAO,EAAE,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,OAAO,EAAE,CAAC,CAAC,OAAO,EAAE,IAAI,EAAE,4BAA4B,EAAE,CAAC;QACrG,KAAK,cAAc,CAAC,CAAC,OAAO,EAAE,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,OAAO,EAAE,CAAC,CAAC,OAAO,EAAE,IAAI,EAAE,mDAAmD,EAAE,CAAC;QAC5H,KAAK,cAAc,CAAC,CAAC,OAAO,EAAE,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,IAAI,EAAE,OAAO,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC;QAC5E,KAAK,WAAW,CAAC,CAAC,OAAO,EAAE,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,IAAI,EAAE,4BAA4B,CAAC,CAAC,KAAK,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,GAAG,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC;QAC1H,KAAK,iBAAiB,CAAC,CAAC,OAAO,EAAE,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,OAAO,EAAE,CAAC,CAAC,OAAO,EAAE,IAAI,EAAE,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,iBAAiB,EAAE,CAAC;QAChH,OAAO,CAAC,CAAC,OAAO,IAAI,CAAC;IACvB,CAAC;AACH,CAAC"}

package/dist/run-store.d.ts

@@ -1,210 +0,0 @@
-import type { SuppliedInputV1, Plan, StepReceipt, CommitmentRefV1, RunRecordV1 } from '@agenticprimitives/orchestration';
-import type { DelegationWireV1 } from '@agenticprimitives/a2a';
-import type { Address, Hex } from '@agenticprimitives/types';
-import type { ProgressLineV1 } from './progress.js';
-/** Spec 384 W3 — a campaign's selection, carried on a run's origin: the provider the step is handed to and the offer the
- *  mandate must name. Shapes the plan; no verifier reads it — the verifier reads the mandate. */
-export interface SelectedOfferBindingV1 {
-    type: 'ap.selected-offer-binding.v1';
-    campaignId: string;
-    capability: string;
-    provider: Address;
-    providerName?: string | null;
-    offerId: string;
-    offerDigest: Hex;
-    expiresAt: string;
-}
-export type AwaitingKind = 'data' | 'signature' | 'confirmation' | 'commitment' | 'authority';
-/** One unfinished ask. Small on purpose: what the person said, what they granted, what they answered. */
-export interface HarnessRunCheckpointV1 {
-    runRef: string;
-    /** The sentence. An ask is ONE thing — a different sentence is a different ask and a different intent digest, so it
-     *  may not inherit this run's mandate. */
-    message: string;
-    /** The FULL intent when the run was entered with one (a durable/supplied-plan run). The mandate binds the digest of
-     *  THIS object — rebuilding `{ goal }` from the message alone changes the digest and every mandate mismatches. */
-    intent?: {
-        goal: string;
-        constraints?: Record<string, unknown>;
-        context?: Record<string, unknown>;
-    };
-    /** The realm the ask was addressed to. */
-    addressee: Address;
-    /** WHO asked. Only they may resume: a run carries their session's authority and their answers. */
-    asker: Address;
-    /** THE KEYRING — every mandate this run has been granted, not just the last one (spec 350 W3). Holding a key is not
-     *  holding authority: every wire is re-verified on every turn, and the loop judges each step under exactly ONE
-     *  selected mandate (ADR-0013). A keyring makes the run rememberable, never more permitted. */
-    presented: DelegationWireV1[];
-    /** Everything answered so far, by stepRef. */
-    supplied: SuppliedInputV1[];
-    /** Spec 361 I4 — the caller-supplied plan, when the run was entered deterministically. */
-    plan?: {
-        steps: Array<{
-            toolId: string;
-            args: Record<string, unknown>;
-            id?: string;
-        }>;
-    };
-    /** What the run is waiting for. `expiresAt` (spec 370 P1) is when waiting stops being resumable. */
-    awaiting?: {
-        kind: AwaitingKind;
-        prompt: string;
-        stepRef: string;
-        expiresAt?: number;
-        /** Spec 374 — when `kind` is `commitment`: what another agent owes this run, and where it waits. */
-        commitment?: CommitmentRefV1;
-        /** Spec 385 — an AMBIGUITY choice's scope (word + capability + arg), so the resume that answers it can be
-         *  remembered as a scoped preference. Display/memory only. */
-        scope?: {
-            word: string;
-            capability: string;
-            arg: string;
-        };
-    };
-    /** Spec 370 P1 — WHAT RAN: the admitted plan and the completed steps with their receipts. A resume REPLAYS them
-     *  (spec 362 §0.1 gate 4) and judges the remaining steps as if for the first time. Evidence, never permission. */
-    executed?: {
-        plan: Plan;
-        completed: Array<{
-            stepRef: string;
-            result?: unknown;
-            receipt?: StepReceipt;
-        }>;
-    };
-    /** Spec 370 P5 — started by a TRIGGER of the agent's playbook, not by a person. Display and audit; no gate reads it. */
-    trigger?: {
-        id: string;
-        playbookDigest: string;
-    };
-    /** Spec 372 N1 — started by an OUTSIDE runtime on the standard A2A surface, calling as the agent named. */
-    outsider?: {
-        agent: Address;
-        surface: 'a2a-standard' | 'subject-ask';
-    };
-    /** Spec 374 — a ROUTED ACT another agent's run is waiting on; the correlation is the creditor's (spec 366 R2). */
-    routedFrom?: {
-        creditor: Address;
-        correlation: {
-            operationId: string;
-            runRef: string;
-            stepRef: string;
-        };
-    };
-    /** Spec 374 W2 — where each ROUTED step of this run waits at the subject's agent. */
-    routedAt?: Record<string, {
-        agent: Address;
-        name?: string;
-        runRef: string;
-    }>;
-    /** Spec 370 P1 tail — when this run stops being resumable. Absent on older rows ⇒ `updatedAt`-based. */
-    expiresAt?: number;
-    /** A WORK ITEM nobody has picked up: `asker` is the principal, and any steward who can mint the mandate may claim it. */
-    openToStewards?: boolean;
-    /** The plan step this run exists to satisfy. When it completes, the step's evidence is its RECEIPT. */
-    origin?: {
-        endeavorId: string;
-        stepId: string;
-        principal: Address;
-        commitmentRef?: string;
-        planHash?: string;
-        engagement?: SelectedOfferBindingV1;
-    };
-    /** Spec 362 — WHICH ENGINE advances this run. ONE executor per run, never a fallback pair. */
-    executor?: 'client' | 'workflow';
-    /** Spec 400 W2 (B3) — the THREAD this run belongs to, when a message on that thread opened it. */
-    thread?: string;
-    /** Spec 409 §5 — the SENDER whose message opened this run on its thread; only they continue it by words. */
-    threadPeer?: string;
-    createdAt: number;
-    updatedAt: number;
-}
-/** One unfinished run as a LISTING shows it — everything but the keyring. A list says that something is waiting and
- *  what it waits for; it never hands out the mandates, which only a resume does and only to whoever may resume. */
-export type SuspendedRunV1 = Omit<HarnessRunCheckpointV1, 'presented'>;
-/** THE PORT. What the harness turn and the `/harness/runs` route code against; nothing here names a binding. */
-export interface RunStore {
-    save(checkpoint: HarnessRunCheckpointV1): Promise<void>;
-    load(addressee: Address, runRef: string): Promise<HarnessRunCheckpointV1 | null>;
-    /** The unfinished runs on this agent — ALL of them, keyring stripped. Who may see which is the caller's decision. */
-    list(addressee: Address): Promise<SuspendedRunV1[]>;
-    /** A run that reached a terminal outcome leaves nothing behind: done is done, and a denial is terminal (ADR-0013). */
-    drop(addressee: Address, runRef: string): Promise<void>;
-    /** Spec 370 P2 — the run's progress lines. `asker` is recorded with the first line and gates every read. */
-    appendProgress(addressee: Address, runRef: string, asker: Address, line: Omit<ProgressLineV1, 'seq' | 'at'> & {
-        at?: number;
-    }): Promise<{
-        seq: number;
-    }>;
-    readProgress(addressee: Address, runRef: string, asker: Address, after?: number): Promise<{
-        known: boolean;
-        lines: ProgressLineV1[];
-        terminal: boolean;
-    }>;
-}
-/** Spec 400 W2 (B3) — THE OPEN RUN ON A THREAD: the newest unexpired run on `thread` that waits for DATA. A run waiting
- *  on a signature, a commitment or authority is not resumable by words, and a mention leaves it where it is. */
-export declare function openRunOnThread(runs: readonly SuspendedRunV1[], thread: string, now?: number): SuspendedRunV1 | null;
-/** Merge a turn's inputs over the checkpoint. The stored answers come FIRST so a resend of the same stepRef adds rather
- *  than replaces. THE KEYRING GROWS, NEWEST FIRST: this turn's mandates go in front (a re-grant is reached first), the
- *  older keys stay for the items they were granted for; a re-grant has a fresh salt and never dedups the one it
- *  supersedes. */
-export declare function mergeTurn(stored: HarnessRunCheckpointV1 | null, turn: {
-    message?: string;
-    presented?: DelegationWireV1 | DelegationWireV1[] | null;
-    supplied?: SuppliedInputV1[];
-}): {
-    message: string;
-    presented: DelegationWireV1[];
-    supplied: SuppliedInputV1[];
-} | {
-    error: string;
-};
-/** How long a wait stays resumable (spec 370 P1). A signature or a confirmation answers a mandate minted for the request
- *  — minutes, not days; a data question may wait two hours; a commitment waits on ANOTHER agent's steward — a day. */
-export declare const AWAIT_WINDOW_MS: Record<AwaitingKind, number>;
-/** A day: well past the point of resumability for any run, whatever it waits for. */
-export declare const RUN_TTL_MS: number;
-/** Past its window: resumable no longer. Absent window ⇒ a data question keeps the day; anything else is stale after
- *  the same half hour a new row would get. */
-export declare function isExpired(cp: Pick<HarnessRunCheckpointV1, 'awaiting' | 'expiresAt' | 'updatedAt'>, now?: number): boolean;
-/** The window a run keeps from the moment it stopped: the prompt's own, else the authority window. */
-export declare function expiryFor(awaiting: HarnessRunCheckpointV1['awaiting'] | undefined, now?: number): number;
-/**
- * THE LISTING RULE, shared by every store. An unfinished run expires: after `RUN_TTL_MS` regardless, or past its own
- * window (spec 370 P1 tail) — a run a person walked away from is gone from the list, not shown as unfinished (one estate
- * reached 167 of them). Mandates are bearer-shaped wires and enumeration is a LISTING, not a resume, so the keyring
- * never rides along. Returns what is live and which keys the store may delete.
- */
-export declare function liveRuns<K>(rows: ReadonlyArray<readonly [K, HarnessRunCheckpointV1]>, now?: number): {
-    live: SuspendedRunV1[];
-    expired: K[];
-};
-/** The completed steps of a run result, as a checkpoint records them — successful, named, with their receipt. A failed
- *  or suspended step is not "done" and is not replayed. */
-export declare function completedStepsOf(result: {
-    steps: ReadonlyArray<{
-        ok: boolean;
-        stepRef?: string;
-        result?: unknown;
-    }>;
-    receipts: ReadonlyArray<StepReceipt>;
-}): NonNullable<HarnessRunCheckpointV1['executed']>['completed'];
-/**
- * Spec 398 §5.3 — THE RECORD OF A CANCELED RUN. The turn's record is kept and MARKED (never rewritten as failed: nothing
- * went wrong); a record that never landed is synthesised from the checkpoint — what ran, what it left, nothing invented.
- */
-export declare function canceledRecord(existing: RunRecordV1 | null, stored: Pick<HarnessRunCheckpointV1, 'runRef' | 'message' | 'intent' | 'executed'>, by: {
-    at: number;
-    by: Address;
-    note?: string;
-}): RunRecordV1 & {
-    canceled: NonNullable<RunRecordV1['canceled']>;
-};
-export type RunStoreOp = 'save' | 'load' | 'drop' | 'list' | 'progress-append' | 'progress-read';
-/** One call to the agent's own store: the Cloudflare adapter sends it to the agent's DO stub; a Node binding to its own
- *  process. The core never names the transport. */
-export type RunStoreCall = (agent: Address, op: RunStoreOp, body: Record<string, unknown>) => Promise<Record<string, unknown>>;
-/** A `RunStore` over one `call`. The op names and bodies are the contract `runStorage` (the DO side) answers. */
-export declare function runStoreOver(call: RunStoreCall): RunStore;
-//# sourceMappingURL=run-store.d.ts.map

package/dist/run-store.d.ts.map

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

package/dist/run-store.js

@@ -1,132 +0,0 @@
-/** Spec 400 W2 (B3) — THE OPEN RUN ON A THREAD: the newest unexpired run on `thread` that waits for DATA. A run waiting
- *  on a signature, a commitment or authority is not resumable by words, and a mention leaves it where it is. */
-export function openRunOnThread(runs, thread, now = Date.now()) {
-    return runs
-        .filter((r) => r.thread === thread && r.awaiting?.kind === 'data' && !isExpired(r, now))
-        .sort((a, b) => b.updatedAt - a.updatedAt)[0] ?? null;
-}
-/** A wire's identity WITHIN one run: delegator + delegate + salt. Not a security check — it dedups a list; every wire
- *  is verified on chain regardless. */
-const wireKey = (w) => `${String(w.delegator).toLowerCase()}:${String(w.delegate).toLowerCase()}:${String(w.salt)}`;
-const asList = (p) => (p == null ? [] : Array.isArray(p) ? p : [p]);
-/** Merge a turn's inputs over the checkpoint. The stored answers come FIRST so a resend of the same stepRef adds rather
- *  than replaces. THE KEYRING GROWS, NEWEST FIRST: this turn's mandates go in front (a re-grant is reached first), the
- *  older keys stay for the items they were granted for; a re-grant has a fresh salt and never dedups the one it
- *  supersedes. */
-export function mergeTurn(stored, turn) {
-    const message = (turn.message ?? stored?.message ?? '').trim();
-    if (!message)
-        return { error: 'this run has no question and none was given' };
-    if (stored && turn.message && turn.message.trim() !== stored.message) {
-        // The mandate is bound to the intent digest, so a changed sentence would be denied a step later with
-        // `intent-mismatch`. Saying it here names the actual mistake instead of a hash comparison.
-        return { error: 'this run was started for a different question — ask it as a new one rather than changing this one mid-way' };
-    }
-    const keyring = [];
-    const seen = new Set();
-    for (const w of [...asList(turn.presented), ...asList(stored?.presented)]) {
-        const k = wireKey(w);
-        if (seen.has(k))
-            continue;
-        seen.add(k);
-        keyring.push(w);
-    }
-    return { message, presented: keyring, supplied: [...(stored?.supplied ?? []), ...(turn.supplied ?? [])] };
-}
-/** How long a wait stays resumable (spec 370 P1). A signature or a confirmation answers a mandate minted for the request
- *  — minutes, not days; a data question may wait two hours; a commitment waits on ANOTHER agent's steward — a day. */
-export const AWAIT_WINDOW_MS = {
-    data: 2 * 3600_000, signature: 30 * 60_000, confirmation: 30 * 60_000, authority: 30 * 60_000, commitment: 24 * 3600_000,
-};
-/** A day: well past the point of resumability for any run, whatever it waits for. */
-export const RUN_TTL_MS = 24 * 60 * 60 * 1000;
-/** Past its window: resumable no longer. Absent window ⇒ a data question keeps the day; anything else is stale after
- *  the same half hour a new row would get. */
-export function isExpired(cp, now = Date.now()) {
-    if (typeof cp.awaiting?.expiresAt === 'number')
-        return cp.awaiting.expiresAt < now;
-    if (typeof cp.expiresAt === 'number')
-        return cp.expiresAt < now;
-    if (cp.awaiting?.kind === 'data')
-        return false;
-    return typeof cp.updatedAt === 'number' && now - cp.updatedAt > AWAIT_WINDOW_MS.signature;
-}
-/** The window a run keeps from the moment it stopped: the prompt's own, else the authority window. */
-export function expiryFor(awaiting, now = Date.now()) {
-    return now + (awaiting ? AWAIT_WINDOW_MS[awaiting.kind] : AWAIT_WINDOW_MS.signature);
-}
-/**
- * THE LISTING RULE, shared by every store. An unfinished run expires: after `RUN_TTL_MS` regardless, or past its own
- * window (spec 370 P1 tail) — a run a person walked away from is gone from the list, not shown as unfinished (one estate
- * reached 167 of them). Mandates are bearer-shaped wires and enumeration is a LISTING, not a resume, so the keyring
- * never rides along. Returns what is live and which keys the store may delete.
- */
-export function liveRuns(rows, now = Date.now()) {
-    const live = [];
-    const expired = [];
-    for (const [key, run] of rows) {
-        const updatedAt = Number(run.updatedAt ?? 0);
-        if (updatedAt && now - updatedAt > RUN_TTL_MS) {
-            expired.push(key);
-            continue;
-        }
-        if (isExpired(run, now)) {
-            expired.push(key);
-            continue;
-        }
-        const { presented: _presented, ...rest } = run;
-        live.push(rest);
-    }
-    return { live, expired };
-}
-/** The completed steps of a run result, as a checkpoint records them — successful, named, with their receipt. A failed
- *  or suspended step is not "done" and is not replayed. */
-export function completedStepsOf(result) {
-    return result.steps
-        .filter((o) => o.ok && o.stepRef)
-        .map((o) => {
-        const receipt = result.receipts.find((r) => r.stepRef === o.stepRef);
-        return { stepRef: o.stepRef, ...(o.result !== undefined ? { result: o.result } : {}), ...(receipt ? { receipt } : {}) };
-    });
-}
-/**
- * Spec 398 §5.3 — THE RECORD OF A CANCELED RUN. The turn's record is kept and MARKED (never rewritten as failed: nothing
- * went wrong); a record that never landed is synthesised from the checkpoint — what ran, what it left, nothing invented.
- */
-export function canceledRecord(existing, stored, by) {
-    const completed = stored.executed?.completed ?? [];
-    const base = existing ?? {
-        type: 'ap.run-record.v1', runRef: stored.runRef, at: by.at,
-        intent: stored.intent ?? { goal: stored.message },
-        plan: stored.executed?.plan ?? { steps: [] },
-        steps: completed.map((x) => ({ stepRef: x.stepRef, toolId: x.receipt?.toolId ?? '', args: {}, ok: true, ...(x.result !== undefined ? { result: x.result } : {}) })),
-        receipts: completed.flatMap((x) => (x.receipt ? [x.receipt] : [])),
-        events: [], outcome: 'suspended',
-    };
-    const note = by.note?.trim() ? by.note.trim().slice(0, 280) : undefined;
-    return { ...base, canceled: { at: by.at, by: by.by, afterSteps: completed.length, ...(note ? { note } : {}) } };
-}
-/** A `RunStore` over one `call`. The op names and bodies are the contract `runStorage` (the DO side) answers. */
-export function runStoreOver(call) {
-    return {
-        async save(checkpoint) { await call(checkpoint.addressee, 'save', { checkpoint }); },
-        async load(addressee, runRef) {
-            const out = await call(addressee, 'load', { runRef });
-            return out.checkpoint ?? null;
-        },
-        async list(addressee) {
-            const out = await call(addressee, 'list', {});
-            return out.runs ?? [];
-        },
-        async drop(addressee, runRef) { await call(addressee, 'drop', { runRef }); },
-        async appendProgress(addressee, runRef, asker, line) {
-            const out = await call(addressee, 'progress-append', { runRef, asker, line });
-            return { seq: Number(out.seq ?? 0) };
-        },
-        async readProgress(addressee, runRef, asker, after = 0) {
-            const out = await call(addressee, 'progress-read', { runRef, asker, after });
-            return { known: out.known === true, lines: out.lines ?? [], terminal: out.terminal === true };
-        },
-    };
-}
-//# sourceMappingURL=run-store.js.map

package/dist/run-store.js.map

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

package/dist/storage.d.ts

@@ -1,54 +0,0 @@
-import { liveRuns, type HarnessRunCheckpointV1, type RunStoreOp } from './run-store.js';
-import { type ProgressLineV1 } from './progress.js';
-/** The slice of a key/value store the run storage needs. `DurableObjectStorage` satisfies it directly. */
-export interface RunKv {
-    get<T = unknown>(key: string): Promise<T | undefined>;
-    put<T = unknown>(key: string, value: T): Promise<void>;
-    delete(key: string | string[]): Promise<unknown>;
-    list<T = unknown>(opts: {
-        prefix: string;
-    }): Promise<Map<string, T>>;
-}
-export declare const RUN_KEY_PREFIX = "harness:run:";
-export declare const PROGRESS_KEY_PREFIX = "harness:progress:";
-export type RunStorageResult = {
-    ok: true;
-} & Record<string, unknown> | {
-    ok: false;
-    error: string;
-    status: number;
-};
-export interface RunStorage {
-    /** One handler for every op; the Cloudflare DO routes `/internal/harness-run/<op>` here. */
-    handle(op: RunStoreOp | string, body: Record<string, unknown> | null | undefined, now?: number): Promise<RunStorageResult>;
-    /** The ops individually, for a binding that prefers typed calls. */
-    save(checkpoint: HarnessRunCheckpointV1): Promise<void>;
-    load(runRef: string): Promise<HarnessRunCheckpointV1 | null>;
-    /** Live runs, newest first; `expired` counts the rows this call deleted. */
-    list(now?: number): Promise<ReturnType<typeof liveRuns<string>>['live'] & {
-        expired: number;
-    }>;
-    drop(runRef: string): Promise<void>;
-    appendProgress(runRef: string, asker: string, line: Omit<ProgressLineV1, 'seq' | 'at'> & {
-        at?: number;
-    }, now?: number): Promise<{
-        seq: number;
-    } | {
-        error: string;
-        status: number;
-    }>;
-    readProgress(runRef: string, asker: string, after?: number): Promise<{
-        known: boolean;
-        lines: ProgressLineV1[];
-        terminal: boolean;
-    } | {
-        error: string;
-        status: number;
-    }>;
-}
-export declare function runStorage(kv: RunKv): RunStorage;
-/** An in-memory `RunKv` — tests, and a single-process host. */
-export declare function memoryRunKv(): RunKv;
-/** A `RunStore` over an in-memory storage, one agent per key space — a single-process host or a test. */
-export declare function memoryRunStoreCall(): import('./run-store.js').RunStoreCall;
-//# sourceMappingURL=storage.d.ts.map

package/dist/storage.d.ts.map

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

package/dist/storage.js

@@ -1,126 +0,0 @@
-// THE STORE'S OWN SIDE — what answers a `RunStoreCall`, over a minimal key/value storage (census §2: the checkpoint and
-// progress ops of the runtime's `A2aTaskDO`, carved out of the class). Pure over `RunKv`, so a Durable Object's storage
-// (`./cloudflare`), an in-memory map (tests) or a Node store bind it unchanged. The op names and bodies are the
-// contract `runStoreOver` sends.
-import { liveRuns } from './run-store.js';
-import { PROGRESS_MAX_LINES, PROGRESS_TTL_MS } from './progress.js';
-export const RUN_KEY_PREFIX = 'harness:run:';
-export const PROGRESS_KEY_PREFIX = 'harness:progress:';
-const runKey = (ref) => `${RUN_KEY_PREFIX}${ref}`;
-const progressKey = (ref) => `${PROGRESS_KEY_PREFIX}${ref}`;
-export function runStorage(kv) {
-    const save = async (cp) => { await kv.put(runKey(cp.runRef), cp); };
-    const load = async (runRef) => (await kv.get(runKey(runRef))) ?? null;
-    const drop = async (runRef) => { await kv.delete(runKey(runRef)); };
-    // ENUMERATE the unfinished runs. The store returns them all; WHOSE they are is decided by the caller's session at the
-    // route (a person sees their own; a steward additionally sees the unclaimed work items). Expiry is applied here,
-    // wherever the cost of a list is already being paid, rather than on a timer; and the progress lines a run left
-    // behind outlive it by `PROGRESS_TTL_MS` at most.
-    const list = async (now = Date.now()) => {
-        const rows = [...(await kv.list({ prefix: RUN_KEY_PREFIX }))];
-        const { live, expired } = liveRuns(rows, now);
-        const stale = [...(await kv.list({ prefix: PROGRESS_KEY_PREFIX }))].filter(([, v]) => now - Number(v?.at ?? 0) > PROGRESS_TTL_MS).map(([k]) => k);
-        const gone = [...expired, ...stale];
-        if (gone.length)
-            await kv.delete(gone);
-        // Newest first — the order every listing surface shows, so a consumer never re-sorts.
-        live.sort((a, b) => Number(b.updatedAt ?? 0) - Number(a.updatedAt ?? 0));
-        return Object.assign(live, { expired: expired.length });
-    };
-    const appendProgress = async (runRef, asker, line, now = Date.now()) => {
-        const cur = (await kv.get(progressKey(runRef))) ?? { asker, at: now, lines: [] };
-        if (cur.asker !== asker)
-            return { error: 'this run belongs to someone else', status: 403 };
-        // ONE SEQUENCE PER RUN, assigned here: a reader keeps its cursor across turns. Spec 418 A1 — a streamed answer's
-        // drafts REPLACE each other (same step): the list keeps the latest, under a new seq.
-        const last = cur.lines[cur.lines.length - 1];
-        const seq = (last?.seq ?? 0) + 1;
-        const next = { ...line, at: line.at ?? now, seq };
-        if (next.type === 'AnswerDraft' && last?.type === 'AnswerDraft' && last.stepRef === next.stepRef)
-            cur.lines[cur.lines.length - 1] = next;
-        else if (cur.lines.length < PROGRESS_MAX_LINES)
-            cur.lines.push(next);
-        cur.at = now;
-        await kv.put(progressKey(runRef), cur);
-        return { seq };
-    };
-    const readProgress = async (runRef, asker, after = 0) => {
-        const cur = await kv.get(progressKey(runRef));
-        if (!cur)
-            return { known: false, lines: [], terminal: false };
-        if (cur.asker !== asker)
-            return { error: 'this run belongs to someone else', status: 403 };
-        // Terminal = the LAST line says so: a new turn's lines after a reply make the run live again.
-        const last = cur.lines[cur.lines.length - 1];
-        return { known: true, lines: cur.lines.filter((l) => l.seq > after), terminal: !!last?.terminal };
-    };
-    const bad = (error, status = 400) => ({ ok: false, error, status });
-    return {
-        save, load, list, drop, appendProgress, readProgress,
-        async handle(op, body, now = Date.now()) {
-            const b = body ?? {};
-            switch (op) {
-                case 'save': {
-                    const cp = b.checkpoint;
-                    if (!cp?.runRef || !cp.addressee || !cp.asker)
-                        return bad('checkpoint with runRef, addressee and asker required');
-                    await save(cp);
-                    return { ok: true };
-                }
-                case 'load': {
-                    if (!b.runRef)
-                        return bad('runRef required');
-                    return { ok: true, checkpoint: await load(String(b.runRef)) };
-                }
-                case 'drop': {
-                    if (!b.runRef)
-                        return bad('runRef required');
-                    await drop(String(b.runRef));
-                    return { ok: true };
-                }
-                case 'list': {
-                    const runs = await list(now);
-                    return { ok: true, runs: [...runs], expired: runs.expired };
-                }
-                case 'progress-append': {
-                    if (!b.runRef || !b.line || !b.asker)
-                        return bad('runRef, asker and line required');
-                    const r = await appendProgress(String(b.runRef), String(b.asker), b.line, now);
-                    return 'error' in r ? bad(r.error, r.status) : { ok: true, seq: r.seq };
-                }
-                case 'progress-read': {
-                    if (!b.runRef || !b.asker)
-                        return bad('runRef and asker required');
-                    const r = await readProgress(String(b.runRef), String(b.asker), Number(b.after ?? 0));
-                    return 'error' in r ? bad(r.error, r.status) : { ok: true, ...r };
-                }
-                default: return bad(`unknown harness-run op "${op}"`, 404);
-            }
-        },
-    };
-}
-/** An in-memory `RunKv` — tests, and a single-process host. */
-export function memoryRunKv() {
-    const m = new Map();
-    return {
-        async get(key) { return m.get(key); },
-        async put(key, value) { m.set(key, value); },
-        async delete(key) { for (const k of Array.isArray(key) ? key : [key])
-            m.delete(k); },
-        async list({ prefix }) { return new Map([...m].filter(([k]) => k.startsWith(prefix))); },
-    };
-}
-/** A `RunStore` over an in-memory storage, one agent per key space — a single-process host or a test. */
-export function memoryRunStoreCall() {
-    const perAgent = new Map();
-    return async (agent, op, body) => {
-        const a = agent.toLowerCase();
-        const s = perAgent.get(a) ?? runStorage(memoryRunKv());
-        perAgent.set(a, s);
-        const r = await s.handle(op, body);
-        if (!r.ok)
-            throw new Error(r.error);
-        return r;
-    };
-}
-//# sourceMappingURL=storage.js.map

package/dist/storage.js.map

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

package/spec.md

@@ -1,4 +0,0 @@
-# service-host — the harness a service agent embeds
-
-**Status:** w1-run-store. **Spec of record:** [spec 433](../../specs/433-service-apps-run-the-harness-service-host.md).
-**Census (what moves here, from where):** [`docs/architecture/service-host-census.md`](../../docs/architecture/service-host-census.md).