zidane 7.0.16 → 7.0.17

package/dist/types.d.ts

@@ -1,5 +1,5 @@
 import { d as ClassifiedErrorKind, i as AgentContextExceededError, l as CONTEXT_EXCEEDED_MESSAGE_PATTERNS, n as AgentAbortedError, o as AgentProviderError, p as matchesContextExceeded, r as AgentBudgetExceededError, s as AgentToolNotAllowedError, u as ClassifiedError } from "./timeout-DEaqslLO.js";
-import { $g as ToolHookContext, A_ as ToolStateOp, Ag as PromptDocumentPart, Bg as RunHookMap, Br as InteractionToolOptions, C as SuccessfulMutationOutcome, Cm as TurnResult, Dg as ProgressNudgeKind, Eg as OAuthRefreshHookContext, Fg as RepeatGuardConfig, G_ as SessionData, Gg as SessionTurn, Gv as McpConnection, H_ as CreateSessionOptions, Hg as SessionEndStatus, Ig as RepeatGuardToolMatcher, J_ as SessionStore, Ji as AgentHookMap, Kg as SpawnHookContext, L_ as SkillConfig, Lg as ResolveContentRef, M_ as ToolStateView, Mg as PromptPart, Ng as PromptTextPart, O_ as StagedToolState, Og as ProgressNudgeMessage, Pg as PromptVideoPart, Pm as OpenRouterParams, Rg as ResolveContentRefBlock, S as MutationValidationResult, Sg as McpToolHookContext, Sm as ToolSpec, Th as AnthropicParams, Ug as SessionHookContext, V_ as SkillsConfig, Vg as SessionContentBlock, W_ as Session, Wg as SessionMessage, Xi as AgentOptions, Yg as StreamHookContext, Yi as AgentHooks, Zg as ThinkingLevel, _ as statsByModel, __ as ToolMap, _m as StreamCallbacks, a_ as ToolResultImageContent, ag as AgentClock, b as MutationValidationHooksOptions, b_ as ReadStateMap, bm as ToolCall, c_ as ToolResultTextContent, d_ as TurnUsage, dc as SpawnToolOptions, dg as ChildRunStats, e_ as ToolOutcome, f_ as toolOutputBudgetByteLength, fc as SpawnToolState, g_ as ToolDef, gg as DEFAULT_AGENT_CLOCK, gh as CerebrasParams, h as flattenTurns, h_ as ToolContext, hm as ProviderCapabilities, i_ as ToolResultDocumentRefContent, ig as AgentBehavior, ih as OpenAIParams, iv as RemoteStoreOptions, j_ as ToolStateStore, jg as PromptImagePart, k_ as ToolStateController, kg as PromptAudioPart, l_ as ToolResultVideoContent, m_ as toolResultToText, mm as Provider, n_ as ToolResultContent, o_ as ToolResultImageRefContent, oc as ChildAgent, og as AgentRunOptions, p as ModelUsage, p_ as toolOutputByteLength, q_ as SessionRun, qi as Agent, r_ as ToolResultDocumentContent, s_ as ToolResultMetadata, sg as AgentStats, t as Preset, t_ as ToolResultAudioContent, u_ as TurnFinishReason, v as MutationValidationBatch, vm as StreamOptions, vr as ValidationResult, x as MutationValidationMutation, xg as McpServerConfig, xm as ToolResult, y as MutationValidationFailure, y_ as ReadStateEntry, z_ as SkillResource, zg as RetryConfig } from "./index-Dc_zYpEu.js";
+import { Ag as PromptAudioPart, B_ as SkillConfig, Bg as RetryConfig, Br as InteractionToolOptions, C as SuccessfulMutationOutcome, C_ as ReadStateMap, Cg as McpToolHookContext, Cm as TurnResult, Dg as OAuthRefreshHookContext, F_ as ToolStateView, Fg as PromptVideoPart, G_ as CreateSessionOptions, Gg as SessionMessage, H_ as SkillResource, Hg as SessionContentBlock, Ig as RepeatGuardConfig, J_ as SessionData, Ji as AgentHookMap, Jv as McpConnection, Kg as SessionTurn, Lg as RepeatGuardToolMatcher, M_ as ToolStateController, Mg as PromptImagePart, N_ as ToolStateOp, Ng as PromptPart, Og as ProgressNudgeKind, P_ as ToolStateStore, Pg as PromptTextPart, Pm as OpenRouterParams, Rg as ResolveContentRef, S as MutationValidationResult, S_ as ReadStateEntry, Sg as McpServerConfig, Sm as ToolSpec, Th as AnthropicParams, Ug as SessionEndStatus, Vg as RunHookMap, W_ as SkillsConfig, Wg as SessionHookContext, X_ as SessionRun, Xg as StreamHookContext, Xi as AgentOptions, Yi as AgentHooks, Z_ as SessionStore, _ as statsByModel, __ as toolResultToText, _g as DEFAULT_AGENT_CLOCK, _m as StreamCallbacks, a_ as ToolResultContent, ag as AgentBehavior, b as MutationValidationHooksOptions, b_ as ToolMap, bm as ToolCall, c_ as ToolResultImageContent, cg as AgentStats, d_ as ToolResultTextContent, dc as SpawnToolOptions, e_ as ThinkingLevel, f_ as ToolResultVideoContent, fc as SpawnToolState, fg as ChildRunStats, g_ as toolOutputByteLength, gh as CerebrasParams, h as flattenTurns, h_ as toolOutputBudgetByteLength, hm as ProviderCapabilities, i_ as ToolResultAudioContent, ih as OpenAIParams, j_ as StagedToolState, jg as PromptDocumentPart, kg as ProgressNudgeMessage, l_ as ToolResultImageRefContent, m_ as TurnUsage, mm as Provider, n_ as ToolHookContext, o_ as ToolResultDocumentContent, oc as ChildAgent, og as AgentClock, p as ModelUsage, p_ as TurnFinishReason, q_ as Session, qg as SpawnHookContext, qi as Agent, r_ as ToolOutcome, s_ as ToolResultDocumentRefContent, sg as AgentRunOptions, sv as RemoteStoreOptions, t as Preset, u_ as ToolResultMetadata, v as MutationValidationBatch, v_ as ToolContext, vm as StreamOptions, vr as ValidationResult, x as MutationValidationMutation, xm as ToolResult, y as MutationValidationFailure, y_ as ToolDef, zg as ResolveContentRefBlock } from "./index-D7H81_kd.js";
 import { _ as TaskHandle, a as ContextType, c as ExecutionContext, g as TaskExitInfo, h as TaskEntry, l as ExecutionHandle, n as ContextCapabilities, o as DetachedTasksCapability, p as SpawnConfig, r as ContextHardening, s as ExecResult, t as BackgroundTaskStatus, v as TaskStallInfo } from "./types-U-rIVUDw.js";
 import { t as SandboxProvider } from "./sandbox-CDl9tfTo.js";
 export { type Agent, AgentAbortedError, type AgentBehavior, AgentBudgetExceededError, type AgentClock, AgentContextExceededError, type AgentHookMap, type AgentHooks, type AgentOptions, AgentProviderError, type AgentRunOptions, type AgentStats, AgentToolNotAllowedError, type AnthropicParams, type BackgroundTaskStatus, CONTEXT_EXCEEDED_MESSAGE_PATTERNS, type CerebrasParams, type ChildAgent, type ChildRunStats, type ClassifiedError, type ClassifiedErrorKind, type ContextCapabilities, type ContextHardening, type ContextType, type CreateSessionOptions, DEFAULT_AGENT_CLOCK, type DetachedTasksCapability, type ExecResult, type ExecutionContext, type ExecutionHandle, type InteractionToolOptions, type McpConnection, type McpServerConfig, type McpToolHookContext, type ModelUsage, type MutationValidationBatch, type MutationValidationFailure, type MutationValidationHooksOptions, type MutationValidationMutation, type MutationValidationResult, type OAuthRefreshHookContext, type OpenAIParams, type OpenRouterParams, type Preset, type ProgressNudgeKind, type ProgressNudgeMessage, type PromptAudioPart, type PromptDocumentPart, type PromptImagePart, type PromptPart, type PromptTextPart, type PromptVideoPart, type Provider, type ProviderCapabilities, type ReadStateEntry, type ReadStateMap, type RemoteStoreOptions, type RepeatGuardConfig, type RepeatGuardToolMatcher, type ResolveContentRef, type ResolveContentRefBlock, type RetryConfig, type RunHookMap, type SandboxProvider, type Session, type SessionContentBlock, type SessionData, type SessionEndStatus, type SessionHookContext, type SessionMessage, type SessionRun, type SessionStore, type SessionTurn, type SkillConfig, type SkillResource, type SkillsConfig, type SpawnConfig, type SpawnHookContext, type SpawnToolOptions, type SpawnToolState, type StagedToolState, type StreamCallbacks, type StreamHookContext, type StreamOptions, type SuccessfulMutationOutcome, type TaskEntry, type TaskExitInfo, type TaskHandle, type TaskStallInfo, type ThinkingLevel, type ToolCall, type ToolContext, type ToolDef, type ToolHookContext, type ToolMap, type ToolOutcome, type ToolResult, type ToolResultAudioContent, type ToolResultContent, type ToolResultDocumentContent, type ToolResultDocumentRefContent, type ToolResultImageContent, type ToolResultImageRefContent, type ToolResultMetadata, type ToolResultTextContent, type ToolResultVideoContent, type ToolSpec, type ToolStateController, type ToolStateOp, type ToolStateStore, type ToolStateView, type TurnFinishReason, type TurnResult, type TurnUsage, type ValidationResult, flattenTurns, matchesContextExceeded, statsByModel, toolOutputBudgetByteLength, toolOutputByteLength, toolResultToText };

