@xenosystem/agent-sdk 0.10.0 → 0.10.1

package/dist/index.d.cts

@@ -4386,6 +4386,7 @@ type ProviderStreamEvent = {
 interface LLMProviderRequestContext {
     systemPrompt: string;
     attemptId?: string;
+    quotaRemainingTokens?: number;
     onEvent?: (event: ProviderStreamEvent) => void | Promise<void>;
 }
 interface LLMProviderCapabilities {
@@ -5584,6 +5585,10 @@ declare class AgentLoop {
         meteredRequests: number;
         coverageComplete: boolean;
     };
+    configureModelExecution(options: {
+        provider?: LLMProvider;
+        modelWorkAccounting?: ModelWorkAccounting;
+    }): void;
     get lastTraceId(): string | null;
     get lastRunTermination(): AgentRunTermination | null;
     get queryState(): QueryState;
@@ -9200,6 +9205,89 @@ declare class FileXenoShareRegistry {
     load(): Promise<XenoShareRegistrySnapshot>;
     private mutate;
 }
+interface QuotaEntity {
+    id: string;
+    generation: string;
+}
+interface QuotaScope {
+    workspace: QuotaEntity;
+    team?: QuotaEntity;
+    agent?: QuotaEntity;
+    goal?: QuotaEntity;
+}
+interface QuotaLimits {
+    requestsPerMinute: number | null;
+    tokensPerDay: number | null;
+    tokensLifetime?: number | null;
+}
+interface QuotaReservation {
+    id: string;
+    scope: QuotaScope;
+    requestHash: string;
+    reservedTokens: number;
+    admittedAt: number;
+    state: "reserved" | "dispatched" | "settled" | "void";
+    actualTokens?: number;
+}
+interface QuotaAuthority {
+    reserve(input: Omit<QuotaReservation, "admittedAt" | "state" | "actualTokens">): Promise<QuotaReservation>;
+    dispatch(id: string): Promise<void>;
+    settle(id: string, actualTokens: number): Promise<void>;
+    void(id: string): Promise<void>;
+    remainingTokens?(scope: QuotaScope): Promise<number | null>;
+}
+declare class QuotaError extends Error {
+    readonly code: "INVALID" | "CONFLICT" | "EXCEEDED" | "UNSUPPORTED" | "CORRUPT" | "CAPACITY" | "CLOCK_ROLLBACK";
+    readonly retryable = false;
+    constructor(code: "INVALID" | "CONFLICT" | "EXCEEDED" | "UNSUPPORTED" | "CORRUPT" | "CAPACITY" | "CLOCK_ROLLBACK", message: string);
+}
+type QuotaAcknowledgementPhase = "prepare" | "reserve" | "dispatch" | "settle" | "void";
+declare class QuotaAcknowledgementError extends Error {
+    readonly phase: QuotaAcknowledgementPhase;
+    readonly reservationId: string;
+    readonly code = "ACKNOWLEDGEMENT_FAILED";
+    readonly retryable = false;
+    constructor(phase: QuotaAcknowledgementPhase, reservationId: string, cause: unknown);
+}
+declare function isQuotaControlError(error: unknown): error is QuotaError | QuotaAcknowledgementError;
+declare function quotaInteger(value: unknown): number;
+declare function quotaText(value: unknown): string;
+declare function normalizeQuotaScope(scope: QuotaScope): QuotaScope;
+declare function quotaScopeKey(scope: QuotaScope): string;
+declare function quotaAncestors(scope: QuotaScope): QuotaScope[];
+declare function createQuotaGovernedProvider(provider: LLMProvider, authority: QuotaAuthority, scope: QuotaScope): LLMProvider;
+interface Policy {
+    scope: QuotaScope;
+    revision: number;
+    limits: QuotaLimits;
+}
+declare class FileQuotaAuthority implements QuotaAuthority {
+    private readonly now;
+    private readonly maximumEntries;
+    readonly directory: string;
+    constructor(directory: string, now?: () => number, maximumEntries?: number);
+    policy(scope: QuotaScope): Promise<Policy | null>;
+    setPolicy(scope: QuotaScope, value: QuotaLimits, expectedRevision: number): Promise<Policy>;
+    reservation(id: string): Promise<QuotaReservation | null>;
+    reserve(input: Omit<QuotaReservation, "admittedAt" | "state" | "actualTokens">): Promise<QuotaReservation>;
+    dispatch(id: string): Promise<void>;
+    void(id: string): Promise<void>;
+    settle(id: string, actualTokens: number): Promise<void>;
+    snapshot(scope: QuotaScope): Promise<{
+        authority: "local-file";
+        policies: Policy[];
+        heldTokens: number;
+        usedTokens: number;
+        lifetimeHeldTokens: number;
+        lifetimeUsedTokens: number;
+        requestsInLastMinute: number;
+        unresolved: number;
+    }>;
+    remainingTokens(scope: QuotaScope): Promise<number | null>;
+    private apply;
+    private load;
+    private append;
+}
 interface UpdateXenoGoalInput {
     objective?: string;
     why?: string;
@@ -9274,6 +9362,7 @@ declare class DurableXenoCoordinationStore {
     beginLoopIteration(sessionId: string, loopId: string, expectedVersion: number, activity: string, taskId?: string): Promise<XenoLoopRecord>;
     private appendLoopIteration;
     admitGoalTurn(input: XenoGoalTurnRequest): Promise<XenoGoalTurnAdmission>;
+    admitQuotaGoalTurn(input: XenoGoalTurnRequest, quota: Pick<FileQuotaAuthority, "policy" | "remainingTokens">, scopeInput: QuotaScope, authority?: Pick<XenoExecutionOwner, "ownerId" | "leaseId" | "epoch">): Promise<XenoGoalTurnAdmission>;
     admitOwnedGoalTurn(input: XenoGoalTurnRequest, authority: Pick<XenoExecutionOwner, "ownerId" | "leaseId" | "epoch">): Promise<XenoGoalTurnAdmission>;
     private admitGoalTurnWithOwner;
     getGoalTurnState(sessionId: string, goalId?: string, requestId?: string): Promise<XenoGoalTurnState | undefined>;
@@ -10368,6 +10457,7 @@ interface CreateXenoAgentOptions {
     onToolWillExecute?: AgentLoopConfig["onToolWillExecute"];
     onToolEnd?: AgentLoopConfig["onToolEnd"];
     onIteration?: AgentLoopConfig["onIteration"];
+    modelWorkAccounting?: AgentLoopConfig["modelWorkAccounting"];
     onError?: AgentLoopConfig["onError"];
     onTranscriptError?: AgentLoopConfig["onTranscriptError"];
     onRuntimeEvent?: XenoRuntimeEventSink;
@@ -13794,6 +13884,7 @@ interface DirectProviderConfig {
     baseURL?: string;
     anthropicVersion?: string;
     maxTokens?: number;
+    xenoPromptTokenCeiling?: number;
     streaming?: boolean;
     capabilityProfile?: DirectProviderCapabilityProfile;
     endpointProfile?: DirectEndpointProfile;
@@ -14020,87 +14111,6 @@ declare class FileXenoProviderConnectionStore {
     load(): Promise<XenoProviderConnectionSnapshot>;
     private mutate;
 }
-interface QuotaEntity {
-    id: string;
-    generation: string;
-}
-interface QuotaScope {
-    workspace: QuotaEntity;
-    team?: QuotaEntity;
-    agent?: QuotaEntity;
-    goal?: QuotaEntity;
-}
-interface QuotaLimits {
-    requestsPerMinute: number | null;
-    tokensPerDay: number | null;
-    tokensLifetime?: number | null;
-}
-interface QuotaReservation {
-    id: string;
-    scope: QuotaScope;
-    requestHash: string;
-    reservedTokens: number;
-    admittedAt: number;
-    state: "reserved" | "dispatched" | "settled" | "void";
-    actualTokens?: number;
-}
-interface QuotaAuthority {
-    reserve(input: Omit<QuotaReservation, "admittedAt" | "state" | "actualTokens">): Promise<QuotaReservation>;
-    dispatch(id: string): Promise<void>;
-    settle(id: string, actualTokens: number): Promise<void>;
-    void(id: string): Promise<void>;
-}
-declare class QuotaError extends Error {
-    readonly code: "INVALID" | "CONFLICT" | "EXCEEDED" | "UNSUPPORTED" | "CORRUPT" | "CAPACITY" | "CLOCK_ROLLBACK";
-    readonly retryable = false;
-    constructor(code: "INVALID" | "CONFLICT" | "EXCEEDED" | "UNSUPPORTED" | "CORRUPT" | "CAPACITY" | "CLOCK_ROLLBACK", message: string);
-}
-type QuotaAcknowledgementPhase = "prepare" | "reserve" | "dispatch" | "settle" | "void";
-declare class QuotaAcknowledgementError extends Error {
-    readonly phase: QuotaAcknowledgementPhase;
-    readonly reservationId: string;
-    readonly code = "ACKNOWLEDGEMENT_FAILED";
-    readonly retryable = false;
-    constructor(phase: QuotaAcknowledgementPhase, reservationId: string, cause: unknown);
-}
-declare function isQuotaControlError(error: unknown): error is QuotaError | QuotaAcknowledgementError;
-declare function quotaInteger(value: unknown): number;
-declare function quotaText(value: unknown): string;
-declare function normalizeQuotaScope(scope: QuotaScope): QuotaScope;
-declare function quotaScopeKey(scope: QuotaScope): string;
-declare function quotaAncestors(scope: QuotaScope): QuotaScope[];
-declare function createQuotaGovernedProvider(provider: LLMProvider, authority: QuotaAuthority, scope: QuotaScope): LLMProvider;
-interface Policy {
-    scope: QuotaScope;
-    revision: number;
-    limits: QuotaLimits;
-}
-declare class FileQuotaAuthority implements QuotaAuthority {
-    private readonly now;
-    private readonly maximumEntries;
-    readonly directory: string;
-    constructor(directory: string, now?: () => number, maximumEntries?: number);
-    policy(scope: QuotaScope): Promise<Policy | null>;
-    setPolicy(scope: QuotaScope, value: QuotaLimits, expectedRevision: number): Promise<Policy>;
-    reservation(id: string): Promise<QuotaReservation | null>;
-    reserve(input: Omit<QuotaReservation, "admittedAt" | "state" | "actualTokens">): Promise<QuotaReservation>;
-    dispatch(id: string): Promise<void>;
-    void(id: string): Promise<void>;
-    settle(id: string, actualTokens: number): Promise<void>;
-    snapshot(scope: QuotaScope): Promise<{
-        authority: "local-file";
-        policies: Policy[];
-        heldTokens: number;
-        usedTokens: number;
-        lifetimeHeldTokens: number;
-        lifetimeUsedTokens: number;
-        requestsInLastMinute: number;
-        unresolved: number;
-    }>;
-    private apply;
-    private load;
-    private append;
-}
 interface CodeValidationResult {
     valid: boolean;
     errors: CodeValidationIssue[];

package/dist/index.d.ts

@@ -4386,6 +4386,7 @@ type ProviderStreamEvent = {
 interface LLMProviderRequestContext {
     systemPrompt: string;
     attemptId?: string;
+    quotaRemainingTokens?: number;
     onEvent?: (event: ProviderStreamEvent) => void | Promise<void>;
 }
 interface LLMProviderCapabilities {
@@ -5584,6 +5585,10 @@ declare class AgentLoop {
         meteredRequests: number;
         coverageComplete: boolean;
     };
+    configureModelExecution(options: {
+        provider?: LLMProvider;
+        modelWorkAccounting?: ModelWorkAccounting;
+    }): void;
     get lastTraceId(): string | null;
     get lastRunTermination(): AgentRunTermination | null;
     get queryState(): QueryState;
@@ -9200,6 +9205,89 @@ declare class FileXenoShareRegistry {
     load(): Promise<XenoShareRegistrySnapshot>;
     private mutate;
 }
+interface QuotaEntity {
+    id: string;
+    generation: string;
+}
+interface QuotaScope {
+    workspace: QuotaEntity;
+    team?: QuotaEntity;
+    agent?: QuotaEntity;
+    goal?: QuotaEntity;
+}
+interface QuotaLimits {
+    requestsPerMinute: number | null;
+    tokensPerDay: number | null;
+    tokensLifetime?: number | null;
+}
+interface QuotaReservation {
+    id: string;
+    scope: QuotaScope;
+    requestHash: string;
+    reservedTokens: number;
+    admittedAt: number;
+    state: "reserved" | "dispatched" | "settled" | "void";
+    actualTokens?: number;
+}
+interface QuotaAuthority {
+    reserve(input: Omit<QuotaReservation, "admittedAt" | "state" | "actualTokens">): Promise<QuotaReservation>;
+    dispatch(id: string): Promise<void>;
+    settle(id: string, actualTokens: number): Promise<void>;
+    void(id: string): Promise<void>;
+    remainingTokens?(scope: QuotaScope): Promise<number | null>;
+}
+declare class QuotaError extends Error {
+    readonly code: "INVALID" | "CONFLICT" | "EXCEEDED" | "UNSUPPORTED" | "CORRUPT" | "CAPACITY" | "CLOCK_ROLLBACK";
+    readonly retryable = false;
+    constructor(code: "INVALID" | "CONFLICT" | "EXCEEDED" | "UNSUPPORTED" | "CORRUPT" | "CAPACITY" | "CLOCK_ROLLBACK", message: string);
+}
+type QuotaAcknowledgementPhase = "prepare" | "reserve" | "dispatch" | "settle" | "void";
+declare class QuotaAcknowledgementError extends Error {
+    readonly phase: QuotaAcknowledgementPhase;
+    readonly reservationId: string;
+    readonly code = "ACKNOWLEDGEMENT_FAILED";
+    readonly retryable = false;
+    constructor(phase: QuotaAcknowledgementPhase, reservationId: string, cause: unknown);
+}
+declare function isQuotaControlError(error: unknown): error is QuotaError | QuotaAcknowledgementError;
+declare function quotaInteger(value: unknown): number;
+declare function quotaText(value: unknown): string;
+declare function normalizeQuotaScope(scope: QuotaScope): QuotaScope;
+declare function quotaScopeKey(scope: QuotaScope): string;
+declare function quotaAncestors(scope: QuotaScope): QuotaScope[];
+declare function createQuotaGovernedProvider(provider: LLMProvider, authority: QuotaAuthority, scope: QuotaScope): LLMProvider;
+interface Policy {
+    scope: QuotaScope;
+    revision: number;
+    limits: QuotaLimits;
+}
+declare class FileQuotaAuthority implements QuotaAuthority {
+    private readonly now;
+    private readonly maximumEntries;
+    readonly directory: string;
+    constructor(directory: string, now?: () => number, maximumEntries?: number);
+    policy(scope: QuotaScope): Promise<Policy | null>;
+    setPolicy(scope: QuotaScope, value: QuotaLimits, expectedRevision: number): Promise<Policy>;
+    reservation(id: string): Promise<QuotaReservation | null>;
+    reserve(input: Omit<QuotaReservation, "admittedAt" | "state" | "actualTokens">): Promise<QuotaReservation>;
+    dispatch(id: string): Promise<void>;
+    void(id: string): Promise<void>;
+    settle(id: string, actualTokens: number): Promise<void>;
+    snapshot(scope: QuotaScope): Promise<{
+        authority: "local-file";
+        policies: Policy[];
+        heldTokens: number;
+        usedTokens: number;
+        lifetimeHeldTokens: number;
+        lifetimeUsedTokens: number;
+        requestsInLastMinute: number;
+        unresolved: number;
+    }>;
+    remainingTokens(scope: QuotaScope): Promise<number | null>;
+    private apply;
+    private load;
+    private append;
+}
 interface UpdateXenoGoalInput {
     objective?: string;
     why?: string;
@@ -9274,6 +9362,7 @@ declare class DurableXenoCoordinationStore {
     beginLoopIteration(sessionId: string, loopId: string, expectedVersion: number, activity: string, taskId?: string): Promise<XenoLoopRecord>;
     private appendLoopIteration;
     admitGoalTurn(input: XenoGoalTurnRequest): Promise<XenoGoalTurnAdmission>;
+    admitQuotaGoalTurn(input: XenoGoalTurnRequest, quota: Pick<FileQuotaAuthority, "policy" | "remainingTokens">, scopeInput: QuotaScope, authority?: Pick<XenoExecutionOwner, "ownerId" | "leaseId" | "epoch">): Promise<XenoGoalTurnAdmission>;
     admitOwnedGoalTurn(input: XenoGoalTurnRequest, authority: Pick<XenoExecutionOwner, "ownerId" | "leaseId" | "epoch">): Promise<XenoGoalTurnAdmission>;
     private admitGoalTurnWithOwner;
     getGoalTurnState(sessionId: string, goalId?: string, requestId?: string): Promise<XenoGoalTurnState | undefined>;
@@ -10368,6 +10457,7 @@ interface CreateXenoAgentOptions {
     onToolWillExecute?: AgentLoopConfig["onToolWillExecute"];
     onToolEnd?: AgentLoopConfig["onToolEnd"];
     onIteration?: AgentLoopConfig["onIteration"];
+    modelWorkAccounting?: AgentLoopConfig["modelWorkAccounting"];
     onError?: AgentLoopConfig["onError"];
     onTranscriptError?: AgentLoopConfig["onTranscriptError"];
     onRuntimeEvent?: XenoRuntimeEventSink;
@@ -13794,6 +13884,7 @@ interface DirectProviderConfig {
     baseURL?: string;
     anthropicVersion?: string;
     maxTokens?: number;
+    xenoPromptTokenCeiling?: number;
     streaming?: boolean;
     capabilityProfile?: DirectProviderCapabilityProfile;
     endpointProfile?: DirectEndpointProfile;
@@ -14020,87 +14111,6 @@ declare class FileXenoProviderConnectionStore {
     load(): Promise<XenoProviderConnectionSnapshot>;
     private mutate;
 }
-interface QuotaEntity {
-    id: string;
-    generation: string;
-}
-interface QuotaScope {
-    workspace: QuotaEntity;
-    team?: QuotaEntity;
-    agent?: QuotaEntity;
-    goal?: QuotaEntity;
-}
-interface QuotaLimits {
-    requestsPerMinute: number | null;
-    tokensPerDay: number | null;
-    tokensLifetime?: number | null;
-}
-interface QuotaReservation {
-    id: string;
-    scope: QuotaScope;
-    requestHash: string;
-    reservedTokens: number;
-    admittedAt: number;
-    state: "reserved" | "dispatched" | "settled" | "void";
-    actualTokens?: number;
-}
-interface QuotaAuthority {
-    reserve(input: Omit<QuotaReservation, "admittedAt" | "state" | "actualTokens">): Promise<QuotaReservation>;
-    dispatch(id: string): Promise<void>;
-    settle(id: string, actualTokens: number): Promise<void>;
-    void(id: string): Promise<void>;
-}
-declare class QuotaError extends Error {
-    readonly code: "INVALID" | "CONFLICT" | "EXCEEDED" | "UNSUPPORTED" | "CORRUPT" | "CAPACITY" | "CLOCK_ROLLBACK";
-    readonly retryable = false;
-    constructor(code: "INVALID" | "CONFLICT" | "EXCEEDED" | "UNSUPPORTED" | "CORRUPT" | "CAPACITY" | "CLOCK_ROLLBACK", message: string);
-}
-type QuotaAcknowledgementPhase = "prepare" | "reserve" | "dispatch" | "settle" | "void";
-declare class QuotaAcknowledgementError extends Error {
-    readonly phase: QuotaAcknowledgementPhase;
-    readonly reservationId: string;
-    readonly code = "ACKNOWLEDGEMENT_FAILED";
-    readonly retryable = false;
-    constructor(phase: QuotaAcknowledgementPhase, reservationId: string, cause: unknown);
-}
-declare function isQuotaControlError(error: unknown): error is QuotaError | QuotaAcknowledgementError;
-declare function quotaInteger(value: unknown): number;
-declare function quotaText(value: unknown): string;
-declare function normalizeQuotaScope(scope: QuotaScope): QuotaScope;
-declare function quotaScopeKey(scope: QuotaScope): string;
-declare function quotaAncestors(scope: QuotaScope): QuotaScope[];
-declare function createQuotaGovernedProvider(provider: LLMProvider, authority: QuotaAuthority, scope: QuotaScope): LLMProvider;
-interface Policy {
-    scope: QuotaScope;
-    revision: number;
-    limits: QuotaLimits;
-}
-declare class FileQuotaAuthority implements QuotaAuthority {
-    private readonly now;
-    private readonly maximumEntries;
-    readonly directory: string;
-    constructor(directory: string, now?: () => number, maximumEntries?: number);
-    policy(scope: QuotaScope): Promise<Policy | null>;
-    setPolicy(scope: QuotaScope, value: QuotaLimits, expectedRevision: number): Promise<Policy>;
-    reservation(id: string): Promise<QuotaReservation | null>;
-    reserve(input: Omit<QuotaReservation, "admittedAt" | "state" | "actualTokens">): Promise<QuotaReservation>;
-    dispatch(id: string): Promise<void>;
-    void(id: string): Promise<void>;
-    settle(id: string, actualTokens: number): Promise<void>;
-    snapshot(scope: QuotaScope): Promise<{
-        authority: "local-file";
-        policies: Policy[];
-        heldTokens: number;
-        usedTokens: number;
-        lifetimeHeldTokens: number;
-        lifetimeUsedTokens: number;
-        requestsInLastMinute: number;
-        unresolved: number;
-    }>;
-    private apply;
-    private load;
-    private append;
-}
 interface CodeValidationResult {
     valid: boolean;
     errors: CodeValidationIssue[];