@vauban-org/agent-sdk 0.17.3 → 1.0.0

package/src/loop/sdk-loop.ts

@@ -45,9 +45,6 @@ import type { RenewalManager } from "../permissions/renewal-manager.js";
 import type { AgentTool, ToolRegistry } from "../tools/types.js";
 
 export type SdkToolRegistry = ToolRegistry;
-/** @deprecated Use AgentTool from "@vauban-org/agent-sdk" directly. */
-export type SdkToolEntry = AgentTool;
-
 // ─── Capability annotation on tools ────────────────────────────────────────
 
 export interface AgentToolCapabilityMarker {
@@ -252,7 +249,7 @@ class SdkAgentLoopImpl {
         }
 
         const toolUses = response.content.filter(
-          (b): b is Anthropic.Messages.ToolUseBlock => b.type === "tool_use",
+          (b): b is Anthropic.Messages.ToolUseBlock => b.type === "tool_use"
         );
 
         if (toolUses.length === 0) {
@@ -362,7 +359,7 @@ class SdkAgentLoopImpl {
 
   private async authoriseCall(
     call: Anthropic.Messages.ToolUseBlock,
-    budgetUsedUsd: number,
+    budgetUsedUsd: number
   ): Promise<"allow" | "deny" | "capability_denied" | "cancelled"> {
     const tool = this.config.tools.get(call.name);
     if (!tool) return "deny";
@@ -414,7 +411,7 @@ class SdkAgentLoopImpl {
 
   private async awaitApproval(
     tool: AgentTool,
-    args: unknown,
+    args: unknown
   ): Promise<boolean> {
     const channel = this.config.approvalChannel;
     if (!channel) return false;
@@ -480,7 +477,7 @@ function cryptoRandomId(): string {
 }
 
 function extractText(
-  content: readonly Anthropic.Messages.ContentBlock[],
+  content: readonly Anthropic.Messages.ContentBlock[]
 ): string {
   return content
     .filter((b): b is Anthropic.Messages.TextBlock => b.type === "text")
@@ -490,7 +487,7 @@ function extractText(
 
 function safeStringify(v: unknown): string {
   try {
-    return typeof v === "string" ? v : (JSON.stringify(v) ?? "null");
+    return typeof v === "string" ? v : JSON.stringify(v) ?? "null";
   } catch {
     return "[unserialisable]";
   }

package/src/orchestration/ooda/run-step-persistence.ts

@@ -15,10 +15,28 @@
  * @public
  */
 
-import { computeLeafHash } from "@vauban-org/proof-core";
 import type { DbClient } from "../../tracking/agent-run-tracker.js";
 import type { OODAPhaseKind } from "./types.js";
 
+// Lazy singleton — proof-core is an optional peerDep; SHA-256 fallback when absent
+type LeafHashFn = (payload: Record<string, unknown>) => string;
+let _computeLeafHash: LeafHashFn | null = null;
+
+async function getComputeLeafHash(): Promise<LeafHashFn> {
+  if (_computeLeafHash !== null) return _computeLeafHash;
+  try {
+    const mod = await import("@vauban-org/proof-core") as { computeLeafHash: LeafHashFn };
+    _computeLeafHash = mod.computeLeafHash;
+  } catch {
+    // proof-core not installed (optional peer) — fall back to sync node:crypto SHA-256
+    const { createHash } = await import("node:crypto");
+    _computeLeafHash = (payload) =>
+      createHash("sha256").update(JSON.stringify(payload)).digest("hex");
+  }
+  // eslint-disable-next-line @typescript-eslint/no-non-null-assertion
+  return _computeLeafHash!;
+}
+
 export interface InsertRunStepInput {
   type: OODAPhaseKind;
   /** Human-readable phase tag (e.g. "observe", "orient", "decide", "act"). */
@@ -97,6 +115,7 @@ export async function completeRunStep(
     throw new Error("[ooda] completeRunStep: payload must be a plain object");
   }
 
+  const computeLeafHash = await getComputeLeafHash();
   const leafHash = computeLeafHash(payload);
 
   await db.query(

package/src/orchestration/ooda/types.ts

@@ -250,16 +250,10 @@ export interface OODAAgentConfig<
   /**
    * Port dependencies injected at boot (BYOM — plan v6 §3.7).
    *
-   * Optional in SDK 0.17 for backward compatibility.
-   * Will be required in SDK 1.0.
-   *
-   * When `SDK_STRICT_DEPS !== "false"` (default), boot validation throws
-   * `MissingDependencyError` if this field is absent or `deps.llm` is missing.
-   *
-   * @deprecated Omitting `deps` is supported only in legacy mode. Will be required in 1.0.
+   * Required since SDK 1.0. Boot validation throws `MissingDependencyError`
+   * if this field is absent or `deps.llm` is missing.
    */
-  // Will be required in 1.0
-  readonly deps?: OODAAgentDeps;
+  readonly deps: OODAAgentDeps;
 
   readonly phases: {
     readonly observe: PhaseDef<void, TObs>;

package/src/ports/event-bus.ts

@@ -136,24 +136,6 @@ export interface EventBusPort {
     key: string
   ): Promise<void>;
 
-  /**
-   * Subscribe to a stream with a consumer group.
-   *
-   * Returns an unsubscribe function. The handler receives each event after
-   * dedup (based on `event.id`). Implementation MUST:
-   *   1. Create consumer group if it doesn't exist (XGROUP CREATE).
-   *   2. XREADGROUP → handler → XACK.
-   *   3. On 3 consecutive XAUTOCLAIM failures → XADD to DLQ stream.
-   *   4. Extract `traceparent` and set as parent span context.
-   *
-   * @deprecated Prefer the overload returning Subscription for CloudEvent streams.
-   */
-  subscribe(
-    stream: string,
-    consumerGroup: string,
-    handler: (event: CloudEvent) => Promise<void>
-  ): Promise<() => void>;
-
   /**
    * Subscribe to DomainEvents of a specific type.
    *

package/src/testing/contracts/event-bus.contract.ts

@@ -49,31 +49,33 @@ export function eventBusContract(
     const testStream = "vauban.test.contract";
     const testGroup = "test-consumer-group";
 
-    it("publishes and consumes an event", async () => {
+    it("publishes and consumes a domain event", async () => {
       const received: unknown[] = [];
-      const unsub = await port.subscribe(
-        testStream,
-        testGroup,
+      const sub = port.subscribeDomain<{ message: string }>(
+        "tech.vauban.test.event",
         async (event) => {
-          received.push(event.data);
-        }
+          received.push(event.payload);
+        },
+        { groupId: testGroup }
       );
 
-      await port.publish(
+      const testKey = "test-hmac-key-32-bytes-minimum!!";
+      await port.publishWithIdempotency<{ message: string }>(
         {
-          id: "test-event-1",
-          specversion: "1.0",
-          source: "test",
           type: "tech.vauban.test.event",
-          time: new Date().toISOString(),
-          data: { message: "hello" },
+          source: "cc" as const,
+          correlationId: "contract-test-corr-1",
+          idempotencyKey: "contract-test-1",
+          timestamp: new Date().toISOString(),
+          schemaVersion: "1.0.0",
+          payload: { message: "hello" },
         },
-        testStream
+        testKey
       );
 
       // Allow async delivery
       await new Promise((r) => setTimeout(r, 100));
-      await unsub();
+      await sub.unsubscribe();
 
       expect(received.length).toBeGreaterThanOrEqual(1);
     });