@dogpile/sdk 0.1.0

package/dist/runtime/defaults.js

@@ -0,0 +1,426 @@
+export function normalizeProtocol(protocol) {
+    if (typeof protocol !== "string") {
+        return protocol;
+    }
+    switch (protocol) {
+        case "sequential":
+            return { kind: "sequential", maxTurns: 3 };
+        case "coordinator":
+            return { kind: "coordinator", maxTurns: 3 };
+        case "broadcast":
+            return { kind: "broadcast", maxRounds: 2 };
+        case "shared":
+            return { kind: "shared", maxTurns: 3 };
+    }
+}
+export function defaultAgents() {
+    return [
+        { id: "agent-1", role: "planner", instructions: "Frame the mission and identify the important constraints." },
+        { id: "agent-2", role: "critic", instructions: "Stress-test the previous contribution and improve weak spots." },
+        { id: "agent-3", role: "synthesizer", instructions: "Produce the final useful answer from the accumulated work." }
+    ];
+}
+export function orderAgentsForTemperature(agents, temperature, seed) {
+    if (temperature !== 0) {
+        return agents;
+    }
+    if (seed !== undefined) {
+        return [...agents].sort((left, right) => compareAgentsBySeededSelection(left, right, seed));
+    }
+    return [...agents].sort(compareAgentsByStableIdentity);
+}
+function compareAgentsBySeededSelection(left, right, seed) {
+    const leftScore = deterministicSelectionScore(seed, left);
+    const rightScore = deterministicSelectionScore(seed, right);
+    if (leftScore !== rightScore) {
+        return leftScore - rightScore;
+    }
+    return compareAgentsByStableIdentity(left, right);
+}
+function deterministicSelectionScore(seed, agent) {
+    return stableHash(`${String(seed)}\u0000${agent.id}\u0000${agent.role}\u0000${agent.instructions ?? ""}`);
+}
+function stableHash(input) {
+    let hash = 0x811c9dc5;
+    for (let index = 0; index < input.length; index += 1) {
+        hash ^= input.charCodeAt(index);
+        hash = Math.imul(hash, 0x01000193);
+    }
+    return hash >>> 0;
+}
+function compareAgentsByStableIdentity(left, right) {
+    const idOrder = left.id.localeCompare(right.id);
+    if (idOrder !== 0) {
+        return idOrder;
+    }
+    const roleOrder = left.role.localeCompare(right.role);
+    if (roleOrder !== 0) {
+        return roleOrder;
+    }
+    return (left.instructions ?? "").localeCompare(right.instructions ?? "");
+}
+export function tierTemperature(tier) {
+    switch (tier) {
+        case "fast":
+            return 0;
+        case "balanced":
+            return 0.2;
+        case "quality":
+            return 0.4;
+    }
+}
+export function emptyCost() {
+    return { usd: 0, inputTokens: 0, outputTokens: 0, totalTokens: 0 };
+}
+export function addCost(left, right) {
+    return {
+        usd: left.usd + right.usd,
+        inputTokens: left.inputTokens + right.inputTokens,
+        outputTokens: left.outputTokens + right.outputTokens,
+        totalTokens: left.totalTokens + right.totalTokens
+    };
+}
+export function createTranscriptLink(transcript) {
+    return {
+        kind: "trace-transcript",
+        entryCount: transcript.length,
+        lastEntryIndex: transcript.length === 0 ? null : transcript.length - 1
+    };
+}
+export function createRunEventLog(runId, protocol, events) {
+    return {
+        kind: "run-event-log",
+        runId,
+        protocol,
+        eventTypes: events.map((event) => event.type),
+        eventCount: events.length,
+        events
+    };
+}
+export function createRunUsage(cost) {
+    return {
+        usd: cost.usd,
+        inputTokens: cost.inputTokens,
+        outputTokens: cost.outputTokens,
+        totalTokens: cost.totalTokens
+    };
+}
+export function createRunAccounting(options) {
+    const usage = createRunUsage(options.cost);
+    return {
+        kind: "run-accounting",
+        tier: options.tier,
+        ...(options.budget ? { budget: options.budget } : {}),
+        ...(options.termination ? { termination: options.termination } : {}),
+        usage,
+        cost: options.cost,
+        budgetStateChanges: createReplayTraceBudgetStateChanges(options.events),
+        ...(options.budget?.maxUsd !== undefined
+            ? { usdCapUtilization: options.budget.maxUsd === 0 ? 0 : options.cost.usd / options.budget.maxUsd }
+            : {}),
+        ...(options.budget?.maxTokens !== undefined
+            ? {
+                totalTokenCapUtilization: options.budget.maxTokens === 0 ? 0 : options.cost.totalTokens / options.budget.maxTokens
+            }
+            : {})
+    };
+}
+export function createRunMetadata(options) {
+    const firstEvent = options.events[0];
+    const lastEvent = options.events.at(-1);
+    return {
+        runId: options.runId,
+        protocol: options.protocol,
+        tier: options.tier,
+        modelProviderId: options.modelProviderId,
+        agentsUsed: options.agentsUsed,
+        startedAt: firstEvent?.at ?? "",
+        completedAt: lastEvent?.at ?? ""
+    };
+}
+export function createReplayTraceRunInputs(options) {
+    return {
+        kind: "replay-trace-run-inputs",
+        intent: options.intent,
+        protocol: options.protocol,
+        tier: options.tier,
+        modelProviderId: options.modelProviderId,
+        agents: options.agents,
+        temperature: options.temperature
+    };
+}
+export function createReplayTraceBudget(options) {
+    return {
+        kind: "replay-trace-budget",
+        tier: options.tier,
+        ...(options.caps ? { caps: options.caps } : {}),
+        ...(options.termination ? { termination: options.termination } : {})
+    };
+}
+export function createReplayTraceBudgetStateChanges(events) {
+    return events.flatMap((event, eventIndex) => {
+        switch (event.type) {
+            case "agent-turn":
+            case "broadcast":
+            case "final":
+                return [
+                    {
+                        kind: "replay-trace-budget-state-change",
+                        eventIndex,
+                        eventType: event.type,
+                        at: event.at,
+                        cost: event.cost
+                    }
+                ];
+            case "budget-stop":
+                return [
+                    {
+                        kind: "replay-trace-budget-state-change",
+                        eventIndex,
+                        eventType: event.type,
+                        at: event.at,
+                        cost: event.cost,
+                        iteration: event.iteration,
+                        elapsedMs: event.elapsedMs,
+                        budgetReason: event.reason
+                    }
+                ];
+            case "role-assignment":
+            case "model-request":
+            case "model-response":
+            case "model-output-chunk":
+            case "tool-call":
+            case "tool-result":
+                return [];
+        }
+    });
+}
+export function createReplayTraceSeed(seed) {
+    if (seed === undefined) {
+        return {
+            kind: "replay-trace-seed",
+            source: "none",
+            value: null
+        };
+    }
+    return {
+        kind: "replay-trace-seed",
+        source: "caller",
+        value: seed
+    };
+}
+export function createReplayTraceProtocolDecisions(protocol, events) {
+    return events.map((event, eventIndex) => {
+        return createReplayTraceProtocolDecision(protocol, event, eventIndex);
+    });
+}
+export function createReplayTraceProtocolDecision(protocol, event, eventIndex, options = {}) {
+    const base = {
+        kind: "replay-trace-protocol-decision",
+        eventIndex,
+        eventType: event.type,
+        protocol,
+        decision: options.decision ?? defaultProtocolDecision(event),
+        at: event.at,
+        ...(options.turn !== undefined ? { turn: options.turn } : {}),
+        ...(options.phase !== undefined ? { phase: options.phase } : {}),
+        ...(options.round !== undefined ? { round: options.round } : {}),
+        ...(options.transcriptEntryCount !== undefined ? { transcriptEntryCount: options.transcriptEntryCount } : {}),
+        ...(options.contributionCount !== undefined ? { contributionCount: options.contributionCount } : {})
+    };
+    switch (event.type) {
+        case "role-assignment":
+            return {
+                ...base,
+                agentId: event.agentId,
+                role: event.role
+            };
+        case "model-request":
+            return {
+                ...base,
+                agentId: event.agentId,
+                role: event.role,
+                callId: event.callId,
+                providerId: event.providerId,
+                input: event.request.messages.map((message) => message.content).join("\n")
+            };
+        case "model-response":
+            return {
+                ...base,
+                agentId: event.agentId,
+                role: event.role,
+                callId: event.callId,
+                providerId: event.providerId,
+                output: event.response.text
+            };
+        case "model-output-chunk":
+            return {
+                ...base,
+                agentId: event.agentId,
+                role: event.role,
+                input: event.input,
+                output: event.output
+            };
+        case "tool-call":
+            return {
+                ...base,
+                toolCallId: event.toolCallId,
+                tool: event.tool,
+                input: stableJsonStringify(event.input),
+                ...eventAgentScope(event)
+            };
+        case "tool-result":
+            return {
+                ...base,
+                toolCallId: event.toolCallId,
+                tool: event.tool,
+                output: stableJsonStringify(event.result),
+                ...eventAgentScope(event)
+            };
+        case "agent-turn":
+            return {
+                ...base,
+                agentId: event.agentId,
+                role: event.role,
+                input: event.input,
+                output: event.output,
+                cost: event.cost
+            };
+        case "broadcast":
+            return {
+                ...base,
+                round: event.round,
+                contributionCount: options.contributionCount ?? event.contributions.length,
+                cost: event.cost
+            };
+        case "budget-stop":
+            return {
+                ...base,
+                cost: event.cost,
+                budgetReason: event.reason
+            };
+        case "final":
+            return {
+                ...base,
+                output: event.output,
+                cost: event.cost
+            };
+    }
+}
+function defaultProtocolDecision(event) {
+    switch (event.type) {
+        case "role-assignment":
+            return "assign-role";
+        case "model-request":
+            return "start-model-call";
+        case "model-response":
+            return "complete-model-call";
+        case "model-output-chunk":
+            return "observe-model-output";
+        case "tool-call":
+            return "start-tool-call";
+        case "tool-result":
+            return "complete-tool-call";
+        case "agent-turn":
+            return "select-agent-turn";
+        case "broadcast":
+            return "collect-broadcast-round";
+        case "budget-stop":
+            return "stop-for-budget";
+        case "final":
+            return "finalize-output";
+    }
+}
+function eventAgentScope(event) {
+    return {
+        ...(event.agentId !== undefined ? { agentId: event.agentId } : {}),
+        ...(event.role !== undefined ? { role: event.role } : {})
+    };
+}
+export function createReplayTraceFinalOutput(output, event) {
+    if (event.type === "final") {
+        return {
+            kind: "replay-trace-final-output",
+            output,
+            cost: event.cost,
+            completedAt: event.at,
+            transcript: event.transcript
+        };
+    }
+    return {
+        kind: "replay-trace-final-output",
+        output,
+        cost: emptyCost(),
+        completedAt: event.at,
+        transcript: {
+            kind: "trace-transcript",
+            entryCount: 0,
+            lastEntryIndex: null
+        }
+    };
+}
+export function nextProviderCallId(runId, providerCalls) {
+    return `${runId}:provider-call:${providerCalls.length + 1}`;
+}
+/**
+ * Normalize completed run artifacts into deterministic JSON shapes.
+ *
+ * This keeps caller-owned persistence stable across runtimes: object keys are
+ * sorted recursively, undefined object fields are omitted, non-finite numbers
+ * become JSON `null`, and negative zero is normalized to zero before callers
+ * serialize the returned result, trace, event log, transcript, or metadata.
+ */
+export function canonicalizeRunResult(result) {
+    const trace = canonicalizeSerializable(result.trace);
+    const eventLog = {
+        eventCount: trace.events.length,
+        eventTypes: trace.events.map((event) => event.type),
+        events: trace.events,
+        kind: "run-event-log",
+        protocol: trace.protocol,
+        runId: trace.runId
+    };
+    const canonicalResult = {
+        accounting: canonicalizeSerializable(result.accounting),
+        cost: canonicalizeSerializable(result.cost),
+        ...(result.evaluation !== undefined ? { evaluation: canonicalizeSerializable(result.evaluation) } : {}),
+        eventLog,
+        metadata: canonicalizeSerializable(result.metadata),
+        output: result.output,
+        ...(result.quality !== undefined ? { quality: canonicalizeSerializable(result.quality) } : {}),
+        trace,
+        transcript: trace.transcript,
+        usage: canonicalizeSerializable(result.usage)
+    };
+    return canonicalResult;
+}
+export function stableJsonStringify(value) {
+    return JSON.stringify(canonicalizeSerializable(value));
+}
+export function canonicalizeSerializable(value) {
+    if (Array.isArray(value)) {
+        return value.map((item) => canonicalizeSerializable(item));
+    }
+    if (typeof value === "number") {
+        if (Object.is(value, -0)) {
+            return 0;
+        }
+        if (!Number.isFinite(value)) {
+            return null;
+        }
+        return value;
+    }
+    if (value === null || typeof value !== "object") {
+        return value;
+    }
+    const input = value;
+    const output = {};
+    for (const key of Object.keys(input).sort()) {
+        const child = input[key];
+        if (child !== undefined) {
+            output[key] = canonicalizeSerializable(child);
+        }
+    }
+    return output;
+}
+//# sourceMappingURL=defaults.js.map

