experimental-ash 0.1.0-alpha.1

package/dist/src/runtime/harness/run-turn.d.ts

@@ -0,0 +1,111 @@
+import { type ManagedRuntimeSandboxes } from "../sandboxes/ensure.js";
+import type { RuntimeSandboxEventSink, RuntimeSandboxState } from "../sandboxes/types.js";
+import type { PreparedRuntimeTurn, RuntimeTurnContext } from "../sessions/turn.js";
+import type { RuntimeSessionState } from "../sessions/types.js";
+import type { ResumeHarnessTurnRequest, RuntimeHarnessTurnOutcome } from "./contracts.js";
+import type { RuntimeHarnessHost } from "./hosts/types.js";
+import type { HarnessWorkspaceState, ManagedHarnessWorkspace } from "./workspace/types.js";
+/**
+ * Serializable runtime-owned result of executing one harness turn with a live
+ * runtime-owned workspace.
+ */
+export interface RuntimeHarnessTurnExecutionResult {
+    readonly outcome: RuntimeHarnessTurnOutcome;
+    readonly sandboxState: RuntimeSandboxState;
+    readonly workspaceState: HarnessWorkspaceState;
+}
+/**
+ * Minimal session input needed to create or reattach the live harness
+ * workspace before a turn starts or resumes.
+ */
+export interface RuntimeHarnessTurnSession {
+    readonly compiledArtifactsSource: RuntimeSessionState["compiledArtifactsSource"];
+    readonly harnessState: RuntimeSessionState["harnessState"];
+    readonly parent?: RuntimeSessionState["parent"];
+    readonly runId: RuntimeSessionState["runId"];
+    readonly sandboxState: RuntimeSessionState["sandboxState"];
+    readonly sessionId: RuntimeSessionState["sessionId"];
+    readonly workspaceState: RuntimeSessionState["workspaceState"];
+}
+/**
+ * Input required to start one harness turn with runtime-owned workspace
+ * lifecycle.
+ */
+export interface StartRuntimeHarnessTurnInput {
+    readonly runtime: RuntimeTurnContext;
+    readonly session: RuntimeHarnessTurnSession;
+    readonly turn: PreparedRuntimeTurn;
+}
+/**
+ * Input required to resume one harness turn with runtime-owned workspace
+ * lifecycle.
+ */
+export interface ResumeRuntimeHarnessTurnInput {
+    readonly continuation: ResumeHarnessTurnRequest["continuation"];
+    readonly results: ResumeHarnessTurnRequest["results"];
+    readonly runtime: RuntimeTurnContext;
+    readonly session: RuntimeHarnessTurnSession;
+    readonly turn: PreparedRuntimeTurn;
+}
+/**
+ * Optional execution dependencies for one runtime-owned harness turn.
+ */
+export interface RuntimeHarnessTurnDependencies {
+    /**
+     * Harness host used to create the step-owned harness instance for the current
+     * turn fragment.
+     */
+    readonly host?: RuntimeHarnessHost;
+    /**
+     * Workspace provider used to create or reattach the live runtime-owned
+     * workspace for the current turn fragment.
+     */
+    readonly workspaceProvider?: RuntimeHarnessWorkspaceProvider;
+    /**
+     * Sandbox provider used to create or reattach the live authored sandboxes
+     * for the current turn fragment.
+     */
+    readonly sandboxProvider?: RuntimeHarnessSandboxProvider;
+    /**
+     * Optional callback invoked whenever one authored sandbox lifecycle or
+     * command event is observed during the current turn fragment.
+     */
+    readonly sandboxEventSink?: RuntimeSandboxEventSink;
+}
+/**
+ * Provider contract for creating or reattaching the live runtime-owned
+ * workspace outside the default `just-bash` implementation.
+ */
+export interface RuntimeHarnessWorkspaceProvider {
+    ensureWorkspace(input: {
+        readonly runId: string;
+        readonly spec: PreparedRuntimeTurn["workspaceSpec"];
+        readonly state: HarnessWorkspaceState | null;
+    }): Promise<ManagedHarnessWorkspace>;
+}
+/**
+ * Provider contract for creating or reattaching authored sandboxes outside the
+ * default runtime-owned implementation.
+ */
+export interface RuntimeHarnessSandboxProvider {
+    ensureSandboxes(input: {
+        readonly compiledArtifactsSource: RuntimeSessionState["compiledArtifactsSource"];
+        readonly eventSink?: RuntimeSandboxEventSink;
+        readonly registry: RuntimeTurnContext["sandboxRegistry"];
+        readonly sessionId: string;
+        readonly state: RuntimeSandboxState | null;
+    }): Promise<ManagedRuntimeSandboxes>;
+}
+/**
+ * Starts one runtime-owned harness turn with the active ToolLoop harness.
+ *
+ * Call this only from framework-owned `use step` functions or equivalent step-backed runtime code.
+ */
+export declare function startRuntimeHarnessTurn(input: StartRuntimeHarnessTurnInput, dependencies?: RuntimeHarnessTurnDependencies): Promise<RuntimeHarnessTurnExecutionResult>;
+/**
+ * Resumes one paused runtime-owned harness turn with runtime action results.
+ *
+ * Call this only from framework-owned `use step` functions or equivalent step-backed runtime code.
+ */
+export declare function resumeRuntimeHarnessTurn(input: ResumeRuntimeHarnessTurnInput, dependencies?: RuntimeHarnessTurnDependencies): Promise<RuntimeHarnessTurnExecutionResult>;
+//# sourceMappingURL=run-turn.d.ts.map

