@granular-software/sdk 0.4.33 → 0.4.34

package/dist/agent-evals.d.mts

@@ -1,4 +1,4 @@
-import { P as Prompt, f as EnvironmentSession, c as SessionHeapSnapshot, bf as ManifestContent, aN as RecordObjectOptions, T as ToolWithHandler, G as Granular, C as ConnectOptions, J as CreateEnvironmentData, k as GranularOptions } from './client-DTvI5MUG.mjs';
+import { P as Prompt, f as EnvironmentSession, c as SessionHeapSnapshot, bg as ManifestContent, aO as RecordObjectOptions, T as ToolWithHandler, G as Granular, C as ConnectOptions, J as CreateEnvironmentData, k as GranularOptions } from './client-iw76FL_8.mjs';
 import { GeneratedJobCodeIssue, HarnessControllerBudgets } from './agent-harness.mjs';
 import '@automerge/automerge';
 import '@automerge/automerge/slim';

package/dist/agent-evals.d.ts

@@ -1,4 +1,4 @@
-import { P as Prompt, f as EnvironmentSession, c as SessionHeapSnapshot, bf as ManifestContent, aN as RecordObjectOptions, T as ToolWithHandler, G as Granular, C as ConnectOptions, J as CreateEnvironmentData, k as GranularOptions } from './client-DTvI5MUG.js';
+import { P as Prompt, f as EnvironmentSession, c as SessionHeapSnapshot, bg as ManifestContent, aO as RecordObjectOptions, T as ToolWithHandler, G as Granular, C as ConnectOptions, J as CreateEnvironmentData, k as GranularOptions } from './client-iw76FL_8.js';
 import { GeneratedJobCodeIssue, HarnessControllerBudgets } from './agent-harness.js';
 import '@automerge/automerge';
 import '@automerge/automerge/slim';

package/dist/agent-evals.js

@@ -10891,6 +10891,50 @@ function computeEffectKey(effect) {
   }
   return effect.static ? `class:${attachedClass}:static:${effect.name}` : `class:${attachedClass}:instance:${effect.name}`;
 }
