zidane 7.1.8 → 7.1.9

package/dist/types.d.ts

@@ -1,4 +1,4 @@
-import { $g as SessionHookContext, A_ as ToolDescriptionTarget, Ah as AnthropicParams, Bg as PromptDocumentPart, Br as InteractionToolOptions, C as SuccessfulMutationOutcome, C_ as TurnUsage, Cm as StreamOptions, D_ as ToolContext, Dm as ToolSpec, E_ as toolResultToText, Eg as DEFAULT_AGENT_CLOCK, Em as ToolResult, F_ as ReadStateMap, G_ as ToolStateOp, Gg as RepeatGuardConfig, Hg as PromptPart, Ig as OAuthRefreshHookContext, Jg as ResolveContentRefBlock, Ji as AgentHookMap, K_ as ToolStateStore, Kg as RepeatGuardToolMatcher, Lg as ProgressNudgeKind, M_ as ToolMap, Mg as McpToolHookContext, O_ as ToolDef, Om as TurnResult, P_ as ReadStateEntry, Q_ as SkillConfig, Qg as SessionEndStatus, Rg as ProgressNudgeMessage, S as MutationValidationResult, S_ as TurnFinishReason, Sm as StreamCallbacks, T_ as toolOutputByteLength, Tm as ToolCall, U_ as StagedToolState, Ug as PromptTextPart, Vg as PromptImagePart, W_ as ToolStateController, Wg as PromptVideoPart, Xg as RunHookMap, Xi as AgentOptions, Yg as RetryConfig, Yi as AgentHooks, Zg as SessionContentBlock, Zi as AgentToolState, _ as statsByModel, __ as ToolResultImageContent, _g as AgentStats, a_ as StreamHookContext, av as Session, b as MutationValidationHooksOptions, b_ as ToolResultTextContent, bm as ProviderCapabilities, cv as SessionRun, d_ as ToolHookContext, e_ as SessionMessage, ev as SkillResource, f_ as ToolOutcome, g_ as ToolResultDocumentRefContent, gc as SpawnToolState, gg as AgentRunOptions, h as flattenTurns, h_ as ToolResultDocumentContent, hc as SpawnToolOptions, hg as AgentClock, j_ as ToolDescriptions, jg as McpServerConfig, k_ as ToolDescriptionOverride, l_ as ThinkingLevel, lh as OpenAIParams, lv as SessionStore, m_ as ToolResultContent, mg as AgentBehavior, n_ as SpawnHookContext, nv as SkillsConfig, ov as SessionData, p as ModelUsage, p_ as ToolResultAudioContent, q_ as ToolStateView, qg as ResolveContentRef, qi as Agent, rv as CreateSessionOptions, t as Preset, t_ as SessionTurn, uc as ChildAgent, uy as McpConnection, v as MutationValidationBatch, v_ as ToolResultImageRefContent, vr as ValidationResult, w_ as toolOutputBudgetByteLength, x as MutationValidationMutation, x_ as ToolResultVideoContent, xg as ChildRunStats, xh as CerebrasParams, y as MutationValidationFailure, y_ as ToolResultMetadata, ym as Provider, yv as RemoteStoreOptions, zg as PromptAudioPart, zm as OpenRouterParams } from "./index-DCYh6lOp.js";
+import { $g as ProgressNudgeMessage, A_ as ToolResultDocumentContent, Ac as SpawnToolOptions, Ag as AgentClock, B_ as toolOutputByteLength, Bm as ToolCall, Br as InteractionToolOptions, C as SuccessfulMutationOutcome, Cv as SessionRun, D_ as ToolOutcome, E_ as ToolHookContext, F_ as ToolResultTextContent, Fm as ProviderCapabilities, G_ as ToolDescriptionTarget, Gh as AnthropicParams, H_ as ToolContext, Hm as ToolSpec, I_ as ToolResultVideoContent, Ig as ChildRunStats, Ih as CerebrasParams, Ji as AgentHookMap, K_ as ToolDescriptions, Kg as McpServerConfig, L_ as TurnFinishReason, Lm as StreamCallbacks, M_ as ToolResultImageContent, Mg as AgentStats, N_ as ToolResultImageRefContent, O_ as ToolResultAudioContent, P_ as ToolResultMetadata, Pm as Provider, Pv as RemoteStoreOptions, Qg as ProgressNudgeKind, R_ as TurnUsage, Rm as StreamOptions, S as MutationValidationResult, Tc as ChildAgent, Ty as McpConnection, U_ as ToolDef, Um as TurnResult, V_ as toolResultToText, Vg as DEFAULT_AGENT_CLOCK, Vm as ToolResult, W_ as ToolDescriptionOverride, X_ as ReadStateMap, Xi as AgentOptions, Y_ as ReadStateEntry, Yi as AgentHooks, Zg as OAuthRefreshHookContext, Zi as AgentToolState, _ as statsByModel, __ as SpawnHookContext, _v as SkillsConfig, a_ as PromptVideoPart, av as ToolStateController, b as MutationValidationHooksOptions, b_ as StreamHookContext, bv as Session, c_ as ResolveContentRef, cv as ToolStateView, d_ as RunHookMap, e_ as PromptAudioPart, eh as OpenRouterParams, f_ as SessionContentBlock, g_ as SessionTurn, h as flattenTurns, h_ as SessionMessage, hv as SkillResource, i_ as PromptTextPart, iv as StagedToolState, j_ as ToolResultDocumentRefContent, jc as SpawnToolState, jg as AgentRunOptions, k_ as ToolResultContent, kg as AgentBehavior, l_ as ResolveContentRefBlock, m_ as SessionHookContext, n_ as PromptImagePart, o_ as RepeatGuardConfig, ov as ToolStateOp, p as ModelUsage, p_ as SessionEndStatus, pv as SkillConfig, q_ as ToolMap, qg as McpToolHookContext, qi as Agent, r_ as PromptPart, s_ as RepeatGuardToolMatcher, sv as ToolStateStore, t as Preset, t_ as PromptDocumentPart, u_ as RetryConfig, v as MutationValidationBatch, vr as ValidationResult, vv as CreateSessionOptions, w_ as ThinkingLevel, wh as OpenAIParams, wv as SessionStore, x as MutationValidationMutation, xv as SessionData, y as MutationValidationFailure, z_ as toolOutputBudgetByteLength } from "./index-dXnPmqFx.js";
 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 { C as TaskHandle, S as TaskExitInfo, c as ContextCapabilities, d as ContextType, f as DetachedTasksCapability, h as ExecutionHandle, l as ContextHardening, m as ExecutionContext, p as ExecResult, s as BackgroundTaskStatus, w as TaskStallInfo, x as TaskEntry, y as SpawnConfig } from "./isolation-Kfoof0MM.js";
 import { t as SandboxProvider } from "./sandbox-BH0WQkXn.js";

