@alma-harness/runtime 0.7.0 → 0.8.0

package/README.md

@@ -1,8 +1,72 @@
 # @alma-harness/runtime
 
-Official storage composition for `createConversationRunner`. This package wires
-existing stores; the host still supplies clients, audit, policy, prices, caps,
-revisions and limits. The root export contains types only.
+Official storage composition and a simple text conversation facade. The root
+export contains types only. Use `/agent` for query/resume, `/memory` or `/postgres`
+for storage, and the lower-level `createConversationRunner` for advanced routing.
+
+## Start and resume a conversation
+
+Configure once, then bind the authenticated user on the server:
+
+```ts
+import { createConversationAgent } from '@alma-harness/runtime/agent';
+
+const agent = createConversationAgent({
+  id: 'assistant', revision: 'v1', runtime,
+  model: { ref: model, client, prices },
+  instructions: 'You are a helpful assistant.',
+  intent: { tier: 'standard', sensitivity: 'personal' },
+  limits: { caps: { perTurnUsd: 0.25 }, retentionMs: 60_000 },
+  audit, onBackgroundError: reportAccountingIssue,
+});
+const user = agent.forUser({ org, uid }); // verified by the host
+const first = await user.query({ prompt: 'Hello', messageId: 'delivery-1' });
+if (first.view.status === 'completed') {
+  const next = await user.query({
+    resume: first.sessionId, prompt: 'Continue', messageId: 'delivery-2',
+  });
+  // Inspect next.view.status before using its result.
+}
+const observed = await user.read({ sessionId: first.sessionId, messageId: 'delivery-1' });
+```
+
+The complete [quickstart](../../examples/quickstart/src/agent.ts) shows storage,
+tools and configuration. The facade wires all stores, one model's routing and
+internal versions; it does not own/close the supplied runtime. Optional `tools`,
+`hooks` and `volatile` configure trusted behavior. Model/client/prices, audit,
+intent, budget and retention remain explicit deployment choices. Keep one
+immutable revision for the entire configuration, including trusted capabilities.
+Changing behavior requires a new revision; admitted retries still conflict.
+
+Technical defaults are versioned: 120s timeout, 24 calls, 64,000 input characters,
+1,000,000 request characters and 100,000 output characters. Override through
+`limits.runTimeoutMs/maxCalls/maxInputChars/maxRequestChars/maxOutputChars`.
+Runtime result policies must accommodate the chosen retention, sensitivity and
+output envelopes. The facade never widens those policies or guesses model prices.
+
+`resume` selects existing history within the bound scope; it is not automatic
+execution recovery. Unknown/foreign sessions throw `ConversationResumeError`
+(`code: conversation_resume_not_found`) without creating a replacement. The host
+must authorize the selected session; an ID is not an access credential. Different
+agents can explicitly share a session within that authorized scope.
+
+For the initial message, session ID derives from agent ID, scope and messageId.
+Exported `conversationAgentSessionId(id,scope,messageId)` obtains it before I/O.
+Repeat the original no-resume request if its response was lost. For subsequent
+messages, repeat the same resume/messageId/prompt. IDs are scoped to a conversation;
+there is no cross-session membership deduplication. Namespace/hash raw transport
+IDs into the official bounded identifiers when needed.
+
+Every query returns `{sessionId,messageId,rootKey,view}`. `view` is the unchanged
+canonical result, including busy, not_admitted, in_progress, unavailable and
+reconciliation_required. `read` can return a null view and never dispatches.
+Input that was not admitted is still the host's responsibility; this facade adds
+no durable input queue, retry, ACK, scheduler or erasure barrier. Existing operator
+and multi-surface erasure procedures remain required. Execution `signal` is not a
+socket-close signal. Advanced media/multi-provider/streaming callers retain the
+canonical runner API below; query currently returns a buffered final view.
+
+## Explicit runner composition
 
 ```ts
 import { createMemoryRuntime } from '@alma-harness/runtime/memory';

package/dist/agent.d.ts

@@ -0,0 +1,66 @@
+import { Scope, ModelRef, SingleDispatchModelClient, ModelPrice } from '@alma-harness/core';
+import { ConversationView, ConversationConfig, SimpleConversationInput } from '@alma-harness/conversation';
+import { Runtime } from './index.js';
+
+interface ConversationAgentOptions {
+    id: string;
+    /** Immutable host configuration: includes prices, tools and trusted callbacks. */
+    revision: string;
+    runtime: Runtime;
+    model: {
+        ref: ModelRef;
+        client: SingleDispatchModelClient;
+        prices: ModelPrice[];
+    };
+    instructions: string;
+    audit: ConversationConfig["step"]["audit"];
+    intent: SimpleConversationInput["intent"];
+    tools?: ConversationConfig["tools"];
+    hooks?: ConversationConfig["hooks"];
+    volatile?: ConversationConfig["volatile"];
+    limits: {
+        caps: ConversationConfig["caps"];
+        retentionMs: number;
+        runTimeoutMs?: number;
+        maxCalls?: number;
+        maxInputChars?: number;
+        maxRequestChars?: number;
+        maxOutputChars?: number;
+    };
+    onBackgroundError: ConversationConfig["step"]["onBackgroundError"];
+}
+interface ConversationQuery {
+    prompt: string;
+    messageId: string;
+    resume?: string;
+    signal?: AbortSignal;
+}
+interface ConversationQueryKey {
+    sessionId: string;
+    messageId: string;
+}
+interface ConversationQueryResult extends ConversationQueryKey {
+    rootKey: string;
+    view: ConversationView;
+}
+interface ConversationQueryObservation extends ConversationQueryKey {
+    rootKey: string;
+    view: ConversationView | null;
+}
+interface UserConversationAgent {
+    query(input: ConversationQuery): Promise<ConversationQueryResult>;
+    read(key: ConversationQueryKey): Promise<ConversationQueryObservation>;
+}
+interface ConversationAgent {
+    forUser(scope: Scope): UserConversationAgent;
+}
+declare class ConversationResumeError extends Error {
+    readonly code = "conversation_resume_not_found";
+    constructor();
+}
+/** Deterministic even when the first response was lost. Never derives identity from text or revision. */
+declare function conversationAgentSessionId(agentId: string, scope: Scope, messageId: string): string;
+/** A text facade over the canonical engine. Owns no stores, pools, retries or session registry. */
+declare function createConversationAgent(value: ConversationAgentOptions): ConversationAgent;
+
+export { type ConversationAgent, type ConversationAgentOptions, type ConversationQuery, type ConversationQueryKey, type ConversationQueryObservation, type ConversationQueryResult, ConversationResumeError, type UserConversationAgent, conversationAgentSessionId, createConversationAgent };

package/dist/agent.js

@@ -0,0 +1,113 @@
+// src/agent.ts
+import { createHash } from "crypto";
+import { settlementIdentifier, settlementScope } from "@alma-harness/core";
+import { conversationRootKey, createConversationDescriptor, createConversationRunner } from "@alma-harness/conversation";
+var FORMAT = "conversation-agent-v1";
+var digest = (parts) => createHash("sha256").update(JSON.stringify(parts)).digest("hex");
+var ConversationResumeError = class extends Error {
+  code = "conversation_resume_not_found";
+  constructor() {
+    super("Conversation session not found in the bound scope");
+    this.name = "ConversationResumeError";
+  }
+};
+function fields(value, allowed) {
+  if (!value || typeof value !== "object" || ![Object.prototype, null].includes(Object.getPrototypeOf(value))) throw new TypeError("Invalid conversation agent input");
+  return Object.fromEntries(Reflect.ownKeys(value).map((key) => {
+    const d = Object.getOwnPropertyDescriptor(value, key);
+    if (typeof key !== "string" || !allowed.includes(key) || !d.enumerable || !("value" in d)) throw new TypeError("Invalid conversation agent field");
+    return [key, d.value];
+  }));
+}
+var scopeCopy = (value) => settlementScope(fields(value, ["org", "uid"]));
+function conversationAgentSessionId(agentId, scope, messageId) {
+  const s = scopeCopy(scope);
+  return `agent-session-v1:${digest(["agent-session-v1", settlementIdentifier(agentId), s.org, s.uid, settlementIdentifier(messageId)])}`;
+}
+function createConversationAgent(value) {
+  const options = fields(value, ["id", "revision", "runtime", "model", "instructions", "audit", "intent", "tools", "hooks", "volatile", "limits", "onBackgroundError"]);
+  const id = settlementIdentifier(options.id), revision = settlementIdentifier(options.revision);
+  const model = fields(options.model, ["ref", "client", "prices"]);
+  const ref = structuredClone(model.ref), intent = structuredClone(options.intent);
+  const limits = fields(options.limits, ["caps", "retentionMs", "runTimeoutMs", "maxCalls", "maxInputChars", "maxRequestChars", "maxOutputChars"]);
+  if (!["anthropic", "openai", "openrouter"].includes(ref.provider)) throw new TypeError("Invalid conversation model provider");
+  settlementIdentifier(ref.id);
+  for (const key of ["runTimeoutMs", "maxCalls", "maxInputChars", "maxRequestChars", "maxOutputChars"]) {
+    const n = limits[key];
+    if (n !== void 0 && (!Number.isSafeInteger(n) || n < 1)) throw new TypeError("Invalid conversation agent limit");
+  }
+  if (limits.caps === void 0 || limits.caps === null) throw new TypeError("Explicit conversation budget required");
+  if (typeof options.instructions !== "string" || typeof options.onBackgroundError !== "function") throw new TypeError("Conversation instructions and error observer are required");
+  const version = `${FORMAT}:${digest([FORMAT, id, revision])}`;
+  const runTimeoutMs = limits.runTimeoutMs ?? 12e4;
+  const config = {
+    ...options.runtime.stores,
+    system: [{ text: options.instructions, volatility: "stable" }],
+    policy: { resolve: () => ({ model: { ...ref }, rationale: "configured conversation agent model" }) },
+    prices: structuredClone(model.prices),
+    caps: structuredClone(limits.caps),
+    consumers: [],
+    policyVersion: version,
+    priceVersion: version,
+    configRevision: version,
+    resultContractVersion: FORMAT,
+    resultRetentionMs: limits.retentionMs,
+    runTimeoutMs,
+    maxCalls: limits.maxCalls ?? 24,
+    maxInputChars: limits.maxInputChars ?? 64e3,
+    ...options.tools !== void 0 ? { tools: options.tools } : {},
+    ...options.hooks !== void 0 ? { hooks: options.hooks } : {},
+    ...options.volatile !== void 0 ? { volatile: options.volatile } : {},
+    step: {
+      ...options.runtime.stores.step,
+      clients: { [ref.provider]: model.client },
+      audit: options.audit,
+      runTimeoutMs,
+      maxRequestChars: limits.maxRequestChars ?? 1e6,
+      maxOutputChars: limits.maxOutputChars ?? 1e5,
+      onBackgroundError: options.onBackgroundError
+    }
+  };
+  createConversationDescriptor(config, {
+    scope: { org: "validation", uid: "validation" },
+    sessionId: "validation",
+    idempotencyKey: "validation",
+    input: { role: "user", blocks: [] },
+    intent
+  }, new Date(Date.now() + runTimeoutMs).toISOString());
+  const runner = createConversationRunner(config), admissions = options.runtime.stores.admissions;
+  return { forUser(value2) {
+    const scope = scopeCopy(value2);
+    return {
+      async query(value3) {
+        const q = fields(value3, ["prompt", "messageId", "resume", "signal"]);
+        const messageId = settlementIdentifier(q.messageId);
+        const sessionId = q.resume === void 0 ? conversationAgentSessionId(id, scope, messageId) : settlementIdentifier(q.resume);
+        if (typeof q.prompt !== "string" || q.prompt.length > config.maxInputChars) throw new TypeError("Invalid conversation prompt");
+        const input = {
+          scope: { ...scope },
+          sessionId,
+          idempotencyKey: messageId,
+          input: { role: "user", blocks: [{ type: "text", text: q.prompt }] },
+          intent: structuredClone(intent),
+          ...q.signal !== void 0 ? { signal: q.signal } : {}
+        };
+        const root = createConversationDescriptor(config, input, new Date(Date.now() + runTimeoutMs).toISOString());
+        if (q.resume !== void 0 && !(await admissions.list({ ...scope }, sessionId, { limit: 1 })).length) throw new ConversationResumeError();
+        return { sessionId, messageId, rootKey: root.key, view: await runner.runTurn(input) };
+      },
+      async read(value3) {
+        const key = fields(value3, ["sessionId", "messageId"]);
+        const sessionId = settlementIdentifier(key.sessionId), messageId = settlementIdentifier(key.messageId);
+        const rootKey = conversationRootKey(scope, sessionId, messageId);
+        return { sessionId, messageId, rootKey, view: await runner.read({ ...scope }, rootKey) };
+      }
+    };
+  } };
+}
+export {
+  ConversationResumeError,
+  conversationAgentSessionId,
+  createConversationAgent
+};
+//# sourceMappingURL=agent.js.map

package/dist/agent.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/agent.ts"],"sourcesContent":["import { createHash } from \"node:crypto\";\nimport { settlementIdentifier, settlementScope, type ModelPrice, type ModelRef, type Scope, type SingleDispatchModelClient } from \"@alma-harness/core\";\nimport { conversationRootKey, createConversationDescriptor, createConversationRunner, type ConversationConfig, type ConversationView, type SimpleConversationInput } from \"@alma-harness/conversation\";\nimport type { Runtime } from \"./index\";\n\n// DECISION: default changes require a format bump, preserving admitted bindings.\nconst FORMAT = \"conversation-agent-v1\";\nconst digest = (parts: unknown[]) => createHash(\"sha256\").update(JSON.stringify(parts)).digest(\"hex\");\nexport interface ConversationAgentOptions {\n  id: string;\n  /** Immutable host configuration: includes prices, tools and trusted callbacks. */\n  revision: string;\n  runtime: Runtime;\n  model: { ref: ModelRef; client: SingleDispatchModelClient; prices: ModelPrice[] };\n  instructions: string;\n  audit: ConversationConfig[\"step\"][\"audit\"];\n  intent: SimpleConversationInput[\"intent\"];\n  tools?: ConversationConfig[\"tools\"];\n  hooks?: ConversationConfig[\"hooks\"];\n  volatile?: ConversationConfig[\"volatile\"];\n  limits: {\n    caps: ConversationConfig[\"caps\"];\n    retentionMs: number;\n    runTimeoutMs?: number;\n    maxCalls?: number;\n    maxInputChars?: number;\n    maxRequestChars?: number;\n    maxOutputChars?: number;\n  };\n  onBackgroundError: ConversationConfig[\"step\"][\"onBackgroundError\"];\n}\nexport interface ConversationQuery { prompt: string; messageId: string; resume?: string; signal?: AbortSignal }\nexport interface ConversationQueryKey { sessionId: string; messageId: string }\nexport interface ConversationQueryResult extends ConversationQueryKey { rootKey: string; view: ConversationView }\nexport interface ConversationQueryObservation extends ConversationQueryKey { rootKey: string; view: ConversationView | null }\nexport interface UserConversationAgent {\n  query(input: ConversationQuery): Promise<ConversationQueryResult>;\n  read(key: ConversationQueryKey): Promise<ConversationQueryObservation>;\n}\nexport interface ConversationAgent { forUser(scope: Scope): UserConversationAgent }\nexport class ConversationResumeError extends Error {\n  readonly code = \"conversation_resume_not_found\";\n  constructor() { super(\"Conversation session not found in the bound scope\"); this.name = \"ConversationResumeError\"; }\n}\n\n/** Inspect data descriptors before reading values; a request cannot invoke getters. */\nfunction fields(value: unknown, allowed: readonly string[]): Record<string, unknown> {\n  if (!value || typeof value !== \"object\" || ![Object.prototype, null].includes(Object.getPrototypeOf(value))) throw new TypeError(\"Invalid conversation agent input\");\n  return Object.fromEntries(Reflect.ownKeys(value).map(key => {\n    const d = Object.getOwnPropertyDescriptor(value, key)!;\n    if (typeof key !== \"string\" || !allowed.includes(key) || !d.enumerable || !(\"value\" in d)) throw new TypeError(\"Invalid conversation agent field\");\n    return [key, d.value];\n  }));\n}\nconst scopeCopy = (value: Scope): Scope => settlementScope(fields(value, [\"org\", \"uid\"]) as unknown as Scope);\n\n/** Deterministic even when the first response was lost. Never derives identity from text or revision. */\nexport function conversationAgentSessionId(agentId: string, scope: Scope, messageId: string): string {\n  const s = scopeCopy(scope);\n  return `agent-session-v1:${digest([\"agent-session-v1\", settlementIdentifier(agentId), s.org, s.uid, settlementIdentifier(messageId)])}`;\n}\n\n/** A text facade over the canonical engine. Owns no stores, pools, retries or session registry. */\nexport function createConversationAgent(value: ConversationAgentOptions): ConversationAgent {\n  const options = fields(value, [\"id\", \"revision\", \"runtime\", \"model\", \"instructions\", \"audit\", \"intent\", \"tools\", \"hooks\", \"volatile\", \"limits\", \"onBackgroundError\"]) as unknown as ConversationAgentOptions;\n  const id = settlementIdentifier(options.id), revision = settlementIdentifier(options.revision);\n  const model = fields(options.model, [\"ref\", \"client\", \"prices\"]) as unknown as ConversationAgentOptions[\"model\"];\n  const ref = structuredClone(model.ref), intent = structuredClone(options.intent);\n  const limits = fields(options.limits, [\"caps\", \"retentionMs\", \"runTimeoutMs\", \"maxCalls\", \"maxInputChars\", \"maxRequestChars\", \"maxOutputChars\"]) as unknown as ConversationAgentOptions[\"limits\"];\n  if (![\"anthropic\", \"openai\", \"openrouter\"].includes(ref.provider)) throw new TypeError(\"Invalid conversation model provider\");\n  settlementIdentifier(ref.id);\n  for (const key of [\"runTimeoutMs\", \"maxCalls\", \"maxInputChars\", \"maxRequestChars\", \"maxOutputChars\"] as const) {\n    const n = limits[key];\n    if (n !== undefined && (!Number.isSafeInteger(n) || n < 1)) throw new TypeError(\"Invalid conversation agent limit\");\n  }\n  if (limits.caps === undefined || limits.caps === null) throw new TypeError(\"Explicit conversation budget required\");\n  if (typeof options.instructions !== \"string\" || typeof options.onBackgroundError !== \"function\") throw new TypeError(\"Conversation instructions and error observer are required\");\n  const version = `${FORMAT}:${digest([FORMAT, id, revision])}`;\n  const runTimeoutMs = limits.runTimeoutMs ?? 120000;\n  const config: ConversationConfig = {\n    ...options.runtime.stores,\n    system: [{ text: options.instructions, volatility: \"stable\" }],\n    policy: { resolve: () => ({ model: { ...ref }, rationale: \"configured conversation agent model\" }) },\n    prices: structuredClone(model.prices), caps: structuredClone(limits.caps), consumers: [],\n    policyVersion: version, priceVersion: version, configRevision: version, resultContractVersion: FORMAT,\n    resultRetentionMs: limits.retentionMs, runTimeoutMs, maxCalls: limits.maxCalls ?? 24, maxInputChars: limits.maxInputChars ?? 64000,\n    ...(options.tools !== undefined ? { tools: options.tools } : {}),\n    ...(options.hooks !== undefined ? { hooks: options.hooks } : {}),\n    ...(options.volatile !== undefined ? { volatile: options.volatile } : {}),\n    step: { ...options.runtime.stores.step, clients: { [ref.provider]: model.client }, audit: options.audit, runTimeoutMs,\n      maxRequestChars: limits.maxRequestChars ?? 1000000, maxOutputChars: limits.maxOutputChars ?? 100000,\n      onBackgroundError: options.onBackgroundError },\n  };\n  // Reuse canonical validation, including intent, before any request can perform I/O.\n  createConversationDescriptor(config, { scope: { org: \"validation\", uid: \"validation\" }, sessionId: \"validation\", idempotencyKey: \"validation\",\n    input: { role: \"user\", blocks: [] }, intent }, new Date(Date.now() + runTimeoutMs).toISOString());\n  const runner = createConversationRunner(config), admissions = options.runtime.stores.admissions;\n  return { forUser(value) {\n    const scope = scopeCopy(value);\n    return {\n      async query(value) {\n        const q = fields(value, [\"prompt\", \"messageId\", \"resume\", \"signal\"]);\n        const messageId = settlementIdentifier(q.messageId);\n        const sessionId = q.resume === undefined ? conversationAgentSessionId(id, scope, messageId) : settlementIdentifier(q.resume);\n        if (typeof q.prompt !== \"string\" || q.prompt.length > config.maxInputChars) throw new TypeError(\"Invalid conversation prompt\");\n        const input: SimpleConversationInput = { scope: { ...scope }, sessionId, idempotencyKey: messageId,\n          input: { role: \"user\", blocks: [{ type: \"text\", text: q.prompt }] }, intent: structuredClone(intent),\n          ...(q.signal !== undefined ? { signal: q.signal as AbortSignal } : {}) };\n        // Validate the canonical envelope before the resume lookup, not after I/O.\n        const root = createConversationDescriptor(config, input, new Date(Date.now() + runTimeoutMs).toISOString());\n        if (q.resume !== undefined && !(await admissions.list({ ...scope }, sessionId, { limit: 1 })).length) throw new ConversationResumeError();\n        return { sessionId, messageId, rootKey: root.key, view: await runner.runTurn(input) };\n      },\n      async read(value) {\n        const key = fields(value, [\"sessionId\", \"messageId\"]);\n        const sessionId = settlementIdentifier(key.sessionId), messageId = settlementIdentifier(key.messageId);\n        const rootKey = conversationRootKey(scope, sessionId, messageId);\n        return { sessionId, messageId, rootKey, view: await runner.read({ ...scope }, rootKey) };\n      },\n    };\n  } };\n}\n"],"mappings":"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","names":["value"]}

package/dist/operations.d.ts

@@ -43,13 +43,13 @@ declare function createConversationOperations(options: ConversationOperationsOpt
         key: ConversationOperationKey;
         digest: string;
         admission: {
-            status: "reconciliation_required" | "active" | "released";
+            status: "active" | "reconciliation_required" | "released";
             rootId: string;
             deadlineAt: string;
             resolutionId: string | undefined;
         };
         root: {
-            status: "reconciliation_required" | "active" | "closed";
+            status: "active" | "reconciliation_required" | "closed";
             callCount: number;
         } | null;
         accounting: {
@@ -80,7 +80,7 @@ declare function createConversationOperations(options: ConversationOperationsOpt
             id: string;
             operationKey: string;
             receivedAt: string;
-            evidence: "known" | "unpriced" | "not_dispatched" | "unknown";
+            evidence: "unknown" | "known" | "unpriced" | "not_dispatched";
         }[];
         blockers: string[];
     }>;
@@ -95,13 +95,13 @@ declare function createConversationOperations(options: ConversationOperationsOpt
             key: ConversationOperationKey;
             digest: string;
             admission: {
-                status: "reconciliation_required" | "active" | "released";
+                status: "active" | "reconciliation_required" | "released";
                 rootId: string;
                 deadlineAt: string;
                 resolutionId: string | undefined;
             };
             root: {
-                status: "reconciliation_required" | "active" | "closed";
+                status: "active" | "reconciliation_required" | "closed";
                 callCount: number;
             } | null;
             accounting: {
@@ -132,7 +132,7 @@ declare function createConversationOperations(options: ConversationOperationsOpt
                 id: string;
                 operationKey: string;
                 receivedAt: string;
-                evidence: "known" | "unpriced" | "not_dispatched" | "unknown";
+                evidence: "unknown" | "known" | "unpriced" | "not_dispatched";
             }[];
             blockers: string[];
         };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@alma-harness/runtime",
-  "version": "0.7.0",
+  "version": "0.8.0",
   "description": "Official store composition for governed Alma conversations.",
   "license": "Apache-2.0",
   "type": "module",
@@ -27,6 +27,10 @@
     "./operations-cli": {
       "types": "./dist/operations-cli.d.ts",
       "default": "./dist/operations-cli.js"
+    },
+    "./agent": {
+      "types": "./dist/agent.d.ts",
+      "default": "./dist/agent.js"
     }
   },
   "repository": {
@@ -36,13 +40,13 @@
   },
   "peerDependencies": {
     "pg": "^8.16.3",
-    "@alma-harness/core": "^0.7.0",
-    "@alma-harness/conversation": "^0.7.0",
-    "@alma-harness/postgres": "^0.7.0",
-    "@alma-harness/memory": "^0.7.0",
-    "@alma-harness/execution": "^0.7.0",
-    "@alma-harness/single-call": "^0.7.0",
-    "@alma-harness/postgres-execution": "^0.7.0"
+    "@alma-harness/conversation": "^0.8.0",
+    "@alma-harness/memory": "^0.8.0",
+    "@alma-harness/postgres": "^0.8.0",
+    "@alma-harness/execution": "^0.8.0",
+    "@alma-harness/core": "^0.8.0",
+    "@alma-harness/single-call": "^0.8.0",
+    "@alma-harness/postgres-execution": "^0.8.0"
   },
   "peerDependenciesMeta": {
     "pg": {
@@ -61,13 +65,13 @@
     "typescript": "^5.9.2",
     "vitest": "^3.2.4",
     "pg": "^8.16.3",
-    "@alma-harness/core": "^0.7.0",
-    "@alma-harness/conversation": "^0.7.0",
-    "@alma-harness/single-call": "^0.7.0",
-    "@alma-harness/postgres": "^0.7.0",
-    "@alma-harness/execution": "^0.7.0",
-    "@alma-harness/memory": "^0.7.0",
-    "@alma-harness/postgres-execution": "^0.7.0"
+    "@alma-harness/core": "^0.8.0",
+    "@alma-harness/conversation": "^0.8.0",
+    "@alma-harness/memory": "^0.8.0",
+    "@alma-harness/postgres": "^0.8.0",
+    "@alma-harness/single-call": "^0.8.0",
+    "@alma-harness/execution": "^0.8.0",
+    "@alma-harness/postgres-execution": "^0.8.0"
   },
   "files": [
     "dist"