{"_id":"@0xkobold/pi-orchestration","_rev":"5-d83ae8fc8a46fe4ae20aaf719b502a5d","name":"@0xkobold/pi-orchestration","dist-tags":{"latest":"0.3.0"},"versions":{"0.1.0":{"name":"@0xkobold/pi-orchestration","version":"0.1.0","keywords":["pi-package","pi-extension","subagent","orchestration","multi-agent","0xkobold"],"author":{"name":"0xKobold"},"license":"MIT","_id":"@0xkobold/pi-orchestration@0.1.0","maintainers":[{"name":"moikapy","email":"warrenckhan@gmail.com"}],"homepage":"https://github.com/0xKobold/pi-orchestration#readme","bugs":{"url":"https://github.com/0xKobold/pi-orchestration/issues"},"pi":{"extensions":["./dist/index.js"]},"dist":{"shasum":"c6c7a4ac36c096709ed8daebf5da3a5cee18dd2e","tarball":"https://registry.npmjs.org/@0xkobold/pi-orchestration/-/pi-orchestration-0.1.0.tgz","fileCount":113,"integrity":"sha512-JNuEBcVTxkRLWn1UCH9WKr1tN1E5GOJ8h6MD2eSRmjHvR7f+DH7ncuhuG4QGwuQGV/D8Y5oG6h9T1TF/80olcA==","signatures":[{"sig":"MEUCIQDKkD+VOTXJhOb5XrT1YnAdvoATWwjG172BTe5dCqa9QgIgYXtgO7A4dyjqMAM5Zu0cU4QJfO3K6UimSDfH23tZ/E8=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":417636},"main":"dist/index.js","type":"module","types":"dist/index.d.ts","exports":{".":{"types":"./dist/index.d.ts","import":"./dist/index.js"},"./core":{"types":"./dist/core/index.d.ts","import":"./dist/core/index.js"}},"gitHead":"867aca20578d2f4ed1f2986a0ffc9d75514ce681","scripts":{"dev":"tsc --watch","lint":"echo 'No linter configured'","test":"bun test","build":"rm -rf dist && tsc","prepublishOnly":"npm run build && npm test"},"_npmUser":{"name":"moikapy","email":"warrenckhan@gmail.com"},"repository":{"url":"git+https://github.com/moikapy/0xkobolds.git","type":"git"},"_npmVersion":"9.2.0","description":"Agnostic subagent orchestration for pi-coding-agent. Supports single, chain, parallel, and fork execution modes with depth limiting and worktree isolation.","directories":{},"_nodeVersion":"20.19.2","_hasShrinkwrap":false,"devDependencies":{"@types/bun":"latest","typescript":"^6.0.0","@types/node":"^20.0.0","@sinclair/typebox":">=0.32.0","@0xkobold/pi-ollama":">=0.2.0","@mariozechner/pi-coding-agent":">=0.65.0"},"peerDependencies":{"@sinclair/typebox":">=0.32.0","@0xkobold/pi-ollama":">=0.2.0","@mariozechner/pi-coding-agent":">=0.65.0"},"_npmOperationalInternal":{"tmp":"tmp/pi-orchestration_0.1.0_1775448635470_0.42930003333937194","host":"s3://npm-registry-packages-npm-production"}},"0.1.1":{"name":"@0xkobold/pi-orchestration","version":"0.1.1","keywords":["pi-package","pi-extension","subagent","orchestration","multi-agent","0xkobold"],"author":{"name":"0xKobold"},"license":"MIT","_id":"@0xkobold/pi-orchestration@0.1.1","maintainers":[{"name":"moikapy","email":"warrenckhan@gmail.com"}],"homepage":"https://github.com/0xKobold/pi-orchestration#readme","bugs":{"url":"https://github.com/0xKobold/pi-orchestration/issues"},"pi":{"extensions":["./dist/index.js"]},"dist":{"shasum":"d3b7723a7ecb82eff8a90a96c85c0eac7184a80c","tarball":"https://registry.npmjs.org/@0xkobold/pi-orchestration/-/pi-orchestration-0.1.1.tgz","fileCount":113,"integrity":"sha512-yYGbFJLBaDKrVyrR0oC2EZLYoer7gfePEwaynYl3m6xIBDlRbas2f+gdzAQy6Ss52xsynAVaPXtQwQRcxbaDTg==","signatures":[{"sig":"MEUCIHuAgp7sOHLImdXmRaiCtgN/Y3kKl6PzjCSeL/Boy/+8AiEA+LErfiROKaQ8H4Rtbe4ptdXYHdvicLcW9djyc/FOvNc=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":417629},"main":"dist/index.js","type":"module","types":"dist/index.d.ts","exports":{".":{"types":"./dist/index.d.ts","import":"./dist/index.js"},"./core":{"types":"./dist/core/index.d.ts","import":"./dist/core/index.js"}},"gitHead":"a445be1936465cd15eac7e2af4140456f3fab3f1","scripts":{"dev":"tsc --watch","lint":"echo 'No linter configured'","test":"bun test","build":"tsc","prepublishOnly":"npm run build && npm test"},"_npmUser":{"name":"moikapy","email":"warrenckhan@gmail.com"},"repository":{"url":"git+https://github.com/0xKobold/pi-orchestration.git","type":"git"},"_npmVersion":"9.2.0","description":"Agnostic subagent orchestration for pi-coding-agent. Supports single, chain, parallel, and fork execution modes with depth limiting and worktree isolation.","directories":{},"_nodeVersion":"20.19.2","_hasShrinkwrap":false,"devDependencies":{"@types/bun":"latest","typescript":"^6.0.0","@types/node":"^20.0.0","@sinclair/typebox":">=0.32.0","@0xkobold/pi-ollama":">=0.2.0","@mariozechner/pi-coding-agent":">=0.65.0"},"peerDependencies":{"@sinclair/typebox":">=0.32.0","@0xkobold/pi-ollama":">=0.2.0","@mariozechner/pi-coding-agent":">=0.65.0"},"_npmOperationalInternal":{"tmp":"tmp/pi-orchestration_0.1.1_1775484938618_0.1660519313299056","host":"s3://npm-registry-packages-npm-production"}},"0.2.0":{"name":"@0xkobold/pi-orchestration","version":"0.2.0","keywords":["pi-package","pi-extension","subagent","orchestration","multi-agent","0xkobold"],"author":{"name":"0xKobold"},"license":"MIT","_id":"@0xkobold/pi-orchestration@0.2.0","maintainers":[{"name":"moikapy","email":"warrenckhan@gmail.com"}],"homepage":"https://github.com/0xKobold/pi-orchestration#readme","bugs":{"url":"https://github.com/0xKobold/pi-orchestration/issues"},"pi":{"extensions":["./dist/index.js"]},"dist":{"shasum":"174d2878335606ddb1a19bcee2860c41c477246b","tarball":"https://registry.npmjs.org/@0xkobold/pi-orchestration/-/pi-orchestration-0.2.0.tgz","fileCount":113,"integrity":"sha512-uW36oAPYuS5kyRaT67qR+MypE3Anjl0yc82n2oGnVY/H5GQhGtCjagJfVghpNDLtf1WFdWpoUZgesUg6XtgpKw==","signatures":[{"sig":"MEQCIDye8+qXhtfTau8sYGMfxdczypiGvnpOV4ExQ5zdysjZAiB3aS+Mc63nr1PpGiBkdCZrWbv+IcnyaB2Io89nXSjvaA==","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":417818},"main":"dist/index.js","type":"module","types":"dist/index.d.ts","exports":{".":{"types":"./dist/index.d.ts","import":"./dist/index.js"},"./core":{"types":"./dist/core/index.d.ts","import":"./dist/core/index.js"}},"gitHead":"231b21192f631aecba0b2a82ea9068f3dcca0121","scripts":{"dev":"tsc --watch","lint":"echo 'No linter configured'","test":"bun test","build":"tsc","prepublishOnly":"rm -rf dist && tsc"},"_npmUser":{"name":"moikapy","email":"warrenckhan@gmail.com"},"repository":{"url":"git+https://github.com/0xKobold/pi-orchestration.git","type":"git"},"_npmVersion":"11.6.2","description":"Agnostic subagent orchestration for pi-coding-agent. Supports single, chain, parallel, and fork execution modes with depth limiting and worktree isolation.","directories":{},"_nodeVersion":"25.1.0","_hasShrinkwrap":false,"devDependencies":{"@types/bun":"latest","typescript":"^6.0.0","@types/node":"^20.0.0","@sinclair/typebox":">=0.32.0","@0xkobold/pi-ollama":">=0.2.0","@mariozechner/pi-coding-agent":">=0.65.0"},"peerDependencies":{"@sinclair/typebox":">=0.32.0","@0xkobold/pi-ollama":">=0.2.0","@mariozechner/pi-coding-agent":">=0.65.0"},"_npmOperationalInternal":{"tmp":"tmp/pi-orchestration_0.2.0_1775584451108_0.8273971046742703","host":"s3://npm-registry-packages-npm-production"}},"0.2.1":{"name":"@0xkobold/pi-orchestration","version":"0.2.1","keywords":["pi-package","pi-extension","subagent","orchestration","multi-agent","0xkobold"],"author":{"name":"0xKobold"},"license":"MIT","_id":"@0xkobold/pi-orchestration@0.2.1","maintainers":[{"name":"moikapy","email":"warrenckhan@gmail.com"}],"homepage":"https://github.com/0xKobold/pi-orchestration#readme","bugs":{"url":"https://github.com/0xKobold/pi-orchestration/issues"},"pi":{},"dist":{"shasum":"d366851d6f210e7f82f6dc919a6d76b0c687d239","tarball":"https://registry.npmjs.org/@0xkobold/pi-orchestration/-/pi-orchestration-0.2.1.tgz","fileCount":113,"integrity":"sha512-eYCb1cxrhteAyldZ1vw34PKpSjUu8ALSx97zU9XT0v9W64crAFZk+q217GCibqtEP+bMQ/gL9rrwtubIl5Exgw==","signatures":[{"sig":"MEYCIQDbdp1XH2TpjRRS6zH3E51bS3UfQQQXZiVWcYZ+o7akVwIhAMMZVKW3ra2fyY2BdWxyWCSEDJ9dZzY+Juxkt+xqcvF7","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":417765},"main":"dist/index.js","type":"module","types":"dist/index.d.ts","exports":{".":{"types":"./dist/index.d.ts","import":"./dist/index.js"},"./core":{"types":"./dist/core/index.d.ts","import":"./dist/core/index.js"}},"gitHead":"231b21192f631aecba0b2a82ea9068f3dcca0121","scripts":{"dev":"tsc --watch","lint":"echo 'No linter configured'","test":"bun test","build":"tsc","prepublishOnly":"rm -rf dist && tsc"},"_npmUser":{"name":"moikapy","email":"warrenckhan@gmail.com"},"repository":{"url":"git+https://github.com/0xKobold/pi-orchestration.git","type":"git"},"_npmVersion":"11.6.2","description":"Agnostic subagent orchestration for pi-coding-agent. Supports single, chain, parallel, and fork execution modes with depth limiting and worktree isolation.","directories":{},"_nodeVersion":"25.1.0","_hasShrinkwrap":false,"devDependencies":{"@types/bun":"latest","typescript":"^6.0.0","@types/node":"^20.0.0","@sinclair/typebox":">=0.32.0","@0xkobold/pi-ollama":">=0.2.0","@mariozechner/pi-coding-agent":">=0.65.0"},"peerDependencies":{"@sinclair/typebox":">=0.32.0","@0xkobold/pi-ollama":">=0.2.0","@mariozechner/pi-coding-agent":">=0.65.0"},"_npmOperationalInternal":{"tmp":"tmp/pi-orchestration_0.2.1_1775585987266_0.473225408427008","host":"s3://npm-registry-packages-npm-production"}},"0.3.0":{"name":"@0xkobold/pi-orchestration","version":"0.3.0","description":"Agnostic subagent orchestration for pi-coding-agent. Supports single, chain, parallel, and fork execution modes with depth limiting and worktree isolation.","keywords":["pi-package","pi-extension","subagent","orchestration","multi-agent","0xkobold"],"author":{"name":"0xKobold"},"license":"MIT","type":"module","main":"dist/index.js","types":"dist/index.d.ts","exports":{".":{"import":"./dist/index.js","types":"./dist/index.d.ts"},"./core":{"import":"./dist/core/index.js","types":"./dist/core/index.d.ts"}},"scripts":{"build":"tsc","dev":"tsc --watch","test":"bun test","lint":"echo 'No linter configured'","prepublishOnly":"rm -rf dist && tsc"},"pi":{"extensions":["./dist/index.js"]},"peerDependencies":{"@mariozechner/pi-coding-agent":">=0.65.0","@sinclair/typebox":">=0.32.0","@0xkobold/pi-ollama":">=0.2.0"},"devDependencies":{"@mariozechner/pi-coding-agent":">=0.65.0","@sinclair/typebox":">=0.32.0","@0xkobold/pi-ollama":">=0.2.0","@types/bun":"latest","@types/node":"^20.0.0","typescript":"^6.0.0"},"repository":{"type":"git","url":"git+https://github.com/0xKobold/pi-orchestration.git"},"bugs":{"url":"https://github.com/0xKobold/pi-orchestration/issues"},"homepage":"https://github.com/0xKobold/pi-orchestration#readme","gitHead":"231b21192f631aecba0b2a82ea9068f3dcca0121","_id":"@0xkobold/pi-orchestration@0.3.0","_nodeVersion":"25.1.0","_npmVersion":"11.6.2","dist":{"integrity":"sha512-1MVwWGQhRPlxJDzxs8btiMepVElafHse9vo9xKM5yChV3evnKubkQiNk5ZBXHixVPikdKiP/Zi+bw5JJS7idcA==","shasum":"34ad3eb869ed7c0316da7d91e2d957b8093803c0","tarball":"https://registry.npmjs.org/@0xkobold/pi-orchestration/-/pi-orchestration-0.3.0.tgz","fileCount":113,"unpackedSize":417806,"signatures":[{"keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U","sig":"MEUCIAIVO0CU2uIRsnGqAGvaqnS0dVVQfX7//7/t7ii7TsBNAiEA9G2zq7bNEXUmWoZH+TvtMZ+Q2Cq2khNsKoMp4qc+0aw="}]},"_npmUser":{"name":"moikapy","email":"warrenckhan@gmail.com"},"directories":{},"maintainers":[{"name":"moikapy","email":"warrenckhan@gmail.com"}],"_npmOperationalInternal":{"host":"s3://npm-registry-packages-npm-production","tmp":"tmp/pi-orchestration_0.3.0_1775588787140_0.9775872058515254"},"_hasShrinkwrap":false}},"time":{"created":"2026-04-06T04:10:35.387Z","modified":"2026-04-07T19:06:27.499Z","0.1.0":"2026-04-06T04:10:35.613Z","0.1.1":"2026-04-06T14:15:38.773Z","0.2.0":"2026-04-07T17:54:11.292Z","0.2.1":"2026-04-07T18:19:47.465Z","0.3.0":"2026-04-07T19:06:27.367Z"},"bugs":{"url":"https://github.com/0xKobold/pi-orchestration/issues"},"author":{"name":"0xKobold"},"license":"MIT","homepage":"https://github.com/0xKobold/pi-orchestration#readme","keywords":["pi-package","pi-extension","subagent","orchestration","multi-agent","0xkobold"],"repository":{"type":"git","url":"git+https://github.com/0xKobold/pi-orchestration.git"},"description":"Agnostic subagent orchestration for pi-coding-agent. Supports single, chain, parallel, and fork execution modes with depth limiting and worktree isolation.","maintainers":[{"name":"moikapy","email":"warrenckhan@gmail.com"}],"readme":"# pi-orchestration\n\n> Agnostic subagent orchestration for pi-coding-agent\n\nA TypeScript package for orchestrating multi-agent workflows with depth limiting, worktree isolation, and model flexibility.\n\n## Features\n\n- **Single Execution**: Spawn a single typed agent with a task\n- **Chain Execution**: Execute agents in sequence, passing output between steps\n- **Parallel Execution**: Execute multiple agents concurrently with limits\n- **Fork Execution**: Share parent's context for efficiency\n\n## Agent Types\n\n| Type | Emoji | Purpose | Depth Limit |\n|------|-------|---------|-------------|\n| `scout` | šŸ” | Fast reconnaissance | 0 |\n| `specialist` | šŸ§  | Domain expert | 1 |\n| `worker` | āš’ļø | Implementation | 1 |\n| `reviewer` | šŸ‘ļø | Quality validation | 0 |\n| `coordinator` | šŸŽÆ | Task orchestration | āˆž |\n\n## Model Flexibility\n\npi-orchestration inherits the parent agent's model registry and selects the best model for each agent type:\n\n```typescript\n// \"auto\" = use parent's ctx.modelRegistry (default)\n{ agent: \"worker\", model: \"auto\" }\n\n// Explicit model\n{ agent: \"worker\", model: \"ollama/qwen2.5-coder:14b\" }\n\n// Use parent's current model\n{ agent: \"reviewer\", model: \"inherit\" }\n```\n\n### Supported Providers\n\n- `ollama/*` - Local or cloud Ollama models\n- `claude/*` - Anthropic Claude\n- `anthropic/*` - Alias for claude/\n- Any custom provider registered via pi-coding-agent\n\n## Installation\n\n```bash\nnpm install @0xkobold/pi-orchestration\n```\n\n## Usage\n\n### Single Execution\n\n```typescript\nimport { orchestrate } from \"@0xkobold/pi-orchestration\";\n\nconst result = await orchestrate({\n agent: \"worker\",\n task: \"Implement user authentication\",\n}, ctx);\n\nconsole.log(result.content);\n```\n\n### Chain Execution\n\n```typescript\nconst result = await orchestrate({\n chain: [\n { agent: \"scout\", task: \"Analyze the codebase structure\" },\n { agent: \"planner\", task: \"Create implementation plan\" },\n { agent: \"worker\", task: \"Implement the feature\" },\n { agent: \"reviewer\", task: \"Review the changes\" },\n ],\n}, ctx);\n```\n\n### Parallel Execution\n\n```typescript\nconst result = await orchestrate({\n parallel: [\n { agent: \"scout\", task: \"Audit frontend security\" },\n { agent: \"scout\", task: \"Audit backend security\" },\n { agent: \"scout\", task: \"Audit infrastructure\" },\n ],\n}, ctx);\n```\n\n### With Options\n\n```typescript\nconst result = await orchestrate({\n agent: \"worker\",\n task: \"Refactor authentication module\",\n cwd: \"/path/to/project\",\n timeout: 60000, // 60 second timeout\n maxOutput: 5000, // 5000 character max output\n isolation: {\n type: \"worktree\",\n diffOnComplete: true,\n autoApply: false,\n },\n model: \"ollama/qwen2.5-coder:14b\",\n}, ctx);\n```\n\n## API\n\n### `orchestrate(options, ctx)`\n\nMain orchestration function.\n\n**Options:**\n- `agent` - Agent type for single execution\n- `task` - Task description\n- `chain` - Array of steps for chain execution\n- `parallel` - Array of tasks for parallel execution\n- `cwd` - Working directory\n- `timeout` - Timeout in milliseconds\n- `maxOutput` - Maximum output length\n- `isolation` - Isolation configuration\n- `model` - Model override\n- `context` - Context mode: `fresh`, `fork`, or `inherit`\n\n**Returns:** `OrchestrateResult | ChainResult | ParallelResult`\n\n### Tools\n\n- `orchestrate` - Main orchestration tool (single, chain, parallel execution)\n- `orchestrate_status` - Check engine status and pi CLI availability\n\n## Architecture\n\n```\nsrc/\nā”œā”€ā”€ core/ # Types and agent definitions\nā”œā”€ā”€ utils/ # Model selection, depth tracking, templates\nā”œā”€ā”€ modes/ # Single, chain, parallel, fork execution\nā”œā”€ā”€ execution/ # Main orchestration engine\nā””ā”€ā”€ tools/ # pi-coding-agent skill definitions\n```\n\n## License\n\nMIT\n","readmeFilename":"README.md"}