@granular-software/sdk 0.4.50 → 0.4.51

package/dist/{spend-RpJikX9w.d.mts → spend-BA-jZwZ0.d.mts}

@@ -256,6 +256,13 @@ interface ConnectOptions extends OpenEnvironmentOptions {
 interface CreateSessionOptions {
     /** Optional stable client ID. Defaults to `client_${Date.now()}`. */
     clientId?: string;
+    /**
+     * Optional application-owned history scope for this conversation.
+     *
+     * Use the same value when listing sessions or reading the materialized user
+     * environment state so unrelated product surfaces never share history.
+     */
+    sessionScope?: string;
     /**
      * Optional session heap seed. Each item uses application record identity:
      * class name plus the record id from the customer's own system. Granular
@@ -285,6 +292,23 @@ interface ConversationSessionInfo {
     jobCount?: number;
     toolCallCount?: number;
 }
+type ConversationSessionListStatus = ConversationSessionInfo["status"] | "all";
+/**
+ * Bounded filters for indexed conversation history.
+ *
+ * At least one ownership filter (`environmentId`, `sandboxId`, or
+ * `subjectId`) is required by the SDK. Results are newest-first and default to
+ * 100 rows; use `offset` to request the next page.
+ */
+interface ConversationSessionListOptions {
+    environmentId?: string;
+    sandboxId?: string;
+    subjectId?: string;
+    sessionScope?: string | null;
+    status?: ConversationSessionListStatus;
+    limit?: number;
+    offset?: number;
+}
 type SpendLineItemType = "llm_tokens" | "granular_session_time" | string;
 type QuotaScopeType = "tenant" | "sandbox" | "permission_profile" | "subject";
 type QuotaPeriod = "hour" | "day" | "week" | "month";
@@ -893,6 +917,10 @@ interface Job {
 }
 interface Prompt {
     id: string;
+    /** Job that owns this prompt, when it was opened by a running job. */
+    jobId?: string;
+    /** Harness turn that owns this prompt. */
+    turnId?: string;
     type: "confirm" | "choice" | "input";
     title: string;
     message: string;
@@ -913,6 +941,33 @@ interface ConversationMessageShowRefs {
     fileIds?: string[];
     sessionArtifactIds?: string[];
     actionSuggestions?: ConversationActionSuggestion[];
+    tables?: ConversationTableProjection[];
+}
+type ConversationTableCell = string | number | boolean | null | {
+    kind: "relative_time" | "date";
+    value: string | number;
+};
+interface ConversationTableColumn {
+    id: string;
+    label: string;
+}
+interface ConversationTableRowReference {
+    entryPath?: string;
+    className?: string;
+    id?: string;
+    label?: string;
+}
+interface ConversationTableRow {
+    id: string;
+    reference?: ConversationTableRowReference;
+    cells: ConversationTableCell[];
+}
+interface ConversationTableProjection {
+    id: string;
+    label?: string;
+    source?: string;
+    columns: ConversationTableColumn[];
+    rows: ConversationTableRow[];
 }
 interface ConversationActionSuggestion {
     suggestionId?: string;
@@ -922,13 +977,35 @@ interface ConversationActionSuggestion {
     target?: Record<string, unknown> | null;
     metadata?: Record<string, unknown>;
 }
+/** A normalized action embedded in an ordered assistant message stream. */
+interface ConversationMessageAction {
+    kind: "frontend" | "backend" | "system";
+    label: string;
+    status?: "done" | "queued" | "failed";
+}
+/**
+ * A durable assistant message segment in the order it reached the client.
+ *
+ * `content` and `actions` remain the canonical compatibility fields on the
+ * message. Parts only preserve their interleaving for capable clients.
+ */
+type ConversationMessagePart = {
+    type: "text";
+    text: string;
+} | {
+    type: "action";
+    action: ConversationMessageAction;
+};
 interface ConversationMessageInput {
+    /** Optional caller-owned id used to correlate optimistic and durable turns. */
+    id?: string;
     role: "user" | "assistant";
     content?: string;
     show?: ConversationMessageShowRefs;
     reasoningLines?: string[];
     reasoningDurationMs?: number;
     actions?: Array<Record<string, unknown>>;
+    parts?: ConversationMessagePart[];
     target?: Record<string, unknown>;
     jobId?: string;
     promptId?: string;
@@ -949,6 +1026,7 @@ interface SessionConversationMessage {
     reasoningLines?: string[];
     reasoningDurationMs?: number;
     actions?: Array<Record<string, unknown>>;
+    parts?: ConversationMessagePart[];
     target?: Record<string, unknown>;
     jobId?: string;
     promptId?: string;
@@ -998,6 +1076,25 @@ interface SessionFileRecord {
 }
 type SessionArtifactStatus = "draft" | "ready" | "needs_edit" | "blocked" | "running" | "awaiting_human" | "completed" | "partially_completed" | "failed" | "canceled" | "stale";
 type SessionArtifactKind = "effect" | "batch" | "state_path";
+/**
+ * Declarative impact metadata consumed by deterministic clients before an
+ * artifact can execute. Missing metadata must be treated conservatively.
+ */
+interface SessionArtifactAutonomyPolicy {
+    sideEffect?: "read" | "readonly" | "read_only" | "ui" | "write" | "delete" | "destructive" | "irreversible";
+    scope?: "internal" | "bulk" | "external" | "financial" | "permission";
+    risk?: "low" | "medium" | "high";
+    targetCount?: number;
+    reversible?: boolean;
+    destructive?: boolean;
+    external?: boolean;
+    financial?: boolean;
+    permissionChange?: boolean;
+    reverse?: string | Record<string, unknown>;
+    undo?: string | Record<string, unknown>;
+    rollback?: string | Record<string, unknown>;
+    [key: string]: unknown;
+}
 interface SessionArtifactRecord {
     artifactId: string;
     sessionId?: string | null;
@@ -1023,8 +1120,10 @@ interface SessionArtifactRecord {
     } | null;
     relationships?: Record<string, string | string[] | null>;
     validation?: Record<string, unknown> | null;
-    policy?: Record<string, unknown> | null;
-    metadata?: Record<string, unknown>;
+    policy?: SessionArtifactAutonomyPolicy | null;
+    metadata?: Record<string, unknown> & {
+        autonomy?: SessionArtifactAutonomyPolicy;
+    };
     parentArtifactId?: string | null;
     subArtifactIds?: string[];
     createdAt: number;
@@ -1274,6 +1373,8 @@ interface SessionTranscriptEntry {
     jobResultPreview?: string;
     error?: string;
     show?: ConversationMessageShowRefs;
+    actions?: ConversationMessageAction[];
+    parts?: ConversationMessagePart[];
     historyContent?: string;
     source: "conversation" | "job_code" | "job_result" | "job_prompt" | "job_agent_message";
 }
@@ -1344,6 +1445,8 @@ interface SessionDocumentResult {
 interface SessionCollectionListOptions {
     limit?: number;
     cursor?: string | null;
+    /** Return only the newest page, in chronological order. */
+    latest?: boolean | null;
 }
 interface SessionJobListOptions extends SessionCollectionListOptions {
     status?: string | null;
@@ -1393,6 +1496,8 @@ interface UserEnvironmentState {
     tenantId?: string;
     sessionScope?: string | null;
     updatedAt: number;
+    /** Monotonic materialized-index revision used for conditional refreshes. */
+    revision?: number;
     stateSource?: "user_environment_snapshot" | "live_session_aggregate";
     stale?: boolean;
     snapshotUpdatedAt?: number | null;
@@ -1434,6 +1539,7 @@ interface WSClientOptions {
     url: string;
     sessionId: string;
     token: string;
+    initialDocumentSnapshot?: Record<string, unknown> | Uint8Array | null;
     tokenProvider?: AccessTokenProvider;
     WebSocketCtor?: any;
     maxReconnectAttempts?: number;
@@ -2082,13 +2188,23 @@ interface OpenAIModelPricing {
     currency: "USD";
     inputUsdPerMillion: number;
     cachedInputUsdPerMillion: number;
+    cacheWriteUsdPerMillion?: number | null;
     outputUsdPerMillion: number;
+    contextTier?: "short" | "long";
+    longContextThresholdTokens?: number | null;
+    longContextPricing?: {
+        inputUsdPerMillion: number;
+        cachedInputUsdPerMillion: number;
+        cacheWriteUsdPerMillion?: number | null;
+        outputUsdPerMillion: number;
+    };
     sourceUrl: string;
     effectiveDate: string;
 }
 interface NormalizedOpenAIUsage {
     inputTokens: number;
     cachedInputTokens: number;
+    cacheWriteTokens: number;
     uncachedInputTokens: number;
     outputTokens: number;
     reasoningTokens: number;
@@ -2099,6 +2215,7 @@ interface OpenAITokenSpend {
     model: string;
     inputTokens: number;
     cachedInputTokens: number;
+    cacheWriteTokens: number;
     uncachedInputTokens: number;
     outputTokens: number;
     reasoningTokens: number;
@@ -2107,13 +2224,17 @@ interface OpenAITokenSpend {
     currency: "USD";
     inputPricePerMillionMicros: number;
     cachedInputPricePerMillionMicros: number;
+    cacheWritePricePerMillionMicros: number | null;
+    cacheWriteCostMicros: number;
     outputPricePerMillionMicros: number;
+    pricingContextTier: "short" | "long";
+    longContextThresholdTokens: number | null;
     pricingSource: string;
     pricingEffectiveAt: string;
     usage: NormalizedOpenAIUsage;
 }
 declare const OPENAI_MODEL_PRICING_USD_PER_MILLION: Record<string, OpenAIModelPricing>;
-declare function getOpenAIModelPricing(model: string): OpenAIModelPricing | null;
+declare function getOpenAIModelPricing(model: string, inputTokens?: number): OpenAIModelPricing | null;
 declare function normalizeOpenAIUsage(rawUsage: unknown): NormalizedOpenAIUsage;
 declare function calculateOpenAITokenSpend(model: string, rawUsage: unknown): OpenAITokenSpend | null;
 
@@ -2151,4 +2272,4 @@ declare function toGranularHttpBase(apiUrl: string): string;
 declare function buildOpenAISpendEventId(usage: Pick<OpenAIUsageSpendEvent, "requestId">, context?: GranularSpendContext): string | undefined;
 declare function recordOpenAIUsageSpend(options: RecordOpenAIUsageSpendOptions): Promise<RecordOpenAIUsageSpendResult>;
 
-export { type GranularQuotaProgress as $, type AccessTokenProvider as A, type RecordUserOptions as B, type ConditionIR as C, type DomainState as D, type EndpointMode as E, type Subject as F, type GranularSpendContext as G, type OpenEnvironmentOptions as H, type InstanceToolHandler as I, type ConnectOptions as J, type CreateSessionOptions as K, type ConversationSessionInfo as L, type ManifestEffectMetamodelSpec as M, type NormalizedOpenAIUsage as N, type OpenAIModelPricing as O, type Prompt as P, type SpendLineItemType as Q, type ResolvedEffectBehaviors as R, type SessionHeapEntry as S, type ToolWithHandler as T, type User as U, type QuotaScopeType as V, type QuotaPeriod as W, type QuotaStatus as X, type SpendSummary as Y, type QuotaLineItemFilter as Z, type GranularQuotaPolicy as _, type EffectHandlerContext as a, type SessionArtifactExecutionResult as a$, type Sandbox as a0, type CreateSandboxData as a1, type SandboxListResponse as a2, type PermissionRules as a3, type PermissionProfile as a4, type CreatePermissionProfileData as a5, type PermissionProfileListResponse as a6, type Assignment as a7, type AssignmentListResponse as a8, type BuildPolicy as a9, type EffectsChangedEvent as aA, type EffectHandler as aB, type InstanceEffectHandler as aC, type JobStatus as aD, type JobFeedbackSentiment as aE, type JobFeedbackToolCall as aF, type JobFeedbackMetadata as aG, type JobFeedbackInput as aH, type JobFeedbackRecord as aI, type EnvironmentFeedbackRecord as aJ, type JobSubmitResult as aK, type Job as aL, type ConversationMessageShowRefs as aM, type ConversationActionSuggestion as aN, type ConversationMessageInput as aO, type ConversationAppendResult as aP, type SessionConversationMessage as aQ, type SessionTimelineEvent as aR, type SessionFileSource as aS, type SessionFileKind as aT, type SessionFileStatus as aU, type SessionFileRecord as aV, type SessionArtifactStatus as aW, type SessionArtifactKind as aX, type SessionArtifactRecord as aY, type SessionArtifactListOptions as aZ, type SessionArtifactValidationResult as a_, type VersionTracking as aa, type VersionTag as ab, type EnvironmentData as ac, type CreateEnvironmentData as ad, type EnvironmentListResponse as ae, type Manifest as af, type ManifestListResponse as ag, type BuildStatus as ah, type Build as ai, type Version as aj, type BuildListResponse as ak, type SemanticVersionDiffEntry as al, type SemanticVersionDiff as am, type ResolvedEffectPostCondition as an, type ResolvedEffectDryRun as ao, type ResolvedEffectReverse as ap, type ResolvedEffectApprovalRequired as aq, type EffectInvocationMode as ar, type EffectInvocationMetadata as as, type EffectSchema as at, type EffectWithHandler as au, type PublishEffectsResult as av, type EffectVersionSelector as aw, type ToolInfo as ax, type EffectInfo as ay, type ToolsChangedEvent as az, type SessionHeapList as b, type RecordImport as b$, type SessionArtifactExecutionOptions as b0, type SessionArtifactApprovalOptions as b1, type ArtifactApprovalTaskStatus as b2, type ArtifactApprovalTask as b3, type ArtifactApprovalTaskListOptions as b4, type ArtifactApprovalDecisionInput as b5, type ArtifactApprovalDecisionResult as b6, type ManualActionStatus as b7, type ManualActionSource as b8, type ManualActionTarget as b9, type WSReconnectErrorInfo as bA, type WSClientOptions as bB, type RPCRequest as bC, type RPCResponse as bD, type SyncMessage as bE, type RPCRequestFromServer as bF, type ToolInvokeParams as bG, type ToolResultParams as bH, type ModelRef as bI, type RelationshipInfo as bJ, type DefineRelationshipOptions as bK, type RecordObjectOptions as bL, type RecordObjectStateValue as bM, type EnvironmentStateTarget as bN, type EnvironmentStateObservationInput as bO, type EnvironmentStateUpdateInput as bP, type EnvironmentStateMachineProxy as bQ, type EnvironmentStateProxy as bR, type RecordObjectResult as bS, type RecordObjectsChunkInfo as bT, type RecordObjectsOptions as bU, type RecordImportWriteMode as bV, type RecordImportOptions as bW, type RecordImportStatus as bX, type RecordImportItemStatus as bY, type RecordImportStats as bZ, type RecordImportItem as b_, type ManualActionRelatedRecord as ba, type RecordManualActionInput as bb, type ManualActionOccurrence as bc, type ManualActionRecordResult as bd, type ManualActionListOptions as be, type ManualActionSuggestion as bf, type ManualActionSuggestionOptions as bg, type SessionFileUploadOptions as bh, type SessionJobRecord as bi, type SessionHeapFieldType as bj, type SessionHeapFieldValue as bk, type SessionHeapVariable as bl, type RecordSearchResult as bm, type RecordSearchOptions as bn, type RecordMentionInput as bo, type SessionDocumentResult as bp, type SessionCollectionListOptions as bq, type SessionJobListOptions as br, type SessionCollectionListResult as bs, type UserEnvironmentPrompt as bt, type UserEnvironmentMessagePreview as bu, type UserEnvironmentSessionState as bv, type UserEnvironmentState as bw, type UserEnvironmentStateOptions as bx, type MarkUserEnvironmentReadOptions as by, type WSDisconnectInfo as bz, type SessionHeapSnapshot as c, type EnvironmentRecordImportSummary as c0, type EnvironmentSetupTriggerReason as c1, type RunEnvironmentImporterOptions as c2, type EnvironmentSetupLifecycleStatus as c3, type EnvironmentSetupSummary as c4, type EnvironmentImporterImportOptions as c5, type EnvironmentImporter as c6, type ManifestPropertySpec as c7, type ManifestValidationOperator as c8, type ManifestEnumRuleSpec as c9, type GraphQLResult as cA, type APIError as cB, type DeleteResponse as cC, type StreamEvent as cD, type StreamSubscription as cE, type StreamStats as cF, type ManifestFilterBySpec as ca, type ManifestValidationRuleSpec as cb, type ManifestStateMachineStateSpec as cc, type ManifestStateTransitionInputBinding as cd, type ManifestStateTransitionActionSpec as ce, type ManifestStateTransitionAssigneeSpec as cf, type ManifestStateTransitionRelatedStateRequirementSpec as cg, type ManifestStateTransitionRequirementsSpec as ch, type ManifestStateTransitionPermissionSpec as ci, type ManifestStateTransitionExpectedOutcomeSpec as cj, type ManifestStateMachineTransitionSpec as ck, type ManifestStateMachineSpec as cl, type ManifestPostConditionSpec as cm, type ManifestDryRunSpec as cn, type ManifestReverseSpec as co, type ManifestApprovalRequiredSpec as cp, type ManifestCreatesSpec as cq, type ManifestRelationshipDef as cr, type ManifestEffectSchema as cs, type ManifestEffectDeclaration as ct, type ManifestEventTypeDef as cu, type ManifestEventStreamDef as cv, type ManifestOperation as cw, type ManifestImport as cx, type ManifestVolume as cy, type ManifestContent as cz, type SessionTranscriptEntry as d, type ToolSchema as e, type PublishToolsResult as f, type ToolHandler as g, type OpenAITokenSpend as h, OPENAI_MODEL_PRICING_USD_PER_MILLION as i, getOpenAIModelPricing as j, calculateOpenAITokenSpend as k, type OpenAIUsageSpendEvent as l, type RecordOpenAIUsageSpendOptions as m, normalizeOpenAIUsage as n, type RecordOpenAIUsageSpendResult as o, buildOpenAISpendEventId as p, type PolicySource as q, recordOpenAIUsageSpend as r, type PolicyPredicateSource as s, toGranularHttpBase as t, type PolicyOperator as u, type PolicyOrigin as v, type PolicyRuleIR as w, type MatchedPolicy as x, type GranularOptions as y, type GranularAuth as z };
+export { type QuotaLineItemFilter as $, type AccessTokenProvider as A, type RecordUserOptions as B, type ConditionIR as C, type DomainState as D, type EndpointMode as E, type Subject as F, type GranularSpendContext as G, type OpenEnvironmentOptions as H, type InstanceToolHandler as I, type ConnectOptions as J, type CreateSessionOptions as K, type ConversationSessionInfo as L, type ManifestEffectMetamodelSpec as M, type NormalizedOpenAIUsage as N, type OpenAIModelPricing as O, type Prompt as P, type ConversationSessionListStatus as Q, type ResolvedEffectBehaviors as R, type SessionHeapEntry as S, type ToolWithHandler as T, type User as U, type ConversationSessionListOptions as V, type SpendLineItemType as W, type QuotaScopeType as X, type QuotaPeriod as Y, type QuotaStatus as Z, type SpendSummary as _, type EffectHandlerContext as a, type SessionFileSource as a$, type GranularQuotaPolicy as a0, type GranularQuotaProgress as a1, type Sandbox as a2, type CreateSandboxData as a3, type SandboxListResponse as a4, type PermissionRules as a5, type PermissionProfile as a6, type CreatePermissionProfileData as a7, type PermissionProfileListResponse as a8, type Assignment as a9, 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 ConversationTableCell as aP, type ConversationTableColumn as aQ, type ConversationTableRowReference as aR, type ConversationTableRow as aS, type ConversationTableProjection as aT, type ConversationActionSuggestion as aU, type ConversationMessageAction as aV, type ConversationMessagePart as aW, type ConversationMessageInput as aX, type ConversationAppendResult as aY, type SessionConversationMessage as aZ, type SessionTimelineEvent as a_, type AssignmentListResponse as aa, type BuildPolicy as ab, type VersionTracking as ac, type VersionTag as ad, type EnvironmentData as ae, type CreateEnvironmentData as af, type EnvironmentListResponse as ag, type Manifest as ah, type ManifestListResponse as ai, type BuildStatus as aj, type Build as ak, type Version as al, type BuildListResponse as am, type SemanticVersionDiffEntry as an, type SemanticVersionDiff as ao, type ResolvedEffectPostCondition as ap, type ResolvedEffectDryRun as aq, type ResolvedEffectReverse as ar, type ResolvedEffectApprovalRequired as as, type EffectInvocationMode as at, type EffectInvocationMetadata as au, type EffectSchema as av, type EffectWithHandler as aw, type PublishEffectsResult as ax, type EffectVersionSelector as ay, type ToolInfo as az, type SessionHeapList as b, type EnvironmentStateProxy as b$, type SessionFileKind as b0, type SessionFileStatus as b1, type SessionFileRecord as b2, type SessionArtifactStatus as b3, type SessionArtifactKind as b4, type SessionArtifactAutonomyPolicy as b5, type SessionArtifactRecord as b6, type SessionArtifactListOptions as b7, type SessionArtifactValidationResult as b8, type SessionArtifactExecutionResult as b9, type SessionCollectionListOptions as bA, type SessionJobListOptions as bB, type SessionCollectionListResult as bC, type UserEnvironmentPrompt as bD, type UserEnvironmentMessagePreview as bE, type UserEnvironmentSessionState as bF, type UserEnvironmentState as bG, type UserEnvironmentStateOptions as bH, type MarkUserEnvironmentReadOptions as bI, type WSDisconnectInfo as bJ, type WSReconnectErrorInfo as bK, type WSClientOptions as bL, type RPCRequest as bM, type RPCResponse as bN, type SyncMessage as bO, type RPCRequestFromServer as bP, type ToolInvokeParams as bQ, type ToolResultParams as bR, type ModelRef as bS, type RelationshipInfo as bT, type DefineRelationshipOptions as bU, type RecordObjectOptions as bV, type RecordObjectStateValue as bW, type EnvironmentStateTarget as bX, type EnvironmentStateObservationInput as bY, type EnvironmentStateUpdateInput as bZ, type EnvironmentStateMachineProxy as b_, type SessionArtifactExecutionOptions as ba, type SessionArtifactApprovalOptions as bb, type ArtifactApprovalTaskStatus as bc, type ArtifactApprovalTask as bd, type ArtifactApprovalTaskListOptions as be, type ArtifactApprovalDecisionInput as bf, type ArtifactApprovalDecisionResult as bg, type ManualActionStatus as bh, type ManualActionSource as bi, type ManualActionTarget as bj, type ManualActionRelatedRecord as bk, type RecordManualActionInput as bl, type ManualActionOccurrence as bm, type ManualActionRecordResult as bn, type ManualActionListOptions as bo, type ManualActionSuggestion as bp, type ManualActionSuggestionOptions as bq, type SessionFileUploadOptions as br, type SessionJobRecord as bs, type SessionHeapFieldType as bt, type SessionHeapFieldValue as bu, type SessionHeapVariable as bv, type RecordSearchResult as bw, type RecordSearchOptions as bx, type RecordMentionInput as by, type SessionDocumentResult as bz, type SessionHeapSnapshot as c, type RecordObjectResult as c0, type RecordObjectsChunkInfo as c1, type RecordObjectsOptions as c2, type RecordImportWriteMode as c3, type RecordImportOptions as c4, type RecordImportStatus as c5, type RecordImportItemStatus as c6, type RecordImportStats as c7, type RecordImportItem as c8, type RecordImport as c9, type ManifestCreatesSpec as cA, type ManifestRelationshipDef as cB, type ManifestEffectSchema as cC, type ManifestEffectDeclaration as cD, type ManifestEventTypeDef as cE, type ManifestEventStreamDef as cF, type ManifestOperation as cG, type ManifestImport as cH, type ManifestVolume as cI, type ManifestContent as cJ, type GraphQLResult as cK, type APIError as cL, type DeleteResponse as cM, type StreamEvent as cN, type StreamSubscription as cO, type StreamStats as cP, type EnvironmentRecordImportSummary as ca, type EnvironmentSetupTriggerReason as cb, type RunEnvironmentImporterOptions as cc, type EnvironmentSetupLifecycleStatus as cd, type EnvironmentSetupSummary as ce, type EnvironmentImporterImportOptions as cf, type EnvironmentImporter as cg, type ManifestPropertySpec as ch, type ManifestValidationOperator as ci, type ManifestEnumRuleSpec as cj, type ManifestFilterBySpec as ck, type ManifestValidationRuleSpec as cl, type ManifestStateMachineStateSpec as cm, type ManifestStateTransitionInputBinding as cn, type ManifestStateTransitionActionSpec as co, type ManifestStateTransitionAssigneeSpec as cp, type ManifestStateTransitionRelatedStateRequirementSpec as cq, type ManifestStateTransitionRequirementsSpec as cr, type ManifestStateTransitionPermissionSpec as cs, type ManifestStateTransitionExpectedOutcomeSpec as ct, type ManifestStateMachineTransitionSpec as cu, type ManifestStateMachineSpec as cv, type ManifestPostConditionSpec as cw, type ManifestDryRunSpec as cx, type ManifestReverseSpec as cy, type ManifestApprovalRequiredSpec as cz, type SessionTranscriptEntry as d, type ToolSchema as e, type PublishToolsResult as f, type ToolHandler as g, type OpenAITokenSpend as h, OPENAI_MODEL_PRICING_USD_PER_MILLION as i, getOpenAIModelPricing as j, calculateOpenAITokenSpend as k, type OpenAIUsageSpendEvent as l, type RecordOpenAIUsageSpendOptions as m, normalizeOpenAIUsage as n, type RecordOpenAIUsageSpendResult as o, buildOpenAISpendEventId as p, type PolicySource as q, recordOpenAIUsageSpend as r, type PolicyPredicateSource as s, toGranularHttpBase as t, type PolicyOperator as u, type PolicyOrigin as v, type PolicyRuleIR as w, type MatchedPolicy as x, type GranularOptions as y, type GranularAuth as z };

package/dist/{spend-RpJikX9w.d.ts → spend-BA-jZwZ0.d.ts}

@@ -256,6 +256,13 @@ interface ConnectOptions extends OpenEnvironmentOptions {
 interface CreateSessionOptions {
     /** Optional stable client ID. Defaults to `client_${Date.now()}`. */
     clientId?: string;
+    /**
+     * Optional application-owned history scope for this conversation.
+     *
+     * Use the same value when listing sessions or reading the materialized user
+     * environment state so unrelated product surfaces never share history.
+     */
+    sessionScope?: string;
     /**
      * Optional session heap seed. Each item uses application record identity:
      * class name plus the record id from the customer's own system. Granular
@@ -285,6 +292,23 @@ interface ConversationSessionInfo {
     jobCount?: number;
     toolCallCount?: number;
 }
+type ConversationSessionListStatus = ConversationSessionInfo["status"] | "all";
+/**
+ * Bounded filters for indexed conversation history.
+ *
+ * At least one ownership filter (`environmentId`, `sandboxId`, or
+ * `subjectId`) is required by the SDK. Results are newest-first and default to
+ * 100 rows; use `offset` to request the next page.
+ */
+interface ConversationSessionListOptions {
+    environmentId?: string;
+    sandboxId?: string;
+    subjectId?: string;
+    sessionScope?: string | null;
+    status?: ConversationSessionListStatus;
+    limit?: number;
+    offset?: number;
+}
 type SpendLineItemType = "llm_tokens" | "granular_session_time" | string;
 type QuotaScopeType = "tenant" | "sandbox" | "permission_profile" | "subject";
 type QuotaPeriod = "hour" | "day" | "week" | "month";
@@ -893,6 +917,10 @@ interface Job {
 }
 interface Prompt {
     id: string;
+    /** Job that owns this prompt, when it was opened by a running job. */
+    jobId?: string;
+    /** Harness turn that owns this prompt. */
+    turnId?: string;
     type: "confirm" | "choice" | "input";
     title: string;
     message: string;
@@ -913,6 +941,33 @@ interface ConversationMessageShowRefs {
     fileIds?: string[];
     sessionArtifactIds?: string[];
     actionSuggestions?: ConversationActionSuggestion[];
+    tables?: ConversationTableProjection[];
+}
+type ConversationTableCell = string | number | boolean | null | {
+    kind: "relative_time" | "date";
+    value: string | number;
+};
+interface ConversationTableColumn {
+    id: string;
+    label: string;
+}
+interface ConversationTableRowReference {
+    entryPath?: string;
+    className?: string;
+    id?: string;
+    label?: string;
+}
+interface ConversationTableRow {
+    id: string;
+    reference?: ConversationTableRowReference;
+    cells: ConversationTableCell[];
+}
+interface ConversationTableProjection {
+    id: string;
+    label?: string;
+    source?: string;
+    columns: ConversationTableColumn[];
+    rows: ConversationTableRow[];
 }
 interface ConversationActionSuggestion {
     suggestionId?: string;
@@ -922,13 +977,35 @@ interface ConversationActionSuggestion {
     target?: Record<string, unknown> | null;
     metadata?: Record<string, unknown>;
 }
+/** A normalized action embedded in an ordered assistant message stream. */
+interface ConversationMessageAction {
+    kind: "frontend" | "backend" | "system";
+    label: string;
+    status?: "done" | "queued" | "failed";
+}
+/**
+ * A durable assistant message segment in the order it reached the client.
+ *
+ * `content` and `actions` remain the canonical compatibility fields on the
+ * message. Parts only preserve their interleaving for capable clients.
+ */
+type ConversationMessagePart = {
+    type: "text";
+    text: string;
+} | {
+    type: "action";
+    action: ConversationMessageAction;
+};
 interface ConversationMessageInput {
+    /** Optional caller-owned id used to correlate optimistic and durable turns. */
+    id?: string;
     role: "user" | "assistant";
     content?: string;
     show?: ConversationMessageShowRefs;
     reasoningLines?: string[];
     reasoningDurationMs?: number;
     actions?: Array<Record<string, unknown>>;
+    parts?: ConversationMessagePart[];
     target?: Record<string, unknown>;
     jobId?: string;
     promptId?: string;
@@ -949,6 +1026,7 @@ interface SessionConversationMessage {
     reasoningLines?: string[];
     reasoningDurationMs?: number;
     actions?: Array<Record<string, unknown>>;
+    parts?: ConversationMessagePart[];
     target?: Record<string, unknown>;
     jobId?: string;
     promptId?: string;
@@ -998,6 +1076,25 @@ interface SessionFileRecord {
 }
 type SessionArtifactStatus = "draft" | "ready" | "needs_edit" | "blocked" | "running" | "awaiting_human" | "completed" | "partially_completed" | "failed" | "canceled" | "stale";
 type SessionArtifactKind = "effect" | "batch" | "state_path";
+/**
+ * Declarative impact metadata consumed by deterministic clients before an
+ * artifact can execute. Missing metadata must be treated conservatively.
+ */
+interface SessionArtifactAutonomyPolicy {
+    sideEffect?: "read" | "readonly" | "read_only" | "ui" | "write" | "delete" | "destructive" | "irreversible";
+    scope?: "internal" | "bulk" | "external" | "financial" | "permission";
+    risk?: "low" | "medium" | "high";
+    targetCount?: number;
+    reversible?: boolean;
+    destructive?: boolean;
+    external?: boolean;
+    financial?: boolean;
+    permissionChange?: boolean;
+    reverse?: string | Record<string, unknown>;
+    undo?: string | Record<string, unknown>;
+    rollback?: string | Record<string, unknown>;
+    [key: string]: unknown;
+}
 interface SessionArtifactRecord {
     artifactId: string;
     sessionId?: string | null;
@@ -1023,8 +1120,10 @@ interface SessionArtifactRecord {
     } | null;
     relationships?: Record<string, string | string[] | null>;
     validation?: Record<string, unknown> | null;
-    policy?: Record<string, unknown> | null;
-    metadata?: Record<string, unknown>;
+    policy?: SessionArtifactAutonomyPolicy | null;
+    metadata?: Record<string, unknown> & {
+        autonomy?: SessionArtifactAutonomyPolicy;
+    };
     parentArtifactId?: string | null;
     subArtifactIds?: string[];
     createdAt: number;
@@ -1274,6 +1373,8 @@ interface SessionTranscriptEntry {
     jobResultPreview?: string;
     error?: string;
     show?: ConversationMessageShowRefs;
+    actions?: ConversationMessageAction[];
+    parts?: ConversationMessagePart[];
     historyContent?: string;
     source: "conversation" | "job_code" | "job_result" | "job_prompt" | "job_agent_message";
 }
@@ -1344,6 +1445,8 @@ interface SessionDocumentResult {
 interface SessionCollectionListOptions {
     limit?: number;
     cursor?: string | null;
+    /** Return only the newest page, in chronological order. */
+    latest?: boolean | null;
 }
 interface SessionJobListOptions extends SessionCollectionListOptions {
     status?: string | null;
@@ -1393,6 +1496,8 @@ interface UserEnvironmentState {
     tenantId?: string;
     sessionScope?: string | null;
     updatedAt: number;
+    /** Monotonic materialized-index revision used for conditional refreshes. */
+    revision?: number;
     stateSource?: "user_environment_snapshot" | "live_session_aggregate";
     stale?: boolean;
     snapshotUpdatedAt?: number | null;
@@ -1434,6 +1539,7 @@ interface WSClientOptions {
     url: string;
     sessionId: string;
     token: string;
+    initialDocumentSnapshot?: Record<string, unknown> | Uint8Array | null;
     tokenProvider?: AccessTokenProvider;
     WebSocketCtor?: any;
     maxReconnectAttempts?: number;
@@ -2082,13 +2188,23 @@ interface OpenAIModelPricing {
     currency: "USD";
     inputUsdPerMillion: number;
     cachedInputUsdPerMillion: number;
+    cacheWriteUsdPerMillion?: number | null;
     outputUsdPerMillion: number;
+    contextTier?: "short" | "long";
+    longContextThresholdTokens?: number | null;
+    longContextPricing?: {
+        inputUsdPerMillion: number;
+        cachedInputUsdPerMillion: number;
+        cacheWriteUsdPerMillion?: number | null;
+        outputUsdPerMillion: number;
+    };
     sourceUrl: string;
     effectiveDate: string;
 }
 interface NormalizedOpenAIUsage {
     inputTokens: number;
     cachedInputTokens: number;
+    cacheWriteTokens: number;
     uncachedInputTokens: number;
     outputTokens: number;
     reasoningTokens: number;
@@ -2099,6 +2215,7 @@ interface OpenAITokenSpend {
     model: string;
     inputTokens: number;
     cachedInputTokens: number;
+    cacheWriteTokens: number;
     uncachedInputTokens: number;
     outputTokens: number;
     reasoningTokens: number;
@@ -2107,13 +2224,17 @@ interface OpenAITokenSpend {
     currency: "USD";
     inputPricePerMillionMicros: number;
     cachedInputPricePerMillionMicros: number;
+    cacheWritePricePerMillionMicros: number | null;
+    cacheWriteCostMicros: number;
     outputPricePerMillionMicros: number;
+    pricingContextTier: "short" | "long";
+    longContextThresholdTokens: number | null;
     pricingSource: string;
     pricingEffectiveAt: string;
     usage: NormalizedOpenAIUsage;
 }
 declare const OPENAI_MODEL_PRICING_USD_PER_MILLION: Record<string, OpenAIModelPricing>;
-declare function getOpenAIModelPricing(model: string): OpenAIModelPricing | null;
+declare function getOpenAIModelPricing(model: string, inputTokens?: number): OpenAIModelPricing | null;
 declare function normalizeOpenAIUsage(rawUsage: unknown): NormalizedOpenAIUsage;
 declare function calculateOpenAITokenSpend(model: string, rawUsage: unknown): OpenAITokenSpend | null;
 
@@ -2151,4 +2272,4 @@ declare function toGranularHttpBase(apiUrl: string): string;
 declare function buildOpenAISpendEventId(usage: Pick<OpenAIUsageSpendEvent, "requestId">, context?: GranularSpendContext): string | undefined;
 declare function recordOpenAIUsageSpend(options: RecordOpenAIUsageSpendOptions): Promise<RecordOpenAIUsageSpendResult>;
 
-export { type GranularQuotaProgress as $, type AccessTokenProvider as A, type RecordUserOptions as B, type ConditionIR as C, type DomainState as D, type EndpointMode as E, type Subject as F, type GranularSpendContext as G, type OpenEnvironmentOptions as H, type InstanceToolHandler as I, type ConnectOptions as J, type CreateSessionOptions as K, type ConversationSessionInfo as L, type ManifestEffectMetamodelSpec as M, type NormalizedOpenAIUsage as N, type OpenAIModelPricing as O, type Prompt as P, type SpendLineItemType as Q, type ResolvedEffectBehaviors as R, type SessionHeapEntry as S, type ToolWithHandler as T, type User as U, type QuotaScopeType as V, type QuotaPeriod as W, type QuotaStatus as X, type SpendSummary as Y, type QuotaLineItemFilter as Z, type GranularQuotaPolicy as _, type EffectHandlerContext as a, type SessionArtifactExecutionResult as a$, type Sandbox as a0, type CreateSandboxData as a1, type SandboxListResponse as a2, type PermissionRules as a3, type PermissionProfile as a4, type CreatePermissionProfileData as a5, type PermissionProfileListResponse as a6, type Assignment as a7, type AssignmentListResponse as a8, type BuildPolicy as a9, type EffectsChangedEvent as aA, type EffectHandler as aB, type InstanceEffectHandler as aC, type JobStatus as aD, type JobFeedbackSentiment as aE, type JobFeedbackToolCall as aF, type JobFeedbackMetadata as aG, type JobFeedbackInput as aH, type JobFeedbackRecord as aI, type EnvironmentFeedbackRecord as aJ, type JobSubmitResult as aK, type Job as aL, type ConversationMessageShowRefs as aM, type ConversationActionSuggestion as aN, type ConversationMessageInput as aO, type ConversationAppendResult as aP, type SessionConversationMessage as aQ, type SessionTimelineEvent as aR, type SessionFileSource as aS, type SessionFileKind as aT, type SessionFileStatus as aU, type SessionFileRecord as aV, type SessionArtifactStatus as aW, type SessionArtifactKind as aX, type SessionArtifactRecord as aY, type SessionArtifactListOptions as aZ, type SessionArtifactValidationResult as a_, type VersionTracking as aa, type VersionTag as ab, type EnvironmentData as ac, type CreateEnvironmentData as ad, type EnvironmentListResponse as ae, type Manifest as af, type ManifestListResponse as ag, type BuildStatus as ah, type Build as ai, type Version as aj, type BuildListResponse as ak, type SemanticVersionDiffEntry as al, type SemanticVersionDiff as am, type ResolvedEffectPostCondition as an, type ResolvedEffectDryRun as ao, type ResolvedEffectReverse as ap, type ResolvedEffectApprovalRequired as aq, type EffectInvocationMode as ar, type EffectInvocationMetadata as as, type EffectSchema as at, type EffectWithHandler as au, type PublishEffectsResult as av, type EffectVersionSelector as aw, type ToolInfo as ax, type EffectInfo as ay, type ToolsChangedEvent as az, type SessionHeapList as b, type RecordImport as b$, type SessionArtifactExecutionOptions as b0, type SessionArtifactApprovalOptions as b1, type ArtifactApprovalTaskStatus as b2, type ArtifactApprovalTask as b3, type ArtifactApprovalTaskListOptions as b4, type ArtifactApprovalDecisionInput as b5, type ArtifactApprovalDecisionResult as b6, type ManualActionStatus as b7, type ManualActionSource as b8, type ManualActionTarget as b9, type WSReconnectErrorInfo as bA, type WSClientOptions as bB, type RPCRequest as bC, type RPCResponse as bD, type SyncMessage as bE, type RPCRequestFromServer as bF, type ToolInvokeParams as bG, type ToolResultParams as bH, type ModelRef as bI, type RelationshipInfo as bJ, type DefineRelationshipOptions as bK, type RecordObjectOptions as bL, type RecordObjectStateValue as bM, type EnvironmentStateTarget as bN, type EnvironmentStateObservationInput as bO, type EnvironmentStateUpdateInput as bP, type EnvironmentStateMachineProxy as bQ, type EnvironmentStateProxy as bR, type RecordObjectResult as bS, type RecordObjectsChunkInfo as bT, type RecordObjectsOptions as bU, type RecordImportWriteMode as bV, type RecordImportOptions as bW, type RecordImportStatus as bX, type RecordImportItemStatus as bY, type RecordImportStats as bZ, type RecordImportItem as b_, type ManualActionRelatedRecord as ba, type RecordManualActionInput as bb, type ManualActionOccurrence as bc, type ManualActionRecordResult as bd, type ManualActionListOptions as be, type ManualActionSuggestion as bf, type ManualActionSuggestionOptions as bg, type SessionFileUploadOptions as bh, type SessionJobRecord as bi, type SessionHeapFieldType as bj, type SessionHeapFieldValue as bk, type SessionHeapVariable as bl, type RecordSearchResult as bm, type RecordSearchOptions as bn, type RecordMentionInput as bo, type SessionDocumentResult as bp, type SessionCollectionListOptions as bq, type SessionJobListOptions as br, type SessionCollectionListResult as bs, type UserEnvironmentPrompt as bt, type UserEnvironmentMessagePreview as bu, type UserEnvironmentSessionState as bv, type UserEnvironmentState as bw, type UserEnvironmentStateOptions as bx, type MarkUserEnvironmentReadOptions as by, type WSDisconnectInfo as bz, type SessionHeapSnapshot as c, type EnvironmentRecordImportSummary as c0, type EnvironmentSetupTriggerReason as c1, type RunEnvironmentImporterOptions as c2, type EnvironmentSetupLifecycleStatus as c3, type EnvironmentSetupSummary as c4, type EnvironmentImporterImportOptions as c5, type EnvironmentImporter as c6, type ManifestPropertySpec as c7, type ManifestValidationOperator as c8, type ManifestEnumRuleSpec as c9, type GraphQLResult as cA, type APIError as cB, type DeleteResponse as cC, type StreamEvent as cD, type StreamSubscription as cE, type StreamStats as cF, type ManifestFilterBySpec as ca, type ManifestValidationRuleSpec as cb, type ManifestStateMachineStateSpec as cc, type ManifestStateTransitionInputBinding as cd, type ManifestStateTransitionActionSpec as ce, type ManifestStateTransitionAssigneeSpec as cf, type ManifestStateTransitionRelatedStateRequirementSpec as cg, type ManifestStateTransitionRequirementsSpec as ch, type ManifestStateTransitionPermissionSpec as ci, type ManifestStateTransitionExpectedOutcomeSpec as cj, type ManifestStateMachineTransitionSpec as ck, type ManifestStateMachineSpec as cl, type ManifestPostConditionSpec as cm, type ManifestDryRunSpec as cn, type ManifestReverseSpec as co, type ManifestApprovalRequiredSpec as cp, type ManifestCreatesSpec as cq, type ManifestRelationshipDef as cr, type ManifestEffectSchema as cs, type ManifestEffectDeclaration as ct, type ManifestEventTypeDef as cu, type ManifestEventStreamDef as cv, type ManifestOperation as cw, type ManifestImport as cx, type ManifestVolume as cy, type ManifestContent as cz, type SessionTranscriptEntry as d, type ToolSchema as e, type PublishToolsResult as f, type ToolHandler as g, type OpenAITokenSpend as h, OPENAI_MODEL_PRICING_USD_PER_MILLION as i, getOpenAIModelPricing as j, calculateOpenAITokenSpend as k, type OpenAIUsageSpendEvent as l, type RecordOpenAIUsageSpendOptions as m, normalizeOpenAIUsage as n, type RecordOpenAIUsageSpendResult as o, buildOpenAISpendEventId as p, type PolicySource as q, recordOpenAIUsageSpend as r, type PolicyPredicateSource as s, toGranularHttpBase as t, type PolicyOperator as u, type PolicyOrigin as v, type PolicyRuleIR as w, type MatchedPolicy as x, type GranularOptions as y, type GranularAuth as z };
+export { type QuotaLineItemFilter as $, type AccessTokenProvider as A, type RecordUserOptions as B, type ConditionIR as C, type DomainState as D, type EndpointMode as E, type Subject as F, type GranularSpendContext as G, type OpenEnvironmentOptions as H, type InstanceToolHandler as I, type ConnectOptions as J, type CreateSessionOptions as K, type ConversationSessionInfo as L, type ManifestEffectMetamodelSpec as M, type NormalizedOpenAIUsage as N, type OpenAIModelPricing as O, type Prompt as P, type ConversationSessionListStatus as Q, type ResolvedEffectBehaviors as R, type SessionHeapEntry as S, type ToolWithHandler as T, type User as U, type ConversationSessionListOptions as V, type SpendLineItemType as W, type QuotaScopeType as X, type QuotaPeriod as Y, type QuotaStatus as Z, type SpendSummary as _, type EffectHandlerContext as a, type SessionFileSource as a$, type GranularQuotaPolicy as a0, type GranularQuotaProgress as a1, type Sandbox as a2, type CreateSandboxData as a3, type SandboxListResponse as a4, type PermissionRules as a5, type PermissionProfile as a6, type CreatePermissionProfileData as a7, type PermissionProfileListResponse as a8, type Assignment as a9, 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 ConversationTableCell as aP, type ConversationTableColumn as aQ, type ConversationTableRowReference as aR, type ConversationTableRow as aS, type ConversationTableProjection as aT, type ConversationActionSuggestion as aU, type ConversationMessageAction as aV, type ConversationMessagePart as aW, type ConversationMessageInput as aX, type ConversationAppendResult as aY, type SessionConversationMessage as aZ, type SessionTimelineEvent as a_, type AssignmentListResponse as aa, type BuildPolicy as ab, type VersionTracking as ac, type VersionTag as ad, type EnvironmentData as ae, type CreateEnvironmentData as af, type EnvironmentListResponse as ag, type Manifest as ah, type ManifestListResponse as ai, type BuildStatus as aj, type Build as ak, type Version as al, type BuildListResponse as am, type SemanticVersionDiffEntry as an, type SemanticVersionDiff as ao, type ResolvedEffectPostCondition as ap, type ResolvedEffectDryRun as aq, type ResolvedEffectReverse as ar, type ResolvedEffectApprovalRequired as as, type EffectInvocationMode as at, type EffectInvocationMetadata as au, type EffectSchema as av, type EffectWithHandler as aw, type PublishEffectsResult as ax, type EffectVersionSelector as ay, type ToolInfo as az, type SessionHeapList as b, type EnvironmentStateProxy as b$, type SessionFileKind as b0, type SessionFileStatus as b1, type SessionFileRecord as b2, type SessionArtifactStatus as b3, type SessionArtifactKind as b4, type SessionArtifactAutonomyPolicy as b5, type SessionArtifactRecord as b6, type SessionArtifactListOptions as b7, type SessionArtifactValidationResult as b8, type SessionArtifactExecutionResult as b9, type SessionCollectionListOptions as bA, type SessionJobListOptions as bB, type SessionCollectionListResult as bC, type UserEnvironmentPrompt as bD, type UserEnvironmentMessagePreview as bE, type UserEnvironmentSessionState as bF, type UserEnvironmentState as bG, type UserEnvironmentStateOptions as bH, type MarkUserEnvironmentReadOptions as bI, type WSDisconnectInfo as bJ, type WSReconnectErrorInfo as bK, type WSClientOptions as bL, type RPCRequest as bM, type RPCResponse as bN, type SyncMessage as bO, type RPCRequestFromServer as bP, type ToolInvokeParams as bQ, type ToolResultParams as bR, type ModelRef as bS, type RelationshipInfo as bT, type DefineRelationshipOptions as bU, type RecordObjectOptions as bV, type RecordObjectStateValue as bW, type EnvironmentStateTarget as bX, type EnvironmentStateObservationInput as bY, type EnvironmentStateUpdateInput as bZ, type EnvironmentStateMachineProxy as b_, type SessionArtifactExecutionOptions as ba, type SessionArtifactApprovalOptions as bb, type ArtifactApprovalTaskStatus as bc, type ArtifactApprovalTask as bd, type ArtifactApprovalTaskListOptions as be, type ArtifactApprovalDecisionInput as bf, type ArtifactApprovalDecisionResult as bg, type ManualActionStatus as bh, type ManualActionSource as bi, type ManualActionTarget as bj, type ManualActionRelatedRecord as bk, type RecordManualActionInput as bl, type ManualActionOccurrence as bm, type ManualActionRecordResult as bn, type ManualActionListOptions as bo, type ManualActionSuggestion as bp, type ManualActionSuggestionOptions as bq, type SessionFileUploadOptions as br, type SessionJobRecord as bs, type SessionHeapFieldType as bt, type SessionHeapFieldValue as bu, type SessionHeapVariable as bv, type RecordSearchResult as bw, type RecordSearchOptions as bx, type RecordMentionInput as by, type SessionDocumentResult as bz, type SessionHeapSnapshot as c, type RecordObjectResult as c0, type RecordObjectsChunkInfo as c1, type RecordObjectsOptions as c2, type RecordImportWriteMode as c3, type RecordImportOptions as c4, type RecordImportStatus as c5, type RecordImportItemStatus as c6, type RecordImportStats as c7, type RecordImportItem as c8, type RecordImport as c9, type ManifestCreatesSpec as cA, type ManifestRelationshipDef as cB, type ManifestEffectSchema as cC, type ManifestEffectDeclaration as cD, type ManifestEventTypeDef as cE, type ManifestEventStreamDef as cF, type ManifestOperation as cG, type ManifestImport as cH, type ManifestVolume as cI, type ManifestContent as cJ, type GraphQLResult as cK, type APIError as cL, type DeleteResponse as cM, type StreamEvent as cN, type StreamSubscription as cO, type StreamStats as cP, type EnvironmentRecordImportSummary as ca, type EnvironmentSetupTriggerReason as cb, type RunEnvironmentImporterOptions as cc, type EnvironmentSetupLifecycleStatus as cd, type EnvironmentSetupSummary as ce, type EnvironmentImporterImportOptions as cf, type EnvironmentImporter as cg, type ManifestPropertySpec as ch, type ManifestValidationOperator as ci, type ManifestEnumRuleSpec as cj, type ManifestFilterBySpec as ck, type ManifestValidationRuleSpec as cl, type ManifestStateMachineStateSpec as cm, type ManifestStateTransitionInputBinding as cn, type ManifestStateTransitionActionSpec as co, type ManifestStateTransitionAssigneeSpec as cp, type ManifestStateTransitionRelatedStateRequirementSpec as cq, type ManifestStateTransitionRequirementsSpec as cr, type ManifestStateTransitionPermissionSpec as cs, type ManifestStateTransitionExpectedOutcomeSpec as ct, type ManifestStateMachineTransitionSpec as cu, type ManifestStateMachineSpec as cv, type ManifestPostConditionSpec as cw, type ManifestDryRunSpec as cx, type ManifestReverseSpec as cy, type ManifestApprovalRequiredSpec as cz, type SessionTranscriptEntry as d, type ToolSchema as e, type PublishToolsResult as f, type ToolHandler as g, type OpenAITokenSpend as h, OPENAI_MODEL_PRICING_USD_PER_MILLION as i, getOpenAIModelPricing as j, calculateOpenAITokenSpend as k, type OpenAIUsageSpendEvent as l, type RecordOpenAIUsageSpendOptions as m, normalizeOpenAIUsage as n, type RecordOpenAIUsageSpendResult as o, buildOpenAISpendEventId as p, type PolicySource as q, recordOpenAIUsageSpend as r, type PolicyPredicateSource as s, toGranularHttpBase as t, type PolicyOperator as u, type PolicyOrigin as v, type PolicyRuleIR as w, type MatchedPolicy as x, type GranularOptions as y, type GranularAuth as z };

package/dist/spend.d.mts

@@ -1 +1 @@
-export { G as GranularSpendContext, l as OpenAIUsageSpendEvent, m as RecordOpenAIUsageSpendOptions, o as RecordOpenAIUsageSpendResult, p as buildOpenAISpendEventId, r as recordOpenAIUsageSpend, t as toGranularHttpBase } from './spend-RpJikX9w.mjs';
+export { G as GranularSpendContext, l as OpenAIUsageSpendEvent, m as RecordOpenAIUsageSpendOptions, o as RecordOpenAIUsageSpendResult, p as buildOpenAISpendEventId, r as recordOpenAIUsageSpend, t as toGranularHttpBase } from './spend-BA-jZwZ0.mjs';

package/dist/spend.d.ts

@@ -1 +1 @@
-export { G as GranularSpendContext, l as OpenAIUsageSpendEvent, m as RecordOpenAIUsageSpendOptions, o as RecordOpenAIUsageSpendResult, p as buildOpenAISpendEventId, r as recordOpenAIUsageSpend, t as toGranularHttpBase } from './spend-RpJikX9w.js';
+export { G as GranularSpendContext, l as OpenAIUsageSpendEvent, m as RecordOpenAIUsageSpendOptions, o as RecordOpenAIUsageSpendResult, p as buildOpenAISpendEventId, r as recordOpenAIUsageSpend, t as toGranularHttpBase } from './spend-BA-jZwZ0.js';

package/dist/spend.js

@@ -52,7 +52,12 @@ async function recordOpenAIUsageSpend(options) {
   const metadata = {
     ...options.metadata || {},
     ...options.usage.rawUsage !== void 0 ? { openaiUsage: options.usage.rawUsage } : {},
-    usageContext: context
+    usageContext: context,
+    pricingContextTier: options.usage.pricingContextTier,
+    cacheWritePricePerMillionMicros: options.usage.cacheWritePricePerMillionMicros,
+    cacheWriteTokens: options.usage.cacheWriteTokens,
+    cacheWriteCostMicros: options.usage.cacheWriteCostMicros,
+    longContextThresholdTokens: options.usage.longContextThresholdTokens
   };
   const response = await fetch(
     `${toGranularHttpBase(options.apiUrl)}/control/spend/events`,

package/dist/spend.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/spend.ts"],"names":[],"mappings":"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","file":"spend.js","sourcesContent":["import type { OpenAITokenSpend } from \"./openai-usage\";\nimport type { GranularQuotaProgress } from \"./types\";\n\nexport interface GranularSpendContext {\n  tenantId?: string | null;\n  sandboxId?: string | null;\n  environmentId?: string | null;\n  sessionId?: string | null;\n  subjectId?: string | null;\n  permissionProfileId?: string | null;\n  [key: string]: string | null | undefined;\n}\n\nexport interface OpenAIUsageSpendEvent extends OpenAITokenSpend {\n  spendEventId?: string;\n  source?: \"openai\";\n  lineItemType?: \"llm_tokens\";\n  operation?: string;\n  requestId?: string | null;\n  usageContext?: GranularSpendContext;\n  rawUsage?: unknown;\n}\n\nexport interface RecordOpenAIUsageSpendOptions {\n  apiUrl: string;\n  token: string;\n  usage: OpenAIUsageSpendEvent;\n  context?: GranularSpendContext | null;\n  metadata?: Record<string, unknown> | null;\n}\n\nexport interface RecordOpenAIUsageSpendResult {\n  spendEventId: string;\n  inserted: boolean;\n  quota: GranularQuotaProgress | null;\n}\n\nexport function toGranularHttpBase(apiUrl: string): string {\n  const url = new URL(apiUrl);\n  if (url.protocol === \"ws:\") {\n    url.protocol = \"http:\";\n  } else if (url.protocol === \"wss:\") {\n    url.protocol = \"https:\";\n  }\n\n  url.pathname = url.pathname\n    .replace(/\\/ws\\/connect$/, \"\")\n    .replace(/\\/ws$/, \"\");\n  if (!url.pathname || url.pathname === \"/\") {\n    url.pathname = \"/granular\";\n  }\n  url.search = \"\";\n  url.hash = \"\";\n  return url.toString().replace(/\\/$/, \"\");\n}\n\nfunction cleanIdPart(value: string): string {\n  return value.replace(/[^a-zA-Z0-9_-]+/g, \"_\").replace(/^_+|_+$/g, \"\");\n}\n\nexport function buildOpenAISpendEventId(\n  usage: Pick<OpenAIUsageSpendEvent, \"requestId\">,\n  context: GranularSpendContext = {},\n): string | undefined {\n  const requestId = usage.requestId?.trim();\n  if (!requestId) return undefined;\n\n  const scope =\n    context.sessionId ||\n    context.environmentId ||\n    context.subjectId ||\n    context.sandboxId ||\n    \"global\";\n  return [\"spend\", \"openai\", scope, requestId].map(cleanIdPart).join(\"_\");\n}\n\nfunction pricingEffectiveAtSeconds(value: string | null | undefined) {\n  if (!value) return null;\n  const parsed = Date.parse(value);\n  return Number.isFinite(parsed) ? Math.floor(parsed / 1000) : null;\n}\n\nfunction compactContext(context: GranularSpendContext): GranularSpendContext {\n  return Object.fromEntries(\n    Object.entries(context).filter(\n      ([, value]) => value != null && value !== \"\",\n    ),\n  ) as GranularSpendContext;\n}\n\nfunction omitTenantId(context: GranularSpendContext): GranularSpendContext {\n  const scopedContext = { ...context };\n  delete scopedContext.tenantId;\n  return scopedContext;\n}\n\nexport async function recordOpenAIUsageSpend(\n  options: RecordOpenAIUsageSpendOptions,\n): Promise<RecordOpenAIUsageSpendResult> {\n  const usageContext = compactContext({\n    ...(options.usage.usageContext || {}),\n    ...(options.context || {}),\n  });\n  const context = omitTenantId(usageContext);\n  const spendEventId =\n    options.usage.spendEventId ||\n    buildOpenAISpendEventId(options.usage, context);\n  const metadata = {\n    ...(options.metadata || {}),\n    ...(options.usage.rawUsage !== undefined\n      ? { openaiUsage: options.usage.rawUsage }\n      : {}),\n    usageContext: context,\n  };\n\n  const response = await fetch(\n    `${toGranularHttpBase(options.apiUrl)}/control/spend/events`,\n    {\n      method: \"POST\",\n      cache: \"no-store\",\n      headers: {\n        Authorization: `Bearer ${options.token}`,\n        \"Content-Type\": \"application/json\",\n      },\n      body: JSON.stringify({\n        ...(spendEventId ? { spendEventId } : {}),\n        sandboxId: context.sandboxId || null,\n        environmentId: context.environmentId || null,\n        sessionId: context.sessionId || null,\n        subjectId: context.subjectId || null,\n        permissionProfileId: context.permissionProfileId || null,\n        source: \"openai\",\n        lineItemType: \"llm_tokens\",\n        provider: options.usage.provider,\n        model: options.usage.model,\n        operation: options.usage.operation || \"chat.completions\",\n        requestId: options.usage.requestId || null,\n        inputTokens: options.usage.inputTokens,\n        outputTokens: options.usage.outputTokens,\n        cachedInputTokens: options.usage.cachedInputTokens,\n        reasoningTokens: options.usage.reasoningTokens,\n        quantity: options.usage.totalTokens,\n        quantityUnit: \"tokens\",\n        inputPricePerMillionMicros: options.usage.inputPricePerMillionMicros,\n        cachedInputPricePerMillionMicros:\n          options.usage.cachedInputPricePerMillionMicros,\n        outputPricePerMillionMicros: options.usage.outputPricePerMillionMicros,\n        amountMicros: options.usage.amountMicros,\n        currency: options.usage.currency,\n        pricingSource: options.usage.pricingSource,\n        pricingEffectiveAt: pricingEffectiveAtSeconds(\n          options.usage.pricingEffectiveAt,\n        ),\n        estimated: false,\n        metadata,\n      }),\n    },\n  );\n\n  if (!response.ok) {\n    throw new Error(\n      `Granular spend event failed (${response.status}): ${await response.text()}`,\n    );\n  }\n\n  return response.json() as Promise<RecordOpenAIUsageSpendResult>;\n}\n"]}
+{"version":3,"sources":["../src/spend.ts"],"names":[],"mappings":"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","file":"spend.js","sourcesContent":["import type { OpenAITokenSpend } from \"./openai-usage\";\nimport type { GranularQuotaProgress } from \"./types\";\n\nexport interface GranularSpendContext {\n  tenantId?: string | null;\n  sandboxId?: string | null;\n  environmentId?: string | null;\n  sessionId?: string | null;\n  subjectId?: string | null;\n  permissionProfileId?: string | null;\n  [key: string]: string | null | undefined;\n}\n\nexport interface OpenAIUsageSpendEvent extends OpenAITokenSpend {\n  spendEventId?: string;\n  source?: \"openai\";\n  lineItemType?: \"llm_tokens\";\n  operation?: string;\n  requestId?: string | null;\n  usageContext?: GranularSpendContext;\n  rawUsage?: unknown;\n}\n\nexport interface RecordOpenAIUsageSpendOptions {\n  apiUrl: string;\n  token: string;\n  usage: OpenAIUsageSpendEvent;\n  context?: GranularSpendContext | null;\n  metadata?: Record<string, unknown> | null;\n}\n\nexport interface RecordOpenAIUsageSpendResult {\n  spendEventId: string;\n  inserted: boolean;\n  quota: GranularQuotaProgress | null;\n}\n\nexport function toGranularHttpBase(apiUrl: string): string {\n  const url = new URL(apiUrl);\n  if (url.protocol === \"ws:\") {\n    url.protocol = \"http:\";\n  } else if (url.protocol === \"wss:\") {\n    url.protocol = \"https:\";\n  }\n\n  url.pathname = url.pathname\n    .replace(/\\/ws\\/connect$/, \"\")\n    .replace(/\\/ws$/, \"\");\n  if (!url.pathname || url.pathname === \"/\") {\n    url.pathname = \"/granular\";\n  }\n  url.search = \"\";\n  url.hash = \"\";\n  return url.toString().replace(/\\/$/, \"\");\n}\n\nfunction cleanIdPart(value: string): string {\n  return value.replace(/[^a-zA-Z0-9_-]+/g, \"_\").replace(/^_+|_+$/g, \"\");\n}\n\nexport function buildOpenAISpendEventId(\n  usage: Pick<OpenAIUsageSpendEvent, \"requestId\">,\n  context: GranularSpendContext = {},\n): string | undefined {\n  const requestId = usage.requestId?.trim();\n  if (!requestId) return undefined;\n\n  const scope =\n    context.sessionId ||\n    context.environmentId ||\n    context.subjectId ||\n    context.sandboxId ||\n    \"global\";\n  return [\"spend\", \"openai\", scope, requestId].map(cleanIdPart).join(\"_\");\n}\n\nfunction pricingEffectiveAtSeconds(value: string | null | undefined) {\n  if (!value) return null;\n  const parsed = Date.parse(value);\n  return Number.isFinite(parsed) ? Math.floor(parsed / 1000) : null;\n}\n\nfunction compactContext(context: GranularSpendContext): GranularSpendContext {\n  return Object.fromEntries(\n    Object.entries(context).filter(\n      ([, value]) => value != null && value !== \"\",\n    ),\n  ) as GranularSpendContext;\n}\n\nfunction omitTenantId(context: GranularSpendContext): GranularSpendContext {\n  const scopedContext = { ...context };\n  delete scopedContext.tenantId;\n  return scopedContext;\n}\n\nexport async function recordOpenAIUsageSpend(\n  options: RecordOpenAIUsageSpendOptions,\n): Promise<RecordOpenAIUsageSpendResult> {\n  const usageContext = compactContext({\n    ...(options.usage.usageContext || {}),\n    ...(options.context || {}),\n  });\n  const context = omitTenantId(usageContext);\n  const spendEventId =\n    options.usage.spendEventId ||\n    buildOpenAISpendEventId(options.usage, context);\n  const metadata = {\n    ...(options.metadata || {}),\n    ...(options.usage.rawUsage !== undefined\n      ? { openaiUsage: options.usage.rawUsage }\n      : {}),\n    usageContext: context,\n    pricingContextTier: options.usage.pricingContextTier,\n    cacheWritePricePerMillionMicros:\n      options.usage.cacheWritePricePerMillionMicros,\n    cacheWriteTokens: options.usage.cacheWriteTokens,\n    cacheWriteCostMicros: options.usage.cacheWriteCostMicros,\n    longContextThresholdTokens: options.usage.longContextThresholdTokens,\n  };\n\n  const response = await fetch(\n    `${toGranularHttpBase(options.apiUrl)}/control/spend/events`,\n    {\n      method: \"POST\",\n      cache: \"no-store\",\n      headers: {\n        Authorization: `Bearer ${options.token}`,\n        \"Content-Type\": \"application/json\",\n      },\n      body: JSON.stringify({\n        ...(spendEventId ? { spendEventId } : {}),\n        sandboxId: context.sandboxId || null,\n        environmentId: context.environmentId || null,\n        sessionId: context.sessionId || null,\n        subjectId: context.subjectId || null,\n        permissionProfileId: context.permissionProfileId || null,\n        source: \"openai\",\n        lineItemType: \"llm_tokens\",\n        provider: options.usage.provider,\n        model: options.usage.model,\n        operation: options.usage.operation || \"chat.completions\",\n        requestId: options.usage.requestId || null,\n        inputTokens: options.usage.inputTokens,\n        outputTokens: options.usage.outputTokens,\n        cachedInputTokens: options.usage.cachedInputTokens,\n        reasoningTokens: options.usage.reasoningTokens,\n        quantity: options.usage.totalTokens,\n        quantityUnit: \"tokens\",\n        inputPricePerMillionMicros: options.usage.inputPricePerMillionMicros,\n        cachedInputPricePerMillionMicros:\n          options.usage.cachedInputPricePerMillionMicros,\n        outputPricePerMillionMicros: options.usage.outputPricePerMillionMicros,\n        amountMicros: options.usage.amountMicros,\n        currency: options.usage.currency,\n        pricingSource: options.usage.pricingSource,\n        pricingEffectiveAt: pricingEffectiveAtSeconds(\n          options.usage.pricingEffectiveAt,\n        ),\n        estimated: false,\n        metadata,\n      }),\n    },\n  );\n\n  if (!response.ok) {\n    throw new Error(\n      `Granular spend event failed (${response.status}): ${await response.text()}`,\n    );\n  }\n\n  return response.json() as Promise<RecordOpenAIUsageSpendResult>;\n}\n"]}