@granular-software/sdk 0.4.37 → 0.4.38

package/dist/index.d.mts

@@ -1,5 +1,6 @@
-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-eE9nTfvp.mjs';
-export { bt 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, aQ as DefineRelationshipOptions, bu 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, b6 as EnvironmentImporter, b5 as EnvironmentImporterImportOptions, K as EnvironmentListResponse, b0 as EnvironmentRecordImportSummary, f as EnvironmentSession, b3 as EnvironmentSetupLifecycleStatus, b4 as EnvironmentSetupSummary, b1 as EnvironmentSetupTriggerReason, G as Granular, l as GranularAuth, k as GranularOptions, bs 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, bi as ManifestApprovalRequiredSpec, br as ManifestContent, bg as ManifestDryRunSpec, bl as ManifestEffectDeclaration, bk as ManifestEffectSchema, b9 as ManifestEnumRuleSpec, bn as ManifestEventStreamDef, bm as ManifestEventTypeDef, ba as ManifestFilterBySpec, bp as ManifestImport, N as ManifestListResponse, bo as ManifestOperation, bf as ManifestPostConditionSpec, b7 as ManifestPropertySpec, bj as ManifestRelationshipDef, bh as ManifestReverseSpec, be as ManifestStateMachineSpec, bc as ManifestStateMachineStateSpec, bd as ManifestStateMachineTransitionSpec, b8 as ManifestValidationOperator, bb as ManifestValidationRuleSpec, bq as ManifestVolume, aO as ModelRef, O as OntologyHandle, o as OpenEnvironmentOptions, v as PermissionProfile, x as PermissionProfileListResponse, u as PermissionRules, a8 as PublishEffectsResult, i as PublishToolsResult, aI as RPCRequest, aL as RPCRequestFromServer, aJ as RPCResponse, a$ as RecordImport, a_ as RecordImportItem, aY as RecordImportItemStatus, aW as RecordImportOptions, aZ as RecordImportStats, aX as RecordImportStatus, aV as RecordImportWriteMode, aA as RecordMentionInput, aR as RecordObjectOptions, aS as RecordObjectResult, aT as RecordObjectsChunkInfo, aU as RecordObjectsOptions, az as RecordSearchOptions, ay as RecordSearchResult, m as RecordUserOptions, aP as RelationshipInfo, a3 as ResolvedEffectApprovalRequired, a1 as ResolvedEffectDryRun, a0 as ResolvedEffectPostCondition, a2 as ResolvedEffectReverse, b2 as RunEnvironmentImporterOptions, r as Sandbox, t as SandboxListResponse, $ as SemanticVersionDiff, _ as SemanticVersionDiffEntry, g as Session, aC as SessionCollectionListOptions, aE as SessionCollectionListResult, as as SessionConversationMessage, aB as SessionDocumentResult, av as SessionHeapFieldType, aw as SessionHeapFieldValue, ax as SessionHeapVariable, aD as SessionJobListOptions, au as SessionJobRecord, at as SessionTimelineEvent, bv as StreamEvent, bx as StreamStats, bw as StreamSubscription, n as Subject, aK as SyncMessage, j as ToolHandler, aa as ToolInfo, aM as ToolInvokeParams, aN as ToolResultParams, h as ToolSchema, ac as ToolsChangedEvent, U as User, Y as Version, F as VersionTag, V as VersionTracking, W as WSClient, aH as WSClientOptions, aF as WSDisconnectInfo, aG as WSReconnectErrorInfo } from './client-eE9nTfvp.mjs';
+export { E as Environment, a as EnvironmentSession, G as Granular, O as OntologyHandle, S as Session, W as WSClient } from './client-HDJgcJC5.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 './spend-rzS1rlFr.mjs';
+export { bJ as APIError, A as AccessTokenProvider, a0 as Assignment, a1 as AssignmentListResponse, ab as Build, ad as BuildListResponse, a2 as BuildPolicy, aa as BuildStatus, C as ConnectOptions, aH as ConversationAppendResult, aG as ConversationMessageInput, aF as ConversationMessageShowRefs, y as ConversationSessionInfo, a6 as CreateEnvironmentData, _ as CreatePermissionProfileData, W as CreateSandboxData, x as CreateSessionOptions, b4 as DefineRelationshipOptions, bK as DeleteResponse, D as DomainState, au as EffectHandler, ar as EffectInfo, al as EffectInvocationMetadata, ak as EffectInvocationMode, am as EffectSchema, ap as EffectVersionSelector, an as EffectWithHandler, at as EffectsChangedEvent, a5 as EnvironmentData, aC as EnvironmentFeedbackRecord, bm as EnvironmentImporter, bl as EnvironmentImporterImportOptions, a7 as EnvironmentListResponse, bg as EnvironmentRecordImportSummary, bj as EnvironmentSetupLifecycleStatus, bk as EnvironmentSetupSummary, bh as EnvironmentSetupTriggerReason, s as GranularAuth, q as GranularOptions, K as GranularQuotaPolicy, L as GranularQuotaProgress, G as GranularSpendContext, bI as GraphQLResult, av as InstanceEffectHandler, I as InstanceToolHandler, aE as Job, aA as JobFeedbackInput, az as JobFeedbackMetadata, aB as JobFeedbackRecord, ax as JobFeedbackSentiment, ay as JobFeedbackToolCall, aw as JobStatus, aD as JobSubmitResult, a8 as Manifest, by as ManifestApprovalRequiredSpec, bH as ManifestContent, bw as ManifestDryRunSpec, bB as ManifestEffectDeclaration, bA as ManifestEffectSchema, bp as ManifestEnumRuleSpec, bD as ManifestEventStreamDef, bC as ManifestEventTypeDef, bq as ManifestFilterBySpec, bF as ManifestImport, a9 as ManifestListResponse, bE as ManifestOperation, bv as ManifestPostConditionSpec, bn as ManifestPropertySpec, bz as ManifestRelationshipDef, bx as ManifestReverseSpec, bu as ManifestStateMachineSpec, bs as ManifestStateMachineStateSpec, bt as ManifestStateMachineTransitionSpec, bo as ManifestValidationOperator, br as ManifestValidationRuleSpec, bG as ManifestVolume, b2 as ModelRef, N as NormalizedOpenAIUsage, i as OPENAI_MODEL_PRICING_USD_PER_MILLION, O as OpenAIModelPricing, h as OpenAITokenSpend, l as OpenAIUsageSpendEvent, w as OpenEnvironmentOptions, Z as PermissionProfile, $ as PermissionProfileListResponse, Y as PermissionRules, ao as PublishEffectsResult, f as PublishToolsResult, J as QuotaLineItemFilter, B as QuotaPeriod, Q as QuotaScopeType, F as QuotaStatus, aY as RPCRequest, a$ as RPCRequestFromServer, aZ as RPCResponse, bf as RecordImport, be as RecordImportItem, bc as RecordImportItemStatus, ba as RecordImportOptions, bd as RecordImportStats, bb as RecordImportStatus, b9 as RecordImportWriteMode, aQ as RecordMentionInput, b5 as RecordObjectOptions, b6 as RecordObjectResult, b7 as RecordObjectsChunkInfo, b8 as RecordObjectsOptions, m as RecordOpenAIUsageSpendOptions, o as RecordOpenAIUsageSpendResult, aP as RecordSearchOptions, aO as RecordSearchResult, u as RecordUserOptions, b3 as RelationshipInfo, aj as ResolvedEffectApprovalRequired, ah as ResolvedEffectDryRun, ag as ResolvedEffectPostCondition, ai as ResolvedEffectReverse, bi as RunEnvironmentImporterOptions, V as Sandbox, X as SandboxListResponse, af as SemanticVersionDiff, ae as SemanticVersionDiffEntry, aS as SessionCollectionListOptions, aU as SessionCollectionListResult, aI as SessionConversationMessage, aR as SessionDocumentResult, aL as SessionHeapFieldType, aM as SessionHeapFieldValue, aN as SessionHeapVariable, aT as SessionJobListOptions, aK as SessionJobRecord, aJ as SessionTimelineEvent, z as SpendLineItemType, H as SpendSummary, bL as StreamEvent, bN as StreamStats, bM as StreamSubscription, v as Subject, a_ as SyncMessage, g as ToolHandler, aq as ToolInfo, b0 as ToolInvokeParams, b1 as ToolResultParams, e as ToolSchema, as as ToolsChangedEvent, U as User, ac as Version, a4 as VersionTag, a3 as VersionTracking, aX as WSClientOptions, aV as WSDisconnectInfo, aW as WSReconnectErrorInfo, p as buildOpenAISpendEventId, k as calculateOpenAITokenSpend, j as getOpenAIModelPricing, n as normalizeOpenAIUsage, r as recordOpenAIUsageSpend, t as toGranularHttpBase } from './spend-rzS1rlFr.mjs';
 export { ConditionIR, ConditionalPolicySpec, LimitPolicySpec, MatchedPolicy, PermissionActionSpec, PermissionPolicySpec, PermissionProfileFile, PolicyDecision, PolicyEvaluationContext, PolicyOutcome, PolicyRuleIR } from '@granular-software/policy-engine';
 export { BuildGranularAgentSystemPromptInput, GeneratedJobCodeIssue, GranularAgentExecutionCheckpoint, GranularAgentHeapSummaryOptions, GranularAgentPromptCapabilities, GranularAgentReferentFocus, GranularAgentSessionContext, GranularAgentToolInfo, GranularAgentWorkflowFocus, GranularReasoningTraceChunkResult, GranularReasoningTraceOptions, HarnessContinuationDecision, HarnessControllerBudgets, HarnessProjectionOptions, HarnessPromptLike, HarnessVerifierSnapshot, HarnessVerifierSnapshotInput, ReviewGeneratedJobCodeOptions, buildContinuationInstruction, buildGranularAgentCheckpointBlock, buildGranularAgentDomainBlock, buildGranularAgentHeapBlock, buildGranularAgentLoopBlock, buildGranularAgentReferentBlock, buildGranularAgentSessionBlock, buildGranularAgentSystemPrompt, buildGranularAgentToolBlock, buildGranularAgentWorkflowBlock, consumeGranularReasoningOnlyChunk, consumeGranularReasoningTraceChunk, createHarnessVerifierSnapshot, evaluateContinuation, getCurrentClosureId, getExclusivePromptTarget, hasOpenPrompt, projectConversationReferentFocus, projectConversationReferentSummary, projectHeapSummary, projectLoopSummary, projectWorkflowFocus, projectWorkflowSummary, reviewGeneratedJobCode, stripGranularReasoningTrace } from './agent-harness.mjs';
 import '@automerge/automerge';

