@dogpile/sdk 0.1.0

package/dist/runtime/shared.js

@@ -0,0 +1,288 @@
+import { addCost, createReplayTraceBudget, createReplayTraceBudgetStateChanges, createReplayTraceFinalOutput, createReplayTraceProtocolDecision, createReplayTraceRunInputs, createReplayTraceSeed, createRunAccounting, createRunEventLog, createRunMetadata, createRunUsage, createTranscriptLink, emptyCost } from "./defaults.js";
+import { throwIfAborted } from "./cancellation.js";
+import { parseAgentDecision } from "./decisions.js";
+import { generateModelTurn } from "./model.js";
+import { evaluateTerminationStop } from "./termination.js";
+import { createRuntimeToolExecutor, executeModelResponseToolRequests, runtimeToolAvailability } from "./tools.js";
+export async function runShared(options) {
+    const runId = createRunId();
+    const events = [];
+    const transcript = [];
+    const protocolDecisions = [];
+    const providerCalls = [];
+    let totalCost = emptyCost();
+    const sharedState = options.protocol.organizationalMemory ?? "";
+    const maxTurns = options.protocol.maxTurns ?? options.agents.length;
+    const activeAgents = options.agents.slice(0, maxTurns);
+    const startedAtMs = nowMs();
+    let stopped = false;
+    let termination;
+    const emit = (event) => {
+        events.push(event);
+        options.emit?.(event);
+    };
+    const recordProtocolDecision = (event, decisionOptions) => {
+        protocolDecisions.push(createReplayTraceProtocolDecision("shared", event, events.length - 1, decisionOptions));
+    };
+    const toolExecutor = createRuntimeToolExecutor({
+        runId,
+        protocol: "shared",
+        tier: options.tier,
+        tools: options.tools,
+        emit(event) {
+            emit(event);
+            recordProtocolDecision(event);
+        },
+        getTrace: () => ({ events, transcript }),
+        ...(options.signal !== undefined ? { abortSignal: options.signal } : {})
+    });
+    const toolAvailability = runtimeToolAvailability(toolExecutor.tools);
+    throwIfAborted(options.signal, options.model.id);
+    for (const agent of activeAgents) {
+        const event = {
+            type: "role-assignment",
+            runId,
+            at: new Date().toISOString(),
+            agentId: agent.id,
+            role: agent.role
+        };
+        emit(event);
+        recordProtocolDecision(event);
+    }
+    if (!stopIfNeeded()) {
+        const providerCallSlots = [];
+        const turnResults = await Promise.all(activeAgents.map(async (agent, index) => {
+            const turn = index + 1;
+            const input = buildSharedInput(options.intent, sharedState, turn);
+            const request = {
+                temperature: options.temperature,
+                ...(options.signal !== undefined ? { signal: options.signal } : {}),
+                metadata: {
+                    runId,
+                    protocol: "shared",
+                    agentId: agent.id,
+                    role: agent.role,
+                    tier: options.tier,
+                    turn,
+                    ...toolAvailability
+                },
+                messages: [
+                    {
+                        role: "system",
+                        content: buildSystemPrompt(agent)
+                    },
+                    {
+                        role: "user",
+                        content: input
+                    }
+                ]
+            };
+            const response = await generateModelTurn({
+                model: options.model,
+                request,
+                runId,
+                agent,
+                input,
+                emit,
+                callId: providerCallIdFor(runId, providerCalls.length + index + 1),
+                onProviderCall(call) {
+                    providerCallSlots[index] = call;
+                }
+            });
+            const decision = parseAgentDecision(response.text);
+            const toolCalls = await executeModelResponseToolRequests({
+                response,
+                executor: toolExecutor,
+                agentId: agent.id,
+                role: agent.role,
+                turn
+            });
+            throwIfAborted(options.signal, options.model.id);
+            return {
+                agent,
+                turn,
+                input,
+                response,
+                decision,
+                toolCalls,
+                turnCost: responseCost(response)
+            };
+        }));
+        providerCalls.push(...providerCallSlots.filter((call) => call !== undefined));
+        for (const result of turnResults) {
+            totalCost = addCost(totalCost, result.turnCost);
+            transcript.push({
+                agentId: result.agent.id,
+                role: result.agent.role,
+                input: result.input,
+                output: result.response.text,
+                ...(result.decision !== undefined ? { decision: result.decision } : {}),
+                ...(result.toolCalls.length > 0 ? { toolCalls: result.toolCalls } : {})
+            });
+            const event = {
+                type: "agent-turn",
+                runId,
+                at: new Date().toISOString(),
+                agentId: result.agent.id,
+                role: result.agent.role,
+                input: result.input,
+                output: result.response.text,
+                ...(result.decision !== undefined ? { decision: result.decision } : {}),
+                cost: totalCost
+            };
+            emit(event);
+            recordProtocolDecision(event, {
+                turn: result.turn,
+                transcriptEntryCount: transcript.length
+            });
+        }
+        stopIfNeeded();
+    }
+    const output = synthesizeSharedOutput(transcript);
+    throwIfAborted(options.signal, options.model.id);
+    const final = {
+        type: "final",
+        runId,
+        at: new Date().toISOString(),
+        output,
+        cost: totalCost,
+        transcript: createTranscriptLink(transcript),
+        ...(termination !== undefined ? { termination } : {})
+    };
+    emit(final);
+    recordProtocolDecision(final, {
+        transcriptEntryCount: transcript.length
+    });
+    const finalEvent = events.at(-1);
+    return {
+        output,
+        eventLog: createRunEventLog(runId, "shared", events),
+        trace: {
+            schemaVersion: "1.0",
+            runId,
+            protocol: "shared",
+            tier: options.tier,
+            modelProviderId: options.model.id,
+            agentsUsed: activeAgents,
+            inputs: createReplayTraceRunInputs({
+                intent: options.intent,
+                protocol: options.protocol,
+                tier: options.tier,
+                modelProviderId: options.model.id,
+                agents: activeAgents,
+                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
+        },
+        transcript,
+        usage: createRunUsage(totalCost),
+        metadata: createRunMetadata({
+            runId,
+            protocol: "shared",
+            tier: options.tier,
+            modelProviderId: options.model.id,
+            agentsUsed: activeAgents,
+            events
+        }),
+        accounting: createRunAccounting({
+            tier: options.tier,
+            ...(options.budget ? { budget: options.budget } : {}),
+            ...(options.terminate ? { termination: options.terminate } : {}),
+            cost: totalCost,
+            events
+        }),
+        cost: totalCost
+    };
+    function stopIfNeeded() {
+        throwIfAborted(options.signal, options.model.id);
+        if (stopped || !options.terminate) {
+            return stopped;
+        }
+        const stopRecord = evaluateTerminationStop(options.terminate, {
+            runId,
+            protocol: "shared",
+            tier: options.tier,
+            cost: totalCost,
+            events,
+            transcript,
+            iteration: transcript.length,
+            elapsedMs: elapsedMs(startedAtMs)
+        });
+        if (!stopRecord) {
+            return false;
+        }
+        stopped = true;
+        termination = stopRecord;
+        if (stopRecord.reason === "budget") {
+            emitBudgetStop(stopRecord);
+        }
+        return true;
+    }
+    function emitBudgetStop(record) {
+        const event = {
+            type: "budget-stop",
+            runId,
+            at: new Date().toISOString(),
+            reason: record.budgetReason ?? "cost",
+            cost: totalCost,
+            iteration: transcript.length,
+            elapsedMs: elapsedMs(startedAtMs),
+            detail: record.detail ?? {}
+        };
+        emit(event);
+        recordProtocolDecision(event, {
+            transcriptEntryCount: transcript.length
+        });
+    }
+}
+function buildSystemPrompt(agent) {
+    const instruction = agent.instructions ? `\nInstructions: ${agent.instructions}` : "";
+    return `You are ${agent.id}, acting as ${agent.role} in a Shared multi-agent protocol. Read the shared state, update it with your best contribution, and preserve useful prior work.${instruction}`;
+}
+function buildSharedInput(intent, sharedState, turn) {
+    const state = sharedState ? sharedState : "(empty)";
+    return `Mission: ${intent}\nShared turn ${turn}: read the shared state and return an improved shared-state update.\n\nShared state:\n${state}`;
+}
+function synthesizeSharedOutput(transcript) {
+    return transcript.map((entry) => `${entry.role}:${entry.agentId} => ${entry.output}`).join("\n");
+}
+function responseCost(response) {
+    return {
+        usd: response.costUsd ?? 0,
+        inputTokens: response.usage?.inputTokens ?? 0,
+        outputTokens: response.usage?.outputTokens ?? 0,
+        totalTokens: response.usage?.totalTokens ?? 0
+    };
+}
+function createRunId() {
+    const random = globalThis.crypto?.randomUUID?.();
+    return random ?? `run-${Date.now().toString(36)}`;
+}
+function nowMs() {
+    return globalThis.performance?.now() ?? Date.now();
+}
+function elapsedMs(startedAtMs) {
+    return Math.max(0, nowMs() - startedAtMs);
+}
+function providerCallIdFor(runId, oneBasedIndex) {
+    return `${runId}:provider-call:${oneBasedIndex}`;
+}
+//# sourceMappingURL=shared.js.map

package/dist/runtime/shared.js.map

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

package/dist/runtime/termination.d.ts

@@ -0,0 +1,77 @@
+import type { BudgetTerminationCondition, ConvergenceTerminationCondition, FirstOfTerminationCondition, FirstOfTerminationConditions, FirstOfTerminationOutput, JudgeTerminationCondition, TerminationStopRecord, TerminationCondition, TerminationDecision, TerminationEvaluationContext } from "../types.js";
+/**
+ * Create a budget termination condition.
+ *
+ * The returned object is JSON-serializable and can be used directly in
+ * `terminate` or composed with {@link firstOf}.
+ */
+export declare function budget(options: Omit<BudgetTerminationCondition, "kind">): BudgetTerminationCondition;
+/**
+ * Create a convergence termination condition.
+ *
+ * The condition fires when the run has produced `stableTurns` sufficiently
+ * similar protocol outputs.
+ */
+export declare function convergence(options: Omit<ConvergenceTerminationCondition, "kind">): ConvergenceTerminationCondition;
+/**
+ * Create a judge termination condition.
+ *
+ * The rubric is stored as serializable configuration so callers can replay or
+ * persist traces without SDK-owned state.
+ */
+export declare function judge(options: Omit<JudgeTerminationCondition, "kind">): JudgeTerminationCondition;
+/**
+ * Compose termination conditions so whichever child fires first wins.
+ *
+ * Conditions are evaluated in the order supplied by the caller. At least one
+ * condition is required so the composite is always meaningful and the public
+ * type remains a non-empty tuple.
+ */
+export declare function firstOf(...conditions: FirstOfTerminationConditions): FirstOfTerminationCondition;
+/**
+ * Evaluate a serializable termination condition against the current run state.
+ *
+ * Budget, convergence, judge, and firstOf conditions are enforced from their
+ * own normalized inputs so one stop class cannot accidentally satisfy another.
+ */
+export declare function evaluateTermination(condition: TerminationCondition, context: TerminationEvaluationContext): TerminationDecision;
+/**
+ * Evaluate an ordered firstOf composition and return the winning child, if any.
+ */
+export declare function evaluateFirstOf(condition: FirstOfTerminationCondition, context: TerminationEvaluationContext): FirstOfTerminationOutput;
+/**
+ * Evaluate a termination condition and return a trace-ready stop record.
+ *
+ * Protocol runners use this helper so the first policy decision that halts a
+ * run is recorded exactly once on the terminal event.
+ */
+export declare function evaluateTerminationStop(condition: TerminationCondition, context: TerminationEvaluationContext): TerminationStopRecord | null;
+/**
+ * Combine independently evaluated termination decisions with SDK precedence.
+ *
+ * Budget caps win over judge decisions, and judge decisions win over
+ * convergence. This keeps simultaneous stops deterministic while preserving
+ * each evaluator's normalized stop reason on the returned decision.
+ */
+export declare function combineTerminationDecisions(decisions: readonly TerminationDecision[]): TerminationDecision;
+/**
+ * Evaluate cost, token, iteration, and timeout caps for a budget condition.
+ */
+export declare function evaluateBudget(condition: BudgetTerminationCondition, context: TerminationEvaluationContext): TerminationDecision;
+/**
+ * Evaluate protocol-level convergence from recent coordination outputs.
+ *
+ * This intentionally ignores budget caps and judge quality state. Budget and
+ * judge conditions can be composed with convergence through `firstOf`, but a
+ * convergence condition itself only reads protocol output signals.
+ */
+export declare function evaluateConvergence(condition: ConvergenceTerminationCondition, context: TerminationEvaluationContext): TerminationDecision;
+/**
+ * Evaluate caller-owned judge state without reading budget or convergence data.
+ *
+ * Explicit accept/reject verdicts always halt. Score-only decisions halt when
+ * they meet `minScore`; when `minScore` is omitted, any score-only decision is
+ * treated as the judge's terminal decision.
+ */
+export declare function evaluateJudge(condition: JudgeTerminationCondition, context: TerminationEvaluationContext): TerminationDecision;
+//# sourceMappingURL=termination.d.ts.map

package/dist/runtime/termination.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"termination.d.ts","sourceRoot":"","sources":["../../src/runtime/termination.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAEV,0BAA0B,EAC1B,+BAA+B,EAC/B,2BAA2B,EAC3B,4BAA4B,EAC5B,wBAAwB,EAGxB,yBAAyB,EAGzB,qBAAqB,EAErB,oBAAoB,EACpB,mBAAmB,EACnB,4BAA4B,EAE7B,MAAM,aAAa,CAAC;AAErB;;;;;GAKG;AACH,wBAAgB,MAAM,CAAC,OAAO,EAAE,IAAI,CAAC,0BAA0B,EAAE,MAAM,CAAC,GAAG,0BAA0B,CAKpG;AAED;;;;;GAKG;AACH,wBAAgB,WAAW,CAAC,OAAO,EAAE,IAAI,CAAC,+BAA+B,EAAE,MAAM,CAAC,GAAG,+BAA+B,CAKnH;AAED;;;;;GAKG;AACH,wBAAgB,KAAK,CAAC,OAAO,EAAE,IAAI,CAAC,yBAAyB,EAAE,MAAM,CAAC,GAAG,yBAAyB,CAKjG;AAED;;;;;;GAMG;AACH,wBAAgB,OAAO,CAAC,GAAG,UAAU,EAAE,4BAA4B,GAAG,2BAA2B,CAShG;AAED;;;;;GAKG;AACH,wBAAgB,mBAAmB,CACjC,SAAS,EAAE,oBAAoB,EAC/B,OAAO,EAAE,4BAA4B,GACpC,mBAAmB,CAWrB;AAED;;GAEG;AACH,wBAAgB,eAAe,CAC7B,SAAS,EAAE,2BAA2B,EACtC,OAAO,EAAE,4BAA4B,GACpC,wBAAwB,CAuB1B;AAED;;;;;GAKG;AACH,wBAAgB,uBAAuB,CACrC,SAAS,EAAE,oBAAoB,EAC/B,OAAO,EAAE,4BAA4B,GACpC,qBAAqB,GAAG,IAAI,CA2B9B;AAED;;;;;;GAMG;AACH,wBAAgB,2BAA2B,CACzC,SAAS,EAAE,SAAS,mBAAmB,EAAE,GACxC,mBAAmB,CAcrB;AAED;;GAEG;AACH,wBAAgB,cAAc,CAC5B,SAAS,EAAE,0BAA0B,EACrC,OAAO,EAAE,4BAA4B,GACpC,mBAAmB,CAyBrB;AAED;;;;;;GAMG;AACH,wBAAgB,mBAAmB,CACjC,SAAS,EAAE,+BAA+B,EAC1C,OAAO,EAAE,4BAA4B,GACpC,mBAAmB,CA4BrB;AAED;;;;;;GAMG;AACH,wBAAgB,aAAa,CAC3B,SAAS,EAAE,yBAAyB,EACpC,OAAO,EAAE,4BAA4B,GACpC,mBAAmB,CAoBrB"}