experimental-ash 0.1.0-alpha.1

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

@@ -0,0 +1,67 @@
+import { jsonSchema, tool } from "ai";
+/**
+ * Framework-owned tool name used to activate one available compiled skill.
+ */
+export const ACTIVATE_SKILL_TOOL_NAME = "activate_skill";
+/**
+ * Creates the framework-owned activation tool when the current turn exposes
+ * any available skills.
+ */
+export function createActivateSkillTool(input) {
+    if (input.availableSkills.length === 0) {
+        return null;
+    }
+    return tool({
+        description: "Load the full instructions for one available skill by name or id before relying on that skill.",
+        inputSchema: jsonSchema({
+            additionalProperties: false,
+            properties: {
+                skill: {
+                    description: "Available skill name or id.",
+                    type: "string",
+                },
+            },
+            required: ["skill"],
+            type: "object",
+        }),
+    });
+}
+/**
+ * Builds the dynamic system-instruction list for the current ToolLoop step.
+ */
+export function createRuntimeSkillInstructions(input) {
+    const instructions = [...input.baseInstructions];
+    const availableInstruction = createAvailableSkillsInstruction(input.availableSkills);
+    if (availableInstruction !== null) {
+        instructions.push(availableInstruction);
+    }
+    for (const skill of input.activeSkills) {
+        instructions.push(createActivatedSkillInstruction(skill));
+    }
+    return instructions;
+}
+function createAvailableSkillsInstruction(skills) {
+    if (skills.length === 0) {
+        return null;
+    }
+    const lines = [
+        "Available skills",
+        "Use the activate_skill tool to load a skill by name or id before following its full instructions.",
+        ...skills.map((skill) => createAvailableSkillLine(skill)),
+    ];
+    return lines.join("\n");
+}
+function createAvailableSkillLine(skill) {
+    const skillView = {
+        description: skill.description,
+        name: skill.name,
+        skillId: skill.skillId,
+    };
+    return skillView.name === skillView.skillId
+        ? `- ${skillView.name}: ${skillView.description}`
+        : `- ${skillView.name} [${skillView.skillId}]: ${skillView.description}`;
+}
+function createActivatedSkillInstruction(skill) {
+    return `Skill (${skill.skillId})\n${skill.markdown.trimEnd()}`;
+}
+//# sourceMappingURL=runtime-skills.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"runtime-skills.js","sourceRoot":"","sources":["../../../../../../src/runtime/harness/tool-loop/internal/runtime-skills.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAgB,IAAI,EAAE,MAAM,IAAI,CAAC;AAKpD;;GAEG;AACH,MAAM,CAAC,MAAM,wBAAwB,GAAG,gBAAgB,CAAC;AAQzD;;;GAGG;AACH,MAAM,UAAU,uBAAuB,CAAC,KAEvC;IACC,IAAI,KAAK,CAAC,eAAe,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACvC,OAAO,IAAI,CAAC;IACd,CAAC;IAED,OAAO,IAAI,CAAC;QACV,WAAW,EACT,gGAAgG;QAClG,WAAW,EAAE,UAAU,CAAC;YACtB,oBAAoB,EAAE,KAAK;YAC3B,UAAU,EAAE;gBACV,KAAK,EAAE;oBACL,WAAW,EAAE,6BAA6B;oBAC1C,IAAI,EAAE,QAAQ;iBACf;aACF;YACD,QAAQ,EAAE,CAAC,OAAO,CAAC;YACnB,IAAI,EAAE,QAAQ;SACf,CAAC;KACH,CAAoB,CAAC;AACxB,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,8BAA8B,CAAC,KAI9C;IACC,MAAM,YAAY,GAAG,CAAC,GAAG,KAAK,CAAC,gBAAgB,CAAC,CAAC;IACjD,MAAM,oBAAoB,GAAG,gCAAgC,CAAC,KAAK,CAAC,eAAe,CAAC,CAAC;IAErF,IAAI,oBAAoB,KAAK,IAAI,EAAE,CAAC;QAClC,YAAY,CAAC,IAAI,CAAC,oBAAoB,CAAC,CAAC;IAC1C,CAAC;IAED,KAAK,MAAM,KAAK,IAAI,KAAK,CAAC,YAAY,EAAE,CAAC;QACvC,YAAY,CAAC,IAAI,CAAC,+BAA+B,CAAC,KAAK,CAAC,CAAC,CAAC;IAC5D,CAAC;IAED,OAAO,YAAY,CAAC;AACtB,CAAC;AAED,SAAS,gCAAgC,CAAC,MAAqC;IAC7E,IAAI,MAAM,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACxB,OAAO,IAAI,CAAC;IACd,CAAC;IAED,MAAM,KAAK,GAAG;QACZ,kBAAkB;QAClB,mGAAmG;QACnG,GAAG,MAAM,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,wBAAwB,CAAC,KAAK,CAAC,CAAC;KAC1D,CAAC;IAEF,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AAC1B,CAAC;AAED,SAAS,wBAAwB,CAAC,KAAyB;IACzD,MAAM,SAAS,GAA8B;QAC3C,WAAW,EAAE,KAAK,CAAC,WAAW;QAC9B,IAAI,EAAE,KAAK,CAAC,IAAI;QAChB,OAAO,EAAE,KAAK,CAAC,OAAO;KACvB,CAAC;IAEF,OAAO,SAAS,CAAC,IAAI,KAAK,SAAS,CAAC,OAAO;QACzC,CAAC,CAAC,KAAK,SAAS,CAAC,IAAI,KAAK,SAAS,CAAC,WAAW,EAAE;QACjD,CAAC,CAAC,KAAK,SAAS,CAAC,IAAI,KAAK,SAAS,CAAC,OAAO,MAAM,SAAS,CAAC,WAAW,EAAE,CAAC;AAC7E,CAAC;AAED,SAAS,+BAA+B,CAAC,KAAyB;IAChE,OAAO,UAAU,KAAK,CAAC,OAAO,MAAM,KAAK,CAAC,QAAQ,CAAC,OAAO,EAAE,EAAE,CAAC;AACjE,CAAC"}

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

