@a-dray/aglib 0.2.0 → 0.3.1

package/dist/run.js.map

@@ -1 +1 @@
-{"version":3,"file":"run.js","sourceRoot":"","sources":["../src/run.ts"],"names":[],"mappings":"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","sourcesContent":["import type { Agent, AgentRun, Arrival, RunAgentOptions, RunResult } from \"./agent.js\";\nimport type { Failure } from \"./result.js\";\nimport type { Update } from \"./harness/harness.js\";\nimport type { Delivery, Store, StoreConflict, StoreError } from \"./store/store.js\";\nimport type { Content } from \"./content.js\";\nimport type { Entry, Stored, Usage } from \"./session/entry.js\";\nimport { err } from \"./result.js\";\nimport { createLog } from \"./session/log.js\";\nimport { toMessages } from \"./session/messages.js\";\nimport { createExecutor } from \"./tools/execute.js\";\n\n/**\n * Start an agent on a session.\n *\n * Without a store the log lives in memory and the session is ephemeral; with\n * one, every commit is durable before the next turn is built. The agent\n * definition is identical either way — durability is a composition choice, not\n * a different program.\n */\nexport function runAgent(options: RunAgentOptions): AgentRun {\n  // A claim names its own session; a caller sending into a new one names none.\n  const claim = options.claim;\n  const sessionId = claim?.sessionId ?? options.sessionId ?? crypto.randomUUID();\n  const controller = new AbortController();\n  // Composed rather than forwarded. `addEventListener(\"abort\", …)` never fires\n  // on a signal that has already aborted, so a caller who gave up before\n  // calling got a full run anyway; and a listener added per run to a signal\n  // that outlives it is a leak the run cannot clean up.\n  const signal = options.signal\n    ? AbortSignal.any([options.signal, controller.signal])\n    : controller.signal;\n\n  const updates = createChannel<Update>();\n  const result = execute();\n\n  return {\n    result,\n    cancel: () => controller.abort(),\n    [Symbol.asyncIterator]: () => updates.iterator(),\n  };\n\n  async function execute(): Promise<RunResult> {\n    // What this activation consumed. Summed from the `assistant` entries it\n    // commits rather than reported by the harness, so one answer serves a loop\n    // we own and a loop we do not — and so a run that failed still says what it\n    // burned on the way there.\n    const usage: Usage = {};\n\n    try {\n      const { agent, store } = options;\n      const restored = store ? await open(store, sessionId, agent, options.key) : undefined;\n      if (restored && !restored.ok) {\n        return {\n          status: \"failed\", error: restored.error,\n          seq: positionOf(restored.error, 0), usage,\n        };\n      }\n      // The store's own position, not the last entry's. They agree only while\n      // nothing has ever been folded away, and the store is the one that knows.\n      const log = createLog(restored?.value.entries ?? [], restored?.value.seq ?? 0);\n      const stopping = (error: Failure): RunResult => ({ status: \"failed\", error, seq: log.seq, usage });\n\n      // A claim was read at a position. If the session has moved since, this\n      // worker lost, and the deliveries it was carrying are still where it\n      // found them.\n      if (claim && claim.seq !== log.seq) {\n        return stopping({ code: \"conflict\", message: `Session is at ${log.seq}, not ${claim.seq}`, retryable: true });\n      }\n\n      // A ceiling on money needs something that can count it. Refused here\n      // rather than silently ignored, because a limit that is declared and not\n      // enforced is the most expensive kind of nothing.\n\n      // The activation still open on this log, if one is. It decides three\n      // things below: whether there is anything to resume, which run a\n      // resumption continues, and which run a fresh activation supersedes.\n      const interrupted = openRunId(log.entries);\n\n      // What this run is adding, then what was waiting. A claim's deliveries\n      // are named so the log records who each came from; anything the worker\n      // supplies itself leads, because the only thing that ever does is\n      // orientation for a harness with nowhere else to put it.\n      const arrivals: readonly Arrival[] = [\n        ...arrivalsOf(options.input),\n        ...(claim?.pending ?? []).map((delivery): Arrival => ({\n          input: delivery.input,\n          ...(delivery.from ? { from: delivery.from } : {}),\n        })),\n      ];\n\n      // A resumption continues the run it was handed, under that run's id. A\n      // fresh id would leave the log holding a `run.started` nothing closes and\n      // a `run.finished` nothing opened — a pair that only the store's\n      // type-based rule saves, and that anything grouping entries by run reads\n      // as broken. A resumption without an interrupted run is refused below.\n      const runId = arrivals.length || !interrupted ? crypto.randomUUID() : interrupted;\n\n      // Deliveries ride the next commit, which is the one that records the work\n      // that produced them. They used to be held back to the run's final entry\n      // so that a failed run handed nothing to anyone — a stronger promise than\n      // any caller needs, and it was being paid for with a lie: a `send` tool\n      // returned \"Delivered\" and interrupted the recipient many turns before\n      // the delivery existed, and never at all if a later turn failed.\n      const deliveries: Delivery[] = [];\n\n      // The ceiling has one owner, and it is here rather than in a harness.\n      // Counting committed entries is the only way to bound a harness that owns\n      // its own loop — which is most of them — so a limit declared on the agent\n      // holds for every one instead of only for ours.\n      const limits = agent.limits;\n      let stopped: Failure | undefined;\n      let turns = 0;\n      let toolCalls = 0;\n\n      function exceeded(): Failure | undefined {\n        if (!limits) return undefined;\n        if (limits.maxTurns !== undefined && turns >= limits.maxTurns) {\n          return { code: \"turn-limit\", message: `Stopped after ${turns} turns.`, retryable: false };\n        }\n        if (limits.maxToolCalls !== undefined && toolCalls >= limits.maxToolCalls) {\n          return { code: \"tool-call-limit\", message: `Stopped after ${toolCalls} tool calls.`, retryable: false };\n        }\n        // Checked where work is recorded rather than on a timer: a deadline\n        // stops the next piece of work, it does not interrupt one mid-flight.\n        if (limits.deadline !== undefined && Date.now() >= Date.parse(limits.deadline)) {\n          return { code: \"deadline\", message: `Stopped at the deadline of ${limits.deadline}.`, retryable: false };\n        }\n        return undefined;\n      }\n\n      // How many deliveries the next write takes off this session's own queue:\n      // what the claim was carrying, and afterwards whatever `drain` folded in.\n      // Cleared by the write that lands, because the input is gone once the\n      // entries carrying it are durable, and not before.\n      let take = claim?.pending.length ?? 0;\n\n      async function commit(entries: readonly Entry[], enqueue?: readonly Delivery[]): Promise<void> {\n        const outgoing = [...deliveries, ...(enqueue ?? [])];\n        deliveries.length = 0;\n        if (!entries.length && !outgoing.length) return;\n        // Counted before the write, not after: the tokens were consumed whether\n        // or not this entry wins the compare-and-swap, and a run that reports\n        // nothing after paying for a generation is the opposite of what\n        // `RunResult.usage` promises.\n        for (const entry of entries) {\n          if (entry.type === \"assistant\" && entry.usage) accumulate(usage, entry.usage);\n        }\n\n        if (store) {\n          const written = await store.append({\n            sessionId, expectedSeq: log.seq, entries,\n            ...(outgoing.length ? { enqueue: outgoing } : {}),\n            ...(take ? { takePending: take } : {}),\n          });\n          if (!written.ok) throw new CommitFailed(written.error, positionOf(written.error, log.seq));\n          take = 0;\n        }\n        for (const stored of log.append(entries)) updates.push({ type: \"entry\", entry: stored });\n\n        if (!stopped) {\n          for (const entry of entries) {\n            if (entry.type === \"assistant\") turns += 1;\n            // `tool.finished`, not `tool.started`: the start is committed before\n            // the batch executes, so counting it there cancelled the very batch\n            // that reached the ceiling — `maxToolCalls: 1` ran no tools at all,\n            // and said it had stopped after one.\n            if (entry.type === \"tool.finished\") toolCalls += 1;\n          }\n          stopped = exceeded();\n          if (stopped) controller.abort();\n        }\n      }\n\n      /**\n       * What the agent wants delivered as this run ends.\n       *\n       * A callback that throws must not cost the log its terminal entry: the\n       * run would stay open, and an open run nothing closes is claimed by\n       * `interrupted` every window for ever — the trap the no-recovery path above\n       * exists to close. So the throw is held, the run is ended without the\n       * deliveries, and it is re-thrown once the log is safe.\n       */\n      let reportFailure: unknown;\n      async function reporting(run: {\n        runId: string; outcome: \"completed\" | \"failed\" | \"cancelled\"; output: Content;\n      }): Promise<readonly Delivery[]> {\n        if (!agent.finished) return [];\n        try {\n          return await agent.finished({ sessionId, ...run });\n        } catch (error) {\n          reportFailure = error;\n          return [];\n        }\n      }\n\n      // Input that arrived while this activation was running, taken from the\n      // front of the queue and committed as part of it. `takePending` removes\n      // exactly what was committed, in the same write, so losing the position\n      // loses the turn and never the messages.\n      async function drain(): Promise<number> {\n        if (!store) return 0;\n        // Nothing is folded into an activation that is over. Draining here\n        // committed the waiting deliveries and took them off the queue, and the\n        // loop then ended — leaving a peer's message answered by nobody and\n        // invisible to `next` (nothing pending) and to `interrupted` (no open run),\n        // which is the trap this whole path exists to close.\n        if (signal.aborted) return 0;\n        const current = await store.read({ sessionId, afterSeq: log.seq });\n        if (!current.ok || !current.value.pending.length) return 0;\n        const waiting = current.value.pending;\n        take = waiting.length;\n        await commit(waiting.map((delivery): Entry => ({\n          type: \"run.started\", runId, input: delivery.input,\n          ...(delivery.from ? { from: delivery.from } : {}),\n        })));\n        return waiting.length;\n      }\n\n      const executor = agent.tools?.length\n        ? createExecutor({\n            tools: agent.tools,\n            ...(agent.decide ? { decide: agent.decide } : {}),\n            sessionId, runId,\n            enqueue: (delivery) => deliveries.push(delivery),\n            report: (callId, data) => updates.push({ type: \"tool.progress\", callId, data }),\n          })\n        : undefined;\n\n      if (!arrivals.length) {\n        // An open run is what a resumption continues. Without one there is\n        // nothing half-done here: a closed log would otherwise take a second\n        // `run.finished` with no beginning to match it.\n        if (!interrupted) {\n          return stopping({\n            code: \"nothing-to-resume\",\n            message: \"An activation with no input continues an interrupted run, and this session has none open.\",\n            retryable: false,\n          });\n        }\n        if (agent.harness.recovery !== \"history\") {\n          // Asked to continue a log this harness cannot read. The interrupted\n          // run is ended rather than left open, because nothing else will\n          // continue it either — the harness is a property of the session — and\n          // a run that stays open is handed back by `interrupted` every window,\n          // for ever. A worker that provisions anything before it runs pays for\n          // that each time round.\n          const failure: Failure = {\n            code: \"no-recovery\",\n            message: `The ${agent.harness.id} harness cannot restart from history, so this activation cannot be continued.`,\n            retryable: false,\n          };\n          // Whoever was waiting on it is told, in the write that ends it. A\n          // parent expecting a child that can now never report is the same dead\n          // end one layer up.\n          const told = await reporting({ runId: interrupted, outcome: \"failed\", output: \"\" });\n          await commit([{ type: \"run.finished\", runId: interrupted, outcome: \"failed\", error: failure }], told);\n          return stopping(failure);\n        }\n      }\n\n      // An interrupted predecessor is ended before a new activation begins over\n      // it, so one session never holds two open runs. Only on a claim: the\n      // store established there that nothing else is running, where a bare\n      // `sessionId` establishes nothing and the run may still be live.\n      if (arrivals.length && interrupted && claim) {\n        await commit([{\n          type: \"run.finished\", runId: interrupted, outcome: \"cancelled\",\n          error: {\n            code: \"superseded\",\n            message: \"This activation was interrupted, and a later one began over it.\",\n            retryable: false,\n          },\n        }]);\n      }\n\n      // Nothing opens a resumption. A `run.started` recording input nobody sent\n      // would be a second beginning for one conversation; the loop reads the\n      // history it was handed instead, sees the call that already ran, and\n      // carries on rather than asking for it again.\n      await commit(arrivals.map((arrival): Entry => ({\n        type: \"run.started\", runId, input: arrival.input,\n        ...(arrival.from ? { from: arrival.from } : {}),\n      })));\n\n      // Every ceiling is checked where work is recorded, and a resumption\n      // records nothing before its first turn — so a deadline that had already\n      // passed was never seen. Checked once here too, before the harness is\n      // handed anything.\n      stopped ??= exceeded();\n\n      const outcome = stopped\n        ? { status: \"failed\" as const, error: stopped }\n        : await agent.harness.run({\n        sessionId, runId,\n        instructions: agent.instructions,\n        history: () => toMessages({\n          instructions: agent.instructions,\n          entries: log.entries,\n          ...(agent.attribution ? { attribution: true } : {}),\n          ...(options.context ? { context: options.context } : {}),\n        }),\n        entries: () => log.entries,\n        ...(options.context ? { context: options.context } : {}),\n        ...(executor ? { tools: executor } : {}),\n        commit: (entries) => commit(entries),\n        ...(store ? { drain } : {}),\n        emit: (update) => updates.push(update),\n        signal,\n      });\n\n      // A harness stopped by the ceiling reports a cancellation, because that is\n      // all it saw. The run knows why it was cancelled and says so instead.\n      const settled = stopped && outcome.status === \"cancelled\"\n        ? { status: \"failed\" as const, error: stopped }\n        : outcome;\n\n      const output = settled.status === \"completed\" ? settled.output : \"\";\n      const finished = await reporting({ runId, outcome: settled.status, output });\n\n      await commit(\n        [{\n          type: \"run.finished\", runId,\n          outcome: settled.status === \"completed\" ? \"completed\" : settled.status === \"cancelled\" ? \"cancelled\" : \"failed\",\n          ...(settled.status === \"failed\" ? { error: settled.error } : {}),\n        }],\n        finished,\n      );\n\n      if (settled.status === \"completed\") {\n        return { status: \"completed\", output: settled.output, seq: log.seq, usage };\n      }\n      if (settled.status === \"cancelled\") return { status: \"cancelled\", seq: log.seq, usage };\n      return stopping(settled.error);\n    } catch (error) {\n      if (error instanceof CommitFailed) {\n        return { status: \"failed\", error: error.failure, seq: error.seq, usage };\n      }\n      throw error;\n    } finally {\n      updates.close();\n    }\n  }\n}\n\nclass CommitFailed extends Error {\n  constructor(readonly failure: Failure, readonly seq: number) {\n    super(failure.message);\n  }\n}\n\n/**\n * Where the session actually is after a refused write. A conflict knows; every\n * other failure leaves the caller with the position it already had. Reporting\n * zero told a caller at forty that it was at the beginning.\n *\n * The `typeof` is not defensive noise: a store may report a conflict, and only\n * a `StoreConflict` carries the position. Casting on the code alone produced a\n * `RunResult.seq` of `undefined` under a type that says `number`.\n */\nfunction positionOf(error: StoreError, fallback: number): number {\n  const actual = (error as StoreConflict).actualSeq;\n  return error.code === \"conflict\" && typeof actual === \"number\" ? actual : fallback;\n}\n\nconst isArrival = (value: unknown): value is Arrival =>\n  typeof value === \"object\" && value !== null && !Array.isArray(value) && \"input\" in value;\n\n/**\n * One arrival, or several.\n *\n * The elements decide it, because the outer shape cannot: an arrival names its\n * `input`, a content part names its `type`, and nothing is both. Reading every\n * array as a batch is what turned one image-and-text message into one entry per\n * part, each holding a part where whole content belongs.\n */\nfunction arrivalsOf(input: RunAgentOptions[\"input\"]): readonly Arrival[] {\n  if (input === undefined) return [];\n  // Nothing sent is nothing sent. Falling through committed a `run.started`\n  // whose input was an empty array of content parts.\n  if (Array.isArray(input) && input.length === 0) return [];\n  if (Array.isArray(input) && input.length > 0 && input.every(isArrival)) return input;\n  if (isArrival(input)) return [input];\n  return [{ input: input as Content }];\n}\n\n/**\n * The activation still open on this log, if one is.\n *\n * `run.started` opens and `run.finished` closes, which is the same rule the\n * store maintains its claim from — read here from the entries rather than asked\n * of the store, because the log is the only thing that knows.\n */\nfunction openRunId(entries: readonly Stored[]): string | undefined {\n  let open: string | undefined;\n  for (const entry of entries) {\n    if (entry.type === \"run.started\") open = entry.runId;\n    if (entry.type === \"run.finished\") open = undefined;\n  }\n  return open;\n}\n\n/** Token counts add; unknown stays unknown rather than becoming a zero. */\nfunction accumulate(total: Usage, turn: Usage): void {\n  for (const key of [\"inputTokens\", \"outputTokens\", \"cacheReadTokens\", \"cacheWriteTokens\"] as const) {\n    if (turn[key] !== undefined) total[key] = (total[key] ?? 0) + turn[key]!;\n  }\n}\n\nasync function open(store: Store, sessionId: string, agent: Agent, key?: string) {\n  const existing = await store.read({ sessionId });\n  if (existing.ok) {\n    // `version` is documented as the boundary past which an agent is no longer\n    // compatible with an existing session. Nothing was comparing it, so the\n    // boundary held for exactly as long as nobody crossed it.\n    const stored = existing.value.agent;\n    if (stored.id !== agent.id || stored.version !== agent.version) {\n      return err<StoreError>({\n        code: \"conflict\",\n        message: `Session ${sessionId} belongs to ${stored.id}@${stored.version}, not ${agent.id}@${agent.version}`,\n        retryable: false,\n      });\n    }\n    return existing;\n  }\n  if (existing.error.code !== \"not-found\") return existing;\n  const created = await store.create({\n    sessionId, agent: { id: agent.id, version: agent.version }, ...(key ? { key } : {}),\n  });\n  if (!created.ok) return created;\n  return store.read({ sessionId });\n}\n\n/**\n * A bounded fan-out queue for ephemeral updates.\n *\n * One buffer of recent updates, which every listener starts from and which\n * never grows past its limit. That single rule gives three things:\n *\n * **A run nobody drains costs a fixed amount.** A headless worker used to\n * accumulate every delta of an entire activation, because the queue only ever\n * grew. Dropping the oldest is safe precisely because updates are not recovery\n * state and the committed log is.\n *\n * **Arriving late loses nothing that matters.** The first entry commits before\n * `runAgent` returns, so a caller that iterates immediately would otherwise\n * never see its own run start. A UI reconnecting mid-run gets recent history\n * for the same reason, without asking the store for it.\n *\n * **Everyone sees everything.** Each listener drains its own copy, so an\n * application can watch a run for telemetry and for a UI at once instead of the\n * two stealing events from each other.\n */\nfunction createChannel<T>(limit = 1_024) {\n  interface Listener { buffer: T[]; wake?: () => void }\n  const listeners = new Set<Listener>();\n  const replay: T[] = [];\n  let closed = false;\n\n  const bounded = (buffer: T[], value: T) => {\n    if (buffer.length >= limit) buffer.shift();\n    buffer.push(value);\n  };\n\n  return {\n    push(value: T) {\n      bounded(replay, value);\n      for (const listener of listeners) {\n        bounded(listener.buffer, value);\n        listener.wake?.();\n      }\n    },\n    close() {\n      closed = true;\n      for (const listener of listeners) listener.wake?.();\n    },\n    iterator(): AsyncIterator<T> {\n      const listener: Listener = { buffer: [...replay] };\n      listeners.add(listener);\n      const done = (): IteratorResult<T> => {\n        listeners.delete(listener);\n        return { value: undefined, done: true };\n      };\n      return {\n        async next(): Promise<IteratorResult<T>> {\n          for (;;) {\n            const value = listener.buffer.shift();\n            if (value !== undefined) return { value, done: false };\n            if (closed) return done();\n            await new Promise<void>((resolve) => { listener.wake = resolve; });\n          }\n        },\n        async return(): Promise<IteratorResult<T>> { return done(); },\n      };\n    },\n  };\n}\n"]}
+{"version":3,"file":"run.js","sourceRoot":"","sources":["../src/run.ts"],"names":[],"mappings":"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","sourcesContent":["import type { Agent, AgentRun, Arrival, RunAgentOptions, RunResult } from \"./agent.js\";\nimport type { Failure } from \"./result.js\";\nimport type { HarnessContext, HarnessResult, Update } from \"./harness/harness.js\";\nimport type { Delivery, Store, StoreConflict, StoreError } from \"./store/store.js\";\nimport type { Content } from \"./content.js\";\nimport type { Entry, Stored, Usage } from \"./session/entry.js\";\nimport { err } from \"./result.js\";\nimport { createLog } from \"./session/log.js\";\nimport { toMessages } from \"./session/messages.js\";\nimport { createExecutor } from \"./tools/execute.js\";\n\n/**\n * Start an agent on a session.\n *\n * Without a store the log lives in memory and the session is ephemeral; with\n * one, every commit is durable before the next turn is built. The agent\n * definition is identical either way — durability is a composition choice, not\n * a different program.\n */\nexport function runAgent(options: RunAgentOptions): AgentRun {\n  // A claim names its own session; a caller sending into a new one names none.\n  const hooks = options.agent.hooks ?? [];\n  if (new Set(hooks.map(hook => hook.name)).size !== hooks.length || hooks.some(hook => !hook.name)) {\n    throw new Error(\"Lifecycle hook names must be non-empty and unique.\");\n  }\n  const claim = options.claim;\n  const sessionId = claim?.sessionId ?? options.sessionId ?? crypto.randomUUID();\n  const controller = new AbortController();\n  // Composed rather than forwarded. `addEventListener(\"abort\", …)` never fires\n  // on a signal that has already aborted, so a caller who gave up before\n  // calling got a full run anyway; and a listener added per run to a signal\n  // that outlives it is a leak the run cannot clean up.\n  const signal = options.signal\n    ? AbortSignal.any([options.signal, controller.signal])\n    : controller.signal;\n\n  const updates = createChannel<Update>();\n  const result = execute();\n\n  return {\n    result,\n    cancel: () => controller.abort(),\n    [Symbol.asyncIterator]: () => updates.iterator(),\n  };\n\n  async function execute(): Promise<RunResult> {\n    // What this activation consumed. Summed from the `assistant` entries it\n    // commits rather than reported by the harness, so one answer serves a loop\n    // we own and a loop we do not — and so a run that failed still says what it\n    // burned on the way there.\n    const usage: Usage = {};\n    let hookContext: HarnessContext | undefined;\n    let result: RunResult | undefined;\n\n    try {\n      const { agent, store } = options;\n      const restored = store ? await open(store, sessionId, agent, options.key) : undefined;\n      if (restored && !restored.ok) {\n        return {\n          status: \"failed\", error: restored.error,\n          seq: positionOf(restored.error, 0), usage,\n        };\n      }\n      // The store's own position, not the last entry's. They agree only while\n      // nothing has ever been folded away, and the store is the one that knows.\n      const log = createLog(restored?.value.entries ?? [], restored?.value.seq ?? 0);\n      const stopping = (error: Failure): RunResult => (result = { status: \"failed\", error, seq: log.seq, usage });\n\n      // A claim was read at a position. If the session has moved since, this\n      // worker lost, and the deliveries it was carrying are still where it\n      // found them.\n      if (claim && claim.seq !== log.seq) {\n        return stopping({ code: \"conflict\", message: `Session is at ${log.seq}, not ${claim.seq}`, retryable: true });\n      }\n\n      // A ceiling on money needs something that can count it. Refused here\n      // rather than silently ignored, because a limit that is declared and not\n      // enforced is the most expensive kind of nothing.\n\n      // The activation still open on this log, if one is. It decides three\n      // things below: whether there is anything to resume, which run a\n      // resumption continues, and which run a fresh activation supersedes.\n      const interrupted = openRunId(log.entries);\n\n      // What this run is adding, then what was waiting. A claim's deliveries\n      // are named so the log records who each came from; anything the worker\n      // supplies itself leads, because the only thing that ever does is\n      // orientation for a harness with nowhere else to put it.\n      const arrivals: readonly Arrival[] = [\n        ...arrivalsOf(options.input),\n        ...(claim?.pending ?? []).map((delivery): Arrival => ({\n          input: delivery.input,\n          ...(delivery.from ? { from: delivery.from } : {}),\n        })),\n      ];\n\n      // A resumption continues the run it was handed, under that run's id. A\n      // fresh id would leave the log holding a `run.started` nothing closes and\n      // a `run.finished` nothing opened — a pair that only the store's\n      // type-based rule saves, and that anything grouping entries by run reads\n      // as broken. A resumption without an interrupted run is refused below.\n      const runId = arrivals.length || !interrupted ? crypto.randomUUID() : interrupted;\n\n      // Deliveries ride the next commit, which is the one that records the work\n      // that produced them. They used to be held back to the run's final entry\n      // so that a failed run handed nothing to anyone — a stronger promise than\n      // any caller needs, and it was being paid for with a lie: a `send` tool\n      // returned \"Delivered\" and interrupted the recipient many turns before\n      // the delivery existed, and never at all if a later turn failed.\n      const deliveries: Delivery[] = [];\n\n      // The ceiling has one owner, and it is here rather than in a harness.\n      // Counting committed entries is the only way to bound a harness that owns\n      // its own loop — which is most of them — so a limit declared on the agent\n      // holds for every one instead of only for ours.\n      const limits = agent.limits;\n      let stopped: Failure | undefined;\n      let turns = 0;\n      let toolCalls = 0;\n\n      function exceeded(): Failure | undefined {\n        if (!limits) return undefined;\n        if (limits.maxTurns !== undefined && turns >= limits.maxTurns) {\n          return { code: \"turn-limit\", message: `Stopped after ${turns} turns.`, retryable: false };\n        }\n        if (limits.maxToolCalls !== undefined && toolCalls >= limits.maxToolCalls) {\n          return { code: \"tool-call-limit\", message: `Stopped after ${toolCalls} tool calls.`, retryable: false };\n        }\n        // Checked where work is recorded rather than on a timer: a deadline\n        // stops the next piece of work, it does not interrupt one mid-flight.\n        if (limits.deadline !== undefined && Date.now() >= Date.parse(limits.deadline)) {\n          return { code: \"deadline\", message: `Stopped at the deadline of ${limits.deadline}.`, retryable: false };\n        }\n        return undefined;\n      }\n\n      // How many deliveries the next write takes off this session's own queue:\n      // what the claim was carrying, and afterwards whatever `drain` folded in.\n      // Cleared by the write that lands, because the input is gone once the\n      // entries carrying it are durable, and not before.\n      let take = claim?.pending.length ?? 0;\n\n      async function commit(entries: readonly Entry[], enqueue?: readonly Delivery[]): Promise<void> {\n        const outgoing = [...deliveries, ...(enqueue ?? [])];\n        deliveries.length = 0;\n        if (!entries.length && !outgoing.length) return;\n        // Counted before the write, not after: the tokens were consumed whether\n        // or not this entry wins the compare-and-swap, and a run that reports\n        // nothing after paying for a generation is the opposite of what\n        // `RunResult.usage` promises.\n        for (const entry of entries) {\n          if (entry.type === \"assistant\" && entry.usage) accumulate(usage, entry.usage);\n        }\n\n        if (store) {\n          const written = await store.append({\n            sessionId, expectedSeq: log.seq, entries,\n            ...(outgoing.length ? { enqueue: outgoing } : {}),\n            ...(take ? { takePending: take } : {}),\n          });\n          if (!written.ok) throw new CommitFailed(written.error, positionOf(written.error, log.seq));\n          take = 0;\n        }\n        for (const stored of log.append(entries)) updates.push({ type: \"entry\", entry: stored });\n\n        if (!stopped) {\n          for (const entry of entries) {\n            if (entry.type === \"assistant\") turns += 1;\n            // `tool.finished`, not `tool.started`: the start is committed before\n            // the batch executes, so counting it there cancelled the very batch\n            // that reached the ceiling — `maxToolCalls: 1` ran no tools at all,\n            // and said it had stopped after one.\n            if (entry.type === \"tool.finished\") toolCalls += 1;\n          }\n          stopped = exceeded();\n          if (stopped) controller.abort();\n        }\n      }\n\n      // Input that arrived while this activation was running, taken from the\n      // front of the queue and committed as part of it. `takePending` removes\n      // exactly what was committed, in the same write, so losing the position\n      // loses the turn and never the messages.\n      async function drain(): Promise<number> {\n        if (!store) return 0;\n        // Nothing is folded into an activation that is over. Draining here\n        // committed the waiting deliveries and took them off the queue, and the\n        // loop then ended — leaving a peer's message answered by nobody and\n        // invisible to `next` (nothing pending) and to `interrupted` (no open run),\n        // which is the trap this whole path exists to close.\n        if (signal.aborted) return 0;\n        const current = await store.read({ sessionId, afterSeq: log.seq });\n        if (!current.ok || !current.value.pending.length) return 0;\n        const waiting = current.value.pending;\n        take = waiting.length;\n        await commit(waiting.map((delivery): Entry => ({\n          type: \"run.started\", runId, input: delivery.input,\n          ...(delivery.from ? { from: delivery.from } : {}),\n        })));\n        return waiting.length;\n      }\n\n      const executor = agent.tools?.length\n        ? createExecutor({\n            tools: agent.tools,\n            ...(agent.decide ? { decide: agent.decide } : {}),\n            sessionId, runId,\n            enqueue: (delivery) => deliveries.push(delivery),\n            report: (callId, data) => updates.push({ type: \"tool.progress\", callId, data }),\n          })\n        : undefined;\n\n      if (!arrivals.length) {\n        // An open run is what a resumption continues. Without one there is\n        // nothing half-done here: a closed log would otherwise take a second\n        // `run.finished` with no beginning to match it.\n        if (!interrupted) {\n          return stopping({\n            code: \"nothing-to-resume\",\n            message: \"An activation with no input continues an interrupted run, and this session has none open.\",\n            retryable: false,\n          });\n        }\n        if (agent.harness.recovery !== \"history\") {\n          // Asked to continue a log this harness cannot read. The interrupted\n          // run is ended rather than left open, because nothing else will\n          // continue it either — the harness is a property of the session — and\n          // a run that stays open is handed back by `interrupted` every window,\n          // for ever. A worker that provisions anything before it runs pays for\n          // that each time round.\n          const failure: Failure = {\n            code: \"no-recovery\",\n            message: `The ${agent.harness.id} harness cannot restart from history, so this activation cannot be continued.`,\n            retryable: false,\n          };\n          stopped = failure;\n        }\n      }\n\n      // An interrupted predecessor is ended before a new activation begins over\n      // it, so one session never holds two open runs. Only on a claim: the\n      // store established there that nothing else is running, where a bare\n      // `sessionId` establishes nothing and the run may still be live.\n      if (arrivals.length && interrupted && claim) {\n        await commit([{\n          type: \"run.finished\", runId: interrupted, outcome: \"cancelled\",\n          error: {\n            code: \"superseded\",\n            message: \"This activation was interrupted, and a later one began over it.\",\n            retryable: false,\n          },\n        }]);\n      }\n\n      // Nothing opens a resumption. A `run.started` recording input nobody sent\n      // would be a second beginning for one conversation; the loop reads the\n      // history it was handed instead, sees the call that already ran, and\n      // carries on rather than asking for it again.\n      await commit(arrivals.map((arrival): Entry => ({\n        type: \"run.started\", runId, input: arrival.input,\n        ...(arrival.from ? { from: arrival.from } : {}),\n      })));\n\n      // Every ceiling is checked where work is recorded, and a resumption\n      // records nothing before its first turn — so a deadline that had already\n      // passed was never seen. Checked once here too, before the harness is\n      // handed anything.\n      stopped ??= exceeded();\n\n      function makeContext(): HarnessContext {\n        return {\n        sessionId, runId,\n        instructions: agent.instructions,\n        history: () => toMessages({\n          instructions: agent.instructions,\n          entries: log.entries,\n          ...(agent.attribution ? { attribution: true } : {}),\n          ...(options.context ? { context: options.context } : {}),\n        }),\n        entries: () => log.entries,\n        ...(options.context ? { context: options.context } : {}),\n        ...(executor ? { tools: executor } : {}),\n        commit: (entries) => commit(entries),\n        ...(store ? { drain } : {}),\n        emit: (update) => updates.push(update),\n        signal, hooks,\n        };\n      }\n\n      async function stoppingHooks(outcome: HarnessResult) {\n        const inputs: Entry[] = [];\n        const outgoing: Delivery[] = [];\n        for (const hook of hooks) {\n          const response = await hook.beforeStop?.(hookContext!, outcome);\n          if (response && \"input\" in response && outcome.status === \"completed\" && !signal.aborted && !stopped &&\n              !log.entries.some(entry => entry.type === \"hook.input\" && entry.runId === runId && entry.hook === hook.name)) {\n            inputs.push({ type: \"hook.input\", runId, hook: hook.name, input: response.input });\n          }\n          if (response && \"deliveries\" in response) outgoing.push(...response.deliveries);\n        }\n        return { inputs, deliveries: outgoing };\n      }\n\n      hookContext = makeContext();\n      let outcome: HarnessResult;\n      let outgoing: readonly Delivery[] = [];\n      try {\n        for (const hook of hooks) await hook.beforeRun?.(hookContext);\n        for (;;) {\n          outcome = stopped ? { status: \"failed\", error: stopped }\n            : signal.aborted ? { status: \"cancelled\" }\n            : await agent.harness.run(hookContext);\n          if (stopped) outcome = { status: \"failed\", error: stopped };\n          else if (signal.aborted) outcome = { status: \"cancelled\" };\n          const ending = await stoppingHooks(outcome);\n          if (!ending.inputs.length) { outgoing = ending.deliveries; break; }\n          await commit(ending.inputs);\n        }\n      } catch (error) {\n        if (error instanceof CommitFailed) throw error;\n        outcome = { status: \"failed\", error: {\n          code: \"hook-or-harness\", message: error instanceof Error ? error.message : String(error), retryable: false,\n        } };\n      }\n\n      // A harness stopped by the ceiling reports a cancellation, because that is\n      // all it saw. The run knows why it was cancelled and says so instead.\n      const settled = stopped && outcome.status === \"cancelled\"\n        ? { status: \"failed\" as const, error: stopped }\n        : outcome;\n\n      await commit(\n        [{\n          type: \"run.finished\", runId,\n          outcome: settled.status === \"completed\" ? \"completed\" : settled.status === \"cancelled\" ? \"cancelled\" : \"failed\",\n          ...(settled.status === \"failed\" ? { error: settled.error } : {}),\n        }],\n        outgoing,\n      );\n\n      if (settled.status === \"completed\") {\n        return result = { status: \"completed\", output: settled.output, seq: log.seq, usage };\n      }\n      if (settled.status === \"cancelled\") return result = { status: \"cancelled\", seq: log.seq, usage };\n      return stopping(settled.error);\n    } catch (error) {\n      if (error instanceof CommitFailed) {\n        return result = { status: \"failed\", error: error.failure, seq: error.seq, usage };\n      }\n      throw error;\n    } finally {\n      if (hookContext) {\n        const final = result ?? { status: \"failed\" as const, error: {\n          code: \"run-error\", message: \"The run could not finish.\", retryable: false,\n        }, seq: hookContext.entries().at(-1)?.seq ?? 0, usage };\n        for (const hook of hooks) {\n          try { await hook.afterRun?.(hookContext, final); }\n          catch (error) {\n            updates.push({ type: \"hook.error\", hook: hook.name, message: error instanceof Error ? error.message : String(error) });\n          }\n        }\n      }\n      updates.close();\n    }\n  }\n}\n\nclass CommitFailed extends Error {\n  constructor(readonly failure: Failure, readonly seq: number) {\n    super(failure.message);\n  }\n}\n\n/**\n * Where the session actually is after a refused write. A conflict knows; every\n * other failure leaves the caller with the position it already had. Reporting\n * zero told a caller at forty that it was at the beginning.\n *\n * The `typeof` is not defensive noise: a store may report a conflict, and only\n * a `StoreConflict` carries the position. Casting on the code alone produced a\n * `RunResult.seq` of `undefined` under a type that says `number`.\n */\nfunction positionOf(error: StoreError, fallback: number): number {\n  const actual = (error as StoreConflict).actualSeq;\n  return error.code === \"conflict\" && typeof actual === \"number\" ? actual : fallback;\n}\n\nconst isArrival = (value: unknown): value is Arrival =>\n  typeof value === \"object\" && value !== null && !Array.isArray(value) && \"input\" in value;\n\n/**\n * One arrival, or several.\n *\n * The elements decide it, because the outer shape cannot: an arrival names its\n * `input`, a content part names its `type`, and nothing is both. Reading every\n * array as a batch is what turned one image-and-text message into one entry per\n * part, each holding a part where whole content belongs.\n */\nfunction arrivalsOf(input: RunAgentOptions[\"input\"]): readonly Arrival[] {\n  if (input === undefined) return [];\n  // Nothing sent is nothing sent. Falling through committed a `run.started`\n  // whose input was an empty array of content parts.\n  if (Array.isArray(input) && input.length === 0) return [];\n  if (Array.isArray(input) && input.length > 0 && input.every(isArrival)) return input;\n  if (isArrival(input)) return [input];\n  return [{ input: input as Content }];\n}\n\n/**\n * The activation still open on this log, if one is.\n *\n * `run.started` opens and `run.finished` closes, which is the same rule the\n * store maintains its claim from — read here from the entries rather than asked\n * of the store, because the log is the only thing that knows.\n */\nfunction openRunId(entries: readonly Stored[]): string | undefined {\n  let open: string | undefined;\n  for (const entry of entries) {\n    if (entry.type === \"run.started\") open = entry.runId;\n    if (entry.type === \"run.finished\") open = undefined;\n  }\n  return open;\n}\n\n/** Token counts add; unknown stays unknown rather than becoming a zero. */\nfunction accumulate(total: Usage, turn: Usage): void {\n  for (const key of [\"inputTokens\", \"outputTokens\", \"cacheReadTokens\", \"cacheWriteTokens\"] as const) {\n    if (turn[key] !== undefined) total[key] = (total[key] ?? 0) + turn[key]!;\n  }\n}\n\nasync function open(store: Store, sessionId: string, agent: Agent, key?: string) {\n  const existing = await store.read({ sessionId });\n  if (existing.ok) {\n    // `version` is documented as the boundary past which an agent is no longer\n    // compatible with an existing session. Nothing was comparing it, so the\n    // boundary held for exactly as long as nobody crossed it.\n    const stored = existing.value.agent;\n    if (stored.id !== agent.id || stored.version !== agent.version) {\n      return err<StoreError>({\n        code: \"conflict\",\n        message: `Session ${sessionId} belongs to ${stored.id}@${stored.version}, not ${agent.id}@${agent.version}`,\n        retryable: false,\n      });\n    }\n    return existing;\n  }\n  if (existing.error.code !== \"not-found\") return existing;\n  const created = await store.create({\n    sessionId, agent: { id: agent.id, version: agent.version }, ...(key ? { key } : {}),\n  });\n  if (!created.ok) return created;\n  return store.read({ sessionId });\n}\n\n/**\n * A bounded fan-out queue for ephemeral updates.\n *\n * One buffer of recent updates, which every listener starts from and which\n * never grows past its limit. That single rule gives three things:\n *\n * **A run nobody drains costs a fixed amount.** A headless worker used to\n * accumulate every delta of an entire activation, because the queue only ever\n * grew. Dropping the oldest is safe precisely because updates are not recovery\n * state and the committed log is.\n *\n * **Arriving late loses nothing that matters.** The first entry commits before\n * `runAgent` returns, so a caller that iterates immediately would otherwise\n * never see its own run start. A UI reconnecting mid-run gets recent history\n * for the same reason, without asking the store for it.\n *\n * **Everyone sees everything.** Each listener drains its own copy, so an\n * application can watch a run for telemetry and for a UI at once instead of the\n * two stealing events from each other.\n */\nfunction createChannel<T>(limit = 1_024) {\n  interface Listener { buffer: T[]; wake?: () => void }\n  const listeners = new Set<Listener>();\n  const replay: T[] = [];\n  let closed = false;\n\n  const bounded = (buffer: T[], value: T) => {\n    if (buffer.length >= limit) buffer.shift();\n    buffer.push(value);\n  };\n\n  return {\n    push(value: T) {\n      bounded(replay, value);\n      for (const listener of listeners) {\n        bounded(listener.buffer, value);\n        listener.wake?.();\n      }\n    },\n    close() {\n      closed = true;\n      for (const listener of listeners) listener.wake?.();\n    },\n    iterator(): AsyncIterator<T> {\n      const listener: Listener = { buffer: [...replay] };\n      listeners.add(listener);\n      const done = (): IteratorResult<T> => {\n        listeners.delete(listener);\n        return { value: undefined, done: true };\n      };\n      return {\n        async next(): Promise<IteratorResult<T>> {\n          for (;;) {\n            const value = listener.buffer.shift();\n            if (value !== undefined) return { value, done: false };\n            if (closed) return done();\n            await new Promise<void>((resolve) => { listener.wake = resolve; });\n          }\n        },\n        async return(): Promise<IteratorResult<T>> { return done(); },\n      };\n    },\n  };\n}\n"]}

