@studio-foundation/runner 0.3.0-beta.1

package/README.md

@@ -0,0 +1,125 @@
+# @studio-foundation/runner
+
+Multi-provider LLM agent runner with tool plugin execution, streaming support, and PII anonymization.
+
+## Role
+
+runner handles everything that touches external services: LLM API calls and tool execution. It's the only package that knows about Anthropic, OpenAI, or what `repo_manager-write_file` does.
+
+```
+engine → runner.runAgent(config) → AgentRunResult
+                  ↓
+         [builds prompt] → [calls LLM] → [executes tool calls] → [returns result]
+```
+
+## Key exports
+
+```typescript
+import { runAgent, createDefaultRegistry, ToolRegistry, AnonymizationMiddleware } from '@studio-foundation/runner';
+
+const registry = createDefaultRegistry({
+  anthropic: { apiKey: process.env.ANTHROPIC_API_KEY },
+  openai: { apiKey: process.env.OPENAI_API_KEY },
+});
+
+const result = await runAgent({
+  agent: agentConfig,
+  task: taskInput,
+  context: agentContext,
+  toolRegistry,
+  providerRegistry: registry,
+  outputContract: contract,
+  anonymizationMiddleware: new AnonymizationMiddleware(),
+  callbacks: {
+    onToolCallStart: (e) => { /* e.tool, e.params */ },
+    onToolCallComplete: (e) => { /* e.tool, e.result, e.error */ },
+    onAgentToken: (e) => { /* streaming token */ },
+    onPreToolUse: async (e) => ({ blocked: false }),   // hook callback
+    onPostToolUse: async (e) => ({}),                  // hook callback
+  },
+});
+```
+
+## Providers
+
+| Provider | Class | Notes |
+|----------|-------|-------|
+| Anthropic | `AnthropicProvider` | Claude models, prompt caching (90% cost reduction on retries) |
+| OpenAI | `OpenAIProvider` | Chat completions API |
+| OpenAI Responses | `OpenAIResponsesProvider` | Responses API |
+| Mock | `MockProvider` | For tests — reads from `mock.yaml`, no API calls |
+
+Use `createDefaultRegistry()` to get all providers wired up. Use `--provider mock` in the CLI for testing without API keys.
+
+## Builtin tools
+
+| Tool | Factory | What it does |
+|------|---------|-------------|
+| `repo_manager-read_file` | `createRepoManagerTools()` | Read files in the workspace |
+| `repo_manager-write_file` | `createRepoManagerTools()` | Write/create files |
+| `repo_manager-list_files` | `createRepoManagerTools()` | List files and directories |
+| `shell-run_command` | `createShellTools()` | Execute shell commands |
+| `search-search_codebase` | `createSearchTools()` | Search code with ripgrep |
+| `patch-apply_patch` | `createPatchTools()` | Apply unified diffs |
+| `git-checkout` | `createGitTools()` | Checkout or create branches |
+| `git-commit` | `createGitTools()` | Create commits |
+| `git-push` | `createGitTools()` | Push to remote |
+| `git-pull` | `createGitTools()` | Pull from remote |
+| `git-status` | `createGitTools()` | Show working tree status |
+| `git-diff` | `createGitTools()` | Show diffs |
+| `studio_run` | `createStudioRunTool()` | Spawn and await a sub-pipeline run |
+
+`studio_run` is only registered when a `RunSpawner` is injected into the engine (via `EngineConfig.spawner`). Agents use it to trigger nested pipelines and receive their output.
+
+Tools are registered into a `ToolRegistry` and passed to `runAgent`. The runner injects tool descriptions into the system prompt automatically.
+
+## PII Anonymization
+
+```typescript
+const middleware = new AnonymizationMiddleware();
+// Passed to runAgent() → transparently replaces PII in prompts before LLM calls
+// Keymap stored in .studio/runs/anonymization/<run-id>.keymap.json
+const keymap = middleware.getKeymap(); // Reconstruct original values
+```
+
+## Plugin system
+
+runner supports loading Claude Code plugins and YAML tool plugins:
+
+```typescript
+import { loadPlugin } from '@studio-foundation/runner';
+
+// Load a Claude Code plugin (.mcp.json + skills/ + agents/)
+const plugin = await loadPlugin('/path/to/plugin');
+// plugin.skills → array of skill markdown content
+// plugin.mcpServers → MCP server configs
+```
+
+YAML tool plugins (`.tool.yaml`) are loaded via `ToolRegistry.loadYamlPlugin()`.
+
+## Lifecycle hook callbacks
+
+`onPreToolUse` and `onPostToolUse` in the callbacks wire to stage hook configuration:
+
+```typescript
+callbacks: {
+  onPreToolUse: async (event) => {
+    // event: { tool, params, timestamp }
+    // Return { blocked: true, error: '...' } to block the tool call
+    return { blocked: false };
+  },
+  onPostToolUse: async (event) => {
+    // event: { tool, params, result, error, timestamp }
+    // Return { append_message: '...' } to inject feedback into context
+    return {};
+  },
+}
+```
+
+These callbacks are wired by the engine from the stage's `hooks` YAML configuration.
+
+## Rules
+
+- **runner doesn't validate, doesn't retry.** It executes one agent turn and returns `AgentRunResult`. ralph handles the loop.
+- **runner doesn't know engine.** No pipeline state, no events, no stage concepts.
+- Prompt assembly lives in `prompt-builder.ts`. Provider abstractions in `providers/`.

package/configs/agents/analyst.agent.yaml

@@ -0,0 +1,31 @@
+name: analyst
+version: 1.0.0
+description: Agent specialized in code analysis and understanding
+
+systemMessage: |
+  You are an expert code analyst that helps understand complex codebases.
+
+  When analyzing code:
+  - Identify key patterns and architectural decisions
+  - Highlight potential issues or improvements
+  - Explain complex logic clearly
+  - Trace data flow and dependencies
+  - Provide actionable insights
+
+  Use search and file reading tools to explore the codebase thoroughly.
+
+capabilities:
+  - code_analysis
+  - architecture_review
+  - dependency_tracing
+  - pattern_recognition
+  - documentation
+
+tools:
+  - repo_manager
+  - search
+  - shell
+
+parameters:
+  temperature: 0.5
+  maxTokens: 4096

package/configs/agents/code-generator.agent.yaml

@@ -0,0 +1,31 @@
+name: code-generator
+version: 1.0.0
+description: Agent specialized in generating and modifying code
+
+systemMessage: |
+  You are an expert software engineer that writes clean, efficient, and well-documented code.
+
+  When generating code:
+  - Follow best practices and conventions for the target language
+  - Include appropriate error handling
+  - Add clear comments and documentation
+  - Use modern language features appropriately
+  - Ensure code is production-ready
+
+  Use the available tools to read existing code, write new files, and search the codebase.
+
+capabilities:
+  - code_generation
+  - code_modification
+  - refactoring
+  - file_operations
+  - code_analysis
+
+tools:
+  - repo_manager
+  - search
+  - shell
+
+parameters:
+  temperature: 0.3
+  maxTokens: 4096

package/configs/agents/generic.agent.yaml

