@owlmeans/agent 0.1.18-rc.47 → 0.1.18-rc.49

package/README.md

@@ -40,8 +40,8 @@ const agent = context.agents().agent({ exec, tools })
 | `memoryGraphPlugin` | Durable notes filed by subsystem, with links — index injected, content pulled by tool |
 | `memoryEventsPlugin` | A bounded, ordered record of what happened |
 
-Both memory plugins also export a plain API (`memoryGraph`, `memoryEvents`) usable with no agent at
-all, so a pipeline helper writes to the same store an agent reads.
+Both memory plugins also export a plain API (`makeMemoryGraphApi`, `makeMemoryEventsApi`) usable
+with no agent at all, so a pipeline helper writes to the same store an agent reads.
 
 ## Things worth knowing before you change it
 
@@ -49,7 +49,7 @@ all, so a pipeline helper writes to the same store an agent reads.
 provider will not put a cache breakpoint on. Volatile material anywhere above it invalidates the
 prefix that every call sharing a persona pays for.
 
-**`safeInvokeTool` must never throw.** A rejected LangGraph task aborts the whole superstep: every
+**`toolHelper.safeInvokeTool` must never throw.** A rejected LangGraph task aborts the whole superstep: every
 sibling tool call in the same parallel batch dies with it, discarding work they had already
 finished. A tool failure comes back as `{ error }` the model can read and correct.
 
