@studio-foundation/runner 0.3.0-beta.1

package/dist/tools/builtin/web-search.test.js

@@ -0,0 +1,90 @@
+"use strict";
+/**
+ * Tests for the web_search builtin tool
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+const vitest_1 = require("vitest");
+const web_search_js_1 = require("./web-search.js");
+(0, vitest_1.describe)('createWebSearchTools', () => {
+    (0, vitest_1.afterEach)(() => {
+        vitest_1.vi.restoreAllMocks();
+        delete process.env.TAVILY_API_KEY;
+    });
+    (0, vitest_1.it)('returns a single tool named web_search-search', () => {
+        const tools = (0, web_search_js_1.createWebSearchTools)();
+        (0, vitest_1.expect)(tools).toHaveLength(1);
+        (0, vitest_1.expect)(tools[0].name).toBe('web_search-search');
+    });
+    (0, vitest_1.it)('requires query parameter', () => {
+        const [tool] = (0, web_search_js_1.createWebSearchTools)();
+        const schema = tool.parameters;
+        (0, vitest_1.expect)(schema.required).toContain('query');
+    });
+    (0, vitest_1.it)('returns error when TAVILY_API_KEY is not set', async () => {
+        const [tool] = (0, web_search_js_1.createWebSearchTools)();
+        const result = await tool.execute({ query: 'test' });
+        (0, vitest_1.expect)(result.success).toBe(false);
+        (0, vitest_1.expect)(result.error).toMatch(/TAVILY_API_KEY/);
+    });
+    (0, vitest_1.it)('calls Tavily API and returns results', async () => {
+        process.env.TAVILY_API_KEY = 'test-key';
+        const mockResponse = {
+            results: [
+                { title: 'Result 1', url: 'https://example.com/1', content: 'Content 1', score: 0.9 },
+                { title: 'Result 2', url: 'https://example.com/2', content: 'Content 2', score: 0.8 },
+            ],
+            answer: 'A direct answer'
+        };
+        vitest_1.vi.spyOn(global, 'fetch').mockResolvedValueOnce(new Response(JSON.stringify(mockResponse), { status: 200 }));
+        const [tool] = (0, web_search_js_1.createWebSearchTools)();
+        const result = await tool.execute({ query: 'test query', max_results: 2 });
+        (0, vitest_1.expect)(result.success).toBe(true);
+        const output = result.output;
+        (0, vitest_1.expect)(output.query).toBe('test query');
+        (0, vitest_1.expect)(output.results).toHaveLength(2);
+        (0, vitest_1.expect)(output.results[0].title).toBe('Result 1');
+        (0, vitest_1.expect)(output.answer).toBe('A direct answer');
+        (0, vitest_1.expect)(output.count).toBe(2);
+    });
+    (0, vitest_1.it)('passes max_results to Tavily API', async () => {
+        process.env.TAVILY_API_KEY = 'test-key';
+        vitest_1.vi.spyOn(global, 'fetch').mockResolvedValueOnce(new Response(JSON.stringify({ results: [], answer: null }), { status: 200 }));
+        const [tool] = (0, web_search_js_1.createWebSearchTools)();
+        await tool.execute({ query: 'test', max_results: 3 });
+        const [, options] = fetch.mock.calls[0];
+        const body = JSON.parse(options.body);
+        (0, vitest_1.expect)(body.max_results).toBe(3);
+    });
+    (0, vitest_1.it)('defaults max_results to 5 when not provided', async () => {
+        process.env.TAVILY_API_KEY = 'test-key';
+        vitest_1.vi.spyOn(global, 'fetch').mockResolvedValueOnce(new Response(JSON.stringify({ results: [] }), { status: 200 }));
+        const [tool] = (0, web_search_js_1.createWebSearchTools)();
+        await tool.execute({ query: 'test' });
+        const [, options] = fetch.mock.calls[0];
+        const body = JSON.parse(options.body);
+        (0, vitest_1.expect)(body.max_results).toBe(5);
+    });
+    (0, vitest_1.it)('returns error on non-ok API response', async () => {
+        process.env.TAVILY_API_KEY = 'test-key';
+        vitest_1.vi.spyOn(global, 'fetch').mockResolvedValueOnce(new Response('Unauthorized', { status: 401 }));
+        const [tool] = (0, web_search_js_1.createWebSearchTools)();
+        const result = await tool.execute({ query: 'test' });
+        (0, vitest_1.expect)(result.success).toBe(false);
+        (0, vitest_1.expect)(result.error).toMatch(/401/);
+    });
+    (0, vitest_1.it)('returns error on network failure', async () => {
+        process.env.TAVILY_API_KEY = 'test-key';
+        vitest_1.vi.spyOn(global, 'fetch').mockRejectedValueOnce(new Error('Network error'));
+        const [tool] = (0, web_search_js_1.createWebSearchTools)();
+        const result = await tool.execute({ query: 'test' });
+        (0, vitest_1.expect)(result.success).toBe(false);
+        (0, vitest_1.expect)(result.error).toMatch(/Network error/);
+    });
+});
+(0, vitest_1.describe)('WEB_SEARCH_PROMPT_SNIPPET', () => {
+    (0, vitest_1.it)('is a non-empty string', () => {
+        (0, vitest_1.expect)(typeof web_search_js_1.WEB_SEARCH_PROMPT_SNIPPET).toBe('string');
+        (0, vitest_1.expect)(web_search_js_1.WEB_SEARCH_PROMPT_SNIPPET.length).toBeGreaterThan(0);
+    });
+});
+//# sourceMappingURL=web-search.test.js.map

package/dist/tools/builtin/web-search.test.js.map

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

package/dist/tools/errors.d.ts

@@ -0,0 +1,4 @@
+export declare class ToolYamlError extends Error {
+    constructor(message: string);
+}
+//# sourceMappingURL=errors.d.ts.map

package/dist/tools/errors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../../src/tools/errors.ts"],"names":[],"mappings":"AAAA,qBAAa,aAAc,SAAQ,KAAK;gBAC1B,OAAO,EAAE,MAAM;CAI5B"}

package/dist/tools/errors.js

@@ -0,0 +1,11 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ToolYamlError = void 0;
+class ToolYamlError extends Error {
+    constructor(message) {
+        super(message);
+        this.name = 'ToolYamlError';
+    }
+}
+exports.ToolYamlError = ToolYamlError;
+//# sourceMappingURL=errors.js.map

package/dist/tools/errors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.js","sourceRoot":"","sources":["../../src/tools/errors.ts"],"names":[],"mappings":";;;AAAA,MAAa,aAAc,SAAQ,KAAK;IACtC,YAAY,OAAe;QACzB,KAAK,CAAC,OAAO,CAAC,CAAC;QACf,IAAI,CAAC,IAAI,GAAG,eAAe,CAAC;IAC9B,CAAC;CACF;AALD,sCAKC"}

package/dist/tools/errors.test.d.ts

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

package/dist/tools/errors.test.d.ts.map

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

package/dist/tools/errors.test.js

@@ -0,0 +1,14 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+// runner/src/tools/errors.test.ts
+const vitest_1 = require("vitest");
+const errors_js_1 = require("./errors.js");
+(0, vitest_1.describe)('ToolYamlError', () => {
+    (0, vitest_1.it)('is an Error with name ToolYamlError', () => {
+        const err = new errors_js_1.ToolYamlError('bad yaml');
+        (0, vitest_1.expect)(err).toBeInstanceOf(Error);
+        (0, vitest_1.expect)(err.name).toBe('ToolYamlError');
+        (0, vitest_1.expect)(err.message).toBe('bad yaml');
+    });
+});
+//# sourceMappingURL=errors.test.js.map

package/dist/tools/errors.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.test.js","sourceRoot":"","sources":["../../src/tools/errors.test.ts"],"names":[],"mappings":";;AAAA,kCAAkC;AAClC,mCAA8C;AAC9C,2CAA4C;AAE5C,IAAA,iBAAQ,EAAC,eAAe,EAAE,GAAG,EAAE;IAC7B,IAAA,WAAE,EAAC,qCAAqC,EAAE,GAAG,EAAE;QAC7C,MAAM,GAAG,GAAG,IAAI,yBAAa,CAAC,UAAU,CAAC,CAAC;QAC1C,IAAA,eAAM,EAAC,GAAG,CAAC,CAAC,cAAc,CAAC,KAAK,CAAC,CAAC;QAClC,IAAA,eAAM,EAAC,GAAG,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,eAAe,CAAC,CAAC;QACvC,IAAA,eAAM,EAAC,GAAG,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;IACvC,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC"}

package/dist/tools/plugin-loader.d.ts

@@ -0,0 +1,31 @@
+import type { Tool } from './tool-registry.js';
+export interface LoadedPlugin {
+    name: string;
+    tools: Tool[];
+    promptSnippet?: string;
+}
+/**
+ * Load all `.tool.yaml` files from a project's tools directory.
+ * Returns an empty array if the directory does not exist.
+ */
+export declare function loadProjectTools(toolsDir: string, repoPath: string): Promise<LoadedPlugin[]>;
+/**
+ * Names of built-in tool plugins that have bundled installable templates.
+ * Mirrors runner/templates/tools/*.tool.yaml.
+ * Note: 'patch' is a TypeScript-only builtin with no installable template and is intentionally excluded.
+ */
+export declare const BUILTIN_TOOL_NAMES: Set<string>;
+/**
+ * List all tool plugins available for installation from the bundled registry.
+ * Returns an array of { name, description } objects.
+ */
+export declare function listAvailableToolTemplates(): Promise<{
+    name: string;
+    description: string;
+}[]>;
+/**
+ * Return the raw YAML content of a bundled tool template by name.
+ * Returns null if the tool does not exist in the bundled registry.
+ */
+export declare function getBundledToolTemplate(name: string): Promise<string | null>;
+//# sourceMappingURL=plugin-loader.d.ts.map

