Skip to content

Open source CapCut alternative.

TypeScript

docs: describe unjudged CLI turns

David Leac3ee36c1c74
diff --git a/docs/guides/cut/ai-assistant.md b/docs/guides/cut/ai-assistant.md
index e541eba5..6f446d13 100644
--- a/docs/guides/cut/ai-assistant.md
+++ b/docs/guides/cut/ai-assistant.md
@@ -39,7 +39,7 @@ A turn the page lost resumes itself when the thread next opens, replaying the en
The Gemini path skips the engine entirely — the same carve-out as AI media generation. The loop runs on the pi agent harness (the `@earendil-works` packages) in the browser: a custom transport speaks Donkey's hosted responses route with the user's session, tools execute directly against the store, and each thread's conversation persists as the harness's own structured history — past tool calls replay as real tool records, so no bookkeeping rides as prose the model could imitate. Gemini's quirks live in that transport: thought signatures replay exactly with each call, tool media returns as its own following turn, and an empty round retries before it surfaces as an error.
-The turn's route is one typed judgment: a System One judge scores the ask's size, the skill to open first, and the tool areas it needs, and code applies the thresholds in the `cutJudge` setting. The first round waits a bounded moment for it, then runs the light chat model with only the routed areas' tools; a simple verdict keeps the run, chat or complex restarts it routed, and a `request_tools` call widens the catalog for the next round. With credits, Claude and Codex turns take the same judgment, which narrows the engine's MCP listing; Codex reads tools once per run, so a widening resumes it. Without credits the CLI decides.
+The turn's route is one typed judgment: a System One judge scores the ask's size, the skill to open first, and the tool areas it needs, and code applies the thresholds in the `cutJudge` setting. The first round waits a bounded moment for it, then runs the light chat model with only the routed areas' tools; a simple verdict keeps the run, chat or complex restarts it routed, and a `request_tools` call widens the catalog for the next round. With credits, Claude and Codex turns take the same judgment, which narrows the engine's MCP listing; Codex reads tools once per run, so a widening resumes it.
The same loop code runs with no browser at all. A headless session opens a project doc into the editor store, binds both transports at an explicit origin with auth headers, and runs the production chat loop against it — which is how a chat turn becomes a durable job. The page or an API caller posts a thread's messages to the cloud project's turns route; the row is the project's agent write lease (one turn at a time per project); the worker container claims it, runs the turn under a runner grant that spends that user's credits and writes that user's project, pushes the doc back through the versioned PUT, and appends the finished exchange to the stored thread.
@@ -60,7 +60,7 @@ Every knowledge surface is defined once — the catalog file ships in the engine
| Surface | Size today | When it enters context |
| --- | --- | --- |
| System prompt | ~13K chars (~3K tokens) | Claude: replaces the Agent SDK default. Codex: prepended to the first turn (a resumed session already has it). Gemini: the instructions field, every round. |
-| Tool catalog (127 tools in 19 areas) | ~140K chars (~35K tokens) whole | The core plus the routed areas per turn. |
+| Tool catalog (127 tools in 19 areas) | ~140K chars (~35K tokens) whole | Core plus the routed areas; the whole catalog when unjudged. |
| Skills library (16 docs) | ~97K chars (~24K tokens) total | The judge's pick rides the turn; list-skills and read-skill cover the rest. |
| Editor snapshot | Grows with the project; media list and subtitle cues capped at 60 each | Attached to the newest user message as `<editor_state>`, rebuilt fresh every turn. |
| Attachments | Metadata JSON per asset | `<attached_assets>` on the message that carried them; on the Gemini path the newest message also carries the actual payloads (frames, images, text contents). |