package/dist/src/runtime/harness/run-turn.d.ts.map

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

package/dist/src/runtime/harness/run-turn.js

@@ -0,0 +1,92 @@
+import { ensureRuntimeSandboxes } from "../sandboxes/ensure.js";
+import { runWithActiveSession } from "../session-context.js";
+import { createToolLoopHarnessHost } from "./hosts/tool-loop.js";
+import { ensureHarnessWorkspace } from "./workspace/ensure.js";
+const DEFAULT_RUNTIME_HARNESS_HOST = createToolLoopHarnessHost();
+const DEFAULT_RUNTIME_HARNESS_WORKSPACE_PROVIDER = {
+    ensureWorkspace(input) {
+        return ensureHarnessWorkspace(input);
+    },
+};
+const DEFAULT_RUNTIME_HARNESS_SANDBOX_PROVIDER = {
+    ensureSandboxes(input) {
+        return ensureRuntimeSandboxes(input);
+    },
+};
+/**
+ * Starts one runtime-owned harness turn with the active ToolLoop harness.
+ *
+ * Call this only from framework-owned `use step` functions or equivalent step-backed runtime code.
+ */
+export async function startRuntimeHarnessTurn(input, dependencies = {}) {
+    const workspace = await (dependencies.workspaceProvider ?? DEFAULT_RUNTIME_HARNESS_WORKSPACE_PROVIDER).ensureWorkspace({
+        runId: input.session.runId,
+        spec: input.turn.workspaceSpec,
+        state: input.session.workspaceState,
+    });
+    const sandboxes = await ensureTurnSandboxes(input, dependencies);
+    const harness = (dependencies.host ?? DEFAULT_RUNTIME_HARNESS_HOST).createHarness({
+        sandboxes: sandboxes.sandboxes,
+        workspace: workspace.workspace,
+    });
+    const outcome = await runWithActiveSession(createAuthoredSession(input), async () => harness.startTurn({
+        checkpoint: input.session.harnessState,
+        runtime: input.runtime,
+        turn: input.turn,
+    }));
+    return {
+        outcome,
+        sandboxState: await sandboxes.captureState(),
+        workspaceState: await workspace.captureState(),
+    };
+}
+/**
+ * Resumes one paused runtime-owned harness turn with runtime action results.
+ *
+ * Call this only from framework-owned `use step` functions or equivalent step-backed runtime code.
+ */
+export async function resumeRuntimeHarnessTurn(input, dependencies = {}) {
+    const workspace = await (dependencies.workspaceProvider ?? DEFAULT_RUNTIME_HARNESS_WORKSPACE_PROVIDER).ensureWorkspace({
+        runId: input.session.runId,
+        spec: input.turn.workspaceSpec,
+        state: input.session.workspaceState,
+    });
+    const sandboxes = await ensureTurnSandboxes(input, dependencies);
+    const harness = (dependencies.host ?? DEFAULT_RUNTIME_HARNESS_HOST).createHarness({
+        sandboxes: sandboxes.sandboxes,
+        workspace: workspace.workspace,
+    });
+    const request = {
+        continuation: input.continuation,
+        checkpoint: input.session.harnessState,
+        results: input.results,
+        runtime: input.runtime,
+        turn: input.turn,
+    };
+    return {
+        outcome: await runWithActiveSession(createAuthoredSession(input), async () => harness.resumeTurn(request)),
+        sandboxState: await sandboxes.captureState(),
+        workspaceState: await workspace.captureState(),
+    };
+}
+async function ensureTurnSandboxes(input, dependencies) {
+    return await (dependencies.sandboxProvider ?? DEFAULT_RUNTIME_HARNESS_SANDBOX_PROVIDER).ensureSandboxes({
+        compiledArtifactsSource: input.session.compiledArtifactsSource,
+        eventSink: dependencies.sandboxEventSink,
+        registry: input.runtime.sandboxRegistry,
+        sessionId: input.session.sessionId,
+        state: input.session.sandboxState,
+    });
+}
+function createAuthoredSession(input) {
+    return {
+        parent: input.session.parent,
+        runId: input.session.runId,
+        sessionId: input.session.sessionId,
+        turn: {
+            id: input.turn.turnId,
+            sequence: input.turn.sequence,
+        },
+    };
+}
+//# sourceMappingURL=run-turn.js.map