package/dist/tools/plugin-loader.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"plugin-loader.d.ts","sourceRoot":"","sources":["../../src/tools/plugin-loader.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,oBAAoB,CAAC;AAU/C,MAAM,WAAW,YAAY;IAC3B,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,IAAI,EAAE,CAAC;IACd,aAAa,CAAC,EAAE,MAAM,CAAC;CACxB;AAoFD;;;GAGG;AACH,wBAAsB,gBAAgB,CACpC,QAAQ,EAAE,MAAM,EAChB,QAAQ,EAAE,MAAM,GACf,OAAO,CAAC,YAAY,EAAE,CAAC,CAwCzB;AAOD;;;;GAIG;AACH,eAAO,MAAM,kBAAkB,aAM7B,CAAC;AAEH;;;GAGG;AACH,wBAAsB,0BAA0B,IAAI,OAAO,CAAC;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,WAAW,EAAE,MAAM,CAAA;CAAE,EAAE,CAAC,CAcnG;AAED;;;GAGG;AACH,wBAAsB,sBAAsB,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAOjF"}

package/dist/tools/plugin-loader.js

@@ -0,0 +1,183 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.BUILTIN_TOOL_NAMES = void 0;
+exports.loadProjectTools = loadProjectTools;
+exports.listAvailableToolTemplates = listAvailableToolTemplates;
+exports.getBundledToolTemplate = getBundledToolTemplate;
+// runner/src/tools/plugin-loader.ts
+const promises_1 = require("node:fs/promises");
+const node_fs_1 = require("node:fs");
+const node_path_1 = require("node:path");
+const js_yaml_1 = __importDefault(require("js-yaml"));
+const yaml_executor_js_1 = require("./yaml-executor.js");
+const repo_manager_js_1 = require("./builtin/repo-manager.js");
+const shell_js_1 = require("./builtin/shell.js");
+const search_js_1 = require("./builtin/search.js");
+const patch_js_1 = require("./builtin/patch.js");
+const git_js_1 = require("./builtin/git.js");
+const web_search_js_1 = require("./builtin/web-search.js");
+const errors_js_1 = require("./errors.js");
+/** Build a map of tool name → Tool from all builtin factories. */
+function buildBuiltinMap(repoPath) {
+    const map = new Map();
+    const add = (tools) => tools.forEach(t => map.set(t.name, t));
+    add((0, repo_manager_js_1.createRepoManagerTools)(repoPath));
+    add((0, shell_js_1.createShellTools)(repoPath));
+    add((0, search_js_1.createSearchTools)(repoPath));
+    add((0, patch_js_1.createPatchTools)(repoPath));
+    add((0, git_js_1.createGitTools)(repoPath));
+    add((0, web_search_js_1.createWebSearchTools)());
+    return map;
+}
+/** Convert a ParameterDef map to a JSON Schema object for the LLM. */
+function buildJsonSchema(parameters) {
+    const properties = {};
+    const required = [];
+    for (const [key, def] of Object.entries(parameters ?? {})) {
+        properties[key] = {
+            type: def.type,
+            ...(def.description ? { description: def.description } : {}),
+            ...(def.type === 'array' && def.items ? { items: def.items } : {}),
+        };
+        if (def.required)
+            required.push(key);
+    }
+    return {
+        type: 'object',
+        properties,
+        ...(required.length > 0 ? { required } : {}),
+    };
+}
+/** Template keywords that appear as {{word}} but are not parameter names.
+ *  Note: block tags like {{#if}} and {{/if}} are already excluded because
+ *  '#' and '/' are not matched by [\w-]+. */
+const TEMPLATE_KEYWORDS = new Set(['else']);
+/**
+ * Validate that every {{placeholder}} in a shell command template
+ * is declared in the command's parameters.
+ * Throws ToolYamlError if any undeclared placeholder is found.
+ */
+function validateShellTemplate(fileName, cmd) {
+    const exec = cmd.execute;
+    if (exec.type !== 'shell' || !exec.command)
+        return;
+    const declared = new Set(Object.keys(cmd.parameters ?? {}));
+    const used = new Set();
+    for (const match of exec.command.matchAll(/\{\{([\w-]+)\}\}/g)) {
+        const name = match[1];
+        if (!TEMPLATE_KEYWORDS.has(name))
+            used.add(name);
+    }
+    const unknown = [...used].filter(p => !declared.has(p));
+    if (unknown.length > 0) {
+        throw new errors_js_1.ToolYamlError(`${fileName} › command '${cmd.name}':\n` +
+            `  template uses ${unknown.map(p => `{{${p}}}`).join(', ')} but no such parameter is declared.\n` +
+            `  Declared parameters: ${[...declared].join(', ') || '(none)'}`);
+    }
+}
+/** Create a Tool that renders the command template and runs it in a shell. */
+function createShellTool(cmd, repoPath, configsDir) {
+    const exec = cmd.execute;
+    return {
+        name: cmd.name,
+        description: cmd.description,
+        parameters: buildJsonSchema(cmd.parameters),
+        async execute(args) {
+            const rendered = (0, yaml_executor_js_1.renderTemplate)(exec.command, args);
+            return (0, yaml_executor_js_1.executeShellCommand)(rendered, exec.parse_output ?? 'text', repoPath, exec.timeout_ms, { STUDIO_CONFIG_DIR: configsDir });
+        },
+    };
+}
+/**
+ * Load all `.tool.yaml` files from a project's tools directory.
+ * Returns an empty array if the directory does not exist.
+ */
+async function loadProjectTools(toolsDir, repoPath) {
+    if (!(0, node_fs_1.existsSync)(toolsDir))
+        return [];
+    let files;
+    try {
+        files = (await (0, promises_1.readdir)(toolsDir)).filter(f => f.endsWith('.tool.yaml'));
+    }
+    catch {
+        return [];
+    }
+    if (files.length === 0)
+        return [];
+    const configsDir = (0, node_path_1.resolve)((0, node_path_1.dirname)(toolsDir));
+    const builtinMap = buildBuiltinMap(repoPath);
+    const plugins = [];
+    for (const file of files.sort()) {
+        const content = await (0, promises_1.readFile)((0, node_path_1.resolve)(toolsDir, file), 'utf-8');
+        const def = js_yaml_1.default.load(content);
+        const tools = [];
+        for (const cmd of def.commands ?? []) {
+            if (cmd.execute.type === 'builtin') {
+                const tool = builtinMap.get(cmd.name);
+                if (tool)
+                    tools.push(tool);
+                // If unknown builtin name, skip silently (no crash)
+            }
+            else {
+                validateShellTemplate(file, cmd);
+                tools.push(createShellTool(cmd, repoPath, configsDir));
+            }
+        }
+        plugins.push({
+            name: def.name,
+            tools,
+            promptSnippet: def.prompt_snippet,
+        });
+    }
+    return plugins;
+}
+const BUNDLED_TOOL_TEMPLATES_DIR = (0, node_path_1.resolve)(__dirname, '../../templates/tools');
+/**
+ * Names of built-in tool plugins that have bundled installable templates.
+ * Mirrors runner/templates/tools/*.tool.yaml.
+ * Note: 'patch' is a TypeScript-only builtin with no installable template and is intentionally excluded.
+ */
+exports.BUILTIN_TOOL_NAMES = new Set([
+    'repo-manager',
+    'shell',
+    'search',
+    'git',
+    'web-search',
+]);
+/**
+ * List all tool plugins available for installation from the bundled registry.
+ * Returns an array of { name, description } objects.
+ */
+async function listAvailableToolTemplates() {
+    let files;
+    try {
+        files = (await (0, promises_1.readdir)(BUNDLED_TOOL_TEMPLATES_DIR)).filter(f => f.endsWith('.tool.yaml')).sort();
+    }
+    catch {
+        return [];
+    }
+    const result = [];
+    for (const file of files) {
+        const content = await (0, promises_1.readFile)((0, node_path_1.resolve)(BUNDLED_TOOL_TEMPLATES_DIR, file), 'utf-8');
+        const def = js_yaml_1.default.load(content);
+        result.push({ name: file.replace('.tool.yaml', ''), description: def.description ?? '' });
+    }
+    return result;
+}
+/**
+ * Return the raw YAML content of a bundled tool template by name.
+ * Returns null if the tool does not exist in the bundled registry.
+ */
+async function getBundledToolTemplate(name) {
+    const filePath = (0, node_path_1.resolve)(BUNDLED_TOOL_TEMPLATES_DIR, `${name}.tool.yaml`);
+    try {
+        return await (0, promises_1.readFile)(filePath, 'utf-8');
+    }
+    catch {
+        return null;
+    }
+}
+//# sourceMappingURL=plugin-loader.js.map