@@ -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.48
+npx @owlmeans/agent-skills@^0.1.18-rc.51
 ```
 
 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.47",
-  "generatedAt": "2026-10-05T08:32:19.123Z",
+  "version": "0.1.18-rc.49",
+  "generatedAt": "2026-10-06T11:45:57.670Z",
   "canonicalRepo": "https://github.com/owlmeans/common",
   "entries": [
     {

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

@@ -1,6 +1,6 @@
 ---
 name: agent
-description: How to use @owlmeans/agent — context-aware LLM agents over the LangGraph functional API, and resumable PIPELINES over a checkpointed StateGraph, with the AgentPlugin and PipelinePlugin seams, CUMULATIVE PIPELINE RESULTS (cumulativeResultsPlugin), conversation-summarization and memory plugins, and storage-independent ports. Auto-invoked when importing makeAgentModel, makePipeline, makeCheckpointSaver, appendAgentsService, an agent or pipeline plugin, cumulativeResultsPlugin, safeInvokeTool, or an agent store.
+description: How to use @owlmeans/agent — context-aware LLM agents over the LangGraph functional API, and resumable PIPELINES over a checkpointed StateGraph, with the AgentPlugin and PipelinePlugin seams, CUMULATIVE PIPELINE RESULTS (cumulativeResultsPlugin), conversation-summarization and memory plugins, and storage-independent ports. Auto-invoked when importing makeAgentModel, makePipeline, makeCheckpointSaver, appendAgentsService, an agent or pipeline plugin, cumulativeResultsPlugin, toolHelper, or an agent store.
 user-invocable: false
 ---
 <!-- AUTO-GENERATED — do not edit. Regenerate via sync-agent-meta. -->
@@ -8,7 +8,7 @@ user-invocable: false
 # @owlmeans/agent
 
 **Layer:** Cross-cutting domain
-**Install:** `"@owlmeans/agent": "^0.1.18-rc.47"` in `dependencies`, plus the `@langchain/core` and
+**Install:** `"@owlmeans/agent": "^0.1.18-rc.49"` in `dependencies`, plus the `@langchain/core` and
 `@langchain/langgraph` **peers**
 
 The agent runtime. Contracts live in `@owlmeans/agent-common`.
@@ -24,10 +24,10 @@ The agent runtime. Contracts live in `@owlmeans/agent-common`.
 | `makeCheckpointSaver(store)` | A `BaseCheckpointSaver` over the `CheckpointStore` port. |
 | `makeAgentsService(options?, alias?)` · `appendAgentsService(ctx, options?, alias?)` · `agentServiceApi(options, self)` | The service, and its half without `createService` for composition. |
 | `summarizePlugin(options?)` | Compacts each finished run into `summary` + `advice`; replays the last few. |
-| `memoryGraphPlugin(options?)` · `memoryGraph(store, options?)` | Durable notes filed by subsystem, with links. Plugin **and** plain API. |
-| `memoryEventsPlugin(options?)` · `memoryEvents(store, options?)` | A bounded, ordered record of what happened. |
-| `safeInvokeTool`, `toErrorResponse`, `isToolError` | The never-throwing tool contract. |
-| `composeCompaction`, `composeRollingSummary`, `renderTranscript`, `messageText` | Summary primitives; both composers are total. |
+| `memoryGraphPlugin(options?)` · `makeMemoryGraphApi(store, options?)` | Durable notes filed by subsystem, with links. Plugin **and** plain API. |
+| `memoryEventsPlugin(options?)` · `makeMemoryEventsApi(store, options?)` | A bounded, ordered record of what happened. |
+| `toolHelper.{safeInvokeTool, toErrorResponse, isToolError}` | The never-throwing tool contract. |
+| `compactionHelper.{composeCompaction, renderTranscript, messageText}`, `composeRollingSummary` | Summary primitives; both composers are total. |
 | `makeStaticFlowProvider(flows)` | The server-side `FlowProvider` `@owlmeans/flow` does not ship. |
 | `inProcessTransport()`, `AgentTransport` | The scaling seam; default carries messages by direct call. |
 | `createMemory*Store()` | In-memory reference implementations of every port, including `createMemoryPipelineRunStore`, `createMemoryCheckpointStore` and `createMemoryCumulativeResultStore`. |
@@ -183,7 +183,7 @@ that every call sharing a persona pays for.
 model keeps calling tools without ever answering — so catch that error by name rather than treating
 every failed run alike: it says the loop ran out of room, not that a tool or the model failed.
 
-**`safeInvokeTool` must never throw.** The loop wraps it in a LangGraph `task`, and a rejected task
+**`toolHelper.safeInvokeTool` must never throw.** The loop wraps it in a LangGraph `task`, and a rejected task
 aborts the whole superstep: every sibling tool call in the same parallel batch dies with AbortError
 and the run ends on "Multiple errors occurred during superstep 0", discarding work the others had
 already finished. A tool failure comes back as `{ error }` the model can read and correct — most are
@@ -219,7 +219,7 @@ is streamed to the client, so without it the summary of a run types itself out i
 that run, immediately after it finished.
 
 **Character caps are applied after the model answers, never asked for in the prompt alone.** A cap in
-a prompt is a request. Both composers (`composeCompaction`, `composeRollingSummary`) are total: with
+a prompt is a request. Both composers (`compactionHelper.composeCompaction`, `composeRollingSummary`) are total: with
 no model, a failing model or an empty answer they fall back deterministically, so a caller can record
 history unconditionally. A failed fold costs detail, never the event.
 
@@ -272,7 +272,7 @@ refuses to re-enter a completed one without `force`.
 effects already applied to the world: re-entering a turn re-applies them. What IS resumable is a
 pipeline — and an agent run belongs inside one of its steps.
 
-**`safeInvokeTool(tools, call, fatal?)` takes a fatal predicate.** Containment is right for a bad
+**`toolHelper.safeInvokeTool(tools, call, fatal?)` takes a fatal predicate.** Containment is right for a bad
 argument and wrong for an exhausted budget: a tool may be a whole pipeline behind one call, and
 handing the model a readable "out of tokens" is an invitation to pick another tool and spend again.
 

package/build/helpers/compaction/types.d.ts

@@ -0,0 +1,49 @@
+import type { LlmModel } from '@owlmeans/llm';
+import type { BaseMessage } from '@langchain/core/messages';
+import { AgentRunStatus } from '@owlmeans/agent-common';
+export interface Compaction {
+    summary: string;
+    advice?: string;
+}
+export interface CompactionInput {
+    /** Omit to skip the model entirely and take the deterministic path. */
+    model?: LlmModel;
+    /** The ask that opened the run. */
+    prompt: string;
+    messages: readonly BaseMessage[];
+    status: AgentRunStatus;
+    /** What happened after the loop — a validation verdict, a build result. */
+    note?: string;
+    maxSummaryChars?: number;
+    maxAdviceChars?: number;
+    /** LangChain `runName`. Give it a value the application filters, or the summary of a run streams into the user's view of that run. */
+    action?: string;
+    /** How much of the transcript to show the model. */
+    maxTranscriptChars?: number;
+}
+/** The handover between two runs on one subject: a summary and the advice that carries intent. */
+export interface CompactionHelper {
+    /** The text of a message, whatever content shape it arrived in. */
+    messageText: (message: BaseMessage) => string;
+    /**
+     * A transcript the model can read, newest-biased.
+     *
+     * The tail is what matters to a compaction — how the run ENDED decides what to do next — so when
+     * the budget binds it is the head that goes.
+     */
+    renderTranscript: (messages: readonly BaseMessage[], maxChars?: number) => string;
+    /**
+     * Compact a finished run into what the next one needs.
+     *
+     * Two parts, deliberately. A summary alone leaves the next run to re-derive the plan from the
+     * outcome, which is where it invents a different one; the advice is the half that carries intent
+     * across the gap.
+     *
+     * **Never throws, and never trusts the model's arithmetic.** The character caps are applied after
+     * the answer comes back, because a cap in a prompt is a request. When the model is absent or fails
+     * — an exhausted budget is the common case, and asking again would fail the same way — the
+     * deterministic fallback still produces a usable event: what was asked, and how it ended.
+     */
+    composeCompaction: (input: CompactionInput) => Promise<Compaction>;
+}
+//# sourceMappingURL=types.d.ts.map

package/build/helpers/compaction/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/helpers/compaction/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAA;AAC7C,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,0BAA0B,CAAA;AAC3D,OAAO,EAAE,cAAc,EAAE,MAAM,wBAAwB,CAAA;AAEvD,MAAM,WAAW,UAAU;IACzB,OAAO,EAAE,MAAM,CAAA;IACf,MAAM,CAAC,EAAE,MAAM,CAAA;CAChB;AAED,MAAM,WAAW,eAAe;IAC9B,uEAAuE;IACvE,KAAK,CAAC,EAAE,QAAQ,CAAA;IAChB,mCAAmC;IACnC,MAAM,EAAE,MAAM,CAAA;IACd,QAAQ,EAAE,SAAS,WAAW,EAAE,CAAA;IAChC,MAAM,EAAE,cAAc,CAAA;IACtB,2EAA2E;IAC3E,IAAI,CAAC,EAAE,MAAM,CAAA;IACb,eAAe,CAAC,EAAE,MAAM,CAAA;IACxB,cAAc,CAAC,EAAE,MAAM,CAAA;IACvB,sIAAsI;IACtI,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,oDAAoD;IACpD,kBAAkB,CAAC,EAAE,MAAM,CAAA;CAC5B;AAED,kGAAkG;AAClG,MAAM,WAAW,gBAAgB;IAC/B,mEAAmE;IACnE,WAAW,EAAE,CAAC,OAAO,EAAE,WAAW,KAAK,MAAM,CAAA;IAC7C;;;;;OAKG;IACH,gBAAgB,EAAE,CAAC,QAAQ,EAAE,SAAS,WAAW,EAAE,EAAE,QAAQ,CAAC,EAAE,MAAM,KAAK,MAAM,CAAA;IACjF;;;;;;;;;;;OAWG;IACH,iBAAiB,EAAE,CAAC,KAAK,EAAE,eAAe,KAAK,OAAO,CAAC,UAAU,CAAC,CAAA;CACnE"}

package/build/helpers/compaction/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../src/helpers/compaction/types.ts"],"names":[],"mappings":""}

package/build/helpers/compaction.d.ts

@@ -1,25 +1,11 @@
 import type { BaseMessage } from '@langchain/core/messages';
-import type { Compaction, CompactionInput } from './types.js';
-/** The text of a message, whatever content shape it arrived in. */
+import type { Compaction, CompactionHelper, CompactionInput } from './compaction/types.js';
+export declare const createCompactionHelper: () => CompactionHelper;
+export declare const compactionHelper: CompactionHelper;
+/** @deprecated compat:factory-refactor — use `compactionHelper.messageText(…)` */
 export declare const messageText: (message: BaseMessage) => string;
-/**
- * A transcript the model can read, newest-biased.
- *
- * The tail is what matters to a compaction — how the run ENDED decides what to do next — so when
- * the budget binds it is the head that goes.
- */
+/** @deprecated compat:factory-refactor — use `compactionHelper.renderTranscript(…)` */
 export declare const renderTranscript: (messages: readonly BaseMessage[], maxChars?: number) => string;
-/**
- * Compact a finished run into what the next one needs.
- *
- * Two parts, deliberately. A summary alone leaves the next run to re-derive the plan from the
- * outcome, which is where it invents a different one; the advice is the half that carries intent
- * across the gap.
- *
- * **Never throws, and never trusts the model's arithmetic.** The character caps are applied after
- * the answer comes back, because a cap in a prompt is a request. When the model is absent or fails
- * — an exhausted budget is the common case, and asking again would fail the same way — the
- * deterministic fallback still produces a usable event: what was asked, and how it ended.
- */
+/** @deprecated compat:factory-refactor — use `compactionHelper.composeCompaction(…)` */
 export declare const composeCompaction: (input: CompactionInput) => Promise<Compaction>;
 //# sourceMappingURL=compaction.d.ts.map

package/build/helpers/compaction.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"compaction.d.ts","sourceRoot":"","sources":["../../src/helpers/compaction.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,0BAA0B,CAAA;AAI3D,OAAO,KAAK,EAAE,UAAU,EAAE,eAAe,EAAE,MAAM,YAAY,CAAA;AAI7D,mEAAmE;AACnE,eAAO,MAAM,WAAW,YAAa,WAAW,KAAG,MAalD,CAAA;AAED;;;;;GAKG;AACH,eAAO,MAAM,gBAAgB,aACjB,SAAS,WAAW,EAAE,wBAC/B,MA0BF,CAAA;AAED;;;;;;;;;;;GAWG;AACH,eAAO,MAAM,iBAAiB,UAAiB,eAAe,KAAG,OAAO,CAAC,UAAU,CAoElF,CAAA"}
+{"version":3,"file":"compaction.d.ts","sourceRoot":"","sources":["../../src/helpers/compaction.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,0BAA0B,CAAA;AAI3D,OAAO,KAAK,EAAE,UAAU,EAAE,gBAAgB,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAA;AAI1F,eAAO,MAAM,sBAAsB,QAAO,gBAqHzC,CAAA;AAED,eAAO,MAAM,gBAAgB,kBAA2B,CAAA;AAExD,kFAAkF;AAClF,eAAO,MAAM,WAAW,YAAa,WAAW,KAAG,MAA+C,CAAA;AAElG,uFAAuF;AACvF,eAAO,MAAM,gBAAgB,aAAc,SAAS,WAAW,EAAE,aAAa,MAAM,KAAG,MAChC,CAAA;AAEvD,wFAAwF;AACxF,eAAO,MAAM,iBAAiB,UAAW,eAAe,KAAG,OAAO,CAAC,UAAU,CAA8C,CAAA"}

package/build/helpers/compaction.js

@@ -2,78 +2,60 @@ import { AgentRunStatus, DEFAULT_ADVICE_CHARS, DEFAULT_SUMMARY_CHARS, truncateAt
 import { logger } from '@owlmeans/log';
 import { COMPACTION_SCHEMA, DEFAULT_TRANSCRIPT_CHARS } from './consts.local.js';
 const log = logger('agent');
-/** The text of a message, whatever content shape it arrived in. */
-export const messageText = (message) => {
-    const content = message.content;
-    if (typeof content === 'string') {
-        return content;
-    }
-    if (Array.isArray(content)) {
-        return content
-            .map(part => typeof part === 'string' ? part : part.text ?? '')
-            .filter(text => text !== '')
-            .join('\n');
-    }
-    return '';
-};
-/**
- * A transcript the model can read, newest-biased.
- *
- * The tail is what matters to a compaction — how the run ENDED decides what to do next — so when
- * the budget binds it is the head that goes.
- */
-export const renderTranscript = (messages, maxChars = DEFAULT_TRANSCRIPT_CHARS) => {
-    const lines = [];
-    let used = 0;
-    for (let i = messages.length - 1; i >= 0; --i) {
-        const message = messages[i];
-        const text = messageText(message).trim();
-        const calls = message.tool_calls;
-        const body = text !== ''
-            ? text
-            : calls != null && calls.length > 0
-                ? `(called ${calls.map(call => call.name).join(', ')})`
-                : '';
-        if (body === '') {
-            continue;
+export const createCompactionHelper = () => {
+    const messageText = (message) => {
+        const content = message.content;
+        if (typeof content === 'string') {
+            return content;
         }
-        const line = `${message.getType()}: ${body}`;
-        if (used + line.length > maxChars) {
-            break;
+        if (Array.isArray(content)) {
+            return content
+                .map(part => typeof part === 'string' ? part : part.text ?? '')
+                .filter(text => text !== '')
+                .join('\n');
         }
-        lines.unshift(line);
-        used += line.length;
-    }
-    return lines.join('\n\n');
-};
-/**
- * Compact a finished run into what the next one needs.
- *
- * Two parts, deliberately. A summary alone leaves the next run to re-derive the plan from the
- * outcome, which is where it invents a different one; the advice is the half that carries intent
- * across the gap.
- *
- * **Never throws, and never trusts the model's arithmetic.** The character caps are applied after
- * the answer comes back, because a cap in a prompt is a request. When the model is absent or fails
- * — an exhausted budget is the common case, and asking again would fail the same way — the
- * deterministic fallback still produces a usable event: what was asked, and how it ended.
- */
-export const composeCompaction = async (input) => {
-    const { model, prompt, messages, status, note, maxSummaryChars = DEFAULT_SUMMARY_CHARS, maxAdviceChars = DEFAULT_ADVICE_CHARS, action = 'agent-compaction', maxTranscriptChars, } = input;
-    const fallback = () => {
-        const last = [...messages].reverse().find(message => messageText(message).trim() !== '');
-        const tail = last != null ? messageText(last).trim() : '';
-        const head = `Asked: ${prompt.trim()}`;
-        const ended = status === AgentRunStatus.Ok ? 'Finished.' : 'Did not finish.';
-        return {
-            summary: truncateAt([head, ended, note?.trim(), tail].filter(part => part != null && part !== '').join(' '), maxSummaryChars),
-        };
+        return '';
+    };
+    const renderTranscript = (messages, maxChars = DEFAULT_TRANSCRIPT_CHARS) => {
+        const lines = [];
+        let used = 0;
+        for (let i = messages.length - 1; i >= 0; --i) {
+            const message = messages[i];
+            const text = messageText(message).trim();
+            const calls = message.tool_calls;
+            const body = text !== ''
+                ? text
+                : calls != null && calls.length > 0
+                    ? `(called ${calls.map(call => call.name).join(', ')})`
+                    : '';
+            if (body === '') {
+                continue;
+            }
+            const line = `${message.getType()}: ${body}`;
+            if (used + line.length > maxChars) {
+                break;
+            }
+            lines.unshift(line);
+            used += line.length;
+        }
+        return lines.join('\n\n');
     };
-    if (model == null) {
-        return fallback();
-    }
-    try {
-        const result = await model.invoke(`
+    const composeCompaction = async (input) => {
+        const { model, prompt, messages, status, note, maxSummaryChars = DEFAULT_SUMMARY_CHARS, maxAdviceChars = DEFAULT_ADVICE_CHARS, action = 'agent-compaction', maxTranscriptChars, } = input;
+        const fallback = () => {
+            const last = [...messages].reverse().find(message => messageText(message).trim() !== '');
+            const tail = last != null ? messageText(last).trim() : '';
+            const head = `Asked: ${prompt.trim()}`;
+            const ended = status === AgentRunStatus.Ok ? 'Finished.' : 'Did not finish.';
+            return {
+                summary: truncateAt([head, ended, note?.trim(), tail].filter(part => part != null && part !== '').join(' '), maxSummaryChars),
+            };
+        };
+        if (model == null) {
+            return fallback();
+        }
+        try {
+            const result = await model.invoke(`
 Compact the conversation below into a handover for the next session working on the same subject.
 
 Write two things:
@@ -96,17 +78,26 @@ ${status === AgentRunStatus.Ok ? 'Completed' : 'Failed'}${note != null && note !
 # Conversation
 ${renderTranscript(messages, maxTranscriptChars)}
       `, COMPACTION_SCHEMA, { action });
-        const summary = truncateAt(result.summary ?? '', maxSummaryChars);
-        const advice = truncateAt(result.advice ?? '', maxAdviceChars);
-        // An empty summary is a non-answer, not a short one — take the deterministic path rather than
-        // storing a blank event that the next run will read as "nothing happened".
-        return summary === ''
-            ? fallback()
-            : { summary, ...(advice !== '' ? { advice } : {}) };
-    }
-    catch (e) {
-        log.warn('Agent compaction failed, falling back to a deterministic summary', e);
-        return fallback();
-    }
+            const summary = truncateAt(result.summary ?? '', maxSummaryChars);
+            const advice = truncateAt(result.advice ?? '', maxAdviceChars);
+            // An empty summary is a non-answer, not a short one — take the deterministic path rather than
+            // storing a blank event that the next run will read as "nothing happened".
+            return summary === ''
+                ? fallback()
+                : { summary, ...(advice !== '' ? { advice } : {}) };
+        }
+        catch (e) {
+            log.warn('Agent compaction failed, falling back to a deterministic summary', e);
+            return fallback();
+        }
+    };
+    return { messageText, renderTranscript, composeCompaction };
 };
