@hachej/boring-agent 0.1.94 → 0.1.96

package/dist/{errors-G6T6S7PQ.d.ts → errors-cNC4HMpV.d.ts}

@@ -1,4 +1,4 @@
-import { b as PiChatEvent, o as ChatModelSelection, K as ThinkingLevel, v as ChatAttachmentPayload, Q as QueuedUserMessage, n as PiChatSnapshot } from './piChatEvent-BsMp3MSo.js';
+import { b as PiChatEvent, o as ChatModelSelection, L as ThinkingLevel, v as ChatAttachmentPayload, Q as QueuedUserMessage, n as PiChatSnapshot } from './piChatEvent-B3ehh9V0.js';
 
 /** Placement-independent event envelope. `seq` is the only replay cursor. */
 interface AgentSessionEvent {
@@ -43,6 +43,8 @@ interface AgentSummary {
     readonly agentTypeId: string;
     readonly label: string;
     readonly description?: string;
+    /** Runtime plugins explicitly bound to this Agent definition. */
+    readonly pluginIds?: readonly string[];
     readonly definition?: {
         readonly version: string;
         readonly digest: string;
@@ -64,6 +66,11 @@ interface AgentSessionSummary {
     readonly status: AgentSessionActivity;
     readonly createdAt: number;
     readonly updatedAt: number;
+    readonly turnCount?: number;
+    /** Present only for an explicitly allowed bare native Pi transcript. */
+    readonly nativeSessionId?: string;
+    /** Native transcript metadata used to gate rename until a reply exists. */
+    readonly hasAssistantReply?: boolean;
 }
 interface AgentSessionPage {
     readonly sessions: readonly AgentSessionSummary[];
@@ -74,6 +81,8 @@ interface CreateAgentSessionInput {
     readonly agentTypeId: string;
     readonly requestId: string;
     readonly title?: string;
+    /** Boot-only intent to resume this exact tab-owned empty session. */
+    readonly resumeSessionId?: string;
 }
 interface ConnectAgentSessionInput {
     readonly scope: AuthorizedAgentScope;
@@ -166,10 +175,6 @@ interface AgentGateway {
     close(): Promise<void>;
 }
 
-interface FileSearch {
-    search(glob: string, limit?: number): Promise<string[]>;
-}
-
 declare const AgentGatewayErrorCode: {
     readonly AGENT_TYPE_UNKNOWN: "AGENT_TYPE_UNKNOWN";
     readonly AGENT_SESSION_NOT_FOUND: "AGENT_SESSION_NOT_FOUND";
@@ -179,14 +184,16 @@ declare const AgentGatewayErrorCode: {
     readonly AGENT_SESSION_CURSOR_EXPIRED: "AGENT_SESSION_CURSOR_EXPIRED";
     readonly AGENT_SESSION_CURSOR_INVALID: "AGENT_SESSION_CURSOR_INVALID";
     readonly AGENT_REQUEST_CONFLICT: "AGENT_REQUEST_CONFLICT";
+    readonly AGENT_REQUEST_IN_PROGRESS: "AGENT_REQUEST_IN_PROGRESS";
     readonly AGENT_REQUEST_OUTCOME_UNKNOWN: "AGENT_REQUEST_OUTCOME_UNKNOWN";
+    readonly AGENT_RUNTIME_RESTART_REQUIRED: "AGENT_RUNTIME_RESTART_REQUIRED";
     readonly AGENT_COMMAND_INVALID_STATE: "AGENT_COMMAND_INVALID_STATE";
     readonly AGENT_SESSION_RUNTIME_SCOPE_MISMATCH: "AGENT_SESSION_RUNTIME_SCOPE_MISMATCH";
     readonly AGENT_SHARED_ENVIRONMENT_UNAVAILABLE: "AGENT_SHARED_ENVIRONMENT_UNAVAILABLE";
     readonly AGENT_GATEWAY_CLOSED: "AGENT_GATEWAY_CLOSED";
 };
 type AgentGatewayErrorCode = (typeof AgentGatewayErrorCode)[keyof typeof AgentGatewayErrorCode];
-declare const AGENT_GATEWAY_ERROR_CODES: readonly ["AGENT_TYPE_UNKNOWN", "AGENT_SESSION_NOT_FOUND", "AGENT_SCOPE_DENIED", "AGENT_SESSION_REPLAY_GAP", "AGENT_SESSION_CURSOR_AHEAD", "AGENT_SESSION_CURSOR_EXPIRED", "AGENT_SESSION_CURSOR_INVALID", "AGENT_REQUEST_CONFLICT", "AGENT_REQUEST_OUTCOME_UNKNOWN", "AGENT_COMMAND_INVALID_STATE", "AGENT_SESSION_RUNTIME_SCOPE_MISMATCH", "AGENT_SHARED_ENVIRONMENT_UNAVAILABLE", "AGENT_GATEWAY_CLOSED"];
+declare const AGENT_GATEWAY_ERROR_CODES: readonly ["AGENT_TYPE_UNKNOWN", "AGENT_SESSION_NOT_FOUND", "AGENT_SCOPE_DENIED", "AGENT_SESSION_REPLAY_GAP", "AGENT_SESSION_CURSOR_AHEAD", "AGENT_SESSION_CURSOR_EXPIRED", "AGENT_SESSION_CURSOR_INVALID", "AGENT_REQUEST_CONFLICT", "AGENT_REQUEST_IN_PROGRESS", "AGENT_REQUEST_OUTCOME_UNKNOWN", "AGENT_RUNTIME_RESTART_REQUIRED", "AGENT_COMMAND_INVALID_STATE", "AGENT_SESSION_RUNTIME_SCOPE_MISMATCH", "AGENT_SHARED_ENVIRONMENT_UNAVAILABLE", "AGENT_GATEWAY_CLOSED"];
 interface AgentGatewayErrorDTO {
     readonly code: AgentGatewayErrorCode;
     readonly message: string;
@@ -199,4 +206,4 @@ declare class AgentGatewayError extends Error {
     toJSON(): AgentGatewayErrorDTO;
 }
 
-export { type AgentGateway as A, type ConnectAgentSessionInput as C, type DeleteAgentSessionInput as D, type FileSearch as F, type IdempotentAgentControl as I, type JsonValue as J, type ListAgentsInput as L, type ReadAgentSessionStateInput as R, type VerifiedAgentScopeClaim as V, type WorkspaceScopeId as W, type AuthorizedAgentScope as a, type AgentSessionRef as b, type AgentSessionActivity as c, type AgentSessionSummary as d, type AgentSessionStateSnapshot as e, type AgentSessionConnection as f, type AgentGatewayErrorDTO as g, type AgentScopeVerifier as h, AGENT_GATEWAY_ERROR_CODES as i, type AgentFollowUpCommand as j, AgentGatewayError as k, AgentGatewayErrorCode as l, type AgentPromptCommand as m, type AgentSendReceipt as n, type AgentSessionEvent as o, type AgentSessionPage as p, type AgentSummary as q, type AuthSubjectId as r, type AuthorizedAgentSessionQuery as s, type CreateAgentSessionInput as t, type IdempotentAgentSend as u, type IdempotentQueueClear as v, type JsonPrimitive as w, type JsonSafe as x, type RenameAgentSessionInput as y };
+export { type AgentSummary as A, type ConnectAgentSessionInput as C, type DeleteAgentSessionInput as D, type IdempotentAgentControl as I, type JsonValue as J, type ListAgentsInput as L, type ReadAgentSessionStateInput as R, type VerifiedAgentScopeClaim as V, type WorkspaceScopeId as W, AgentGatewayErrorCode as a, type AgentGateway as b, type AuthorizedAgentScope as c, type AgentSessionRef as d, type AgentSessionActivity as e, type AgentGatewayErrorDTO as f, type AgentSessionSummary as g, type AgentSessionStateSnapshot as h, type AgentSessionConnection as i, type AgentScopeVerifier as j, AGENT_GATEWAY_ERROR_CODES as k, type AgentFollowUpCommand as l, AgentGatewayError as m, type AgentPromptCommand as n, type AgentSendReceipt as o, type AgentSessionEvent as p, type AgentSessionPage as q, type AuthSubjectId as r, type AuthorizedAgentSessionQuery as s, type CreateAgentSessionInput as t, type IdempotentAgentSend as u, type IdempotentQueueClear as v, type JsonPrimitive as w, type JsonSafe as x, type RenameAgentSessionInput as y };

package/dist/eval/index.d.ts

@@ -61,8 +61,10 @@ type EvalModelSelection = string | {
     id: string;
 };
 interface EvalPromptOptions {
-    /** A FastifyInstance from createAgentApp / createWorkspaceAgentApp / etc. */
+    /** A FastifyInstance from createStandaloneAgentHostApp / createWorkspaceAgentApp / etc. */
     app: FastifyInstance;
+    /** Addressed Agent owner exercised by this eval. */
+    agentTypeId: string;
     /** User prompt sent to the agent. */
     prompt: string;
     /**
@@ -92,8 +94,6 @@ interface EvalPromptOptions {
     sessionId?: string;
     /** Optional headers sent to session/chat requests (e.g. workspace scoping). */
     headers?: Record<string, string>;
-    /** Optional query params appended to session/chat requests (e.g. workspaceId). */
-    query?: Record<string, string | number | boolean | undefined>;
     /** Per-call timeout in ms. Defaults to 30_000. */
     timeoutMs?: number;
     /** Per-prompt retry count. Default: 0. */
@@ -120,6 +120,8 @@ interface EvalResult {
  */
 interface SuiteOptions {
     app: FastifyInstance;
+    /** Addressed Agent owner exercised by every fixture. */
+    agentTypeId: string;
     /** Path to a YAML fixture file. See AGENT_EVAL_FRAMEWORK.md for format. */
     fixturesPath: string;
     /** Stop on first failure. Default: false. */

package/dist/eval/index.js

@@ -1,5 +1,5 @@
 // src/eval/evalPrompt.ts
-import { randomUUID } from "crypto";
+import { randomUUID } from "node:crypto";
 
 // src/eval/types.ts
 var EvalAny = /* @__PURE__ */ Symbol.for("@hachej/boring-agent/eval/EvalAny");
@@ -202,13 +202,13 @@ async function evalAgentPrompt(opts) {
     let captured;
     try {
       captured = await runOnce(opts.app, {
+        agentTypeId: opts.agentTypeId,
         sessionId: `${sessionId}-attempt-${attempts}`,
         prompt: opts.prompt,
         systemPrompt: opts.systemPrompt,
         model,
         timeoutMs,
-        headers: opts.headers,
-        query: opts.query
+        headers: opts.headers
       });
     } catch (err) {
       lastResult = {
@@ -279,7 +279,18 @@ function matchExpectations(opts, actual) {
   return someCallMatches(opts.expect, actual);
 }
 async function runOnce(app, opts) {
-  const querySuffix = formatQuerySuffix(opts.query);
+  const sessionsPath = `/api/v1/agents/${encodeURIComponent(opts.agentTypeId)}/sessions`;
+  const created = await app.inject({
+    method: "POST",
+    url: sessionsPath,
+    headers: opts.headers,
+    payload: { requestId: `eval-create-${opts.sessionId}`, title: opts.sessionId }
+  });
+  if (created.statusCode !== 201) {
+    throw new Error(`Agent session create returned ${created.statusCode}: ${created.body.slice(0, 256)}`);
+  }
+  const sessionId = created.json().sessionId;
+  if (typeof sessionId !== "string" || !sessionId) throw new Error("Agent session create did not return sessionId");
   const userMessage = opts.systemPrompt ? `[SYSTEM]
 ${opts.systemPrompt}
 [/SYSTEM]
@@ -289,10 +300,11 @@ ${opts.prompt}` : opts.prompt;
     const res = await withTimeout(
       app.inject({
         method: "POST",
-        url: `/api/v1/agent/pi-chat/${encodeURIComponent(opts.sessionId)}/prompt${querySuffix}`,
+        url: `${sessionsPath}/${encodeURIComponent(sessionId)}/prompt`,
         headers: opts.headers,
         payload: {
-          message: userMessage,
+          requestId: `eval-${sessionId}`,
+          content: userMessage,
           clientNonce: `eval-${opts.sessionId}`,
           model: opts.model
         }
@@ -306,7 +318,7 @@ ${opts.prompt}` : opts.prompt;
       );
     }
     const snapshot = await withTimeout(
-      waitForSettledState(app, opts, querySuffix),
+      waitForSettledState(app, opts, sessionId),
       opts.timeoutMs,
       `chat turn did not settle within ${opts.timeoutMs}ms`
     );
@@ -314,25 +326,30 @@ ${opts.prompt}` : opts.prompt;
   } finally {
     void app.inject({
       method: "DELETE",
-      url: `/api/v1/agent/pi-chat/sessions/${encodeURIComponent(opts.sessionId)}${querySuffix}`,
+      url: `${sessionsPath}/${encodeURIComponent(sessionId)}`,
       headers: opts.headers
     }).catch(() => {
     });
   }
 }
 var STATE_POLL_INTERVAL_MS = 250;
-async function waitForSettledState(app, opts, querySuffix) {
+async function waitForSettledState(app, opts, sessionId) {
   for (; ; ) {
     const state = await app.inject({
       method: "GET",
-      url: `/api/v1/agent/pi-chat/${encodeURIComponent(opts.sessionId)}/state${querySuffix}`,
+      url: `/api/v1/agents/${encodeURIComponent(opts.agentTypeId)}/sessions/${encodeURIComponent(sessionId)}/state`,
       headers: opts.headers
     });
     if (state.statusCode !== 200) {
       throw new Error(`Pi chat state returned ${state.statusCode}: ${state.body.slice(0, 256)}`);
     }
-    const snapshot = JSON.parse(state.body);
-    if (snapshot.status !== "streaming") return snapshot;
+    const envelope = JSON.parse(state.body);
+    const snapshot = envelope.state;
+    if (!snapshot || typeof snapshot !== "object" || Array.isArray(snapshot)) {
+      throw new Error("Pi chat state did not return an addressed state envelope");
+    }
+    const addressedState = snapshot;
+    if (addressedState.status !== "streaming") return addressedState;
     await new Promise((resolve) => setTimeout(resolve, STATE_POLL_INTERVAL_MS));
   }
 }
@@ -356,16 +373,6 @@ function capturePiChatSnapshot(snapshot) {
   }
   return { toolCalls, text: textParts.join(""), errorText };
 }
-function formatQuerySuffix(query) {
-  if (!query) return "";
-  const params = new URLSearchParams();
-  for (const [key, value] of Object.entries(query)) {
-    if (value === void 0) continue;
-    params.set(key, String(value));
-  }
-  const encoded = params.toString();
-  return encoded ? `?${encoded}` : "";
-}
 function withTimeout(p, ms, label) {
   return new Promise((resolve, reject) => {
     const timer = setTimeout(() => reject(new Error(label)), ms);
@@ -390,7 +397,7 @@ function parseModelString(input) {
 }
 
 // src/eval/runSuite.ts
-import { readFile } from "fs/promises";
+import { readFile } from "node:fs/promises";
 
 // src/eval/yamlSchema.ts
 import { parse, Schema } from "yaml";
@@ -505,6 +512,7 @@ async function runOnePrompt(opts, fixture, p) {
   const timeoutMs = p.timeoutMs ?? fixture.defaults?.timeoutMs ?? DEFAULT_TIMEOUT_MS;
   return evalAgentPrompt({
     app: opts.app,
+    agentTypeId: opts.agentTypeId,
     prompt: p.prompt,
     expect: p.expect,
     expectFirst: p.expectFirst,

package/dist/file-search-QxnanNjO.d.ts

@@ -0,0 +1,87 @@
+import { D as InterruptReceipt, j as StopReceipt } from './piChatEvent-B3ehh9V0.js';
+import { p as AgentSendInput, j as AgentEvent } from './harness-DS8jLKIx.js';
+import { b as Workspace } from './sandbox-KQiEdz4W.js';
+import { d as AgentSessionRef, o as AgentSendReceipt, b as AgentGateway, c as AuthorizedAgentScope } from './errors-cNC4HMpV.js';
+
+interface WorkspaceAgentDispatcherContext {
+    workspaceId: string;
+    userId: string;
+}
+type WorkspaceAgentDispatcherSendInput = Omit<AgentSendInput, 'ctx'>;
+interface WorkspaceAgentDispatcherDispatchInput extends WorkspaceAgentDispatcherSendInput {
+    /** Optional user-visible presentation when content carries hidden instructions. */
+    displayMessage?: string;
+    /** Optional title for a newly created addressed session. */
+    title?: string;
+    /** Durable caller-owned idempotency key. */
+    requestId: string;
+    /** Defaults to requestId. */
+    clientNonce?: string;
+    /** Defaults to prompt; follow-up requires a non-negative clientSeq. */
+    kind?: 'prompt' | 'followup';
+    clientSeq?: number;
+}
+interface WorkspaceAgentDispatch {
+    ref: AgentSessionRef;
+    receipt: AgentSendReceipt;
+    events: AsyncIterable<AgentEvent>;
+}
+/**
+ * Callback-scoped direct Agent capability. The Workspace and operations are
+ * lease guarded by the Host and must not be retained after the callback.
+ */
+interface LeaseBoundWorkspaceAgent {
+    readonly workspace: Workspace;
+    readonly signal: AbortSignal;
+    dispatch(input: WorkspaceAgentDispatcherDispatchInput, onEvent: (event: AgentEvent) => void | Promise<void>, onAccepted?: (accepted: {
+        readonly ref: AgentSessionRef;
+        readonly receipt: AgentSendReceipt;
+    }) => void | Promise<void>): Promise<{
+        readonly ref: AgentSessionRef;
+        readonly receipt: AgentSendReceipt;
+    }>;
+    interrupt(sessionId: string, requestId: string): Promise<InterruptReceipt>;
+    stop(sessionId: string, requestId: string): Promise<StopReceipt>;
+}
+interface WorkspaceAgentDirectRunInput {
+    readonly agentTypeId: string;
+    readonly context: WorkspaceAgentDispatcherContext;
+    readonly requestId: string;
+}
+type WorkspaceAgentDirectRunCallback = (binding: LeaseBoundWorkspaceAgent) => Promise<void>;
+/** Addressed gateway binding minted by the trusted composition root. */
+interface WorkspaceAgentGatewayBinding {
+    gateway: AgentGateway;
+    scope: AuthorizedAgentScope;
+    agentTypeId: string;
+}
+/**
+ * Compatibility-facing delegation surface. New durable callers use dispatch so
+ * the addressed ref and accepted Gateway receipt can be persisted before they
+ * consume events. send remains for callers that only need the legacy stream.
+ */
+interface WorkspaceAgentDispatcher {
+    /** Optional only for source compatibility with pre-Gateway injected resolvers. */
+    dispatch?(input: WorkspaceAgentDispatcherDispatchInput): Promise<WorkspaceAgentDispatch>;
+    send(input: WorkspaceAgentDispatcherSendInput): AsyncIterable<AgentEvent>;
+    interrupt(sessionId: string): Promise<InterruptReceipt>;
+    stop(sessionId: string): Promise<StopReceipt>;
+}
+
+declare const AGENT_RESOURCES_FILESYSTEM_ID: "agent_resources";
+/**
+ * Agent-scoped readonly filesystem carrying the knowledge/ folder shipped
+ * inside an agent definition package (gh-1107 slice 2). Generic id only —
+ * never tenant-named. The binding exists only for the owning agent.
+ */
+declare const AGENT_KNOWLEDGE_FILESYSTEM_ID: "agent_knowledge";
+interface AgentSkillResource {
+    readonly filesystem: 'user' | typeof AGENT_RESOURCES_FILESYSTEM_ID | (string & {});
+    readonly path: string;
+}
+
+interface FileSearch {
+    search(glob: string, limit?: number): Promise<string[]>;
+}
+
+export { type AgentSkillResource as A, type FileSearch as F, type LeaseBoundWorkspaceAgent as L, type WorkspaceAgentDirectRunInput as W, type WorkspaceAgentDirectRunCallback as a, type WorkspaceAgentDispatcherContext as b, type WorkspaceAgentDispatcher as c, type WorkspaceAgentGatewayBinding as d, AGENT_KNOWLEDGE_FILESYSTEM_ID as e, AGENT_RESOURCES_FILESYSTEM_ID as f, type WorkspaceAgentDispatch as g, type WorkspaceAgentDispatcherDispatchInput as h, type WorkspaceAgentDispatcherSendInput as i };

package/dist/front/index.d.ts

@@ -1,7 +1,8 @@
-import { T as ToolUiMetadata, B as BoringChatPart, a as BoringChatMessage, P as PiChatStatus, Q as QueuedUserMessage, C as ChatError, b as PiChatEvent, c as PromptPayload, d as PromptReceipt, F as FollowUpPayload, e as FollowUpReceipt, f as QueueClearPayload, g as QueueClearReceipt, I as InterruptPayload, h as CommandReceipt, i as StopPayload, j as StopReceipt, k as SessionSummary } from '../piChatEvent-BsMp3MSo.js';
+import { T as ToolUiMetadata, B as BoringChatPart, a as BoringChatMessage, P as PiChatStatus, Q as QueuedUserMessage, C as ChatError, b as PiChatEvent, c as PromptPayload, d as PromptReceipt, F as FollowUpPayload, e as FollowUpReceipt, f as QueueClearPayload, g as QueueClearReceipt, I as InterruptPayload, h as CommandReceipt, i as StopPayload, j as StopReceipt, k as SessionSummary, E as ErrorCode } from '../piChatEvent-B3ehh9V0.js';
 import * as react from 'react';
 import { ComponentProps, HTMLAttributes, FormEvent, ReactNode, ComponentType } from 'react';
 import { FileUIPart, ChatStatus, UIMessage } from 'ai';
+import { A as AgentSummary, a as AgentGatewayErrorCode, J as JsonValue } from '../errors-cNC4HMpV.js';
 import { InputGroupAddon, InputGroupButton, InputGroupTextarea, Button, Collapsible, CollapsibleContent, CollapsibleTrigger } from '@hachej/boring-ui-kit';
 import { Streamdown } from 'streamdown';
 import { StickToBottom } from 'use-stick-to-bottom';
@@ -137,11 +138,13 @@ interface ChatEmptyStateProps {
      * resolves this to `sendMessage` with the suggestion's prompt.
      */
     onSelect?: (suggestion: ChatSuggestion) => void;
+    /** Uses the concise empty-chat hierarchy. */
+    hero?: boolean;
     /** Optional content rendered below the suggestion grid. */
     footer?: ReactNode;
     className?: string;
 }
-declare function ChatEmptyState({ eyebrow, title, description, suggestions, onSelect, footer, className, }: ChatEmptyStateProps): react.JSX.Element;
+declare function ChatEmptyState({ eyebrow, title, description, suggestions, onSelect, hero, footer, className, }: ChatEmptyStateProps): react.JSX.Element;
 
 interface ParsedCommand {
     name: string;
@@ -197,7 +200,7 @@ interface SlashCommandContext {
      * Drives the PluginUpdateStatus banner above the composer. The `/reload`
      * builtin prefers this over the inline-text path: it calls
      * `pluginUpdate.run()` which (1) sets the banner to "running", (2)
-     * hits /api/v1/agent/reload, (3) transitions to "success" or "error"
+     * hits the addressed Agent reload route, (3) transitions to "success" or "error"
      * with diagnostics. Returns a short string ack for the assistant
      * message bubble.
      */
@@ -239,7 +242,9 @@ interface ToolPart$1 {
     rendererResolution?: ToolRendererResolution;
 }
 type ToolRenderablePart = ToolPart$1 | BoringToolCallPart | unknown;
-type ToolRenderer = (part: ToolPart$1) => ReactNode;
+type ToolRenderer = ((part: ToolPart$1) => ReactNode) & {
+    presentation?: "inline";
+};
 type ToolRendererOverrides = Partial<Record<string, ToolRenderer>>;
 declare const defaultToolRenderers: Record<string, ToolRenderer>;
 declare function mergeToolRenderers(overrides?: ToolRendererOverrides): Record<string, ToolRenderer>;
@@ -278,7 +283,7 @@ interface OptimisticUserMessage extends BoringChatMessage {
     afterMessageId?: string;
 }
 
-type PiChatConnectionState = 'disconnected' | 'connecting' | 'connected' | 'reconnecting';
+type PiChatConnectionState = 'disconnected' | 'connecting' | 'connected' | 'reconnecting' | 'suspended';
 
 interface PiChatRuntimeNotice {
     id: string;
@@ -344,8 +349,8 @@ interface RemotePiSessionHeaders {
 }
 interface RemotePiSessionOptions {
     sessionId: string;
-    /** Selects the additive addressed AgentGateway transport. Omit for legacy wire. */
-    agentTypeId?: string;
+    /** Addressed AgentGateway owner for this session. */
+    agentTypeId: string;
     workspaceId?: string;
     storageScope?: string;
     apiBaseUrl?: string;
@@ -398,6 +403,7 @@ interface RemotePiSessionDebugState {
         streamingMessageCount: 0 | 1;
     };
     disposed: boolean;
+    suspended: boolean;
     generation: number;
     streamRunId: number;
     reconnectAttempt: number;
@@ -417,6 +423,7 @@ declare class RemotePiSession {
     private streamRunId;
     private reconnectAttempt;
     private started;
+    private suspended;
     private disposed;
     private streamAbortController?;
     private reconnectTimer?;
@@ -434,6 +441,8 @@ declare class RemotePiSession {
     clearQueue(payload?: QueueClearPayload): Promise<QueueClearReceipt>;
     interrupt(payload?: InterruptPayload): Promise<CommandReceipt>;
     stop(payload?: StopPayload): Promise<StopReceipt>;
+    suspendStream(): void;
+    resumeStream(): void;
     dispose(): void;
     private hydrateAndConnect;
     private connectEvents;
@@ -456,6 +465,8 @@ declare class RemotePiSession {
     private clearReconnectTimer;
     private abortEventStream;
     private isGenerationActive;
+    private isStreamLifecycleActive;
+    private isHydrationActive;
     private isStreamActive;
 }
 
@@ -464,17 +475,27 @@ interface ActiveSessionStorageLike {
     setItem(key: string, value: string): void;
     removeItem(key: string): void;
 }
+interface BootResumeSessionSource {
+    apiBaseUrl?: string;
+    sessionsApiPath: string;
+    /** Explicit normalized owner, including when sessionsApiPath is host-fixed. */
+    agentTypeId?: string;
+    workspaceId?: string;
+    storageScope?: string;
+}
 interface ActiveSessionStorageOptions {
     storageScope?: string;
     storage?: ActiveSessionStorageLike;
+    bootResumeSource?: BootResumeSessionSource;
 }
 declare function activeSessionStorageKey(storageScope?: string): string;
 declare function readActiveSessionId(options?: ActiveSessionStorageOptions): string | undefined;
 declare function writeActiveSessionId(sessionId: string | undefined, options?: ActiveSessionStorageOptions): void;
-declare function clearActiveSessionId(options?: ActiveSessionStorageOptions): void;
 
 interface PiSessionCreateInit {
     title?: string;
+    /** Boot-only intent to resume this exact tab-owned empty session. */
+    resumeSessionId?: string;
 }
 interface PiSessionRefreshOptions {
     background?: boolean;
@@ -482,18 +503,24 @@ interface PiSessionRefreshOptions {
     throwOnError?: boolean;
 }
 interface UsePiSessionsOptions {
+    agentTypeId: string;
     apiBaseUrl?: string;
     sessionsApiPath?: string;
-    /** Selects the additive addressed AgentGateway transport. Omit for legacy wire. */
-    agentTypeId?: string;
     workspaceId?: string;
+    /** Stable caller identity echoed only after this source's rows are authoritative. */
+    sourceIdentity?: string;
+    /** Server-authorized workspace/storage scope used for HTTP requests. */
     storageScope?: string;
+    /** Browser-only active-session persistence scope; defaults to storageScope. */
+    activeSessionStorageScope?: string;
     requestHeaders?: Record<string, string | undefined>;
     enabled?: boolean;
     refreshKey?: unknown;
     initialActiveSessionId?: string;
     fetch?: typeof globalThis.fetch;
     storage?: ActiveSessionStorageLike;
+    /** Tab-owned unsent-session resume storage. Defaults to sessionStorage. */
+    bootResumeStorage?: ActiveSessionStorageLike;
     createRemoteSession?: (options: RemotePiSessionOptions) => RemotePiSession;
     remoteSessionOptions?: Omit<Partial<RemotePiSessionOptions>, 'sessionId' | 'agentTypeId' | 'workspaceId' | 'storageScope' | 'apiBaseUrl' | 'headers' | 'fetch'>;
     connectActiveSession?: boolean;
@@ -507,20 +534,25 @@ interface UsePiSessionsResult {
     sessions: SessionSummary[];
     activeSession: SessionSummary | undefined;
     activeSessionId: string | undefined;
+    /** Hidden boot candidate; never connected/rendered before create confirms it. */
+    resumeSessionId: string | undefined;
     activePiSession: RemotePiSession | undefined;
     dataStorageScope: string;
+    /** Attests that returned session data belongs to the caller's expected source. */
+    sourceIdentity: string | undefined;
     loading: boolean;
     loadingMore: boolean;
     hasMore: boolean;
     error: Error | undefined;
     refresh: (options?: PiSessionRefreshOptions) => Promise<void>;
     create: (init?: PiSessionCreateInit) => Promise<SessionSummary>;
+    rename: (id: string, title: string) => Promise<SessionSummary>;
     switch: (id: string) => void;
     delete: (id: string) => Promise<void>;
     loadMore: () => Promise<void>;
     reset: () => void;
 }
-declare function usePiSessions(options?: UsePiSessionsOptions): UsePiSessionsResult;
+declare function usePiSessions(options: UsePiSessionsOptions): UsePiSessionsResult;
 
 interface SessionListProps {
     sessions: SessionSummary[];
@@ -617,8 +649,8 @@ interface AgentPluginReloadResult {
 interface PiChatPanelProps<TComposerBlocker extends ComposerBlocker = ComposerBlocker> {
     /** Optional externally selected Pi session id. When provided, session navigation is owned by the host. */
     sessionId?: string;
-    /** Selects the additive addressed AgentGateway transport. Omit for legacy wire. */
-    agentTypeId?: string;
+    /** Addressed AgentGateway owner for every chat/session request. */
+    agentTypeId: string;
     /** Alias kept for consumers that still pass the pre-cutover prop name. */
     extraCommands?: SlashCommand[];
     apiBaseUrl?: string;
@@ -688,7 +720,41 @@ interface PiChatPanelProps<TComposerBlocker extends ComposerBlocker = ComposerBl
 }
 declare function PiChatPanel<TComposerBlocker extends ComposerBlocker = ComposerBlocker>({ sessionId, agentTypeId, 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, allowPromptDuringInitialHydration, workspaceWarmupStatus, onSessionReset, onBeforeSubmit, onReloadAgentPlugins, onCommandResult, onComposerWarning, onMentionedFilesConsumed, onPromptSubmitStarted, onData, onOpenArtifact, composerBlockers, onComposerStop, onComposerBlockerAction, onTurnComplete, renderNoticeAction, }: PiChatPanelProps<TComposerBlocker>): react.JSX.Element;
 
+type AddressedAgentOption = Pick<AgentSummary, 'agentTypeId' | 'label' | 'description' | 'pluginIds'>;
+interface UseAddressedAgentSelectionOptions {
+    apiBaseUrl?: string;
+    requestHeaders?: Record<string, string | undefined>;
+    storageScope?: string;
+    fetch?: typeof globalThis.fetch;
+    enabled?: boolean;
+}
+interface UseAddressedAgentSelectionResult {
+    agents: AddressedAgentOption[];
+    selectedAgentTypeId: string | undefined;
+    loading: boolean;
+    error: Error | undefined;
+    selectAgentTypeId: (agentTypeId: string) => void;
+}
+declare function useAddressedAgentSelection({ apiBaseUrl, requestHeaders, storageScope, fetch, enabled, }?: UseAddressedAgentSelectionOptions): UseAddressedAgentSelectionResult;
+
+declare const RUNTIME_SCOPE_MISMATCH_MESSAGE = "This chat belongs to a previous runtime configuration and can no longer be changed.";
+type GatewayResponseErrorCode = AgentGatewayErrorCode | ErrorCode;
+declare class GatewayResponseError extends Error {
+    readonly status: number;
+    readonly code?: GatewayResponseErrorCode | undefined;
+    readonly details?: JsonValue | undefined;
+    readonly body?: unknown | undefined;
+    readonly operation?: string | undefined;
+    readonly errorCode?: GatewayResponseErrorCode;
+    constructor(status: number, message: string, code?: GatewayResponseErrorCode | undefined, details?: JsonValue | undefined, body?: unknown | undefined, operation?: string | undefined);
+}
+declare function gatewayResponseError(response: Response, fallbackMessage: string, operation?: string): Promise<GatewayResponseError>;
+declare function gatewayResponseErrorFromBody(status: number, body: unknown, fallbackMessage: string, operation?: string): GatewayResponseError;
+declare function errorResponseCode(error: unknown): GatewayResponseErrorCode | undefined;
+declare function isRuntimeScopeMismatchError(error: unknown): boolean;
+
 interface DebugDrawerProps {
+    agentTypeId: string;
     apiBaseUrl?: string;
     fetch?: typeof globalThis.fetch;
     sessionId: string;
@@ -698,7 +764,7 @@ interface DebugDrawerProps {
     width: number;
     onWidthChange: (w: number) => void;
 }
-declare function DebugDrawer({ apiBaseUrl, fetch, sessionId, messages, requestHeaders, storageScope, width, onWidthChange }: DebugDrawerProps): react.JSX.Element;
+declare function DebugDrawer({ agentTypeId, apiBaseUrl, fetch, sessionId, messages, requestHeaders, storageScope, width, onWidthChange }: DebugDrawerProps): react.JSX.Element;
 
 interface OpenArtifactOptions {
     filesystem?: string;
@@ -731,7 +797,7 @@ declare function ModelPickerMenu({ value, onChange, options, disabled, hideDefau
 }): react.JSX.Element;
 /**
  * Model picker whose options are pi-coding-agent's actual available
- * models (fetched from /api/v1/agent/models). Groups by provider and
+ * models (fetched from the addressed Agent models route). Groups by provider and
  * shows a concise human-friendly label with the raw pi id as the
  * option's stored value, encoded as "{provider}:{id}" to keep
  * ids stable across providers.
@@ -832,7 +898,11 @@ type MessageActionProps = ComponentProps<typeof Button> & {
 };
 declare const MessageAction: ({ tooltip, children, label, variant, size, ...props }: MessageActionProps) => react.JSX.Element;
 type MessageResponseProps = ComponentProps<typeof Streamdown>;
-declare const MessageResponse: react.MemoExoticComponent<({ className, shikiTheme, components, ...props }: MessageResponseProps) => react.JSX.Element>;
+type BoringMessageResponseProps = MessageResponseProps & {
+    /** Source path inferred from the preceding write/edit tool call, when known. */
+    codeFilename?: string;
+};
+declare const MessageResponse: react.MemoExoticComponent<({ className, shikiTheme, components, codeFilename, ...props }: BoringMessageResponseProps) => react.JSX.Element>;
 
 type ConversationProps = ComponentProps<typeof StickToBottom> & {
     onScrollToBottomReady?: (scrollToBottom: () => void) => void;
@@ -894,4 +964,4 @@ declare const ToolContent: ({ className, ...props }: ToolContentProps) => react.
 
 declare function cn(...inputs: ClassValue[]): string;
 
-export { type AgentCommandContribution, type AgentCommandOptions, type AgentPluginReloadResult, ArtifactOpenProvider, type AvailableModel, BoringChatMessage, ChatEmptyState, type ChatEmptyStateProps, type ChatMessageContribution, type ChatMessageContributionProps, ChatMessageContributionProvider, PiChatPanel as ChatPanel, type PiChatPanelProps as ChatPanelProps, type ChatSuggestion, CodeBlock, type CommandRegistry, type ComposerActionContributionProps, type ComposerBlocker, type ComposerBlockerAction, type ComposerContribution, ComposerContributionProvider, type ComposerDraftUpdate, Conversation, ConversationContent, ConversationScrollButton, DebugDrawer, type GroupedToolEntry, Message, MessageAction, MessageActions, MessageContent, MessageResponse, ModelPickerMenu, ModelSelect, ModelSelectTrigger, type ModelSelection, type OpenArtifactHandler, type ParsedCommand, PiChatPanel, type PiChatPanelProps, SessionBrowser as PiSessionBrowser, type PiSessionCreateInit, SessionList as PiSessionList, type PiSessionSearchItem, type PiSessionSearchOptions, type PiSessionSearchSortMode, PromptInput, PromptInputFooter, PromptInputSubmit, PromptInputTextarea, Reasoning, ReasoningContent, ReasoningTrigger, type SessionListProps, type SlashCommand, type SlashCommandContext, type ThinkingLevel, ThinkingSelect, Tool, ToolCallGroup, ToolContent, ToolHeader, type ToolPart$1 as ToolPart, type ToolRenderer, type ToolRendererOverrides, type UploadFileOptions, type UploadFileResult, type UsePiSessionsOptions, type UsePiSessionsResult, activeSessionStorageKey, builtinCommands, clearActiveSessionId, cn, createCommandRegistry, defaultChatSuggestions, defaultToolRenderers, getAgentCommands, matchPiSessionSearch, mergeShadcnToolRenderers, mergeToolRenderers, parsePiSessionSearchQuery, parseSlashCommand, readActiveSessionId, resolveToolRenderer, searchPiSessions, uploadFile, useOpenArtifact, usePiSessions, writeActiveSessionId };
+export { type AddressedAgentOption, type AgentCommandContribution, type AgentCommandOptions, type AgentPluginReloadResult, ArtifactOpenProvider, type AvailableModel, BoringChatMessage, ChatEmptyState, type ChatEmptyStateProps, type ChatMessageContribution, type ChatMessageContributionProps, ChatMessageContributionProvider, PiChatPanel as ChatPanel, type PiChatPanelProps as ChatPanelProps, type ChatSuggestion, CodeBlock, type CommandRegistry, type ComposerActionContributionProps, type ComposerBlocker, type ComposerBlockerAction, type ComposerContribution, ComposerContributionProvider, type ComposerDraftUpdate, Conversation, ConversationContent, ConversationScrollButton, DebugDrawer, GatewayResponseError, type GatewayResponseErrorCode, type GroupedToolEntry, Message, MessageAction, MessageActions, MessageContent, MessageResponse, ModelPickerMenu, ModelSelect, ModelSelectTrigger, type ModelSelection, type OpenArtifactHandler, type ParsedCommand, PiChatPanel, type PiChatPanelProps, SessionBrowser as PiSessionBrowser, type PiSessionCreateInit, SessionList as PiSessionList, type PiSessionSearchItem, type PiSessionSearchOptions, type PiSessionSearchSortMode, PromptInput, PromptInputFooter, PromptInputSubmit, PromptInputTextarea, RUNTIME_SCOPE_MISMATCH_MESSAGE, Reasoning, ReasoningContent, ReasoningTrigger, type SessionListProps, type SlashCommand, type SlashCommandContext, type ThinkingLevel, ThinkingSelect, Tool, ToolCallGroup, ToolContent, ToolHeader, type ToolPart$1 as ToolPart, type ToolRenderer, type ToolRendererOverrides, type UploadFileOptions, type UploadFileResult, type UseAddressedAgentSelectionOptions, type UseAddressedAgentSelectionResult, type UsePiSessionsOptions, type UsePiSessionsResult, activeSessionStorageKey, builtinCommands, cn, createCommandRegistry, defaultChatSuggestions, defaultToolRenderers, errorResponseCode, gatewayResponseError, gatewayResponseErrorFromBody, getAgentCommands, isRuntimeScopeMismatchError, matchPiSessionSearch, mergeShadcnToolRenderers, mergeToolRenderers, parsePiSessionSearchQuery, parseSlashCommand, readActiveSessionId, resolveToolRenderer, searchPiSessions, uploadFile, useAddressedAgentSelection, useOpenArtifact, usePiSessions, writeActiveSessionId };