package/dist/tools/plugin-loader.js.map

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

package/dist/tools/plugin-loader.test.d.ts

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

package/dist/tools/plugin-loader.test.d.ts.map

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

package/dist/tools/plugin-loader.test.js

@@ -0,0 +1,116 @@
+"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 node_os_1 = require("node:os");
+const plugin_loader_js_1 = require("./plugin-loader.js");
+const errors_js_1 = require("./errors.js");
+let tmpDir;
+(0, vitest_1.beforeAll)(async () => {
+    tmpDir = await (0, promises_1.mkdtemp)((0, node_path_1.join)((0, node_os_1.tmpdir)(), 'studio-tool-loader-test-'));
+});
+(0, vitest_1.afterAll)(async () => {
+    await (0, promises_1.rm)(tmpDir, { recursive: true, force: true });
+});
+async function writeToolYaml(name, content) {
+    const dir = (0, node_path_1.join)(tmpDir, name);
+    await (0, promises_1.mkdir)(dir, { recursive: true });
+    const toolsDir = (0, node_path_1.join)(dir, 'tools');
+    await (0, promises_1.mkdir)(toolsDir, { recursive: true });
+    await (0, promises_1.writeFile)((0, node_path_1.join)(toolsDir, `${name}.tool.yaml`), content);
+    return toolsDir;
+}
+(0, vitest_1.describe)('loadProjectTools — shell template validation', () => {
+    (0, vitest_1.it)('throws ToolYamlError when template uses undeclared placeholder', async () => {
+        const toolsDir = await writeToolYaml('bad-search', `
+name: bad_search
+version: 1
+commands:
+  - name: bad_search-search
+    description: Search
+    parameters:
+      query:
+        type: string
+        required: true
+    execute:
+      type: shell
+      command: 'curl "https://api.example.com?q={{search_query}}"'
+`);
+        const promise = (0, plugin_loader_js_1.loadProjectTools)(toolsDir, '/tmp');
+        await (0, vitest_1.expect)(promise).rejects.toThrow(errors_js_1.ToolYamlError);
+        await (0, vitest_1.expect)(promise).rejects.toThrow(errors_js_1.ToolYamlError);
+        await (0, vitest_1.expect)(promise).rejects.toThrow("template uses {{search_query}} but no such parameter is declared");
+    });
+    (0, vitest_1.it)('loads successfully when all template placeholders are declared', async () => {
+        const toolsDir = await writeToolYaml('good-search', `
+name: good_search
+version: 1
+commands:
+  - name: good_search-search
+    description: Search
+    parameters:
+      query:
+        type: string
+        required: true
+    execute:
+      type: shell
+      command: 'curl "https://api.example.com?q={{query}}"'
+`);
+        await (0, vitest_1.expect)((0, plugin_loader_js_1.loadProjectTools)(toolsDir, '/tmp')).resolves.toHaveLength(1);
+    });
+    (0, vitest_1.it)('does not flag {{else}} as an undeclared placeholder', async () => {
+        const toolsDir = await writeToolYaml('conditional-tool', `
+name: conditional_tool
+version: 1
+commands:
+  - name: conditional_tool-run
+    description: Run with optional flag
+    parameters:
+      verbose:
+        type: boolean
+        required: false
+    execute:
+      type: shell
+      command: 'echo {{#if verbose}}--verbose{{else}}--quiet{{/if}}'
+`);
+        await (0, vitest_1.expect)((0, plugin_loader_js_1.loadProjectTools)(toolsDir, '/tmp')).resolves.toHaveLength(1);
+    });
+    (0, vitest_1.it)('error message includes filename, command name, and declared parameters', async () => {
+        const toolsDir = await writeToolYaml('err-msg', `
+name: err_msg
+version: 1
+commands:
+  - name: err_msg-run
+    description: Run
+    parameters:
+      query:
+        type: string
+        required: true
+    execute:
+      type: shell
+      command: 'curl {{typo}}'
+`);
+        const promise = (0, plugin_loader_js_1.loadProjectTools)(toolsDir, '/tmp');
+        await (0, vitest_1.expect)(promise).rejects.toThrow(errors_js_1.ToolYamlError);
+        await (0, vitest_1.expect)(promise).rejects.toThrow("err-msg.tool.yaml › command 'err_msg-run'");
+        await (0, vitest_1.expect)(promise).rejects.toThrow("Declared parameters: query");
+    });
+    (0, vitest_1.it)('error message shows (none) when command has no parameters declared', async () => {
+        const toolsDir = await writeToolYaml('no-params', `
+name: no_params
+version: 1
+commands:
+  - name: no_params-run
+    description: Run
+    parameters: {}
+    execute:
+      type: shell
+      command: 'curl {{typo}}'
+`);
+        const promise = (0, plugin_loader_js_1.loadProjectTools)(toolsDir, '/tmp');
+        await (0, vitest_1.expect)(promise).rejects.toThrow(errors_js_1.ToolYamlError);
+        await (0, vitest_1.expect)(promise).rejects.toThrow("Declared parameters: (none)");
+    });
+});
+//# sourceMappingURL=plugin-loader.test.js.map