package/docs/EXTENSIONS.md

@@ -99,7 +99,7 @@ Three namespaces:
 |---|---|---|
 | `ctx.*` (root) | Renderer-agnostic — folds into the agent and config | never |
 | `ctx.tui.*` | OpenTUI-specific (keybindings, modals, footer hints) | non-TUI host (GUI / SDK) |
-| `ctx.gui.*` | Reserved for the future GUI shell | every host today |
+| `ctx.gui.*` | Deprecated alias namespace (`registerPanel` forwards to the root call) | never |
 
 ### Renderer-agnostic
 
@@ -127,6 +127,7 @@ Three namespaces:
 | `registerContextBreakdownSection(fn)` | Existing low-level context panel contributor | May return one section or an array; async is supported |
 | `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 |
+| `registerPanel({ id, label, icon?, load, subscribe?, onAction? })` | A tab in the side panel (TUI rail / GUI side panel) fed by declarative, JSON-safe content | Renderer-agnostic: the same registration paints in both hosts. See [PANELS.md](./PANELS.md) |
 | `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)` / `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 |
@@ -260,11 +261,7 @@ Extension bindings appear in `Settings → Keybindings` under a trailing **Exten
 
 ### GUI-specific
 
-```ts
-ctx.gui.registerPanel({ id, label, render })
-```
-
-Calls land in the registry, but GUI panels aren't rendered yet. GUI parity wired today: extension discovery/settings, extension summaries, completion providers, and completion submit hooks (`resolveReferences` / `onSubmit`) through IPC.
+There is no GUI-only registration surface. Panels are renderer-agnostic (`ctx.registerPanel`, see [PANELS.md](./PANELS.md)); `ctx.gui.registerPanel` is kept as a deprecated alias that forwards there. GUI parity wired today: extension discovery/settings, extension summaries, completion providers, completion submit hooks (`resolveReferences` / `onSubmit`), themes, and panels through IPC.
 
 ## How it boots
 
