experimental-ash 0.26.0 → 0.28.0

package/dist/src/runtime/agent/mock-model-adapter.js

@@ -1,358 +1,7 @@
-import { MockLanguageModelV3 } from "ai/test";
-import { z } from "#compiled/zod/index.js";
-import { BOOTSTRAP_RUNTIME_MODEL_ID, BOOTSTRAP_RUNTIME_SYSTEM_PROMPT, } from "#runtime/agent/bootstrap.js";
-import { createBootstrapGenerateResult, createBootstrapStreamResult, estimateTokenCount, getLastUserPromptText, getPromptContentText, getPromptText, } from "#runtime/agent/bootstrap-model-utils.js";
-import { LOAD_SKILL_TOOL_NAME } from "#runtime/skills/fragment-context.js";
-const MOCK_RUNTIME_MODEL_PROVIDER = "ash-runtime-mock";
-const LOAD_SKILL_TOOL_CALL_ID = "call_load_skill";
-const GET_WEATHER_TOOL_CALL_ID = "call_get_weather";
-const authoredRuntimeModelMocks = new Map();
-const bootstrapWeatherPayloadSchema = z
-    .object({
-    city: z.string(),
-    condition: z.string(),
-    summary: z.string(),
-    temperatureF: z.number().finite(),
-})
-    .strict();
-/**
- * Environment variable that forces authored runtime models onto the dedicated
- * deterministic mock adapter.
- */
-export const ASH_MOCK_AUTHORED_MODELS_ENV = "ASH_MOCK_AUTHORED_MODELS";
-/**
- * Returns true when authored runtime models should resolve through the
- * dedicated deterministic mock adapter.
- */
-export function shouldMockAuthoredRuntimeModels() {
-    return process.env[ASH_MOCK_AUTHORED_MODELS_ENV] === "1" || process.env.NODE_ENV === "test";
-}
-/**
- * Creates a deterministic authored-model mock for one runtime model reference.
- */
-export function createMockAuthoredRuntimeModel(reference) {
-    const existingModel = authoredRuntimeModelMocks.get(reference.id);
-    if (existingModel !== undefined) {
-        return existingModel;
-    }
-    const model = new MockLanguageModelV3({
-        modelId: reference.id,
-        provider: MOCK_RUNTIME_MODEL_PROVIDER,
-        doGenerate: async (options) => createMockModelResult(options, reference.id),
-        doStream: async (options) => createBootstrapStreamResult(createMockModelResult(options, reference.id)),
-    });
-    authoredRuntimeModelMocks.set(reference.id, model);
-    return model;
-}
-function createMockModelResult(options, modelId) {
-    const authoredToolResult = getLastAuthoredToolResult(options.prompt);
-    if (authoredToolResult !== null) {
-        const text = formatToolResultReply(authoredToolResult, options.prompt);
-        return createBootstrapGenerateResult({
-            inputTokens: estimateTokenCount(getPromptText(options.prompt)),
-            modelId,
-            outputTokens: estimateTokenCount(text),
-            text,
-        });
-    }
-    const loadResult = createSkillLoadResult(options.prompt, modelId);
-    if (loadResult !== null) {
-        return loadResult;
-    }
-    const authoredToolCallResult = createAuthoredToolCallResult(options, modelId);
-    if (authoredToolCallResult !== null) {
-        return authoredToolCallResult;
-    }
-    const text = createAssistantMessage(options.prompt);
-    return createBootstrapGenerateResult({
-        inputTokens: estimateTokenCount(getPromptText(options.prompt)),
-        modelId,
-        outputTokens: estimateTokenCount(text),
-        text,
-    });
-}
-/**
- * Resolves the current authored runtime model onto the deterministic mock
- * adapter when the test seam is active.
- */
-export function resolveMockAuthoredRuntimeModel(reference) {
-    if (!shouldMockAuthoredRuntimeModels() || reference.id === BOOTSTRAP_RUNTIME_MODEL_ID) {
-        return null;
-    }
-    return createMockAuthoredRuntimeModel(reference);
-}
-function createSkillLoadResult(prompt, modelId) {
-    const lastUserMessage = getLastUserPromptText(prompt);
-    if (lastUserMessage === null || getActivatedSkillIds(prompt).length > 0) {
-        return null;
-    }
-    const skill = findRelevantSkill(getAvailableSkills(prompt), lastUserMessage);
-    if (skill === null) {
-        return null;
-    }
-    return createToolCallGenerateResult({
-        input: {
-            skill: skill.name,
-        },
-        inputTokens: estimateTokenCount(getPromptText(prompt)),
-        modelId,
-        outputTokens: estimateTokenCount(skill.name),
-        toolCallId: LOAD_SKILL_TOOL_CALL_ID,
-        toolName: LOAD_SKILL_TOOL_NAME,
-    });
-}
-function createAuthoredToolCallResult(options, modelId) {
-    const lastUserMessage = getLastUserPromptText(options.prompt);
-    if (lastUserMessage === null) {
-        return null;
-    }
-    const tool = findRelevantTool(getAvailableTools(options), lastUserMessage);
-    if (tool === null) {
-        return null;
-    }
-    const city = resolveWeatherCity(lastUserMessage);
-    return createToolCallGenerateResult({
-        input: {
-            city,
-        },
-        inputTokens: estimateTokenCount(getPromptText(options.prompt)),
-        modelId,
-        outputTokens: estimateTokenCount(city),
-        toolCallId: GET_WEATHER_TOOL_CALL_ID,
-        toolName: tool.name,
-    });
-}
-function createAssistantMessage(prompt) {
-    const lastUserMessage = getLastUserPromptText(prompt) ?? "Hello from Ash";
-    const systemLabels = getSystemPromptLabels(prompt);
-    const systemProbe = resolveSystemProbe(prompt);
-    if (systemLabels.length > 0) {
-        if (systemProbe === null) {
-            return `Bootstrap reply [${systemLabels.join(", ")}]: ${lastUserMessage}`;
-        }
-        return `Bootstrap reply [${systemLabels.join(", ")}; probe=${systemProbe}]: ${lastUserMessage}`;
-    }
-    if (systemProbe !== null) {
-        return `Bootstrap reply [probe=${systemProbe}]: ${lastUserMessage}`;
-    }
-    return `Bootstrap reply: ${lastUserMessage}`;
-}
-function formatToolResultReply(result, prompt) {
-    if (result.isError) {
-        return `Local weather tool failed: ${formatToolOutput(result.output)}`;
-    }
-    if (isWeatherPayload(result.output)) {
-        return `Used local weather tool for ${result.output.city}: ${result.output.condition}, ${result.output.temperatureF}F. ${result.output.summary}`;
-    }
-    const lastUserMessage = getLastUserPromptText(prompt) ?? "Hello from Ash";
-    return `Used ${result.toolName} for "${lastUserMessage}": ${formatToolOutput(result.output)}`;
-}
-function createToolCallGenerateResult(input) {
-    return {
-        content: [
-            {
-                input: JSON.stringify(input.input),
-                toolCallId: input.toolCallId,
-                toolName: input.toolName,
-                type: "tool-call",
-            },
-        ],
-        finishReason: "tool-calls",
-        response: {
-            id: "bootstrap-response",
-            modelId: input.modelId,
-            timestamp: new Date("2026-03-16T00:00:00.000Z"),
-        },
-        usage: {
-            inputTokens: {
-                cacheRead: 0,
-                cacheWrite: 0,
-                noCache: input.inputTokens,
-                total: input.inputTokens,
-            },
-            outputTokens: {
-                reasoning: 0,
-                text: input.outputTokens,
-                total: input.outputTokens,
-            },
-        },
-        warnings: [],
-    };
-}
-function getAvailableTools(options) {
-    return (options.tools ?? []).flatMap((tool) => {
-        if (tool.type !== "function") {
-            return [];
-        }
-        return [
-            {
-                description: tool.description,
-                name: tool.name,
-            },
-        ];
-    });
-}
-function getLastAuthoredToolResult(prompt) {
-    for (const message of [...prompt].reverse()) {
-        if (message.role !== "tool" && message.role !== "assistant") {
-            continue;
-        }
-        for (const part of [...message.content].reverse()) {
-            if (typeof part === "string" || part.type !== "tool-result") {
-                continue;
-            }
-            if (part.toolName === LOAD_SKILL_TOOL_NAME) {
-                continue;
-            }
-            return {
-                isError: part.output.type === "error-json" ||
-                    part.output.type === "error-text" ||
-                    part.output.type === "execution-denied",
-                output: part.output.type === "execution-denied"
-                    ? {
-                        reason: part.output.reason ?? null,
-                        type: part.output.type,
-                    }
-                    : part.output.value,
-                toolCallId: part.toolCallId,
-                toolName: part.toolName,
-            };
-        }
-    }
-    return null;
-}
-function getSystemPromptLabels(prompt) {
-    const systemMessages = prompt.filter((message) => message.role === "system");
-    if (systemMessages.length === 0) {
-        return [];
-    }
-    const labels = systemMessages.flatMap((message) => {
-        const text = getPromptContentText(message.content);
-        if (text.startsWith("Available skills\n")) {
-            return [];
-        }
-        const lines = text
-            .split("\n")
-            .map((line) => line.trim())
-            .filter((line) => line.length > 0);
-        const extractedLabels = [];
-        for (const line of lines) {
-            if (line === BOOTSTRAP_RUNTIME_SYSTEM_PROMPT || line === "Available skills") {
-                continue;
-            }
-            const systemMatch = /^System \((.+)\)$/.exec(line);
-            if (systemMatch?.[1]) {
-                extractedLabels.push(systemMatch[1]);
-                continue;
-            }
-            const skillMatch = /^Skill \((.+)\)$/.exec(line);
-            if (skillMatch?.[1]) {
-                extractedLabels.push(skillMatch[1]);
-            }
-        }
-        if (extractedLabels.length > 0) {
-            return extractedLabels;
-        }
-        const fallbackFirstLine = lines.find((line) => line !== BOOTSTRAP_RUNTIME_SYSTEM_PROMPT && line !== "Available skills");
-        return fallbackFirstLine === undefined ? [] : [fallbackFirstLine];
-    });
-    return [...new Set(labels)];
-}
-function getActivatedSkillIds(prompt) {
-    return prompt
-        .filter((message) => message.role === "system")
-        .flatMap((message) => {
-        return getPromptContentText(message.content)
-            .split("\n")
-            .map((line) => line.trim())
-            .flatMap((line) => {
-            const skillMatch = /^Skill \((.+)\)$/.exec(line);
-            return skillMatch?.[1] === undefined ? [] : [skillMatch[1]];
-        });
-    });
-}
-function getAvailableSkills(prompt) {
-    const skillsById = new Map();
-    for (const message of prompt) {
-        if (message.role !== "system") {
-            continue;
-        }
-        const text = getPromptContentText(message.content);
-        if (!text.startsWith("Available skills\n")) {
-            continue;
-        }
-        for (const line of text.split("\n").slice(1)) {
-            const skill = parseAvailableSkill(line);
-            if (skill !== null) {
-                skillsById.set(skill.name, skill);
-            }
-        }
-    }
-    return [...skillsById.values()];
-}
-function parseAvailableSkill(line) {
-    const directSkillMatch = /^- (.+?): (.+?)(?: \(path: (.+)\))?$/.exec(line.trim());
-    if (directSkillMatch?.[1] && directSkillMatch[2]) {
-        return {
-            description: directSkillMatch[2],
-            name: directSkillMatch[1],
-        };
-    }
-    return null;
-}
-function findRelevantTool(tools, message) {
-    const normalizedMessage = normalizeText(message);
-    if (!/\b(forecast|temperature|weather|wind|rain|snow)\b/u.test(normalizedMessage)) {
-        return null;
-    }
-    return (tools.find((tool) => /\b(forecast|temperature|weather|wind|rain|snow)\b/u.test(normalizeText(`${tool.name} ${tool.description ?? ""}`))) ?? null);
-}
-function findRelevantSkill(skills, message) {
-    const normalizedMessage = normalizeText(message);
-    for (const skill of skills) {
-        if (normalizedMessage.includes(normalizeText(skill.name))) {
-            return skill;
-        }
-    }
-    if (!/\b(forecast|temperature|weather|wind|rain|snow)\b/u.test(normalizedMessage)) {
-        return null;
-    }
-    return (skills.find((skill) => /\b(forecast|temperature|weather|wind|rain|snow)\b/u.test(normalizeText(`${skill.name} ${skill.description}`))) ?? null);
-}
-function normalizeText(value) {
-    return value
-        .toLowerCase()
-        .replace(/[^a-z0-9]+/gu, " ")
-        .trim();
-}
-function resolveSystemProbe(prompt) {
-    const systemText = prompt
-        .filter((message) => message.role === "system")
-        .map((message) => getPromptContentText(message.content))
-        .join("\n");
-    const probeMatch = /hmr-probe:\s*([^\n]+)/iu.exec(systemText);
-    return probeMatch?.[1]?.trim() || null;
-}
-function resolveWeatherCity(message) {
-    const invocationJsonCityMatch = /"city"\s*:\s*"([^"]+)"/u.exec(message);
-    if (invocationJsonCityMatch?.[1]) {
-        return invocationJsonCityMatch[1].trim();
-    }
-    const cityMatch = /\b(?:in|for)\s+([A-Za-z][A-Za-z\s.-]*?)(?:[?.!,]|$)/u.exec(message) ??
-        /\b([A-Z][a-z]+(?:\s+[A-Z][a-z]+)*)\b/u.exec(message);
-    return cityMatch?.[1]?.trim() || "Brooklyn";
-}
-function isWeatherPayload(value) {
-    return bootstrapWeatherPayloadSchema.safeParse(value).success;
-}
-function formatToolOutput(output) {
-    if (typeof output === "string") {
-        return output;
-    }
-    try {
-        return JSON.stringify(output);
-    }
-    catch {
-        return String(output);
-    }
-}
+import{z}from"#compiled/zod/index.js";import{MockLanguageModelV3}from"ai/test";import{BOOTSTRAP_RUNTIME_MODEL_ID,BOOTSTRAP_RUNTIME_SYSTEM_PROMPT}from"#runtime/agent/bootstrap.js";import{createBootstrapGenerateResult,createBootstrapStreamResult,estimateTokenCount,getLastUserPromptText,getPromptContentText,getPromptText}from"#runtime/agent/bootstrap-model-utils.js";import{LOAD_SKILL_TOOL_NAME}from"#runtime/skills/fragment-context.js";var MOCK_RUNTIME_MODEL_PROVIDER=`ash-runtime-mock`,LOAD_SKILL_TOOL_CALL_ID=`call_load_skill`,GET_WEATHER_TOOL_CALL_ID=`call_get_weather`,authoredRuntimeModelMocks=new Map,bootstrapWeatherPayloadSchema=z.object({city:z.string(),condition:z.string(),summary:z.string(),temperatureF:z.number().finite()}).strict(),ASH_MOCK_AUTHORED_MODELS_ENV=`ASH_MOCK_AUTHORED_MODELS`;function shouldMockAuthoredRuntimeModels(){return process.env.ASH_MOCK_AUTHORED_MODELS===`1`||process.env.NODE_ENV===`test`}function createMockAuthoredRuntimeModel(e){let n=authoredRuntimeModelMocks.get(e.id);if(n!==void 0)return n;let r=new MockLanguageModelV3({modelId:e.id,provider:MOCK_RUNTIME_MODEL_PROVIDER,doGenerate:async t=>createMockModelResult(t,e.id),doStream:async t=>createBootstrapStreamResult(createMockModelResult(t,e.id))});return authoredRuntimeModelMocks.set(e.id,r),r}function createMockModelResult(e,t){let n=getLastAuthoredToolResult(e.prompt);if(n!==null){let r=formatToolResultReply(n,e.prompt);return createBootstrapGenerateResult({inputTokens:estimateTokenCount(getPromptText(e.prompt)),modelId:t,outputTokens:estimateTokenCount(r),text:r})}let r=createSkillLoadResult(e.prompt,t);if(r!==null)return r;let a=createAuthoredToolCallResult(e,t);if(a!==null)return a;let o=createAssistantMessage(e.prompt);return createBootstrapGenerateResult({inputTokens:estimateTokenCount(getPromptText(e.prompt)),modelId:t,outputTokens:estimateTokenCount(o),text:o})}function resolveMockAuthoredRuntimeModel(e){return!shouldMockAuthoredRuntimeModels()||e.id===BOOTSTRAP_RUNTIME_MODEL_ID?null:createMockAuthoredRuntimeModel(e)}function createSkillLoadResult(e,t){let n=getLastUserPromptText(e);if(n===null||getActivatedSkillIds(e).length>0)return null;let r=findRelevantSkill(getAvailableSkills(e),n);return r===null?null:createToolCallGenerateResult({input:{skill:r.name},inputTokens:estimateTokenCount(getPromptText(e)),modelId:t,outputTokens:estimateTokenCount(r.name),toolCallId:LOAD_SKILL_TOOL_CALL_ID,toolName:LOAD_SKILL_TOOL_NAME})}function createAuthoredToolCallResult(e,t){let n=getLastUserPromptText(e.prompt);if(n===null)return null;let r=findRelevantTool(getAvailableTools(e),n);if(r===null)return null;let i=resolveWeatherCity(n);return createToolCallGenerateResult({input:{city:i},inputTokens:estimateTokenCount(getPromptText(e.prompt)),modelId:t,outputTokens:estimateTokenCount(i),toolCallId:GET_WEATHER_TOOL_CALL_ID,toolName:r.name})}function createAssistantMessage(e){let t=getLastUserPromptText(e)??`Hello from Ash`,n=getSystemPromptLabels(e),r=resolveSystemProbe(e);return n.length>0?r===null?`Bootstrap reply [${n.join(`, `)}]: ${t}`:`Bootstrap reply [${n.join(`, `)}; probe=${r}]: ${t}`:r===null?`Bootstrap reply: ${t}`:`Bootstrap reply [probe=${r}]: ${t}`}function formatToolResultReply(e,t){if(e.isError)return`Local weather tool failed: ${formatToolOutput(e.output)}`;if(isWeatherPayload(e.output))return`Used local weather tool for ${e.output.city}: ${e.output.condition}, ${e.output.temperatureF}F. ${e.output.summary}`;let n=getLastUserPromptText(t)??`Hello from Ash`;return`Used ${e.toolName} for "${n}": ${formatToolOutput(e.output)}`}function createToolCallGenerateResult(e){return{content:[{input:JSON.stringify(e.input),toolCallId:e.toolCallId,toolName:e.toolName,type:`tool-call`}],finishReason:`tool-calls`,response:{id:`bootstrap-response`,modelId:e.modelId,timestamp:new Date(`2026-03-16T00:00:00.000Z`)},usage:{inputTokens:{cacheRead:0,cacheWrite:0,noCache:e.inputTokens,total:e.inputTokens},outputTokens:{reasoning:0,text:e.outputTokens,total:e.outputTokens}},warnings:[]}}function getAvailableTools(e){return(e.tools??[]).flatMap(e=>e.type===`function`?[{description:e.description,name:e.name}]:[])}function getLastAuthoredToolResult(e){for(let t of[...e].reverse())if(!(t.role!==`tool`&&t.role!==`assistant`)){for(let e of[...t.content].reverse())if(!(typeof e==`string`||e.type!==`tool-result`)&&e.toolName!==LOAD_SKILL_TOOL_NAME)return{isError:e.output.type===`error-json`||e.output.type===`error-text`||e.output.type===`execution-denied`,output:e.output.type===`execution-denied`?{reason:e.output.reason??null,type:e.output.type}:e.output.value,toolCallId:e.toolCallId,toolName:e.toolName}}return null}function getSystemPromptLabels(e){let t=e.filter(e=>e.role===`system`);if(t.length===0)return[];let n=t.flatMap(e=>{let t=getPromptContentText(e.content);if(t.startsWith(`Available skills
+`))return[];let n=t.split(`
+`).map(e=>e.trim()).filter(e=>e.length>0),i=[];for(let e of n){if(e===BOOTSTRAP_RUNTIME_SYSTEM_PROMPT||e===`Available skills`)continue;let t=/^System \((.+)\)$/.exec(e);if(t?.[1]){i.push(t[1]);continue}let n=/^Skill \((.+)\)$/.exec(e);n?.[1]&&i.push(n[1])}if(i.length>0)return i;let a=n.find(e=>e!==BOOTSTRAP_RUNTIME_SYSTEM_PROMPT&&e!==`Available skills`);return a===void 0?[]:[a]});return[...new Set(n)]}function getActivatedSkillIds(e){return e.filter(e=>e.role===`system`).flatMap(e=>getPromptContentText(e.content).split(`
+`).map(e=>e.trim()).flatMap(e=>{let t=/^Skill \((.+)\)$/.exec(e);return t?.[1]===void 0?[]:[t[1]]}))}function getAvailableSkills(e){let t=new Map;for(let n of e){if(n.role!==`system`)continue;let e=getPromptContentText(n.content);if(e.startsWith(`Available skills
+`))for(let n of e.split(`
+`).slice(1)){let e=parseAvailableSkill(n);e!==null&&t.set(e.name,e)}}return[...t.values()]}function parseAvailableSkill(e){let t=/^- (.+?): (.+?)(?: \(path: (.+)\))?$/.exec(e.trim());return t?.[1]&&t[2]?{description:t[2],name:t[1]}:null}function findRelevantTool(e,t){let n=normalizeText(t);return/\b(forecast|temperature|weather|wind|rain|snow)\b/u.test(n)?e.find(e=>/\b(forecast|temperature|weather|wind|rain|snow)\b/u.test(normalizeText(`${e.name} ${e.description??``}`)))??null:null}function findRelevantSkill(e,t){let n=normalizeText(t);for(let t of e)if(n.includes(normalizeText(t.name)))return t;return/\b(forecast|temperature|weather|wind|rain|snow)\b/u.test(n)?e.find(e=>/\b(forecast|temperature|weather|wind|rain|snow)\b/u.test(normalizeText(`${e.name} ${e.description}`)))??null:null}function normalizeText(e){return e.toLowerCase().replace(/[^a-z0-9]+/gu,` `).trim()}function resolveSystemProbe(e){let t=e.filter(e=>e.role===`system`).map(e=>getPromptContentText(e.content)).join(`
+`);return/hmr-probe:\s*([^\n]+)/iu.exec(t)?.[1]?.trim()||null}function resolveWeatherCity(e){let t=/"city"\s*:\s*"([^"]+)"/u.exec(e);return t?.[1]?t[1].trim():(/\b(?:in|for)\s+([A-Za-z][A-Za-z\s.-]*?)(?:[?.!,]|$)/u.exec(e)??/\b([A-Z][a-z]+(?:\s+[A-Z][a-z]+)*)\b/u.exec(e))?.[1]?.trim()||`Brooklyn`}function isWeatherPayload(e){return bootstrapWeatherPayloadSchema.safeParse(e).success}function formatToolOutput(e){if(typeof e==`string`)return e;try{return JSON.stringify(e)}catch{return String(e)}}export{ASH_MOCK_AUTHORED_MODELS_ENV,createMockAuthoredRuntimeModel,resolveMockAuthoredRuntimeModel,shouldMockAuthoredRuntimeModels};

