experimental-ash 0.1.0-alpha.1

package/dist/src/runtime/skills/load-skill-content.d.ts

@@ -0,0 +1,15 @@
+import type { RuntimeSkillSource } from "../harness/contracts.js";
+import type { LoadedRuntimeSkill } from "./types.js";
+/**
+ * Loads one runtime skill on demand from the compiled metadata preserved on the
+ * prepared turn.
+ */
+export declare function loadRuntimeSkill(source: RuntimeSkillSource): Promise<LoadedRuntimeSkill>;
+/**
+ * Loads the currently active runtime skills in canonical session order.
+ */
+export declare function loadActiveRuntimeSkills(input: {
+    readonly activeSkillIds: readonly string[];
+    readonly availableSkills: readonly RuntimeSkillSource[];
+}): Promise<LoadedRuntimeSkill[]>;
+//# sourceMappingURL=load-skill-content.d.ts.map

package/dist/src/runtime/skills/load-skill-content.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"load-skill-content.d.ts","sourceRoot":"","sources":["../../../../src/runtime/skills/load-skill-content.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,yBAAyB,CAAC;AAGlE,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,YAAY,CAAC;AAErD;;;GAGG;AACH,wBAAsB,gBAAgB,CAAC,MAAM,EAAE,kBAAkB,GAAG,OAAO,CAAC,kBAAkB,CAAC,CAS9F;AAED;;GAEG;AACH,wBAAsB,uBAAuB,CAAC,KAAK,EAAE;IACnD,QAAQ,CAAC,cAAc,EAAE,SAAS,MAAM,EAAE,CAAC;IAC3C,QAAQ,CAAC,eAAe,EAAE,SAAS,kBAAkB,EAAE,CAAC;CACzD,GAAG,OAAO,CAAC,kBAAkB,EAAE,CAAC,CAchC"}

package/dist/src/runtime/skills/load-skill-content.js

@@ -0,0 +1,29 @@
+import { findRuntimeSkillSource } from "./load-skills.js";
+/**
+ * Loads one runtime skill on demand from the compiled metadata preserved on the
+ * prepared turn.
+ */
+export async function loadRuntimeSkill(source) {
+    if (source.markdown === undefined) {
+        throw new Error(`Resolved runtime skill "${source.skillId}" is missing markdown instructions.`);
+    }
+    return {
+        ...source,
+        markdown: source.markdown,
+    };
+}
+/**
+ * Loads the currently active runtime skills in canonical session order.
+ */
+export async function loadActiveRuntimeSkills(input) {
+    const loadedSkills = [];
+    for (const skillId of input.activeSkillIds) {
+        const source = findRuntimeSkillSource(input.availableSkills, skillId);
+        if (source === null) {
+            throw new Error(`Active runtime skill "${skillId}" is no longer available.`);
+        }
+        loadedSkills.push(await loadRuntimeSkill(source));
+    }
+    return loadedSkills;
+}
+//# sourceMappingURL=load-skill-content.js.map

package/dist/src/runtime/skills/load-skill-content.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"load-skill-content.js","sourceRoot":"","sources":["../../../../src/runtime/skills/load-skill-content.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,sBAAsB,EAAE,MAAM,kBAAkB,CAAC;AAG1D;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,gBAAgB,CAAC,MAA0B;IAC/D,IAAI,MAAM,CAAC,QAAQ,KAAK,SAAS,EAAE,CAAC;QAClC,MAAM,IAAI,KAAK,CAAC,2BAA2B,MAAM,CAAC,OAAO,qCAAqC,CAAC,CAAC;IAClG,CAAC;IAED,OAAO;QACL,GAAG,MAAM;QACT,QAAQ,EAAE,MAAM,CAAC,QAAQ;KAC1B,CAAC;AACJ,CAAC;AAED;;GAEG;AACH,MAAM,CAAC,KAAK,UAAU,uBAAuB,CAAC,KAG7C;IACC,MAAM,YAAY,GAAyB,EAAE,CAAC;IAE9C,KAAK,MAAM,OAAO,IAAI,KAAK,CAAC,cAAc,EAAE,CAAC;QAC3C,MAAM,MAAM,GAAG,sBAAsB,CAAC,KAAK,CAAC,eAAe,EAAE,OAAO,CAAC,CAAC;QAEtE,IAAI,MAAM,KAAK,IAAI,EAAE,CAAC;YACpB,MAAM,IAAI,KAAK,CAAC,yBAAyB,OAAO,2BAA2B,CAAC,CAAC;QAC/E,CAAC;QAED,YAAY,CAAC,IAAI,CAAC,MAAM,gBAAgB,CAAC,MAAM,CAAC,CAAC,CAAC;IACpD,CAAC;IAED,OAAO,YAAY,CAAC;AACtB,CAAC"}

package/dist/src/runtime/skills/load-skills.d.ts

