./.github/skills/rig/addons.ts |
Defines agent addons including repair (re-prompts on parse/validation failure) and steering (warns when turn limit is near); mirrors skills/rig/addons.ts for the GitHub Actions context. |
./.github/skills/rig/engines/anthropic.ts |
Implements the Anthropic engine adapter using the Anthropic SDK, translating rig tool-call protocol to Anthropic API requests and responses. |
./.github/skills/rig/engines/codex.ts |
Implements the Codex engine adapter using the OpenAI Codex SDK, enabling rig agents to run on Codex-backed models. |
./.github/skills/rig/engines/gemini.ts |
Implements the Gemini engine adapter by spawning a child process and communicating over stdio using randomized session UUIDs. |
./.github/skills/rig/engines/pi.ts |
Implements the Pi engine adapter using the Pi Agent Core SDK, exposing Pi-backed models to rig agents with typed tool support. |
./.github/skills/rig/rig.ts |
The core rig runtime: exports agent, configureAgent, copilotEngine, p, and s; manages schema validation, prompt intent resolution, sub-agent delegation, and Copilot SDK session lifecycle. |
./scripts/haiku.integration.test.ts |
Integration test that spawns the rig launcher as a child process and verifies end-to-end agent execution against the Haiku model. |
./scripts/run-sample.test.ts |
Sample runner that imports each sample agent under a stub Copilot SDK client, generates schema-conforming output, and asserts completion within 5 seconds. |
./skills/rig/addons.ts |
Source-of-truth addon module exporting repair, steering, timeout, and oncePerAgent composable agent decorators. |
./skills/rig/engines/anthropic.ts |
Source-of-truth Anthropic engine implementation; wraps the Anthropic client to provide AgentFactory-compatible sessions with tool-call round-trips. |
./skills/rig/engines/codex.ts |
Source-of-truth Codex engine implementation; exposes OpenAI Codex thread-based sessions as a rig AgentFactory. |
./skills/rig/engines/gemini.ts |
Source-of-truth Gemini engine implementation; spawns and manages a Gemini subprocess, routing tool calls via stdio JSON protocol. |
./skills/rig/engines/pi.ts |
Source-of-truth Pi engine implementation using @earendil-works/pi-agent-core; maps Pi model types and tools to the rig AgentFactory interface. |
./skills/rig/rig.ts |
Canonical rig runtime source (~2500 lines): schema helpers (s.*), prompt intent builders (p.*), agent factory, launcher CLI, Copilot engine, and all validation/repair logic. |
./src/addons.ts |
Re-export barrel for the addons module, forwarding all exports from skills/rig/addons.ts into the src/ alias path. |
./src/engines/anthropic.test.ts |
Unit tests for the Anthropic engine adapter, mocking the SDK client and verifying tool-call handling and session lifecycle. |
./src/engines/codex.test.ts |
Unit tests for the Codex engine adapter, verifying thread creation, tool-call dispatch, and response parsing. |
./src/engines/copilot.test.ts |
Unit tests for the Copilot engine, mocking @github/copilot-sdk and asserting session creation, sendAndWait calls, and disconnect behavior. |
./src/engines/gemini.test.ts |
Unit tests for the Gemini engine, using EventEmitter and PassThrough streams to simulate subprocess stdio and validate JSON protocol handling. |
./src/engines/pi.test.ts |
Unit tests for the Pi engine adapter, mocking Pi Agent Core and verifying prompt dispatch, tool execution, and abort handling. |
Global Summary
Rig is a minimal TypeScript multi-agent harness that provides declarative agent construction with typed input/output schemas, prompt intents, and pluggable engine backends (Copilot, Anthropic, Gemini, Codex, Pi). The repository includes the core runtime (
skills/rig/rig.ts), multiple engine adapters, an addon system for repair/steering/timeout, 50+ sample agents, and a comprehensive vitest test suite.Individual File Summaries
./.github/skills/rig/addons.tsskills/rig/addons.tsfor the GitHub Actions context../.github/skills/rig/engines/anthropic.ts./.github/skills/rig/engines/codex.ts./.github/skills/rig/engines/gemini.ts./.github/skills/rig/engines/pi.ts./.github/skills/rig/rig.tsagent,configureAgent,copilotEngine,p, ands; manages schema validation, prompt intent resolution, sub-agent delegation, and Copilot SDK session lifecycle../scripts/haiku.integration.test.ts./scripts/run-sample.test.ts./skills/rig/addons.tsrepair,steering,timeout, andoncePerAgentcomposable agent decorators../skills/rig/engines/anthropic.tsAgentFactory-compatible sessions with tool-call round-trips../skills/rig/engines/codex.tsAgentFactory../skills/rig/engines/gemini.ts./skills/rig/engines/pi.ts@earendil-works/pi-agent-core; maps Pi model types and tools to the rigAgentFactoryinterface../skills/rig/rig.tss.*), prompt intent builders (p.*), agent factory, launcher CLI, Copilot engine, and all validation/repair logic../src/addons.tsskills/rig/addons.tsinto thesrc/alias path../src/engines/anthropic.test.ts./src/engines/codex.test.ts./src/engines/copilot.test.ts@github/copilot-sdkand asserting session creation,sendAndWaitcalls, and disconnect behavior../src/engines/gemini.test.tsEventEmitterandPassThroughstreams to simulate subprocess stdio and validate JSON protocol handling../src/engines/pi.test.ts