@@ -0,0 +1,31 @@
+import { type ToolSet } from "ai";
+import type { RuntimeSandboxToolSandbox } from "../../../sandboxes/types.js";
+import type { PreparedRuntimeActionTool, PreparedRuntimeTool } from "../../../sessions/turn.js";
+import type { HarnessWorkspace } from "../../workspace/types.js";
+/**
+ * Converts runtime-owned model tool descriptors into AI SDK tool definitions
+ * without execute handlers.
+ *
+ * Omitting `execute` keeps authored tool code out of the harness so turns pause on tool results
+ * instead of running user logic inline.
+ */
+export declare function createModelTools(tools: readonly (PreparedRuntimeActionTool | PreparedRuntimeTool)[]): ToolSet;
+/**
+ * Wraps the runtime-owned workspace sandbox with `createBashTool` to produce an AI SDK
+ * bash tool definition.
+ */
+export declare function createRuntimeBashTool(workspace: HarnessWorkspace): Promise<import("ai").Tool<{
+    command: string;
+}, import("bash-tool").CommandResult>>;
+/**
+ * Wraps one runtime-owned sandbox with `createBashTool` to produce an AI SDK
+ * bash-style tool definition.
+ */
+export declare function createRuntimeSandboxTool(input: {
+    readonly cwd: string;
+    readonly extraInstructions?: string;
+    readonly sandbox: RuntimeSandboxToolSandbox;
+}): Promise<import("ai").Tool<{
+    command: string;
+}, import("bash-tool").CommandResult>>;
+//# sourceMappingURL=runtime-tools.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"runtime-tools.d.ts","sourceRoot":"","sources":["../../../../../../src/runtime/harness/tool-loop/internal/runtime-tools.ts"],"names":[],"mappings":"AAAA,OAAO,EAAc,KAAK,OAAO,EAAQ,MAAM,IAAI,CAAC;AAEpD,OAAO,KAAK,EAAE,yBAAyB,EAAE,MAAM,6BAA6B,CAAC;AAC7E,OAAO,KAAK,EAAE,yBAAyB,EAAE,mBAAmB,EAAE,MAAM,2BAA2B,CAAC;AAChG,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,0BAA0B,CAAC;AAkBjE;;;;;;GAMG;AACH,wBAAgB,gBAAgB,CAC9B,KAAK,EAAE,SAAS,CAAC,yBAAyB,GAAG,mBAAmB,CAAC,EAAE,GAClE,OAAO,CAeT;AAED;;;GAGG;AACH,wBAAsB,qBAAqB,CAAC,SAAS,EAAE,gBAAgB;;uCAqBtE;AAED;;;GAGG;AACH,wBAAsB,wBAAwB,CAAC,KAAK,EAAE;IACpD,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,iBAAiB,CAAC,EAAE,MAAM,CAAC;IACpC,QAAQ,CAAC,OAAO,EAAE,yBAAyB,CAAC;CAC7C;;uCAYA"}

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

