claudecode-omc 5.6.5 → 5.6.7

package/bundled/upstream/anthropic-skills/skills/claude-api/typescript/agent-sdk/README.md

@@ -1,297 +0,0 @@
-# Agent SDK — TypeScript
-
-The Claude Agent SDK provides a higher-level interface for building AI agents with built-in tools, safety features, and agentic capabilities.
-
-## Installation
-
-```bash
-npm install @anthropic-ai/claude-agent-sdk
-```
-
----
-
-## Quick Start
-
-```typescript
-import { query } from "@anthropic-ai/claude-agent-sdk";
-
-for await (const message of query({
-  prompt: "Explain this codebase",
-  options: { allowedTools: ["Read", "Glob", "Grep"] },
-})) {
-  if ("result" in message) {
-    console.log(message.result);
-  }
-}
-```
-
----
-
-## Built-in Tools
-
-| Tool      | Description                          |
-| --------- | ------------------------------------ |
-| Read      | Read files in the workspace          |
-| Write     | Create new files                     |
-| Edit      | Make precise edits to existing files |
-| Bash      | Execute shell commands               |
-| Glob      | Find files by pattern                |
-| Grep      | Search files by content              |
-| WebSearch | Search the web for information       |
-| WebFetch        | Fetch and analyze web pages          |
-| AskUserQuestion | Ask user clarifying questions         |
-| Agent           | Spawn subagents                      |
-
----
-
-## Permission System
-
-```typescript
-for await (const message of query({
-  prompt: "Refactor the authentication module",
-  options: {
-    allowedTools: ["Read", "Edit", "Write"],
-    permissionMode: "acceptEdits",
-  },
-})) {
-  if ("result" in message) console.log(message.result);
-}
-```
-
-Permission modes:
-
-- `"default"`: Prompt for dangerous operations
-- `"plan"`: Planning only, no execution
-- `"acceptEdits"`: Auto-accept file edits
-- `"dontAsk"`: Don't prompt — **denies** anything not pre-approved (not an auto-approve mode)
-- `"bypassPermissions"`: Skip all prompts (requires `allowDangerouslySkipPermissions: true` in options)
-
----
-
-## MCP (Model Context Protocol) Support
-
-```typescript
-for await (const message of query({
-  prompt: "Open example.com and describe what you see",
-  options: {
-    mcpServers: {
-      playwright: { command: "npx", args: ["@playwright/mcp@latest"] },
-    },
-  },
-})) {
-  if ("result" in message) console.log(message.result);
-}
-```
-
-### In-Process MCP Tools
-
-You can define custom tools that run in-process using `tool()` and `createSdkMcpServer`:
-
-```typescript
-import { query, tool, createSdkMcpServer } from "@anthropic-ai/claude-agent-sdk";
-import { z } from "zod";
-
-const myTool = tool("my-tool", "Description", { input: z.string() }, async (args) => {
-  return { content: [{ type: "text", text: "result" }] };
-});
-
-const server = createSdkMcpServer({ name: "my-server", tools: [myTool] });
-
-// Pass to query
-for await (const message of query({
-  prompt: "Use my-tool to do something",
-  options: { mcpServers: { myServer: server } },
-})) {
-  if ("result" in message) console.log(message.result);
-}
-```
-
----
-
-## Hooks
-
-```typescript
-import { query, HookCallback } from "@anthropic-ai/claude-agent-sdk";
-import { appendFileSync } from "fs";
-
-const logFileChange: HookCallback = async (input) => {
-  const filePath = (input as any).tool_input?.file_path ?? "unknown";
-  appendFileSync(
-    "./audit.log",
-    `${new Date().toISOString()}: modified ${filePath}\n`,
-  );
-  return {};
-};
-
-for await (const message of query({
-  prompt: "Refactor utils.py to improve readability",
-  options: {
-    allowedTools: ["Read", "Edit", "Write"],
-    permissionMode: "acceptEdits",
-    hooks: {
-      PostToolUse: [{ matcher: "Edit|Write", hooks: [logFileChange] }],
-    },
-  },
-})) {
-  if ("result" in message) console.log(message.result);
-}
-```
-
-Hook event inputs for tool-lifecycle events (`PreToolUse`, `PostToolUse`, `PostToolUseFailure`) include `agent_id` and `agent_type` fields, allowing hooks to identify which agent (main or subagent) triggered the tool call.
-
-Available hook events: `PreToolUse`, `PostToolUse`, `PostToolUseFailure`, `Notification`, `UserPromptSubmit`, `SessionStart`, `SessionEnd`, `Stop`, `SubagentStart`, `SubagentStop`, `PreCompact`, `PermissionRequest`, `Setup`, `TeammateIdle`, `TaskCompleted`, `ConfigChange`, `Elicitation`, `ElicitationResult`, `WorktreeCreate`, `WorktreeRemove`, `InstructionsLoaded`
-
----
-
-## Common Options
-
-`query()` takes a top-level `prompt` (string) and an `options` object:
-
-```typescript
-query({ prompt: "...", options: { ... } })
-```
-
-| Option                              | Type   | Description                                                                |
-| ----------------------------------- | ------ | -------------------------------------------------------------------------- |
-| `cwd`                               | string | Working directory for file operations                                      |
-| `allowedTools`                      | array  | Tools the agent can use (e.g., `["Read", "Edit", "Bash"]`)                |
-| `tools`                             | array \| preset | Built-in tools to make available (`string[]` or `{type:'preset', preset:'claude_code'}`) |
-| `disallowedTools`                   | array  | Tools to explicitly disallow                                               |
-| `permissionMode`                    | string | How to handle permission prompts                                           |
-| `allowDangerouslySkipPermissions`   | bool   | Must be `true` to use `permissionMode: "bypassPermissions"`                |
-| `mcpServers`                        | object | MCP servers to connect to                                                  |
-| `hooks`                             | object | Hooks for customizing behavior                                             |
-| `systemPrompt`                      | string \| preset | Custom system prompt (`string` or `{type:'preset', preset:'claude_code', append?:string}`) |
-| `maxTurns`                          | number | Maximum agent turns before stopping                                        |
-| `maxBudgetUsd`                      | number | Maximum budget in USD for the query                                        |
-| `model`                             | string | Model ID (default: determined by CLI)                                      |
-| `agents`                            | object | Subagent definitions (`Record<string, AgentDefinition>`)                   |
-| `outputFormat`                      | object | Structured output schema                                                   |
-| `thinking`                          | object | Thinking/reasoning control                                                 |
-| `betas`                             | array  | Beta features to enable (e.g., `["context-1m-2025-08-07"]`)               |
-| `settingSources`                    | array  | Settings to load (e.g., `["project"]`). Default: none (no CLAUDE.md files) |
-| `env`                               | object | Environment variables to set for the session                               |
-| `agentProgressSummaries`            | bool   | Enable periodic AI-generated progress summaries on `task_progress` events  |
-
----
-
-## Subagents
-
-```typescript
-for await (const message of query({
-  prompt: "Use the code-reviewer agent to review this codebase",
-  options: {
-    allowedTools: ["Read", "Glob", "Grep", "Agent"],
-    agents: {
-      "code-reviewer": {
-        description: "Expert code reviewer for quality and security reviews.",
-        prompt: "Analyze code quality and suggest improvements.",
-        tools: ["Read", "Glob", "Grep"],
-        // Optional: skills, mcpServers for subagent customization
-      },
-    },
-  },
-})) {
-  if ("result" in message) console.log(message.result);
-}
-```
-
----
-
-## Message Types
-
-```typescript
-for await (const message of query({
-  prompt: "Find TODO comments",
-  options: { allowedTools: ["Read", "Glob", "Grep"] },
-})) {
-  if ("result" in message) {
-    console.log(message.result);
-    console.log(`Stop reason: ${message.stop_reason}`); // e.g., "end_turn", "tool_use", "max_tokens"
-  } else if (message.type === "system" && message.subtype === "init") {
-    const sessionId = message.session_id; // Capture for resuming later
-  }
-}
-```
-
-Task-related system messages are also emitted for subagent operations:
-- `task_started` — emitted when a subagent task is registered
-- `task_progress` — real-time progress updates with cumulative usage metrics, tool counts, and duration (enable `agentProgressSummaries` option for periodic AI-generated summaries via the `summary` field)
-- `task_notification` — task completion notifications (includes `tool_use_id` for correlating with originating tool calls)
-
----
-
-## Session History
-
-Retrieve past session data:
-
-```typescript
-import { listSessions, getSessionMessages, getSessionInfo } from "@anthropic-ai/claude-agent-sdk";
-
-// List all past sessions (supports pagination via limit/offset)
-const sessions = await listSessions({ limit: 20, offset: 0 });
-for (const session of sessions) {
-  console.log(`${session.sessionId}: ${session.cwd} (tag: ${session.tag})`);
-}
-
-// Get metadata for a single session
-const sessionId = sessions[0]?.sessionId;
-const info = await getSessionInfo(sessionId);
-console.log(info.tag, info.createdAt);
-
-// Get messages from a specific session (supports pagination via limit/offset)
-const messages = await getSessionMessages(sessionId, { limit: 50, offset: 0 });
-for (const msg of messages) {
-  console.log(msg);
-}
-```
-
-### Session Mutations
-
-Rename, tag, or fork sessions:
-
-```typescript
-import { renameSession, tagSession, forkSession } from "@anthropic-ai/claude-agent-sdk";
-
-// Rename a session
-await renameSession(sessionId, "My refactoring session");
-
-// Tag a session
-await tagSession(sessionId, "experiment");
-
-// Clear a tag
-await tagSession(sessionId, null);
-
-// Fork a session — branch a conversation from a specific point
-const { sessionId: forkedId } = await forkSession(sessionId);
-```
-
----
-
-## MCP Server Management
-
-Manage MCP servers at runtime on a running query:
-
-```typescript
-// Reconnect a disconnected MCP server
-await queryHandle.reconnectMcpServer("my-server");
-
-// Toggle an MCP server on/off
-await queryHandle.toggleMcpServer("my-server", false);  // (name, enabled) — both required
-
-// Get status of ALL configured MCP servers — returns an ARRAY
-const statuses: McpServerStatus[] = await queryHandle.mcpServerStatus();
-for (const s of statuses) {
-  console.log(s.name, s.scope, s.tools.length, s.error);
-}
-```
-
----
-
-## Best Practices
-
-1. **Always specify allowedTools** — Explicitly list which tools the agent can use
-2. **Set working directory** — Always specify `cwd` for file operations
-3. **Use appropriate permission modes** — Start with `"default"` and only escalate when needed
-4. **Handle all message types** — Check for `result` property to get agent output
-5. **Limit maxTurns** — Prevent runaway agents with reasonable limits