package/dist/index.d.ts

@@ -1,5 +1,6 @@
-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-eE9nTfvp.js';
-export { bt 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, aQ as DefineRelationshipOptions, bu 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, b6 as EnvironmentImporter, b5 as EnvironmentImporterImportOptions, K as EnvironmentListResponse, b0 as EnvironmentRecordImportSummary, f as EnvironmentSession, b3 as EnvironmentSetupLifecycleStatus, b4 as EnvironmentSetupSummary, b1 as EnvironmentSetupTriggerReason, G as Granular, l as GranularAuth, k as GranularOptions, bs 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, bi as ManifestApprovalRequiredSpec, br as ManifestContent, bg as ManifestDryRunSpec, bl as ManifestEffectDeclaration, bk as ManifestEffectSchema, b9 as ManifestEnumRuleSpec, bn as ManifestEventStreamDef, bm as ManifestEventTypeDef, ba as ManifestFilterBySpec, bp as ManifestImport, N as ManifestListResponse, bo as ManifestOperation, bf as ManifestPostConditionSpec, b7 as ManifestPropertySpec, bj as ManifestRelationshipDef, bh as ManifestReverseSpec, be as ManifestStateMachineSpec, bc as ManifestStateMachineStateSpec, bd as ManifestStateMachineTransitionSpec, b8 as ManifestValidationOperator, bb as ManifestValidationRuleSpec, bq as ManifestVolume, aO as ModelRef, O as OntologyHandle, o as OpenEnvironmentOptions, v as PermissionProfile, x as PermissionProfileListResponse, u as PermissionRules, a8 as PublishEffectsResult, i as PublishToolsResult, aI as RPCRequest, aL as RPCRequestFromServer, aJ as RPCResponse, a$ as RecordImport, a_ as RecordImportItem, aY as RecordImportItemStatus, aW as RecordImportOptions, aZ as RecordImportStats, aX as RecordImportStatus, aV as RecordImportWriteMode, aA as RecordMentionInput, aR as RecordObjectOptions, aS as RecordObjectResult, aT as RecordObjectsChunkInfo, aU as RecordObjectsOptions, az as RecordSearchOptions, ay as RecordSearchResult, m as RecordUserOptions, aP as RelationshipInfo, a3 as ResolvedEffectApprovalRequired, a1 as ResolvedEffectDryRun, a0 as ResolvedEffectPostCondition, a2 as ResolvedEffectReverse, b2 as RunEnvironmentImporterOptions, r as Sandbox, t as SandboxListResponse, $ as SemanticVersionDiff, _ as SemanticVersionDiffEntry, g as Session, aC as SessionCollectionListOptions, aE as SessionCollectionListResult, as as SessionConversationMessage, aB as SessionDocumentResult, av as SessionHeapFieldType, aw as SessionHeapFieldValue, ax as SessionHeapVariable, aD as SessionJobListOptions, au as SessionJobRecord, at as SessionTimelineEvent, bv as StreamEvent, bx as StreamStats, bw as StreamSubscription, n as Subject, aK as SyncMessage, j as ToolHandler, aa as ToolInfo, aM as ToolInvokeParams, aN as ToolResultParams, h as ToolSchema, ac as ToolsChangedEvent, U as User, Y as Version, F as VersionTag, V as VersionTracking, W as WSClient, aH as WSClientOptions, aF as WSDisconnectInfo, aG as WSReconnectErrorInfo } from './client-eE9nTfvp.js';
+export { E as Environment, a as EnvironmentSession, G as Granular, O as OntologyHandle, S as Session, W as WSClient } from './client-BNbWA9jQ.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 './spend-rzS1rlFr.js';
+export { bJ as APIError, A as AccessTokenProvider, a0 as Assignment, a1 as AssignmentListResponse, ab as Build, ad as BuildListResponse, a2 as BuildPolicy, aa as BuildStatus, C as ConnectOptions, aH as ConversationAppendResult, aG as ConversationMessageInput, aF as ConversationMessageShowRefs, y as ConversationSessionInfo, a6 as CreateEnvironmentData, _ as CreatePermissionProfileData, W as CreateSandboxData, x as CreateSessionOptions, b4 as DefineRelationshipOptions, bK as DeleteResponse, D as DomainState, au as EffectHandler, ar as EffectInfo, al as EffectInvocationMetadata, ak as EffectInvocationMode, am as EffectSchema, ap as EffectVersionSelector, an as EffectWithHandler, at as EffectsChangedEvent, a5 as EnvironmentData, aC as EnvironmentFeedbackRecord, bm as EnvironmentImporter, bl as EnvironmentImporterImportOptions, a7 as EnvironmentListResponse, bg as EnvironmentRecordImportSummary, bj as EnvironmentSetupLifecycleStatus, bk as EnvironmentSetupSummary, bh as EnvironmentSetupTriggerReason, s as GranularAuth, q as GranularOptions, K as GranularQuotaPolicy, L as GranularQuotaProgress, G as GranularSpendContext, bI as GraphQLResult, av as InstanceEffectHandler, I as InstanceToolHandler, aE as Job, aA as JobFeedbackInput, az as JobFeedbackMetadata, aB as JobFeedbackRecord, ax as JobFeedbackSentiment, ay as JobFeedbackToolCall, aw as JobStatus, aD as JobSubmitResult, a8 as Manifest, by as ManifestApprovalRequiredSpec, bH as ManifestContent, bw as ManifestDryRunSpec, bB as ManifestEffectDeclaration, bA as ManifestEffectSchema, bp as ManifestEnumRuleSpec, bD as ManifestEventStreamDef, bC as ManifestEventTypeDef, bq as ManifestFilterBySpec, bF as ManifestImport, a9 as ManifestListResponse, bE as ManifestOperation, bv as ManifestPostConditionSpec, bn as ManifestPropertySpec, bz as ManifestRelationshipDef, bx as ManifestReverseSpec, bu as ManifestStateMachineSpec, bs as ManifestStateMachineStateSpec, bt as ManifestStateMachineTransitionSpec, bo as ManifestValidationOperator, br as ManifestValidationRuleSpec, bG as ManifestVolume, b2 as ModelRef, N as NormalizedOpenAIUsage, i as OPENAI_MODEL_PRICING_USD_PER_MILLION, O as OpenAIModelPricing, h as OpenAITokenSpend, l as OpenAIUsageSpendEvent, w as OpenEnvironmentOptions, Z as PermissionProfile, $ as PermissionProfileListResponse, Y as PermissionRules, ao as PublishEffectsResult, f as PublishToolsResult, J as QuotaLineItemFilter, B as QuotaPeriod, Q as QuotaScopeType, F as QuotaStatus, aY as RPCRequest, a$ as RPCRequestFromServer, aZ as RPCResponse, bf as RecordImport, be as RecordImportItem, bc as RecordImportItemStatus, ba as RecordImportOptions, bd as RecordImportStats, bb as RecordImportStatus, b9 as RecordImportWriteMode, aQ as RecordMentionInput, b5 as RecordObjectOptions, b6 as RecordObjectResult, b7 as RecordObjectsChunkInfo, b8 as RecordObjectsOptions, m as RecordOpenAIUsageSpendOptions, o as RecordOpenAIUsageSpendResult, aP as RecordSearchOptions, aO as RecordSearchResult, u as RecordUserOptions, b3 as RelationshipInfo, aj as ResolvedEffectApprovalRequired, ah as ResolvedEffectDryRun, ag as ResolvedEffectPostCondition, ai as ResolvedEffectReverse, bi as RunEnvironmentImporterOptions, V as Sandbox, X as SandboxListResponse, af as SemanticVersionDiff, ae as SemanticVersionDiffEntry, aS as SessionCollectionListOptions, aU as SessionCollectionListResult, aI as SessionConversationMessage, aR as SessionDocumentResult, aL as SessionHeapFieldType, aM as SessionHeapFieldValue, aN as SessionHeapVariable, aT as SessionJobListOptions, aK as SessionJobRecord, aJ as SessionTimelineEvent, z as SpendLineItemType, H as SpendSummary, bL as StreamEvent, bN as StreamStats, bM as StreamSubscription, v as Subject, a_ as SyncMessage, g as ToolHandler, aq as ToolInfo, b0 as ToolInvokeParams, b1 as ToolResultParams, e as ToolSchema, as as ToolsChangedEvent, U as User, ac as Version, a4 as VersionTag, a3 as VersionTracking, aX as WSClientOptions, aV as WSDisconnectInfo, aW as WSReconnectErrorInfo, p as buildOpenAISpendEventId, k as calculateOpenAITokenSpend, j as getOpenAIModelPricing, n as normalizeOpenAIUsage, r as recordOpenAIUsageSpend, t as toGranularHttpBase } from './spend-rzS1rlFr.js';
 export { ConditionIR, ConditionalPolicySpec, LimitPolicySpec, MatchedPolicy, PermissionActionSpec, PermissionPolicySpec, PermissionProfileFile, PolicyDecision, PolicyEvaluationContext, PolicyOutcome, PolicyRuleIR } from '@granular-software/policy-engine';
 export { BuildGranularAgentSystemPromptInput, GeneratedJobCodeIssue, GranularAgentExecutionCheckpoint, GranularAgentHeapSummaryOptions, GranularAgentPromptCapabilities, GranularAgentReferentFocus, GranularAgentSessionContext, GranularAgentToolInfo, GranularAgentWorkflowFocus, GranularReasoningTraceChunkResult, GranularReasoningTraceOptions, HarnessContinuationDecision, HarnessControllerBudgets, HarnessProjectionOptions, HarnessPromptLike, HarnessVerifierSnapshot, HarnessVerifierSnapshotInput, ReviewGeneratedJobCodeOptions, buildContinuationInstruction, buildGranularAgentCheckpointBlock, buildGranularAgentDomainBlock, buildGranularAgentHeapBlock, buildGranularAgentLoopBlock, buildGranularAgentReferentBlock, buildGranularAgentSessionBlock, buildGranularAgentSystemPrompt, buildGranularAgentToolBlock, buildGranularAgentWorkflowBlock, consumeGranularReasoningOnlyChunk, consumeGranularReasoningTraceChunk, createHarnessVerifierSnapshot, evaluateContinuation, getCurrentClosureId, getExclusivePromptTarget, hasOpenPrompt, projectConversationReferentFocus, projectConversationReferentSummary, projectHeapSummary, projectLoopSummary, projectWorkflowFocus, projectWorkflowSummary, reviewGeneratedJobCode, stripGranularReasoningTrace } from './agent-harness.js';
 import '@automerge/automerge';

