@dogpile/sdk 0.4.0 → 0.6.0

package/dist/types.js.map

@@ -1 +1 @@
-{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@dogpile/sdk",
-  "version": "0.4.0",
+  "version": "0.6.0",
   "description": "TypeScript SDK for running multi-agent LLM coordination protocols.",
   "license": "Apache-2.0",
   "type": "module",
@@ -45,6 +45,11 @@
       "import": "./dist/types.js",
       "default": "./dist/types.js"
     },
+    "./runtime/audit": {
+      "types": "./dist/runtime/audit.d.ts",
+      "import": "./dist/runtime/audit.js",
+      "default": "./dist/runtime/audit.js"
+    },
     "./runtime/broadcast": {
       "types": "./dist/runtime/broadcast.d.ts",
       "import": "./dist/runtime/broadcast.js",
@@ -65,11 +70,41 @@
       "import": "./dist/runtime/engine.js",
       "default": "./dist/runtime/engine.js"
     },
+    "./runtime/health": {
+      "types": "./dist/runtime/health.d.ts",
+      "import": "./dist/runtime/health.js",
+      "default": "./dist/runtime/health.js"
+    },
+    "./runtime/introspection": {
+      "types": "./dist/runtime/introspection.d.ts",
+      "import": "./dist/runtime/introspection.js",
+      "default": "./dist/runtime/introspection.js"
+    },
     "./runtime/model": {
       "types": "./dist/runtime/model.d.ts",
       "import": "./dist/runtime/model.js",
       "default": "./dist/runtime/model.js"
     },