@@ -0,0 +1,86 @@
+import { jsonSchema, tool } from "ai";
+const DEFAULT_RUNTIME_TOOL_INPUT_SCHEMA = {
+    additionalProperties: true,
+    properties: {},
+    type: "object",
+};
+const PARALLEL_TOOL_CALL_DESCRIPTION = "If you call multiple tools or subagents in one response, Ash executes them in parallel. Only batch work that is independent and safe to run concurrently.";
+const ASH_BASH_TOOL_PROMPT = [
+    "Shell environment notes:",
+    "- Use standard Unix shell commands for filesystem inspection and text processing.",
+    "- Common utilities often include `ls`, `find`, `grep`, `sed`, `awk`, `cat`, `head`, `tail`, `sort`, `uniq`, `cut`, `tr`, `wc`, and `diff`.",
+    "- Other binaries may be available depending on the workspace or sandbox image, such as `git`, `node`, `bun`, `python`, `jq`, `yq`, and `curl`.",
+    "- Before relying on a non-trivial binary, verify it with `command -v <name>` or a direct command invocation.",
+].join("\n");
+/**
+ * Converts runtime-owned model tool descriptors into AI SDK tool definitions
+ * without execute handlers.
+ *
+ * Omitting `execute` keeps authored tool code out of the harness so turns pause on tool results
+ * instead of running user logic inline.
+ */
+export function createModelTools(tools) {
+    const runtimeTools = {};
+    for (const runtimeTool of tools) {
+        if (runtimeTool.name in runtimeTools) {
+            throw new Error(`Tool "${runtimeTool.name}" is already defined for this ToolLoop fragment.`);
+        }
+        runtimeTools[runtimeTool.name] = tool({
+            description: createRuntimeToolDescription(runtimeTool.description),
+            inputSchema: jsonSchema(resolveRuntimeToolInputSchema(runtimeTool.inputSchema)),
+        });
+    }
+    return runtimeTools;
+}
+/**
+ * Wraps the runtime-owned workspace sandbox with `createBashTool` to produce an AI SDK
+ * bash tool definition.
+ */
+export async function createRuntimeBashTool(workspace) {
+    return await createRuntimeSandboxTool({
+        cwd: workspace.cwd,
+        extraInstructions: workspace.extraInstructions,
+        sandbox: {
+            async executeCommand(command) {
+                return await workspace.sandbox.exec(command);
+            },
+            async readFile(path) {
+                return await workspace.sandbox.fs.readFile(path);
+            },
+            async writeFiles(files) {
+                for (const file of files) {
+                    const content = typeof file.content === "string" ? file.content : file.content.toString("utf8");
+                    await workspace.sandbox.fs.writeFile(file.path, content);
+                }
+            },
+        },
+    });
+}
+/**
+ * Wraps one runtime-owned sandbox with `createBashTool` to produce an AI SDK
+ * bash-style tool definition.
+ */
+export async function createRuntimeSandboxTool(input) {
+    const { createBashTool } = await import("bash-tool");
+    const { tools } = await createBashTool({
+        destination: input.cwd,
+        extraInstructions: input.extraInstructions,
+        promptOptions: {
+            toolPrompt: ASH_BASH_TOOL_PROMPT,
+        },
+        sandbox: input.sandbox,
+    });
+    return tools.bash;
+}
+function isJsonObjectRecord(value) {
+    return typeof value === "object" && value !== null && !Array.isArray(value);
+}
+function resolveRuntimeToolInputSchema(inputSchema) {
+    return isJsonObjectRecord(inputSchema) ? inputSchema : DEFAULT_RUNTIME_TOOL_INPUT_SCHEMA;
+}
+function createRuntimeToolDescription(description) {
+    return description === null
+        ? PARALLEL_TOOL_CALL_DESCRIPTION
+        : `${description}\n\n${PARALLEL_TOOL_CALL_DESCRIPTION}`;
+}
+//# sourceMappingURL=runtime-tools.js.map

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

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

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

@@ -0,0 +1,47 @@
+import { type RuntimeActionRequest } from "../../../actions/types.js";
+import type { HarnessContinuationState, HarnessSessionState, HarnessTokenUsage } from "../../types.js";
+import { type ToolLoopTranscriptMessage } from "./transcript.js";
+declare const TOOL_LOOP_CONTINUATION_KIND = "tool-loop-continuation";
+declare const TOOL_LOOP_CONTINUATION_VERSION = 2;
+declare const TOOL_LOOP_SESSION_KIND = "tool-loop-session";
+declare const TOOL_LOOP_SESSION_VERSION = 1;
+/**
+ * Serializable continuation payload persisted while waiting on runtime action results.
+ */
+export interface ToolLoopContinuationState {
+    readonly kind: typeof TOOL_LOOP_CONTINUATION_KIND;
+    readonly pendingActions: readonly RuntimeActionRequest[];
+    readonly transcript: readonly ToolLoopTranscriptMessage[];
+    readonly usage: HarnessTokenUsage | null;
+    readonly version: typeof TOOL_LOOP_CONTINUATION_VERSION;
+}
+/**
+ * Serializable checkpoint payload persisted after each ToolLoop turn boundary.
+ */
+export interface ToolLoopSessionState {
+    readonly kind: typeof TOOL_LOOP_SESSION_KIND;
+    readonly transcript: readonly ToolLoopTranscriptMessage[];
+    readonly version: typeof TOOL_LOOP_SESSION_VERSION;
+}
+/**
+ * Creates one opaque harness continuation value from the authoritative ToolLoop transcript.
+ */
+export declare function createToolLoopContinuationState(input: {
+    readonly pendingActions: readonly RuntimeActionRequest[];
+    readonly transcript: readonly ToolLoopTranscriptMessage[];
+    readonly usage: HarnessTokenUsage | null;
+}): HarnessContinuationState;
+/**
+ * Creates one opaque harness checkpoint from the authoritative ToolLoop transcript.
+ */
+export declare function createToolLoopSessionState(transcript: readonly ToolLoopTranscriptMessage[]): HarnessSessionState;
+/**
+ * Parses one opaque harness continuation state into the ToolLoop-owned shape.
+ */
+export declare function parseToolLoopContinuationState(value: HarnessContinuationState): ToolLoopContinuationState | Error;
+/**
+ * Parses one opaque harness checkpoint into the ToolLoop-owned shape.
+ */
+export declare function parseToolLoopSessionState(value: HarnessSessionState): ToolLoopSessionState | Error;
+export {};
+//# sourceMappingURL=state.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"state.d.ts","sourceRoot":"","sources":["../../../../../../src/runtime/harness/tool-loop/internal/state.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,KAAK,oBAAoB,EAA8B,MAAM,2BAA2B,CAAC;AAGlG,OAAO,KAAK,EACV,wBAAwB,EACxB,mBAAmB,EACnB,iBAAiB,EAClB,MAAM,gBAAgB,CAAC;AACxB,OAAO,EAAE,KAAK,yBAAyB,EAAmC,MAAM,iBAAiB,CAAC;AAElG,QAAA,MAAM,2BAA2B,2BAA2B,CAAC;AAC7D,QAAA,MAAM,8BAA8B,IAAI,CAAC;AACzC,QAAA,MAAM,sBAAsB,sBAAsB,CAAC;AACnD,QAAA,MAAM,yBAAyB,IAAI,CAAC;AAEpC;;GAEG;AACH,MAAM,WAAW,yBAAyB;IACxC,QAAQ,CAAC,IAAI,EAAE,OAAO,2BAA2B,CAAC;IAClD,QAAQ,CAAC,cAAc,EAAE,SAAS,oBAAoB,EAAE,CAAC;IACzD,QAAQ,CAAC,UAAU,EAAE,SAAS,yBAAyB,EAAE,CAAC;IAC1D,QAAQ,CAAC,KAAK,EAAE,iBAAiB,GAAG,IAAI,CAAC;IACzC,QAAQ,CAAC,OAAO,EAAE,OAAO,8BAA8B,CAAC;CACzD;AAED;;GAEG;AACH,MAAM,WAAW,oBAAoB;IACnC,QAAQ,CAAC,IAAI,EAAE,OAAO,sBAAsB,CAAC;IAC7C,QAAQ,CAAC,UAAU,EAAE,SAAS,yBAAyB,EAAE,CAAC;IAC1D,QAAQ,CAAC,OAAO,EAAE,OAAO,yBAAyB,CAAC;CACpD;AAoBD;;GAEG;AACH,wBAAgB,+BAA+B,CAAC,KAAK,EAAE;IACrD,QAAQ,CAAC,cAAc,EAAE,SAAS,oBAAoB,EAAE,CAAC;IACzD,QAAQ,CAAC,UAAU,EAAE,SAAS,yBAAyB,EAAE,CAAC;IAC1D,QAAQ,CAAC,KAAK,EAAE,iBAAiB,GAAG,IAAI,CAAC;CAC1C,GAAG,wBAAwB,CAQ3B;AAED;;GAEG;AACH,wBAAgB,0BAA0B,CACxC,UAAU,EAAE,SAAS,yBAAyB,EAAE,GAC/C,mBAAmB,CAMrB;AAED;;GAEG;AACH,wBAAgB,8BAA8B,CAC5C,KAAK,EAAE,wBAAwB,GAC9B,yBAAyB,GAAG,KAAK,CAanC;AAED;;GAEG;AACH,wBAAgB,yBAAyB,CACvC,KAAK,EAAE,mBAAmB,GACzB,oBAAoB,GAAG,KAAK,CAU9B"}

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

