@granular-software/sdk 0.4.57 → 0.4.59

package/dist/{client-BKde5VzV.d.ts → client-BHhqFMeU.d.ts}

@@ -1,19 +1,23 @@
-import { bM as WSClientOptions, a2 as GranularQuotaProgress, T as ToolWithHandler, f as PublishToolsResult, aO as Job, g as ToolHandler, I as InstanceToolHandler, aY as ConversationMessageInput, aZ as ConversationAppendResult, aB as EffectInfo, P as Prompt, aA as ToolInfo, aD as EffectsChangedEvent, aC as ToolsChangedEvent, D as DomainState, y as GranularOptions, ci as EnvironmentImporter, B as RecordUserOptions, U as User, H as OpenEnvironmentOptions, af as EnvironmentData, ac as BuildPolicy, cf as EnvironmentSetupSummary, W as ConversationSessionListOptions, Q as ConversationSessionInfo, L as CreateSessionOptions, bW as RecordObjectOptions, c1 as RecordObjectResult, c3 as RecordObjectsOptions, ca as RecordImport, c6 as RecordImportStatus, c9 as RecordImportItem, cb as EnvironmentRecordImportSummary, aM as EnvironmentFeedbackRecord, c as SessionHeapSnapshot, bA as SessionDocumentResult, bB as SessionCollectionListOptions, bD as SessionCollectionListResult, a_ as SessionConversationMessage, a$ as SessionTimelineEvent, bC as SessionJobListOptions, bt as SessionJobRecord, b8 as SessionArtifactListOptions, b7 as SessionArtifactRecord, b9 as SessionArtifactValidationResult, bb as SessionArtifactExecutionOptions, ba as SessionArtifactExecutionResult, bc as SessionArtifactApprovalOptions, bm as RecordManualActionInput, bo as ManualActionRecordResult, bp as ManualActionListOptions, bn as ManualActionOccurrence, br as ManualActionSuggestionOptions, bq as ManualActionSuggestion, bf as ArtifactApprovalTaskListOptions, be as ArtifactApprovalTask, bg as ArtifactApprovalDecisionInput, bh as ArtifactApprovalDecisionResult, b3 as SessionFileRecord, bs as SessionFileUploadOptions, S as SessionHeapEntry, b as SessionHeapList, bw as SessionHeapVariable, d as SessionTranscriptEntry, cM as GraphQLResult, by as RecordSearchOptions, bx as RecordSearchResult, bz as RecordMentionInput, bV as DefineRelationshipOptions, bU as RelationshipInfo, bT as ModelRef, cL as ManifestContent, b_ as EnvironmentStateUpdateInput, bY as EnvironmentStateTarget, c0 as EnvironmentStateProxy, c5 as RecordImportOptions, bI as UserEnvironmentStateOptions, bH as UserEnvironmentState, bJ as MarkUserEnvironmentReadOptions, J as AdoptEnvironmentOptions, K as ConnectOptions, cd as RunEnvironmentImporterOptions, l as OpenAIUsageSpendEvent, G as GranularSpendContext, o as RecordOpenAIUsageSpendResult, a5 as SandboxListResponse, a3 as Sandbox, a4 as CreateSandboxData, cO as DeleteResponse, a7 as PermissionProfile, a8 as CreatePermissionProfileData, ag as CreateEnvironmentData, cP as StreamEvent, cQ as StreamSubscription, cR as StreamStats, F as Subject, ab as AssignmentListResponse } from './spend-DpRRCrAr.js';
+import { cN as WSClientOptions, Y as SessionFeedApi, a$ as GranularQuotaProgress, T as ToolWithHandler, g as PublishToolsResult, bP as Job, h as ToolHandler, I as InstanceToolHandler, bS as UserMessageInput, bT as UserMessageAppendResult, bC as EffectInfo, P as Prompt, bB as ToolInfo, bE as EffectsChangedEvent, bD as ToolsChangedEvent, D as DomainState, $ as FeedListTransport, aI as GranularOptions, dj as EnvironmentImporter, aL as RecordUserOptions, aK as User, aN as OpenEnvironmentOptions, bc as EnvironmentData, b9 as BuildPolicy, dg as EnvironmentSetupSummary, aT as ConversationSessionListOptions, aR as ConversationSessionInfo, aQ as CreateSessionOptions, cX as RecordObjectOptions, d2 as RecordObjectResult, d4 as RecordObjectsOptions, db as RecordImport, d7 as RecordImportStatus, da as RecordImportItem, dc as EnvironmentRecordImportSummary, bN as EnvironmentFeedbackRecord, d as SessionHeapSnapshot, cB as SessionDocumentResult, bU as AssistantReplyPublicationInput, bV as AssistantReplyPublicationResult, cC as SessionCollectionListOptions, cE as SessionCollectionListResult, bY as SessionTimelineEvent, cD as SessionJobListOptions, cu as SessionJobRecord, c5 as SessionArtifactListOptions, c4 as SessionArtifactRecord, c7 as SessionArtifactRelationshipOptionsInput, c9 as SessionArtifactRelationshipOptionsResult, ca as SessionArtifactRelationshipCreateInput, c6 as SessionArtifactValidationResult, cc as SessionArtifactExecutionOptions, cb as SessionArtifactExecutionResult, cd as SessionArtifactApprovalOptions, cn as RecordManualActionInput, cp as ManualActionRecordResult, cq as ManualActionListOptions, co as ManualActionOccurrence, cs as ManualActionSuggestionOptions, cr as ManualActionSuggestion, cg as ArtifactApprovalTaskListOptions, cf as ArtifactApprovalTask, ch as ArtifactApprovalDecisionInput, ci as ArtifactApprovalDecisionResult, c0 as SessionFileRecord, ct as SessionFileUploadOptions, S as SessionHeapEntry, b as SessionHeapList, cx as SessionHeapVariable, e as SessionTranscriptEntry, dO as GraphQLResult, cz as RecordSearchOptions, cy as RecordSearchResult, cA as RecordMentionInput, cW as DefineRelationshipOptions, cV as RelationshipInfo, cU as ModelRef, dN as ManifestContent, c$ as EnvironmentStateUpdateInput, cZ as EnvironmentStateTarget, d1 as EnvironmentStateProxy, d6 as RecordImportOptions, cJ as UserEnvironmentStateOptions, cI as UserEnvironmentState, cK as MarkUserEnvironmentReadOptions, aO as AdoptEnvironmentOptions, aP as ConnectOptions, de as RunEnvironmentImporterOptions, au as OpenAIUsageSpendEvent, at as GranularSpendContext, aw as RecordOpenAIUsageSpendResult, b2 as SandboxListResponse, b0 as Sandbox, b1 as CreateSandboxData, dQ as DeleteResponse, b4 as PermissionProfile, b5 as CreatePermissionProfileData, bd as CreateEnvironmentData, dR as StreamEvent, dS as StreamSubscription, dT as StreamStats, aM as Subject, b8 as AssignmentListResponse } from './spend-3DNM1u9N.js';
 import * as Automerge from '@automerge/automerge';
 import { Doc } from '@automerge/automerge/slim';
 