package/dist/tools/plugin-loader.test.js.map

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

package/dist/tools/skills/skill-loader.d.ts

@@ -0,0 +1,23 @@
+import type { SkillContent } from '../../plugins/plugin-loader.js';
+export type { SkillContent };
+/** Minimal structure required for a valid skill manifest */
+export interface SkillManifest {
+    name: string;
+    content: string;
+}
+/**
+ * Load multiple `.skill.md` files by name from `.studio/skills/`.
+ * Missing files are skipped with a warning (non-fatal).
+ */
+export declare function loadSkills(skillNames: string[], studioDir: string): Promise<SkillContent[]>;
+/**
+ * Load a single `.skill.md` file by name from `<studioDir>/skills/`.
+ * Returns null if the file does not exist.
+ */
+export declare function loadSkill(name: string, studioDir: string): Promise<SkillContent | null>;
+/**
+ * Validate that a skill manifest has the required structure.
+ * Throws a descriptive error if invalid.
+ */
+export declare function validateSkillManifest(manifest: unknown): boolean;
+//# sourceMappingURL=skill-loader.d.ts.map

package/dist/tools/skills/skill-loader.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"skill-loader.d.ts","sourceRoot":"","sources":["../../../src/tools/skills/skill-loader.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,gCAAgC,CAAC;AAEnE,YAAY,EAAE,YAAY,EAAE,CAAC;AAE7B,4DAA4D;AAC5D,MAAM,WAAW,aAAa;IAC5B,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;CACjB;AAED;;;GAGG;AACH,wBAAsB,UAAU,CAAC,UAAU,EAAE,MAAM,EAAE,EAAE,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,EAAE,CAAC,CAOjG;AAED;;;GAGG;AACH,wBAAsB,SAAS,CAAC,IAAI,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,GAAG,IAAI,CAAC,CAa7F;AAED;;;GAGG;AACH,wBAAgB,qBAAqB,CAAC,QAAQ,EAAE,OAAO,GAAG,OAAO,CAYhE"}

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

