@hachej/boring-agent 0.1.41 → 0.1.43

package/README.md

@@ -7,291 +7,70 @@
 
 </div>
 
-A pane-embeddable coding agent with three execution modes behind one interface. Ships as a standalone CLI (`npx @hachej/boring-agent`) and composes into any app shell.
+A pane-embeddable coding agent: an LLM agent loop, a tool catalog, and a chat UI
+behind one interface, with three swappable execution modes. The same agent,
+tools, and UI run in `direct` (host process), `local` (bwrap sandbox), or
+`vercel-sandbox` (Firecracker microVM) mode.
 
-```bash
-npx @hachej/boring-agent
-```
-
----
-
-## TL;DR
-
-**The Problem**: You want a coding agent in the browser — but also as a CLI — and you need it to run your code somewhere safe (or not). Existing solutions force you into one deployment model and one UI.
-
-**The Solution**: One package that ships a full LLM agent loop, tool catalog, and chat UI — with swappable execution backends. Same agent, same tools, same UI. Three modes. Zero config to start.
-
-### Why Use @hachej/boring-agent?
-
-| Feature | What It Does |
-|---------|--------------|
-| **Three execution modes** | `direct` (no isolation, macOS dev) / `local` (bwrap sandbox) / `vercel-sandbox` (Firecracker microVM) |
-| **CLI + embeddable** | `npx @hachej/boring-agent` works standalone; `<ChatPanel />` composes into any layout |
-| **7 standard tools** | `bash`, `read`, `write`, `edit`, `find`, `grep`, `ls` — ported from pi-coding-agent |
-| **Workspace-local runtime provisioning** | Generates `.boring-agent` inside the selected workspace for mirrored skills, SDKs, CLIs, and templates |
-| **Workspace-agnostic FS** | `Workspace` interface — agent tools and HTTP routes share the same filesystem view |
-| **Session management** | List, create, switch, delete sessions with streamed history hydration |
-| **UI bridge** | Agent opens files, panels, and surfaces in the workbench via typed commands |
-| **Model picker + thinking toggle** | Inline in the composer — switch models and reasoning depth per message |
-
-### Quick Example
+## Install
 
 ```bash
-# Start the agent in your current directory — zero setup
-npx @hachej/boring-agent
-
-# Or run with a specific workspace root
-BORING_AGENT_WORKSPACE_ROOT=/path/to/project npx @hachej/boring-agent
-
-# Set the API key
-ANTHROPIC_API_KEY=sk-ant-... npx @hachej/boring-agent
-
-# Run in local sandbox mode (Linux + bubblewrap)
-BORING_AGENT_MODE=local npx @hachej/boring-agent
-```
-
-In the browser chat, try:
-```
-read the README and summarize it
-find all TypeScript files that import "react"
-write a test for src/utils.ts
-```
-
----
-
-## Workspace-local runtime provisioning
-
-Boring UI keeps generated runtime state in the selected workspace at
-`$BORING_AGENT_WORKSPACE_ROOT/.boring-agent`. Plugin skills are mirrored to
-`.boring-agent/skills`, runtime CLIs live under `.boring-agent/node` or
-`.boring-agent/venv`, and templates seed only missing workspace files. The
-folder is generated/disposable and should not be hand-edited or committed.
-
-See [docs/runtime-provisioning.md](docs/runtime-provisioning.md) for the full
-user and plugin-author contract, including package metadata shape,
-`provisionWorkspace: false`, `/api/v1/agent/reload`, and direct/local/Vercel
-mode behavior.
-
----
-
-## Architecture
-
-```
-┌─────────────────────────────────────┐
-│         Chat UI (browser)           │
-│  Composer · Messages · SessionBar    │
-└──────────────────┬──────────────────┘
-                   │ UIMessage stream (SSE)
-┌──────────────────▼──────────────────┐
-│          Agent Harness              │
-│  (pi-coding-agent loop)             │
-└──────────────────┬──────────────────┘
-                   │ AgentTool[]
-┌──────────────────▼──────────────────┐
-│         Tool Catalog                │
-│  bash · read · write · edit         │
-│  find · grep · ls                   │
-└──────┬──────────────┬───────────────┘
-       │              │
-┌──────▼─────┐ ┌──────▼─────┐
-│ Workspace   │ │  Sandbox   │
-│ (fs ops)   │ │  (exec)    │
-│ read/write │ │  bwrap     │
-│ readdir    │ │  vercel    │
-└────────────┘ └────────────┘
-```
-
-**Two layers, clear boundary:**
-
-- **Layer 1 (Core runtime):** `AgentHarness` · `Catalog` · `Workspace` · `Sandbox` — interfaces locked; adapters swap per mode.
-- **Layer 2 (Integration):** `SessionStore` · `UiBridge` · `Provisioning` — replaceable plumbing, independent evolution.
-
-### Execution Modes
-
-| Mode | Workspace | Sandbox | Isolation | Use Case |
-|------|-----------|---------|-----------|----------|
-| `direct` | `NodeWorkspace` | `DirectSandbox` | None | macOS/Windows dev, quick tests |
-| `local` | `NodeWorkspace` | `BwrapSandbox` | bwrap process jail | Linux deployments, safer default |
-| `vercel-sandbox` | `VercelSandboxWorkspace` | `VercelSandboxExec` | Firecracker microVM | Multi-tenant, remote execution |
-
-**Pairing invariant:** Workspace + Sandbox must target the same filesystem substrate. The adapter factory enforces this at construction — mismatched pairs are impossible.
-
----
-
-## Installation
-
-```bash
-# npm
-npm install @hachej/boring-agent
-
-# pnpm
 pnpm add @hachej/boring-agent
-
-# standalone (no install needed)
-npx @hachej/boring-agent
-```
-
-### From Source
-
-```bash
-git clone https://github.com/hachej/boring-ui.git
-cd boring-ui
-pnpm install
-pnpm --filter @hachej/boring-agent build
-```
-
----
-
-## Quick Start
-
-### 1. As a CLI
-
-```bash
-# Set your API key
-export ANTHROPIC_API_KEY=sk-ant-...
-
-# Run in your project directory
-cd /path/to/project
-npx @hachej/boring-agent
+# or: npm install @hachej/boring-agent
 ```
 