@@ -0,0 +1,22 @@
+import { z } from "zod";
+import { type RuntimeSkillSource } from "../harness/contracts.js";
+import type { LoadedRuntimeSkill } from "./types.js";
+export type { LoadedRuntimeSkill } from "./types.js";
+/**
+ * Zod schema for one loaded runtime skill persisted in ToolLoop continuations.
+ */
+export declare const loadedRuntimeSkillSchema: z.ZodType<LoadedRuntimeSkill>;
+/**
+ * Resolves one available runtime skill by authored id or display name.
+ */
+export declare function findRuntimeSkillSource(skills: readonly RuntimeSkillSource[], identifier: string): RuntimeSkillSource | null;
+/**
+ * Resolves one already loaded runtime skill by authored id or display name.
+ */
+export declare function findLoadedRuntimeSkill(skills: readonly LoadedRuntimeSkill[], identifier: string): LoadedRuntimeSkill | null;
+/**
+ * Returns true when the value matches the serializable loaded-runtime-skill
+ * shape persisted in ToolLoop continuations.
+ */
+export declare function isLoadedRuntimeSkill(value: unknown): value is LoadedRuntimeSkill;
+//# sourceMappingURL=load-skills.d.ts.map

package/dist/src/runtime/skills/load-skills.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"load-skills.d.ts","sourceRoot":"","sources":["../../../../src/runtime/skills/load-skills.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,OAAO,EAAE,KAAK,kBAAkB,EAA4B,MAAM,yBAAyB,CAAC;AAC5F,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,YAAY,CAAC;AAErD,YAAY,EAAE,kBAAkB,EAAE,MAAM,YAAY,CAAC;AAErD;;GAEG;AACH,eAAO,MAAM,wBAAwB,EAAE,CAAC,CAAC,OAAO,CAAC,kBAAkB,CAIxD,CAAC;AAEZ;;GAEG;AACH,wBAAgB,sBAAsB,CACpC,MAAM,EAAE,SAAS,kBAAkB,EAAE,EACrC,UAAU,EAAE,MAAM,GACjB,kBAAkB,GAAG,IAAI,CAa3B;AAED;;GAEG;AACH,wBAAgB,sBAAsB,CACpC,MAAM,EAAE,SAAS,kBAAkB,EAAE,EACrC,UAAU,EAAE,MAAM,GACjB,kBAAkB,GAAG,IAAI,CAa3B;AAED;;;GAGG;AACH,wBAAgB,oBAAoB,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,kBAAkB,CAEhF"}

package/dist/src/runtime/skills/load-skills.js

@@ -0,0 +1,47 @@
+import { z } from "zod";
+import { runtimeSkillSourceSchema } from "../harness/contracts.js";
+/**
+ * Zod schema for one loaded runtime skill persisted in ToolLoop continuations.
+ */
+export const loadedRuntimeSkillSchema = runtimeSkillSourceSchema
+    .extend({
+    markdown: z.string(),
+})
+    .strict();
+/**
+ * Resolves one available runtime skill by authored id or display name.
+ */
+export function findRuntimeSkillSource(skills, identifier) {
+    const normalizedIdentifier = normalizeSkillIdentifier(identifier);
+    for (const skill of skills) {
+        if (normalizeSkillIdentifier(skill.skillId) === normalizedIdentifier ||
+            normalizeSkillIdentifier(skill.name) === normalizedIdentifier) {
+            return skill;
+        }
+    }
+    return null;
+}
+/**
+ * Resolves one already loaded runtime skill by authored id or display name.
+ */
+export function findLoadedRuntimeSkill(skills, identifier) {
+    const normalizedIdentifier = normalizeSkillIdentifier(identifier);
+    for (const skill of skills) {
+        if (normalizeSkillIdentifier(skill.skillId) === normalizedIdentifier ||
+            normalizeSkillIdentifier(skill.name) === normalizedIdentifier) {
+            return skill;
+        }
+    }
+    return null;
+}
+/**
+ * Returns true when the value matches the serializable loaded-runtime-skill
+ * shape persisted in ToolLoop continuations.
+ */
+export function isLoadedRuntimeSkill(value) {
+    return loadedRuntimeSkillSchema.safeParse(value).success;
+}
+function normalizeSkillIdentifier(value) {
+    return value.trim().toLowerCase();
+}
+//# sourceMappingURL=load-skills.js.map