@@ -0,0 +1,71 @@
+import { z } from "zod";
+import { runtimeActionRequestSchema } from "../../../actions/types.js";
+import { formatValidationError } from "../../../validation.js";
+import { harnessTokenUsageSchema } from "../../contracts.js";
+import { toolLoopTranscriptMessageSchema } from "./transcript.js";
+const TOOL_LOOP_CONTINUATION_KIND = "tool-loop-continuation";
+const TOOL_LOOP_CONTINUATION_VERSION = 2;
+const TOOL_LOOP_SESSION_KIND = "tool-loop-session";
+const TOOL_LOOP_SESSION_VERSION = 1;
+const toolLoopContinuationStateSchema = z
+    .object({
+    kind: z.literal(TOOL_LOOP_CONTINUATION_KIND),
+    pendingActions: z.array(runtimeActionRequestSchema),
+    transcript: z.array(toolLoopTranscriptMessageSchema),
+    usage: harnessTokenUsageSchema.nullable().optional(),
+    version: z.literal(TOOL_LOOP_CONTINUATION_VERSION),
+})
+    .strict();
+const toolLoopSessionStateSchema = z
+    .object({
+    kind: z.literal(TOOL_LOOP_SESSION_KIND),
+    transcript: z.array(toolLoopTranscriptMessageSchema),
+    version: z.literal(TOOL_LOOP_SESSION_VERSION),
+})
+    .strict();
+/**
+ * Creates one opaque harness continuation value from the authoritative ToolLoop transcript.
+ */
+export function createToolLoopContinuationState(input) {
+    return {
+        kind: TOOL_LOOP_CONTINUATION_KIND,
+        pendingActions: [...input.pendingActions],
+        transcript: [...input.transcript],
+        usage: input.usage,
+        version: TOOL_LOOP_CONTINUATION_VERSION,
+    };
+}
+/**
+ * Creates one opaque harness checkpoint from the authoritative ToolLoop transcript.
+ */
+export function createToolLoopSessionState(transcript) {
+    return {
+        kind: TOOL_LOOP_SESSION_KIND,
+        transcript: [...transcript],
+        version: TOOL_LOOP_SESSION_VERSION,
+    };
+}
+/**
+ * Parses one opaque harness continuation state into the ToolLoop-owned shape.
+ */
+export function parseToolLoopContinuationState(value) {
+    const parsed = toolLoopContinuationStateSchema.safeParse(value);
+    if (!parsed.success) {
+        return new Error(`Expected a valid ToolLoop continuation state. ${formatValidationError(parsed.error)}`);
+    }
+    return {
+        ...parsed.data,
+        usage: parsed.data.usage ?? null,
+    };
+}
+/**
+ * Parses one opaque harness checkpoint into the ToolLoop-owned shape.
+ */
+export function parseToolLoopSessionState(value) {
+    const parsed = toolLoopSessionStateSchema.safeParse(value);
+    if (!parsed.success) {
+        return new Error(`Expected a valid ToolLoop session checkpoint. ${formatValidationError(parsed.error)}`);
+    }
+    return parsed.data;
+}
+//# sourceMappingURL=state.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"state.js","sourceRoot":"","sources":["../../../../../../src/runtime/harness/tool-loop/internal/state.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,OAAO,EAA6B,0BAA0B,EAAE,MAAM,2BAA2B,CAAC;AAClG,OAAO,EAAE,qBAAqB,EAAE,MAAM,wBAAwB,CAAC;AAC/D,OAAO,EAAE,uBAAuB,EAAE,MAAM,oBAAoB,CAAC;AAM7D,OAAO,EAAkC,+BAA+B,EAAE,MAAM,iBAAiB,CAAC;AAElG,MAAM,2BAA2B,GAAG,wBAAwB,CAAC;AAC7D,MAAM,8BAA8B,GAAG,CAAC,CAAC;AACzC,MAAM,sBAAsB,GAAG,mBAAmB,CAAC;AACnD,MAAM,yBAAyB,GAAG,CAAC,CAAC;AAsBpC,MAAM,+BAA+B,GAAG,CAAC;KACtC,MAAM,CAAC;IACN,IAAI,EAAE,CAAC,CAAC,OAAO,CAAC,2BAA2B,CAAC;IAC5C,cAAc,EAAE,CAAC,CAAC,KAAK,CAAC,0BAA0B,CAAC;IACnD,UAAU,EAAE,CAAC,CAAC,KAAK,CAAC,+BAA+B,CAAC;IACpD,KAAK,EAAE,uBAAuB,CAAC,QAAQ,EAAE,CAAC,QAAQ,EAAE;IACpD,OAAO,EAAE,CAAC,CAAC,OAAO,CAAC,8BAA8B,CAAC;CACnD,CAAC;KACD,MAAM,EAAE,CAAC;AAEZ,MAAM,0BAA0B,GAAG,CAAC;KACjC,MAAM,CAAC;IACN,IAAI,EAAE,CAAC,CAAC,OAAO,CAAC,sBAAsB,CAAC;IACvC,UAAU,EAAE,CAAC,CAAC,KAAK,CAAC,+BAA+B,CAAC;IACpD,OAAO,EAAE,CAAC,CAAC,OAAO,CAAC,yBAAyB,CAAC;CAC9C,CAAC;KACD,MAAM,EAAE,CAAC;AAEZ;;GAEG;AACH,MAAM,UAAU,+BAA+B,CAAC,KAI/C;IACC,OAAO;QACL,IAAI,EAAE,2BAA2B;QACjC,cAAc,EAAE,CAAC,GAAG,KAAK,CAAC,cAAc,CAAC;QACzC,UAAU,EAAE,CAAC,GAAG,KAAK,CAAC,UAAU,CAAC;QACjC,KAAK,EAAE,KAAK,CAAC,KAAK;QAClB,OAAO,EAAE,8BAA8B;KACD,CAAC;AAC3C,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,0BAA0B,CACxC,UAAgD;IAEhD,OAAO;QACL,IAAI,EAAE,sBAAsB;QAC5B,UAAU,EAAE,CAAC,GAAG,UAAU,CAAC;QAC3B,OAAO,EAAE,yBAAyB;KACD,CAAC;AACtC,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,8BAA8B,CAC5C,KAA+B;IAE/B,MAAM,MAAM,GAAG,+BAA+B,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC;IAEhE,IAAI,CAAC,MAAM,CAAC,OAAO,EAAE,CAAC;QACpB,OAAO,IAAI,KAAK,CACd,iDAAiD,qBAAqB,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE,CACvF,CAAC;IACJ,CAAC;IAED,OAAO;QACL,GAAG,MAAM,CAAC,IAAI;QACd,KAAK,EAAE,MAAM,CAAC,IAAI,CAAC,KAAK,IAAI,IAAI;KACjC,CAAC;AACJ,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,yBAAyB,CACvC,KAA0B;IAE1B,MAAM,MAAM,GAAG,0BAA0B,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC;IAE3D,IAAI,CAAC,MAAM,CAAC,OAAO,EAAE,CAAC;QACpB,OAAO,IAAI,KAAK,CACd,iDAAiD,qBAAqB,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE,CACvF,CAAC;IACJ,CAAC;IAED,OAAO,MAAM,CAAC,IAAI,CAAC;AACrB,CAAC"}