-Opens `http://localhost:5200` with a full agent workspace pointed at your cwd.
+Peer deps (optional): `react`, `react-dom`, `tailwindcss`.
 
-### 2. Embedded in an App
+## Usage
 
-**Server:**
+**Server** — standalone Fastify app:
 
 ```ts
 import { createAgentApp } from "@hachej/boring-agent/server"
 
 const app = await createAgentApp({
-  mode: "local",              // "direct" | "local" | "vercel-sandbox"
+  mode: "local",                 // "direct" | "local" | "vercel-sandbox"
   workspaceRoot: process.cwd(),
-  apiBaseUrl: "http://localhost:3000",
 })
 await app.listen({ port: 3001 })
 ```
 
-**Frontend:**
-
-```tsx
-import { ChatPanel, useAgentChat } from "@hachej/boring-agent"
-import "@hachej/boring-agent/front/styles.css"
-
-function App() {
-  return <ChatPanel apiBaseUrl="http://localhost:3000" />
-}
-```
+To embed routes into an existing Fastify instance, use `registerAgentRoutes`
+instead. The full IDE shell (file tree, panes, UI-bridge tools) lives in
+`@hachej/boring-workspace`, which mounts this agent.
 
-### 3. Composed with Workspace
+**Frontend** — the chat panel:
 
 ```tsx
-import { WorkspaceProvider, IdeLayout } from "@hachej/boring-workspace"
 import { ChatPanel } from "@hachej/boring-agent"
+import "@hachej/boring-agent/front/styles.css"
 
 function App() {
-  return (
-    <WorkspaceProvider chatPanel={ChatPanel} workspaceId="proj-1">
-      <IdeLayout />
-    </WorkspaceProvider>
-  )
+  return <ChatPanel apiBaseUrl="http://localhost:3001" />
 }
 ```
 
