@tangle-network/agent-app 0.43.41 → 0.43.42

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

@@ -0,0 +1,419 @@
+import { C as ChatInteraction, g as InteractionAnswerValue, k as InteractionRequestWire, i as InteractionCancelData, j as InteractionPersistedPart } from '../contract-KfqJh_au.js';
+import { ChatPlan } from '../plans/index.js';
+import { DurableInteractionRouteArgs, DurableInteractionRoutePersistence } from '../interactions/index.js';
+import '@tangle-network/agent-interface';
+
+type DurableChatErrorCode = 'DURABLE_CHAT_BAD_REQUEST' | 'DURABLE_CHAT_UNAUTHORIZED' | 'DURABLE_CHAT_CONFLICT' | 'DURABLE_CHAT_UNAVAILABLE' | 'DURABLE_CHAT_GONE' | 'DURABLE_CHAT_NOT_FOUND';
+/** Typed, fail-loud errors for adapters and route seams. */
+declare class DurableChatError extends Error {
+    readonly code: DurableChatErrorCode;
+    readonly status: number;
+    readonly details?: unknown;
+    constructor(code: DurableChatErrorCode, message: string, status: number, details?: unknown);
+}
+declare class DurableChatConflictError extends DurableChatError {
+    constructor(message?: string, details?: unknown);
+}
+declare class DurableChatUnavailableError extends DurableChatError {
+    constructor(message?: string, details?: unknown);
+}
+declare class DurableChatGoneError extends DurableChatError {
+    constructor(message?: string, details?: unknown);
+}
+
+/** An authorization-derived tenant/thread scope.  Consumers should only
+ * create this value after authenticating the request; the route never accepts
+ * an identity or scope from the request body. */
+type DurableChatScope = string & {
+    readonly __durableChatScope: unique symbol;
+};
+declare function createDurableChatScope(value: string): DurableChatScope;
+declare function durableChatScopeKey(scope: DurableChatScope): string;
+type DurablePlanDecision = 'approved' | 'rejected';
+type DurablePlanAuthorityDecision = DurablePlanDecision | 'approve' | 'reject';
+/** Projection retained by a durable store.  It is intentionally compatible
+ * with the browser `/plans` projection and adds no product-specific fields. */
+type DurablePlanProjection = ChatPlan & {
+    metadata?: Record<string, unknown>;
+    decidedBy?: string;
+};
+type DurablePlanCommandKey = string;
+type DurablePlanCommandState = 'claimed' | 'authority_committed' | 'finalized' | 'conflicted';
+interface DurablePlanCommandRecord {
+    scope: DurableChatScope;
+    planId: string;
+    revision: number;
+    decision: DurablePlanDecision;
+    commandKey: DurablePlanCommandKey;
+    authorityIdempotencyKey: string;
+    state: DurablePlanCommandState;
+    claimedAt: string;
+    authorityResult?: DurablePlanAuthorityResult;
+    receipt?: DurableFollowUpReceipt;
+    conflict?: string;
+}
+interface DurablePlanAuthorityCurrentResult {
+    /** Authoritative state. `null` means the authority has forgotten the plan. */
+    plan: DurablePlanProjection | null;
+    receipt?: DurableFollowUpReceipt;
+}
+interface DurableFollowUpReceipt {
+    /** Stable for a scope + plan + revision + decision. */
+    receiptId: string;
+    planId: string;
+    revision: number;
+    decision: DurablePlanDecision;
+    turnId: string;
+    state: string;
+    /** Authority's stable idempotency key, useful when reconciling. */
+    authorityIdempotencyKey: string;
+}
+interface DurablePlanAuthorityResult {
+    /** Authority's final plan projection. */
+    plan: DurablePlanProjection;
+    /** Sandbox-style follow-up result. */
+    followUp: {
+        turnId: string;
+        state: string;
+    };
+    /** True when the authority served a previously committed decision. */
+    idempotent?: boolean;
+    /** Stable authority operation id, if the provider has one. */
+    authorityId?: string;
+    receipt?: DurableFollowUpReceipt;
+}
+/** Structural port to Sandbox (or another durable plan authority). */
+interface DurablePlanAuthority {
+    current(args: {
+        scope: DurableChatScope;
+        planId: string;
+        revision?: number;
+    }): Promise<DurablePlanAuthorityCurrentResult | DurablePlanProjection | null>;
+    decide(args: {
+        scope: DurableChatScope;
+        planId: string;
+        revision: number;
+        decision: DurablePlanDecision;
+        feedback?: string;
+        idempotencyKey: string;
+    }): Promise<DurablePlanAuthorityResult>;
+}
+interface DurablePlanEffectRecord {
+    effectKey: string;
+    scope: DurableChatScope;
+    planId: string;
+    revision: number;
+    decision: DurablePlanDecision;
+    state: 'claimed' | 'completed' | 'error';
+    claimedAt: string;
+    completedAt?: string;
+    error?: string;
+}
+interface DurablePlanStore {
+    getPlanProjection(scope: DurableChatScope, planId: string, revision?: number): Promise<DurablePlanProjection | null>;
+    putPlanProjection(scope: DurableChatScope, projection: DurablePlanProjection): Promise<void>;
+    listPlanProjections?(scope: DurableChatScope, planId?: string): Promise<DurablePlanProjection[]>;
+    getPlanCommand(scope: DurableChatScope, commandKey: DurablePlanCommandKey): Promise<DurablePlanCommandRecord | null>;
+    claimPlanCommand(scope: DurableChatScope, command: DurablePlanCommandRecord): Promise<{
+        status: 'claimed';
+        record: DurablePlanCommandRecord;
+    } | {
+        status: 'existing';
+        record: DurablePlanCommandRecord;
+    } | {
+        status: 'conflict';
+        record?: DurablePlanCommandRecord;
+        reason: string;
+    }>;
+    recordPlanAuthorityResult(scope: DurableChatScope, commandKey: DurablePlanCommandKey, result: DurablePlanAuthorityResult, receipt: DurableFollowUpReceipt): Promise<void>;
+    finalizePlanCommand(scope: DurableChatScope, commandKey: DurablePlanCommandKey): Promise<void>;
+    getPlanEffect(scope: DurableChatScope, effectKey: string): Promise<DurablePlanEffectRecord | null>;
+    claimPlanEffect(scope: DurableChatScope, effect: DurablePlanEffectRecord): Promise<{
+        status: 'claimed';
+        record: DurablePlanEffectRecord;
+    } | {
+        status: 'existing';
+        record: DurablePlanEffectRecord;
+    }>;
+    completePlanEffect(scope: DurableChatScope, effectKey: string): Promise<void>;
+    failPlanEffect(scope: DurableChatScope, effectKey: string, error: string): Promise<void>;
+    getInteractionProjection(scope: DurableChatScope, interactionId: string): Promise<DurableInteractionProjection | null>;
+    upsertInteractionProjection(scope: DurableChatScope, projection: DurableInteractionProjection): Promise<DurableInteractionProjection>;
+    listInteractionProjections?(scope: DurableChatScope): Promise<DurableInteractionProjection[]>;
+    getAnswerIntent(scope: DurableChatScope, intentKey: string): Promise<DurableAnswerIntentRecord | null>;
+    claimAnswerIntent(scope: DurableChatScope, intent: DurableAnswerIntentRecord): Promise<{
+        status: 'claimed';
+        record: DurableAnswerIntentRecord;
+    } | {
+        status: 'existing';
+        record: DurableAnswerIntentRecord;
+    } | {
+        status: 'conflict';
+        record?: DurableAnswerIntentRecord;
+        reason: string;
+    }>;
+    acknowledgeAnswerIntent(scope: DurableChatScope, intentKey: string, acknowledgement: DurableInteractionAcknowledgement): Promise<void>;
+    /** Atomically settle the interaction projection (including semantic aliases)
+     * from the acknowledged intent and mark the intent finalized. */
+    finalizeAnswerIntent(scope: DurableChatScope, intentKey: string, guarantee?: DurableInteractionGuarantee): Promise<void>;
+    abortAnswerIntent(scope: DurableChatScope, intentKey: string, error: string): Promise<void>;
+}
+/** Alias used by adapters that store all durable chat state in one port. */
+type DurableChatStateStore = DurablePlanStore;
+type DurablePlanStateStore = DurablePlanStore;
+type DurablePlanCommandJournal = Pick<DurablePlanStore, 'getPlanCommand' | 'claimPlanCommand' | 'recordPlanAuthorityResult' | 'finalizePlanCommand'>;
+type DurableAnswerIntentJournal = Pick<DurablePlanStore, 'getAnswerIntent' | 'claimAnswerIntent' | 'acknowledgeAnswerIntent' | 'finalizeAnswerIntent' | 'abortAnswerIntent'>;
+interface DurableInteractionProjection extends ChatInteraction {
+    /** Sequence/event identity used to make ask replays idempotent. */
+    eventId?: string;
+    semanticKey?: string;
+    /** A cancel-before-ask row is a terminal tombstone. */
+    tombstone?: boolean;
+    updatedAt?: string;
+}
+type DurableAnswerIntentState = 'prepared' | 'acknowledged' | 'finalized' | 'aborted';
+interface DurableAnswerIntentRecord {
+    scope: DurableChatScope;
+    interactionId: string;
+    attemptKey: string;
+    intentKey: string;
+    outcome: 'accepted' | 'declined';
+    data?: Record<string, InteractionAnswerValue>;
+    state: DurableAnswerIntentState;
+    guarantee?: DurableInteractionGuarantee;
+    acknowledgement?: DurableInteractionAcknowledgement;
+    createdAt: string;
+    finalizedAt?: string;
+    error?: string;
+}
+interface DurableInteractionAcknowledgement {
+    acknowledged: true;
+    authorityId?: string;
+    status?: string;
+    at?: string;
+}
+type DurableInteractionGuarantee = 'reconciled' | 'best-effort';
+interface DurableInteractionSettlementOptions {
+    /** Caller-created and stable across retries/reconnects. */
+    attemptKey: string;
+    guarantee?: DurableInteractionGuarantee;
+    now?: () => string;
+}
+interface DurableInteractionSettlement {
+    prepare(scope: DurableChatScope, interactionId: string, outcome: 'accepted' | 'declined', data?: Record<string, InteractionAnswerValue>): Promise<DurableAnswerIntentRecord>;
+    acknowledge(scope: DurableChatScope, intentKey: string, acknowledgement?: Omit<DurableInteractionAcknowledgement, 'acknowledged'>): Promise<DurableAnswerIntentRecord>;
+    finalize(scope: DurableChatScope, intentKey: string): Promise<DurableAnswerIntentRecord>;
+    abort(scope: DurableChatScope, intentKey: string, error: string): Promise<DurableAnswerIntentRecord>;
+    reconcile(scope: DurableChatScope, intentKey: string): Promise<DurableAnswerIntentRecord | null>;
+}
+declare function normalizePlanDecision(value: unknown): DurablePlanDecision | null;
+declare function planCommandKey(planId: string, revision: number, decision: DurablePlanDecision): string;
+declare function planAuthorityIdempotencyKey(scope: DurableChatScope, planId: string, revision: number, decision: DurablePlanDecision): string;
+declare function planEffectKey(scope: DurableChatScope, planId: string, revision: number, decision: DurablePlanDecision): string;
+declare function stablePlanReceipt(scope: DurableChatScope, planId: string, revision: number, decision: DurablePlanDecision, result: Pick<DurablePlanAuthorityResult, 'followUp'>): DurableFollowUpReceipt;
+
+/**
+ * Reference adapter for tests and local development. It is intentionally
+ * process-local and non-production: there is no locking across processes,
+ * transaction, or crash recovery. Production adapters should implement the
+ * same port with a database/Workflow primitive and CAS at every claim.
+ */
+declare class InMemoryDurableChatStateStore implements DurablePlanStore {
+    private readonly plans;
+    private readonly currentPlans;
+    private readonly commands;
+    private readonly effects;
+    private readonly interactions;
+    private readonly interactionSemantic;
+    /** Duplicate event ids point at the canonical semantic interaction so all
+     * duplicate asks settle through one terminal row/attempt. */
+    private readonly interactionAliases;
+    private readonly answerIntents;
+    private scopePrefix;
+    private scopedKey;
+    private planKey;
+    private currentKey;
+    private commandKey;
+    private interactionKey;
+    private intentKey;
+    private effectKey;
+    getPlanProjection(scope: DurableChatScope, planId: string, revision?: number): Promise<DurablePlanProjection | null>;
+    listPlanProjections(scope: DurableChatScope, planId?: string): Promise<DurablePlanProjection[]>;
+    putPlanProjection(scope: DurableChatScope, projection: DurablePlanProjection): Promise<void>;
+    getPlanCommand(scope: DurableChatScope, commandKey: DurablePlanCommandKey): Promise<DurablePlanCommandRecord | null>;
+    claimPlanCommand(scope: DurableChatScope, command: DurablePlanCommandRecord): Promise<{
+        status: "conflict";
+        record: DurablePlanCommandRecord;
+        reason: string;
+    } | {
+        status: "claimed";
+        record: DurablePlanCommandRecord;
+        reason?: undefined;
+    } | {
+        status: "existing";
+        record: DurablePlanCommandRecord;
+        reason?: undefined;
+    }>;
+    recordPlanAuthorityResult(scope: DurableChatScope, commandKey: string, result: DurablePlanAuthorityResult, receipt: DurablePlanCommandRecord['receipt']): Promise<void>;
+    finalizePlanCommand(scope: DurableChatScope, commandKey: string): Promise<void>;
+    getPlanEffect(scope: DurableChatScope, effectKey: string): Promise<DurablePlanEffectRecord | null>;
+    claimPlanEffect(scope: DurableChatScope, effect: DurablePlanEffectRecord): Promise<{
+        status: "existing";
+        record: DurablePlanEffectRecord;
+    } | {
+        status: "claimed";
+        record: DurablePlanEffectRecord;
+    }>;
+    completePlanEffect(scope: DurableChatScope, effectKey: string): Promise<void>;
+    failPlanEffect(scope: DurableChatScope, effectKey: string, error: string): Promise<void>;
+    getInteractionProjection(scope: DurableChatScope, interactionId: string): Promise<DurableInteractionProjection | null>;
+    listInteractionProjections(scope: DurableChatScope): Promise<DurableInteractionProjection[]>;
+    upsertInteractionProjection(scope: DurableChatScope, projection: DurableInteractionProjection): Promise<DurableInteractionProjection>;
+    getAnswerIntent(scope: DurableChatScope, intentKey: string): Promise<DurableAnswerIntentRecord | null>;
+    claimAnswerIntent(scope: DurableChatScope, intent: DurableAnswerIntentRecord): Promise<{
+        status: "claimed";
+        record: DurableAnswerIntentRecord;
+        reason?: undefined;
+    } | {
+        status: "existing";
+        record: DurableAnswerIntentRecord;
+        reason?: undefined;
+    } | {
+        status: "conflict";
+        record: DurableAnswerIntentRecord;
+        reason: string;
+    }>;
+    acknowledgeAnswerIntent(scope: DurableChatScope, intentKey: string, acknowledgement: DurableAnswerIntentRecord['acknowledgement']): Promise<void>;
+    finalizeAnswerIntent(scope: DurableChatScope, intentKey: string, guarantee?: DurableAnswerIntentRecord['guarantee']): Promise<void>;
+    abortAnswerIntent(scope: DurableChatScope, intentKey: string, error: string): Promise<void>;
+}
+/** Short aliases retained for adapter authors who call this a durable chat
+ * store rather than a state store. Both names refer to the same non-production
+ * reference implementation. */
+declare const InMemoryDurableChatStore: typeof InMemoryDurableChatStateStore;
+declare function createInMemoryDurableChatStateStore(): InMemoryDurableChatStateStore;
+
+/** Apply an ask event. Event ids and semantic signatures make replays safe;
+ * a prior cancel creates a tombstone and cannot be resurrected by a late ask. */
+declare function upsertDurableInteractionAsk(store: DurablePlanStore, scope: DurableChatScope, request: InteractionRequestWire, options?: {
+    eventId?: string;
+    semanticKey?: string;
+    now?: () => string;
+}): Promise<DurableInteractionProjection>;
+/** Apply a cancel event. It is valid before the ask arrives and leaves a
+ * terminal tombstone so a delayed ask cannot re-open the card. */
+declare function recordDurableInteractionCancel(store: DurablePlanStore, scope: DurableChatScope, interactionId: string, reason?: string, options?: {
+    eventId?: string;
+    now?: () => string;
+}): Promise<DurableInteractionProjection>;
+/** Record an accepted/declined answer in the projection. The terminal
+ * transition is intentionally separate from answer-intent acknowledgement so
+ * callers can choose reconciled or best-effort delivery. */
+declare function recordDurableInteractionAnswer(store: DurablePlanStore, scope: DurableChatScope, interactionId: string, outcome: 'accepted' | 'declined', answers?: Record<string, InteractionAnswerValue>, options?: {
+    eventId?: string;
+    now?: () => string;
+}): Promise<DurableInteractionProjection>;
+interface DurableInteractionSettlementFactoryOptions extends DurableInteractionSettlementOptions {
+    store: DurablePlanStore;
+    /** Optional authority lookup used by `reconcile`; returning null leaves the
+     * intent prepared for a later durable retry. */
+    reconcileAuthority?: (args: {
+        scope: DurableChatScope;
+        intent: DurableAnswerIntentRecord;
+    }) => Promise<DurableInteractionAcknowledgement | null>;
+}
+/** Additive answer settlement primitive for wiring into `/interactions`.
+ * `attemptKey` belongs to the caller and is never generated from user data. */
+declare function createDurableInteractionSettlement(options: DurableInteractionSettlementFactoryOptions): DurableInteractionSettlement;
+/** Stable key helper exported for products implementing their own settlement
+ * loop. */
+declare function durableInteractionIntentKey(scope: DurableChatScope, interactionId: string, attemptKey: string): string;
+declare const applyDurableInteractionAsk: typeof upsertDurableInteractionAsk;
+declare const applyDurableInteractionCancel: typeof recordDurableInteractionCancel;
+declare const applyDurableInteractionAnswer: typeof recordDurableInteractionAnswer;
+
+interface DurableInteractionProjectionAdapter {
+    upsertAsk(request: InteractionRequestWire): Promise<void>;
+    cancel(cancel: InteractionCancelData): Promise<void>;
+    materialize(): Promise<InteractionPersistedPart[]>;
+}
+/** Binds an authorized durable scope/store to interaction lifecycle events. */
+declare function createDurableInteractionProjectionAdapter(options: {
+    store: DurablePlanStore;
+    scope: DurableChatScope;
+    now?: () => string;
+}): DurableInteractionProjectionAdapter;
+interface DurableChatEventProjection {
+    observe(event: unknown): void | Promise<void>;
+    materialize(): Array<Record<string, unknown>> | Promise<Array<Record<string, unknown>>>;
+}
+/** Event projector usable with any `ChatTurnRouteProducer` through
+ * `withDurableChatProjection`. It tracks this turn's identities so older
+ * thread state is not copied into every assistant message. */
+declare function createDurableChatEventProjection(options: {
+    store: DurablePlanStore;
+    scope: DurableChatScope;
+    now?: () => string;
+}): DurableChatEventProjection;
+interface PreparedDurableInteractionAnswer {
+    scope: DurableChatScope;
+    settlement: DurableInteractionSettlement;
+    intent: DurableAnswerIntentRecord;
+}
+interface DurableInteractionRoutePersistenceBase {
+    store: DurablePlanStore;
+    scope(args: DurableInteractionRouteArgs): DurableChatScope | Promise<DurableChatScope>;
+    now?: () => string;
+}
+type CreateDurableInteractionRoutePersistenceOptions = (DurableInteractionRoutePersistenceBase & {
+    guarantee: 'reconciled';
+    reconcileAuthority(args: {
+        scope: DurableChatScope;
+        intent: DurableAnswerIntentRecord;
+        route: DurableInteractionRouteArgs;
+    }): Promise<DurableInteractionAcknowledgement | null>;
+}) | (DurableInteractionRoutePersistenceBase & {
+    guarantee: 'best-effort';
+    reconcileAuthority?: (args: {
+        scope: DurableChatScope;
+        intent: DurableAnswerIntentRecord;
+        route: DurableInteractionRouteArgs;
+    }) => Promise<DurableInteractionAcknowledgement | null>;
+});
+/** Ready-to-use bridge from `/interactions` to the durable state port. Only
+ * the reconciled variant may claim crash-safe behavior; best-effort is
+ * explicit in both its type and persisted intent. */
+declare function createDurableInteractionRoutePersistence(options: CreateDurableInteractionRoutePersistenceOptions): DurableInteractionRoutePersistence<PreparedDurableInteractionAnswer>;
+
+type DurablePlanAuthorization = DurableChatScope | {
+    scope: DurableChatScope;
+} | Response | null | undefined;
+interface DurablePlanRouteAuthorizeArgs {
+    request: Request;
+    operation: 'current' | 'decide';
+    planId?: string;
+}
+interface DurablePlanRouteOptions {
+    store: DurablePlanStore;
+    authority: DurablePlanAuthority;
+    /** Authentication and resource authorization. Scope must be derived by the
+     * caller from trusted credentials, never from client JSON. */
+    authorize: (args: DurablePlanRouteAuthorizeArgs) => Promise<DurablePlanAuthorization> | DurablePlanAuthorization;
+    /** Required idempotent side effect seam. The route claims `effectKey` before
+     * calling it; a product must make the callback safe to retry by that key. */
+    afterDecision: (args: {
+        scope: DurableChatScope;
+        plan: DurablePlanProjection;
+        receipt: DurableFollowUpReceipt;
+        effectKey: string;
+    }) => Promise<void> | void;
+    now?: () => string;
+    logger?: Pick<Console, 'warn' | 'error'>;
+}
+interface DurablePlanRoutes {
+    current(request: Request): Promise<Response>;
+    decide(request: Request): Promise<Response>;
+}
+declare function createDurablePlanRoutes(options: DurablePlanRouteOptions): DurablePlanRoutes;
+
+export { type CreateDurableInteractionRoutePersistenceOptions, type DurableAnswerIntentJournal, type DurableAnswerIntentRecord, type DurableAnswerIntentState, DurableChatConflictError, DurableChatError, type DurableChatErrorCode, type DurableChatEventProjection, DurableChatGoneError, type DurableChatScope, type DurableChatStateStore, DurableChatUnavailableError, type DurableFollowUpReceipt, type DurableInteractionAcknowledgement, type DurableInteractionGuarantee, type DurableInteractionProjection, type DurableInteractionProjectionAdapter, type DurableInteractionSettlement, type DurableInteractionSettlementFactoryOptions, type DurableInteractionSettlementOptions, type DurablePlanAuthority, type DurablePlanAuthorityCurrentResult, type DurablePlanAuthorityDecision, type DurablePlanAuthorityResult, type DurablePlanAuthorization, type DurablePlanCommandJournal, type DurablePlanCommandKey, type DurablePlanCommandRecord, type DurablePlanCommandState, type DurablePlanDecision, type DurablePlanEffectRecord, type DurablePlanProjection, type DurablePlanRouteAuthorizeArgs, type DurablePlanRouteOptions, type DurablePlanRoutes, type DurablePlanStateStore, type DurablePlanStore, InMemoryDurableChatStateStore, InMemoryDurableChatStore, type PreparedDurableInteractionAnswer, applyDurableInteractionAnswer, applyDurableInteractionAsk, applyDurableInteractionCancel, createDurableChatEventProjection, createDurableChatScope, createDurableInteractionProjectionAdapter, createDurableInteractionRoutePersistence, createDurableInteractionSettlement, createDurablePlanRoutes, createInMemoryDurableChatStateStore, durableChatScopeKey, durableInteractionIntentKey, normalizePlanDecision, planAuthorityIdempotencyKey, planCommandKey, planEffectKey, recordDurableInteractionAnswer, recordDurableInteractionCancel, stablePlanReceipt, upsertDurableInteractionAsk };

