stitchkit 0.88.0 → 0.89.0

package/dist/{index-0ydchz76.js → index-mnm4qp0p.js}

@@ -1,16 +1,16 @@
 import {
   collectTools,
   createToolRunner
-} from "./index-0vfdh685.js";
+} from "./index-8c3a7m4g.js";
 import {
   toolErrorFromResult
-} from "./index-wn9cb82y.js";
-import {
-  assertUniqueToolName
-} from "./index-r159gjwy.js";
+} from "./index-zyvby92n.js";
 import {
   AppError
 } from "./index-0w9abg87.js";
+import {
+  assertUniqueToolName
+} from "./index-r159gjwy.js";
 
 // src/tools/invoker.ts
 function createToolInvoker(services, config) {

package/dist/{index-1szetq6f.js → index-q3ve2d1k.js}

@@ -1,17 +1,19 @@
 import {
-  AgentToolError
-} from "./index-3xnq72rz.js";
+  AgentToolError,
+  resolveToolDurability
+} from "./index-7rkhw9ec.js";
 import {
   collectToolSurface
-} from "./index-rcgsnrr6.js";
+} from "./index-31jw8fjq.js";
 import {
   createToolRunner,
   formatToolError
-} from "./index-0vfdh685.js";
+} from "./index-8c3a7m4g.js";
 import {
   isToolExecutionControlError,
+  toolCauseFromResult,
   toolResultFromError
-} from "./index-wn9cb82y.js";
+} from "./index-zyvby92n.js";
 import {
   isRecord
 } from "./index-77fekveh.js";