+function computeEffectVersionSelectorSpecificity(selector) {
+  if (!selector || selector.mode === "all") {
+    return 0;
+  }
+  if (selector.mode === "exact") {
+    return 2;
+  }
+  return 1;
+}
+function matchesEffectVersionSelector(selector, buildVersionNumber) {
+  if (!selector || selector.mode === "all") {
+    return true;
+  }
+  if (typeof buildVersionNumber !== "number" || !Number.isFinite(buildVersionNumber)) {
+    return false;
+  }
+  if (selector.mode === "exact") {
+    return buildVersionNumber === selector.versionNumber;
+  }
+  if (selector.mode === "before") {
+    return buildVersionNumber < selector.versionNumber;
+  }
+  return buildVersionNumber > selector.versionNumber;
+}
+function selectRegisteredEffect(effectMap, effectKey, buildVersionNumber) {
+  let bestEffect;
+  let bestSpecificity = Number.NEGATIVE_INFINITY;
+  for (const effect of effectMap.values()) {
+    if (computeEffectKey(effect) !== effectKey) {
+      continue;
+    }
+    if (!matchesEffectVersionSelector(effect.versionSelector, buildVersionNumber)) {
+      continue;
+    }
+    const specificity = computeEffectVersionSelectorSpecificity(
+      effect.versionSelector
+    );
+    if (!bestEffect || specificity > bestSpecificity) {
+      bestEffect = effect;
+      bestSpecificity = specificity;
+    }
+  }
+  return bestEffect;
+}
 function normalizeEffectBehaviors(value) {
   return normalizeEffectBehaviorSummary(
     value
@@ -10911,9 +10955,17 @@ function resolveReverseEffect(effectMap, currentEffect, request, behaviors) {
     return void 0;
   }
   if (reverseHandler.includes(":")) {
-    return effectMap.get(reverseHandler);
+    return selectRegisteredEffect(
+      effectMap,
+      reverseHandler,
+      request.context?.buildVersionNumber
+    );
   }
-  const directMatch = effectMap.get(reverseHandler);
+  const directMatch = selectRegisteredEffect(
+    effectMap,
+    reverseHandler,
+    request.context?.buildVersionNumber
+  );
   if (directMatch) {
     return directMatch;
   }
@@ -10928,7 +10980,11 @@ function resolveReverseEffect(effectMap, currentEffect, request, behaviors) {
     })
   ];
   for (const candidateKey of candidateKeys) {
-    const candidate = effectMap.get(candidateKey);
+    const candidate = selectRegisteredEffect(
+      effectMap,
+      candidateKey,
+      request.context?.buildVersionNumber
+    );
     if (candidate) {
       return candidate;
     }
@@ -10964,7 +11020,11 @@ function resolveHandlerForMode(effectMap, effect, request) {
   return { effect, mode, handler: effect.handler };
 }
 async function invokeRegisteredEffect(effectMap, request) {
-  const effect = effectMap.get(request.effectKey);
+  const effect = selectRegisteredEffect(
+    effectMap,
+    request.effectKey,
+    request.context?.buildVersionNumber
+  );
   if (!effect) {
     throw new Error(`Effect handler not found: ${request.effectKey}`);
   }
@@ -12223,6 +12283,17 @@ function computeEffectKey2(effect) {
   }
   return effect.static ? `class:${attachedClass}:static:${effect.name}` : `class:${attachedClass}:instance:${effect.name}`;
 }
+function computeEffectVersionSelectorKey(selector) {
+  if (!selector || selector.mode === "all") {
+    return "all";
+  }
+  return `${selector.mode}:${selector.versionNumber}`;
+}
+function computeEffectRegistrationKey(effect) {
+  return `${computeEffectKey2(effect)}@${computeEffectVersionSelectorKey(
+    effect.versionSelector
+  )}`;
+}
 function buildEffectHostUrl(apiUrl, sandboxId, effectClientId, clientId) {
   const url = new URL(apiUrl);
   if (url.pathname.endsWith("/granular/ws/connect")) {
@@ -13744,7 +13815,7 @@ var Granular = class _Granular {
   onUnexpectedClose;
   onReconnectError;
   debugHttp = process.env.GRANULAR_DEBUG_HTTP === "1";
-  /** Sandbox-level effect registry: sandboxId → (effectKey → ToolWithHandler) */
+  /** Sandbox-level effect registry: sandboxId → (effectKey@selector → ToolWithHandler) */
   sandboxEffects = /* @__PURE__ */ new Map();
   /** Live sandbox-scoped effect hosts keyed by sandboxId */
   sandboxEffectHosts = /* @__PURE__ */ new Map();
@@ -14163,7 +14234,8 @@ var Granular = class _Granular {
       provenance: effect.provenance || { source: "custom" },
       tags: effect.tags,
       className: effect.className,
-      static: effect.static
+      static: effect.static,
+      versionSelector: effect.versionSelector
     };
   }
   async publishSandboxEffectCatalog(host) {
@@ -14351,7 +14423,10 @@ var Granular = class _Granular {
   async registerEffect(sandboxNameOrId, effect) {
     const sandbox = await this.findOrCreateSandbox(sandboxNameOrId);
     const sandboxId = sandbox.sandboxId;
-    this.getSandboxEffectMap(sandboxId).set(computeEffectKey2(effect), effect);
+    this.getSandboxEffectMap(sandboxId).set(
+      computeEffectRegistrationKey(effect),
+      effect
+    );
     await this.syncSandboxEffectCatalog(sandboxId);
   }
   /**
@@ -14364,7 +14439,7 @@ var Granular = class _Granular {
     const sandboxId = sandbox.sandboxId;
     const map = this.getSandboxEffectMap(sandboxId);
     for (const effect of effects) {
-      map.set(computeEffectKey2(effect), effect);
+      map.set(computeEffectRegistrationKey(effect), effect);
     }
     await this.syncSandboxEffectCatalog(sandboxId);
   }
@@ -14382,7 +14457,7 @@ var Granular = class _Granular {
       return;
     }
     const nextEntries = Array.from(currentMap.entries()).filter(
-      ([effectKey, effect]) => effectKey !== name && effect.name !== name
+      ([, effect]) => computeEffectKey2(effect) !== name && effect.name !== name
     );
     if (nextEntries.length === currentMap.size) {
       return;