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

package/build/types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,6CAA6C,CAAA;AAChF,OAAO,KAAK,EAAE,SAAS,EAAE,WAAW,EAAE,YAAY,EAAE,MAAM,0BAA0B,CAAA;AACpF,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,uBAAuB,CAAA;AACpE,OAAO,KAAK,EAAE,WAAW,EAAE,YAAY,EAAE,kBAAkB,EAAE,MAAM,mBAAmB,CAAA;AACtF,OAAO,KAAK,EAAE,SAAS,EAAE,YAAY,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAA;AAC1E,OAAO,KAAK,EAAE,SAAS,EAAE,SAAS,EAAE,cAAc,EAAE,aAAa,EAAE,MAAM,eAAe,CAAA;AACxF,OAAO,KAAK,EAAE,cAAc,EAAE,iBAAiB,EAAE,eAAe,EAAE,YAAY,EAAE,aAAa,EAAE,MAAM,wBAAwB,CAAA;AAC7H,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,sBAAsB,CAAA;AAC/D,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAA;AACxD,OAAO,KAAK,EAAE,iBAAiB,EAAE,gBAAgB,EAAE,MAAM,mBAAmB,CAAA;AAC5E,OAAO,KAAK,EAAE,aAAa,EAAE,eAAe,EAAE,MAAM,4BAA4B,CAAA;AAEhF,8FAA8F;AAC9F,MAAM,WAAW,YAAY;IAAG,CAAC,GAAG,EAAE,MAAM,GAAG,uBAAuB,CAAA;CAAE;AAExE;;;;;GAKG;AACH,MAAM,WAAW,iBAAiB;IAChC,CACE,KAAK,EAAE,cAAc,EAAE,EAAE,OAAO,EAAE,SAAS,EAAE,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,SAAS,CAAC,EAAE,MAAM,GAC/F,OAAO,CAAC,OAAO,CAAC,CAAA;CACpB;AAED,MAAM,WAAW,YAAY;IAC3B,oFAAoF;IACpF,IAAI,EAAE,SAAS,CAAA;IACf,uDAAuD;IACvD,UAAU,CAAC,EAAE,aAAa,CAAA;IAC1B,KAAK,EAAE,YAAY,CAAA;IACnB,2FAA2F;IAC3F,OAAO,CAAC,EAAE,MAAM,EAAE,CAAA;IAClB,YAAY,CAAC,EAAE,eAAe,CAAA;IAC9B,qDAAqD;IACrD,UAAU,CAAC,EAAE,MAAM,CAAA;IACnB,QAAQ,CAAC,EAAE,iBAAiB,CAAA;IAC5B,OAAO,CAAC,EAAE,MAAM,aAAa,CAAA;IAC7B;;;;OAIG;IACH,OAAO,CAAC,EAAE,MAAM,aAAa,GAAG,SAAS,CAAA;IACzC,sFAAsF;IACtF,QAAQ,CAAC,EAAE,SAAS,CAAA;IACpB,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB;;;;;OAKG;IACH,KAAK,CAAC,EAAE,CAAC,CAAC,EAAE,OAAO,KAAK,OAAO,CAAA;IAC/B;;;;;;;OAOG;IACH,UAAU,CAAC,EAAE,OAAO,CAAA;IACpB,OAAO,CAAC,EAAE,WAAW,EAAE,CAAA;CACxB;AAED,MAAM,WAAW,eAAe;IAC9B,2DAA2D;IAC3D,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,iDAAiD;IACjD,OAAO,CAAC,EAAE,MAAM,EAAE,CAAA;CACnB;AAED,MAAM,WAAW,eAAe;IAC9B,MAAM,EAAE,cAAc,CAAA;IACtB,8FAA8F;IAC9F,IAAI,CAAC,EAAE,MAAM,CAAA;IACb,KAAK,CAAC,EAAE,KAAK,CAAA;CACd;AAED,8FAA8F;AAC9F,MAAM,WAAW,QAAQ;IACvB,EAAE,EAAE,MAAM,CAAA;IACV,YAAY,EAAE,eAAe,CAAA;IAC7B,IAAI,EAAE,SAAS,CAAA;IACf,IAAI,EAAE,SAAS,CAAA;IACf,mCAAmC;IACnC,MAAM,EAAE,MAAM,CAAA;IACd,MAAM,EAAE,MAAM,CAAA;CACf;AAED,MAAM,WAAW,cAAc;IAC7B,EAAE,EAAE,MAAM,CAAA;IACV,YAAY,EAAE,eAAe,CAAA;IAC7B,qGAAqG;IACrG,MAAM,EAAE,CAAC,OAAO,EAAE,eAAe,KAAK,OAAO,CAAC,IAAI,CAAC,CAAA;CACpD;AAED,MAAM,WAAW,WAAW;IAC1B,OAAO,EAAE,SAAS,CAAA;IAClB,2EAA2E;IAC3E,QAAQ,EAAE,WAAW,EAAE,CAAA;IACvB,GAAG,EAAE,cAAc,CAAA;CACpB;AAED;;;;;;GAMG;AACH,MAAM,WAAW,WAAW;IAC1B,KAAK,EAAE,MAAM,CAAA;IACb,wCAAwC;IACxC,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,OAAO,CAAC,EAAE,CAAC,GAAG,EAAE,QAAQ,KAAK,OAAO,CAAC,MAAM,EAAE,CAAC,CAAA;IAC9C,KAAK,CAAC,EAAE,CAAC,GAAG,EAAE,QAAQ,KAAK,YAAY,CAAA;IACvC,MAAM,CAAC,EAAE,CAAC,GAAG,EAAE,QAAQ,EAAE,QAAQ,EAAE,SAAS,WAAW,EAAE,KAAK,OAAO,CAAC,IAAI,CAAC,CAAA;IAC3E,QAAQ,CAAC,EAAE,CAAC,GAAG,EAAE,QAAQ,EAAE,MAAM,EAAE,WAAW,EAAE,OAAO,EAAE,eAAe,KAAK,OAAO,CAAC,IAAI,CAAC,CAAA;IAC1F;;;;;;OAMG;IACH,IAAI,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,gBAAgB,GAAG,SAAS,CAAA;IACtD,4FAA4F;IAC5F,YAAY,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,OAAO,CAAC,mBAAmB,GAAG,SAAS,CAAC,CAAA;CAC3E;AAED,MAAM,WAAW,UAAU;IACzB,GAAG,EAAE,CAAC,MAAM,EAAE,WAAW,KAAK,IAAI,CAAA;IAClC,MAAM,EAAE,CAAC,KAAK,EAAE,MAAM,GAAG,YAAY,EAAE,IAAI,CAAC,EAAE,eAAe,KAAK,OAAO,CAAC,WAAW,CAAC,CAAA;IACtF,YAAY,EAAE,MAAM,eAAe,CAAA;CACpC;AAED,MAAM,WAAW,eAAe;IAC9B,IAAI,EAAE,CAAC,KAAK,CAAC,EAAE,MAAM,KAAK,OAAO,CAAC,iBAAiB,EAAE,CAAC,CAAA;IACtD,MAAM,EAAE,CAAC,KAAK,EAAE,IAAI,CAAC,iBAAiB,EAAE,IAAI,GAAG,KAAK,GAAG,WAAW,CAAC,KAAK,OAAO,CAAC,iBAAiB,CAAC,CAAA;CACnG;AAED,MAAM,WAAW,mBAAmB;IAClC,wFAAwF;IACxF,KAAK,CAAC,EAAE,WAAW,EAAE,CAAA;IACrB,SAAS,CAAC,EAAE,cAAc,CAAA;IAC1B,OAAO,CAAC,EAAE,WAAW,EAAE,CAAA;IACvB,aAAa,CAAC,EAAE,iBAAiB,CAAA;CAClC;AAED,0EAA0E;AAC1E,MAAM,WAAW,oBAAoB,CAAC,CAAC,SAAS,aAAa,EAAE,CAAC,CAC9D,SAAQ,IAAI,CAAC,eAAe,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,MAAM,GAAG,cAAc,CAAC;IAC5D,+FAA+F;IAC/F,KAAK,EAAE,MAAM,CAAA;IACb,IAAI,CAAC,EAAE,gBAAgB,CAAA;IACvB,YAAY,CAAC,EAAE,mBAAmB,CAAA;CACnC;AAED,MAAM,WAAW,YAAa,SAAQ,kBAAkB;IACtD,kEAAkE;IAClE,KAAK,EAAE,CAAC,OAAO,EAAE,YAAY,KAAK,UAAU,CAAA;IAC5C;;;;;;OAMG;IACH,QAAQ,EAAE,CAAC,CAAC,SAAS,aAAa,EAAE,CAAC,EACnC,IAAI,EAAE,YAAY,EAAE,OAAO,EAAE,oBAAoB,CAAC,CAAC,EAAE,CAAC,CAAC,KACpD,OAAO,CAAC,aAAa,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAA;IACjC,GAAG,EAAE,CAAC,MAAM,EAAE,WAAW,KAAK,IAAI,CAAA;IAClC,OAAO,EAAE,MAAM,WAAW,EAAE,CAAA;IAC5B,IAAI,EAAE,YAAY,CAAA;IAClB,SAAS,EAAE,MAAM,cAAc,CAAA;IAC/B,kGAAkG;IAClG,YAAY,EAAE,CAAC,GAAG,EAAE,eAAe,KAAK,eAAe,CAAA;CACxD;AAED,MAAM,WAAW,iBAAiB;IAChC,MAAM,EAAE,MAAM,YAAY,CAAA;CAC3B;AAED,MAAM,WAAW,YAAY,CAAC,CAAC,SAAS,WAAW,GAAG,WAAW,CAAE,SAAQ,YAAY,CAAC,CAAC,CAAC,EAAE,iBAAiB;CAAG;AAEhH,MAAM,WAAW,eAAgB,SAAQ,IAAI,CAC3C,YAAY,EAAE,OAAO,GAAG,KAAK,GAAG,SAAS,GAAG,MAAM,GAAG,WAAW,GAAG,cAAc,GAAG,UAAU,CAC/F;CAAG"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@owlmeans/agent",
-  "version": "0.1.18-rc.47",
+  "version": "0.1.18-rc.49",
   "license": "MIT",
   "type": "module",
   "scripts": {
@@ -68,14 +68,14 @@
     "@langchain/langgraph-checkpoint": "^1.1.5"
   },
   "dependencies": {
-    "@owlmeans/agent-common": "^0.1.18-rc.47",
-    "@owlmeans/basic-ids": "^0.1.18-rc.36",
-    "@owlmeans/context": "^0.1.18-rc.33",
-    "@owlmeans/error": "^0.1.18-rc.37",
-    "@owlmeans/flow": "^0.1.18-rc.44",
-    "@owlmeans/llm": "^0.1.18-rc.44",
-    "@owlmeans/llm-common": "^0.1.18-rc.38",
-    "@owlmeans/log": "^0.1.18-rc.1",
+    "@owlmeans/agent-common": "^0.1.18-rc.48",
+    "@owlmeans/basic-ids": "^0.1.18-rc.38",
+    "@owlmeans/context": "^0.1.18-rc.34",
+    "@owlmeans/error": "^0.1.18-rc.38",
+    "@owlmeans/flow": "^0.1.18-rc.45",
+    "@owlmeans/llm": "^0.1.18-rc.46",
+    "@owlmeans/llm-common": "^0.1.18-rc.39",
+    "@owlmeans/log": "^0.1.18-rc.2",
     "ajv": "^8.20.0"
   },
   "publishConfig": {

package/src/helpers/compaction/types.ts

@@ -0,0 +1,51 @@
+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>
+}