package/dist/src/runtime/harness/run-turn.js.map

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

package/dist/src/runtime/harness/tool-loop/create-harness.d.ts

@@ -0,0 +1,31 @@
+import { type LanguageModel } from "ai";
+import type { RuntimeModelReference } from "../../agent/bootstrap.js";
+import type { RuntimeHarnessSandboxTool } from "../../sandboxes/types.js";
+import type { RuntimeHarness } from "../contracts.js";
+import type { HarnessWorkspace } from "../workspace/types.js";
+/**
+ * Dependencies used by the step-owned ToolLoop harness runtime.
+ */
+export interface ToolLoopHarnessDependencies {
+    /**
+     * Resolves one runtime model reference into the AI SDK model value used by `ToolLoopAgent`.
+     */
+    readonly resolveModel?: (reference: RuntimeModelReference) => LanguageModel | Promise<LanguageModel>;
+    /**
+     * Live runtime-owned sandboxes available to the harness host during the
+     * current step.
+     */
+    readonly sandboxes?: readonly RuntimeHarnessSandboxTool[];
+    /**
+     * Live runtime-owned workspace available to the harness host during the current step.
+     */
+    readonly workspace?: HarnessWorkspace;
+}
+/**
+ * Creates the active step-owned ToolLoop harness.
+ *
+ * The harness itself is framework-owned, but it instantiates AI SDK `ToolLoopAgent`
+ * instances only while starting or resuming turns inside runtime-owned step functions.
+ */
+export declare function createToolLoopHarness(dependencies?: ToolLoopHarnessDependencies): RuntimeHarness;
+//# sourceMappingURL=create-harness.d.ts.map

package/dist/src/runtime/harness/tool-loop/create-harness.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"create-harness.d.ts","sourceRoot":"","sources":["../../../../../src/runtime/harness/tool-loop/create-harness.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,aAAa,EAA0C,MAAM,IAAI,CAAC;AAQhF,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,0BAA0B,CAAC;AAEtE,OAAO,KAAK,EAAE,yBAAyB,EAAE,MAAM,0BAA0B,CAAC;AAG1E,OAAO,KAAK,EAGV,cAAc,EAIf,MAAM,iBAAiB,CAAC;AAEzB,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAC;AAsB9D;;GAEG;AACH,MAAM,WAAW,2BAA2B;IAC1C;;OAEG;IACH,QAAQ,CAAC,YAAY,CAAC,EAAE,CACtB,SAAS,EAAE,qBAAqB,KAC7B,aAAa,GAAG,OAAO,CAAC,aAAa,CAAC,CAAC;IAC5C;;;OAGG;IACH,QAAQ,CAAC,SAAS,CAAC,EAAE,SAAS,yBAAyB,EAAE,CAAC;IAC1D;;OAEG;IACH,QAAQ,CAAC,SAAS,CAAC,EAAE,gBAAgB,CAAC;CACvC;AAED;;;;;GAKG;AACH,wBAAgB,qBAAqB,CACnC,YAAY,GAAE,2BAAgC,GAC7C,cAAc,CAShB"}