package/dist/src/runtime/agent/resolve-model.js

@@ -1,48 +1 @@
-import { ROOT_COMPILED_AGENT_NODE_ID } from "#compiler/manifest.js";
-import { normalizeAgentDefinition } from "#internal/authored-definition/core.js";
-import { expectObjectRecord, getAuthoredModuleExport, materializeAuthoredModuleExport, } from "#internal/authored-module.js";
-import { loadCompiledModuleMap } from "#runtime/loaders/module-map.js";
-import { resolveBootstrapRuntimeModel } from "#runtime/agent/bootstrap-model.js";
-import { ASH_MOCK_AUTHORED_MODELS_ENV, resolveMockAuthoredRuntimeModel, shouldMockAuthoredRuntimeModels, } from "#runtime/agent/mock-model-adapter.js";
-export { ASH_MOCK_AUTHORED_MODELS_ENV, shouldMockAuthoredRuntimeModels };
-/**
- * Resolves one runtime model reference into the active language model.
- */
-export async function resolveRuntimeModelReference(reference, input = {}) {
-    const bootstrapModel = resolveBootstrapRuntimeModel(reference);
-    if (bootstrapModel !== null) {
-        return bootstrapModel;
-    }
-    const mockModel = resolveMockAuthoredRuntimeModel(reference);
-    if (mockModel !== null) {
-        return mockModel;
-    }
-    if (isSourceBackedRuntimeModelReference(reference)) {
-        return await loadSourceBackedRuntimeModelReference(reference, input);
-    }
-    return reference.id;
-}
-async function loadSourceBackedRuntimeModelReference(reference, input) {
-    if (input.compiledArtifactsSource === undefined) {
-        throw new Error(`Expected an explicit compiled artifact source to resolve the authored runtime model "${reference.id}".`);
-    }
-    const moduleMap = await loadCompiledModuleMap({
-        compiledArtifactsSource: input.compiledArtifactsSource,
-    });
-    const moduleNamespace = moduleMap.nodes[ROOT_COMPILED_AGENT_NODE_ID]?.modules[reference.source.sourceId];
-    const moduleRecord = expectObjectRecord(moduleNamespace, `Missing compiled agent config module for runtime model "${reference.id}" at "${reference.source.logicalPath}".`);
-    const exportValue = getAuthoredModuleExport(moduleRecord, reference.source);
-    const definition = await materializeAuthoredModuleExport(exportValue);
-    const normalizedDefinition = normalizeAgentDefinition(definition, `Expected the authored agent config export "${reference.source.exportName ?? "default"}" from "${reference.source.logicalPath}" to match the public Ash shape.`);
-    const model = normalizedDefinition.model;
-    if (model === undefined) {
-        throw new Error(`Expected the authored agent config export "${reference.source.exportName ?? "default"}" from "${reference.source.logicalPath}" to provide a runtime model.`);
-    }
-    if (typeof model === "string") {
-        return model;
-    }
-    return model;
-}
-function isSourceBackedRuntimeModelReference(reference) {
-    return reference.source !== undefined;
-}
+import{expectObjectRecord,getAuthoredModuleExport,materializeAuthoredModuleExport}from"#internal/authored-module.js";import{ROOT_COMPILED_AGENT_NODE_ID}from"#compiler/manifest.js";import{normalizeAgentDefinition}from"#internal/authored-definition/core.js";import{loadCompiledModuleMap}from"#runtime/loaders/module-map.js";import{resolveBootstrapRuntimeModel}from"#runtime/agent/bootstrap-model.js";import{ASH_MOCK_AUTHORED_MODELS_ENV,resolveMockAuthoredRuntimeModel,shouldMockAuthoredRuntimeModels}from"#runtime/agent/mock-model-adapter.js";async function resolveRuntimeModelReference(e,t={}){let n=resolveBootstrapRuntimeModel(e);if(n!==null)return n;let r=resolveMockAuthoredRuntimeModel(e);return r===null?isSourceBackedRuntimeModelReference(e)?await loadSourceBackedRuntimeModelReference(e,t):e.id:r}async function loadSourceBackedRuntimeModelReference(i,a){if(a.compiledArtifactsSource===void 0)throw Error(`Expected an explicit compiled artifact source to resolve the authored runtime model "${i.id}".`);let o=(await loadCompiledModuleMap({compiledArtifactsSource:a.compiledArtifactsSource})).nodes[ROOT_COMPILED_AGENT_NODE_ID]?.modules[i.source.sourceId],s=normalizeAgentDefinition(await materializeAuthoredModuleExport(getAuthoredModuleExport(expectObjectRecord(o,`Missing compiled agent config module for runtime model "${i.id}" at "${i.source.logicalPath}".`),i.source)),`Expected the authored agent config export "${i.source.exportName??`default`}" from "${i.source.logicalPath}" to match the public Ash shape.`).model;if(s===void 0)throw Error(`Expected the authored agent config export "${i.source.exportName??`default`}" from "${i.source.logicalPath}" to provide a runtime model.`);return s}function isSourceBackedRuntimeModelReference(e){return e.source!==void 0}export{ASH_MOCK_AUTHORED_MODELS_ENV,resolveRuntimeModelReference,shouldMockAuthoredRuntimeModels};

