@tangle-network/agent-app 0.43.55 → 0.43.57

package/dist/chat-routes/index.d.ts

@@ -1,21 +1,21 @@
-import { L as ChatTurnRequestPayload, M as ChatTurnPartInput, g as ChatMessagePart, N as ChatTurnFilePartInput, a as ChatAttachmentPart, C as ChatAttachmentKind, f as ChatMentionPart } from '../parts-1sRYSPjF.js';
-export { O as ChatAttachmentInput, e as ChatMentionKind, P as ChatTurnInputError, Q as ChatTurnTextPartInput, R as DISPATCH_MAX_MEDIA_PARTS, T as DISPATCH_MAX_PARTS, U as DISPATCH_REQUEST_MAX_BYTES, V as DISPATCH_STRUCTURAL_RESERVE_BYTES, K as FileMention, W as FileMentionsToPartsOptions, X as INLINE_PARTS_MAX_BYTES, Y as MENTION_MAX_COUNT, Z as ProducerErrorEvent, _ as ProducerNoticeEvent, $ as ProducerPassthroughEvent, a0 as ProducerPassthroughEventType, a1 as ProducerReasoningEvent, a2 as ProducerTextEvent, a3 as ProducerToolCallEvent, a4 as ProducerToolResultEvent, a5 as ProducerUsageEvent, a6 as ProducerWireEvent, a7 as SandboxMentionPathCheck, a8 as assertPromptPartsWithinCap, a9 as base64WireLen, aa as buildMentionPromptBlock, ab as chatTurnRequestInit, ac as fileMentionsToParts, ad as formatBytes, ae as mediaTypeForMentionPath, af as mentionKindForPath, ag as parseChatTurnParts, ah as parseFileMentions, ai as promptPartsByteSize, aj as validateSandboxMentionPath } from '../parts-1sRYSPjF.js';
-export { A as ALLOWED_ATTACHMENT_SNIFFED_MIMES, a as ATTACHMENT_ACCEPT, b as ATTACHMENT_MAX_COUNT, c as AttachmentTypeCheckResult, C as CreateSandboxFileIndexRouteOptions, F as FileIndexAuthorization, d as FileIndexCache, e as FileIndexReadyResponse, f as FileIndexResponse, g as FileIndexWarmingResponse, M as MAX_ATTACHMENT_TOTAL_BYTES, h as MAX_BINARY_ATTACHMENT_BYTES, i as MAX_TEXT_ATTACHMENT_BYTES, S as SandboxFileTreeSource, j as SandboxTreeFile, k as SandboxTreeResult, l as SniffResult, m as attachmentSizeErrorMessage, n as attachmentTotalSizeErrorMessage, o as checkAttachmentType, p as createSandboxFileIndexRoute, s as sanitizeAttachmentFileName, q as sniffBinary } from '../attachment-validation-D0csjCvz.js';
+import { L as ChatTurnRequestPayload, M as ChatTurnPartInput, g as ChatMessagePart, N as ChatTurnFilePartInput, a as ChatAttachmentPart, C as ChatAttachmentKind, f as ChatMentionPart } from '../parts-n9XUon0a.js';
+export { O as ChatAttachmentInput, e as ChatMentionKind, P as ChatTurnInputError, Q as ChatTurnTextPartInput, R as DISPATCH_MAX_MEDIA_PARTS, T as DISPATCH_MAX_PARTS, U as DISPATCH_REQUEST_MAX_BYTES, V as DISPATCH_STRUCTURAL_RESERVE_BYTES, K as FileMention, W as FileMentionsToPartsOptions, X as INLINE_PARTS_MAX_BYTES, Y as MENTION_MAX_COUNT, Z as ProducerErrorEvent, _ as ProducerNoticeEvent, $ as ProducerPassthroughEvent, a0 as ProducerPassthroughEventType, a1 as ProducerReasoningEvent, a2 as ProducerTextEvent, a3 as ProducerToolCallEvent, a4 as ProducerToolResultEvent, a5 as ProducerUsageEvent, a6 as ProducerWireEvent, a7 as SandboxMentionPathCheck, a8 as assertPromptPartsWithinCap, a9 as base64WireLen, aa as buildMentionPromptBlock, ab as chatTurnRequestInit, ac as fileMentionsToParts, ad as formatBytes, ae as mediaTypeForMentionPath, af as mentionKindForPath, ag as parseChatTurnParts, ah as parseFileMentions, ai as promptPartsByteSize, aj as validateSandboxMentionPath } from '../parts-n9XUon0a.js';
+export { A as ALLOWED_ATTACHMENT_SNIFFED_MIMES, a as ATTACHMENT_ACCEPT, b as ATTACHMENT_MAX_COUNT, c as AttachmentTypeCheckResult, C as CreateSandboxFileIndexRouteOptions, F as FileIndexAuthorization, d as FileIndexCache, e as FileIndexReadyResponse, f as FileIndexResponse, g as FileIndexWarmingResponse, M as MAX_ATTACHMENT_TOTAL_BYTES, h as MAX_BINARY_ATTACHMENT_BYTES, i as MAX_TEXT_ATTACHMENT_BYTES, S as SandboxFileTreeSource, j as SandboxTreeFile, k as SandboxTreeResult, l as SniffResult, m as attachmentSizeErrorMessage, n as attachmentTotalSizeErrorMessage, o as checkAttachmentType, p as createSandboxFileIndexRoute, s as sanitizeAttachmentFileName, q as sniffBinary } from '../attachment-validation-tPRp-PP1.js';
 import { ChatTurnIdentity, ChatTurnProducer } from '@tangle-network/agent-runtime';
 import { InteractionAnswerRoute, InteractionAnswerRouteOptions } from '../interactions/index.js';
 import { PersistedChatMessageForTurn } from '../stream/index.js';