+export const compactionHelper = createCompactionHelper();
+/** @deprecated compat:factory-refactor — use `compactionHelper.messageText(…)` */
+export const messageText = (message) => compactionHelper.messageText(message);
+/** @deprecated compat:factory-refactor — use `compactionHelper.renderTranscript(…)` */
+export const renderTranscript = (messages, maxChars) => compactionHelper.renderTranscript(messages, maxChars);
+/** @deprecated compat:factory-refactor — use `compactionHelper.composeCompaction(…)` */
+export const composeCompaction = (input) => compactionHelper.composeCompaction(input);
 //# sourceMappingURL=compaction.js.map

package/build/helpers/compaction.js.map

@@ -1 +1 @@
-{"version":3,"file":"compaction.js","sourceRoot":"","sources":["../../src/helpers/compaction.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,cAAc,EAAE,oBAAoB,EAAE,qBAAqB,EAAE,UAAU,EAAE,MAAM,wBAAwB,CAAA;AAChH,OAAO,EAAE,MAAM,EAAE,MAAM,eAAe,CAAA;AACtC,OAAO,EAAE,iBAAiB,EAAE,wBAAwB,EAAE,MAAM,mBAAmB,CAAA;AAG/E,MAAM,GAAG,GAAG,MAAM,CAAC,OAAO,CAAC,CAAA;AAE3B,mEAAmE;AACnE,MAAM,CAAC,MAAM,WAAW,GAAG,CAAC,OAAoB,EAAU,EAAE;IAC1D,MAAM,OAAO,GAAG,OAAO,CAAC,OAAO,CAAA;IAC/B,IAAI,OAAO,OAAO,KAAK,QAAQ,EAAE,CAAC;QAChC,OAAO,OAAO,CAAA;IAChB,CAAC;IACD,IAAI,KAAK,CAAC,OAAO,CAAC,OAAO,CAAC,EAAE,CAAC;QAC3B,OAAO,OAAO;aACX,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC,OAAO,IAAI,KAAK,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAE,IAA0B,CAAC,IAAI,IAAI,EAAE,CAAC;aACrF,MAAM,CAAC,IAAI,CAAC,EAAE,CAAC,IAAI,KAAK,EAAE,CAAC;aAC3B,IAAI,CAAC,IAAI,CAAC,CAAA;IACf,CAAC;IAED,OAAO,EAAE,CAAA;AACX,CAAC,CAAA;AAED;;;;;GAKG;AACH,MAAM,CAAC,MAAM,gBAAgB,GAAG,CAC9B,QAAgC,EAAE,QAAQ,GAAG,wBAAwB,EAC7D,EAAE;IACV,MAAM,KAAK,GAAa,EAAE,CAAA;IAC1B,IAAI,IAAI,GAAG,CAAC,CAAA;IAEZ,KAAK,IAAI,CAAC,GAAG,QAAQ,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC,IAAI,CAAC,EAAE,EAAE,CAAC,EAAE,CAAC;QAC9C,MAAM,OAAO,GAAG,QAAQ,CAAC,CAAC,CAAC,CAAA;QAC3B,MAAM,IAAI,GAAG,WAAW,CAAC,OAAO,CAAC,CAAC,IAAI,EAAE,CAAA;QACxC,MAAM,KAAK,GAAI,OAAoD,CAAC,UAAU,CAAA;QAC9E,MAAM,IAAI,GAAG,IAAI,KAAK,EAAE;YACtB,CAAC,CAAC,IAAI;YACN,CAAC,CAAC,KAAK,IAAI,IAAI,IAAI,KAAK,CAAC,MAAM,GAAG,CAAC;gBACjC,CAAC,CAAC,WAAW,KAAK,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG;gBACvD,CAAC,CAAC,EAAE,CAAA;QACR,IAAI,IAAI,KAAK,EAAE,EAAE,CAAC;YAChB,SAAQ;QACV,CAAC;QAED,MAAM,IAAI,GAAG,GAAG,OAAO,CAAC,OAAO,EAAE,KAAK,IAAI,EAAE,CAAA;QAC5C,IAAI,IAAI,GAAG,IAAI,CAAC,MAAM,GAAG,QAAQ,EAAE,CAAC;YAClC,MAAK;QACP,CAAC;QACD,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,CAAA;QACnB,IAAI,IAAI,IAAI,CAAC,MAAM,CAAA;IACrB,CAAC;IAED,OAAO,KAAK,CAAC,IAAI,CAAC,MAAM,CAAC,CAAA;AAC3B,CAAC,CAAA;AAED;;;;;;;;;;;GAWG;AACH,MAAM,CAAC,MAAM,iBAAiB,GAAG,KAAK,EAAE,KAAsB,EAAuB,EAAE;IACrF,MAAM,EACJ,KAAK,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,IAAI,EACrC,eAAe,GAAG,qBAAqB,EACvC,cAAc,GAAG,oBAAoB,EACrC,MAAM,GAAG,kBAAkB,EAC3B,kBAAkB,GACnB,GAAG,KAAK,CAAA;IAET,MAAM,QAAQ,GAAG,GAAe,EAAE;QAChC,MAAM,IAAI,GAAG,CAAC,GAAG,QAAQ,CAAC,CAAC,OAAO,EAAE,CAAC,IAAI,CAAC,OAAO,CAAC,EAAE,CAAC,WAAW,CAAC,OAAO,CAAC,CAAC,IAAI,EAAE,KAAK,EAAE,CAAC,CAAA;QACxF,MAAM,IAAI,GAAG,IAAI,IAAI,IAAI,CAAC,CAAC,CAAC,WAAW,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,EAAE,CAAA;QACzD,MAAM,IAAI,GAAG,UAAU,MAAM,CAAC,IAAI,EAAE,EAAE,CAAA;QACtC,MAAM,KAAK,GAAG,MAAM,KAAK,cAAc,CAAC,EAAE,CAAC,CAAC,CAAC,WAAW,CAAC,CAAC,CAAC,iBAAiB,CAAA;QAE5E,OAAO;YACL,OAAO,EAAE,UAAU,CACjB,CAAC,IAAI,EAAE,KAAK,EAAE,IAAI,EAAE,IAAI,EAAE,EAAE,IAAI,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC,EAAE,CAAC,IAAI,IAAI,IAAI,IAAI,IAAI,KAAK,EAAE,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,EACvF,eAAe,CAChB;SACF,CAAA;IACH,CAAC,CAAA;IAED,IAAI,KAAK,IAAI,IAAI,EAAE,CAAC;QAClB,OAAO,QAAQ,EAAE,CAAA;IACnB,CAAC;IAED,IAAI,CAAC;QACH,MAAM,MAAM,GAAG,MAAM,KAAK,CAAC,MAAM,CAC/B;;;;;;kDAM4C,eAAe;;yEAEQ,cAAc;;;;;;;EAOrF,MAAM;;;EAGN,MAAM,KAAK,cAAc,CAAC,EAAE,CAAC,CAAC,CAAC,WAAW,CAAC,CAAC,CAAC,QAAQ,GAAG,IAAI,IAAI,IAAI,IAAI,IAAI,KAAK,EAAE,CAAC,CAAC,CAAC,MAAM,IAAI,EAAE,CAAC,CAAC,CAAC,EAAE;;;EAGvG,gBAAgB,CAAC,QAAQ,EAAE,kBAAkB,CAAC;OACzC,EACD,iBAAiB,EACjB,EAAE,MAAM,EAAE,CACX,CAAA;QAED,MAAM,OAAO,GAAG,UAAU,CAAC,MAAM,CAAC,OAAO,IAAI,EAAE,EAAE,eAAe,CAAC,CAAA;QACjE,MAAM,MAAM,GAAG,UAAU,CAAC,MAAM,CAAC,MAAM,IAAI,EAAE,EAAE,cAAc,CAAC,CAAA;QAE9D,8FAA8F;QAC9F,2EAA2E;QAC3E,OAAO,OAAO,KAAK,EAAE;YACnB,CAAC,CAAC,QAAQ,EAAE;YACZ,CAAC,CAAC,EAAE,OAAO,EAAE,GAAG,CAAC,MAAM,KAAK,EAAE,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,CAAA;IACvD,CAAC;IAAC,OAAO,CAAC,EAAE,CAAC;QACX,GAAG,CAAC,IAAI,CAAC,kEAAkE,EAAE,CAAC,CAAC,CAAA;QAC/E,OAAO,QAAQ,EAAE,CAAA;IACnB,CAAC;AACH,CAAC,CAAA"}
+{"version":3,"file":"compaction.js","sourceRoot":"","sources":["../../src/helpers/compaction.ts"],"names":[],"mappings":"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"}

package/build/helpers/index.d.ts

@@ -1,5 +1,7 @@
+export type * from './tools/types.js';
+export type * from './compaction/types.js';
+export type * from './rolling/types.js';
 export * from './tools.js';
-export type * from './types.js';
 export * from './compaction.js';
 export * from './rolling.js';
 //# sourceMappingURL=index.d.ts.map

package/build/helpers/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/helpers/index.ts"],"names":[],"mappings":"AAAA,cAAc,YAAY,CAAA;AAC1B,mBAAmB,YAAY,CAAA;AAC/B,cAAc,iBAAiB,CAAA;AAC/B,cAAc,cAAc,CAAA"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/helpers/index.ts"],"names":[],"mappings":"AAAA,mBAAmB,kBAAkB,CAAA;AACrC,mBAAmB,uBAAuB,CAAA;AAC1C,mBAAmB,oBAAoB,CAAA;AACvC,cAAc,YAAY,CAAA;AAC1B,cAAc,iBAAiB,CAAA;AAC/B,cAAc,cAAc,CAAA"}