package/dist/index.js

@@ -4638,6 +4638,7 @@ function withPromptTranscriptTimeout(promise) {
 var Session = class {
   client;
   clientId;
+  initialQuota;
   jobsMap = /* @__PURE__ */ new Map();
   pendingAgentMessagesByJobId = /* @__PURE__ */ new Map();
   eventListeners = /* @__PURE__ */ new Map();
@@ -4653,9 +4654,10 @@ var Session = class {
   promptCache = /* @__PURE__ */ new Map();
   /** Prompt ids locally answered before the document sync catches up. */
   hiddenPromptIds = /* @__PURE__ */ new Set();
-  constructor(client, clientId) {
+  constructor(client, clientId, options = {}) {
     this.client = client;
     this.clientId = clientId || `client_${Date.now()}`;
+    this.initialQuota = options.initialQuota || null;
     this.setupEventHandlers();
     this.setupToolInvokeHandler();
   }
@@ -4704,6 +4706,16 @@ var Session = class {
   get document() {
     return this.client.doc;
   }
+  get quota() {
+    return this.getQuota();
+  }
+  getQuota() {
+    const quota = this.client.doc.billing?.quota;
+    if (quota && typeof quota === "object") {
+      return quota;
+    }
+    return this.initialQuota;
+  }
   get sessionId() {
     return this.client.currentSessionId;
   }
@@ -11326,6 +11338,110 @@ async function invokeRegisteredEffect(effectMap, request) {
   return resolved.handler(request.input, context);
 }
 
+// src/spend.ts
+function toGranularHttpBase(apiUrl) {
+  const url = new URL(apiUrl);
+  if (url.protocol === "ws:") {
+    url.protocol = "http:";
+  } else if (url.protocol === "wss:") {
+    url.protocol = "https:";
+  }
+  url.pathname = url.pathname.replace(/\/ws\/connect$/, "").replace(/\/ws$/, "");
+  if (!url.pathname || url.pathname === "/") {
+    url.pathname = "/granular";
+  }
+  url.search = "";
+  url.hash = "";
+  return url.toString().replace(/\/$/, "");
+}
+function cleanIdPart(value) {
+  return value.replace(/[^a-zA-Z0-9_-]+/g, "_").replace(/^_+|_+$/g, "");
+}
+function buildOpenAISpendEventId(usage, context = {}) {
+  const requestId = usage.requestId?.trim();
+  if (!requestId) return void 0;
+  const scope = context.sessionId || context.environmentId || context.subjectId || context.sandboxId || "global";
+  return ["spend", "openai", scope, requestId].map(cleanIdPart).join("_");
+}
+function pricingEffectiveAtSeconds(value) {
+  if (!value) return null;
+  const parsed = Date.parse(value);
+  return Number.isFinite(parsed) ? Math.floor(parsed / 1e3) : null;
+}
+function compactContext(context) {
+  return Object.fromEntries(
+    Object.entries(context).filter(
+      ([, value]) => value != null && value !== ""
+    )
+  );
+}
+function omitTenantId(context) {
+  const scopedContext = { ...context };
+  delete scopedContext.tenantId;
+  return scopedContext;
+}
+async function recordOpenAIUsageSpend(options) {
+  const usageContext = compactContext({
+    ...options.usage.usageContext || {},
+    ...options.context || {}
+  });
+  const context = omitTenantId(usageContext);
+  const spendEventId = options.usage.spendEventId || buildOpenAISpendEventId(options.usage, context);
+  const metadata = {
+    ...options.metadata || {},
+    ...options.usage.rawUsage !== void 0 ? { openaiUsage: options.usage.rawUsage } : {},
+    usageContext: context
+  };
+  const response = await fetch(
+    `${toGranularHttpBase(options.apiUrl)}/control/spend/events`,
+    {
+      method: "POST",
+      cache: "no-store",
+      headers: {
+        Authorization: `Bearer ${options.token}`,
+        "Content-Type": "application/json"
+      },
+      body: JSON.stringify({
+        ...spendEventId ? { spendEventId } : {},
+        sandboxId: context.sandboxId || null,
+        environmentId: context.environmentId || null,
+        sessionId: context.sessionId || null,
+        subjectId: context.subjectId || null,
+        permissionProfileId: context.permissionProfileId || null,
+        source: "openai",
+        lineItemType: "llm_tokens",
+        provider: options.usage.provider,
+        model: options.usage.model,
+        operation: options.usage.operation || "chat.completions",
+        requestId: options.usage.requestId || null,
+        inputTokens: options.usage.inputTokens,
+        outputTokens: options.usage.outputTokens,
+        cachedInputTokens: options.usage.cachedInputTokens,
+        reasoningTokens: options.usage.reasoningTokens,
+        quantity: options.usage.totalTokens,
+        quantityUnit: "tokens",
+        inputPricePerMillionMicros: options.usage.inputPricePerMillionMicros,
+        cachedInputPricePerMillionMicros: options.usage.cachedInputPricePerMillionMicros,
+        outputPricePerMillionMicros: options.usage.outputPricePerMillionMicros,
+        amountMicros: options.usage.amountMicros,
+        currency: options.usage.currency,
+        pricingSource: options.usage.pricingSource,
+        pricingEffectiveAt: pricingEffectiveAtSeconds(
+          options.usage.pricingEffectiveAt
+        ),
+        estimated: false,
+        metadata
+      })
+    }
+  );
+  if (!response.ok) {
+    throw new Error(
+      `Granular spend event failed (${response.status}): ${await response.text()}`
+    );
+  }
+  return response.json();
+}
+
 // ../metamodel-enum/src/index.ts
 function renderInlineStringUnion(values) {
   return values.map((value) => JSON.stringify(value)).join(" | ");
@@ -14108,7 +14224,7 @@ var EnvironmentSession = class extends Session {
   /** The last known graph container status, updated by checkReadiness() or on heartbeat */
   graphContainerStatus = null;
   constructor(client, environment, clientId, options = {}) {
-    super(client, clientId);
+    super(client, clientId, { initialQuota: options.initialQuota });
     this.environment = environment;
     this.sessionDataRoutePrefix = options.sessionDataRoutePrefix || "/orchestrator/ws/sessions";
   }
@@ -14907,6 +15023,15 @@ var Granular = class _Granular {
     const environment = this.bindEnvironmentHandle(envData);
     return this.bindWebSocketEnvironmentSession(environment, clientId, minted);
   }
+  async recordOpenAIUsageSpend(usage, context, options) {
+    return recordOpenAIUsageSpend({
+      apiUrl: this.apiUrl,
+      token: this.apiKey,
+      usage,
+      context,
+      metadata: options?.metadata
+    });
+  }
   /**
    * Mark a session closed in the control plane. If `environment` is the connected handle for that
    * `sessionId`, disconnects the WebSocket so the runtime tears down cleanly.
@@ -15061,7 +15186,8 @@ var Granular = class _Granular {
     const environmentSession = new EnvironmentSession(
       client,
       environment,
-      clientId
+      clientId,
+      { initialQuota: session.quota || null }
     );
     await environmentSession.hello();
     return environmentSession;
@@ -17600,9 +17726,105 @@ ${knownFactsBlock}
 ${input.request?.trim() || "Use the latest user message in the conversation."}`;
 }
 
+// src/openai-usage.ts
+var OPENAI_PRICING_SOURCE_URL = "https://developers.openai.com/api/docs/models/gpt-5.4/";
+var OPENAI_PRICING_EFFECTIVE_DATE = "2026-05-19";
+var OPENAI_MODEL_PRICING_USD_PER_MILLION = {
+  "gpt-5.4": {
+    provider: "openai",
+    model: "gpt-5.4",
+    currency: "USD",
+    inputUsdPerMillion: 2.5,
+    cachedInputUsdPerMillion: 0.25,
+    outputUsdPerMillion: 15,
+    sourceUrl: OPENAI_PRICING_SOURCE_URL,
+    effectiveDate: OPENAI_PRICING_EFFECTIVE_DATE
+  }
+};
+function asRecord5(value) {
+  return value && typeof value === "object" ? value : null;
+}
+function numberField(record, key) {
+  const value = record?.[key];
+  return typeof value === "number" && Number.isFinite(value) ? value : 0;
+}
+function microsPerMillion(usdPerMillion) {
+  return Math.round(usdPerMillion * 1e6);
+}
+function getOpenAIModelPricing(model) {
+  return OPENAI_MODEL_PRICING_USD_PER_MILLION[model] || null;
+}
+function normalizeOpenAIUsage(rawUsage) {
+  const usage = asRecord5(rawUsage);
+  if (!usage) {
+    return {
+      inputTokens: 0,
+      cachedInputTokens: 0,
+      uncachedInputTokens: 0,
+      outputTokens: 0,
+      reasoningTokens: 0,
+      totalTokens: 0
+    };
+  }
+  const inputTokens = numberField(usage, "prompt_tokens") || numberField(usage, "input_tokens");
+  const outputTokens = numberField(usage, "completion_tokens") || numberField(usage, "output_tokens");
+  const totalTokens = numberField(usage, "total_tokens") || inputTokens + outputTokens;
+  const inputDetails = asRecord5(usage.prompt_tokens_details) || asRecord5(usage.input_tokens_details);
+  const outputDetails = asRecord5(usage.completion_tokens_details) || asRecord5(usage.output_tokens_details);
+  const cachedInputTokens = Math.min(
+    inputTokens,
+    numberField(inputDetails, "cached_tokens") || numberField(inputDetails, "cached_input_tokens")
+  );
+  const reasoningTokens = numberField(outputDetails, "reasoning_tokens") || numberField(outputDetails, "reasoning_output_tokens");
+  return {
+    inputTokens,
+    cachedInputTokens,
+    uncachedInputTokens: Math.max(inputTokens - cachedInputTokens, 0),
+    outputTokens,
+    reasoningTokens,
+    totalTokens
+  };
+}
+function calculateOpenAITokenSpend(model, rawUsage) {
+  const pricing = getOpenAIModelPricing(model);
+  if (!pricing) return null;
+  const usage = normalizeOpenAIUsage(rawUsage);
+  const inputPricePerMillionMicros = microsPerMillion(
+    pricing.inputUsdPerMillion
+  );
+  const cachedInputPricePerMillionMicros = microsPerMillion(
+    pricing.cachedInputUsdPerMillion
+  );
+  const outputPricePerMillionMicros = microsPerMillion(
+    pricing.outputUsdPerMillion
+  );
+  const amountMicros = Math.round(
+    (usage.uncachedInputTokens * inputPricePerMillionMicros + usage.cachedInputTokens * cachedInputPricePerMillionMicros + usage.outputTokens * outputPricePerMillionMicros) / 1e6
+  );
+  return {
+    provider: "openai",
+    model,
+    inputTokens: usage.inputTokens,
+    cachedInputTokens: usage.cachedInputTokens,
+    uncachedInputTokens: usage.uncachedInputTokens,
+    outputTokens: usage.outputTokens,
+    reasoningTokens: usage.reasoningTokens,
+    totalTokens: usage.totalTokens,
+    amountMicros,
+    currency: "USD",
+    inputPricePerMillionMicros,
+    cachedInputPricePerMillionMicros,
+    outputPricePerMillionMicros,
+    pricingSource: pricing.sourceUrl,
+    pricingEffectiveAt: pricing.effectiveDate,
+    usage
+  };
+}
+
 exports.Environment = Environment;
 exports.EnvironmentSession = EnvironmentSession;
 exports.Granular = Granular;
+exports.OPENAI_MODEL_PRICING_USD_PER_MILLION = OPENAI_MODEL_PRICING_USD_PER_MILLION;
 exports.OntologyHandle = OntologyHandle;
 exports.Session = Session;
 exports.WSClient = WSClient;
@@ -17616,7 +17838,9 @@ exports.buildGranularAgentSessionBlock = buildGranularAgentSessionBlock;
 exports.buildGranularAgentSystemPrompt = buildGranularAgentSystemPrompt;
 exports.buildGranularAgentToolBlock = buildGranularAgentToolBlock;
 exports.buildGranularAgentWorkflowBlock = buildGranularAgentWorkflowBlock;
+exports.buildOpenAISpendEventId = buildOpenAISpendEventId;
 exports.buildSessionTranscript = buildSessionTranscript;
+exports.calculateOpenAITokenSpend = calculateOpenAITokenSpend;
 exports.consumeGranularReasoningOnlyChunk = consumeGranularReasoningOnlyChunk;
 exports.consumeGranularReasoningTraceChunk = consumeGranularReasoningTraceChunk;
 exports.createHarnessVerifierSnapshot = createHarnessVerifierSnapshot;
@@ -17624,10 +17848,12 @@ exports.evaluateContinuation = evaluateContinuation;
 exports.extractPromptTokens = extractPromptTokens;
 exports.getCurrentClosureId = getCurrentClosureId;
 exports.getExclusivePromptTarget = getExclusivePromptTarget;
+exports.getOpenAIModelPricing = getOpenAIModelPricing;
 exports.hasOpenPrompt = hasOpenPrompt;
 exports.invokeRegisteredEffect = invokeRegisteredEffect;
 exports.isLocalApiUrl = isLocalApiUrl;
 exports.normalizeEffectBehaviors = normalizeEffectBehaviors;
+exports.normalizeOpenAIUsage = normalizeOpenAIUsage;
 exports.normalizePrompt = normalizePrompt;
 exports.normalizePromptChoiceOption = normalizePromptChoiceOption;
 exports.normalizePromptText = normalizePromptText;
@@ -17638,6 +17864,7 @@ exports.projectHeapSummary = projectHeapSummary;
 exports.projectLoopSummary = projectLoopSummary;
 exports.projectWorkflowFocus = projectWorkflowFocus;
 exports.projectWorkflowSummary = projectWorkflowSummary;
+exports.recordOpenAIUsageSpend = recordOpenAIUsageSpend;
 exports.resolveApiUrl = resolveApiUrl;
 exports.resolveAuthTokenForApiUrl = resolveAuthTokenForApiUrl;
 exports.resolveJobPresentation = resolveJobPresentation;
@@ -17645,5 +17872,6 @@ exports.resolvePromptAnswer = resolvePromptAnswer;
 exports.reviewGeneratedJobCode = reviewGeneratedJobCode;
 exports.scorePromptChoiceMatch = scorePromptChoiceMatch;
 exports.stripGranularReasoningTrace = stripGranularReasoningTrace;
+exports.toGranularHttpBase = toGranularHttpBase;
 //# sourceMappingURL=index.js.map
 //# sourceMappingURL=index.js.map