@granular-software/sdk 0.4.71 → 0.4.73

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-U0rb2nG5.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-k8V2Y1Tt.mjs';
 import { GranularAgentToolInfo, GeneratedJobCodeIssue, BuildGranularAgentSystemPromptInput, HarnessRenderedPrompt, HarnessRenderedContinuation, HarnessControllerBudgets } from './agent-harness.mjs';
 import '@automerge/automerge';
 import '@automerge/automerge/slim';
@@ -415,6 +415,7 @@ declare function createOpenAIChatTurnGenerator(options: {
     model?: string;
     baseUrl?: string;
     temperature?: number;
+    reasoningEffort?: "low" | "medium" | "high";
     headers?: Record<string, string>;
     usageContext?: GranularSpendContext;
     onUsage?: (usage: AgentEvalOpenAIUsageEvent) => void | Promise<void>;
@@ -470,6 +471,7 @@ interface AgentTesterOptions {
         model?: string;
         baseUrl?: string;
         temperature?: number;
+        reasoningEffort?: "low" | "medium" | "high";
         headers?: Record<string, string>;
     };
     model?: string;

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-WJrPOw6N.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-k8V2Y1Tt.js';
 import { GranularAgentToolInfo, GeneratedJobCodeIssue, BuildGranularAgentSystemPromptInput, HarnessRenderedPrompt, HarnessRenderedContinuation, HarnessControllerBudgets } from './agent-harness.js';
 import '@automerge/automerge';
 import '@automerge/automerge/slim';
@@ -415,6 +415,7 @@ declare function createOpenAIChatTurnGenerator(options: {
     model?: string;
     baseUrl?: string;
     temperature?: number;
+    reasoningEffort?: "low" | "medium" | "high";
     headers?: Record<string, string>;
     usageContext?: GranularSpendContext;
     onUsage?: (usage: AgentEvalOpenAIUsageEvent) => void | Promise<void>;
@@ -470,6 +471,7 @@ interface AgentTesterOptions {
         model?: string;
         baseUrl?: string;
         temperature?: number;
+        reasoningEffort?: "low" | "medium" | "high";
         headers?: Record<string, string>;
     };
     model?: string;

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,
@@ -16714,8 +16744,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 +16771,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(
@@ -17034,6 +17064,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();
@@ -24097,6 +24132,9 @@ ${modelOutputInstruction()}`
     if (typeof options.temperature === "number") {
       payload.temperature = options.temperature;
     }
+    if (options.reasoningEffort) {
+      payload.reasoning_effort = options.reasoningEffort;
+    }
     let lastError = null;
     for (let attempt = 1; attempt <= 3; attempt += 1) {
       try {
@@ -26422,6 +26460,7 @@ function createAgentTester(options) {
     model: options.openai?.model || options.model,
     baseUrl: options.openai?.baseUrl,
     temperature: options.openai?.temperature,
+    reasoningEffort: options.openai?.reasoningEffort,
     headers: options.openai?.headers,
     onUsage: async (usage) => {
       await granular.recordOpenAIUsageSpend(usage, usage.usageContext);