[rig-summarizer] Daily file summary — 2026-07-31

[github-actions]

Global Summary

Rig is a minimal TypeScript multi-agent harness that provides typed input/output schemas, declarative prompt intents, sub-agent delegation, and composable agent construction. It supports multiple engine backends including Copilot SDK, Anthropic Claude, OpenAI Codex, Gemini CLI, and Pi agent runtime, each adapting Rig's generic agent interface to their respective SDKs. The project includes a sample library, integration tests, and unit tests covering engine initialization, tool execution, and end-to-end agent workflows.

Individual File Summaries

File	Summary
./.agents/skills/rig/engines/anthropic.ts	Implements an Anthropic Claude engine adapter for the Rig agent framework, providing a factory function that creates agents capable of invoking tools via Anthropic's beta messages API with support for configurable token limits and iteration counts. Handles message history management, tool execution, and response text extraction.
./.agents/skills/rig/engines/codex.ts	Implements a Codex engine adapter for the Rig agent framework, providing an AgentFactory that wraps OpenAI's Codex SDK with support for prompts, structured output schemas, and graceful shutdown via AbortSignal. It does not support Rig tools and requires system messages to be strings.
./.agents/skills/rig/engines/gemini.ts	Implements a Gemini engine factory that spawns a Gemini CLI subprocess to handle agent interactions, managing session state, prompt construction, and output parsing with support for approval modes and error handling.
./.agents/skills/rig/engines/pi.ts	Implements a Rig engine adapter for the pi-agent-core library, providing agent factory creation, prompt handling, and tool execution bridging. Converts Rig's tool schema and agent lifecycle to pi-agent's interface with built-in debugging and abort signal support.
./.agents/skills/rig/engines/utils.ts	Utility functions for tool schema validation and result formatting: objectToolSchema extracts and validates object-type parameters from tools, while toolResultText converts tool results to strings for prompt inclusion.
./.agents/skills/rig/rig.ts	Minimal TypeScript multi-agent harness providing typed input/output schemas, declarative prompt intents, sub-agent delegation, and Copilot SDK runtime integration for building orchestrated agent workflows. Core types include Agent, AgentSpec, AgentAddon, Schema validators, PromptIntent primitives, and Tool abstractions for composable agent construction.
./scripts/haiku.integration.test.ts	Integration test suite that spawns rig runtime samples with real Copilot SDK connections to verify end-to-end agent execution for haiku and sonnet generation tasks. Tests require COPILOT_GITHUB_TOKEN or COPILOT_SDK_URI environment variables to run.
./scripts/run-sample.test.ts	A vitest test suite that runs Rig sample agents with a mocked Copilot SDK client, generating shape-conforming stub output by parsing output schemas from prompts to validate agent behavior.
./skills/rig/engines/anthropic.ts	Implements an Anthropic-based agent engine that wraps the Anthropic SDK client, handling tool invocation, message history, and text response extraction for the Rig agent framework.
./skills/rig/engines/codex.ts	Exports a codexEngine factory that creates agents powered by OpenAI's Codex SDK, handling prompt execution, output schema validation, and lifecycle management with abort signal support.
./skills/rig/engines/gemini.ts	Implements a Gemini engine adapter for the Rig agent harness that spawns a Gemini CLI process to handle agent prompts, managing session state and supporting approval modes. It handles concurrent turn prevention, signal-based cancellation, and error handling while maintaining a persistent session across multiple turns.
./skills/rig/engines/pi.ts	Implements a Rig agent factory for the Pi agent runtime, providing model resolution, tool marshaling, and prompt execution with abort signal support. Converts Rig's generic Tool interface to Pi's tool schema and manages agent lifecycle through streaming and state management.
./skills/rig/engines/utils.ts	Utility module providing helper functions for tool schema validation and result serialization: objectToolSchema ensures tool parameters conform to object schema format, and toolResultText converts tool results to string representation.
./skills/rig/rig.ts	Minimal TypeScript multi-agent harness providing typed input/output schemas, prompt intents, sub-agent delegation, and Copilot SDK runtime integration with comprehensive type definitions for agent construction, validation, and orchestration.
./src/engines/anthropic.test.ts	Unit tests for the Anthropic engine integration that verify tool runner creation, conversation state preservation, Rig-to-Anthropic tool mapping, and error handling. Tests use vitest mocks to stub the Anthropic SDK and validate the engine's lifecycle and tool execution behavior.
./src/engines/codex.test.ts	Unit tests for the Codex engine adapter that verify thread creation, conversation preservation, configuration handling, and output schema forwarding to the Codex SDK. Tests confirm proper initialization, signal handling, and structured response stringification.
./src/engines/copilot.test.ts	Unit tests for the Copilot engine initialization and SDK integration, verifying default URI connections, environment variable overrides, client options preservation, and session creation behavior with mocked Copilot SDK components.
./src/engines/gemini.test.ts	Unit tests for the Gemini engine that verify session creation, resumption, and CLI argument forwarding by mocking the child process spawn and UUID generation. Tests validate that the engine correctly constructs Gemini CLI commands with model, prompt, and session parameters.
./src/engines/pi.test.ts	Unit tests for the piEngine runtime adapter, verifying that it correctly initializes a pi-agent with models, system prompts, and tools; handles agent closure with abort and idle-wait; and propagates provider errors. Tests mock the @earendil-works/pi-agent-core Agent class and validate tool execution, prompt handling, and error propagation.
./src/launcher-default-engine.test.ts	Unit test suite that mocks the Copilot SDK, Anthropic SDK, and Codex SDK to verify that the default Rig launcher correctly mounts and initializes the default copilot engine with the proper working directory and environment configuration.

Generated by Daily Rig File Summarizer · sonnet46 307.2 AIC · ⌖ 5.54 AIC · ⊞ 4.3K · ◷

• expires on Aug 7, 2026, 6:10 AM UTC