package/dist/src/runtime/harness/tool-loop/internal/stream-result.d.ts

@@ -0,0 +1,36 @@
+import type { AssistantModelMessage, LanguageModelUsage, ToolModelMessage } from "ai";
+import { type RuntimeActionRequest } from "../../../actions/types.js";
+import type { PreparedRuntimeActionTool, PreparedRuntimeTool } from "../../../sessions/turn.js";
+import type { HarnessAssistantOutput, HarnessTokenUsage } from "../../types.js";
+import { type ToolLoopModelMessage } from "./model-messages.js";
+interface ToolLoopToolCallLike {
+    readonly input: unknown;
+    readonly toolCallId: string;
+    readonly toolName: string;
+}
+interface ToolLoopGenerateResultLike {
+    readonly response: {
+        readonly messages: readonly (AssistantModelMessage | ToolModelMessage)[];
+    };
+    readonly toolCalls: readonly ToolLoopToolCallLike[];
+    readonly totalUsage: LanguageModelUsage;
+}
+/**
+ * Serializable projection of one ToolLoop agent invocation.
+ */
+export interface ProjectedToolLoopResult {
+    readonly actions: readonly RuntimeActionRequest[];
+    readonly assistantOutput: HarnessAssistantOutput | null;
+    readonly messages: readonly ToolLoopModelMessage[];
+    readonly usage: HarnessTokenUsage | null;
+}
+/**
+ * Projects one AI SDK ToolLoop result into Ash's serializable harness contract.
+ */
+export declare function projectToolLoopResult(input: {
+    readonly result: ToolLoopGenerateResultLike;
+    readonly runtimeActionTools: readonly PreparedRuntimeActionTool[];
+    readonly visibleTools: readonly PreparedRuntimeTool[];
+}): ProjectedToolLoopResult;
+export {};
+//# sourceMappingURL=stream-result.d.ts.map