package/dist/src/runtime/cache-key.js

@@ -1,52 +1 @@
-import { getRuntimeCompiledArtifactsCacheKey, } from "#runtime/compiled-artifacts-source.js";
-import { resolveRuntimeCompilerArtifactPaths } from "#runtime/loaders/artifact-paths.js";
-import { loadCompileMetadata } from "#runtime/loaders/compile-metadata.js";
-/**
- * Resolves a cache key for one compiled-artifact source that also fingerprints
- * the current compiled source graph when metadata is available.
- *
- * This lets long-lived processes keep cache hits across turns while still
- * invalidating naturally after recompilation under the same app root.
- */
-export async function resolveRuntimeCompiledArtifactsVersionedCacheKey(source) {
-    const baseKey = getRuntimeCompiledArtifactsCacheKey(source);
-    const compileMetadataMtimeMs = await resolveCompileMetadataMtimeMs(source);
-    try {
-        const metadata = await loadCompileMetadata({
-            compiledArtifactsSource: source,
-        });
-        const sourceGraphHash = metadata?.discovery.sourceGraphHash;
-        if (sourceGraphHash === undefined || sourceGraphHash.length === 0) {
-            if (compileMetadataMtimeMs === undefined) {
-                return baseKey;
-            }
-            return `${baseKey}:mtime-${formatMtimeMsForCacheKey(compileMetadataMtimeMs)}`;
-        }
-        if (compileMetadataMtimeMs === undefined) {
-            return `${baseKey}:${sourceGraphHash}`;
-        }
-        return `${baseKey}:${sourceGraphHash}:mtime-${formatMtimeMsForCacheKey(compileMetadataMtimeMs)}`;
-    }
-    catch {
-        if (compileMetadataMtimeMs === undefined) {
-            return baseKey;
-        }
-        return `${baseKey}:mtime-${formatMtimeMsForCacheKey(compileMetadataMtimeMs)}`;
-    }
-}
-async function resolveCompileMetadataMtimeMs(source) {
-    if (source.kind !== "disk") {
-        return undefined;
-    }
-    const { stat } = await import("node:fs/promises");
-    const { compileMetadataPath } = resolveRuntimeCompilerArtifactPaths(source.appRoot);
-    try {
-        return (await stat(compileMetadataPath)).mtimeMs;
-    }
-    catch {
-        return undefined;
-    }
-}
-function formatMtimeMsForCacheKey(value) {
-    return Math.floor(value).toString(36);
-}
+import{getRuntimeCompiledArtifactsCacheKey}from"#runtime/compiled-artifacts-source.js";import{resolveRuntimeCompilerArtifactPaths}from"#runtime/loaders/artifact-paths.js";import{loadCompileMetadata}from"#runtime/loaders/compile-metadata.js";async function resolveRuntimeCompiledArtifactsVersionedCacheKey(t){let r=getRuntimeCompiledArtifactsCacheKey(t),i=await resolveCompileMetadataMtimeMs(t);try{let e=(await loadCompileMetadata({compiledArtifactsSource:t}))?.discovery.sourceGraphHash;return e===void 0||e.length===0?i===void 0?r:`${r}:mtime-${formatMtimeMsForCacheKey(i)}`:i===void 0?`${r}:${e}`:`${r}:${e}:mtime-${formatMtimeMsForCacheKey(i)}`}catch{return i===void 0?r:`${r}:mtime-${formatMtimeMsForCacheKey(i)}`}}async function resolveCompileMetadataMtimeMs(e){if(e.kind!==`disk`)return;let{stat:n}=await import(`node:fs/promises`),{compileMetadataPath:r}=resolveRuntimeCompilerArtifactPaths(e.appRoot);try{return(await n(r)).mtimeMs}catch{return}}function formatMtimeMsForCacheKey(e){return Math.floor(e).toString(36)}export{resolveRuntimeCompiledArtifactsVersionedCacheKey};