-import { d as TurnEventStore } from '../turn-buffer-C9mEgoop.js';
-export { D as DEFAULT_STALE_TURN_LOCK_GRACE_MS, a as DEFAULT_TERMINAL_TURN_LOCK_GRACE_MS, R as ReconcileStaleTurnLockOptions, b as ReconcileStaleTurnLockResult, S as StaleTurnLockSandboxProbeResult, c as StaleTurnLockSessionProbeResult, r as reconcileStaleTurnLock } from '../stale-turn-lock-C8Na1cFZ.js';
-import { J as JsonRecord } from '../stream-normalizer-DWvtmY6F.js';
+import { d as TurnEventStore } from '../turn-buffer-DGnAPKwa.js';
+export { D as DEFAULT_STALE_TURN_LOCK_GRACE_MS, a as DEFAULT_TERMINAL_TURN_LOCK_GRACE_MS, R as ReconcileStaleTurnLockOptions, b as ReconcileStaleTurnLockResult, S as StaleTurnLockSandboxProbeResult, c as StaleTurnLockSessionProbeResult, r as reconcileStaleTurnLock } from '../stale-turn-lock-DucQzvXu.js';
+import { J as JsonRecord } from '../stream-normalizer-C3M--r6y.js';
 import { SandboxExecChannel, PromptInputPart } from '../sandbox/index.js';
 import '@tangle-network/agent-interface';
-import '../contract-KfqJh_au.js';
+import '../contract-TjB68uqA.js';
 import '../plans/index.js';
 import '@tangle-network/sandbox';
-import '../auth-DuptSkWh.js';
-import '../types-BEOvc_ue.js';
+import '../auth-_FU8w01b.js';
+import '../types-CBRyqijY.js';
 import '../harness/index.js';