package/dist/src/runtime/skills/load-skills.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"load-skills.js","sourceRoot":"","sources":["../../../../src/runtime/skills/load-skills.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,OAAO,EAA2B,wBAAwB,EAAE,MAAM,yBAAyB,CAAC;AAK5F;;GAEG;AACH,MAAM,CAAC,MAAM,wBAAwB,GAAkC,wBAAwB;KAC5F,MAAM,CAAC;IACN,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE;CACrB,CAAC;KACD,MAAM,EAAE,CAAC;AAEZ;;GAEG;AACH,MAAM,UAAU,sBAAsB,CACpC,MAAqC,EACrC,UAAkB;IAElB,MAAM,oBAAoB,GAAG,wBAAwB,CAAC,UAAU,CAAC,CAAC;IAElE,KAAK,MAAM,KAAK,IAAI,MAAM,EAAE,CAAC;QAC3B,IACE,wBAAwB,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,oBAAoB;YAChE,wBAAwB,CAAC,KAAK,CAAC,IAAI,CAAC,KAAK,oBAAoB,EAC7D,CAAC;YACD,OAAO,KAAK,CAAC;QACf,CAAC;IACH,CAAC;IAED,OAAO,IAAI,CAAC;AACd,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,sBAAsB,CACpC,MAAqC,EACrC,UAAkB;IAElB,MAAM,oBAAoB,GAAG,wBAAwB,CAAC,UAAU,CAAC,CAAC;IAElE,KAAK,MAAM,KAAK,IAAI,MAAM,EAAE,CAAC;QAC3B,IACE,wBAAwB,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,oBAAoB;YAChE,wBAAwB,CAAC,KAAK,CAAC,IAAI,CAAC,KAAK,oBAAoB,EAC7D,CAAC;YACD,OAAO,KAAK,CAAC;QACf,CAAC;IACH,CAAC;IAED,OAAO,IAAI,CAAC;AACd,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,oBAAoB,CAAC,KAAc;IACjD,OAAO,wBAAwB,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC,OAAO,CAAC;AAC3D,CAAC;AAED,SAAS,wBAAwB,CAAC,KAAa;IAC7C,OAAO,KAAK,CAAC,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC;AACpC,CAAC"}

package/dist/src/runtime/skills/types.d.ts

@@ -0,0 +1,8 @@
+import type { RuntimeSkillSource } from "../harness/contracts.js";
+/**
+ * Runtime skill metadata after the framework has loaded the full skill body.
+ */
+export interface LoadedRuntimeSkill extends RuntimeSkillSource {
+    readonly markdown: string;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/src/runtime/skills/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../../src/runtime/skills/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,yBAAyB,CAAC;AAElE;;GAEG;AACH,MAAM,WAAW,kBAAmB,SAAQ,kBAAkB;IAC5D,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;CAC3B"}

package/dist/src/runtime/skills/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/dist/src/runtime/skills/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../../src/runtime/skills/types.ts"],"names":[],"mappings":""}

package/dist/src/runtime/subagents/definitions.d.ts

@@ -0,0 +1,11 @@
+import { type SubagentDefinition, type SubagentInputDefinition } from "../../public/definitions/subagent.js";
+/**
+ * Returns true when a value matches the Ash-owned recursive subagent input
+ * definition contract.
+ */
+export declare function isSubagentInputDefinition(value: unknown): value is SubagentInputDefinition;
+/**
+ * Returns true when a value matches the authored local-subagent public shape.
+ */
+export declare function isLocalSubagentDefinition(value: unknown): value is SubagentDefinition;
+//# sourceMappingURL=definitions.d.ts.map

package/dist/src/runtime/subagents/definitions.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"definitions.d.ts","sourceRoot":"","sources":["../../../../src/runtime/subagents/definitions.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,KAAK,kBAAkB,EACvB,KAAK,uBAAuB,EAG7B,MAAM,sCAAsC,CAAC;AAE9C;;;GAGG;AACH,wBAAgB,yBAAyB,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,uBAAuB,CAE1F;AAED;;GAEG;AACH,wBAAgB,yBAAyB,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,kBAAkB,CAErF"}

package/dist/src/runtime/subagents/definitions.js

@@ -0,0 +1,15 @@
+import { subagentDefinitionSchema, subagentInputDefinitionSchema, } from "../../public/definitions/subagent.js";
+/**
+ * Returns true when a value matches the Ash-owned recursive subagent input
+ * definition contract.
+ */
+export function isSubagentInputDefinition(value) {
+    return subagentInputDefinitionSchema.safeParse(value).success;
+}
+/**
+ * Returns true when a value matches the authored local-subagent public shape.
+ */
+export function isLocalSubagentDefinition(value) {
+    return subagentDefinitionSchema.safeParse(value).success;
+}
+//# sourceMappingURL=definitions.js.map

package/dist/src/runtime/subagents/definitions.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"definitions.js","sourceRoot":"","sources":["../../../../src/runtime/subagents/definitions.ts"],"names":[],"mappings":"AAAA,OAAO,EAGL,wBAAwB,EACxB,6BAA6B,GAC9B,MAAM,sCAAsC,CAAC;AAE9C;;;GAGG;AACH,MAAM,UAAU,yBAAyB,CAAC,KAAc;IACtD,OAAO,6BAA6B,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC,OAAO,CAAC;AAChE,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,yBAAyB,CAAC,KAAc;IACtD,OAAO,wBAAwB,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC,OAAO,CAAC;AAC3D,CAAC"}

package/dist/src/runtime/subagents/execute-subagent.d.ts

