experimental-ash 0.1.0-alpha.1

package/dist/src/public/helpers/markdown.js

@@ -0,0 +1,193 @@
+import grayMatter from "gray-matter";
+import { normalizeScheduleDefinition, normalizeSkillDefinition, normalizeSystemDefinition, } from "../../internal/authored-definition/core.js";
+import { defineSchedule } from "../definitions/schedule.js";
+import { defineSkill } from "../definitions/skill.js";
+import { defineSystem } from "../definitions/system.js";
+const CLOSED_FRONTMATTER_PATTERN = /^---\r?\n[\s\S]*?\r?\n---(?:\r?\n|$)/;
+/**
+ * Parses markdown with optional YAML frontmatter.
+ */
+export function parseMarkdownDocument(source) {
+    if (!grayMatter.test(source)) {
+        return {
+            hasFrontmatter: false,
+            frontmatter: {},
+            markdown: source,
+        };
+    }
+    let document;
+    try {
+        document = grayMatter(source);
+    }
+    catch (error) {
+        if (startsWithFrontmatterFence(source) && !hasClosedFrontmatterFence(source)) {
+            throw new Error("Markdown frontmatter is missing a closing delimiter.");
+        }
+        throw error;
+    }
+    if (!isRecord(document.data)) {
+        throw new Error("Markdown frontmatter must parse to an object.");
+    }
+    return {
+        hasFrontmatter: true,
+        frontmatter: document.data,
+        markdown: normalizeFrontmatterMarkdownBody(document.content),
+    };
+}
+/**
+ * Lowers authored system prompt markdown into the shared public definition shape.
+ */
+export function lowerSystemMarkdown(markdown, input = {}) {
+    const rawDefinition = {
+        markdown,
+    };
+    if (input.id !== undefined) {
+        rawDefinition.id = input.id;
+    }
+    return defineSystem(normalizeSystemDefinition(rawDefinition, "Expected authored system markdown to match the public Ash shape."));
+}
+/**
+ * Lowers authored `SKILL.md` content into the shared public definition shape.
+ */
+export function lowerSkillMarkdown(source, input = {}) {
+    const document = parseMarkdownDocument(source);
+    if (!document.hasFrontmatter) {
+        throw new Error("Skill markdown must start with YAML frontmatter.");
+    }
+    assertNoLegacySkillToolAllowlist(document.frontmatter);
+    const rawDefinition = {
+        ...document.frontmatter,
+        description: requireStringFrontmatter(document.frontmatter.description, "description"),
+        markdown: document.markdown,
+        name: requireStringFrontmatter(document.frontmatter.name, "name"),
+    };
+    if (input.id !== undefined) {
+        rawDefinition.id = input.id;
+    }
+    const license = toOptionalString(document.frontmatter.license, "license");
+    const compatibility = toOptionalString(document.frontmatter.compatibility, "compatibility");
+    const metadata = toOptionalStringRecord(document.frontmatter.metadata, "metadata");
+    if (license !== undefined) {
+        rawDefinition.license = license;
+    }
+    if (compatibility !== undefined) {
+        rawDefinition.compatibility = compatibility;
+    }
+    if (metadata !== undefined) {
+        rawDefinition.metadata = metadata;
+    }
+    return defineSkill(normalizeSkillDefinition(rawDefinition, "Expected authored skill markdown to match the public Ash shape."));
+}
+/**
+ * Lowers flat authored skill markdown into the shared public definition shape.
+ *
+ * Flat skill files may omit frontmatter. In that case the file stem becomes the
+ * skill name and the first non-empty markdown line becomes the description.
+ */
+export function lowerFlatSkillMarkdown(source, input) {
+    const document = parseMarkdownDocument(source);
+    assertNoLegacySkillToolAllowlist(document.frontmatter);
+    const frontmatterName = toOptionalString(document.frontmatter.name, "name");
+    const frontmatterDescription = toOptionalString(document.frontmatter.description, "description");
+    const rawDefinition = {
+        ...document.frontmatter,
+        description: frontmatterDescription ??
+            input.description ??
+            deriveFlatSkillDescription(document.markdown, input.name),
+        markdown: document.markdown,
+        name: frontmatterName ?? input.name,
+    };
+    if (input.id !== undefined) {
+        rawDefinition.id = input.id;
+    }
+    const license = toOptionalString(document.frontmatter.license, "license");
+    const compatibility = toOptionalString(document.frontmatter.compatibility, "compatibility");
+    const metadata = toOptionalStringRecord(document.frontmatter.metadata, "metadata");
+    if (license !== undefined) {
+        rawDefinition.license = license;
+    }
+    if (compatibility !== undefined) {
+        rawDefinition.compatibility = compatibility;
+    }
+    if (metadata !== undefined) {
+        rawDefinition.metadata = metadata;
+    }
+    return defineSkill(normalizeSkillDefinition(rawDefinition, "Expected authored skill markdown to match the public Ash shape."));
+}
+/**
+ * Lowers authored schedule markdown into the shared public definition shape.
+ */
+export function lowerScheduleMarkdown(source, input = {}) {
+    const document = parseMarkdownDocument(source);
+    if (!document.hasFrontmatter) {
+        throw new Error("Schedule markdown must start with YAML frontmatter.");
+    }
+    const rawDefinition = {
+        ...document.frontmatter,
+        cron: requireStringFrontmatter(document.frontmatter.cron, "cron"),
+        markdown: document.markdown,
+    };
+    if (input.id !== undefined) {
+        rawDefinition.id = input.id;
+    }
+    return defineSchedule(normalizeScheduleDefinition(rawDefinition, "Expected authored schedule markdown to match the public Ash shape."));
+}
+function isRecord(value) {
+    return typeof value === "object" && value !== null && !Array.isArray(value);
+}
+function startsWithFrontmatterFence(source) {
+    return source.startsWith("---\n") || source.startsWith("---\r\n");
+}
+function hasClosedFrontmatterFence(source) {
+    return CLOSED_FRONTMATTER_PATTERN.test(source);
+}
+function normalizeFrontmatterMarkdownBody(markdown) {
+    return markdown.replace(/^\r?\n/u, "");
+}
+function assertNoLegacySkillToolAllowlist(frontmatter) {
+    if ("allowed-tools" in frontmatter) {
+        throw new Error('Skill frontmatter field "allowed-tools" is no longer supported. Tools in "tools/" are always available.');
+    }
+}
+function toOptionalString(value, fieldName) {
+    if (value === undefined || value === null) {
+        return undefined;
+    }
+    if (typeof value !== "string") {
+        throw new Error(`Expected "${fieldName}" frontmatter to be a string.`);
+    }
+    return value;
+}
+function requireStringFrontmatter(value, fieldName) {
+    const normalizedValue = toOptionalString(value, fieldName);
+    if (normalizedValue === undefined) {
+        throw new Error(`Missing required "${fieldName}" frontmatter.`);
+    }
+    return normalizedValue;
+}
+function toOptionalStringRecord(value, fieldName) {
+    if (value === undefined || value === null) {
+        return undefined;
+    }
+    if (!isRecord(value)) {
+        throw new Error(`Expected "${fieldName}" frontmatter to be an object.`);
+    }
+    const stringEntries = Object.entries(value).map(([key, entryValue]) => {
+        if (typeof entryValue !== "string") {
+            throw new Error(`Expected "${fieldName}.${key}" frontmatter to be a string.`);
+        }
+        return [key, entryValue];
+    });
+    return Object.fromEntries(stringEntries);
+}
+function deriveFlatSkillDescription(markdown, name) {
+    const descriptionLine = markdown
+        .split(/\r?\n/u)
+        .map((line) => line.trim())
+        .find((line) => line !== "" && !line.startsWith("```"));
+    if (descriptionLine === undefined) {
+        return `Instructions for the ${name} skill.`;
+    }
+    return (descriptionLine.replace(/^[#>*\-\s]+/u, "").trim() || `Instructions for the ${name} skill.`);
+}
+//# sourceMappingURL=markdown.js.map

package/dist/src/public/helpers/markdown.js.map

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

package/dist/src/public/index.d.ts

@@ -0,0 +1,12 @@
+export { getSession, type Session, type SessionParent, type SessionTurn, } from "../runtime/session-context.js";
+export { type AgentDefinition, type AgentModelDefinition, defineAgent, } from "./definitions/agent.js";
+export { type ContextDocumentDefinition, defineContextDocument, } from "./definitions/context.js";
+export { defineSandbox, type SandboxCommandResult, type SandboxDefinition, type SandboxLifecycleContext, type SandboxSession, } from "./definitions/sandbox.js";
+export { defineSchedule, type ScheduleDefinition } from "./definitions/schedule.js";
+export { defineSkill, type SkillDefinition } from "./definitions/skill.js";
+export type { ModuleDefinitionExport } from "./definitions/source.js";
+export { defineSubagent, type SubagentDefinition, } from "./definitions/subagent.js";
+export { defineSystem, type SystemDefinition } from "./definitions/system.js";
+export { defineTool, type ToolDefinition } from "./definitions/tool.js";
+export { lowerFlatSkillMarkdown, lowerScheduleMarkdown, lowerSkillMarkdown, lowerSystemMarkdown, type ParsedMarkdownDocument, parseMarkdownDocument, } from "./helpers/markdown.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/src/public/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/public/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,UAAU,EACV,KAAK,OAAO,EACZ,KAAK,aAAa,EAClB,KAAK,WAAW,GACjB,MAAM,+BAA+B,CAAC;AACvC,OAAO,EACL,KAAK,eAAe,EACpB,KAAK,oBAAoB,EACzB,WAAW,GACZ,MAAM,wBAAwB,CAAC;AAChC,OAAO,EACL,KAAK,yBAAyB,EAC9B,qBAAqB,GACtB,MAAM,0BAA0B,CAAC;AAClC,OAAO,EACL,aAAa,EACb,KAAK,oBAAoB,EACzB,KAAK,iBAAiB,EACtB,KAAK,uBAAuB,EAC5B,KAAK,cAAc,GACpB,MAAM,0BAA0B,CAAC;AAClC,OAAO,EAAE,cAAc,EAAE,KAAK,kBAAkB,EAAE,MAAM,2BAA2B,CAAC;AACpF,OAAO,EAAE,WAAW,EAAE,KAAK,eAAe,EAAE,MAAM,wBAAwB,CAAC;AAC3E,YAAY,EAAE,sBAAsB,EAAE,MAAM,yBAAyB,CAAC;AACtE,OAAO,EACL,cAAc,EACd,KAAK,kBAAkB,GACxB,MAAM,2BAA2B,CAAC;AACnC,OAAO,EAAE,YAAY,EAAE,KAAK,gBAAgB,EAAE,MAAM,yBAAyB,CAAC;AAC9E,OAAO,EAAE,UAAU,EAAE,KAAK,cAAc,EAAE,MAAM,uBAAuB,CAAC;AACxE,OAAO,EACL,sBAAsB,EACtB,qBAAqB,EACrB,kBAAkB,EAClB,mBAAmB,EACnB,KAAK,sBAAsB,EAC3B,qBAAqB,GACtB,MAAM,uBAAuB,CAAC"}

package/dist/src/public/index.js

@@ -0,0 +1,11 @@
+export { getSession, } from "../runtime/session-context.js";
+export { defineAgent, } from "./definitions/agent.js";
+export { defineContextDocument, } from "./definitions/context.js";
+export { defineSandbox, } from "./definitions/sandbox.js";
+export { defineSchedule } from "./definitions/schedule.js";
+export { defineSkill } from "./definitions/skill.js";
+export { defineSubagent, } from "./definitions/subagent.js";
+export { defineSystem } from "./definitions/system.js";
+export { defineTool } from "./definitions/tool.js";
+export { lowerFlatSkillMarkdown, lowerScheduleMarkdown, lowerSkillMarkdown, lowerSystemMarkdown, parseMarkdownDocument, } from "./helpers/markdown.js";
+//# sourceMappingURL=index.js.map

package/dist/src/public/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/public/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,UAAU,GAIX,MAAM,+BAA+B,CAAC;AACvC,OAAO,EAGL,WAAW,GACZ,MAAM,wBAAwB,CAAC;AAChC,OAAO,EAEL,qBAAqB,GACtB,MAAM,0BAA0B,CAAC;AAClC,OAAO,EACL,aAAa,GAKd,MAAM,0BAA0B,CAAC;AAClC,OAAO,EAAE,cAAc,EAA2B,MAAM,2BAA2B,CAAC;AACpF,OAAO,EAAE,WAAW,EAAwB,MAAM,wBAAwB,CAAC;AAE3E,OAAO,EACL,cAAc,GAEf,MAAM,2BAA2B,CAAC;AACnC,OAAO,EAAE,YAAY,EAAyB,MAAM,yBAAyB,CAAC;AAC9E,OAAO,EAAE,UAAU,EAAuB,MAAM,uBAAuB,CAAC;AACxE,OAAO,EACL,sBAAsB,EACtB,qBAAqB,EACrB,kBAAkB,EAClB,mBAAmB,EAEnB,qBAAqB,GACtB,MAAM,uBAAuB,CAAC"}

package/dist/src/runtime/actions/activate-skill.d.ts

@@ -0,0 +1,19 @@
+import type { RuntimeSkillSource } from "../harness/contracts.js";
+import type { RuntimeActionResult, RuntimeActivateSkillActionRequest, RuntimeActivateSkillActionResult } from "./types.js";
+/**
+ * Executes one runtime-owned skill-activation request from already prepared
+ * runtime skill metadata.
+ */
+export declare function executeRuntimeActivateSkillAction(input: {
+    readonly action: RuntimeActivateSkillActionRequest;
+    readonly activeSkillIds: readonly string[];
+    readonly availableSkills: readonly RuntimeSkillSource[];
+}): Promise<RuntimeActivateSkillActionResult>;
+/**
+ * Applies runtime action results to the canonical active-skill id list.
+ */
+export declare function applyRuntimeActionResultsToActiveSkillIds(input: {
+    readonly activeSkillIds: readonly string[];
+    readonly results: readonly RuntimeActionResult[];
+}): string[];
+//# sourceMappingURL=activate-skill.d.ts.map

package/dist/src/runtime/actions/activate-skill.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"activate-skill.d.ts","sourceRoot":"","sources":["../../../../src/runtime/actions/activate-skill.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,yBAAyB,CAAC;AAGlE,OAAO,KAAK,EACV,mBAAmB,EACnB,iCAAiC,EACjC,gCAAgC,EACjC,MAAM,YAAY,CAAC;AAEpB;;;GAGG;AACH,wBAAsB,iCAAiC,CAAC,KAAK,EAAE;IAC7D,QAAQ,CAAC,MAAM,EAAE,iCAAiC,CAAC;IACnD,QAAQ,CAAC,cAAc,EAAE,SAAS,MAAM,EAAE,CAAC;IAC3C,QAAQ,CAAC,eAAe,EAAE,SAAS,kBAAkB,EAAE,CAAC;CACzD,GAAG,OAAO,CAAC,gCAAgC,CAAC,CAuD5C;AAED;;GAEG;AACH,wBAAgB,yCAAyC,CAAC,KAAK,EAAE;IAC/D,QAAQ,CAAC,cAAc,EAAE,SAAS,MAAM,EAAE,CAAC;IAC3C,QAAQ,CAAC,OAAO,EAAE,SAAS,mBAAmB,EAAE,CAAC;CAClD,GAAG,MAAM,EAAE,CAkBX"}

package/dist/src/runtime/actions/activate-skill.js

@@ -0,0 +1,74 @@
+import { findRuntimeSkillSource } from "../skills/load-skills.js";
+/**
+ * Executes one runtime-owned skill-activation request from already prepared
+ * runtime skill metadata.
+ */
+export async function executeRuntimeActivateSkillAction(input) {
+    const identifier = typeof input.action.input.skill === "string" ? input.action.input.skill.trim() : "";
+    if (identifier.length === 0) {
+        return {
+            callId: input.action.callId,
+            kind: "activate-skill-result",
+            output: {
+                activated: false,
+                code: "INVALID_SKILL_IDENTIFIER",
+                message: 'Expected "skill" to be a non-empty string.',
+            },
+        };
+    }
+    const source = findRuntimeSkillSource(input.availableSkills, identifier);
+    if (source === null) {
+        return {
+            callId: input.action.callId,
+            kind: "activate-skill-result",
+            output: {
+                activated: false,
+                code: "SKILL_NOT_FOUND",
+                message: `No available skill matched "${identifier}".`,
+            },
+        };
+    }
+    if (input.activeSkillIds.includes(source.skillId)) {
+        return {
+            callId: input.action.callId,
+            kind: "activate-skill-result",
+            output: {
+                activated: false,
+                code: "SKILL_ALREADY_ACTIVE",
+                name: source.name,
+                skillId: source.skillId,
+            },
+            skillId: source.skillId,
+        };
+    }
+    return {
+        callId: input.action.callId,
+        kind: "activate-skill-result",
+        output: {
+            activated: true,
+            description: source.description,
+            name: source.name,
+            skillId: source.skillId,
+        },
+        skillId: source.skillId,
+    };
+}
+/**
+ * Applies runtime action results to the canonical active-skill id list.
+ */
+export function applyRuntimeActionResultsToActiveSkillIds(input) {
+    const nextActiveSkillIds = [...input.activeSkillIds];
+    const seen = new Set(nextActiveSkillIds);
+    for (const result of input.results) {
+        if (result.kind !== "activate-skill-result" || result.skillId === undefined) {
+            continue;
+        }
+        if (seen.has(result.skillId)) {
+            continue;
+        }
+        nextActiveSkillIds.push(result.skillId);
+        seen.add(result.skillId);
+    }
+    return nextActiveSkillIds;
+}
+//# sourceMappingURL=activate-skill.js.map

package/dist/src/runtime/actions/activate-skill.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"activate-skill.js","sourceRoot":"","sources":["../../../../src/runtime/actions/activate-skill.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,sBAAsB,EAAE,MAAM,0BAA0B,CAAC;AAQlE;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,iCAAiC,CAAC,KAIvD;IACC,MAAM,UAAU,GACd,OAAO,KAAK,CAAC,MAAM,CAAC,KAAK,CAAC,KAAK,KAAK,QAAQ,CAAC,CAAC,CAAC,KAAK,CAAC,MAAM,CAAC,KAAK,CAAC,KAAK,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;IAEtF,IAAI,UAAU,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAC5B,OAAO;YACL,MAAM,EAAE,KAAK,CAAC,MAAM,CAAC,MAAM;YAC3B,IAAI,EAAE,uBAAuB;YAC7B,MAAM,EAAE;gBACN,SAAS,EAAE,KAAK;gBAChB,IAAI,EAAE,0BAA0B;gBAChC,OAAO,EAAE,4CAA4C;aACtD;SACF,CAAC;IACJ,CAAC;IAED,MAAM,MAAM,GAAG,sBAAsB,CAAC,KAAK,CAAC,eAAe,EAAE,UAAU,CAAC,CAAC;IAEzE,IAAI,MAAM,KAAK,IAAI,EAAE,CAAC;QACpB,OAAO;YACL,MAAM,EAAE,KAAK,CAAC,MAAM,CAAC,MAAM;YAC3B,IAAI,EAAE,uBAAuB;YAC7B,MAAM,EAAE;gBACN,SAAS,EAAE,KAAK;gBAChB,IAAI,EAAE,iBAAiB;gBACvB,OAAO,EAAE,+BAA+B,UAAU,IAAI;aACvD;SACF,CAAC;IACJ,CAAC;IAED,IAAI,KAAK,CAAC,cAAc,CAAC,QAAQ,CAAC,MAAM,CAAC,OAAO,CAAC,EAAE,CAAC;QAClD,OAAO;YACL,MAAM,EAAE,KAAK,CAAC,MAAM,CAAC,MAAM;YAC3B,IAAI,EAAE,uBAAuB;YAC7B,MAAM,EAAE;gBACN,SAAS,EAAE,KAAK;gBAChB,IAAI,EAAE,sBAAsB;gBAC5B,IAAI,EAAE,MAAM,CAAC,IAAI;gBACjB,OAAO,EAAE,MAAM,CAAC,OAAO;aACxB;YACD,OAAO,EAAE,MAAM,CAAC,OAAO;SACxB,CAAC;IACJ,CAAC;IAED,OAAO;QACL,MAAM,EAAE,KAAK,CAAC,MAAM,CAAC,MAAM;QAC3B,IAAI,EAAE,uBAAuB;QAC7B,MAAM,EAAE;YACN,SAAS,EAAE,IAAI;YACf,WAAW,EAAE,MAAM,CAAC,WAAW;YAC/B,IAAI,EAAE,MAAM,CAAC,IAAI;YACjB,OAAO,EAAE,MAAM,CAAC,OAAO;SACxB;QACD,OAAO,EAAE,MAAM,CAAC,OAAO;KACxB,CAAC;AACJ,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,yCAAyC,CAAC,KAGzD;IACC,MAAM,kBAAkB,GAAG,CAAC,GAAG,KAAK,CAAC,cAAc,CAAC,CAAC;IACrD,MAAM,IAAI,GAAG,IAAI,GAAG,CAAC,kBAAkB,CAAC,CAAC;IAEzC,KAAK,MAAM,MAAM,IAAI,KAAK,CAAC,OAAO,EAAE,CAAC;QACnC,IAAI,MAAM,CAAC,IAAI,KAAK,uBAAuB,IAAI,MAAM,CAAC,OAAO,KAAK,SAAS,EAAE,CAAC;YAC5E,SAAS;QACX,CAAC;QAED,IAAI,IAAI,CAAC,GAAG,CAAC,MAAM,CAAC,OAAO,CAAC,EAAE,CAAC;YAC7B,SAAS;QACX,CAAC;QAED,kBAAkB,CAAC,IAAI,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;QACxC,IAAI,CAAC,GAAG,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;IAC3B,CAAC;IAED,OAAO,kBAAkB,CAAC;AAC5B,CAAC"}

package/dist/src/runtime/actions/execute-action.d.ts

@@ -0,0 +1,34 @@
+import type { RuntimeSkillSource } from "../harness/contracts.js";
+import type { Session } from "../session-context.js";
+import type { PreparedRuntimeTool } from "../sessions/turn.js";
+import type { RuntimeToolRegistry } from "../tools/registry.js";
+import type { RuntimeActionRequest, RuntimeActionResult } from "./types.js";
+/**
+ * Input for executing one runtime-owned action through the active runtime
+ * executor.
+ */
+export interface ExecuteRuntimeActionInput {
+    readonly action: RuntimeActionRequest;
+    readonly activeSkillIds: readonly string[];
+    readonly availableSkills: readonly RuntimeSkillSource[];
+    readonly session: Session;
+    readonly toolRegistry: RuntimeToolRegistry;
+    readonly visibleTools: readonly PreparedRuntimeTool[];
+}
+/**
+ * Executes one surfaced runtime action through the active runtime executor.
+ */
+export declare function executeRuntimeAction(input: ExecuteRuntimeActionInput): Promise<RuntimeActionResult>;
+/**
+ * Executes one surfaced runtime-action batch in parallel while preserving the
+ * harness-requested result ordering.
+ */
+export declare function executeRuntimeActionBatch(input: {
+    readonly actions: readonly RuntimeActionRequest[];
+    readonly activeSkillIds: readonly string[];
+    readonly availableSkills: readonly RuntimeSkillSource[];
+    readonly session: Session;
+    readonly toolRegistry: RuntimeToolRegistry;
+    readonly visibleTools: readonly PreparedRuntimeTool[];
+}): Promise<readonly RuntimeActionResult[]>;
+//# sourceMappingURL=execute-action.d.ts.map

package/dist/src/runtime/actions/execute-action.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"execute-action.d.ts","sourceRoot":"","sources":["../../../../src/runtime/actions/execute-action.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,yBAAyB,CAAC;AAClE,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,uBAAuB,CAAC;AACrD,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,qBAAqB,CAAC;AAG/D,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,sBAAsB,CAAC;AAGhE,OAAO,KAAK,EAAE,oBAAoB,EAAE,mBAAmB,EAAE,MAAM,YAAY,CAAC;AAE5E;;;GAGG;AACH,MAAM,WAAW,yBAAyB;IACxC,QAAQ,CAAC,MAAM,EAAE,oBAAoB,CAAC;IACtC,QAAQ,CAAC,cAAc,EAAE,SAAS,MAAM,EAAE,CAAC;IAC3C,QAAQ,CAAC,eAAe,EAAE,SAAS,kBAAkB,EAAE,CAAC;IACxD,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC;IAC1B,QAAQ,CAAC,YAAY,EAAE,mBAAmB,CAAC;IAC3C,QAAQ,CAAC,YAAY,EAAE,SAAS,mBAAmB,EAAE,CAAC;CACvD;AAED;;GAEG;AACH,wBAAsB,oBAAoB,CACxC,KAAK,EAAE,yBAAyB,GAC/B,OAAO,CAAC,mBAAmB,CAAC,CAoB9B;AAED;;;GAGG;AACH,wBAAsB,yBAAyB,CAAC,KAAK,EAAE;IACrD,QAAQ,CAAC,OAAO,EAAE,SAAS,oBAAoB,EAAE,CAAC;IAClD,QAAQ,CAAC,cAAc,EAAE,SAAS,MAAM,EAAE,CAAC;IAC3C,QAAQ,CAAC,eAAe,EAAE,SAAS,kBAAkB,EAAE,CAAC;IACxD,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC;IAC1B,QAAQ,CAAC,YAAY,EAAE,mBAAmB,CAAC;IAC3C,QAAQ,CAAC,YAAY,EAAE,SAAS,mBAAmB,EAAE,CAAC;CACvD,GAAG,OAAO,CAAC,SAAS,mBAAmB,EAAE,CAAC,CAa1C"}

package/dist/src/runtime/actions/execute-action.js

@@ -0,0 +1,42 @@
+import { executeRuntimeSubagentCall } from "../subagents/execute-subagent.js";
+import { executeRuntimeToolCall } from "../tools/execute-tool.js";
+import { executeRuntimeActivateSkillAction } from "./activate-skill.js";
+/**
+ * Executes one surfaced runtime action through the active runtime executor.
+ */
+export async function executeRuntimeAction(input) {
+    switch (input.action.kind) {
+        case "activate-skill":
+            return executeRuntimeActivateSkillAction({
+                action: input.action,
+                activeSkillIds: input.activeSkillIds,
+                availableSkills: input.availableSkills,
+            });
+        case "subagent-call":
+            return executeRuntimeSubagentCall({
+                action: input.action,
+            });
+        case "tool-call":
+            return executeRuntimeToolCall({
+                action: input.action,
+                registry: input.toolRegistry,
+                session: input.session,
+                visibleTools: input.visibleTools,
+            });
+    }
+}
+/**
+ * Executes one surfaced runtime-action batch in parallel while preserving the
+ * harness-requested result ordering.
+ */
+export async function executeRuntimeActionBatch(input) {
+    return await Promise.all(input.actions.map((action) => executeRuntimeAction({
+        action,
+        activeSkillIds: input.activeSkillIds,
+        availableSkills: input.availableSkills,
+        session: input.session,
+        toolRegistry: input.toolRegistry,
+        visibleTools: input.visibleTools,
+    })));
+}
+//# sourceMappingURL=execute-action.js.map

package/dist/src/runtime/actions/execute-action.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"execute-action.js","sourceRoot":"","sources":["../../../../src/runtime/actions/execute-action.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,0BAA0B,EAAE,MAAM,kCAAkC,CAAC;AAC9E,OAAO,EAAE,sBAAsB,EAAE,MAAM,0BAA0B,CAAC;AAElE,OAAO,EAAE,iCAAiC,EAAE,MAAM,qBAAqB,CAAC;AAiBxE;;GAEG;AACH,MAAM,CAAC,KAAK,UAAU,oBAAoB,CACxC,KAAgC;IAEhC,QAAQ,KAAK,CAAC,MAAM,CAAC,IAAI,EAAE,CAAC;QAC1B,KAAK,gBAAgB;YACnB,OAAO,iCAAiC,CAAC;gBACvC,MAAM,EAAE,KAAK,CAAC,MAAM;gBACpB,cAAc,EAAE,KAAK,CAAC,cAAc;gBACpC,eAAe,EAAE,KAAK,CAAC,eAAe;aACvC,CAAC,CAAC;QACL,KAAK,eAAe;YAClB,OAAO,0BAA0B,CAAC;gBAChC,MAAM,EAAE,KAAK,CAAC,MAAM;aACrB,CAAC,CAAC;QACL,KAAK,WAAW;YACd,OAAO,sBAAsB,CAAC;gBAC5B,MAAM,EAAE,KAAK,CAAC,MAAM;gBACpB,QAAQ,EAAE,KAAK,CAAC,YAAY;gBAC5B,OAAO,EAAE,KAAK,CAAC,OAAO;gBACtB,YAAY,EAAE,KAAK,CAAC,YAAY;aACjC,CAAC,CAAC;IACP,CAAC;AACH,CAAC;AAED;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,yBAAyB,CAAC,KAO/C;IACC,OAAO,MAAM,OAAO,CAAC,GAAG,CACtB,KAAK,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,MAAM,EAAE,EAAE,CAC3B,oBAAoB,CAAC;QACnB,MAAM;QACN,cAAc,EAAE,KAAK,CAAC,cAAc;QACpC,eAAe,EAAE,KAAK,CAAC,eAAe;QACtC,OAAO,EAAE,KAAK,CAAC,OAAO;QACtB,YAAY,EAAE,KAAK,CAAC,YAAY;QAChC,YAAY,EAAE,KAAK,CAAC,YAAY;KACjC,CAAC,CACH,CACF,CAAC;AACJ,CAAC"}