stitchkit 0.92.0 → 0.94.0

package/dist/{agent-runtime.js → entrypoints/agent-runtime.js}

@@ -24,8 +24,8 @@ import {
   renderAgentStateSlots,
   repairedSearchCall,
   selectAgentHistory
-} from "./index-vk3kq9sb.js";
-import"./index-p13mwz16.js";
+} from "../index-97ac4gph.js";
+import"../index-83bdg97s.js";
 import {
   AgentAdmissionEventSchema,
   AgentAttemptResetEventSchema,
@@ -42,7 +42,7 @@ import {
   AgentTransientDeltaEventSchema,
   advanceAgentRuntimeEventCursor,
   agentDurableEventId
-} from "./index-y64k3s0h.js";
+} from "../index-y64k3s0h.js";
 import {
   AgentModelCapabilitySchema,
   AgentModelCatalogEntrySchema,
@@ -59,12 +59,26 @@ import {
   defineModelRegistry,
   searchAgentModelCatalog,
   validateAgentModelSnapshot
-} from "./index-mqv3b5rh.js";
+} from "../index-mqv3b5rh.js";
 import {
   AgentConversationMessagePageSchema,
   AgentConversationPageSchema,
   AgentConversationSummarySchema
-} from "./index-crykmqkr.js";
+} from "../index-crykmqkr.js";
+import {
+  createBoundedSinkManager
+} from "../index-h6eeys1v.js";
+import {
+  AgentSandboxGradeSchema,
+  AgentSandboxRestrictionSchema,
+  missingSandboxRestrictions,
+  probeAgentProcessSandbox,
+  recordAgentSandboxProbe,
+  refuseUnknownSpillReference
+} from "../index-qmy6zq75.js";
+import {
+  createMemoryAgentRuntimeStore
+} from "../index-xsqjkha9.js";
 import {
   ACTIVE_AGENT_RUN_STATES,
   AgentAdmissionReceiptSchema,
@@ -76,9 +90,8 @@ import {
   AgentSeedReceiptSchema,
   AgentStoredRunSchema,
   createAgentRuntimeStore,
-  createMemoryAgentRuntimeStore,
   purgeAgentConversation
-} from "./index-hrbajay7.js";
+} from "../index-58k4fp34.js";
 import {
   AcceptInputAndAssignRunSchema,
   AcquireAgentRunSchema,
@@ -110,7 +123,7 @@ import {
   encodeAgentConversationArchive,
   isAssistantHistoryEvidence,
   isCompleteAgentHistoryTurn
-} from "./index-zwkgfq1s.js";
+} from "../index-1nd48tm9.js";
 import {
   AgentAssistantPlaceholderSchema,
   AgentControlPartSchema,
@@ -147,55 +160,41 @@ import {
   AgentUsageSchema,
   AgentUsageValueSchema,
   runStateForTerminalReason
-} from "./index-gtj3zc53.js";
-import {
-  createBoundedSinkManager
-} from "./index-wnfk50r0.js";
-import {
-  AgentSandboxGradeSchema,
-  AgentSandboxRestrictionSchema,
-  missingSandboxRestrictions,
-  probeAgentProcessSandbox,
-  recordAgentSandboxProbe,
-  refuseUnknownSpillReference
-} from "./index-qmy6zq75.js";
+} from "../index-gtj3zc53.js";
 import {
   buildToolManifest,
   mountAgent
-} from "./index-e42wzzz5.js";
+} from "../index-dcpdvjsc.js";
 import {
   DURABILITY_STEP_EVENT_KIND,
   ParkAbortedError,
   ParkRecordDecodeError,
   StepAbortedError,
   StepResultDecodeError,
-  StepResultNotSerializableError,
-  createLocalStepDurability
-} from "./index-kw9t5ayn.js";
-import"./index-2c2bjw3s.js";
-import"./index-mzvgxp0n.js";
-import"./index-yn8remb1.js";
-import"./index-tmwcrptx.js";
-import"./index-f9mb610r.js";
-import"./index-e0znv5gn.js";
-import"./index-0a349c33.js";
-import"./index-rxfy4cq7.js";
-import"./index-6k1937bx.js";
+  StepResultNotSerializableError
+} from "../index-cq4qfycf.js";
+import"../index-vcvkq30w.js";
+import"../index-2cr1cqhn.js";
+import"../index-j05z5gn4.js";
+import"../index-zfrhfn82.js";
+import"../index-35mh5bhj.js";
 import {
   childSpan,
   createTraceContext
-} from "./index-zcgf3gqf.js";
-import"./index-7zbps32p.js";
-import {
-  defineRuntimeTool
-} from "./index-vjpvjqpn.js";
-import"./index-h9etkkyk.js";
-import"./index-cby4ar3v.js";
-import"./index-2vtcmrj9.js";
-import"./index-kzfs85xp.js";
+} from "../index-zcgf3gqf.js";
+import"../index-1zbbzgfh.js";
 import {
+  defineRuntimeTool,
   executableAgentRuntimeTools
-} from "./index-77fekveh.js";
+} from "../index-v38qyerb.js";
+import"../index-dydjcp8z.js";
+import"../index-eqqvgdb3.js";
+import"../index-znfs20ss.js";
+import"../index-p5r7qpdd.js";
+import"../index-2vtcmrj9.js";
+import"../index-k5hsfc3j.js";
+import"../index-kzfs85xp.js";
+import"../index-hffjpmq9.js";
 
 // src/agent-runtime/child-tools.ts
 import { z as z2 } from "zod";