@@ -0,0 +1,23 @@
+import type { RuntimeSubagentCallActionRequest, RuntimeSubagentResultActionResult } from "../actions/types.js";
+/**
+ * Input for executing one surfaced runtime subagent call.
+ */
+export interface ExecuteRuntimeSubagentCallInput {
+    readonly action: RuntimeSubagentCallActionRequest;
+}
+/**
+ * Executes one surfaced runtime subagent call through the current runtime
+ * wrapper.
+ *
+ * Phase 2 only makes subagent calls explicit in the runtime action taxonomy.
+ * Phase 3 replaces the placeholder error result with child workflow execution.
+ */
+export declare function executeRuntimeSubagentCall(input: ExecuteRuntimeSubagentCallInput): Promise<RuntimeSubagentResultActionResult>;
+/**
+ * Creates one runtime-owned subagent error result for the originating call.
+ */
+export declare function createErrorSubagentResult(action: RuntimeSubagentCallActionRequest, output: {
+    readonly code: string;
+    readonly message: string;
+}): RuntimeSubagentResultActionResult;
+//# sourceMappingURL=execute-subagent.d.ts.map

package/dist/src/runtime/subagents/execute-subagent.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"execute-subagent.d.ts","sourceRoot":"","sources":["../../../../src/runtime/subagents/execute-subagent.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,gCAAgC,EAChC,iCAAiC,EAClC,MAAM,qBAAqB,CAAC;AAE7B;;GAEG;AACH,MAAM,WAAW,+BAA+B;IAC9C,QAAQ,CAAC,MAAM,EAAE,gCAAgC,CAAC;CACnD;AAED;;;;;;GAMG;AACH,wBAAsB,0BAA0B,CAC9C,KAAK,EAAE,+BAA+B,GACrC,OAAO,CAAC,iCAAiC,CAAC,CAK5C;AAED;;GAEG;AACH,wBAAgB,yBAAyB,CACvC,MAAM,EAAE,gCAAgC,EACxC,MAAM,EAAE;IACN,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;CAC1B,GACA,iCAAiC,CAQnC"}

package/dist/src/runtime/subagents/execute-subagent.js

@@ -0,0 +1,26 @@
+/**
+ * Executes one surfaced runtime subagent call through the current runtime
+ * wrapper.
+ *
+ * Phase 2 only makes subagent calls explicit in the runtime action taxonomy.
+ * Phase 3 replaces the placeholder error result with child workflow execution.
+ */
+export async function executeRuntimeSubagentCall(input) {
+    return createErrorSubagentResult(input.action, {
+        code: "SUBAGENT_EXECUTION_NOT_IMPLEMENTED",
+        message: `Subagent "${input.action.subagentName}" execution is not implemented yet.`,
+    });
+}
+/**
+ * Creates one runtime-owned subagent error result for the originating call.
+ */
+export function createErrorSubagentResult(action, output) {
+    return {
+        callId: action.callId,
+        isError: true,
+        kind: "subagent-result",
+        output,
+        subagentName: action.subagentName,
+    };
+}
+//# sourceMappingURL=execute-subagent.js.map

package/dist/src/runtime/subagents/execute-subagent.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"execute-subagent.js","sourceRoot":"","sources":["../../../../src/runtime/subagents/execute-subagent.ts"],"names":[],"mappings":"AAYA;;;;;;GAMG;AACH,MAAM,CAAC,KAAK,UAAU,0BAA0B,CAC9C,KAAsC;IAEtC,OAAO,yBAAyB,CAAC,KAAK,CAAC,MAAM,EAAE;QAC7C,IAAI,EAAE,oCAAoC;QAC1C,OAAO,EAAE,aAAa,KAAK,CAAC,MAAM,CAAC,YAAY,qCAAqC;KACrF,CAAC,CAAC;AACL,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,yBAAyB,CACvC,MAAwC,EACxC,MAGC;IAED,OAAO;QACL,MAAM,EAAE,MAAM,CAAC,MAAM;QACrB,OAAO,EAAE,IAAI;QACb,IAAI,EAAE,iBAAiB;QACvB,MAAM;QACN,YAAY,EAAE,MAAM,CAAC,YAAY;KAClC,CAAC;AACJ,CAAC"}

package/dist/src/runtime/subagents/invocation.d.ts

@@ -0,0 +1,11 @@
+import type { JsonObject } from "../json.js";
+/**
+ * Creates the stable v1 user-message bridge used to invoke one local subagent
+ * through the existing harness message model.
+ */
+export declare function createLocalSubagentInvocationMessage(input: {
+    readonly description: string;
+    readonly invocationInput: JsonObject;
+    readonly name: string;
+}): string;
+//# sourceMappingURL=invocation.d.ts.map

package/dist/src/runtime/subagents/invocation.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"invocation.d.ts","sourceRoot":"","sources":["../../../../src/runtime/subagents/invocation.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAE7C;;;GAGG;AACH,wBAAgB,oCAAoC,CAAC,KAAK,EAAE;IAC1D,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,eAAe,EAAE,UAAU,CAAC;IACrC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;CACvB,GAAG,MAAM,CAUT"}

package/dist/src/runtime/subagents/invocation.js