package/build/helpers/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/helpers/index.ts"],"names":[],"mappings":"AAAA,cAAc,YAAY,CAAA;AAE1B,cAAc,iBAAiB,CAAA;AAC/B,cAAc,cAAc,CAAA"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/helpers/index.ts"],"names":[],"mappings":"AAGA,cAAc,YAAY,CAAA;AAC1B,cAAc,iBAAiB,CAAA;AAC/B,cAAc,cAAc,CAAA"}

package/build/helpers/rolling/types.d.ts

@@ -0,0 +1,16 @@
+import type { LlmModel } from '@owlmeans/llm';
+export interface RollingSummaryInput {
+    /** Omit to skip the model and take the deterministic path. */
+    model?: LlmModel;
+    /** The prose account so far. Empty on the first fold. */
+    previous: string;
+    /** What just happened, as one line. */
+    event: string;
+    /** Anything the fold may use but that need not survive into the summary. */
+    details?: string;
+    /** Hard ceiling on the returned prose, in characters. */
+    maxChars: number;
+    /** LangChain `runName`. Give it a value the application filters out of its user-facing stream. */
+    action?: string;
+}
+//# sourceMappingURL=types.d.ts.map

package/build/helpers/rolling/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/helpers/rolling/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAA;AAE7C,MAAM,WAAW,mBAAmB;IAClC,8DAA8D;IAC9D,KAAK,CAAC,EAAE,QAAQ,CAAA;IAChB,yDAAyD;IACzD,QAAQ,EAAE,MAAM,CAAA;IAChB,uCAAuC;IACvC,KAAK,EAAE,MAAM,CAAA;IACb,4EAA4E;IAC5E,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,yDAAyD;IACzD,QAAQ,EAAE,MAAM,CAAA;IAChB,kGAAkG;IAClG,MAAM,CAAC,EAAE,MAAM,CAAA;CAChB"}

