@studio-foundation/runner 0.3.0-beta.1

package/dist/tools/skills/skill-loader.test.js

@@ -0,0 +1,92 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const vitest_1 = require("vitest");
+const promises_1 = require("node:fs/promises");
+const node_path_1 = require("node:path");
+const skill_loader_js_1 = require("./skill-loader.js");
+const TMP = (0, node_path_1.join)('/tmp', '.studio-runner-skill-loader-test-' + Date.now());
+const SKILLS_DIR = (0, node_path_1.join)(TMP, 'skills');
+(0, vitest_1.describe)('loadSkill', () => {
+    (0, vitest_1.beforeAll)(async () => {
+        await (0, promises_1.mkdir)(SKILLS_DIR, { recursive: true });
+        await (0, promises_1.writeFile)((0, node_path_1.join)(SKILLS_DIR, 'commit-conventions.skill.md'), '# Commit Conventions\n\nUse conventional commits.');
+        await (0, promises_1.writeFile)((0, node_path_1.join)(SKILLS_DIR, 'react-patterns.skill.md'), '# React Patterns\n\nPrefer hooks.');
+    });
+    (0, vitest_1.afterAll)(async () => {
+        await (0, promises_1.rm)(TMP, { recursive: true, force: true });
+    });
+    (0, vitest_1.it)('returns SkillContent for an existing skill file', async () => {
+        const skill = await (0, skill_loader_js_1.loadSkill)('commit-conventions', TMP);
+        (0, vitest_1.expect)(skill).toEqual({
+            name: 'commit-conventions',
+            content: '# Commit Conventions\n\nUse conventional commits.',
+        });
+    });
+    (0, vitest_1.it)('returns null and warns for a missing skill file', async () => {
+        const warnSpy = vitest_1.vi.spyOn(console, 'warn').mockImplementation(() => { });
+        const skill = await (0, skill_loader_js_1.loadSkill)('nonexistent', TMP);
+        (0, vitest_1.expect)(skill).toBeNull();
+        (0, vitest_1.expect)(warnSpy).toHaveBeenCalledWith(vitest_1.expect.stringContaining('nonexistent'));
+        warnSpy.mockRestore();
+    });
+    (0, vitest_1.it)('returns null when studioDir has no skills/ subdirectory', async () => {
+        const warnSpy = vitest_1.vi.spyOn(console, 'warn').mockImplementation(() => { });
+        const skill = await (0, skill_loader_js_1.loadSkill)('commit-conventions', '/tmp/nonexistent-studio-dir-xyz');
+        (0, vitest_1.expect)(skill).toBeNull();
+        warnSpy.mockRestore();
+    });
+});
+(0, vitest_1.describe)('loadSkills', () => {
+    (0, vitest_1.beforeAll)(async () => {
+        await (0, promises_1.mkdir)(SKILLS_DIR, { recursive: true }).catch(() => { });
+        await (0, promises_1.writeFile)((0, node_path_1.join)(SKILLS_DIR, 'commit-conventions.skill.md'), '# Commit Conventions\n\nUse conventional commits.').catch(() => { });
+        await (0, promises_1.writeFile)((0, node_path_1.join)(SKILLS_DIR, 'react-patterns.skill.md'), '# React Patterns\n\nPrefer hooks.').catch(() => { });
+    });
+    (0, vitest_1.it)('loads all named skills from .studio/skills/', async () => {
+        const skills = await (0, skill_loader_js_1.loadSkills)(['commit-conventions', 'react-patterns'], TMP);
+        (0, vitest_1.expect)(skills).toHaveLength(2);
+        (0, vitest_1.expect)(skills[0]).toEqual({ name: 'commit-conventions', content: '# Commit Conventions\n\nUse conventional commits.' });
+        (0, vitest_1.expect)(skills[1]).toEqual({ name: 'react-patterns', content: '# React Patterns\n\nPrefer hooks.' });
+    });
+    (0, vitest_1.it)('skips missing skills and returns the ones that exist', async () => {
+        const warnSpy = vitest_1.vi.spyOn(console, 'warn').mockImplementation(() => { });
+        const skills = await (0, skill_loader_js_1.loadSkills)(['commit-conventions', 'missing-skill'], TMP);
+        (0, vitest_1.expect)(skills).toHaveLength(1);
+        (0, vitest_1.expect)(skills[0].name).toBe('commit-conventions');
+        (0, vitest_1.expect)(warnSpy).toHaveBeenCalledWith(vitest_1.expect.stringContaining('missing-skill'));
+        warnSpy.mockRestore();
+    });
+    (0, vitest_1.it)('returns empty array when names list is empty', async () => {
+        const skills = await (0, skill_loader_js_1.loadSkills)([], TMP);
+        (0, vitest_1.expect)(skills).toHaveLength(0);
+    });
+    (0, vitest_1.it)('returns empty array when studioDir has no skills/ directory', async () => {
+        const warnSpy = vitest_1.vi.spyOn(console, 'warn').mockImplementation(() => { });
+        const skills = await (0, skill_loader_js_1.loadSkills)(['commit-conventions'], '/tmp/nonexistent-studio-xyz');
+        (0, vitest_1.expect)(skills).toHaveLength(0);
+        warnSpy.mockRestore();
+    });
+});
+(0, vitest_1.describe)('validateSkillManifest', () => {
+    (0, vitest_1.it)('returns true for a valid skill manifest', () => {
+        (0, vitest_1.expect)((0, skill_loader_js_1.validateSkillManifest)({ name: 'my-skill', content: '# My Skill\n\nContent here.' })).toBe(true);
+    });
+    (0, vitest_1.it)('throws when manifest is missing name', () => {
+        (0, vitest_1.expect)(() => (0, skill_loader_js_1.validateSkillManifest)({ content: 'some content' })).toThrow();
+    });
+    (0, vitest_1.it)('throws when manifest is missing content', () => {
+        (0, vitest_1.expect)(() => (0, skill_loader_js_1.validateSkillManifest)({ name: 'my-skill' })).toThrow();
+    });
+    (0, vitest_1.it)('throws when manifest is not an object', () => {
+        (0, vitest_1.expect)(() => (0, skill_loader_js_1.validateSkillManifest)(null)).toThrow();
+        (0, vitest_1.expect)(() => (0, skill_loader_js_1.validateSkillManifest)('string')).toThrow();
+        (0, vitest_1.expect)(() => (0, skill_loader_js_1.validateSkillManifest)(42)).toThrow();
+    });
+    (0, vitest_1.it)('throws when name is not a string', () => {
+        (0, vitest_1.expect)(() => (0, skill_loader_js_1.validateSkillManifest)({ name: 123, content: 'content' })).toThrow();
+    });
+    (0, vitest_1.it)('throws when content is not a string', () => {
+        (0, vitest_1.expect)(() => (0, skill_loader_js_1.validateSkillManifest)({ name: 'skill', content: [] })).toThrow();
+    });
+});
+//# sourceMappingURL=skill-loader.test.js.map

