@enderfga/claw-orchestrator 7.6.2 → 7.7.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (23) hide show
  1. package/README.md +3 -3
  2. package/dist/src/acp-server.d.ts +11 -1
  3. package/dist/src/acp-server.js +68 -14
  4. package/dist/src/acp-server.js.map +1 -1
  5. package/dist/src/index.js +10 -0
  6. package/dist/src/index.js.map +1 -1
  7. package/dist/src/persistent-session.d.ts +2 -0
  8. package/dist/src/persistent-session.js +26 -1
  9. package/dist/src/persistent-session.js.map +1 -1
  10. package/dist/src/run-ledger.d.ts +6 -0
  11. package/dist/src/run-ledger.js.map +1 -1
  12. package/dist/src/session-manager.d.ts +7 -0
  13. package/dist/src/session-manager.js +103 -47
  14. package/dist/src/session-manager.js.map +1 -1
  15. package/dist/src/types.d.ts +24 -0
  16. package/package.json +1 -1
  17. package/skills/references/acp.md +29 -11
  18. package/skills/references/claude-cli-tracking.md +2 -1
  19. package/skills/references/mcp.md +19 -0
  20. package/skills/references/multi-engine.md +3 -3
  21. package/skills/references/observability.md +2 -1
  22. package/skills/references/sessions.md +11 -0
  23. package/skills/references/tools.md +2 -0
package/skills/references/claude-cli-tracking.md CHANGED
@@ -2,12 +2,13 @@
2
2
 
3
3
  This document tracks which Claude Code CLI version Claw Orchestrator is currently synced to, and which features have been integrated. Recent rows also record the other engines' versions checked in the same sync.
4
4
 
5
- ## Currently tracked: **Claude Code CLI 2.1.289** (as of 2026-10-05, plugin v7.6.2)
5
+ ## Currently tracked: **Claude Code CLI 2.1.291** (as of 2026-10-07, plugin v7.7.0)
6
6
 
7
7
  ## Sync history
8
8
 
9
9
  | Plugin Version | Claude CLI Version | Date | Notable integrations |
10
10
  | ------------------- | ------------------ | ---------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
11
+ | v7.7.0 | 2.1.291 | 2026-10-07 | CC 2.1.289→2.1.291, Codex 0.160.0→0.160.1, agy 1.2.17→1.3.0; grok 1.0.46 and OpenCode 1.18.34 unchanged. No flag surface changed. Integrated: `--chrome` behind a `chrome` session option (2.1.290 stopped project settings from turning Claude in Chrome on, so the flag is the way in); `system/model_refusal_fallback` recorded per turn in the ledger. Read, no change needed: Codex's `computer_use` feature is the ChatGPT desktop app's Computer Use plugin, not a tool in `codex exec`, which reports none; agy 1.3.0 is interactive-view changes. |
11
12
  | v7.6.2 | 2.1.289 | 2026-10-05 | CC 2.1.286→2.1.289, Codex 0.159.3→0.160.0, agy 1.2.14→1.2.17, grok 1.0.44→1.0.46; OpenCode 1.18.34 unchanged. No flag surface changed, no wrapper change. Read, no change needed: CC 2.1.288 limits background-command time only in unattended (`-p`) sessions, which these already are; agy 1.2.16 fixes `-p` runs exiting before the agent answers a finished background command, consistent with the 7.5.6 deadline handling. |
12
13
  | v7.6.1 | 2.1.286 | 2026-10-01 | CC 2.1.284→2.1.286, Codex 0.159.0→0.159.3, agy 1.2.13→1.2.14, OpenCode 1.18.33→1.18.34; grok 1.0.44 unchanged. No flag surface changed. Integrated: `gpt-6.1-sol` registered ($2/$10, cache reads at 5% of input); a Codex session with no model is priced as the model Codex reports it ran rather than `gpt-5.5`. Read, no change needed: CC 2.1.285 starts `-p` sessions on third-party providers or with telemetry off in auto mode when no permission mode is set (this wrapper always passes `--permission-mode`); CC 2.1.286 resume fixes after parallel tool calls. Gemini 4 is not yet released: no API id, price or `agy models` entry. |
13
14
  | v7.6.0 | 2.1.284 | 2026-09-29 | CC 2.1.283→2.1.284, Codex 0.157.1→0.159.0, agy 1.2.11→1.2.13, grok 1.0.41→1.0.44, OpenCode 1.18.32→1.18.33. No flag surface changed. Integrated: Claude Sonnet 5.5 registered and the `sonnet` alias moved to `claude-sonnet-5-5` (the CLI resolves `--model sonnet` to it); priced at $2/$10 per Mtok with $0.20 cache reads, the same as Sonnet 5. Read, no change needed: CC 2.1.284 makes Ultracode its own `/effort` toggle that no longer forces xhigh (the `ultracode` settings key this wrapper passes already composes with a separate effort) and starts interactive sessions in auto mode (headless sessions are unaffected); Codex 0.158–0.159 TUI, sandbox and approval changes; agy 1.2.12–1.2.13 rate-limit handling; OpenCode 1.18.33 Gemini effort defaults. |
