stitchkit 0.102.0 → 0.103.1

package/dist/entrypoints/agent-runtime/realtime.js

@@ -0,0 +1,159 @@
+import"../../index-n53mswt3.js";
+import"../../index-pw99k9h5.js";
+import"../../index-4s0fep5q.js";
+import"../../index-814xpr6d.js";
+import"../../index-8kzct1d6.js";
+import"../../index-mnkk1ffz.js";
+import"../../index-n5yqxd3d.js";
+import {
+  agentControlRealtimeContract2
+} from "../../index-20yvtn9a.js";
+import"../../index-h97tqqp1.js";
+import {
+  createAgentHarnessControlServer2
+} from "../../index-jn9g8xdt.js";
+import {
+  bindRealtimeServer2
+} from "../../index-qapzv4p5.js";
+import"../../index-vgkbcnkc.js";
+
+// src/agent-runtime/harness-realtime.ts
+function bindAgentHarnessRealtime(harness, handle, config) {
+  const control = createAgentHarnessControlServer2(harness, config);
+  const realtime = bindRealtimeServer2(agentControlRealtimeContract2, handle);
+  const cleanups = new Set;
+  const maxPending = config.maxPendingRequests ?? 32;
+  const authTimeout = config.authorizationTimeoutMs ?? 1e4;
+  for (const [name, value] of Object.entries({ maxPending, authTimeout })) {
+    if (!Number.isSafeInteger(value) || value < 1)
+      throw new TypeError(`${name} must be a positive safe integer`);
+  }
+  const unsubscribe = realtime.onConnection(({ raw, events }) => {
+    let closed = false;
+    const pending = new Set;
+    const report = (error) => {
+      try {
+        if (config.onError)
+          config.onError(error);
+        else
+          console.error("[stitchkit] agent control authorization failed", error);
+      } catch (observerError) {
+        console.error("[stitchkit] agent control error observer failed", {
+          error,
+          observerError
+        });
+      }
+    };
+    const authorize = async (request) => {
+      let timer;
+      const abort = new AbortController;
+      try {
+        return await Promise.race([
+          Promise.resolve().then(() => config.authorize({ identity: raw.data, request, signal: abort.signal })),
+          new Promise((_resolve, reject) => {
+            timer = setTimeout(() => reject(new Error("Agent authorization timed out")), authTimeout);
+          })
+        ]);
+      } catch (error) {
+        report(error);
+        return null;
+      } finally {
+        abort.abort();
+        if (timer !== undefined)
+          clearTimeout(timer);
+      }
+    };
+    const connection = control.connect({
+      id: raw.id,
+      async deliver(delivery) {
+        const allowed = await authorize({
+          schemaVersion: 1,
+          requestId: crypto.randomUUID(),
+          operation: "snapshot",
+          conversationId: delivery.event.conversationId
+        });
+        if (!allowed) {
+          await connection.request({
+            schemaVersion: 1,
+            requestId: crypto.randomUUID(),
+            operation: "detach",
+            conversationId: delivery.event.conversationId
+          });
+          return;
+        }
+        if (!closed)
+          events.emit("agent:delivery", delivery);
+      },
+      onOverflow(delivery) {
+        events.emit("agent:delivery", delivery);
+        raw.disconnect(true);
+      }
+    });
+    const offRequest = events.on("agent:control", (request, ack) => {
+      const fail = (code, message) => ({
+        schemaVersion: 1,
+        requestId: request.requestId,
+        outcome: "error",
+        error: { code, message }
+      });
+      if (request.operation === "detach") {
+        for (const entry of pending)
+          if (entry.conversationId === request.conversationId)
+            entry.cancelled = true;
+        connection.request(request);
+      }
+      if (pending.size >= maxPending) {
+        ack(fail("REQUEST_CAPACITY", "Too many agent requests are pending"));
+        return;
+      }
+      const entry = { conversationId: request.conversationId, cancelled: false };
+      pending.add(entry);
+      const execute = async () => {
+        const allowed = await authorize(request);
+        if (entry.cancelled)
+          return fail("REQUEST_CANCELLED", "Agent request was detached");
+        if (!allowed || closed) {
+          if (!allowed)
+            await connection.request({
+              schemaVersion: 1,
+              requestId: crypto.randomUUID(),
+              operation: "detach",
+              conversationId: request.conversationId
+            });
+          return {
+            schemaVersion: 1,
+            requestId: request.requestId,
+            outcome: "error",
+            error: { code: "ACCESS_DENIED", message: "Agent access denied" }
+          };
+        }
+        return connection.request(request.operation === "submit" || request.operation === "respond-approval" ? { ...request, context: allowed.context } : request);
+      };
+      execute().then(ack).catch(report).finally(() => {
+        pending.delete(entry);
+      });
+    });
+    const close = () => {
+      if (closed)
+        return;
+      closed = true;
+      offRequest();
+      raw.off("disconnect", close);
+      connection.close();
+      cleanups.delete(close);
+    };
+    raw.on("disconnect", close);
+    cleanups.add(close);
+  });
+  return {
+    close() {
+      unsubscribe();
+      for (const close of cleanups)
+        close();
+      control.close();
+    }
+  };
+}
+export {
+  bindAgentHarnessRealtime
+};