package/dist/tools/skills/skill-loader.test.js.map

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

package/dist/tools/tool-executor.d.ts

@@ -0,0 +1,12 @@
+import { ToolCall } from '@studio-foundation/contracts';
+import { ToolRegistry } from './tool-registry.js';
+export declare class ToolExecutor {
+    private registry;
+    constructor(registry: ToolRegistry);
+    execute(toolCall: {
+        id: string;
+        name: string;
+        arguments: Record<string, unknown>;
+    }): Promise<ToolCall>;
+}
+//# sourceMappingURL=tool-executor.d.ts.map

package/dist/tools/tool-executor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tool-executor.d.ts","sourceRoot":"","sources":["../../src/tools/tool-executor.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,8BAA8B,CAAC;AACxD,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AA4BlD,qBAAa,YAAY;IACX,OAAO,CAAC,QAAQ;gBAAR,QAAQ,EAAE,YAAY;IAEpC,OAAO,CAAC,QAAQ,EAAE;QAAE,EAAE,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAC;QAAC,SAAS,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;KAAE,GAAG,OAAO,CAAC,QAAQ,CAAC;CAmD7G"}

package/dist/tools/tool-executor.js

@@ -0,0 +1,76 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ToolExecutor = void 0;
+/**
+ * Validate LLM-provided arguments against the tool's JSON Schema.
+ * Returns an error string if invalid, null if OK.
+ */
+function validateArgs(toolName, schema, args) {
+    const properties = schema.properties ?? {};
+    const required = schema.required ?? [];
+    const declared = new Set(Object.keys(properties));
+    const missing = required.filter(p => !(p in args));
+    if (missing.length > 0) {
+        return `Tool ${toolName}: missing required parameter${missing.length > 1 ? 's' : ''}: ${missing.join(', ')}`;
+    }
+    const unknown = Object.keys(args).filter(p => !declared.has(p));
+    if (unknown.length > 0) {
+        return `Tool ${toolName}: unknown parameter${unknown.length > 1 ? 's' : ''}: ${unknown.join(', ')} (declared: ${[...declared].join(', ')})`;
+    }
+    return null;
+}
+class ToolExecutor {
+    registry;
+    constructor(registry) {
+        this.registry = registry;
+    }
+    async execute(toolCall) {
+        const tool = this.registry.get(toolCall.name);
+        if (!tool) {
+            return {
+                id: toolCall.id,
+                name: toolCall.name,
+                arguments: toolCall.arguments,
+                error: `Tool not found: ${toolCall.name}`
+            };
+        }
+        // Validate arguments against the tool's parameter schema
+        const validationError = validateArgs(toolCall.name, tool.parameters, toolCall.arguments);
+        if (validationError) {
+            return {
+                id: toolCall.id,
+                name: toolCall.name,
+                arguments: toolCall.arguments,
+                error: validationError,
+            };
+        }
+        try {
+            const toolResult = await tool.execute(toolCall.arguments);
+            if (!toolResult.success) {
+                return {
+                    id: toolCall.id,
+                    name: toolCall.name,
+                    arguments: toolCall.arguments,
+                    error: toolResult.error || 'Tool execution failed'
+                };
+            }
+            return {
+                id: toolCall.id,
+                name: toolCall.name,
+                arguments: toolCall.arguments,
+                result: toolResult.output
+            };
+        }
+        catch (error) {
+            const errorMessage = error instanceof Error ? error.message : String(error);
+            return {
+                id: toolCall.id,
+                name: toolCall.name,
+                arguments: toolCall.arguments,
+                error: errorMessage
+            };
+        }
+    }
+}
+exports.ToolExecutor = ToolExecutor;
+//# sourceMappingURL=tool-executor.js.map