package/bundled/upstream/anthropic-skills/skills/claude-api/typescript/agent-sdk/patterns.md

@@ -1,209 +0,0 @@
-# Agent SDK Patterns — TypeScript
-
-## Basic Agent
-
-```typescript
-import { query } from "@anthropic-ai/claude-agent-sdk";
-
-async function main() {
-  for await (const message of query({
-    prompt: "Explain what this repository does",
-    options: {
-      cwd: "/path/to/project",
-      allowedTools: ["Read", "Glob", "Grep"],
-    },
-  })) {
-    if ("result" in message) {
-      console.log(message.result);
-    }
-  }
-}
-
-main();
-```
-
----
-
-## Hooks
-
-### After Tool Use Hook
-
-```typescript
-import { query, HookCallback } from "@anthropic-ai/claude-agent-sdk";
-import { appendFileSync } from "fs";
-
-const logFileChange: HookCallback = async (input) => {
-  const filePath = (input as any).tool_input?.file_path ?? "unknown";
-  appendFileSync(
-    "./audit.log",
-    `${new Date().toISOString()}: modified ${filePath}\n`,
-  );
-  return {};
-};
-
-for await (const message of query({
-  prompt: "Refactor utils.py to improve readability",
-  options: {
-    allowedTools: ["Read", "Edit", "Write"],
-    permissionMode: "acceptEdits",
-    hooks: {
-      PostToolUse: [{ matcher: "Edit|Write", hooks: [logFileChange] }],
-    },
-  },
-})) {
-  if ("result" in message) console.log(message.result);
-}
-```
-
----
-
-## Subagents
-
-```typescript
-import { query } from "@anthropic-ai/claude-agent-sdk";
-
-for await (const message of query({
-  prompt: "Use the code-reviewer agent to review this codebase",
-  options: {
-    allowedTools: ["Read", "Glob", "Grep", "Agent"],
-    agents: {
-      "code-reviewer": {
-        description: "Expert code reviewer for quality and security reviews.",
-        prompt: "Analyze code quality and suggest improvements.",
-        tools: ["Read", "Glob", "Grep"],
-      },
-    },
-  },
-})) {
-  if ("result" in message) console.log(message.result);
-}
-```
-
----
-
-## MCP Server Integration
-
-### Browser Automation (Playwright)
-
-```typescript
-for await (const message of query({
-  prompt: "Open example.com and describe what you see",
-  options: {
-    mcpServers: {
-      playwright: { command: "npx", args: ["@playwright/mcp@latest"] },
-    },
-  },
-})) {
-  if ("result" in message) console.log(message.result);
-}
-```
-
----
-
-## Session Resumption
-
-```typescript
-import { query } from "@anthropic-ai/claude-agent-sdk";
-
-let sessionId: string | undefined;
-
-// First query: capture the session ID
-for await (const message of query({
-  prompt: "Read the authentication module",
-  options: { allowedTools: ["Read", "Glob"] },
-})) {
-  if (message.type === "system" && message.subtype === "init") {
-    sessionId = message.session_id;
-  }
-}
-
-// Resume with full context from the first query
-for await (const message of query({
-  prompt: "Now find all places that call it",
-  options: { resume: sessionId },
-})) {
-  if ("result" in message) console.log(message.result);
-}
-```
-
----
-
-## Session History
-
-```typescript
-import { listSessions, getSessionMessages, getSessionInfo } from "@anthropic-ai/claude-agent-sdk";
-
-async function main() {
-  // List past sessions (supports pagination via limit/offset)
-  const sessions = await listSessions();
-  for (const session of sessions) {
-    console.log(`Session ${session.sessionId} in ${session.cwd} (tag: ${session.tag})`);
-  }
-
-  // Get metadata for a single session
-  if (sessions.length > 0) {
-    const info = await getSessionInfo(sessions[0].sessionId);
-    console.log(`Created: ${info.createdAt}, Tag: ${info.tag}`);
-  }
-
-  // Retrieve messages from the most recent session
-  if (sessions.length > 0) {
-    const messages = await getSessionMessages(sessions[0].sessionId, { limit: 50 });
-    for (const msg of messages) {
-      console.log(msg);
-    }
-  }
-}
-
-main();
-```
-
----
-
-## Session Mutations
-
-```typescript
-import { renameSession, tagSession, forkSession } from "@anthropic-ai/claude-agent-sdk";
-
-async function main() {
-  const sessionId = "your-session-id";
-
-  // Rename a session
-  await renameSession(sessionId, "Refactoring auth module");
-
-  // Tag a session for filtering
-  await tagSession(sessionId, "experiment-v2");
-
-  // Clear a tag
-  await tagSession(sessionId, null);
-
-  // Fork a conversation to branch from a point
-  const { sessionId: forkedId } = await forkSession(sessionId);
-  console.log(`Forked session: ${forkedId}`);
-}
-
-main();
-```
-
----
-
-## Custom System Prompt
-
-```typescript
-import { query } from "@anthropic-ai/claude-agent-sdk";
-
-for await (const message of query({
-  prompt: "Review this code",
-  options: {
-    allowedTools: ["Read", "Glob", "Grep"],
-    systemPrompt: `You are a senior code reviewer focused on:
-1. Security vulnerabilities
-2. Performance issues
-3. Code maintainability
-
-Always provide specific line numbers and suggestions for improvement.`,
-  },
-})) {
-  if ("result" in message) console.log(message.result);
-}
-```