package/dist/src/runtime/harness/tool-loop/internal/stream-result.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"stream-result.d.ts","sourceRoot":"","sources":["../../../../../../src/runtime/harness/tool-loop/internal/stream-result.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,qBAAqB,EAAE,kBAAkB,EAAE,gBAAgB,EAAE,MAAM,IAAI,CAAC;AACtF,OAAO,EAEL,KAAK,oBAAoB,EAC1B,MAAM,2BAA2B,CAAC;AAEnC,OAAO,KAAK,EAAE,yBAAyB,EAAE,mBAAmB,EAAE,MAAM,2BAA2B,CAAC;AAChG,OAAO,KAAK,EAAE,sBAAsB,EAAE,iBAAiB,EAAE,MAAM,gBAAgB,CAAC;AAChF,OAAO,EAGL,KAAK,oBAAoB,EAC1B,MAAM,qBAAqB,CAAC;AAE7B,UAAU,oBAAoB;IAC5B,QAAQ,CAAC,KAAK,EAAE,OAAO,CAAC;IACxB,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;CAC3B;AAED,UAAU,0BAA0B;IAClC,QAAQ,CAAC,QAAQ,EAAE;QACjB,QAAQ,CAAC,QAAQ,EAAE,SAAS,CAAC,qBAAqB,GAAG,gBAAgB,CAAC,EAAE,CAAC;KAC1E,CAAC;IACF,QAAQ,CAAC,SAAS,EAAE,SAAS,oBAAoB,EAAE,CAAC;IACpD,QAAQ,CAAC,UAAU,EAAE,kBAAkB,CAAC;CACzC;AAED;;GAEG;AACH,MAAM,WAAW,uBAAuB;IACtC,QAAQ,CAAC,OAAO,EAAE,SAAS,oBAAoB,EAAE,CAAC;IAClD,QAAQ,CAAC,eAAe,EAAE,sBAAsB,GAAG,IAAI,CAAC;IACxD,QAAQ,CAAC,QAAQ,EAAE,SAAS,oBAAoB,EAAE,CAAC;IACnD,QAAQ,CAAC,KAAK,EAAE,iBAAiB,GAAG,IAAI,CAAC;CAC1C;AAED;;GAEG;AACH,wBAAgB,qBAAqB,CAAC,KAAK,EAAE;IAC3C,QAAQ,CAAC,MAAM,EAAE,0BAA0B,CAAC;IAC5C,QAAQ,CAAC,kBAAkB,EAAE,SAAS,yBAAyB,EAAE,CAAC;IAClE,QAAQ,CAAC,YAAY,EAAE,SAAS,mBAAmB,EAAE,CAAC;CACvD,GAAG,uBAAuB,CAoB1B"}

package/dist/src/runtime/harness/tool-loop/internal/stream-result.js

@@ -0,0 +1,70 @@
+import { createRuntimeActionRequestFromToolCall, } from "../../../actions/types.js";
+import { jsonObjectSchema } from "../../../json.js";
+import { convertResponseMessages, getToolLoopAssistantText, } from "./model-messages.js";
+/**
+ * Projects one AI SDK ToolLoop result into Ash's serializable harness contract.
+ */
+export function projectToolLoopResult(input) {
+    const messages = convertResponseMessages(input.result.response.messages);
+    const runtimeActionToolsByName = new Map(input.runtimeActionTools.map((runtimeActionTool) => [
+        runtimeActionTool.name,
+        runtimeActionTool,
+    ]));
+    const visibleToolsByName = new Map(input.visibleTools.map((visibleTool) => [visibleTool.name, visibleTool]));
+    return {
+        actions: input.result.toolCalls.map((call) => toRuntimeActionRequest(call, runtimeActionToolsByName, visibleToolsByName)),
+        assistantOutput: getToolLoopAssistantText(messages),
+        messages,
+        usage: toHarnessTokenUsage(input.result.totalUsage),
+    };
+}
+function toHarnessTokenUsage(usage) {
+    const inputTokens = getFiniteNumber(usage.inputTokens);
+    const outputTokens = getFiniteNumber(usage.outputTokens);
+    const totalTokens = getFiniteNumber(usage.totalTokens);
+    return inputTokens === undefined && outputTokens === undefined && totalTokens === undefined
+        ? null
+        : {
+            inputTokens,
+            outputTokens,
+            totalTokens,
+        };
+}
+function getFiniteNumber(value) {
+    return typeof value === "number" && Number.isFinite(value) ? value : undefined;
+}
+function isJsonObject(value) {
+    return jsonObjectSchema.safeParse(value).success;
+}
+function toRuntimeActionRequest(call, runtimeActionToolsByName, visibleToolsByName) {
+    if (!isJsonObject(call.input)) {
+        throw new Error(`Tool call ${call.toolName} produced non-object input that does not match the harness contract.`);
+    }
+    const runtimeActionTool = runtimeActionToolsByName.get(call.toolName);
+    if (runtimeActionTool !== undefined) {
+        return createRuntimeActionRequestFromToolCall({
+            actionKind: runtimeActionTool.actionKind,
+            callId: call.toolCallId,
+            input: call.input,
+        });
+    }
+    const visibleTool = visibleToolsByName.get(call.toolName);
+    if (visibleTool?.kind === "subagent") {
+        return {
+            callId: call.toolCallId,
+            description: visibleTool.description ?? "",
+            input: call.input,
+            kind: "subagent-call",
+            nodeSelector: visibleTool.selector,
+            subagentId: visibleTool.subagentId,
+            subagentName: call.toolName,
+        };
+    }
+    return {
+        callId: call.toolCallId,
+        input: call.input,
+        kind: "tool-call",
+        toolName: call.toolName,
+    };
+}
+//# sourceMappingURL=stream-result.js.map