package/dist/tools/tool-executor.js.map

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

package/dist/tools/tool-executor.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=tool-executor.test.d.ts.map

package/dist/tools/tool-executor.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tool-executor.test.d.ts","sourceRoot":"","sources":["../../src/tools/tool-executor.test.ts"],"names":[],"mappings":""}

package/dist/tools/tool-executor.test.js

@@ -0,0 +1,83 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const vitest_1 = require("vitest");
+const tool_executor_js_1 = require("./tool-executor.js");
+const tool_registry_js_1 = require("./tool-registry.js");
+function makeRegistry(paramSchema) {
+    const registry = new tool_registry_js_1.ToolRegistry();
+    registry.register({
+        name: 'test-tool',
+        description: 'A test tool',
+        parameters: paramSchema,
+        execute: vitest_1.vi.fn().mockResolvedValue({ success: true, output: 'ok' }),
+    });
+    return registry;
+}
+const SCHEMA_WITH_REQUIRED = {
+    type: 'object',
+    properties: {
+        query: { type: 'string', description: 'Search query' },
+    },
+    required: ['query'],
+};
+const SCHEMA_NO_REQUIRED = {
+    type: 'object',
+    properties: {
+        query: { type: 'string', description: 'Search query' },
+    },
+};
+(0, vitest_1.describe)('ToolExecutor — argument validation', () => {
+    (0, vitest_1.it)('returns error for missing required parameter', async () => {
+        const executor = new tool_executor_js_1.ToolExecutor(makeRegistry(SCHEMA_WITH_REQUIRED));
+        const result = await executor.execute({
+            id: '1',
+            name: 'test-tool',
+            arguments: {},
+        });
+        (0, vitest_1.expect)(result.error).toMatch(/missing required parameter.*query/);
+        (0, vitest_1.expect)(result.result).toBeUndefined();
+    });
+    (0, vitest_1.it)('returns error for unknown parameter', async () => {
+        const executor = new tool_executor_js_1.ToolExecutor(makeRegistry(SCHEMA_WITH_REQUIRED));
+        const result = await executor.execute({
+            id: '2',
+            name: 'test-tool',
+            arguments: { query: 'hello', pattern: 'oops' },
+        });
+        (0, vitest_1.expect)(result.error).toMatch(/unknown parameter.*pattern/);
+        (0, vitest_1.expect)(result.error).toMatch(/declared: query/);
+        (0, vitest_1.expect)(result.result).toBeUndefined();
+    });
+    (0, vitest_1.it)('executes successfully with correct required parameters', async () => {
+        const registry = makeRegistry(SCHEMA_WITH_REQUIRED);
+        const executor = new tool_executor_js_1.ToolExecutor(registry);
+        const result = await executor.execute({
+            id: '3',
+            name: 'test-tool',
+            arguments: { query: 'ramen' },
+        });
+        (0, vitest_1.expect)(result.error).toBeUndefined();
+        (0, vitest_1.expect)(result.result).toBe('ok');
+    });
+    (0, vitest_1.it)('executes successfully with no required parameters and empty args', async () => {
+        const executor = new tool_executor_js_1.ToolExecutor(makeRegistry(SCHEMA_NO_REQUIRED));
+        const result = await executor.execute({
+            id: '4',
+            name: 'test-tool',
+            arguments: {},
+        });
+        (0, vitest_1.expect)(result.error).toBeUndefined();
+        (0, vitest_1.expect)(result.result).toBe('ok');
+    });
+    (0, vitest_1.it)('executes successfully with optional parameter provided', async () => {
+        const executor = new tool_executor_js_1.ToolExecutor(makeRegistry(SCHEMA_NO_REQUIRED));
+        const result = await executor.execute({
+            id: '5',
+            name: 'test-tool',
+            arguments: { query: 'ramen' },
+        });
+        (0, vitest_1.expect)(result.error).toBeUndefined();
+        (0, vitest_1.expect)(result.result).toBe('ok');
+    });
+});
+//# sourceMappingURL=tool-executor.test.js.map

