@granular-software/sdk 0.4.70 → 0.4.71

package/dist/{client-qgWZ495o.d.mts → client-p5EhOwpP.d.mts}

@@ -1,4 +1,4 @@
-import { dh as WSClientOptions, a7 as SessionFeedApi, bb as GranularQuotaProgress, T as ToolWithHandler, q as PublishToolsResult, ch as Job, r as ToolHandler, I as InstanceToolHandler, ck as UserMessageInput, cl as UserMessageAppendResult, c4 as EffectInfo, n as Prompt, c3 as ToolInfo, c6 as EffectsChangedEvent, c5 as ToolsChangedEvent, D as DomainState, aa as FeedListTransport, aT as GranularOptions, dO as EnvironmentImporter, aW as RecordUserOptions, aV as User, aY as OpenEnvironmentOptions, E as EnvironmentData, aS as AccessTokenProvider, bl as BuildPolicy, dL as EnvironmentSetupSummary, b2 as ConversationSessionListOptions, b0 as ConversationSessionInfo, b3 as ConversationSessionListResponse, a$ as CreateSessionOptions, h as RecordObjectOptions, dy as RecordObjectResult, dA as RecordObjectsOptions, dH as RecordImport, dD as RecordImportStatus, dG as RecordImportItem, a as EnvironmentRecordImportSummary, cf as EnvironmentFeedbackRecord, m as SessionHeapSnapshot, d5 as SessionDocumentResult, cm as AssistantReplyPublicationInput, cn as AssistantReplyPublicationResult, d6 as SessionCollectionListOptions, d8 as SessionCollectionListResult, cq as SessionTimelineEvent, d7 as SessionJobListOptions, c_ as SessionJobRecord, bP as SessionMutationView, cB as SessionArtifactListOptions, cA as SessionArtifactRecord, cD as SessionArtifactRelationshipOptionsInput, cF as SessionArtifactRelationshipOptionsResult, cG as SessionArtifactRelationshipCreateInput, cC as SessionArtifactValidationResult, cI as SessionArtifactExecutionOptions, cH as SessionArtifactExecutionResult, cJ as SessionArtifactApprovalOptions, cT as RecordManualActionInput, cV as ManualActionRecordResult, cW as ManualActionListOptions, cU as ManualActionOccurrence, cY as ManualActionSuggestionOptions, cX as ManualActionSuggestion, cM as ArtifactApprovalTaskListOptions, cL as ArtifactApprovalTask, cN as ArtifactApprovalDecisionInput, cO as ArtifactApprovalDecisionResult, cu as SessionFileRecord, cZ as SessionFileUploadOptions, S as SessionHeapEntry, k as SessionHeapList, d1 as SessionHeapVariable, o as SessionTranscriptEntry, eg as GraphQLResult, d3 as RecordSearchOptions, d2 as RecordSearchResult, d4 as RecordMentionInput, dr as DefineRelationshipOptions, dq as RelationshipInfo, dp as ModelRef, i as ManifestContent, dv as EnvironmentStateUpdateInput, dt as EnvironmentStateTarget, dx as EnvironmentStateProxy, dC as RecordImportOptions, dd as UserEnvironmentStateOptions, dc as UserEnvironmentState, de as MarkUserEnvironmentReadOptions, d as ProjectionMapper, bI as EffectProjectionResult, bN as ExternalCommitOptions, C as CommitReceipt, bJ as TransitionProjectionResult, bO as ObservationReceipt, aZ as AdoptEnvironmentOptions, a_ as ConnectOptions, dJ as RunEnvironmentImporterOptions, aF as OpenAIUsageSpendEvent, aE as GranularSpendContext, aH as RecordOpenAIUsageSpendResult, be as SandboxListResponse, bc as Sandbox, bd as CreateSandboxData, ei as DeleteResponse, bg as PermissionProfile, bh as CreatePermissionProfileData, bo as CreateEnvironmentData, ej as StreamEvent, ek as StreamSubscription, el as StreamStats, aX as Subject, bk as AssignmentListResponse } from './spend-B-IQmp7F.mjs';
+import { du as WSClientOptions, ab as SessionFeedApi, bf as GranularQuotaProgress, T as ToolWithHandler, t as PublishToolsResult, cl as Job, u as ToolHandler, I as InstanceToolHandler, co as UserMessageInput, cp as UserMessageAppendResult, c8 as EffectInfo, n as Prompt, c7 as ToolInfo, ca as EffectsChangedEvent, c9 as ToolsChangedEvent, D as DomainState, ae as FeedListTransport, aX as GranularOptions, e0 as EnvironmentImporter, a_ as RecordUserOptions, aZ as User, b0 as OpenEnvironmentOptions, E as EnvironmentData, aW as AccessTokenProvider, bp as BuildPolicy, dZ as EnvironmentSetupSummary, b6 as ConversationSessionListOptions, b4 as ConversationSessionInfo, b7 as ConversationSessionListResponse, b3 as CreateSessionOptions, h as RecordObjectOptions, dM as RecordObjectResult, dO as RecordObjectsOptions, dV as RecordImport, dR as RecordImportStatus, dU as RecordImportItem, a as EnvironmentRecordImportSummary, cj as EnvironmentFeedbackRecord, m as SessionHeapSnapshot, dh as SessionDocumentResult, cq as AssistantReplyPublicationInput, cr as AssistantReplyPublicationResult, di as SessionCollectionListOptions, dk as SessionCollectionListResult, cu as SessionTimelineEvent, dj as SessionJobListOptions, da as SessionJobRecord, bT as SessionMutationView, cN as SessionArtifactListOptions, r as SessionArtifactRecord, cP as SessionArtifactRelationshipOptionsInput, cR as SessionArtifactRelationshipOptionsResult, cS as SessionArtifactRelationshipCreateInput, cO as SessionArtifactValidationResult, cU as SessionArtifactExecutionOptions, cT as SessionArtifactExecutionResult, cV as SessionArtifactApprovalOptions, d3 as RecordManualActionInput, d5 as ManualActionRecordResult, d6 as ManualActionListOptions, d4 as ManualActionOccurrence, d8 as ManualActionSuggestionOptions, d7 as ManualActionSuggestion, cY as ArtifactApprovalTaskListOptions, cX as ArtifactApprovalTask, cZ as ArtifactApprovalDecisionInput, c_ as ArtifactApprovalDecisionResult, cy as SessionFileRecord, d9 as SessionFileUploadOptions, S as SessionHeapEntry, k as SessionHeapList, dd as SessionHeapVariable, o as SessionTranscriptEntry, eu as GraphQLResult, df as RecordSearchOptions, de as RecordSearchResult, dg as RecordMentionInput, dF as DefineRelationshipOptions, dE as RelationshipInfo, dD as ModelRef, i as ManifestContent, dJ as EnvironmentStateUpdateInput, dH as EnvironmentStateTarget, dL as EnvironmentStateProxy, dQ as RecordImportOptions, dq as UserEnvironmentStateOptions, dp as UserEnvironmentState, dr as MarkUserEnvironmentReadOptions, d as ProjectionMapper, bM as EffectProjectionResult, bR as ExternalCommitOptions, C as CommitReceipt, bN as TransitionProjectionResult, bS as ObservationReceipt, b1 as AdoptEnvironmentOptions, b2 as ConnectOptions, dX as RunEnvironmentImporterOptions, aJ as OpenAIUsageSpendEvent, aI as GranularSpendContext, aL as RecordOpenAIUsageSpendResult, bi as SandboxListResponse, bg as Sandbox, bh as CreateSandboxData, ew as DeleteResponse, bk as PermissionProfile, bl as CreatePermissionProfileData, bs as CreateEnvironmentData, ex as StreamEvent, ey as StreamSubscription, ez as StreamStats, a$ as Subject, bo as AssignmentListResponse } from './spend-lJDtuAr6.mjs';
 import * as Automerge from '@automerge/automerge';
 import { Doc } from '@automerge/automerge/slim';
 