package/dist/src/runtime/channels/registry.js

@@ -1,133 +1 @@
-import { getAdapterKind } from "#channel/adapter.js";
-import { HTTP_ADAPTER } from "#channel/http.js";
-import { SCHEDULE_ADAPTER } from "#channel/schedule.js";
-import { SUBAGENT_ADAPTER } from "#execution/subagent-adapter.js";
-import { RuntimeRegistryError } from "#internal/runtime-registry.js";
-/**
- * Framework-provided adapter configs.
- *
- * Framework kinds cannot be shadowed with route-authored behavior.
- */
-const FRAMEWORK_ADAPTERS = [
-    HTTP_ADAPTER,
-    SUBAGENT_ADAPTER,
-    SCHEDULE_ADAPTER,
-];
-/**
- * Non-event-handler fields on a {@link ChannelAdapter}. Any other
- * key on the adapter object corresponds to a stream event handler
- * keyed by event type (see {@link ChannelEventHandlers}). Used by
- * {@link carriesAdapterBehavior} to detect whether a route-declared
- * adapter contributes behavior beyond the bare `kind`.
- */
-const ADAPTER_NON_EVENT_FIELDS = new Set([
-    "kind",
-    "state",
-    "deliver",
-    "createAdapterContext",
-    "fetchFile",
-]);
-/**
- * Builds the runtime-owned adapter registry from framework adapters plus any
- * custom adapters declared on resolved route definitions.
- *
- * Route-declared adapters may share framework kinds only as pass-throughs.
- */
-export function createRuntimeAdapterRegistry(input) {
-    const adaptersByKind = new Map();
-    const frameworkKinds = new Set();
-    // Pass 1: register framework adapters. Each owns its kind
-    // permanently — route-declared adapters can share the kind only
-    // if they carry no authored behavior (strictly additive
-    // pass-through).
-    for (const adapter of FRAMEWORK_ADAPTERS) {
-        const kind = requireAdapterKind(adapter);
-        frameworkKinds.add(kind);
-        adaptersByKind.set(kind, adapter);
-    }
-    // Pass 2: register route-declared adapters. Validates that
-    // authored adapters do not shadow a framework kind with
-    // behavior.
-    for (const channelDefinition of input.channels) {
-        if (channelDefinition.adapter === undefined) {
-            continue;
-        }
-        const location = {
-            logicalPath: channelDefinition.logicalPath,
-            sourceId: channelDefinition.sourceId,
-        };
-        const adapter = channelDefinition.adapter;
-        const kind = requireAdapterKind(adapter, location);
-        if (frameworkKinds.has(kind)) {
-            if (carriesAdapterBehavior(adapter)) {
-                throw new RuntimeRegistryError("adapter", `Channel adapter kind "${kind}" is reserved by the framework. ` +
-                    `A route-declared adapter may share a framework kind only as a ` +
-                    `pass-through with no \`deliver\` hook, event handlers, ` +
-                    `\`attachments\` resolver, or \`createAdapterContext\` factory. ` +
-                    `Use a custom \`kind\` to add channel-specific behavior.`, { ...location, entryName: kind });
-            }
-            // Additive pass-through — the framework adapter stays in place.
-            continue;
-        }
-        // Non-framework kind. The last route-declared adapter for this
-        // kind wins, matching the pre-Phase-4 behavior for authored
-        // kinds.
-        adaptersByKind.set(kind, adapter);
-    }
-    return { adaptersByKind };
-}
-/**
- * Rehydrates one serialized adapter from the runtime-owned registry.
- *
- * Looks up the adapter config by `kind`, then merges the serialized state
- * onto it. The result is a full adapter with behavior functions and
- * restored state.
- */
-export function deserializeRuntimeAdapter(registry, data) {
-    const serialized = data;
-    const adapterConfig = registry.adaptersByKind.get(serialized.kind);
-    if (adapterConfig === undefined) {
-        throw new Error(`Unknown adapter kind: "${serialized.kind}". Declare the adapter on the route that starts this session so the runtime can rehydrate it.`);
-    }
-    // Merge the serialized state onto the adapter config. The behavior
-    // functions come from the registry entry; the state comes from the
-    // serialized context.
-    return { ...adapterConfig, state: serialized.state };
-}
-function requireAdapterKind(adapter, location) {
-    const kind = getAdapterKind(adapter);
-    if (typeof kind !== "string" || kind.length === 0) {
-        throw new RuntimeRegistryError("adapter", "Adapters must declare a non-empty `kind` field.", {
-            entryName: "unknown",
-            logicalPath: location?.logicalPath,
-            sourceId: location?.sourceId,
-        });
-    }
-    return kind;
-}
-/**
- * Returns true if the adapter contributes any authored behavior beyond
- * the bare `kind` discriminator (and initial `state`).
- */
-function carriesAdapterBehavior(adapter) {
-    if (adapter.deliver !== undefined) {
-        return true;
-    }
-    if (adapter.fetchFile !== undefined) {
-        return true;
-    }
-    if (adapter.createAdapterContext !== undefined) {
-        return true;
-    }
-    // Remaining keys on a ChannelAdapter object correspond to stream
-    // event handlers (keyed by event type, e.g. "input.requested").
-    for (const [key, value] of Object.entries(adapter)) {
-        if (ADAPTER_NON_EVENT_FIELDS.has(key)) {
-            continue;
-        }
-        if (typeof value === "function") {
-            return true;
-        }
-    }
-    return false;
-}
+import{getAdapterKind}from"#channel/adapter.js";import{SUBAGENT_ADAPTER}from"#execution/subagent-adapter.js";import{SCHEDULE_ADAPTER}from"#channel/schedule.js";import{HTTP_ADAPTER}from"#channel/http.js";import{RuntimeRegistryError}from"#internal/runtime-registry.js";var FRAMEWORK_ADAPTERS=[HTTP_ADAPTER,SUBAGENT_ADAPTER,SCHEDULE_ADAPTER],ADAPTER_NON_EVENT_FIELDS=new Set([`kind`,`state`,`deliver`,`createAdapterContext`,`fetchFile`]);function createRuntimeAdapterRegistry(e){let t=new Map,n=new Set;for(let e of FRAMEWORK_ADAPTERS){let r=requireAdapterKind(e);n.add(r),t.set(r,e)}for(let r of e.channels){if(r.adapter===void 0)continue;let e={logicalPath:r.logicalPath,sourceId:r.sourceId},i=r.adapter,a=requireAdapterKind(i,e);if(n.has(a)){if(carriesAdapterBehavior(i))throw new RuntimeRegistryError(`adapter`,`Channel adapter kind "${a}" is reserved by the framework. A route-declared adapter may share a framework kind only as a pass-through with no \`deliver\` hook, event handlers, \`attachments\` resolver, or \`createAdapterContext\` factory. Use a custom \`kind\` to add channel-specific behavior.`,{...e,entryName:a});continue}t.set(a,i)}return{adaptersByKind:t}}function deserializeRuntimeAdapter(e,t){let n=t,r=e.adaptersByKind.get(n.kind);if(r===void 0)throw Error(`Unknown adapter kind: "${n.kind}". Declare the adapter on the route that starts this session so the runtime can rehydrate it.`);return{...r,state:n.state}}function requireAdapterKind(t,n){let r=getAdapterKind(t);if(typeof r!=`string`||r.length===0)throw new RuntimeRegistryError(`adapter`,"Adapters must declare a non-empty `kind` field.",{entryName:`unknown`,logicalPath:n?.logicalPath,sourceId:n?.sourceId});return r}function carriesAdapterBehavior(e){if(e.deliver!==void 0||e.fetchFile!==void 0||e.createAdapterContext!==void 0)return!0;for(let[t,n]of Object.entries(e))if(!ADAPTER_NON_EVENT_FIELDS.has(t)&&typeof n==`function`)return!0;return!1}export{createRuntimeAdapterRegistry,deserializeRuntimeAdapter};