@@ -0,0 +1,58 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.loadSkills = loadSkills;
+exports.loadSkill = loadSkill;
+exports.validateSkillManifest = validateSkillManifest;
+const promises_1 = require("node:fs/promises");
+const node_fs_1 = require("node:fs");
+const node_path_1 = require("node:path");
+/**
+ * Load multiple `.skill.md` files by name from `.studio/skills/`.
+ * Missing files are skipped with a warning (non-fatal).
+ */
+async function loadSkills(skillNames, studioDir) {
+    const results = [];
+    for (const name of skillNames) {
+        const skill = await loadSkill(name, studioDir);
+        if (skill)
+            results.push(skill);
+    }
+    return results;
+}
+/**
+ * Load a single `.skill.md` file by name from `<studioDir>/skills/`.
+ * Returns null if the file does not exist.
+ */
+async function loadSkill(name, studioDir) {
+    const filePath = (0, node_path_1.join)(studioDir, 'skills', `${name}.skill.md`);
+    if (!(0, node_fs_1.existsSync)(filePath)) {
+        console.warn(`[studio] Skill '${name}' not found at ${filePath} — skipping.`);
+        return null;
+    }
+    try {
+        const content = await (0, promises_1.readFile)(filePath, 'utf-8');
+        return { name, content };
+    }
+    catch {
+        console.warn(`[studio] Failed to load skill '${name}' — skipping.`);
+        return null;
+    }
+}
+/**
+ * Validate that a skill manifest has the required structure.
+ * Throws a descriptive error if invalid.
+ */
+function validateSkillManifest(manifest) {
+    if (!manifest || typeof manifest !== 'object') {
+        throw new Error('Skill manifest must be an object');
+    }
+    const m = manifest;
+    if (typeof m.name !== 'string') {
+        throw new Error('Skill manifest must have a string "name" field');
+    }
+    if (typeof m.content !== 'string') {
+        throw new Error('Skill manifest must have a string "content" field');
+    }
+    return true;
+}
+//# sourceMappingURL=skill-loader.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"skill-loader.js","sourceRoot":"","sources":["../../../src/tools/skills/skill-loader.ts"],"names":[],"mappings":";;AAiBA,gCAOC;AAMD,8BAaC;AAMD,sDAYC;AA7DD,+CAA4C;AAC5C,qCAAqC;AACrC,yCAAiC;AAWjC;;;GAGG;AACI,KAAK,UAAU,UAAU,CAAC,UAAoB,EAAE,SAAiB;IACtE,MAAM,OAAO,GAAmB,EAAE,CAAC;IACnC,KAAK,MAAM,IAAI,IAAI,UAAU,EAAE,CAAC;QAC9B,MAAM,KAAK,GAAG,MAAM,SAAS,CAAC,IAAI,EAAE,SAAS,CAAC,CAAC;QAC/C,IAAI,KAAK;YAAE,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IACjC,CAAC;IACD,OAAO,OAAO,CAAC;AACjB,CAAC;AAED;;;GAGG;AACI,KAAK,UAAU,SAAS,CAAC,IAAY,EAAE,SAAiB;IAC7D,MAAM,QAAQ,GAAG,IAAA,gBAAI,EAAC,SAAS,EAAE,QAAQ,EAAE,GAAG,IAAI,WAAW,CAAC,CAAC;IAC/D,IAAI,CAAC,IAAA,oBAAU,EAAC,QAAQ,CAAC,EAAE,CAAC;QAC1B,OAAO,CAAC,IAAI,CAAC,mBAAmB,IAAI,kBAAkB,QAAQ,cAAc,CAAC,CAAC;QAC9E,OAAO,IAAI,CAAC;IACd,CAAC;IACD,IAAI,CAAC;QACH,MAAM,OAAO,GAAG,MAAM,IAAA,mBAAQ,EAAC,QAAQ,EAAE,OAAO,CAAC,CAAC;QAClD,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,CAAC;IAC3B,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,CAAC,IAAI,CAAC,kCAAkC,IAAI,eAAe,CAAC,CAAC;QACpE,OAAO,IAAI,CAAC;IACd,CAAC;AACH,CAAC;AAED;;;GAGG;AACH,SAAgB,qBAAqB,CAAC,QAAiB;IACrD,IAAI,CAAC,QAAQ,IAAI,OAAO,QAAQ,KAAK,QAAQ,EAAE,CAAC;QAC9C,MAAM,IAAI,KAAK,CAAC,kCAAkC,CAAC,CAAC;IACtD,CAAC;IACD,MAAM,CAAC,GAAG,QAAmC,CAAC;IAC9C,IAAI,OAAO,CAAC,CAAC,IAAI,KAAK,QAAQ,EAAE,CAAC;QAC/B,MAAM,IAAI,KAAK,CAAC,gDAAgD,CAAC,CAAC;IACpE,CAAC;IACD,IAAI,OAAO,CAAC,CAAC,OAAO,KAAK,QAAQ,EAAE,CAAC;QAClC,MAAM,IAAI,KAAK,CAAC,mDAAmD,CAAC,CAAC;IACvE,CAAC;IACD,OAAO,IAAI,CAAC;AACd,CAAC"}

package/dist/tools/skills/skill-loader.test.d.ts

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

package/dist/tools/skills/skill-loader.test.d.ts.map

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