@granular-software/sdk 0.4.33 → 0.4.34

package/dist/cli/index.js

@@ -19956,6 +19956,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
@@ -19976,9 +20020,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;
   }
@@ -19993,7 +20045,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;
     }
@@ -20029,7 +20085,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}`);
   }
@@ -20150,6 +20210,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")) {
@@ -21671,7 +21742,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();
@@ -22090,7 +22161,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) {
@@ -22278,7 +22350,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);
   }
   /**
@@ -22291,7 +22366,7 @@ var Granular = class _Granular {
     const sandboxId = sandbox.sandboxId;
     const map = this.getSandboxEffectMap(sandboxId);
     for (const effect of effects2) {
-      map.set(computeEffectKey2(effect), effect);
+      map.set(computeEffectRegistrationKey(effect), effect);
     }
     await this.syncSandboxEffectCatalog(sandboxId);
   }
@@ -22309,7 +22384,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;

package/dist/{client-DTvI5MUG.d.mts → client-iw76FL_8.d.mts}

@@ -303,6 +303,7 @@ interface EnvironmentData {
     sandboxId: string;
     ontologyId?: string;
     buildId: string;
+    versionNumber?: number | null;
     versionId: string;
     subjectId: string;
     envName: string;
@@ -422,6 +423,8 @@ interface EffectHandlerContext {
     effectClientId: string;
     sandboxId: string;
     environmentId: string;
+    buildId?: string;
+    buildVersionNumber?: number;
     sessionId: string;
     tenantId?: string;
     principalId?: string;
@@ -534,6 +537,12 @@ interface ToolSchema {
      * passed as the first argument to the handler).
      */
     static?: boolean;
+    /**
+     * Optional build-version selector for this live effect binding.
+     *
+     * When omitted, the binding applies to all build versions for the sandbox.
+     */
+    versionSelector?: EffectVersionSelector;
     /** Declarative runtime behaviors attached to the effect. */
     metamodels?: ManifestEffectMetamodelSpec;
 }
@@ -566,6 +575,18 @@ interface PublishToolsResult {
     }>;
 }
 type PublishEffectsResult = PublishToolsResult;
+type EffectVersionSelector = {
+    mode: "all";
+} | {
+    mode: "exact";
+    versionNumber: number;
+} | {
+    mode: "before";
+    versionNumber: number;
+} | {
+    mode: "after";
+    versionNumber: number;
+};
 /**
  * Domain state response
  */
@@ -603,6 +624,8 @@ interface ToolInfo {
     className?: string;
     /** Whether this is a static method */
     static?: boolean;
+    /** Optional build-version selector associated with the live binding. */
+    versionSelector?: EffectVersionSelector;
     /** Declarative runtime behaviors attached to the effect. */
     metamodels?: ManifestEffectMetamodelSpec;
 }
@@ -2068,7 +2091,7 @@ declare class Granular {
     private onUnexpectedClose?;
     private onReconnectError?;
     private debugHttp;
-    /** Sandbox-level effect registry: sandboxId → (effectKey → ToolWithHandler) */
+    /** Sandbox-level effect registry: sandboxId → (effectKey@selector → ToolWithHandler) */
     private sandboxEffects;
     /** Live sandbox-scoped effect hosts keyed by sandboxId */
     private sandboxEffectHosts;
@@ -2326,4 +2349,4 @@ declare class Granular {
     private request;
 }
 
-export { type SemanticVersionDiff as $, type AccessTokenProvider as A, type BuildPolicy as B, type ConnectOptions as C, type DomainState as D, type EndpointMode as E, type VersionTag as F, Granular as G, type EnvironmentData as H, type InstanceToolHandler as I, type CreateEnvironmentData as J, type EnvironmentListResponse as K, type Manifest as L, type ManifestEffectMetamodelSpec as M, type ManifestListResponse as N, OntologyHandle as O, type Prompt as P, type BuildStatus as Q, type ResolvedEffectBehaviors as R, type SessionHeapEntry as S, type ToolWithHandler as T, type User as U, type VersionTracking as V, WSClient as W, type Build as X, type Version as Y, type BuildListResponse as Z, type SemanticVersionDiffEntry as _, type EffectHandlerContext as a, type ManifestValidationRuleSpec as a$, type ResolvedEffectPostCondition as a0, type ResolvedEffectDryRun as a1, type ResolvedEffectReverse as a2, type ResolvedEffectApprovalRequired as a3, type EffectInvocationMode as a4, type EffectInvocationMetadata as a5, type EffectSchema as a6, type EffectWithHandler as a7, type PublishEffectsResult as a8, type ToolInfo as a9, type SessionCollectionListResult as aA, type WSDisconnectInfo as aB, type WSReconnectErrorInfo as aC, type WSClientOptions as aD, type RPCRequest as aE, type RPCResponse as aF, type SyncMessage as aG, type RPCRequestFromServer as aH, type ToolInvokeParams as aI, type ToolResultParams as aJ, type ModelRef as aK, type RelationshipInfo as aL, type DefineRelationshipOptions as aM, type RecordObjectOptions as aN, type RecordObjectResult as aO, type RecordObjectsChunkInfo as aP, type RecordObjectsOptions as aQ, type RecordImportStatus as aR, type RecordImportItemStatus as aS, type RecordImportStats as aT, type RecordImportItem as aU, type RecordImport as aV, type EnvironmentRecordImportSummary as aW, type ManifestPropertySpec as aX, type ManifestValidationOperator as aY, type ManifestEnumRuleSpec as aZ, type ManifestFilterBySpec as a_, type EffectInfo as aa, type ToolsChangedEvent as ab, type EffectsChangedEvent as ac, type EffectHandler as ad, type InstanceEffectHandler as ae, type JobStatus as af, type JobFeedbackSentiment as ag, type JobFeedbackToolCall as ah, type JobFeedbackMetadata as ai, type JobFeedbackInput as aj, type JobFeedbackRecord as ak, type EnvironmentFeedbackRecord as al, type JobSubmitResult as am, type Job as an, type ConversationMessageShowRefs as ao, type ConversationMessageInput as ap, type ConversationAppendResult as aq, type SessionConversationMessage as ar, type SessionTimelineEvent as as, type SessionJobRecord as at, type SessionHeapFieldType as au, type SessionHeapFieldValue as av, type SessionHeapVariable as aw, type SessionDocumentResult as ax, type SessionCollectionListOptions as ay, type SessionJobListOptions as az, type SessionHeapList as b, type ManifestStateMachineStateSpec as b0, type ManifestStateMachineTransitionSpec as b1, type ManifestStateMachineSpec as b2, type ManifestPostConditionSpec as b3, type ManifestDryRunSpec as b4, type ManifestReverseSpec as b5, type ManifestApprovalRequiredSpec as b6, type ManifestRelationshipDef as b7, type ManifestEffectSchema as b8, type ManifestEffectDeclaration as b9, type ManifestEventTypeDef as ba, type ManifestEventStreamDef as bb, type ManifestOperation as bc, type ManifestImport as bd, type ManifestVolume as be, type ManifestContent as bf, type GraphQLResult as bg, type APIError as bh, type DeleteResponse as bi, type StreamEvent as bj, type StreamSubscription as bk, type StreamStats as bl, type SessionHeapSnapshot as c, type SessionTranscriptEntry as d, Environment as e, EnvironmentSession as f, Session as g, type ToolSchema as h, type PublishToolsResult as i, type ToolHandler as j, type GranularOptions as k, type GranularAuth as l, type RecordUserOptions as m, type Subject as n, type OpenEnvironmentOptions as o, type CreateSessionOptions as p, type ConversationSessionInfo as q, type Sandbox as r, type CreateSandboxData as s, type SandboxListResponse as t, type PermissionRules as u, type PermissionProfile as v, type CreatePermissionProfileData as w, type PermissionProfileListResponse as x, type Assignment as y, type AssignmentListResponse as z };
+export { type SemanticVersionDiff as $, type AccessTokenProvider as A, type BuildPolicy as B, type ConnectOptions as C, type DomainState as D, type EndpointMode as E, type VersionTag as F, Granular as G, type EnvironmentData as H, type InstanceToolHandler as I, type CreateEnvironmentData as J, type EnvironmentListResponse as K, type Manifest as L, type ManifestEffectMetamodelSpec as M, type ManifestListResponse as N, OntologyHandle as O, type Prompt as P, type BuildStatus as Q, type ResolvedEffectBehaviors as R, type SessionHeapEntry as S, type ToolWithHandler as T, type User as U, type VersionTracking as V, WSClient as W, type Build as X, type Version as Y, type BuildListResponse as Z, type SemanticVersionDiffEntry as _, type EffectHandlerContext as a, type ManifestFilterBySpec as a$, type ResolvedEffectPostCondition as a0, type ResolvedEffectDryRun as a1, type ResolvedEffectReverse as a2, type ResolvedEffectApprovalRequired as a3, type EffectInvocationMode as a4, type EffectInvocationMetadata as a5, type EffectSchema as a6, type EffectWithHandler as a7, type PublishEffectsResult as a8, type EffectVersionSelector as a9, type SessionJobListOptions as aA, type SessionCollectionListResult as aB, type WSDisconnectInfo as aC, type WSReconnectErrorInfo as aD, type WSClientOptions as aE, type RPCRequest as aF, type RPCResponse as aG, type SyncMessage as aH, type RPCRequestFromServer as aI, type ToolInvokeParams as aJ, type ToolResultParams as aK, type ModelRef as aL, type RelationshipInfo as aM, type DefineRelationshipOptions as aN, type RecordObjectOptions as aO, type RecordObjectResult as aP, type RecordObjectsChunkInfo as aQ, type RecordObjectsOptions as aR, type RecordImportStatus as aS, type RecordImportItemStatus as aT, type RecordImportStats as aU, type RecordImportItem as aV, type RecordImport as aW, type EnvironmentRecordImportSummary as aX, type ManifestPropertySpec as aY, type ManifestValidationOperator as aZ, type ManifestEnumRuleSpec as a_, type ToolInfo as aa, type EffectInfo as ab, type ToolsChangedEvent as ac, type EffectsChangedEvent as ad, type EffectHandler as ae, type InstanceEffectHandler as af, type JobStatus as ag, type JobFeedbackSentiment as ah, type JobFeedbackToolCall as ai, type JobFeedbackMetadata as aj, type JobFeedbackInput as ak, type JobFeedbackRecord as al, type EnvironmentFeedbackRecord as am, type JobSubmitResult as an, type Job as ao, type ConversationMessageShowRefs as ap, type ConversationMessageInput as aq, type ConversationAppendResult as ar, type SessionConversationMessage as as, type SessionTimelineEvent as at, type SessionJobRecord as au, type SessionHeapFieldType as av, type SessionHeapFieldValue as aw, type SessionHeapVariable as ax, type SessionDocumentResult as ay, type SessionCollectionListOptions as az, type SessionHeapList as b, type ManifestValidationRuleSpec as b0, type ManifestStateMachineStateSpec as b1, type ManifestStateMachineTransitionSpec as b2, type ManifestStateMachineSpec as b3, type ManifestPostConditionSpec as b4, type ManifestDryRunSpec as b5, type ManifestReverseSpec as b6, type ManifestApprovalRequiredSpec as b7, type ManifestRelationshipDef as b8, type ManifestEffectSchema as b9, type ManifestEffectDeclaration as ba, type ManifestEventTypeDef as bb, type ManifestEventStreamDef as bc, type ManifestOperation as bd, type ManifestImport as be, type ManifestVolume as bf, type ManifestContent as bg, type GraphQLResult as bh, type APIError as bi, type DeleteResponse as bj, type StreamEvent as bk, type StreamSubscription as bl, type StreamStats as bm, type SessionHeapSnapshot as c, type SessionTranscriptEntry as d, Environment as e, EnvironmentSession as f, Session as g, type ToolSchema as h, type PublishToolsResult as i, type ToolHandler as j, type GranularOptions as k, type GranularAuth as l, type RecordUserOptions as m, type Subject as n, type OpenEnvironmentOptions as o, type CreateSessionOptions as p, type ConversationSessionInfo as q, type Sandbox as r, type CreateSandboxData as s, type SandboxListResponse as t, type PermissionRules as u, type PermissionProfile as v, type CreatePermissionProfileData as w, type PermissionProfileListResponse as x, type Assignment as y, type AssignmentListResponse as z };

package/dist/{client-DTvI5MUG.d.ts → client-iw76FL_8.d.ts}

@@ -303,6 +303,7 @@ interface EnvironmentData {
     sandboxId: string;
     ontologyId?: string;
     buildId: string;
+    versionNumber?: number | null;
     versionId: string;
     subjectId: string;
     envName: string;
@@ -422,6 +423,8 @@ interface EffectHandlerContext {
     effectClientId: string;
     sandboxId: string;
     environmentId: string;
+    buildId?: string;
+    buildVersionNumber?: number;
     sessionId: string;
     tenantId?: string;
     principalId?: string;
@@ -534,6 +537,12 @@ interface ToolSchema {
      * passed as the first argument to the handler).
      */
     static?: boolean;
+    /**
+     * Optional build-version selector for this live effect binding.
+     *
+     * When omitted, the binding applies to all build versions for the sandbox.
+     */
+    versionSelector?: EffectVersionSelector;
     /** Declarative runtime behaviors attached to the effect. */
     metamodels?: ManifestEffectMetamodelSpec;
 }
@@ -566,6 +575,18 @@ interface PublishToolsResult {
     }>;
 }
 type PublishEffectsResult = PublishToolsResult;
+type EffectVersionSelector = {
+    mode: "all";
+} | {
+    mode: "exact";
+    versionNumber: number;
+} | {
+    mode: "before";
+    versionNumber: number;
+} | {
+    mode: "after";
+    versionNumber: number;
+};
 /**
  * Domain state response
  */
@@ -603,6 +624,8 @@ interface ToolInfo {
     className?: string;
     /** Whether this is a static method */
     static?: boolean;
+    /** Optional build-version selector associated with the live binding. */
+    versionSelector?: EffectVersionSelector;
     /** Declarative runtime behaviors attached to the effect. */
     metamodels?: ManifestEffectMetamodelSpec;
 }
@@ -2068,7 +2091,7 @@ declare class Granular {
     private onUnexpectedClose?;
     private onReconnectError?;
     private debugHttp;
-    /** Sandbox-level effect registry: sandboxId → (effectKey → ToolWithHandler) */
+    /** Sandbox-level effect registry: sandboxId → (effectKey@selector → ToolWithHandler) */
     private sandboxEffects;
     /** Live sandbox-scoped effect hosts keyed by sandboxId */
     private sandboxEffectHosts;
@@ -2326,4 +2349,4 @@ declare class Granular {
     private request;
 }
 
-export { type SemanticVersionDiff as $, type AccessTokenProvider as A, type BuildPolicy as B, type ConnectOptions as C, type DomainState as D, type EndpointMode as E, type VersionTag as F, Granular as G, type EnvironmentData as H, type InstanceToolHandler as I, type CreateEnvironmentData as J, type EnvironmentListResponse as K, type Manifest as L, type ManifestEffectMetamodelSpec as M, type ManifestListResponse as N, OntologyHandle as O, type Prompt as P, type BuildStatus as Q, type ResolvedEffectBehaviors as R, type SessionHeapEntry as S, type ToolWithHandler as T, type User as U, type VersionTracking as V, WSClient as W, type Build as X, type Version as Y, type BuildListResponse as Z, type SemanticVersionDiffEntry as _, type EffectHandlerContext as a, type ManifestValidationRuleSpec as a$, type ResolvedEffectPostCondition as a0, type ResolvedEffectDryRun as a1, type ResolvedEffectReverse as a2, type ResolvedEffectApprovalRequired as a3, type EffectInvocationMode as a4, type EffectInvocationMetadata as a5, type EffectSchema as a6, type EffectWithHandler as a7, type PublishEffectsResult as a8, type ToolInfo as a9, type SessionCollectionListResult as aA, type WSDisconnectInfo as aB, type WSReconnectErrorInfo as aC, type WSClientOptions as aD, type RPCRequest as aE, type RPCResponse as aF, type SyncMessage as aG, type RPCRequestFromServer as aH, type ToolInvokeParams as aI, type ToolResultParams as aJ, type ModelRef as aK, type RelationshipInfo as aL, type DefineRelationshipOptions as aM, type RecordObjectOptions as aN, type RecordObjectResult as aO, type RecordObjectsChunkInfo as aP, type RecordObjectsOptions as aQ, type RecordImportStatus as aR, type RecordImportItemStatus as aS, type RecordImportStats as aT, type RecordImportItem as aU, type RecordImport as aV, type EnvironmentRecordImportSummary as aW, type ManifestPropertySpec as aX, type ManifestValidationOperator as aY, type ManifestEnumRuleSpec as aZ, type ManifestFilterBySpec as a_, type EffectInfo as aa, type ToolsChangedEvent as ab, type EffectsChangedEvent as ac, type EffectHandler as ad, type InstanceEffectHandler as ae, type JobStatus as af, type JobFeedbackSentiment as ag, type JobFeedbackToolCall as ah, type JobFeedbackMetadata as ai, type JobFeedbackInput as aj, type JobFeedbackRecord as ak, type EnvironmentFeedbackRecord as al, type JobSubmitResult as am, type Job as an, type ConversationMessageShowRefs as ao, type ConversationMessageInput as ap, type ConversationAppendResult as aq, type SessionConversationMessage as ar, type SessionTimelineEvent as as, type SessionJobRecord as at, type SessionHeapFieldType as au, type SessionHeapFieldValue as av, type SessionHeapVariable as aw, type SessionDocumentResult as ax, type SessionCollectionListOptions as ay, type SessionJobListOptions as az, type SessionHeapList as b, type ManifestStateMachineStateSpec as b0, type ManifestStateMachineTransitionSpec as b1, type ManifestStateMachineSpec as b2, type ManifestPostConditionSpec as b3, type ManifestDryRunSpec as b4, type ManifestReverseSpec as b5, type ManifestApprovalRequiredSpec as b6, type ManifestRelationshipDef as b7, type ManifestEffectSchema as b8, type ManifestEffectDeclaration as b9, type ManifestEventTypeDef as ba, type ManifestEventStreamDef as bb, type ManifestOperation as bc, type ManifestImport as bd, type ManifestVolume as be, type ManifestContent as bf, type GraphQLResult as bg, type APIError as bh, type DeleteResponse as bi, type StreamEvent as bj, type StreamSubscription as bk, type StreamStats as bl, type SessionHeapSnapshot as c, type SessionTranscriptEntry as d, Environment as e, EnvironmentSession as f, Session as g, type ToolSchema as h, type PublishToolsResult as i, type ToolHandler as j, type GranularOptions as k, type GranularAuth as l, type RecordUserOptions as m, type Subject as n, type OpenEnvironmentOptions as o, type CreateSessionOptions as p, type ConversationSessionInfo as q, type Sandbox as r, type CreateSandboxData as s, type SandboxListResponse as t, type PermissionRules as u, type PermissionProfile as v, type CreatePermissionProfileData as w, type PermissionProfileListResponse as x, type Assignment as y, type AssignmentListResponse as z };
+export { type SemanticVersionDiff as $, type AccessTokenProvider as A, type BuildPolicy as B, type ConnectOptions as C, type DomainState as D, type EndpointMode as E, type VersionTag as F, Granular as G, type EnvironmentData as H, type InstanceToolHandler as I, type CreateEnvironmentData as J, type EnvironmentListResponse as K, type Manifest as L, type ManifestEffectMetamodelSpec as M, type ManifestListResponse as N, OntologyHandle as O, type Prompt as P, type BuildStatus as Q, type ResolvedEffectBehaviors as R, type SessionHeapEntry as S, type ToolWithHandler as T, type User as U, type VersionTracking as V, WSClient as W, type Build as X, type Version as Y, type BuildListResponse as Z, type SemanticVersionDiffEntry as _, type EffectHandlerContext as a, type ManifestFilterBySpec as a$, type ResolvedEffectPostCondition as a0, type ResolvedEffectDryRun as a1, type ResolvedEffectReverse as a2, type ResolvedEffectApprovalRequired as a3, type EffectInvocationMode as a4, type EffectInvocationMetadata as a5, type EffectSchema as a6, type EffectWithHandler as a7, type PublishEffectsResult as a8, type EffectVersionSelector as a9, type SessionJobListOptions as aA, type SessionCollectionListResult as aB, type WSDisconnectInfo as aC, type WSReconnectErrorInfo as aD, type WSClientOptions as aE, type RPCRequest as aF, type RPCResponse as aG, type SyncMessage as aH, type RPCRequestFromServer as aI, type ToolInvokeParams as aJ, type ToolResultParams as aK, type ModelRef as aL, type RelationshipInfo as aM, type DefineRelationshipOptions as aN, type RecordObjectOptions as aO, type RecordObjectResult as aP, type RecordObjectsChunkInfo as aQ, type RecordObjectsOptions as aR, type RecordImportStatus as aS, type RecordImportItemStatus as aT, type RecordImportStats as aU, type RecordImportItem as aV, type RecordImport as aW, type EnvironmentRecordImportSummary as aX, type ManifestPropertySpec as aY, type ManifestValidationOperator as aZ, type ManifestEnumRuleSpec as a_, type ToolInfo as aa, type EffectInfo as ab, type ToolsChangedEvent as ac, type EffectsChangedEvent as ad, type EffectHandler as ae, type InstanceEffectHandler as af, type JobStatus as ag, type JobFeedbackSentiment as ah, type JobFeedbackToolCall as ai, type JobFeedbackMetadata as aj, type JobFeedbackInput as ak, type JobFeedbackRecord as al, type EnvironmentFeedbackRecord as am, type JobSubmitResult as an, type Job as ao, type ConversationMessageShowRefs as ap, type ConversationMessageInput as aq, type ConversationAppendResult as ar, type SessionConversationMessage as as, type SessionTimelineEvent as at, type SessionJobRecord as au, type SessionHeapFieldType as av, type SessionHeapFieldValue as aw, type SessionHeapVariable as ax, type SessionDocumentResult as ay, type SessionCollectionListOptions as az, type SessionHeapList as b, type ManifestValidationRuleSpec as b0, type ManifestStateMachineStateSpec as b1, type ManifestStateMachineTransitionSpec as b2, type ManifestStateMachineSpec as b3, type ManifestPostConditionSpec as b4, type ManifestDryRunSpec as b5, type ManifestReverseSpec as b6, type ManifestApprovalRequiredSpec as b7, type ManifestRelationshipDef as b8, type ManifestEffectSchema as b9, type ManifestEffectDeclaration as ba, type ManifestEventTypeDef as bb, type ManifestEventStreamDef as bc, type ManifestOperation as bd, type ManifestImport as be, type ManifestVolume as bf, type ManifestContent as bg, type GraphQLResult as bh, type APIError as bi, type DeleteResponse as bj, type StreamEvent as bk, type StreamSubscription as bl, type StreamStats as bm, type SessionHeapSnapshot as c, type SessionTranscriptEntry as d, Environment as e, EnvironmentSession as f, Session as g, type ToolSchema as h, type PublishToolsResult as i, type ToolHandler as j, type GranularOptions as k, type GranularAuth as l, type RecordUserOptions as m, type Subject as n, type OpenEnvironmentOptions as o, type CreateSessionOptions as p, type ConversationSessionInfo as q, type Sandbox as r, type CreateSandboxData as s, type SandboxListResponse as t, type PermissionRules as u, type PermissionProfile as v, type CreatePermissionProfileData as w, type PermissionProfileListResponse as x, type Assignment as y, type AssignmentListResponse as z };

package/dist/index.d.mts

@@ -1,5 +1,5 @@
-import { E as EndpointMode, T as ToolWithHandler, a as EffectHandlerContext, M as ManifestEffectMetamodelSpec, R as ResolvedEffectBehaviors, S as SessionHeapEntry, b as SessionHeapList, c as SessionHeapSnapshot, P as Prompt, d as SessionTranscriptEntry } from './client-DTvI5MUG.mjs';
-export { bh as APIError, A as AccessTokenProvider, y as Assignment, z as AssignmentListResponse, X as Build, Z as BuildListResponse, B as BuildPolicy, Q as BuildStatus, C as ConnectOptions, aq as ConversationAppendResult, ap as ConversationMessageInput, ao as ConversationMessageShowRefs, q as ConversationSessionInfo, J as CreateEnvironmentData, w as CreatePermissionProfileData, s as CreateSandboxData, p as CreateSessionOptions, aM as DefineRelationshipOptions, bi as DeleteResponse, D as DomainState, ad as EffectHandler, aa as EffectInfo, a5 as EffectInvocationMetadata, a4 as EffectInvocationMode, a6 as EffectSchema, a7 as EffectWithHandler, ac as EffectsChangedEvent, e as Environment, H as EnvironmentData, al as EnvironmentFeedbackRecord, K as EnvironmentListResponse, aW as EnvironmentRecordImportSummary, f as EnvironmentSession, G as Granular, l as GranularAuth, k as GranularOptions, bg as GraphQLResult, ae as InstanceEffectHandler, I as InstanceToolHandler, an as Job, aj as JobFeedbackInput, ai as JobFeedbackMetadata, ak as JobFeedbackRecord, ag as JobFeedbackSentiment, ah as JobFeedbackToolCall, af as JobStatus, am as JobSubmitResult, L as Manifest, b6 as ManifestApprovalRequiredSpec, bf as ManifestContent, b4 as ManifestDryRunSpec, b9 as ManifestEffectDeclaration, b8 as ManifestEffectSchema, aZ as ManifestEnumRuleSpec, bb as ManifestEventStreamDef, ba as ManifestEventTypeDef, a_ as ManifestFilterBySpec, bd as ManifestImport, N as ManifestListResponse, bc as ManifestOperation, b3 as ManifestPostConditionSpec, aX as ManifestPropertySpec, b7 as ManifestRelationshipDef, b5 as ManifestReverseSpec, b2 as ManifestStateMachineSpec, b0 as ManifestStateMachineStateSpec, b1 as ManifestStateMachineTransitionSpec, aY as ManifestValidationOperator, a$ as ManifestValidationRuleSpec, be as ManifestVolume, aK as ModelRef, O as OntologyHandle, o as OpenEnvironmentOptions, v as PermissionProfile, x as PermissionProfileListResponse, u as PermissionRules, a8 as PublishEffectsResult, i as PublishToolsResult, aE as RPCRequest, aH as RPCRequestFromServer, aF as RPCResponse, aV as RecordImport, aU as RecordImportItem, aS as RecordImportItemStatus, aT as RecordImportStats, aR as RecordImportStatus, aN as RecordObjectOptions, aO as RecordObjectResult, aP as RecordObjectsChunkInfo, aQ as RecordObjectsOptions, m as RecordUserOptions, aL as RelationshipInfo, a3 as ResolvedEffectApprovalRequired, a1 as ResolvedEffectDryRun, a0 as ResolvedEffectPostCondition, a2 as ResolvedEffectReverse, r as Sandbox, t as SandboxListResponse, $ as SemanticVersionDiff, _ as SemanticVersionDiffEntry, g as Session, ay as SessionCollectionListOptions, aA as SessionCollectionListResult, ar as SessionConversationMessage, ax as SessionDocumentResult, au as SessionHeapFieldType, av as SessionHeapFieldValue, aw as SessionHeapVariable, az as SessionJobListOptions, at as SessionJobRecord, as as SessionTimelineEvent, bj as StreamEvent, bl as StreamStats, bk as StreamSubscription, n as Subject, aG as SyncMessage, j as ToolHandler, a9 as ToolInfo, aI as ToolInvokeParams, aJ as ToolResultParams, h as ToolSchema, ab as ToolsChangedEvent, U as User, Y as Version, F as VersionTag, V as VersionTracking, W as WSClient, aD as WSClientOptions, aB as WSDisconnectInfo, aC as WSReconnectErrorInfo } from './client-DTvI5MUG.mjs';
+import { E as EndpointMode, T as ToolWithHandler, a as EffectHandlerContext, M as ManifestEffectMetamodelSpec, R as ResolvedEffectBehaviors, S as SessionHeapEntry, b as SessionHeapList, c as SessionHeapSnapshot, P as Prompt, d as SessionTranscriptEntry } from './client-iw76FL_8.mjs';
+export { bi as APIError, A as AccessTokenProvider, y as Assignment, z as AssignmentListResponse, X as Build, Z as BuildListResponse, B as BuildPolicy, Q as BuildStatus, C as ConnectOptions, ar as ConversationAppendResult, aq as ConversationMessageInput, ap as ConversationMessageShowRefs, q as ConversationSessionInfo, J as CreateEnvironmentData, w as CreatePermissionProfileData, s as CreateSandboxData, p as CreateSessionOptions, aN as DefineRelationshipOptions, bj as DeleteResponse, D as DomainState, ae as EffectHandler, ab as EffectInfo, a5 as EffectInvocationMetadata, a4 as EffectInvocationMode, a6 as EffectSchema, a9 as EffectVersionSelector, a7 as EffectWithHandler, ad as EffectsChangedEvent, e as Environment, H as EnvironmentData, am as EnvironmentFeedbackRecord, K as EnvironmentListResponse, aX as EnvironmentRecordImportSummary, f as EnvironmentSession, G as Granular, l as GranularAuth, k as GranularOptions, bh as GraphQLResult, af as InstanceEffectHandler, I as InstanceToolHandler, ao as Job, ak as JobFeedbackInput, aj as JobFeedbackMetadata, al as JobFeedbackRecord, ah as JobFeedbackSentiment, ai as JobFeedbackToolCall, ag as JobStatus, an as JobSubmitResult, L as Manifest, b7 as ManifestApprovalRequiredSpec, bg as ManifestContent, b5 as ManifestDryRunSpec, ba as ManifestEffectDeclaration, b9 as ManifestEffectSchema, a_ as ManifestEnumRuleSpec, bc as ManifestEventStreamDef, bb as ManifestEventTypeDef, a$ as ManifestFilterBySpec, be as ManifestImport, N as ManifestListResponse, bd as ManifestOperation, b4 as ManifestPostConditionSpec, aY as ManifestPropertySpec, b8 as ManifestRelationshipDef, b6 as ManifestReverseSpec, b3 as ManifestStateMachineSpec, b1 as ManifestStateMachineStateSpec, b2 as ManifestStateMachineTransitionSpec, aZ as ManifestValidationOperator, b0 as ManifestValidationRuleSpec, bf as ManifestVolume, aL as ModelRef, O as OntologyHandle, o as OpenEnvironmentOptions, v as PermissionProfile, x as PermissionProfileListResponse, u as PermissionRules, a8 as PublishEffectsResult, i as PublishToolsResult, aF as RPCRequest, aI as RPCRequestFromServer, aG as RPCResponse, aW as RecordImport, aV as RecordImportItem, aT as RecordImportItemStatus, aU as RecordImportStats, aS as RecordImportStatus, aO as RecordObjectOptions, aP as RecordObjectResult, aQ as RecordObjectsChunkInfo, aR as RecordObjectsOptions, m as RecordUserOptions, aM as RelationshipInfo, a3 as ResolvedEffectApprovalRequired, a1 as ResolvedEffectDryRun, a0 as ResolvedEffectPostCondition, a2 as ResolvedEffectReverse, r as Sandbox, t as SandboxListResponse, $ as SemanticVersionDiff, _ as SemanticVersionDiffEntry, g as Session, az as SessionCollectionListOptions, aB as SessionCollectionListResult, as as SessionConversationMessage, ay as SessionDocumentResult, av as SessionHeapFieldType, aw as SessionHeapFieldValue, ax as SessionHeapVariable, aA as SessionJobListOptions, au as SessionJobRecord, at as SessionTimelineEvent, bk as StreamEvent, bm as StreamStats, bl as StreamSubscription, n as Subject, aH as SyncMessage, j as ToolHandler, aa as ToolInfo, aJ as ToolInvokeParams, aK as ToolResultParams, h as ToolSchema, ac as ToolsChangedEvent, U as User, Y as Version, F as VersionTag, V as VersionTracking, W as WSClient, aE as WSClientOptions, aC as WSDisconnectInfo, aD as WSReconnectErrorInfo } from './client-iw76FL_8.mjs';
 export { BuildGranularAgentSystemPromptInput, GeneratedJobCodeIssue, GranularAgentExecutionCheckpoint, GranularAgentHeapSummaryOptions, GranularAgentReferentFocus, GranularAgentSessionContext, GranularAgentToolInfo, GranularAgentWorkflowFocus, HarnessContinuationDecision, HarnessControllerBudgets, HarnessProjectionOptions, HarnessPromptLike, HarnessVerifierSnapshot, HarnessVerifierSnapshotInput, buildContinuationInstruction, buildGranularAgentCheckpointBlock, buildGranularAgentDomainBlock, buildGranularAgentHeapBlock, buildGranularAgentLoopBlock, buildGranularAgentReferentBlock, buildGranularAgentSessionBlock, buildGranularAgentSystemPrompt, buildGranularAgentToolBlock, buildGranularAgentWorkflowBlock, createHarnessVerifierSnapshot, evaluateContinuation, getCurrentClosureId, getExclusivePromptTarget, hasOpenPrompt, projectConversationReferentFocus, projectConversationReferentSummary, projectHeapSummary, projectLoopSummary, projectWorkflowFocus, projectWorkflowSummary, reviewGeneratedJobCode } from './agent-harness.mjs';
 import '@automerge/automerge';
 import '@automerge/automerge/slim';

package/dist/index.d.ts

@@ -1,5 +1,5 @@
-import { E as EndpointMode, T as ToolWithHandler, a as EffectHandlerContext, M as ManifestEffectMetamodelSpec, R as ResolvedEffectBehaviors, S as SessionHeapEntry, b as SessionHeapList, c as SessionHeapSnapshot, P as Prompt, d as SessionTranscriptEntry } from './client-DTvI5MUG.js';
-export { bh as APIError, A as AccessTokenProvider, y as Assignment, z as AssignmentListResponse, X as Build, Z as BuildListResponse, B as BuildPolicy, Q as BuildStatus, C as ConnectOptions, aq as ConversationAppendResult, ap as ConversationMessageInput, ao as ConversationMessageShowRefs, q as ConversationSessionInfo, J as CreateEnvironmentData, w as CreatePermissionProfileData, s as CreateSandboxData, p as CreateSessionOptions, aM as DefineRelationshipOptions, bi as DeleteResponse, D as DomainState, ad as EffectHandler, aa as EffectInfo, a5 as EffectInvocationMetadata, a4 as EffectInvocationMode, a6 as EffectSchema, a7 as EffectWithHandler, ac as EffectsChangedEvent, e as Environment, H as EnvironmentData, al as EnvironmentFeedbackRecord, K as EnvironmentListResponse, aW as EnvironmentRecordImportSummary, f as EnvironmentSession, G as Granular, l as GranularAuth, k as GranularOptions, bg as GraphQLResult, ae as InstanceEffectHandler, I as InstanceToolHandler, an as Job, aj as JobFeedbackInput, ai as JobFeedbackMetadata, ak as JobFeedbackRecord, ag as JobFeedbackSentiment, ah as JobFeedbackToolCall, af as JobStatus, am as JobSubmitResult, L as Manifest, b6 as ManifestApprovalRequiredSpec, bf as ManifestContent, b4 as ManifestDryRunSpec, b9 as ManifestEffectDeclaration, b8 as ManifestEffectSchema, aZ as ManifestEnumRuleSpec, bb as ManifestEventStreamDef, ba as ManifestEventTypeDef, a_ as ManifestFilterBySpec, bd as ManifestImport, N as ManifestListResponse, bc as ManifestOperation, b3 as ManifestPostConditionSpec, aX as ManifestPropertySpec, b7 as ManifestRelationshipDef, b5 as ManifestReverseSpec, b2 as ManifestStateMachineSpec, b0 as ManifestStateMachineStateSpec, b1 as ManifestStateMachineTransitionSpec, aY as ManifestValidationOperator, a$ as ManifestValidationRuleSpec, be as ManifestVolume, aK as ModelRef, O as OntologyHandle, o as OpenEnvironmentOptions, v as PermissionProfile, x as PermissionProfileListResponse, u as PermissionRules, a8 as PublishEffectsResult, i as PublishToolsResult, aE as RPCRequest, aH as RPCRequestFromServer, aF as RPCResponse, aV as RecordImport, aU as RecordImportItem, aS as RecordImportItemStatus, aT as RecordImportStats, aR as RecordImportStatus, aN as RecordObjectOptions, aO as RecordObjectResult, aP as RecordObjectsChunkInfo, aQ as RecordObjectsOptions, m as RecordUserOptions, aL as RelationshipInfo, a3 as ResolvedEffectApprovalRequired, a1 as ResolvedEffectDryRun, a0 as ResolvedEffectPostCondition, a2 as ResolvedEffectReverse, r as Sandbox, t as SandboxListResponse, $ as SemanticVersionDiff, _ as SemanticVersionDiffEntry, g as Session, ay as SessionCollectionListOptions, aA as SessionCollectionListResult, ar as SessionConversationMessage, ax as SessionDocumentResult, au as SessionHeapFieldType, av as SessionHeapFieldValue, aw as SessionHeapVariable, az as SessionJobListOptions, at as SessionJobRecord, as as SessionTimelineEvent, bj as StreamEvent, bl as StreamStats, bk as StreamSubscription, n as Subject, aG as SyncMessage, j as ToolHandler, a9 as ToolInfo, aI as ToolInvokeParams, aJ as ToolResultParams, h as ToolSchema, ab as ToolsChangedEvent, U as User, Y as Version, F as VersionTag, V as VersionTracking, W as WSClient, aD as WSClientOptions, aB as WSDisconnectInfo, aC as WSReconnectErrorInfo } from './client-DTvI5MUG.js';
+import { E as EndpointMode, T as ToolWithHandler, a as EffectHandlerContext, M as ManifestEffectMetamodelSpec, R as ResolvedEffectBehaviors, S as SessionHeapEntry, b as SessionHeapList, c as SessionHeapSnapshot, P as Prompt, d as SessionTranscriptEntry } from './client-iw76FL_8.js';
+export { bi as APIError, A as AccessTokenProvider, y as Assignment, z as AssignmentListResponse, X as Build, Z as BuildListResponse, B as BuildPolicy, Q as BuildStatus, C as ConnectOptions, ar as ConversationAppendResult, aq as ConversationMessageInput, ap as ConversationMessageShowRefs, q as ConversationSessionInfo, J as CreateEnvironmentData, w as CreatePermissionProfileData, s as CreateSandboxData, p as CreateSessionOptions, aN as DefineRelationshipOptions, bj as DeleteResponse, D as DomainState, ae as EffectHandler, ab as EffectInfo, a5 as EffectInvocationMetadata, a4 as EffectInvocationMode, a6 as EffectSchema, a9 as EffectVersionSelector, a7 as EffectWithHandler, ad as EffectsChangedEvent, e as Environment, H as EnvironmentData, am as EnvironmentFeedbackRecord, K as EnvironmentListResponse, aX as EnvironmentRecordImportSummary, f as EnvironmentSession, G as Granular, l as GranularAuth, k as GranularOptions, bh as GraphQLResult, af as InstanceEffectHandler, I as InstanceToolHandler, ao as Job, ak as JobFeedbackInput, aj as JobFeedbackMetadata, al as JobFeedbackRecord, ah as JobFeedbackSentiment, ai as JobFeedbackToolCall, ag as JobStatus, an as JobSubmitResult, L as Manifest, b7 as ManifestApprovalRequiredSpec, bg as ManifestContent, b5 as ManifestDryRunSpec, ba as ManifestEffectDeclaration, b9 as ManifestEffectSchema, a_ as ManifestEnumRuleSpec, bc as ManifestEventStreamDef, bb as ManifestEventTypeDef, a$ as ManifestFilterBySpec, be as ManifestImport, N as ManifestListResponse, bd as ManifestOperation, b4 as ManifestPostConditionSpec, aY as ManifestPropertySpec, b8 as ManifestRelationshipDef, b6 as ManifestReverseSpec, b3 as ManifestStateMachineSpec, b1 as ManifestStateMachineStateSpec, b2 as ManifestStateMachineTransitionSpec, aZ as ManifestValidationOperator, b0 as ManifestValidationRuleSpec, bf as ManifestVolume, aL as ModelRef, O as OntologyHandle, o as OpenEnvironmentOptions, v as PermissionProfile, x as PermissionProfileListResponse, u as PermissionRules, a8 as PublishEffectsResult, i as PublishToolsResult, aF as RPCRequest, aI as RPCRequestFromServer, aG as RPCResponse, aW as RecordImport, aV as RecordImportItem, aT as RecordImportItemStatus, aU as RecordImportStats, aS as RecordImportStatus, aO as RecordObjectOptions, aP as RecordObjectResult, aQ as RecordObjectsChunkInfo, aR as RecordObjectsOptions, m as RecordUserOptions, aM as RelationshipInfo, a3 as ResolvedEffectApprovalRequired, a1 as ResolvedEffectDryRun, a0 as ResolvedEffectPostCondition, a2 as ResolvedEffectReverse, r as Sandbox, t as SandboxListResponse, $ as SemanticVersionDiff, _ as SemanticVersionDiffEntry, g as Session, az as SessionCollectionListOptions, aB as SessionCollectionListResult, as as SessionConversationMessage, ay as SessionDocumentResult, av as SessionHeapFieldType, aw as SessionHeapFieldValue, ax as SessionHeapVariable, aA as SessionJobListOptions, au as SessionJobRecord, at as SessionTimelineEvent, bk as StreamEvent, bm as StreamStats, bl as StreamSubscription, n as Subject, aH as SyncMessage, j as ToolHandler, aa as ToolInfo, aJ as ToolInvokeParams, aK as ToolResultParams, h as ToolSchema, ac as ToolsChangedEvent, U as User, Y as Version, F as VersionTag, V as VersionTracking, W as WSClient, aE as WSClientOptions, aC as WSDisconnectInfo, aD as WSReconnectErrorInfo } from './client-iw76FL_8.js';
 export { BuildGranularAgentSystemPromptInput, GeneratedJobCodeIssue, GranularAgentExecutionCheckpoint, GranularAgentHeapSummaryOptions, GranularAgentReferentFocus, GranularAgentSessionContext, GranularAgentToolInfo, GranularAgentWorkflowFocus, HarnessContinuationDecision, HarnessControllerBudgets, HarnessProjectionOptions, HarnessPromptLike, HarnessVerifierSnapshot, HarnessVerifierSnapshotInput, buildContinuationInstruction, buildGranularAgentCheckpointBlock, buildGranularAgentDomainBlock, buildGranularAgentHeapBlock, buildGranularAgentLoopBlock, buildGranularAgentReferentBlock, buildGranularAgentSessionBlock, buildGranularAgentSystemPrompt, buildGranularAgentToolBlock, buildGranularAgentWorkflowBlock, createHarnessVerifierSnapshot, evaluateContinuation, getCurrentClosureId, getExclusivePromptTarget, hasOpenPrompt, projectConversationReferentFocus, projectConversationReferentSummary, projectHeapSummary, projectLoopSummary, projectWorkflowFocus, projectWorkflowSummary, reviewGeneratedJobCode } from './agent-harness.js';
 import '@automerge/automerge';
 import '@automerge/automerge/slim';

package/dist/index.js

@@ -10886,6 +10886,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
@@ -10906,9 +10950,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;
   }
@@ -10923,7 +10975,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;
     }
@@ -10959,7 +11015,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}`);
   }
@@ -12218,6 +12278,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")) {
@@ -13739,7 +13810,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();
@@ -14158,7 +14229,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) {
@@ -14346,7 +14418,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);
   }
   /**
@@ -14359,7 +14434,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);
   }
@@ -14377,7 +14452,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;