@@ -0,0 +1,16 @@
+/**
+ * Creates the stable v1 user-message bridge used to invoke one local subagent
+ * through the existing harness message model.
+ */
+export function createLocalSubagentInvocationMessage(input) {
+    return [
+        `You are the subagent "${input.name}".`,
+        `Description: ${input.description}`,
+        "",
+        "The caller delegated the following task to you. Complete it and return the final result directly.",
+        "",
+        "Invocation input (JSON):",
+        JSON.stringify(input.invocationInput, null, 2),
+    ].join("\n");
+}
+//# sourceMappingURL=invocation.js.map

package/dist/src/runtime/subagents/invocation.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"invocation.js","sourceRoot":"","sources":["../../../../src/runtime/subagents/invocation.ts"],"names":[],"mappings":"AAEA;;;GAGG;AACH,MAAM,UAAU,oCAAoC,CAAC,KAIpD;IACC,OAAO;QACL,yBAAyB,KAAK,CAAC,IAAI,IAAI;QACvC,gBAAgB,KAAK,CAAC,WAAW,EAAE;QACnC,EAAE;QACF,mGAAmG;QACnG,EAAE;QACF,0BAA0B;QAC1B,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,eAAe,EAAE,IAAI,EAAE,CAAC,CAAC;KAC/C,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AACf,CAAC"}

package/dist/src/runtime/subagents/registry.d.ts

@@ -0,0 +1,44 @@
+import type { PreparedRuntimeSubagentTool } from "../sessions/turn.js";
+import type { ResolvedRuntimeSubagent } from "../types.js";
+/**
+ * Error raised when resolved runtime subagents cannot be lowered into a
+ * model-visible runtime registry.
+ */
+export declare class RuntimeSubagentRegistryError extends Error {
+    readonly logicalPath?: string;
+    readonly sourceId?: string;
+    readonly subagentName?: string;
+    constructor(message: string, input?: {
+        logicalPath?: string;
+        sourceId?: string;
+        subagentName?: string;
+    });
+}
+/**
+ * One runtime-owned subagent tracked by the prepared registry.
+ */
+export interface RuntimeRegisteredSubagent {
+    readonly definition: ResolvedRuntimeSubagent;
+    readonly prepared: PreparedRuntimeSubagentTool;
+}
+/**
+ * Runtime-owned registry that exposes resolved subagents as model-visible tools.
+ */
+export interface RuntimeSubagentRegistry {
+    readonly preparedTools: readonly PreparedRuntimeSubagentTool[];
+    readonly subagentsByName: ReadonlyMap<string, RuntimeRegisteredSubagent>;
+    readonly subagentsBySelector: ReadonlyMap<string, RuntimeRegisteredSubagent>;
+}
+/**
+ * Builds the runtime-owned registry for the resolved subagents visible from one
+ * runtime agent node.
+ */
+export declare function createRuntimeSubagentRegistry(input: {
+    readonly reservedToolNames?: readonly string[];
+    readonly subagents: readonly ResolvedRuntimeSubagent[];
+}): RuntimeSubagentRegistry;
+/**
+ * Looks up one prepared runtime subagent by its model-visible name.
+ */
+export declare function findRegisteredRuntimeSubagent(registry: RuntimeSubagentRegistry, subagentName: string): RuntimeRegisteredSubagent | null;
+//# sourceMappingURL=registry.d.ts.map

package/dist/src/runtime/subagents/registry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"registry.d.ts","sourceRoot":"","sources":["../../../../src/runtime/subagents/registry.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,2BAA2B,EAAE,MAAM,qBAAqB,CAAC;AACvE,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,aAAa,CAAC;AAE3D;;;GAGG;AACH,qBAAa,4BAA6B,SAAQ,KAAK;IACrD,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,YAAY,CAAC,EAAE,MAAM,CAAC;gBAG7B,OAAO,EAAE,MAAM,EACf,KAAK,GAAE;QACL,WAAW,CAAC,EAAE,MAAM,CAAC;QACrB,QAAQ,CAAC,EAAE,MAAM,CAAC;QAClB,YAAY,CAAC,EAAE,MAAM,CAAC;KAClB;CAiBT;AAED;;GAEG;AACH,MAAM,WAAW,yBAAyB;IACxC,QAAQ,CAAC,UAAU,EAAE,uBAAuB,CAAC;IAC7C,QAAQ,CAAC,QAAQ,EAAE,2BAA2B,CAAC;CAChD;AAED;;GAEG;AACH,MAAM,WAAW,uBAAuB;IACtC,QAAQ,CAAC,aAAa,EAAE,SAAS,2BAA2B,EAAE,CAAC;IAC/D,QAAQ,CAAC,eAAe,EAAE,WAAW,CAAC,MAAM,EAAE,yBAAyB,CAAC,CAAC;IACzE,QAAQ,CAAC,mBAAmB,EAAE,WAAW,CAAC,MAAM,EAAE,yBAAyB,CAAC,CAAC;CAC9E;AAED;;;GAGG;AACH,wBAAgB,6BAA6B,CAAC,KAAK,EAAE;IACnD,QAAQ,CAAC,iBAAiB,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;IAC/C,QAAQ,CAAC,SAAS,EAAE,SAAS,uBAAuB,EAAE,CAAC;CACxD,GAAG,uBAAuB,CA2D1B;AAED;;GAEG;AACH,wBAAgB,6BAA6B,CAC3C,QAAQ,EAAE,uBAAuB,EACjC,YAAY,EAAE,MAAM,GACnB,yBAAyB,GAAG,IAAI,CAElC"}

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

