@tangle-network/agent-app 0.43.49 → 0.43.51

package/dist/web-react/index.d.ts

@@ -5,14 +5,14 @@ export { d as ComposerAnswerDelivery, I as INTERACTION_CANCEL_EVENT, e as INTERA
 import { ChatPlan } from '../plans/index.js';
 import { InteractionData } from '@tangle-network/agent-interface';
 export { InteractionData, InteractionOutcome, InteractionRequest } from '@tangle-network/agent-interface';
-import { K as FileMention, f as ChatMentionPart } from '../parts-IB-Kbb7z.js';
-export { O as ChatAttachmentInput, C as ChatAttachmentKind, a as ChatAttachmentPart, e as ChatMentionKind, N as ChatTurnFilePartInput, M as ChatTurnPartInput, L as ChatTurnRequestPayload, R as DISPATCH_MAX_MEDIA_PARTS, T as DISPATCH_MAX_PARTS, U as DISPATCH_REQUEST_MAX_BYTES, V as DISPATCH_STRUCTURAL_RESERVE_BYTES, t as attachmentInputToPart, u as attachmentKindForMime, v as attachmentPartsFromMessageParts, $ as base64WireLen, a0 as buildMentionPromptBlock, a1 as chatTurnRequestInit, a2 as fileMentionsToParts, y as isChatAttachmentPart, a4 as mediaTypeForMentionPath, H as mentionInputToPart, a5 as mentionKindForPath, I as mentionPartsFromMessageParts } from '../parts-IB-Kbb7z.js';
+import { K as FileMention, f as ChatMentionPart, a as ChatAttachmentPart, C as ChatAttachmentKind, O as ChatAttachmentInput } from '../parts-IB-Kbb7z.js';
+export { e as ChatMentionKind, N as ChatTurnFilePartInput, M as ChatTurnPartInput, L as ChatTurnRequestPayload, R as DISPATCH_MAX_MEDIA_PARTS, T as DISPATCH_MAX_PARTS, U as DISPATCH_REQUEST_MAX_BYTES, V as DISPATCH_STRUCTURAL_RESERVE_BYTES, t as attachmentInputToPart, u as attachmentKindForMime, v as attachmentPartsFromMessageParts, $ as base64WireLen, a0 as buildMentionPromptBlock, a1 as chatTurnRequestInit, a2 as fileMentionsToParts, y as isChatAttachmentPart, a4 as mediaTypeForMentionPath, H as mentionInputToPart, a5 as mentionKindForPath, I as mentionPartsFromMessageParts } from '../parts-IB-Kbb7z.js';
 import { S as StepAgentActivity } from '../agent-activity-C8ZG0F0M.js';
 import { a as FlowTrace } from '../flow-types-Cb_AblZs.js';
 export { S as SandboxTerminalConnection, a as SandboxTerminalConnectionResponse, U as UseSandboxTerminalConnectionOptions, b as UseSandboxTerminalConnectionResult, t as tabTerminalConnectionId, u as useSandboxTerminalConnection } from '../sandbox-terminal-BIIC__CP.js';
 import { CatalogModel } from '../catalog/index.js';
 import { Harness } from '../harness/index.js';
-export { b as FileIndexReadyResponse, c as FileIndexResponse, d as FileIndexWarmingResponse } from '../file-index-b26ee-_R.js';
+export { a as ATTACHMENT_ACCEPT, e as FileIndexReadyResponse, f as FileIndexResponse, g as FileIndexWarmingResponse } from '../attachment-validation-DX2KIzMC.js';
 export { d as attachmentPartKey } from '../stream-normalizer-DWvtmY6F.js';
 
 type DurablePlanDecision = 'approved' | 'rejected';
@@ -672,6 +672,170 @@ declare function segmentMentionContent(content: string, parts: ReadonlyArray<Cha
     matched: Set<ChatMentionPart>;
 };
 
+/**
+ * Renders a message's attachment parts (images + files) as thumbnails and
+ * download chips — the transcript-side counterpart to `ChatComposer`'s
+ * staged-upload chips. Ported from gtm-agent's `chat-attachment-parts.tsx`
+ * onto agent-app's RAW-BYTES download contract: the host supplies
+ * `resolveFileUrl(part)`, a URL that serves the attachment's raw bytes
+ * directly, so this module never parses a JSON `{file:{blobUrl,body}}`
+ * envelope or decodes a `[base64]` marker the way gtm's vault route did.
+ *
+ * No icon-library or primitives dependency (`ChatComposer`'s house style):
+ * the loading skeleton is an inline `animate-pulse` span and the few glyphs
+ * are inline SVGs.
+ */
+
+/** Typed outcome of fetching one attachment's raw bytes. Callers must check
+ *  `ok` before touching `blob` — a failed fetch never produces a blank
+ *  render, it produces a visible error state. */
+type AttachmentFileResult = {
+    ok: true;
+    blob: Blob;
+} | {
+    ok: false;
+    message: string;
+};
+declare function __resetAttachmentFileCacheForTests(): void;
+/** Fetches (and caches) the raw bytes behind one attachment url. Concurrent
+ *  callers for the SAME url dedupe to one in-flight fetch. Only a successful
+ *  settlement stays cached — evicting failures means a remount or click-retry
+ *  after a transient error issues a fresh fetch. */
+declare function loadAttachmentFile(url: string, fetchFile?: (url: string) => Promise<Response>): Promise<AttachmentFileResult>;
+/** Drives an anchor-click download from an already-resolved blob. Returns a
+ *  typed outcome rather than throwing — a chip that fails to synthesize the
+ *  download must show the failure, not silently no-op. */
+declare function triggerAttachmentDownload(name: string, blob: Blob): {
+    ok: true;
+} | {
+    ok: false;
+    message: string;
+};
+interface MessageAttachmentsProps {
+    parts: ChatAttachmentPart[];
+    /** URL serving the attachment's RAW bytes. */
+    resolveFileUrl: (part: ChatAttachmentPart) => string;
+    /** Row alignment — a user-bubble attachment row is right-aligned by
+     *  default; pass `"start"` for an assistant-turn attachment, which sits
+     *  inline with the rest of the transcript. */
+    justify?: 'start' | 'end';
+    /** Override the fetch used to load an attachment's bytes. Default:
+     *  `fetch(url, { credentials: 'same-origin' })`. */
+    fetchFile?: (url: string) => Promise<Response>;
+}
+/** Renders a message's attachment parts as a row of image thumbnails and file
+ *  chips. `null` when there are none, so callers can render unconditionally
+ *  without an extra length check. */
+declare function MessageAttachments({ parts, resolveFileUrl, justify, fetchFile }: MessageAttachmentsProps): ReactNode;
+
+/**
+ * `useComposerAttachments` — the composer's staged-upload lifecycle: validate
+ * selected/dropped/pasted files against the shared limits (the SAME
+ * `sniffBinary`/`checkAttachmentType`/size-cap vocabulary the store-backed
+ * upload route enforces server-side, `../chat-routes/attachment-validation`
+ * + `../chat-routes/binary-sniff`), upload each accepted file with one POST
+ * request per file (so a single failure never poisons the batch), and track
+ * every file's status so a host composer can render chips and gate sending.
+ *
+ * Ported from gtm-agent's `src/components/composer-attachments.tsx`
+ * (gtm#584/#592/#593 hardened the sniff gate and batch semantics this leans
+ * on), de-gtm-ified:
+ *   - the hardcoded `/api/vault/upload?workspaceId=` URL becomes
+ *     `uploadUrl`/`buildUploadRequest` (the latter wins — it hands back both
+ *     the URL and a `RequestInit` override, e.g. an auth header);
+ *   - `sonner` toasts become `onReject` (client pre-validation, never hits the
+ *     network) and `onError` (a request that reached the server and failed);
+ *   - the sandbox-ui `validateComposerFiles` import becomes a small
+ *     accept-list matcher re-implemented locally (`isAcceptedFileType`,
+ *     mirroring its `accept`-string matching byte-for-byte) — this module
+ *     stays free of the sandbox-ui peer;
+ *   - the response is expected to be `{ files: ChatAttachmentInput[] }` (full
+ *     server-authoritative descriptors — size/mediaType/kind — not gtm's
+ *     `{path, name}`), so `references` is a verbatim pass-through with no
+ *     client recompute;
+ *   - `workspaceId`'s truthiness gate becomes `enabled` (default `true`).
+ *
+ * Import-free beyond React + the browser-safe `/chat-routes` validation core:
+ * this module ships through `/web-react` into client bundles
+ * (`tests/browser-safe-subpaths.test.ts` walks the graph), so nothing here
+ * may reach a Node builtin, `sandbox-ui`, or an engine package.
+ */
+
+interface UseComposerAttachmentsOptions {
+    /** Simple upload target: every file POSTs here. Ignored when
+     *  `buildUploadRequest` is provided. */
+    uploadUrl?: string;
+    /** Full request-building seam (auth headers, per-file routing, …) — wins
+     *  over `uploadUrl` when both are set. */
+    buildUploadRequest?: (args: {
+        file: File;
+        name: string;
+        form: FormData;
+    }) => {
+        url: string;
+        init?: Omit<RequestInit, 'body' | 'signal'>;
+    };
+    /** Client pre-validation rejections — a file that never reaches the
+     *  network (bad type, over a size cap, over count, disallowed kind). */
+    onReject?: (reason: string, file?: File) => void;
+    /** A file that reached the upload endpoint and failed (HTTP error,
+     *  transport error, malformed response). */
+    onError?: (reason: string) => void;
+    limits?: {
+        maxCount?: number;
+        maxBinaryBytes?: number;
+        maxTextBytes?: number;
+        maxTotalBytes?: number;
+    };
+    /** Attachment kinds accepted, checked against the sniffed content's
+     *  mime. Default: both (`['image', 'file']` — i.e. no restriction). */
+    allowedKinds?: ChatAttachmentKind[];
+    /** `<input accept>`-style gate for the file picker/drop/paste path.
+     *  Default {@link ATTACHMENT_ACCEPT}. */
+    accept?: string;
+    /** When `false`, `addFiles` rejects every call via `onReject` (and
+     *  `blockReason` explains why) instead of staging anything — the
+     *  replacement for gtm's `workspaceId`-truthiness gate (e.g. no workspace
+     *  loaded yet). Default `true`. */
+    enabled?: boolean;
+}
+interface UseComposerAttachmentsResult {
+    /** Chip models for `ChatComposer`'s `pendingFiles` prop, one per staged
+     *  file — `kind` is always `'file'` (agent-app's `ComposerFile.kind`
+     *  discriminates file-vs-folder chips, not attachment media type). */
+    composerFiles: ComposerFile[];
+    /** Ready-to-send attachment descriptors — only files whose upload
+     *  succeeded, straight from the server's response (no recompute). Feed
+     *  this into `ChatTurnRequestPayload.attachments`. */
+    references: ChatAttachmentInput[];
+    /** Validate + stage + upload the given files, one request per file. */
+    addFiles: (files: File[] | FileList) => Promise<void>;
+    /** Re-upload a failed entry using its retained `File`. */
+    retry: (id: string) => void;
+    /** Drop one staged entry, aborting its upload and revoking its preview. */
+    removeAttachment: (id: string) => void;
+    /** Forget every staged entry (call after a successful send). */
+    clear: () => void;
+    /** True while any file is still pending or uploading. */
+    hasPending: boolean;
+    /** True while any file failed to upload. */
+    hasError: boolean;
+    /** Why a send is blocked, or `null` when the queue is clean. */
+    blockReason: string | null;
+}
+/**
+ * Owns the composer's attachment lifecycle: validate selected/dropped/pasted
+ * files against the shared limits, upload each accepted file to the
+ * product's store (one request per file), and track every file's status so
+ * the composer can render chips and gate sending.
+ *
+ * Failures surface loud — a rejected file calls `onReject` and is never
+ * uploaded; a failed upload calls `onError` and leaves an error chip the user
+ * can retry or remove. `references` only ever contains files whose upload the
+ * server actually confirmed.
+ */
+declare function useComposerAttachments(options: UseComposerAttachmentsOptions): UseComposerAttachmentsResult;
+
 /**
  * Provider brand marks — real logo path data (simple-icons / SVG Logos, both
  * CC0) inlined so the picker shows actual provider identity instead of
@@ -1063,6 +1227,12 @@ interface ChatMessagesProps {
      *  preserve the current layout; pass `{ title }` (or your own node via
      *  `header`) to show the Tangle mark + product title in the chat shell. */
     header?: ReactNode;
+    /** Resolve a raw-bytes download URL for one attachment part. When set, any
+     *  message carrying attachment parts (`file`/`image` parts with a `path`,
+     *  see `attachmentPartsFromMessageParts`) renders them as a `MessageAttachments`
+     *  row next to the bubble — thumbnails for images, download chips for files.
+     *  Absent → today's rendering, byte-identical (no attachment row). */
+    resolveAttachmentUrl?: (part: ChatAttachmentPart) => string;
 }
 /** One starting "door" in the chat first-run state — a concrete, labeled action
  *  (start from a template, do it by hand, ask the agent), not a placeholder. */