package/dist/src/runtime/harness/tool-loop/create-harness.js

@@ -0,0 +1,276 @@
+import { ToolLoopAgent } from "ai";
+import { getRuntimeActionRequestKey, getRuntimeActionResultKey, isRuntimeActionResult, } from "../../actions/types.js";
+import { resolveRuntimeModelReference } from "../../agent/resolve-model.js";
+import { createToolLoopToolResultMessage } from "./internal/action-results.js";
+import { generateToolLoopAgentResult, serializeToolLoopErrorDetails, } from "./internal/generate-with-retries.js";
+import { toLanguageModelMessages } from "./internal/provider-messages.js";
+import { projectRuntimeSessionMessages } from "./internal/runtime-history.js";
+import { createModelTools, createRuntimeBashTool, createRuntimeSandboxTool, } from "./internal/runtime-tools.js";
+import { createToolLoopContinuationState, createToolLoopSessionState, parseToolLoopContinuationState, parseToolLoopSessionState, } from "./internal/state.js";
+import { projectToolLoopResult } from "./internal/stream-result.js";
+import { createToolLoopTranscript } from "./internal/transcript.js";
+/**
+ * Creates the active step-owned ToolLoop harness.
+ *
+ * The harness itself is framework-owned, but it instantiates AI SDK `ToolLoopAgent`
+ * instances only while starting or resuming turns inside runtime-owned step functions.
+ */
+export function createToolLoopHarness(dependencies = {}) {
+    return {
+        resumeTurn(input) {
+            return resumeToolLoopTurn(input, dependencies);
+        },
+        startTurn(input) {
+            return startToolLoopTurn(input, dependencies);
+        },
+    };
+}
+async function resumeToolLoopTurn(input, dependencies) {
+    const continuation = parseToolLoopContinuationState(input.continuation);
+    if (continuation instanceof Error) {
+        return createFailedOutcome({
+            code: "INVALID_CONTINUATION_STATE",
+            message: continuation.message,
+        }, input.checkpoint, createProjectionFromCheckpoint({
+            checkpoint: input.checkpoint,
+            usage: null,
+        }));
+    }
+    const actionResultsError = validateActionResults(continuation.pendingActions, input.results);
+    if (actionResultsError !== null) {
+        return createFailedOutcome({
+            code: "INVALID_ACTION_RESULTS",
+            message: actionResultsError,
+        }, createToolLoopSessionState(continuation.transcript), createProjection({
+            history: projectRuntimeSessionMessages(continuation.transcript),
+            usage: continuation.usage,
+        }));
+    }
+    const transcript = [
+        ...continuation.transcript,
+        createToolLoopToolResultMessage({
+            pendingActions: continuation.pendingActions,
+            results: input.results,
+            runtimeActionTools: input.runtime.runtimeTools,
+        }),
+    ];
+    try {
+        const toolLoopAgent = await createToolLoopAgent({
+            model: input.turn.model,
+            runtimeTools: input.runtime.runtimeTools,
+            systemInstructions: input.runtime.systemInstructions,
+            tools: input.turn.tools,
+        }, dependencies);
+        const result = await generateToolLoopAgentResult(toolLoopAgent, {
+            messages: toLanguageModelMessages(transcript),
+        });
+        return createOutcome({
+            accumulatedUsage: continuation.usage,
+            transcript,
+            runtimeActionTools: input.runtime.runtimeTools,
+            visibleTools: input.turn.tools,
+            result,
+        });
+    }
+    catch (error) {
+        return createFailedOutcome({
+            code: "TOOL_LOOP_RESUME_FAILED",
+            details: serializeToolLoopErrorDetails(error),
+            message: formatErrorMessage(error),
+        }, createToolLoopSessionState(transcript), createProjection({
+            history: projectRuntimeSessionMessages(transcript),
+            usage: continuation.usage,
+        }));
+    }
+}
+async function startToolLoopTurn(input, dependencies) {
+    const transcript = createToolLoopTranscript(input.turn.messages);
+    try {
+        const toolLoopAgent = await createToolLoopAgent({
+            model: input.turn.model,
+            runtimeTools: input.runtime.runtimeTools,
+            systemInstructions: input.runtime.systemInstructions,
+            tools: input.turn.tools,
+        }, dependencies);
+        const result = await generateToolLoopAgentResult(toolLoopAgent, {
+            messages: toLanguageModelMessages(transcript),
+        });
+        return createOutcome({
+            accumulatedUsage: null,
+            transcript,
+            runtimeActionTools: input.runtime.runtimeTools,
+            visibleTools: input.turn.tools,
+            result,
+        });
+    }
+    catch (error) {
+        return createFailedOutcome({
+            code: "TOOL_LOOP_START_FAILED",
+            details: serializeToolLoopErrorDetails(error),
+            message: formatErrorMessage(error),
+        }, createToolLoopSessionState(transcript), createProjection({
+            history: projectRuntimeSessionMessages(transcript),
+            usage: null,
+        }));
+    }
+}
+function createOutcome(input) {
+    const projected = projectToolLoopResult({
+        result: input.result,
+        runtimeActionTools: input.runtimeActionTools,
+        visibleTools: input.visibleTools,
+    });
+    const transcript = [...input.transcript, ...projected.messages];
+    const usage = sumHarnessTokenUsage(input.accumulatedUsage, projected.usage);
+    const checkpoint = createToolLoopSessionState(transcript);
+    const projection = createProjection({
+        assistantOutput: projected.assistantOutput,
+        history: projectRuntimeSessionMessages(transcript),
+        usage,
+    });
+    if (projected.actions.length > 0) {
+        return {
+            actions: projected.actions,
+            checkpoint,
+            continuation: createToolLoopContinuationState({
+                pendingActions: projected.actions,
+                transcript,
+                usage,
+            }),
+            projection,
+            status: "awaiting-actions",
+        };
+    }
+    return {
+        checkpoint,
+        completion: "turn",
+        projection,
+        status: "completed",
+    };
+}
+async function createToolLoopAgent(input, dependencies) {
+    const model = await resolveRuntimeModel(input.model, dependencies);
+    const tools = createModelTools([...input.tools, ...input.runtimeTools]);
+    if (dependencies.workspace !== undefined) {
+        if ("bash" in tools) {
+            throw new Error('Tool "bash" is already defined for this ToolLoop fragment.');
+        }
+        tools.bash = await createRuntimeBashTool(dependencies.workspace);
+    }
+    for (const sandbox of dependencies.sandboxes ?? []) {
+        if (sandbox.toolName in tools) {
+            throw new Error(`Tool "${sandbox.toolName}" is already defined for this ToolLoop fragment.`);
+        }
+        tools[sandbox.toolName] = await createRuntimeSandboxTool({
+            cwd: sandbox.cwd,
+            extraInstructions: sandbox.description ?? undefined,
+            sandbox: sandbox.sandbox,
+        });
+    }
+    const initialInstructions = input.systemInstructions;
+    return new ToolLoopAgent({
+        instructions: initialInstructions.length === 0
+            ? undefined
+            : createToolLoopInstructions(initialInstructions),
+        model,
+        prepareStep() {
+            return initialInstructions.length === 0
+                ? {}
+                : {
+                    system: createToolLoopInstructions(initialInstructions),
+                };
+        },
+        tools,
+    });
+}
+function createFailedOutcome(error, checkpoint, projection) {
+    return {
+        checkpoint,
+        error,
+        projection,
+        status: "failed",
+    };
+}
+function createToolLoopInstructions(instructions) {
+    if (instructions.length === 1 && instructions[0] !== undefined) {
+        return instructions[0];
+    }
+    return instructions.map((instruction) => ({
+        content: instruction,
+        role: "system",
+    }));
+}
+function createProjection(input) {
+    return {
+        assistantOutput: input.assistantOutput ?? null,
+        history: [...input.history],
+        usage: input.usage,
+    };
+}
+function createProjectionFromCheckpoint(input) {
+    const checkpoint = parseToolLoopSessionState(input.checkpoint);
+    return createProjection({
+        history: checkpoint instanceof Error ? [] : projectRuntimeSessionMessages(checkpoint.transcript),
+        usage: input.usage,
+    });
+}
+function sumHarnessTokenUsage(previous, next) {
+    if (previous === null) {
+        return next;
+    }
+    if (next === null) {
+        return previous;
+    }
+    const inputTokens = sumOptionalTokens(previous.inputTokens, next.inputTokens);
+    const outputTokens = sumOptionalTokens(previous.outputTokens, next.outputTokens);
+    const totalTokens = sumOptionalTokens(previous.totalTokens, next.totalTokens);
+    const usage = {};
+    if (inputTokens !== undefined) {
+        usage.inputTokens = inputTokens;
+    }
+    if (outputTokens !== undefined) {
+        usage.outputTokens = outputTokens;
+    }
+    if (totalTokens !== undefined) {
+        usage.totalTokens = totalTokens;
+    }
+    return usage;
+}
+function sumOptionalTokens(left, right) {
+    if (left === undefined) {
+        return right;
+    }
+    if (right === undefined) {
+        return left;
+    }
+    return left + right;
+}
+function validateActionResults(pendingActions, results) {
+    if (pendingActions.length !== results.length) {
+        return `Expected ${pendingActions.length} action result(s), received ${results.length}.`;
+    }
+    const pendingKeys = new Set(pendingActions.map((action) => getRuntimeActionRequestKey(action)));
+    for (const result of results) {
+        if (!isRuntimeActionResult(result)) {
+            return "Received a non-runtime action result while resuming the ToolLoop harness.";
+        }
+        const key = getRuntimeActionResultKey(result);
+        if (!pendingKeys.has(key)) {
+            return `Received an action result (${key}) that is not pending.`;
+        }
+        pendingKeys.delete(key);
+    }
+    if (pendingKeys.size > 0) {
+        const [missingKey] = pendingKeys;
+        return `Missing an action result for ${missingKey}.`;
+    }
+    return null;
+}
+async function resolveRuntimeModel(reference, dependencies) {
+    return ((await dependencies.resolveModel?.(reference)) ??
+        (await resolveRuntimeModelReference(reference)));
+}
+function formatErrorMessage(error) {
+    return error instanceof Error ? error.message : String(error);
+}
+//# sourceMappingURL=create-harness.js.map