@@ -194,6 +194,12 @@ declare class Session {
         ok: boolean;
         environmentId?: string;
         docId?: string;
+        features?: {
+            /** Whether the server sends application-level heartbeat frames. */
+            serverHeartbeat?: boolean;
+            /** Whether the server expects a hibernatable WebSocket lifecycle. */
+            hibernatingWebSocket?: boolean;
+        };
         graphContainerStatus?: {
             lastKeepAliveAt: number;
             status: "warming" | "hot" | "unknown";
@@ -794,6 +800,7 @@ declare class EnvironmentSession extends Session {
     private readonly sessionDataHeaders;
     private readonly beforeMutationSend?;
     private heartbeatTimer;
+    private heartbeatProbeInFlight;
     /** The last known graph container status, updated by checkReadiness(). */
     graphContainerStatus: {
         lastKeepAliveAt: number;
@@ -824,6 +831,10 @@ declare class EnvironmentSession extends Session {
         ok: boolean;
         environmentId?: string;
         docId?: string;
+        features?: {
+            serverHeartbeat?: boolean;
+            hibernatingWebSocket?: boolean;
+        };
         graphContainerStatus?: {
             lastKeepAliveAt: number;
             status: "warming" | "hot" | "unknown";
@@ -888,13 +899,22 @@ declare class EnvironmentSession extends Session {
     get mutations(): {
         list: (options?: {
             limit?: number;
+            compact?: boolean;
         }) => Promise<{
             items: SessionMutationView[];
         }>;
     };
     get artifacts(): {
-        list: (options?: SessionArtifactListOptions) => Promise<SessionCollectionListResult<SessionArtifactRecord>>;
-        listForLatestJob: (options?: Omit<SessionArtifactListOptions, "jobId" | "latestJob">) => Promise<SessionCollectionListResult<SessionArtifactRecord>>;
+        list: (options?: SessionArtifactListOptions) => Promise<{
+            items: SessionArtifactRecord[];
+            nextCursor: string | null;
+            totalCount: number;
+        }>;
+        listForLatestJob: (options?: Omit<SessionArtifactListOptions, "jobId" | "latestJob">) => Promise<{
+            items: SessionArtifactRecord[];
+            nextCursor: string | null;
+            totalCount: number;
+        }>;
         get: (artifactId: string) => Promise<SessionArtifactRecord>;
         create: (artifact: Partial<SessionArtifactRecord> & {
             label: string;

package/dist/index.d.mts

@@ -1,6 +1,6 @@
-export { E as Environment, a as EnvironmentSession, G as Granular, O as OntologyHandle, S as Session, W as WSClient, i as isGraphQLMutationDocument } from './client-qgWZ495o.mjs';
-import { E as EnvironmentData, a as EnvironmentRecordImportSummary, b as EndpointMode, c as EffectCommitRequest, C as CommitReceipt, T as ToolWithHandler, P as ProjectionResult, d as ProjectionMapper, e as CommitTransitionOutcomeDeclaration, f as CommitDeclaration, g as EffectHandlerContext, F as FeedPublishTransport, M as ManifestEffectMetamodelSpec, R as ResolvedEffectBehaviors, h as RecordObjectOptions, i as ManifestContent, j as CommitTransitionInvocation, S as SessionHeapEntry, k as SessionHeapList, l as FeedItem, m as SessionHeapSnapshot, n as Prompt, o as SessionTranscriptEntry } from './spend-B-IQmp7F.mjs';
-export { eh as APIError, aS as AccessTokenProvider, Y as ActionSuggestionFeedItem, aZ as AdoptEnvironmentOptions, bK as AgentCommitStatus, cN as ArtifactApprovalDecisionInput, cO as ArtifactApprovalDecisionResult, cL as ArtifactApprovalTask, cM as ArtifactApprovalTaskListOptions, cK as ArtifactApprovalTaskStatus, U as ArtifactFeedItem, b_ as ArtifactOptionsHandler, bj as Assignment, bk as AssignmentListResponse, cm as AssistantReplyPublicationInput, cn as AssistantReplyPublicationResult, bH as BaseProjectionResult, bt as Build, bv as BuildListResponse, bl as BuildPolicy, bs as BuildStatus, bC as CanonicalProjectedRecord, bL as CommitChangeReceipt, bA as CommitSafeError, bM as CommitTransitionReceipt, aO as ConditionIR, a_ as ConnectOptions, b0 as ConversationSessionInfo, b2 as ConversationSessionListOptions, b3 as ConversationSessionListResponse, b1 as ConversationSessionListStatus, bo as CreateEnvironmentData, bh as CreatePermissionProfileData, bd as CreateSandboxData, a$ as CreateSessionOptions, dr as DefineRelationshipOptions, ei as DeleteResponse, D as DomainState, bW as EffectArtifactOptionsInvocation, bY as EffectArtifactRelationshipOption, bZ as EffectArtifactRelationshipOptionsResult, bQ as EffectCommitContext, c7 as EffectHandler, c4 as EffectInfo, bX as EffectInvocationMetadata, bV as EffectInvocationMode, bI as EffectProjectionResult, b$ as EffectSchema, c2 as EffectVersionSelector, c0 as EffectWithHandler, c6 as EffectsChangedEvent, cf as EnvironmentFeedbackRecord, dO as EnvironmentImporter, dN as EnvironmentImporterImportOptions, bp as EnvironmentListResponse, dM as EnvironmentSetupImporterClaim, dK as EnvironmentSetupLifecycleStatus, dL as EnvironmentSetupSummary, dI as EnvironmentSetupTriggerReason, dw as EnvironmentStateMachineProxy, du as EnvironmentStateObservationInput, dx as EnvironmentStateProxy, dt as EnvironmentStateTarget, dv as EnvironmentStateUpdateInput, bN as ExternalCommitOptions, ac as FeedDiagnostic, ad as FeedDiagnosticListener, ak as FeedDocumentState, v as FeedFeedbackTone, V as FeedFileSource, u as FeedIconToken, z as FeedItemBase, x as FeedItemKind, a3 as FeedListOptions, aa as FeedListTransport, G as FeedObjectReference, a4 as FeedPage, av as FeedPublisher, a2 as FeedSnapshot, ab as FeedSnapshotRegressionReason, t as FeedSource, s as FeedSourceActor, a5 as FeedSubscribeOptions, a6 as FeedSubscriptionChange, H as FeedTableCell, J as FeedTableColumn, N as FeedTableProjection, L as FeedTableRow, K as FeedTableRowReference, y as FeedTarget, w as FeedTransientFeedbackTone, B as FeedbackFeedItem, W as FileFeedItem, ae as GRANULAR_FEED_DIAGNOSTIC_EVENT, aU as GranularAuth, aT as GranularOptions, ba as GranularQuotaPolicy, bb as GranularQuotaProgress, aE as GranularSpendContext, eg as GraphQLResult, c8 as InstanceEffectHandler, I as InstanceToolHandler, ch as Job, cd as JobFeedbackInput, cc as JobFeedbackMetadata, ce as JobFeedbackRecord, ca as JobFeedbackSentiment, cb as JobFeedbackToolCall, c9 as JobStatus, cg as JobSubmitResult, bq as Manifest, e6 as ManifestApprovalRequiredSpec, e7 as ManifestCreatesSpec, e4 as ManifestDryRunSpec, ea as ManifestEffectDeclaration, e9 as ManifestEffectSchema, dR as ManifestEnumRuleSpec, ec as ManifestEventStreamDef, eb as ManifestEventTypeDef, dS as ManifestFilterBySpec, ee as ManifestImport, br as ManifestListResponse, ed as ManifestOperation, e3 as ManifestPostConditionSpec, dP as ManifestPropertySpec, e8 as ManifestRelationshipDef, e5 as ManifestReverseSpec, e2 as ManifestStateMachineSpec, dU as ManifestStateMachineStateSpec, e1 as ManifestStateMachineTransitionSpec, dW as ManifestStateTransitionActionSpec, dX as ManifestStateTransitionAssigneeSpec, d$ as ManifestStateTransitionExpectedOutcomeSpec, dV as ManifestStateTransitionInputBinding, e0 as ManifestStateTransitionOutcomeSpec, d_ as ManifestStateTransitionPermissionSpec, dY as ManifestStateTransitionRelatedStateRequirementSpec, dZ as ManifestStateTransitionRequirementsSpec, dQ as ManifestValidationOperator, dT as ManifestValidationRuleSpec, ef as ManifestVolume, cW as ManualActionListOptions, cU as ManualActionOccurrence, cV as ManualActionRecordResult, cS as ManualActionRelatedRecord, cQ as ManualActionSource, cP as ManualActionStatus, cX as ManualActionSuggestion, cY as ManualActionSuggestionOptions, cR as ManualActionTarget, de as MarkUserEnvironmentReadOptions, aR as MatchedPolicy, A as MessageFeedItem, dp as ModelRef, ay as NormalizedOpenAIUsage, X as NormalizedSuggestedArtifact, aA as OPENAI_MODEL_PRICING_USD_PER_MILLION, bD as ObjectProjectionChange, by as ObjectReference, O as ObjectsFeedItem, bO as ObservationReceipt, ax as OpenAIModelPricing, az as OpenAITokenSpend, aF as OpenAIUsageSpendEvent, aY as OpenEnvironmentOptions, bg as PermissionProfile, bi as PermissionProfileListResponse, bf as PermissionRules, aN as PolicyOperator, aP as PolicyOrigin, aM as PolicyPredicateSource, aQ as PolicyRuleIR, aL as PolicySource, bG as ProjectionChange, Z as PromptFeedItem, c1 as PublishEffectsResult, ar as PublishFeedbackOptions, q as PublishToolsResult, as as PublishTransientFeedbackOptions, b9 as QuotaLineItemFilter, b6 as QuotaPeriod, b5 as QuotaScopeType, b7 as QuotaStatus, di as RPCRequest, dl as RPCRequestFromServer, dj as RPCResponse, dH as RecordImport, dG as RecordImportItem, dE as RecordImportItemStatus, dC as RecordImportOptions, dF as RecordImportStats, dD as RecordImportStatus, dB as RecordImportWriteMode, cT as RecordManualActionInput, d4 as RecordMentionInput, dy as RecordObjectResult, ds as RecordObjectStateValue, dz as RecordObjectsChunkInfo, dA as RecordObjectsOptions, aG as RecordOpenAIUsageSpendOptions, aH as RecordOpenAIUsageSpendResult, d3 as RecordSearchOptions, d2 as RecordSearchResult, aW as RecordUserOptions, dq as RelationshipInfo, bE as RelationshipProjectionChange, bU as ResolvedEffectApprovalRequired, bS as ResolvedEffectDryRun, bR as ResolvedEffectPostCondition, bT as ResolvedEffectReverse, dJ as RunEnvironmentImporterOptions, bc as Sandbox, be as SandboxListResponse, bx as SemanticVersionDiff, bw as SemanticVersionDiffEntry, cJ as SessionArtifactApprovalOptions, cx as SessionArtifactAutonomyPolicy, cI as SessionArtifactExecutionOptions, cH as SessionArtifactExecutionResult, cz as SessionArtifactFieldProvenance, cy as SessionArtifactFieldProvenanceSource, cw as SessionArtifactKind, cB as SessionArtifactListOptions, cA as SessionArtifactRecord, cG as SessionArtifactRelationshipCreateInput, cE as SessionArtifactRelationshipOption, cD as SessionArtifactRelationshipOptionsInput, cF as SessionArtifactRelationshipOptionsResult, cv as SessionArtifactStatus, cC as SessionArtifactValidationResult, d6 as SessionCollectionListOptions, d8 as SessionCollectionListResult, d5 as SessionDocumentResult, a7 as SessionFeedApi, aq as SessionFeedController, aj as SessionFeedControllerOptions, cs as SessionFileKind, cu as SessionFileRecord, cr as SessionFileSource, ct as SessionFileStatus, cZ as SessionFileUploadOptions, c$ as SessionHeapFieldType, d0 as SessionHeapFieldValue, d1 as SessionHeapVariable, d7 as SessionJobListOptions, c_ as SessionJobRecord, bP as SessionMutationView, cq as SessionTimelineEvent, co as SessionTranscriptActionSuggestion, cp as SessionTranscriptShowRefs, at as SettleTransientFeedbackOptions, dk as SnapshotResetMessage, bz as SourceAcknowledgement, b4 as SpendLineItemType, b8 as SpendSummary, bF as StateObservationProjectionChange, ej as StreamEvent, el as StreamStats, ek as StreamSubscription, aX as Subject, Q as TableFeedItem, r as ToolHandler, c3 as ToolInfo, dm as ToolInvokeParams, dn as ToolResultParams, p as ToolSchema, c5 as ToolsChangedEvent, a1 as TransientFeedItem, _ as TransientFeedItemBase, a0 as TransientFeedbackFeedItem, au as TransientFeedbackHandle, $ as TransientMessageFeedItem, bB as TransitionOutcomeProjection, bJ as TransitionProjectionResult, aV as User, da as UserEnvironmentMessagePreview, d9 as UserEnvironmentPrompt, db as UserEnvironmentSessionState, dc as UserEnvironmentState, dd as UserEnvironmentStateOptions, cl as UserMessageAppendResult, ck as UserMessageInput, ci as UserMessageShowRefs, cj as UserMessageTarget, bu as Version, bn as VersionTag, bm as VersionTracking, dh as WSClientOptions, df as WSDisconnectInfo, dg as WSReconnectErrorInfo, aJ as buildOpenAISpendEventId, aD as calculateOpenAITokenSpend, aw as createFeedPublisher, ai as emitFeedDiagnostic, ah as emitFeedDiagnosticToDefaultSink, al as emptyFeedSnapshot, aB as getOpenAIModelPricing, am as hasCanonicalSessionFeedActivation, an as isCanonicalSessionFeedDocument, a8 as mergeFeedItemsBySequence, ag as normalizeFeedDiagnostic, af as normalizeFeedDiagnosticKind, ap as normalizeFeedPage, aC as normalizeOpenAIUsage, a9 as orderTransientFeedItems, ao as readSessionFeedSnapshot, aK as recordOpenAIUsageSpend, aI as toGranularHttpBase } from './spend-B-IQmp7F.mjs';
+export { E as Environment, a as EnvironmentSession, G as Granular, O as OntologyHandle, S as Session, W as WSClient, i as isGraphQLMutationDocument } from './client-p5EhOwpP.mjs';
+import { E as EnvironmentData, a as EnvironmentRecordImportSummary, b as EndpointMode, c as EffectCommitRequest, C as CommitReceipt, T as ToolWithHandler, P as ProjectionResult, d as ProjectionMapper, e as CommitTransitionOutcomeDeclaration, f as CommitDeclaration, g as EffectHandlerContext, F as FeedPublishTransport, M as ManifestEffectMetamodelSpec, R as ResolvedEffectBehaviors, h as RecordObjectOptions, i as ManifestContent, j as CommitTransitionInvocation, S as SessionHeapEntry, k as SessionHeapList, l as FeedItem, m as SessionHeapSnapshot, n as Prompt, o as SessionTranscriptEntry, A as ArtifactWorkflowNode, p as ArtifactWorkflowNodeStatus, q as ArtifactWorkflow, r as SessionArtifactRecord } from './spend-lJDtuAr6.mjs';
+export { ev as APIError, aW as AccessTokenProvider, a0 as ActionSuggestionFeedItem, b1 as AdoptEnvironmentOptions, bO as AgentCommitStatus, cZ as ArtifactApprovalDecisionInput, c_ as ArtifactApprovalDecisionResult, cX as ArtifactApprovalTask, cY as ArtifactApprovalTaskListOptions, cW as ArtifactApprovalTaskStatus, Y as ArtifactFeedItem, c2 as ArtifactOptionsHandler, cH as ArtifactWorkflowAttention, cC as ArtifactWorkflowCompletionState, cD as ArtifactWorkflowNodeAvailability, cB as ArtifactWorkflowNodeKind, cE as ArtifactWorkflowOperationPhase, cG as ArtifactWorkflowRecap, cF as ArtifactWorkflowRecapItem, bn as Assignment, bo as AssignmentListResponse, cq as AssistantReplyPublicationInput, cr as AssistantReplyPublicationResult, bL as BaseProjectionResult, bx as Build, bz as BuildListResponse, bp as BuildPolicy, bw as BuildStatus, bG as CanonicalProjectedRecord, bP as CommitChangeReceipt, bE as CommitSafeError, bQ as CommitTransitionReceipt, aS as ConditionIR, b2 as ConnectOptions, b4 as ConversationSessionInfo, b6 as ConversationSessionListOptions, b7 as ConversationSessionListResponse, b5 as ConversationSessionListStatus, bs as CreateEnvironmentData, bl as CreatePermissionProfileData, bh as CreateSandboxData, b3 as CreateSessionOptions, dF as DefineRelationshipOptions, ew as DeleteResponse, D as DomainState, b_ as EffectArtifactOptionsInvocation, c0 as EffectArtifactRelationshipOption, c1 as EffectArtifactRelationshipOptionsResult, bU as EffectCommitContext, cb as EffectHandler, c8 as EffectInfo, b$ as EffectInvocationMetadata, bZ as EffectInvocationMode, bM as EffectProjectionResult, c3 as EffectSchema, c6 as EffectVersionSelector, c4 as EffectWithHandler, ca as EffectsChangedEvent, cj as EnvironmentFeedbackRecord, e0 as EnvironmentImporter, d$ as EnvironmentImporterImportOptions, bt as EnvironmentListResponse, d_ as EnvironmentSetupImporterClaim, dY as EnvironmentSetupLifecycleStatus, dZ as EnvironmentSetupSummary, dW as EnvironmentSetupTriggerReason, dK as EnvironmentStateMachineProxy, dI as EnvironmentStateObservationInput, dL as EnvironmentStateProxy, dH as EnvironmentStateTarget, dJ as EnvironmentStateUpdateInput, bR as ExternalCommitOptions, ag as FeedDiagnostic, ah as FeedDiagnosticListener, ao as FeedDocumentState, y as FeedFeedbackTone, Z as FeedFileSource, x as FeedIconToken, H as FeedItemBase, B as FeedItemKind, a7 as FeedListOptions, ae as FeedListTransport, L as FeedObjectReference, a8 as FeedPage, az as FeedPublisher, a6 as FeedSnapshot, af as FeedSnapshotRegressionReason, w as FeedSource, v as FeedSourceActor, a9 as FeedSubscribeOptions, aa as FeedSubscriptionChange, N as FeedTableCell, Q as FeedTableColumn, W as FeedTableProjection, V as FeedTableRow, U as FeedTableRowReference, G as FeedTarget, z as FeedTransientFeedbackTone, dz as FeedTransientPatchMessage, K as FeedbackFeedItem, _ as FileFeedItem, ai as GRANULAR_FEED_DIAGNOSTIC_EVENT, aY as GranularAuth, aX as GranularOptions, be as GranularQuotaPolicy, bf as GranularQuotaProgress, aI as GranularSpendContext, eu as GraphQLResult, cc as InstanceEffectHandler, I as InstanceToolHandler, cl as Job, dy as JobActionTraceMessage, ch as JobFeedbackInput, cg as JobFeedbackMetadata, ci as JobFeedbackRecord, ce as JobFeedbackSentiment, cf as JobFeedbackToolCall, cd as JobStatus, ck as JobSubmitResult, bu as Manifest, ek as ManifestApprovalRequiredSpec, el as ManifestCreatesSpec, ei as ManifestDryRunSpec, eo as ManifestEffectDeclaration, en as ManifestEffectSchema, e3 as ManifestEnumRuleSpec, eq as ManifestEventStreamDef, ep as ManifestEventTypeDef, e4 as ManifestFilterBySpec, es as ManifestImport, bv as ManifestListResponse, er as ManifestOperation, eh as ManifestPostConditionSpec, e1 as ManifestPropertySpec, em as ManifestRelationshipDef, ej as ManifestReverseSpec, eg as ManifestStateMachineSpec, e6 as ManifestStateMachineStateSpec, ef as ManifestStateMachineTransitionSpec, e8 as ManifestStateTransitionActionSpec, e9 as ManifestStateTransitionAssigneeSpec, ed as ManifestStateTransitionExpectedOutcomeSpec, e7 as ManifestStateTransitionInputBinding, ee as ManifestStateTransitionOutcomeSpec, ec as ManifestStateTransitionPermissionSpec, ea as ManifestStateTransitionRelatedStateRequirementSpec, eb as ManifestStateTransitionRequirementsSpec, e2 as ManifestValidationOperator, e5 as ManifestValidationRuleSpec, et as ManifestVolume, d6 as ManualActionListOptions, d4 as ManualActionOccurrence, d5 as ManualActionRecordResult, d2 as ManualActionRelatedRecord, d0 as ManualActionSource, c$ as ManualActionStatus, d7 as ManualActionSuggestion, d8 as ManualActionSuggestionOptions, d1 as ManualActionTarget, dr as MarkUserEnvironmentReadOptions, aV as MatchedPolicy, J as MessageFeedItem, dD as ModelRef, aC as NormalizedOpenAIUsage, $ as NormalizedSuggestedArtifact, aE as OPENAI_MODEL_PRICING_USD_PER_MILLION, bH as ObjectProjectionChange, bC as ObjectReference, O as ObjectsFeedItem, bS as ObservationReceipt, aB as OpenAIModelPricing, aD as OpenAITokenSpend, aJ as OpenAIUsageSpendEvent, b0 as OpenEnvironmentOptions, bk as PermissionProfile, bm as PermissionProfileListResponse, bj as PermissionRules, aR as PolicyOperator, aT as PolicyOrigin, aQ as PolicyPredicateSource, aU as PolicyRuleIR, aP as PolicySource, bK as ProjectionChange, a1 as PromptFeedItem, c5 as PublishEffectsResult, av as PublishFeedbackOptions, t as PublishToolsResult, aw as PublishTransientFeedbackOptions, bd as QuotaLineItemFilter, ba as QuotaPeriod, b9 as QuotaScopeType, bb as QuotaStatus, dv as RPCRequest, dA as RPCRequestFromServer, dw as RPCResponse, dV as RecordImport, dU as RecordImportItem, dS as RecordImportItemStatus, dQ as RecordImportOptions, dT as RecordImportStats, dR as RecordImportStatus, dP as RecordImportWriteMode, d3 as RecordManualActionInput, dg as RecordMentionInput, dM as RecordObjectResult, dG as RecordObjectStateValue, dN as RecordObjectsChunkInfo, dO as RecordObjectsOptions, aK as RecordOpenAIUsageSpendOptions, aL as RecordOpenAIUsageSpendResult, df as RecordSearchOptions, de as RecordSearchResult, a_ as RecordUserOptions, dE as RelationshipInfo, bI as RelationshipProjectionChange, bY as ResolvedEffectApprovalRequired, bW as ResolvedEffectDryRun, bV as ResolvedEffectPostCondition, bX as ResolvedEffectReverse, dX as RunEnvironmentImporterOptions, bg as Sandbox, bi as SandboxListResponse, bB as SemanticVersionDiff, bA as SemanticVersionDiffEntry, cV as SessionArtifactApprovalOptions, cI as SessionArtifactAutonomyPolicy, cU as SessionArtifactExecutionOptions, cT as SessionArtifactExecutionResult, cM as SessionArtifactFieldProvenance, cJ as SessionArtifactFieldProvenanceSource, cA as SessionArtifactKind, cN as SessionArtifactListOptions, cS as SessionArtifactRelationshipCreateInput, cQ as SessionArtifactRelationshipOption, cP as SessionArtifactRelationshipOptionsInput, cR as SessionArtifactRelationshipOptionsResult, cL as SessionArtifactRequestContext, cK as SessionArtifactRequestContextSource, cz as SessionArtifactStatus, cO as SessionArtifactValidationResult, di as SessionCollectionListOptions, dk as SessionCollectionListResult, dh as SessionDocumentResult, ab as SessionFeedApi, au as SessionFeedController, an as SessionFeedControllerOptions, cw as SessionFileKind, cy as SessionFileRecord, cv as SessionFileSource, cx as SessionFileStatus, d9 as SessionFileUploadOptions, db as SessionHeapFieldType, dc as SessionHeapFieldValue, dd as SessionHeapVariable, dj as SessionJobListOptions, da as SessionJobRecord, bT as SessionMutationView, cu as SessionTimelineEvent, cs as SessionTranscriptActionSuggestion, ct as SessionTranscriptShowRefs, ax as SettleTransientFeedbackOptions, dx as SnapshotResetMessage, bD as SourceAcknowledgement, b8 as SpendLineItemType, bc as SpendSummary, bJ as StateObservationProjectionChange, ex as StreamEvent, ez as StreamStats, ey as StreamSubscription, a$ as Subject, X as TableFeedItem, u as ToolHandler, c7 as ToolInfo, dB as ToolInvokeParams, dC as ToolResultParams, s as ToolSchema, c9 as ToolsChangedEvent, a5 as TransientFeedItem, a2 as TransientFeedItemBase, a4 as TransientFeedbackFeedItem, ay as TransientFeedbackHandle, a3 as TransientMessageFeedItem, bF as TransitionOutcomeProjection, bN as TransitionProjectionResult, aZ as User, dm as UserEnvironmentMessagePreview, dl as UserEnvironmentPrompt, dn as UserEnvironmentSessionState, dp as UserEnvironmentState, dq as UserEnvironmentStateOptions, cp as UserMessageAppendResult, co as UserMessageInput, cm as UserMessageShowRefs, cn as UserMessageTarget, by as Version, br as VersionTag, bq as VersionTracking, du as WSClientOptions, ds as WSDisconnectInfo, dt as WSReconnectErrorInfo, aN as buildOpenAISpendEventId, aH as calculateOpenAITokenSpend, aA as createFeedPublisher, am as emitFeedDiagnostic, al as emitFeedDiagnosticToDefaultSink, ap as emptyFeedSnapshot, aF as getOpenAIModelPricing, aq as hasCanonicalSessionFeedActivation, ar as isCanonicalSessionFeedDocument, ac as mergeFeedItemsBySequence, ak as normalizeFeedDiagnostic, aj as normalizeFeedDiagnosticKind, at as normalizeFeedPage, aG as normalizeOpenAIUsage, ad as orderTransientFeedItems, as as readSessionFeedSnapshot, aO as recordOpenAIUsageSpend, aM as toGranularHttpBase } from './spend-lJDtuAr6.mjs';
 export { BuildGranularAgentSystemPromptInput, GeneratedJobCodeIssue, GranularAgentExecutionCheckpoint, GranularAgentHeapSummaryOptions, GranularAgentManualActionMemorySuggestion, GranularAgentPromptCapabilities, GranularAgentReferentFocus, GranularAgentSessionContext, GranularAgentToolInfo, GranularAgentWorkflowFocus, GranularReasoningTraceChunkResult, GranularReasoningTraceOptions, HarnessContinuationDecision, HarnessControllerBudgets, HarnessProjectionOptions, HarnessPromptLike, HarnessRenderedContinuation, HarnessRenderedPrompt, HarnessTemplate, HarnessTemplateManifest, HarnessTemplateSelectionOptions, HarnessTemplateStatus, HarnessVerifierSnapshot, HarnessVerifierSnapshotInput, ReviewGeneratedJobCodeOptions, buildContinuationInstruction, buildContinuationInstructionFromTemplate, buildGranularAgentCheckpointBlock, buildGranularAgentDomainBlock, buildGranularAgentFileBlock, buildGranularAgentHeapBlock, buildGranularAgentLoopBlock, buildGranularAgentManualActionBlock, buildGranularAgentManualActionMemorySummary, buildGranularAgentReferentBlock, buildGranularAgentRuntimeImportsBlock, buildGranularAgentSessionBlock, buildGranularAgentSystemPrompt, buildGranularAgentSystemPromptFromTemplate, buildGranularAgentToolBlock, buildGranularAgentWorkflowBlock, consumeGranularReasoningOnlyChunk, consumeGranularReasoningTraceChunk, createHarnessVerifierSnapshot, evaluateContinuation, getCurrentClosureId, getDefaultHarnessTemplateId, getExclusivePromptTarget, hasOpenPrompt, hashHarnessTemplateValue, listHarnessTemplates, projectConversationReferentFocus, projectConversationReferentSummary, projectHeapSummary, projectLoopSummary, projectSessionFileSummary, projectWorkflowFocus, projectWorkflowSummary, renderContinuationInstructionFromTemplate, renderGranularAgentSystemPromptFromTemplate, resolveHarnessTemplate, reviewGeneratedJobCode, stripGranularReasoningTrace, validateHarnessTemplateManifest } from './agent-harness.mjs';
 import '@automerge/automerge';
 import '@automerge/automerge/slim';
@@ -130,6 +130,7 @@ declare function invokeRegisteredEffect(effectMap: Map<string, ToolWithHandler>,
 interface RecordSnapshotCommitSource {
     reference: string;
     version?: string;
+    versionScope?: "global" | "target";
     beforeRecords: RecordObjectOptions[];
     afterRecords: RecordObjectOptions[];
 }
@@ -311,4 +312,66 @@ declare function buildSessionTranscript(input: {
     canonicalFeedItems?: FeedItem[];
 }): SessionTranscriptEntry[];
 
-export { CommitDeclaration, CommitReceipt, CommitTransitionInvocation, CommitTransitionOutcomeDeclaration, type CommitTransport, type ConditionalPolicySpec, type DefinedStateMachine, EffectCommitRequest, EffectHandlerContext, EndpointMode, EnvironmentData, EnvironmentRecordImportSummary, type EnvironmentSetupPollInput, type EnvironmentSetupProgress, type EnvironmentSetupRequestError, type EnvironmentSetupResponse, FeedItem, FeedPublishTransport, type JobPresentation, type LimitPolicySpec, ManifestContent, ManifestEffectMetamodelSpec, type NormalizedPromptChoiceOption, type PermissionActionSpec, type PermissionPolicySpec, type PermissionProfileFile, type PolicyDecision, type PolicyEvaluationContext, type PolicyOutcome, ProjectionMapper, ProjectionResult, Prompt, RecordObjectOptions, type RecordSnapshotCommitSource, ResolvedEffectBehaviors, SessionHeapEntry, SessionHeapList, SessionHeapSnapshot, SessionTranscriptEntry, type StateMachineDefinition, ToolWithHandler, type ValidationRuleEvaluationInput, type ValidationRuleEvaluationResult, buildSessionTranscript, buildSessionTranscriptFromFeedItems, canonicalizeCommitValue, changedRecordSnapshots, defineEffect, defineProjection, defineStateMachine, environmentSetupProgressFromError, environmentSetupProgressFromResponse, evaluateValidationRule, extractPromptTokens, invokeRegisteredEffect, isLocalApiUrl, normalizeEffectBehaviors, normalizePrompt, normalizePromptChoiceOption, normalizePromptText, normalizePromptType, pollEnvironmentSetup, projectRecordSnapshotMutation, resolveApiUrl, resolveAuthTokenForApiUrl, resolveJobPresentation, resolvePromptAnswer, scorePromptChoiceMatch, validateProjectionResult, validationRuleFailureMessage };
+type ArtifactLike = Omit<SessionArtifactRecord, "workflow"> & {
+    workflow?: ArtifactWorkflow | null;
+};
+declare function isArtifactWorkflowNodeTerminal(nodeOrStatus: ArtifactWorkflowNode | ArtifactWorkflowNodeStatus): boolean;
+declare function getArtifactWorkflowNavigationLeaves(workflow: ArtifactWorkflow): ArtifactWorkflowNode[];
+declare function isArtifactWorkflowNodeNavigableLeaf(workflow: ArtifactWorkflow, node: ArtifactWorkflowNode): boolean;
+/**
+ * Resolve the only automatic destination allowed by the workflow contract.
+ * The first non-terminal actionable leaf owns the next user interaction. A
+ * terminal workflow has no active leaf, so the last leaf remains the stable
+ * recap destination. This selector is shared by the SDK projector and UI;
+ * neither caller is allowed to infer a destination from labels or row order.
+ */
+declare function getArtifactWorkflowNavigationTarget(workflow: ArtifactWorkflow): ArtifactWorkflowNode | null;
+declare function projectArtifactWorkflow(artifact: ArtifactLike, allArtifacts?: readonly ArtifactLike[], now?: number): ArtifactWorkflow;
+declare function getCurrentArtifactWorkflowNode(workflow: ArtifactWorkflow): ArtifactWorkflowNode | null;
+declare function getArtifactWorkflowNodes(workflow: ArtifactWorkflow): ArtifactWorkflowNode[];
+declare function canInspectArtifactWorkflowNode(node: ArtifactWorkflowNode): boolean;
+declare function assertArtifactWorkflow(workflow: ArtifactWorkflow): void;
+declare function requireArtifactWorkflow<T extends ArtifactLike>(artifact: T): T;
+declare function requireArtifactWorkflowResult<T extends {
+    artifact: ArtifactLike;
+}>(result: T): T;
+
+type ArtifactSurfaceKind = "input" | "review" | "executing" | "approval" | "blocked" | "failure" | "partial" | "result" | "canceled" | "stale";
+type ArtifactSurfaceActionId = "continue" | "edit" | "execute" | "approve" | "decline" | "retry" | "refresh" | "check_status" | "close";
+interface ArtifactSurfaceAction {
+    id: ArtifactSurfaceActionId;
+    label: string;
+    disabled: boolean;
+    disabledReason: string | null;
+    tone: "primary" | "secondary" | "destructive";
+}
+interface ArtifactSurfaceContext {
+    activeEditorNodeId?: string | null;
+    busyAction?: string | null;
+    canApprove?: boolean;
+    canEdit?: boolean;
+    canExecute?: boolean;
+    mutationsDisabled?: boolean;
+    directError?: string | null;
+    transportStatus?: "connected" | "reconnecting" | "offline";
+}
+interface ArtifactSurfaceModel {
+    artifactId: string;
+    revision: number;
+    updatedAt: number;
+    kind: ArtifactSurfaceKind;
+    title: string;
+    description: string | null;
+    statusLabel: string | null;
+    announcement: string;
+    workflow: ArtifactWorkflow;
+    activeNodeId: string | null;
+    operationNodeId: string | null;
+    showNavigation: boolean;
+    primaryAction: ArtifactSurfaceAction | null;
+    secondaryActions: ArtifactSurfaceAction[];
+    transportStatus: "connected" | "reconnecting" | "offline";
+}
+declare function selectArtifactSurface(artifact: SessionArtifactRecord, context?: ArtifactSurfaceContext): ArtifactSurfaceModel;
+
+export { type ArtifactSurfaceAction, type ArtifactSurfaceActionId, type ArtifactSurfaceContext, type ArtifactSurfaceKind, type ArtifactSurfaceModel, ArtifactWorkflow, ArtifactWorkflowNode, ArtifactWorkflowNodeStatus, CommitDeclaration, CommitReceipt, CommitTransitionInvocation, CommitTransitionOutcomeDeclaration, type CommitTransport, type ConditionalPolicySpec, type DefinedStateMachine, EffectCommitRequest, EffectHandlerContext, EndpointMode, EnvironmentData, EnvironmentRecordImportSummary, type EnvironmentSetupPollInput, type EnvironmentSetupProgress, type EnvironmentSetupRequestError, type EnvironmentSetupResponse, FeedItem, FeedPublishTransport, type JobPresentation, type LimitPolicySpec, ManifestContent, ManifestEffectMetamodelSpec, type NormalizedPromptChoiceOption, type PermissionActionSpec, type PermissionPolicySpec, type PermissionProfileFile, type PolicyDecision, type PolicyEvaluationContext, type PolicyOutcome, ProjectionMapper, ProjectionResult, Prompt, RecordObjectOptions, type RecordSnapshotCommitSource, ResolvedEffectBehaviors, SessionArtifactRecord, SessionHeapEntry, SessionHeapList, SessionHeapSnapshot, SessionTranscriptEntry, type StateMachineDefinition, ToolWithHandler, type ValidationRuleEvaluationInput, type ValidationRuleEvaluationResult, assertArtifactWorkflow, buildSessionTranscript, buildSessionTranscriptFromFeedItems, canInspectArtifactWorkflowNode, canonicalizeCommitValue, changedRecordSnapshots, defineEffect, defineProjection, defineStateMachine, environmentSetupProgressFromError, environmentSetupProgressFromResponse, evaluateValidationRule, extractPromptTokens, getArtifactWorkflowNavigationLeaves, getArtifactWorkflowNavigationTarget, getArtifactWorkflowNodes, getCurrentArtifactWorkflowNode, invokeRegisteredEffect, isArtifactWorkflowNodeNavigableLeaf, isArtifactWorkflowNodeTerminal, isLocalApiUrl, normalizeEffectBehaviors, normalizePrompt, normalizePromptChoiceOption, normalizePromptText, normalizePromptType, pollEnvironmentSetup, projectArtifactWorkflow, projectRecordSnapshotMutation, requireArtifactWorkflow, requireArtifactWorkflowResult, resolveApiUrl, resolveAuthTokenForApiUrl, resolveJobPresentation, resolvePromptAnswer, scorePromptChoiceMatch, selectArtifactSurface, validateProjectionResult, validationRuleFailureMessage };

package/dist/index.d.ts

@@ -1,6 +1,6 @@
-export { E as Environment, a as EnvironmentSession, G as Granular, O as OntologyHandle, S as Session, W as WSClient, i as isGraphQLMutationDocument } from './client-D1gq4TO4.js';
-import { E as EnvironmentData, a as EnvironmentRecordImportSummary, b as EndpointMode, c as EffectCommitRequest, C as CommitReceipt, T as ToolWithHandler, P as ProjectionResult, d as ProjectionMapper, e as CommitTransitionOutcomeDeclaration, f as CommitDeclaration, g as EffectHandlerContext, F as FeedPublishTransport, M as ManifestEffectMetamodelSpec, R as ResolvedEffectBehaviors, h as RecordObjectOptions, i as ManifestContent, j as CommitTransitionInvocation, S as SessionHeapEntry, k as SessionHeapList, l as FeedItem, m as SessionHeapSnapshot, n as Prompt, o as SessionTranscriptEntry } from './spend-B-IQmp7F.js';
-export { eh as APIError, aS as AccessTokenProvider, Y as ActionSuggestionFeedItem, aZ as AdoptEnvironmentOptions, bK as AgentCommitStatus, cN as ArtifactApprovalDecisionInput, cO as ArtifactApprovalDecisionResult, cL as ArtifactApprovalTask, cM as ArtifactApprovalTaskListOptions, cK as ArtifactApprovalTaskStatus, U as ArtifactFeedItem, b_ as ArtifactOptionsHandler, bj as Assignment, bk as AssignmentListResponse, cm as AssistantReplyPublicationInput, cn as AssistantReplyPublicationResult, bH as BaseProjectionResult, bt as Build, bv as BuildListResponse, bl as BuildPolicy, bs as BuildStatus, bC as CanonicalProjectedRecord, bL as CommitChangeReceipt, bA as CommitSafeError, bM as CommitTransitionReceipt, aO as ConditionIR, a_ as ConnectOptions, b0 as ConversationSessionInfo, b2 as ConversationSessionListOptions, b3 as ConversationSessionListResponse, b1 as ConversationSessionListStatus, bo as CreateEnvironmentData, bh as CreatePermissionProfileData, bd as CreateSandboxData, a$ as CreateSessionOptions, dr as DefineRelationshipOptions, ei as DeleteResponse, D as DomainState, bW as EffectArtifactOptionsInvocation, bY as EffectArtifactRelationshipOption, bZ as EffectArtifactRelationshipOptionsResult, bQ as EffectCommitContext, c7 as EffectHandler, c4 as EffectInfo, bX as EffectInvocationMetadata, bV as EffectInvocationMode, bI as EffectProjectionResult, b$ as EffectSchema, c2 as EffectVersionSelector, c0 as EffectWithHandler, c6 as EffectsChangedEvent, cf as EnvironmentFeedbackRecord, dO as EnvironmentImporter, dN as EnvironmentImporterImportOptions, bp as EnvironmentListResponse, dM as EnvironmentSetupImporterClaim, dK as EnvironmentSetupLifecycleStatus, dL as EnvironmentSetupSummary, dI as EnvironmentSetupTriggerReason, dw as EnvironmentStateMachineProxy, du as EnvironmentStateObservationInput, dx as EnvironmentStateProxy, dt as EnvironmentStateTarget, dv as EnvironmentStateUpdateInput, bN as ExternalCommitOptions, ac as FeedDiagnostic, ad as FeedDiagnosticListener, ak as FeedDocumentState, v as FeedFeedbackTone, V as FeedFileSource, u as FeedIconToken, z as FeedItemBase, x as FeedItemKind, a3 as FeedListOptions, aa as FeedListTransport, G as FeedObjectReference, a4 as FeedPage, av as FeedPublisher, a2 as FeedSnapshot, ab as FeedSnapshotRegressionReason, t as FeedSource, s as FeedSourceActor, a5 as FeedSubscribeOptions, a6 as FeedSubscriptionChange, H as FeedTableCell, J as FeedTableColumn, N as FeedTableProjection, L as FeedTableRow, K as FeedTableRowReference, y as FeedTarget, w as FeedTransientFeedbackTone, B as FeedbackFeedItem, W as FileFeedItem, ae as GRANULAR_FEED_DIAGNOSTIC_EVENT, aU as GranularAuth, aT as GranularOptions, ba as GranularQuotaPolicy, bb as GranularQuotaProgress, aE as GranularSpendContext, eg as GraphQLResult, c8 as InstanceEffectHandler, I as InstanceToolHandler, ch as Job, cd as JobFeedbackInput, cc as JobFeedbackMetadata, ce as JobFeedbackRecord, ca as JobFeedbackSentiment, cb as JobFeedbackToolCall, c9 as JobStatus, cg as JobSubmitResult, bq as Manifest, e6 as ManifestApprovalRequiredSpec, e7 as ManifestCreatesSpec, e4 as ManifestDryRunSpec, ea as ManifestEffectDeclaration, e9 as ManifestEffectSchema, dR as ManifestEnumRuleSpec, ec as ManifestEventStreamDef, eb as ManifestEventTypeDef, dS as ManifestFilterBySpec, ee as ManifestImport, br as ManifestListResponse, ed as ManifestOperation, e3 as ManifestPostConditionSpec, dP as ManifestPropertySpec, e8 as ManifestRelationshipDef, e5 as ManifestReverseSpec, e2 as ManifestStateMachineSpec, dU as ManifestStateMachineStateSpec, e1 as ManifestStateMachineTransitionSpec, dW as ManifestStateTransitionActionSpec, dX as ManifestStateTransitionAssigneeSpec, d$ as ManifestStateTransitionExpectedOutcomeSpec, dV as ManifestStateTransitionInputBinding, e0 as ManifestStateTransitionOutcomeSpec, d_ as ManifestStateTransitionPermissionSpec, dY as ManifestStateTransitionRelatedStateRequirementSpec, dZ as ManifestStateTransitionRequirementsSpec, dQ as ManifestValidationOperator, dT as ManifestValidationRuleSpec, ef as ManifestVolume, cW as ManualActionListOptions, cU as ManualActionOccurrence, cV as ManualActionRecordResult, cS as ManualActionRelatedRecord, cQ as ManualActionSource, cP as ManualActionStatus, cX as ManualActionSuggestion, cY as ManualActionSuggestionOptions, cR as ManualActionTarget, de as MarkUserEnvironmentReadOptions, aR as MatchedPolicy, A as MessageFeedItem, dp as ModelRef, ay as NormalizedOpenAIUsage, X as NormalizedSuggestedArtifact, aA as OPENAI_MODEL_PRICING_USD_PER_MILLION, bD as ObjectProjectionChange, by as ObjectReference, O as ObjectsFeedItem, bO as ObservationReceipt, ax as OpenAIModelPricing, az as OpenAITokenSpend, aF as OpenAIUsageSpendEvent, aY as OpenEnvironmentOptions, bg as PermissionProfile, bi as PermissionProfileListResponse, bf as PermissionRules, aN as PolicyOperator, aP as PolicyOrigin, aM as PolicyPredicateSource, aQ as PolicyRuleIR, aL as PolicySource, bG as ProjectionChange, Z as PromptFeedItem, c1 as PublishEffectsResult, ar as PublishFeedbackOptions, q as PublishToolsResult, as as PublishTransientFeedbackOptions, b9 as QuotaLineItemFilter, b6 as QuotaPeriod, b5 as QuotaScopeType, b7 as QuotaStatus, di as RPCRequest, dl as RPCRequestFromServer, dj as RPCResponse, dH as RecordImport, dG as RecordImportItem, dE as RecordImportItemStatus, dC as RecordImportOptions, dF as RecordImportStats, dD as RecordImportStatus, dB as RecordImportWriteMode, cT as RecordManualActionInput, d4 as RecordMentionInput, dy as RecordObjectResult, ds as RecordObjectStateValue, dz as RecordObjectsChunkInfo, dA as RecordObjectsOptions, aG as RecordOpenAIUsageSpendOptions, aH as RecordOpenAIUsageSpendResult, d3 as RecordSearchOptions, d2 as RecordSearchResult, aW as RecordUserOptions, dq as RelationshipInfo, bE as RelationshipProjectionChange, bU as ResolvedEffectApprovalRequired, bS as ResolvedEffectDryRun, bR as ResolvedEffectPostCondition, bT as ResolvedEffectReverse, dJ as RunEnvironmentImporterOptions, bc as Sandbox, be as SandboxListResponse, bx as SemanticVersionDiff, bw as SemanticVersionDiffEntry, cJ as SessionArtifactApprovalOptions, cx as SessionArtifactAutonomyPolicy, cI as SessionArtifactExecutionOptions, cH as SessionArtifactExecutionResult, cz as SessionArtifactFieldProvenance, cy as SessionArtifactFieldProvenanceSource, cw as SessionArtifactKind, cB as SessionArtifactListOptions, cA as SessionArtifactRecord, cG as SessionArtifactRelationshipCreateInput, cE as SessionArtifactRelationshipOption, cD as SessionArtifactRelationshipOptionsInput, cF as SessionArtifactRelationshipOptionsResult, cv as SessionArtifactStatus, cC as SessionArtifactValidationResult, d6 as SessionCollectionListOptions, d8 as SessionCollectionListResult, d5 as SessionDocumentResult, a7 as SessionFeedApi, aq as SessionFeedController, aj as SessionFeedControllerOptions, cs as SessionFileKind, cu as SessionFileRecord, cr as SessionFileSource, ct as SessionFileStatus, cZ as SessionFileUploadOptions, c$ as SessionHeapFieldType, d0 as SessionHeapFieldValue, d1 as SessionHeapVariable, d7 as SessionJobListOptions, c_ as SessionJobRecord, bP as SessionMutationView, cq as SessionTimelineEvent, co as SessionTranscriptActionSuggestion, cp as SessionTranscriptShowRefs, at as SettleTransientFeedbackOptions, dk as SnapshotResetMessage, bz as SourceAcknowledgement, b4 as SpendLineItemType, b8 as SpendSummary, bF as StateObservationProjectionChange, ej as StreamEvent, el as StreamStats, ek as StreamSubscription, aX as Subject, Q as TableFeedItem, r as ToolHandler, c3 as ToolInfo, dm as ToolInvokeParams, dn as ToolResultParams, p as ToolSchema, c5 as ToolsChangedEvent, a1 as TransientFeedItem, _ as TransientFeedItemBase, a0 as TransientFeedbackFeedItem, au as TransientFeedbackHandle, $ as TransientMessageFeedItem, bB as TransitionOutcomeProjection, bJ as TransitionProjectionResult, aV as User, da as UserEnvironmentMessagePreview, d9 as UserEnvironmentPrompt, db as UserEnvironmentSessionState, dc as UserEnvironmentState, dd as UserEnvironmentStateOptions, cl as UserMessageAppendResult, ck as UserMessageInput, ci as UserMessageShowRefs, cj as UserMessageTarget, bu as Version, bn as VersionTag, bm as VersionTracking, dh as WSClientOptions, df as WSDisconnectInfo, dg as WSReconnectErrorInfo, aJ as buildOpenAISpendEventId, aD as calculateOpenAITokenSpend, aw as createFeedPublisher, ai as emitFeedDiagnostic, ah as emitFeedDiagnosticToDefaultSink, al as emptyFeedSnapshot, aB as getOpenAIModelPricing, am as hasCanonicalSessionFeedActivation, an as isCanonicalSessionFeedDocument, a8 as mergeFeedItemsBySequence, ag as normalizeFeedDiagnostic, af as normalizeFeedDiagnosticKind, ap as normalizeFeedPage, aC as normalizeOpenAIUsage, a9 as orderTransientFeedItems, ao as readSessionFeedSnapshot, aK as recordOpenAIUsageSpend, aI as toGranularHttpBase } from './spend-B-IQmp7F.js';
+export { E as Environment, a as EnvironmentSession, G as Granular, O as OntologyHandle, S as Session, W as WSClient, i as isGraphQLMutationDocument } from './client-JCISbded.js';
+import { E as EnvironmentData, a as EnvironmentRecordImportSummary, b as EndpointMode, c as EffectCommitRequest, C as CommitReceipt, T as ToolWithHandler, P as ProjectionResult, d as ProjectionMapper, e as CommitTransitionOutcomeDeclaration, f as CommitDeclaration, g as EffectHandlerContext, F as FeedPublishTransport, M as ManifestEffectMetamodelSpec, R as ResolvedEffectBehaviors, h as RecordObjectOptions, i as ManifestContent, j as CommitTransitionInvocation, S as SessionHeapEntry, k as SessionHeapList, l as FeedItem, m as SessionHeapSnapshot, n as Prompt, o as SessionTranscriptEntry, A as ArtifactWorkflowNode, p as ArtifactWorkflowNodeStatus, q as ArtifactWorkflow, r as SessionArtifactRecord } from './spend-lJDtuAr6.js';
+export { ev as APIError, aW as AccessTokenProvider, a0 as ActionSuggestionFeedItem, b1 as AdoptEnvironmentOptions, bO as AgentCommitStatus, cZ as ArtifactApprovalDecisionInput, c_ as ArtifactApprovalDecisionResult, cX as ArtifactApprovalTask, cY as ArtifactApprovalTaskListOptions, cW as ArtifactApprovalTaskStatus, Y as ArtifactFeedItem, c2 as ArtifactOptionsHandler, cH as ArtifactWorkflowAttention, cC as ArtifactWorkflowCompletionState, cD as ArtifactWorkflowNodeAvailability, cB as ArtifactWorkflowNodeKind, cE as ArtifactWorkflowOperationPhase, cG as ArtifactWorkflowRecap, cF as ArtifactWorkflowRecapItem, bn as Assignment, bo as AssignmentListResponse, cq as AssistantReplyPublicationInput, cr as AssistantReplyPublicationResult, bL as BaseProjectionResult, bx as Build, bz as BuildListResponse, bp as BuildPolicy, bw as BuildStatus, bG as CanonicalProjectedRecord, bP as CommitChangeReceipt, bE as CommitSafeError, bQ as CommitTransitionReceipt, aS as ConditionIR, b2 as ConnectOptions, b4 as ConversationSessionInfo, b6 as ConversationSessionListOptions, b7 as ConversationSessionListResponse, b5 as ConversationSessionListStatus, bs as CreateEnvironmentData, bl as CreatePermissionProfileData, bh as CreateSandboxData, b3 as CreateSessionOptions, dF as DefineRelationshipOptions, ew as DeleteResponse, D as DomainState, b_ as EffectArtifactOptionsInvocation, c0 as EffectArtifactRelationshipOption, c1 as EffectArtifactRelationshipOptionsResult, bU as EffectCommitContext, cb as EffectHandler, c8 as EffectInfo, b$ as EffectInvocationMetadata, bZ as EffectInvocationMode, bM as EffectProjectionResult, c3 as EffectSchema, c6 as EffectVersionSelector, c4 as EffectWithHandler, ca as EffectsChangedEvent, cj as EnvironmentFeedbackRecord, e0 as EnvironmentImporter, d$ as EnvironmentImporterImportOptions, bt as EnvironmentListResponse, d_ as EnvironmentSetupImporterClaim, dY as EnvironmentSetupLifecycleStatus, dZ as EnvironmentSetupSummary, dW as EnvironmentSetupTriggerReason, dK as EnvironmentStateMachineProxy, dI as EnvironmentStateObservationInput, dL as EnvironmentStateProxy, dH as EnvironmentStateTarget, dJ as EnvironmentStateUpdateInput, bR as ExternalCommitOptions, ag as FeedDiagnostic, ah as FeedDiagnosticListener, ao as FeedDocumentState, y as FeedFeedbackTone, Z as FeedFileSource, x as FeedIconToken, H as FeedItemBase, B as FeedItemKind, a7 as FeedListOptions, ae as FeedListTransport, L as FeedObjectReference, a8 as FeedPage, az as FeedPublisher, a6 as FeedSnapshot, af as FeedSnapshotRegressionReason, w as FeedSource, v as FeedSourceActor, a9 as FeedSubscribeOptions, aa as FeedSubscriptionChange, N as FeedTableCell, Q as FeedTableColumn, W as FeedTableProjection, V as FeedTableRow, U as FeedTableRowReference, G as FeedTarget, z as FeedTransientFeedbackTone, dz as FeedTransientPatchMessage, K as FeedbackFeedItem, _ as FileFeedItem, ai as GRANULAR_FEED_DIAGNOSTIC_EVENT, aY as GranularAuth, aX as GranularOptions, be as GranularQuotaPolicy, bf as GranularQuotaProgress, aI as GranularSpendContext, eu as GraphQLResult, cc as InstanceEffectHandler, I as InstanceToolHandler, cl as Job, dy as JobActionTraceMessage, ch as JobFeedbackInput, cg as JobFeedbackMetadata, ci as JobFeedbackRecord, ce as JobFeedbackSentiment, cf as JobFeedbackToolCall, cd as JobStatus, ck as JobSubmitResult, bu as Manifest, ek as ManifestApprovalRequiredSpec, el as ManifestCreatesSpec, ei as ManifestDryRunSpec, eo as ManifestEffectDeclaration, en as ManifestEffectSchema, e3 as ManifestEnumRuleSpec, eq as ManifestEventStreamDef, ep as ManifestEventTypeDef, e4 as ManifestFilterBySpec, es as ManifestImport, bv as ManifestListResponse, er as ManifestOperation, eh as ManifestPostConditionSpec, e1 as ManifestPropertySpec, em as ManifestRelationshipDef, ej as ManifestReverseSpec, eg as ManifestStateMachineSpec, e6 as ManifestStateMachineStateSpec, ef as ManifestStateMachineTransitionSpec, e8 as ManifestStateTransitionActionSpec, e9 as ManifestStateTransitionAssigneeSpec, ed as ManifestStateTransitionExpectedOutcomeSpec, e7 as ManifestStateTransitionInputBinding, ee as ManifestStateTransitionOutcomeSpec, ec as ManifestStateTransitionPermissionSpec, ea as ManifestStateTransitionRelatedStateRequirementSpec, eb as ManifestStateTransitionRequirementsSpec, e2 as ManifestValidationOperator, e5 as ManifestValidationRuleSpec, et as ManifestVolume, d6 as ManualActionListOptions, d4 as ManualActionOccurrence, d5 as ManualActionRecordResult, d2 as ManualActionRelatedRecord, d0 as ManualActionSource, c$ as ManualActionStatus, d7 as ManualActionSuggestion, d8 as ManualActionSuggestionOptions, d1 as ManualActionTarget, dr as MarkUserEnvironmentReadOptions, aV as MatchedPolicy, J as MessageFeedItem, dD as ModelRef, aC as NormalizedOpenAIUsage, $ as NormalizedSuggestedArtifact, aE as OPENAI_MODEL_PRICING_USD_PER_MILLION, bH as ObjectProjectionChange, bC as ObjectReference, O as ObjectsFeedItem, bS as ObservationReceipt, aB as OpenAIModelPricing, aD as OpenAITokenSpend, aJ as OpenAIUsageSpendEvent, b0 as OpenEnvironmentOptions, bk as PermissionProfile, bm as PermissionProfileListResponse, bj as PermissionRules, aR as PolicyOperator, aT as PolicyOrigin, aQ as PolicyPredicateSource, aU as PolicyRuleIR, aP as PolicySource, bK as ProjectionChange, a1 as PromptFeedItem, c5 as PublishEffectsResult, av as PublishFeedbackOptions, t as PublishToolsResult, aw as PublishTransientFeedbackOptions, bd as QuotaLineItemFilter, ba as QuotaPeriod, b9 as QuotaScopeType, bb as QuotaStatus, dv as RPCRequest, dA as RPCRequestFromServer, dw as RPCResponse, dV as RecordImport, dU as RecordImportItem, dS as RecordImportItemStatus, dQ as RecordImportOptions, dT as RecordImportStats, dR as RecordImportStatus, dP as RecordImportWriteMode, d3 as RecordManualActionInput, dg as RecordMentionInput, dM as RecordObjectResult, dG as RecordObjectStateValue, dN as RecordObjectsChunkInfo, dO as RecordObjectsOptions, aK as RecordOpenAIUsageSpendOptions, aL as RecordOpenAIUsageSpendResult, df as RecordSearchOptions, de as RecordSearchResult, a_ as RecordUserOptions, dE as RelationshipInfo, bI as RelationshipProjectionChange, bY as ResolvedEffectApprovalRequired, bW as ResolvedEffectDryRun, bV as ResolvedEffectPostCondition, bX as ResolvedEffectReverse, dX as RunEnvironmentImporterOptions, bg as Sandbox, bi as SandboxListResponse, bB as SemanticVersionDiff, bA as SemanticVersionDiffEntry, cV as SessionArtifactApprovalOptions, cI as SessionArtifactAutonomyPolicy, cU as SessionArtifactExecutionOptions, cT as SessionArtifactExecutionResult, cM as SessionArtifactFieldProvenance, cJ as SessionArtifactFieldProvenanceSource, cA as SessionArtifactKind, cN as SessionArtifactListOptions, cS as SessionArtifactRelationshipCreateInput, cQ as SessionArtifactRelationshipOption, cP as SessionArtifactRelationshipOptionsInput, cR as SessionArtifactRelationshipOptionsResult, cL as SessionArtifactRequestContext, cK as SessionArtifactRequestContextSource, cz as SessionArtifactStatus, cO as SessionArtifactValidationResult, di as SessionCollectionListOptions, dk as SessionCollectionListResult, dh as SessionDocumentResult, ab as SessionFeedApi, au as SessionFeedController, an as SessionFeedControllerOptions, cw as SessionFileKind, cy as SessionFileRecord, cv as SessionFileSource, cx as SessionFileStatus, d9 as SessionFileUploadOptions, db as SessionHeapFieldType, dc as SessionHeapFieldValue, dd as SessionHeapVariable, dj as SessionJobListOptions, da as SessionJobRecord, bT as SessionMutationView, cu as SessionTimelineEvent, cs as SessionTranscriptActionSuggestion, ct as SessionTranscriptShowRefs, ax as SettleTransientFeedbackOptions, dx as SnapshotResetMessage, bD as SourceAcknowledgement, b8 as SpendLineItemType, bc as SpendSummary, bJ as StateObservationProjectionChange, ex as StreamEvent, ez as StreamStats, ey as StreamSubscription, a$ as Subject, X as TableFeedItem, u as ToolHandler, c7 as ToolInfo, dB as ToolInvokeParams, dC as ToolResultParams, s as ToolSchema, c9 as ToolsChangedEvent, a5 as TransientFeedItem, a2 as TransientFeedItemBase, a4 as TransientFeedbackFeedItem, ay as TransientFeedbackHandle, a3 as TransientMessageFeedItem, bF as TransitionOutcomeProjection, bN as TransitionProjectionResult, aZ as User, dm as UserEnvironmentMessagePreview, dl as UserEnvironmentPrompt, dn as UserEnvironmentSessionState, dp as UserEnvironmentState, dq as UserEnvironmentStateOptions, cp as UserMessageAppendResult, co as UserMessageInput, cm as UserMessageShowRefs, cn as UserMessageTarget, by as Version, br as VersionTag, bq as VersionTracking, du as WSClientOptions, ds as WSDisconnectInfo, dt as WSReconnectErrorInfo, aN as buildOpenAISpendEventId, aH as calculateOpenAITokenSpend, aA as createFeedPublisher, am as emitFeedDiagnostic, al as emitFeedDiagnosticToDefaultSink, ap as emptyFeedSnapshot, aF as getOpenAIModelPricing, aq as hasCanonicalSessionFeedActivation, ar as isCanonicalSessionFeedDocument, ac as mergeFeedItemsBySequence, ak as normalizeFeedDiagnostic, aj as normalizeFeedDiagnosticKind, at as normalizeFeedPage, aG as normalizeOpenAIUsage, ad as orderTransientFeedItems, as as readSessionFeedSnapshot, aO as recordOpenAIUsageSpend, aM as toGranularHttpBase } from './spend-lJDtuAr6.js';
 export { BuildGranularAgentSystemPromptInput, GeneratedJobCodeIssue, GranularAgentExecutionCheckpoint, GranularAgentHeapSummaryOptions, GranularAgentManualActionMemorySuggestion, GranularAgentPromptCapabilities, GranularAgentReferentFocus, GranularAgentSessionContext, GranularAgentToolInfo, GranularAgentWorkflowFocus, GranularReasoningTraceChunkResult, GranularReasoningTraceOptions, HarnessContinuationDecision, HarnessControllerBudgets, HarnessProjectionOptions, HarnessPromptLike, HarnessRenderedContinuation, HarnessRenderedPrompt, HarnessTemplate, HarnessTemplateManifest, HarnessTemplateSelectionOptions, HarnessTemplateStatus, HarnessVerifierSnapshot, HarnessVerifierSnapshotInput, ReviewGeneratedJobCodeOptions, buildContinuationInstruction, buildContinuationInstructionFromTemplate, buildGranularAgentCheckpointBlock, buildGranularAgentDomainBlock, buildGranularAgentFileBlock, buildGranularAgentHeapBlock, buildGranularAgentLoopBlock, buildGranularAgentManualActionBlock, buildGranularAgentManualActionMemorySummary, buildGranularAgentReferentBlock, buildGranularAgentRuntimeImportsBlock, buildGranularAgentSessionBlock, buildGranularAgentSystemPrompt, buildGranularAgentSystemPromptFromTemplate, buildGranularAgentToolBlock, buildGranularAgentWorkflowBlock, consumeGranularReasoningOnlyChunk, consumeGranularReasoningTraceChunk, createHarnessVerifierSnapshot, evaluateContinuation, getCurrentClosureId, getDefaultHarnessTemplateId, getExclusivePromptTarget, hasOpenPrompt, hashHarnessTemplateValue, listHarnessTemplates, projectConversationReferentFocus, projectConversationReferentSummary, projectHeapSummary, projectLoopSummary, projectSessionFileSummary, projectWorkflowFocus, projectWorkflowSummary, renderContinuationInstructionFromTemplate, renderGranularAgentSystemPromptFromTemplate, resolveHarnessTemplate, reviewGeneratedJobCode, stripGranularReasoningTrace, validateHarnessTemplateManifest } from './agent-harness.js';
 import '@automerge/automerge';
 import '@automerge/automerge/slim';
@@ -130,6 +130,7 @@ declare function invokeRegisteredEffect(effectMap: Map<string, ToolWithHandler>,
 interface RecordSnapshotCommitSource {
     reference: string;
     version?: string;
+    versionScope?: "global" | "target";
     beforeRecords: RecordObjectOptions[];
     afterRecords: RecordObjectOptions[];
 }
@@ -311,4 +312,66 @@ declare function buildSessionTranscript(input: {
     canonicalFeedItems?: FeedItem[];
 }): SessionTranscriptEntry[];
 
-export { CommitDeclaration, CommitReceipt, CommitTransitionInvocation, CommitTransitionOutcomeDeclaration, type CommitTransport, type ConditionalPolicySpec, type DefinedStateMachine, EffectCommitRequest, EffectHandlerContext, EndpointMode, EnvironmentData, EnvironmentRecordImportSummary, type EnvironmentSetupPollInput, type EnvironmentSetupProgress, type EnvironmentSetupRequestError, type EnvironmentSetupResponse, FeedItem, FeedPublishTransport, type JobPresentation, type LimitPolicySpec, ManifestContent, ManifestEffectMetamodelSpec, type NormalizedPromptChoiceOption, type PermissionActionSpec, type PermissionPolicySpec, type PermissionProfileFile, type PolicyDecision, type PolicyEvaluationContext, type PolicyOutcome, ProjectionMapper, ProjectionResult, Prompt, RecordObjectOptions, type RecordSnapshotCommitSource, ResolvedEffectBehaviors, SessionHeapEntry, SessionHeapList, SessionHeapSnapshot, SessionTranscriptEntry, type StateMachineDefinition, ToolWithHandler, type ValidationRuleEvaluationInput, type ValidationRuleEvaluationResult, buildSessionTranscript, buildSessionTranscriptFromFeedItems, canonicalizeCommitValue, changedRecordSnapshots, defineEffect, defineProjection, defineStateMachine, environmentSetupProgressFromError, environmentSetupProgressFromResponse, evaluateValidationRule, extractPromptTokens, invokeRegisteredEffect, isLocalApiUrl, normalizeEffectBehaviors, normalizePrompt, normalizePromptChoiceOption, normalizePromptText, normalizePromptType, pollEnvironmentSetup, projectRecordSnapshotMutation, resolveApiUrl, resolveAuthTokenForApiUrl, resolveJobPresentation, resolvePromptAnswer, scorePromptChoiceMatch, validateProjectionResult, validationRuleFailureMessage };
+type ArtifactLike = Omit<SessionArtifactRecord, "workflow"> & {
+    workflow?: ArtifactWorkflow | null;
+};
+declare function isArtifactWorkflowNodeTerminal(nodeOrStatus: ArtifactWorkflowNode | ArtifactWorkflowNodeStatus): boolean;
+declare function getArtifactWorkflowNavigationLeaves(workflow: ArtifactWorkflow): ArtifactWorkflowNode[];
+declare function isArtifactWorkflowNodeNavigableLeaf(workflow: ArtifactWorkflow, node: ArtifactWorkflowNode): boolean;
+/**
+ * Resolve the only automatic destination allowed by the workflow contract.
+ * The first non-terminal actionable leaf owns the next user interaction. A
+ * terminal workflow has no active leaf, so the last leaf remains the stable
+ * recap destination. This selector is shared by the SDK projector and UI;
+ * neither caller is allowed to infer a destination from labels or row order.
+ */
+declare function getArtifactWorkflowNavigationTarget(workflow: ArtifactWorkflow): ArtifactWorkflowNode | null;
+declare function projectArtifactWorkflow(artifact: ArtifactLike, allArtifacts?: readonly ArtifactLike[], now?: number): ArtifactWorkflow;
+declare function getCurrentArtifactWorkflowNode(workflow: ArtifactWorkflow): ArtifactWorkflowNode | null;
+declare function getArtifactWorkflowNodes(workflow: ArtifactWorkflow): ArtifactWorkflowNode[];
+declare function canInspectArtifactWorkflowNode(node: ArtifactWorkflowNode): boolean;
+declare function assertArtifactWorkflow(workflow: ArtifactWorkflow): void;
+declare function requireArtifactWorkflow<T extends ArtifactLike>(artifact: T): T;
+declare function requireArtifactWorkflowResult<T extends {
+    artifact: ArtifactLike;
+}>(result: T): T;
+
+type ArtifactSurfaceKind = "input" | "review" | "executing" | "approval" | "blocked" | "failure" | "partial" | "result" | "canceled" | "stale";
+type ArtifactSurfaceActionId = "continue" | "edit" | "execute" | "approve" | "decline" | "retry" | "refresh" | "check_status" | "close";
+interface ArtifactSurfaceAction {
+    id: ArtifactSurfaceActionId;
+    label: string;
+    disabled: boolean;
+    disabledReason: string | null;
+    tone: "primary" | "secondary" | "destructive";
+}
+interface ArtifactSurfaceContext {
+    activeEditorNodeId?: string | null;
+    busyAction?: string | null;
+    canApprove?: boolean;
+    canEdit?: boolean;
+    canExecute?: boolean;
+    mutationsDisabled?: boolean;
+    directError?: string | null;
+    transportStatus?: "connected" | "reconnecting" | "offline";
+}
+interface ArtifactSurfaceModel {
+    artifactId: string;
+    revision: number;
+    updatedAt: number;
+    kind: ArtifactSurfaceKind;
+    title: string;
+    description: string | null;
+    statusLabel: string | null;
+    announcement: string;
+    workflow: ArtifactWorkflow;
+    activeNodeId: string | null;
+    operationNodeId: string | null;
+    showNavigation: boolean;
+    primaryAction: ArtifactSurfaceAction | null;
+    secondaryActions: ArtifactSurfaceAction[];
+    transportStatus: "connected" | "reconnecting" | "offline";
+}
+declare function selectArtifactSurface(artifact: SessionArtifactRecord, context?: ArtifactSurfaceContext): ArtifactSurfaceModel;
+
+export { type ArtifactSurfaceAction, type ArtifactSurfaceActionId, type ArtifactSurfaceContext, type ArtifactSurfaceKind, type ArtifactSurfaceModel, ArtifactWorkflow, ArtifactWorkflowNode, ArtifactWorkflowNodeStatus, CommitDeclaration, CommitReceipt, CommitTransitionInvocation, CommitTransitionOutcomeDeclaration, type CommitTransport, type ConditionalPolicySpec, type DefinedStateMachine, EffectCommitRequest, EffectHandlerContext, EndpointMode, EnvironmentData, EnvironmentRecordImportSummary, type EnvironmentSetupPollInput, type EnvironmentSetupProgress, type EnvironmentSetupRequestError, type EnvironmentSetupResponse, FeedItem, FeedPublishTransport, type JobPresentation, type LimitPolicySpec, ManifestContent, ManifestEffectMetamodelSpec, type NormalizedPromptChoiceOption, type PermissionActionSpec, type PermissionPolicySpec, type PermissionProfileFile, type PolicyDecision, type PolicyEvaluationContext, type PolicyOutcome, ProjectionMapper, ProjectionResult, Prompt, RecordObjectOptions, type RecordSnapshotCommitSource, ResolvedEffectBehaviors, SessionArtifactRecord, SessionHeapEntry, SessionHeapList, SessionHeapSnapshot, SessionTranscriptEntry, type StateMachineDefinition, ToolWithHandler, type ValidationRuleEvaluationInput, type ValidationRuleEvaluationResult, assertArtifactWorkflow, buildSessionTranscript, buildSessionTranscriptFromFeedItems, canInspectArtifactWorkflowNode, canonicalizeCommitValue, changedRecordSnapshots, defineEffect, defineProjection, defineStateMachine, environmentSetupProgressFromError, environmentSetupProgressFromResponse, evaluateValidationRule, extractPromptTokens, getArtifactWorkflowNavigationLeaves, getArtifactWorkflowNavigationTarget, getArtifactWorkflowNodes, getCurrentArtifactWorkflowNode, invokeRegisteredEffect, isArtifactWorkflowNodeNavigableLeaf, isArtifactWorkflowNodeTerminal, isLocalApiUrl, normalizeEffectBehaviors, normalizePrompt, normalizePromptChoiceOption, normalizePromptText, normalizePromptType, pollEnvironmentSetup, projectArtifactWorkflow, projectRecordSnapshotMutation, requireArtifactWorkflow, requireArtifactWorkflowResult, resolveApiUrl, resolveAuthTokenForApiUrl, resolveJobPresentation, resolvePromptAnswer, scorePromptChoiceMatch, selectArtifactSurface, validateProjectionResult, validationRuleFailureMessage };