package/dist/session/entry.d.ts

@@ -93,6 +93,11 @@ export interface From {
  * field for a value another field determines.
  */
 export type Entry = {
+    type: "hook.input";
+    runId: string;
+    hook: string;
+    input: Content;
+} | {
     type: "run.started";
     runId: string;
     input: Content;

package/dist/session/entry.js.map

@@ -1 +1 @@
-{"version":3,"file":"entry.js","sourceRoot":"","sources":["../../src/session/entry.ts"],"names":[],"mappings":"","sourcesContent":["import type { Content } from \"../content.js\";\nimport type { Failure } from \"../result.js\";\nimport type { JsonValue } from \"../json.js\";\n\n/** A model's request to invoke a tool. `arguments` is unparsed JSON as the provider sent it. */\nexport interface ToolCall {\n  callId: string;\n  name: string;\n  arguments: string;\n}\n\nexport interface ToolResult {\n  content: Content;\n  /** Structured channel for the application and the UI. Never reaches the model. */\n  details?: JsonValue;\n  isError?: boolean;\n}\n\n/**\n * What a generation consumed.\n *\n * Absent stays absent — a count nobody reported is not a zero. This package\n * holds no rates and computes no money from tokens. Where an adapter does\n * arithmetic it is reconciling its wire's encoding to the meanings below:\n * normalization, which is an adapter's job, and never a new fact.\n *\n * That is why `costUsd` belongs here and a rate table does not. A cost the\n * provider *states* is an observation like the counts beside it, and dropping\n * it was the same mistake as dropping the model that served the request: an\n * application was left reconstructing, from a table it maintains by hand, a\n * number the wire had already given it. For a router that is not even possible\n * — it picks an upstream provider per request and adds its own margin, so no\n * static table can say what was charged.\n */\nexport interface Usage {\n  /**\n   * Input tokens that were neither read from nor written to a cache.\n   *\n   * **The three input counts are disjoint.** The prompt's total size is\n   * `inputTokens + cacheReadTokens + cacheWriteTokens`; no field here is a\n   * subset of another, so a caller sums and never subtracts.\n   *\n   * The wires disagree about this and one of them has to be converted. What\n   * Anthropic calls `input_tokens` is already this — \"tokens which were not\n   * read from or used to create a cache\". What OpenAI calls `prompt_tokens` is\n   * the whole prompt, with `cached_tokens` counted inside it, so that adapter\n   * subtracts once and callers stop having to know which wire answered.\n   *\n   * Disjoint is the choice that survives absence, which is the rule the rest of\n   * this type runs on. Summing the fields you were given is right whichever\n   * ones are missing; subtracting a field you were not given is not. Under the\n   * other convention a heavily cached Anthropic turn priced its fresh tokens at\n   * zero — quietly, because the subtraction was clamped at zero rather than\n   * being allowed to go negative where somebody would have seen it.\n   */\n  inputTokens?: number;\n  outputTokens?: number;\n  /** Input tokens served from a cache. Disjoint from `inputTokens`. */\n  cacheReadTokens?: number;\n  /** Input tokens written to a cache. Disjoint from `inputTokens`. */\n  cacheWriteTokens?: number;\n  /**\n   * What the provider said this generation cost, in US dollars. Reported,\n   * never derived: no adapter computes this from a rate, and one whose wire\n   * does not carry a cost leaves it absent rather than estimating.\n   */\n  costUsd?: number;\n}\n\n/**\n * Who sent an arrival: what sort of sender, and which one.\n *\n * aglib mints exactly one kind — `\"session\"`, a delivery from another session —\n * and interprets no other. Every other kind is the application's word for one of\n * its own senders: a person, a channel, a schedule, a webhook. The vocabulary\n * belongs to whoever can close it, and that is never this package.\n *\n * Two fields because absence was carrying four facts. This used to be the\n * sending session's id alone, so an operator, a channel and a timer all said the\n * same thing by saying nothing, and a recipient could not tell a person typing\n * from a routine firing. Packing both into one string instead — `\"routine:x\"` —\n * would put the vocabulary in a convention nothing closes, which is how such a\n * field ends up with values that exist only by grep and a different reading on\n * every surface that renders it.\n */\nexport interface From {\n  kind: string;\n  id: string;\n}\n\n/**\n * The canonical vocabulary. This is the session's state, not a record of it:\n * the loop reads its context by projecting these and appends back to them, so\n * there is no second transcript that could disagree.\n *\n * `tool.started` carries only the call id — the assistant entry above it\n * already holds the call, and duplicating name and arguments would be a second\n * field for a value another field determines.\n */\nexport type Entry =\n  | { type: \"run.started\"; runId: string; input: Content; from?: From }\n  | {\n      type: \"assistant\"; runId: string; content: Content;\n      calls?: readonly ToolCall[]; usage?: Usage;\n      /**\n       * What produced this turn, when a model did: which model answered and the\n       * span it took. `Stored.at` is when the entry was committed, which is a\n       * different fact and not a substitute — anything projecting a generation\n       * needs both ends of the call, and the commit is neither of them.\n       */\n      generation?: { model?: string; startedAt: string; endedAt: string };\n    }\n  | { type: \"tool.started\"; runId: string; callId: string }\n  | { type: \"tool.finished\"; runId: string; callId: string; result: ToolResult }\n  /** Compaction output. `replaces` is the seq up to which entries are folded; nothing is deleted. */\n  | { type: \"summary\"; runId: string; content: string; replaces: number }\n  | { type: \"run.finished\"; runId: string; outcome: \"completed\" | \"failed\" | \"cancelled\"; error?: Failure };\n\nexport type EntryType = Entry[\"type\"];\n\n/** An entry once the log has given it a position. */\nexport type Stored<T extends Entry = Entry> = T & { seq: number; at: string };\n\n/**\n * Input delivered to a session, committed with the sender's own entries.\n * Spawning a child, replying to a parent and messaging a peer are all this.\n */\nexport interface Delivery {\n  /** The session it is delivered to. */\n  sessionId: string;\n  input: Content;\n  /**\n   * Who sent it. Absent means the application did not say — not that nobody\n   * did. Recorded on the receiving `run.started`, so an application can tell a\n   * peer's message from its user's, and can see that it already answered one\n   * that arrives twice. It becomes text the model reads only where the\n   * recipient's agent asks, with `attribution`.\n   */\n  from?: From;\n  /**\n   * Where in the recipient's loop this lands. Defaults to \"next\".\n   *\n   * Three places, and each is an outcome a sender can reason about rather than\n   * a level of urgency a harness interprets:\n   *\n   *   \"interrupt\" — the running activation ends, so the next one begins with\n   *                 this. Its uncommitted work is lost; everything it had\n   *                 already committed stays.\n   *   \"turn\"      — folded into the activation already running, before its next\n   *                 model call. Nothing in flight is lost. Immediately, if\n   *                 nothing is running.\n   *   \"next\"      — at the start of the recipient's next activation.\n   *\n   * This used to be `now | next | later`, and `now` meant either of the first\n   * two depending on the harness — fold if it had a safe point, end the\n   * activation if it did not. One word for \"your message arrives and the work\n   * continues\" and \"your message arrives and a turn's work is destroyed\". The\n   * doctrine was that a priority names the requirement and not the mechanism,\n   * but those are not two mechanisms for one requirement: they are two\n   * different things happening to somebody's work, and a runtime answer saying\n   * which one you got was invented to paper over it. `later` named a fourth\n   * thing that nothing implemented.\n   *\n   * **A harness that cannot honour one falls back to a later place, never an\n   * earlier one.** A loop with no safe point cannot do \"turn\", so it does\n   * \"next\" — the message waits. It does not end the activation instead, which\n   * is what falling back through an ordered scale used to do: ask for the\n   * gentlest useful thing and get the most destructive one.\n   */\n  priority?: \"interrupt\" | \"turn\" | \"next\";\n  /**\n   * The sender's key for this delivery. Two deliveries with the same id are the\n   * same delivery, so a retried send does not arrive twice.\n   */\n  id?: string;\n}\n"]}
+{"version":3,"file":"entry.js","sourceRoot":"","sources":["../../src/session/entry.ts"],"names":[],"mappings":"","sourcesContent":["import type { Content } from \"../content.js\";\nimport type { Failure } from \"../result.js\";\nimport type { JsonValue } from \"../json.js\";\n\n/** A model's request to invoke a tool. `arguments` is unparsed JSON as the provider sent it. */\nexport interface ToolCall {\n  callId: string;\n  name: string;\n  arguments: string;\n}\n\nexport interface ToolResult {\n  content: Content;\n  /** Structured channel for the application and the UI. Never reaches the model. */\n  details?: JsonValue;\n  isError?: boolean;\n}\n\n/**\n * What a generation consumed.\n *\n * Absent stays absent — a count nobody reported is not a zero. This package\n * holds no rates and computes no money from tokens. Where an adapter does\n * arithmetic it is reconciling its wire's encoding to the meanings below:\n * normalization, which is an adapter's job, and never a new fact.\n *\n * That is why `costUsd` belongs here and a rate table does not. A cost the\n * provider *states* is an observation like the counts beside it, and dropping\n * it was the same mistake as dropping the model that served the request: an\n * application was left reconstructing, from a table it maintains by hand, a\n * number the wire had already given it. For a router that is not even possible\n * — it picks an upstream provider per request and adds its own margin, so no\n * static table can say what was charged.\n */\nexport interface Usage {\n  /**\n   * Input tokens that were neither read from nor written to a cache.\n   *\n   * **The three input counts are disjoint.** The prompt's total size is\n   * `inputTokens + cacheReadTokens + cacheWriteTokens`; no field here is a\n   * subset of another, so a caller sums and never subtracts.\n   *\n   * The wires disagree about this and one of them has to be converted. What\n   * Anthropic calls `input_tokens` is already this — \"tokens which were not\n   * read from or used to create a cache\". What OpenAI calls `prompt_tokens` is\n   * the whole prompt, with `cached_tokens` counted inside it, so that adapter\n   * subtracts once and callers stop having to know which wire answered.\n   *\n   * Disjoint is the choice that survives absence, which is the rule the rest of\n   * this type runs on. Summing the fields you were given is right whichever\n   * ones are missing; subtracting a field you were not given is not. Under the\n   * other convention a heavily cached Anthropic turn priced its fresh tokens at\n   * zero — quietly, because the subtraction was clamped at zero rather than\n   * being allowed to go negative where somebody would have seen it.\n   */\n  inputTokens?: number;\n  outputTokens?: number;\n  /** Input tokens served from a cache. Disjoint from `inputTokens`. */\n  cacheReadTokens?: number;\n  /** Input tokens written to a cache. Disjoint from `inputTokens`. */\n  cacheWriteTokens?: number;\n  /**\n   * What the provider said this generation cost, in US dollars. Reported,\n   * never derived: no adapter computes this from a rate, and one whose wire\n   * does not carry a cost leaves it absent rather than estimating.\n   */\n  costUsd?: number;\n}\n\n/**\n * Who sent an arrival: what sort of sender, and which one.\n *\n * aglib mints exactly one kind — `\"session\"`, a delivery from another session —\n * and interprets no other. Every other kind is the application's word for one of\n * its own senders: a person, a channel, a schedule, a webhook. The vocabulary\n * belongs to whoever can close it, and that is never this package.\n *\n * Two fields because absence was carrying four facts. This used to be the\n * sending session's id alone, so an operator, a channel and a timer all said the\n * same thing by saying nothing, and a recipient could not tell a person typing\n * from a routine firing. Packing both into one string instead — `\"routine:x\"` —\n * would put the vocabulary in a convention nothing closes, which is how such a\n * field ends up with values that exist only by grep and a different reading on\n * every surface that renders it.\n */\nexport interface From {\n  kind: string;\n  id: string;\n}\n\n/**\n * The canonical vocabulary. This is the session's state, not a record of it:\n * the loop reads its context by projecting these and appends back to them, so\n * there is no second transcript that could disagree.\n *\n * `tool.started` carries only the call id — the assistant entry above it\n * already holds the call, and duplicating name and arguments would be a second\n * field for a value another field determines.\n */\nexport type Entry =\n  | { type: \"hook.input\"; runId: string; hook: string; input: Content }\n  | { type: \"run.started\"; runId: string; input: Content; from?: From }\n  | {\n      type: \"assistant\"; runId: string; content: Content;\n      calls?: readonly ToolCall[]; usage?: Usage;\n      /**\n       * What produced this turn, when a model did: which model answered and the\n       * span it took. `Stored.at` is when the entry was committed, which is a\n       * different fact and not a substitute — anything projecting a generation\n       * needs both ends of the call, and the commit is neither of them.\n       */\n      generation?: { model?: string; startedAt: string; endedAt: string };\n    }\n  | { type: \"tool.started\"; runId: string; callId: string }\n  | { type: \"tool.finished\"; runId: string; callId: string; result: ToolResult }\n  /** Compaction output. `replaces` is the seq up to which entries are folded; nothing is deleted. */\n  | { type: \"summary\"; runId: string; content: string; replaces: number }\n  | { type: \"run.finished\"; runId: string; outcome: \"completed\" | \"failed\" | \"cancelled\"; error?: Failure };\n\nexport type EntryType = Entry[\"type\"];\n\n/** An entry once the log has given it a position. */\nexport type Stored<T extends Entry = Entry> = T & { seq: number; at: string };\n\n/**\n * Input delivered to a session, committed with the sender's own entries.\n * Spawning a child, replying to a parent and messaging a peer are all this.\n */\nexport interface Delivery {\n  /** The session it is delivered to. */\n  sessionId: string;\n  input: Content;\n  /**\n   * Who sent it. Absent means the application did not say — not that nobody\n   * did. Recorded on the receiving `run.started`, so an application can tell a\n   * peer's message from its user's, and can see that it already answered one\n   * that arrives twice. It becomes text the model reads only where the\n   * recipient's agent asks, with `attribution`.\n   */\n  from?: From;\n  /**\n   * Where in the recipient's loop this lands. Defaults to \"next\".\n   *\n   * Three places, and each is an outcome a sender can reason about rather than\n   * a level of urgency a harness interprets:\n   *\n   *   \"interrupt\" — the running activation ends, so the next one begins with\n   *                 this. Its uncommitted work is lost; everything it had\n   *                 already committed stays.\n   *   \"turn\"      — folded into the activation already running, before its next\n   *                 model call. Nothing in flight is lost. Immediately, if\n   *                 nothing is running.\n   *   \"next\"      — at the start of the recipient's next activation.\n   *\n   * This used to be `now | next | later`, and `now` meant either of the first\n   * two depending on the harness — fold if it had a safe point, end the\n   * activation if it did not. One word for \"your message arrives and the work\n   * continues\" and \"your message arrives and a turn's work is destroyed\". The\n   * doctrine was that a priority names the requirement and not the mechanism,\n   * but those are not two mechanisms for one requirement: they are two\n   * different things happening to somebody's work, and a runtime answer saying\n   * which one you got was invented to paper over it. `later` named a fourth\n   * thing that nothing implemented.\n   *\n   * **A harness that cannot honour one falls back to a later place, never an\n   * earlier one.** A loop with no safe point cannot do \"turn\", so it does\n   * \"next\" — the message waits. It does not end the activation instead, which\n   * is what falling back through an ordered scale used to do: ask for the\n   * gentlest useful thing and get the most destructive one.\n   */\n  priority?: \"interrupt\" | \"turn\" | \"next\";\n  /**\n   * The sender's key for this delivery. Two deliveries with the same id are the\n   * same delivery, so a retried send does not arrive twice.\n   */\n  id?: string;\n}\n"]}

package/dist/session/messages.js

@@ -33,6 +33,10 @@ export function toMessages(input) {
     // A summary folds everything up to `replaces`. The source entries stay in the
     // log — compaction changes what the model sees, never what happened.
     const cut = foldedThrough(input.entries);
+    const summary = input.entries.findLast((entry) => entry.type === "summary" && entry.replaces === cut);
+    if (summary?.type === "summary") {
+        messages.push({ role: "user", content: `<summary>\n${summary.content}\n</summary>` });
+    }
     // A call whose result never committed. It happens when an activation ends
     // between asking and answering — cancelled, interrupted, or beaten to the
     // commit by another worker. The projection has to close it: a provider
@@ -41,13 +45,14 @@ export function toMessages(input) {
     // — the call did not report back — and never an invented result.
     const answered = new Set(input.entries.filter((entry) => entry.type === "tool.finished").map((entry) => entry.callId));
     for (const entry of input.entries) {
-        // A summary folds like anything else it covers. Exempting the whole type
-        // kept every summary ever written, so a long session carried a chain of
-        // them whose content was already inside the newest — duplicated, and
-        // rewriting the cached prefix each time one was added.
-        if (entry.seq <= cut)
+        // The checkpoint describes the replaced prefix, not the moment it was
+        // written. Newer instructions must follow it, including after another fold.
+        if (entry.seq <= cut || entry.type === "summary")
             continue;
         switch (entry.type) {
+            case "hook.input":
+                messages.push({ role: "user", content: entry.input });
+                break;
             case "run.started":
                 messages.push({
                     role: "user",
@@ -78,11 +83,6 @@ export function toMessages(input) {
                     ...(entry.result.isError ? { isError: true } : {}),
                 });
                 break;
-            case "summary":
-                // Delimited user context rather than an assistant turn: attributing a
-                // summary to the assistant puts words in the model's mouth it never said.
-                messages.push({ role: "user", content: `<summary>\n${entry.content}\n</summary>` });
-                break;
             // Not model-visible: tool.started is bookkeeping and run.finished is a
             // boundary.
             case "tool.started":

package/dist/session/messages.js.map

@@ -1 +1 @@
-{"version":3,"file":"messages.js","sourceRoot":"","sources":["../../src/session/messages.ts"],"names":[],"mappings":"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","sourcesContent":["import type { Content } from \"../content.js\";\nimport type { From, Stored, ToolCall } from \"./entry.js\";\n\n/** A message as a provider takes it: built per turn from the log, never held. */\nexport type Message =\n  | { role: \"system\"; content: Content }\n  | { role: \"user\"; content: Content }\n  | { role: \"assistant\"; content: Content; calls?: readonly ToolCall[] }\n  | { role: \"tool\"; callId: string; content: Content; isError?: boolean };\n\n/**\n * The position everything up to has been folded into a summary.\n *\n * One answer, because two callers need it: the projection skips what is folded,\n * and the loop refuses to cut at or behind it. They were the same reduce written\n * out twice.\n */\nexport function foldedThrough(entries: readonly Stored[]): number {\n  return entries.reduce((at, entry) => entry.type === \"summary\" ? Math.max(at, entry.replaces) : at, 0);\n}\n\n/** Names the sender in the turn itself, since only text reaches the model. */\nfunction labelled(input: Content, from: From | undefined): Content {\n  if (!from) return input;\n  const label = `[from ${from.kind} ${from.id}]`;\n  return typeof input === \"string\"\n    ? `${label}\\n${input}`\n    : [{ type: \"text\" as const, text: label }, ...input];\n}\n\n/**\n * The log projected into what a provider takes.\n *\n * Built fresh for every request and never held. That is the whole reason there\n * is no second transcript to drift from the log, and why nothing needs a test\n * proving two representations agree.\n */\nexport function toMessages(input: {\n  instructions: Content;\n  entries: readonly Stored[];\n  context?: { run?: string; turn?: string };\n  /**\n   * Name each arrival's sender in the turn text, as `[from kind id]`.\n   *\n   * Off by default. `from` is provenance the log keeps whatever this says; an\n   * application that renders its own attribution into the input it delivers\n   * would otherwise hand the model two names for one sender, one of them a\n   * session id that means nothing to it.\n   */\n  attribution?: boolean;\n}): readonly Message[] {\n  const messages: Message[] = [{ role: \"system\", content: input.instructions }];\n\n  // Run-scoped context sits immediately after the instructions, inside the\n  // cacheable prefix, because it does not change for the life of the run.\n  if (input.context?.run) messages.push({ role: \"system\", content: input.context.run });\n\n  // A summary folds everything up to `replaces`. The source entries stay in the\n  // log — compaction changes what the model sees, never what happened.\n  const cut = foldedThrough(input.entries);\n\n  // A call whose result never committed. It happens when an activation ends\n  // between asking and answering — cancelled, interrupted, or beaten to the\n  // commit by another worker. The projection has to close it: a provider\n  // rejects an assistant turn holding a call with no result, so leaving the gap\n  // would make the session permanently unusable. What is said is what is known\n  // — the call did not report back — and never an invented result.\n  const answered = new Set(\n    input.entries.filter((entry) => entry.type === \"tool.finished\").map((entry) => entry.callId),\n  );\n\n  for (const entry of input.entries) {\n    // A summary folds like anything else it covers. Exempting the whole type\n    // kept every summary ever written, so a long session carried a chain of\n    // them whose content was already inside the newest — duplicated, and\n    // rewriting the cached prefix each time one was added.\n    if (entry.seq <= cut) continue;\n    switch (entry.type) {\n      case \"run.started\":\n        messages.push({\n          role: \"user\",\n          content: input.attribution ? labelled(entry.input, entry.from) : entry.input,\n        });\n        break;\n      case \"assistant\": {\n        messages.push({\n          role: \"assistant\",\n          content: entry.content,\n          ...(entry.calls?.length ? { calls: entry.calls } : {}),\n        });\n        for (const call of entry.calls ?? []) {\n          if (answered.has(call.callId)) continue;\n          messages.push({\n            role: \"tool\", callId: call.callId, isError: true,\n            content: \"This call did not report back: the activation ended before its result was committed.\",\n          });\n        }\n        break;\n      }\n      case \"tool.finished\":\n        messages.push({\n          role: \"tool\",\n          callId: entry.callId,\n          content: entry.result.content,\n          ...(entry.result.isError ? { isError: true } : {}),\n        });\n        break;\n      case \"summary\":\n        // Delimited user context rather than an assistant turn: attributing a\n        // summary to the assistant puts words in the model's mouth it never said.\n        messages.push({ role: \"user\", content: `<summary>\\n${entry.content}\\n</summary>` });\n        break;\n      // Not model-visible: tool.started is bookkeeping and run.finished is a\n      // boundary.\n      case \"tool.started\":\n      case \"run.finished\":\n        break;\n    }\n  }\n\n  // Turn-scoped context sits last, after the cache boundary, because it is for\n  // this request only and must not be written into the cached prefix.\n  if (input.context?.turn) messages.push({ role: \"system\", content: input.context.turn });\n  return messages;\n}\n\n"]}
+{"version":3,"file":"messages.js","sourceRoot":"","sources":["../../src/session/messages.ts"],"names":[],"mappings":"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","sourcesContent":["import type { Content } from \"../content.js\";\nimport type { From, Stored, ToolCall } from \"./entry.js\";\n\n/** A message as a provider takes it: built per turn from the log, never held. */\nexport type Message =\n  | { role: \"system\"; content: Content }\n  | { role: \"user\"; content: Content }\n  | { role: \"assistant\"; content: Content; calls?: readonly ToolCall[] }\n  | { role: \"tool\"; callId: string; content: Content; isError?: boolean };\n\n/**\n * The position everything up to has been folded into a summary.\n *\n * One answer, because two callers need it: the projection skips what is folded,\n * and the loop refuses to cut at or behind it. They were the same reduce written\n * out twice.\n */\nexport function foldedThrough(entries: readonly Stored[]): number {\n  return entries.reduce((at, entry) => entry.type === \"summary\" ? Math.max(at, entry.replaces) : at, 0);\n}\n\n/** Names the sender in the turn itself, since only text reaches the model. */\nfunction labelled(input: Content, from: From | undefined): Content {\n  if (!from) return input;\n  const label = `[from ${from.kind} ${from.id}]`;\n  return typeof input === \"string\"\n    ? `${label}\\n${input}`\n    : [{ type: \"text\" as const, text: label }, ...input];\n}\n\n/**\n * The log projected into what a provider takes.\n *\n * Built fresh for every request and never held. That is the whole reason there\n * is no second transcript to drift from the log, and why nothing needs a test\n * proving two representations agree.\n */\nexport function toMessages(input: {\n  instructions: Content;\n  entries: readonly Stored[];\n  context?: { run?: string; turn?: string };\n  /**\n   * Name each arrival's sender in the turn text, as `[from kind id]`.\n   *\n   * Off by default. `from` is provenance the log keeps whatever this says; an\n   * application that renders its own attribution into the input it delivers\n   * would otherwise hand the model two names for one sender, one of them a\n   * session id that means nothing to it.\n   */\n  attribution?: boolean;\n}): readonly Message[] {\n  const messages: Message[] = [{ role: \"system\", content: input.instructions }];\n\n  // Run-scoped context sits immediately after the instructions, inside the\n  // cacheable prefix, because it does not change for the life of the run.\n  if (input.context?.run) messages.push({ role: \"system\", content: input.context.run });\n\n  // A summary folds everything up to `replaces`. The source entries stay in the\n  // log — compaction changes what the model sees, never what happened.\n  const cut = foldedThrough(input.entries);\n  const summary = input.entries.findLast((entry) => entry.type === \"summary\" && entry.replaces === cut);\n  if (summary?.type === \"summary\") {\n    messages.push({ role: \"user\", content: `<summary>\\n${summary.content}\\n</summary>` });\n  }\n\n  // A call whose result never committed. It happens when an activation ends\n  // between asking and answering — cancelled, interrupted, or beaten to the\n  // commit by another worker. The projection has to close it: a provider\n  // rejects an assistant turn holding a call with no result, so leaving the gap\n  // would make the session permanently unusable. What is said is what is known\n  // — the call did not report back — and never an invented result.\n  const answered = new Set(\n    input.entries.filter((entry) => entry.type === \"tool.finished\").map((entry) => entry.callId),\n  );\n\n  for (const entry of input.entries) {\n    // The checkpoint describes the replaced prefix, not the moment it was\n    // written. Newer instructions must follow it, including after another fold.\n    if (entry.seq <= cut || entry.type === \"summary\") continue;\n    switch (entry.type) {\n      case \"hook.input\":\n        messages.push({ role: \"user\", content: entry.input });\n        break;\n      case \"run.started\":\n        messages.push({\n          role: \"user\",\n          content: input.attribution ? labelled(entry.input, entry.from) : entry.input,\n        });\n        break;\n      case \"assistant\": {\n        messages.push({\n          role: \"assistant\",\n          content: entry.content,\n          ...(entry.calls?.length ? { calls: entry.calls } : {}),\n        });\n        for (const call of entry.calls ?? []) {\n          if (answered.has(call.callId)) continue;\n          messages.push({\n            role: \"tool\", callId: call.callId, isError: true,\n            content: \"This call did not report back: the activation ended before its result was committed.\",\n          });\n        }\n        break;\n      }\n      case \"tool.finished\":\n        messages.push({\n          role: \"tool\",\n          callId: entry.callId,\n          content: entry.result.content,\n          ...(entry.result.isError ? { isError: true } : {}),\n        });\n        break;\n      // Not model-visible: tool.started is bookkeeping and run.finished is a\n      // boundary.\n      case \"tool.started\":\n      case \"run.finished\":\n        break;\n    }\n  }\n\n  // Turn-scoped context sits last, after the cache boundary, because it is for\n  // this request only and must not be written into the cached prefix.\n  if (input.context?.turn) messages.push({ role: \"system\", content: input.context.turn });\n  return messages;\n}\n"]}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@a-dray/aglib",
-  "version": "0.2.0",
+  "version": "0.3.1",
   "type": "module",
   "description": "A small TypeScript toolkit for building your own agent harness.",
   "license": "MIT",