@@ -0,0 +1,107 @@
+/**
+ * Error raised when resolved runtime subagents cannot be lowered into a
+ * model-visible runtime registry.
+ */
+export class RuntimeSubagentRegistryError extends Error {
+    logicalPath;
+    sourceId;
+    subagentName;
+    constructor(message, input = {}) {
+        super(message);
+        this.name = "RuntimeSubagentRegistryError";
+        if (input.logicalPath !== undefined) {
+            this.logicalPath = input.logicalPath;
+        }
+        if (input.sourceId !== undefined) {
+            this.sourceId = input.sourceId;
+        }
+        if (input.subagentName !== undefined) {
+            this.subagentName = input.subagentName;
+        }
+    }
+}
+/**
+ * Builds the runtime-owned registry for the resolved subagents visible from one
+ * runtime agent node.
+ */
+export function createRuntimeSubagentRegistry(input) {
+    const preparedTools = [];
+    const subagentsByName = new Map();
+    const subagentsBySelector = new Map();
+    const reservedToolNames = new Set(input.reservedToolNames ?? []);
+    for (const subagentDefinition of input.subagents) {
+        if (reservedToolNames.has(subagentDefinition.name)) {
+            throw new RuntimeSubagentRegistryError(`Subagent "${subagentDefinition.name}" collides with another runtime-visible tool name.`, {
+                logicalPath: subagentDefinition.logicalPath,
+                sourceId: subagentDefinition.sourceId,
+                subagentName: subagentDefinition.name,
+            });
+        }
+        const existingSubagent = subagentsByName.get(subagentDefinition.name);
+        if (existingSubagent !== undefined) {
+            throw new RuntimeSubagentRegistryError(`Found multiple subagents named "${subagentDefinition.name}". Subagent names must be unique at runtime.`, {
+                logicalPath: subagentDefinition.logicalPath,
+                sourceId: subagentDefinition.sourceId,
+                subagentName: subagentDefinition.name,
+            });
+        }
+        if (subagentsBySelector.has(subagentDefinition.selector)) {
+            throw new RuntimeSubagentRegistryError(`Found multiple runtime subagents mapped to selector "${subagentDefinition.selector}".`, {
+                logicalPath: subagentDefinition.logicalPath,
+                sourceId: subagentDefinition.sourceId,
+                subagentName: subagentDefinition.name,
+            });
+        }
+        const prepared = createPreparedRuntimeSubagentTool(subagentDefinition);
+        const registeredSubagent = {
+            definition: subagentDefinition,
+            prepared,
+        };
+        reservedToolNames.add(subagentDefinition.name);
+        preparedTools.push(prepared);
+        subagentsByName.set(subagentDefinition.name, registeredSubagent);
+        subagentsBySelector.set(subagentDefinition.selector, registeredSubagent);
+    }
+    return {
+        preparedTools,
+        subagentsByName,
+        subagentsBySelector,
+    };
+}
+/**
+ * Looks up one prepared runtime subagent by its model-visible name.
+ */
+export function findRegisteredRuntimeSubagent(registry, subagentName) {
+    return registry.subagentsByName.get(subagentName) ?? null;
+}
+function createPreparedRuntimeSubagentTool(definition) {
+    try {
+        return {
+            description: definition.description,
+            inputSchema: lowerSubagentInputSchema(definition),
+            kind: "subagent",
+            logicalPath: definition.logicalPath,
+            name: definition.name,
+            selector: definition.selector,
+            sourceId: definition.sourceId,
+            subagentId: definition.subagentId,
+        };
+    }
+    catch (error) {
+        if (error instanceof RuntimeSubagentRegistryError) {
+            throw error;
+        }
+        throw new RuntimeSubagentRegistryError(`Failed to lower the authored subagent schema for "${definition.name}" into runtime JSON schema: ${formatErrorMessage(error)}`, {
+            logicalPath: definition.logicalPath,
+            sourceId: definition.sourceId,
+            subagentName: definition.name,
+        });
+    }
+}
+function lowerSubagentInputSchema(definition) {
+    return definition.inputSchema;
+}
+function formatErrorMessage(error) {
+    return error instanceof Error ? error.message : String(error);
+}
+//# sourceMappingURL=registry.js.map

package/dist/src/runtime/subagents/registry.js.map

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

package/dist/src/runtime/tools/execute-tool.d.ts