----
-
-## Package Surfaces
-
-| Import | Environment | What You Get |
-|--------|-------------|--------------|
-| `@hachej/boring-agent` | Browser | `ChatPanel`, `SessionToolbar`, primitives, hooks, `theme.css` |
-| `@hachej/boring-agent/server` | Node | `createAgentApp`, routes, harness, sandbox, workspace adapters |
-| `@hachej/boring-agent/front` | Browser | Frontend-specific (same as top-level, explicit subpath) |
-| `@hachej/boring-agent/shared` | Any | `AgentHarness`, `Workspace`, `Sandbox`, `AgentTool`, `SessionStore` interfaces |
-| `@hachej/boring-agent/front/styles.css` | Browser | CSS custom properties for theming |
-| `@hachej/boring-agent/eval` | Node | Evaluation toolkit for agent behavior |
-
----
-
 ## Configuration
 
-### Environment Variables
-
-| Variable | Required | Default | Description |
-|----------|----------|---------|-------------|
-| `ANTHROPIC_API_KEY` | Yes | — | Anthropic API key for Claude |
-| `BORING_AGENT_MODE` | No | `direct` | `direct`, `local`, or `vercel-sandbox` |
-| `BORING_AGENT_WORKSPACE_ROOT` | No | `.` | Root directory for workspace |
-| `BORING_AGENT_DEFAULT_MODEL_PROVIDER` | No | `anthropic` | Default model provider |
-| `BORING_AGENT_DEFAULT_MODEL_ID` | No | `claude-sonnet-4-6` | Default model ID |
-| `VERCEL_OIDC_TOKEN` | Remote only | — | Required for `vercel-sandbox` mode |
-| `PORT` | No | `5200` | Server port |
-| `HOST` | No | `localhost` | Server host |
-
-### Config File
-
-`boring.app.toml` (optional, for embedded mode):
-
-```toml
-[runtime]
-mode = "local"           # direct | local | vercel-sandbox
-
-[model]
-default_provider = "anthropic"
-default_id = "claude-sonnet-4-6"
-```
-
----
-
-## Troubleshooting
-
-| Error | Cause | Fix |
-|-------|-------|-----|
-| `ANTHROPIC_API_KEY not set` | Missing API key | `export ANTHROPIC_API_KEY=sk-ant-...` |
-| `bwrap not found` (local mode) | bubblewrap not installed | `sudo apt install bubblewrap` (Debian/Ubuntu) |
-| `port already in use` | Port 5200 occupied | `PORT=5201 npx @hachej/boring-agent` |
-| `workspace root not found` | Invalid `BORING_AGENT_WORKSPACE_ROOT` | Point to an existing directory |
-| `Vercel sandbox auth failed` (remote mode) | Missing/invalid OIDC token | Set `VERCEL_OIDC_TOKEN` |
-| `model provider not supported` | Unknown provider in config | Use `anthropic` (only supported provider in v1) |
-
----
-
-## Limitations
-
-- **Single model provider**: Only Anthropic (Claude) is supported in v1. The harness interface is designed to accept others, but only `anthropic` is wired.
-- **No multi-user auth**: The agent is single-workspace-per-instance. Multi-user auth, billing, and workspace CRUD belong to `@hachej/boring-core`.
-- **No git UI**: The agent runs git via `bash`, but there's no status bar, diff pane, or branch picker. When git UI lands, thin routes will be added.
-- **Plugin loading is local-only**: Pi plugins load in the backend Node process. They're disabled in `vercel-sandbox` mode for security.
-- **No browser-agent mode yet**: The `AgentHarness` interface has a `placement: "browser"` option, but no browser harness is implemented.
-- **No MCP tool integration**: Not in scope for v1.
-
----
-
-## FAQ
-
-**Q: What's the difference between `direct` and `local` mode?**  
-A: `direct` runs bash commands with no sandbox — the agent has full access to your machine. `local` wraps commands in bubblewrap (`bwrap`), which provides filesystem and process isolation on Linux. Use `direct` for macOS dev; use `local` on Linux servers.
-
-**Q: Can I use OpenAI or other model providers?**  
-A: Not in v1. Only Anthropic's Claude is wired up. The harness interface is provider-agnostic — community PRs for other providers are welcome.
-
-**Q: How do sessions persist?**  
-A: Via pi-coding-agent's JSONL session files under `${workdir}/.pi/sessions/`. The `PiSessionStore` reads and manages lifecycle. SQLite and IndexedDB implementations are planned.
-
-**Q: Can I add custom tools to the agent?**  
-A: Yes. Use the `CatalogDeps` pattern to build tools that bind to `Workspace` and `Sandbox`. For pi-native tools, register them via pi's extension system (`pi.extensions` in config). In `vercel-sandbox` mode, extensions are disabled.
-
-**Q: What's the UI bridge for?**  
-A: It lets the agent programmatically open files, panels, and surfaces in the workbench. The agent calls `exec_ui({ kind: "openFile", params: { path: "src/index.ts" } })` and the panel opens. It's a typed pubsub bus between backend and frontend.
+Set an API key for the model provider (e.g. `ANTHROPIC_API_KEY`). Common env
+vars: `BORING_AGENT_MODE` (default `direct`), `BORING_AGENT_WORKSPACE_ROOT`
+(default cwd), `BORING_AGENT_PORT`, and the `BORING_AGENT_DEFAULT_MODEL*` /
+`BORING_AGENT_CUSTOM_MODEL*` / `BORING_AGENT_INFOMANIAK*` provider settings. See
+[docs/runtime.md](./docs/runtime.md) and [docs/API.md](./docs/API.md).
 