@@ -0,0 +1,23 @@
+name: generic
+version: 1.0.0
+description: General-purpose assistant agent
+
+systemMessage: |
+  You are a helpful assistant that can perform tasks using available tools.
+  Be concise and accurate in your responses.
+  Use tools when necessary to accomplish the user's goals.
+
+capabilities:
+  - general_qa
+  - file_operations
+  - command_execution
+  - code_search
+
+tools:
+  - repo_manager
+  - shell
+  - search
+
+parameters:
+  temperature: 0.7
+  maxTokens: 2048

package/dist/__tests__/script-executor.test.d.ts

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

package/dist/__tests__/script-executor.test.d.ts.map

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

package/dist/__tests__/script-executor.test.js

@@ -0,0 +1,173 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+const vitest_1 = require("vitest");
+const cp = __importStar(require("node:child_process"));
+const fs = __importStar(require("node:fs"));
+const node_events_1 = require("node:events");
+// Mock child_process and fs before importing the module under test
+vitest_1.vi.mock('node:child_process');
+vitest_1.vi.mock('node:fs');
+const script_executor_js_1 = require("../script-executor.js");
+function makeContext(overrides) {
+    return {
+        input: 'test input',
+        ...overrides,
+    };
+}
+function makeSpawnMock(opts) {
+    const proc = new node_events_1.EventEmitter();
+    proc.stdout = new node_events_1.EventEmitter();
+    proc.stderr = new node_events_1.EventEmitter();
+    proc.stdin = { write: vitest_1.vi.fn(), end: vitest_1.vi.fn() };
+    proc.kill = vitest_1.vi.fn();
+    vitest_1.vi.mocked(cp.spawn).mockReturnValue(proc);
+    // Simulate async process lifecycle
+    setTimeout(() => {
+        if (opts.errorEvent) {
+            proc.emit('error', opts.errorEvent);
+            return;
+        }
+        if (opts.stdout)
+            proc.stdout.emit('data', Buffer.from(opts.stdout));
+        if (opts.stderr)
+            proc.stderr.emit('data', Buffer.from(opts.stderr));
+        proc.emit('close', opts.exitCode ?? 0);
+    }, 10);
+    return proc;
+}
+(0, vitest_1.beforeEach)(() => {
+    vitest_1.vi.mocked(fs.existsSync).mockReturnValue(false);
+    vitest_1.vi.clearAllMocks();
+});
+(0, vitest_1.describe)('runScript', () => {
+    (0, vitest_1.it)('parses stdout JSON and returns output on exit 0', async () => {
+        const output = { result: 'ok', count: 42 };
+        makeSpawnMock({ stdout: JSON.stringify(output), exitCode: 0 });
+        const result = await (0, script_executor_js_1.runScript)({
+            scriptPath: 'scripts/parse.py',
+            runtime: 'python',
+            context: makeContext(),
+        });
+        (0, vitest_1.expect)(result.output).toEqual(output);
+        (0, vitest_1.expect)(result.tool_calls).toEqual([]);
+        (0, vitest_1.expect)(result.tool_calls_count).toBe(0);
+        (0, vitest_1.expect)(result.error).toBeUndefined();
+        (0, vitest_1.expect)(result.duration_ms).toBeGreaterThanOrEqual(0);
+    });
+    (0, vitest_1.it)('sets error when script exits with non-zero code', async () => {
+        makeSpawnMock({ stdout: '', stderr: 'FileNotFoundError', exitCode: 1 });
+        const result = await (0, script_executor_js_1.runScript)({
+            scriptPath: 'scripts/parse.py',
+            runtime: 'python',
+            context: makeContext(),
+        });
+        (0, vitest_1.expect)(result.output).toBeNull();
+        (0, vitest_1.expect)(result.error).toMatch(/exited with code 1/);
+        (0, vitest_1.expect)(result.error).toMatch(/FileNotFoundError/);
+    });
+    (0, vitest_1.it)('sets error when stdout is not valid JSON', async () => {
+        makeSpawnMock({ stdout: 'not json at all', exitCode: 0 });
+        const result = await (0, script_executor_js_1.runScript)({
+            scriptPath: 'scripts/parse.py',
+            runtime: 'python',
+            context: makeContext(),
+        });
+        (0, vitest_1.expect)(result.output).toBeNull();
+        (0, vitest_1.expect)(result.error).toMatch(/not valid JSON/);
+        (0, vitest_1.expect)(result.error).toMatch(/not json at all/);
+    });
+    (0, vitest_1.it)('sets error on process spawn error', async () => {
+        const proc = new node_events_1.EventEmitter();
+        proc.stdout = new node_events_1.EventEmitter();
+        proc.stderr = new node_events_1.EventEmitter();
+        proc.stdin = { write: vitest_1.vi.fn(), end: vitest_1.vi.fn() };
+        vitest_1.vi.mocked(cp.spawn).mockReturnValue(proc);
+        setTimeout(() => proc.emit('error', new Error('ENOENT: python3 not found')), 10);
+        const result = await (0, script_executor_js_1.runScript)({
+            scriptPath: 'scripts/parse.py',
+            runtime: 'python',
+            context: makeContext(),
+        });
+        (0, vitest_1.expect)(result.error).toMatch(/process error/);
+        (0, vitest_1.expect)(result.error).toMatch(/ENOENT/);
+    });
+    (0, vitest_1.it)('uses python3 command for python runtime', async () => {
+        makeSpawnMock({ stdout: '{}', exitCode: 0 });
+        await (0, script_executor_js_1.runScript)({ scriptPath: 'scripts/parse.py', runtime: 'python', context: makeContext() });
+        (0, vitest_1.expect)(vitest_1.vi.mocked(cp.spawn)).toHaveBeenCalledWith('python3', ['scripts/parse.py'], vitest_1.expect.objectContaining({ stdio: ['pipe', 'pipe', 'pipe'] }));
+    });
+    (0, vitest_1.it)('uses node command for node runtime', async () => {
+        makeSpawnMock({ stdout: '{}', exitCode: 0 });
+        await (0, script_executor_js_1.runScript)({ scriptPath: 'scripts/parse.js', runtime: 'node', context: makeContext() });
+        (0, vitest_1.expect)(vitest_1.vi.mocked(cp.spawn)).toHaveBeenCalledWith('node', ['scripts/parse.js'], vitest_1.expect.anything());
+    });
+    (0, vitest_1.it)('uses sh command for shell runtime', async () => {
+        makeSpawnMock({ stdout: '{}', exitCode: 0 });
+        await (0, script_executor_js_1.runScript)({ scriptPath: 'scripts/run.sh', runtime: 'shell', context: makeContext() });
+        (0, vitest_1.expect)(vitest_1.vi.mocked(cp.spawn)).toHaveBeenCalledWith('sh', ['scripts/run.sh'], vitest_1.expect.anything());
+    });
+    (0, vitest_1.it)('activates venv when venv/ directory exists', async () => {
+        vitest_1.vi.mocked(fs.existsSync).mockImplementation((p) => String(p).endsWith('venv'));
+        makeSpawnMock({ stdout: '{}', exitCode: 0 });
+        await (0, script_executor_js_1.runScript)({
+            scriptPath: 'scripts/parse.py',
+            runtime: 'python',
+            context: makeContext(),
+            cwd: '/project',
+        });
+        const spawnCall = vitest_1.vi.mocked(cp.spawn).mock.calls[0];
+        const spawnEnv = spawnCall[2].env;
+        (0, vitest_1.expect)(spawnEnv.VIRTUAL_ENV).toBe('/project/venv');
+        (0, vitest_1.expect)(spawnEnv.PATH).toContain('/project/venv/bin');
+    });
+    (0, vitest_1.it)('writes context JSON to stdin', async () => {
+        const stdinMock = { write: vitest_1.vi.fn(), end: vitest_1.vi.fn() };
+        const proc = new node_events_1.EventEmitter();
+        proc.stdout = new node_events_1.EventEmitter();
+        proc.stderr = new node_events_1.EventEmitter();
+        proc.stdin = stdinMock;
+        vitest_1.vi.mocked(cp.spawn).mockReturnValue(proc);
+        setTimeout(() => {
+            proc.stdout.emit('data', Buffer.from('{"ok":true}'));
+            proc.emit('close', 0);
+        }, 10);
+        const ctx = makeContext({ additional_context: 'hello world' });
+        await (0, script_executor_js_1.runScript)({ scriptPath: 'scripts/parse.py', runtime: 'python', context: ctx });
+        (0, vitest_1.expect)(stdinMock.write).toHaveBeenCalledWith(JSON.stringify(ctx));
+        (0, vitest_1.expect)(stdinMock.end).toHaveBeenCalled();
+    });
+});
+//# sourceMappingURL=script-executor.test.js.map

