@tangle-network/agent-app 0.43.47 → 0.43.48

package/dist/{file-index-Bn6sitKb.d.ts → file-index-b26ee-_R.d.ts}

@@ -1,4 +1,4 @@
-import { F as FileMention } from './parts-1_3y2JmR.js';
+import { K as FileMention } from './parts-IB-Kbb7z.js';
 
 /**
  * `createSandboxFileIndexRoute` — server side of `@`-file-mentions

package/dist/index.d.ts

@@ -17,9 +17,10 @@ export { KeyCrypto, KeyProvisioner, PlanLimit, PlatformBalanceInfo, PlatformBala
 export { HttpHeadProbeConfig, PreflightProbe, PreflightProbeResult, PreflightProbeVerdict, PreflightReport, RouterChatProbeConfig, SandboxAuthProbeConfig, formatPreflightReport, httpHeadProbe, routerChatProbe, runPreflight, sandboxAuthProbe } from './preflight/index.js';
 export { ObjectBody, ObjectKeyParts, ObjectStore, PutObjectOptions, R2LikeBucket, R2LikeObjectBody, R2LikeObjectHead, SignObjectUrlArgs, VerifyObjectUrlResult, assertSafeKeySegment, createProxiedArtifactRoute, createR2ObjectStore, objectKey, signObjectUrl, verifyObjectUrl } from './object-store/index.js';
 export { B as BULK_DELETE_MAX_THREADS, C as ChatStoreInputError, t as threadTitleFromMessage } from './core-7qIM7svy.js';
-export { C as ChatFilePart, a as ChatImagePart, b as ChatInteractionPart, c as ChatMentionKind, d as ChatMentionPart, e as ChatMessagePart, f as ChatNoticePart, g as ChatPartTime, h as ChatPlanPart, i as ChatReasoningPart, j as ChatStepFinishPart, k as ChatStepStartPart, l as ChatSubtaskPart, m as ChatTextPart, n as ChatToolPart, o as ChatToolState, p as ChatToolStatus, q as ChatUsageTokens, S as StorableHarnessPartKind, r as isChatInteractionPart, s as isChatMentionPart, t as isChatPlanPart, u as isChatStepFinishPart, v as isChatTextPart, w as isChatToolPart, x as mentionInputToPart, y as mentionPartsFromMessageParts, z as toChatMessageParts } from './parts-1_3y2JmR.js';
+export { C as ChatAttachmentKind, a as ChatAttachmentPart, b as ChatFilePart, c as ChatImagePart, d as ChatInteractionPart, e as ChatMentionKind, f as ChatMentionPart, g as ChatMessagePart, h as ChatNoticePart, i as ChatPartTime, j as ChatPlanPart, k as ChatReasoningPart, l as ChatStepFinishPart, m as ChatStepStartPart, n as ChatSubtaskPart, o as ChatTextPart, p as ChatToolPart, q as ChatToolState, r as ChatToolStatus, s as ChatUsageTokens, D as DEFAULT_ATTACHMENT_PROMPT_HEADER, S as StorableHarnessPartKind, t as attachmentInputToPart, u as attachmentKindForMime, v as attachmentPartsFromMessageParts, w as buildAttachmentPromptBlock, x as historyContentWithAttachments, y as isChatAttachmentPart, z as isChatInteractionPart, A as isChatMentionPart, B as isChatPlanPart, E as isChatStepFinishPart, F as isChatTextPart, G as isChatToolPart, H as mentionInputToPart, I as mentionPartsFromMessageParts, J as toChatMessageParts } from './parts-IB-Kbb7z.js';
 export { DeriveKeyOptions, createFieldCrypto, decodeHexKey, decryptAesGcm, decryptBytes, decryptWithKey, deriveKey, encryptAesGcm, encryptBytes, encryptWithKey } from './crypto/index.js';
-export { JsonRecord, MISSING_TOOL_TERMINAL_ERROR, MISSING_TOOL_TERMINAL_REASON, PersistedChatMessageForTurn, ResolvedChatTurn, StreamEvent, asRecord, asString, attachmentPartKey, buildUserTextParts, collapseRedundantTextParts, encodeEvent, finalizeAssistantParts, finalizePendingInteractionParts, getPartKey, mergePersistedPart, messageHasTurnId, normalizeClientTurnId, normalizePersistedPart, normalizeTime, normalizeToolEvent, resolveChatTurn, resolveToolId, resolveToolName, terminalizeDanglingAssistantToolUpdates, terminalizeDanglingToolPart, terminalizeDanglingToolParts } from './stream/index.js';
+export { J as JsonRecord, M as MISSING_TOOL_TERMINAL_ERROR, a as MISSING_TOOL_TERMINAL_REASON, S as StreamEvent, b as asRecord, c as asString, d as attachmentPartKey, e as collapseRedundantTextParts, f as encodeEvent, g as finalizeAssistantParts, h as finalizePendingInteractionParts, i as getPartKey, m as mergePersistedPart, n as normalizePersistedPart, j as normalizeTime, k as normalizeToolEvent, r as resolveToolId, l as resolveToolName, t as terminalizeDanglingAssistantToolUpdates, o as terminalizeDanglingToolPart, p as terminalizeDanglingToolParts } from './stream-normalizer-DWvtmY6F.js';
+export { PersistedChatMessageForTurn, ResolvedChatTurn, buildUserTextParts, messageHasTurnId, normalizeClientTurnId, resolveChatTurn } from './stream/index.js';
 export { B as BufferedTurnEvent, a as BufferedTurnOptions, b as BufferedTurnTap, D as D1LikeForTurns, P as PumpBufferedTurnOptions, R as ReplayTurnEventsOptions, T as TURN_EVENTS_MIGRATION_SQL, c as TURN_STATUS_SCOPE_MIGRATION_SQL, d as TurnEventStore, e as TurnStatus, f as coalesceChatStreamEvents, g as coalesceDeltas, h as createBufferedTurnTap, i as createD1TurnEventStore, j as createMemoryTurnEventStore, p as pumpBufferedTurn, r as replayTurnEvents } from './turn-buffer-C9mEgoop.js';
 export { HubExecClient, HubExecClientOptions, HubExecErrorCode, HubExecResult, HubInvokeDeps, HubInvokeInput, HubInvokeOutcome, ParsedIntegrationAction, invokeIntegrationHub, resolveIntegrationAction } from './integrations/index.js';
 export { C as ChatInteraction, a as ChatInteractionField, b as ChatInteractionStatus, c as ChatSelectField, d as ComposerAnswerDelivery, I as INTERACTION_CANCEL_EVENT, e as INTERACTION_EVENT, f as INTERACTION_RESOLVED_EVENT, g as InteractionAnswerValue, h as InteractionAnswers, i as InteractionCancelData, j as InteractionPersistedPart, k as InteractionRequestWire, N as NoticeKind, l as NoticePersistedPart, P as ParseInteractionAnswersResult, m as ParseInteractionResult, n as canTransitionInteractionStatus, o as cancelStatusFor, p as composerAnswerData, q as composerAnswerDeliveries, r as dedupeQuestionInteractionsByContent, s as fieldAcceptsFreeText, t as interactionFromWireRequest, u as interactionPartKey, v as interactionToPersistedPart, w as isRenderableInteractionKind, x as isSafeInteractionFieldKey, y as isTerminalInteractionStatus, z as noticePart, A as noticePartKey, B as parseInteractionAnswers, D as parseInteractionCancel, E as parseInteractionRequest, F as persistedPartToInteraction, G as questionInteractionContentSignature, H as stampInteractionAnswers } from './contract-KfqJh_au.js';

package/dist/index.js

@@ -244,39 +244,20 @@ import {
   threadTitleFromMessage
 } from "./chunk-5EQCITY3.js";
 import {
-  MISSING_TOOL_TERMINAL_ERROR,
-  MISSING_TOOL_TERMINAL_REASON,
   TURN_EVENTS_MIGRATION_SQL,
   TURN_STATUS_SCOPE_MIGRATION_SQL,
-  asRecord,
-  asString,
-  attachmentPartKey,
   buildUserTextParts,
   coalesceChatStreamEvents,
   coalesceDeltas,
-  collapseRedundantTextParts,
   createBufferedTurnTap,
   createD1TurnEventStore,
   createMemoryTurnEventStore,
-  encodeEvent,
-  finalizeAssistantParts,
-  finalizePendingInteractionParts,
-  getPartKey,
-  mergePersistedPart,
   messageHasTurnId,
   normalizeClientTurnId,
-  normalizePersistedPart,
-  normalizeTime,
-  normalizeToolEvent,
   pumpBufferedTurn,
   replayTurnEvents,
-  resolveChatTurn,
-  resolveToolId,
-  resolveToolName,
-  terminalizeDanglingAssistantToolUpdates,
-  terminalizeDanglingToolPart,
-  terminalizeDanglingToolParts
-} from "./chunk-4AUQIAYU.js";
+  resolveChatTurn
+} from "./chunk-23LUHHHN.js";
 import {
   createInteractionAnswerRoute,
   listSessionInteractions,
@@ -296,6 +277,13 @@ import {
   serializeCookie
 } from "./chunk-HFC4BTWJ.js";
 import {
+  DEFAULT_ATTACHMENT_PROMPT_HEADER,
+  attachmentInputToPart,
+  attachmentKindForMime,
+  attachmentPartsFromMessageParts,
+  buildAttachmentPromptBlock,
+  historyContentWithAttachments,
+  isChatAttachmentPart,
   isChatInteractionPart,
   isChatMentionPart,
   isChatPlanPart,
@@ -305,7 +293,28 @@ import {
   mentionInputToPart,
   mentionPartsFromMessageParts,
   toChatMessageParts
-} from "./chunk-6E2XJSCT.js";
+} from "./chunk-JGYOYY5D.js";
+import {
+  MISSING_TOOL_TERMINAL_ERROR,
+  MISSING_TOOL_TERMINAL_REASON,
+  asRecord,
+  asString,
+  attachmentPartKey,
+  collapseRedundantTextParts,
+  encodeEvent,
+  finalizeAssistantParts,
+  finalizePendingInteractionParts,
+  getPartKey,
+  mergePersistedPart,
+  normalizePersistedPart,
+  normalizeTime,
+  normalizeToolEvent,
+  resolveToolId,
+  resolveToolName,
+  terminalizeDanglingAssistantToolUpdates,
+  terminalizeDanglingToolPart,
+  terminalizeDanglingToolParts
+} from "./chunk-5MG74GVQ.js";
 import {
   INTERACTION_CANCEL_EVENT,
   INTERACTION_EVENT,
@@ -524,6 +533,7 @@ export {
   ConversionMetricsSchema,
   CopyContentSchema,
   DEFAULT_APP_TOOL_PATHS,
+  DEFAULT_ATTACHMENT_PROMPT_HEADER,
   DEFAULT_DESIGN_CANVAS_MCP_DESCRIPTION,
   DEFAULT_HARNESS,
   DEFAULT_HEADER_NAMES,
@@ -604,7 +614,10 @@ export {
   assertSceneMediaSrc,
   assertSequenceMediaUrl,
   attachReasoningEffort,
+  attachmentInputToPart,
+  attachmentKindForMime,
   attachmentPartKey,
+  attachmentPartsFromMessageParts,
   authenticateToolRequest,
   bearerSubprotocolToken,
   bearerToken,
@@ -616,6 +629,7 @@ export {
   buildAppToolMcpServer,
   buildAppToolMcpServers,
   buildAppToolOpenAITools,
+  buildAttachmentPromptBlock,
   buildCaptionChunks,
   buildCatalog,
   buildConsentUrl,
@@ -755,6 +769,7 @@ export {
   getClient,
   getPartKey,
   handleAppToolRequest,
+  historyContentWithAttachments,
   httpHeadProbe,
   instantiateTemplate,
   interactionFromWireRequest,
@@ -762,6 +777,7 @@ export {
   interactionToPersistedPart,
   invokeIntegrationHub,
   isAppToolName,
+  isChatAttachmentPart,
   isChatInteractionPart,
   isChatMentionPart,
   isChatPlanPart,

package/dist/{parts-1_3y2JmR.d.ts → parts-IB-Kbb7z.d.ts}

@@ -29,6 +29,27 @@ interface ChatTurnFilePartInput {
     content?: string;
 }
 type ChatTurnPartInput = ChatTurnTextPartInput | ChatTurnFilePartInput;
+/** The image/file split an attachment is rendered and persisted under — the
+ *  same discriminant as {@link ChatMentionKind}, but a distinct name because an
+ *  attachment carries content the product uploaded (`ChatAttachmentInput`)
+ *  while a mention points at a file the box already has. Defined HERE (the
+ *  import-free layer) so `ChatAttachmentInput` can reference it and the client
+ *  composer imports it without pulling the persisted-part vocabulary;
+ *  `/chat-store`'s parts module re-exports it alongside the attachment helpers. */
+type ChatAttachmentKind = 'image' | 'file';
+/** `POST` turn-body entry describing a file already uploaded to the product's
+ *  store (vault/object-store) — distinct from an inline {@link
+ *  ChatTurnFilePartInput} (which carries bytes) and from a {@link FileMention}
+ *  (a sandbox path the box already holds). The route resolves this field with
+ *  {@link resolveChatAttachments}: every path is re-validated and every size is
+ *  re-derived from the stored body, so nothing here is trusted as sent. */
+interface ChatAttachmentInput {
+    path: string;
+    name: string;
+    size: number;
+    mediaType: string;
+    kind: ChatAttachmentKind;
+}
 /** POST body for the turn route. `content` may be empty when `parts` carry the
  *  message (an image-only send). Product routing fields (workspaceId etc.) ride
  *  alongside and are read by the product's `authorize` seam. */