package/dist/tools/tool-executor.test.js.map

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

package/dist/tools/tool-registry.d.ts

@@ -0,0 +1,65 @@
+/**
+ * Tool registry - manages tool definitions and execution
+ */
+import { ToolDefinition } from '@studio-foundation/contracts';
+/** Normalize tool name: dots → hyphens so both conventions work */
+export declare function normalizeToolName(name: string): string;
+export interface ToolResult {
+    success: boolean;
+    output: unknown;
+    error?: string;
+}
+export interface Tool {
+    name: string;
+    description: string;
+    parameters: Record<string, unknown>;
+    execute(args: Record<string, unknown>): Promise<ToolResult>;
+}
+export declare class ToolRegistry {
+    private tools;
+    private toolToPlugin;
+    private pluginSnippets;
+    /**
+     * Register a single tool (no plugin metadata).
+     */
+    register(tool: Tool): void;
+    /**
+     * Register all tools belonging to a plugin.
+     * If promptSnippet is provided it will be returned by getActiveSnippets()
+     * whenever any tool from this plugin is in the registry.
+     */
+    registerPlugin(pluginName: string, tools: Tool[], promptSnippet?: string): void;
+    /**
+     * Get tool by name
+     */
+    get(name: string): Tool | undefined;
+    /**
+     * Check if tool exists
+     */
+    has(name: string): boolean;
+    /**
+     * List all tools
+     */
+    list(): Tool[];
+    /**
+     * Convert tools to LLM tool definitions format
+     */
+    toToolDefinitions(): ToolDefinition[];
+    /**
+     * Return prompt snippets for all plugins that have at least one tool
+     * currently in this registry.
+     */
+    getActiveSnippets(): string[];
+    /**
+     * Create a new registry filtered to specific tool names.
+     * Normalizes dots to hyphens so both "repo_manager.write_file"
+     * and "repo_manager-write_file" match the registered name.
+     * Plugin snippet metadata is carried over for included tools.
+     */
+    filter(allowedTools: string[]): ToolRegistry;
+    /**
+     * Create a full copy of this registry (all tools + plugin metadata).
+     */
+    clone(): ToolRegistry;
+}
+//# sourceMappingURL=tool-registry.d.ts.map