package/build/helpers/rolling/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/build/helpers/rolling/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../src/helpers/rolling/types.ts"],"names":[],"mappings":""}

package/build/helpers/rolling.d.ts

@@ -1,4 +1,4 @@
-import type { RollingSummaryInput } from './types.js';
+import type { RollingSummaryInput } from './rolling/types.js';
 /**
  * Fold one event into a running account of a subject, under a hard character ceiling.
  *

package/build/helpers/rolling.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"rolling.d.ts","sourceRoot":"","sources":["../../src/helpers/rolling.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,YAAY,CAAA;AAIrD;;;;;;;GAOG;AACH,eAAO,MAAM,qBAAqB,UAAiB,mBAAmB,KAAG,OAAO,CAAC,MAAM,CAyCtF,CAAA"}
+{"version":3,"file":"rolling.d.ts","sourceRoot":"","sources":["../../src/helpers/rolling.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,oBAAoB,CAAA;AAI7D;;;;;;;GAOG;AACH,eAAO,MAAM,qBAAqB,UAAiB,mBAAmB,KAAG,OAAO,CAAC,MAAM,CAyCtF,CAAA"}

package/build/helpers/tools/types.d.ts

@@ -0,0 +1,38 @@
+import type { ToolCall } from '@langchain/core/messages';
+import type { AgentToolSet } from '../../types.js';
+/** The shape a contained tool failure comes back as. Matches what tool bodies return themselves. */
+export interface ToolErrorResponse {
+    error: string;
+}
+/** Running a model-requested tool without letting its failure take the run with it. */
+export interface ToolHelper {
+    toErrorResponse: (e: unknown) => ToolErrorResponse;
+    isToolError: (result: unknown) => result is ToolErrorResponse;
+    /**
+     * Run one model-requested tool, contained.
+     *
+     * **Never throws.** The caller wraps this in a LangGraph task, and a rejected task aborts the whole
+     * superstep: every sibling tool call in the same parallel batch dies with AbortError and the run
+     * ends on "Multiple errors occurred during superstep 0", discarding work the other calls had
+     * already finished. A tool failure has to come back as something the model can read and correct
+     * instead — most of them are the model's own mistake (an argument outside an enum, a hallucinated
+     * tool name), and the error text already names what was expected.
+     *
+     * Awaiting `invoke` is what makes the catch reachable: the tool's schema is validated inside it, so
+     * a bad argument rejects asynchronously and returning the promise unawaited would carry the
+     * rejection straight past this handler.
+     *
+     * Resolution is by the tool's OWN name, not by the map key. `bindTools` advertises `tool.name`, so
+     * that is what the model calls — a map keyed by a local variable silently loses any tool whose two
+     * names drifted apart, leaving it advertised, callable, and permanently "not found". The key stays
+     * as a fallback so a caller may still address a tool by it.
+     *
+     * `fatal` is the ONE exception to "never throws", and it exists because containment has a cost the
+     * containment itself cannot see. A tool may be a whole pipeline behind a single call; when the
+     * thing that stopped it is an exhausted budget or a refusal, handing the model a readable error
+     * message is an invitation to pick another tool and spend again. A caller that knows which errors
+     * mean "stop" says so here, and those alone travel out.
+     */
+    safeInvokeTool: (tools: AgentToolSet, toolCall: ToolCall, fatal?: (e: unknown) => boolean) => Promise<unknown>;
+}
+//# sourceMappingURL=types.d.ts.map

