@granular-software/sdk 0.4.72 → 0.4.74

package/dist/agent-evals.d.mts

@@ -1,5 +1,5 @@
-import { a as EnvironmentSession, G as Granular } from './client-p5EhOwpP.mjs';
-import { aI as GranularSpendContext, aD as OpenAITokenSpend, n as Prompt, h as RecordObjectOptions, i as ManifestContent, m as SessionHeapSnapshot, T as ToolWithHandler, b2 as ConnectOptions, bs as CreateEnvironmentData, aX as GranularOptions } from './spend-lJDtuAr6.mjs';
+import { a as EnvironmentSession, G as Granular } from './client-6d1OsWJf.mjs';
+import { aI as GranularSpendContext, aD as OpenAITokenSpend, n as Prompt, h as RecordObjectOptions, i as ManifestContent, m as SessionHeapSnapshot, T as ToolWithHandler, b2 as ConnectOptions, bs as CreateEnvironmentData, aX as GranularOptions } from './spend-DBRQOSaj.mjs';
 import { GranularAgentToolInfo, GeneratedJobCodeIssue, BuildGranularAgentSystemPromptInput, HarnessRenderedPrompt, HarnessRenderedContinuation, HarnessControllerBudgets } from './agent-harness.mjs';
 import '@automerge/automerge';
 import '@automerge/automerge/slim';

package/dist/agent-evals.d.ts

@@ -1,5 +1,5 @@
-import { a as EnvironmentSession, G as Granular } from './client-JCISbded.js';
-import { aI as GranularSpendContext, aD as OpenAITokenSpend, n as Prompt, h as RecordObjectOptions, i as ManifestContent, m as SessionHeapSnapshot, T as ToolWithHandler, b2 as ConnectOptions, bs as CreateEnvironmentData, aX as GranularOptions } from './spend-lJDtuAr6.js';
+import { a as EnvironmentSession, G as Granular } from './client-DdEXINlv.js';
+import { aI as GranularSpendContext, aD as OpenAITokenSpend, n as Prompt, h as RecordObjectOptions, i as ManifestContent, m as SessionHeapSnapshot, T as ToolWithHandler, b2 as ConnectOptions, bs as CreateEnvironmentData, aX as GranularOptions } from './spend-DBRQOSaj.js';
 import { GranularAgentToolInfo, GeneratedJobCodeIssue, BuildGranularAgentSystemPromptInput, HarnessRenderedPrompt, HarnessRenderedContinuation, HarnessControllerBudgets } from './agent-harness.js';
 import '@automerge/automerge';
 import '@automerge/automerge/slim';

package/dist/agent-evals.js

@@ -13172,6 +13172,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;
@@ -13730,6 +13755,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;
@@ -15108,7 +15138,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}`;
@@ -15118,12 +15148,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"
       }
@@ -15134,13 +15164,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"
       }
@@ -15155,7 +15185,7 @@ function buildMachineMethods(classSummary, machine) {
         kind: "state_machine",
         machineName: machine.name,
         className: classSummary.name,
-        stateTypeName: stateName,
+        stateTypeName: stateName2,
         transitionTypeName: transitionName,
         operation: "list_transitions"
       }
@@ -15165,12 +15195,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"
       }
@@ -15185,7 +15215,7 @@ function buildMachineMethods(classSummary, machine) {
         kind: "state_machine",
         machineName: machine.name,
         className: classSummary.name,
-        stateTypeName: stateName,
+        stateTypeName: stateName2,
         transitionTypeName: transitionName,
         operation: "is_final"
       }
@@ -15196,13 +15226,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"
       }
@@ -15226,7 +15256,7 @@ function buildMachineMethods(classSummary, machine) {
           kind: "state_machine",
           machineName: machine.name,
           className: classSummary.name,
-          stateTypeName: stateName,
+          stateTypeName: stateName2,
           transitionTypeName: transitionName,
           operation: "reach",
           targetState: stateNameValue,
@@ -15245,7 +15275,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,
@@ -15258,7 +15288,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,
@@ -16426,13 +16456,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() {
@@ -16714,8 +16746,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");
       }
@@ -16741,7 +16773,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(
@@ -16975,11 +17007,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,
@@ -17034,6 +17068,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();
@@ -18548,6 +18587,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();
@@ -18577,6 +18617,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$/, "");
   }
   /**
@@ -19592,7 +19633,9 @@ var Granular = class _Granular {
       envData,
       this.apiKey,
       graphqlEndpoint,
-      this.tokenProvider
+      this.tokenProvider,
+      void 0,
+      this.graphqlIdempotencyKey
     );
   }
   async bindWebSocketEnvironmentSession(environment, clientId, session, transportOptions = {}) {