@granular-software/sdk 0.4.72 → 0.4.74

package/dist/cli/index.js

@@ -7818,6 +7818,22 @@ var ApiClient = class {
       try {
         const parsed = JSON.parse(errorText);
         errorMsg = parsed.message || parsed.error || errorMsg;
+        if (Array.isArray(parsed.errors)) {
+          const details = parsed.errors.flatMap((issue) => {
+            if (!issue || typeof issue !== "object") return [];
+            const { code, path: path8, message } = issue;
+            if (typeof message !== "string") return [];
+            return [
+              [
+                typeof code === "string" ? code : "Validation error",
+                typeof path8 === "string" ? `at ${path8}` : "",
+                message
+              ].filter(Boolean).join(": ")
+            ];
+          });
+          if (details.length) errorMsg += `
+${details.join("\n")}`;
+        }
       } catch {
         errorMsg = errorText || errorMsg;
       }
@@ -15705,7 +15721,7 @@ function buildMachineTypes(classSummary, machine) {
   ];
 }
 function buildMachineMethods(classSummary, machine) {
-  const stateName = stateTypeName(classSummary.name, machine.name);
+  const stateName2 = stateTypeName(classSummary.name, machine.name);
   const transitionName = transitionTypeName(classSummary.name, machine.name);
   pathTypeName(classSummary.name, machine.name);
   const docsPrefix = `${classSummary.name}.${machine.name}`;
@@ -15715,12 +15731,12 @@ function buildMachineMethods(classSummary, machine) {
       docs: [`Get the current ${docsPrefix} state.`],
       static: false,
       params: [],
-      returnType: `Promise<${stateName} | null>`,
+      returnType: `Promise<${stateName2} | null>`,
       runtime: {
         kind: "state_machine",
         machineName: machine.name,
         className: classSummary.name,
-        stateTypeName: stateName,
+        stateTypeName: stateName2,
         transitionTypeName: transitionName,
         operation: "get_current"
       }
@@ -15731,13 +15747,13 @@ function buildMachineMethods(classSummary, machine) {
         `Reach a ${docsPrefix} state through the shortest allowed transition path.`
       ],
       static: false,
-      params: [{ name: "target", type: stateName }],
+      params: [{ name: "target", type: stateName2 }],
       returnType: `Promise<${toPascalCase2(classSummary.name)}>`,
       runtime: {
         kind: "state_machine",
         machineName: machine.name,
         className: classSummary.name,
-        stateTypeName: stateName,
+        stateTypeName: stateName2,
         transitionTypeName: transitionName,
         operation: "reach"
       }
@@ -15752,7 +15768,7 @@ function buildMachineMethods(classSummary, machine) {
         kind: "state_machine",
         machineName: machine.name,
         className: classSummary.name,
-        stateTypeName: stateName,
+        stateTypeName: stateName2,
         transitionTypeName: transitionName,
         operation: "list_transitions"
       }
@@ -15762,12 +15778,12 @@ function buildMachineMethods(classSummary, machine) {
       docs: [`List reachable states for ${docsPrefix} from the current state.`],
       static: false,
       params: [],
-      returnType: `Promise<${stateName}[]>`,
+      returnType: `Promise<${stateName2}[]>`,
       runtime: {
         kind: "state_machine",
         machineName: machine.name,
         className: classSummary.name,
-        stateTypeName: stateName,
+        stateTypeName: stateName2,
         transitionTypeName: transitionName,
         operation: "list_reachable_states"
       }
@@ -15782,7 +15798,7 @@ function buildMachineMethods(classSummary, machine) {
         kind: "state_machine",
         machineName: machine.name,
         className: classSummary.name,
-        stateTypeName: stateName,
+        stateTypeName: stateName2,
         transitionTypeName: transitionName,
         operation: "is_final"
       }
@@ -15793,13 +15809,13 @@ function buildMachineMethods(classSummary, machine) {
         `List shortest transition paths from the current ${docsPrefix} state to a target state.`
       ],
       static: false,
-      params: [{ name: "target", type: stateName }],
-      returnType: `Promise<Array<{ states: ${stateName}[]; transitions: ${transitionName}[] }>>`,
+      params: [{ name: "target", type: stateName2 }],
+      returnType: `Promise<Array<{ states: ${stateName2}[]; transitions: ${transitionName}[] }>>`,
       runtime: {
         kind: "state_machine",
         machineName: machine.name,
         className: classSummary.name,
-        stateTypeName: stateName,
+        stateTypeName: stateName2,
         transitionTypeName: transitionName,
         operation: "paths_to"
       }
@@ -15823,7 +15839,7 @@ function buildMachineMethods(classSummary, machine) {
           kind: "state_machine",
           machineName: machine.name,
           className: classSummary.name,
-          stateTypeName: stateName,
+          stateTypeName: stateName2,
           transitionTypeName: transitionName,
           operation: "reach",
           targetState: stateNameValue,
@@ -15842,7 +15858,7 @@ function buildMachineMethods(classSummary, machine) {
           kind: "state_machine",
           machineName: machine.name,
           className: classSummary.name,
-          stateTypeName: stateName,
+          stateTypeName: stateName2,
           transitionTypeName: transitionName,
           operation: "prepare_reach",
           targetState: stateNameValue,
@@ -15855,7 +15871,7 @@ function buildMachineMethods(classSummary, machine) {
         kind: "state_machine",
         machineName: machine.name,
         className: classSummary.name,
-        stateTypeName: stateName,
+        stateTypeName: stateName2,
         transitionTypeName: transitionName,
         operation: "prepare_create_reach",
         targetState: stateNameValue,
@@ -23928,6 +23944,31 @@ function buildSessionTranscript(input) {
     liveDoc
   });
 }
+function assertRecordSnapshotTransitionMapping(transition) {
+  if (!transition)
+    throw new Error("A transition commit has no authored transition context.");
+  if (!transition.outcomes || !Object.keys(transition.outcomes).length) {
+    throw new Error(
+      "Automatic product-state mapping requires at least one declared outcome."
+    );
+  }
+  const destinations = /* @__PURE__ */ new Map();
+  for (const [key, outcome] of Object.entries(transition.outcomes)) {
+    if (!outcome || typeof outcome.to !== "string" || !outcome.to) {
+      throw new Error(
+        `Automatic product-state mapping requires a destination for outcome ${key}.`
+      );
+    }
+    const destination = outcome.to === "$current" ? transition.from : outcome.to;
+    const previous = destinations.get(destination);
+    if (previous !== void 0) {
+      throw new Error(
+        `Ambiguous product-state mapping for ${transition.machine}.${transition.transition}: outcomes ${previous} and ${key} both resolve to ${destination}; automatic mapping requires distinct outcome destinations.`
+      );
+    }
+    destinations.set(destination, key);
+  }
+}
 
 // src/commit.ts
 var MAX_PROJECTION_CHANGES = 1e3;
@@ -24486,6 +24527,11 @@ async function invokeRegisteredEffect(effectMap, request, options = {}) {
       `Transition effect ${request.effectKey} has no resolved transition context; customer code was not invoked`
     );
   }
+  if (commitRequired && declaration?.kind === "transition" && declaration.outcomeSelection === "product_state") {
+    assertRecordSnapshotTransitionMapping(
+      request.context?.invocation?.transition
+    );
+  }
   const idempotencyKey = commitRequired ? await resolveInvocationIdempotencyKey(request) : request.context?.idempotencyKey;
   let commitStarted = false;
   let commitPromise = null;
@@ -25435,13 +25481,15 @@ var Environment = class _Environment {
   _apiEndpoint;
   _tokenProvider;
   _beforeMutationSend;
-  constructor(granular, envData, apiKey, apiEndpoint, tokenProvider, beforeMutationSend) {
+  _graphqlIdempotencyKey;
+  constructor(granular, envData, apiKey, apiEndpoint, tokenProvider, beforeMutationSend, graphqlIdempotencyKey) {
     this.granular = granular;
     this.envData = envData;
     this._apiKey = apiKey;
     this._apiEndpoint = apiEndpoint;
     this._tokenProvider = tokenProvider;
     this._beforeMutationSend = beforeMutationSend;
+    this._graphqlIdempotencyKey = graphqlIdempotencyKey;
   }
   /** The environment ID */
   get environmentId() {
@@ -25723,8 +25771,8 @@ var Environment = class _Environment {
    * `await env.recordState({ className: "spend_request", id, machine: "lifecycle", state: "policy_review", source: "customer_backend" })`
    */
   state(target) {
-    const observe = async (machineName, stateName, input = {}) => {
-      const observedState = input.observedState || input.state || stateName;
+    const observe = async (machineName, stateName2, input = {}) => {
+      const observedState = input.observedState || input.state || stateName2;
       if (!observedState) {
         throw new Error("State observation requires a target state");
       }
@@ -25750,7 +25798,7 @@ var Environment = class _Environment {
             {
               get: (_machineTarget, stateProperty) => {
                 if (stateProperty === "to") {
-                  return (stateName, input) => observe(machineProperty, stateName, input || {});
+                  return (stateName2, input) => observe(machineProperty, stateName2, input || {});
                 }
                 if (typeof stateProperty !== "string") return void 0;
                 return (input) => observe(
@@ -25984,11 +26032,13 @@ var Environment = class _Environment {
     if (this._beforeMutationSend && isGraphQLMutationDocument(query)) {
       this._beforeMutationSend?.();
     }
+    const idempotencyKey = this._graphqlIdempotencyKey?.(query, variables);
     const response = await fetch(this._apiEndpoint, {
       method: "POST",
       headers: {
         "Content-Type": "application/json",
-        Authorization: `Bearer ${authToken}`
+        Authorization: `Bearer ${authToken}`,
+        ...idempotencyKey ? { "Idempotency-Key": idempotencyKey } : {}
       },
       body: JSON.stringify({
         environmentId: this.environmentId,
@@ -26043,6 +26093,11 @@ var Environment = class _Environment {
         classNames: options.classNames?.length ? options.classNames : []
       }
     );
+    if (response.errors?.length) {
+      throw new Error(
+        `Record search failed: ${response.errors.map((error2) => error2.message).join("; ")}`
+      );
+    }
     const seen = /* @__PURE__ */ new Set();
     const results = (response.data?.record_search || []).flatMap((entry) => {
       const className = entry.className?.trim();
@@ -27557,6 +27612,7 @@ var Granular = class _Granular {
   onUnexpectedClose;
   onReconnectError;
   effectHostUrl;
+  graphqlIdempotencyKey;
   debugHttp = process.env.GRANULAR_DEBUG_HTTP === "1";
   /** Sandbox-level effect registry: sandboxId → (effectKey@selector → ToolWithHandler) */
   sandboxEffects = /* @__PURE__ */ new Map();
@@ -27586,6 +27642,7 @@ var Granular = class _Granular {
     this.onUnexpectedClose = options.onUnexpectedClose;
     this.onReconnectError = options.onReconnectError;
     this.effectHostUrl = options.effectHostUrl;
+    this.graphqlIdempotencyKey = options.graphqlIdempotencyKey;
     this.httpUrl = this.apiUrl.replace(/^wss:\/\//, "https://").replace(/^ws:\/\//, "http://").replace(/\/ws$/, "");
   }
   /**
@@ -28601,7 +28658,9 @@ var Granular = class _Granular {
       envData,
       this.apiKey,
       graphqlEndpoint,
-      this.tokenProvider
+      this.tokenProvider,
+      void 0,
+      this.graphqlIdempotencyKey
     );
   }
   async bindWebSocketEnvironmentSession(environment, clientId, session2, transportOptions = {}) {

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

@@ -1,4 +1,4 @@
-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 { dv 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, e1 as EnvironmentImporter, a_ as RecordUserOptions, aZ as User, b0 as OpenEnvironmentOptions, E as EnvironmentData, aW as AccessTokenProvider, bp as BuildPolicy, d_ as EnvironmentSetupSummary, b6 as ConversationSessionListOptions, b4 as ConversationSessionInfo, b7 as ConversationSessionListResponse, b3 as CreateSessionOptions, h as RecordObjectOptions, dN as RecordObjectResult, dP as RecordObjectsOptions, dW as RecordImport, dS as RecordImportStatus, dV 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, ev as GraphQLResult, df as RecordSearchOptions, de as RecordSearchResult, dg as RecordMentionInput, dG as DefineRelationshipOptions, dF as RelationshipInfo, dE as ModelRef, i as ManifestContent, dK as EnvironmentStateUpdateInput, dI as EnvironmentStateTarget, dM as EnvironmentStateProxy, dR as RecordImportOptions, dr as UserEnvironmentStateOptions, dq as UserEnvironmentState, ds 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, dY as RunEnvironmentImporterOptions, aJ as OpenAIUsageSpendEvent, aI as GranularSpendContext, aL as RecordOpenAIUsageSpendResult, bi as SandboxListResponse, bg as Sandbox, bh as CreateSandboxData, ex as DeleteResponse, bk as PermissionProfile, bl as CreatePermissionProfileData, bs as CreateEnvironmentData, ey as StreamEvent, ez as StreamSubscription, eA as StreamStats, a$ as Subject, bo as AssignmentListResponse } from './spend-DBRQOSaj.mjs';
 import * as Automerge from '@automerge/automerge';
 import { Doc } from '@automerge/automerge/slim';
 
@@ -343,7 +343,8 @@ declare class Environment {
     private _apiEndpoint;
     private _tokenProvider?;
     private _beforeMutationSend?;
-    constructor(granular: Granular, envData: EnvironmentData, apiKey: string, apiEndpoint: string, tokenProvider?: AccessTokenProvider, beforeMutationSend?: () => void);
+    private _graphqlIdempotencyKey?;
+    constructor(granular: Granular, envData: EnvironmentData, apiKey: string, apiEndpoint: string, tokenProvider?: AccessTokenProvider, beforeMutationSend?: () => void, graphqlIdempotencyKey?: GranularOptions["graphqlIdempotencyKey"]);
     /** The environment ID */
     get environmentId(): string;
     /** The sandbox ID */
@@ -1052,6 +1053,7 @@ declare class Granular {
     private onUnexpectedClose?;
     private onReconnectError?;
     private effectHostUrl?;
+    private graphqlIdempotencyKey?;
     private debugHttp;
     /** Sandbox-level effect registry: sandboxId → (effectKey@selector → ToolWithHandler) */
     private sandboxEffects;

package/dist/{client-JCISbded.d.ts → client-DdEXINlv.d.ts}

@@ -1,4 +1,4 @@
-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.js';
+import { dv 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, e1 as EnvironmentImporter, a_ as RecordUserOptions, aZ as User, b0 as OpenEnvironmentOptions, E as EnvironmentData, aW as AccessTokenProvider, bp as BuildPolicy, d_ as EnvironmentSetupSummary, b6 as ConversationSessionListOptions, b4 as ConversationSessionInfo, b7 as ConversationSessionListResponse, b3 as CreateSessionOptions, h as RecordObjectOptions, dN as RecordObjectResult, dP as RecordObjectsOptions, dW as RecordImport, dS as RecordImportStatus, dV 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, ev as GraphQLResult, df as RecordSearchOptions, de as RecordSearchResult, dg as RecordMentionInput, dG as DefineRelationshipOptions, dF as RelationshipInfo, dE as ModelRef, i as ManifestContent, dK as EnvironmentStateUpdateInput, dI as EnvironmentStateTarget, dM as EnvironmentStateProxy, dR as RecordImportOptions, dr as UserEnvironmentStateOptions, dq as UserEnvironmentState, ds 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, dY as RunEnvironmentImporterOptions, aJ as OpenAIUsageSpendEvent, aI as GranularSpendContext, aL as RecordOpenAIUsageSpendResult, bi as SandboxListResponse, bg as Sandbox, bh as CreateSandboxData, ex as DeleteResponse, bk as PermissionProfile, bl as CreatePermissionProfileData, bs as CreateEnvironmentData, ey as StreamEvent, ez as StreamSubscription, eA as StreamStats, a$ as Subject, bo as AssignmentListResponse } from './spend-DBRQOSaj.js';
 import * as Automerge from '@automerge/automerge';
 import { Doc } from '@automerge/automerge/slim';
 
@@ -343,7 +343,8 @@ declare class Environment {
     private _apiEndpoint;
     private _tokenProvider?;
     private _beforeMutationSend?;
-    constructor(granular: Granular, envData: EnvironmentData, apiKey: string, apiEndpoint: string, tokenProvider?: AccessTokenProvider, beforeMutationSend?: () => void);
+    private _graphqlIdempotencyKey?;
+    constructor(granular: Granular, envData: EnvironmentData, apiKey: string, apiEndpoint: string, tokenProvider?: AccessTokenProvider, beforeMutationSend?: () => void, graphqlIdempotencyKey?: GranularOptions["graphqlIdempotencyKey"]);
     /** The environment ID */
     get environmentId(): string;
     /** The sandbox ID */
@@ -1052,6 +1053,7 @@ declare class Granular {
     private onUnexpectedClose?;
     private onReconnectError?;
     private effectHostUrl?;
+    private graphqlIdempotencyKey?;
     private debugHttp;
     /** Sandbox-level effect registry: sandboxId → (effectKey@selector → ToolWithHandler) */
     private sandboxEffects;

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-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 { E as Environment, a as EnvironmentSession, G as Granular, O as OntologyHandle, S as Session, W as WSClient, i as isGraphQLMutationDocument } from './client-6d1OsWJf.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-DBRQOSaj.mjs';
+export { ew 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, dG as DefineRelationshipOptions, ex 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, e1 as EnvironmentImporter, e0 as EnvironmentImporterImportOptions, bt as EnvironmentListResponse, d$ as EnvironmentSetupImporterClaim, dZ as EnvironmentSetupLifecycleStatus, d_ as EnvironmentSetupSummary, dX as EnvironmentSetupTriggerReason, dL as EnvironmentStateMachineProxy, dJ as EnvironmentStateObservationInput, dM as EnvironmentStateProxy, dI as EnvironmentStateTarget, dK 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, dA 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, ev as GraphQLResult, cc as InstanceEffectHandler, I as InstanceToolHandler, cl as Job, dz 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, el as ManifestApprovalRequiredSpec, em as ManifestCreatesSpec, ej as ManifestDryRunSpec, ep as ManifestEffectDeclaration, eo as ManifestEffectSchema, e4 as ManifestEnumRuleSpec, er as ManifestEventStreamDef, eq as ManifestEventTypeDef, e5 as ManifestFilterBySpec, et as ManifestImport, bv as ManifestListResponse, es as ManifestOperation, ei as ManifestPostConditionSpec, e2 as ManifestPropertySpec, en as ManifestRelationshipDef, ek as ManifestReverseSpec, eh as ManifestStateMachineSpec, e7 as ManifestStateMachineStateSpec, eg as ManifestStateMachineTransitionSpec, e9 as ManifestStateTransitionActionSpec, ea as ManifestStateTransitionAssigneeSpec, ee as ManifestStateTransitionExpectedOutcomeSpec, e8 as ManifestStateTransitionInputBinding, ef as ManifestStateTransitionOutcomeSpec, ed as ManifestStateTransitionPermissionSpec, eb as ManifestStateTransitionRelatedStateRequirementSpec, ec as ManifestStateTransitionRequirementsSpec, e3 as ManifestValidationOperator, e6 as ManifestValidationRuleSpec, eu 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, ds as MarkUserEnvironmentReadOptions, aV as MatchedPolicy, J as MessageFeedItem, dE 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, dw as RPCRequest, dB as RPCRequestFromServer, dx as RPCResponse, dW as RecordImport, dV as RecordImportItem, dT as RecordImportItemStatus, dR as RecordImportOptions, dU as RecordImportStats, dS as RecordImportStatus, dQ as RecordImportWriteMode, d3 as RecordManualActionInput, dg as RecordMentionInput, dN as RecordObjectResult, dH as RecordObjectStateValue, dO as RecordObjectsChunkInfo, dP as RecordObjectsOptions, aK as RecordOpenAIUsageSpendOptions, aL as RecordOpenAIUsageSpendResult, df as RecordSearchOptions, de as RecordSearchResult, a_ as RecordUserOptions, dF as RelationshipInfo, bI as RelationshipProjectionChange, bY as ResolvedEffectApprovalRequired, bW as ResolvedEffectDryRun, bV as ResolvedEffectPostCondition, bX as ResolvedEffectReverse, dY 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, dy as SnapshotResetMessage, bD as SourceAcknowledgement, b8 as SpendLineItemType, bc as SpendSummary, bJ as StateObservationProjectionChange, ey as StreamEvent, eA as StreamStats, ez as StreamSubscription, a$ as Subject, X as TableFeedItem, u as ToolHandler, c7 as ToolInfo, dC as ToolInvokeParams, dD 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, dn as UserEnvironmentArtifactAttention, dm as UserEnvironmentMessagePreview, dl as UserEnvironmentPrompt, dp as UserEnvironmentSessionState, dq as UserEnvironmentState, dr as UserEnvironmentStateOptions, cp as UserMessageAppendResult, co as UserMessageInput, cm as UserMessageShowRefs, cn as UserMessageTarget, by as Version, br as VersionTag, bq as VersionTracking, dv as WSClientOptions, dt as WSDisconnectInfo, du 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-DBRQOSaj.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';
@@ -139,6 +139,8 @@ interface RecordSnapshotCommitSource {
  * persisting bounded, replayable mapper input beside a product mutation.
  */
 declare function changedRecordSnapshots(beforeRecords: RecordObjectOptions[], afterRecords: RecordObjectOptions[]): Pick<RecordSnapshotCommitSource, "beforeRecords" | "afterRecords">;
+/** Validate automatic state-based mapping before invoking product code. */
+declare function assertRecordSnapshotTransitionMapping(transition: CommitTransitionInvocation | undefined): asserts transition is CommitTransitionInvocation;
 /**
  * Deterministically maps a persisted before/after product snapshot to commit
  * changes. It performs no I/O and never guesses ontology labels or paths.
@@ -152,6 +154,9 @@ declare function projectRecordSnapshotMutation(input: {
     commitKind: "effect" | "transition";
     transition?: CommitTransitionInvocation;
 }): ProjectionResult;
+declare namespace projectRecordSnapshotMutation {
+    var validateTransition: typeof assertRecordSnapshotTransitionMapping;
+}
 
 interface ValidationRuleEvaluationInput {
     operator?: string | null;
@@ -336,6 +341,24 @@ declare function requireArtifactWorkflowResult<T extends {
     artifact: ArtifactLike;
 }>(result: T): T;
 
+/** The prepared operation a person reviews, independent of runtime progress. */
+declare function artifactReviewedOperation(artifact: {
+    artifactId: string;
+    sessionId?: string | null;
+    environmentId?: string | null;
+    subjectId?: string | null;
+    buildId?: string | null;
+    buildVersionNumber?: number | null;
+    kind: string;
+    target?: unknown;
+    policy?: unknown;
+    inputSchema?: unknown;
+    inputValues?: Record<string, unknown>;
+    relationships?: Record<string, unknown>;
+    metadata?: Record<string, unknown>;
+    subArtifactIds?: string[];
+}, inputValues?: Record<string, unknown>, relationships?: Record<string, unknown>): Record<string, unknown>;
+
 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 {
@@ -374,4 +397,4 @@ interface ArtifactSurfaceModel {
 }
 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 };
+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, artifactReviewedOperation, 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-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 { E as Environment, a as EnvironmentSession, G as Granular, O as OntologyHandle, S as Session, W as WSClient, i as isGraphQLMutationDocument } from './client-DdEXINlv.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-DBRQOSaj.js';
+export { ew 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, dG as DefineRelationshipOptions, ex 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, e1 as EnvironmentImporter, e0 as EnvironmentImporterImportOptions, bt as EnvironmentListResponse, d$ as EnvironmentSetupImporterClaim, dZ as EnvironmentSetupLifecycleStatus, d_ as EnvironmentSetupSummary, dX as EnvironmentSetupTriggerReason, dL as EnvironmentStateMachineProxy, dJ as EnvironmentStateObservationInput, dM as EnvironmentStateProxy, dI as EnvironmentStateTarget, dK 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, dA 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, ev as GraphQLResult, cc as InstanceEffectHandler, I as InstanceToolHandler, cl as Job, dz 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, el as ManifestApprovalRequiredSpec, em as ManifestCreatesSpec, ej as ManifestDryRunSpec, ep as ManifestEffectDeclaration, eo as ManifestEffectSchema, e4 as ManifestEnumRuleSpec, er as ManifestEventStreamDef, eq as ManifestEventTypeDef, e5 as ManifestFilterBySpec, et as ManifestImport, bv as ManifestListResponse, es as ManifestOperation, ei as ManifestPostConditionSpec, e2 as ManifestPropertySpec, en as ManifestRelationshipDef, ek as ManifestReverseSpec, eh as ManifestStateMachineSpec, e7 as ManifestStateMachineStateSpec, eg as ManifestStateMachineTransitionSpec, e9 as ManifestStateTransitionActionSpec, ea as ManifestStateTransitionAssigneeSpec, ee as ManifestStateTransitionExpectedOutcomeSpec, e8 as ManifestStateTransitionInputBinding, ef as ManifestStateTransitionOutcomeSpec, ed as ManifestStateTransitionPermissionSpec, eb as ManifestStateTransitionRelatedStateRequirementSpec, ec as ManifestStateTransitionRequirementsSpec, e3 as ManifestValidationOperator, e6 as ManifestValidationRuleSpec, eu 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, ds as MarkUserEnvironmentReadOptions, aV as MatchedPolicy, J as MessageFeedItem, dE 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, dw as RPCRequest, dB as RPCRequestFromServer, dx as RPCResponse, dW as RecordImport, dV as RecordImportItem, dT as RecordImportItemStatus, dR as RecordImportOptions, dU as RecordImportStats, dS as RecordImportStatus, dQ as RecordImportWriteMode, d3 as RecordManualActionInput, dg as RecordMentionInput, dN as RecordObjectResult, dH as RecordObjectStateValue, dO as RecordObjectsChunkInfo, dP as RecordObjectsOptions, aK as RecordOpenAIUsageSpendOptions, aL as RecordOpenAIUsageSpendResult, df as RecordSearchOptions, de as RecordSearchResult, a_ as RecordUserOptions, dF as RelationshipInfo, bI as RelationshipProjectionChange, bY as ResolvedEffectApprovalRequired, bW as ResolvedEffectDryRun, bV as ResolvedEffectPostCondition, bX as ResolvedEffectReverse, dY 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, dy as SnapshotResetMessage, bD as SourceAcknowledgement, b8 as SpendLineItemType, bc as SpendSummary, bJ as StateObservationProjectionChange, ey as StreamEvent, eA as StreamStats, ez as StreamSubscription, a$ as Subject, X as TableFeedItem, u as ToolHandler, c7 as ToolInfo, dC as ToolInvokeParams, dD 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, dn as UserEnvironmentArtifactAttention, dm as UserEnvironmentMessagePreview, dl as UserEnvironmentPrompt, dp as UserEnvironmentSessionState, dq as UserEnvironmentState, dr as UserEnvironmentStateOptions, cp as UserMessageAppendResult, co as UserMessageInput, cm as UserMessageShowRefs, cn as UserMessageTarget, by as Version, br as VersionTag, bq as VersionTracking, dv as WSClientOptions, dt as WSDisconnectInfo, du 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-DBRQOSaj.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';
@@ -139,6 +139,8 @@ interface RecordSnapshotCommitSource {
  * persisting bounded, replayable mapper input beside a product mutation.
  */
 declare function changedRecordSnapshots(beforeRecords: RecordObjectOptions[], afterRecords: RecordObjectOptions[]): Pick<RecordSnapshotCommitSource, "beforeRecords" | "afterRecords">;
+/** Validate automatic state-based mapping before invoking product code. */
+declare function assertRecordSnapshotTransitionMapping(transition: CommitTransitionInvocation | undefined): asserts transition is CommitTransitionInvocation;
 /**
  * Deterministically maps a persisted before/after product snapshot to commit
  * changes. It performs no I/O and never guesses ontology labels or paths.
@@ -152,6 +154,9 @@ declare function projectRecordSnapshotMutation(input: {
     commitKind: "effect" | "transition";
     transition?: CommitTransitionInvocation;
 }): ProjectionResult;
+declare namespace projectRecordSnapshotMutation {
+    var validateTransition: typeof assertRecordSnapshotTransitionMapping;
+}
 
 interface ValidationRuleEvaluationInput {
     operator?: string | null;
@@ -336,6 +341,24 @@ declare function requireArtifactWorkflowResult<T extends {
     artifact: ArtifactLike;
 }>(result: T): T;
 
+/** The prepared operation a person reviews, independent of runtime progress. */
+declare function artifactReviewedOperation(artifact: {
+    artifactId: string;
+    sessionId?: string | null;
+    environmentId?: string | null;
+    subjectId?: string | null;
+    buildId?: string | null;
+    buildVersionNumber?: number | null;
+    kind: string;
+    target?: unknown;
+    policy?: unknown;
+    inputSchema?: unknown;
+    inputValues?: Record<string, unknown>;
+    relationships?: Record<string, unknown>;
+    metadata?: Record<string, unknown>;
+    subArtifactIds?: string[];
+}, inputValues?: Record<string, unknown>, relationships?: Record<string, unknown>): Record<string, unknown>;
+
 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 {
@@ -374,4 +397,4 @@ interface ArtifactSurfaceModel {
 }
 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 };
+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, artifactReviewedOperation, 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 };