agentsys 5.1.0 → 5.2.1

package/plugins/consult/skills/consult/SKILL.md

@@ -1,312 +0,0 @@
----
-name: consult
-description: "Cross-tool AI consultation. Use when user asks to 'consult gemini', 'ask codex', 'get second opinion', 'cross-check with claude', 'consult another AI', 'ask opencode', 'copilot opinion', or wants a second opinion from a different AI tool."
-version: 5.1.0
-argument-hint: "[question] [--tool] [--effort] [--model] [--context] [--continue]"
----
-
-# consult
-
-Cross-tool AI consultation: query another AI CLI tool and return the response.
-
-## When to Use
-
-Invoke this skill when:
-- User wants a second opinion from a different AI tool
-- User asks to consult, ask, or cross-check with gemini/codex/claude/opencode/copilot
-- User needs to compare responses across AI tools
-- User wants to validate a decision with an external AI
-
-## Arguments
-
-Parse from `$ARGUMENTS`:
-
-| Flag | Values | Default | Description |
-|------|--------|---------|-------------|
-| `--tool` | gemini, codex, claude, opencode, copilot | (picker) | Target tool |
-| `--effort` | low, medium, high, max | medium | Thinking effort level |
-| `--model` | any model name | (from effort) | Override model selection |
-| `--context` | diff, file=PATH, none | none | Auto-include context |
-| `--continue` | (flag) or SESSION_ID | false | Resume previous session |
-
-Question text is everything in `$ARGUMENTS` except the flags above.
-
-## Provider Configurations
-
-### Claude
-
-```
-Command: claude -p "QUESTION" --output-format json --model "MODEL" --max-turns TURNS --allowedTools "Read,Glob,Grep"
-Session resume: --resume "SESSION_ID"
-```
-
-Models: haiku, sonnet, opus
-
-| Effort | Model | Max Turns |
-|--------|-------|-----------|
-| low | haiku | 1 |
-| medium | sonnet | 3 |
-| high | opus | 5 |
-| max | opus | 10 |
-
-**Parse output**: `JSON.parse(stdout).result`
-**Session ID**: `JSON.parse(stdout).session_id`
-**Continuable**: Yes
-
-### Gemini
-
-```
-Command: gemini -p "QUESTION" --output-format json -m "MODEL"
-Session resume: --resume "SESSION_ID"
-```
-
-Models: gemini-2.5-flash, gemini-2.5-pro, gemini-3-flash, gemini-3-pro
-
-| Effort | Model |
-|--------|-------|
-| low | gemini-2.5-flash |
-| medium | gemini-3-flash |
-| high | gemini-3-pro |
-| max | gemini-3-pro |
-
-**Parse output**: `JSON.parse(stdout).response`
-**Session ID**: `JSON.parse(stdout).session_id`
-**Continuable**: Yes (via `--resume`)
-
-### Codex
-
-```
-Command: codex exec "QUESTION" --json -m "MODEL" -c model_reasoning_effort="LEVEL"
-Session resume: codex exec resume SESSION_ID "QUESTION" --json
-Session resume (latest): codex exec resume --last "QUESTION" --json
-```
-
-Note: `codex exec` is the non-interactive/headless mode. There is no `-q` flag. The TUI mode is `codex` (no subcommand).
-
-Models: gpt-5.3-codex-spark, gpt-5-codex, gpt-5.1-codex, gpt-5.2-codex, gpt-5.3-codex, gpt-5.1-codex-max
-
-| Effort | Model | Reasoning |
-|--------|-------|-----------|
-| low | gpt-5.3-codex-spark | low |
-| medium | gpt-5.2-codex | medium |
-| high | gpt-5.3-codex | high |
-| max | gpt-5.3-codex | xhigh |
-
-**Parse output**: `JSON.parse(stdout).message` or raw text
-**Session ID**: Codex prints a resume hint at session end (e.g., `codex resume SESSION_ID`). Extract the session ID from stdout or from `JSON.parse(stdout).session_id` if available.
-**Continuable**: Yes. Sessions are stored as JSONL rollout files at `~/.codex/sessions/`. Non-interactive resume uses `codex exec resume SESSION_ID "follow-up prompt" --json`. Use `--last` instead of a session ID to resume the most recent session.
-
-### OpenCode
-
-```
-Command: opencode run "QUESTION" --format json --model "MODEL" --variant "VARIANT"
-Session resume: opencode run "QUESTION" --format json --model "MODEL" --variant "VARIANT" --continue (most recent) or --session "SESSION_ID"
-With thinking: add --thinking flag
-```
-
-Models: 75+ via providers (format: provider/model). Top picks: claude-sonnet-4-5, claude-opus-4-5, gpt-5.2, gpt-5.1-codex, gemini-3-pro, minimax-m2.1
-
-| Effort | Model | Variant |
-|--------|-------|---------|
-| low | (user-selected or default) | low |
-| medium | (user-selected or default) | medium |
-| high | (user-selected or default) | high |
-| max | (user-selected or default) | high + --thinking |
-
-**Parse output**: Parse JSON events from stdout, extract final text response
-**Session ID**: Extract from JSON output if available, or use `--continue` to auto-resume the most recent session.
-**Continuable**: Yes (via `--continue` or `--session`). Sessions are stored in a SQLite database in the OpenCode data directory. Use `--session SESSION_ID` for a specific session, or `--continue` for the most recent.
-
-### Copilot
-
-```
-Command: copilot -p "QUESTION"
-```
-
-Models: claude-sonnet-4-5 (default), claude-opus-4-6, claude-haiku-4-5, claude-sonnet-4, gpt-5
-
-| Effort | Notes |
-|--------|-------|
-| all | No effort control available. Model selectable via --model flag. |
-
-**Parse output**: Raw text from stdout
-**Continuable**: No
-
-## Input Validation
-
-Before building commands, validate all user-provided arguments:
-
-- **--tool**: MUST be one of: gemini, codex, claude, opencode, copilot. Reject all other values.
-- **--effort**: MUST be one of: low, medium, high, max. Default to medium.
-- **--model**: Allow any string, but quote it in the command.
-- **--context=file=PATH**: MUST resolve within the project directory. Reject absolute paths outside cwd. Additional checks:
-  1. **Block UNC paths** (Windows): Reject paths starting with `\\` or `//` (network shares)
-  2. **Resolve canonical path**: Use the Read tool to read the file (do NOT use shell commands). Before reading, resolve the path: join `cwd + PATH`, then normalize (collapse `.`, `..`, resolve symlinks)
-  3. **Verify containment**: The resolved canonical path MUST start with the current working directory. If it escapes (via `..`, symlinks, or junction points), reject with: `[ERROR] Path escapes project directory: {PATH}`
-  4. **No shell access**: Read file content using the Read tool only. Never pass user-provided paths to shell commands (prevents injection via path values)
-
-## Command Building
-
-Given the parsed arguments, build the complete CLI command. All user-provided values MUST be quoted in the shell command to prevent injection.
-
-### Step 1: Resolve Model
-
-If `--model` is specified, use it directly. Otherwise, use the effort-based model from the provider table above.
-
-### Step 2: Build Command String
-
-Use the command template from the provider's configuration section. Substitute QUESTION, MODEL, TURNS, LEVEL, and VARIANT with resolved values.
-
-If continuing a session:
-- **Claude or Gemini**: append `--resume SESSION_ID` to the command.
-- **Codex**: use `codex exec resume SESSION_ID "QUESTION" --json` instead of the standard command. Use `--last` instead of a session ID for the most recent session.
-- **OpenCode**: append `--session SESSION_ID` to the command. If no session_id is saved, use `--continue` instead (resumes most recent session).
-If OpenCode at max effort: append `--thinking`.
-
-### Step 3: Context Packaging
-
-If `--context=diff`: Run `git diff 2>/dev/null` and prepend output to the question.
-If `--context=file=PATH`: Read the file using the Read tool and prepend its content to the question.
-
-### Step 4: Safe Question Passing
-
-User-provided question text MUST NOT be interpolated into shell command strings. Shell escaping is insufficient -- `$()`, backticks, and other expansion sequences can execute arbitrary commands even inside double quotes.
-
-**Required approach -- pass question via stdin or temp file:**
-
-1. **Write the question** to a temporary file using the Write tool (e.g., `{AI_STATE_DIR}/consult/question.tmp`)
-
-   Platform state directory:
-   - Claude Code: `.claude/`
-   - OpenCode: `.opencode/`
-   - Codex CLI: `.codex/`
-2. **Build the command** using the temp file as input instead of inline text:
-
-| Provider | Safe command pattern |
-|----------|---------------------|
-| Claude | `claude -p - --output-format json --model "MODEL" --max-turns TURNS --allowedTools "Read,Glob,Grep" < "{AI_STATE_DIR}/consult/question.tmp"` |
-| Claude (resume) | `claude -p - --output-format json --model "MODEL" --max-turns TURNS --allowedTools "Read,Glob,Grep" --resume "SESSION_ID" < "{AI_STATE_DIR}/consult/question.tmp"` |
-| Gemini | `gemini -p - --output-format json -m "MODEL" < "{AI_STATE_DIR}/consult/question.tmp"` |
-| Gemini (resume) | `gemini -p - --output-format json -m "MODEL" --resume "SESSION_ID" < "{AI_STATE_DIR}/consult/question.tmp"` |
-| Codex | `codex exec "$(cat "{AI_STATE_DIR}/consult/question.tmp")" --json -m "MODEL" -c model_reasoning_effort="LEVEL"` (Codex exec lacks stdin mode -- cat reads from platform-controlled path, not user input) |
-| Codex (resume) | `codex exec resume SESSION_ID "$(cat "{AI_STATE_DIR}/consult/question.tmp")" --json -m "MODEL"` |
-| Codex (resume latest) | `codex exec resume --last "$(cat "{AI_STATE_DIR}/consult/question.tmp")" --json -m "MODEL"` |
-| OpenCode | `opencode run - --format json --model "MODEL" --variant "VARIANT" < "{AI_STATE_DIR}/consult/question.tmp"` |
-| OpenCode (resume by ID) | `opencode run - --format json --model "MODEL" --variant "VARIANT" --session "SESSION_ID" < "{AI_STATE_DIR}/consult/question.tmp"` |
-| OpenCode (resume latest) | `opencode run - --format json --model "MODEL" --variant "VARIANT" --continue < "{AI_STATE_DIR}/consult/question.tmp"` |
-| Copilot | `copilot -p - < "{AI_STATE_DIR}/consult/question.tmp"` |
-
-3. **Delete the temp file** after the command completes (success or failure). Always clean up to prevent accumulation.
-
-**Model and session ID values** are controlled strings (from pickers or saved state) and safe to quote directly in the command. Only the question contains arbitrary user text and requires the temp file approach. The temp file path (`{AI_STATE_DIR}/consult/question.tmp`) uses a platform-controlled directory and fixed filename -- no user input in the path.
-
-## Provider Detection
-
-Cross-platform tool detection:
-
-- **Windows**: `where.exe TOOL 2>nul` -- returns 0 if found
-- **Unix**: `which TOOL 2>/dev/null` -- returns 0 if found
-
-Check each tool (claude, gemini, codex, opencode, copilot) and return only the available ones.
-
-## Session Management
-
-### Save Session
-
-After successful consultation, save to `{AI_STATE_DIR}/consult/last-session.json`:
-
-```json
-{
-  "tool": "claude",
-  "model": "opus",
-  "effort": "high",
-  "session_id": "abc-123-def-456",
-  "timestamp": "2026-02-10T12:00:00Z",
-  "question": "original question text",
-  "continuable": true
-}
-```
-
-`AI_STATE_DIR` uses the platform state directory:
-- Claude Code: `.claude/`
-- OpenCode: `.opencode/`
-- Codex CLI: `.codex/`
-
-### Load Session
-
-For `--continue`, read the session file and restore:
-- tool (from saved state)
-- session_id (for --resume flag)
-- model (reuse same model)
-
-If session file not found, warn and proceed as fresh consultation.
-
-## Output Sanitization
-
-Before including any consulted tool's response in the output, scan the response text and redact matches for these patterns:
-
-| Pattern | Description | Replacement |
-|---------|-------------|-------------|
-| `sk-[a-zA-Z0-9_-]{20,}` | Anthropic API keys | `[REDACTED_API_KEY]` |
-| `sk-proj-[a-zA-Z0-9_-]{20,}` | OpenAI project keys | `[REDACTED_API_KEY]` |
-| `sk-ant-[a-zA-Z0-9_-]{20,}` | Anthropic API keys (ant prefix) | `[REDACTED_API_KEY]` |
-| `AIza[a-zA-Z0-9_-]{30,}` | Google API keys | `[REDACTED_API_KEY]` |
-| `ghp_[a-zA-Z0-9]{36,}` | GitHub personal access tokens | `[REDACTED_TOKEN]` |
-| `gho_[a-zA-Z0-9]{36,}` | GitHub OAuth tokens | `[REDACTED_TOKEN]` |
-| `github_pat_[a-zA-Z0-9_]{20,}` | GitHub fine-grained PATs | `[REDACTED_TOKEN]` |
-| `ANTHROPIC_API_KEY=[^\s]+` | Key assignment in env output | `ANTHROPIC_API_KEY=[REDACTED]` |
-| `OPENAI_API_KEY=[^\s]+` | Key assignment in env output | `OPENAI_API_KEY=[REDACTED]` |
-| `GOOGLE_API_KEY=[^\s]+` | Key assignment in env output | `GOOGLE_API_KEY=[REDACTED]` |
-| `GEMINI_API_KEY=[^\s]+` | Key assignment in env output | `GEMINI_API_KEY=[REDACTED]` |
-| `AKIA[A-Z0-9]{16}` | AWS access keys | `[REDACTED_AWS_KEY]` |
-| `ASIA[A-Z0-9]{16}` | AWS session tokens | `[REDACTED_AWS_KEY]` |
-| `Bearer [a-zA-Z0-9_-]{20,}` | Authorization headers | `Bearer [REDACTED]` |
-
-Apply redaction to the full response text before inserting into the result JSON. If any redaction occurs, append a note: `[WARN] Sensitive tokens were redacted from the response.`
-
-## Output Format
-
-Return a plain JSON object to stdout (no markers or wrappers):
-
-```json
-{
-  "tool": "gemini",
-  "model": "gemini-3-pro",
-  "effort": "high",
-  "duration_ms": 12300,
-  "response": "The AI's response text here...",
-  "session_id": "abc-123",
-  "continuable": true
-}
-```
-
-## Install Instructions
-
-When a tool is not found, return these install commands:
-
-| Tool | Install |
-|------|---------|
-| Claude | `npm install -g @anthropic-ai/claude-code` |
-| Gemini | See https://gemini.google.com/cli for install instructions |
-| Codex | `npm install -g @openai/codex` |
-| OpenCode | `npm install -g opencode-ai` or `brew install anomalyco/tap/opencode` |
-| Copilot | `gh extension install github/copilot-cli` |
-
-## Error Handling
-
-| Error | Response |
-|-------|----------|
-| Tool not installed | Return install instructions from table above |
-| Tool execution timeout | Return `"response": "Timeout after 120s"` |
-| JSON parse error | Return raw text as response |
-| Empty output | Return `"response": "No output received"` |
-| Session file missing | Proceed without session resume |
-| API key missing | Return tool-specific env var instructions |
-
-## Integration
-
-This skill is invoked by:
-- `consult-agent` for `/consult` command
-- Direct invocation: `Skill('consult', '"question" --tool=gemini --effort=high')`
-
-Example: `Skill('consult', '"Is this approach correct?" --tool=gemini --effort=high --model=gemini-3-pro')`