@@ -208,9 +207,6 @@ function defineAgentTool(definition) {
   };
 }
 
-// src/agent-runtime/children.ts
-import { randomUUID } from "node:crypto";
-
 // src/agent-runtime/children-contract.ts
 import { z } from "zod";
 var AgentChildBudgetSchema = z.object({
@@ -409,359 +405,406 @@ function createChildBlockingRelay(input) {
   const respondToChildBlocking = (parentConversationId, decision) => serializeBlocking(() => respondToChildBlockingInner(parentConversationId, decision));
   return { retireChildBlocking, listChildBlocking, respondToChildBlocking };
 }
-// src/agent-runtime/child-budget-policy.ts
-function agentChildBudgetStopPolicy(input) {
-  let stepsSeen = 0;
-  let lastBoundary = performance.now();
+
+// src/agent-runtime/children-state.ts
+function createChildManagerState(config) {
   return {
-    name: "child-budget",
-    when: async ({ steps }) => {
-      const step = steps.at(-1);
-      if (!step || steps.length <= stepsSeen)
-        return false;
-      stepsSeen = steps.length;
-      const elapsedMs = Math.max(0, performance.now() - lastBoundary);
-      lastBoundary = performance.now();
-      const usage = normalizeSdkUsage(step.usage);
-      const cost = input.cost?.({ usage: step.usage });
-      const boundary = await input.manager.recordStepUsage({
-        childConversationId: input.childConversationId,
-        usage: { ...usage, ...cost && { cost } },
-        elapsedMs
-      });
-      return boundary.stop;
-    }
+    config,
+    database: config.sqlite.database,
+    store: config.sqlite.store,
+    now: config.now ?? (() => new Date),
+    handles: new Map,
+    settlements: new Map
   };
 }
-
-// src/agent-runtime/children.ts
-function createSqliteAgentChildManager(input) {
-  const now = input.now ?? (() => new Date);
-  const database = input.sqlite.database;
-  const store = input.sqlite.store;
-  const handles = new Map;
-  const settlements = new Map;
-  const currentState = (childConversationId) => {
-    const raw = database.prepare("SELECT state FROM stitchkit_agent_runtime_children WHERE child_conversation_id = ?").get(childConversationId);
-    return raw === null || raw === undefined ? undefined : AgentChildStateSchema.parse(raw.state);
-  };
-  const isLive = (childConversationId) => {
-    const state = currentState(childConversationId);
-    return state === "spawned" || state === "running";
-  };
-  const settleable = (childConversationId) => {
-    const state = currentState(childConversationId);
-    return state === undefined || state === "spawned" || state === "running";
-  };
-  const STOP_BOUND_MS = 1e4;
-  const bounded = async (work, fallback) => {
-    let timer;
-    try {
-      return await Promise.race([
-        Promise.resolve(work),
-        new Promise((resolve) => {
-          timer = setTimeout(() => resolve(fallback), STOP_BOUND_MS);
-        })
-      ]);
-    } finally {
-      if (timer)
-        clearTimeout(timer);
-    }
-  };
-  const listChildren = (parentConversationId) => database.prepare(`
+function currentState(state, childConversationId) {
+  const raw = state.database.prepare("SELECT state FROM stitchkit_agent_runtime_children WHERE child_conversation_id = ?").get(childConversationId);
+  return raw === null || raw === undefined ? undefined : AgentChildStateSchema.parse(raw.state);
+}
+function isLive(state, childConversationId) {
+  const current = currentState(state, childConversationId);
+  return current === "spawned" || current === "running";
+}
+function settleable(state, childConversationId) {
+  const current = currentState(state, childConversationId);
+  return current === undefined || current === "spawned" || current === "running";
+}
+var STOP_BOUND_MS = 1e4;
+async function bounded(work, fallback) {
+  let timer;
+  try {
+    return await Promise.race([
+      Promise.resolve(work),
+      new Promise((resolve) => {
+        timer = setTimeout(() => resolve(fallback), STOP_BOUND_MS);
+      })
+    ]);
+  } finally {
+    if (timer)
+      clearTimeout(timer);
+  }
+}
+function listChildren(state, parentConversationId) {
+  return state.database.prepare(`
         SELECT parent_conversation_id, child_conversation_id, seed_upto_seq, state,
           budget_payload, usage_payload, result_reference, created_at, updated_at
         FROM stitchkit_agent_runtime_children
         WHERE parent_conversation_id = ? ORDER BY created_at, child_conversation_id
       `).all(parentConversationId).map(parseChild);
-  const updateState = async (record, state, resultReference, details = {}) => {
-    const updatedAt = now().toISOString();
-    const payload = {
-      childConversationId: record.childConversationId,
-      state,
-      ...resultReference && { resultReference },
-      ...details
-    };
-    const childPayload = {
-      parentConversationId: record.parentConversationId,
-      state,
-      ...resultReference && { resultReference },
-      ...details
-    };
-    const write = (audience) => input.sqlite.transaction(async (scope) => {
-      scope.database.prepare(`
+}
+async function updateState(state, record, next, resultReference, details = {}) {
+  const updatedAt = state.now().toISOString();
+  const payload = {
+    childConversationId: record.childConversationId,
+    state: next,
+    ...resultReference && { resultReference },
+    ...details
+  };
+  const childPayload = {
+    parentConversationId: record.parentConversationId,
+    state: next,
+    ...resultReference && { resultReference },
+    ...details
+  };
+  const write = (audience) => state.config.sqlite.transaction(async (scope) => {
+    scope.database.prepare(`
             UPDATE stitchkit_agent_runtime_children
             SET state = ?, result_reference = ?, updated_at = ? WHERE child_conversation_id = ?
-          `).run(state, resultReference ?? null, updatedAt, record.childConversationId);
-      if (audience === "both") {
-        await scope.appendEvent({
-          conversationId: record.parentConversationId,
-          kind: "child/state",
-          occurredAt: updatedAt,
-          payload
-        });
-      }
-      if (audience !== "row") {
-        await scope.appendEvent({
-          conversationId: record.childConversationId,
-          kind: "child/state",
-          occurredAt: updatedAt,
-          payload: childPayload
-        });
-      }
-    });
+          `).run(next, resultReference ?? null, updatedAt, record.childConversationId);
+    if (audience === "both") {
+      await scope.appendEvent({
+        conversationId: record.parentConversationId,
+        kind: "child/state",
+        occurredAt: updatedAt,
+        payload
+      });
+    }
+    if (audience !== "row") {
+      await scope.appendEvent({
+        conversationId: record.childConversationId,
+        kind: "child/state",
+        occurredAt: updatedAt,
+        payload: childPayload
+      });
+    }
+  });
+  try {
+    await write("both");
+  } catch (error) {
+    if (!(error instanceof AgentConversationPurgedError))
+      throw error;
     try {
-      await write("both");
-    } catch (error) {
-      if (!(error instanceof AgentConversationPurgedError))
-        throw error;
-      try {
-        await write("child");
-      } catch (inner) {
-        if (!(inner instanceof AgentConversationPurgedError))
-          throw inner;
-        await write("row");
-      }
+      await write("child");
+    } catch (inner) {
+      if (!(inner instanceof AgentConversationPurgedError))
+        throw inner;
+      await write("row");
     }
-  };
-  const spawnChild = async (request) => {
-    const requestedBudget = AgentChildBudgetSchema.parse(request.budget);
-    const remaining = input.remainingBudget ? AgentChildBudgetSchema.parse(await input.remainingBudget(request.parentConversationId)) : undefined;
-    const bounded2 = (requested, available) => {
-      if (requested === undefined)
-        return available;
-      if (available === undefined)
-        return requested;
-      return Math.min(requested, available);
-    };
-    const usd = bounded2(requestedBudget.usd, remaining?.usd);
-    const tokens = bounded2(requestedBudget.tokens, remaining?.tokens);
-    const milliseconds = bounded2(requestedBudget.milliseconds, remaining?.milliseconds);
-    const budget = AgentChildBudgetSchema.parse({
-      ...usd !== undefined && { usd },
-      ...tokens !== undefined && { tokens },
-      ...milliseconds !== undefined && { milliseconds }
-    });
-    const events = [];
-    let cursor = 1;
-    for (;; ) {
-      const page = await store.readEvents({
-        conversationId: request.parentConversationId,
-        fromSeq: cursor,
-        ...request.seedUptoSeq !== undefined && { toSeq: request.seedUptoSeq },
-        limit: 1000
+  }
+}
+function activeChild(state, parentConversationId, childConversationId) {
+  const child = listChildren(state, parentConversationId).find((record) => record.childConversationId === childConversationId);
+  if (!child)
+    throw new TypeError("Unknown child conversation for this parent");
+  if (child.state !== "running" && child.state !== "spawned") {
+    throw new TypeError("Child conversation is not active");
+  }
+  const handle = state.handles.get(childConversationId);
+  if (!handle)
+    throw new TypeError("Child host handle is unavailable");
+  return { child, handle };
+}
+
+// src/agent-runtime/children-control.ts
+async function stopChildren(state, retireChildBlocking, parentConversationId) {
+  const records = listChildren(state, parentConversationId).filter((record) => record.state === "spawned" || record.state === "running");
+  await Promise.all(records.map((record) => stopChild(state, retireChildBlocking, record)));
+}
+async function stopChild(state, retireChildBlocking, record) {
+  const startedAt = performance.now();
+  const handle = state.handles.get(record.childConversationId);
+  const reachable = handle ? handle.reachable ? await bounded(handle.reachable(), false) : true : false;
+  if (!reachable) {
+    if (isLive(state, record.childConversationId)) {
+      await updateState(state, record, "lost", undefined, {
+        stopDurationMs: Math.max(0, performance.now() - startedAt)
       });
-      events.push(...page.items);
-      if (page.nextSeq === undefined)
-        break;
-      cursor = page.nextSeq;
     }
-    const seedUptoSeq = events.at(-1)?.seq ?? 0;
-    const childConversationId = request.childConversationId ?? randomUUID();
-    const createdAt = now().toISOString();
-    const record = AgentChildRecordSchema.parse({
-      parentConversationId: request.parentConversationId,
-      childConversationId,
-      seedUptoSeq,
-      state: "spawned",
-      budget,
-      usage: { tokens: 0, usd: 0, milliseconds: 0 },
-      createdAt,
-      updatedAt: createdAt
-    });
-    const seedArchive = encodeAgentConversationArchive({
-      format: "stitchkit.agent-conversation",
-      formatVersion: 1,
+    retireChildBlocking(record.childConversationId);
+    return;
+  }
+  await bounded(Promise.resolve(handle?.stopPolicy("parent-stopped")).then(() => true), false);
+  if (!isLive(state, record.childConversationId))
+    return;
+  await updateState(state, record, "stopped", undefined, {
+    stopDurationMs: Math.max(0, performance.now() - startedAt)
+  });
+  retireChildBlocking(record.childConversationId);
+}
+async function sendMessage(state, parentConversationId, childConversationId, message) {
+  const { handle } = activeChild(state, parentConversationId, childConversationId);
+  if (!handle.sendMessage)
+    throw new TypeError("Child host does not support messages");
+  await handle.sendMessage(message);
+  await state.store.appendEvent({
+    conversationId: parentConversationId,
+    kind: "child/state",
+    payload: { childConversationId, action: "message-sent" }
+  });
+}
+async function interruptChild(state, retireChildBlocking, parentConversationId, childConversationId) {
+  const { child, handle } = activeChild(state, parentConversationId, childConversationId);
+  const startedAt = performance.now();
+  await handle.stopPolicy("parent-interrupt");
+  await updateState(state, child, "stopped", undefined, {
+    policyName: "parent-interrupt",
+    stopDurationMs: Math.max(0, performance.now() - startedAt)
+  });
+  retireChildBlocking(childConversationId);
+}
+
+// src/agent-runtime/children-spawn.ts
+import { randomUUID } from "node:crypto";
+async function grantedBudget(state, request) {
+  const requestedBudget = AgentChildBudgetSchema.parse(request.budget);
+  const remaining = state.config.remainingBudget ? AgentChildBudgetSchema.parse(await state.config.remainingBudget(request.parentConversationId)) : undefined;
+  const bounded2 = (requested, available) => {
+    if (requested === undefined)
+      return available;
+    if (available === undefined)
+      return requested;
+    return Math.min(requested, available);
+  };
+  const usd = bounded2(requestedBudget.usd, remaining?.usd);
+  const tokens = bounded2(requestedBudget.tokens, remaining?.tokens);
+  const milliseconds = bounded2(requestedBudget.milliseconds, remaining?.milliseconds);
+  return AgentChildBudgetSchema.parse({
+    ...usd !== undefined && { usd },
+    ...tokens !== undefined && { tokens },
+    ...milliseconds !== undefined && { milliseconds }
+  });
+}
+async function readSeedEvents(state, request) {
+  const events = [];
+  let cursor = 1;
+  for (;; ) {
+    const page = await state.store.readEvents({
       conversationId: request.parentConversationId,
-      events,
-      projections: [],
-      spills: []
-    });
-    const handle = await input.spawn({
-      parentConversationId: record.parentConversationId,
-      childConversationId,
-      seedArchive,
-      childInput: request.childInput,
-      budget
-    });
-    handle.result.catch(() => {
-      return;
+      fromSeq: cursor,
+      ...request.seedUptoSeq !== undefined && { toSeq: request.seedUptoSeq },
+      limit: 1000
     });
-    try {
-      await input.sqlite.transaction(async (scope) => {
-        scope.database.prepare(`
+    events.push(...page.items);
+    if (page.nextSeq === undefined)
+      break;
+    cursor = page.nextSeq;
+  }
+  return events;
+}
+async function persistSpawn(state, record, handle) {
+  const { childConversationId, createdAt } = record;
+  try {
+    await state.config.sqlite.transaction(async (scope) => {
+      scope.database.prepare(`
           INSERT INTO stitchkit_agent_runtime_children (
             parent_conversation_id, child_conversation_id, seed_upto_seq, state,
             budget_payload, usage_payload, result_reference, created_at, updated_at
           ) VALUES (?, ?, ?, ?, ?, ?, NULL, ?, ?)
         `).run(record.parentConversationId, record.childConversationId, record.seedUptoSeq, record.state, JSON.stringify(record.budget), JSON.stringify(record.usage), createdAt, createdAt);
-        await scope.appendEvent({
-          conversationId: record.parentConversationId,
-          kind: "child/spawned",
-          occurredAt: createdAt,
-          payload: { childConversationId, seedUptoSeq, budget }
-        });
+      await scope.appendEvent({
+        conversationId: record.parentConversationId,
+        kind: "child/spawned",
+        occurredAt: createdAt,
+        payload: {
+          childConversationId,
+          seedUptoSeq: record.seedUptoSeq,
+          budget: record.budget
+        }
       });
-      await updateState(record, "running");
-    } catch (cause) {
-      try {
-        await handle.stopPolicy("spawn-persistence-failed");
-      } catch (cleanup) {
-        throw new AggregateError([cause, cleanup], "Child persistence and stop both failed");
-      }
-      try {
-        if (isLive(childConversationId))
-          await updateState(record, "lost", undefined, { reason: "spawn-persistence-failed" });
-      } catch (cleanup) {
-        throw new AggregateError([cause, cleanup], "Child stopped but persistence reconciliation failed");
-      }
-      throw cause;
-    }
-    handles.set(childConversationId, handle);
-    const settlement = handle.result.then(async (result) => {
-      handles.delete(childConversationId);
-      retireChildBlocking(childConversationId);
-      if (settleable(childConversationId)) {
-        await updateState(record, "finished", result.resultReference);
-      }
-    }, async () => {
-      handles.delete(childConversationId);
-      retireChildBlocking(childConversationId);
-      if (settleable(childConversationId))
-        await updateState(record, "stopped");
-    });
-    settlements.set(childConversationId, settlement);
-    settlement.catch(() => {
-      return;
     });
-    return { ...record, state: "running", updatedAt: now().toISOString() };
-  };
-  const recordStepUsage = async (request) => {
-    const raw = database.prepare(`
-        SELECT parent_conversation_id, child_conversation_id, seed_upto_seq, state,
-          budget_payload, usage_payload, result_reference, created_at, updated_at
-        FROM stitchkit_agent_runtime_children WHERE child_conversation_id = ?
-      `).get(request.childConversationId);
-    if (raw === null || raw === undefined)
-      throw new TypeError("Unknown child conversation");
-    const record = parseChild(raw);
-    const measured = usageNumbers(request.usage);
-    if (record.budget.tokens !== undefined && measured.tokens === undefined) {
-      throw new TypeError("Cannot enforce child token budget without measured token usage");
+    await updateState(state, record, "running");
+  } catch (cause) {
+    try {
+      await handle.stopPolicy("spawn-persistence-failed");
+    } catch (cleanup) {
+      throw new AggregateError([cause, cleanup], "Child persistence and stop both failed");
     }
-    if (record.budget.usd !== undefined && measured.usd === undefined) {
-      throw new TypeError("Cannot enforce child USD budget without USD usage");
+    try {
+      if (isLive(state, childConversationId))
+        await updateState(state, record, "lost", undefined, {
+          reason: "spawn-persistence-failed"
+        });
+    } catch (cleanup) {
+      throw new AggregateError([cause, cleanup], "Child stopped but persistence reconciliation failed");
     }
-    const usage = {
-      tokens: record.usage.tokens + (measured.tokens ?? 0),
-      usd: record.usage.usd + (measured.usd ?? 0),
-      milliseconds: record.usage.milliseconds + request.elapsedMs
-    };
-    const updatedAt = now().toISOString();
-    const overrun = {
-      tokens: Math.max(0, usage.tokens - (record.budget.tokens ?? Number.POSITIVE_INFINITY)),
-      usd: Math.max(0, usage.usd - (record.budget.usd ?? Number.POSITIVE_INFINITY)),
-      milliseconds: Math.max(0, usage.milliseconds - (record.budget.milliseconds ?? Number.POSITIVE_INFINITY))
-    };
-    const stop = record.budget.tokens !== undefined && usage.tokens >= record.budget.tokens || record.budget.usd !== undefined && usage.usd >= record.budget.usd || record.budget.milliseconds !== undefined && usage.milliseconds >= record.budget.milliseconds;
-    const handle = handles.get(request.childConversationId);
-    let enforced = false;
-    if (stop && handle) {
-      enforced = await bounded(Promise.resolve().then(() => handle.stopPolicy("child-budget")).then(() => true, () => false), false);
+    throw cause;
+  }
+}
+function watchSettlement(state, record, handle, retireChildBlocking) {
+  const { childConversationId } = record;
+  state.handles.set(childConversationId, handle);
+  const settlement = handle.result.then(async (result) => {
+    state.handles.delete(childConversationId);
+    retireChildBlocking(childConversationId);
+    if (settleable(state, childConversationId)) {
+      await updateState(state, record, "finished", result.resultReference);
     }
-    const payload = {
-      childConversationId: record.childConversationId,
-      state: "running",
-      usage,
-      overrun,
-      ...stop && { policyName: "child-budget", enforced }
-    };
-    await input.sqlite.transaction(async (scope) => {
-      scope.database.prepare("UPDATE stitchkit_agent_runtime_children SET usage_payload = ?, updated_at = ? WHERE child_conversation_id = ?").run(JSON.stringify(usage), updatedAt, request.childConversationId);
-      await scope.appendEvent({
-        conversationId: record.parentConversationId,
-        kind: "child/state",
-        occurredAt: updatedAt,
-        payload
-      });
-      await scope.appendEvent({
-        conversationId: record.childConversationId,
-        kind: "child/state",
-        occurredAt: updatedAt,
-        payload: { parentConversationId: record.parentConversationId, ...payload }
-      });
-    });
-    return { stop, enforced, ...stop && { policyName: "child-budget" }, overrun };
+  }, async () => {
+    state.handles.delete(childConversationId);
+    retireChildBlocking(childConversationId);
+    if (settleable(state, childConversationId))
+      await updateState(state, record, "stopped");
+  });
+  state.settlements.set(childConversationId, settlement);
+  settlement.catch(() => {
+    return;
+  });
+}
+async function spawnChild(state, retireChildBlocking, request) {
+  const budget = await grantedBudget(state, request);
+  const events = await readSeedEvents(state, request);
+  const seedUptoSeq = events.at(-1)?.seq ?? 0;
+  const childConversationId = request.childConversationId ?? randomUUID();
+  const createdAt = state.now().toISOString();
+  const record = AgentChildRecordSchema.parse({
+    parentConversationId: request.parentConversationId,
+    childConversationId,
+    seedUptoSeq,
+    state: "spawned",
+    budget,
+    usage: { tokens: 0, usd: 0, milliseconds: 0 },
+    createdAt,
+    updatedAt: createdAt
+  });
+  const seedArchive = encodeAgentConversationArchive({
+    format: "stitchkit.agent-conversation",
+    formatVersion: 1,
+    conversationId: request.parentConversationId,
+    events,
+    projections: [],
+    spills: []
+  });
+  const handle = await state.config.spawn({
+    parentConversationId: record.parentConversationId,
+    childConversationId,
+    seedArchive,
+    childInput: request.childInput,
+    budget
+  });
+  handle.result.catch(() => {
+    return;
+  });
+  await persistSpawn(state, record, handle);
+  watchSettlement(state, record, handle, retireChildBlocking);
+  return { ...record, state: "running", updatedAt: state.now().toISOString() };
+}
+
+// src/agent-runtime/children-usage.ts
+async function recordStepUsage(state, request) {
+  const { database, handles, now } = state;
+  const raw = database.prepare(`
+      SELECT parent_conversation_id, child_conversation_id, seed_upto_seq, state,
+        budget_payload, usage_payload, result_reference, created_at, updated_at
+      FROM stitchkit_agent_runtime_children WHERE child_conversation_id = ?
+    `).get(request.childConversationId);
+  if (raw === null || raw === undefined)
+    throw new TypeError("Unknown child conversation");
+  const record = parseChild(raw);
+  const measured = usageNumbers(request.usage);
+  if (record.budget.tokens !== undefined && measured.tokens === undefined) {
+    throw new TypeError("Cannot enforce child token budget without measured token usage");
+  }
+  if (record.budget.usd !== undefined && measured.usd === undefined) {
+    throw new TypeError("Cannot enforce child USD budget without USD usage");
+  }
+  const usage = {
+    tokens: record.usage.tokens + (measured.tokens ?? 0),
+    usd: record.usage.usd + (measured.usd ?? 0),
+    milliseconds: record.usage.milliseconds + request.elapsedMs
   };
-  const stopChildren = async (parentConversationId) => {
-    const records = listChildren(parentConversationId).filter((record) => record.state === "spawned" || record.state === "running");
-    await Promise.all(records.map(async (record) => {
-      const startedAt = performance.now();
-      const handle = handles.get(record.childConversationId);
-      const reachable = handle ? handle.reachable ? await bounded(handle.reachable(), false) : true : false;
-      if (!reachable) {
-        if (isLive(record.childConversationId)) {
-          await updateState(record, "lost", undefined, {
-            stopDurationMs: Math.max(0, performance.now() - startedAt)
-          });
-        }
-        retireChildBlocking(record.childConversationId);
-        return;
-      }
-      await bounded(Promise.resolve(handle?.stopPolicy("parent-stopped")).then(() => true), false);
-      if (!isLive(record.childConversationId))
-        return;
-      await updateState(record, "stopped", undefined, {
-        stopDurationMs: Math.max(0, performance.now() - startedAt)
-      });
-      retireChildBlocking(record.childConversationId);
-    }));
+  const updatedAt = now().toISOString();
+  const overrun = {
+    tokens: Math.max(0, usage.tokens - (record.budget.tokens ?? Number.POSITIVE_INFINITY)),
+    usd: Math.max(0, usage.usd - (record.budget.usd ?? Number.POSITIVE_INFINITY)),
+    milliseconds: Math.max(0, usage.milliseconds - (record.budget.milliseconds ?? Number.POSITIVE_INFINITY))
   };
-  const activeChild = (parentConversationId, childConversationId) => {
-    const child = listChildren(parentConversationId).find((record) => record.childConversationId === childConversationId);
-    if (!child)
-      throw new TypeError("Unknown child conversation for this parent");
-    if (child.state !== "running" && child.state !== "spawned") {
-      throw new TypeError("Child conversation is not active");
-    }
-    const handle = handles.get(childConversationId);
-    if (!handle)
-      throw new TypeError("Child host handle is unavailable");
-    return { child, handle };
+  const stop = record.budget.tokens !== undefined && usage.tokens >= record.budget.tokens || record.budget.usd !== undefined && usage.usd >= record.budget.usd || record.budget.milliseconds !== undefined && usage.milliseconds >= record.budget.milliseconds;
+  const handle = handles.get(request.childConversationId);
+  let enforced = false;
+  if (stop && handle) {
+    enforced = await bounded(Promise.resolve().then(() => handle.stopPolicy("child-budget")).then(() => true, () => false), false);
+  }
+  const payload = {
+    childConversationId: record.childConversationId,
+    state: "running",
+    usage,
+    overrun,
+    ...stop && { policyName: "child-budget", enforced }
   };
-  const { retireChildBlocking, listChildBlocking, respondToChildBlocking } = createChildBlockingRelay({ store, now, handles, listChildren, activeChild, bounded });
-  const sendMessage = async (parentConversationId, childConversationId, message) => {
-    const { handle } = activeChild(parentConversationId, childConversationId);
-    if (!handle.sendMessage)
-      throw new TypeError("Child host does not support messages");
-    await handle.sendMessage(message);
-    await store.appendEvent({
-      conversationId: parentConversationId,
+  await state.config.sqlite.transaction(async (scope) => {
+    scope.database.prepare("UPDATE stitchkit_agent_runtime_children SET usage_payload = ?, updated_at = ? WHERE child_conversation_id = ?").run(JSON.stringify(usage), updatedAt, request.childConversationId);
+    await scope.appendEvent({
+      conversationId: record.parentConversationId,
       kind: "child/state",
-      payload: { childConversationId, action: "message-sent" }
+      occurredAt: updatedAt,
+      payload
     });
-  };
-  const interruptChild = async (parentConversationId, childConversationId) => {
-    const { child, handle } = activeChild(parentConversationId, childConversationId);
-    const startedAt = performance.now();
-    await handle.stopPolicy("parent-interrupt");
-    await updateState(child, "stopped", undefined, {
-      policyName: "parent-interrupt",
-      stopDurationMs: Math.max(0, performance.now() - startedAt)
+    await scope.appendEvent({
+      conversationId: record.childConversationId,
+      kind: "child/state",
+      occurredAt: updatedAt,
+      payload: { parentConversationId: record.parentConversationId, ...payload }
     });
-    retireChildBlocking(childConversationId);
-  };
-  const waitChild = async (childConversationId) => {
-    await settlements.get(childConversationId);
+  });
+  return { stop, enforced, ...stop && { policyName: "child-budget" }, overrun };
+}
+// src/agent-runtime/child-budget-policy.ts
+function agentChildBudgetStopPolicy(input) {
+  let stepsSeen = 0;
+  let lastBoundary = performance.now();
+  return {
+    name: "child-budget",
+    when: async ({ steps }) => {
+      const step = steps.at(-1);
+      if (!step || steps.length <= stepsSeen)
+        return false;
+      stepsSeen = steps.length;
+      const elapsedMs = Math.max(0, performance.now() - lastBoundary);
+      lastBoundary = performance.now();
+      const usage = normalizeSdkUsage(step.usage);
+      const cost = input.cost?.({ usage: step.usage });
+      const boundary = await input.manager.recordStepUsage({
+        childConversationId: input.childConversationId,
+        usage: { ...usage, ...cost && { cost } },
+        elapsedMs
+      });
+      return boundary.stop;
+    }
   };
+}
+
+// src/agent-runtime/children.ts
+function createSqliteAgentChildManager(input) {
+  const state = createChildManagerState(input);
+  const list = (parentConversationId) => listChildren(state, parentConversationId);
+  const { retireChildBlocking, listChildBlocking, respondToChildBlocking } = createChildBlockingRelay({
+    store: state.store,
+    now: state.now,
+    handles: state.handles,
+    listChildren: list,
+    activeChild: (parentConversationId, childConversationId) => activeChild(state, parentConversationId, childConversationId),
+    bounded
+  });
   return {
-    spawnChild,
-    listChildren,
-    recordStepUsage,
-    stopChildren,
-    sendMessage,
-    interruptChild,
-    waitChild,
+    spawnChild: (request) => spawnChild(state, retireChildBlocking, request),
+    listChildren: list,
+    recordStepUsage: (request) => recordStepUsage(state, request),
+    stopChildren: (parentConversationId) => stopChildren(state, retireChildBlocking, parentConversationId),
+    sendMessage: (parentConversationId, childConversationId, message) => sendMessage(state, parentConversationId, childConversationId, message),
+    interruptChild: (parentConversationId, childConversationId) => interruptChild(state, retireChildBlocking, parentConversationId, childConversationId),
+    waitChild: async (childConversationId) => {
+      await state.settlements.get(childConversationId);
+    },
     listChildBlocking,
     respondToChildBlocking
   };
@@ -2454,7 +2497,6 @@ export {
   createSqliteAgentChildManager,
   createMemoryAgentRuntimeStore,
   createMemoryAgentModelSelectionStore,
-  createLocalStepDurability,
   createDeferredAgentToolSurface,
   createAgentToolFenceLifecycle,
   createAgentStateTools,