package/dist/src/runtime/harness/tool-loop/internal/stream-result.js.map

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

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

@@ -0,0 +1,94 @@
+import { z } from "zod";
+import { type JsonValue } from "../../../json.js";
+import type { RuntimeSessionMessage } from "../../../sessions/messages.js";
+/**
+ * Serializable text content persisted for assistant transcript messages.
+ */
+export interface ToolLoopTextPart {
+    readonly text: string;
+    readonly type: "text";
+}
+/**
+ * Serializable tool-call content persisted for assistant transcript messages.
+ */
+export interface ToolLoopToolCallPart {
+    readonly input: JsonValue;
+    readonly toolCallId: string;
+    readonly toolName: string;
+    readonly type: "tool-call";
+}
+/**
+ * Serializable tool-result content persisted for assistant and tool transcript messages.
+ */
+export interface ToolLoopToolResultPart {
+    readonly isError?: boolean;
+    readonly output: JsonValue;
+    readonly toolCallId: string;
+    readonly toolName: string;
+    readonly type: "tool-result";
+}
+/**
+ * Serializable assistant content persisted between ToolLoop harness invocations.
+ */
+export type ToolLoopAssistantContent = string | readonly (ToolLoopTextPart | ToolLoopToolCallPart | ToolLoopToolResultPart)[];
+/**
+ * Serializable system transcript message for the ToolLoop harness.
+ */
+export interface ToolLoopSystemMessage {
+    readonly content: string;
+    readonly role: "system";
+}
+/**
+ * Serializable user transcript message for the ToolLoop harness.
+ */
+export interface ToolLoopUserMessage {
+    readonly content: string;
+    readonly role: "user";
+}
+/**
+ * Serializable assistant transcript message for the ToolLoop harness.
+ */
+export interface ToolLoopAssistantMessage {
+    readonly content: ToolLoopAssistantContent;
+    readonly role: "assistant";
+}
+/**
+ * Serializable tool transcript message for the ToolLoop harness.
+ */
+export interface ToolLoopToolMessage {
+    readonly content: readonly ToolLoopToolResultPart[];
+    readonly role: "tool";
+}
+/**
+ * Authoritative serializable transcript message persisted by the ToolLoop harness.
+ */
+export type ToolLoopTranscriptMessage = ToolLoopAssistantMessage | ToolLoopSystemMessage | ToolLoopToolMessage | ToolLoopUserMessage;
+/**
+ * Backward-compatible alias for the authoritative ToolLoop transcript message.
+ */
+export type ToolLoopModelMessage = ToolLoopTranscriptMessage;
+/**
+ * Zod schema for one serializable ToolLoop transcript message.
+ */
+export declare const toolLoopTranscriptMessageSchema: z.ZodType<ToolLoopTranscriptMessage>;
+/**
+ * Backward-compatible alias for the authoritative ToolLoop transcript schema.
+ */
+export declare const toolLoopModelMessageSchema: z.ZodType<ToolLoopTranscriptMessage, unknown, z.core.$ZodTypeInternals<ToolLoopTranscriptMessage, unknown>>;
+/**
+ * Converts runtime-owned session messages into the ToolLoop transcript format.
+ */
+export declare function createToolLoopTranscript(messages: readonly RuntimeSessionMessage[]): ToolLoopTranscriptMessage[];
+/**
+ * Backward-compatible alias for creating ToolLoop transcript messages.
+ */
+export declare const createToolLoopModelMessages: typeof createToolLoopTranscript;
+/**
+ * Returns true when unknown JSON matches one ToolLoop transcript message.
+ */
+export declare function isToolLoopTranscriptMessage(value: unknown): value is ToolLoopTranscriptMessage;
+/**
+ * Backward-compatible alias for checking ToolLoop transcript messages.
+ */
+export declare const isToolLoopModelMessage: typeof isToolLoopTranscriptMessage;
+//# sourceMappingURL=transcript.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"transcript.d.ts","sourceRoot":"","sources":["../../../../../../src/runtime/harness/tool-loop/internal/transcript.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,KAAK,SAAS,EAAmB,MAAM,kBAAkB,CAAC;AACnE,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,+BAA+B,CAAC;AAE3E;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;CACvB;AAED;;GAEG;AACH,MAAM,WAAW,oBAAoB;IACnC,QAAQ,CAAC,KAAK,EAAE,SAAS,CAAC;IAC1B,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,IAAI,EAAE,WAAW,CAAC;CAC5B;AAED;;GAEG;AACH,MAAM,WAAW,sBAAsB;IACrC,QAAQ,CAAC,OAAO,CAAC,EAAE,OAAO,CAAC;IAC3B,QAAQ,CAAC,MAAM,EAAE,SAAS,CAAC;IAC3B,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,IAAI,EAAE,aAAa,CAAC;CAC9B;AAED;;GAEG;AACH,MAAM,MAAM,wBAAwB,GAChC,MAAM,GACN,SAAS,CAAC,gBAAgB,GAAG,oBAAoB,GAAG,sBAAsB,CAAC,EAAE,CAAC;AAElF;;GAEG;AACH,MAAM,WAAW,qBAAqB;IACpC,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,IAAI,EAAE,QAAQ,CAAC;CACzB;AAED;;GAEG;AACH,MAAM,WAAW,mBAAmB;IAClC,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;CACvB;AAED;;GAEG;AACH,MAAM,WAAW,wBAAwB;IACvC,QAAQ,CAAC,OAAO,EAAE,wBAAwB,CAAC;IAC3C,QAAQ,CAAC,IAAI,EAAE,WAAW,CAAC;CAC5B;AAED;;GAEG;AACH,MAAM,WAAW,mBAAmB;IAClC,QAAQ,CAAC,OAAO,EAAE,SAAS,sBAAsB,EAAE,CAAC;IACpD,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;CACvB;AAED;;GAEG;AACH,MAAM,MAAM,yBAAyB,GACjC,wBAAwB,GACxB,qBAAqB,GACrB,mBAAmB,GACnB,mBAAmB,CAAC;AAExB;;GAEG;AACH,MAAM,MAAM,oBAAoB,GAAG,yBAAyB,CAAC;AAuC7D;;GAEG;AACH,eAAO,MAAM,+BAA+B,EAAE,CAAC,CAAC,OAAO,CAAC,yBAAyB,CA0B7E,CAAC;AAEL;;GAEG;AACH,eAAO,MAAM,0BAA0B,6GAAkC,CAAC;AAE1E;;GAEG;AACH,wBAAgB,wBAAwB,CACtC,QAAQ,EAAE,SAAS,qBAAqB,EAAE,GACzC,yBAAyB,EAAE,CAsB7B;AAED;;GAEG;AACH,eAAO,MAAM,2BAA2B,iCAA2B,CAAC;AAEpE;;GAEG;AACH,wBAAgB,2BAA2B,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,yBAAyB,CAE9F;AAED;;GAEG;AACH,eAAO,MAAM,sBAAsB,oCAA8B,CAAC"}

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