package/dist/tools/tool-registry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tool-registry.d.ts","sourceRoot":"","sources":["../../src/tools/tool-registry.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,cAAc,EAAE,MAAM,8BAA8B,CAAC;AAE9D,mEAAmE;AACnE,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAEtD;AAED,MAAM,WAAW,UAAU;IACzB,OAAO,EAAE,OAAO,CAAC;IACjB,MAAM,EAAE,OAAO,CAAC;IAChB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,IAAI;IACnB,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACpC,OAAO,CAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,OAAO,CAAC,UAAU,CAAC,CAAC;CAC7D;AAED,qBAAa,YAAY;IACvB,OAAO,CAAC,KAAK,CAAgC;IAC7C,OAAO,CAAC,YAAY,CAAkC;IACtD,OAAO,CAAC,cAAc,CAAkC;IAExD;;OAEG;IACH,QAAQ,CAAC,IAAI,EAAE,IAAI,GAAG,IAAI;IAI1B;;;;OAIG;IACH,cAAc,CAAC,UAAU,EAAE,MAAM,EAAE,KAAK,EAAE,IAAI,EAAE,EAAE,aAAa,CAAC,EAAE,MAAM,GAAG,IAAI;IAU/E;;OAEG;IACH,GAAG,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS;IAInC;;OAEG;IACH,GAAG,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO;IAI1B;;OAEG;IACH,IAAI,IAAI,IAAI,EAAE;IAId;;OAEG;IACH,iBAAiB,IAAI,cAAc,EAAE;IAQrC;;;OAGG;IACH,iBAAiB,IAAI,MAAM,EAAE;IAW7B;;;;;OAKG;IACH,MAAM,CAAC,YAAY,EAAE,MAAM,EAAE,GAAG,YAAY;IAmB5C;;OAEG;IACH,KAAK,IAAI,YAAY;CAGtB"}

package/dist/tools/tool-registry.js

@@ -0,0 +1,112 @@
+"use strict";
+/**
+ * Tool registry - manages tool definitions and execution
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ToolRegistry = void 0;
+exports.normalizeToolName = normalizeToolName;
+/** Normalize tool name: dots → hyphens so both conventions work */
+function normalizeToolName(name) {
+    return name.replace(/\./g, '-');
+}
+class ToolRegistry {
+    tools = new Map();
+    toolToPlugin = new Map(); // normalized name → plugin name
+    pluginSnippets = new Map(); // plugin name → snippet
+    /**
+     * Register a single tool (no plugin metadata).
+     */
+    register(tool) {
+        this.tools.set(tool.name, tool);
+    }
+    /**
+     * Register all tools belonging to a plugin.
+     * If promptSnippet is provided it will be returned by getActiveSnippets()
+     * whenever any tool from this plugin is in the registry.
+     */
+    registerPlugin(pluginName, tools, promptSnippet) {
+        for (const tool of tools) {
+            this.register(tool);
+            this.toolToPlugin.set(normalizeToolName(tool.name), pluginName);
+        }
+        if (promptSnippet) {
+            this.pluginSnippets.set(pluginName, promptSnippet);
+        }
+    }
+    /**
+     * Get tool by name
+     */
+    get(name) {
+        return this.tools.get(name);
+    }
+    /**
+     * Check if tool exists
+     */
+    has(name) {
+        return this.tools.has(name);
+    }
+    /**
+     * List all tools
+     */
+    list() {
+        return Array.from(this.tools.values());
+    }
+    /**
+     * Convert tools to LLM tool definitions format
+     */
+    toToolDefinitions() {
+        return this.list().map(tool => ({
+            name: tool.name,
+            description: tool.description,
+            parameters: tool.parameters
+        }));
+    }
+    /**
+     * Return prompt snippets for all plugins that have at least one tool
+     * currently in this registry.
+     */
+    getActiveSnippets() {
+        const activePlugins = new Set();
+        for (const toolName of this.tools.keys()) {
+            const plugin = this.toolToPlugin.get(normalizeToolName(toolName));
+            if (plugin)
+                activePlugins.add(plugin);
+        }
+        return Array.from(activePlugins)
+            .map(p => this.pluginSnippets.get(p))
+            .filter((s) => s !== undefined);
+    }
+    /**
+     * Create a new registry filtered to specific tool names.
+     * Normalizes dots to hyphens so both "repo_manager.write_file"
+     * and "repo_manager-write_file" match the registered name.
+     * Plugin snippet metadata is carried over for included tools.
+     */
+    filter(allowedTools) {
+        const filtered = new ToolRegistry();
+        for (const toolName of allowedTools) {
+            const tool = this.tools.get(toolName)
+                ?? this.tools.get(normalizeToolName(toolName));
+            if (tool) {
+                filtered.register(tool);
+                // Carry over plugin metadata so getActiveSnippets() works on filtered registry
+                const pluginName = this.toolToPlugin.get(normalizeToolName(tool.name));
+                if (pluginName) {
+                    filtered.toolToPlugin.set(normalizeToolName(tool.name), pluginName);
+                    const snippet = this.pluginSnippets.get(pluginName);
+                    if (snippet)
+                        filtered.pluginSnippets.set(pluginName, snippet);
+                }
+            }
+        }
+        return filtered;
+    }
+    /**
+     * Create a full copy of this registry (all tools + plugin metadata).
+     */
+    clone() {
+        return this.filter(Array.from(this.tools.keys()));
+    }
+}
+exports.ToolRegistry = ToolRegistry;
+//# sourceMappingURL=tool-registry.js.map