+    "./runtime/provenance": {
+      "types": "./dist/runtime/provenance.d.ts",
+      "import": "./dist/runtime/provenance.js",
+      "default": "./dist/runtime/provenance.js"
+    },
+    "./runtime/tracing": {
+      "types": "./dist/runtime/tracing.d.ts",
+      "import": "./dist/runtime/tracing.js",
+      "default": "./dist/runtime/tracing.js"
+    },
+    "./runtime/metrics": {
+      "types": "./dist/runtime/metrics.d.ts",
+      "import": "./dist/runtime/metrics.js",
+      "default": "./dist/runtime/metrics.js"
+    },
+    "./runtime/redaction": {
+      "types": "./dist/runtime/redaction.d.ts",
+      "import": "./dist/runtime/redaction.js",
+      "default": "./dist/runtime/redaction.js"
+    },
     "./providers/openai-compatible": {
       "types": "./dist/providers/openai-compatible.d.ts",
       "import": "./dist/providers/openai-compatible.js",
@@ -142,22 +177,30 @@
     "src/types/replay.ts",
     "src/browser/index.ts",
     "src/providers/openai-compatible.ts",
+    "src/runtime/audit.ts",
     "src/runtime/broadcast.ts",
     "src/runtime/cancellation.ts",
     "src/runtime/coordinator.ts",
     "src/runtime/decisions.ts",
     "src/runtime/defaults.ts",
     "src/runtime/engine.ts",
+    "src/runtime/health.ts",
     "src/runtime/ids.ts",
+    "src/runtime/introspection.ts",
     "src/runtime/logger.ts",
+    "src/runtime/metrics.ts",
     "src/runtime/model.ts",
+    "src/runtime/provenance.ts",
+    "src/runtime/redaction.ts",
     "src/runtime/retry.ts",
+    "src/runtime/sanitization.ts",
     "src/runtime/sequential.ts",
     "src/runtime/shared.ts",
     "src/runtime/termination.ts",
     "src/runtime/tools.ts",
     "src/runtime/tools/built-in.ts",
     "src/runtime/tools/vercel-ai.ts",
+    "src/runtime/tracing.ts",
     "src/runtime/wrap-up.ts",
     "src/runtime/validation.ts",
     "README.md",
@@ -184,6 +227,8 @@
     "verify": "pnpm run package:identity && pnpm run build && pnpm run package:artifacts && pnpm run quickstart:smoke -- --skip-build && pnpm run typecheck && pnpm run test"
   },
   "devDependencies": {
+    "@opentelemetry/api": "1.9.1",
+    "@opentelemetry/sdk-trace-base": "2.7.1",
     "@types/node": "^25.6.0",
     "ai": "^6.0.168",
     "typescript": "^6.0.3",

package/src/index.ts

@@ -12,6 +12,8 @@ export { consoleLogger, loggerFromEvents, noopLogger } from "./runtime/logger.js
 export type { Logger, LoggerFromEventsOptions, LogLevel } from "./runtime/logger.js";
 export { DEFAULT_RETRYABLE_DOGPILE_CODES, withRetry } from "./runtime/retry.js";
 export type { RetryAttemptInfo, RetryJitterMode, RetryPolicy } from "./runtime/retry.js";
+export { DOGPILE_SPAN_NAMES } from "./runtime/tracing.js";
+export type { DogpileSpan, DogpileSpanOptions, DogpileTracer } from "./runtime/tracing.js";
 export { DogpileError } from "./types.js";
 export type {
   OpenAICompatibleChatCompletionChoice,
@@ -79,6 +81,7 @@ export type {
   AgentSpec,
   AgentDecision,
   AgentParticipation,
+  AnomalyCode,
   BroadcastContribution,
   BroadcastEvent,
   BroadcastProtocolConfig,
@@ -102,6 +105,7 @@ export type {
   EngineOptions,
   RunCallOptions,
   FinalEvent,
+  HealthAnomaly,
   FirstOfTerminationCondition,
   FirstOfTerminationConditions,
   FirstOfTerminationInput,
@@ -150,6 +154,7 @@ export type {
   RunEvaluator,
   RunEventLog,
   RunEvent,
+  RunHealthSummary,
   RunMetadata,
   RunResult,
   RunUsage,

package/src/providers/openai-compatible.ts

@@ -9,6 +9,7 @@ import type {
   ModelRequest,
   ModelResponse
 } from "../types.js";
+import { sanitizeProviderJsonValue, sanitizeProviderResponseHeaders } from "../runtime/sanitization.js";
 
 const defaultBaseURL = "https://api.openai.com/v1";
 const defaultPath = "/chat/completions";
@@ -91,6 +92,7 @@ export function createOpenAICompatibleProvider(options: OpenAICompatibleProvider
 
   return {
     id: providerId,
+    modelId: options.model,
     metadata: { locality: resolvedLocality },
     async generate(request: ModelRequest): Promise<ModelResponse> {
       let response: Response;
@@ -419,6 +421,8 @@ function responseMetadata(response: OpenAICompatibleChatCompletionResponse): Jso
 function createProviderError(response: Response, payload: unknown, providerId: string): DogpileError {
   const code = codeForStatus(response.status);
   const timeoutSource = code === "provider-timeout" ? { source: "provider" as const } : {};
+  const responseHeaders = sanitizeProviderResponseHeaders(response.headers);
+  const sanitizedPayload = sanitizeProviderJsonValue(payload);
   return new DogpileError({
     code,
     message: providerResponseErrorMessage(response, payload),
@@ -428,7 +432,8 @@ function createProviderError(response: Response, payload: unknown, providerId: s
       statusCode: response.status,
       statusText: response.statusText,
       ...timeoutSource,
-      response: isJsonValue(payload) ? payload : undefined
+      responseHeaders,
+      response: sanitizedPayload
     })
   });
 }

package/src/runtime/audit.ts

@@ -0,0 +1,121 @@
+import type { Protocol, Tier, Trace } from "../types.js";
+import type { BudgetStopEvent, FinalEvent, SubRunCompletedEvent, TurnEvent } from "../types/events.js";
+
+export type AuditOutcomeStatus = "completed" | "budget-stopped" | "aborted";
+
+export interface AuditOutcome {
+  readonly status: AuditOutcomeStatus;
+  readonly terminationCode?: string;
+}
+
+export interface AuditCost {
+  readonly usd: number;
+  readonly inputTokens: number;
+  readonly outputTokens: number;
+}
+
+export interface AuditAgentRecord {
+  readonly id: string;
+  readonly role: string;
+  readonly turnCount: number;
+}
+
+export interface AuditRecord {
+  readonly auditSchemaVersion: "1";
+  readonly runId: string;
+  readonly intent: string;
+  readonly startedAt: string;
+  readonly completedAt: string;
+  readonly protocol: Protocol;
+  readonly tier: Tier;
+  readonly modelProviderId: string;
+  readonly agentCount: number;
+  readonly turnCount: number;
+  readonly outcome: AuditOutcome;
+  readonly cost: AuditCost;
+  readonly agents: readonly AuditAgentRecord[];
+  readonly childRunIds?: readonly string[];
+}
+
+/**
+ * Derive a versioned, schema-stable audit record from a completed run trace.
+ *
+ * Pure function - no side effects, no I/O, no storage access. Deterministic:
+ * given the same trace, always produces the same AuditRecord.
+ *
+ * @param trace - Completed run trace (from RunResult.trace or a stored/replayed trace).
+ */
+export function createAuditRecord(trace: Trace): AuditRecord {
+  const finalEvent = trace.events.find((event): event is FinalEvent => event.type === "final");
+  const budgetStopEvent = trace.events.find((event): event is BudgetStopEvent => event.type === "budget-stop");
+
+  const outcome: AuditOutcome = budgetStopEvent
+    ? { status: "budget-stopped", terminationCode: budgetStopEvent.reason }
+    : finalEvent
+      ? { status: "completed" }
+      : { status: "aborted" };
+
+  const lastTurnCost = [...trace.events]
+    .reverse()
+    .find((event): event is TurnEvent => event.type === "agent-turn")?.cost;
+  const costSource = finalEvent?.cost ?? budgetStopEvent?.cost ?? lastTurnCost;
+  const cost: AuditCost = {
+    usd: costSource?.usd ?? 0,
+    inputTokens: costSource?.inputTokens ?? 0,
+    outputTokens: costSource?.outputTokens ?? 0
+  };
+
+  const turnEvents = trace.events.filter((event): event is TurnEvent => event.type === "agent-turn");
+  const agentTurnMap = new Map<string, { role: string; count: number }>();
+  for (const event of turnEvents) {
+    const existing = agentTurnMap.get(event.agentId);
+    if (existing !== undefined) {
+      existing.count++;
+    } else {
+      agentTurnMap.set(event.agentId, { role: event.role, count: 1 });
+    }
+  }
+
+  const agents: AuditAgentRecord[] = [...agentTurnMap.entries()]
+    .map(([id, { role, count }]) => ({ id, role, turnCount: count }))
+    .sort((a, b) => a.id.localeCompare(b.id));
+
+  const childRunIds = trace.events
+    .filter((event): event is SubRunCompletedEvent => event.type === "sub-run-completed")
+    .map((event) => event.childRunId);
+
+  const startedAt = eventStartedAt(trace.events[0]);
+
+  return {
+    auditSchemaVersion: "1",
+    runId: trace.runId,
+    intent: trace.inputs.intent,
+    startedAt,
+    completedAt: trace.finalOutput.completedAt,
+    protocol: trace.protocol,
+    tier: trace.tier,
+    modelProviderId: trace.modelProviderId,
+    agentCount: agentTurnMap.size,
+    turnCount: turnEvents.length,
+    outcome,
+    cost,
+    agents,
+    ...(childRunIds.length > 0 ? { childRunIds } : {})
+  };
+}
+
+function eventStartedAt(event: Trace["events"][number] | undefined): string {
+  if (event === undefined) {
+    return "";
+  }
+
+  if ("at" in event) {
+    return event.at;
+  }
+
+  if ("startedAt" in event) {
+    return event.startedAt;
+  }
+
+  return "";
+}

package/src/runtime/broadcast.ts

@@ -17,6 +17,7 @@ import type {
   TerminationCondition,
   TerminationStopRecord,
   Tier,
+  Trace,
   TranscriptEntry
 } from "../types.js";
 import { createRunId, elapsedMs, nowMs, providerCallIdFor } from "./ids.js";
@@ -35,6 +36,7 @@ import {
   createTranscriptLink,
   emptyCost
 } from "./defaults.js";
+import { computeHealth, DEFAULT_HEALTH_THRESHOLDS } from "./health.js";
 import { throwIfAborted } from "./cancellation.js";
 import { parseAgentDecision } from "./decisions.js";
 import { generateModelTurn } from "./model.js";
@@ -55,9 +57,12 @@ interface BroadcastRunOptions {
   readonly signal?: AbortSignal;
   readonly terminate?: TerminationCondition;
   readonly wrapUpHint?: DogpileOptions["wrapUpHint"];
+  readonly maxConcurrentAgentTurns?: number;
   readonly emit?: (event: RunEvent) => void;
 }
 
+const DEFAULT_MAX_CONCURRENT_AGENT_TURNS = 4;
+
 export async function runBroadcast(options: BroadcastRunOptions): Promise<RunResult> {
   const runId = createRunId();
   const events: RunEvent[] = [];
@@ -129,81 +134,92 @@ export async function runBroadcast(options: BroadcastRunOptions): Promise<RunRes
     }
 
     const providerCallSlots: ReplayTraceProviderCall[] = [];
-    const turnResults = await Promise.all(
-      options.agents.map(async (agent, agentIndex) => {
-        const turn = transcript.length + agentIndex + 1;
-        const input = buildBroadcastInput(options.intent, round, maxRounds, firstRoundContributions);
-        const request: ModelRequest = {
-          temperature: options.temperature,
-          ...(options.signal !== undefined ? { signal: options.signal } : {}),
-          metadata: {
-            runId,
-            protocol: "broadcast",
-            agentId: agent.id,
-            role: agent.role,
-            tier: options.tier,
-            round,
-            ...toolAvailability
-          },
-          messages: wrapUpHint.inject(
-            [
-              {
-                role: "system",
-                content: buildSystemPrompt(agent)
+    const fanout = createFanoutAbortController(options.signal);
+    const turnResults = await (async () => {
+      try {
+        return await mapWithConcurrency(
+          options.agents,
+          options.maxConcurrentAgentTurns ?? DEFAULT_MAX_CONCURRENT_AGENT_TURNS,
+          fanout,
+          async (agent, agentIndex) => {
+            throwIfAborted(fanout.signal, options.model.id);
+            const turn = transcript.length + agentIndex + 1;
+            const input = buildBroadcastInput(options.intent, round, maxRounds, firstRoundContributions);
+            const request: ModelRequest = {
+              temperature: options.temperature,
+              signal: fanout.signal,
+              metadata: {
+                runId,
+                protocol: "broadcast",
+                agentId: agent.id,
+                role: agent.role,
+                tier: options.tier,
+                round,
+                ...toolAvailability
               },
-              {
-                role: "user",
-                content: input
-              }
-            ],
-            {
+              messages: wrapUpHint.inject(
+                [
+                  {
+                    role: "system",
+                    content: buildSystemPrompt(agent)
+                  },
+                  {
+                    role: "user",
+                    content: input
+                  }
+                ],
+                {
+                  runId,
+                  protocol: "broadcast",
+                  cost: totalCost,
+                  events,
+                  transcript,
+                  iteration: transcript.length,
+                  elapsedMs: elapsedMs(startedAtMs)
+                }
+              )
+            };
+            const response = await generateModelTurn({
+              model: options.model,
+              request,
               runId,
-              protocol: "broadcast",
-              cost: totalCost,
-              events,
-              transcript,
-              iteration: transcript.length,
-              elapsedMs: elapsedMs(startedAtMs)
-            }
-          )
-        };
-        const response = await generateModelTurn({
-          model: options.model,
-          request,
-          runId,
-          agent,
-          input,
-          emit,
-          callId: providerCallIdFor(runId, providerCalls.length + agentIndex + 1),
-          onProviderCall(call): void {
-            providerCallSlots[agentIndex] = call;
-          }
-        });
-        const decision = parseAgentDecision(response.text);
-        const toolCalls = await executeModelResponseToolRequests({
-          response,
-          executor: toolExecutor,
-          agentId: agent.id,
-          role: agent.role,
-          turn,
-          metadata: {
-            round
+              agent,
+              input,
+              emit,
+              callId: providerCallIdFor(runId, providerCalls.length + agentIndex + 1),
+              onProviderCall(call): void {
+                providerCallSlots[agentIndex] = call;
+              }
+            });
+            const decision = parseAgentDecision(response.text);
+            const toolCalls = await executeModelResponseToolRequests({
+              response,
+              executor: toolExecutor,
+              agentId: agent.id,
+              role: agent.role,
+              turn,
+              metadata: {
+                round
+              }
+            });
+            throwIfAborted(fanout.signal, options.model.id);
+
+            return {
+              agent,
+              agentIndex,
+              turn,
+              input,
+              response,
+              decision,
+              toolCalls,
+              turnCost: responseCost(response)
+            };
           }
-        });
-        throwIfAborted(options.signal, options.model.id);
-
-        return {
-          agent,
-          agentIndex,
-          turn,
-          input,
-          response,
-          decision,
-          toolCalls,
-          turnCost: responseCost(response)
-        };
-      })
-    );
+        );
+      } finally {
+        fanout.cleanup();
+      }
+    })();
     providerCalls.push(...providerCallSlots.filter((call): call is ReplayTraceProviderCall => call !== undefined));
 
     const contributions: BroadcastContribution[] = [];
@@ -289,45 +305,46 @@ export async function runBroadcast(options: BroadcastRunOptions): Promise<RunRes
     transcriptEntryCount: transcript.length
   });
   const finalEvent = events.at(-1);
+  const trace: Trace = {
+    schemaVersion: "1.0",
+    runId,
+    protocol: "broadcast",
+    tier: options.tier,
+    modelProviderId: options.model.id,
+    agentsUsed: options.agents,
+    inputs: createReplayTraceRunInputs({
+      intent: options.intent,
+      protocol: options.protocol,
+      tier: options.tier,
+      modelProviderId: options.model.id,
+      agents: options.agents,
+      temperature: options.temperature
+    }),
+    budget: createReplayTraceBudget({
+      tier: options.tier,
+      ...(options.budget ? { caps: options.budget } : {}),
+      ...(options.terminate ? { termination: options.terminate } : {})
+    }),
+    budgetStateChanges: createReplayTraceBudgetStateChanges(events),
+    seed: createReplayTraceSeed(options.seed),
+    protocolDecisions,
+    providerCalls,
+    finalOutput: createReplayTraceFinalOutput(output, finalEvent ?? {
+      type: "final",
+      runId,
+      at: "",
+      output,
+      cost: totalCost,
+      transcript: createTranscriptLink(transcript)
+    }),
+    events,
+    transcript
+  };
 
   return {
     output,
     eventLog: createRunEventLog(runId, "broadcast", events),
-    trace: {
-      schemaVersion: "1.0",
-      runId,
-      protocol: "broadcast",
-      tier: options.tier,
-      modelProviderId: options.model.id,
-      agentsUsed: options.agents,
-      inputs: createReplayTraceRunInputs({
-        intent: options.intent,
-        protocol: options.protocol,
-        tier: options.tier,
-        modelProviderId: options.model.id,
-        agents: options.agents,
-        temperature: options.temperature
-      }),
-      budget: createReplayTraceBudget({
-        tier: options.tier,
-        ...(options.budget ? { caps: options.budget } : {}),
-        ...(options.terminate ? { termination: options.terminate } : {})
-      }),
-      budgetStateChanges: createReplayTraceBudgetStateChanges(events),
-      seed: createReplayTraceSeed(options.seed),
-      protocolDecisions,
-      providerCalls,
-      finalOutput: createReplayTraceFinalOutput(output, finalEvent ?? {
-        type: "final",
-        runId,
-        at: "",
-        output,
-        cost: totalCost,
-        transcript: createTranscriptLink(transcript)
-      }),
-      events,
-      transcript
-    },
+    trace,
     transcript,
     usage: createRunUsage(totalCost),
     metadata: createRunMetadata({
@@ -345,7 +362,8 @@ export async function runBroadcast(options: BroadcastRunOptions): Promise<RunRes
       cost: totalCost,
       events
     }),
-    cost: totalCost
+    cost: totalCost,
+    health: computeHealth(trace, DEFAULT_HEALTH_THRESHOLDS)
   };
 
   function stopIfNeeded(): boolean {
@@ -441,3 +459,72 @@ function responseCost(response: ModelResponse): CostSummary {
   };
 }
 
+interface FanoutAbortController {
+  readonly signal: AbortSignal;
+  abort(reason: unknown): void;
+  cleanup(): void;
+}
+
+function createFanoutAbortController(parentSignal: AbortSignal | undefined): FanoutAbortController {
+  const controller = new AbortController();
+  let removeParentListener = (): void => {};
+
+  if (parentSignal?.aborted) {
+    controller.abort(parentSignal.reason);
+  } else if (parentSignal !== undefined) {
+    const abortFromParent = (): void => {
+      controller.abort(parentSignal.reason);
+    };
+    parentSignal.addEventListener("abort", abortFromParent, { once: true });
+    removeParentListener = (): void => {
+      parentSignal.removeEventListener("abort", abortFromParent);
+    };
+  }
+
+  return {
+    signal: controller.signal,
+    abort(reason: unknown): void {
+      if (!controller.signal.aborted) {
+        controller.abort(reason);
+      }
+    },
+    cleanup(): void {
+      removeParentListener();
+    }
+  };
+}
+
+async function mapWithConcurrency<T, R>(
+  items: readonly T[],
+  maxConcurrent: number,
+  fanout: FanoutAbortController,
+  mapper: (item: T, index: number) => Promise<R>
+): Promise<R[]> {
+  if (items.length === 0) {
+    return [];
+  }
+
+  const results: R[] = new Array(items.length);
+  let nextIndex = 0;
+  let firstError: unknown;
+  const workerCount = Math.min(maxConcurrent, items.length);
+
+  await Promise.all(Array.from({ length: workerCount }, async () => {
+    while (nextIndex < items.length && firstError === undefined) {
+      const index = nextIndex;
+      nextIndex += 1;
+      try {
+        results[index] = await mapper(items[index]!, index);
+      } catch (error) {
+        firstError ??= error;
+        fanout.abort(error);
+      }
+    }
+  }));
+
+  if (firstError !== undefined) {
+    throw firstError;
+  }
+
+  return results;
+}