@hachej/boring-agent 0.1.54 → 0.1.56

package/dist/{agentPluginEvents-Dgm57gEU.d.ts → agentPluginEvents-Ddn5DQ5E.d.ts}

@@ -47,6 +47,7 @@ interface AgentHarnessFactoryInput {
     runtimeCwd?: string;
     systemPromptAppend?: string;
     sessionNamespace?: string;
+    sessionRoot?: string;
     sessionDir?: string;
     /**
      * Optional dynamic system-prompt source. Harness calls it whenever it
@@ -477,4 +478,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 WorkspaceChangeEvent as q, type AgentHarnessFactory as r, safeCapture as s, type AgentHarnessFactoryInput as t };
+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 ToolReadinessRequirement as q, type WorkspaceChangeEvent as r, safeCapture as s, type AgentHarnessFactory as t, type AgentHarnessFactoryInput as u };

package/dist/front/index.js

@@ -68,7 +68,7 @@ function rawWorkspaceFileUrl(path, opts) {
 }
 
 // src/front/chat/PiChatPanel.tsx
-import { lazy, Suspense, useCallback as useCallback18, useEffect as useEffect21, useMemo as useMemo12, useRef as useRef16, useState as useState20 } from "react";
+import { lazy, Suspense, useCallback as useCallback18, useEffect as useEffect21, useMemo as useMemo13, useRef as useRef17, useState as useState20 } from "react";
 
 // src/front/ArtifactOpenContext.tsx
 import { createContext, useContext } from "react";
@@ -5091,6 +5091,12 @@ function usePiSessions(options = {}) {
   const loadedDataSourceRef = useRef8(dataSourceKey);
   const requestScopeRef = useRef8(requestScopeKey);
   requestScopeRef.current = requestScopeKey;
+  const remoteSessionOptionsRef = useRef8(options.remoteSessionOptions);
+  remoteSessionOptionsRef.current = options.remoteSessionOptions;
+  const remoteSessionOptionsKey = useMemo3(
+    () => remoteSessionOptionsIdentity(options.remoteSessionOptions),
+    [options.remoteSessionOptions]
+  );
   useEffect8(() => {
     sessionsRef.current = sessions;
   }, [sessions]);
@@ -5253,7 +5259,7 @@ function usePiSessions(options = {}) {
       return;
     }
     const session = createRemoteSession({
-      ...options.remoteSessionOptions,
+      ...remoteSessionOptionsRef.current,
       sessionId: activeSessionId,
       workspaceId: options.workspaceId,
       storageScope,
@@ -5265,7 +5271,7 @@ function usePiSessions(options = {}) {
     return () => {
       session.dispose();
     };
-  }, [activeSessionId, activeSessionKnown, apiBaseUrl, connectActiveSession, createRemoteSession, enabled, fetchImpl, options.remoteSessionOptions, options.workspaceId, requestHeaders, storageScope]);
+  }, [activeSessionId, activeSessionKnown, apiBaseUrl, connectActiveSession, createRemoteSession, enabled, fetchImpl, remoteSessionOptionsKey, options.workspaceId, requestHeaders, storageScope]);
   const create = useCallback7(async (init) => {
     if (!enabled) throw new Error("Pi sessions are disabled");
     const response = await fetchImpl(sessionsUrl(), {
@@ -5377,6 +5383,40 @@ function toSessionSummary(value) {
 function canonicalPageCount(data) {
   return Math.min(data.length, SESSION_PAGE_SIZE);
 }
+var remoteSessionOptionObjectIds = /* @__PURE__ */ new WeakMap();
+var remoteSessionOptionObjectSeq = 0;
+function remoteSessionOptionObjectIdentity(value) {
+  if (typeof value !== "object" && typeof value !== "function" || value === null) return void 0;
+  const object = value;
+  let id = remoteSessionOptionObjectIds.get(object);
+  if (!id) {
+    id = ++remoteSessionOptionObjectSeq;
+    remoteSessionOptionObjectIds.set(object, id);
+  }
+  return String(id);
+}
+function remoteSessionOptionsIdentity(options) {
+  if (!options) return "{}";
+  return JSON.stringify({
+    autoStart: options.autoStart,
+    requestTimeoutMs: options.requestTimeoutMs,
+    onEvent: remoteSessionOptionObjectIdentity(options.onEvent),
+    storeOptions: remoteSessionOptionObjectIdentity(options.storeOptions),
+    setTimeoutFn: remoteSessionOptionObjectIdentity(options.setTimeoutFn),
+    clearTimeoutFn: remoteSessionOptionObjectIdentity(options.clearTimeoutFn),
+    reconnect: options.reconnect ? {
+      baseMs: options.reconnect.baseMs,
+      maxMs: options.reconnect.maxMs,
+      jitterRatio: options.reconnect.jitterRatio,
+      random: remoteSessionOptionObjectIdentity(options.reconnect.random)
+    } : void 0,
+    debug: options.debug ? {
+      largeStateWarningBytes: options.debug.largeStateWarningBytes,
+      largeStateWarningMessages: options.debug.largeStateWarningMessages,
+      onWarning: remoteSessionOptionObjectIdentity(options.debug.onWarning)
+    } : void 0
+  });
+}
 function mergeSessions(...lists) {
   const seen = /* @__PURE__ */ new Set();
   const merged = [];
@@ -5687,7 +5727,7 @@ var ConversationScrollButton = ({
 };
 
 // src/front/chat/components/ChatNotices.tsx
-import { AlertCircleIcon, ListRestartIcon, Loader2 } from "lucide-react";
+import { AlertCircleIcon, ExternalLinkIcon as ExternalLinkIcon2, ListRestartIcon, Loader2, XIcon as XIcon3 } from "lucide-react";
 import { IconButton as IconButton2 } from "@hachej/boring-ui-kit";
 
 // src/front/chat/components/noticeStyles.ts
@@ -5847,20 +5887,41 @@ function ComposerBlockerNotice({
       className: noticeSurfaceClass("info", "mx-auto mb-2 w-full max-w-3xl text-xs"),
       children: [
         /* @__PURE__ */ jsx16("span", { children: label }),
-        blocker?.actions?.map((action) => /* @__PURE__ */ jsx16(
-          "button",
-          {
-            type: "button",
-            className: "ml-2 rounded border border-primary/30 px-2 py-0.5 text-[11px] font-medium hover:bg-primary/10",
-            onClick: () => onAction?.(blocker, action.id),
-            children: action.label
-          },
-          action.id
-        ))
+        blocker?.actions?.map((action) => {
+          const icon = composerBlockerActionIcon(action.id);
+          return icon ? /* @__PURE__ */ jsx16(
+            IconButton2,
+            {
+              type: "button",
+              variant: "ghost",
+              size: "icon-sm",
+              className: "ml-1.5 h-6 w-6 rounded-md border border-primary/25 text-muted-foreground hover:bg-primary/10 hover:text-foreground",
+              onClick: () => onAction?.(blocker, action.id),
+              "aria-label": action.label,
+              title: action.label,
+              children: icon
+            },
+            action.id
+          ) : /* @__PURE__ */ jsx16(
+            "button",
+            {
+              type: "button",
+              className: "ml-2 rounded border border-primary/30 px-2 py-0.5 text-[11px] font-medium hover:bg-primary/10",
+              onClick: () => onAction?.(blocker, action.id),
+              children: action.label
+            },
+            action.id
+          );
+        })
       ]
     }
   );
 }
+function composerBlockerActionIcon(actionId) {
+  if (actionId === "open") return /* @__PURE__ */ jsx16(ExternalLinkIcon2, { className: "size-3.5", "aria-hidden": "true" });
+  if (actionId === "cancel") return /* @__PURE__ */ jsx16(XIcon3, { className: "size-3.5", "aria-hidden": "true" });
+  return null;
+}
 function QueuedComposerNotice({ followUps, onEdit }) {
   return /* @__PURE__ */ jsxs15(
     "div",
@@ -5911,7 +5972,7 @@ import {
   Music2Icon,
   PaperclipIcon,
   VideoIcon,
-  XIcon as XIcon3
+  XIcon as XIcon4
 } from "lucide-react";
 import { createContext as createContext3, useCallback as useCallback9, useContext as useContext3, useMemo as useMemo5 } from "react";
 import { jsx as jsx17, jsxs as jsxs16 } from "react/jsx-runtime";
@@ -6125,7 +6186,7 @@ var AttachmentRemove = ({
       variant: "ghost",
       ...props,
       children: [
-        children ?? /* @__PURE__ */ jsx17(XIcon3, {}),
+        children ?? /* @__PURE__ */ jsx17(XIcon4, {}),
         /* @__PURE__ */ jsx17("span", { className: "sr-only", children: label })
       ]
     }
@@ -8026,7 +8087,7 @@ import {
   Monitor,
   PlusIcon as PlusIcon2,
   SquareIcon,
-  XIcon as XIcon4
+  XIcon as XIcon5
 } from "lucide-react";
 import { nanoid } from "nanoid";
 import { useCallback as useCallback15, useEffect as useEffect18, useMemo as useMemo10, useRef as useRef14, useState as useState17 } from "react";
@@ -8560,7 +8621,7 @@ var PromptInputSubmit = ({
   } else if (status === "streaming") {
     Icon = /* @__PURE__ */ jsx29(SquareIcon, { className: "size-4" });
   } else if (status === "error") {
-    Icon = /* @__PURE__ */ jsx29(XIcon4, { className: "size-4" });
+    Icon = /* @__PURE__ */ jsx29(XIcon5, { className: "size-4" });
   }
   const handleClick = useCallback15(
     (e) => {
@@ -9157,7 +9218,7 @@ function getHeaderValue(headers, name) {
 }
 
 // src/front/chat/piChatPanelHooks.ts
-import { useCallback as useCallback17, useEffect as useEffect20, useState as useState19, useSyncExternalStore } from "react";
+import { useCallback as useCallback17, useEffect as useEffect20, useMemo as useMemo12, useRef as useRef16, useState as useState19, useSyncExternalStore } from "react";
 function useExternalRemotePiSession({
   sessionId,
   workspaceId,
@@ -9169,13 +9230,19 @@ function useExternalRemotePiSession({
   remoteSessionOptions
 }) {
   const [session, setSession] = useState19();
+  const remoteSessionOptionsRef = useRef16(remoteSessionOptions);
+  remoteSessionOptionsRef.current = remoteSessionOptions;
+  const remoteSessionOptionsKey = useMemo12(
+    () => remoteSessionOptionsIdentity2(remoteSessionOptions),
+    [remoteSessionOptions]
+  );
   useEffect20(() => {
     if (!sessionId) {
       setSession(void 0);
       return;
     }
     const next = (createRemoteSession ?? createRemotePiSession)({
-      ...remoteSessionOptions,
+      ...remoteSessionOptionsRef.current,
       sessionId,
       workspaceId,
       storageScope,
@@ -9185,9 +9252,43 @@ function useExternalRemotePiSession({
     });
     setSession(next);
     return () => next.dispose();
-  }, [apiBaseUrl, createRemoteSession, fetch2, remoteSessionOptions, requestHeaders, sessionId, storageScope, workspaceId]);
+  }, [apiBaseUrl, createRemoteSession, fetch2, remoteSessionOptionsKey, requestHeaders, sessionId, storageScope, workspaceId]);
   return session;
 }
+var remoteSessionOptionObjectIds2 = /* @__PURE__ */ new WeakMap();
+var remoteSessionOptionObjectSeq2 = 0;
+function remoteSessionOptionObjectIdentity2(value) {
+  if (typeof value !== "object" && typeof value !== "function" || value === null) return void 0;
+  const object = value;
+  let id = remoteSessionOptionObjectIds2.get(object);
+  if (!id) {
+    id = ++remoteSessionOptionObjectSeq2;
+    remoteSessionOptionObjectIds2.set(object, id);
+  }
+  return String(id);
+}
+function remoteSessionOptionsIdentity2(options) {
+  if (!options) return "{}";
+  return JSON.stringify({
+    autoStart: options.autoStart,
+    requestTimeoutMs: options.requestTimeoutMs,
+    onEvent: remoteSessionOptionObjectIdentity2(options.onEvent),
+    storeOptions: remoteSessionOptionObjectIdentity2(options.storeOptions),
+    setTimeoutFn: remoteSessionOptionObjectIdentity2(options.setTimeoutFn),
+    clearTimeoutFn: remoteSessionOptionObjectIdentity2(options.clearTimeoutFn),
+    reconnect: options.reconnect ? {
+      baseMs: options.reconnect.baseMs,
+      maxMs: options.reconnect.maxMs,
+      jitterRatio: options.reconnect.jitterRatio,
+      random: remoteSessionOptionObjectIdentity2(options.reconnect.random)
+    } : void 0,
+    debug: options.debug ? {
+      largeStateWarningBytes: options.debug.largeStateWarningBytes,
+      largeStateWarningMessages: options.debug.largeStateWarningMessages,
+      onWarning: remoteSessionOptionObjectIdentity2(options.debug.onWarning)
+    } : void 0
+  });
+}
 function useRemotePiSessionState(session) {
   return useSyncExternalStore(
     useCallback17((listener) => session?.subscribe(listener) ?? (() => {
@@ -9371,14 +9472,14 @@ function PiChatPanel({
 }) {
   const externalSessionId = sessionId?.trim() || void 0;
   const showSessionSidebar = showSessions ?? externalSessionId === void 0;
-  const onDataRef = useRef16(onData);
+  const onDataRef = useRef17(onData);
   onDataRef.current = onData;
-  const onTurnCompleteRef = useRef16(onTurnComplete);
+  const onTurnCompleteRef = useRef17(onTurnComplete);
   onTurnCompleteRef.current = onTurnComplete;
-  const sessionListRefreshRef = useRef16(void 0);
-  const requestHeadersKey = useMemo12(() => headersContentKey(requestHeaders), [requestHeaders]);
-  const normalizedRequestHeaders = useMemo12(() => normalizedHeadersFromContentKey(requestHeadersKey), [requestHeadersKey]);
-  const remoteSessionOptionsWithEvents = useMemo12(() => ({
+  const sessionListRefreshRef = useRef17(void 0);
+  const requestHeadersKey = useMemo13(() => headersContentKey(requestHeaders), [requestHeaders]);
+  const normalizedRequestHeaders = useMemo13(() => normalizedHeadersFromContentKey(requestHeadersKey), [requestHeadersKey]);
+  const remoteSessionOptionsWithEvents = useMemo13(() => ({
     ...remoteSessionOptions,
     ...hydrateMessages ? {} : { autoStart: false },
     onEvent: (event) => {
@@ -9442,7 +9543,7 @@ function PiChatPanel({
     enabled: serverResourcesEnabled && availableModels === void 0
   });
   const selectedModel = model === void 0 ? modelDiscovery.model : model;
-  const modelOptions = useMemo12(
+  const modelOptions = useMemo13(
     () => modelOptionsForSelection(availableModels ?? modelDiscovery.availableModels, selectedModel),
     [availableModels, modelDiscovery.availableModels, selectedModel]
   );
@@ -9474,13 +9575,13 @@ function PiChatPanel({
   const [modelPickerOpen, setModelPickerOpen] = useState20(false);
   const [thinkingPickerOpen, setThinkingPickerOpen] = useState20(false);
   const [draft, setDraft] = useState20(() => initialDraft ?? "");
-  const draftRef = useRef16(draft);
+  const draftRef = useRef17(draft);
   draftRef.current = draft;
-  const initialDraftGuard = useRef16(new InitialDraftAutoSubmitGuard());
-  const pendingAutoSubmitSettleRef = useRef16(void 0);
-  const acceptedAutoSubmitSettleRef = useRef16(void 0);
-  const resetInProgressRef = useRef16(false);
-  const autoCreateInFlightRef = useRef16(false);
+  const initialDraftGuard = useRef17(new InitialDraftAutoSubmitGuard());
+  const pendingAutoSubmitSettleRef = useRef17(void 0);
+  const acceptedAutoSubmitSettleRef = useRef17(void 0);
+  const resetInProgressRef = useRef17(false);
+  const autoCreateInFlightRef = useRef17(false);
   const settlePendingAutoSubmit = useCallback18((sessionId2) => {
     const pendingSessionId = pendingAutoSubmitSettleRef.current;
     if (!pendingSessionId || sessionId2 && pendingSessionId !== sessionId2) return false;
@@ -9489,19 +9590,19 @@ function PiChatPanel({
     onAutoSubmitInitialDraftSettled?.();
     return true;
   }, [onAutoSubmitInitialDraftSettled]);
-  const prevStatusRef = useRef16("idle");
-  const statusRef = useRef16("idle");
-  const scrollToBottomRef = useRef16(() => {
+  const prevStatusRef = useRef17("idle");
+  const statusRef = useRef17("idle");
+  const scrollToBottomRef = useRef17(() => {
   });
-  const textareaRef = useRef16(null);
+  const textareaRef = useRef17(null);
   const [localNotices, setLocalNotices] = useState20([]);
   const [dismissedNoticeIds, setDismissedNoticeIds] = useState20(() => /* @__PURE__ */ new Set());
   const [pluginUpdateState, setPluginUpdateState] = useState20(null);
   const [commandNotifyState, setCommandNotifyState] = useState20(null);
-  const commandRunIdRef = useRef16(0);
+  const commandRunIdRef = useRef17(0);
   const [serverSkillsRefreshKey, setServerSkillsRefreshKey] = useState20(0);
   const [localSubmittedSessionId, setLocalSubmittedSessionId] = useState20();
-  const localSubmittedSessionRef = useRef16(void 0);
+  const localSubmittedSessionRef = useRef17(void 0);
   const { attachmentNotice, setAttachmentNotice } = useAttachmentNotice();
   const markLocalSubmitted = useCallback18((sessionId2) => {
     localSubmittedSessionRef.current = sessionId2;
@@ -9512,7 +9613,7 @@ function PiChatPanel({
     localSubmittedSessionRef.current = void 0;
     setLocalSubmittedSessionId(void 0);
   }, []);
-  const registry = useMemo12(() => {
+  const registry = useMemo13(() => {
     const excludedBuiltins = new Set(excludeBuiltinCommands);
     const effectiveBuiltins = builtinCommands.filter((command) => {
       if (!hotReloadEnabled && command.name === "reload") return false;
@@ -9533,19 +9634,22 @@ function PiChatPanel({
     refreshKey: serverSkillsRefreshKey,
     enabled: serverResourcesEnabled
   });
-  const allCommands = useMemo12(() => registry.list(), [registry, commandsStamp]);
+  const allCommands = useMemo13(() => registry.list(), [registry, commandsStamp]);
   const activeChatSessionId = selectedChatState?.sessionId;
   const warmupNotice = composerNoticeForWarmup(workspaceWarmupStatus);
   const runtimeDependenciesNotice = composerNoticeForRuntimeDependencies(workspaceWarmupStatus);
   const workspaceWarmupBlocked = Boolean(warmupNotice);
-  const activeBlockers = useMemo12(
-    () => composerBlockers.filter((blocker) => !blocker.sessionId || blocker.sessionId === activeSessionId),
+  const activeBlockers = useMemo13(
+    // A missing active session id means a single/sessionless chat host. In that
+    // mode, keep scoped blockers visible instead of hiding the only attention UI.
+    // Multi-session hosts should pass a session id so unrelated blockers filter out.
+    () => composerBlockers.filter((blocker) => !blocker.sessionId || !activeSessionId || blocker.sessionId === activeSessionId),
     [activeSessionId, composerBlockers]
   );
   const canonicalMessages = selectedChatState ? selectMessagesForRender(selectedChatState) : [];
   const queuePreview = selectedChatState ? selectQueuePreview(selectedChatState) : [];
   const messages = canonicalMessages;
-  const userHistory = useMemo12(() => selectComposerHistoryFromCanonicalUsers(canonicalMessages), [canonicalMessages]);
+  const userHistory = useMemo13(() => selectComposerHistoryFromCanonicalUsers(canonicalMessages), [canonicalMessages]);
   const emptyStateHydrating = statusForState(selectedChatState, sessionsLoading || chatStatePending || selectedSessionPending) === "hydrating";
   const emptyHero = emptyPlacement === "hero" && messages.length === 0 && queuePreview.length === 0 && !emptyStateHydrating;
   const debugState = selectedPiSession?.getDebugState();
@@ -9553,7 +9657,7 @@ function PiChatPanel({
   const primaryComposerBlocker = activeBlockers[0];
   const composerBlockerLabel = workspaceWarmupBlocked ? warmupNotice?.title ?? "Preparing workspace..." : primaryComposerBlocker?.label ?? primaryComposerBlocker?.reason ?? "Complete the pending workspace action to continue.";
   const composerStatusNotice = warmupNotice ?? runtimeDependenciesNotice;
-  const runtimeNotices = useMemo12(() => {
+  const runtimeNotices = useMemo13(() => {
     const fromState = selectedChatState ? selectRuntimeNotices(selectedChatState) : [];
     const sessionNotice = sessionsError ? [{ id: "session-navigation-error", level: "error", text: sessionsError.message, dismissible: true }] : [];
     const largeStateNotice = debug && debugState?.largeStateWarning ? [{
@@ -9772,7 +9876,7 @@ function PiChatPanel({
     }
     insertSlashCommand(name);
   }, [dismissSlash, insertSlashCommand, openModelPicker, openThinkingPicker, setComposerDraft]);
-  const policy = useMemo12(() => {
+  const policy = useMemo13(() => {
     if (!selectedPiSession || !activeChatSessionId) return void 0;
     const policySession = {
       getState: () => {
@@ -9981,8 +10085,8 @@ function PiChatPanel({
   const isStreaming = isPiBusyStatus(status);
   const submitStatus = toPromptSubmitStatus(status);
   const submitDisabled = !policy || sessionsLoading || composerBlocked && !isStreaming;
-  const mergedToolRenderers = useMemo12(() => mergeShadcnToolRenderers(toolRenderers), [toolRenderers]);
-  const debugMessages = useMemo12(() => messages.map(toDebugUiMessage), [messages]);
+  const mergedToolRenderers = useMemo13(() => mergeShadcnToolRenderers(toolRenderers), [toolRenderers]);
+  const debugMessages = useMemo13(() => messages.map(toDebugUiMessage), [messages]);
   const onTextareaChange = useCallback18((event) => {
     setModelPickerOpen(false);
     setThinkingPickerOpen(false);

package/dist/front/styles.css

@@ -889,6 +889,12 @@
       border-color: color-mix(in oklab, var(--input) 60%, transparent);
     }
   }
+  .border-primary\/25 {
+    border-color: var(--primary);
+    @supports (color: color-mix(in lab, red, red)) {
+      border-color: color-mix(in oklab, var(--primary) 25%, transparent);
+    }
+  }
   .border-primary\/30 {
     border-color: var(--primary);
     @supports (color: color-mix(in lab, red, red)) {

package/dist/server/index.d.ts

@@ -1,5 +1,5 @@
-import { o as WorkspaceRuntimeContext, S as Sandbox, g as SandboxHandleStore, f as SandboxHandleRecord, W as Workspace, j as TelemetrySink, F as FileSearch, i as Stat, E as Entry, c as ExecResult, q as WorkspaceChangeEvent, b as ExecOptions, P as PluginRestartWarning, A as AgentTool, r as AgentHarnessFactory } from '../agentPluginEvents-Dgm57gEU.js';
-export { t as AgentHarnessFactoryInput } from '../agentPluginEvents-Dgm57gEU.js';
+import { o as WorkspaceRuntimeContext, S as Sandbox, g as SandboxHandleStore, f as SandboxHandleRecord, W as Workspace, j as TelemetrySink, q as ToolReadinessRequirement, F as FileSearch, i as Stat, E as Entry, c as ExecResult, r as WorkspaceChangeEvent, b as ExecOptions, P as PluginRestartWarning, A as AgentTool, t as AgentHarnessFactory } from '../agentPluginEvents-Ddn5DQ5E.js';
+export { u as AgentHarnessFactoryInput } from '../agentPluginEvents-Ddn5DQ5E.js';
 import { Sandbox as Sandbox$1 } from '@vercel/sandbox';
 import { FastifyInstance, FastifyRequest, FastifyPluginAsync } from 'fastify';
 import { PackageSource, ExtensionFactory, SettingsManager } from '@mariozechner/pi-coding-agent';
@@ -317,8 +317,107 @@ interface ProvisionWorkspaceRuntimeOptions {
 
 declare function provisionWorkspaceRuntime(opts: ProvisionWorkspaceRuntimeOptions): Promise<WorkspaceProvisioningResult>;
 
+type ReadyState = 'provisioning' | 'ready' | 'degraded';
+type CapabilityState = 'not-started' | 'preparing' | 'ready' | 'failed';
+interface CapabilityReadinessDetail {
+    state: CapabilityState;
+    requirement?: ToolReadinessRequirement;
+    startedAt?: string;
+    completedAt?: string;
+    errorCode?: string;
+    causeCode?: string;
+    retryable?: boolean;
+    message?: string;
+}
+interface AgentCapabilityReadiness {
+    chat: CapabilityReadinessDetail;
+    workspace: CapabilityReadinessDetail;
+    runtimeDependencies: CapabilityReadinessDetail;
+}
+interface ReadyStatusEvent {
+    state: ReadyState;
+    sandboxReady: boolean;
+    harnessReady: boolean;
+    capabilities: AgentCapabilityReadiness;
+    message?: string;
+    timestamp: string;
+}
+interface ReadinessSnapshot {
+    sandboxReady: boolean;
+    harnessReady: boolean;
+    capabilities: AgentCapabilityReadiness;
+    degradedReason?: string;
+}
+type StatusHandler = (event: ReadyStatusEvent) => void;
+declare class ReadyStatusTracker {
+    private _sandboxReady;
+    private _harnessReady;
+    private _degradedReason?;
+    private _capabilities;
+    private subscribers;
+    constructor(opts?: {
+        sandboxReady?: boolean;
+        harnessReady?: boolean;
+        capabilities?: Partial<AgentCapabilityReadiness>;
+    });
+    get state(): ReadyState;
+    isReady(): boolean;
+    getReadiness(): ReadinessSnapshot;
+    getCapabilities(): AgentCapabilityReadiness;
+    updateCapability(name: keyof AgentCapabilityReadiness, detail: CapabilityReadinessDetail): void;
+    updateRuntimeDependencies(detail: CapabilityReadinessDetail): void;
+    markSandboxReady(): void;
+    markHarnessReady(): void;
+    markDegraded(reason: string): void;
+    clearDegraded(): void;
+    subscribe(handler: StatusHandler): () => void;
+    private emit;
+    private snapshot;
+}
+
 type BuiltinRuntimeModeId = 'direct' | 'local' | 'vercel-sandbox';
 type RuntimeModeId = BuiltinRuntimeModeId | (string & {});
+interface RuntimeModeReadinessHooks {
+    initialSandboxReady?: boolean;
+    initialWorkspaceReadiness?: CapabilityReadinessDetail;
+    onTrackerCreated?: (tracker: ReadyStatusTracker) => void;
+}
+type RuntimeCachedBindingHealthCheckResult = {
+    state: 'ok';
+} | {
+    state: 'recreate';
+    message?: string;
+    error?: unknown;
+};
+interface RuntimeCachedBindingHealthCheck {
+    intervalMs?: number;
+    check(ctx: {
+        runtimeBundle: RuntimeBundle;
+        workspaceId: string;
+    }): Promise<RuntimeCachedBindingHealthCheckResult>;
+}
+type RuntimeBashStrategy = {
+    kind: 'host';
+    preserveHostHome?: boolean;
+} | {
+    kind: 'local-sandbox';
+    sandboxRoot: string;
+} | {
+    kind: 'remote';
+    defaultPath?: string;
+};
+interface RuntimeRemoteWorkspacePathOptions {
+    rootAliases?: string[];
+    toRemotePath?: (value: string) => string;
+    toRuntimePath?: (value: string) => string;
+    sanitizeErrorText?: (value: string) => string;
+}
+type RuntimeFilesystemStrategy = {
+    kind: 'host';
+} | {
+    kind: 'remote-workspace';
+    pathOptions?: RuntimeRemoteWorkspacePathOptions;
+};
 interface RuntimeModeAdapter {
     readonly id: RuntimeModeId;
     /**
@@ -327,8 +426,14 @@ interface RuntimeModeAdapter {
      * host-side fs checks/prompts are safe without hard-coding sandbox IDs.
      */
     readonly workspaceFsCapability?: Workspace['fsCapability'];
+    readonly readiness?: RuntimeModeReadinessHooks;
+    readonly cachedBindingHealthCheck?: RuntimeCachedBindingHealthCheck;
     create(ctx: ModeContext): Promise<RuntimeBundle>;
     createProvisioningAdapter?(runtimeLayout: BoringAgentRuntimePaths, ctx?: ModeContext): WorkspaceProvisioningAdapter;
+    getRuntimeLayoutRoot?(ctx: ModeContext): string;
+    evictCachedRuntime?(ctx: {
+        workspaceId: string;
+    }): void;
     dispose?(): Promise<void>;
 }
 interface ModeContext {
@@ -350,6 +455,12 @@ interface RuntimeBundle {
     workspace: Workspace;
     sandbox: Sandbox;
     fileSearch: FileSearch;
+    /** Optional per-execution runtime env provider for local/direct operations that do not call Sandbox.exec. */
+    getRuntimeEnv?: () => Promise<Record<string, string>>;
+    /** Runtime-owned bash execution strategy, consumed by the agent bash tool builder. */
+    bash?: RuntimeBashStrategy;
+    /** Runtime-owned filesystem strategy, consumed by the agent filesystem tool builder. */
+    filesystem?: RuntimeFilesystemStrategy;
 }
 
 declare const REMOTE_WORKER_RUNTIME_CWD = "/workspace";
@@ -578,7 +689,10 @@ declare function createVercelProvisioningAdapter(options: CreateVercelProvisioni
 
 declare function hasBwrap(): boolean;
 declare function autoDetectMode(): RuntimeModeId;
-declare function resolveMode(mode?: RuntimeModeId): RuntimeModeAdapter;
+interface ResolveModeOptions {
+    sandboxHandleStore?: SandboxHandleStore;
+}
+declare function resolveMode(mode?: RuntimeModeId, opts?: ResolveModeOptions): RuntimeModeAdapter;
 
 interface ReloadHookDiagnostic {
     source: string;
@@ -597,6 +711,17 @@ interface ReloadHookResult {
     diagnostics?: ReadonlyArray<ReloadHookDiagnostic>;
 }
 
+interface RuntimeEnvContributionContext {
+    workspaceId: string;
+    workspaceRoot: string;
+    runtimeMode: RuntimeModeId;
+    runtimeBundle: RuntimeBundle;
+}
+interface RuntimeEnvContribution {
+    id: string;
+    getEnv(ctx: RuntimeEnvContributionContext): Record<string, string> | Promise<Record<string, string>>;
+}
+
 type PiPackageSource = PackageSource;
 declare const PI_PACKAGE_RESOURCE_FILTERS: readonly ["extensions", "skills", "prompts", "themes"];
 declare function piPackageSourceKey(source: PiPackageSource): string;
@@ -768,6 +893,14 @@ interface CreateAgentAppOptions {
     telemetry?: TelemetrySink;
     /** Optional billing sink for native Pi usage (see AgentMeteringSink). */
     metering?: AgentMeteringSink;
+    /** Generic runtime env contributors. Agent stays workspace-neutral; hosts decide env names/values. */
+    runtimeEnvContributions?: RuntimeEnvContribution[];
+    /** Runtime-aware provisioning hook. Runs after Workspace/Sandbox creation and before tools/harness. */
+    runtimeProvisioner?: (ctx: {
+        workspaceRoot: string;
+        runtimeMode: RuntimeModeId;
+        runtimeBundle: RuntimeBundle;
+    }) => Promise<void>;
     /** Optional explicit file-backed session directory. Mostly for tests/hosts. */
     sessionDir?: string;
     /**
@@ -849,6 +982,8 @@ interface RegisterAgentRoutesOptions {
         request?: FastifyRequest;
     }) => PiHarnessOptions | undefined | Promise<PiHarnessOptions | undefined>;
     sessionNamespace?: string;
+    /** Optional explicit root for file-backed Pi chat transcript storage. */
+    sessionRoot?: string;
     /** Optional best-effort telemetry sink supplied by an embedding host. */
     telemetry?: TelemetrySink;
     /**
@@ -873,6 +1008,8 @@ interface RegisterAgentRoutesOptions {
     sandboxHandleStore?: SandboxHandleStore;
     getWorkspaceId?: (request: FastifyRequest) => string | Promise<string>;
     getWorkspaceRoot?: (workspaceId: string, request: FastifyRequest) => string | Promise<string>;
+    /** Generic runtime env contributors. Agent stays workspace-neutral; hosts decide env names/values. */
+    runtimeEnvContributions?: RuntimeEnvContribution[];
     /**
      * Optional runtime reconciliation hook. Callers own plugin discovery and may
      * call provisionWorkspaceRuntime() with the normalized structural inputs.
@@ -927,4 +1064,4 @@ interface Logger {
 }
 declare function createLogger(prefix: string): Logger;
 
-export { AgentHarnessFactory, type AgentMeteringSink, type BoringAgentRuntimePaths, type BuiltinRuntimeModeId, type BwrapResourceLimits, type CreateAgentAppOptions, type CreateBwrapSandboxOptions, type CreateVercelProvisioningAdapterOptions, type DeploymentSnapshotProvider, type DeploymentSnapshotRecipe, type DeploymentSnapshotResult, type DeploymentSnapshotStatus, FileHandleStore, type LogFields, type Logger, type MeteringErrorLogger, type MeteringReleaseInput, type MeteringReleaseReason, type MeteringReservationResult, type MeteringReserveInput, type MeteringRunKind, type MeteringRunScope, type MeteringRunStatus, type MeteringSettleInput, type MeteringUsage, type MeteringUsageInput, type ModeContext, PI_PACKAGE_RESOURCE_FILTERS, type PiExtensionFactory, type PiHarnessOptions, type PiPackageSource, type PluginSkillSource, type ProvisionRuntimeWorkspaceOptions, type ProvisionWorkspaceRuntimeOptions, type ProvisioningArtifactRequest, REMOTE_WORKER_PROVIDER, REMOTE_WORKER_RUNTIME_CWD, type RegisterAgentRoutesOptions, RemoteWorkerClient, RemoteWorkerClientError, type RemoteWorkerClientOptions, type RemoteWorkerErrorPayload, type RemoteWorkerExecRequest, type RemoteWorkerExecResponse, type RemoteWorkerFsEventEnvelope, type RemoteWorkerModeAdapterOptions, type RemoteWorkerWorkspaceOp, type RemoteWorkerWorkspaceResult, type RuntimeBundle, type RuntimeModeAdapter, type RuntimeModeId, type RuntimeNodePackageSpec$1 as RuntimeNodePackageSpec, type RuntimeProvisioningContribution$1 as RuntimeProvisioningContribution, type RuntimePythonSpec$1 as RuntimePythonSpec, type RuntimeTemplateContribution$1 as RuntimeTemplateContribution, type RuntimeWorkspaceProvisioningResult, type SnapshotBakeOptions, type SnapshotBakeResult, UV_SETUP_COMMANDS, VERCEL_PROVISIONING_CACHE_ROOT, VERCEL_SANDBOX_WORKSPACE_ROOT, UV_SETUP_COMMANDS as VERCEL_UV_SETUP_COMMANDS, type VercelBakeClient, type VercelBakeSandbox, type VercelDeploymentSnapshotOptions, WORKER_INTERNAL_TOKEN_HEADER, WORKER_REQUEST_ID_HEADER, WORKER_WORKSPACE_ID_HEADER, type WorkspaceProvisioningAdapter, type WorkspaceProvisioningExecResult, type WorkspaceProvisioningResult, applyCspHeaders, autoDetectMode, bakeSnapshotIfNeeded, buildDeploymentSnapshotRecipe, buildPackageHash, buildSnapshotRecipeHash, compactPiPackages, constantTimeTokenEqual, createAgentApp, createBwrapSandbox, createDirectSandbox, createLogger, createNodeWorkspace, createRemoteWorkerModeAdapter, createRemoteWorkerSandbox, createRemoteWorkerWorkspace, createResourceSettingsManager, createVercelDeploymentSnapshotProvider, createVercelProvisioningAdapter, createVercelSandboxWorkspace, decodeBytesFromWorker, encodeBytesForWorker, fileRoutes, getBoringAgentPathEntries, getBoringAgentRuntimeEnv, getBoringAgentRuntimePaths, hasBwrap, mergePiPackageSources, normalizeMeteringUsage, piPackageSourceKey, prepareDeploymentSnapshot, prepareVercelDeploymentSnapshot, provisionRuntimeWorkspace, provisionWorkspaceRuntime, registerAgentRoutes, resolveMode, resolveSandboxHandle };
+export { AgentHarnessFactory, type AgentMeteringSink, type BoringAgentRuntimePaths, type BuiltinRuntimeModeId, type BwrapResourceLimits, type CreateAgentAppOptions, type CreateBwrapSandboxOptions, type CreateVercelProvisioningAdapterOptions, type DeploymentSnapshotProvider, type DeploymentSnapshotRecipe, type DeploymentSnapshotResult, type DeploymentSnapshotStatus, FileHandleStore, type LogFields, type Logger, type MeteringErrorLogger, type MeteringReleaseInput, type MeteringReleaseReason, type MeteringReservationResult, type MeteringReserveInput, type MeteringRunKind, type MeteringRunScope, type MeteringRunStatus, type MeteringSettleInput, type MeteringUsage, type MeteringUsageInput, type ModeContext, PI_PACKAGE_RESOURCE_FILTERS, type PiExtensionFactory, type PiHarnessOptions, type PiPackageSource, type PluginSkillSource, type ProvisionRuntimeWorkspaceOptions, type ProvisionWorkspaceRuntimeOptions, type ProvisioningArtifactRequest, REMOTE_WORKER_PROVIDER, REMOTE_WORKER_RUNTIME_CWD, type RegisterAgentRoutesOptions, RemoteWorkerClient, RemoteWorkerClientError, type RemoteWorkerClientOptions, type RemoteWorkerErrorPayload, type RemoteWorkerExecRequest, type RemoteWorkerExecResponse, type RemoteWorkerFsEventEnvelope, type RemoteWorkerModeAdapterOptions, type RemoteWorkerWorkspaceOp, type RemoteWorkerWorkspaceResult, type RuntimeBundle, type RuntimeEnvContribution, type RuntimeEnvContributionContext, type RuntimeModeAdapter, type RuntimeModeId, type RuntimeNodePackageSpec$1 as RuntimeNodePackageSpec, type RuntimeProvisioningContribution$1 as RuntimeProvisioningContribution, type RuntimePythonSpec$1 as RuntimePythonSpec, type RuntimeTemplateContribution$1 as RuntimeTemplateContribution, type RuntimeWorkspaceProvisioningResult, type SnapshotBakeOptions, type SnapshotBakeResult, UV_SETUP_COMMANDS, VERCEL_PROVISIONING_CACHE_ROOT, VERCEL_SANDBOX_WORKSPACE_ROOT, UV_SETUP_COMMANDS as VERCEL_UV_SETUP_COMMANDS, type VercelBakeClient, type VercelBakeSandbox, type VercelDeploymentSnapshotOptions, WORKER_INTERNAL_TOKEN_HEADER, WORKER_REQUEST_ID_HEADER, WORKER_WORKSPACE_ID_HEADER, type WorkspaceProvisioningAdapter, type WorkspaceProvisioningExecResult, type WorkspaceProvisioningResult, applyCspHeaders, autoDetectMode, bakeSnapshotIfNeeded, buildDeploymentSnapshotRecipe, buildPackageHash, buildSnapshotRecipeHash, compactPiPackages, constantTimeTokenEqual, createAgentApp, createBwrapSandbox, createDirectSandbox, createLogger, createNodeWorkspace, createRemoteWorkerModeAdapter, createRemoteWorkerSandbox, createRemoteWorkerWorkspace, createResourceSettingsManager, createVercelDeploymentSnapshotProvider, createVercelProvisioningAdapter, createVercelSandboxWorkspace, decodeBytesFromWorker, encodeBytesForWorker, fileRoutes, getBoringAgentPathEntries, getBoringAgentRuntimeEnv, getBoringAgentRuntimePaths, hasBwrap, mergePiPackageSources, normalizeMeteringUsage, piPackageSourceKey, prepareDeploymentSnapshot, prepareVercelDeploymentSnapshot, provisionRuntimeWorkspace, provisionWorkspaceRuntime, registerAgentRoutes, resolveMode, resolveSandboxHandle };