package/dist/tools/tool-registry.js.map

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

package/dist/tools/yaml-executor.d.ts

@@ -0,0 +1,22 @@
+import type { ParseOutputFormat } from '@studio-foundation/contracts';
+/**
+ * Render a shell command template with parameter substitution.
+ *
+ * Supports:
+ *   {{param}}              → stringify value (empty string if undefined)
+ *   {{#if param}}...{{/if}}              → include block only when param is truthy
+ *   {{#if param}}...{{else}}...{{/if}}   → if/else block
+ *   {{param | join 'sep'}} → join array with separator
+ *   {{param | json}}       → JSON.stringify(value)
+ */
+export declare function renderTemplate(template: string, params: Record<string, unknown>): string;
+export interface ShellResult {
+    success: boolean;
+    output: unknown;
+    error?: string;
+}
+/**
+ * Execute a rendered shell command and parse the output.
+ */
+export declare function executeShellCommand(command: string, parseOutput: ParseOutputFormat | undefined, workingDir: string, timeoutMs?: number, env?: Record<string, string>): Promise<ShellResult>;
+//# sourceMappingURL=yaml-executor.d.ts.map

package/dist/tools/yaml-executor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"yaml-executor.d.ts","sourceRoot":"","sources":["../../src/tools/yaml-executor.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,8BAA8B,CAAC;AAItE;;;;;;;;;GASG;AACH,wBAAgB,cAAc,CAC5B,QAAQ,EAAE,MAAM,EAChB,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAC9B,MAAM,CA+CR;AAED,MAAM,WAAW,WAAW;IAC1B,OAAO,EAAE,OAAO,CAAC;IACjB,MAAM,EAAE,OAAO,CAAC;IAChB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED;;GAEG;AACH,wBAAsB,mBAAmB,CACvC,OAAO,EAAE,MAAM,EACf,WAAW,EAAE,iBAAiB,YAAS,EACvC,UAAU,EAAE,MAAM,EAClB,SAAS,GAAE,MAAe,EAC1B,GAAG,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAC3B,OAAO,CAAC,WAAW,CAAC,CAmCtB"}

package/dist/tools/yaml-executor.js