package/docs/ARTIFACTS.md

@@ -5,10 +5,10 @@ An **artifact** is a durable, typed pointer to something a session produced outs
 - **Model / store:** `src/session/artifacts.ts`, `SessionStore` artifact methods in `src/session/index.ts`
 - **Producers:** the `metadata.artifacts` tool-result namespace, lifted by `src/loop.ts`
 - **Kinds:** `src/extensions/builtin-artifact-kinds.ts` + `ctx.registerArtifactKind`
-- **Surfaces:** TUI `/artifacts` · GUI Artifacts modal · sessions-list badge · `#pr` completion
+- **Surfaces:** TUI rail + `▢` title-bar chip · GUI rail + header chip · sessions-list badge · `#pr` completion
 - **IPC:** `sessions.artifacts`, `artifacts.list` / `delete` / `upsert`; signals `artifact:recorded`, `artifact:changed`
 
-Contents: [Model](#model) · [Producers](#producers) · [Storage](#storage) · [Extension API](#extension-api) · [Surfaces](#surfaces) · [IPC](#ipc) · [Lazy refresh](#lazy-refresh) · [Known gaps](#known-gaps)
+Contents: [Model](#model) · [Producers](#producers) · [Storage](#storage) · [Extension API](#extension-api) · [Surfaces](#surfaces) · [IPC](#ipc) · [Lazy refresh](#lazy-refresh) · [Disabling](#disabling) · [Known gaps](#known-gaps)
 
 ## Model
 
@@ -41,13 +41,14 @@ Artifacts are **not** part of `SessionData`: `load()` / `save()` / export / comp
 
 ## Producers
 
-All three paths converge on one channel — the reserved `artifacts` key of tool-result metadata — so bounds, normalization, and hooks are identical.
+Tool-driven paths converge on one channel — the reserved `artifacts` key of tool-result metadata; host-side code (`/` commands) writes through `ctx.artifacts.record`. Every path runs the same normalization and bounds and upserts on the same identity.
 
 | Path | How |
 |---|---|
 | **Tool-result metadata** | Any `tool:transform` hook appends `SessionArtifactInput[]` to `ctx.metadata.artifacts`. After the tool settles, the loop normalizes each entry (`normalizeArtifactInput`), canonicalizes `file:` URIs against the execution cwd, and calls `session.addArtifact`. ≤ 50 entries per tool result. |
-| **Built-in detectors** (`artifactsPreset`) | Keyed on the command or tool name, never on free text: `gh pr create` / `glab mr create` / `*create_pull_request` → `pull_request` · `git commit` → `commit` · `git switch -c` / `checkout -b` / `push -u` → `branch` · `write_file` that *creates* → `file`. Composed under every TUI / daemon / GUI profile; SDK users opt in with `composePresets(artifactsPreset, …)`. |
-| **`record_artifact` tool** | Explicit path for what detection can't see: a PR opened from a background shell task, a deployment URL, an issue. Input `{ kind, uri, label?, meta? }`; the preset's detector reads the input and emits it. |
+| **Built-in detectors** (`artifactsPreset`) | Keyed on the command or tool name, never on free text: `gh pr create` / `glab mr create` / `*create_pull_request` → `pull_request` · `git commit` → `commit` · `git switch -c` / `checkout -b` / `push -u` → `branch`. **Files are never auto-detected** — a source edit is not a deliverable; `file` artifacts exist only via `record_artifact` / `ctx.artifacts.record`. Composed under every TUI / daemon / GUI profile when `Settings.artifacts` is on; SDK users opt in with `composePresets(artifactsPreset, …)`. |
+| **`record_artifact` tool** | The model marks a *deliverable*: a PR the detectors couldn't see (background shell), a deployment / preview URL, an issue it filed, a release, a generated report / export the user asked for. The tool description carries the worth-it / not-worth-it guidance (source edits, scratch files, logs are not artifacts). Input `{ kind, uri, label?, meta? }`; the preset's detector reads the input and emits it. |
+| **`ctx.artifacts.record`** (extensions) | For work that never passes through a tool result — a `/` command running `gh pr create` via `ctx.workspace.exec`. Stamps the active session (+ `runId` when in a run), writes the store (daemon-owned when attached), fans out `artifact:changed`. git-flow's `/pr` (PR + created branch) and `/commit` use it with the same locators the detectors emit, so agent- and command-made rows merge. |
 
 Emission is best-effort: a store failure never fails the tool call, and the persisted turn / wire payload are byte-identical with or without artifacts. Each stored artifact fires `artifact:recorded` (`child:artifact:recorded` when bubbled from a subagent).
 
@@ -79,12 +80,13 @@ ctx.registerArtifactKind({
 ctx.tui.registerArtifactRenderer({ kind, renderDetail: artifact => <Pane /> })   // TUI detail pane
 ctx.artifacts.list({ scope: 'session' | 'project' | 'all', kind?, since?, limit? })
 ctx.artifacts.find(kind, uri)                                                    // reverse lookup across sessions
+ctx.artifacts.record({ kind, uri, label, projectRoot?, meta? })                  // host-side producer (commands)
 ctx.registerHook('artifact:recorded', ({ artifact, runId, turnId }) => …)
 ```
 
 - Kinds are a global namespace; first registration wins (logged). Built-ins use the same API and can be refined by an extension re-registering the kind.
 - `detect` rides `tool:transform` and `child:tool:transform` but can only append to `metadata.artifacts`; it never changes what the model sees. A throwing detector emits nothing.
-- `ctx.artifacts` is late-bound (like `ctx.sessions`): `[]` when detached or when the store lacks artifact support.
+- `ctx.artifacts` is late-bound (like `ctx.sessions`): reads answer `[]`, `record` answers `undefined`, when detached or the store lacks artifact support. `record` never throws for unusable input either.
 - Row presentation goes through `renderArtifactRow(artifact, registry)`: registry kind → built-in kind → `label` + `uri` fallback. A throwing `render` falls back.
 
 Authoring example: [EXTENSIONS.md → Session artifacts](./EXTENSIONS.md#session-artifacts).
@@ -93,9 +95,9 @@ Authoring example: [EXTENSIONS.md → Session artifacts](./EXTENSIONS.md#session
 
 | Surface | Behavior |
 |---|---|
-| `/artifacts [project]` | TUI opens the modal; daemon / GUI hosts without a modal emit a markdown list. Session scope by default. |
-| TUI modal (`ctrl+shift+a`) | Grouped by kind (built-ins first). `↵` open href (browser / editor) · `tab` session ↔ project · `c` copy locator · `d` remove. Re-queries on `artifact:recorded` / `artifact:changed`. Extension `renderDetail` mounts under the list in an error boundary. |
-| GUI modal (`⌃⇧A`) | Same scopes; rows pre-rendered main-side (`artifacts:list` IPC) so the renderer stays node-free. Hover → copy / remove. |
+| TUI rail (`ctrl+shift+a`) | Read-only column docked right of the chat screen, 34 cells: kind headers, bullet rows (PR state tints the bullet), path tails. Click a row to open its href. Hides itself under 110 columns; the toggle survives. Live via the same change ticks as the modal. |
+| TUI actions modal | Opened from the rail's `⋯ actions` footer: `↵` open href · `tab` session ↔ project · `c` copy locator · `d` remove. Grouped by kind, built-ins first; extension `renderDetail` mounts under the list in an error boundary. |
+| GUI rail (`⌃⇧A`, header chip, `⋯` menu) | 288 px column right of transcript + composer, under the header; session scope only (the project-wide view belongs to the project page). No controls of its own — the chip / shortcut open and close it. Hover → copy / remove, PR rows lazily refresh on first hover. Header chip shows the live count. Rows pre-rendered main-side (`artifacts:list` IPC). |
 | Sessions list | `N artifacts` badge from `artifactCount` (hidden at 0 or when the store doesn't report it). |
 | `#` completion | Shares the trigger with chats. `#pr` / `#br` / `#file` rank by kind alias; selecting inserts the locator as plain text (no reference grammar). |
 
@@ -118,10 +120,23 @@ All additive: a pre-artifact daemon rejects the methods and clients treat that a
 
 `resolve()` is never polled. UIs call it once per focused row per open (`refreshArtifact(artifact, registry)`), persist the patched row through the store or `artifacts.upsert`, and the change signal re-converges other windows. The built-in `pull_request` resolver queries the GitHub API (bearer token from `GITHUB_TOKEN` / `GH_TOKEN` when set, 4 s timeout), writes `meta.state` (`open` / `draft` / `merged` / `closed`), `title`, `resolvedAt`, and skips terminal states and entries fresher than 5 minutes.
 
+## Disabling
+
+`Settings.artifacts` (default on; TUI Settings → UI, GUI Settings → Chat → Artifacts) is the master switch. Off:
+
+- the `artifacts` preset is not composed — no detectors, no `record_artifact` tool;
+- `AgentOptions.artifacts: false` makes the loop ignore `metadata.artifacts` entirely (covers extension detectors too);
+- `ctx.artifacts` scope is detached — reads answer `[]`, `record` returns `undefined`;
+- the rail, the `▢` chip, `ctrl+shift+a` / `⌃⇧A`, GUI header chip, sessions badge and `#pr` completion are hidden.
+
+No `/` command exists for artifacts on purpose: slash commands are the agent's vocabulary, UI chrome stays in the frame.
+
+Existing rows are kept, not deleted; turning it back on shows them again. The TUI rebuilds the agent on toggle (the preset is a build-time input).
+
 ## Known gaps
 
 - **PR / commit / branch attribution.** Detected from shell output, these carry no local path, so `projectRoot` is the session's root; `cd ../other && gh pr create` files under the current project. Fix needs the execution cwd on the detect outcome plus `cd` parsing, or an `owner/repo` → checkout map.
-- **Staleness.** `git commit --amend` records a second commit; deleted files/branches persist until removed (`d` / `×`).
+- **Staleness.** `git commit --amend` records a second commit; deleted branches persist until removed (`d` / `×`).
 - **Remote / file-map stores** don't implement artifacts (by design); everything degrades to empty.
 - **Background shells.** Output that never reaches a tool result isn't detected; `record_artifact` is the model's escape hatch.
 

package/docs/CHAT.md

@@ -98,7 +98,7 @@ Every named export lives in one file under `src/chat/`; each row is `<module>`
 | `store` | `eventsFromTurns`, `listSessionMeta`, `deriveSessionTitle`, transcript-view rules. See **Session reconstruction**. |
 | `streaming` | `useStreamBuffer`, `finalizeStreamingMarkdown(ForOwner)`, `turnContextSize`. See **Streaming buffer**. |
 | `completion`, `completion-skills`, `completion-files`, `completion-chats`, `completion-artifacts`, `completion-commands` | `useCompletion` + built-in providers (`/` skills & commands, `@` files, `#` chats & artifacts). See **Completion**. |
-| `commands`, `builtin-commands` | `Command`/`CommandStep`, `executeCommand`, `createBuiltinCommands` (`/help`, `/reload`, `/artifacts`). See **Commands**. |
+| `commands`, `builtin-commands` | `Command`/`CommandStep`, `executeCommand`, `createBuiltinCommands` (`/help`, `/reload`). See **Commands**. |
 | `markdown-segments`, `prompt-segments` | Markdown → renderable segments; `splitPromptSegments` for submitted-prompt chip highlighting. |
 | `session-export` | `renderSession`, `writeSessionExport`. See **Session export**. |
 | `generate-title` | `generateSessionTitle`, `cleanTitle`. See **Title generation**. |
@@ -260,6 +260,7 @@ Both join `[...doctrine, userInstructions]` as the **static** half and `[envSect
 | `smoothStreaming` | `boolean` | `true` | |
 | `fileLogging` | `boolean` | `false` | The in-TUI Logs panel works regardless (in-memory). |
 | `showTodoIndicator`, `showUsageIndicator`, `showThrobber` | `boolean` | `true`, `true`, `false` | See **Todos**, **Subscription usage**. |
+| `artifacts` | `boolean` | `true` | Master switch for session artifacts (detection, `record_artifact`, every surface). See [ARTIFACTS.md § Disabling](./ARTIFACTS.md#disabling). |
 | `checkForUpdates` | `boolean` | `true` | |
 | `subscriptionUsage` | `boolean` | `true` | Gates *automatic* usage probes; see **Subscription usage**. |
 | `uiMode` | `'full'\|'minimal'` | `'full'` | |
@@ -738,7 +739,7 @@ Anchor walks upward from `cwd` looking for `.git`; the first hit anchors to that
 
 ## Session artifacts
 
-`SessionStore` carries three **optional** methods — `upsertArtifact`, `listArtifacts`, `deleteArtifact` — and `SessionMetaRow` an optional `artifactCount`; a store that omits them degrades to empty artifact listings rather than throwing. `Session.addArtifact(input, origin)` / `Session.listArtifacts(filter?)` are the per-session convenience wrappers built on top. The `/artifacts` built-in command (`createBuiltinCommands` in `src/chat/builtin-commands.ts`, alongside `/help` and `/reload`) lists what a session or project produced, and the `#` completion trigger is shared between the chats provider (`completion-chats.ts`) and the artifacts provider (`completion-artifacts.ts`) — see **Completion**. Full schema, kinds, and the extension-facing `artifact:add` surface are owned by `docs/ARTIFACTS.md`.
+`SessionStore` carries three **optional** methods — `upsertArtifact`, `listArtifacts`, `deleteArtifact` — and `SessionMetaRow` an optional `artifactCount`; a store that omits them degrades to empty artifact listings rather than throwing. `Session.addArtifact(input, origin)` / `Session.listArtifacts(filter?)` are the per-session convenience wrappers built on top. There is deliberately no `/artifacts` command — artifacts are UI chrome (rail, title-bar chip, sessions badge), not agent vocabulary. The `#` completion trigger is shared between the chats provider (`completion-chats.ts`) and the artifacts provider (`completion-artifacts.ts`) — see **Completion**. `Settings.artifacts` is the master switch. Full schema, kinds, and the extension-facing `ctx.artifacts` surface are owned by `docs/ARTIFACTS.md`.
 
 ## Commands
 
@@ -750,7 +751,6 @@ Anchor walks upward from `cwd` looking for `.git`; the first hit anchors to that
 |---|---|---|
 | `/help` | — | Lists `opts.getCommands()` (built-ins + extensions), read live so it stays accurate after `/reload`. |
 | `/reload` | `opts.reloadExtensions` | Re-discovers, re-runs `setup`, tears down the old extension instances. Omitted from the list on hosts without one. |
-| `/artifacts [project\|session]` | `opts.artifacts` | Lists what the session (or every session in the project) produced. A host with a modal (the TUI) opens it instead of emitting markdown. Omitted on hosts without a session store. |
 
 `createCommandsCompletionProvider` (trigger `/`, shared with skills) suggests from the live merged command list. Authoring a new command — the full `Command` shape, `CommandInteraction`, `generateData`/`spawnAgents` — is documented in `docs/EXTENSIONS.md`; this module is the runtime that executes whatever a `Command` describes.
 

package/docs/EXTENSIONS.md

@@ -128,7 +128,7 @@ Three namespaces:
 | `registerContextPanelSection(section)` | Richer context panel section (`id`, `title`, rows, optional async `load`) | Normalized into the same model as above |
 | `registerToolResultMetadata(registration)` | Interpret namespaced metadata attached to tool results | Can project entries into context-panel rows |
 | `registerArtifactKind({ kind, label, detect?, validateMeta?, render?, resolve? })` | Give meaning to a session artifact kind | Global namespace, first registration wins. See [ARTIFACTS.md](./ARTIFACTS.md) |
-| `artifacts.list(query)` / `artifacts.find(kind, uri)` | Read the artifact store | Late-bound like `sessions`: `[]` when detached. See [ARTIFACTS.md](./ARTIFACTS.md) |
+| `artifacts.list(query)` / `artifacts.find(kind, uri)` / `artifacts.record(input)` | Read the artifact store; record one from host-side code (a `/` command that ran `gh pr create`) | Late-bound like `sessions`: reads `[]`, `record` `undefined`, when detached. See [ARTIFACTS.md](./ARTIFACTS.md) |
 | `registerRunTransform(fn)` | Rewrite `agent.run()` options before precondition checks | Synchronous, applied in extension order; throws logged under `ZIDANE_DEBUG` and ignored |
 | `registerBehaviorTransform(fn)` | Rewrite resolved behavior (`maxTurns`, retry, budgets) | Run-level `behavior` options re-applied after, so explicit caller choices win |
 | `registerProviderMiddleware(fn)` | Wrap provider instances (tracing, fallback, metrics, policy) | Runs per provider-factory call; `undefined` return = pass-through |
@@ -164,7 +164,7 @@ ctx.tui.setStatus('✓ indexed', { timeout: 3000 })                // transient
 ctx.tui.setBanner(['review pending: 3 files'], { timeout: 10_000 }) // block above the prompt
 ctx.tui.setStatus(null)                                          // clear (also wiped on disposal)
 
-// Artifact detail pane in the /artifacts modal (row rendering is on the
+// Artifact detail pane in the TUI artifacts modal (row rendering is on the
 // renderer-agnostic registerArtifactKind({ render })):
 ctx.tui.registerArtifactRenderer({
   kind: 'my-ext.deployment',

package/docs/IPC.md

@@ -156,6 +156,7 @@ Host → every connected client, one push channel. Source of truth:
 | `event` | Canonical `StreamEvent`; `echo: true` marks the sender's own send/steer echo. |
 | `compacting:start` | Manual or auto-compaction began. |
 | `compacting:progress` | Live summary-token estimate during an in-flight compaction. |
+| `stream:progress` | Live counters for the streaming parent turn (`outputTokens`, `estimated`, `elapsedMs`, optional `estCostUsd`), throttled ~4/s plus one final tick before the turn settles. Clients fold `estCostUsd` into the session cost until the matching `turn:end`. |
 | `compacting:end` | Compaction finished; `effectiveTokens` (success only) is the post-compact estimate. |
 | `prompt-turns` | Persisted prompt turns, reduced to `PromptTurnRef` (id + texts) for echo binding. |
 | `model:fallback` | The run fell back off its primary model. |
@@ -347,7 +348,7 @@ store at the next run-end resync; **gap** = known missing cabling.
 | Todos indicator + editing modal | synced | `todos:snapshot` mirror; `todos.set` writes the live `Session` |
 | Running work + ctrl+k cancel picker | synced | `work:snapshot` mirror; cancel via `chat.cancelWork` |
 | Context panel (ctrl+?) | synced | `sessions.contextBreakdown` RPC |
-| Artifacts (`/artifacts`, badges, `#pr` completion) | synced | see [ARTIFACTS.md § IPC](./ARTIFACTS.md#ipc) |
+| Artifacts (rail, badges, `#pr` completion) | synced | see [ARTIFACTS.md § IPC](./ARTIFACTS.md#ipc) |
 | History edits (selection modal) | synced | store refresh, `chat.rebuildAgent`, `sessions.touch` |
 | History search (transcript + cross-session) | synced + accelerated | `history.searchSession`/`searchAll`, daemon LRU cache |
 | Provider-retry indicator | synced | `stream:retry`; clears on resume / run end |

package/docs/README.md

@@ -34,7 +34,7 @@ Each topic has exactly one owner doc; the others link to it. If two docs seem to
 | Settings keys and defaults | CHAT.md § Settings |
 | Safe mode, approvals, per-edit approval | CHAT.md § Safe mode / Per-edit approval |
 | Todos (`todowrite`) contract | CHAT.md § Todos |
-| Slash commands (`/help`, `/artifacts`, extension commands) | CHAT.md § Commands (runtime) · EXTENSIONS.md (authoring) |
+| Slash commands (`/help`, `/reload`, extension commands) | CHAT.md § Commands (runtime) · EXTENSIONS.md (authoring) |
 | `@` `/` `#` `!` completion | CHAT.md § Completion |
 | Keybindings and rebinding | TUI.md § Keyboard |
 | A modal or screen | TUI.md § Modals / Screens |

package/docs/SKILL.md

@@ -328,6 +328,7 @@ Every event in `AgentHooks` (`src/agent.ts`), one row each. `child:*` bubble eve
 | `stream:thinking` | Each reasoning chunk | — | `delta, thinking` |
 | `stream:text` | Each text chunk | — | `delta, text` |
 | `stream:end` | Text stream complete (only if text present) | — | `text` |
+| `stream:progress` | Throttled (~4/s) while the parent turn streams, plus one final tick before `stream:end`; not bubbled for subagents | — | `elapsedMs, outputTokens, estimated, inputTokens?, cacheRead?, cacheCreation?, estCostUsd?` — provider-counted when the wire reports usage mid-stream (`StreamCallbacks.onUsage`), else chars ÷ 4; `estCostUsd` absent for unpriced models and flat-rate (subscription) traffic |
 | `stream:server_tool_use` | Provider-executed tool invocation closes (e.g. Anthropic `web_search_20250305`) | — | `id, name, input` |
 | `stream:server_tool_result` | Matching provider-executed tool result closes | — | `toolUseId, toolName, content` |
 | `stream:error` | Provider stream rejects before `stream:end` | — | `err, statusCode?, requestId?` — never fires on user aborts (those land on `agent:abort`) |

package/docs/TUI.md

@@ -135,7 +135,7 @@ Every action routes through `<userDir>/keybindings.json`, matched via `matchesBi
 | `ctrl+m` | `openModelPicker` | chat (idle) | cross-provider model picker |
 | `ctrl+l` | `openEffortPicker` | chat (idle, model has reasoning or options) | open `ModelOptionsPickerModal` (reasoning effort + feature toggles, e.g. fast mode) |
 | `ctrl+t` | `openTodos` | chat (session attached) | open `TodosModal` (read-only) |
-| `ctrl+shift+a` | `openArtifacts` | chat (session attached) | open `ArtifactsModal` — same modal as `/artifacts`. Collapses to `ctrl+a` without kitty; rebind there |
+| `ctrl+shift+a` | `openArtifacts` | chat (session attached) | toggle the artifacts rail (`ArtifactsPanel`) — same as clicking the `▢` chip on the chat title bar; the rail's `⋯ actions` footer opens the modal. Collapses to `ctrl+a` without kitty; rebind there |
 | `ctrl+shift+g` | `openContextPanel` | chat | context-usage breakdown (read-only). Collapses to `ctrl+g`; rebind there |
 | `ctrl+shift+m` | `openMainSession` | any, when `Settings.orchestration` is on | jump to (or lazily create) the pinned Main orchestration session for the cwd; requires the daemon runtime. Silent no-op when the setting/runtime is off |
 | `ctrl+p` | `openUsagePanel` | chat | subscription usage panel; also opens by clicking the footer's `▰ 5h 43%` segment |
@@ -207,9 +207,13 @@ Inline-mounted in `ChatScreen`'s transcript slot (not stacked); keyed on `reques
 
 The above-prompt "in progress" bar this modal replaced is gone — the same signal now renders as a footer hint chip (`N/M todos`, from `todoProgressLabel`), gated on `Settings.showTodoIndicator`, clickable to open the modal. Every `todowrite` call in the transcript also gets an inline "what's in progress" sub-list under the formatted call line (reads that call's own `input.todos`, not live session state).
 
+### ArtifactsPanel
+
+`ctrl+shift+a` (`openArtifacts`) toggles a read-only rail docked right of the chat screen (`artifacts-panel.tsx`, 34 cells): kind headers, bullet rows with PR state, path tails, row click opens the href. Auto-hides below 110 columns (the toggle survives). `ChatScreen` receives `frameWidth` so its title-overlay budget tracks the narrower border. Actions live in the modal below.
+
 ### ArtifactsModal
 
-`ctrl+shift+a` (`openArtifacts`) or `/artifacts` (`/artifacts project` for project scope) — what the session produced: pull requests, branches, commits, created files, extension-contributed kinds. `tab` toggles session ↔ project scope, `↵` opens the focused row's href (browser/editor), `c` copies its locator, `j` jumps to the producing turn (session scope only), `d` removes it. Live via a `subscribe` tick (local `artifact:recorded` hook, or daemon `artifact:recorded`/`artifact:changed`) so artifacts created while the modal is open appear without a re-open. Extension `renderDetail` panes mount under the list inside an error boundary. Semantics + extension API: [ARTIFACTS.md](./ARTIFACTS.md).
+Opened from the rail's `⋯ actions` footer — what the session produced: pull requests, branches, commits, recorded files, extension-contributed kinds. `tab` toggles session ↔ project scope, `↵` opens the focused row's href (browser/editor), `c` copies its locator, `j` jumps to the producing turn (session scope only), `d` removes it. Live via a `subscribe` tick (local `artifact:recorded` hook, or daemon `artifact:recorded`/`artifact:changed`) so artifacts created while the modal is open appear without a re-open. Extension `renderDetail` panes mount under the list inside an error boundary. Semantics + extension API: [ARTIFACTS.md](./ARTIFACTS.md).
 
 ### ContextPanelModal
 
@@ -357,7 +361,8 @@ src/tui/
   file-edit-approval-modal.tsx  SingleEditApprovalModal + MultiEditApprovalModal + UnresolvedHunkPanel; inline-mounted, keyed on request.id
   cancel-tool-modal.tsx         In-flight tool picker (ctrl+k)
   todos-modal.tsx               Read-only todowrite viewer (ctrl+t); falls back to the archive snapshot when the live list is empty
-  artifacts-modal.tsx           Session/project artifacts (ctrl+shift+a, /artifacts) — see ARTIFACTS.md
+  artifacts-panel.tsx           Read-only artifacts rail docked right of ChatScreen (ctrl+shift+a) — see ARTIFACTS.md
+  artifacts-modal.tsx           Session/project artifacts with actions (rail footer) — see ARTIFACTS.md
   context-panel.tsx             Context-usage breakdown (ctrl+shift+g)
   usage-panel.tsx               Subscription usage panel (ctrl+p)
   use-provider-usage.ts         useActiveProviderUsage (footer) + useAllProviderUsage (panel) hooks

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "zidane",
-  "version": "7.0.16",
+  "version": "7.0.17",
   "description": "an agent that goes straight to the goal",
   "type": "module",
   "private": false,