@owlmeans/agent 0.1.18-rc.40 → 0.1.18-rc.41

package/README.md

@@ -84,7 +84,7 @@ This package ships embedded agent skills under `agent-meta/`. After installing y
 your project's skill store (`.agents/skills/`):
 
 ```sh
-npx @owlmeans/agent-skills@^0.1.18-rc.41
+npx @owlmeans/agent-skills@^0.1.18-rc.42
 ```
 
 The embedded files are version-matched to this package release. Do not edit them

package/agent-meta/manifest.json

@@ -1,8 +1,8 @@
 {
   "schemaVersion": 2,
   "package": "@owlmeans/agent",
-  "version": "0.1.18-rc.40",
-  "generatedAt": "2026-09-28T02:06:37.884Z",
+  "version": "0.1.18-rc.41",
+  "generatedAt": "2026-09-29T08:01:58.133Z",
   "canonicalRepo": "https://github.com/owlmeans/common",
   "entries": [
     {

package/agent-meta/skills/agent/SKILL.md

@@ -8,7 +8,7 @@ user-invocable: false
 # @owlmeans/agent
 
 **Layer:** Cross-cutting domain
-**Install:** `"@owlmeans/agent": "^0.1.18-rc.40"` in `dependencies`, plus the `@langchain/core` and
+**Install:** `"@owlmeans/agent": "^0.1.18-rc.41"` in `dependencies`, plus the `@langchain/core` and
 `@langchain/langgraph` **peers**
 
 The agent runtime. Contracts live in `@owlmeans/agent-common`.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@owlmeans/agent",
-  "version": "0.1.18-rc.40",
+  "version": "0.1.18-rc.41",
   "license": "MIT",
   "type": "module",
   "scripts": {
@@ -68,12 +68,12 @@
     "@langchain/langgraph-checkpoint": "^1.1.5"
   },
   "dependencies": {
-    "@owlmeans/agent-common": "^0.1.18-rc.42",
+    "@owlmeans/agent-common": "^0.1.18-rc.43",
     "@owlmeans/basic-ids": "^0.1.18-rc.34",
     "@owlmeans/context": "^0.1.18-rc.32",
     "@owlmeans/error": "^0.1.18-rc.36",
-    "@owlmeans/flow": "^0.1.18-rc.39",
-    "@owlmeans/llm": "^0.1.18-rc.39",
+    "@owlmeans/flow": "^0.1.18-rc.40",
+    "@owlmeans/llm": "^0.1.18-rc.40",
     "@owlmeans/llm-common": "^0.1.18-rc.37",
     "ajv": "^8.17.1"
   },

package/build/runtime/checkpoint.d.ts

@@ -1,37 +0,0 @@
-import type { Execution, ExecutionPlugin } from '@owlmeans/llm';
-import type { AgentRunStateStore } from '../stores/types.js';
-import type { AgentTransport } from './transport.js';
-export interface AgentCheckpointOptions {
-    store: AgentRunStateStore;
-    /** Dispatched after a successful save, so a queue-backed runner can pick the run up. */
-    transport?: AgentTransport;
-    /**
-     * Refuse to persist a state larger than this, in serialized characters.
-     *
-     * A project-level execution carries the whole project specification in `state.project`, so an
-     * unguarded checkpoint writes tens of kilobytes on every call. The guard drops the write and
-     * says so, which is a recoverable gap; silently writing them is a storage problem that surfaces
-     * much later and much worse.
-     */
-    maxStateChars?: number;
-    /** How a run id is recovered from the key a caller checkpoints under. Defaults to the key. */
-    runId?: (key: string | undefined, exec: Execution) => string;
-    /** How a conversation id is recovered. Defaults to the execution's dedication. */
-    conversationId?: (exec: Execution) => string;
-}
-export declare const DEFAULT_MAX_STATE_CHARS = 64000;
-/**
- * The first implementation of `@owlmeans/llm`'s `ExecutionPlugin`.
- *
- * That seam has shipped unimplemented since it was designed: `ExecutionService.checkpoint()` is a
- * no-op with no plugin registered, and applications call it at their lock boundaries in the
- * expectation that one day something will listen. This is that something — it turns a checkpoint
- * into an `AgentRunState` row, and a restore into a state a run can be rebuilt from.
- *
- * It persists the EXECUTION state only. The flow string belongs to a run and is written by the run
- * itself; a checkpoint taken from an execution has no run to ask, so `flow` is left empty and the
- * run's own save fills it in. Reading a state back with an empty `flow` means "a checkpoint exists
- * but no run had started" — resume from the beginning, not from a step.
- */
-export declare const makeAgentExecutionPlugin: (options: AgentCheckpointOptions) => ExecutionPlugin;
-//# sourceMappingURL=checkpoint.d.ts.map

package/build/runtime/checkpoint.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"checkpoint.d.ts","sourceRoot":"","sources":["../../src/runtime/checkpoint.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,eAAe,EAAE,MAAM,eAAe,CAAA;AAG/D,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,oBAAoB,CAAA;AAC5D,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAA;AAEpD,MAAM,WAAW,sBAAsB;IACrC,KAAK,EAAE,kBAAkB,CAAA;IACzB,wFAAwF;IACxF,SAAS,CAAC,EAAE,cAAc,CAAA;IAC1B;;;;;;;OAOG;IACH,aAAa,CAAC,EAAE,MAAM,CAAA;IACtB,8FAA8F;IAC9F,KAAK,CAAC,EAAE,CAAC,GAAG,EAAE,MAAM,GAAG,SAAS,EAAE,IAAI,EAAE,SAAS,KAAK,MAAM,CAAA;IAC5D,kFAAkF;IAClF,cAAc,CAAC,EAAE,CAAC,IAAI,EAAE,SAAS,KAAK,MAAM,CAAA;CAC7C;AAED,eAAO,MAAM,uBAAuB,QAAS,CAAA;AAE7C;;;;;;;;;;;;GAYG;AACH,eAAO,MAAM,wBAAwB,YAAa,sBAAsB,KAAG,eAgD1E,CAAA"}

package/build/runtime/checkpoint.js

@@ -1,52 +0,0 @@
-export const DEFAULT_MAX_STATE_CHARS = 64_000;
-/**
- * The first implementation of `@owlmeans/llm`'s `ExecutionPlugin`.
- *
- * That seam has shipped unimplemented since it was designed: `ExecutionService.checkpoint()` is a
- * no-op with no plugin registered, and applications call it at their lock boundaries in the
- * expectation that one day something will listen. This is that something — it turns a checkpoint
- * into an `AgentRunState` row, and a restore into a state a run can be rebuilt from.
- *
- * It persists the EXECUTION state only. The flow string belongs to a run and is written by the run
- * itself; a checkpoint taken from an execution has no run to ask, so `flow` is left empty and the
- * run's own save fills it in. Reading a state back with an empty `flow` means "a checkpoint exists
- * but no run had started" — resume from the beginning, not from a step.
- */
-export const makeAgentExecutionPlugin = (options) => {
-    const { store, transport, maxStateChars = DEFAULT_MAX_STATE_CHARS, runId = key => key ?? '', conversationId = exec => exec.purpose?.dedication ?? '', } = options;
-    return {
-        onCheckpoint: async (state, exec, key) => {
-            const id = runId(key, exec);
-            if (id === '') {
-                console.warn('Agent checkpoint skipped: no run id could be resolved from the key');
-                return;
-            }
-            let serialized;
-            try {
-                serialized = JSON.stringify(state);
-            }
-            catch (e) {
-                // A state that will not serialize is a collaborator that leaked into it — report the fact
-                // rather than the exception, because the caller cannot act on a cycle in someone's object.
-                console.warn('Agent checkpoint skipped: execution state is not serializable:', e);
-                return;
-            }
-            if (serialized.length > maxStateChars) {
-                console.warn(`Agent checkpoint skipped: state is ${serialized.length} chars, over the `
-                    + `${maxStateChars} limit — narrow what the execution carries before checkpointing it`);
-                return;
-            }
-            const record = {
-                id,
-                conversationId: conversationId(exec),
-                flow: '',
-                state,
-                updatedAt: new Date().toISOString(),
-            };
-            await store.save(record);
-            await transport?.dispatch({ id, conversationId: record.conversationId, flow: '', stateRef: id });
-        },
-        onRestore: async (key) => (await store.load(key))?.state ?? null,
-    };
-};
-//# sourceMappingURL=checkpoint.js.map

package/build/runtime/checkpoint.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"checkpoint.js","sourceRoot":"","sources":["../../src/runtime/checkpoint.ts"],"names":[],"mappings":"AAyBA,MAAM,CAAC,MAAM,uBAAuB,GAAG,MAAM,CAAA;AAE7C;;;;;;;;;;;;GAYG;AACH,MAAM,CAAC,MAAM,wBAAwB,GAAG,CAAC,OAA+B,EAAmB,EAAE;IAC3F,MAAM,EACJ,KAAK,EAAE,SAAS,EAChB,aAAa,GAAG,uBAAuB,EACvC,KAAK,GAAG,GAAG,CAAC,EAAE,CAAC,GAAG,IAAI,EAAE,EACxB,cAAc,GAAG,IAAI,CAAC,EAAE,CAAC,IAAI,CAAC,OAAO,EAAE,UAAU,IAAI,EAAE,GACxD,GAAG,OAAO,CAAA;IAEX,OAAO;QACL,YAAY,EAAE,KAAK,EAAE,KAAqB,EAAE,IAAe,EAAE,GAAY,EAAE,EAAE;YAC3E,MAAM,EAAE,GAAG,KAAK,CAAC,GAAG,EAAE,IAAI,CAAC,CAAA;YAC3B,IAAI,EAAE,KAAK,EAAE,EAAE,CAAC;gBACd,OAAO,CAAC,IAAI,CAAC,oEAAoE,CAAC,CAAA;gBAClF,OAAM;YACR,CAAC;YAED,IAAI,UAAkB,CAAA;YACtB,IAAI,CAAC;gBACH,UAAU,GAAG,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,CAAA;YACpC,CAAC;YAAC,OAAO,CAAC,EAAE,CAAC;gBACX,0FAA0F;gBAC1F,2FAA2F;gBAC3F,OAAO,CAAC,IAAI,CAAC,gEAAgE,EAAE,CAAC,CAAC,CAAA;gBACjF,OAAM;YACR,CAAC;YAED,IAAI,UAAU,CAAC,MAAM,GAAG,aAAa,EAAE,CAAC;gBACtC,OAAO,CAAC,IAAI,CACV,sCAAsC,UAAU,CAAC,MAAM,mBAAmB;sBACxE,GAAG,aAAa,oEAAoE,CACvF,CAAA;gBACD,OAAM;YACR,CAAC;YAED,MAAM,MAAM,GAAkB;gBAC5B,EAAE;gBACF,cAAc,EAAE,cAAc,CAAC,IAAI,CAAC;gBACpC,IAAI,EAAE,EAAE;gBACR,KAAK;gBACL,SAAS,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;aACpC,CAAA;YAED,MAAM,KAAK,CAAC,IAAI,CAAC,MAAM,CAAC,CAAA;YACxB,MAAM,SAAS,EAAE,QAAQ,CAAC,EAAE,EAAE,EAAE,cAAc,EAAE,MAAM,CAAC,cAAc,EAAE,IAAI,EAAE,EAAE,EAAE,QAAQ,EAAE,EAAE,EAAE,CAAC,CAAA;QAClG,CAAC;QAED,SAAS,EAAE,KAAK,EAAE,GAAW,EAAE,EAAE,CAAC,CAAC,MAAM,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,KAAK,IAAI,IAAI;KACzE,CAAA;AACH,CAAC,CAAA"}