package/dist/src/runtime/harness/tool-loop/create-harness.js.map

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

package/dist/src/runtime/harness/tool-loop/internal/action-results.d.ts

@@ -0,0 +1,12 @@
+import { type RuntimeActionRequest, type RuntimeActionResult } from "../../../actions/types.js";
+import type { PreparedRuntimeActionTool } from "../../../sessions/turn.js";
+import type { ToolLoopToolMessage } from "./transcript.js";
+/**
+ * Creates one serializable tool-result message for resuming a paused ToolLoop turn.
+ */
+export declare function createToolLoopToolResultMessage(input: {
+    readonly pendingActions: readonly RuntimeActionRequest[];
+    readonly results: readonly RuntimeActionResult[];
+    readonly runtimeActionTools: readonly PreparedRuntimeActionTool[];
+}): ToolLoopToolMessage;
+//# sourceMappingURL=action-results.d.ts.map

package/dist/src/runtime/harness/tool-loop/internal/action-results.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"action-results.d.ts","sourceRoot":"","sources":["../../../../../../src/runtime/harness/tool-loop/internal/action-results.ts"],"names":[],"mappings":"AAAA,OAAO,EAKL,KAAK,oBAAoB,EACzB,KAAK,mBAAmB,EACzB,MAAM,2BAA2B,CAAC;AACnC,OAAO,KAAK,EAAE,yBAAyB,EAAE,MAAM,2BAA2B,CAAC;AAE3E,OAAO,KAAK,EAAE,mBAAmB,EAA0B,MAAM,iBAAiB,CAAC;AAEnF;;GAEG;AACH,wBAAgB,+BAA+B,CAAC,KAAK,EAAE;IACrD,QAAQ,CAAC,cAAc,EAAE,SAAS,oBAAoB,EAAE,CAAC;IACzD,QAAQ,CAAC,OAAO,EAAE,SAAS,mBAAmB,EAAE,CAAC;IACjD,QAAQ,CAAC,kBAAkB,EAAE,SAAS,yBAAyB,EAAE,CAAC;CACnE,GAAG,mBAAmB,CAqBtB"}