package/bundled/upstream/ecc/commands/agent-sort.md

@@ -1,23 +0,0 @@
----
-description: Legacy slash-entry shim for the agent-sort skill. Prefer the skill directly.
----
-
-# Agent Sort (Legacy Shim)
-
-Use this only if you still invoke `/agent-sort`. The maintained workflow lives in `skills/agent-sort/SKILL.md`.
-
-## Canonical Surface
-
-- Prefer the `agent-sort` skill directly.
-- Keep this file only as a compatibility entry point.
-
-## Arguments
-
-`$ARGUMENTS`
-
-## Delegation
-
-Apply the `agent-sort` skill.
-- Classify ECC surfaces with concrete repo evidence.
-- Keep the result to DAILY vs LIBRARY.
-- If an install change is needed afterward, hand off to `configure-ecc` instead of re-implementing install logic here.

package/bundled/upstream/ecc/commands/claw.md

@@ -1,23 +0,0 @@
----
-description: Legacy slash-entry shim for the nanoclaw-repl skill. Prefer the skill directly.
----
-
-# Claw Command (Legacy Shim)
-
-Use this only if you still reach for `/claw` from muscle memory. The maintained implementation lives in `skills/nanoclaw-repl/SKILL.md`.
-
-## Canonical Surface
-
-- Prefer the `nanoclaw-repl` skill directly.
-- Keep this file only as a compatibility entry point while command-first usage is retired.
-
-## Arguments
-
-`$ARGUMENTS`
-
-## Delegation
-
-Apply the `nanoclaw-repl` skill and keep the response focused on operating or extending `scripts/claw.js`.
-- If the user wants to run it, use `node scripts/claw.js` or `npm run claw`.
-- If the user wants to extend it, preserve the zero-dependency and markdown-backed session model.
-- If the request is really about long-running orchestration rather than NanoClaw itself, redirect to `dmux-workflows` or `autonomous-agent-harness`.