@@ -1105,6 +1275,6 @@ declare function useThinkingSeconds(active: boolean): number;
  * model id, tokens/sec, and cost, plus a collapsible thinking section and
  * tool-call chips.
  */
-declare function ChatMessages({ messages, models, renderMarkdown, renderExtras, durableCards, userLabel, agentLabel, loading, approval, onToolCallClick, toolRenderers, error, onRetry, renderEmpty, emptyState, header, }: ChatMessagesProps): react.JSX.Element;
+declare function ChatMessages({ messages, models, renderMarkdown, renderExtras, durableCards, userLabel, agentLabel, loading, approval, onToolCallClick, toolRenderers, error, onRetry, renderEmpty, emptyState, header, resolveAttachmentUrl, }: ChatMessagesProps): react.JSX.Element;
 
-export { type ActivityTone, type AgentActivityPage, AgentActivityPanel, type AgentActivityPanelProps, type AgentActivityRecord, AgentSessionControls, type AgentSessionControlsProps, CatalogModel, ChatComposer, type ChatComposerProps, type ChatEmptyDoor, ChatEmptyState, type ChatEmptyStateProps, ChatInteraction, ChatInteractionField, type ChatInteractionRestoreMode, ChatInteractionStatus, ChatMentionPart, type ChatMessageMetrics, type ChatMessageSegment, ChatMessages, type ChatMessagesProps, ChatSelectField, type ChatStreamCallbacks, type ChatStreamToolCall, type ChatStreamToolResult, type ChatToolCallInfo, type ChatUiMessage, type ComposerFile, type ComposerFilePart, type ComposerMentionProp, type ConsumeChatStreamResult, DEFAULT_EFFORT_LEVELS, DEFAULT_MENTION_EMPTY_TEXT, DEFAULT_MENTION_LIMIT, type DurableChatCard, DurableChatCards, type DurableChatCardsProps, type DurableInteractionAnswerSubmitterOptions, DurablePlanCard, type DurablePlanCardProps, DurablePlanClientError, type DurablePlanCurrentInput, type DurablePlanDecision, type DurablePlanDecisionClient, type DurablePlanDecisionClientOptions, type DurablePlanDecisionInput, type DurablePlanDecisionResult, type DurablePlanFollowUpReceipt, type EffortLevel, EffortPicker, type EffortPickerProps, type FieldValues, FileMention, FlowWaterfall, type FlowWaterfallProps, INDEX_REFRESH_AFTER_MS, INTERACTION_SUBMIT_TIMEOUT_MESSAGE, INTERACTION_SUBMIT_TIMEOUT_MS, InteractionActionButton, type InteractionAnswerSubmission, type InteractionAnswerSubmitterOptions, InteractionAnswers, type InteractionAttemptStore, InteractionBadge, type InteractionBadgeVariant, InteractionCancelData, InteractionPlanCard, type InteractionPlanCardProps, InteractionQuestionCard, type InteractionQuestionCardProps, InteractionRequestWire, type InteractionSubmitResult, type MentionItem, type MentionTextSegment, MissionActivityLane, type MissionActivityLaneProps, ModelPicker, type ModelPickerProps, type ProposalApprovalHandlers, ProviderLogo, type ProviderLogoProps, QuestionOptionList, type QuestionOptionListProps, type RestoreChatInteractionsOptions, RunDrillIn, type RunDrillInProps, SeatPaywall, type SeatPaywallProps, type SmoothRevealOptions, type StreamChatOptions, type SubmitInteractionAnswer, type ToolDetailRenderers, type ToolRunRecord, type ToolRunStep, type UseChatInteractionsOptions, type UseChatInteractionsResult, type UseDurablePlanFlowOptions, type UseDurablePlanFlowResult, type UseFileMentionsOptions, type UseFileMentionsResult, type WaterfallRow, activityTone, buildAnswerData, cancelChatInteraction, consumeChatStream, createDurableInteractionAnswerSubmitter, createDurablePlanDecisionClient, createInteractionAnswerSubmitter, createMemoryInteractionAttemptStore, createSessionInteractionAttemptStore, dispatchChatStreamLine, durableChatCardsFromParts, fieldAnswer, fieldValuesFromAnswers, formatActivityCost, formatActivityDuration, formatModelCost, formatTokensPerSecond, hasSecretField, hydrateChatInteractions, interactionStatusLabels, interactionSubmissionSignature, interactionTerminalNotes, isLateAnswerableStatus, lateAnswerMessage, mergeActivityPages, nextRevealCount, pendingApprovalOf, rankFileMentions, resolveChatInteraction, responseErrorMessage, restoreChatInteractions, segmentMentionContent, streamChatTurn, terminalizePendingChatInteractions, upsertChatInteraction, useChatInteractions, useDurablePlanFlow, useFileMentions, usePending, usePopover, useSmoothText, useThinkingSeconds, waterfallLayout };
+export { type ActivityTone, type AgentActivityPage, AgentActivityPanel, type AgentActivityPanelProps, type AgentActivityRecord, AgentSessionControls, type AgentSessionControlsProps, type AttachmentFileResult, CatalogModel, ChatAttachmentInput, ChatAttachmentKind, ChatAttachmentPart, ChatComposer, type ChatComposerProps, type ChatEmptyDoor, ChatEmptyState, type ChatEmptyStateProps, ChatInteraction, ChatInteractionField, type ChatInteractionRestoreMode, ChatInteractionStatus, ChatMentionPart, type ChatMessageMetrics, type ChatMessageSegment, ChatMessages, type ChatMessagesProps, ChatSelectField, type ChatStreamCallbacks, type ChatStreamToolCall, type ChatStreamToolResult, type ChatToolCallInfo, type ChatUiMessage, type ComposerFile, type ComposerFilePart, type ComposerMentionProp, type ConsumeChatStreamResult, DEFAULT_EFFORT_LEVELS, DEFAULT_MENTION_EMPTY_TEXT, DEFAULT_MENTION_LIMIT, type DurableChatCard, DurableChatCards, type DurableChatCardsProps, type DurableInteractionAnswerSubmitterOptions, DurablePlanCard, type DurablePlanCardProps, DurablePlanClientError, type DurablePlanCurrentInput, type DurablePlanDecision, type DurablePlanDecisionClient, type DurablePlanDecisionClientOptions, type DurablePlanDecisionInput, type DurablePlanDecisionResult, type DurablePlanFollowUpReceipt, type EffortLevel, EffortPicker, type EffortPickerProps, type FieldValues, FileMention, FlowWaterfall, type FlowWaterfallProps, INDEX_REFRESH_AFTER_MS, INTERACTION_SUBMIT_TIMEOUT_MESSAGE, INTERACTION_SUBMIT_TIMEOUT_MS, InteractionActionButton, type InteractionAnswerSubmission, type InteractionAnswerSubmitterOptions, InteractionAnswers, type InteractionAttemptStore, InteractionBadge, type InteractionBadgeVariant, InteractionCancelData, InteractionPlanCard, type InteractionPlanCardProps, InteractionQuestionCard, type InteractionQuestionCardProps, InteractionRequestWire, type InteractionSubmitResult, type MentionItem, type MentionTextSegment, MessageAttachments, type MessageAttachmentsProps, MissionActivityLane, type MissionActivityLaneProps, ModelPicker, type ModelPickerProps, type ProposalApprovalHandlers, ProviderLogo, type ProviderLogoProps, QuestionOptionList, type QuestionOptionListProps, type RestoreChatInteractionsOptions, RunDrillIn, type RunDrillInProps, SeatPaywall, type SeatPaywallProps, type SmoothRevealOptions, type StreamChatOptions, type SubmitInteractionAnswer, type ToolDetailRenderers, type ToolRunRecord, type ToolRunStep, type UseChatInteractionsOptions, type UseChatInteractionsResult, type UseComposerAttachmentsOptions, type UseComposerAttachmentsResult, type UseDurablePlanFlowOptions, type UseDurablePlanFlowResult, type UseFileMentionsOptions, type UseFileMentionsResult, type WaterfallRow, __resetAttachmentFileCacheForTests, activityTone, buildAnswerData, cancelChatInteraction, consumeChatStream, createDurableInteractionAnswerSubmitter, createDurablePlanDecisionClient, createInteractionAnswerSubmitter, createMemoryInteractionAttemptStore, createSessionInteractionAttemptStore, dispatchChatStreamLine, durableChatCardsFromParts, fieldAnswer, fieldValuesFromAnswers, formatActivityCost, formatActivityDuration, formatModelCost, formatTokensPerSecond, hasSecretField, hydrateChatInteractions, interactionStatusLabels, interactionSubmissionSignature, interactionTerminalNotes, isLateAnswerableStatus, lateAnswerMessage, loadAttachmentFile, mergeActivityPages, nextRevealCount, pendingApprovalOf, rankFileMentions, resolveChatInteraction, responseErrorMessage, restoreChatInteractions, segmentMentionContent, streamChatTurn, terminalizePendingChatInteractions, triggerAttachmentDownload, upsertChatInteraction, useChatInteractions, useComposerAttachments, useDurablePlanFlow, useFileMentions, usePending, usePopover, useSmoothText, useThinkingSeconds, waterfallLayout };

