@hachej/boring-agent 0.1.58 → 0.1.60

package/dist/front/index.d.ts

@@ -523,6 +523,51 @@ interface SessionListProps {
 declare function SessionList({ sessions, activeId, loading, onSwitch, onCreate, onDelete, onLoadMore, hasMore, loadingMore, onClose, className, }: SessionListProps): react_jsx_runtime.JSX.Element;
 declare const SessionBrowser: typeof SessionList;
 
+interface PiSessionSearchItem {
+    id: string;
+    /** boring-ui session title maps to pi's session display name. */
+    title?: string | null;
+    /** Optional pi-style session name for callers that already expose it. */
+    name?: string | null;
+    /** Optional full transcript search text when available from a pi session listing. */
+    allMessagesText?: string | null;
+    /** Optional cwd from the underlying pi session. */
+    cwd?: string | null;
+    updatedAt?: string | number | Date | null;
+}
+type PiSessionSearchSortMode = "fuzzy" | "recent";
+interface PiSessionSearchOptions {
+    sortMode?: PiSessionSearchSortMode;
+    limit?: number;
+}
+type SearchToken = {
+    kind: "fuzzy" | "phrase";
+    value: string;
+};
+type ParsedSearchQuery = {
+    mode: "tokens";
+    tokens: SearchToken[];
+    regex: null;
+    error?: undefined;
+} | {
+    mode: "regex";
+    tokens: [];
+    regex: RegExp | null;
+    error?: string;
+};
+/**
+ * Parse session-search queries with the same user-facing syntax as pi's native
+ * session picker: whitespace fuzzy tokens, quoted exact phrases, and `re:`
+ * regex mode. Kept intentionally small so boring-agent frontends can reuse the
+ * pi search behavior without importing the terminal-only session picker UI.
+ */
+declare function parsePiSessionSearchQuery(query: string): ParsedSearchQuery;
+declare function matchPiSessionSearch(session: PiSessionSearchItem, parsed: ParsedSearchQuery): {
+    matches: boolean;
+    score: number;
+};
+declare function searchPiSessions<T extends PiSessionSearchItem>(sessions: readonly T[], query: string, options?: PiSessionSearchOptions): T[];
+
 interface ComposerBlockerAction {
     id: string;
     label: string;
@@ -592,6 +637,7 @@ interface PiChatPanelProps<TComposerBlocker extends ComposerBlocker = ComposerBl
     createRemoteSession?: (options: RemotePiSessionOptions) => RemotePiSession;
     remoteSessionOptions?: UsePiSessionsOptions['remoteSessionOptions'];
     hydrateMessages?: boolean;
+    allowPromptDuringInitialHydration?: boolean;
     workspaceWarmupStatus?: ChatPanelWorkspaceWarmupStatus;
     onSessionReset?: () => void | Promise<void>;
     onBeforeSubmit?: (draft: string, context: ChatSubmitContext) => false | void | boolean | Promise<false | void | boolean>;
@@ -599,6 +645,10 @@ interface PiChatPanelProps<TComposerBlocker extends ComposerBlocker = ComposerBl
     onCommandResult?: (message: string) => void;
     onComposerWarning?: (message: string) => void;
     onMentionedFilesConsumed?: () => void;
+    onPromptSubmitStarted?: (context: {
+        sessionId: string;
+        clientNonce: string;
+    }) => void;
     onData?: (part: unknown) => void;
     onOpenArtifact?: (path: string) => void;
     composerBlockers?: TComposerBlocker[];
@@ -613,7 +663,7 @@ interface PiChatPanelProps<TComposerBlocker extends ComposerBlocker = ComposerBl
      * knowing what the code means or what the action does. */
     renderNoticeAction?: (notice: PiChatRuntimeNotice) => ReactNode;
 }
-declare function PiChatPanel<TComposerBlocker extends ComposerBlocker = ComposerBlocker>({ 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<TComposerBlocker>): react_jsx_runtime.JSX.Element;
+declare function PiChatPanel<TComposerBlocker extends ComposerBlocker = ComposerBlocker>({ 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, allowPromptDuringInitialHydration, workspaceWarmupStatus, onSessionReset, onBeforeSubmit, onReloadAgentPlugins, onCommandResult, onComposerWarning, onMentionedFilesConsumed, onPromptSubmitStarted, onData, onOpenArtifact, composerBlockers, onComposerStop, onComposerBlockerAction, onTurnComplete, renderNoticeAction, }: PiChatPanelProps<TComposerBlocker>): react_jsx_runtime.JSX.Element;
 
 interface DebugDrawerProps {
     apiBaseUrl?: string;
@@ -716,4 +766,4 @@ declare const CodeBlock: ({ code, language, showLineNumbers, className, children
 
 declare function cn(...inputs: ClassValue[]): string;
 
-export { type AgentCommandContribution, type AgentCommandOptions, ArtifactOpenProvider, ChatEmptyState, type ChatEmptyStateProps, PiChatPanel as ChatPanel, type PiChatPanelProps as ChatPanelProps, type ChatSuggestion, CodeBlock, type CommandRegistry, type ComposerBlocker, type ComposerBlockerAction, Conversation, ConversationContent, ConversationScrollButton, DebugDrawer, type GroupedToolEntry, Message, MessageAction, MessageActions, MessageContent, MessageResponse, type OpenArtifactHandler, type ParsedCommand, PiChatPanel, type PiChatPanelProps, SessionBrowser as PiSessionBrowser, type PiSessionCreateInit, SessionList as PiSessionList, PromptInput, PromptInputFooter, PromptInputSubmit, PromptInputTextarea, Reasoning, ReasoningContent, ReasoningTrigger, type SessionListProps, type SlashCommand, type SlashCommandContext, ToolCallGroup, type ToolPart, type ToolRenderer, type ToolRendererOverrides, type UploadFileOptions, type UploadFileResult, type UsePiSessionsOptions, type UsePiSessionsResult, activeSessionStorageKey, builtinCommands, clearActiveSessionId, cn, createCommandRegistry, defaultChatSuggestions, defaultToolRenderers, getAgentCommands, mergeShadcnToolRenderers, mergeToolRenderers, parseSlashCommand, readActiveSessionId, resolveToolRenderer, uploadFile, useOpenArtifact, usePiSessions, writeActiveSessionId };
+export { type AgentCommandContribution, type AgentCommandOptions, ArtifactOpenProvider, ChatEmptyState, type ChatEmptyStateProps, PiChatPanel as ChatPanel, type PiChatPanelProps as ChatPanelProps, type ChatSuggestion, CodeBlock, type CommandRegistry, type ComposerBlocker, type ComposerBlockerAction, Conversation, ConversationContent, ConversationScrollButton, DebugDrawer, type GroupedToolEntry, Message, MessageAction, MessageActions, MessageContent, MessageResponse, 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, ToolCallGroup, type 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 };

package/dist/front/index.js

@@ -2309,7 +2309,10 @@ var PiFollowUpQueueController = class {
       return this.block("empty", "Enter a message before sending.");
     }
     const state = this.session.getState();
-    if (state.status === "hydrating") {
+    if (state.status === "hydrating" && !(this.options.allowPromptDuringInitialHydration === true && canPromptDuringInitialHydration(state))) {
+      return this.block("hydrating", "The agent session is still hydrating.");
+    }
+    if (state.status === "idle" && hasPendingOptimisticPromptInEmptySession(state)) {
       return this.block("hydrating", "The agent session is still hydrating.");
     }
     if (isPiChatBusy(state.status)) {
@@ -2379,6 +2382,12 @@ function createPiFollowUpQueueController(session, options) {
 function isPiChatBusy(status) {
   return status === "submitted" || status === "streaming" || status === "aborting";
 }
+function canPromptDuringInitialHydration(state) {
+  return !state.hydrated && state.history.messageCount === 0 && state.committedMessages.length === 0 && state.queue.followUps.length === 0 && Object.keys(state.optimisticOutbox).length === 0 && !state.streamingMessage;
+}
+function hasPendingOptimisticPromptInEmptySession(state) {
+  return state.hydrated && state.history.messageCount === 0 && state.committedMessages.length === 0 && Object.values(state.optimisticOutbox).some((message) => message.clientSeq === void 0);
+}
 function nextFollowUpClientSeq(state, floor = 1) {
   let maxSeq = floor - 1;
   for (const queued of state.queue.followUps) {
@@ -3776,13 +3785,15 @@ function hydrateFromSnapshot(state, snapshot, options = {}) {
   for (const followUp of queue.followUps) {
     if (followUp.clientNonce) serverNonces.add(followUp.clientNonce);
   }
+  const preserveInitialOptimisticOutbox = shouldPreserveInitialOptimisticOutbox(state, snapshot, snapshotMessages);
+  const preserveOutbox = preserveLocalHistory || preserveInitialOptimisticOutbox;
   const nextOutbox = {};
-  if (preserveLocalHistory) {
+  if (preserveOutbox) {
     for (const message of Object.values(state.optimisticOutbox)) {
       if (!serverNonces.has(message.clientNonce)) nextOutbox[message.clientNonce] = message;
     }
   }
-  const staleOutbox = preserveLocalHistory ? [] : Object.values(state.optimisticOutbox).filter((message) => !serverNonces.has(message.clientNonce));
+  const staleOutbox = preserveOutbox ? [] : Object.values(state.optimisticOutbox).filter((message) => !serverNonces.has(message.clientNonce));
   const notices = staleOutbox.length > 0 ? upsertNotice(state.notices, {
     id: "stale-outbox-cleared",
     level: "warning",
@@ -3809,6 +3820,9 @@ function hydrateFromSnapshot(state, snapshot, options = {}) {
     needsResync: void 0
   };
 }
+function shouldPreserveInitialOptimisticOutbox(state, snapshot, snapshotMessages) {
+  return !state.hydrated && Object.keys(state.optimisticOutbox).length > 0 && snapshotMessages.length === 0 && snapshot.queue.followUps.length === 0;
+}
 function shouldPreserveLocalCommittedHistory(state, snapshot, snapshotMessages, options) {
   if (options.allowSeqRewind) return false;
   if (!state.hydrated) return false;
@@ -5649,6 +5663,190 @@ function sortByUpdatedDesc(a, b) {
   return a.id.localeCompare(b.id);
 }
 
+// ../../node_modules/.pnpm/@earendil-works+pi-tui@0.75.5/node_modules/@earendil-works/pi-tui/dist/fuzzy.js
+function fuzzyMatch(query, text) {
+  const queryLower = query.toLowerCase();
+  const textLower = text.toLowerCase();
+  const matchQuery = (normalizedQuery) => {
+    if (normalizedQuery.length === 0) {
+      return { matches: true, score: 0 };
+    }
+    if (normalizedQuery.length > textLower.length) {
+      return { matches: false, score: 0 };
+    }
+    let queryIndex = 0;
+    let score = 0;
+    let lastMatchIndex = -1;
+    let consecutiveMatches = 0;
+    for (let i = 0; i < textLower.length && queryIndex < normalizedQuery.length; i++) {
+      if (textLower[i] === normalizedQuery[queryIndex]) {
+        const isWordBoundary = i === 0 || /[\s\-_./:]/.test(textLower[i - 1]);
+        if (lastMatchIndex === i - 1) {
+          consecutiveMatches++;
+          score -= consecutiveMatches * 5;
+        } else {
+          consecutiveMatches = 0;
+          if (lastMatchIndex >= 0) {
+            score += (i - lastMatchIndex - 1) * 2;
+          }
+        }
+        if (isWordBoundary) {
+          score -= 10;
+        }
+        score += i * 0.1;
+        lastMatchIndex = i;
+        queryIndex++;
+      }
+    }
+    if (queryIndex < normalizedQuery.length) {
+      return { matches: false, score: 0 };
+    }
+    if (normalizedQuery === textLower) {
+      score -= 100;
+    }
+    return { matches: true, score };
+  };
+  const primaryMatch = matchQuery(queryLower);
+  if (primaryMatch.matches) {
+    return primaryMatch;
+  }
+  const alphaNumericMatch = queryLower.match(/^(?<letters>[a-z]+)(?<digits>[0-9]+)$/);
+  const numericAlphaMatch = queryLower.match(/^(?<digits>[0-9]+)(?<letters>[a-z]+)$/);
+  const swappedQuery = alphaNumericMatch ? `${alphaNumericMatch.groups?.digits ?? ""}${alphaNumericMatch.groups?.letters ?? ""}` : numericAlphaMatch ? `${numericAlphaMatch.groups?.letters ?? ""}${numericAlphaMatch.groups?.digits ?? ""}` : "";
+  if (!swappedQuery) {
+    return primaryMatch;
+  }
+  const swappedMatch = matchQuery(swappedQuery);
+  if (!swappedMatch.matches) {
+    return primaryMatch;
+  }
+  return { matches: true, score: swappedMatch.score + 5 };
+}
+
+// src/front/chat/session/piSessionSearch.ts
+function normalizeWhitespaceLower(text) {
+  return text.toLowerCase().replace(/\s+/g, " ").trim();
+}
+function sessionModifiedMs(session) {
+  const value = session.updatedAt;
+  if (value instanceof Date) return value.getTime();
+  if (typeof value === "number") return Number.isFinite(value) ? value : 0;
+  if (typeof value === "string") {
+    const parsed = Date.parse(value);
+    return Number.isFinite(parsed) ? parsed : 0;
+  }
+  return 0;
+}
+function getSessionSearchText(session) {
+  const name = session.name ?? session.title ?? "";
+  return `${session.id} ${name} ${session.allMessagesText ?? ""} ${session.cwd ?? ""}`;
+}
+function parsePiSessionSearchQuery(query) {
+  const trimmed = query.trim();
+  if (!trimmed) return { mode: "tokens", tokens: [], regex: null };
+  if (trimmed.startsWith("re:")) {
+    const pattern = trimmed.slice(3).trim();
+    if (!pattern) return { mode: "regex", tokens: [], regex: null, error: "Empty regex" };
+    try {
+      return { mode: "regex", tokens: [], regex: new RegExp(pattern, "i") };
+    } catch (error) {
+      return {
+        mode: "regex",
+        tokens: [],
+        regex: null,
+        error: error instanceof Error ? error.message : String(error)
+      };
+    }
+  }
+  const tokens = [];
+  let buffer = "";
+  let inQuote = false;
+  let hadUnclosedQuote = false;
+  const flush = (kind) => {
+    const value = buffer.trim();
+    buffer = "";
+    if (value) tokens.push({ kind, value });
+  };
+  for (let index = 0; index < trimmed.length; index += 1) {
+    const char = trimmed[index];
+    if (char === '"') {
+      if (inQuote) {
+        flush("phrase");
+        inQuote = false;
+      } else {
+        flush("fuzzy");
+        inQuote = true;
+      }
+      continue;
+    }
+    if (!inQuote && /\s/.test(char)) {
+      flush("fuzzy");
+      continue;
+    }
+    buffer += char;
+  }
+  if (inQuote) hadUnclosedQuote = true;
+  if (hadUnclosedQuote) {
+    return {
+      mode: "tokens",
+      tokens: trimmed.split(/\s+/).map((token) => token.trim()).filter((token) => token.length > 0).map((value) => ({ kind: "fuzzy", value })),
+      regex: null
+    };
+  }
+  flush(inQuote ? "phrase" : "fuzzy");
+  return { mode: "tokens", tokens, regex: null };
+}
+function matchPiSessionSearch(session, parsed) {
+  const text = getSessionSearchText(session);
+  if (parsed.mode === "regex") {
+    if (!parsed.regex) return { matches: false, score: 0 };
+    const index = text.search(parsed.regex);
+    if (index < 0) return { matches: false, score: 0 };
+    return { matches: true, score: index * 0.1 };
+  }
+  if (parsed.tokens.length === 0) return { matches: true, score: 0 };
+  let totalScore = 0;
+  let normalizedText = null;
+  for (const token of parsed.tokens) {
+    if (token.kind === "phrase") {
+      normalizedText ??= normalizeWhitespaceLower(text);
+      const phrase = normalizeWhitespaceLower(token.value);
+      if (!phrase) continue;
+      const index = normalizedText.indexOf(phrase);
+      if (index < 0) return { matches: false, score: 0 };
+      totalScore += index * 0.1;
+      continue;
+    }
+    const match = fuzzyMatch(token.value, text);
+    if (!match.matches) return { matches: false, score: 0 };
+    totalScore += match.score;
+  }
+  return { matches: true, score: totalScore };
+}
+function searchPiSessions(sessions, query, options = {}) {
+  const { sortMode = "fuzzy", limit } = options;
+  const trimmed = query.trim();
+  const source = [...sessions];
+  if (!trimmed) return limit == null ? source : source.slice(0, limit);
+  const parsed = parsePiSessionSearchQuery(trimmed);
+  if (parsed.error) return [];
+  if (sortMode === "recent") {
+    const filtered = source.filter((session) => matchPiSessionSearch(session, parsed).matches);
+    return limit == null ? filtered : filtered.slice(0, limit);
+  }
+  const scored = [];
+  for (const session of source) {
+    const result = matchPiSessionSearch(session, parsed);
+    if (result.matches) scored.push({ session, score: result.score });
+  }
+  scored.sort((a, b) => {
+    if (a.score !== b.score) return a.score - b.score;
+    return sessionModifiedMs(b.session) - sessionModifiedMs(a.session);
+  });
+  const results = scored.map((result) => result.session);
+  return limit == null ? results : results.slice(0, limit);
+}
+
 // src/front/chat/components/PiConversationSurface.tsx
 import { Loader2 as Loader22 } from "lucide-react";
 import { useCallback as useCallback14, useEffect as useEffect14, useLayoutEffect, useRef as useRef10, useState as useState15 } from "react";
@@ -9455,6 +9653,7 @@ function PiChatPanel({
   createRemoteSession,
   remoteSessionOptions,
   hydrateMessages = true,
+  allowPromptDuringInitialHydration = false,
   workspaceWarmupStatus,
   onSessionReset,
   onBeforeSubmit,
@@ -9462,6 +9661,7 @@ function PiChatPanel({
   onCommandResult,
   onComposerWarning,
   onMentionedFilesConsumed,
+  onPromptSubmitStarted,
   onData,
   onOpenArtifact,
   composerBlockers = EMPTY_BLOCKERS,
@@ -9920,6 +10120,7 @@ function PiChatPanel({
       mentionedFiles: effectiveMentionedFiles,
       getDraft: () => draftRef.current,
       onDraftChange: setComposerDraft,
+      allowPromptDuringInitialHydration,
       onPromptSubmitStarted: () => {
         markLocalSubmitted(activeChatSessionId);
       },
@@ -9941,7 +10142,7 @@ function PiChatPanel({
         onMentionedFilesConsumed?.();
       }
     });
-  }, [activeChatSessionId, addLocalNotice, clearMentionedFiles, composerBlocked, composerBlockerLabel, effectiveMentionedFiles, markLocalSubmitted, onBeforeSubmit, onCommandResult, onComposerWarning, onMentionedFilesConsumed, openModelPicker, openThinkingPicker, registry, reloadAgentPlugins, resetSession, runPluginUpdate, selectComposerModel, selectComposerThinking, selectedModel, selectedPiSession, selectedThinking, setComposerDraft, submitThinkingControl, suppressPreSubmitCancelledWarning]);
+  }, [activeChatSessionId, addLocalNotice, allowPromptDuringInitialHydration, clearMentionedFiles, composerBlocked, composerBlockerLabel, effectiveMentionedFiles, markLocalSubmitted, onBeforeSubmit, onCommandResult, onComposerWarning, onMentionedFilesConsumed, onPromptSubmitStarted, openModelPicker, openThinkingPicker, registry, reloadAgentPlugins, resetSession, runPluginUpdate, selectComposerModel, selectComposerThinking, selectedModel, selectedPiSession, selectedThinking, setComposerDraft, submitThinkingControl, suppressPreSubmitCancelledWarning]);
   const surfaceRunRejected = useCallback18((error) => {
     const errorCode = piChatErrorCode(error);
     dropLocalNotice(RUN_REJECTED_NOTICE_ID);
@@ -9974,6 +10175,7 @@ function PiChatPanel({
         dropLocalNotice(RUN_REJECTED_NOTICE_ID);
       }
       if (result.type === "prompt" && activeChatSessionId) {
+        onPromptSubmitStarted?.({ sessionId: activeChatSessionId, clientNonce: result.clientNonce });
         if (shouldHoldLocalSubmitted(selectedPiSession, result.cursor)) markLocalSubmitted(activeChatSessionId);
         else clearLocalSubmitted(activeChatSessionId);
       }
@@ -9984,7 +10186,7 @@ function PiChatPanel({
       surfaceRunRejected(error);
       return false;
     }
-  }, [activeChatSessionId, clearLocalSubmitted, dropLocalNotice, markLocalSubmitted, policy, selectedPiSession, setComposerDraft, surfaceRunRejected]);
+  }, [activeChatSessionId, clearLocalSubmitted, dropLocalNotice, markLocalSubmitted, onPromptSubmitStarted, policy, selectedPiSession, setComposerDraft, surfaceRunRejected]);
   const editQueued = useCallback18(() => {
     if (!policy) return;
     void policy.editQueued().then((result) => {
@@ -10061,6 +10263,7 @@ function PiChatPanel({
         dropLocalNotice(RUN_REJECTED_NOTICE_ID);
       }
       if (result.type === "prompt") {
+        onPromptSubmitStarted?.({ sessionId: activeSessionId, clientNonce: result.clientNonce });
         if (shouldHoldLocalSubmitted(selectedPiSession, result.cursor)) markLocalSubmitted(activeSessionId);
         else clearLocalSubmitted(activeSessionId);
       }
@@ -10075,15 +10278,18 @@ function PiChatPanel({
       settlePendingAutoSubmit(activeSessionId);
       surfaceRunRejected(error);
     });
-  }, [activeSessionId, autoSubmitInitialDraft, clearLocalSubmitted, composerBlocked, dropLocalNotice, initialDraft, markLocalSubmitted, onAutoSubmitInitialDraftAccepted, policy, selectedPiSession, setComposerDraft, settlePendingAutoSubmit, surfaceRunRejected]);
+  }, [activeSessionId, autoSubmitInitialDraft, clearLocalSubmitted, composerBlocked, dropLocalNotice, initialDraft, markLocalSubmitted, onAutoSubmitInitialDraftAccepted, onPromptSubmitStarted, policy, selectedPiSession, setComposerDraft, settlePendingAutoSubmit, surfaceRunRejected]);
   useEffect21(() => {
     if (workspaceWarmupStatus?.status === "ready") {
       clearLocalNotice("workspace-warmup");
     }
   }, [clearLocalNotice, workspaceWarmupStatus?.status]);
+  const initialHydrationPromptAllowed = Boolean(
+    allowPromptDuringInitialHydration && selectedChatState && selectedChatState.status === "hydrating" && !selectedChatState.hydrated && selectedChatState.history.messageCount === 0 && selectedChatState.committedMessages.length === 0 && selectedChatState.queue.followUps.length === 0 && Object.keys(selectedChatState.optimisticOutbox).length === 0 && !selectedChatState.streamingMessage
+  );
   const disabled = !policy || sessionsLoading || composerBlocked;
   const isStreaming = isPiBusyStatus(status);
-  const submitStatus = toPromptSubmitStatus(status);
+  const submitStatus = initialHydrationPromptAllowed ? "ready" : toPromptSubmitStatus(status);
   const submitDisabled = !policy || sessionsLoading || composerBlocked && !isStreaming;
   const mergedToolRenderers = useMemo13(() => mergeShadcnToolRenderers(toolRenderers), [toolRenderers]);
   const debugMessages = useMemo13(() => messages.map(toDebugUiMessage), [messages]);
@@ -10336,11 +10542,14 @@ export {
   defaultChatSuggestions,
   defaultToolRenderers,
   getAgentCommands,
+  matchPiSessionSearch,
   mergeShadcnToolRenderers,
   mergeToolRenderers,
+  parsePiSessionSearchQuery,
   parseSlashCommand,
   readActiveSessionId,
   resolveToolRenderer,
+  searchPiSessions,
   uploadFile,
   useOpenArtifact,
   usePiSessions,

package/dist/server/index.js

@@ -2619,6 +2619,37 @@ function buildFileRecordsResult(args) {
   return result;
 }
 
+// src/server/http/readonlySkillFiles.ts
+import { readFile as readFile4, stat as stat4 } from "fs/promises";
+function isReadonlySkillFilePath(path4) {
+  if (!path4.startsWith("/")) return false;
+  if (path4.includes("\0")) return false;
+  if (!path4.endsWith("/SKILL.md")) return false;
+  return path4.includes("/.pi/agent/") && path4.includes("/skills/");
+}
+async function readReadonlySkillFile(path4) {
+  const [content, fsStat2] = await Promise.all([
+    readFile4(path4, "utf-8"),
+    stat4(path4)
+  ]);
+  return {
+    content,
+    stat: {
+      kind: fsStat2.isDirectory() ? "directory" : "file",
+      size: fsStat2.size,
+      mtimeMs: fsStat2.mtimeMs
+    }
+  };
+}
+async function statReadonlySkillFile(path4) {
+  const fsStat2 = await stat4(path4);
+  return {
+    kind: fsStat2.isDirectory() ? "directory" : "file",
+    size: fsStat2.size,
+    mtimeMs: fsStat2.mtimeMs
+  };
+}
+
 // src/server/http/routes/file.ts
 var log2 = createLogger("boring/workspace-settings");
 var BORING_SETTINGS_PATH = ".boring/settings";
@@ -2828,8 +2859,8 @@ function fileRoutes(app, opts, done) {
           error: { code: ERROR_CODE_INTERNAL, message: "workspace does not support binary reads" }
         });
       }
-      const stat11 = await workspace.stat(path4);
-      if (stat11.kind !== "file") {
+      const stat12 = await workspace.stat(path4);
+      if (stat12.kind !== "file") {
         return reply.code(400).send({
           error: { code: ERROR_CODE_VALIDATION_ERROR, message: "path is not a file", field: "path" }
         });
@@ -2844,11 +2875,11 @@ function fileRoutes(app, opts, done) {
     try {
       const parsed = parseFileRecordsRequest(request.query);
       const workspace = await resolveWorkspace(request);
-      const stat11 = await workspace.stat(parsed.path);
-      if (stat11.kind !== "file") {
+      const stat12 = await workspace.stat(parsed.path);
+      if (stat12.kind !== "file") {
         return sendValidationError(reply, "path is not a file", "path");
       }
-      if (stat11.size > MAX_RECORD_FILE_BYTES) {
+      if (stat12.size > MAX_RECORD_FILE_BYTES) {
         return sendValidationError(reply, "records file is too large", "path");
       }
       const content = await workspace.readFile(parsed.path);
@@ -2858,7 +2889,7 @@ function fileRoutes(app, opts, done) {
       return buildFileRecordsResult({
         path: parsed.path,
         content,
-        mtimeMs: stat11.mtimeMs,
+        mtimeMs: stat12.mtimeMs,
         offset: parsed.offset,
         limit: parsed.limit,
         q: parsed.q
@@ -2875,14 +2906,23 @@ function fileRoutes(app, opts, done) {
     const path4 = requireStringParam(query.path, "path", reply);
     if (path4 === null) return;
     try {
+      if (isReadonlySkillFilePath(path4)) {
+        const { content: content2, stat: stat13 } = await readReadonlySkillFile(path4);
+        if (stat13.kind !== "file") {
+          return reply.code(400).send({
+            error: { code: ERROR_CODE_VALIDATION_ERROR, message: "path is not a file", field: "path" }
+          });
+        }
+        return { content: content2, mtimeMs: stat13.mtimeMs };
+      }
       const workspace = await resolveWorkspace(request);
       if (workspace.readFileWithStat) {
-        const { content: content2, stat: stat12 } = await workspace.readFileWithStat(path4);
-        return { content: content2, mtimeMs: stat12.kind === "file" ? stat12.mtimeMs : void 0 };
+        const { content: content2, stat: stat13 } = await workspace.readFileWithStat(path4);
+        return { content: content2, mtimeMs: stat13.kind === "file" ? stat13.mtimeMs : void 0 };
       }
       const content = await workspace.readFile(path4);
-      const stat11 = await workspace.stat(path4);
-      return { content, mtimeMs: stat11.kind === "file" ? stat11.mtimeMs : void 0 };
+      const stat12 = await workspace.stat(path4);
+      return { content, mtimeMs: stat12.kind === "file" ? stat12.mtimeMs : void 0 };
     } catch (err) {
       return classifyError(err, reply, "file");
     }
@@ -2936,11 +2976,11 @@ function fileRoutes(app, opts, done) {
         await workspace.writeFile(path4, content);
         return { ok: true };
       }
-      const stat11 = workspace.writeFileWithStat ? await workspace.writeFileWithStat(path4, content) : await (async () => {
+      const stat12 = workspace.writeFileWithStat ? await workspace.writeFileWithStat(path4, content) : await (async () => {
         await workspace.writeFile(path4, content);
         return await workspace.stat(path4);
       })();
-      return { ok: true, mtimeMs: stat11.kind === "file" ? stat11.mtimeMs : void 0 };
+      return { ok: true, mtimeMs: stat12.kind === "file" ? stat12.mtimeMs : void 0 };
     } catch (err) {
       return classifyError(err, reply, "file");
     }
@@ -2969,7 +3009,7 @@ function fileRoutes(app, opts, done) {
       }
       const bytes = Buffer.from(contentBase64, "base64");
       await workspace.mkdir(dir, { recursive: true });
-      const stat11 = workspace.writeBinaryFileWithStat ? await workspace.writeBinaryFileWithStat(path4, bytes) : await (async () => {
+      const stat12 = workspace.writeBinaryFileWithStat ? await workspace.writeBinaryFileWithStat(path4, bytes) : await (async () => {
         if (!workspace.writeBinaryFile) {
           throw new Error("workspace does not support binary uploads");
         }
@@ -2983,7 +3023,7 @@ function fileRoutes(app, opts, done) {
         ok: true,
         path: path4,
         markdownUrl: markdownUrlFor(sourcePath, path4),
-        mtimeMs: stat11.kind === "file" ? stat11.mtimeMs : void 0
+        mtimeMs: stat12.kind === "file" ? stat12.mtimeMs : void 0
       };
     } catch (err) {
       return classifyError(err, reply, "upload");
@@ -3069,9 +3109,12 @@ function fileRoutes(app, opts, done) {
     const path4 = requireStringParam(query.path, "path", reply);
     if (path4 === null) return;
     try {
+      if (isReadonlySkillFilePath(path4)) {
+        return await statReadonlySkillFile(path4);
+      }
       const workspace = await resolveWorkspace(request);
-      const stat11 = await workspace.stat(path4);
-      return stat11;
+      const stat12 = await workspace.stat(path4);
+      return stat12;
     } catch (err) {
       return classifyError(err, reply, "path");
     }
@@ -3082,7 +3125,7 @@ function fileRoutes(app, opts, done) {
 // src/server/workspace/provisionRuntime.ts
 import { createHash as createHash3 } from "crypto";
 import { constants as constants2 } from "fs";
-import { access as access2, chmod as chmod3, cp, mkdir as mkdir4, readdir as readdir3, readFile as readFile4, realpath as realpath2, stat as stat4, writeFile as writeFile4 } from "fs/promises";
+import { access as access2, chmod as chmod3, cp, mkdir as mkdir4, readdir as readdir3, readFile as readFile5, realpath as realpath2, stat as stat5, writeFile as writeFile4 } from "fs/promises";
 import { dirname as dirname6, isAbsolute as isAbsolute4, join as join4, relative as relative5, resolve as resolve5 } from "path";
 import { fileURLToPath } from "url";
 import { execFile } from "child_process";
@@ -3117,7 +3160,7 @@ async function commandExists(cmd) {
   }
 }
 async function hashPath(path4, hash) {
-  const info = await stat4(path4);
+  const info = await stat5(path4);
   if (info.isDirectory()) {
     const entries = (await readdir3(path4)).filter((entry) => entry !== "__pycache__" && entry !== "build" && !entry.endsWith(".egg-info")).sort();
     for (const entry of entries) {
@@ -3130,7 +3173,7 @@ async function hashPath(path4, hash) {
   if (!info.isFile()) return;
   hash.update(`file:${path4}
 `);
-  hash.update(await readFile4(path4));
+  hash.update(await readFile5(path4));
 }
 async function fingerprint(contributions) {
   const hash = createHash3("sha256");
@@ -3323,7 +3366,7 @@ VENV_BIN="$WORKSPACE_ROOT/.boring-agent/venv/bin"
     for (const entry of await readdir3(venvBin)) {
       if (["python", "python3", "pip", "pip3"].includes(entry)) continue;
       const full = join4(venvBin, entry);
-      const info = await stat4(full).catch(() => null);
+      const info = await stat5(full).catch(() => null);
       if (!info?.isFile()) continue;
       await writeExecutable(join4(shimDir, entry), `${base}TARGET="$VENV_BIN"/${bashSingleQuote(entry)}
 SHEBANG="$(head -n 1 "$TARGET" 2>/dev/null || true)"
@@ -3352,7 +3395,7 @@ async function provisionRuntimeWorkspace({
   const binDir = join4(workspaceRoot, ".boring-agent", "bin");
   if (!force && await exists(markerPath)) {
     try {
-      const marker = JSON.parse(await readFile4(markerPath, "utf8"));
+      const marker = JSON.parse(await readFile5(markerPath, "utf8"));
       if (marker.fingerprint === hash && await isRuntimeMaterialized(workspaceRoot, active)) {
         await writeShims(workspaceRoot, env);
         return { fingerprint: hash, changed: false, env, binDir };
@@ -3410,11 +3453,11 @@ function createTimedLruCache(ttlMs, maxEntries) {
     }
   };
 }
-function cloneStat(stat11) {
+function cloneStat(stat12) {
   return {
-    size: stat11.size,
-    mtimeMs: stat11.mtimeMs,
-    kind: stat11.kind
+    size: stat12.size,
+    mtimeMs: stat12.mtimeMs,
+    kind: stat12.kind
   };
 }
 function cloneEntries(entries) {
@@ -3622,15 +3665,15 @@ function createVercelSandboxWorkspace(sandbox, workspaceOpts = {}) {
           remote.fs.readFile(sandboxPath, "utf8"),
           remote.fs.stat(sandboxPath)
         ]);
-        const stat11 = {
+        const stat12 = {
           size: fileStat.size,
           mtimeMs: fileStat.mtimeMs,
           kind: fileStat.isDirectory() ? "dir" : "file"
         };
-        statCache.set(sandboxPath, stat11);
+        statCache.set(sandboxPath, stat12);
         return {
           content: typeof content === "string" ? content : Buffer.from(content).toString("utf-8"),
-          stat: cloneStat(stat11)
+          stat: cloneStat(stat12)
         };
       }
       const version = metadataVersion;
@@ -3896,7 +3939,7 @@ function createVercelProvisioningAdapter(options) {
 // src/server/workspace/provisioning/fingerprint.ts
 import { createHash as createHash4 } from "crypto";
 import { constants as constants3 } from "fs";
-import { access as access3, mkdir as mkdir6, open, readFile as readFile5, rename as rename5, rm as rm2 } from "fs/promises";
+import { access as access3, mkdir as mkdir6, open, readFile as readFile6, rename as rename5, rm as rm2 } from "fs/promises";
 import { dirname as dirname8 } from "path";
 var FINGERPRINT_RE = /^sha256:[a-f0-9]{64}$/;
 function isValidFingerprint(value) {
@@ -4278,7 +4321,7 @@ async function ensurePythonRuntime(options) {
 }
 
 // src/server/workspace/provisioning/skills.ts
-import { stat as stat5 } from "fs/promises";
+import { stat as stat6 } from "fs/promises";
 import { join as join8 } from "path";
 import { fileURLToPath as fileURLToPath4 } from "url";
 var GENERATED_SKILLS_REL = ".boring-agent/skills";
@@ -4309,7 +4352,7 @@ async function mirrorPluginSkills(options) {
       }
       seen.add(key);
       const sourcePath = sourceToPath2(skill.source);
-      const sourceStat = await stat5(sourcePath);
+      const sourceStat = await stat6(sourcePath);
       const skillTarget = `${GENERATED_SKILLS_REL}/${plugin.id}/${skill.name}`;
       const target = sourceStat.isDirectory() ? skillTarget : `${skillTarget}/SKILL.md`;
       await options.adapter.workspaceFs.copyFromHost(skill.source, target);
@@ -4325,7 +4368,7 @@ async function mirrorPluginSkills(options) {
 // src/server/workspace/provisioning/workspaceFiles.ts
 import { basename, join as joinPath } from "path";
 import { posix as posix2 } from "path";
-import { readdir as readdir4, stat as stat6 } from "fs/promises";
+import { readdir as readdir4, stat as stat7 } from "fs/promises";
 import { fileURLToPath as fileURLToPath5, pathToFileURL } from "url";
 function sourceToPath3(source) {
   return source instanceof URL ? fileURLToPath5(source) : source;
@@ -4338,7 +4381,7 @@ function sourceForChild(rootSource, childPath) {
 }
 async function collectTemplateWorkItems(template) {
   const sourcePath = sourceToPath3(template.path);
-  const sourceStat = await stat6(sourcePath);
+  const sourceStat = await stat7(sourcePath);
   const targetPrefix = template.target ?? "";
   if (!sourceStat.isDirectory()) {
     const targetRel = toWorkspaceRel3(targetPrefix || basename(sourcePath));
@@ -4645,7 +4688,7 @@ async function copyTemplate(templatePath, workspaceRoot) {
 
 // src/server/runtime/modes/provisioningAdapter.ts
 import { spawn as spawn3 } from "child_process";
-import { cp as cp3, lstat as lstat3, mkdir as mkdir7, readFile as readFile6, realpath as realpath3, rm as rm3, stat as stat7, writeFile as writeFile5 } from "fs/promises";
+import { cp as cp3, lstat as lstat3, mkdir as mkdir7, readFile as readFile7, realpath as realpath3, rm as rm3, stat as stat8, writeFile as writeFile5 } from "fs/promises";
 import { dirname as dirname10, isAbsolute as isAbsolute6, relative as relative8, resolve as resolve6, sep as sep5 } from "path";
 import { fileURLToPath as fileURLToPath6 } from "url";
 var LOCAL_SANDBOX_WORKSPACE_ROOT = "/workspace";
@@ -4754,7 +4797,7 @@ function createWorkspaceFs(workspaceRoot, opts) {
     async exists(workspaceRelativePath) {
       const absPath = validatePath(workspaceRoot, workspaceRelativePath);
       try {
-        await stat7(absPath);
+        await stat8(absPath);
         return true;
       } catch (error) {
         if (error.code === "ENOENT") return false;
@@ -4780,12 +4823,12 @@ function createWorkspaceFs(workspaceRoot, opts) {
     async readText(workspaceRelativePath) {
       const absPath = await assertExistingInsideWorkspace(workspaceRoot, workspaceRelativePath, enforceSymlinkBoundary);
       if (!absPath) return null;
-      return await readFile6(absPath, "utf8");
+      return await readFile7(absPath, "utf8");
     },
     async copyFromHost(hostSourcePath, workspaceRelativeTarget) {
       const sourcePath = sourceToPath4(hostSourcePath);
       const absTarget = await prepareWritablePath(workspaceRoot, workspaceRelativeTarget, enforceSymlinkBoundary);
-      const sourceStat = await stat7(sourcePath);
+      const sourceStat = await stat8(sourcePath);
       await cp3(sourcePath, absTarget, {
         recursive: sourceStat.isDirectory(),
         force: false,
@@ -4915,7 +4958,7 @@ var localModeAdapter = {
 };
 
 // src/server/runtime/modes/vercel-sandbox.ts
-import { readFile as readFile8, readdir as readdir6, stat as stat8 } from "fs/promises";
+import { readFile as readFile9, readdir as readdir6, stat as stat9 } from "fs/promises";
 import { join as join9 } from "path";
 import { fileURLToPath as fileURLToPath7 } from "url";
 import { Sandbox as VercelSandbox } from "@vercel/sandbox";
@@ -5062,7 +5105,7 @@ function createVercelSandboxExec(sandbox, execOpts = {}) {
 
 // src/server/sandbox/vercel-sandbox/packageTemplate.ts
 import { createHash as createHash5 } from "crypto";
-import { readFile as readFile7, readdir as readdir5 } from "fs/promises";
+import { readFile as readFile8, readdir as readdir5 } from "fs/promises";
 import path3 from "path";
 import { Readable } from "stream";
 import { createGzip } from "zlib";
@@ -5083,7 +5126,7 @@ async function collectFiles(dir, base = "") {
     if (entry.isDirectory()) {
       files.push(...await collectFiles(fullPath, relPath));
     } else if (entry.isFile()) {
-      files.push({ rel: relPath, content: await readFile7(fullPath) });
+      files.push({ rel: relPath, content: await readFile8(fullPath) });
     }
   }
   return files.sort((a, b) => a.rel.localeCompare(b.rel));
@@ -5360,7 +5403,7 @@ function shellSingleQuote(value) {
 }
 async function copyHostPathToVercelWorkspace(options) {
   const sourcePath = provisioningSourceToPath(options.source);
-  const sourceStat = await stat8(sourcePath);
+  const sourceStat = await stat9(sourcePath);
   if (sourceStat.isDirectory()) {
     await options.workspace.mkdir(options.targetRel, { recursive: true });
     for (const entry of await readdir6(sourcePath, { withFileTypes: true })) {
@@ -5373,7 +5416,7 @@ async function copyHostPathToVercelWorkspace(options) {
     return;
   }
   if (!sourceStat.isFile()) return;
-  const bytes = new Uint8Array(await readFile8(sourcePath));
+  const bytes = new Uint8Array(await readFile9(sourcePath));
   if (options.workspace.writeBinaryFile) await options.workspace.writeBinaryFile(options.targetRel, bytes);
   else await options.workspace.writeFile(options.targetRel, Buffer.from(bytes).toString("utf8"));
 }
@@ -6159,7 +6202,7 @@ function createPiAgentSessionAdapter(session, options = {}) {
 import { randomUUID } from "crypto";
 import {
   readdir as readdir7,
-  readFile as readFile9,
+  readFile as readFile10,
   stat as fsStat,
   rm as rm4,
   mkdir as mkdir11,
@@ -6322,7 +6365,7 @@ var PiSessionStore = class {
     const filepath = await this.resolveSessionFile(sessionId);
     let content;
     try {
-      content = await readFile9(filepath, "utf-8");
+      content = await readFile10(filepath, "utf-8");
     } catch {
       throw new Error(`Session not found: ${sessionId}`);
     }
@@ -6403,7 +6446,7 @@ var PiSessionStore = class {
       let filepath = direct;
       let content;
       try {
-        content = await readFile9(direct, "utf-8");
+        content = await readFile10(direct, "utf-8");
       } catch {
         const files = await readdir7(this.sessionDir).catch(() => []);
         const match = files.find(
@@ -6411,7 +6454,7 @@ var PiSessionStore = class {
         );
         if (!match) return null;
         filepath = join10(this.sessionDir, match);
-        content = await readFile9(filepath, "utf-8");
+        content = await readFile10(filepath, "utf-8");
       }
       const entries = safeParseEntries(content);
       const linkedPiFile = extractPiSessionFilePath(entries);
@@ -6488,7 +6531,7 @@ var PiSessionStore = class {
   }
   async linkedPiFileFor(filepath) {
     try {
-      const content = await readFile9(filepath, "utf-8");
+      const content = await readFile10(filepath, "utf-8");
       return extractPiSessionFilePath(safeParseEntries(content));
     } catch {
       return null;
@@ -6496,9 +6539,9 @@ var PiSessionStore = class {
   }
   async referencedPiFiles(files) {
     const referenced = /* @__PURE__ */ new Set();
-    await Promise.all(files.map(async ({ filepath, stat: stat11 }) => {
+    await Promise.all(files.map(async ({ filepath, stat: stat12 }) => {
       try {
-        const piFilePath = (await this.readPrefixCache(filepath, stat11)).referencedPiFile;
+        const piFilePath = (await this.readPrefixCache(filepath, stat12)).referencedPiFile;
         if (piFilePath && resolve7(piFilePath) !== resolve7(filepath)) {
           referenced.add(resolve7(piFilePath));
         }
@@ -6507,10 +6550,10 @@ var PiSessionStore = class {
     }));
     return referenced;
   }
-  async sessionSortMtimeMs({ filepath, stat: stat11 }) {
-    let sortMtimeMs = stat11.mtime.getTime();
+  async sessionSortMtimeMs({ filepath, stat: stat12 }) {
+    let sortMtimeMs = stat12.mtime.getTime();
     try {
-      const linkedPiFile = (await this.readPrefixCache(filepath, stat11)).referencedPiFile;
+      const linkedPiFile = (await this.readPrefixCache(filepath, stat12)).referencedPiFile;
       if (linkedPiFile && resolve7(linkedPiFile) !== resolve7(filepath)) {
         const linkedStat = await fsStat(linkedPiFile);
         sortMtimeMs = Math.max(sortMtimeMs, linkedStat.mtime.getTime());
@@ -6604,7 +6647,7 @@ var PiSessionStore = class {
       const batch = visibleFiles.slice(index, index + batchSize);
       index += batch.length;
       const summaries = await Promise.all(
-        batch.map(({ filepath, stat: stat11 }) => this.summarizeFile(filepath, stat11))
+        batch.map(({ filepath, stat: stat12 }) => this.summarizeFile(filepath, stat12))
       );
       for (const summary of summaries) {
         if (!summary) continue;
@@ -6706,7 +6749,7 @@ var PiSessionStore = class {
     try {
       const [fileStat, content] = await Promise.all([
         fsStat(filepath),
-        readFile9(filepath, "utf-8")
+        readFile10(filepath, "utf-8")
       ]);
       return { entries: safeParseEntries(content), mtime: fileStat.mtime, size: Number(fileStat.size) };
     } catch {
@@ -7449,7 +7492,7 @@ ${entry.message}`;
 }
 
 // src/server/harness/pi-coding-agent/pluginLoader.ts
-import { readdir as readdir8, stat as stat9, readFile as readFile10 } from "fs/promises";
+import { readdir as readdir8, stat as stat10, readFile as readFile11 } from "fs/promises";
 import { join as join12, extname as extname4, resolve as resolve8, sep as sep6, relative as relative9 } from "path";
 import { homedir as homedir4 } from "os";
 import { pathToFileURL as pathToFileURL2 } from "url";
@@ -7459,7 +7502,7 @@ var LOCAL_DIR = ".pi/extensions";
 var EXTENSIONS_JSON = ".pi/extensions.json";
 async function dirExists2(path4) {
   try {
-    const s = await stat9(path4);
+    const s = await stat10(path4);
     return s.isDirectory();
   } catch {
     return false;
@@ -7467,7 +7510,7 @@ async function dirExists2(path4) {
 }
 async function fileExists(path4) {
   try {
-    const s = await stat9(path4);
+    const s = await stat10(path4);
     return s.isFile();
   } catch {
     return false;
@@ -7518,7 +7561,7 @@ async function discoverNpmPlugins(cwd) {
 async function loadNpmPlugin(pkgDir, importFn) {
   const pkgJsonPath = join12(pkgDir, "package.json");
   if (!await fileExists(pkgJsonPath)) return [];
-  const pkgJson = JSON.parse(await readFile10(pkgJsonPath, "utf-8"));
+  const pkgJson = JSON.parse(await readFile11(pkgJsonPath, "utf-8"));
   const main = pkgJson.main ?? "index.js";
   const resolvedMain = resolve8(pkgDir, main);
   const resolvedPkgDir = resolve8(pkgDir);
@@ -7535,7 +7578,7 @@ async function loadExtensionsJson(cwd) {
   const configPath = join12(cwd, EXTENSIONS_JSON);
   if (!await fileExists(configPath)) return null;
   try {
-    const raw = await readFile10(configPath, "utf-8");
+    const raw = await readFile11(configPath, "utf-8");
     return JSON.parse(raw);
   } catch {
     return null;
@@ -7609,7 +7652,7 @@ import {
 
 // src/server/tools/operations/bound.ts
 import { constants as constants4 } from "fs";
-import { access as access4, lstat as lstat4, mkdir as mkdir12, readFile as readFile11, readdir as readdir9, readlink, realpath as realpath4, stat as stat10, writeFile as writeFile7 } from "fs/promises";
+import { access as access4, lstat as lstat4, mkdir as mkdir12, readFile as readFile12, readdir as readdir9, readlink, realpath as realpath4, stat as stat11, writeFile as writeFile7 } from "fs/promises";
 import { dirname as dirname11, isAbsolute as isAbsolute7, join as join13, relative as relative10, resolve as resolve9 } from "path";
 function toPosixPath(value) {
   return value.split("\\").join("/");
@@ -7681,7 +7724,7 @@ async function findNearestExistingAncestor(absPath) {
   let current = absPath;
   for (; ; ) {
     try {
-      await stat10(current);
+      await stat11(current);
       return current;
     } catch {
       const parent = dirname11(current);
@@ -7756,7 +7799,7 @@ function boundFs(workspaceRoot, opts = {}) {
     async readFile(absolutePath) {
       const storagePath = toStoragePath(absolutePath);
       await assertWithinWorkspace(workspaceRoot, storagePath);
-      return await readFile11(storagePath);
+      return await readFile12(storagePath);
     },
     async access(absolutePath) {
       const storagePath = toStoragePath(absolutePath);
@@ -7781,7 +7824,7 @@ function boundFs(workspaceRoot, opts = {}) {
     async readFile(absolutePath) {
       const storagePath = toStoragePath(absolutePath);
       await assertWithinWorkspace(workspaceRoot, storagePath);
-      return await readFile11(storagePath);
+      return await readFile12(storagePath);
     },
     async writeFile(absolutePath, content) {
       const storagePath = toStoragePath(absolutePath);
@@ -7799,7 +7842,7 @@ function boundFs(workspaceRoot, opts = {}) {
       const storagePath = toStoragePath(absolutePath);
       await assertWithinWorkspace(workspaceRoot, storagePath);
       try {
-        await stat10(storagePath);
+        await stat11(storagePath);
         return true;
       } catch (err) {
         if (err.code === "ENOENT") return false;
@@ -7818,12 +7861,12 @@ function boundFs(workspaceRoot, opts = {}) {
     async isDirectory(absolutePath) {
       const storagePath = toStoragePath(absolutePath);
       await assertWithinWorkspace(workspaceRoot, storagePath);
-      return (await stat10(storagePath)).isDirectory();
+      return (await stat11(storagePath)).isDirectory();
     },
     async readFile(absolutePath) {
       const storagePath = toStoragePath(absolutePath);
       await assertWithinWorkspace(workspaceRoot, storagePath);
-      return await readFile11(storagePath, "utf8");
+      return await readFile12(storagePath, "utf8");
     }
   };
   const ls = {
@@ -7831,7 +7874,7 @@ function boundFs(workspaceRoot, opts = {}) {
       const storagePath = toStoragePath(absolutePath);
       try {
         await assertWithinWorkspace(workspaceRoot, storagePath);
-        await stat10(storagePath);
+        await stat11(storagePath);
         return true;
       } catch {
         return false;
@@ -7840,7 +7883,7 @@ function boundFs(workspaceRoot, opts = {}) {
     async stat(absolutePath) {
       const storagePath = toStoragePath(absolutePath);
       await assertWithinWorkspace(workspaceRoot, storagePath);
-      return await stat10(storagePath);
+      return await stat11(storagePath);
     },
     async readdir(absolutePath) {
       const storagePath = toStoragePath(absolutePath);
@@ -8023,8 +8066,8 @@ function remoteWorkspaceLsOps(workspace, opts = {}) {
     },
     async stat(absolutePath) {
       const rel = toRelPath(workspace, absolutePath, opts);
-      const stat11 = await workspace.stat(rel);
-      return { isDirectory: () => stat11.kind === "dir" };
+      const stat12 = await workspace.stat(rel);
+      return { isDirectory: () => stat12.kind === "dir" };
     },
     async readdir(absolutePath) {
       const rel = toRelPath(workspace, absolutePath, opts);
@@ -9092,49 +9135,53 @@ import {
 var CACHE_TTL_MS2 = 3e4;
 function skillsRoutes(app, opts, done) {
   const cached = /* @__PURE__ */ new Map();
-  app.get("/api/v1/agent/skills", async (request, reply) => {
-    try {
-      const workspaceRoot = opts.getWorkspaceRoot ? await opts.getWorkspaceRoot(request) : opts.workspaceRoot;
-      const additionalSkillPaths = opts.getAdditionalSkillPaths ? await opts.getAdditionalSkillPaths(request) : opts.additionalSkillPaths;
-      const piPackages = opts.getPiPackages ? await opts.getPiPackages(request) : opts.piPackages;
-      const noSkills = (opts.getNoSkills ? await opts.getNoSkills(request) : opts.noSkills) ?? withPiHarnessDefaults().noSkills;
-      const cacheKey = JSON.stringify([workspaceRoot, additionalSkillPaths ?? [], piPackages ?? [], noSkills]);
-      const now = Date.now();
-      for (const [key, entry] of cached) {
-        if (entry.expiresAt <= now) cached.delete(key);
-      }
-      const cachedEntry = cached.get(cacheKey);
-      const refresh = request.query.refresh === "1";
-      if (!refresh && cachedEntry && cachedEntry.expiresAt > now) {
-        return reply.code(200).send({ skills: cachedEntry.skills });
-      }
-      const agentDir = getAgentDir3();
-      const packageSkillPaths = noSkills ? [] : await (async () => {
-        const settingsManager = createResourceSettingsManager(
-          workspaceRoot,
-          agentDir,
-          piPackages ?? []
-        );
-        const packageManager = new DefaultPackageManager({
-          cwd: workspaceRoot,
-          agentDir,
-          settingsManager
-        });
-        const resolved = await packageManager.resolve();
-        return resolved.skills.filter((resource) => resource.enabled).map((resource) => resource.path);
-      })();
-      const result = loadSkills2({
+  async function resolveSkillsForRequest(request, refresh = false) {
+    const workspaceRoot = opts.getWorkspaceRoot ? await opts.getWorkspaceRoot(request) : opts.workspaceRoot;
+    const additionalSkillPaths = opts.getAdditionalSkillPaths ? await opts.getAdditionalSkillPaths(request) : opts.additionalSkillPaths;
+    const piPackages = opts.getPiPackages ? await opts.getPiPackages(request) : opts.piPackages;
+    const noSkills = (opts.getNoSkills ? await opts.getNoSkills(request) : opts.noSkills) ?? withPiHarnessDefaults().noSkills;
+    const cacheKey = JSON.stringify([workspaceRoot, additionalSkillPaths ?? [], piPackages ?? [], noSkills]);
+    const now = Date.now();
+    for (const [key, entry2] of cached) {
+      if (entry2.expiresAt <= now) cached.delete(key);
+    }
+    const cachedEntry = cached.get(cacheKey);
+    if (!refresh && cachedEntry && cachedEntry.expiresAt > now) return cachedEntry;
+    const agentDir = getAgentDir3();
+    const packageSkillPaths = noSkills ? [] : await (async () => {
+      const settingsManager = createResourceSettingsManager(
+        workspaceRoot,
+        agentDir,
+        piPackages ?? []
+      );
+      const packageManager = new DefaultPackageManager({
         cwd: workspaceRoot,
         agentDir,
-        skillPaths: [...packageSkillPaths, ...additionalSkillPaths ?? []],
-        includeDefaults: !noSkills
+        settingsManager
       });
-      const skills = result.skills.map((s) => ({
-        name: s.name,
-        description: s.description
-      }));
-      cached.set(cacheKey, { skills, expiresAt: now + CACHE_TTL_MS2 });
-      return reply.code(200).send({ skills });
+      const resolved = await packageManager.resolve();
+      return resolved.skills.filter((resource) => resource.enabled).map((resource) => resource.path);
+    })();
+    const result = loadSkills2({
+      cwd: workspaceRoot,
+      agentDir,
+      skillPaths: [...packageSkillPaths, ...additionalSkillPaths ?? []],
+      includeDefaults: !noSkills
+    });
+    const skills = result.skills.map((s) => ({
+      name: String(s.name),
+      description: String(s.description ?? ""),
+      ...typeof s.filePath === "string" ? { filePath: s.filePath } : {},
+      ...typeof s.sourceInfo?.scope === "string" ? { source: s.sourceInfo.scope } : {}
+    }));
+    const entry = { skills, expiresAt: now + CACHE_TTL_MS2 };
+    cached.set(cacheKey, entry);
+    return entry;
+  }
+  app.get("/api/v1/agent/skills", async (request, reply) => {
+    try {
+      const entry = await resolveSkillsForRequest(request, request.query.refresh === "1");
+      return reply.code(200).send({ skills: entry.skills });
     } catch (error) {
       const message = error instanceof Error ? error.message : String(error);
       request.log.warn({ err: error }, "[agent] failed to load skills");
@@ -12075,8 +12122,8 @@ async function promptImagesFromAttachments(attachments, workspace) {
     }
     if (!workspace?.readBinaryFile || !isWorkspaceImageAttachment(attachment)) continue;
     try {
-      const stat11 = await workspace.stat(attachment.path);
-      if (stat11.kind !== "file" || stat11.size <= 0 || stat11.size > MAX_PROMPT_IMAGE_BYTES) continue;
+      const stat12 = await workspace.stat(attachment.path);
+      if (stat12.kind !== "file" || stat12.size <= 0 || stat12.size > MAX_PROMPT_IMAGE_BYTES) continue;
       const bytes = await workspace.readBinaryFile(attachment.path);
       if (bytes.byteLength <= 0 || bytes.byteLength > MAX_PROMPT_IMAGE_BYTES) continue;
       const detectedMimeType = detectPromptImageMimeType(bytes);
@@ -12376,7 +12423,7 @@ function mergeTools(options) {
 }
 
 // src/server/tools/upload/index.ts
-import { readFile as readFile12 } from "fs/promises";
+import { readFile as readFile13 } from "fs/promises";
 import { extname as extname5, join as join14 } from "path";
 var DEFAULT_UPLOAD_DIR = "assets/images";
 var MAX_UPLOAD_BYTES2 = 10 * 1024 * 1024;
@@ -12445,7 +12492,7 @@ function buildUploadAgentTools(bundle) {
         const rawDir = typeof input.directory === "string" ? input.directory.trim() : "";
         const dir = rawDir ? rawDir.replace(/^\.\/+/, "").replace(/\/+$/, "") : DEFAULT_UPLOAD_DIR;
         try {
-          const bytes = workspace.readBinaryFile ? Buffer.from(await workspace.readBinaryFile(filePath)) : await readFile12(join14(getRuntimeBundleStorageRoot(bundle), filePath));
+          const bytes = workspace.readBinaryFile ? Buffer.from(await workspace.readBinaryFile(filePath)) : await readFile13(join14(getRuntimeBundleStorageRoot(bundle), filePath));
           if (bytes.byteLength === 0 || bytes.byteLength > MAX_UPLOAD_BYTES2) {
             return {
               content: [{ type: "text", text: `file must be between 1 byte and ${MAX_UPLOAD_BYTES2} bytes` }],

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@hachej/boring-agent",
-  "version": "0.1.58",
+  "version": "0.1.60",
   "type": "module",
   "license": "MIT",
   "description": "Pane-embeddable coding agent. Ships direct/local/vercel-sandbox execution modes behind one interface.",
@@ -74,7 +74,7 @@
     "use-stick-to-bottom": "^1.1.3",
     "yaml": "^2.8.3",
     "zod": "^3.25.76",
-    "@hachej/boring-ui-kit": "0.1.58"
+    "@hachej/boring-ui-kit": "0.1.60"
   },
   "devDependencies": {
     "@antithesishq/bombadil": "0.5.0",