package/dist/durable-chat/index.js

@@ -0,0 +1,59 @@
+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 "../chunk-XAWFPMAR.js";
+import "../chunk-SIXYZ2FB.js";
+export {
+  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
+};
+//# sourceMappingURL=index.js.map

package/dist/durable-chat/index.js.map

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

package/dist/index.d.ts

@@ -17,12 +17,14 @@ 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 ChatMessagePart, d as ChatNoticePart, e as ChatPartTime, f as ChatReasoningPart, g as ChatStepFinishPart, h as ChatStepStartPart, i as ChatSubtaskPart, j as ChatTextPart, k as ChatToolPart, l as ChatToolState, m as ChatToolStatus, n as ChatUsageTokens, S as StorableHarnessPartKind, o as isChatInteractionPart, p as isChatStepFinishPart, q as isChatTextPart, r as isChatToolPart, t as toChatMessageParts } from './parts-BcbitSNp.js';
+export { C as ChatFilePart, a as ChatImagePart, b as ChatInteractionPart, c as ChatMessagePart, d as ChatNoticePart, e as ChatPartTime, f as ChatPlanPart, g as ChatReasoningPart, h as ChatStepFinishPart, i as ChatStepStartPart, j as ChatSubtaskPart, k as ChatTextPart, l as ChatToolPart, m as ChatToolState, n as ChatToolStatus, o as ChatUsageTokens, S as StorableHarnessPartKind, p as isChatInteractionPart, q as isChatPlanPart, r as isChatStepFinishPart, s as isChatTextPart, t as isChatToolPart, u as toChatMessageParts } from './parts-DjX0RRTS.js';
 export { DeriveKeyOptions, createFieldCrypto, decodeHexKey, decryptAesGcm, decryptBytes, decryptWithKey, deriveKey, encryptAesGcm, encryptBytes, encryptWithKey } from './crypto/index.js';
 export { BufferedTurnEvent, BufferedTurnOptions, BufferedTurnTap, D1LikeForTurns, JsonRecord, PersistedChatMessageForTurn, PumpBufferedTurnOptions, ReplayTurnEventsOptions, ResolvedChatTurn, StreamEvent, TURN_EVENTS_MIGRATION_SQL, TURN_STATUS_SCOPE_MIGRATION_SQL, TurnEventStore, TurnStatus, asRecord, asString, buildUserTextParts, coalesceChatStreamEvents, coalesceDeltas, createBufferedTurnTap, createD1TurnEventStore, createMemoryTurnEventStore, encodeEvent, finalizeAssistantParts, getPartKey, mergePersistedPart, messageHasTurnId, normalizeClientTurnId, normalizePersistedPart, normalizeTime, normalizeToolEvent, pumpBufferedTurn, replayTurnEvents, resolveChatTurn, resolveToolId, resolveToolName } from './stream/index.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 InteractionCancelData, h as InteractionPersistedPart, i as InteractionRequestWire, 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';