@@ -0,0 +1,28 @@
+import type { RuntimeToolCallActionRequest, RuntimeToolResultActionResult } from "../actions/types.js";
+import { type Session } from "../session-context.js";
+import type { PreparedRuntimeTool } from "../sessions/turn.js";
+import { type RuntimeToolRegistry } from "./registry.js";
+/**
+ * Input for executing one authored tool call through the runtime-owned wrapper.
+ */
+export interface ExecuteRuntimeToolCallInput {
+    readonly action: RuntimeToolCallActionRequest;
+    readonly registry: RuntimeToolRegistry;
+    readonly session: Session;
+    readonly visibleTools: readonly PreparedRuntimeTool[];
+}
+/**
+ * Executes one authored tool call through the runtime-owned wrapper.
+ */
+export declare function executeRuntimeToolCall(input: ExecuteRuntimeToolCallInput): Promise<RuntimeToolResultActionResult>;
+/**
+ * Executes one authored tool batch through the runtime-owned wrappers while
+ * preserving the harness-requested result ordering.
+ */
+export declare function executeRuntimeToolBatch(input: {
+    readonly actions: readonly RuntimeToolCallActionRequest[];
+    readonly registry: RuntimeToolRegistry;
+    readonly session: Session;
+    readonly visibleTools: readonly PreparedRuntimeTool[];
+}): Promise<readonly RuntimeToolResultActionResult[]>;
+//# sourceMappingURL=execute-tool.d.ts.map

package/dist/src/runtime/tools/execute-tool.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"execute-tool.d.ts","sourceRoot":"","sources":["../../../../src/runtime/tools/execute-tool.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,4BAA4B,EAC5B,6BAA6B,EAC9B,MAAM,qBAAqB,CAAC;AAE7B,OAAO,EAAwB,KAAK,OAAO,EAAE,MAAM,uBAAuB,CAAC;AAC3E,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,qBAAqB,CAAC;AAE/D,OAAO,EAA6B,KAAK,mBAAmB,EAAE,MAAM,eAAe,CAAC;AAEpF;;GAEG;AACH,MAAM,WAAW,2BAA2B;IAC1C,QAAQ,CAAC,MAAM,EAAE,4BAA4B,CAAC;IAC9C,QAAQ,CAAC,QAAQ,EAAE,mBAAmB,CAAC;IACvC,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC;IAC1B,QAAQ,CAAC,YAAY,EAAE,SAAS,mBAAmB,EAAE,CAAC;CACvD;AAED;;GAEG;AACH,wBAAsB,sBAAsB,CAC1C,KAAK,EAAE,2BAA2B,GACjC,OAAO,CAAC,6BAA6B,CAAC,CAqDxC;AAED;;;GAGG;AACH,wBAAsB,uBAAuB,CAAC,KAAK,EAAE;IACnD,QAAQ,CAAC,OAAO,EAAE,SAAS,4BAA4B,EAAE,CAAC;IAC1D,QAAQ,CAAC,QAAQ,EAAE,mBAAmB,CAAC;IACvC,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC;IAC1B,QAAQ,CAAC,YAAY,EAAE,SAAS,mBAAmB,EAAE,CAAC;CACvD,GAAG,OAAO,CAAC,SAAS,6BAA6B,EAAE,CAAC,CAWpD"}

package/dist/src/runtime/tools/execute-tool.js

@@ -0,0 +1,75 @@
+import { isJsonValue } from "../json.js";
+import { runWithActiveSession } from "../session-context.js";
+import { findRegisteredRuntimeTool } from "./registry.js";
+/**
+ * Executes one authored tool call through the runtime-owned wrapper.
+ */
+export async function executeRuntimeToolCall(input) {
+    const visibleTool = input.visibleTools.find((tool) => tool.name === input.action.toolName);
+    if (visibleTool === undefined) {
+        return createErrorToolResult(input.action, {
+            code: "TOOL_NOT_VISIBLE",
+            message: `Tool "${input.action.toolName}" was not available on this runtime turn.`,
+        });
+    }
+    const registeredTool = findRegisteredRuntimeTool(input.registry, input.action.toolName);
+    if (registeredTool === null) {
+        return createErrorToolResult(input.action, {
+            code: "TOOL_NOT_REGISTERED",
+            message: `Tool "${input.action.toolName}" is not registered in the current compiled runtime.`,
+        });
+    }
+    if (visibleTool.sourceId !== registeredTool.prepared.sourceId ||
+        visibleTool.logicalPath !== registeredTool.prepared.logicalPath) {
+        return createErrorToolResult(input.action, {
+            code: "TOOL_REGISTRY_MISMATCH",
+            message: `Tool "${input.action.toolName}" no longer matches the current compiled runtime definition.`,
+        });
+    }
+    try {
+        const output = await runWithActiveSession(input.session, () => registeredTool.definition.execute(input.action.input));
+        if (!isJsonValue(output)) {
+            return createErrorToolResult(input.action, {
+                code: "TOOL_OUTPUT_NOT_SERIALIZABLE",
+                message: `Tool "${input.action.toolName}" returned a non-JSON-serializable value.`,
+            });
+        }
+        return {
+            callId: input.action.callId,
+            kind: "tool-result",
+            output,
+            toolName: input.action.toolName,
+        };
+    }
+    catch (error) {
+        return createErrorToolResult(input.action, {
+            code: "TOOL_EXECUTION_FAILED",
+            message: formatErrorMessage(error),
+        });
+    }
+}
+/**
+ * Executes one authored tool batch through the runtime-owned wrappers while
+ * preserving the harness-requested result ordering.
+ */
+export async function executeRuntimeToolBatch(input) {
+    return Promise.all(input.actions.map((action) => executeRuntimeToolCall({
+        action,
+        registry: input.registry,
+        session: input.session,
+        visibleTools: input.visibleTools,
+    })));
+}
+function createErrorToolResult(action, output) {
+    return {
+        callId: action.callId,
+        isError: true,
+        kind: "tool-result",
+        output,
+        toolName: action.toolName,
+    };
+}
+function formatErrorMessage(error) {
+    return error instanceof Error ? error.message : String(error);
+}
+//# sourceMappingURL=execute-tool.js.map