package/dist/web-react/index.js

@@ -19,12 +19,14 @@ import {
   InteractionBadge,
   InteractionPlanCard,
   InteractionQuestionCard,
+  MessageAttachments,
   MissionActivityLane,
   ModelPicker,
   ProviderLogo,
   QuestionOptionList,
   RunDrillIn,
   SeatPaywall,
+  __resetAttachmentFileCacheForTests,
   activityTone,
   buildAnswerData,
   cancelChatInteraction,
@@ -49,6 +51,7 @@ import {
   interactionTerminalNotes,
   isLateAnswerableStatus,
   lateAnswerMessage,
+  loadAttachmentFile,
   mergeActivityPages,
   nextRevealCount,
   pendingApprovalOf,
@@ -59,8 +62,10 @@ import {
   segmentMentionContent,
   streamChatTurn,
   terminalizePendingChatInteractions,
+  triggerAttachmentDownload,
   upsertChatInteraction,
   useChatInteractions,
+  useComposerAttachments,
   useDurablePlanFlow,
   useFileMentions,
   usePending,
@@ -68,12 +73,14 @@ import {
   useSmoothText,
   useThinkingSeconds,
   waterfallLayout
-} from "../chunk-O6H2WD3I.js";
+} from "../chunk-EIG7ZQW2.js";
 import {
   tabTerminalConnectionId,
   useSandboxTerminalConnection
 } from "../chunk-65P3HJY3.js";
-import "../chunk-LCNY3DCM.js";
+import {
+  ATTACHMENT_ACCEPT
+} from "../chunk-3EKOSBYL.js";
 import "../chunk-2QI7XV2T.js";
 import {
   DISPATCH_MAX_MEDIA_PARTS,
@@ -124,6 +131,7 @@ import {
 import "../chunk-SIXYZ2FB.js";
 import "../chunk-MCJSS6SM.js";
 export {
+  ATTACHMENT_ACCEPT,
   AgentActivityPanel,
   AgentSessionControls,
   ChatComposer,
@@ -151,12 +159,14 @@ export {
   InteractionBadge,
   InteractionPlanCard,
   InteractionQuestionCard,
+  MessageAttachments,
   MissionActivityLane,
   ModelPicker,
   ProviderLogo,
   QuestionOptionList,
   RunDrillIn,
   SeatPaywall,
+  __resetAttachmentFileCacheForTests,
   activityTone,
   attachmentInputToPart,
   attachmentKindForMime,
@@ -202,6 +212,7 @@ export {
   isSafeInteractionFieldKey,
   isTerminalInteractionStatus,
   lateAnswerMessage,
+  loadAttachmentFile,
   mediaTypeForMentionPath,
   mentionInputToPart,
   mentionKindForPath,
@@ -225,8 +236,10 @@ export {
   streamChatTurn,
   tabTerminalConnectionId,
   terminalizePendingChatInteractions,
+  triggerAttachmentDownload,
   upsertChatInteraction,
   useChatInteractions,
+  useComposerAttachments,
   useDurablePlanFlow,
   useFileMentions,
   usePending,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@tangle-network/agent-app",
-  "version": "0.43.49",
+  "version": "0.43.51",
   "packageManager": "pnpm@10.33.4",
   "description": "Application-shell framework for Tangle agent products: a bounded tool loop, the structured agent→app tool side channel, integration-hub client, per-workspace billing, and crypto — composed over the Tangle agent substrate through typed seams.",
   "keywords": [

package/dist/chunk-LCNY3DCM.js

@@ -1,84 +0,0 @@
-// src/chat-routes/file-index.ts
-var DEFAULT_IGNORE_SEGMENTS = [
-  "node_modules",
-  "dist",
-  "build",
-  "out",
-  "coverage",
-  "target",
-  "__pycache__",
-  "venv"
-];
-function isIgnored(relPath, ignoreSegments) {
-  for (const segment of relPath.split("/")) {
-    if (!segment) continue;
-    if (segment.startsWith(".")) return true;
-    if (ignoreSegments.has(segment)) return true;
-  }
-  return false;
-}
-function relativeTo(root, path) {
-  const prefix = root.endsWith("/") ? root : `${root}/`;
-  if (path.startsWith(prefix)) return path.slice(prefix.length);
-  if (path === root) return "";
-  return path;
-}
-function basename(path) {
-  const segments = path.split("/").filter(Boolean);
-  return segments[segments.length - 1] ?? path;
-}
-function isMissingRootError(err, root) {
-  if (!(err instanceof Error)) return false;
-  if (err.code !== "VALIDATION_ERROR") return false;
-  return /ENOENT/.test(err.message) && /no such file or directory/.test(err.message) && new RegExp(`\\blstat '${escapeRegExp(root)}'`).test(err.message);
-}
-function escapeRegExp(value) {
-  return value.replace(/[.*+?^${}()|[\]\\]/g, "\\$&");
-}
-function createSandboxFileIndexRoute(options) {
-  const maxDepth = options.maxDepth ?? 12;
-  const maxEntries = options.maxEntries ?? 5e3;
-  const cacheTtlSeconds = options.cacheTtlSeconds ?? 20;
-  const staticIgnore = /* @__PURE__ */ new Set([...DEFAULT_IGNORE_SEGMENTS, ...options.ignore ?? []]);
-  return async function fileIndex(request) {
-    const auth = await options.authorize({ request });
-    if (auth.status === "denied") return auth.response;
-    if (auth.status === "warming") {
-      return Response.json({ status: "warming" });
-    }
-    const cache = options.cache;
-    if (cache && auth.cacheKey) {
-      const cached = await cache.get(auth.cacheKey);
-      if (cached) return Response.json(cached);
-    }
-    const ignoreSegments = auth.ignore?.length ? /* @__PURE__ */ new Set([...staticIgnore, ...auth.ignore]) : staticIgnore;
-    let scan;
-    try {
-      scan = await auth.fs.tree(auth.root, { maxDepth });
-    } catch (err) {
-      if (!isMissingRootError(err, auth.root)) throw err;
-      return Response.json({ status: "warming" });
-    }
-    const filtered = scan.files.filter((f) => !isIgnored(relativeTo(scan.root, f.path), ignoreSegments));
-    const truncated = scan.stats.truncated || filtered.length > maxEntries;
-    const files = filtered.slice(0, maxEntries).map((f) => {
-      const path = relativeTo(scan.root, f.path);
-      const entry = { path, name: basename(path) };
-      if (typeof f.size === "number") entry.size = f.size;
-      return entry;
-    });
-    const body = {
-      status: "ready",
-      files,
-      truncated,
-      generatedAt: (/* @__PURE__ */ new Date()).toISOString()
-    };
-    if (cache && auth.cacheKey) await cache.put(auth.cacheKey, body, { ttlSeconds: cacheTtlSeconds });
-    return Response.json(body);
-  };
-}
-
-export {
-  createSandboxFileIndexRoute
-};
-//# sourceMappingURL=chunk-LCNY3DCM.js.map

package/dist/chunk-LCNY3DCM.js.map

@@ -1 +0,0 @@
-{"version":3,"sources":["../src/chat-routes/file-index.ts"],"sourcesContent":["/**\n * `createSandboxFileIndexRoute` — server side of `@`-file-mentions\n * (companion to sandbox-ui#184's composer mention primitive). Serves a flat,\n * ignore-filtered listing of the workspace sandbox so `useFileMentions`\n * (`/web-react`) can filter it client-side without a round trip per\n * keystroke.\n *\n * Same seam style as `createUploadRoute`: `authorize({ request })` resolves a\n * structural `{ tree(path, opts) }` handle (the shape of the sandbox SDK's\n * `box.fs.tree`) — no SDK import here. `authorize` also carries the\n * cold-box signal: a sandbox that isn't running yet answers `{ status:\n * 'warming' }` directly, never provisions-and-waits inside this route.\n *\n * A box can also be running with its workspace root not yet materialised, which\n * `authorize` cannot see; the route recognises that one signal off `fs.tree`\n * and answers `warming` too, so every consumer gets the retry-and-wait state\n * instead of a 500. Every other `tree()` failure propagates.\n */\n\nimport type { FileMention } from './wire'\n\n/** One entry from a structural `tree()` scan. Mirrors the sandbox SDK's\n *  `FileTreeFile` (`path`, `size`, `mtime`) — `mtime` is unused here so it's\n *  omitted from the structural match. */\nexport interface SandboxTreeFile {\n  path: string\n  size: number\n}\n\n/** Structural match of the sandbox SDK's `box.fs.tree` result shape\n *  (`FileTreeResult`). `stats.truncated` is the only stat this route reads;\n *  the rest ride through unread on the real SDK type. */\nexport interface SandboxTreeResult {\n  root: string\n  files: SandboxTreeFile[]\n  stats: { truncated: boolean }\n}\n\n/** Structural match of the sandbox SDK's `box.fs` tree surface. */\nexport interface SandboxFileTreeSource {\n  tree(path: string, options?: { maxDepth?: number }): Promise<SandboxTreeResult>\n}\n\nexport interface FileIndexReadyResponse {\n  status: 'ready'\n  /** Workspace-relative entries. Same shape as `FileMention` (`./wire`) so a\n   *  client can hand a response entry straight to `fileMentionsToParts` /\n   *  `buildMentionPromptBlock` without remapping. */\n  files: FileMention[]\n  /** True when either the underlying scan truncated (SDK-side cap) or this\n   *  route's own `maxEntries` cap trimmed the filtered list. The client\n   *  should show \"showing first N files\" rather than imply completeness. */\n  truncated: boolean\n  generatedAt: string\n}\n\n/** Cold-box answer: no provisioning happened, no files were scanned. The\n *  client shows a warming state and retries — this route never blocks on a\n *  box coming up. Two situations produce it: `authorize` reporting a box that\n *  is not running, and a running box whose workspace root does not exist yet\n *  (see `isMissingRootError`). */\nexport interface FileIndexWarmingResponse {\n  status: 'warming'\n}\n\nexport type FileIndexResponse = FileIndexReadyResponse | FileIndexWarmingResponse\n\n/** Short-TTL cache seam so repeat popover opens in the same session don't\n *  re-scan the workspace. Host-provided (e.g. a KV binding); `key` is\n *  whatever `authorize` returns as `cacheKey` — this route treats it opaquely. */\nexport interface FileIndexCache {\n  get(key: string): Promise<FileIndexReadyResponse | null> | FileIndexReadyResponse | null\n  put(key: string, value: FileIndexReadyResponse, options?: { ttlSeconds?: number }): Promise<void> | void\n}\n\nexport type FileIndexAuthorization =\n  | {\n      status: 'ready'\n      /** Structural sandbox `fs` handle, usually `ensureWorkspaceSandbox(...)` → `box.fs`. */\n      fs: SandboxFileTreeSource\n      /** Workspace root to index (e.g. `/home/agent`). */\n      root: string\n      /** Extra ignore segments for this request, merged with the route's\n       *  defaults + `CreateSandboxFileIndexRouteOptions.ignore`. */\n      ignore?: string[]\n      /** Opaque cache key for the optional cache seam. Omit to skip caching\n       *  for this request (e.g. a workspace the host chooses not to cache). */\n      cacheKey?: string\n    }\n  | { status: 'warming' }\n  | { status: 'denied'; response: Response }\n\nexport interface CreateSandboxFileIndexRouteOptions {\n  /** Authenticate the caller, resolve the sandbox `fs` handle, and signal a\n   *  cold box — never provisions or waits. */\n  authorize(args: { request: Request }): Promise<FileIndexAuthorization>\n  /** Extra ignore segments beyond the route's defaults (node_modules, .git,\n   *  dotfiles/dot-dirs, common build dirs). Matched as exact path-segment\n   *  names, same rule as the defaults. */\n  ignore?: string[]\n  /** Passed to `fs.tree` as `options.maxDepth`. Default 12. */\n  maxDepth?: number\n  /** Hard cap on entries returned after filtering. Default 5000. */\n  maxEntries?: number\n  /** Optional host-provided cache seam. */\n  cache?: FileIndexCache\n  /** Cache TTL in seconds when `cache` is set. Default 20. */\n  cacheTtlSeconds?: number\n}\n\n/** Segment names ignored anywhere in a path, beyond the generic dotfile rule\n *  below. Intentionally small and language/framework-agnostic — callers\n *  extend it via `ignore` for anything domain-specific (e.g. a vault's\n *  `uploads` dir). */\nconst DEFAULT_IGNORE_SEGMENTS = [\n  'node_modules',\n  'dist',\n  'build',\n  'out',\n  'coverage',\n  'target',\n  '__pycache__',\n  'venv',\n]\n\n/** A path segment starting with `.` (`.git`, `.env`, `.next`, `.cache`, …) is\n *  always ignored — this single rule covers most dot-prefixed VCS/tooling\n *  dirs and dotfiles without enumerating them. */\nfunction isIgnored(relPath: string, ignoreSegments: ReadonlySet<string>): boolean {\n  for (const segment of relPath.split('/')) {\n    if (!segment) continue\n    if (segment.startsWith('.')) return true\n    if (ignoreSegments.has(segment)) return true\n  }\n  return false\n}\n\n/** Strips the tree result's echoed `root` prefix so entries are always\n *  workspace-relative, whichever convention the structural `fs.tree` uses\n *  (root-relative already, or root-prefixed). */\nfunction relativeTo(root: string, path: string): string {\n  const prefix = root.endsWith('/') ? root : `${root}/`\n  if (path.startsWith(prefix)) return path.slice(prefix.length)\n  if (path === root) return ''\n  return path\n}\n\nfunction basename(path: string): string {\n  const segments = path.split('/').filter(Boolean)\n  return segments[segments.length - 1] ?? path\n}\n\n/**\n * A box can answer `running` before it has materialised the workspace root —\n * `authorize` has already committed to `ready` by then, so `fs.tree` is the\n * first thing to notice, and it rejects with the sandbox SDK's\n * `ValidationError` wrapping a box-side `ENOENT … lstat` on the root. That is\n * the SAME \"not usable yet\" state `authorize` collapses onto `warming` for an\n * absent or stopped box, just discovered one step later, so it gets the same\n * answer instead of escaping as a 500.\n *\n * Matched STRUCTURALLY, not with `instanceof`: importing the SDK's error class\n * would make `@tangle-network/sandbox` a hard dependency of a route factory\n * whose entire `fs` seam is structural (`SandboxFileTreeSource`), and would\n * break any host feeding it a non-SDK handle.\n *\n * Deliberately narrow — the error code, `ENOENT`, the ENOENT message text, AND\n * the failing syscall's own operand all have to line up. A permission error, a\n * timeout, an auth failure, or an ENOENT on some other path inside the tree is\n * a real failure and still surfaces.\n *\n * The operand is matched as the quoted `lstat '<root>'` clause rather than by\n * substring, because the root is a PREFIX of everything under it: a plain\n * `includes(root)` would also swallow an ENOENT on `<root>/gone/x.md`, and on\n * a prefix sibling like `/home/agent-old/...`.\n */\nfunction isMissingRootError(err: unknown, root: string): boolean {\n  if (!(err instanceof Error)) return false\n  if ((err as { code?: unknown }).code !== 'VALIDATION_ERROR') return false\n  return (\n    /ENOENT/.test(err.message) &&\n    /no such file or directory/.test(err.message) &&\n    new RegExp(`\\\\blstat '${escapeRegExp(root)}'`).test(err.message)\n  )\n}\n\nfunction escapeRegExp(value: string): string {\n  return value.replace(/[.*+?^${}()|[\\]\\\\]/g, '\\\\$&')\n}\n\nexport function createSandboxFileIndexRoute(\n  options: CreateSandboxFileIndexRouteOptions,\n): (request: Request) => Promise<Response> {\n  const maxDepth = options.maxDepth ?? 12\n  const maxEntries = options.maxEntries ?? 5000\n  const cacheTtlSeconds = options.cacheTtlSeconds ?? 20\n  const staticIgnore = new Set([...DEFAULT_IGNORE_SEGMENTS, ...(options.ignore ?? [])])\n\n  return async function fileIndex(request: Request): Promise<Response> {\n    const auth = await options.authorize({ request })\n    if (auth.status === 'denied') return auth.response\n    if (auth.status === 'warming') {\n      return Response.json({ status: 'warming' } satisfies FileIndexWarmingResponse)\n    }\n\n    const cache = options.cache\n    if (cache && auth.cacheKey) {\n      const cached = await cache.get(auth.cacheKey)\n      if (cached) return Response.json(cached)\n    }\n\n    const ignoreSegments = auth.ignore?.length\n      ? new Set([...staticIgnore, ...auth.ignore])\n      : staticIgnore\n\n    let scan: SandboxTreeResult\n    try {\n      scan = await auth.fs.tree(auth.root, { maxDepth })\n    } catch (err) {\n      if (!isMissingRootError(err, auth.root)) throw err\n      return Response.json({ status: 'warming' } satisfies FileIndexWarmingResponse)\n    }\n    const filtered = scan.files.filter((f) => !isIgnored(relativeTo(scan.root, f.path), ignoreSegments))\n    const truncated = scan.stats.truncated || filtered.length > maxEntries\n    const files: FileMention[] = filtered.slice(0, maxEntries).map((f) => {\n      const path = relativeTo(scan.root, f.path)\n      const entry: FileMention = { path, name: basename(path) }\n      if (typeof f.size === 'number') entry.size = f.size\n      return entry\n    })\n\n    const body: FileIndexReadyResponse = {\n      status: 'ready',\n      files,\n      truncated,\n      generatedAt: new Date().toISOString(),\n    }\n\n    if (cache && auth.cacheKey) await cache.put(auth.cacheKey, body, { ttlSeconds: cacheTtlSeconds })\n\n    return Response.json(body)\n  }\n}\n"],"mappings":"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","names":[]}