@granular-software/sdk 0.4.72 → 0.4.74

package/dist/agent-evals.mjs

@@ -13146,6 +13146,31 @@ var effectBehaviorsMetamodelPackage = defineMetamodelPackage({
     }
   }
 });
+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;
@@ -13704,6 +13729,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;
@@ -15082,7 +15112,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}`;
@@ -15092,12 +15122,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"
       }
@@ -15108,13 +15138,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"
       }
@@ -15129,7 +15159,7 @@ function buildMachineMethods(classSummary, machine) {
         kind: "state_machine",
         machineName: machine.name,
         className: classSummary.name,
-        stateTypeName: stateName,
+        stateTypeName: stateName2,
         transitionTypeName: transitionName,
         operation: "list_transitions"
       }
@@ -15139,12 +15169,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"
       }
@@ -15159,7 +15189,7 @@ function buildMachineMethods(classSummary, machine) {
         kind: "state_machine",
         machineName: machine.name,
         className: classSummary.name,
-        stateTypeName: stateName,
+        stateTypeName: stateName2,
         transitionTypeName: transitionName,
         operation: "is_final"
       }
@@ -15170,13 +15200,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"
       }
@@ -15200,7 +15230,7 @@ function buildMachineMethods(classSummary, machine) {
           kind: "state_machine",
           machineName: machine.name,
           className: classSummary.name,
-          stateTypeName: stateName,
+          stateTypeName: stateName2,
           transitionTypeName: transitionName,
           operation: "reach",
           targetState: stateNameValue,
@@ -15219,7 +15249,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,
@@ -15232,7 +15262,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,
@@ -16400,13 +16430,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() {
@@ -16688,8 +16720,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");
       }
@@ -16715,7 +16747,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(
@@ -16949,11 +16981,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,
@@ -17008,6 +17042,11 @@ var Environment = class _Environment {
         classNames: options.classNames?.length ? options.classNames : []
       }
     );
+    if (response.errors?.length) {
+      throw new Error(
+        `Record search failed: ${response.errors.map((error) => error.message).join("; ")}`
+      );
+    }
     const seen = /* @__PURE__ */ new Set();
     const results = (response.data?.record_search || []).flatMap((entry) => {
       const className = entry.className?.trim();
@@ -18522,6 +18561,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();
@@ -18551,6 +18591,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$/, "");
   }
   /**
@@ -19566,7 +19607,9 @@ var Granular = class _Granular {
       envData,
       this.apiKey,
       graphqlEndpoint,
-      this.tokenProvider
+      this.tokenProvider,
+      void 0,
+      this.graphqlIdempotencyKey
     );
   }
   async bindWebSocketEnvironmentSession(environment, clientId, session, transportOptions = {}) {