@@ -0,0 +1,107 @@
+import { z } from "zod";
+import { jsonValueSchema } from "../../../json.js";
+const toolLoopTextPartSchema = z
+    .object({
+    text: z.string(),
+    type: z.literal("text"),
+})
+    .strict();
+const toolLoopToolCallPartSchema = z
+    .object({
+    input: jsonValueSchema,
+    toolCallId: z.string(),
+    toolName: z.string(),
+    type: z.literal("tool-call"),
+})
+    .strict();
+const toolLoopToolResultPartSchema = z
+    .object({
+    isError: z.boolean().optional(),
+    output: jsonValueSchema,
+    toolCallId: z.string(),
+    toolName: z.string(),
+    type: z.literal("tool-result"),
+})
+    .strict();
+const toolLoopAssistantPartSchema = z.union([
+    toolLoopTextPartSchema,
+    toolLoopToolCallPartSchema,
+    toolLoopToolResultPartSchema,
+]);
+const toolLoopAssistantContentSchema = z.union([
+    z.string(),
+    z.array(toolLoopAssistantPartSchema),
+]);
+/**
+ * Zod schema for one serializable ToolLoop transcript message.
+ */
+export const toolLoopTranscriptMessageSchema = z.discriminatedUnion("role", [
+    z
+        .object({
+        content: toolLoopAssistantContentSchema,
+        role: z.literal("assistant"),
+    })
+        .strict(),
+    z
+        .object({
+        content: z.string(),
+        role: z.literal("system"),
+    })
+        .strict(),
+    z
+        .object({
+        content: z.array(toolLoopToolResultPartSchema),
+        role: z.literal("tool"),
+    })
+        .strict(),
+    z
+        .object({
+        content: z.string(),
+        role: z.literal("user"),
+    })
+        .strict(),
+]);
+/**
+ * Backward-compatible alias for the authoritative ToolLoop transcript schema.
+ */
+export const toolLoopModelMessageSchema = toolLoopTranscriptMessageSchema;
+/**
+ * Converts runtime-owned session messages into the ToolLoop transcript format.
+ */
+export function createToolLoopTranscript(messages) {
+    return messages.map((message) => {
+        switch (message.role) {
+            case "assistant":
+                return {
+                    content: message.content,
+                    role: "assistant",
+                };
+            case "system":
+                return {
+                    content: message.content,
+                    role: "system",
+                };
+            case "user":
+                return {
+                    content: message.content,
+                    role: "user",
+                };
+        }
+        throw new Error(`Unsupported runtime session message role "${String(message)}".`);
+    });
+}
+/**
+ * Backward-compatible alias for creating ToolLoop transcript messages.
+ */
+export const createToolLoopModelMessages = createToolLoopTranscript;
+/**
+ * Returns true when unknown JSON matches one ToolLoop transcript message.
+ */
+export function isToolLoopTranscriptMessage(value) {
+    return toolLoopTranscriptMessageSchema.safeParse(value).success;
+}
+/**
+ * Backward-compatible alias for checking ToolLoop transcript messages.
+ */
+export const isToolLoopModelMessage = isToolLoopTranscriptMessage;
+//# sourceMappingURL=transcript.js.map