package/skills/references/mcp.md CHANGED
@@ -8,6 +8,7 @@ This document covers:
8
8
  - [Host configuration](#host-configuration)
9
9
  - [Hermes Agent](#hermes-agent)
10
10
  - [Claude Desktop / Claude Code](#claude-desktop--claude-code)
11
+ - [Codex CLI](#codex-cli)
11
12
  - [Cursor](#cursor)
12
13
  - [Cline (VS Code)](#cline-vs-code)
13
14
  - [Continue](#continue)
@@ -116,6 +117,24 @@ Hermes prefixes tool names with `mcp_<server>_`. The model sees the prefixed nam
116
117
 
117
118
  For Claude Code (`~/.claude.json` or per-project `.mcp.json`), use the same shape under `mcpServers`.
118
119
 
120
+ ### Codex CLI
121
+
122
+ ```bash
123
+ codex mcp add clawo -- clawo-mcp
124
+ ```
125
+
126
+ or in `~/.codex/config.toml`:
127
+
128
+ ```toml
129
+ [mcp_servers.clawo]
130
+ command = "clawo-mcp"
131
+ ```
132
+
133
+ Codex then offers the tools in every local session — `codex exec`, the TUI and `codex app-server`. For a
134
+ one-off run without touching the config, pass `-c 'mcp_servers.clawo.command="clawo-mcp"'`. Each Codex
135
+ session starts its own `clawo-mcp` process, so the sessions one Codex session starts through it are not
136
+ visible from another.
137
+
119
138
  ### Cursor
120
139
 
121
140
  In Cursor settings → MCP, add a server. The config file is `~/.cursor/mcp.json`:
package/skills/references/multi-engine.md CHANGED
@@ -28,7 +28,7 @@ SessionManager
28
28
 
29
29
  ### Claude Code (`engine: 'claude'`)
30
30
 
31
- Default engine. Long-running subprocess with streaming JSON I/O. Tested with Claude Code CLI **2.1.289**.
31
+ Default engine. Long-running subprocess with streaming JSON I/O. Tested with Claude Code CLI **2.1.291**.
32
32
 
33
33
  - Persistent multi-turn conversations
34
34
  - Real-time streaming (text, tool_use, tool_result, system events)
@@ -62,7 +62,7 @@ await manager.startSession({
62
62
 
63
63
  ### OpenAI Codex (`engine: 'codex'`)
64
64
 
65
- Wraps the `codex exec` subcommand. Each `send()` spawns a new process. Tested with `codex` CLI **0.160.0**.
65
+ Wraps the `codex exec` subcommand. Each `send()` spawns a new process. Tested with `codex` CLI **0.160.1**.
66
66
 
67
67
  - Non-interactive execution via `codex exec --sandbox workspace-write --skip-git-repo-check --json`
68
68
  - Real `usage` from the `turn.completed` JSON event (input, output, cached, reasoning tokens). **These are cumulative over the thread, not per turn**, so they replace the session totals rather than being added to them; subtracting consecutive values gives one turn's prompt
@@ -128,7 +128,7 @@ await manager.startSession({
128
128
 
129
129
  Wraps Google's **Antigravity CLI** (`agy`) — the successor to Gemini CLI (consumer
130
130
  Gemini CLI tiers stopped serving 2026-06-18). Each `send()` spawns a new process
131
- in print mode. Tested with `agy` **1.2.17**.
131
+ in print mode. Tested with `agy` **1.3.0**.
132
132
 
133
133
  - One-shot execution per message (no persistent subprocess)
134
134
  - **Structured output and real usage** — `--output-format stream-json` emits an
package/skills/references/observability.md CHANGED
@@ -30,7 +30,7 @@ every engine passes through, not only through Claude Code's `--max-budget-usd`.
30
30
  | `ts` | ISO timestamp of turn completion |
31
31
  | `session` | SessionManager session name |
32
32
  | `engine` | `claude` / `codex` / `codex-app` / `grok` / `opencode` / `agy` / `cursor` (legacy) / `custom` |
33
- | `model` | Configured model, or the engine's own reported model when none was set (Claude Code: the model named in its `init` event). Absent when neither is known |
33
+ | `model` | Configured model, or the engine's own reported model when none was set (Claude Code: the model named in its `init` event). A configured alias such as `opus[1m]` is recorded as the model the engine reports it resolved to. Absent when neither is known |
34
34
  | `cwd` | Working directory the turn ran in |
35
35
  | `turn` | 1-based index of the send within the session, counted by the process that recorded it |
36
36
  | `tokensIn` / `tokensOut` / `cachedTokens` | **Per-turn deltas**, not session totals |
@@ -40,6 +40,7 @@ every engine passes through, not only through Claude Code's `--max-budget-usd`.
40
40
  | `toolCalls` / `toolErrors` | Per-turn deltas |
41
41
  | `ok` | `false` for a turn that threw, or that the session's own `turnsSucceeded` counter did not count (see `sessions.md`). Falls back to "nothing was thrown" when the counter cannot be read |
42
42
  | `error` | Failure text, truncated to 500 chars. Absent when the turn resolved but the engine did not count it as succeeded (an interrupted or non-SUCCESS turn), so a failed row does not always carry one |
43
+ | `refusalFallback` | `{ from, to, category? }` when the model refused and the engine re-ran the turn on another model (Claude Code’s refusal fallback, for example Opus 5.5 to an older Opus on a `cyber` refusal). Absent otherwise |
43
44
  | `parent` | council / fanout / autoloop / workflow run id, when the turn belongs to one |
44
45
 
45
46
  Deltas rather than totals means summing a query window gives that window's spend
package/skills/references/sessions.md CHANGED
@@ -190,6 +190,17 @@ tokens the session has been billed for in total, which only ever grows.
190
190
  (`codex`, `agy`, `grok`, `opencode`); those sessions log a warning the first
191
191
  time it is called.
192
192
 
193
+ A long-lived session can compact itself: start it with `autoCompactPercent`
194
+ (1–99, off by default) and, before each send, the session is compacted first
195
+ if `contextPercent` has reached that value. Every call in a turn re-reads the
196
+ whole context from cache, so cost grows with context size; compacting earlier
197
+ trades detail of older turns for cheaper ones. The setting survives a restart
198
+ of the server, and a failed compaction never costs the send.
199
+
200
+ ```typescript
201
+ await manager.startSession({ name: 'assistant', cwd: '/srv/bot', autoCompactPercent: 85 });
202
+ ```
203
+
193
204
  `stats.turns` and `stats.turnsSucceeded` are the same kind of distinction.
194
205
  `turns` counts turns that reached the engine, whatever their outcome, including
195
206
  the ones that then failed. `turnsSucceeded` counts only the ones the engine
package/skills/references/tools.md CHANGED
@@ -20,6 +20,7 @@ Start a persistent coding session with full CLI flag support.
20
20
  | `disallowedTools` | string[] | Tools to deny |
21
21
  | `maxTurns` | number | Max agent loop turns |
22
22
  | `maxBudgetUsd` | number | Max API spend (USD). Enforced by the runtime on every engine: once the session's cumulative cost reaches the cap, further sends are refused before the engine is spawned. See [observability.md](observability.md) for the accuracy caveat on engines that estimate token counts. |
23
+ | `autoCompactPercent` | number | Compact the conversation before a send once `contextPercent` reaches this value (1–99). Off by default. For long-lived sessions, where cost grows with context size; survives a server restart. A failed compaction does not block the send. |
23
24
  | `systemPrompt` | string | Replace system prompt |
24
25
  | `appendSystemPrompt` | string | Append custom instructions to the system prompt. Claude Code and Grok take it natively; Codex, Antigravity and OpenCode have no such flag and receive it at the top of the first message of a conversation |
25
26
  | `agents` | object | Custom sub-agents JSON |
@@ -43,6 +44,7 @@ Start a persistent coding session with full CLI flag support.
43
44
  | `crossSessionInbound` | string | `accept` / `hold` / `refuse` — policy for peer messages from other Claude Code sessions on this machine (Claude engine). Delivered as a settings key; there is no CLI flag. Without it the CLI holds messages whose two sides run different permission modes, which is the usual orchestrated-session-to-human-terminal case |
44
45
  | `includeHookEvents` | boolean | Stream hook lifecycle events (PreToolUse/PostToolUse) as `system` events |
45
46
  | `forwardSubagentText` | boolean | Forward subagent text and thinking into the output stream (Claude engine, CLI 2.1.211+). Without it the parent stream stays quiet while a subagent works |
47
+ | `chrome` | boolean | Let the session use the user's Chrome through the Claude in Chrome extension, acting with that browser's sign-ins (Claude engine, `--chrome`). Off by default. Needs Chrome running with the extension and a claude.ai login; survives a server restart |
46
48
  | `permissionPromptTool` | string | MCP tool name to delegate permission prompts to (non-interactive use). When omitted, the session runs with `--permission-prompts none`: a prompt nobody could answer is denied rather than left waiting until the turn timeout. |
47
49
  | `excludeDynamicSystemPromptSections` | boolean | Move cwd/env/git context from system prompt to user message for better prompt cache hits; auto-enabled with `bare: true` |
48
50
  | `enablePromptCaching1H` | boolean | Enable 1-hour prompt cache TTL (vs default 5-min); auto-enabled with `bare: true` |