@@ -45,6 +66,12 @@ interface ChatTurnRequestPayload {
      *  route validates this field with {@link parseFileMentions} and replaces it
      *  on the payload with the validated, deduped list. */
     mentions?: FileMention[];
+    /** Files uploaded to the product's store ahead of the turn — path
+     *  references, NOT inline bytes (those ride `parts`). Validated and
+     *  size-re-derived by {@link resolveChatAttachments} into persistable
+     *  attachment parts; a product whose `parts` field is spoken for by inline
+     *  uploads still sends store-backed files here. */
+    attachments?: ChatAttachmentInput[];
     model?: string;
     effort?: 'auto' | 'low' | 'medium' | 'high';
     harness?: string;
@@ -57,6 +84,41 @@ interface ChatTurnRequestPayload {
  *  parser. */
 declare function chatTurnRequestInit(payload: ChatTurnRequestPayload): RequestInit;
 declare const INLINE_PARTS_MAX_BYTES = 950000;
+/** Hard cap on the whole `/prompt` request body as it crosses the sandbox
+ *  proxy — smaller in practice than a raw-file write cap because a dispatch
+ *  carries several inline parts plus the flattened history in one request. */
+declare const DISPATCH_REQUEST_MAX_BYTES: number;
+/** Bytes reserved off the top of {@link DISPATCH_REQUEST_MAX_BYTES} for the
+ *  JSON structure around the parts array (keys, delimiters, per-part
+ *  `type`/`filename`/`mediaType` fields) that {@link base64WireLen} does not
+ *  account for — keeps the inline budget off the exact proxy cap where one
+ *  stray byte trips the 413. */
+declare const DISPATCH_STRUCTURAL_RESERVE_BYTES: number;
+/** Sidecar's hard cap on the `parts` array of one prompt request — a dispatch
+ *  must never assemble more parts than this or the whole turn 400s. */
+declare const DISPATCH_MAX_PARTS = 64;
+/** Product-side cap on media parts per dispatch (current turn + carried
+ *  history), well under {@link DISPATCH_MAX_PARTS}. History trimming that keeps
+ *  a transcript's native media under this is a PRODUCT concern (the pointer
+ *  block keeps trimmed media reachable); `buildDispatchParts` enforces only the
+ *  total {@link DISPATCH_MAX_PARTS} cap. */
+declare const DISPATCH_MAX_MEDIA_PARTS = 24;
+/** Size a base64-encoded string occupies on the wire given the raw
+ *  (pre-encoding) byte length: base64 packs 3 raw bytes into 4 output
+ *  characters, rounded up to the next multiple of 4. */
+declare function base64WireLen(byteLen: number): number;
+/**
+ * Render a raw byte count as a human-readable size (`512B`, `3KB`, `12MB
+ * 500KB`). Ported EXACTLY from gtm-agent's `attachment-limits.ts` — byte-
+ * identical implementation, not a reinterpretation — so `resolve-attachments`'s
+ * and `promote-file-part`'s error strings match gtm's wording verbatim. Lives
+ * in the import-free wire layer (not `resolve-attachments.ts` alone) because
+ * BOTH the aggregate-cap message here and the per-file oversize message in
+ * `promote-file-part.ts` need it; a browser composer wanting the same
+ * formatting for a client-side pre-check can also import it with no engine
+ * pulled in.
+ */
+declare function formatBytes(bytes: number): string;
 declare class ChatTurnInputError extends Error {
     readonly status: number;
     readonly code: string;
@@ -229,11 +291,15 @@ interface ChatToolPart {
     state: ChatToolState;
 }
 /** Union of the sidecar's legacy (path-based) and AI-SDK (url-based) file
- *  shapes; response-side every field besides `type` is optional. */
+ *  shapes; response-side every field besides `type` is optional. `name` is the
+ *  attachment-flavored display label an uploaded/promoted file carries (see
+ *  {@link ChatAttachmentPart}) — absent on a harness-emitted file part, which
+ *  uses `filename`. */
 interface ChatFilePart {
     type: 'file';
     id?: string;
     filename?: string;
+    name?: string;
     mediaType?: string;
     url?: string;
     path?: string;
@@ -242,6 +308,7 @@ interface ChatFilePart {
 interface ChatImagePart {
     type: 'image';
     filename?: string;
+    name?: string;
     mediaType?: string;
     url?: string;
     path?: string;
@@ -364,5 +431,82 @@ declare function mentionPartsFromMessageParts(parts: ReadonlyArray<Record<string
  *  than stored as `undefined`, so a stored row never carries a key that means
  *  nothing. */
 declare function mentionInputToPart(input: FileMention): ChatMentionPart;
+/** `image` for any `image/*` mime, `file` for everything else (including an
+ *  absent/empty mime) — the same split the composer and the persisted-part
+ *  discriminant both key on. */
+declare function attachmentKindForMime(mime?: string): ChatAttachmentKind;
+
+/**
+ * Persisted attachment part: structurally an attachment-flavored `ChatFilePart`
+ * / `ChatImagePart` (`path` + `name` promoted to required) rather than a
+ * separate union member — see the section note above. The index signature keeps
+ * it a `Record<string, unknown>` so it drops into the same untyped `parts`
+ * arrays every other stored part rides in, and lets the `type`-driven
+ * constructors below build it without union-discriminant gymnastics.
+ */
+interface ChatAttachmentPart {
+    type: ChatAttachmentKind;
+    path: string;
+    name: string;
+    size?: number;
+    mediaType?: string;
+    turnId?: string;
+    [key: string]: unknown;
+}
+/** True for any `image`/`file` part carrying a non-empty string `path`.
+ *  DELIBERATELY also matches a sidecar path-bearing file part (a mention-style
+ *  `file` part with only `path`) — the guard is a structural attachment shape,
+ *  not proof of provenance; a caller that needs to exclude those filters
+ *  upstream. The `path.length > 0` check diverges from gtm's original guard
+ *  (which only checked `typeof`), mirroring sibling {@link isChatMentionPart}:
+ *  read-side robustness against a stored `{type:'file', path:''}` row — which
+ *  would otherwise render a malformed `(vault: )` pointer line — justifies the
+ *  small divergence from byte-for-byte gtm parity here; no legitimate write
+ *  path ever produces an empty `path`. */
+declare function isChatAttachmentPart(part: unknown): part is ChatAttachmentPart;
+/** Drop absent/empty optional fields rather than persisting `undefined`/`''`
+ *  — keeps stored parts minimal. */
+declare function attachmentInputToPart(input: ChatAttachmentInput): ChatAttachmentPart;
+/** Every attachment part on one message's stored `parts`, in stored order. */
+declare function attachmentPartsFromMessageParts(parts: ReadonlyArray<Record<string, unknown>> | null | undefined): ChatAttachmentPart[];
+/** gtm's exact default header for {@link buildAttachmentPromptBlock} — kept
+ *  byte-identical because it feeds dispatched prompts (gtm-agent#618
+ *  reproduces the prompt bytes through this module). Override only with intent. */
+declare const DEFAULT_ATTACHMENT_PROMPT_HEADER = "Attached files (already saved to the workspace vault \u2014 read them from these paths):";
+/**
+ * The agent-facing pointer block appended to the dispatched prompt — never
+ * persisted in `message.content`. Empty array → `''` so callers can append
+ * unconditionally. The sole producer of this text: both the current turn's
+ * dispatch and history projection ({@link historyContentWithAttachments}) build
+ * it from here, so the two can never drift. `header` overrides the first line
+ * ({@link DEFAULT_ATTACHMENT_PROMPT_HEADER}); the per-file line format is fixed.
+ *
+ * Every interpolated `name`/`path` is swept for control characters first
+ * (newline/carriage-return/tab included) and each one replaced with a single
+ * space — a single-line-per-file guarantee. Without it, a control character
+ * riding through on a PERSISTED row (`historyContentWithAttachments` reads
+ * whatever is already stored; a legacy or hand-edited row was never re-checked
+ * against `resolveChatAttachments`) could inject extra lines — fabricated
+ * pointer entries or instructions — into a prompt the agent trusts verbatim.
+ * The wire-side validator is the primary control; this is the backstop for
+ * rows it never saw.
+ */
+declare function buildAttachmentPromptBlock(atts: ReadonlyArray<Pick<ChatAttachmentPart, 'name' | 'path'>>, header?: string): string;
+/**
+ * History projection for a persisted message: `content` unchanged when it
+ * carries no attachment parts, else the block is appended once. The
+ * no-double-annotation guarantee holds under the invariant that the block is
+ * never persisted INTO `message.content` — it is appended only at read time,
+ * by this function and the current turn's dispatch, both sourcing from
+ * `attachmentPartsFromMessageParts` — never by content inspection. This
+ * function does not (and cannot) detect an already-embedded block by scanning
+ * `content` for its text: a message whose stored `content` happens to already
+ * contain the block's bytes, alongside attachment parts, still gets the block
+ * appended a second time. See the pinned test for that boundary.
+ */
+declare function historyContentWithAttachments(message: {
+    content: string;
+    parts?: ReadonlyArray<Record<string, unknown>> | null;
+}, header?: string): string;
 
-export { type ChatTurnRequestPayload as A, type ChatTurnPartInput as B, type ChatFilePart as C, type ChatTurnFilePartInput as D, ChatTurnInputError as E, type FileMention as F, type ChatTurnTextPartInput as G, type FileMentionsToPartsOptions as H, INLINE_PARTS_MAX_BYTES as I, type SandboxMentionPathCheck as J, assertPromptPartsWithinCap as K, buildMentionPromptBlock as L, MENTION_MAX_COUNT as M, chatTurnRequestInit as N, fileMentionsToParts as O, mediaTypeForMentionPath as P, mentionKindForPath as Q, parseChatTurnParts as R, type StorableHarnessPartKind as S, parseFileMentions as T, promptPartsByteSize as U, validateSandboxMentionPath as V, type ChatImagePart as a, type ChatInteractionPart as b, type ChatMentionKind as c, type ChatMentionPart as d, type ChatMessagePart as e, type ChatNoticePart as f, type ChatPartTime as g, type ChatPlanPart as h, type ChatReasoningPart as i, type ChatStepFinishPart as j, type ChatStepStartPart as k, type ChatSubtaskPart as l, type ChatTextPart as m, type ChatToolPart as n, type ChatToolState as o, type ChatToolStatus as p, type ChatUsageTokens as q, isChatInteractionPart as r, isChatMentionPart as s, isChatPlanPart as t, isChatStepFinishPart as u, isChatTextPart as v, isChatToolPart as w, mentionInputToPart as x, mentionPartsFromMessageParts as y, toChatMessageParts as z };
+export { base64WireLen as $, isChatMentionPart as A, isChatPlanPart as B, type ChatAttachmentKind as C, DEFAULT_ATTACHMENT_PROMPT_HEADER as D, isChatStepFinishPart as E, isChatTextPart as F, isChatToolPart as G, mentionInputToPart as H, mentionPartsFromMessageParts as I, toChatMessageParts as J, type FileMention as K, type ChatTurnRequestPayload as L, type ChatTurnPartInput as M, type ChatTurnFilePartInput as N, type ChatAttachmentInput as O, ChatTurnInputError as P, type ChatTurnTextPartInput as Q, DISPATCH_MAX_MEDIA_PARTS as R, type StorableHarnessPartKind as S, DISPATCH_MAX_PARTS as T, DISPATCH_REQUEST_MAX_BYTES as U, DISPATCH_STRUCTURAL_RESERVE_BYTES as V, type FileMentionsToPartsOptions as W, INLINE_PARTS_MAX_BYTES as X, MENTION_MAX_COUNT as Y, type SandboxMentionPathCheck as Z, assertPromptPartsWithinCap as _, type ChatAttachmentPart as a, buildMentionPromptBlock as a0, chatTurnRequestInit as a1, fileMentionsToParts as a2, formatBytes as a3, mediaTypeForMentionPath as a4, mentionKindForPath as a5, parseChatTurnParts as a6, parseFileMentions as a7, promptPartsByteSize as a8, validateSandboxMentionPath as a9, type ChatFilePart as b, type ChatImagePart as c, type ChatInteractionPart as d, type ChatMentionKind as e, type ChatMentionPart as f, type ChatMessagePart as g, type ChatNoticePart as h, type ChatPartTime as i, type ChatPlanPart as j, type ChatReasoningPart as k, type ChatStepFinishPart as l, type ChatStepStartPart as m, type ChatSubtaskPart as n, type ChatTextPart as o, type ChatToolPart as p, type ChatToolState as q, type ChatToolStatus as r, type ChatUsageTokens as s, attachmentInputToPart as t, attachmentKindForMime as u, attachmentPartsFromMessageParts as v, buildAttachmentPromptBlock as w, historyContentWithAttachments as x, isChatAttachmentPart as y, isChatInteractionPart as z };

package/dist/sandbox/index.d.ts

@@ -1,4 +1,4 @@
-import { AgentProfileMcpServer, ProvisionEvent, SandboxInstance, AgentProfileFileMount, AgentProfile, StorageConfig, ScopedTokenScope, TurnDriveResult, Sandbox } from '@tangle-network/sandbox';
+import { SandboxInstance, AgentProfileMcpServer, ProvisionEvent, AgentProfileFileMount, AgentProfile, StorageConfig, ScopedTokenScope, TurnDriveResult, Sandbox } from '@tangle-network/sandbox';
 export { StorageConfig } from '@tangle-network/sandbox';
 import { a as ToolHeaderNames } from '../auth-DuptSkWh.js';
 import { f as AppToolName, c as AppToolContext } from '../types-BEOvc_ue.js';

package/dist/stream/index.d.ts

@@ -1,52 +1,9 @@
-import { b as ChatInteractionStatus } from '../contract-KfqJh_au.js';
+import { J as JsonRecord } from '../stream-normalizer-DWvtmY6F.js';
+export { M as MISSING_TOOL_TERMINAL_ERROR, a as MISSING_TOOL_TERMINAL_REASON, S as StreamEvent, b as asRecord, c as asString, d as attachmentPartKey, e as collapseRedundantTextParts, f as encodeEvent, g as finalizeAssistantParts, h as finalizePendingInteractionParts, i as getPartKey, m as mergePersistedPart, n as normalizePersistedPart, j as normalizeTime, k as normalizeToolEvent, r as resolveToolId, l as resolveToolName, t as terminalizeDanglingAssistantToolUpdates, o as terminalizeDanglingToolPart, p as terminalizeDanglingToolParts } from '../stream-normalizer-DWvtmY6F.js';
 export { B as BufferedTurnEvent, a as BufferedTurnOptions, b as BufferedTurnTap, D as D1LikeForTurns, P as PumpBufferedTurnOptions, R as ReplayTurnEventsOptions, T as TURN_EVENTS_MIGRATION_SQL, c as TURN_STATUS_SCOPE_MIGRATION_SQL, d as TurnEventStore, e as TurnStatus, f as coalesceChatStreamEvents, g as coalesceDeltas, h as createBufferedTurnTap, i as createD1TurnEventStore, j as createMemoryTurnEventStore, p as pumpBufferedTurn, r as replayTurnEvents } from '../turn-buffer-C9mEgoop.js';
+import '../contract-KfqJh_au.js';
 import '@tangle-network/agent-interface';
 
-type JsonRecord = Record<string, unknown>;
-interface StreamEvent {
-    type: string;
-    data?: JsonRecord;
-}
-declare function asRecord(value: unknown): JsonRecord | undefined;
-declare function asString(value: unknown): string | undefined;
-declare function resolveToolId(part: JsonRecord): string;
-declare function resolveToolName(part: JsonRecord): string;
-declare function normalizeTime(value: unknown): JsonRecord | undefined;
-declare function normalizeToolEvent(event: StreamEvent): StreamEvent;
-declare function normalizePersistedPart(rawPart: JsonRecord): JsonRecord | null;
-/** Stream/transcript part key for a promoted (path-bearing) attachment,
- *  keyed on its storage path — re-emitting the same path folds into the same
- *  segment instead of duplicating it. */
-declare function attachmentPartKey(path: string): string;
-declare function getPartKey(part: JsonRecord): string;
-declare function mergePersistedPart(existing: JsonRecord | undefined, incoming: JsonRecord, delta?: string): JsonRecord;
-declare const MISSING_TOOL_TERMINAL_ERROR = "Tool did not report a terminal result before the assistant turn completed.";
-declare const MISSING_TOOL_TERMINAL_REASON = "missing-tool-terminal";
-/** Closes a tool part left `running` when a stream ended abnormally: settles
- *  it as a terminal `error` and stamps `state.metadata.terminalized` so the
- *  synthetic settlement is distinguishable from a real tool failure. Parts
- *  that already settled (and non-tool parts) pass through untouched. */
-declare function terminalizeDanglingToolPart(part: JsonRecord): JsonRecord;
-declare function terminalizeDanglingToolParts(parts: JsonRecord[]): JsonRecord[];
-/** Settles still-pending interaction parts at persist time. The broker
- *  guarantees a resolved question either answered (run unblocked, no cancel
- *  event) or cancelled/timed out (cancel event already updated the part), so
- *  the success path finalizes remaining pendings as `answered` and the
- *  failure/terminalize paths as `expired`. */
-declare function finalizePendingInteractionParts(parts: JsonRecord[], outcome: Extract<ChatInteractionStatus, 'answered' | 'expired'>): JsonRecord[];
-/** Collapses text-part artifacts of unstable upstream segment identity: the
- *  same text arriving under two keys (id-less delta stream, then an
- *  id-bearing snapshot) folds into two segments, and interleaved empty
- *  segments survive as blank parts. Consecutive identical text parts merge
- *  into one; empty text parts drop when any non-empty text part exists. */
-declare function collapseRedundantTextParts(parts: JsonRecord[]): JsonRecord[];
-declare function finalizeAssistantParts(partOrder: string[], partMap: Map<string, JsonRecord>, finalText: string): JsonRecord[];
-/** Finalizes, then folds each synthetic tool settlement back into `partMap`
- *  and returns just those updates — the shape a streaming loop needs to emit
- *  closing `message.part.updated` frames for tools the stream never settled. */
-declare function terminalizeDanglingAssistantToolUpdates(partOrder: string[], partMap: Map<string, JsonRecord>, finalText: string): JsonRecord[];
-declare function encodeEvent(encoder: TextEncoder, event: StreamEvent): Uint8Array;
-
 interface PersistedChatMessageForTurn {
     id: string;
     role: 'user' | 'assistant' | 'system' | 'tool';
@@ -68,4 +25,4 @@ declare function resolveChatTurn(input: {
     turnId?: string;
 }): ResolvedChatTurn;
 
-export { type JsonRecord, MISSING_TOOL_TERMINAL_ERROR, MISSING_TOOL_TERMINAL_REASON, type PersistedChatMessageForTurn, type ResolvedChatTurn, type StreamEvent, asRecord, asString, attachmentPartKey, buildUserTextParts, collapseRedundantTextParts, encodeEvent, finalizeAssistantParts, finalizePendingInteractionParts, getPartKey, mergePersistedPart, messageHasTurnId, normalizeClientTurnId, normalizePersistedPart, normalizeTime, normalizeToolEvent, resolveChatTurn, resolveToolId, resolveToolName, terminalizeDanglingAssistantToolUpdates, terminalizeDanglingToolPart, terminalizeDanglingToolParts };
+export { JsonRecord, type PersistedChatMessageForTurn, type ResolvedChatTurn, buildUserTextParts, messageHasTurnId, normalizeClientTurnId, resolveChatTurn };

package/dist/stream/index.js

@@ -1,37 +1,39 @@
 import {
-  MISSING_TOOL_TERMINAL_ERROR,
-  MISSING_TOOL_TERMINAL_REASON,
   TURN_EVENTS_MIGRATION_SQL,
   TURN_STATUS_SCOPE_MIGRATION_SQL,
-  asRecord,
-  asString,
-  attachmentPartKey,
   buildUserTextParts,
   coalesceChatStreamEvents,
   coalesceDeltas,
-  collapseRedundantTextParts,
   createBufferedTurnTap,
   createD1TurnEventStore,
   createMemoryTurnEventStore,
+  messageHasTurnId,
+  normalizeClientTurnId,
+  pumpBufferedTurn,
+  replayTurnEvents,
+  resolveChatTurn
+} from "../chunk-23LUHHHN.js";
+import {
+  MISSING_TOOL_TERMINAL_ERROR,
+  MISSING_TOOL_TERMINAL_REASON,
+  asRecord,
+  asString,
+  attachmentPartKey,
+  collapseRedundantTextParts,
   encodeEvent,
   finalizeAssistantParts,
   finalizePendingInteractionParts,
   getPartKey,
   mergePersistedPart,
-  messageHasTurnId,
-  normalizeClientTurnId,
   normalizePersistedPart,
   normalizeTime,
   normalizeToolEvent,
-  pumpBufferedTurn,
-  replayTurnEvents,
-  resolveChatTurn,
   resolveToolId,
   resolveToolName,
   terminalizeDanglingAssistantToolUpdates,
   terminalizeDanglingToolPart,
   terminalizeDanglingToolParts
-} from "../chunk-4AUQIAYU.js";
+} from "../chunk-5MG74GVQ.js";
 import "../chunk-XAWFPMAR.js";
 import "../chunk-SIXYZ2FB.js";
 export {

package/dist/stream-normalizer-DWvtmY6F.d.ts

@@ -0,0 +1,48 @@
+import { b as ChatInteractionStatus } from './contract-KfqJh_au.js';
+
+type JsonRecord = Record<string, unknown>;
+interface StreamEvent {
+    type: string;
+    data?: JsonRecord;
+}
+declare function asRecord(value: unknown): JsonRecord | undefined;
+declare function asString(value: unknown): string | undefined;
+declare function resolveToolId(part: JsonRecord): string;
+declare function resolveToolName(part: JsonRecord): string;
+declare function normalizeTime(value: unknown): JsonRecord | undefined;
+declare function normalizeToolEvent(event: StreamEvent): StreamEvent;
+declare function normalizePersistedPart(rawPart: JsonRecord): JsonRecord | null;
+/** Stream/transcript part key for a promoted (path-bearing) attachment,
+ *  keyed on its storage path — re-emitting the same path folds into the same
+ *  segment instead of duplicating it. */
+declare function attachmentPartKey(path: string): string;
+declare function getPartKey(part: JsonRecord): string;
+declare function mergePersistedPart(existing: JsonRecord | undefined, incoming: JsonRecord, delta?: string): JsonRecord;
+declare const MISSING_TOOL_TERMINAL_ERROR = "Tool did not report a terminal result before the assistant turn completed.";
+declare const MISSING_TOOL_TERMINAL_REASON = "missing-tool-terminal";
+/** Closes a tool part left `running` when a stream ended abnormally: settles
+ *  it as a terminal `error` and stamps `state.metadata.terminalized` so the
+ *  synthetic settlement is distinguishable from a real tool failure. Parts
+ *  that already settled (and non-tool parts) pass through untouched. */
+declare function terminalizeDanglingToolPart(part: JsonRecord): JsonRecord;
+declare function terminalizeDanglingToolParts(parts: JsonRecord[]): JsonRecord[];
+/** Settles still-pending interaction parts at persist time. The broker
+ *  guarantees a resolved question either answered (run unblocked, no cancel
+ *  event) or cancelled/timed out (cancel event already updated the part), so
+ *  the success path finalizes remaining pendings as `answered` and the
+ *  failure/terminalize paths as `expired`. */
+declare function finalizePendingInteractionParts(parts: JsonRecord[], outcome: Extract<ChatInteractionStatus, 'answered' | 'expired'>): JsonRecord[];
+/** Collapses text-part artifacts of unstable upstream segment identity: the
+ *  same text arriving under two keys (id-less delta stream, then an
+ *  id-bearing snapshot) folds into two segments, and interleaved empty
+ *  segments survive as blank parts. Consecutive identical text parts merge
+ *  into one; empty text parts drop when any non-empty text part exists. */
+declare function collapseRedundantTextParts(parts: JsonRecord[]): JsonRecord[];
+declare function finalizeAssistantParts(partOrder: string[], partMap: Map<string, JsonRecord>, finalText: string): JsonRecord[];
+/** Finalizes, then folds each synthetic tool settlement back into `partMap`
+ *  and returns just those updates — the shape a streaming loop needs to emit
+ *  closing `message.part.updated` frames for tools the stream never settled. */
+declare function terminalizeDanglingAssistantToolUpdates(partOrder: string[], partMap: Map<string, JsonRecord>, finalText: string): JsonRecord[];
+declare function encodeEvent(encoder: TextEncoder, event: StreamEvent): Uint8Array;
+
+export { type JsonRecord as J, MISSING_TOOL_TERMINAL_ERROR as M, type StreamEvent as S, MISSING_TOOL_TERMINAL_REASON as a, asRecord as b, asString as c, attachmentPartKey as d, collapseRedundantTextParts as e, encodeEvent as f, finalizeAssistantParts as g, finalizePendingInteractionParts as h, getPartKey as i, normalizeTime as j, normalizeToolEvent as k, resolveToolName as l, mergePersistedPart as m, normalizePersistedPart as n, terminalizeDanglingToolPart as o, terminalizeDanglingToolParts as p, resolveToolId as r, terminalizeDanglingAssistantToolUpdates as t };

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

@@ -5,14 +5,15 @@ 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 { F as FileMention, d as ChatMentionPart } from '../parts-1_3y2JmR.js';
-export { c as ChatMentionKind, D as ChatTurnFilePartInput, B as ChatTurnPartInput, A as ChatTurnRequestPayload, L as buildMentionPromptBlock, N as chatTurnRequestInit, O as fileMentionsToParts, P as mediaTypeForMentionPath, x as mentionInputToPart, Q as mentionKindForPath, y as mentionPartsFromMessageParts } from '../parts-1_3y2JmR.js';
+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 { 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-Bn6sitKb.js';
+export { b as FileIndexReadyResponse, c as FileIndexResponse, d as FileIndexWarmingResponse } from '../file-index-b26ee-_R.js';
+export { d as attachmentPartKey } from '../stream-normalizer-DWvtmY6F.js';
 
 type DurablePlanDecision = 'approved' | 'rejected';
 /** Stable authority receipt for the follow-up turn dispatched by a plan

package/dist/web-react/index.js

@@ -68,7 +68,7 @@ import {
   useSmoothText,
   useThinkingSeconds,
   waterfallLayout
-} from "../chunk-7VMUOD3G.js";
+} from "../chunk-PHIXZC6Y.js";
 import {
   tabTerminalConnectionId,
   useSandboxTerminalConnection
@@ -76,14 +76,26 @@ import {
 import "../chunk-LCNY3DCM.js";
 import "../chunk-2QI7XV2T.js";
 import {
+  DISPATCH_MAX_MEDIA_PARTS,
+  DISPATCH_MAX_PARTS,
+  DISPATCH_REQUEST_MAX_BYTES,
+  DISPATCH_STRUCTURAL_RESERVE_BYTES,
+  attachmentInputToPart,
+  attachmentKindForMime,
+  attachmentPartsFromMessageParts,
+  base64WireLen,
   buildMentionPromptBlock,
   chatTurnRequestInit,
   fileMentionsToParts,
+  isChatAttachmentPart,
   mediaTypeForMentionPath,
   mentionInputToPart,
   mentionKindForPath,
   mentionPartsFromMessageParts
-} from "../chunk-6E2XJSCT.js";
+} from "../chunk-JGYOYY5D.js";
+import {
+  attachmentPartKey
+} from "../chunk-5MG74GVQ.js";
 import {
   INTERACTION_CANCEL_EVENT,
   INTERACTION_EVENT,
@@ -120,6 +132,10 @@ export {
   DEFAULT_EFFORT_LEVELS,
   DEFAULT_MENTION_EMPTY_TEXT,
   DEFAULT_MENTION_LIMIT,
+  DISPATCH_MAX_MEDIA_PARTS,
+  DISPATCH_MAX_PARTS,
+  DISPATCH_REQUEST_MAX_BYTES,
+  DISPATCH_STRUCTURAL_RESERVE_BYTES,
   DurableChatCards,
   DurablePlanCard,
   DurablePlanClientError,
@@ -142,6 +158,11 @@ export {
   RunDrillIn,
   SeatPaywall,
   activityTone,
+  attachmentInputToPart,
+  attachmentKindForMime,
+  attachmentPartKey,
+  attachmentPartsFromMessageParts,
+  base64WireLen,
   buildAnswerData,
   buildMentionPromptBlock,
   canTransitionInteractionStatus,
@@ -175,6 +196,7 @@ export {
   interactionSubmissionSignature,
   interactionTerminalNotes,
   interactionToPersistedPart,
+  isChatAttachmentPart,
   isLateAnswerableStatus,
   isRenderableInteractionKind,
   isSafeInteractionFieldKey,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@tangle-network/agent-app",
-  "version": "0.43.47",
+  "version": "0.43.48",
   "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": [