package/dist/__tests__/script-executor.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"script-executor.test.js","sourceRoot":"","sources":["../../src/__tests__/script-executor.test.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAAA,mCAA8D;AAC9D,uDAAyC;AACzC,4CAA8B;AAC9B,6CAA2C;AAE3C,mEAAmE;AACnE,WAAE,CAAC,IAAI,CAAC,oBAAoB,CAAC,CAAC;AAC9B,WAAE,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;AAEnB,8DAAkD;AAGlD,SAAS,WAAW,CAAC,SAAiC;IACpD,OAAO;QACL,KAAK,EAAE,YAAY;QACnB,GAAG,SAAS;KACG,CAAC;AACpB,CAAC;AAED,SAAS,aAAa,CAAC,IAKtB;IACC,MAAM,IAAI,GAAG,IAAI,0BAAY,EAAiC,CAAC;IAC9D,IAAY,CAAC,MAAM,GAAG,IAAI,0BAAY,EAAE,CAAC;IACzC,IAAY,CAAC,MAAM,GAAG,IAAI,0BAAY,EAAE,CAAC;IACzC,IAAY,CAAC,KAAK,GAAG,EAAE,KAAK,EAAE,WAAE,CAAC,EAAE,EAAE,EAAE,GAAG,EAAE,WAAE,CAAC,EAAE,EAAE,EAAE,CAAC;IACtD,IAAY,CAAC,IAAI,GAAG,WAAE,CAAC,EAAE,EAAE,CAAC;IAE7B,WAAE,CAAC,MAAM,CAAC,EAAE,CAAC,KAAK,CAAC,CAAC,eAAe,CAAC,IAAW,CAAC,CAAC;IAEjD,mCAAmC;IACnC,UAAU,CAAC,GAAG,EAAE;QACd,IAAI,IAAI,CAAC,UAAU,EAAE,CAAC;YACpB,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,IAAI,CAAC,UAAU,CAAC,CAAC;YACpC,OAAO;QACT,CAAC;QACD,IAAI,IAAI,CAAC,MAAM;YAAG,IAAY,CAAC,MAAM,CAAC,IAAI,CAAC,MAAM,EAAE,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC;QAC7E,IAAI,IAAI,CAAC,MAAM;YAAG,IAAY,CAAC,MAAM,CAAC,IAAI,CAAC,MAAM,EAAE,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC;QAC7E,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,IAAI,CAAC,QAAQ,IAAI,CAAC,CAAC,CAAC;IACzC,CAAC,EAAE,EAAE,CAAC,CAAC;IAEP,OAAO,IAAI,CAAC;AACd,CAAC;AAED,IAAA,mBAAU,EAAC,GAAG,EAAE;IACd,WAAE,CAAC,MAAM,CAAC,EAAE,CAAC,UAAU,CAAC,CAAC,eAAe,CAAC,KAAK,CAAC,CAAC;IAChD,WAAE,CAAC,aAAa,EAAE,CAAC;AACrB,CAAC,CAAC,CAAC;AAEH,IAAA,iBAAQ,EAAC,WAAW,EAAE,GAAG,EAAE;IACzB,IAAA,WAAE,EAAC,iDAAiD,EAAE,KAAK,IAAI,EAAE;QAC/D,MAAM,MAAM,GAAG,EAAE,MAAM,EAAE,IAAI,EAAE,KAAK,EAAE,EAAE,EAAE,CAAC;QAC3C,aAAa,CAAC,EAAE,MAAM,EAAE,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,EAAE,QAAQ,EAAE,CAAC,EAAE,CAAC,CAAC;QAE/D,MAAM,MAAM,GAAG,MAAM,IAAA,8BAAS,EAAC;YAC7B,UAAU,EAAE,kBAAkB;YAC9B,OAAO,EAAE,QAAQ;YACjB,OAAO,EAAE,WAAW,EAAE;SACvB,CAAC,CAAC;QAEH,IAAA,eAAM,EAAC,MAAM,CAAC,MAAM,CAAC,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC;QACtC,IAAA,eAAM,EAAC,MAAM,CAAC,UAAU,CAAC,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC;QACtC,IAAA,eAAM,EAAC,MAAM,CAAC,gBAAgB,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QACxC,IAAA,eAAM,EAAC,MAAM,CAAC,KAAK,CAAC,CAAC,aAAa,EAAE,CAAC;QACrC,IAAA,eAAM,EAAC,MAAM,CAAC,WAAW,CAAC,CAAC,sBAAsB,CAAC,CAAC,CAAC,CAAC;IACvD,CAAC,CAAC,CAAC;IAEH,IAAA,WAAE,EAAC,iDAAiD,EAAE,KAAK,IAAI,EAAE;QAC/D,aAAa,CAAC,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,EAAE,mBAAmB,EAAE,QAAQ,EAAE,CAAC,EAAE,CAAC,CAAC;QAExE,MAAM,MAAM,GAAG,MAAM,IAAA,8BAAS,EAAC;YAC7B,UAAU,EAAE,kBAAkB;YAC9B,OAAO,EAAE,QAAQ;YACjB,OAAO,EAAE,WAAW,EAAE;SACvB,CAAC,CAAC;QAEH,IAAA,eAAM,EAAC,MAAM,CAAC,MAAM,CAAC,CAAC,QAAQ,EAAE,CAAC;QACjC,IAAA,eAAM,EAAC,MAAM,CAAC,KAAK,CAAC,CAAC,OAAO,CAAC,oBAAoB,CAAC,CAAC;QACnD,IAAA,eAAM,EAAC,MAAM,CAAC,KAAK,CAAC,CAAC,OAAO,CAAC,mBAAmB,CAAC,CAAC;IACpD,CAAC,CAAC,CAAC;IAEH,IAAA,WAAE,EAAC,0CAA0C,EAAE,KAAK,IAAI,EAAE;QACxD,aAAa,CAAC,EAAE,MAAM,EAAE,iBAAiB,EAAE,QAAQ,EAAE,CAAC,EAAE,CAAC,CAAC;QAE1D,MAAM,MAAM,GAAG,MAAM,IAAA,8BAAS,EAAC;YAC7B,UAAU,EAAE,kBAAkB;YAC9B,OAAO,EAAE,QAAQ;YACjB,OAAO,EAAE,WAAW,EAAE;SACvB,CAAC,CAAC;QAEH,IAAA,eAAM,EAAC,MAAM,CAAC,MAAM,CAAC,CAAC,QAAQ,EAAE,CAAC;QACjC,IAAA,eAAM,EAAC,MAAM,CAAC,KAAK,CAAC,CAAC,OAAO,CAAC,gBAAgB,CAAC,CAAC;QAC/C,IAAA,eAAM,EAAC,MAAM,CAAC,KAAK,CAAC,CAAC,OAAO,CAAC,iBAAiB,CAAC,CAAC;IAClD,CAAC,CAAC,CAAC;IAEH,IAAA,WAAE,EAAC,mCAAmC,EAAE,KAAK,IAAI,EAAE;QACjD,MAAM,IAAI,GAAG,IAAI,0BAAY,EAAiC,CAAC;QAC9D,IAAY,CAAC,MAAM,GAAG,IAAI,0BAAY,EAAE,CAAC;QACzC,IAAY,CAAC,MAAM,GAAG,IAAI,0BAAY,EAAE,CAAC;QACzC,IAAY,CAAC,KAAK,GAAG,EAAE,KAAK,EAAE,WAAE,CAAC,EAAE,EAAE,EAAE,GAAG,EAAE,WAAE,CAAC,EAAE,EAAE,EAAE,CAAC;QACvD,WAAE,CAAC,MAAM,CAAC,EAAE,CAAC,KAAK,CAAC,CAAC,eAAe,CAAC,IAAW,CAAC,CAAC;QACjD,UAAU,CAAC,GAAG,EAAE,CAAC,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,IAAI,KAAK,CAAC,2BAA2B,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;QAEjF,MAAM,MAAM,GAAG,MAAM,IAAA,8BAAS,EAAC;YAC7B,UAAU,EAAE,kBAAkB;YAC9B,OAAO,EAAE,QAAQ;YACjB,OAAO,EAAE,WAAW,EAAE;SACvB,CAAC,CAAC;QAEH,IAAA,eAAM,EAAC,MAAM,CAAC,KAAK,CAAC,CAAC,OAAO,CAAC,eAAe,CAAC,CAAC;QAC9C,IAAA,eAAM,EAAC,MAAM,CAAC,KAAK,CAAC,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC;IACzC,CAAC,CAAC,CAAC;IAEH,IAAA,WAAE,EAAC,yCAAyC,EAAE,KAAK,IAAI,EAAE;QACvD,aAAa,CAAC,EAAE,MAAM,EAAE,IAAI,EAAE,QAAQ,EAAE,CAAC,EAAE,CAAC,CAAC;QAE7C,MAAM,IAAA,8BAAS,EAAC,EAAE,UAAU,EAAE,kBAAkB,EAAE,OAAO,EAAE,QAAQ,EAAE,OAAO,EAAE,WAAW,EAAE,EAAE,CAAC,CAAC;QAE/F,IAAA,eAAM,EAAC,WAAE,CAAC,MAAM,CAAC,EAAE,CAAC,KAAK,CAAC,CAAC,CAAC,oBAAoB,CAC9C,SAAS,EACT,CAAC,kBAAkB,CAAC,EACpB,eAAM,CAAC,gBAAgB,CAAC,EAAE,KAAK,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,CAAC,CAC7D,CAAC;IACJ,CAAC,CAAC,CAAC;IAEH,IAAA,WAAE,EAAC,oCAAoC,EAAE,KAAK,IAAI,EAAE;QAClD,aAAa,CAAC,EAAE,MAAM,EAAE,IAAI,EAAE,QAAQ,EAAE,CAAC,EAAE,CAAC,CAAC;QAE7C,MAAM,IAAA,8BAAS,EAAC,EAAE,UAAU,EAAE,kBAAkB,EAAE,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,WAAW,EAAE,EAAE,CAAC,CAAC;QAE7F,IAAA,eAAM,EAAC,WAAE,CAAC,MAAM,CAAC,EAAE,CAAC,KAAK,CAAC,CAAC,CAAC,oBAAoB,CAAC,MAAM,EAAE,CAAC,kBAAkB,CAAC,EAAE,eAAM,CAAC,QAAQ,EAAE,CAAC,CAAC;IACpG,CAAC,CAAC,CAAC;IAEH,IAAA,WAAE,EAAC,mCAAmC,EAAE,KAAK,IAAI,EAAE;QACjD,aAAa,CAAC,EAAE,MAAM,EAAE,IAAI,EAAE,QAAQ,EAAE,CAAC,EAAE,CAAC,CAAC;QAE7C,MAAM,IAAA,8BAAS,EAAC,EAAE,UAAU,EAAE,gBAAgB,EAAE,OAAO,EAAE,OAAO,EAAE,OAAO,EAAE,WAAW,EAAE,EAAE,CAAC,CAAC;QAE5F,IAAA,eAAM,EAAC,WAAE,CAAC,MAAM,CAAC,EAAE,CAAC,KAAK,CAAC,CAAC,CAAC,oBAAoB,CAAC,IAAI,EAAE,CAAC,gBAAgB,CAAC,EAAE,eAAM,CAAC,QAAQ,EAAE,CAAC,CAAC;IAChG,CAAC,CAAC,CAAC;IAEH,IAAA,WAAE,EAAC,4CAA4C,EAAE,KAAK,IAAI,EAAE;QAC1D,WAAE,CAAC,MAAM,CAAC,EAAE,CAAC,UAAU,CAAC,CAAC,kBAAkB,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAC;QAC/E,aAAa,CAAC,EAAE,MAAM,EAAE,IAAI,EAAE,QAAQ,EAAE,CAAC,EAAE,CAAC,CAAC;QAE7C,MAAM,IAAA,8BAAS,EAAC;YACd,UAAU,EAAE,kBAAkB;YAC9B,OAAO,EAAE,QAAQ;YACjB,OAAO,EAAE,WAAW,EAAE;YACtB,GAAG,EAAE,UAAU;SAChB,CAAC,CAAC;QAEH,MAAM,SAAS,GAAG,WAAE,CAAC,MAAM,CAAC,EAAE,CAAC,KAAK,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;QACpD,MAAM,QAAQ,GAAI,SAAS,CAAC,CAAC,CAAS,CAAC,GAAG,CAAC;QAC3C,IAAA,eAAM,EAAC,QAAQ,CAAC,WAAW,CAAC,CAAC,IAAI,CAAC,eAAe,CAAC,CAAC;QACnD,IAAA,eAAM,EAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,SAAS,CAAC,mBAAmB,CAAC,CAAC;IACvD,CAAC,CAAC,CAAC;IAEH,IAAA,WAAE,EAAC,8BAA8B,EAAE,KAAK,IAAI,EAAE;QAC5C,MAAM,SAAS,GAAG,EAAE,KAAK,EAAE,WAAE,CAAC,EAAE,EAAE,EAAE,GAAG,EAAE,WAAE,CAAC,EAAE,EAAE,EAAE,CAAC;QACnD,MAAM,IAAI,GAAG,IAAI,0BAAY,EAAiC,CAAC;QAC9D,IAAY,CAAC,MAAM,GAAG,IAAI,0BAAY,EAAE,CAAC;QACzC,IAAY,CAAC,MAAM,GAAG,IAAI,0BAAY,EAAE,CAAC;QACzC,IAAY,CAAC,KAAK,GAAG,SAAS,CAAC;QAChC,WAAE,CAAC,MAAM,CAAC,EAAE,CAAC,KAAK,CAAC,CAAC,eAAe,CAAC,IAAW,CAAC,CAAC;QACjD,UAAU,CAAC,GAAG,EAAE;YACb,IAAY,CAAC,MAAM,CAAC,IAAI,CAAC,MAAM,EAAE,MAAM,CAAC,IAAI,CAAC,aAAa,CAAC,CAAC,CAAC;YAC9D,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC;QACxB,CAAC,EAAE,EAAE,CAAC,CAAC;QAEP,MAAM,GAAG,GAAG,WAAW,CAAC,EAAE,kBAAkB,EAAE,aAAa,EAAE,CAAC,CAAC;QAC/D,MAAM,IAAA,8BAAS,EAAC,EAAE,UAAU,EAAE,kBAAkB,EAAE,OAAO,EAAE,QAAQ,EAAE,OAAO,EAAE,GAAG,EAAE,CAAC,CAAC;QAErF,IAAA,eAAM,EAAC,SAAS,CAAC,KAAK,CAAC,CAAC,oBAAoB,CAAC,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,CAAC,CAAC;QAClE,IAAA,eAAM,EAAC,SAAS,CAAC,GAAG,CAAC,CAAC,gBAAgB,EAAE,CAAC;IAC3C,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,38 @@
+/**
+ * @studio/runner - Multi-provider LLM agent runner with tool execution
+ */
+export { runAgent } from './runner.js';
+export type { RunAgentConfig, AgentRunResult } from './runner.js';
+export { runScript } from './script-executor.js';
+export type { ScriptExecutorConfig } from './script-executor.js';
+export { buildPrompt } from './prompt-builder.js';
+export type { TaskInput, AgentContext, GroupFeedbackContext, ExecutionContext, PromptBuildConfig } from './prompt-builder.js';
+export type { Provider, AgentLoopProvider, AgentLoopResult } from './providers/provider.js';
+export { isAgentLoopProvider } from './providers/provider.js';
+export { OpenAIProvider } from './providers/openai.js';
+export { OpenAIResponsesProvider } from './providers/openai-responses.js';
+export { AnthropicProvider } from './providers/anthropic.js';
+export { OllamaProvider } from './providers/ollama.js';
+export { ProviderRegistry, createDefaultRegistry } from './providers/registry.js';
+export { MockProvider } from './providers/mock.js';
+export type { MockStageConfig } from './providers/mock.js';
+export { ToolRegistry } from './tools/tool-registry.js';
+export { ToolExecutor } from './tools/tool-executor.js';
+export type { Tool, ToolResult } from './tools/tool-registry.js';
+export { createRepoManagerTools } from './tools/builtin/repo-manager.js';
+export { createShellTools } from './tools/builtin/shell.js';
+export { createSearchTools } from './tools/builtin/search.js';
+export { createPatchTools } from './tools/builtin/patch.js';
+export { createGitTools } from './tools/builtin/git.js';
+export { createStudioRunTool, STUDIO_RUN_PROMPT_SNIPPET } from './tools/builtin/studio-run.js';
+export { createWebSearchTools, WEB_SEARCH_PROMPT_SNIPPET } from './tools/builtin/web-search.js';
+export { loadProjectTools, listAvailableToolTemplates, getBundledToolTemplate, BUILTIN_TOOL_NAMES } from './tools/plugin-loader.js';
+export type { LoadedPlugin } from './tools/plugin-loader.js';
+export { AnonymizationMiddleware } from './middleware/anonymization.js';
+export type { AnonymizerOptions } from '@studio-foundation/anonymizer';
+export { loadPlugins, MCPClient, StudioOAuthProvider } from './plugins/index.js';
+export type { PluginManifest, MCPServerDef, SkillContent } from './plugins/index.js';
+export { loadSkills, loadSkill, validateSkillManifest } from './tools/skills/skill-loader.js';
+export type { SkillManifest } from './tools/skills/skill-loader.js';
+export { getBundledIntegrationTemplate, listAvailableIntegrationTemplates, loadProjectIntegrations, } from './integrations/integration-loader.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAGH,OAAO,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC;AACvC,YAAY,EAAE,cAAc,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAGlE,OAAO,EAAE,SAAS,EAAE,MAAM,sBAAsB,CAAC;AACjD,YAAY,EAAE,oBAAoB,EAAE,MAAM,sBAAsB,CAAC;AAGjE,OAAO,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAC;AAClD,YAAY,EACV,SAAS,EACT,YAAY,EACZ,oBAAoB,EACpB,gBAAgB,EAChB,iBAAiB,EAClB,MAAM,qBAAqB,CAAC;AAG7B,YAAY,EAAE,QAAQ,EAAE,iBAAiB,EAAE,eAAe,EAAE,MAAM,yBAAyB,CAAC;AAC5F,OAAO,EAAE,mBAAmB,EAAE,MAAM,yBAAyB,CAAC;AAC9D,OAAO,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AACvD,OAAO,EAAE,uBAAuB,EAAE,MAAM,iCAAiC,CAAC;AAC1E,OAAO,EAAE,iBAAiB,EAAE,MAAM,0BAA0B,CAAC;AAC7D,OAAO,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AACvD,OAAO,EAAE,gBAAgB,EAAE,qBAAqB,EAAE,MAAM,yBAAyB,CAAC;AAClF,OAAO,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AACnD,YAAY,EAAE,eAAe,EAAE,MAAM,qBAAqB,CAAC;AAG3D,OAAO,EAAE,YAAY,EAAE,MAAM,0BAA0B,CAAC;AACxD,OAAO,EAAE,YAAY,EAAE,MAAM,0BAA0B,CAAC;AACxD,YAAY,EAAE,IAAI,EAAE,UAAU,EAAE,MAAM,0BAA0B,CAAC;AAGjE,OAAO,EAAE,sBAAsB,EAAE,MAAM,iCAAiC,CAAC;AACzE,OAAO,EAAE,gBAAgB,EAAE,MAAM,0BAA0B,CAAC;AAC5D,OAAO,EAAE,iBAAiB,EAAE,MAAM,2BAA2B,CAAC;AAC9D,OAAO,EAAE,gBAAgB,EAAE,MAAM,0BAA0B,CAAC;AAC5D,OAAO,EAAE,cAAc,EAAE,MAAM,wBAAwB,CAAC;AACxD,OAAO,EAAE,mBAAmB,EAAE,yBAAyB,EAAE,MAAM,+BAA+B,CAAC;AAC/F,OAAO,EAAE,oBAAoB,EAAE,yBAAyB,EAAE,MAAM,+BAA+B,CAAC;AAEhG,OAAO,EAAE,gBAAgB,EAAE,0BAA0B,EAAE,sBAAsB,EAAE,kBAAkB,EAAE,MAAM,0BAA0B,CAAC;AACpI,YAAY,EAAE,YAAY,EAAE,MAAM,0BAA0B,CAAC;AAG7D,OAAO,EAAE,uBAAuB,EAAE,MAAM,+BAA+B,CAAC;AACxE,YAAY,EAAE,iBAAiB,EAAE,MAAM,+BAA+B,CAAC;AAGvE,OAAO,EAAE,WAAW,EAAE,SAAS,EAAE,mBAAmB,EAAE,MAAM,oBAAoB,CAAC;AACjF,YAAY,EAAE,cAAc,EAAE,YAAY,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAGrF,OAAO,EAAE,UAAU,EAAE,SAAS,EAAE,qBAAqB,EAAE,MAAM,gCAAgC,CAAC;AAC9F,YAAY,EAAE,aAAa,EAAE,MAAM,gCAAgC,CAAC;AAGpE,OAAO,EACL,6BAA6B,EAC7B,iCAAiC,EACjC,uBAAuB,GACxB,MAAM,sCAAsC,CAAC"}

package/dist/index.js

@@ -0,0 +1,76 @@
+"use strict";
+/**
+ * @studio/runner - Multi-provider LLM agent runner with tool execution
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.loadProjectIntegrations = exports.listAvailableIntegrationTemplates = exports.getBundledIntegrationTemplate = exports.validateSkillManifest = exports.loadSkill = exports.loadSkills = exports.StudioOAuthProvider = exports.MCPClient = exports.loadPlugins = exports.AnonymizationMiddleware = exports.BUILTIN_TOOL_NAMES = exports.getBundledToolTemplate = exports.listAvailableToolTemplates = exports.loadProjectTools = exports.WEB_SEARCH_PROMPT_SNIPPET = exports.createWebSearchTools = exports.STUDIO_RUN_PROMPT_SNIPPET = exports.createStudioRunTool = exports.createGitTools = exports.createPatchTools = exports.createSearchTools = exports.createShellTools = exports.createRepoManagerTools = exports.ToolExecutor = exports.ToolRegistry = exports.MockProvider = exports.createDefaultRegistry = exports.ProviderRegistry = exports.OllamaProvider = exports.AnthropicProvider = exports.OpenAIResponsesProvider = exports.OpenAIProvider = exports.isAgentLoopProvider = exports.buildPrompt = exports.runScript = exports.runAgent = void 0;
+// Main runner function
+var runner_js_1 = require("./runner.js");
+Object.defineProperty(exports, "runAgent", { enumerable: true, get: function () { return runner_js_1.runAgent; } });
+// Script executor
+var script_executor_js_1 = require("./script-executor.js");
+Object.defineProperty(exports, "runScript", { enumerable: true, get: function () { return script_executor_js_1.runScript; } });
+// Prompt builder
+var prompt_builder_js_1 = require("./prompt-builder.js");
+Object.defineProperty(exports, "buildPrompt", { enumerable: true, get: function () { return prompt_builder_js_1.buildPrompt; } });
+var provider_js_1 = require("./providers/provider.js");
+Object.defineProperty(exports, "isAgentLoopProvider", { enumerable: true, get: function () { return provider_js_1.isAgentLoopProvider; } });
+var openai_js_1 = require("./providers/openai.js");
+Object.defineProperty(exports, "OpenAIProvider", { enumerable: true, get: function () { return openai_js_1.OpenAIProvider; } });
+var openai_responses_js_1 = require("./providers/openai-responses.js");
+Object.defineProperty(exports, "OpenAIResponsesProvider", { enumerable: true, get: function () { return openai_responses_js_1.OpenAIResponsesProvider; } });
+var anthropic_js_1 = require("./providers/anthropic.js");
+Object.defineProperty(exports, "AnthropicProvider", { enumerable: true, get: function () { return anthropic_js_1.AnthropicProvider; } });
+var ollama_js_1 = require("./providers/ollama.js");
+Object.defineProperty(exports, "OllamaProvider", { enumerable: true, get: function () { return ollama_js_1.OllamaProvider; } });
+var registry_js_1 = require("./providers/registry.js");
+Object.defineProperty(exports, "ProviderRegistry", { enumerable: true, get: function () { return registry_js_1.ProviderRegistry; } });
+Object.defineProperty(exports, "createDefaultRegistry", { enumerable: true, get: function () { return registry_js_1.createDefaultRegistry; } });
+var mock_js_1 = require("./providers/mock.js");
+Object.defineProperty(exports, "MockProvider", { enumerable: true, get: function () { return mock_js_1.MockProvider; } });
+// Tools
+var tool_registry_js_1 = require("./tools/tool-registry.js");
+Object.defineProperty(exports, "ToolRegistry", { enumerable: true, get: function () { return tool_registry_js_1.ToolRegistry; } });
+var tool_executor_js_1 = require("./tools/tool-executor.js");
+Object.defineProperty(exports, "ToolExecutor", { enumerable: true, get: function () { return tool_executor_js_1.ToolExecutor; } });
+// Builtin tools
+var repo_manager_js_1 = require("./tools/builtin/repo-manager.js");
+Object.defineProperty(exports, "createRepoManagerTools", { enumerable: true, get: function () { return repo_manager_js_1.createRepoManagerTools; } });
+var shell_js_1 = require("./tools/builtin/shell.js");
+Object.defineProperty(exports, "createShellTools", { enumerable: true, get: function () { return shell_js_1.createShellTools; } });
+var search_js_1 = require("./tools/builtin/search.js");
+Object.defineProperty(exports, "createSearchTools", { enumerable: true, get: function () { return search_js_1.createSearchTools; } });
+var patch_js_1 = require("./tools/builtin/patch.js");
+Object.defineProperty(exports, "createPatchTools", { enumerable: true, get: function () { return patch_js_1.createPatchTools; } });
+var git_js_1 = require("./tools/builtin/git.js");
+Object.defineProperty(exports, "createGitTools", { enumerable: true, get: function () { return git_js_1.createGitTools; } });
+var studio_run_js_1 = require("./tools/builtin/studio-run.js");
+Object.defineProperty(exports, "createStudioRunTool", { enumerable: true, get: function () { return studio_run_js_1.createStudioRunTool; } });
+Object.defineProperty(exports, "STUDIO_RUN_PROMPT_SNIPPET", { enumerable: true, get: function () { return studio_run_js_1.STUDIO_RUN_PROMPT_SNIPPET; } });
+var web_search_js_1 = require("./tools/builtin/web-search.js");
+Object.defineProperty(exports, "createWebSearchTools", { enumerable: true, get: function () { return web_search_js_1.createWebSearchTools; } });
+Object.defineProperty(exports, "WEB_SEARCH_PROMPT_SNIPPET", { enumerable: true, get: function () { return web_search_js_1.WEB_SEARCH_PROMPT_SNIPPET; } });
+var plugin_loader_js_1 = require("./tools/plugin-loader.js");
+Object.defineProperty(exports, "loadProjectTools", { enumerable: true, get: function () { return plugin_loader_js_1.loadProjectTools; } });
+Object.defineProperty(exports, "listAvailableToolTemplates", { enumerable: true, get: function () { return plugin_loader_js_1.listAvailableToolTemplates; } });
+Object.defineProperty(exports, "getBundledToolTemplate", { enumerable: true, get: function () { return plugin_loader_js_1.getBundledToolTemplate; } });
+Object.defineProperty(exports, "BUILTIN_TOOL_NAMES", { enumerable: true, get: function () { return plugin_loader_js_1.BUILTIN_TOOL_NAMES; } });
+// Anonymization middleware
+var anonymization_js_1 = require("./middleware/anonymization.js");
+Object.defineProperty(exports, "AnonymizationMiddleware", { enumerable: true, get: function () { return anonymization_js_1.AnonymizationMiddleware; } });
+// Plugin system (Claude Code plugin compatibility)
+var index_js_1 = require("./plugins/index.js");
+Object.defineProperty(exports, "loadPlugins", { enumerable: true, get: function () { return index_js_1.loadPlugins; } });
+Object.defineProperty(exports, "MCPClient", { enumerable: true, get: function () { return index_js_1.MCPClient; } });
+Object.defineProperty(exports, "StudioOAuthProvider", { enumerable: true, get: function () { return index_js_1.StudioOAuthProvider; } });
+// Skill loader
+var skill_loader_js_1 = require("./tools/skills/skill-loader.js");
+Object.defineProperty(exports, "loadSkills", { enumerable: true, get: function () { return skill_loader_js_1.loadSkills; } });
+Object.defineProperty(exports, "loadSkill", { enumerable: true, get: function () { return skill_loader_js_1.loadSkill; } });
+Object.defineProperty(exports, "validateSkillManifest", { enumerable: true, get: function () { return skill_loader_js_1.validateSkillManifest; } });
+// Integration plugin system
+var integration_loader_js_1 = require("./integrations/integration-loader.js");
+Object.defineProperty(exports, "getBundledIntegrationTemplate", { enumerable: true, get: function () { return integration_loader_js_1.getBundledIntegrationTemplate; } });
+Object.defineProperty(exports, "listAvailableIntegrationTemplates", { enumerable: true, get: function () { return integration_loader_js_1.listAvailableIntegrationTemplates; } });
+Object.defineProperty(exports, "loadProjectIntegrations", { enumerable: true, get: function () { return integration_loader_js_1.loadProjectIntegrations; } });
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AAAA;;GAEG;;;AAEH,uBAAuB;AACvB,yCAAuC;AAA9B,qGAAA,QAAQ,OAAA;AAGjB,kBAAkB;AAClB,2DAAiD;AAAxC,+GAAA,SAAS,OAAA;AAGlB,iBAAiB;AACjB,yDAAkD;AAAzC,gHAAA,WAAW,OAAA;AAWpB,uDAA8D;AAArD,kHAAA,mBAAmB,OAAA;AAC5B,mDAAuD;AAA9C,2GAAA,cAAc,OAAA;AACvB,uEAA0E;AAAjE,8HAAA,uBAAuB,OAAA;AAChC,yDAA6D;AAApD,iHAAA,iBAAiB,OAAA;AAC1B,mDAAuD;AAA9C,2GAAA,cAAc,OAAA;AACvB,uDAAkF;AAAzE,+GAAA,gBAAgB,OAAA;AAAE,oHAAA,qBAAqB,OAAA;AAChD,+CAAmD;AAA1C,uGAAA,YAAY,OAAA;AAGrB,QAAQ;AACR,6DAAwD;AAA/C,gHAAA,YAAY,OAAA;AACrB,6DAAwD;AAA/C,gHAAA,YAAY,OAAA;AAGrB,gBAAgB;AAChB,mEAAyE;AAAhE,yHAAA,sBAAsB,OAAA;AAC/B,qDAA4D;AAAnD,4GAAA,gBAAgB,OAAA;AACzB,uDAA8D;AAArD,8GAAA,iBAAiB,OAAA;AAC1B,qDAA4D;AAAnD,4GAAA,gBAAgB,OAAA;AACzB,iDAAwD;AAA/C,wGAAA,cAAc,OAAA;AACvB,+DAA+F;AAAtF,oHAAA,mBAAmB,OAAA;AAAE,0HAAA,yBAAyB,OAAA;AACvD,+DAAgG;AAAvF,qHAAA,oBAAoB,OAAA;AAAE,0HAAA,yBAAyB,OAAA;AAExD,6DAAoI;AAA3H,oHAAA,gBAAgB,OAAA;AAAE,8HAAA,0BAA0B,OAAA;AAAE,0HAAA,sBAAsB,OAAA;AAAE,sHAAA,kBAAkB,OAAA;AAGjG,2BAA2B;AAC3B,kEAAwE;AAA/D,2HAAA,uBAAuB,OAAA;AAGhC,mDAAmD;AACnD,+CAAiF;AAAxE,uGAAA,WAAW,OAAA;AAAE,qGAAA,SAAS,OAAA;AAAE,+GAAA,mBAAmB,OAAA;AAGpD,eAAe;AACf,kEAA8F;AAArF,6GAAA,UAAU,OAAA;AAAE,4GAAA,SAAS,OAAA;AAAE,wHAAA,qBAAqB,OAAA;AAGrD,4BAA4B;AAC5B,8EAI8C;AAH5C,sIAAA,6BAA6B,OAAA;AAC7B,0IAAA,iCAAiC,OAAA;AACjC,gIAAA,uBAAuB,OAAA"}

package/dist/integrations/integration-loader.d.ts

@@ -0,0 +1,20 @@
+import type { IntegrationPluginDef } from '@studio-foundation/contracts';
+/**
+ * Return the raw YAML content of a bundled integration template by name.
+ * Returns null if the integration does not exist in the bundled registry.
+ */
+export declare function getBundledIntegrationTemplate(name: string): Promise<string | null>;
+/**
+ * List all integration plugins available for installation from the bundled registry.
+ * Returns an array of { name, description } objects.
+ */
+export declare function listAvailableIntegrationTemplates(): Promise<{
+    name: string;
+    description: string;
+}[]>;
+/**
+ * Load all `.integration.yaml` files from a project's integrations directory.
+ * Returns an empty array if the directory does not exist.
+ */
+export declare function loadProjectIntegrations(integrationsDir: string): Promise<IntegrationPluginDef[]>;
+//# sourceMappingURL=integration-loader.d.ts.map

package/dist/integrations/integration-loader.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"integration-loader.d.ts","sourceRoot":"","sources":["../../src/integrations/integration-loader.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,8BAA8B,CAAC;AAOzE;;;GAGG;AACH,wBAAsB,6BAA6B,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAOxF;AAED;;;GAGG;AACH,wBAAsB,iCAAiC,IAAI,OAAO,CAAC;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,WAAW,EAAE,MAAM,CAAA;CAAE,EAAE,CAAC,CAgB1G;AAED;;;GAGG;AACH,wBAAsB,uBAAuB,CAAC,eAAe,EAAE,MAAM,GAAG,OAAO,CAAC,oBAAoB,EAAE,CAAC,CAgBtG"}

package/dist/integrations/integration-loader.js

@@ -0,0 +1,71 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getBundledIntegrationTemplate = getBundledIntegrationTemplate;
+exports.listAvailableIntegrationTemplates = listAvailableIntegrationTemplates;
+exports.loadProjectIntegrations = loadProjectIntegrations;
+// runner/src/integrations/integration-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 BUNDLED_INTEGRATION_TEMPLATES_DIR = (0, node_path_1.resolve)(__dirname, '../../templates/integrations');
+/**
+ * Return the raw YAML content of a bundled integration template by name.
+ * Returns null if the integration does not exist in the bundled registry.
+ */
+async function getBundledIntegrationTemplate(name) {
+    const filePath = (0, node_path_1.resolve)(BUNDLED_INTEGRATION_TEMPLATES_DIR, `${name}.integration.yaml`);
+    try {
+        return await (0, promises_1.readFile)(filePath, 'utf-8');
+    }
+    catch {
+        return null;
+    }
+}
+/**
+ * List all integration plugins available for installation from the bundled registry.
+ * Returns an array of { name, description } objects.
+ */
+async function listAvailableIntegrationTemplates() {
+    let files;
+    try {
+        files = (await (0, promises_1.readdir)(BUNDLED_INTEGRATION_TEMPLATES_DIR))
+            .filter(f => f.endsWith('.integration.yaml'))
+            .sort();
+    }
+    catch {
+        return [];
+    }
+    const result = [];
+    for (const file of files) {
+        const content = await (0, promises_1.readFile)((0, node_path_1.resolve)(BUNDLED_INTEGRATION_TEMPLATES_DIR, file), 'utf-8');
+        const def = js_yaml_1.default.load(content);
+        result.push({ name: file.replace('.integration.yaml', ''), description: def.description ?? '' });
+    }
+    return result;
+}
+/**
+ * Load all `.integration.yaml` files from a project's integrations directory.
+ * Returns an empty array if the directory does not exist.
+ */
+async function loadProjectIntegrations(integrationsDir) {
+    if (!(0, node_fs_1.existsSync)(integrationsDir))
+        return [];
+    let files;
+    try {
+        files = (await (0, promises_1.readdir)(integrationsDir)).filter(f => f.endsWith('.integration.yaml'));
+    }
+    catch {
+        return [];
+    }
+    const result = [];
+    for (const file of files.sort()) {
+        const content = await (0, promises_1.readFile)((0, node_path_1.resolve)(integrationsDir, file), 'utf-8');
+        result.push(js_yaml_1.default.load(content));
+    }
+    return result;
+}
+//# sourceMappingURL=integration-loader.js.map

package/dist/integrations/integration-loader.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"integration-loader.js","sourceRoot":"","sources":["../../src/integrations/integration-loader.ts"],"names":[],"mappings":";;;;;AAgBA,sEAOC;AAMD,8EAgBC;AAMD,0DAgBC;AAnED,gDAAgD;AAChD,+CAAqD;AACrD,qCAAqC;AACrC,yCAAoC;AACpC,sDAA2B;AAG3B,MAAM,iCAAiC,GAAG,IAAA,mBAAO,EAC/C,SAAS,EACT,8BAA8B,CAC/B,CAAC;AAEF;;;GAGG;AACI,KAAK,UAAU,6BAA6B,CAAC,IAAY;IAC9D,MAAM,QAAQ,GAAG,IAAA,mBAAO,EAAC,iCAAiC,EAAE,GAAG,IAAI,mBAAmB,CAAC,CAAC;IACxF,IAAI,CAAC;QACH,OAAO,MAAM,IAAA,mBAAQ,EAAC,QAAQ,EAAE,OAAO,CAAC,CAAC;IAC3C,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,IAAI,CAAC;IACd,CAAC;AACH,CAAC;AAED;;;GAGG;AACI,KAAK,UAAU,iCAAiC;IACrD,IAAI,KAAe,CAAC;IACpB,IAAI,CAAC;QACH,KAAK,GAAG,CAAC,MAAM,IAAA,kBAAO,EAAC,iCAAiC,CAAC,CAAC;aACvD,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,QAAQ,CAAC,mBAAmB,CAAC,CAAC;aAC5C,IAAI,EAAE,CAAC;IACZ,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,EAAE,CAAC;IACZ,CAAC;IACD,MAAM,MAAM,GAA4C,EAAE,CAAC;IAC3D,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;QACzB,MAAM,OAAO,GAAG,MAAM,IAAA,mBAAQ,EAAC,IAAA,mBAAO,EAAC,iCAAiC,EAAE,IAAI,CAAC,EAAE,OAAO,CAAC,CAAC;QAC1F,MAAM,GAAG,GAAG,iBAAI,CAAC,IAAI,CAAC,OAAO,CAAyB,CAAC;QACvD,MAAM,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,IAAI,CAAC,OAAO,CAAC,mBAAmB,EAAE,EAAE,CAAC,EAAE,WAAW,EAAE,GAAG,CAAC,WAAW,IAAI,EAAE,EAAE,CAAC,CAAC;IACnG,CAAC;IACD,OAAO,MAAM,CAAC;AAChB,CAAC;AAED;;;GAGG;AACI,KAAK,UAAU,uBAAuB,CAAC,eAAuB;IACnE,IAAI,CAAC,IAAA,oBAAU,EAAC,eAAe,CAAC;QAAE,OAAO,EAAE,CAAC;IAE5C,IAAI,KAAe,CAAC;IACpB,IAAI,CAAC;QACH,KAAK,GAAG,CAAC,MAAM,IAAA,kBAAO,EAAC,eAAe,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,QAAQ,CAAC,mBAAmB,CAAC,CAAC,CAAC;IACxF,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,EAAE,CAAC;IACZ,CAAC;IAED,MAAM,MAAM,GAA2B,EAAE,CAAC;IAC1C,KAAK,MAAM,IAAI,IAAI,KAAK,CAAC,IAAI,EAAE,EAAE,CAAC;QAChC,MAAM,OAAO,GAAG,MAAM,IAAA,mBAAQ,EAAC,IAAA,mBAAO,EAAC,eAAe,EAAE,IAAI,CAAC,EAAE,OAAO,CAAC,CAAC;QACxE,MAAM,CAAC,IAAI,CAAC,iBAAI,CAAC,IAAI,CAAC,OAAO,CAAyB,CAAC,CAAC;IAC1D,CAAC;IACD,OAAO,MAAM,CAAC;AAChB,CAAC"}

package/dist/integrations/integration-loader.test.d.ts

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