@@ -516,6 +513,30 @@ ctx.registerProviderMiddleware(provider => ({
 
 Transforms are synchronous and fail-open — use them for cheap composition decisions (budget caps, tool catalog shaping, provider wrappers). Put I/O in provider middleware, hooks, or tools.
 
+### A side panel
+
+```ts
+ctx.registerPanel({
+  id: 'ci',
+  label: 'CI',
+  icon: { gui: 'i-lucide-check-circle', tui: '✓' },
+  load: async () => {
+    const runs = await fetchRuns()
+    return {
+      badge: runs.filter(r => r.status === 'failed').length,
+      sections: [{ id: 'runs', title: 'Latest runs', items: runs.map(r => ({
+        kind: 'row', title: r.workflow, status: r.status, href: r.url,
+      })) }],
+      actions: [{ id: 'refresh', label: 'Refresh' }],
+    }
+  },
+  subscribe: emit => { const t = setInterval(emit, 30_000); return () => clearInterval(t) },
+  onAction: id => { if (id === 'refresh') invalidateRuns() },
+})
+```
+
+Data, not components: the host paints rows, key/value facts, markdown and actions; `custom` items may name a `ctx.tui.registerRenderer` id with a markdown fallback for the GUI. Full model in [PANELS.md](./PANELS.md); working example in `examples/extensions/git-changes/`.
+
 ### Session artifacts
 
 An extension gives meaning to an artifact `kind` — a durable, typed pointer to something a session produced (PR, branch, commit, file, deployment). Full model, storage, and surfaces: [ARTIFACTS.md](./ARTIFACTS.md).

package/docs/PANELS.md

@@ -0,0 +1,86 @@
+# Panels
+
+Side-panel tabs next to the transcript, in both the TUI (docked rail) and the GUI (resizable side panel). Built-in: **Artifacts**. Extensions add their own with `ctx.registerPanel`.
+
+## Model
+
+A panel is data, never UI. The extension returns a JSON-safe `PanelContent`; each host paints it with its own components. This is what lets one registration work in-process (TUI) and across the Electron IPC boundary (GUI, where extensions run in the main process and the panel paints in the renderer).
+
+```ts
+ctx.registerPanel({
+  id: "changes", // namespaced to '<extension>/changes'
+  label: "Git",
+  icon: { gui: "i-lucide-git-branch", tui: "⎇" },
+  load: async ({ cwd, sessionId }) => ({
+    badge: 3, // number or short string on the tab
+    sections: [
+      {
+        id: "branch",
+        items: [{ kind: "kv", rows: [{ label: "branch", value: "main" }] }],
+      },
+      {
+        id: "changes",
+        title: "Changed files",
+        items: [
+          {
+            kind: "row",
+            title: "src/a.ts",
+            status: "M",
+            subtitle: "modified",
+            actionId: "open",
+            payload: "src/a.ts",
+          },
+        ],
+      },
+    ],
+    actions: [{ id: "refresh", label: "Refresh" }],
+    empty: "Working tree clean.",
+  }),
+  subscribe: (emit) => ctx.registerHook("tool:after", () => emit()),
+  onAction: async (actionId, payload, { cwd }) => {
+    /* runs where the extension runs */
+  },
+});
+```
+
+### `PanelContent`
+
+| Field        | Meaning                                                        |
+| ------------ | -------------------------------------------------------------- |
+| `title?`     | Overrides the tab label inside the panel header                |
+| `badge?`     | `number` (capped at `99+`) or short string; `0` / `''` hide it |
+| `sections[]` | `{ id, title?, items[], collapsed? }`                          |
+| `actions?`   | Footer buttons `{ id, label, tone?: 'danger' }`                |
+| `empty?`     | Text shown when every section is empty                         |
+
+### Items
+
+| `kind`     | Shape                                                   | Rendering                                                                                                                                                 |
+| ---------- | ------------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------- |
+| `row`      | `ExtensionArtifactRow` + `id?`, `actionId?`, `payload?` | Same look as an artifact row: status chip, title, subtitle, badges. Click fires `onAction(actionId, payload)`; without an action, `href` opens externally |
+| `markdown` | `{ text }`                                              | GUI: rendered markdown. TUI: plain lines, clipped                                                                                                         |
+| `kv`       | `{ rows: [{ label, value }] }`                          | Two-column facts                                                                                                                                          |
+| `custom`   | `{ renderer, data?, fallback }`                         | TUI: the renderer registered via `ctx.tui.registerRenderer`; GUI and any host without it: `fallback` as markdown                                          |
+
+Everything passes through `normalizePanelContent` before it is painted or crosses IPC: unknown kinds and malformed entries are dropped, strings are capped, and the payload is bounded (`PANEL_CONTENT_LIMITS`). A panel can never take the UI down: a throwing or hanging `load` yields an empty panel with the error text.
+
+### Lifecycle
+
+- `load()` runs when the tab becomes visible and after each `subscribe` emit (debounced 150 ms, both hosts). Hidden tabs are not reloaded; in the GUI they show a pending dot until opened.
+- `subscribe(emit)` is started when the tab is visible and stopped when it is not (GUI) or when the rail unmounts (TUI). Return an unsubscribe.
+- `onAction` runs host-side; the panel reloads afterwards. Failures surface as an error line in the panel.
+- Disabling the extension removes its tab; `/reload` re-registers.
+
+## Host behaviour
+
+Both hosts share `chat/panels.ts`:
+
+- **Catalog**: built-ins first, then extension panels in load order. Duplicate ids are dropped.
+- **State**: `open`, `activeId`, and a proactive-open gate. `openProactive(id)` (an agent or extension asking to show a tab) is honoured only while the user has not picked a tab since the last honoured proactive open, so nothing yanks the panel away from a tab the user chose.
+- **Keybindings**: `openArtifacts` toggles the panel (`ctrl+shift+a`), `panelNext` / `panelPrev` cycle tabs (`ctrl+shift+]` / `[`). Same defaults in the TUI and the GUI.
+
+GUI specifics: the panel is drag-resizable (280–720 px, persisted on release, double-click the handle to reset), slides open/closed with the motion preference, and the tab strip shows badges and pending dots. TUI specifics: fixed 34-cell rail, hidden below 110 columns, tabs are clicked or cycled, rows and actions are clicks.
+
+## Example
+
+`examples/extensions/git-changes/`: a live "Git" tab listing working-tree changes, refreshed after every tool call, with `Refresh` and `Stage all` actions. Copy it to `.zidane/extensions/git-changes/` in a project (with "Load project extensions" enabled) or to `~/.zidane/extensions/git-changes/`.

package/docs/README.md

@@ -16,6 +16,7 @@ Each topic has exactly one owner doc; the others link to it. If two docs seem to
 | Chat + surfaces | [TUI.md](./TUI.md) | `zidane/tui`: screens, **keybindings table**, modals, transcript rendering, code highlighting, embedding, file layout. |
 | Chat + surfaces | [IPC.md](./IPC.md) | `zidane/ipc`: daemon lifecycle, **every RPC and signal**, multi-window convergence, TUI/GUI parity matrix, `zidane attach`. |
 | Chat + surfaces | [ARTIFACTS.md](./ARTIFACTS.md) | Session artifacts: model, producers, storage, extension kinds, surfaces, RPCs, lazy refresh. |
+| Chat + surfaces | [PANELS.md](./PANELS.md) | Side panels: the declarative content model, `ctx.registerPanel`, catalog + open-state rules shared by the TUI rail and the GUI side panel. |
 | Chat + surfaces | [EXTENSIONS.md](./EXTENSIONS.md) | Extensions: `defineExtension`, **the full `ctx` API**, discovery, install, collisions, settings UI, authoring patterns. |
 | Integrations | [PLUGINS.md](./PLUGINS.md) | Agent Plugins 1.0.0 loader: manifest, validation, filesystem boundary. |
 | Integrations | [ACP.md](./ACP.md) | Agent Client Protocol adapter: `zidane-acp`, editor config, stdio framing. |
@@ -31,6 +32,7 @@ Each topic has exactly one owner doc; the others link to it. If two docs seem to
 | Writing a custom tool or preset | SKILL.md § Tools / Presets |
 | Session persistence, `SessionStore` backends, sqlite schema | CHAT.md § Sessions |
 | Artifacts (PRs, files a session produced) | ARTIFACTS.md |
+| A side-panel tab (extension or built-in) | PANELS.md |
 | 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 |

package/package.json

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