-**Q: How does stream resumption work?**  
-A: The server wraps the harness's event stream in a per-turn ring buffer. Disconnected clients reconnect via `GET /api/v1/agent/pi-chat/:sessionId/events?from=<seq>`; the replay buffer serves missed events.
+## Documentation
 
----
+See [docs/README.md](./docs/README.md) for the full doc index — architecture,
+the export surfaces (`/front`, `/server`, `/shared`, `/eval`), runtime modes and
+provisioning, theming, plugins, error codes, and risk/cost notes.
 
-*About Contributions:* Please don't take this the wrong way, but I do not accept outside contributions for any of my projects. I simply don't have the mental bandwidth to review anything, and it's my name on the thing, so I'm responsible for any problems it causes; thus, the risk-reward is highly asymmetric from my perspective. I'd also have to worry about other "stakeholders," which seems unwise for tools I mostly make for myself for free. Feel free to submit issues, and even PRs if you want to illustrate a proposed fix, but know I won't merge them directly. Instead, I'll have Claude or Codex review submissions via `gh` and independently decide whether and how to address them. Bug reports in particular are welcome. Sorry if this offends, but I want to avoid wasted time and hurt feelings. I understand this isn't in sync with the prevailing open-source ethos that seeks community contributions, but it's the only way I can move at this velocity and keep my sanity.
+## Contributions
 
----
+I do not accept outside contributions for my projects: I don't have the
+bandwidth to review them, and it's my name on the result. Issues and bug reports
+are welcome; PRs may be used to illustrate a fix, but I won't merge them
+directly — I'll have Claude or Codex review submissions via `gh` and
+independently decide whether and how to address them.
 
 ## License
 

package/dist/{DebugDrawer-2PUDZ2RL.js → DebugDrawer-RYEBQ6CO.js}