-import '../model-dF2h4xT9.js';
+import '../model-DmdkIteM.js';
 
 /**
  * `createChatTurnRoutes` — the assembled server chat vertical (issue #188
@@ -101,6 +101,7 @@ interface ChatTurnRouteProducer extends ChatTurnProducer {
     usage?(): ChatTurnUsage;
     model?: string;
 }
+/** Resolve authorization status and context for a chat turn including tenant and user identification */
 type ChatTurnAuthorization<TContext> = {
     ok: true;
     tenantId: string;
@@ -118,6 +119,7 @@ type ChatTurnAuthorization<TContext> = {
     ok: false;
     response: Response;
 };
+/** Define arguments required to authorize a chat turn based on intent and request details */
 interface ChatTurnAuthorizeArgs {
     request: Request;
     intent: 'turn' | 'replay' | 'running';
@@ -128,6 +130,7 @@ interface ChatTurnAuthorizeArgs {
     /** The thread whose running turns are being discovered (running intent only). */
     threadId?: string;
 }
+/** Define the arguments required to produce a chat turn with context and messaging details */
 interface ChatTurnProduceArgs<TContext> {
     request: Request;
     body: ChatTurnRequestPayload;
@@ -199,14 +202,17 @@ interface ChatTurnLifecycleBase<TContext> {
     turnStreamId: string;
     context: TContext;
 }
+/** Define lifecycle start event with context and timestamp for a chat turn */
 interface ChatTurnLifecycleStart<TContext> extends ChatTurnLifecycleBase<TContext> {
     startedAt: number;
 }
+/** Define the structure representing the completion state of a chat turn lifecycle with usage data */
 interface ChatTurnLifecycleComplete<TContext> extends ChatTurnLifecycleBase<TContext> {
     finalText: string;
     usage: ChatTurnUsage;
     durationMs: number;
 }
+/** Represent an error occurring during a chat turn lifecycle with context and duration information */
 interface ChatTurnLifecycleError<TContext> extends ChatTurnLifecycleBase<TContext> {
     error: unknown;
     durationMs: number;
@@ -222,6 +228,7 @@ interface ChatTurnLifecycle<TContext> {
     onTurnComplete?(info: ChatTurnLifecycleComplete<TContext>): void | Promise<void>;
     onTurnError?(info: ChatTurnLifecycleError<TContext>): void | Promise<void>;
 }
+/** Define options to configure chat turn routes including authorization, storage, and event buffering */
 interface CreateChatTurnRoutesOptions<TContext = void> {
     /** Names the product in `deriveExecutionId` so retries land on the same
      *  substrate execution. */
@@ -307,6 +314,7 @@ interface CreateChatTurnRoutesOptions<TContext = void> {
     };
     log?: (message: string, meta?: Record<string, unknown>) => void;
 }
+/** Define routes to run, replay, and list running chat turns with streaming and reconnect support */
 interface ChatTurnRoutes {
     /** POST — run one turn, streaming NDJSON. First line is
      *  `{type:'turn', turnId}` (the replay handle); the rest is the engine's
@@ -328,6 +336,7 @@ interface ChatTurnRoutes {
     /** list/answer endpoints from `/interactions`; null when not configured. */
     interactions: InteractionAnswerRoute | null;
 }
+/** Build chat turn routes to handle and validate incoming chat requests with optional logging */
 declare function createChatTurnRoutes<TContext = void>(options: CreateChatTurnRoutesOptions<TContext>): ChatTurnRoutes;
 
 /**
@@ -370,6 +379,7 @@ type FilePartPromotionOutcome = {
     part?: Record<string, unknown>;
     key?: string;
 };
+/** Define options for producing sandbox chat events with rendering and interaction controls */
 interface SandboxChatProducerOptions {
     /** The raw sandbox event stream (e.g. `streamSandboxPrompt(...)`). */
     events: AsyncIterable<unknown>;
@@ -415,6 +425,7 @@ interface SandboxChatProducerOptions {
     promoteFilePart?: (raw: JsonRecord) => Promise<FilePartPromotionOutcome>;
     log?: (message: string, meta?: Record<string, unknown>) => void;
 }
+/** Create a sandbox chat producer that manages chat turn routing with logging and interaction rendering options */
 declare function createSandboxChatProducer(options: SandboxChatProducerOptions): ChatTurnRouteProducer;
 
 /**
@@ -457,6 +468,7 @@ interface DetachedTurnFinal {
      *  a usage receipt. */
     parts?: DetachedTurnParts;
 }
+/** Define options for managing and projecting a detached turn event stream in a session */
 interface DetachedTurnOptions {
     store: TurnEventStore;
     turnId: string;
@@ -498,6 +510,7 @@ interface DetachedTurnOptions {
     resetBuffer?: (turnId: string) => Promise<void>;
     log?: (message: string, meta?: Record<string, unknown>) => void;
 }
+/** Describe the result of a detached turn including state, text, parts, usage, and optional error or cache flag */
 interface DetachedTurnResult {
     /** `completed` — clean drain: persist + bill. `failed` — a terminal error
      *  event, including the producer's structured `sandbox.stream_failed` event
@@ -529,10 +542,12 @@ interface DetachedTurnResult {
  */
 declare function runDetachedTurn(opts: DetachedTurnOptions): Promise<DetachedTurnResult>;
 
+/** Resolve chat route events and materialize their durable state records */
 interface ChatRouteDurableProjection {
     observe(event: unknown): void | Promise<void>;
     materialize(): Array<Record<string, unknown>> | Promise<Array<Record<string, unknown>>>;
 }
+/** Log chat route projection messages with optional metadata for durable processing */
 type ChatRouteDurableProjectionLogger = (message: string, meta?: Record<string, unknown>) => void;
 /** Adds durable lifecycle projection to any producer lane without moving its
  * transport into agent-app. The projection is observed inline and its
@@ -582,6 +597,7 @@ interface SandboxUploadSink {
         encoding?: 'utf8' | 'base64';
     }): Promise<unknown>;
 }
+/** Resolve upload authorization status and provide upload destination or error response */
 type UploadAuthorization = {
     ok: true;
     /** Where large files land. Absent/null: only inline uploads are
@@ -593,6 +609,7 @@ type UploadAuthorization = {
     ok: false;
     response: Response;
 };
+/** Define options to authorize uploads and configure file size limits and upload directory */
 interface CreateUploadRouteOptions {
     /** Authenticate the caller and resolve the sandbox file sink (usually
      *  `ensureWorkspaceSandbox(...)` → `box.fs`). */
@@ -619,7 +636,9 @@ interface UploadedChatFile {
 }
 /** Path-safe file name: basename only, conservative charset, length-capped. */
 declare function sanitizeUploadFilename(name: string): string;
+/** Convert a Uint8Array of bytes into a base64-encoded string */
 declare function bytesToBase64(bytes: Uint8Array): string;
+/** Create an upload route handler that authorizes requests and processes file uploads with size limits */
 declare function createUploadRoute(options: CreateUploadRouteOptions): (request: Request) => Promise<Response>;
 
 /**
@@ -725,6 +744,7 @@ type WriteAttachmentFn = (scopeId: string, path: string, content: Uint8Array | s
  * behavior-identical for gtm-agent#618 adoption.
  */
 
+/** Resolve the result of chat attachment processing with success status and corresponding data or error */
 type ResolveChatAttachmentsResult = {
     succeeded: true;
     value: ChatAttachmentPart[];
@@ -757,6 +777,7 @@ type AttachmentPathCheck = {
  * this default entirely.
  */
 declare function defaultValidateAttachmentPath(path: string): AttachmentPathCheck;
+/** Define options to resolve and validate chat attachments with size, count, and path constraints */
 interface ResolveChatAttachmentsOptions {
     /** The product's workspace/tenant key, passed to `readAttachment`. */
     scopeId: string;
@@ -818,6 +839,7 @@ type AttachmentUploadAuthorization = {
     ok: false;
     response: Response;
 };
+/** Define options to authorize, write, and limit attachment uploads in a route */
 interface CreateAttachmentUploadRouteOptions {
     /** Authenticate the caller, rate-limit, and resolve the store scope
      *  (workspace/tenant id) — never a query param. */
@@ -852,6 +874,7 @@ interface CreateAttachmentUploadRouteOptions {
      *  Default {@link sniffMimeFromName}. */
     sniffMime?: (name: string) => string;
 }
+/** Resolve an attachment upload route handler with customizable limits and validation options */
 declare function createAttachmentUploadRoute(options: CreateAttachmentUploadRouteOptions): (request: Request) => Promise<Response>;
 
 /**
@@ -876,6 +899,7 @@ declare function createAttachmentUploadRoute(options: CreateAttachmentUploadRout
  * demotion math and emitted part shapes reproduce its dispatched prompt bytes).
  */
 
+/** Resolve the outcome of dispatching parts with success status and corresponding value or error message */
 type DispatchPartsOutcome = {
     succeeded: true;
     value: PromptInputPart[];
@@ -895,9 +919,11 @@ type SandboxMentionReadOutcome = {
     succeeded: false;
     error: string;
 };
+/** Resolve sandbox mention details by reading from a specified path with optional byte reading */
 type ReadSandboxMentionFn = (box: SandboxExecChannel, absolutePath: string, options: {
     readBytes: boolean;
 }) => Promise<SandboxMentionReadOutcome>;
+/** Build input parameters for dispatching chat message parts including text, attachments, mentions, and history */
 interface BuildDispatchPartsInput {
     text: string;
     attachments: ChatAttachmentPart[];
@@ -939,6 +965,7 @@ interface BuildDispatchPartsInput {
     /** Sidecar per-request parts-array cap. Default {@link DISPATCH_MAX_PARTS}. */
     maxParts?: number;
 }
+/** Build dispatch parts from input by resolving mentions, paths, and applying size constraints asynchronously */
 declare function buildDispatchParts(input: BuildDispatchPartsInput): Promise<DispatchPartsOutcome>;
 
 /**
@@ -964,6 +991,7 @@ declare function buildDispatchParts(input: BuildDispatchPartsInput): Promise<Dis
 
 /** Default ceiling on a promoted file's raw (pre-encoding) byte size. */
 declare const PROMOTE_MAX_FILE_BYTES: number;
+/** Define the structure for a raw file part with optional metadata and media type information */
 interface RawAgentFilePart {
     type: 'file';
     id?: string;
@@ -974,6 +1002,7 @@ interface RawAgentFilePart {
     mime?: string;
     url?: string;
 }
+/** Resolve the result of promoting a file part with success status and relevant data or error details */
 type PromoteFilePartResult = {
     succeeded: true;
     part: ChatAttachmentPart;
@@ -998,6 +1027,7 @@ interface AttachmentPathArgs {
 }
 /** Default MIME hook: extension → mime, or `text/plain` for the unknown. */
 declare function sniffMimeFromName(filename: string): string;
+/** Define options for promoting a part of an agent file within a specific session and scope */
 interface PromoteAgentFilePartOptions {
     raw: RawAgentFilePart;
     /** The turn's box — required only to promote a sandbox-path part; a `data:`
@@ -1018,6 +1048,7 @@ interface PromoteAgentFilePartOptions {
     /** Clock for the date path segment. Default `() => new Date()`. */
     now?: () => Date;
 }
+/** Promote a part of an agent file with optional byte limits and MIME type detection */
 declare function promoteAgentFilePart(options: PromoteAgentFilePartOptions): Promise<PromoteFilePartResult>;
 
 export { type AttachmentPathArgs, type AttachmentPathCheck, type AttachmentReadResult, type AttachmentUploadAuthorization, type AttachmentWriteResult, type BuildDispatchPartsInput, ChatAttachmentKind, type ChatRouteDurableProjection, type ChatRouteDurableProjectionLogger, type ChatTurnAuthorization, type ChatTurnAuthorizeArgs, ChatTurnFilePartInput, type ChatTurnGateResult, type ChatTurnHeartbeat, type ChatTurnInputPatch, type ChatTurnLifecycle, type ChatTurnLifecycleComplete, type ChatTurnLifecycleError, type ChatTurnLifecycleStart, type ChatTurnLock, type ChatTurnLockResult, type ChatTurnMessageStore, ChatTurnPartInput, type ChatTurnProduceArgs, ChatTurnRequestPayload, type ChatTurnRouteProducer, type ChatTurnRoutes, type ChatTurnUsage, type CreateAttachmentUploadRouteOptions, type CreateChatTurnRoutesOptions, type CreateUploadRouteOptions, type DetachedTurnFinal, type DetachedTurnOptions, type DetachedTurnParts, type DetachedTurnResult, type DispatchPartsOutcome, type FilePartPromotionOutcome, PROMOTE_MAX_FILE_BYTES, type PromoteAgentFilePartOptions, type PromoteFilePartResult, PromptInputPart, type RawAgentFilePart, type ReadAttachmentFn, type ReadSandboxMentionFn, type ResolveChatAttachmentsOptions, type ResolveChatAttachmentsResult, type SandboxChatProducerOptions, type SandboxUploadSink, UPLOAD_INLINE_MAX_BYTES, UPLOAD_MAX_FILE_BYTES, type UploadAuthorization, type UploadedChatFile, type WriteAttachmentFn, buildDispatchParts, bytesToBase64, createAttachmentUploadRoute, createChatTurnRoutes, createSandboxChatProducer, createUploadRoute, defaultValidateAttachmentPath, promoteAgentFilePart, resolveChatAttachments, runDetachedTurn, sanitizeUploadFilename, sniffMimeFromName, withDurableChatProjection };

package/dist/chat-routes/index.js

@@ -11,25 +11,25 @@ import {
   createSandboxFileIndexRoute,
   sanitizeAttachmentFileName,
   sniffBinary
-} from "../chunk-K63OWUDJ.js";
+} from "../chunk-BPSV5AA2.js";
 import {
   DEFAULT_STALE_TURN_LOCK_GRACE_MS,
   DEFAULT_TERMINAL_TURN_LOCK_GRACE_MS,
   reconcileStaleTurnLock
-} from "../chunk-BQV42AFK.js";
+} from "../chunk-CCVWR33L.js";
 import {
   parseJsonObjectBody
-} from "../chunk-HFC4BTWJ.js";
+} from "../chunk-PTUMBMVH.js";
 import {
   coalesceDeltas,
   createBufferedTurnTap,
   normalizeClientTurnId,
   replayTurnEvents,
   resolveChatTurn
-} from "../chunk-23LUHHHN.js";
+} from "../chunk-VCOD5AOR.js";
 import {
   createInteractionAnswerRoute
-} from "../chunk-6KVH5SP5.js";
+} from "../chunk-7YW6EBDX.js";
 import {
   ChatTurnInputError,
   DISPATCH_MAX_MEDIA_PARTS,
@@ -54,7 +54,7 @@ import {
   promptPartsByteSize,
   toChatMessageParts,
   validateSandboxMentionPath
-} from "../chunk-XKBIYSSM.js";
+} from "../chunk-DTSPS2HV.js";
 import {
   asRecord,
   asString,
@@ -65,7 +65,7 @@ import {
   normalizePersistedPart,
   normalizeToolEvent,
   terminalizeDanglingAssistantToolUpdates
-} from "../chunk-5MG74GVQ.js";
+} from "../chunk-IG46XCZM.js";
 import {
   cancelStatusFor,
   interactionPartKey,
@@ -75,22 +75,22 @@ import {
   noticePartKey,
   parseInteractionCancel,
   parseInteractionRequest
-} from "../chunk-XAWFPMAR.js";
+} from "../chunk-YKOM4ZLQ.js";
 import {
   parsePlanSubmittedEvent,
   planToPersistedPart
-} from "../chunk-SIXYZ2FB.js";
+} from "../chunk-YJMCRXQQ.js";
 import {
   flattenHistory,
   readSandboxBinaryBytes,
   statSandboxFileSize
-} from "../chunk-HRJJH3RX.js";
-import "../chunk-MCJSS6SM.js";
-import "../chunk-PJC4NXPA.js";
-import "../chunk-7EVZUIHW.js";
+} from "../chunk-3OFQFW5K.js";
+import "../chunk-CQZSAR77.js";
+import "../chunk-YKBDH2UY.js";
+import "../chunk-3EJ6SFJI.js";
 import "../chunk-S5SRJJQG.js";
-import "../chunk-7W5XSTUF.js";
-import "../chunk-MFRCM32T.js";
+import "../chunk-JML7WKWU.js";
+import "../chunk-7CTIUCQ4.js";
 
 // src/chat-routes/turn-routes.ts
 import { deriveExecutionId, handleChatTurn } from "@tangle-network/agent-runtime";