-export { InteractionAnswerBodyValidation, InteractionAnswerRoute, InteractionAnswerRouteOptions, InteractionClientOutcome, InteractionConnectionResolution, InteractionRouteLogger, ResolveInteractionConnectionArgs, SidecarInteractionsConnection, SidecarInteractionsError, SidecarInteractionsResult, createInteractionAnswerRoute, listSessionInteractions, mapInteractionRespondFailure, respondToSessionInteraction, validateInteractionAnswerBody } from './interactions/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';
+export { BeforeInteractionAnswerArgs, DurableInteractionRouteArgs, DurableInteractionRoutePersistence, InteractionAnswerBodyValidation, InteractionAnswerRoute, InteractionAnswerRouteOptions, InteractionClientOutcome, InteractionConnectionResolution, InteractionRouteLogger, ResolveInteractionConnectionArgs, SidecarInteractionsConnection, SidecarInteractionsError, SidecarInteractionsResult, createInteractionAnswerRoute, listSessionInteractions, mapInteractionRespondFailure, respondToSessionInteraction, validateInteractionAnswerBody } from './interactions/index.js';
+export { ChatPlan, ChatPlanPersistedPart, ChatPlanStatus, PLAN_SUBMITTED_EVENT, ParsePlanSubmittedResult, canTransitionPlanStatus, parsePlanSubmittedEvent, persistedPartToPlan, planFollowUpTurnId, planPartKey, planRevisionKey, planToPersistedPart } from './plans/index.js';
+export { CreateDurableInteractionRoutePersistenceOptions, DurableAnswerIntentJournal, DurableAnswerIntentRecord, DurableAnswerIntentState, DurableChatConflictError, DurableChatError, DurableChatErrorCode, DurableChatEventProjection, DurableChatGoneError, DurableChatScope, DurableChatStateStore, DurableChatUnavailableError, DurableFollowUpReceipt, DurableInteractionAcknowledgement, DurableInteractionGuarantee, DurableInteractionProjection, DurableInteractionProjectionAdapter, DurableInteractionSettlement, DurableInteractionSettlementFactoryOptions, DurableInteractionSettlementOptions, DurablePlanAuthority, DurablePlanAuthorityCurrentResult, DurablePlanAuthorityDecision, DurablePlanAuthorityResult, DurablePlanAuthorization, DurablePlanCommandJournal, DurablePlanCommandKey, DurablePlanCommandRecord, DurablePlanCommandState, DurablePlanDecision, DurablePlanEffectRecord, DurablePlanProjection, DurablePlanRouteAuthorizeArgs, DurablePlanRouteOptions, DurablePlanRoutes, DurablePlanStateStore, DurablePlanStore, InMemoryDurableChatStateStore, InMemoryDurableChatStore, PreparedDurableInteractionAnswer, applyDurableInteractionAnswer, applyDurableInteractionAsk, applyDurableInteractionCancel, createDurableChatEventProjection, createDurableChatScope, createDurableInteractionProjectionAdapter, createDurableInteractionRoutePersistence, createDurableInteractionSettlement, createDurablePlanRoutes, createInMemoryDurableChatStateStore, durableChatScopeKey, durableInteractionIntentKey, normalizePlanDecision, planAuthorityIdempotencyKey, planCommandKey, planEffectKey, recordDurableInteractionAnswer, recordDurableInteractionCancel, stablePlanReceipt, upsertDurableInteractionAsk } from './durable-chat/index.js';
 export { CompleteMissionInput, CreateMissionInput, DEFAULT_MISSION_STEP_KINDS, InMemoryMissionStore, MISSION_CONTROL_CHANNEL_ID, MissionApprovalsPort, MissionAuditEvent, MissionConcurrencyError, MissionCostLedger, MissionEngine, MissionEngineOptions, MissionEventSink, MissionGateKind, MissionGateOptions, MissionGateProposal, MissionOutcome, MissionPlanRunOptions, MissionProposalResolution, MissionRecord, MissionService, MissionServiceOptions, MissionState, MissionStatus, MissionStep, MissionStepState, MissionStepStatus, MissionStorePort, MissionStreamEvent, MissionStreamStatus, MissionStreamStep, MissionStreamStepStatus, MissionUpdateGuard, MissionUpdatePatch, ParseMissionBlocksOptions, ParsedMission, ParsedMissionStep, PlanOutcome, RetryableStepError, SandboxDispatch, SandboxDispatchDoneResult, SandboxDispatchInProgressResult, SandboxDispatchInput, SandboxDispatchResult, SetStepStatusPatch, StepGateClassification, StepOutcome, applyMissionEvent, asMissionStreamEvent, budgetGateProposalId, buildAgentMissionPlan, createInMemoryMissionStore, createMissionEngine, createMissionService, isMissionStopRequested, isMissionTerminal, mergeMissionState, noopEventSink, parseMissionBlocks, parseSessionStreamEnvelope, reduceMissionEvents, stepGateProposalId, volumeGateProposalId } from './missions/index.js';
 export { S as StepAgentActivity, W as WithAgentActivity, s as stepAgentActivity } from './agent-activity-C8ZG0F0M.js';
 export { AppToolDescriptor, AuthenticatedSandboxUser, BuildAppToolMcpServersOptions, BuildSandboxToolFileMountsOptions, DEFAULT_SANDBOX_RESOURCES, DriveSandboxTurnOptions, ENV_TOTAL_MAX_BYTES, ENV_VALUE_MAX_BYTES, EnsureWorkspaceSandboxOptions, LivenessProbeConfig, MemberSyncSeam, Outcome, PROVISION_PAYLOAD_MAX_BYTES, ProfileComposeOptions, PromptInputPart, ProviderResolutionConfig, ProvisionPayloadSections, ProvisionProfileSection, ResolveSandboxClientCredentialsOptions, ResolvedModel, SandboxApiCredentials, SandboxBuildContext, SandboxClientCredentials, SandboxCredentialEnvironment, SandboxPermissionLevel, SandboxResourceConfig, SandboxRestoreSpec, SandboxRuntimeAuthRefreshError, SandboxRuntimeConfig, SandboxRuntimeConnection, SandboxScope, SandboxStepTransition, SandboxTerminalTokenOptions, SandboxTerminalTokenResult, SandboxTerminalTokenSubject, SandboxTerminalWsMatch, SandboxToolPathOptions, SandboxToolSpec, ScopedTokenResult, SecretStore, StoppedSandboxResumeFailure, StoppedSandboxResumeRecovery, StreamSandboxPromptOptions, TerminalProxyIdentity, WorkspaceSandboxConnectionArgs, WorkspaceSandboxConnectionHandlerOptions, WorkspaceSandboxEnsureContext, WorkspaceSandboxInstanceLike, WorkspaceSandboxManager, WorkspaceSandboxManagerOptions, WorkspaceSandboxRuntimeProxyArgs, WorkspaceSandboxRuntimeProxyHandlerOptions, WorkspaceSandboxTerminalUpgradeHandlerOptions, WriteProfileFilesOptions, assertEnvWithinLimits, assertProvisionPayloadWithinCap, attachReasoningEffort, bearerSubprotocolToken, bearerToken, buildAppToolMcpServers, buildSandboxRuntimeProxyHeaders, buildSandboxToolFileMounts, buildSandboxToolPathSetupScript, classifySeveredStream, createSandboxTerminalToken, createWorkspaceSandboxConnectionHandler, createWorkspaceSandboxManager, createWorkspaceSandboxRuntimeProxyHandler, createWorkspaceSandboxTerminalUpgradeHandler, deferredCorpusHash, deleteSecret, detectInteractiveQuestion, driveSandboxTurn, encodeSandboxRuntimePath, ensureWorkspaceSandbox, flattenHistory, getClient, isSandboxTerminalWsUpgrade, isTerminalPromptEvent, matchSandboxTerminalWsPath, mergeExtraMcp, mergeHistoryIntoParts, mintSandboxScopedToken, mintTerminalProxyToken, readSecret, resetClientCache, resolveModel, resolveSandboxClientCredentials, runSandboxPrompt, runSandboxToolPathSetup, sandboxToolBinDir, sandboxToolPath, sandboxToolRootDir, secretStoreFromClient, splitDeferredProfileFiles, storeSecret, streamSandboxPrompt, syncSandboxMemberAdd, syncSandboxMemberRemove, syncSandboxMemberRole, terminalTokenFromRequest, verifySandboxTerminalToken, verifyTerminalProxyToken, writeProfileFilesToBox } from './sandbox/index.js';