package/src/helpers/compaction.ts

@@ -2,104 +2,86 @@ import type { BaseMessage } from '@langchain/core/messages'
 import { AgentRunStatus, DEFAULT_ADVICE_CHARS, DEFAULT_SUMMARY_CHARS, truncateAt } from '@owlmeans/agent-common'
 import { logger } from '@owlmeans/log'
 import { COMPACTION_SCHEMA, DEFAULT_TRANSCRIPT_CHARS } from './consts.local.js'
-import type { Compaction, CompactionInput } from './types.js'
+import type { Compaction, CompactionHelper, CompactionInput } from './compaction/types.js'
 
 const log = logger('agent')
 
-/** The text of a message, whatever content shape it arrived in. */
-export const messageText = (message: BaseMessage): string => {
-  const content = message.content
-  if (typeof content === 'string') {
-    return content
-  }
-  if (Array.isArray(content)) {
-    return content
-      .map(part => typeof part === 'string' ? part : (part as { text?: string }).text ?? '')
-      .filter(text => text !== '')
-      .join('\n')
-  }
+export const createCompactionHelper = (): CompactionHelper => {
+  const messageText = (message: BaseMessage): string => {
+    const content = message.content
+    if (typeof content === 'string') {
+      return content
+    }
+    if (Array.isArray(content)) {
+      return content
+        .map(part => typeof part === 'string' ? part : (part as { text?: string }).text ?? '')
+        .filter(text => text !== '')
+        .join('\n')
+    }
 
-  return ''
-}
+    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: readonly BaseMessage[], maxChars = DEFAULT_TRANSCRIPT_CHARS,
-): string => {
-  const lines: string[] = []
-  let used = 0
-
-  for (let i = messages.length - 1; i >= 0; --i) {
-    const message = messages[i]
-    const text = messageText(message).trim()
-    const calls = (message as { tool_calls?: Array<{ name: string }> }).tool_calls
-    const body = text !== ''
-      ? text
-      : calls != null && calls.length > 0
-        ? `(called ${calls.map(call => call.name).join(', ')})`
-        : ''
-    if (body === '') {
-      continue
+  const renderTranscript = (
+    messages: readonly BaseMessage[], maxChars = DEFAULT_TRANSCRIPT_CHARS,
+  ): string => {
+    const lines: string[] = []
+    let used = 0
+
+    for (let i = messages.length - 1; i >= 0; --i) {
+      const message = messages[i]
+      const text = messageText(message).trim()
+      const calls = (message as { tool_calls?: Array<{ name: string }> }).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
     }
 
-    const line = `${message.getType()}: ${body}`
-    if (used + line.length > maxChars) {
-      break
-    }
-    lines.unshift(line)
-    used += line.length
+    return lines.join('\n\n')
   }
 
-  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: CompactionInput): Promise<Compaction> => {
-  const {
-    model, prompt, messages, status, note,
-    maxSummaryChars = DEFAULT_SUMMARY_CHARS,
-    maxAdviceChars = DEFAULT_ADVICE_CHARS,
-    action = 'agent-compaction',
-    maxTranscriptChars,
-  } = input
-
-  const fallback = (): Compaction => {
-    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,
-      ),
+  const composeCompaction = async (input: CompactionInput): Promise<Compaction> => {
+    const {
+      model, prompt, messages, status, note,
+      maxSummaryChars = DEFAULT_SUMMARY_CHARS,
+      maxAdviceChars = DEFAULT_ADVICE_CHARS,
+      action = 'agent-compaction',
+      maxTranscriptChars,
+    } = input
+
+    const fallback = (): Compaction => {
+      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()
-  }
+    if (model == null) {
+      return fallback()
+    }
 
-  try {
-    const result = await model.invoke<{ summary: string, advice: string }>(
-      `
+    try {
+      const result = await model.invoke<{ summary: string, advice: string }>(
+        `
 Compact the conversation below into a handover for the next session working on the same subject.
 
 Write two things:
@@ -122,20 +104,35 @@ ${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()
+        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()
+    }
   }
+
+  return { messageText, renderTranscript, composeCompaction }
 }
+
+export const compactionHelper = createCompactionHelper()
+
+/** @deprecated compat:factory-refactor — use `compactionHelper.messageText(…)` */
+export const messageText = (message: BaseMessage): string => compactionHelper.messageText(message)
+
+/** @deprecated compat:factory-refactor — use `compactionHelper.renderTranscript(…)` */
+export const renderTranscript = (messages: readonly BaseMessage[], maxChars?: number): string =>
+  compactionHelper.renderTranscript(messages, maxChars)
+
+/** @deprecated compat:factory-refactor — use `compactionHelper.composeCompaction(…)` */
+export const composeCompaction = (input: CompactionInput): Promise<Compaction> => compactionHelper.composeCompaction(input)

package/src/helpers/index.ts

@@ -1,4 +1,6 @@
+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'

package/src/helpers/rolling/types.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
+}

package/src/helpers/rolling.ts

@@ -1,6 +1,6 @@
 import { truncateAt } from '@owlmeans/agent-common'
 import { logger } from '@owlmeans/log'
-import type { RollingSummaryInput } from './types.js'
+import type { RollingSummaryInput } from './rolling/types.js'
 
 const log = logger('agent')
 

package/src/helpers/tools/types.ts

@@ -0,0 +1,37 @@
+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>
+}

package/src/helpers/tools.ts

@@ -1,58 +1,50 @@
 import type { ToolCall } from '@langchain/core/messages'
 import { logger } from '@owlmeans/log'
 import type { AgentToolSet } from '../types.js'
-import type { ToolErrorResponse } from './types.js'
+import type { ToolErrorResponse, ToolHelper } from './tools/types.js'
 
 const log = logger('agent:tools')
 
-export const toErrorResponse = (e: unknown): ToolErrorResponse =>
-  ({ error: `Error during tool call: ${(e instanceof Error) ? e.message : String(e)}` })
-
-export const isToolError = (result: unknown): result is ToolErrorResponse =>
-  typeof result === 'object' && result != null && 'error' in result
-
-/**
- * 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.
- */
-export const safeInvokeTool = async (
-  tools: AgentToolSet, toolCall: ToolCall, fatal?: (e: unknown) => boolean,
-): Promise<unknown> => {
-  const tool = tools[toolCall.name]
-    ?? Object.values(tools).find(entry => entry.name === toolCall.name)
+export const createToolHelper = (): ToolHelper => {
+  const toErrorResponse = (e: unknown): ToolErrorResponse =>
+    ({ error: `Error during tool call: ${(e instanceof Error) ? e.message : String(e)}` })
 
-  if (tool == null) {
-    return toErrorResponse(new Error(`Tool ${toolCall.name} not found`))
-  }
+  const isToolError = (result: unknown): result is ToolErrorResponse =>
+    typeof result === 'object' && result != null && 'error' in result
+
+  const safeInvokeTool = async (
+    tools: AgentToolSet, toolCall: ToolCall, fatal?: (e: unknown) => boolean,
+  ): Promise<unknown> => {
+    const tool = tools[toolCall.name]
+      ?? Object.values(tools).find(entry => entry.name === toolCall.name)
 
-  try {
-    return await tool.invoke(toolCall.args)
-  } catch (e) {
-    if (fatal?.(e) === true) {
-      throw e
+    if (tool == null) {
+      return toErrorResponse(new Error(`Tool ${toolCall.name} not found`))
+    }
+
+    try {
+      return await tool.invoke(toolCall.args)
+    } catch (e) {
+      if (fatal?.(e) === true) {
+        throw e
+      }
+      log.warn('Tool call failed', { tool: toolCall.name, error: e })
+      return toErrorResponse(e)
     }
-    log.warn('Tool call failed', { tool: toolCall.name, error: e })
-    return toErrorResponse(e)
   }
+
+  return { toErrorResponse, isToolError, safeInvokeTool }
 }
+
+export const toolHelper = createToolHelper()
+
+/** @deprecated compat:factory-refactor — use `toolHelper.toErrorResponse(…)` */
+export const toErrorResponse = (e: unknown): ToolErrorResponse => toolHelper.toErrorResponse(e)
+
+/** @deprecated compat:factory-refactor — use `toolHelper.isToolError(…)` */
+export const isToolError = (result: unknown): result is ToolErrorResponse => toolHelper.isToolError(result)
+
+/** @deprecated compat:factory-refactor — use `toolHelper.safeInvokeTool(…)` */
+export const safeInvokeTool = (
+  tools: AgentToolSet, toolCall: ToolCall, fatal?: (e: unknown) => boolean,
+): Promise<unknown> => toolHelper.safeInvokeTool(tools, toolCall, fatal)

package/src/model.ts

@@ -4,7 +4,7 @@ import { addMessages, entrypoint, task } from '@langchain/langgraph'
 import { createIdOfLength } from '@owlmeans/basic-ids'
 import { makeFlowModel } from '@owlmeans/flow'
 import type { FlowModel } from '@owlmeans/flow'
-import { pluginFor } from '@owlmeans/llm'
+import { llmPluginRegistry } from '@owlmeans/llm'
 import type { HelperExecution, ModelInputItem } from '@owlmeans/llm'
 import { logger } from '@owlmeans/log'
 import {
@@ -12,10 +12,10 @@ import {
 } from '@owlmeans/agent-common'
 import { DEFAULT_ACTION, DEFAULT_ENTRYPOINT, DEFAULT_MAX_TURNS, DEFAULT_PLUGIN_ORDER } from './consts.js'
 import { AgentLoopExhaustedError, AgentMissconfiguredError } from './errors.js'
-import { safeInvokeTool } from './helpers/tools.js'
 import type {
   AgentModel, AgentOptions, AgentPlugin, AgentResult, AgentRun, AgentRunOutcome, AgentToolSet,
 } from './types.js'
+import { toolHelper } from './helpers/tools.js'
 
 const log = logger('agent')
 
@@ -49,7 +49,7 @@ export const makeAgentModel = (options: AgentOptions): AgentModel => {
 
   const conversation = options.conversation ?? conversationFor(exec.purpose)
   const prompts = options.prompts ?? exec.prompts
-  const provider = options.provider ?? pluginFor(agentModel)
+  const provider = options.provider ?? llmPluginRegistry.pluginFor(agentModel)
   const purpose = exec.purpose
 
   const registry: AgentPlugin[] = []
@@ -167,7 +167,7 @@ export const makeAgentModel = (options: AgentOptions): AgentModel => {
       // `safeInvokeTool` is what keeps a bad argument from costing the work the others finished.
       const call = task(
         'call-tool',
-        async (toolCall: ToolCall) => safeInvokeTool(toolSet, toolCall, options.fatal),
+        async (toolCall: ToolCall) => toolHelper.safeInvokeTool(toolSet, toolCall, options.fatal),
       )
 
       const agent = entrypoint(entrypointName, async (messages: BaseMessageLike[]) => {

package/src/pipeline/index.ts

@@ -1,4 +1,5 @@
 export * from './runner.js'
 export * from './results.js'
 export * from './consts.js'
-export type * from './types.js'
+export type * from './runner/types.js'
+export type * from './results/types.js'

package/src/pipeline/{types.local.ts → results/types.local.ts}

@@ -1,6 +1,5 @@
 import { type CumulativeResultEntry, type CumulativeResultFact, type CumulativeResultsSpec, type PipelineSpec, type StepResultsSpec, CumulativeResultSource, ResultViewMode } from '@owlmeans/agent-common'
 import type { StepResults, VisibleResultEntry } from './types.js'
-import type { BaseCheckpointSaver } from '@langchain/langgraph'
 
 export interface Recorded {
   files: Set<string>
@@ -39,23 +38,3 @@ export interface EntryParts {
   partial?: boolean
   summary?: string
 }
-
-/**
- * The graph builder, seen loosely.
- *
- * `StateGraph`'s node names are a generic parameter that only a literal-typed builder chain can
- * satisfy, and a pipeline's nodes come from data. The precision belongs at THIS package's public
- * boundary — `PipelineSpec`, `PipelineStep`, `PipelineModel` are all exact — not in the three lines
- * that hand LangGraph a name it will look up in a map either way.
- */
-export interface LooseGraph {
-  addNode: (
-    name: string,
-    fn: (state: unknown) => Promise<Record<string, unknown>>,
-    options?: Record<string, unknown>,
-  ) => LooseGraph
-  addEdge: (start: string | string[], end: string) => LooseGraph
-  compile: (options?: { checkpointer?: BaseCheckpointSaver }) => {
-    invoke: (input: unknown, config?: Record<string, unknown>) => Promise<unknown>
-  }
-}