@tangle-network/agent-app 0.43.12 → 0.43.14

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

@@ -1,11 +1,105 @@
 import * as react from 'react';
 import { ReactNode } from 'react';
+import { InteractionField, InteractionRequest, InteractionData } from '@tangle-network/agent-interface';
+export { InteractionData, InteractionOutcome, InteractionRequest } from '@tangle-network/agent-interface';
 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 { C as CatalogModel } from '../model-catalog-BEAEVDaa.js';
 import { Harness } from '../harness/index.js';
-import '@tangle-network/agent-interface';
+
+/** Sidecar → client: the agent raised an ask; data = `{ request }`. */
+declare const INTERACTION_EVENT: "interaction";
+/** Sidecar → client: the ask was withdrawn; data = `{ id, reason? }`. */
+declare const INTERACTION_CANCEL_EVENT: "interaction.cancel";
+/** An ask was answered; data = `{ id, status }`. In the wire contract so a
+ *  server broadcast and a client-local mark share one event name. */
+declare const INTERACTION_RESOLVED_EVENT: "interaction.resolved";
+declare function isRenderableInteractionKind(kind: string): boolean;
+/** Answer/field keys the sidecar will accept: identifier-safe and never a
+ *  prototype-pollution vector. */
+declare function isSafeInteractionFieldKey(key: string): boolean;
+type ChatSelectField = Extract<InteractionField, {
+    type: 'select';
+}> & {
+    allowCustom?: boolean;
+};
+type ChatInteractionField = Exclude<InteractionField, {
+    type: 'select';
+}> | ChatSelectField;
+/** `InteractionRequest` whose select fields may carry `allowCustom`. */
+type InteractionRequestWire = Omit<InteractionRequest, 'answerSpec'> & {
+    answerSpec: {
+        fields: ChatInteractionField[];
+    };
+};
+type ChatInteractionStatus = 'pending' | 'answered' | 'declined' | 'cancelled' | 'expired';
+/** The client/persisted view of one ask. `fields` come verbatim off the wire. */
+interface ChatInteraction {
+    id: string;
+    kind: string;
+    title: string;
+    body?: string;
+    fields: ChatInteractionField[];
+    status: ChatInteractionStatus;
+    /** Set when status came from an `interaction.cancel` (e.g. "timeout"). */
+    cancelReason?: string;
+}
+declare function isTerminalInteractionStatus(status: ChatInteractionStatus): boolean;
+/** Statuses only move forward (pending → terminal); a replayed/stale `pending`
+ *  must never resurrect a resolved card. */
+declare function canTransitionInteractionStatus(from: ChatInteractionStatus, to: ChatInteractionStatus): boolean;
+/** Maps an `interaction.cancel` reason to the card's terminal status. */
+declare function cancelStatusFor(reason: string | undefined): ChatInteractionStatus;
+/** Content identity for duplicate safety nets. Excludes volatile ids/statuses. */
+declare function questionInteractionContentSignature(interaction: ChatInteraction): string | null;
+declare function dedupeQuestionInteractionsByContent(interactions: ChatInteraction[]): ChatInteraction[];
+type ParseInteractionResult = {
+    succeeded: true;
+    value: InteractionRequestWire;
+} | {
+    succeeded: false;
+    error: string;
+};
+/** Parses an `interaction` event's data (`{ request }`). Validates the shape
+ *  with the agent-interface schema but returns the raw request so a field a
+ *  pinned schema predates (`allowCustom`) survives. */
+declare function parseInteractionRequest(data: Record<string, unknown> | undefined): ParseInteractionResult;
+interface InteractionCancelData {
+    id: string;
+    reason?: string;
+}
+declare function parseInteractionCancel(data: Record<string, unknown> | undefined): {
+    succeeded: true;
+    value: InteractionCancelData;
+} | {
+    succeeded: false;
+    error: string;
+};
+declare function fieldAcceptsFreeText(field: ChatInteractionField): boolean;
+interface ComposerAnswerDelivery {
+    interactionId: string;
+    field: ChatInteractionField;
+}
+/** One delivery per pending ask: the first free-text-capable field, else the
+ *  first field. Zero-field asks are skipped (nothing to carry the text). */
+declare function composerAnswerDeliveries(pending: ChatInteraction[]): ComposerAnswerDelivery[];
+/** Shapes composer text into the respond payload for the routed field
+ *  (select answers are string arrays on the wire; text answers are strings). */
+declare function composerAnswerData(field: ChatInteractionField, text: string): InteractionData;
+declare function interactionPartKey(id: string): string;
+declare function noticePartKey(id: string): string;
+type NoticeKind = 'warning' | 'auto-declined';
+/** Builds the persisted/streamed `notice` part — a one-line transcript notice
+ *  explaining an out-of-band event (warning, auto-declined interaction). */
+declare function noticePart(noticeKind: NoticeKind, id: string, text: string): Record<string, unknown>;
+/** Reads a wire request into the client's pending `ChatInteraction`. */
+declare function interactionFromWireRequest(request: InteractionRequestWire): ChatInteraction;
+/** Builds the persisted/streamed `interaction` part from a wire request. */
+declare function interactionToPersistedPart(request: InteractionRequestWire, status: ChatInteractionStatus, cancelReason?: string): Record<string, unknown>;
+/** Reads a persisted/streamed `interaction` part back into a `ChatInteraction`.
+ *  Returns null (caller logs) when the part is not one of ours. */
+declare function persistedPartToInteraction(part: Record<string, unknown>): ChatInteraction | null;
 
 /**
  * Client-side chat-stream consumption — the NDJSON parse loop every agent
@@ -15,11 +109,13 @@ import '@tangle-network/agent-interface';
  *   {kind:'event', event:{type:'text'|'reasoning'|'tool_call'|'usage', ...}}
  *   {kind:'tool_result', toolCallId, toolName, label, outcome}
  *   {type:'turn'|'metadata'|'error'|'turn_status', ...}          (route-level)
+ *   {type:'interaction', data:{request}}                         (sidecar ask)
  *
  * Replayed lines carry an extra `seq` — transparently ignored. Works for
  * router-backed and sandbox-backed chats alike: anything producing these
  * lines (live pump, queued follow, resume replay) feeds the same callbacks.
  */