package/dist/entrypoints/agent-runtime/testing.d.ts

@@ -1,4 +1,5 @@
 export { type AgentFaultStep, AgentFaultStepSchema, createFaultProviderServer, createReplayAgentProvider, defineAgentFaultPlan, } from '../../agent-runtime/fault-bench.js';
+export { inspectAgentRun } from '../../agent-runtime/run-assertions.js';
 export { type AgentStoreConformanceConfig, type AgentStoreConformanceContext, runAgentStoreConformance, } from '../../agent-runtime/store-conformance.js';
 export { type AgentRaceBarrier, type AgentRaceDriver, type AgentRaceTrace, type AgentRaceTraceEntry, createAgentRaceBarrier, createAgentRaceDriver, createAgentRaceTrace, } from '../../agent-runtime/testing.js';
 //# sourceMappingURL=testing.d.ts.map

package/dist/entrypoints/agent-runtime/testing.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"testing.d.ts","sourceRoot":"","sources":["../../../src/entrypoints/agent-runtime/testing.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,KAAK,cAAc,EACnB,oBAAoB,EACpB,yBAAyB,EACzB,yBAAyB,EACzB,oBAAoB,GACrB,MAAM,iCAAiC,CAAC;AACzC,OAAO,EACL,KAAK,2BAA2B,EAChC,KAAK,4BAA4B,EACjC,wBAAwB,GACzB,MAAM,uCAAuC,CAAC;AAC/C,OAAO,EACL,KAAK,gBAAgB,EACrB,KAAK,eAAe,EACpB,KAAK,cAAc,EACnB,KAAK,mBAAmB,EACxB,sBAAsB,EACtB,qBAAqB,EACrB,oBAAoB,GACrB,MAAM,6BAA6B,CAAC"}
+{"version":3,"file":"testing.d.ts","sourceRoot":"","sources":["../../../src/entrypoints/agent-runtime/testing.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,KAAK,cAAc,EACnB,oBAAoB,EACpB,yBAAyB,EACzB,yBAAyB,EACzB,oBAAoB,GACrB,MAAM,iCAAiC,CAAC;AACzC,OAAO,EAAE,eAAe,EAAE,MAAM,oCAAoC,CAAC;AACrE,OAAO,EACL,KAAK,2BAA2B,EAChC,KAAK,4BAA4B,EACjC,wBAAwB,GACzB,MAAM,uCAAuC,CAAC;AAC/C,OAAO,EACL,KAAK,gBAAgB,EACrB,KAAK,eAAe,EACpB,KAAK,cAAc,EACnB,KAAK,mBAAmB,EACxB,sBAAsB,EACtB,qBAAqB,EACrB,oBAAoB,GACrB,MAAM,6BAA6B,CAAC"}

package/dist/entrypoints/agent-runtime/testing.js

@@ -1,9 +1,12 @@
 import {
   AgentMessageSchema2,
-  AgentRunSchema2
+  AgentRunSchema2,
+  AgentSnapshotSchema2
 } from "../../index-8kzct1d6.js";
 import {
-  decodeAgentConversationArchive2
+  decodeAgentConversationArchive2,
+  createToolChronology,
+  advanceToolChronology
 } from "../../index-r5hsgkz5.js";
 import"../../index-ssmd41kh.js";
 import {
@@ -151,6 +154,67 @@ function createReplayAgentProvider(input) {
     calls: (modelId) => calls.get(modelId) ?? 0
   };
 }
+// src/agent-runtime/run-assertions.ts
+function continuedCalls(snapshot, run) {
+  let chronology = createToolChronology();
+  const calls = [];
+  for (const message of snapshot.messages) {
+    if (message.role === "user" && chronology.pending === 0)
+      chronology = createToolChronology();
+    if (message.conversationId !== run.conversationId || !["assistant", "tool"].includes(message.role))
+      continue;
+    const next = advanceToolChronology(chronology, message.parts);
+    if (!next)
+      continue;
+    if (message.role === "tool" && run.inputMessageIds.includes(message.id)) {
+      for (const part of message.parts) {
+        if (part.type !== "tool-approval-response" || !part.approved)
+          continue;
+        const callId = next.approvals.get(part.approvalId);
+        const call = callId === undefined ? undefined : next.calls.get(callId);
+        if (callId !== undefined && call?.phase === "approved")
+          calls.push({ callId, toolName: call.toolName });
+      }
+    }
+    chronology = next;
+  }
+  return calls;
+}
+function inspectAgentRun(rawSnapshot, runId) {
+  const snapshot = AgentSnapshotSchema2.parse(rawSnapshot);
+  const run = snapshot.runs.find((candidate) => candidate.id === runId);
+  if (!run)
+    throw new Error(`Agent run ${runId} is absent from the snapshot`);
+  const parts = snapshot.messages.filter((message) => message.runId === runId && ["assistant", "tool"].includes(message.role)).flatMap((message) => message.parts);
+  const results = parts.filter((part) => part.type === "tool-result");
+  const calls = [
+    ...parts.filter((part) => part.type === "tool-call"),
+    ...continuedCalls(snapshot, run).filter((call) => results.some((result) => result.callId === call.callId && result.toolName === call.toolName))
+  ];
+  const fail = (message) => {
+    throw new Error(`Agent run ${runId}: ${message}`);
+  };
+  return {
+    run,
+    completed() {
+      const pending = parts.some((part) => part.type === "tool-approval-request" && !parts.some((response) => response.type === "tool-approval-response" && response.approvalId === part.approvalId));
+      if (run.state !== "completed" || run.terminalReason !== "success" || pending)
+        fail(`expected completed output; received ${run.state}/${run.terminalReason ?? "pending"}${pending ? " with pending approval" : ""}`);
+    },
+    calledTool(name) {
+      if (!calls.some((call) => call.toolName === name))
+        fail(`expected tool call ${name}`);
+    },
+    notCalledTool(name) {
+      if (calls.some((call) => call.toolName === name))
+        fail(`unexpected tool call ${name}`);
+    },
+    toolSucceeded(name) {
+      if (!calls.some((call) => call.toolName === name && results.some((result) => result.callId === call.callId && result.toolName === name && result.outcome === "success")))
+        fail(`expected successful result for tool ${name}`);
+    }
+  };
+}
 // src/agent-runtime/store-conformance-support.ts
 function userMessage(conversationId, id) {
   return AgentMessageSchema2.parse({
@@ -1110,5 +1174,6 @@ export {
   createFaultProviderServer,
   createReplayAgentProvider,
   defineAgentFaultPlan,
+  inspectAgentRun,
   runAgentStoreConformance
 };

package/dist/entrypoints/agent-runtime.js

@@ -89,7 +89,6 @@ import {
   registerDeferredToolCatalog,
   deferredToolCatalog,
   repairedSearchCall,
-  createAgentRuntimeEventSink2,
   projectAgentHistoryDetailed2,
   projectAgentHistory2,
   ModelInvocationTraceSchema2,
@@ -111,35 +110,27 @@ import {
   agentGoalStateSlot2,
   agentTodoStateSlot2,
   createAgentRuntime2
-} from "../index-zs4ms3th.js";
+} from "../index-z3pqcy7r.js";
 import {
   AgentConversationSummarySchema2,
   AgentConversationPageSchema2,
   AgentConversationMessagePageSchema2
 } from "../index-kqnd6a85.js";
-import {
-  DURABILITY_STEP_EVENT_KIND2,
-  StepResultDecodeError2,
-  StepResultNotSerializableError2,
-  StepAbortedError2,
-  ParkRecordDecodeError2,
-  ParkAbortedError2
-} from "../index-a9pd417t.js";
+import"../index-nggfa2yn.js";
 import"../index-n53mswt3.js";
 import"../index-b2bz0kdm.js";
 import {
   createTraceContext2,
   childSpan2
-} from "../index-hby4qhax.js";
+} from "../index-yex7eg1v.js";
 import"../index-9pw0a51a.js";
 import"../index-ct75c3at.js";
 import"../index-7z9ym7t8.js";
-import"../index-dvwj1f43.js";
-import"../index-n9tyz8z3.js";
+import"../index-0efgsyav.js";
+import"../index-kgmh97hf.js";
 import {
-  mountAgent2,
-  buildToolManifest2
-} from "../index-xkhk5d6g.js";
+  mountAgent2
+} from "../index-xgc94hy6.js";
 import {
   createBoundedSinkManager
 } from "../index-h97tqqp1.js";
@@ -177,6 +168,14 @@ import {
   defineModelRegistry2,
   validateAgentModelSnapshot2
 } from "../index-nx6eazt0.js";
+import {
+  DURABILITY_STEP_EVENT_KIND2,
+  StepResultDecodeError2,
+  StepResultNotSerializableError2,
+  StepAbortedError2,
+  ParkRecordDecodeError2,
+  ParkAbortedError2
+} from "../index-5vyd0fkb.js";
 import {
   AgentSandboxRestrictionSchema2,
   AgentSandboxGradeSchema2,
@@ -188,8 +187,14 @@ import {
 import {
   createMemoryAgentRuntimeStore2
 } from "../index-adhgd4pe.js";
-import"../index-ewbaywk5.js";
-import"../index-r1z0rd9c.js";
+import {
+  createAgentRuntimeEventSink2
+} from "../index-vgkbcnkc.js";
+import {
+  buildToolManifest2
+} from "../index-860vjkgm.js";
+import"../index-x1dkwx5x.js";
+import"../index-7n68nmc6.js";
 import {
   defineRuntimeTool2,
   executableAgentRuntimeTools

package/dist/entrypoints/application/diagnostic-journal.d.ts

@@ -18,4 +18,5 @@
  * → ADR 0156.
  */
 export { createDiagnosticJournal } from '../../application/diagnostic-journal.js';
+export { type DiagnosticJournalReaderConfig, readDiagnosticJournal, } from '../../application/diagnostic-journal-reader.js';
 //# sourceMappingURL=diagnostic-journal.d.ts.map

package/dist/entrypoints/application/diagnostic-journal.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"diagnostic-journal.d.ts","sourceRoot":"","sources":["../../../src/entrypoints/application/diagnostic-journal.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AACH,OAAO,EAAE,uBAAuB,EAAE,MAAM,sCAAsC,CAAC"}
+{"version":3,"file":"diagnostic-journal.d.ts","sourceRoot":"","sources":["../../../src/entrypoints/application/diagnostic-journal.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AACH,OAAO,EAAE,uBAAuB,EAAE,MAAM,sCAAsC,CAAC;AAC/E,OAAO,EACL,KAAK,6BAA6B,EAClC,qBAAqB,GACtB,MAAM,6CAA6C,CAAC"}