package/dist/src/runtime/tools/execute-tool.js.map

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

package/dist/src/runtime/tools/registry.d.ts

@@ -0,0 +1,42 @@
+import type { PreparedRuntimeAuthoredTool } from "../sessions/turn.js";
+import type { ResolvedToolDefinition } from "../types.js";
+/**
+ * Error raised when resolved authored tools cannot be lowered into a
+ * runtime-owned registry.
+ */
+export declare class RuntimeToolRegistryError extends Error {
+    readonly logicalPath?: string;
+    readonly sourceId?: string;
+    readonly toolName?: string;
+    constructor(message: string, input?: {
+        logicalPath?: string;
+        sourceId?: string;
+        toolName?: string;
+    });
+}
+/**
+ * One executable authored tool tracked by the runtime-owned registry.
+ */
+export interface RuntimeRegisteredTool {
+    readonly definition: ResolvedToolDefinition;
+    readonly prepared: PreparedRuntimeAuthoredTool;
+}
+/**
+ * Runtime-owned tool registry used to expose authored tools to the harness and
+ * execute them later inside framework-owned steps.
+ */
+export interface RuntimeToolRegistry {
+    readonly preparedTools: readonly PreparedRuntimeAuthoredTool[];
+    readonly toolsByName: ReadonlyMap<string, RuntimeRegisteredTool>;
+}
+/**
+ * Builds the runtime-owned registry for one resolved authored agent.
+ */
+export declare function createRuntimeToolRegistry(tools: readonly ResolvedToolDefinition[], input?: {
+    readonly reservedToolNames?: readonly string[];
+}): Promise<RuntimeToolRegistry>;
+/**
+ * Looks up one authored tool by name from the runtime-owned registry.
+ */
+export declare function findRegisteredRuntimeTool(registry: RuntimeToolRegistry, toolName: string): RuntimeRegisteredTool | null;
+//# sourceMappingURL=registry.d.ts.map

package/dist/src/runtime/tools/registry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"registry.d.ts","sourceRoot":"","sources":["../../../../src/runtime/tools/registry.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,2BAA2B,EAAE,MAAM,qBAAqB,CAAC;AACvE,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,aAAa,CAAC;AAE1D;;;GAGG;AACH,qBAAa,wBAAyB,SAAQ,KAAK;IACjD,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;gBAGzB,OAAO,EAAE,MAAM,EACf,KAAK,GAAE;QACL,WAAW,CAAC,EAAE,MAAM,CAAC;QACrB,QAAQ,CAAC,EAAE,MAAM,CAAC;QAClB,QAAQ,CAAC,EAAE,MAAM,CAAC;KACd;CAiBT;AAED;;GAEG;AACH,MAAM,WAAW,qBAAqB;IACpC,QAAQ,CAAC,UAAU,EAAE,sBAAsB,CAAC;IAC5C,QAAQ,CAAC,QAAQ,EAAE,2BAA2B,CAAC;CAChD;AAED;;;GAGG;AACH,MAAM,WAAW,mBAAmB;IAClC,QAAQ,CAAC,aAAa,EAAE,SAAS,2BAA2B,EAAE,CAAC;IAC/D,QAAQ,CAAC,WAAW,EAAE,WAAW,CAAC,MAAM,EAAE,qBAAqB,CAAC,CAAC;CAClE;AAED;;GAEG;AACH,wBAAsB,yBAAyB,CAC7C,KAAK,EAAE,SAAS,sBAAsB,EAAE,EACxC,KAAK,GAAE;IACL,QAAQ,CAAC,iBAAiB,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;CAC3C,GACL,OAAO,CAAC,mBAAmB,CAAC,CA6C9B;AAED;;GAEG;AACH,wBAAgB,yBAAyB,CACvC,QAAQ,EAAE,mBAAmB,EAC7B,QAAQ,EAAE,MAAM,GACf,qBAAqB,GAAG,IAAI,CAE9B"}