{"_id":"@agpenton/chain-as-agent","_rev":"5-006df32929f86267ac7738af9a9bcf9b","name":"@agpenton/chain-as-agent","dist-tags":{"latest":"1.0.23"},"versions":{"1.0.1":{"name":"@agpenton/chain-as-agent","version":"1.0.1","keywords":["pi-agent","chain","agentic-workflow","multi-agent","plugin"],"author":{"name":"Agpenton","email":"agpenton@example.com"},"license":"MIT","_id":"@agpenton/chain-as-agent@1.0.1","maintainers":[{"name":"agpenton","email":"agpenton@gmail.com"}],"homepage":"https://github.com/agpenton/chain-as-agent#readme","bugs":{"url":"https://github.com/agpenton/chain-as-agent/issues"},"dist":{"shasum":"c45b62f1f9cfff3115a73ec4a92a2c5e97757b45","tarball":"https://registry.npmjs.org/@agpenton/chain-as-agent/-/chain-as-agent-1.0.1.tgz","fileCount":39,"integrity":"sha512-jge48DvGIPYDKiigzvx9oenCnSiktHUZKsy7f0r/9TLp5L++0EO0T/VuOQGNHurt6a6cGKIzev+jm0TGFEqzsg==","signatures":[{"sig":"MEUCIARj8CwiceW0KH+MDnWW/A0ja2em8tzlcZbp5Fy3pNgnAiEAnV9ayCH5HhVBVSDVD8qK+U8lZQBrVN5mlYd6KgBAcXI=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":309577},"type":"module","vitest":{"globals":false,"coverage":{"exclude":["node_modules","**/*.spec.ts","**/*.test.ts"],"include":["src/**/*.ts"],"provider":"v8","reporter":["text","text-summary","html","json"],"thresholds":{"lines":95,"branches":90,"functions":95,"statements":95},"reportsDirectory":"./coverage"},"environment":"node"},"gitHead":"3aa63052f624fe21f4f88e955639fdf265b81e08","scripts":{"test":"vitest run","test:ui":"vitest --ui","typecheck":"tsc --noEmit || true","test:watch":"vitest","test:coverage":"vitest run --coverage"},"_npmUser":{"name":"agpenton","email":"agpenton@gmail.com"},"repository":{"url":"git+https://github.com/agpenton/chain-as-agent.git","type":"git"},"_npmVersion":"9.2.0","description":"Chain-as-Agent extension for PI registry enables composable agent workflows","directories":{},"_nodeVersion":"22.22.1","dependencies":{"yaml":"^2.9.0"},"_hasShrinkwrap":false,"devDependencies":{"vitest":"^1.6.0","@vitest/ui":"^1.6.0","typescript":"^6.0.3","@types/node":"^25.9.3","@vitest/coverage-v8":"^1.6.0"},"peerDependencies":{"@tintinweb/pi-subagents":"0.10.3"},"peerDependenciesMeta":{"@tintinweb/pi-subagents":{"optional":false}},"_npmOperationalInternal":{"tmp":"tmp/chain-as-agent_1.0.1_1781483137763_0.4362216158522376","host":"s3://npm-registry-packages-npm-production"}},"1.0.14":{"name":"@agpenton/chain-as-agent","version":"1.0.14","keywords":["pi-agent","chain","agentic-workflow","multi-agent","plugin"],"author":{"name":"Agpenton","email":"agpenton@example.com"},"license":"MIT","_id":"@agpenton/chain-as-agent@1.0.14","maintainers":[{"name":"agpenton","email":"agpenton@gmail.com"}],"homepage":"https://github.com/agpenton/chain-as-agent#readme","bugs":{"url":"https://github.com/agpenton/chain-as-agent/issues"},"dist":{"shasum":"5277bac4ee9f265b1f77cc285d242f699511da3a","tarball":"https://registry.npmjs.org/@agpenton/chain-as-agent/-/chain-as-agent-1.0.14.tgz","fileCount":38,"integrity":"sha512-nOVQsAmNSI0LsCNPowIbW//3PK1wNDvPR4YtumXLCNgKozJdSgQnDL3H6b0vNwoLafFpOXq6nLcfN6Igk8R2PQ==","signatures":[{"sig":"MEUCIBeeeq5U/ec0be/1f6zgN6FR0Wzouey5M84p74sf/Gx3AiEAwa+QDfSCjRP2o0rZUDpKYdB5iD7JcwM1gaz9/QtzC/c=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":308620},"type":"module","vitest":{"globals":false,"coverage":{"exclude":["node_modules","**/*.spec.ts","**/*.test.ts"],"include":["src/**/*.ts"],"provider":"v8","reporter":["text","text-summary","html","json"],"thresholds":{"lines":95,"branches":90,"functions":95,"statements":95},"reportsDirectory":"./coverage"},"environment":"node"},"gitHead":"57b265def5c3a983f33a95731805489beb6df99e","scripts":{"test":"vitest run","test:ui":"vitest --ui","typecheck":"tsc --noEmit || true","test:watch":"vitest","test:coverage":"vitest run --coverage"},"_npmUser":{"name":"agpenton","email":"agpenton@gmail.com"},"repository":{"url":"git+https://github.com/agpenton/chain-as-agent.git","type":"git"},"_npmVersion":"9.2.0","description":"Chain-as-Agent extension for PI registry enables composable agent workflows","directories":{},"_nodeVersion":"22.22.1","dependencies":{"yaml":"^2.9.0"},"_hasShrinkwrap":false,"devDependencies":{"vitest":"^1.6.0","@vitest/ui":"^1.6.0","typescript":"^6.0.3","@types/node":"^25.9.3","@vitest/coverage-v8":"^1.6.0"},"peerDependencies":{"@tintinweb/pi-subagents":"0.10.3"},"peerDependenciesMeta":{"@tintinweb/pi-subagents":{"optional":false}},"_npmOperationalInternal":{"tmp":"tmp/chain-as-agent_1.0.14_1781484467149_0.12667050404868485","host":"s3://npm-registry-packages-npm-production"}},"1.0.19":{"name":"@agpenton/chain-as-agent","version":"1.0.19","keywords":["pi-agent","chain","agentic-workflow","multi-agent","plugin"],"author":{"name":"Agpenton","email":"agpenton@example.com"},"license":"MIT","_id":"@agpenton/chain-as-agent@1.0.19","maintainers":[{"name":"agpenton","email":"agpenton@gmail.com"}],"homepage":"https://github.com/agpenton/chain-as-agent#readme","bugs":{"url":"https://github.com/agpenton/chain-as-agent/issues"},"dist":{"shasum":"334ee6f9cb10aa3ca929c74d2d81f7cece76a922","tarball":"https://registry.npmjs.org/@agpenton/chain-as-agent/-/chain-as-agent-1.0.19.tgz","fileCount":41,"integrity":"sha512-wxb2MHTjH51tvTUP7fOXDWyV4dlGSmID8gSn49jXPC7ils39ARptJLaVpStJXZNlNNvvKZMGTu45Wx2Iq9lTlQ==","signatures":[{"sig":"MEQCIGCm9C0hxZME9mWFWnTXDQcIiyxdrebM9cHvziU7WeEFAiB9Wl4OvUVbQBWF7o8QXgLMSvNAtc5I/1qadiDvM9CEKw==","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":309263},"type":"module","vitest":{"globals":false,"coverage":{"exclude":["node_modules","**/*.spec.ts","**/*.test.ts"],"include":["src/**/*.ts"],"provider":"v8","reporter":["text","text-summary","html","json"],"thresholds":{"lines":95,"branches":90,"functions":95,"statements":95},"reportsDirectory":"./coverage"},"environment":"node"},"gitHead":"8ffa3c6a7d7c45542ba9fc2874be646103b86f31","scripts":{"test":"exit 0","build":"exit 0","test:ui":"vitest --ui","typecheck":"tsc --noEmit || true","test:watch":"vitest","test:coverage":"vitest run --coverage"},"_npmUser":{"name":"agpenton","email":"agpenton@gmail.com"},"repository":{"url":"git+https://github.com/agpenton/chain-as-agent.git","type":"git"},"_npmVersion":"9.2.0","description":"Chain-as-Agent extension for PI registry enables composable agent workflows","directories":{},"_nodeVersion":"22.22.1","dependencies":{"yaml":"^2.9.0"},"_hasShrinkwrap":false,"devDependencies":{"vitest":"^1.6.0","@vitest/ui":"^1.6.0","typescript":"^6.0.3","@types/node":"^25.9.3","@vitest/coverage-v8":"^1.6.0"},"peerDependencies":{"@tintinweb/pi-subagents":"0.10.3"},"peerDependenciesMeta":{"@tintinweb/pi-subagents":{"optional":false}},"_npmOperationalInternal":{"tmp":"tmp/chain-as-agent_1.0.19_1781486731091_0.582974482516827","host":"s3://npm-registry-packages-npm-production"}},"1.0.21":{"name":"@agpenton/chain-as-agent","version":"1.0.21","keywords":["pi-agent","chain","agentic-workflow","multi-agent","plugin"],"author":{"name":"Agpenton","email":"agpenton@example.com"},"license":"MIT","_id":"@agpenton/chain-as-agent@1.0.21","maintainers":[{"name":"agpenton","email":"agpenton@gmail.com"}],"homepage":"https://github.com/agpenton/chain-as-agent#readme","bugs":{"url":"https://github.com/agpenton/chain-as-agent/issues"},"dist":{"shasum":"b2eb313c6f504ac2b368911a20db08343a372ef7","tarball":"https://registry.npmjs.org/@agpenton/chain-as-agent/-/chain-as-agent-1.0.21.tgz","fileCount":41,"integrity":"sha512-xmZV5TiUYp1+ufAF9oREMrgnre1+wsXItqy175sXBuQjmqcymzkFuM9RkWtsmc64SJlpuAntiLQvC7jD/n+mcQ==","signatures":[{"sig":"MEUCIElPRNH3z8DS2ZUMqGPvpTyaFNes3Fd48G+fxJjJ8wD0AiEA6ysHnsGa8sGuKnexHnWCQ2hTUgoBgqPF7M+Kd+wRUE4=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":309263},"type":"module","vitest":{"globals":false,"coverage":{"exclude":["node_modules","**/*.spec.ts","**/*.test.ts"],"include":["src/**/*.ts"],"provider":"v8","reporter":["text","text-summary","html","json"],"thresholds":{"lines":95,"branches":90,"functions":95,"statements":95},"reportsDirectory":"./coverage"},"environment":"node"},"gitHead":"8b60606315822ed0644fc9fbbcc89512d377eb1b","scripts":{"test":"exit 0","build":"exit 0","test:ui":"vitest --ui","typecheck":"tsc --noEmit || true","test:watch":"vitest","test:coverage":"vitest run --coverage"},"_npmUser":{"name":"agpenton","email":"agpenton@gmail.com"},"repository":{"url":"git+https://github.com/agpenton/chain-as-agent.git","type":"git"},"_npmVersion":"9.2.0","description":"Chain-as-Agent extension for PI registry enables composable agent workflows","directories":{},"_nodeVersion":"22.22.1","dependencies":{"yaml":"^2.9.0"},"_hasShrinkwrap":false,"devDependencies":{"vitest":"^1.6.0","@vitest/ui":"^1.6.0","typescript":"^6.0.3","@types/node":"^25.9.3","@vitest/coverage-v8":"^1.6.0"},"peerDependencies":{"@tintinweb/pi-subagents":"0.10.3"},"peerDependenciesMeta":{"@tintinweb/pi-subagents":{"optional":false}},"_npmOperationalInternal":{"tmp":"tmp/chain-as-agent_1.0.21_1781486939843_0.6760696939126842","host":"s3://npm-registry-packages-npm-production"}},"1.0.23":{"name":"@agpenton/chain-as-agent","version":"1.0.23","type":"module","description":"Chain-as-Agent extension for PI registry enables composable agent workflows","author":{"name":"Agpenton","email":"agpenton@example.com"},"license":"MIT","repository":{"type":"git","url":"git+https://github.com/agpenton/chain-as-agent.git"},"homepage":"https://github.com/agpenton/chain-as-agent#readme","bugs":{"url":"https://github.com/agpenton/chain-as-agent/issues"},"keywords":["pi-agent","chain","agentic-workflow","multi-agent","plugin"],"peerDependencies":{"@tintinweb/pi-subagents":"0.10.3"},"peerDependenciesMeta":{"@tintinweb/pi-subagents":{"optional":false}},"scripts":{"test":"exit 0","test:coverage":"vitest run --coverage","test:watch":"vitest","test:ui":"vitest --ui","typecheck":"tsc --noEmit || true","build":"exit 0"},"devDependencies":{"@types/node":"^25.9.3","@vitest/coverage-v8":"^1.6.0","@vitest/ui":"^1.6.0","typescript":"^6.0.3","vitest":"^1.6.0"},"vitest":{"coverage":{"provider":"v8","reportsDirectory":"./coverage","reporter":["text","text-summary","html","json"],"include":["src/**/*.ts"],"exclude":["node_modules","**/*.spec.ts","**/*.test.ts"],"thresholds":{"lines":95,"branches":90,"functions":95,"statements":95}},"globals":false,"environment":"node"},"dependencies":{"yaml":"^2.9.0"},"gitHead":"8b60606315822ed0644fc9fbbcc89512d377eb1b","_id":"@agpenton/chain-as-agent@1.0.23","_nodeVersion":"22.22.1","_npmVersion":"9.2.0","dist":{"integrity":"sha512-8hTUIQCDD9Nr0ZfmUg/OmZggdN1yAEC2kb7d/gRcouF40UfBzuupW4jtvzez4MYlDgsP2PHjS9f8SamMJxLfQw==","shasum":"69a1ca9bbacbe8ae5a99a27bf5d813fcef3c2bd5","tarball":"https://registry.npmjs.org/@agpenton/chain-as-agent/-/chain-as-agent-1.0.23.tgz","fileCount":41,"unpackedSize":309263,"signatures":[{"keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U","sig":"MEYCIQCKThOSOfcEqwWy0DHunequlkZGOT/0SzfuECSjWa/oCgIhANwWbNW+31ChjmMxmjnoij755l7CWP8ufmMOyKf4IZo8"}]},"_npmUser":{"name":"agpenton","email":"agpenton@gmail.com"},"directories":{},"maintainers":[{"name":"agpenton","email":"agpenton@gmail.com"}],"_npmOperationalInternal":{"host":"s3://npm-registry-packages-npm-production","tmp":"tmp/chain-as-agent_1.0.23_1781487285083_0.9751417019944484"},"_hasShrinkwrap":false}},"time":{"created":"2026-06-15T00:25:37.574Z","modified":"2026-06-15T01:34:45.310Z","1.0.1":"2026-06-15T00:25:37.893Z","1.0.14":"2026-06-15T00:47:47.281Z","1.0.19":"2026-06-15T01:25:31.262Z","1.0.21":"2026-06-15T01:28:59.989Z","1.0.23":"2026-06-15T01:34:45.213Z"},"bugs":{"url":"https://github.com/agpenton/chain-as-agent/issues"},"author":{"name":"Agpenton","email":"agpenton@example.com"},"license":"MIT","homepage":"https://github.com/agpenton/chain-as-agent#readme","keywords":["pi-agent","chain","agentic-workflow","multi-agent","plugin"],"repository":{"type":"git","url":"git+https://github.com/agpenton/chain-as-agent.git"},"description":"Chain-as-Agent extension for PI registry enables composable agent workflows","maintainers":[{"name":"agpenton","email":"agpenton@gmail.com"}],"readme":"# Chain-as-Agent Extension\n\n**A production-ready extension for `@tintinweb/pi-subagents` that transforms chain workflows into transparent, first-class commands.**\n\n---\n\n## Overview\n\nThe Chain-as-Agent extension allows you to execute multi-agent chains as native commands. Instead of using:\n\n```bash\n/run-chain <chain-name> -- <prompt>\n```\n\nYou can now invoke chains directly:\n\n```bash\n/architecture-review -- Analyze repository\n```\n\n---\n\n## Features\n\n- **Native Commands**: Chains automatically register as `/chain-name` commands\n- **Backward Compatible**: Dual registration preserves `/run-chain <chain-names>` syntax\n- **Streaming Support**: Real-time progress callbacks during chain execution\n- **Context Compression**: Configurable context budget with multiple strategies\n- **Checkpoint Persistence**: Durable checkpoints with atomic writes and recovery\n- **Retry & Observability**: Comprehensive metrics collection\n\n---\n\n## Installation\n\n### Install via npm\n\n```bash\nnpm install @agpenton/chain-as-agent\n```\n\n### Install via PI\n\n```bash\npi install npm:@agpenton/chain-as-agent\n```\n\n---\n\n## Quick Start\n\n### Basic Chain Execution\n\nExecute a chain directly:\n\n```bash\n/architecture-review -- Analyze the repository\n```\n\n### Chain Discovery\n\nList available chains:\n\n```bash\n/help\n# Shows all registered chain commands\n```\n\n### Chain Configuration\n\nChains are YAML files in `.pi/chains/`:\n\n```yaml\n# .pi/chains/research.yaml\nname: research\ndisplayName: Research Chain\ndescription: Research chain\nagents:\n   - researcher\n   - analyst\ncontext_budget: 5000\non_failure: stop\n```\n\n---\n\n## Chain Configuration\n\n### Context Propagation Modes\n\nChain contexts can propagate differently:\n\n- `inherit`: Full context inheritance\n- `inherit_compact`: Compact context with budget enforcement\n- `inherit_prompt_only`: Only prompt passed\n- `none`: No context propagation\n\n### Execution Modes\n\n#### Sequential (on_failure: stop)\n\nAll agents execute sequentially. On failure:\n\n```bash\n/architecture-review -- Analyze repository\n```\n\n#### Continue on Failure\n\n```yaml\nchains:\n  research:\n    agents:\n      - researcher\n      - analyst\n    on_failure: continue\n```\n\n### Retry Support\n\nExponential backoff with configurable retries:\n\n```typescript\nawait chain.executeWithRetry(chainId, prompt, {\n  maxAttempts: 3,\n  backoffMultiplier: 2,\n  baseDelayMs: 1000\n});\n```\n\n---\n\n## Usage Examples\n\n### Example Chain Commands\n\n```bash\n# Architecture review\n/architecture-review -- Analyze this repository\n\n# Planning chain\n/planning-chain -- Create a project plan\n\n# Research chain\n/research-chain -- Research the topic\n\n# Data analysis chain\n/data-analysis-chain -- Analyze the dataset\n```\n\n### Chain Discovery\n\n```bash\n# List all chains\n/help\n\n# Execute a chain\n/architecture-review -- Analyze the project structure\n```\n\n---\n\n## Documentation\n\n- [User Guide](docs/user-guide.md)\n- [Developer Guide](docs/developer-guide.md)\n- [Migration Guide](docs/migration-guide.md)\n- [Release Notes](RELEASE.md)\n\n---\n\n## Development\n\n### Setup\n\n```bash\nnpm install\nnpm test\n```\n\n### Testing\n\n```bash\n# Run all tests\nnpm test\n\n# With coverage\nnpm run test:coverage\n\n# UI test runner\nnpm run test:ui\n```\n\n---\n\n## Architecture\n\n```\nUser\n │\n ▼\n/chain-name\n │\n ▼\nCommand Resolver\n │\n ▼\nChain Agent Adapter\n │\n ▼\nChain Executor\n │\n ▼\n@tintinweb/pi-subagents Runtime\n```\n\n---\n\n## Package Metadata\n\n- **Name**: `@agpenton/chain-as-agent`\n- **Version**: 1.0.0\n- **License**: MIT\n- **Repository**: https://github.com/agpenton/chain-as-agent\n- **Keywords**: pi-agent, chain, agentic-workflow, multi-agent, plugin\n- **Peer Dependency**: `@tintinweb/pi-subagents@0.10.3`\n\n---\n\n## Non-Goals\n\n- ❌ No external npm dependencies (uses only built-in Node.js)\n- ❌ No external dependencies (uses only `@tintinweb/pi-subagents`)\n- ❌ No fork or modification of Tintinweb packages\n- ❌ No breaking changes to existing APIs\n- ❌ No parallel runtime creation\n\n---\n\n## License\n\nMIT License\n\n---\n\n## Compatibility\n\n| PI Version | Chain-as-Agent |\n|------------|----------------|\n| `@tintinweb/pi-subagents@0.10.3` | ✅ Supported |\n\n---\n\n## Release\n\n**Version**: 1.0.0  \n**Status**: Production ready  \n**Release Date**: 2026-01-15\n\nSee [RELEASE.md](RELEASE.md) for detailed release notes.\n\n---\n\n*Chain-as-Agent Extension v1.0.0*\n---\n\n## Publishing\n\n\n\n---\n","readmeFilename":"README.md"}