package/dist/runtime/defaults.js.map

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

package/dist/runtime/engine.d.ts

@@ -0,0 +1,79 @@
+import type { DogpileOptions, Engine, EngineOptions, RunResult, StreamHandle, Trace } from "../types.js";
+/**
+ * Create a reusable low-level protocol engine.
+ *
+ * @remarks
+ * Use this escape hatch to hold protocol, tier, model, agents, and budget caps
+ * constant across repeated missions. Most application code can call
+ * {@link run}, {@link stream}, or {@link Dogpile.pile} directly.
+ *
+ * The returned engine is stateless between calls: each `run()` or `stream()`
+ * invocation produces its own serializable trace, event log, and transcript.
+ */
+export declare function createEngine(options: EngineOptions): Engine;
+/**
+ * Run a multi-agent workflow in a single call.
+ *
+ * @remarks
+ * Supply a mission through `intent` and provide a configured model provider.
+ * Omitted high-level controls default to Sequential coordination and the
+ * `balanced` tier. The returned
+ * {@link RunResult} contains the final `output`, a JSON-serializable `trace`,
+ * direct `transcript` access, aggregate `cost`, and optional `quality`.
+ *
+ * Use {@link createEngine} when a research harness needs to reuse normalized
+ * protocol/model/agent settings across many missions.
+ */
+export declare function run(options: DogpileOptions): Promise<RunResult>;
+/**
+ * Stream a multi-agent workflow and await the final result.
+ *
+ * @remarks
+ * The returned handle is an async iterable of {@link RunEvent} values with a
+ * `result` promise for the same {@link RunResult} shape returned by
+ * {@link run}. This supports live event logs and trace UIs without requiring
+ * SDK-managed storage.
+ *
+ * Streaming and final traces use the same event shapes, so callers can render
+ * progress live and persist the completed trace without translation.
+ */
+export declare function stream(options: DogpileOptions): StreamHandle;
+/**
+ * Rehydrate the public result shape from a saved completed trace artifact.
+ *
+ * @remarks
+ * This is the caller-facing replay entrypoint for persisted traces. It does
+ * not call the model provider or require SDK-owned storage; it reconstructs
+ * the ergonomic {@link RunResult} wrapper from the JSON-serializable
+ * {@link Trace} returned by a previous `run()`, `stream()`, or
+ * `Dogpile.pile()` call.
+ */
+export declare function replay(trace: Trace): RunResult;
+/**
+ * Replay a saved completed trace as a stream without invoking a model provider.
+ *
+ * @remarks
+ * This is the streaming counterpart to {@link replay}. It yields the exact
+ * saved {@link Trace.events} in order and resolves {@link StreamHandle.result}
+ * to the rehydrated {@link RunResult}. Since all data comes from the trace,
+ * replay remains storage-free and provider-free.
+ */
+export declare function replayStream(trace: Trace): StreamHandle;
+/**
+ * Branded high-level SDK namespace.
+ *
+ * `Dogpile.pile()` is the ergonomic caller-facing workflow API. It uses the
+ * non-streaming execution path and resolves only after the protocol completes,
+ * returning `{ output, eventLog, transcript, usage, metadata, trace, cost,
+ * quality }`.
+ */
+declare function pile(options: DogpileOptions): Promise<RunResult>;
+export declare const Dogpile: {
+    readonly pile: typeof pile;
+    readonly replay: typeof replay;
+    readonly replayStream: typeof replayStream;
+    readonly stream: typeof stream;
+    readonly createEngine: typeof createEngine;
+};
+export {};
+//# sourceMappingURL=engine.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"engine.d.ts","sourceRoot":"","sources":["../../src/runtime/engine.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAEV,cAAc,EACd,MAAM,EACN,aAAa,EAOb,SAAS,EAIT,YAAY,EAEZ,KAAK,EACN,MAAM,aAAa,CAAC;AA+BrB;;;;;;;;;;GAUG;AACH,wBAAgB,YAAY,CAAC,OAAO,EAAE,aAAa,GAAG,MAAM,CAoN3D;AA6YD;;;;;;;;;;;;GAYG;AACH,wBAAgB,GAAG,CAAC,OAAO,EAAE,cAAc,GAAG,OAAO,CAAC,SAAS,CAAC,CAK/D;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,MAAM,CAAC,OAAO,EAAE,cAAc,GAAG,YAAY,CAK5D;AAED;;;;;;;;;GASG;AACH,wBAAgB,MAAM,CAAC,KAAK,EAAE,KAAK,GAAG,SAAS,CAoC9C;AAED;;;;;;;;GAQG;AACH,wBAAgB,YAAY,CAAC,KAAK,EAAE,KAAK,GAAG,YAAY,CAsCvD;AAyDD;;;;;;;GAOG;AACH,iBAAS,IAAI,CAAC,OAAO,EAAE,cAAc,GAAG,OAAO,CAAC,SAAS,CAAC,CAEzD;AAED,eAAO,MAAM,OAAO;;;;;;CAMV,CAAC"}