package/dist/src/runtime/compiled-artifacts-source.js

@@ -1,42 +1 @@
-/**
- * Creates the bundled compiled-artifact source.
- */
-export function createBundledRuntimeCompiledArtifactsSource() {
-    return {
-        kind: "bundled",
-    };
-}
-/**
- * Creates the disk-backed compiled-artifact source for one authored app root.
- */
-export function createDiskRuntimeCompiledArtifactsSource(appRoot, options = {}) {
-    if (options.moduleMapLoaderPath !== undefined) {
-        return {
-            appRoot,
-            kind: "disk",
-            moduleMapLoaderPath: options.moduleMapLoaderPath,
-        };
-    }
-    return {
-        appRoot,
-        kind: "disk",
-    };
-}
-/**
- * Returns the disk-backed app root when one exists for the artifact source.
- */
-export function getRuntimeCompiledArtifactsAppRoot(source) {
-    return source.kind === "disk" ? source.appRoot : undefined;
-}
-/**
- * Returns the stable cache key for one runtime artifact source.
- */
-export function getRuntimeCompiledArtifactsCacheKey(source) {
-    if (source.kind !== "disk") {
-        return "bundled";
-    }
-    if (source.moduleMapLoaderPath !== undefined) {
-        return `disk:${source.appRoot}:authored-source:${source.moduleMapLoaderPath}`;
-    }
-    return `disk:${source.appRoot}`;
-}
+function createBundledRuntimeCompiledArtifactsSource(){return{kind:`bundled`}}function createDiskRuntimeCompiledArtifactsSource(e,t={}){return t.moduleMapLoaderPath===void 0?{appRoot:e,kind:`disk`}:{appRoot:e,kind:`disk`,moduleMapLoaderPath:t.moduleMapLoaderPath}}function getRuntimeCompiledArtifactsAppRoot(e){return e.kind===`disk`?e.appRoot:void 0}function getRuntimeCompiledArtifactsCacheKey(e){return e.kind===`disk`?e.moduleMapLoaderPath===void 0?`disk:${e.appRoot}`:`disk:${e.appRoot}:authored-source:${e.moduleMapLoaderPath}`:`bundled`}export{createBundledRuntimeCompiledArtifactsSource,createDiskRuntimeCompiledArtifactsSource,getRuntimeCompiledArtifactsAppRoot,getRuntimeCompiledArtifactsCacheKey};