@@ -1,6 +1,6 @@
 import {
   DebugDrawer
-} from "./chunk-IUJ22EFB.js";
+} from "./chunk-BOIV2I3N.js";
 export {
   DebugDrawer
 };

package/dist/{agentPluginEvents-CKrZLW3g.d.ts → agentPluginEvents-DP-vLNCs.d.ts}

@@ -1,4 +1,4 @@
-import { b as SessionStore } from './session-BRovhe0D.js';
+import { d as SessionStore } from './chatSubmitPayload-gC61O4Ni.js';
 
 interface TelemetrySink {
     capture(event: TelemetryEvent): void | Promise<void>;
@@ -215,6 +215,32 @@ interface WorkspaceChangeEvent {
     oldPath?: string;
     mtimeMs?: number;
 }
+/**
+ * Result of a watcher's readiness probe. `ok: false` means the
+ * implementation decided it cannot observe this workspace (e.g. the
+ * tree is too large to watch without harming the host process) —
+ * hosts should tell clients to fall back rather than wait for events
+ * that will never come.
+ */
+type WorkspaceWatcherReadiness = {
+    ok: true;
+} | {
+    ok: false;
+    reason: string;
+    message?: string;
+};
+interface WorkspaceWatchControlEvent {
+    type: 'resync-required';
+    reason: string;
+}
+interface WorkspaceWatchSubscribeOptions {
+    /**
+     * Called when the watcher detects a gap where changes may have been
+     * missed. Consumers should drop caches/refetch instead of trusting
+     * incremental events alone.
+     */
+    onControlEvent?: (event: WorkspaceWatchControlEvent) => void;
+}
 interface WorkspaceWatcher {
     /**
      * Add a listener for change events. Returns an unsubscribe fn —
@@ -222,7 +248,14 @@ interface WorkspaceWatcher {
      * itself is disposed, so unsubscribing one listener is cheap and
      * does NOT tear down the watcher.
      */
-    subscribe(listener: (event: WorkspaceChangeEvent) => void): () => void;
+    subscribe(listener: (event: WorkspaceChangeEvent) => void, options?: WorkspaceWatchSubscribeOptions): () => void;
+    /**
+     * Optional readiness probe. Implementations with a startup guard
+     * (workspace-size check, native module availability, …) resolve it
+     * once the underlying source is observing — or with `ok: false`
+     * when observation was refused. Absent → assume always ready.
+     */
+    whenReady?(): Promise<WorkspaceWatcherReadiness>;
     /**
      * Tear down the underlying observation source (chokidar instance,
      * sandbox emitter binding, …). Idempotent. Subscribers added after
@@ -444,4 +477,4 @@ interface CommandNotifyPayload {
     command?: string;
 }
 
-export { type AgentTool as A, type CommandNotifyPayload as C, type Entry as E, type FileSearch as F, type IsolatedCodeInput as I, type JSONSchema as J, type PluginRestartWarning as P, type RunContext as R, type Sandbox as S, type TelemetryEvent as T, type Workspace as W, type AgentHarness as a, type ExecOptions as b, type ExecResult as c, type IsolatedCodeOutput as d, type SandboxCapability as e, type SandboxHandleRecord as f, type SandboxHandleStore as g, type SendMessageInput as h, type Stat as i, type TelemetrySink as j, type ToolExecContext as k, type ToolResult as l, WORKSPACE_AGENT_PLUGINS_RELOADED_EVENT as m, WORKSPACE_COMMAND_NOTIFY_EVENT as n, type WorkspaceRuntimeContext as o, noopTelemetry as p, type AgentHarnessFactory as q, type AgentHarnessFactoryInput as r, safeCapture as s };
+export { type AgentTool as A, type CommandNotifyPayload as C, type Entry as E, type FileSearch as F, type IsolatedCodeInput as I, type JSONSchema as J, type PluginRestartWarning as P, type RunContext as R, type Sandbox as S, type TelemetryEvent as T, type Workspace as W, type AgentHarness as a, type ExecOptions as b, type ExecResult as c, type IsolatedCodeOutput as d, type SandboxCapability as e, type SandboxHandleRecord as f, type SandboxHandleStore as g, type SendMessageInput as h, type Stat as i, type TelemetrySink as j, type ToolExecContext as k, type ToolResult as l, WORKSPACE_AGENT_PLUGINS_RELOADED_EVENT as m, WORKSPACE_COMMAND_NOTIFY_EVENT as n, type WorkspaceRuntimeContext as o, noopTelemetry as p, type WorkspaceChangeEvent as q, type AgentHarnessFactory as r, safeCapture as s, type AgentHarnessFactoryInput as t };

package/dist/{session-BRovhe0D.d.ts → chatSubmitPayload-gC61O4Ni.d.ts}

@@ -24,4 +24,23 @@ interface SessionSummary {
 }
 type SessionDetail = SessionSummary;
 
-export type { SessionCtx as S, SessionDetail as a, SessionStore as b, SessionSummary as c };
+type ThinkingLevel = 'off' | 'low' | 'medium' | 'high';
+interface ChatModelSelection {
+    provider: string;
+    id: string;
+}
+interface ChatAttachmentPayload {
+    filename?: string;
+    mediaType?: string;
+    url: string;
+}
+interface ChatSubmitPayload {
+    message: string;
+    displayMessage?: string;
+    clientNonce: string;
+    model?: ChatModelSelection;
+    thinkingLevel?: ThinkingLevel;
+    attachments?: ChatAttachmentPayload[];
+}
+
+export type { ChatAttachmentPayload as C, SessionCtx as S, ThinkingLevel as T, ChatModelSelection as a, ChatSubmitPayload as b, SessionDetail as c, SessionStore as d, SessionSummary as e };

package/dist/{chunk-IUJ22EFB.js → chunk-BOIV2I3N.js}

@@ -81,17 +81,9 @@ function DebugValue({ label, value }) {
   ] });
 }
 function SessionTab({ sessionId }) {
-  const resumeCommand = `pi --session ${sessionId}`;
   return /* @__PURE__ */ jsxs("div", { className: "flex flex-col gap-3 overflow-auto p-3 text-[11px] text-muted-foreground dark:text-zinc-300", children: [
-    /* @__PURE__ */ jsx("p", { className: "text-muted-foreground dark:text-zinc-300", children: "This web chat is backed by a pi session. Use the id below from the workspace root to resume the same conversation in a terminal." }),
-    /* @__PURE__ */ jsx(DebugValue, { label: "Pi session id", value: sessionId }),
-    /* @__PURE__ */ jsx(DebugValue, { label: "Resume command", value: resumeCommand }),
-    /* @__PURE__ */ jsxs("p", { className: "rounded-md border border-border/30 bg-muted/10 p-2 text-[10px] leading-relaxed text-muted-foreground dark:text-zinc-300", children: [
-      "Tip: ",
-      /* @__PURE__ */ jsx("code", { className: "font-mono text-foreground/80", children: "pi --continue" }),
-      " ",
-      "opens the most recent session for the current working directory. The explicit command above targets this session directly."
-    ] })
+    /* @__PURE__ */ jsx("p", { className: "text-muted-foreground dark:text-zinc-300", children: "This web chat is backed by a runtime session. Use the id below for support or debugging." }),
+    /* @__PURE__ */ jsx(DebugValue, { label: "Runtime session id", value: sessionId })
   ] });
 }
 var RETRY_DELAY_MS = 2500;

package/dist/{chunk-VQ7VSSSX.js → chunk-YUDMSYAO.js}

@@ -29,6 +29,7 @@ function extractToolUiMetadata(output) {
 import { z } from "zod";
 var ErrorCode = z.enum([
   // Auth / config
+  "UNAUTHORIZED",
   "MISSING_API_KEY",
   "INVALID_API_KEY",
   "OIDC_REFRESH_FAILED",
@@ -54,8 +55,12 @@ var ErrorCode = z.enum([
   "SANDBOX_NOT_READY",
   "SANDBOX_EXPIRED",
   "VERCEL_API_ERROR",
+  "REMOTE_WORKER_TIMEOUT",
+  "REMOTE_WORKER_STREAM_CLOSED",
   "CIRCUIT_OPEN",
   "ABORTED",
+  // Billing / metering
+  "PAYMENT_REQUIRED",
   // Session / bridge
   "SESSION_NOT_FOUND",
   "SESSION_LOCKED",
@@ -208,7 +213,7 @@ var PiChatSnapshotSchema = z2.object({
 var baseEvent = z2.object({ seq: seqNumber });
 var PiChatEventSchema = z2.discriminatedUnion("type", [
   baseEvent.extend({ type: z2.literal("agent-start"), turnId: nonEmptyString }),
-  baseEvent.extend({ type: z2.literal("agent-end"), turnId: nonEmptyString, status: z2.enum(["ok", "aborted", "error"]) }),
+  baseEvent.extend({ type: z2.literal("agent-end"), turnId: nonEmptyString, status: z2.enum(["ok", "aborted", "error"]), willRetry: z2.boolean().optional() }),
   baseEvent.extend({
     type: z2.literal("message-start"),
     messageId: nonEmptyString,

package/dist/front/index.d.ts

@@ -1,9 +1,9 @@
 import * as react_jsx_runtime from 'react/jsx-runtime';
-import { FileUIPart, UIMessage, ChatStatus } from 'ai';
 import * as react from 'react';
 import { ComponentType, ReactNode, HTMLAttributes, ComponentProps, FormEvent } from 'react';
-import { T as ToolUiMetadata, B as BoringChatPart, d as BoringChatMessage, p as PiChatStatus, u as QueuedUserMessage, e as ChatError, P as PiChatEvent, r as PromptPayload, s as PromptReceipt, F as FollowUpPayload, l as FollowUpReceipt, Q as QueueClearPayload, t as QueueClearReceipt, I as InterruptPayload, h as CommandReceipt, S as StopPayload, v as StopReceipt } from '../piChatEvent-Ck1BAE_m.js';
-import { c as SessionSummary } from '../session-BRovhe0D.js';
+import { FileUIPart, UIMessage, ChatStatus } from 'ai';
+import { T as ToolUiMetadata, B as BoringChatPart, d as BoringChatMessage, m as PiChatStatus, r as QueuedUserMessage, C as ChatError, P as PiChatEvent, o as PromptPayload, p as PromptReceipt, F as FollowUpPayload, i as FollowUpReceipt, Q as QueueClearPayload, q as QueueClearReceipt, I as InterruptPayload, e as CommandReceipt, S as StopPayload, s as StopReceipt } from '../piChatEvent-DR9a-FVz.js';
+import { e as SessionSummary } from '../chatSubmitPayload-gC61O4Ni.js';
 import { Button, Collapsible, CollapsibleContent, CollapsibleTrigger, InputGroupAddon, InputGroupButton, InputGroupTextarea } from '@hachej/boring-ui-kit';
 import { Streamdown } from 'streamdown';
 import { StickToBottom } from 'use-stick-to-bottom';
@@ -238,6 +238,10 @@ interface PiChatRuntimeNotice {
     level: 'info' | 'warning' | 'error';
     text: string;
     dismissible?: boolean;
+    /** Stable, canonical server error code (a shared ErrorCode enum member) when this
+     * notice came from a rejected run. Lets a host render a recovery action for a specific
+     * code without the agent knowing what the code means. */
+    errorCode?: string;
 }
 interface PiChatRetryNotice {
     attempt: number;
@@ -501,6 +505,8 @@ interface ChatPanelEmptyState {
     eyebrow?: string;
     title?: string;
     description?: string;
+    /** Optional content rendered below the suggestion grid (e.g. a footer link). */
+    footer?: ReactNode;
 }
 interface PiChatPanelProps {
     /** Optional externally selected Pi session id. When provided, session navigation is owned by the host. */
@@ -530,6 +536,9 @@ interface PiChatPanelProps {
     model?: ModelSelection | null;
     defaultModel?: ModelSelection;
     availableModels?: AvailableModel[];
+    hideDefaultModelOption?: boolean;
+    hideComposerSettings?: boolean;
+    suppressPreSubmitCancelledWarning?: boolean;
     thinkingLevel?: ThinkingLevel;
     thinkingControl?: boolean;
     serverResourcesEnabled?: boolean;
@@ -553,8 +562,16 @@ interface PiChatPanelProps {
     composerBlockers?: ComposerBlocker[];
     onComposerStop?: () => void;
     onComposerBlockerAction?: (blocker: ComposerBlocker, action: string) => void;
-}
-declare function PiChatPanel({ sessionId, extraCommands, apiBaseUrl, workspaceId, storageScope, requestHeaders, storage, fetch, className, chrome, debug, showSessions, hotReloadEnabled, suggestions, emptyState, emptyPlacement, composerPlaceholder, initialDraft, autoSubmitInitialDraft, onDraftRestored, onAutoSubmitInitialDraftAccepted, onAutoSubmitInitialDraftSettled, model, defaultModel, availableModels, thinkingLevel, thinkingControl, serverResourcesEnabled, mentionedFiles, commands, excludeBuiltinCommands, toolRenderers, createRemoteSession, remoteSessionOptions, hydrateMessages, workspaceWarmupStatus, onSessionReset, onBeforeSubmit, onReloadAgentPlugins, onCommandResult, onComposerWarning, onMentionedFilesConsumed, onData, onOpenArtifact, composerBlockers, onComposerStop, onComposerBlockerAction, }: PiChatPanelProps): react_jsx_runtime.JSX.Element;
+    /** Fired once each time a run settles (busy → idle). Hosts use it to refresh
+     * out-of-band state after a turn (e.g. a usage/quota indicator). The agent stays
+     * agnostic about what the host does with it. */
+    onTurnComplete?: () => void;
+    /** Host-supplied action node for a runtime notice, keyed off notice.errorCode.
+     * Lets a host attach a recovery action for a specific error code without the agent
+     * knowing what the code means or what the action does. */
+    renderNoticeAction?: (notice: PiChatRuntimeNotice) => ReactNode;
+}
+declare function PiChatPanel({ sessionId, extraCommands, apiBaseUrl, workspaceId, storageScope, requestHeaders, storage, fetch, className, chrome, debug, showSessions, hotReloadEnabled, suggestions, emptyState, emptyPlacement, composerPlaceholder, initialDraft, autoSubmitInitialDraft, onDraftRestored, onAutoSubmitInitialDraftAccepted, onAutoSubmitInitialDraftSettled, model, defaultModel, availableModels, hideDefaultModelOption, hideComposerSettings, suppressPreSubmitCancelledWarning, thinkingLevel, thinkingControl, serverResourcesEnabled, mentionedFiles, commands, excludeBuiltinCommands, toolRenderers, createRemoteSession, remoteSessionOptions, hydrateMessages, workspaceWarmupStatus, onSessionReset, onBeforeSubmit, onReloadAgentPlugins, onCommandResult, onComposerWarning, onMentionedFilesConsumed, onData, onOpenArtifact, composerBlockers, onComposerStop, onComposerBlockerAction, onTurnComplete, renderNoticeAction, }: PiChatPanelProps): react_jsx_runtime.JSX.Element;
 
 interface DebugDrawerProps {
     apiBaseUrl?: string;