package/bundled/upstream/ecc/commands/context-budget.md

@@ -1,23 +0,0 @@
----
-description: Legacy slash-entry shim for the context-budget skill. Prefer the skill directly.
----
-
-# Context Budget Optimizer (Legacy Shim)
-
-Use this only if you still invoke `/context-budget`. The maintained workflow lives in `skills/context-budget/SKILL.md`.
-
-## Canonical Surface
-
-- Prefer the `context-budget` skill directly.
-- Keep this file only as a compatibility entry point.
-
-## Arguments
-
-$ARGUMENTS
-
-## Delegation
-
-Apply the `context-budget` skill.
-- Pass through `--verbose` if the user supplied it.
-- Assume a 200K context window unless the user specified otherwise.
-- Return the skill's inventory, issue detection, and prioritized savings report without re-implementing the scan here.

package/bundled/upstream/ecc/commands/devfleet.md

@@ -1,23 +0,0 @@
----
-description: Legacy slash-entry shim for the claude-devfleet skill. Prefer the skill directly.
----
-
-# DevFleet (Legacy Shim)
-
-Use this only if you still call `/devfleet`. The maintained workflow lives in `skills/claude-devfleet/SKILL.md`.
-
-## Canonical Surface
-
-- Prefer the `claude-devfleet` skill directly.
-- Keep this file only as a compatibility entry point while command-first usage is retired.
-
-## Arguments
-
-`$ARGUMENTS`
-
-## Delegation
-
-Apply the `claude-devfleet` skill.
-- Plan from the user's description, show the DAG, and get approval before dispatch unless the user already said to proceed.
-- Prefer polling status over blocking waits for long missions.
-- Report mission IDs, files changed, failures, and next steps from structured mission reports.

package/bundled/upstream/ecc/commands/docs.md

@@ -1,23 +0,0 @@
----
-description: Legacy slash-entry shim for the documentation-lookup skill. Prefer the skill directly.
----
-
-# Docs Command (Legacy Shim)
-
-Use this only if you still reach for `/docs`. The maintained workflow lives in `skills/documentation-lookup/SKILL.md`.
-
-## Canonical Surface
-
-- Prefer the `documentation-lookup` skill directly.
-- Keep this file only as a compatibility entry point.
-
-## Arguments
-
-`$ARGUMENTS`
-
-## Delegation
-
-Apply the `documentation-lookup` skill.
-- If the library or the question is missing, ask for the missing part.
-- Use live documentation through Context7 instead of training data.
-- Return only the current answer and the minimum code/example surface needed.