@tangle-network/agent-app 0.43.41 → 0.43.42

package/dist/index.js

@@ -1,7 +1,34 @@
+import "./chunk-UAKFCMWK.js";
 import {
   checkThemeContract
 } from "./chunk-NYATNLRK.js";
-import "./chunk-UAKFCMWK.js";
+import {
+  darkTheme,
+  lightTheme,
+  themeColor,
+  themeToCssVars
+} from "./chunk-47C6PJCW.js";
+import {
+  buildFlowTrace,
+  childSpanContext,
+  createMissionTraceContext,
+  renderHistogram,
+  renderWaterfall,
+  summarize,
+  timedEventsFromLines,
+  traceEnv
+} from "./chunk-GQRL6VNU.js";
+import {
+  ApprovalEventSchema,
+  BrandTokensSchema,
+  ConversionMetricsSchema,
+  CopyContentSchema,
+  EmailContentSchema,
+  ImageContentSchema,
+  VideoContentSchema,
+  parseAssetSpec,
+  safeParseAssetSpec
+} from "./chunk-5PTGEJZL.js";
 import {
   DEFAULT_SEQUENCES_MCP_DESCRIPTION,
   MAX_CAPTION_BATCH,
@@ -72,12 +99,6 @@ import {
   listTemplateSlots,
   validateBindings
 } from "./chunk-WFMUDX5J.js";
-import {
-  darkTheme,
-  lightTheme,
-  themeColor,
-  themeToCssVars
-} from "./chunk-47C6PJCW.js";
 import {
   CHANNEL_PRESETS,
   EXPORT_PRESETS,
@@ -112,6 +133,12 @@ import {
   validateSceneOperations,
   validateSlotValue
 } from "./chunk-M2EBUDZ7.js";
+import {
+  composeMissionFlowTrace,
+  delegationActivityToFlowSpans,
+  loopTraceEventsToFlowSpans,
+  stepActivityFlowTrace
+} from "./chunk-2QI7XV2T.js";
 import {
   DEFAULT_REDACTION_PATTERNS,
   buildRedactedDocument,
@@ -120,33 +147,40 @@ import {
   redactForIngestion,
   revealSpan
 } from "./chunk-5RMIUJDI.js";
-import {
-  buildFlowTrace,
-  childSpanContext,
-  createMissionTraceContext,
-  renderHistogram,
-  renderWaterfall,
-  summarize,
-  timedEventsFromLines,
-  traceEnv
-} from "./chunk-GQRL6VNU.js";
-import {
-  ApprovalEventSchema,
-  BrandTokensSchema,
-  ConversionMetricsSchema,
-  CopyContentSchema,
-  EmailContentSchema,
-  ImageContentSchema,
-  VideoContentSchema,
-  parseAssetSpec,
-  safeParseAssetSpec
-} from "./chunk-5PTGEJZL.js";
 import {
   HubExecClient,
   invokeIntegrationHub,
   resolveIntegrationAction
 } from "./chunk-L2TG5DBW.js";
 import "./chunk-7LNGJDNA.js";
+import {
+  DurableChatConflictError,
+  DurableChatError,
+  DurableChatGoneError,
+  DurableChatUnavailableError,
+  InMemoryDurableChatStateStore,
+  InMemoryDurableChatStore,
+  applyDurableInteractionAnswer,
+  applyDurableInteractionAsk,
+  applyDurableInteractionCancel,
+  createDurableChatEventProjection,
+  createDurableChatScope,
+  createDurableInteractionProjectionAdapter,
+  createDurableInteractionRoutePersistence,
+  createDurableInteractionSettlement,
+  createDurablePlanRoutes,
+  createInMemoryDurableChatStateStore,
+  durableChatScopeKey,
+  durableInteractionIntentKey,
+  normalizePlanDecision,
+  planAuthorityIdempotencyKey,
+  planCommandKey,
+  planEffectKey,
+  recordDurableInteractionAnswer,
+  recordDurableInteractionCancel,
+  stablePlanReceipt,
+  upsertDurableInteractionAsk
+} from "./chunk-ZU5GNSOJ.js";
 import {
   DEFAULT_MISSION_STEP_KINDS,
   MISSION_CONTROL_CHANNEL_ID,
@@ -170,12 +204,6 @@ import {
   stepGateProposalId,
   volumeGateProposalId
 } from "./chunk-YNALYIQ3.js";
-import {
-  composeMissionFlowTrace,
-  delegationActivityToFlowSpans,
-  loopTraceEventsToFlowSpans,
-  stepActivityFlowTrace
-} from "./chunk-2QI7XV2T.js";
 import {
   agentAppConfigJsonSchema,
   defineAgentApp
@@ -240,14 +268,14 @@ import {
   resolveChatTurn,
   resolveToolId,
   resolveToolName
-} from "./chunk-XYWCGFII.js";
+} from "./chunk-B5JD3DXD.js";
 import {
   createInteractionAnswerRoute,
   listSessionInteractions,
   mapInteractionRespondFailure,
   respondToSessionInteraction,
   validateInteractionAnswerBody
-} from "./chunk-Y4QHNQ75.js";
+} from "./chunk-6KVH5SP5.js";
 import {
   addSecurityHeaders,
   assertMediaUrl,
@@ -259,6 +287,14 @@ import {
   requireString,
   serializeCookie
 } from "./chunk-HFC4BTWJ.js";
+import {
+  isChatInteractionPart,
+  isChatPlanPart,
+  isChatStepFinishPart,
+  isChatTextPart,
+  isChatToolPart,
+  toChatMessageParts
+} from "./chunk-I2ATYB7R.js";
 import {
   INTERACTION_CANCEL_EVENT,
   INTERACTION_EVENT,
@@ -277,18 +313,23 @@ import {
   isTerminalInteractionStatus,
   noticePart,
   noticePartKey,
+  parseInteractionAnswers,
   parseInteractionCancel,
   parseInteractionRequest,
   persistedPartToInteraction,
-  questionInteractionContentSignature
-} from "./chunk-4TXDD6P2.js";
-import {
-  isChatInteractionPart,
-  isChatStepFinishPart,
-  isChatTextPart,
-  isChatToolPart,
-  toChatMessageParts
-} from "./chunk-I2R2XT4M.js";
+  questionInteractionContentSignature,
+  stampInteractionAnswers
+} from "./chunk-XAWFPMAR.js";
+import {
+  PLAN_SUBMITTED_EVENT,
+  canTransitionPlanStatus,
+  parsePlanSubmittedEvent,
+  persistedPartToPlan,
+  planFollowUpTurnId,
+  planPartKey,
+  planRevisionKey,
+  planToPersistedPart
+} from "./chunk-SIXYZ2FB.js";
 import {
   createFieldCrypto,
   decodeHexKey,
@@ -477,6 +518,10 @@ export {
   DEFAULT_SEQUENCES_MCP_DESCRIPTION,
   DEFAULT_TANGLE_BILLING_ENFORCEMENT_ENV_VAR,
   DEFAULT_TANGLE_ROUTER_BASE_URL,
+  DurableChatConflictError,
+  DurableChatError,
+  DurableChatGoneError,
+  DurableChatUnavailableError,
   ENV_TOTAL_MAX_BYTES,
   ENV_VALUE_MAX_BYTES,
   EXPORT_PRESETS,
@@ -486,12 +531,15 @@ export {
   INTERACTION_EVENT,
   INTERACTION_RESOLVED_EVENT,
   ImageContentSchema,
+  InMemoryDurableChatStateStore,
+  InMemoryDurableChatStore,
   KNOWN_HARNESSES,
   MAX_CAPTION_BATCH,
   MCP_PROTOCOL_VERSIONS,
   MIN_SEQUENCE_CLIP_FRAMES,
   MISSION_CONTROL_CHANNEL_ID,
   MissionConcurrencyError,
+  PLAN_SUBMITTED_EVENT,
   PRESET_MIGRATION_SQL,
   PRESET_TABLES,
   PROVISION_PAYLOAD_MAX_BYTES,
@@ -516,6 +564,9 @@ export {
   addSecurityHeaders,
   agentAppConfigJsonSchema,
   applyBindingsToDocument,
+  applyDurableInteractionAnswer,
+  applyDurableInteractionAsk,
+  applyDurableInteractionCancel,
   applyMissionEvent,
   applySceneOperation,
   applySceneOperations,
@@ -567,6 +618,7 @@ export {
   buildUserTextParts,
   buildVtt,
   canTransitionInteractionStatus,
+  canTransitionPlanStatus,
   cancelStatusFor,
   captionCoverage,
   captionTrackNameForLanguage,
@@ -594,9 +646,16 @@ export {
   createD1KnowledgeStateAccessor,
   createD1TurnEventStore,
   createDesignCanvasMcpHandler,
+  createDurableChatEventProjection,
+  createDurableChatScope,
+  createDurableInteractionProjectionAdapter,
+  createDurableInteractionRoutePersistence,
+  createDurableInteractionSettlement,
+  createDurablePlanRoutes,
   createEmptyDocument,
   createExpiringCapabilityToken,
   createFieldCrypto,
+  createInMemoryDurableChatStateStore,
   createInMemoryMissionStore,
   createInteractionAnswerRoute,
   createKnowledgeLoop,
@@ -647,6 +706,8 @@ export {
   detectSpans,
   dispatchAppTool,
   driveSandboxTurn,
+  durableChatScopeKey,
+  durableInteractionIntentKey,
   elementAabb,
   elementExtent,
   encodeEvent,
@@ -682,6 +743,7 @@ export {
   invokeIntegrationHub,
   isAppToolName,
   isChatInteractionPart,
+  isChatPlanPart,
   isChatStepFinishPart,
   isChatTextPart,
   isChatToolPart,
@@ -719,6 +781,7 @@ export {
   normalizeLanguageTag,
   normalizeModelId,
   normalizePersistedPart,
+  normalizePlanDecision,
   normalizeTime,
   normalizeToolEvent,
   noticePart,
@@ -726,20 +789,32 @@ export {
   objectKey,
   outcomeStatus,
   parseAssetSpec,
+  parseInteractionAnswers,
   parseInteractionCancel,
   parseInteractionRequest,
   parseJsonObjectBody,
   parseMissionBlocks,
+  parsePlanSubmittedEvent,
   parseSequenceOperations,
   parseSessionStreamEnvelope,
   persistedPartToInteraction,
+  persistedPartToPlan,
+  planAuthorityIdempotencyKey,
+  planCommandKey,
+  planEffectKey,
+  planFollowUpTurnId,
   planLanguageFanout,
+  planPartKey,
+  planRevisionKey,
+  planToPersistedPart,
   producedFromToolEvents,
   pumpBufferedTurn,
   questionInteractionContentSignature,
   readCookieValue,
   readSecret,
   readToolArgs,
+  recordDurableInteractionAnswer,
+  recordDurableInteractionCancel,
   redactForIngestion,
   reduceMissionEvents,
   renderHistogram,
@@ -790,6 +865,8 @@ export {
   snapModelToHarness,
   snapshotFrame,
   splitDeferredProfileFiles,
+  stablePlanReceipt,
+  stampInteractionAnswers,
   stepActivityFlowTrace,
   stepAgentActivity,
   stepGateProposalId,
@@ -812,6 +889,7 @@ export {
   traceEnv,
   trackIntervals,
   trimOrNull,
+  upsertDurableInteractionAsk,
   validateAddCaption,
   validateBindings,
   validateCreateTrack,

package/dist/interactions/index.d.ts

@@ -1,5 +1,5 @@
-import { i as InteractionRequestWire } from '../contract-DYbTzEDf.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 InteractionCancelData, h as InteractionPersistedPart, N as NoticeKind, j as NoticePersistedPart, P as ParseInteractionResult, k as canTransitionInteractionStatus, l as cancelStatusFor, m as composerAnswerData, n as composerAnswerDeliveries, o as dedupeQuestionInteractionsByContent, p as fieldAcceptsFreeText, q as interactionFromWireRequest, r as interactionPartKey, s as interactionToPersistedPart, t as isRenderableInteractionKind, u as isSafeInteractionFieldKey, v as isTerminalInteractionStatus, w as noticePart, x as noticePartKey, y as parseInteractionCancel, z as parseInteractionRequest, A as persistedPartToInteraction, B as questionInteractionContentSignature } from '../contract-DYbTzEDf.js';
+import { k as InteractionRequestWire } from '../contract-KfqJh_au.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, 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';
 import { InteractionOutcome, InteractionData } from '@tangle-network/agent-interface';
 export { InteractionData, InteractionOutcome, InteractionRequest } from '@tangle-network/agent-interface';
 
@@ -118,11 +118,66 @@ interface ResolveInteractionConnectionArgs {
      *  read product routing fields (workspaceId/threadId) without re-parsing. */
     body?: Record<string, unknown>;
 }
+interface BeforeInteractionAnswerArgs {
+    request: Request;
+    /** Original parsed body, including product routing fields. */
+    body: Record<string, unknown>;
+    /** Shared validation result; products never need to parse the answer again. */
+    answer: Extract<InteractionAnswerBodyValidation, {
+        ok: true;
+    }>;
+    connection: SidecarInteractionsConnection;
+    /** The route's single authoritative pre-answer sidecar snapshot. */
+    outstanding: InteractionRequestWire[];
+    answeredRequest?: InteractionRequestWire;
+    /** Content-identical questions that the shared route will also answer. */
+    duplicateRequests: InteractionRequestWire[];
+}
+interface DurableInteractionRouteArgs extends BeforeInteractionAnswerArgs {
+    /** Caller-created opaque identifier, stable across an ambiguous retry. */
+    attemptKey: string;
+}
+/** Crash-recoverable persistence lifecycle for the answer route. The product
+ * binds this structural port to `/durable-chat` (or an equivalent durable
+ * store). Existing `beforeAnswer` behavior remains independent and unchanged. */
+interface DurableInteractionRoutePersistence<TPrepared = unknown> {
+    guarantee: 'reconciled' | 'best-effort';
+    prepare(args: DurableInteractionRouteArgs): TPrepared | Promise<TPrepared>;
+    /** Resolve an ambiguous retry (for example, the sidecar says the ask is
+     * already gone). Only `settled:true` permits the route to report success. */
+    reconcile(args: DurableInteractionRouteArgs & {
+        prepared: TPrepared;
+    }): {
+        settled: boolean;
+    } | Promise<{
+        settled: boolean;
+    }>;
+    /** Record the authority acknowledgement before terminal projection. */
+    acknowledge(args: DurableInteractionRouteArgs & {
+        prepared: TPrepared;
+        duplicateIds: string[];
+    }): void | Promise<void>;
+    /** Idempotently materialize terminal status and accepted values. */
+    finalize(args: DurableInteractionRouteArgs & {
+        prepared: TPrepared;
+        duplicateIds: string[];
+    }): void | Promise<void>;
+    fail?(args: DurableInteractionRouteArgs & {
+        prepared: TPrepared;
+        error: unknown;
+    }): void | Promise<void>;
+}
 interface InteractionAnswerRouteOptions {
     /** Authenticate + authorize the caller and resolve the sidecar connection.
      *  This is the only product-supplied step: session auth, workspace/thread
      *  access, rate limiting, and box resolution all live here. */
     resolveConnection: (args: ResolveInteractionConnectionArgs) => Promise<InteractionConnectionResolution>;
+    /** Product persistence seam that runs before the answer can unblock and
+     * finalize the agent turn. A throw aborts the request before any answer POST. */
+    beforeAnswer?: (args: BeforeInteractionAnswerArgs) => void | Promise<void>;
+    /** Additive crash-recoverable settlement. When configured, POST requires an
+     * `attemptKey`; accepted values are finalized only after sidecar ack. */
+    durable?: DurableInteractionRoutePersistence;
     logger?: InteractionRouteLogger;
 }
 interface InteractionAnswerRoute {
@@ -138,4 +193,4 @@ interface InteractionAnswerRoute {
 }
 declare function createInteractionAnswerRoute(options: InteractionAnswerRouteOptions): InteractionAnswerRoute;
 
-export { type InteractionAnswerBodyValidation, type InteractionAnswerRoute, type InteractionAnswerRouteOptions, type InteractionClientOutcome, type InteractionConnectionResolution, InteractionRequestWire, type InteractionRouteLogger, type ResolveInteractionConnectionArgs, type SidecarInteractionsConnection, type SidecarInteractionsError, type SidecarInteractionsResult, createInteractionAnswerRoute, listSessionInteractions, mapInteractionRespondFailure, respondToSessionInteraction, validateInteractionAnswerBody };
+export { type BeforeInteractionAnswerArgs, type DurableInteractionRouteArgs, type DurableInteractionRoutePersistence, type InteractionAnswerBodyValidation, type InteractionAnswerRoute, type InteractionAnswerRouteOptions, type InteractionClientOutcome, type InteractionConnectionResolution, InteractionRequestWire, type InteractionRouteLogger, type ResolveInteractionConnectionArgs, type SidecarInteractionsConnection, type SidecarInteractionsError, type SidecarInteractionsResult, createInteractionAnswerRoute, listSessionInteractions, mapInteractionRespondFailure, respondToSessionInteraction, validateInteractionAnswerBody };

package/dist/interactions/index.js

@@ -5,7 +5,7 @@ import {
   mapInteractionRespondFailure,
   respondToSessionInteraction,
   validateInteractionAnswerBody
-} from "../chunk-Y4QHNQ75.js";
+} from "../chunk-6KVH5SP5.js";
 import {
   INTERACTION_CANCEL_EVENT,
   INTERACTION_EVENT,
@@ -24,11 +24,13 @@ import {
   isTerminalInteractionStatus,
   noticePart,
   noticePartKey,
+  parseInteractionAnswers,
   parseInteractionCancel,
   parseInteractionRequest,
   persistedPartToInteraction,
-  questionInteractionContentSignature
-} from "../chunk-4TXDD6P2.js";
+  questionInteractionContentSignature,
+  stampInteractionAnswers
+} from "../chunk-XAWFPMAR.js";
 export {
   INTERACTION_CANCEL_EVENT,
   INTERACTION_EVENT,
@@ -50,11 +52,13 @@ export {
   mapInteractionRespondFailure,
   noticePart,
   noticePartKey,
+  parseInteractionAnswers,
   parseInteractionCancel,
   parseInteractionRequest,
   persistedPartToInteraction,
   questionInteractionContentSignature,
   respondToSessionInteraction,
+  stampInteractionAnswers,
   validateInteractionAnswerBody
 };
 //# sourceMappingURL=index.js.map

package/dist/{parts-BcbitSNp.d.ts → parts-DjX0RRTS.d.ts}

@@ -1,5 +1,6 @@
 import { Part } from '@tangle-network/agent-interface';
-import { a as ChatInteractionField, b as ChatInteractionStatus, N as NoticeKind } from './contract-DYbTzEDf.js';
+import { a as ChatInteractionField, b as ChatInteractionStatus, h as InteractionAnswers, N as NoticeKind } from './contract-KfqJh_au.js';
+import { ChatPlanPersistedPart } from './plans/index.js';
 
 /**
  * The stored shape of `message.parts` — one typed vocabulary for every part a
@@ -25,6 +26,8 @@ import { a as ChatInteractionField, b as ChatInteractionStatus, N as NoticeKind
  *   `/web-react`'s chat-interactions contract (`interactionToPersistedPart`,
  *   `noticePart`) — type-only imports, one source of truth for their statuses
  *   and field shapes.
+ * - `plan`: the durable-plan projection in `/plans`, derived from the sandbox
+ *   SDK's authoritative plan lifecycle.
  *
  * `@tangle-network/agent-interface` exports the canonical wire `Part` union,
  * but its `PartBase` requires the `sessionID`/`messageID` stream envelope that
@@ -142,8 +145,10 @@ interface ChatInteractionPart {
         fields: ChatInteractionField[];
     };
     status: ChatInteractionStatus;
+    answers?: InteractionAnswers;
     cancelReason?: string;
 }
+type ChatPlanPart = ChatPlanPersistedPart;
 /** Persisted one-line transcript notice — byte-matches `noticePart` in
  *  `/web-react`'s chat-interactions contract. */
 interface ChatNoticePart {
@@ -152,7 +157,7 @@ interface ChatNoticePart {
     noticeKind: NoticeKind;
     text: string;
 }
-type ChatMessagePart = ChatTextPart | ChatReasoningPart | ChatToolPart | ChatFilePart | ChatImagePart | ChatSubtaskPart | ChatStepStartPart | ChatStepFinishPart | ChatInteractionPart | ChatNoticePart;
+type ChatMessagePart = ChatTextPart | ChatReasoningPart | ChatToolPart | ChatFilePart | ChatImagePart | ChatSubtaskPart | ChatStepStartPart | ChatStepFinishPart | ChatInteractionPart | ChatNoticePart | ChatPlanPart;
 /** Every canonical harness wire-part kind must be storable — compile-time
  *  guarantee that a new agent-interface part kind cannot silently fall out of
  *  the persisted vocabulary. */
@@ -171,6 +176,7 @@ declare function toChatMessageParts(parts: Array<Record<string, unknown>>): Chat
 declare function isChatToolPart(part: ChatMessagePart): part is ChatToolPart;
 declare function isChatTextPart(part: ChatMessagePart): part is ChatTextPart;
 declare function isChatInteractionPart(part: ChatMessagePart): part is ChatInteractionPart;
+declare function isChatPlanPart(part: ChatMessagePart): part is ChatPlanPart;
 declare function isChatStepFinishPart(part: ChatMessagePart): part is ChatStepFinishPart;
 
-export { type ChatFilePart as C, type StorableHarnessPartKind as S, type ChatImagePart as a, type ChatInteractionPart as b, type ChatMessagePart as c, type ChatNoticePart as d, type ChatPartTime as e, type ChatReasoningPart as f, type ChatStepFinishPart as g, type ChatStepStartPart as h, type ChatSubtaskPart as i, type ChatTextPart as j, type ChatToolPart as k, type ChatToolState as l, type ChatToolStatus as m, type ChatUsageTokens as n, isChatInteractionPart as o, isChatStepFinishPart as p, isChatTextPart as q, isChatToolPart as r, toChatMessageParts as t };
+export { type ChatFilePart as C, type StorableHarnessPartKind as S, type ChatImagePart as a, type ChatInteractionPart as b, type ChatMessagePart as c, type ChatNoticePart as d, type ChatPartTime as e, type ChatPlanPart as f, type ChatReasoningPart as g, type ChatStepFinishPart as h, type ChatStepStartPart as i, type ChatSubtaskPart as j, type ChatTextPart as k, type ChatToolPart as l, type ChatToolState as m, type ChatToolStatus as n, type ChatUsageTokens as o, isChatInteractionPart as p, isChatPlanPart as q, isChatStepFinishPart as r, isChatTextPart as s, isChatToolPart as t, toChatMessageParts as u };

package/dist/plans/index.d.ts

@@ -0,0 +1,69 @@
+/**
+ * Durable-plan application-shell contract.
+ *
+ * The sandbox SDK owns the authoritative plan lifecycle and decision APIs.
+ * This module only projects that substrate state into chat events and
+ * persisted message parts that products can render and restore.
+ */
+declare const PLAN_SUBMITTED_EVENT: "plan.submitted";
+/** Sandbox plan lifecycle. `preparing` is the transient submission state and
+ * is retained in the projection even though the chat card normally starts at
+ * `pending`. */
+type ChatPlanStatus = 'preparing' | 'pending' | 'approved' | 'rejected' | 'superseded' | 'withdrawn';
+type ChatPlanBase = {
+    /** The sandbox SDK calls this field `id`; the transcript projection names
+     * it explicitly so it cannot collide with a message-part id. */
+    planId: string;
+    revision: number;
+    title?: string;
+    body: string;
+    submittedAt: string;
+    /** Provider/Sandbox metadata is deliberately opaque to this package. */
+    metadata?: Record<string, unknown>;
+    decidedBy?: string;
+};
+/** Browser/persisted projection of the sandbox SDK's durable-plan union. */
+type ChatPlan = ChatPlanBase & ({
+    status: 'preparing';
+} | {
+    status: 'pending';
+} | {
+    status: 'approved';
+    decidedAt: string;
+} | {
+    status: 'rejected';
+    decidedAt: string;
+    feedback: string;
+} | {
+    status: 'superseded';
+    supersededAt: string;
+    supersededByPlanId: string;
+} | {
+    status: 'withdrawn';
+    withdrawnAt: string;
+    withdrawnReason: string;
+});
+/** Canonical transcript part for one durable plan. */
+type ChatPlanPersistedPart = ChatPlan & {
+    type: 'plan';
+};
+type ParsePlanSubmittedResult = {
+    succeeded: true;
+    value: ChatPlan;
+} | {
+    succeeded: false;
+    error: string;
+};
+declare function planPartKey(planId: string): string;
+declare function planRevisionKey(planId: string, revision: number): string;
+declare function planFollowUpTurnId(planId: string, outcome: 'approved' | 'rejected'): string;
+/** Plan status is monotonic: only a pending plan can settle. */
+declare function canTransitionPlanStatus(from: ChatPlanStatus, to: ChatPlanStatus): boolean;
+declare function planToPersistedPart(plan: ChatPlan): ChatPlanPersistedPart;
+declare function persistedPartToPlan(part: Record<string, unknown>): ChatPlan | null;
+/** Parses both direct sandbox events (`data.plan`) and session envelopes
+ * (`properties.plan`). Session identity is carried by the surrounding stream
+ * and is deliberately not required in the payload. */
+declare function parsePlanSubmittedEvent(event: unknown): ParsePlanSubmittedResult;
+
+export { type ChatPlan, type ChatPlanPersistedPart, type ChatPlanStatus, PLAN_SUBMITTED_EVENT, type ParsePlanSubmittedResult, canTransitionPlanStatus, parsePlanSubmittedEvent, persistedPartToPlan, planFollowUpTurnId, planPartKey, planRevisionKey, planToPersistedPart };

package/dist/plans/index.js

@@ -0,0 +1,21 @@
+import {
+  PLAN_SUBMITTED_EVENT,
+  canTransitionPlanStatus,
+  parsePlanSubmittedEvent,
+  persistedPartToPlan,
+  planFollowUpTurnId,
+  planPartKey,
+  planRevisionKey,
+  planToPersistedPart
+} from "../chunk-SIXYZ2FB.js";
+export {
+  PLAN_SUBMITTED_EVENT,
+  canTransitionPlanStatus,
+  parsePlanSubmittedEvent,
+  persistedPartToPlan,
+  planFollowUpTurnId,
+  planPartKey,
+  planRevisionKey,
+  planToPersistedPart
+};
+//# sourceMappingURL=index.js.map

package/dist/plans/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"sourcesContent":[],"mappings":"","names":[]}

package/dist/stream/index.js

@@ -23,7 +23,9 @@ import {
   resolveChatTurn,
   resolveToolId,
   resolveToolName
-} from "../chunk-XYWCGFII.js";
+} from "../chunk-B5JD3DXD.js";
+import "../chunk-XAWFPMAR.js";
+import "../chunk-SIXYZ2FB.js";
 export {
   TURN_EVENTS_MIGRATION_SQL,
   TURN_STATUS_SCOPE_MIGRATION_SQL,

package/dist/teams/index.js

@@ -3,15 +3,6 @@ import {
   isInviteTokenShape,
   validateInviteToken
 } from "../chunk-3SVAA3MA.js";
-import {
-  INVITATION_EXPIRY_DAYS,
-  generateInvitationToken,
-  getInvitationExpiresAt,
-  inviteUrlForToken,
-  normalizeInvitationEmail,
-  parseInvitationPermission,
-  renderInvitationEmail
-} from "../chunk-WEBBJBDH.js";
 import {
   ASSIGNABLE_WORKSPACE_ROLES,
   ORGANIZATION_ROLES,
@@ -27,6 +18,15 @@ import {
   workspaceRoleToCollaborationAccess,
   workspaceRoleToSandboxRole
 } from "../chunk-63CE7FEZ.js";
+import {
+  INVITATION_EXPIRY_DAYS,
+  generateInvitationToken,
+  getInvitationExpiresAt,
+  inviteUrlForToken,
+  normalizeInvitationEmail,
+  parseInvitationPermission,
+  renderInvitationEmail
+} from "../chunk-WEBBJBDH.js";
 export {
   ASSIGNABLE_WORKSPACE_ROLES,
   INVITATION_EXPIRY_DAYS,

package/dist/teams/invitations-api.js

@@ -2,6 +2,9 @@ import {
   SeatLimitError
 } from "../chunk-SWUVTGMR.js";
 import "../chunk-3SVAA3MA.js";
+import {
+  hasWorkspaceRole
+} from "../chunk-63CE7FEZ.js";
 import {
   generateInvitationToken,
   getInvitationExpiresAt,
@@ -9,9 +12,6 @@ import {
   normalizeInvitationEmail,
   parseInvitationPermission
 } from "../chunk-WEBBJBDH.js";
-import {
-  hasWorkspaceRole
-} from "../chunk-63CE7FEZ.js";
 
 // src/teams/invitations-api.ts
 import { and, eq, lte, sql } from "drizzle-orm";