@@ -20,6 +22,10 @@ import {
 import { jsonSchema, tool } from "ai";
 function mountAgent(services, config = {}) {
   const serviceList = Array.isArray(services) ? services : [services];
+  if (config.registry && config.runtimeTools) {
+    throw new Error("mountAgent accepts either runtimeTools or a registry, not both");
+  }
+  const runtimeTools = config.registry ? config.registry.tools : config.runtimeTools;
   const tools = {};
   const runTool = createToolRunner({
     source: "agent",
@@ -32,7 +38,7 @@ function mountAgent(services, config = {}) {
     onOutputStrip: config.onOutputStrip
   });
   for (const entry of collectToolSurface({
-    surface: { services: serviceList, runtimeTools: config.runtimeTools },
+    surface: { services: serviceList, runtimeTools },
     transport: "AGENT",
     extend: config.extend,
     flattenUnionInput: config.flattenUnionInput
@@ -43,7 +49,23 @@ function mountAgent(services, config = {}) {
     });
     const execute = async (rawArgs, options) => {
       const args = isRecord(rawArgs) ? rawArgs : {};
-      const result = await runTool(mountable, args, {
+      const durability = resolveToolDurability(options.context, options.toolCallId, options.abortSignal);
+      const executeTool = durability ? createToolRunner({
+        source: "agent",
+        extend: config.extend,
+        context: {
+          ...config.context,
+          step: durability.step,
+          sleep: durability.sleep,
+          waitFor: durability.waitFor
+        },
+        hooks: config.hooks,
+        lifecycle: config.lifecycle,
+        errorHint: config.errorHint,
+        coerceJsonArgs: config.coerceJsonArgs,
+        onOutputStrip: config.onOutputStrip
+      }) : runTool;
+      const result = await executeTool(mountable, args, {
         signal: options.abortSignal
       }).catch((err) => {
         if (isToolExecutionControlError(err))
@@ -52,7 +74,7 @@ function mountAgent(services, config = {}) {
       });
       if (result.ok)
         return result.data;
-      throw new AgentToolError(formatToolError(result, mountable.name, config.errorHint));
+      throw new AgentToolError(formatToolError(result, mountable.name, config.errorHint), toolCauseFromResult(result));
     };
     const presenter = entry.kind === "runtime" ? entry.definition.present?.agent : undefined;
     if (entry.kind === "runtime" && presenter) {

package/dist/{index-6krwcdcf.js → index-zwkgfq1s.js}

@@ -9,88 +9,6 @@ import {
   AgentUsageSchema
 } from "./index-gtj3zc53.js";
 
-// src/agent-runtime/history-chronology.ts
-function createToolChronology() {
-  return { calls: new Map, approvals: new Map, pending: 0, resultsStarted: false };
-}
-function advanceToolChronology(previous, parts) {
-  const calls = new Map(previous.calls);
-  const approvals = new Map(previous.approvals);
-  let { pending, resultsStarted } = previous;
-  for (const part of parts) {
-    if (part.type === "tool-call") {
-      if (calls.has(part.callId) || resultsStarted && pending > 0)
-        return;
-      if (pending === 0)
-        resultsStarted = false;
-      calls.set(part.callId, { toolName: part.toolName, phase: "called" });
-      pending += 1;
-    } else if (part.type === "tool-approval-request") {
-      const call = calls.get(part.callId);
-      if (call?.phase !== "called" || approvals.has(part.approvalId))
-        return;
-      approvals.set(part.approvalId, part.callId);
-      calls.set(part.callId, { ...call, phase: "requested" });
-    } else if (part.type === "tool-approval-response") {
-      const callId = approvals.get(part.approvalId);
-      const call = callId === undefined ? undefined : calls.get(callId);
-      if (callId === undefined || !call || call.phase !== "requested")
-        return;
-      calls.set(callId, { ...call, phase: part.approved ? "approved" : "denied" });
-    } else if (part.type === "tool-result") {
-      const call = calls.get(part.callId);
-      if (!call || call.toolName !== part.toolName || call.phase === "result" || call.phase === "requested" || call.phase === "denied" && part.outcome === "success")
-        return;
-      calls.set(part.callId, { ...call, phase: "result" });
-      pending -= 1;
-      resultsStarted = true;
-    }
-  }
-  return { calls, approvals, pending, resultsStarted };
-}
-function canProjectToolChronology(state) {
-  return [...state.calls.values()].every(({ phase }) => phase !== "called");
-}
-
-// src/agent-runtime/terminal-status.ts
-function isSpeakableAssistantStatus(status) {
-  return status === "completed" || status === "interrupted" || status === "committed";
-}
-function isAssistantHistoryEvidence(status, policy) {
-  return isSpeakableAssistantStatus(status) || status === "failed" && policy?.failedAssistant === "assistant-marked";
-}
-function isCompleteAgentHistoryTurn(messages, policy) {
-  if (messages[0]?.role !== "user")
-    return false;
-  let chronology = createToolChronology();
-  let assistantCount = 0;
-  for (const message of messages) {
-    if (message.role === "assistant") {
-      if (!isAssistantHistoryEvidence(message.status, policy))
-        return false;
-      assistantCount += 1;
-    }
-    const next = advanceToolChronology(chronology, message.parts);
-    if (!next)
-      return false;
-    chronology = next;
-  }
-  return assistantCount > 0 && chronology.pending === 0;
-}
-function assistantStatus(reason) {
-  if (reason === "success" || reason === "policy_stop" || reason === "provider_stop") {
-    return "completed";
-  }
-  if (reason === "superseded")
-    return "superseded";
-  if (reason === "absorbed")
-    return "superseded";
-  if (reason === "interrupted" || reason === "cancelled" || reason === "shutdown") {
-    return "interrupted";
-  }
-  return "failed";
-}
-
 // src/agent-runtime/store.ts
 import { z } from "zod";
 var AgentStoreConflictSchema = z.object({
@@ -186,6 +104,11 @@ var ReplaceCompactedRangeSchema = z.object({
   replacedMessageIds: z.array(AgentRecordIdSchema).min(1),
   summary: AgentMessageSchema
 });
+var SeedConversationInputSchema = z.object({
+  conversationId: AgentRecordIdSchema,
+  seedKey: z.string().min(1),
+  inputs: z.array(AgentMessageSchema).min(1)
+});
 var AgentRecoverableDescriptorSchema = z.object({
   conversationId: AgentRecordIdSchema,
   run: AgentRunSchema
@@ -216,7 +139,11 @@ var AgentStoreEventKindSchema = z2.enum([
   "child/state",
   "retry/scheduled",
   "retry/started",
-  "sandbox/probed"
+  "sandbox/probed",
+  "approval/response-rejected",
+  "durability/step",
+  "durability/park",
+  "durability/event"
 ]);
 var AgentStoreTransitionSchema = z2.discriminatedUnion("type", [
   z2.object({ type: z2.literal("accept"), input: AcceptInputAndAssignRunSchema }).strict(),
@@ -226,7 +153,8 @@ var AgentStoreTransitionSchema = z2.discriminatedUnion("type", [
   z2.object({ type: z2.literal("interrupt"), input: RequestRunInterruptSchema }).strict(),
   z2.object({ type: z2.literal("recover"), input: RecoverAgentRunSchema }).strict(),
   z2.object({ type: z2.literal("terminal"), input: CommitRunTerminalSchema }).strict(),
-  z2.object({ type: z2.literal("compact"), input: ReplaceCompactedRangeSchema }).strict()
+  z2.object({ type: z2.literal("compact"), input: ReplaceCompactedRangeSchema }).strict(),
+  z2.object({ type: z2.literal("seed"), input: SeedConversationInputSchema }).strict()
 ]);
 var AgentStoreEventEnvelopeSchema = z2.object({
   schemaVersion: z2.int().positive(),
@@ -332,4 +260,86 @@ function decodeAgentConversationArchive(bytes) {
   return archive;
 }
 
-export { createToolChronology, advanceToolChronology, canProjectToolChronology, isAssistantHistoryEvidence, isCompleteAgentHistoryTurn, assistantStatus, AgentStoreConflictSchema, AgentStoreNotFoundSchema, AgentStoreAppliedSchema, AgentStoreDuplicateSchema, AgentStoreMutationResultSchema, AgentRunViewSchema, AcceptInputAndAssignRunSchema, AcquireAgentRunSchema, CheckpointRunAssistantSchema, RecordRunOperationSchema, CommitRunTerminalSchema, RequestRunInterruptSchema, RecoverAgentRunSchema, ReplaceCompactedRangeSchema, AgentRecoverableDescriptorSchema, AgentRecoverablePageSchema, AgentStoreEventKindSchema, AgentStoreTransitionSchema, AgentStoreEventEnvelopeSchema, AppendAgentStoreEventSchema, ReadAgentStoreEventsSchema, AgentStoreEventPageSchema, decodeAgentStoreEvent, agentStoreEventDraft, canonicalAgentJson, AgentConversationArchiveSchema, encodeAgentConversationArchive, decodeAgentConversationArchive };
+// src/agent-runtime/history-chronology.ts
+function createToolChronology() {
+  return { calls: new Map, approvals: new Map, pending: 0, resultsStarted: false };
+}
+function advanceToolChronology(previous, parts) {
+  const calls = new Map(previous.calls);
+  const approvals = new Map(previous.approvals);
+  let { pending, resultsStarted } = previous;
+  for (const part of parts) {
+    if (part.type === "tool-call") {
+      if (calls.has(part.callId) || resultsStarted && pending > 0)
+        return;
+      if (pending === 0)
+        resultsStarted = false;
+      calls.set(part.callId, { toolName: part.toolName, phase: "called" });
+      pending += 1;
+    } else if (part.type === "tool-approval-request") {
+      const call = calls.get(part.callId);
+      if (call?.phase !== "called" || approvals.has(part.approvalId))
+        return;
+      approvals.set(part.approvalId, part.callId);
+      calls.set(part.callId, { ...call, phase: "requested" });
+    } else if (part.type === "tool-approval-response") {
+      const callId = approvals.get(part.approvalId);
+      const call = callId === undefined ? undefined : calls.get(callId);
+      if (callId === undefined || !call || call.phase !== "requested")
+        return;
+      calls.set(callId, { ...call, phase: part.approved ? "approved" : "denied" });
+    } else if (part.type === "tool-result") {
+      const call = calls.get(part.callId);
+      if (!call || call.toolName !== part.toolName || call.phase === "result" || call.phase === "requested" || call.phase === "denied" && part.outcome === "success")
+        return;
+      calls.set(part.callId, { ...call, phase: "result" });
+      pending -= 1;
+      resultsStarted = true;
+    }
+  }
+  return { calls, approvals, pending, resultsStarted };
+}
+function canProjectToolChronology(state) {
+  return [...state.calls.values()].every(({ phase }) => phase !== "called");
+}
+
+// src/agent-runtime/terminal-status.ts
+function isSpeakableAssistantStatus(status) {
+  return status === "completed" || status === "interrupted" || status === "committed";
+}
+function isAssistantHistoryEvidence(status, policy) {
+  return isSpeakableAssistantStatus(status) || status === "failed" && policy?.failedAssistant === "assistant-marked";
+}
+function isCompleteAgentHistoryTurn(messages, policy) {
+  if (messages[0]?.role !== "user")
+    return false;
+  let chronology = createToolChronology();
+  let assistantCount = 0;
+  for (const message of messages) {
+    if (message.role === "assistant") {
+      if (!isAssistantHistoryEvidence(message.status, policy))
+        return false;
+      assistantCount += 1;
+    }
+    const next = advanceToolChronology(chronology, message.parts);
+    if (!next)
+      return false;
+    chronology = next;
+  }
+  return assistantCount > 0 && chronology.pending === 0;
+}
+function assistantStatus(reason) {
+  if (reason === "success" || reason === "policy_stop" || reason === "provider_stop") {
+    return "completed";
+  }
+  if (reason === "superseded")
+    return "superseded";
+  if (reason === "absorbed")
+    return "superseded";
+  if (reason === "interrupted" || reason === "cancelled" || reason === "shutdown") {
+    return "interrupted";
+  }
+  return "failed";
+}
+
+export { AgentStoreConflictSchema, AgentStoreNotFoundSchema, AgentStoreAppliedSchema, AgentStoreDuplicateSchema, AgentStoreMutationResultSchema, AgentRunViewSchema, AcceptInputAndAssignRunSchema, AcquireAgentRunSchema, CheckpointRunAssistantSchema, RecordRunOperationSchema, CommitRunTerminalSchema, RequestRunInterruptSchema, RecoverAgentRunSchema, ReplaceCompactedRangeSchema, SeedConversationInputSchema, AgentRecoverableDescriptorSchema, AgentRecoverablePageSchema, AgentStoreEventKindSchema, AgentStoreTransitionSchema, AgentStoreEventEnvelopeSchema, AppendAgentStoreEventSchema, ReadAgentStoreEventsSchema, AgentStoreEventPageSchema, decodeAgentStoreEvent, agentStoreEventDraft, canonicalAgentJson, AgentConversationArchiveSchema, encodeAgentConversationArchive, decodeAgentConversationArchive, createToolChronology, advanceToolChronology, canProjectToolChronology, isAssistantHistoryEvidence, isCompleteAgentHistoryTurn, assistantStatus };

package/dist/{index-wn9cb82y.js → index-zyvby92n.js}

@@ -2,12 +2,6 @@ import {
   getRequestContext,
   runWithRequestContext
 } from "./index-vsbzgd7b.js";
-import {
-  objectShapeKeys
-} from "./index-r159gjwy.js";
-import {
-  coerceJsonArgs
-} from "./index-7zbps32p.js";
 import {
   formatZodError,
   normalizeError,
@@ -18,9 +12,15 @@ import {
   STITCH_ERROR_STATUS,
   isStitchErrorCode
 } from "./index-0w9abg87.js";
+import {
+  coerceJsonArgs
+} from "./index-7zbps32p.js";
 import {
   isUnsafeKey
 } from "./index-kzfs85xp.js";
+import {
+  objectShapeKeys
+} from "./index-r159gjwy.js";
 import {
   isRecord
 } from "./index-77fekveh.js";
@@ -46,18 +46,21 @@ function toolResultFromError(err) {
     details: appErr.details ?? { message: appErr.message },
     ...appErr.hint && { hint: appErr.hint }
   };
-  normalizedToolErrors.set(result, appErr);
+  normalizedToolErrors.set(result, { normalized: appErr, cause: err });
   return result;
 }
 function toolErrorFromResult(result) {
   const retained = normalizedToolErrors.get(result);
   if (retained)
-    return retained;
+    return retained.normalized;
   const details = isRecord(result.details) ? result.details : undefined;
   const message = typeof details?.message === "string" ? details.message : result.code;
   const status = isStitchErrorCode(result.code) ? STITCH_ERROR_STATUS[result.code] : 500;
   return new AppError(result.code, message, status, details, result.hint);
 }
+function toolCauseFromResult(result) {
+  return normalizedToolErrors.get(result)?.cause;
+}
 async function executeToolMethod(method, toolName, rawArgs, context, hooks, lifecycle, coerceJson = false, onOutputStrip, extension, finalizeOutput) {
   return inToolCallContext({ source: context.source, toolName, method }, () => runToolMethod(method, toolName, rawArgs, context, hooks, lifecycle, coerceJson, onOutputStrip, extension, finalizeOutput));
 }
@@ -258,4 +261,4 @@ async function runToolMethod(method, toolName, rawArgs, context, hooks, lifecycl
   }
 }
 
-export { ToolExecutionControlError, isToolExecutionControlError, toolResultFromError, toolErrorFromResult, executeToolMethod };
+export { ToolExecutionControlError, isToolExecutionControlError, toolResultFromError, toolErrorFromResult, toolCauseFromResult, executeToolMethod };

package/dist/index.js

@@ -6,6 +6,16 @@ import {
   createBackoff,
   resumableIterator
 } from "./index-s8cnx02s.js";
+import {
+  contractEndpointMatchers,
+  createClient,
+  createClients,
+  createScopedClients,
+  createScopedUrlBuilders,
+  createUrlBuilder,
+  createUrlBuilders,
+  parseNDJSON
+} from "./index-27gm3d6g.js";
 import {
   REALTIME_REJECTION_KEY,
   asRealtimeRejection,
@@ -22,6 +32,9 @@ import {
   RealtimeRequestRejectedError,
   RealtimeRequestTimeoutError
 } from "./index-2qzskm8h.js";
+import {
+  parseSSE
+} from "./index-qmgs7y68.js";
 import {
   LiveStateControllerStatusSchema,
   LiveStatePhaseSchema,
@@ -29,19 +42,6 @@ import {
   createLiveStateController
 } from "./index-ywd0y6m1.js";
 import"./index-7gnkny4z.js";
-import {
-  contractEndpointMatchers,
-  createClient,
-  createClients,
-  createScopedClients,
-  createScopedUrlBuilders,
-  createUrlBuilder,
-  createUrlBuilders,
-  parseNDJSON
-} from "./index-27gm3d6g.js";
-import {
-  parseSSE
-} from "./index-qmgs7y68.js";
 import {
   ApiError,
   createHttpClient

package/dist/server/index.js

@@ -27,6 +27,11 @@ import {
 } from "../index-3z73fh2c.js";
 import"../index-apn8repm.js";
 import"../index-2qzskm8h.js";
+import {
+  inputIsQuery,
+  parseSSE,
+  streamSSE
+} from "../index-qmgs7y68.js";
 import {
   composeAuthHooks,
   createAuthHook,
@@ -70,15 +75,6 @@ import {
   resolveSocketIp,
   resolveTraceId
 } from "../index-f9mb610r.js";
-import {
-  jsonSchemaFields,
-  toJsonSchema
-} from "../index-cby4ar3v.js";
-import {
-  inputIsQuery,
-  parseSSE,
-  streamSSE
-} from "../index-qmgs7y68.js";
 import {
   errorCode,
   formatZodError,
@@ -105,6 +101,10 @@ import {
 } from "../index-0w9abg87.js";
 import"../index-zcgf3gqf.js";
 import"../index-kzfs85xp.js";
+import {
+  jsonSchemaFields,
+  toJsonSchema
+} from "../index-cby4ar3v.js";
 import {
   isRecord
 } from "../index-77fekveh.js";

package/dist/testing/agent-store-conformance.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"agent-store-conformance.d.ts","sourceRoot":"","sources":["../../src/testing/agent-store-conformance.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,wBAAwB,CAAC;AAIhE;;;;;;;;;GASG;AACH,MAAM,WAAW,4BAA4B;IAC3C;;;;OAIG;IACH,QAAQ,CAAC,eAAe,EAAE,SAAS,MAAM,EAAE,CAAC;CAC7C;AAED,MAAM,WAAW,2BAA2B;IAC1C;;;;OAIG;IACH,WAAW,CACT,OAAO,EAAE,4BAA4B,GACpC,iBAAiB,GAAG,OAAO,CAAC,iBAAiB,CAAC,CAAC;IAClD;;;;;;;;OAQG;IACH,OAAO,CAAC,CAAC,OAAO,EAAE,4BAA4B,GAAG,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CACvE;AAwCD,gFAAgF;AAChF,wBAAsB,wBAAwB,CAC5C,MAAM,EAAE,2BAA2B,GAClC,OAAO,CAAC,IAAI,CAAC,CAoCf"}
+{"version":3,"file":"agent-store-conformance.d.ts","sourceRoot":"","sources":["../../src/testing/agent-store-conformance.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,wBAAwB,CAAC;AAIhE;;;;;;;;;GASG;AACH,MAAM,WAAW,4BAA4B;IAC3C;;;;OAIG;IACH,QAAQ,CAAC,eAAe,EAAE,SAAS,MAAM,EAAE,CAAC;CAC7C;AAED,MAAM,WAAW,2BAA2B;IAC1C;;;;OAIG;IACH,WAAW,CACT,OAAO,EAAE,4BAA4B,GACpC,iBAAiB,GAAG,OAAO,CAAC,iBAAiB,CAAC,CAAC;IAClD;;;;;;;;OAQG;IACH,OAAO,CAAC,CAAC,OAAO,EAAE,4BAA4B,GAAG,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CACvE;AAwCD,gFAAgF;AAChF,wBAAsB,wBAAwB,CAC5C,MAAM,EAAE,2BAA2B,GAClC,OAAO,CAAC,IAAI,CAAC,CAqCf"}

package/dist/testing.js

@@ -1,47 +1,39 @@
 import {
   createApplication
-} from "./index-evcnmsc3.js";
-import"./index-2k4yrqkc.js";
+} from "./index-t7fkyxcr.js";
 import"./index-3gye9wzb.js";
+import"./index-2k4yrqkc.js";
 import"./index-3z73fh2c.js";
 import {
   createMemoryAgentRuntimeStore
-} from "./index-v1qk37y9.js";
-import {
-  createAgentRaceBarrier,
-  createAgentRaceDriver,
-  createAgentRaceTrace
-} from "./index-cnyk6te3.js";
+} from "./index-hrbajay7.js";
 import {
   decodeAgentConversationArchive
-} from "./index-6krwcdcf.js";
+} from "./index-zwkgfq1s.js";
 import {
   AgentMessageSchema,
   AgentRunSchema
 } from "./index-gtj3zc53.js";
+import {
+  createAgentRaceBarrier,
+  createAgentRaceDriver,
+  createAgentRaceTrace
+} from "./index-cnyk6te3.js";
 import {
   RealtimeRejectDirectionSchema,
   RealtimeRejectFaultSchema,
   RealtimeRejectPhaseSchema,
   RealtimeRejectReasonSchema
 } from "./index-p7hgdyhb.js";
+import {
+  createClient,
+  createClients
+} from "./index-27gm3d6g.js";
 import {
   RealtimeRequestDisconnectedError,
   RealtimeRequestInvalidAcknowledgementError,
   RealtimeRequestTimeoutError
 } from "./index-2qzskm8h.js";
-import {
-  mcpProjectionCandidate,
-  prepareProjectedMcpTools,
-  projectToolSurface
-} from "./index-r159gjwy.js";
-import {
-  toJsonSchema
-} from "./index-cby4ar3v.js";
-import {
-  createClient,
-  createClients
-} from "./index-27gm3d6g.js";
 import"./index-qmgs7y68.js";
 import"./index-3xwxfj4z.js";
 import"./index-7evdsyez.js";
@@ -52,6 +44,14 @@ import"./index-6k1937bx.js";
 import"./index-0w9abg87.js";
 import"./index-zcgf3gqf.js";
 import"./index-kzfs85xp.js";
+import {
+  mcpProjectionCandidate,
+  prepareProjectedMcpTools,
+  projectToolSurface
+} from "./index-r159gjwy.js";
+import {
+  toJsonSchema
+} from "./index-cby4ar3v.js";
 import {
   isRecord
 } from "./index-77fekveh.js";
@@ -97,7 +97,8 @@ async function runAgentStoreConformance(config) {
       `${run}-causal-active`,
       `${run}-interrupt-priority`,
       `${run}-ledger`,
-      `${run}-archive`
+      `${run}-archive`,
+      `${run}-seed`
     ]
   };
   const store = await config.createStore(context);
@@ -117,6 +118,36 @@ async function runAgentStoreConformance(config) {
   if (failure !== undefined)
     throw failure;
 }
+async function seedScenario(store, conversationId) {
+  const input = {
+    conversationId,
+    seedKey: "brief",
+    inputs: [userMessage(conversationId, "seed-a"), userMessage(conversationId, "seed-b")]
+  };
+  const first = await store.seedConversationInput(input);
+  requireOutcome(first, "applied");
+  const before = await store.loadSnapshot(conversationId);
+  if (before.messages.map((message) => message.id).join(",") !== "seed-a,seed-b")
+    throw new Error("Seed conformance: complete ordered seed missing");
+  await Promise.all([store.seedConversationInput(input), store.seedConversationInput(input)]);
+  const repeated = await store.loadSnapshot(conversationId);
+  if (repeated.version !== before.version || repeated.messages.length !== 2)
+    throw new Error("Seed conformance: replay changed history");
+  const compacted = await store.replaceCompactedRange({
+    conversationId,
+    expectedVersion: repeated.version,
+    replacedMessageIds: ["seed-a", "seed-b"],
+    summary: AgentMessageSchema.parse({
+      ...userMessage(conversationId, "seed-summary"),
+      role: "summary"
+    })
+  });
+  requireOutcome(compacted, "applied");
+  await store.seedConversationInput(input);
+  const after = await store.loadSnapshot(conversationId);
+  if (after.messages.some((message) => message.id === "seed-a" || message.id === "seed-b"))
+    throw new Error("Seed conformance: compacted instructions resurrected");
+}
 async function conformanceScenario(store, conversationIds) {
   const [
     conversationId,
@@ -126,8 +157,11 @@ async function conformanceScenario(store, conversationIds) {
     causalActiveConversationId,
     interruptPriorityConversationId,
     ledgerConversationId,
-    archiveConversationId
+    archiveConversationId,
+    seedConversationId
   ] = conversationIds;
+  if (seedConversationId)
+    await seedScenario(store, seedConversationId);
   if (ledgerConversationId)
     await ledgerScenario(store, ledgerConversationId);
   if (archiveConversationId)

package/dist/tool-invoker.js

@@ -1,19 +1,19 @@
 import {
   createToolInvoker
-} from "./index-0ydchz76.js";
-import"./index-0vfdh685.js";
-import"./index-wn9cb82y.js";
+} from "./index-mnm4qp0p.js";
+import"./index-8c3a7m4g.js";
+import"./index-zyvby92n.js";
 import"./index-vsbzgd7b.js";
 import"./index-f9mb610r.js";
-import"./index-r159gjwy.js";
-import"./index-cby4ar3v.js";
-import"./index-7zbps32p.js";
 import"./index-7evdsyez.js";
 import"./index-2bxcmqkb.js";
 import"./index-6k1937bx.js";
 import"./index-0w9abg87.js";
 import"./index-zcgf3gqf.js";
+import"./index-7zbps32p.js";
 import"./index-kzfs85xp.js";
+import"./index-r159gjwy.js";
+import"./index-cby4ar3v.js";
 import"./index-77fekveh.js";
 export {
   createToolInvoker

package/dist/tools/agent.d.ts

@@ -2,6 +2,7 @@ import type { ToolSet } from 'ai';
 import type { ServiceDef } from '../server/types.js';
 import { type ErrorHintFn, type ToolCallHooks, type ToolLifecycle } from './execute.js';
 import { type ToolExtend } from './mount.js';
+import type { AgentToolRegistry } from './registry.js';
 import type { RuntimeToolDefinition } from './runtime-tool.js';
 export interface AgentContext {
     [key: string]: unknown;
@@ -27,6 +28,11 @@ export interface AgentMountConfig {
     errorHint?: ErrorHintFn;
     /** Framework-managed pathless operations mounted beside contract tools. */
     runtimeTools?: readonly RuntimeToolDefinition[];
+    /**
+     * A composed tool registry. Mutually exclusive with `runtimeTools`: one
+     * declaration of the runtime surface, not two lists to reconcile.
+     */
+    registry?: AgentToolRegistry;
 }
 export declare function mountAgent(services: ServiceDef | ServiceDef[], config?: AgentMountConfig): ToolSet;
 //# sourceMappingURL=agent.d.ts.map

package/dist/tools/agent.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"agent.d.ts","sourceRoot":"","sources":["../../src/tools/agent.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAwB,OAAO,EAAE,MAAM,IAAI,CAAC;AAGxD,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAElD,OAAO,EACL,KAAK,WAAW,EAEhB,KAAK,aAAa,EAClB,KAAK,aAAa,EAEnB,MAAM,WAAW,CAAC;AACnB,OAAO,EAAqC,KAAK,UAAU,EAAE,MAAM,SAAS,CAAC;AAC7E,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,gBAAgB,CAAC;AAG5D,MAAM,WAAW,YAAY;IAC3B,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;CACxB;AAED,MAAM,WAAW,gBAAgB;IAC/B,OAAO,CAAC,EAAE,YAAY,CAAC;IACvB,qCAAqC;IACrC,KAAK,CAAC,EAAE,aAAa,CAAC;IACtB;;;;OAIG;IACH,SAAS,CAAC,EAAE,aAAa,CAAC;IAC1B,MAAM,CAAC,EAAE,UAAU,CAAC;IACpB,+EAA+E;IAC/E,cAAc,CAAC,EAAE,OAAO,CAAC;IACzB,mEAAmE;IACnE,aAAa,CAAC,EAAE,CAAC,QAAQ,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,KAAK,IAAI,CAAC;IAC5D,+EAA+E;IAC/E,iBAAiB,CAAC,EAAE,OAAO,CAAC;IAC5B,gEAAgE;IAChE,SAAS,CAAC,EAAE,WAAW,CAAC;IACxB,2EAA2E;IAC3E,YAAY,CAAC,EAAE,SAAS,qBAAqB,EAAE,CAAC;CACjD;AAED,wBAAgB,UAAU,CACxB,QAAQ,EAAE,UAAU,GAAG,UAAU,EAAE,EACnC,MAAM,GAAE,gBAAqB,GAC5B,OAAO,CA4ET"}
+{"version":3,"file":"agent.d.ts","sourceRoot":"","sources":["../../src/tools/agent.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAwB,OAAO,EAAE,MAAM,IAAI,CAAC;AAGxD,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAGlD,OAAO,EACL,KAAK,WAAW,EAEhB,KAAK,aAAa,EAClB,KAAK,aAAa,EAGnB,MAAM,WAAW,CAAC;AACnB,OAAO,EAAqC,KAAK,UAAU,EAAE,MAAM,SAAS,CAAC;AAC7E,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,YAAY,CAAC;AACpD,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,gBAAgB,CAAC;AAG5D,MAAM,WAAW,YAAY;IAC3B,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;CACxB;AAED,MAAM,WAAW,gBAAgB;IAC/B,OAAO,CAAC,EAAE,YAAY,CAAC;IACvB,qCAAqC;IACrC,KAAK,CAAC,EAAE,aAAa,CAAC;IACtB;;;;OAIG;IACH,SAAS,CAAC,EAAE,aAAa,CAAC;IAC1B,MAAM,CAAC,EAAE,UAAU,CAAC;IACpB,+EAA+E;IAC/E,cAAc,CAAC,EAAE,OAAO,CAAC;IACzB,mEAAmE;IACnE,aAAa,CAAC,EAAE,CAAC,QAAQ,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,KAAK,IAAI,CAAC;IAC5D,+EAA+E;IAC/E,iBAAiB,CAAC,EAAE,OAAO,CAAC;IAC5B,gEAAgE;IAChE,SAAS,CAAC,EAAE,WAAW,CAAC;IACxB,2EAA2E;IAC3E,YAAY,CAAC,EAAE,SAAS,qBAAqB,EAAE,CAAC;IAChD;;;OAGG;IACH,QAAQ,CAAC,EAAE,iBAAiB,CAAC;CAC9B;AAED,wBAAgB,UAAU,CACxB,QAAQ,EAAE,UAAU,GAAG,UAAU,EAAE,EACnC,MAAM,GAAE,gBAAqB,GAC5B,OAAO,CAyGT"}

package/dist/tools/connections/define.d.ts

@@ -0,0 +1,6 @@
+import type { McpClientConnection, McpClientConnectionConfig, OpenApiConnection, OpenApiConnectionConfig } from './types.js';
+/** Define one external MCP server connection. */
+export declare function defineMcpClientConnection(config: McpClientConnectionConfig): McpClientConnection;
+/** Define one external OpenAPI connection. */
+export declare function defineOpenApiConnection(config: OpenApiConnectionConfig): OpenApiConnection;
+//# sourceMappingURL=define.d.ts.map

package/dist/tools/connections/define.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"define.d.ts","sourceRoot":"","sources":["../../../src/tools/connections/define.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EACV,mBAAmB,EACnB,yBAAyB,EACzB,iBAAiB,EACjB,uBAAuB,EACxB,MAAM,SAAS,CAAC;AAEjB,iDAAiD;AACjD,wBAAgB,yBAAyB,CACvC,MAAM,EAAE,yBAAyB,GAChC,mBAAmB,CAIrB;AAED,8CAA8C;AAC9C,wBAAgB,uBAAuB,CAAC,MAAM,EAAE,uBAAuB,GAAG,iBAAiB,CAI1F"}