+
 interface ChatStreamToolCall {
     toolCallId?: string;
     toolName: string;
@@ -49,6 +145,11 @@ interface ChatStreamCallbacks {
     onMetadata?: (data: Record<string, unknown>) => void;
     /** A loop-level error event (the turn failed server-side). */
     onErrorEvent?: (message: string) => void;
+    /** A sidecar interaction ask (kind: "question"/"plan"/…). The run is BLOCKED
+     *  in the broker until the user answers; a pending ask is "waiting on the
+     *  user", not "model working". Optional — a consumer that doesn't wire it
+     *  parses the same stream unchanged. */
+    onInteraction?: (interaction: ChatInteraction) => void;
 }
 interface ConsumeChatStreamResult {
     turnId: string | null;
@@ -555,4 +656,4 @@ declare function useThinkingSeconds(active: boolean): number;
  */
 declare function ChatMessages({ messages, models, renderMarkdown, renderExtras, userLabel, agentLabel, loading, approval, onToolCallClick, toolRenderers, error, onRetry, renderEmpty, emptyState, header, }: 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, type ChatMessageMetrics, type ChatMessageSegment, ChatMessages, type ChatMessagesProps, type ChatStreamCallbacks, type ChatStreamToolCall, type ChatStreamToolResult, type ChatToolCallInfo, type ChatUiMessage, type ComposerFile, type ConsumeChatStreamResult, DEFAULT_EFFORT_LEVELS, type EffortLevel, EffortPicker, type EffortPickerProps, FlowWaterfall, type FlowWaterfallProps, MissionActivityLane, type MissionActivityLaneProps, ModelPicker, type ModelPickerProps, type ProposalApprovalHandlers, ProviderLogo, type ProviderLogoProps, RunDrillIn, type RunDrillInProps, SeatPaywall, type SeatPaywallProps, type SmoothRevealOptions, type StreamChatOptions, type ToolDetailRenderers, type ToolRunRecord, type ToolRunStep, type WaterfallRow, activityTone, consumeChatStream, dispatchChatStreamLine, formatActivityCost, formatActivityDuration, formatModelCost, formatTokensPerSecond, mergeActivityPages, nextRevealCount, pendingApprovalOf, streamChatTurn, usePending, usePopover, useSmoothText, useThinkingSeconds, waterfallLayout };
+export { type ActivityTone, type AgentActivityPage, AgentActivityPanel, type AgentActivityPanelProps, type AgentActivityRecord, AgentSessionControls, type AgentSessionControlsProps, CatalogModel, ChatComposer, type ChatComposerProps, type ChatEmptyDoor, ChatEmptyState, type ChatEmptyStateProps, type ChatInteraction, type ChatInteractionField, type ChatInteractionStatus, type ChatMessageMetrics, type ChatMessageSegment, ChatMessages, type ChatMessagesProps, type ChatSelectField, type ChatStreamCallbacks, type ChatStreamToolCall, type ChatStreamToolResult, type ChatToolCallInfo, type ChatUiMessage, type ComposerAnswerDelivery, type ComposerFile, type ConsumeChatStreamResult, DEFAULT_EFFORT_LEVELS, type EffortLevel, EffortPicker, type EffortPickerProps, FlowWaterfall, type FlowWaterfallProps, INTERACTION_CANCEL_EVENT, INTERACTION_EVENT, INTERACTION_RESOLVED_EVENT, type InteractionCancelData, type InteractionRequestWire, MissionActivityLane, type MissionActivityLaneProps, ModelPicker, type ModelPickerProps, type NoticeKind, type ParseInteractionResult, type ProposalApprovalHandlers, ProviderLogo, type ProviderLogoProps, RunDrillIn, type RunDrillInProps, SeatPaywall, type SeatPaywallProps, type SmoothRevealOptions, type StreamChatOptions, type ToolDetailRenderers, type ToolRunRecord, type ToolRunStep, type WaterfallRow, activityTone, canTransitionInteractionStatus, cancelStatusFor, composerAnswerData, composerAnswerDeliveries, consumeChatStream, dedupeQuestionInteractionsByContent, dispatchChatStreamLine, fieldAcceptsFreeText, formatActivityCost, formatActivityDuration, formatModelCost, formatTokensPerSecond, interactionFromWireRequest, interactionPartKey, interactionToPersistedPart, isRenderableInteractionKind, isSafeInteractionFieldKey, isTerminalInteractionStatus, mergeActivityPages, nextRevealCount, noticePart, noticePartKey, parseInteractionCancel, parseInteractionRequest, pendingApprovalOf, persistedPartToInteraction, questionInteractionContentSignature, streamChatTurn, usePending, usePopover, useSmoothText, useThinkingSeconds, waterfallLayout };

package/dist/web-react/index.js

@@ -7,28 +7,49 @@ import {
   DEFAULT_EFFORT_LEVELS,
   EffortPicker,
   FlowWaterfall,
+  INTERACTION_CANCEL_EVENT,
+  INTERACTION_EVENT,
+  INTERACTION_RESOLVED_EVENT,
   MissionActivityLane,
   ModelPicker,
   ProviderLogo,
   RunDrillIn,
   SeatPaywall,
   activityTone,
+  canTransitionInteractionStatus,
+  cancelStatusFor,
+  composerAnswerData,
+  composerAnswerDeliveries,
   consumeChatStream,
+  dedupeQuestionInteractionsByContent,
   dispatchChatStreamLine,
+  fieldAcceptsFreeText,
   formatActivityCost,
   formatActivityDuration,
   formatModelCost,
   formatTokensPerSecond,
+  interactionFromWireRequest,
+  interactionPartKey,
+  interactionToPersistedPart,
+  isRenderableInteractionKind,
+  isSafeInteractionFieldKey,
+  isTerminalInteractionStatus,
   mergeActivityPages,
   nextRevealCount,
+  noticePart,
+  noticePartKey,
+  parseInteractionCancel,
+  parseInteractionRequest,
   pendingApprovalOf,
+  persistedPartToInteraction,
+  questionInteractionContentSignature,
   streamChatTurn,
   usePending,
   usePopover,
   useSmoothText,
   useThinkingSeconds,
   waterfallLayout
-} from "../chunk-4X7OOVII.js";
+} from "../chunk-VMY4TKMN.js";
 import {
   tabTerminalConnectionId,
   useSandboxTerminalConnection
@@ -44,21 +65,42 @@ export {
   DEFAULT_EFFORT_LEVELS,
   EffortPicker,
   FlowWaterfall,
+  INTERACTION_CANCEL_EVENT,
+  INTERACTION_EVENT,
+  INTERACTION_RESOLVED_EVENT,
   MissionActivityLane,
   ModelPicker,
   ProviderLogo,
   RunDrillIn,
   SeatPaywall,
   activityTone,
+  canTransitionInteractionStatus,
+  cancelStatusFor,
+  composerAnswerData,
+  composerAnswerDeliveries,
   consumeChatStream,
+  dedupeQuestionInteractionsByContent,
   dispatchChatStreamLine,
+  fieldAcceptsFreeText,
   formatActivityCost,
   formatActivityDuration,
   formatModelCost,
   formatTokensPerSecond,
+  interactionFromWireRequest,
+  interactionPartKey,
+  interactionToPersistedPart,
+  isRenderableInteractionKind,
+  isSafeInteractionFieldKey,
+  isTerminalInteractionStatus,
   mergeActivityPages,
   nextRevealCount,
+  noticePart,
+  noticePartKey,
+  parseInteractionCancel,
+  parseInteractionRequest,
   pendingApprovalOf,
+  persistedPartToInteraction,
+  questionInteractionContentSignature,
   streamChatTurn,
   tabTerminalConnectionId,
   usePending,

package/package.json

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