package/build/helpers/tools/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/helpers/tools/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,0BAA0B,CAAA;AACxD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAA;AAElD,oGAAoG;AACpG,MAAM,WAAW,iBAAiB;IAAG,KAAK,EAAE,MAAM,CAAA;CAAE;AAEpD,uFAAuF;AACvF,MAAM,WAAW,UAAU;IACzB,eAAe,EAAE,CAAC,CAAC,EAAE,OAAO,KAAK,iBAAiB,CAAA;IAClD,WAAW,EAAE,CAAC,MAAM,EAAE,OAAO,KAAK,MAAM,IAAI,iBAAiB,CAAA;IAC7D;;;;;;;;;;;;;;;;;;;;;;;;OAwBG;IACH,cAAc,EAAE,CAAC,KAAK,EAAE,YAAY,EAAE,QAAQ,EAAE,QAAQ,EAAE,KAAK,CAAC,EAAE,CAAC,CAAC,EAAE,OAAO,KAAK,OAAO,KAAK,OAAO,CAAC,OAAO,CAAC,CAAA;CAC/G"}

package/build/helpers/tools/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/build/helpers/{types.js.map → tools/types.js.map}

@@ -1 +1 @@
-{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/helpers/types.ts"],"names":[],"mappings":""}
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../src/helpers/tools/types.ts"],"names":[],"mappings":""}

package/build/helpers/tools.d.ts

@@ -1,32 +1,12 @@
 import type { ToolCall } from '@langchain/core/messages';
 import type { AgentToolSet } from '../types.js';
-import type { ToolErrorResponse } from './types.js';
+import type { ToolErrorResponse, ToolHelper } from './tools/types.js';
+export declare const createToolHelper: () => ToolHelper;
+export declare const toolHelper: ToolHelper;
+/** @deprecated compat:factory-refactor — use `toolHelper.toErrorResponse(…)` */
 export declare const toErrorResponse: (e: unknown) => ToolErrorResponse;
+/** @deprecated compat:factory-refactor — use `toolHelper.isToolError(…)` */
 export declare const isToolError: (result: unknown) => result is ToolErrorResponse;
-/**
- * Run one model-requested tool, contained.
- *
- * **Never throws.** The caller wraps this in a LangGraph task, and a rejected task aborts the whole
- * superstep: every sibling tool call in the same parallel batch dies with AbortError and the run
- * ends on "Multiple errors occurred during superstep 0", discarding work the other calls had
- * already finished. A tool failure has to come back as something the model can read and correct
- * instead — most of them are the model's own mistake (an argument outside an enum, a hallucinated
- * tool name), and the error text already names what was expected.
- *
- * Awaiting `invoke` is what makes the catch reachable: the tool's schema is validated inside it, so
- * a bad argument rejects asynchronously and returning the promise unawaited would carry the
- * rejection straight past this handler.
- *
- * Resolution is by the tool's OWN name, not by the map key. `bindTools` advertises `tool.name`, so
- * that is what the model calls — a map keyed by a local variable silently loses any tool whose two
- * names drifted apart, leaving it advertised, callable, and permanently "not found". The key stays
- * as a fallback so a caller may still address a tool by it.
- *
- * `fatal` is the ONE exception to "never throws", and it exists because containment has a cost the
- * containment itself cannot see. A tool may be a whole pipeline behind a single call; when the
- * thing that stopped it is an exhausted budget or a refusal, handing the model a readable error
- * message is an invitation to pick another tool and spend again. A caller that knows which errors
- * mean "stop" says so here, and those alone travel out.
- */
+/** @deprecated compat:factory-refactor — use `toolHelper.safeInvokeTool(…)` */
 export declare const safeInvokeTool: (tools: AgentToolSet, toolCall: ToolCall, fatal?: (e: unknown) => boolean) => Promise<unknown>;
 //# sourceMappingURL=tools.d.ts.map

package/build/helpers/tools.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"tools.d.ts","sourceRoot":"","sources":["../../src/helpers/tools.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,0BAA0B,CAAA;AAExD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,aAAa,CAAA;AAC/C,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,YAAY,CAAA;AAInD,eAAO,MAAM,eAAe,MAAO,OAAO,KAAG,iBAC2C,CAAA;AAExF,eAAO,MAAM,WAAW,WAAY,OAAO,KAAG,MAAM,IAAI,iBACW,CAAA;AAEnE;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AACH,eAAO,MAAM,cAAc,UAClB,YAAY,YAAY,QAAQ,UAAU,CAAC,CAAC,EAAE,OAAO,KAAK,OAAO,KACvE,OAAO,CAAC,OAAO,CAiBjB,CAAA"}
+{"version":3,"file":"tools.d.ts","sourceRoot":"","sources":["../../src/helpers/tools.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,0BAA0B,CAAA;AAExD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,aAAa,CAAA;AAC/C,OAAO,KAAK,EAAE,iBAAiB,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAA;AAIrE,eAAO,MAAM,gBAAgB,QAAO,UA6BnC,CAAA;AAED,eAAO,MAAM,UAAU,YAAqB,CAAA;AAE5C,gFAAgF;AAChF,eAAO,MAAM,eAAe,MAAO,OAAO,KAAG,iBAAkD,CAAA;AAE/F,4EAA4E;AAC5E,eAAO,MAAM,WAAW,WAAY,OAAO,KAAG,MAAM,IAAI,iBAAmD,CAAA;AAE3G,+EAA+E;AAC/E,eAAO,MAAM,cAAc,UAClB,YAAY,YAAY,QAAQ,UAAU,CAAC,CAAC,EAAE,OAAO,KAAK,OAAO,KACvE,OAAO,CAAC,OAAO,CAAsD,CAAA"}