package/plugins/debate/.claude-plugin/plugin.json

@@ -1,21 +0,0 @@
-{
-  "name": "debate",
-  "version": "5.1.0",
-  "description": "Structured multi-round debate between AI tools with proposer/challenger roles and verdict",
-  "author": {
-    "name": "Avi Fenesh",
-    "email": "[email protected]",
-    "url": "https://github.com/avifenesh"
-  },
-  "homepage": "https://github.com/avifenesh/agentsys#debate",
-  "repository": "https://github.com/avifenesh/agentsys",
-  "license": "MIT",
-  "keywords": [
-    "debate",
-    "dialectic",
-    "cross-tool",
-    "multi-model",
-    "adversarial",
-    "second-opinion"
-  ]
-}

package/plugins/debate/agents/debate-orchestrator.md

@@ -1,175 +0,0 @@
----
-name: debate-orchestrator
-description: "Orchestrate multi-round debates between AI tools. Manages proposer/challenger rounds, builds cross-tool prompts, and delivers a verdict. Use when the /debate command dispatches a structured debate."
-tools:
-  - Skill
-  - Bash(claude:*)
-  - Bash(gemini:*)
-  - Bash(codex:*)
-  - Bash(opencode:*)
-  - Bash(copilot:*)
-  - Bash(git:*)
-  - Bash(where.exe:*)
-  - Bash(which:*)
-  - Read
-  - Write
-model: opus
----
-
-# Debate Orchestrator
-
-## Role
-
-You are the judge and orchestrator of a structured debate between two AI tools. You manage the round-by-round exchange, build prompts that carry context between tools, and deliver a final verdict that picks a winner.
-
-You are spawned by the /debate command with all parameters pre-resolved.
-
-## Why Opus Model
-
-This is the most judgment-intensive agent in agentsys. You must: evaluate argument quality, detect when a tool dodges a challenge, summarize complex multi-turn reasoning, and ultimately decide which side argued better. This requires deep reasoning.
-
-## Workflow
-
-### 1. Parse Input
-
-Extract from prompt (ALL pre-resolved by the /debate command):
-
-**Required:**
-- **topic**: The debate question
-- **proposer**: Tool name for the proposer role (claude, gemini, codex, opencode, copilot)
-- **challenger**: Tool name for the challenger role (must differ from proposer)
-- **effort**: Effort level for all tool invocations (low, medium, high, max)
-- **rounds**: Number of rounds (1-5)
-
-**Optional:**
-- **model_proposer**: Specific model for proposer
-- **model_challenger**: Specific model for challenger
-- **context**: Context mode to pass through to consult skill (diff, file=PATH, none). Default: none. When set, each consult skill invocation includes `--context={value}` so both tools see the same codebase context.
-
-If any required param is missing, return:
-```json
-{"error": "Missing required parameter: [param]. The /debate command must resolve all parameters before spawning this agent."}
-```
-
-### 2. Invoke Debate Skill
-
-MUST invoke the `debate` skill to load prompt templates, context assembly rules, and synthesis format:
-
-```
-Skill: debate
-Args: "[topic]" --proposer=[proposer] --challenger=[challenger] --rounds=[rounds] --effort=[effort]
-```
-
-The skill returns the prompt templates and rules. Use them for all subsequent steps.
-
-### 3. Execute Debate Rounds
-
-For each round (1 through N):
-
-#### 3a. Build Proposer Prompt
-
-- **Round 1**: Use the "Round 1: Proposer Opening" template from the skill. Substitute {topic}.
-- **Round 2+**: Use the "Round 2+: Proposer Defense" template. Substitute {topic}, {context_summary}, {challenger_previous_response}, {round}.
-
-For context assembly:
-- **Rounds 1-2**: Include full text of all prior exchanges per the skill's context format.
-- **Round 3+**: Summarize rounds 1 through N-2 yourself (you have the full exchange history). Include only the most recent round's responses in full.
-
-#### 3b. Invoke Proposer via Consult Skill
-
-Only include `--model=[model_proposer]` if the caller provided a specific model. If model is "omit", empty, or "auto", do NOT pass --model to the consult skill.
-
-```
-Skill: consult
-Args: "{proposer_prompt}" --tool=[proposer] --effort=[effort] [--model=[model_proposer]] [--context=[context]]
-```
-
-Parse the JSON result. Extract the response text. Record: round, role="proposer", tool, response, duration_ms.
-
-Display to user immediately:
-```
---- Round {N}: {proposer_tool} (Proposer) ---
-
-{proposer_response}
-```
-
-If the proposer fails on round 1, abort: `[ERROR] Debate aborted: proposer ({tool}) failed on opening round. {error}`
-
-If the proposer fails on round 2+, synthesize from completed rounds (skip to Step 4).
-
-#### 3c. Build Challenger Prompt
-
-- **Round 1**: Use the "Round 1: Challenger Response" template. Substitute {topic}, {proposer_tool}, {proposer_round1_response}.
-- **Round 2+**: Use the "Round 2+: Challenger Follow-up" template. Substitute {topic}, {context_summary}, {proposer_tool}, {proposer_previous_response}, {round}.
-
-#### 3d. Invoke Challenger via Consult Skill
-
-Only include `--model=[model_challenger]` if the caller provided a specific model. If model is "omit", empty, or "auto", do NOT pass --model to the consult skill.
-
-```
-Skill: consult
-Args: "{challenger_prompt}" --tool=[challenger] --effort=[effort] [--model=[model_challenger]] [--context=[context]]
-```
-
-Parse the JSON result. Record: round, role="challenger", tool, response, duration_ms.
-
-Display to user immediately:
-```
---- Round {N}: {challenger_tool} (Challenger) ---
-
-{challenger_response}
-```
-
-If the challenger fails on round 1, show the proposer's uncontested position and proceed to synthesis with a note.
-
-If the challenger fails on round 2+, synthesize from completed rounds.
-
-### 4. Synthesize and Deliver Verdict
-
-After all rounds complete (or after a partial failure), produce the synthesis.
-
-You are the JUDGE. Read all exchanges carefully. Use the synthesis format from the debate skill. Your verdict:
-
-1. **Pick a winner.** Which tool made the stronger argument overall? Why? Cite specific exchanges.
-2. **List agreements.** What did both tools agree on?
-3. **List disagreements.** Where do they still diverge? What's each side's position?
-4. **List unresolved questions.** What did neither side address adequately?
-5. **Make a recommendation.** What should the user DO? Be specific and actionable.
-
-**Verdict rules (from the debate skill):**
-- You MUST pick a side. "Both approaches have merit" is NOT acceptable.
-- Cite specific arguments from the debate as evidence.
-- The recommendation must be actionable.
-- Be honest about what wasn't resolved.
-
-Display the full synthesis using the format from the debate skill's Synthesis Format section.
-
-### 5. Save State
-
-Write the debate state to `{AI_STATE_DIR}/debate/last-debate.json` using the schema from the debate skill.
-
-Platform state directory:
-- Claude Code: `.claude/`
-- OpenCode: `.opencode/`
-- Codex CLI: `.codex/`
-
-Create the `debate/` subdirectory if it doesn't exist.
-
-## Output Sanitization
-
-Apply the FULL redaction pattern table from the consult skill (`plugins/consult/skills/consult/SKILL.md`, Output Sanitization section). The skill is the canonical source with all 14 patterns. Do NOT maintain a separate subset here.
-
-The consult skill's table covers: Anthropic keys (`sk-*`, `sk-ant-*`, `sk-proj-*`), Google keys (`AIza*`), GitHub tokens (`ghp_*`, `gho_*`, `github_pat_*`), AWS keys (`AKIA*`, `ASIA*`), env assignments (`ANTHROPIC_API_KEY=*`, `OPENAI_API_KEY=*`, `GOOGLE_API_KEY=*`, `GEMINI_API_KEY=*`), and auth headers (`Bearer *`).
-
-Read the consult skill file to get the exact patterns and replacements.
-
-## Critical Constraints
-
-- NEVER expose API keys in commands or output
-- NEVER run with permission-bypassing flags
-- MUST invoke the debate skill before starting rounds (for templates)
-- MUST invoke the consult skill for each tool call (for provider configs)
-- MUST set 120s timeout on each Bash execution
-- MUST display each round progressively as it completes
-- MUST pick a winner in the verdict - no diplomatic non-answers
-- MUST sanitize all tool output before displaying