@@ -0,0 +1,80 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.renderTemplate = renderTemplate;
+exports.executeShellCommand = executeShellCommand;
+// runner/src/tools/yaml-executor.ts
+const node_child_process_1 = require("node:child_process");
+const node_util_1 = require("node:util");
+const execFileAsync = (0, node_util_1.promisify)(node_child_process_1.execFile);
+/**
+ * Render a shell command template with parameter substitution.
+ *
+ * Supports:
+ *   {{param}}              → stringify value (empty string if undefined)
+ *   {{#if param}}...{{/if}}              → include block only when param is truthy
+ *   {{#if param}}...{{else}}...{{/if}}   → if/else block
+ *   {{param | join 'sep'}} → join array with separator
+ *   {{param | json}}       → JSON.stringify(value)
+ */
+function renderTemplate(template, params) {
+    let result = template;
+    // {{#if param}}...{{else}}...{{/if}} blocks (with else)
+    result = result.replace(/\{\{#if (\w+)\}\}([\s\S]*?)\{\{else\}\}([\s\S]*?)\{\{\/if\}\}/g, (_, key, trueBranch, falseBranch) => params[key] ? trueBranch : falseBranch);
+    // {{#if param}}...{{/if}} blocks (without else)
+    result = result.replace(/\{\{#if (\w+)\}\}([\s\S]*?)\{\{\/if\}\}/g, (_, key, inner) => (params[key] ? inner : ''));
+    // {{param | join 'sep'}} filter
+    result = result.replace(/\{\{(\w+)\s*\|\s*join\s+'([^']*)'\}\}/g, (_, key, sep) => {
+        const value = params[key];
+        return Array.isArray(value) ? value.join(sep) : String(value ?? '');
+    });
+    // {{param | join "sep"}} filter (double quotes variant)
+    result = result.replace(/\{\{(\w+)\s*\|\s*join\s+"([^"]*)"\}\}/g, (_, key, sep) => {
+        const value = params[key];
+        return Array.isArray(value) ? value.join(sep) : String(value ?? '');
+    });
+    // {{param | json}} filter
+    result = result.replace(/\{\{(\w+)\s*\|\s*json\}\}/g, (_, key) => JSON.stringify(params[key] ?? null));
+    // Plain {{param}} substitution
+    result = result.replace(/\{\{(\w+)\}\}/g, (_, key) => (params[key] === undefined ? '' : String(params[key])));
+    return result;
+}
+/**
+ * Execute a rendered shell command and parse the output.
+ */
+async function executeShellCommand(command, parseOutput = 'text', workingDir, timeoutMs = 30_000, env) {
+    try {
+        const { stdout } = await execFileAsync('sh', ['-c', command], {
+            cwd: workingDir,
+            timeout: timeoutMs,
+            maxBuffer: 10 * 1024 * 1024,
+            ...(env ? { env: { ...process.env, ...env } } : {}),
+        });
+        const raw = stdout.trim();
+        if (parseOutput === 'json') {
+            try {
+                return { success: true, output: JSON.parse(raw) };
+            }
+            catch {
+                return {
+                    success: false,
+                    output: undefined,
+                    error: `Failed to parse JSON output: ${raw.slice(0, 200)}`,
+                };
+            }
+        }
+        return { success: true, output: raw };
+    }
+    catch (err) {
+        const e = err;
+        // When claude -p exits non-zero, the JSON result is still in stdout.
+        // Try to parse it so the runner gets structured error info instead of "Command failed".
+        if (parseOutput === 'json' && e.stdout?.trim()) {
+            try {
+                return { success: false, output: JSON.parse(e.stdout.trim()), error: e.stderr?.trim() || undefined };
+            }
+            catch { /* fall through to default error */ }
+        }
+        return { success: false, output: undefined, error: e.stderr?.trim() || e.message || 'Command failed' };
+    }
+}
+//# sourceMappingURL=yaml-executor.js.map

package/dist/tools/yaml-executor.js.map

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

package/dist/utils/race-signal.d.ts

@@ -0,0 +1,6 @@
+/**
+ * Race a promise against an AbortSignal.
+ * Rejects with DOMException('Aborted', 'AbortError') if the signal fires first.
+ */
+export declare function raceSignal<T>(promise: Promise<T>, signal?: AbortSignal): Promise<T>;
+//# sourceMappingURL=race-signal.d.ts.map

package/dist/utils/race-signal.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"race-signal.d.ts","sourceRoot":"","sources":["../../src/utils/race-signal.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,wBAAgB,UAAU,CAAC,CAAC,EAAE,OAAO,EAAE,OAAO,CAAC,CAAC,CAAC,EAAE,MAAM,CAAC,EAAE,WAAW,GAAG,OAAO,CAAC,CAAC,CAAC,CAYnF"}

package/dist/utils/race-signal.js

@@ -0,0 +1,21 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.raceSignal = raceSignal;
+/**
+ * Race a promise against an AbortSignal.
+ * Rejects with DOMException('Aborted', 'AbortError') if the signal fires first.
+ */
+function raceSignal(promise, signal) {
+    if (!signal)
+        return promise;
+    if (signal.aborted)
+        return Promise.reject(new DOMException('Aborted', 'AbortError'));
+    return new Promise((resolve, reject) => {
+        const onAbort = () => reject(new DOMException('Aborted', 'AbortError'));
+        signal.addEventListener('abort', onAbort, { once: true });
+        promise
+            .then((v) => { signal.removeEventListener('abort', onAbort); resolve(v); })
+            .catch((e) => { signal.removeEventListener('abort', onAbort); reject(e); });
+    });
+}
+//# sourceMappingURL=race-signal.js.map