+interface CanonicalDocumentQuarantine {
+    documentEpoch: number;
+    documentRevision: number;
+    error: Error;
+}
 declare class WSClient {
     private ws;
     private url;
     private sessionId;
     private token;
     private messageQueue;
-    private syncHandlers;
     private rpcHandlers;
     private eventHandlers;
+    private canonicalDocumentQuarantineHandlers;
     private nextRpcId;
     doc: Automerge.Doc<Record<string, unknown>>;
-    private syncState;
     private reconnectTimer;
     private tokenRefreshTimer;
     private isExplicitlyDisconnected;
@@ -21,6 +25,8 @@ declare class WSClient {
     private connectPromise;
     private connectionEpoch;
     private cancelConnectAttempt;
+    private documentRepairRequired;
+    private canonicalDocumentActivated;
     private options;
     constructor(options: WSClientOptions);
     get currentSessionId(): string;
@@ -39,12 +45,25 @@ declare class WSClient {
     connect(options?: {
         signal?: AbortSignal;
     }): Promise<void>;
+    /**
+     * Mark the current transport as unusable and schedule the normal reconnect
+     * path. Browser WebSockets can remain in OPEN state after a proxy/worker
+     * restart, so a timed-out heartbeat must revoke the stale socket explicitly.
+     */
+    reportTransportFailure(reason?: unknown): void;
     private connectAttempt;
     private normalizeReason;
     private rejectPending;
     private emitReconnectErrorMessage;
     private scheduleReconnectAttempt;
     private buildDisconnectError;
+    private decodeDocumentBytes;
+    private rememberCanonicalActivation;
+    private canAcceptDocumentReplacement;
+    private exposeCanonicalQuarantine;
+    private canonicalReplacementError;
+    private assertIncrementalDocumentIsSafe;
+    private requireDocumentResync;
     private handleDisconnect;
     private handleMessage;
     /**
@@ -62,6 +81,13 @@ declare class WSClient {
      * @param {Function} handler - Event handler
      */
     on(event: string, handler: (params: unknown) => void): void;
+    /**
+     * Subscribe to rejected canonical replacement metadata without exposing the
+     * malformed document through the public sync stream.
+     *
+     * @internal Session uses this to quarantine only its feed projection.
+     */
+    onCanonicalDocumentQuarantine(handler: (quarantine: CanonicalDocumentQuarantine) => void): () => void;
     /**
      * Register an RPC handler for incoming server requests
      * @param {string} method - RPC method name
@@ -93,7 +119,6 @@ declare class Session {
     private clientId;
     private initialQuota;
     private jobsMap;
-    private pendingAgentMessagesByJobId;
     private eventListeners;
     private toolHandlers;
     /** Tracks which tools are instance methods (className set, not static) */
@@ -110,12 +135,22 @@ declare class Session {
     private domainPackagePartCache;
     private domainPackagePartPromises;
     private domainPackageFetchQueue;
+    private readonly feedController;
+    readonly feed: SessionFeedApi;
     constructor(client: WSClient, clientId?: string, options?: {
         initialQuota?: GranularQuotaProgress | null;
     });
     private extractDomainRevisionFromDoc;
-    private buildLegacyEffectContext;
-    private stringifyConversationValue;
+    /**
+     * Prompt delivery is deliberately event-driven while a socket is live, but
+     * an existing session can be attached from a fresh tab/client after the
+     * event was originally sent. Rebuild that client's prompt cache from the
+     * canonical document on every sync so an open durable prompt remains
+     * actionable after reconnect without manufacturing a second prompt.
+     */
+    private reconcilePromptCacheFromCanonicalDocument;
+    private buildDirectedInvocationEffectContext;
+    private createDirectedInvocationFeedbackContext;
     get document(): Doc<Record<string, unknown>>;
     get quota(): GranularQuotaProgress | null;
     getQuota(): GranularQuotaProgress | null;
@@ -195,7 +230,7 @@ declare class Session {
      * Respond to a prompt request from the sandbox
      */
     answerPrompt(promptId: string, answer: unknown): Promise<void>;
-    appendConversationMessage(input: ConversationMessageInput): Promise<ConversationAppendResult>;
+    appendUserMessage(input: UserMessageInput): Promise<UserMessageAppendResult>;
     /**
      * Get the current list of available effects.
      * Consolidates effect declarations and live availability for the session.
@@ -252,6 +287,8 @@ declare class Session {
      * Close the session and disconnect from the sandbox
      */
     disconnect(): Promise<void>;
+    /** Stop feed repair work without detaching a reconnectable transport. */
+    protected disposeSessionFeed(): void;
     /**
      * Subscribe to session events
      */
@@ -260,6 +297,7 @@ declare class Session {
      * Unsubscribe from session events
      */
     off(event: string, handler: (data: unknown) => void): void;
+    protected setFeedListTransport(transport: FeedListTransport | null): void;
     private setupToolInvokeHandler;
     private setupEventHandlers;
     protected emit(event: string, data: unknown): void;
@@ -270,6 +308,7 @@ declare class Session {
 }
 
 type SessionFileUploadBody = Blob | ArrayBuffer | Uint8Array | string;
+type SessionDataHeaders = any;
 type EnvironmentImporterHandler = (importer: EnvironmentImporter) => Promise<void> | void;
 /**
  * Environment is the sessionless handle for one resolved ontology environment.
@@ -330,11 +369,11 @@ declare class Environment {
         }) => Promise<EnvironmentSession>;
         close: (sessionId: string, session?: EnvironmentSession | null) => Promise<void>;
         state: (options?: UserEnvironmentStateOptions) => Promise<UserEnvironmentState>;
-        markRead: (options: MarkUserEnvironmentReadOptions) => Promise<UserEnvironmentState["readAtBySessionId"]>;
+        markRead: (options: MarkUserEnvironmentReadOptions) => Promise<UserEnvironmentState["readThroughSequenceBySessionId"]>;
     };
     get userEnvironmentState(): {
         get: (options?: UserEnvironmentStateOptions) => Promise<UserEnvironmentState>;
-        markRead: (options: MarkUserEnvironmentReadOptions) => Promise<UserEnvironmentState["readAtBySessionId"]>;
+        markRead: (options: MarkUserEnvironmentReadOptions) => Promise<UserEnvironmentState["readThroughSequenceBySessionId"]>;
     };
     get data(): {
         record: (record: RecordObjectOptions) => Promise<RecordObjectResult>;
@@ -387,7 +426,7 @@ declare class Environment {
     listSessions(status?: ConversationSessionListOptions["status"]): Promise<ConversationSessionInfo[]>;
     listSessions(options?: Omit<ConversationSessionListOptions, "environmentId" | "sandboxId" | "subjectId">): Promise<ConversationSessionInfo[]>;
     getUserEnvironmentState(options?: UserEnvironmentStateOptions): Promise<UserEnvironmentState>;
-    markUserEnvironmentSessionsRead(options: MarkUserEnvironmentReadOptions): Promise<UserEnvironmentState["readAtBySessionId"]>;
+    markUserEnvironmentSessionsRead(options: MarkUserEnvironmentReadOptions): Promise<UserEnvironmentState["readThroughSequenceBySessionId"]>;
     createSession(options?: CreateSessionOptions): Promise<EnvironmentSession>;
     connectSession(sessionId: string, options?: {
         clientId?: string;
@@ -697,6 +736,9 @@ declare class Environment {
 declare class EnvironmentSession extends Session {
     readonly environment: Environment;
     private readonly sessionDataRoutePrefix;
+    private readonly sessionDataHeaders;
+    private heartbeatTimer;
+    private heartbeatInFlight;
     /** The last known graph container status, updated by checkReadiness() or on heartbeat */
     graphContainerStatus: {
         lastKeepAliveAt: number;
@@ -704,8 +746,32 @@ declare class EnvironmentSession extends Session {
     } | null;
     constructor(client: WSClient, environment: Environment, clientId: string, options?: {
         sessionDataRoutePrefix?: string;
+        /**
+         * Browser-only request metadata forwarded with session-data mutations.
+         * This lets a session direct a frontend effect to the exact Dock client
+         * that initiated a user action when multiple tabs are connected.
+         */
+        sessionDataHeaders?: SessionDataHeaders;
         initialQuota?: GranularQuotaProgress | null;
     });
+    /**
+     * Keep the browser session transport observable from the client side.
+     * A worker/proxy restart can leave a browser WebSocket appearing OPEN even
+     * though the server-side Durable Object has already closed its peer. The
+     * heartbeat gives the SDK a bounded failure signal so it can revoke that
+     * stale socket and use WSClient's normal reconnect path.
+     */
+    private startHeartbeat;
+    private stopHeartbeat;
+    hello(): Promise<{
+        ok: boolean;
+        environmentId?: string;
+        docId?: string;
+        graphContainerStatus?: {
+            lastKeepAliveAt: number;
+            status: "warming" | "hot" | "unknown";
+        };
+    }>;
     get environmentId(): string;
     get sandboxId(): string;
     get ontologyId(): string;
@@ -739,17 +805,21 @@ declare class EnvironmentSession extends Session {
     private buildSessionDataUrl;
     private sessionDataFetch;
     private sessionDataRequest;
-    private collectAllSessionItems;
     /**
      * Fetch the live session document from the runtime DO.
      *
-     * For history and saved artifacts, prefer the collection APIs on
-     * `messages`, `timeline`, `jobs`, and `heap`.
+     * For presentation history use `feed.list()` or `transcript.list()`.
+     * Timeline and job collections are diagnostic/execution data only.
      */
     getDocument(): Promise<SessionDocumentResult>;
-    get messages(): {
-        list: (options?: SessionCollectionListOptions) => Promise<SessionCollectionListResult<SessionConversationMessage>>;
-    };
+    /**
+     * Publish one terminal assistant reply from a trusted server integration.
+     *
+     * This uses the API-key-authenticated HTTP session boundary. Delegated
+     * browser sessions cannot use it and never receive assistant feed-authoring
+     * capability through their WebSocket.
+     */
+    publishAssistantReply(input: AssistantReplyPublicationInput): Promise<AssistantReplyPublicationResult>;
     get timeline(): {
         list: (options?: SessionCollectionListOptions) => Promise<SessionCollectionListResult<SessionTimelineEvent>>;
     };
@@ -765,11 +835,14 @@ declare class EnvironmentSession extends Session {
         create: (artifact: Partial<SessionArtifactRecord> & {
             label: string;
         }) => Promise<SessionArtifactRecord>;
+        acceptSuggestion: (sequence: number) => Promise<SessionArtifactRecord>;
         updateInputs: (artifactId: string, patch: {
             inputValues?: Record<string, unknown>;
             relationships?: Record<string, string | string[] | null>;
             expectedUpdatedAt?: number;
         }) => Promise<SessionArtifactRecord>;
+        relationshipOptions: (artifactId: string, input: SessionArtifactRelationshipOptionsInput) => Promise<SessionArtifactRelationshipOptionsResult>;
+        relationshipCreate: (artifactId: string, input: SessionArtifactRelationshipCreateInput) => Promise<SessionArtifactRecord>;
         validate: (artifactId: string) => Promise<SessionArtifactValidationResult>;
         execute: (artifactId: string, options: SessionArtifactExecutionOptions) => Promise<SessionArtifactExecutionResult>;
         approve: (artifactId: string, options: SessionArtifactApprovalOptions) => Promise<SessionArtifactExecutionResult>;
@@ -1031,7 +1104,7 @@ declare class Granular {
     }): Promise<UserEnvironmentState>;
     markUserEnvironmentSessionsRead(options: MarkUserEnvironmentReadOptions & {
         environmentId: string;
-    }): Promise<UserEnvironmentState["readAtBySessionId"]>;
+    }): Promise<UserEnvironmentState["readThroughSequenceBySessionId"]>;
     private normalizeConversationSession;
     private normalizeUserEnvironmentState;
     private static coerceIsoDate;
@@ -1057,10 +1130,7 @@ declare class Granular {
     recordOpenAIUsageSpend(usage: OpenAIUsageSpendEvent, context?: GranularSpendContext | null, options?: {
         metadata?: Record<string, unknown> | null;
     }): Promise<RecordOpenAIUsageSpendResult>;
-    /**
-     * Mark a session closed in the control plane. If `environment` is the connected handle for that
-     * `sessionId`, disconnects the WebSocket so the runtime tears down cleanly.
-     */
+    /** End a session through the runtime, or disconnect its connected handle. */
     closeSession(sessionId: string, environment?: EnvironmentSession | null): Promise<void>;
     /**
      * Re-open a closed session in the index and connect to its existing runtime document.

package/dist/{client-DL4S9uRc.d.mts → client-aWpvZfX4.d.mts}

@@ -1,19 +1,23 @@
-import { bM as WSClientOptions, a2 as GranularQuotaProgress, T as ToolWithHandler, f as PublishToolsResult, aO as Job, g as ToolHandler, I as InstanceToolHandler, aY as ConversationMessageInput, aZ as ConversationAppendResult, aB as EffectInfo, P as Prompt, aA as ToolInfo, aD as EffectsChangedEvent, aC as ToolsChangedEvent, D as DomainState, y as GranularOptions, ci as EnvironmentImporter, B as RecordUserOptions, U as User, H as OpenEnvironmentOptions, af as EnvironmentData, ac as BuildPolicy, cf as EnvironmentSetupSummary, W as ConversationSessionListOptions, Q as ConversationSessionInfo, L as CreateSessionOptions, bW as RecordObjectOptions, c1 as RecordObjectResult, c3 as RecordObjectsOptions, ca as RecordImport, c6 as RecordImportStatus, c9 as RecordImportItem, cb as EnvironmentRecordImportSummary, aM as EnvironmentFeedbackRecord, c as SessionHeapSnapshot, bA as SessionDocumentResult, bB as SessionCollectionListOptions, bD as SessionCollectionListResult, a_ as SessionConversationMessage, a$ as SessionTimelineEvent, bC as SessionJobListOptions, bt as SessionJobRecord, b8 as SessionArtifactListOptions, b7 as SessionArtifactRecord, b9 as SessionArtifactValidationResult, bb as SessionArtifactExecutionOptions, ba as SessionArtifactExecutionResult, bc as SessionArtifactApprovalOptions, bm as RecordManualActionInput, bo as ManualActionRecordResult, bp as ManualActionListOptions, bn as ManualActionOccurrence, br as ManualActionSuggestionOptions, bq as ManualActionSuggestion, bf as ArtifactApprovalTaskListOptions, be as ArtifactApprovalTask, bg as ArtifactApprovalDecisionInput, bh as ArtifactApprovalDecisionResult, b3 as SessionFileRecord, bs as SessionFileUploadOptions, S as SessionHeapEntry, b as SessionHeapList, bw as SessionHeapVariable, d as SessionTranscriptEntry, cM as GraphQLResult, by as RecordSearchOptions, bx as RecordSearchResult, bz as RecordMentionInput, bV as DefineRelationshipOptions, bU as RelationshipInfo, bT as ModelRef, cL as ManifestContent, b_ as EnvironmentStateUpdateInput, bY as EnvironmentStateTarget, c0 as EnvironmentStateProxy, c5 as RecordImportOptions, bI as UserEnvironmentStateOptions, bH as UserEnvironmentState, bJ as MarkUserEnvironmentReadOptions, J as AdoptEnvironmentOptions, K as ConnectOptions, cd as RunEnvironmentImporterOptions, l as OpenAIUsageSpendEvent, G as GranularSpendContext, o as RecordOpenAIUsageSpendResult, a5 as SandboxListResponse, a3 as Sandbox, a4 as CreateSandboxData, cO as DeleteResponse, a7 as PermissionProfile, a8 as CreatePermissionProfileData, ag as CreateEnvironmentData, cP as StreamEvent, cQ as StreamSubscription, cR as StreamStats, F as Subject, ab as AssignmentListResponse } from './spend-DpRRCrAr.mjs';
+import { cN as WSClientOptions, Y as SessionFeedApi, a$ as GranularQuotaProgress, T as ToolWithHandler, g as PublishToolsResult, bP as Job, h as ToolHandler, I as InstanceToolHandler, bS as UserMessageInput, bT as UserMessageAppendResult, bC as EffectInfo, P as Prompt, bB as ToolInfo, bE as EffectsChangedEvent, bD as ToolsChangedEvent, D as DomainState, $ as FeedListTransport, aI as GranularOptions, dj as EnvironmentImporter, aL as RecordUserOptions, aK as User, aN as OpenEnvironmentOptions, bc as EnvironmentData, b9 as BuildPolicy, dg as EnvironmentSetupSummary, aT as ConversationSessionListOptions, aR as ConversationSessionInfo, aQ as CreateSessionOptions, cX as RecordObjectOptions, d2 as RecordObjectResult, d4 as RecordObjectsOptions, db as RecordImport, d7 as RecordImportStatus, da as RecordImportItem, dc as EnvironmentRecordImportSummary, bN as EnvironmentFeedbackRecord, d as SessionHeapSnapshot, cB as SessionDocumentResult, bU as AssistantReplyPublicationInput, bV as AssistantReplyPublicationResult, cC as SessionCollectionListOptions, cE as SessionCollectionListResult, bY as SessionTimelineEvent, cD as SessionJobListOptions, cu as SessionJobRecord, c5 as SessionArtifactListOptions, c4 as SessionArtifactRecord, c7 as SessionArtifactRelationshipOptionsInput, c9 as SessionArtifactRelationshipOptionsResult, ca as SessionArtifactRelationshipCreateInput, c6 as SessionArtifactValidationResult, cc as SessionArtifactExecutionOptions, cb as SessionArtifactExecutionResult, cd as SessionArtifactApprovalOptions, cn as RecordManualActionInput, cp as ManualActionRecordResult, cq as ManualActionListOptions, co as ManualActionOccurrence, cs as ManualActionSuggestionOptions, cr as ManualActionSuggestion, cg as ArtifactApprovalTaskListOptions, cf as ArtifactApprovalTask, ch as ArtifactApprovalDecisionInput, ci as ArtifactApprovalDecisionResult, c0 as SessionFileRecord, ct as SessionFileUploadOptions, S as SessionHeapEntry, b as SessionHeapList, cx as SessionHeapVariable, e as SessionTranscriptEntry, dO as GraphQLResult, cz as RecordSearchOptions, cy as RecordSearchResult, cA as RecordMentionInput, cW as DefineRelationshipOptions, cV as RelationshipInfo, cU as ModelRef, dN as ManifestContent, c$ as EnvironmentStateUpdateInput, cZ as EnvironmentStateTarget, d1 as EnvironmentStateProxy, d6 as RecordImportOptions, cJ as UserEnvironmentStateOptions, cI as UserEnvironmentState, cK as MarkUserEnvironmentReadOptions, aO as AdoptEnvironmentOptions, aP as ConnectOptions, de as RunEnvironmentImporterOptions, au as OpenAIUsageSpendEvent, at as GranularSpendContext, aw as RecordOpenAIUsageSpendResult, b2 as SandboxListResponse, b0 as Sandbox, b1 as CreateSandboxData, dQ as DeleteResponse, b4 as PermissionProfile, b5 as CreatePermissionProfileData, bd as CreateEnvironmentData, dR as StreamEvent, dS as StreamSubscription, dT as StreamStats, aM as Subject, b8 as AssignmentListResponse } from './spend-3DNM1u9N.mjs';
 import * as Automerge from '@automerge/automerge';
 import { Doc } from '@automerge/automerge/slim';
 
+interface CanonicalDocumentQuarantine {
+    documentEpoch: number;
+    documentRevision: number;
+    error: Error;
+}
 declare class WSClient {
     private ws;
     private url;
     private sessionId;
     private token;
     private messageQueue;
-    private syncHandlers;
     private rpcHandlers;
     private eventHandlers;
+    private canonicalDocumentQuarantineHandlers;
     private nextRpcId;
     doc: Automerge.Doc<Record<string, unknown>>;
-    private syncState;
     private reconnectTimer;
     private tokenRefreshTimer;
     private isExplicitlyDisconnected;
@@ -21,6 +25,8 @@ declare class WSClient {
     private connectPromise;
     private connectionEpoch;
     private cancelConnectAttempt;
+    private documentRepairRequired;
+    private canonicalDocumentActivated;
     private options;
     constructor(options: WSClientOptions);
     get currentSessionId(): string;
@@ -39,12 +45,25 @@ declare class WSClient {
     connect(options?: {
         signal?: AbortSignal;
     }): Promise<void>;
+    /**
+     * Mark the current transport as unusable and schedule the normal reconnect
+     * path. Browser WebSockets can remain in OPEN state after a proxy/worker
+     * restart, so a timed-out heartbeat must revoke the stale socket explicitly.
+     */
+    reportTransportFailure(reason?: unknown): void;
     private connectAttempt;
     private normalizeReason;
     private rejectPending;
     private emitReconnectErrorMessage;
     private scheduleReconnectAttempt;
     private buildDisconnectError;
+    private decodeDocumentBytes;
+    private rememberCanonicalActivation;
+    private canAcceptDocumentReplacement;
+    private exposeCanonicalQuarantine;
+    private canonicalReplacementError;
+    private assertIncrementalDocumentIsSafe;
+    private requireDocumentResync;
     private handleDisconnect;
     private handleMessage;
     /**
@@ -62,6 +81,13 @@ declare class WSClient {
      * @param {Function} handler - Event handler
      */
     on(event: string, handler: (params: unknown) => void): void;
+    /**
+     * Subscribe to rejected canonical replacement metadata without exposing the
+     * malformed document through the public sync stream.
+     *
+     * @internal Session uses this to quarantine only its feed projection.
+     */
+    onCanonicalDocumentQuarantine(handler: (quarantine: CanonicalDocumentQuarantine) => void): () => void;
     /**
      * Register an RPC handler for incoming server requests
      * @param {string} method - RPC method name
@@ -93,7 +119,6 @@ declare class Session {
     private clientId;
     private initialQuota;
     private jobsMap;
-    private pendingAgentMessagesByJobId;
     private eventListeners;
     private toolHandlers;
     /** Tracks which tools are instance methods (className set, not static) */
@@ -110,12 +135,22 @@ declare class Session {
     private domainPackagePartCache;
     private domainPackagePartPromises;
     private domainPackageFetchQueue;
+    private readonly feedController;
+    readonly feed: SessionFeedApi;
     constructor(client: WSClient, clientId?: string, options?: {
         initialQuota?: GranularQuotaProgress | null;
     });
     private extractDomainRevisionFromDoc;
-    private buildLegacyEffectContext;
-    private stringifyConversationValue;
+    /**
+     * Prompt delivery is deliberately event-driven while a socket is live, but
+     * an existing session can be attached from a fresh tab/client after the
+     * event was originally sent. Rebuild that client's prompt cache from the
+     * canonical document on every sync so an open durable prompt remains
+     * actionable after reconnect without manufacturing a second prompt.
+     */
+    private reconcilePromptCacheFromCanonicalDocument;
+    private buildDirectedInvocationEffectContext;
+    private createDirectedInvocationFeedbackContext;
     get document(): Doc<Record<string, unknown>>;
     get quota(): GranularQuotaProgress | null;
     getQuota(): GranularQuotaProgress | null;
@@ -195,7 +230,7 @@ declare class Session {
      * Respond to a prompt request from the sandbox
      */
     answerPrompt(promptId: string, answer: unknown): Promise<void>;
-    appendConversationMessage(input: ConversationMessageInput): Promise<ConversationAppendResult>;
+    appendUserMessage(input: UserMessageInput): Promise<UserMessageAppendResult>;
     /**
      * Get the current list of available effects.
      * Consolidates effect declarations and live availability for the session.
@@ -252,6 +287,8 @@ declare class Session {
      * Close the session and disconnect from the sandbox
      */
     disconnect(): Promise<void>;
+    /** Stop feed repair work without detaching a reconnectable transport. */
+    protected disposeSessionFeed(): void;
     /**
      * Subscribe to session events
      */
@@ -260,6 +297,7 @@ declare class Session {
      * Unsubscribe from session events
      */
     off(event: string, handler: (data: unknown) => void): void;
+    protected setFeedListTransport(transport: FeedListTransport | null): void;
     private setupToolInvokeHandler;
     private setupEventHandlers;
     protected emit(event: string, data: unknown): void;
@@ -270,6 +308,7 @@ declare class Session {
 }
 
 type SessionFileUploadBody = Blob | ArrayBuffer | Uint8Array | string;
+type SessionDataHeaders = any;
 type EnvironmentImporterHandler = (importer: EnvironmentImporter) => Promise<void> | void;
 /**
  * Environment is the sessionless handle for one resolved ontology environment.
@@ -330,11 +369,11 @@ declare class Environment {
         }) => Promise<EnvironmentSession>;
         close: (sessionId: string, session?: EnvironmentSession | null) => Promise<void>;
         state: (options?: UserEnvironmentStateOptions) => Promise<UserEnvironmentState>;
-        markRead: (options: MarkUserEnvironmentReadOptions) => Promise<UserEnvironmentState["readAtBySessionId"]>;
+        markRead: (options: MarkUserEnvironmentReadOptions) => Promise<UserEnvironmentState["readThroughSequenceBySessionId"]>;
     };
     get userEnvironmentState(): {
         get: (options?: UserEnvironmentStateOptions) => Promise<UserEnvironmentState>;
-        markRead: (options: MarkUserEnvironmentReadOptions) => Promise<UserEnvironmentState["readAtBySessionId"]>;
+        markRead: (options: MarkUserEnvironmentReadOptions) => Promise<UserEnvironmentState["readThroughSequenceBySessionId"]>;
     };
     get data(): {
         record: (record: RecordObjectOptions) => Promise<RecordObjectResult>;
@@ -387,7 +426,7 @@ declare class Environment {
     listSessions(status?: ConversationSessionListOptions["status"]): Promise<ConversationSessionInfo[]>;
     listSessions(options?: Omit<ConversationSessionListOptions, "environmentId" | "sandboxId" | "subjectId">): Promise<ConversationSessionInfo[]>;
     getUserEnvironmentState(options?: UserEnvironmentStateOptions): Promise<UserEnvironmentState>;
-    markUserEnvironmentSessionsRead(options: MarkUserEnvironmentReadOptions): Promise<UserEnvironmentState["readAtBySessionId"]>;
+    markUserEnvironmentSessionsRead(options: MarkUserEnvironmentReadOptions): Promise<UserEnvironmentState["readThroughSequenceBySessionId"]>;
     createSession(options?: CreateSessionOptions): Promise<EnvironmentSession>;
     connectSession(sessionId: string, options?: {
         clientId?: string;
@@ -697,6 +736,9 @@ declare class Environment {
 declare class EnvironmentSession extends Session {
     readonly environment: Environment;
     private readonly sessionDataRoutePrefix;
+    private readonly sessionDataHeaders;
+    private heartbeatTimer;
+    private heartbeatInFlight;
     /** The last known graph container status, updated by checkReadiness() or on heartbeat */
     graphContainerStatus: {
         lastKeepAliveAt: number;
@@ -704,8 +746,32 @@ declare class EnvironmentSession extends Session {
     } | null;
     constructor(client: WSClient, environment: Environment, clientId: string, options?: {
         sessionDataRoutePrefix?: string;
+        /**
+         * Browser-only request metadata forwarded with session-data mutations.
+         * This lets a session direct a frontend effect to the exact Dock client
+         * that initiated a user action when multiple tabs are connected.
+         */
+        sessionDataHeaders?: SessionDataHeaders;
         initialQuota?: GranularQuotaProgress | null;
     });
+    /**
+     * Keep the browser session transport observable from the client side.
+     * A worker/proxy restart can leave a browser WebSocket appearing OPEN even
+     * though the server-side Durable Object has already closed its peer. The
+     * heartbeat gives the SDK a bounded failure signal so it can revoke that
+     * stale socket and use WSClient's normal reconnect path.
+     */
+    private startHeartbeat;
+    private stopHeartbeat;
+    hello(): Promise<{
+        ok: boolean;
+        environmentId?: string;
+        docId?: string;
+        graphContainerStatus?: {
+            lastKeepAliveAt: number;
+            status: "warming" | "hot" | "unknown";
+        };
+    }>;
     get environmentId(): string;
     get sandboxId(): string;
     get ontologyId(): string;
@@ -739,17 +805,21 @@ declare class EnvironmentSession extends Session {
     private buildSessionDataUrl;
     private sessionDataFetch;
     private sessionDataRequest;
-    private collectAllSessionItems;
     /**
      * Fetch the live session document from the runtime DO.
      *
-     * For history and saved artifacts, prefer the collection APIs on
-     * `messages`, `timeline`, `jobs`, and `heap`.
+     * For presentation history use `feed.list()` or `transcript.list()`.
+     * Timeline and job collections are diagnostic/execution data only.
      */
     getDocument(): Promise<SessionDocumentResult>;
-    get messages(): {
-        list: (options?: SessionCollectionListOptions) => Promise<SessionCollectionListResult<SessionConversationMessage>>;
-    };
+    /**
+     * Publish one terminal assistant reply from a trusted server integration.
+     *
+     * This uses the API-key-authenticated HTTP session boundary. Delegated
+     * browser sessions cannot use it and never receive assistant feed-authoring
+     * capability through their WebSocket.
+     */
+    publishAssistantReply(input: AssistantReplyPublicationInput): Promise<AssistantReplyPublicationResult>;
     get timeline(): {
         list: (options?: SessionCollectionListOptions) => Promise<SessionCollectionListResult<SessionTimelineEvent>>;
     };
@@ -765,11 +835,14 @@ declare class EnvironmentSession extends Session {
         create: (artifact: Partial<SessionArtifactRecord> & {
             label: string;
         }) => Promise<SessionArtifactRecord>;
+        acceptSuggestion: (sequence: number) => Promise<SessionArtifactRecord>;
         updateInputs: (artifactId: string, patch: {
             inputValues?: Record<string, unknown>;
             relationships?: Record<string, string | string[] | null>;
             expectedUpdatedAt?: number;
         }) => Promise<SessionArtifactRecord>;
+        relationshipOptions: (artifactId: string, input: SessionArtifactRelationshipOptionsInput) => Promise<SessionArtifactRelationshipOptionsResult>;
+        relationshipCreate: (artifactId: string, input: SessionArtifactRelationshipCreateInput) => Promise<SessionArtifactRecord>;
         validate: (artifactId: string) => Promise<SessionArtifactValidationResult>;
         execute: (artifactId: string, options: SessionArtifactExecutionOptions) => Promise<SessionArtifactExecutionResult>;
         approve: (artifactId: string, options: SessionArtifactApprovalOptions) => Promise<SessionArtifactExecutionResult>;
@@ -1031,7 +1104,7 @@ declare class Granular {
     }): Promise<UserEnvironmentState>;
     markUserEnvironmentSessionsRead(options: MarkUserEnvironmentReadOptions & {
         environmentId: string;
-    }): Promise<UserEnvironmentState["readAtBySessionId"]>;
+    }): Promise<UserEnvironmentState["readThroughSequenceBySessionId"]>;
     private normalizeConversationSession;
     private normalizeUserEnvironmentState;
     private static coerceIsoDate;
@@ -1057,10 +1130,7 @@ declare class Granular {
     recordOpenAIUsageSpend(usage: OpenAIUsageSpendEvent, context?: GranularSpendContext | null, options?: {
         metadata?: Record<string, unknown> | null;
     }): Promise<RecordOpenAIUsageSpendResult>;
-    /**
-     * Mark a session closed in the control plane. If `environment` is the connected handle for that
-     * `sessionId`, disconnects the WebSocket so the runtime tears down cleanly.
-     */
+    /** End a session through the runtime, or disconnect its connected handle. */
     closeSession(sessionId: string, environment?: EnvironmentSession | null): Promise<void>;
     /**
      * Re-open a closed session in the index and connect to its existing runtime document.