package/dist/src/runtime/harness/tool-loop/internal/action-results.js

@@ -0,0 +1,68 @@
+import { getRuntimeActionRequestKey, getRuntimeActionResultKey, isRuntimeSubagentResultActionResult, isRuntimeToolResultActionResult, } from "../../../actions/types.js";
+import { ACTIVATE_SKILL_TOOL_NAME } from "../../../skills/fragment-context.js";
+/**
+ * Creates one serializable tool-result message for resuming a paused ToolLoop turn.
+ */
+export function createToolLoopToolResultMessage(input) {
+    const pendingActionsByKey = new Map(input.pendingActions.map((action) => [getRuntimeActionRequestKey(action), action]));
+    const runtimeActionToolsByKind = new Map(input.runtimeActionTools.map((runtimeActionTool) => [
+        runtimeActionTool.actionKind,
+        runtimeActionTool,
+    ]));
+    return {
+        content: input.results.map((result) => createToolLoopToolResultPart({
+            pendingActionsByKey,
+            result,
+            runtimeActionToolsByKind,
+        })),
+        role: "tool",
+    };
+}
+function createToolLoopToolResultPart(input) {
+    const pendingAction = input.pendingActionsByKey.get(getRuntimeActionResultKey(input.result));
+    if (pendingAction === undefined) {
+        throw new Error(`Missing the pending runtime action metadata for ${getRuntimeActionResultKey(input.result)} while resuming the ToolLoop harness.`);
+    }
+    if (pendingAction.kind === "tool-call") {
+        if (!isRuntimeToolResultActionResult(input.result)) {
+            throw new Error(`Expected a tool-result for ${getRuntimeActionResultKey(input.result)} while resuming the ToolLoop harness.`);
+        }
+        return {
+            isError: input.result.isError,
+            output: input.result.output,
+            toolCallId: input.result.callId,
+            toolName: pendingAction.toolName,
+            type: "tool-result",
+        };
+    }
+    if (pendingAction.kind === "subagent-call") {
+        if (!isRuntimeSubagentResultActionResult(input.result)) {
+            throw new Error(`Expected a subagent-result for ${getRuntimeActionResultKey(input.result)} while resuming the ToolLoop harness.`);
+        }
+        return {
+            isError: input.result.isError,
+            output: input.result.output,
+            toolCallId: input.result.callId,
+            toolName: pendingAction.subagentName,
+            type: "tool-result",
+        };
+    }
+    const runtimeActionTool = input.runtimeActionToolsByKind.get(pendingAction.kind);
+    return {
+        isError: input.result.isError,
+        output: input.result.output,
+        toolCallId: input.result.callId,
+        toolName: getRuntimeActionToolName(pendingAction.kind, runtimeActionTool),
+        type: "tool-result",
+    };
+}
+function getRuntimeActionToolName(actionKind, runtimeActionTool) {
+    if (runtimeActionTool !== undefined) {
+        return runtimeActionTool.name;
+    }
+    switch (actionKind) {
+        case "activate-skill":
+            return ACTIVATE_SKILL_TOOL_NAME;
+    }
+}
+//# sourceMappingURL=action-results.js.map

package/dist/src/runtime/harness/tool-loop/internal/action-results.js.map

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

package/dist/src/runtime/harness/tool-loop/internal/generate-with-retries.d.ts

@@ -0,0 +1,16 @@
+import { type ToolLoopAgent } from "ai";
+import type { JsonObject } from "../../../json.js";
+type ToolLoopGenerateInput = Parameters<ToolLoopAgent["generate"]>[0];
+type ToolLoopGenerateResult = Awaited<ReturnType<ToolLoopAgent["generate"]>>;
+/**
+ * Retries ToolLoop model calls when the upstream gateway/provider fails with a
+ * transient transport or server-side error.
+ */
+export declare function generateToolLoopAgentResult(agent: ToolLoopAgent, input: ToolLoopGenerateInput): Promise<ToolLoopGenerateResult>;
+/**
+ * Serializes stable structured details from one ToolLoop failure so workflow
+ * stream events can distinguish transient provider failures from runtime bugs.
+ */
+export declare function serializeToolLoopErrorDetails(error: unknown): JsonObject | undefined;
+export {};
+//# sourceMappingURL=generate-with-retries.d.ts.map