@myagentroam/agent 0.10.11 → 0.10.13

package/dist/agent-core/model/openai-responses.js

@@ -949,7 +949,8 @@ function responsesRequestBody(configuration, request, messages) {
         ...(tools.length > 0 ? { tool_choice: toolChoice, parallel_tool_calls: true } : {}),
         input,
         stream: true,
-        store: configuration.responsesTransport?.transport !== 'WEBSOCKET',
+        store: configuration.responsesPreviousResponseId === true &&
+            configuration.responsesTransport?.transport !== 'WEBSOCKET',
         ...(configuration.responsesOptionalParameters?.textVerbosity === false
             ? {}
             : { text: { verbosity: 'low' } }),

package/dist/agent-core/prompts/index.d.ts

@@ -1,6 +1,6 @@
 import type { ExecutionMode } from '../runtime/contracts.js';
 import { type CorePromptPart } from '../extensions/prompt-composition.js';
-export declare const MAR_AGENT_PROMPT_VERSION = "1.63";
+export declare const MAR_AGENT_PROMPT_VERSION = "1.64";
 interface SystemPromptInput {
     mode: ExecutionMode;
     platform: string;

package/dist/agent-core/prompts/index.js

@@ -5,7 +5,7 @@ import { modePrompt } from './modes.js';
 import { outputStylePrompt } from './output.js';
 import { subagentPrompt } from './subagent.js';
 import { interactionPrompt, longRunningPrompt, safetyPrompt, toolUsagePrompt, workflowPrompt } from './workflow.js';
-export const MAR_AGENT_PROMPT_VERSION = '1.63';
+export const MAR_AGENT_PROMPT_VERSION = '1.64';
 export function buildSystemPrompt(input) {
     return renderPromptSections(buildSystemPromptSections(input));
 }

package/dist/agent-core/prompts/modes.js

@@ -1,11 +1,11 @@
 export function modePrompt(mode, input) {
     if (mode !== 'plan')
         return '';
-    const investigationGuidance = 'Resolve discoverable facts through targeted read-only investigation. Ask about user-owned preferences and tradeoffs early when they cannot be inferred from the request, conversation, or workspace evidence. If current environment guidance requires finalization, stop further exploration and use only evidence already gathered.';
+    const investigationGuidance = 'Resolve discoverable facts through targeted read-only investigation. Ask about user-owned preferences and tradeoffs early when they cannot be inferred from the request, conversation, or workspace evidence.';
     const decisionGuidance = input.questionAvailable
         ? 'Use question for unresolved choices that materially change the result; do not finalize the plan while such choices remain. Do not invent support for multiple outcomes or silently choose a default to avoid asking.'
-        : 'Ask a concise plain-text question for unresolved user-owned choices that materially change the result instead of finalizing an ambiguous plan. When current environment guidance requires finalization and user input is unavailable, state the unresolved decision and its impact instead of guessing. Do not invent support for multiple outcomes or silently choose a default.';
-    const finalGuidance = 'Once the plan is decision-complete, return only a concise, actionable plan. Break the work into meaningful, logically ordered deliverables that are easy to verify. Do not pad the plan with filler or obvious steps. Include the implementation and verification detail needed to execute it, without drafting the implementation itself. When current environment guidance requires finalization, return the concise verified staged plan and distinguish incomplete work or unresolved decisions. Do not ask whether to proceed or claim unresolved work is complete.';
+        : 'Ask a concise plain-text question for unresolved user-owned choices that materially change the result instead of finalizing an ambiguous plan. If user input is unavailable, state the unresolved decision and its impact instead of guessing. Do not invent support for multiple outcomes or silently choose a default.';
+    const finalGuidance = 'Once the plan is decision-complete, return only a concise, actionable plan. Break the work into meaningful, logically ordered deliverables that are easy to verify. Do not pad the plan with filler or obvious steps. Include the implementation and verification detail needed to execute it, without drafting the implementation itself. Do not ask whether to proceed or claim unresolved work is complete.';
     return `# Plan mode
 Use tools only for read-only investigation that reduces uncertainty and improves the plan. Do not create, modify, delete, rename, or move files, and do not run commands intended to mutate repository-tracked state or implement the requested work. This is behavioral guidance, not a security boundary; the normal tools and Host policies remain available.
 

package/dist/agent-core/runtime/contracts.d.ts

@@ -30,6 +30,7 @@ export interface ExecutionResult {
     errorCode?: string;
     errorMessage?: string;
 }
+/** @deprecated Execution token budgets are no longer enforced. */
 export interface RolloutBudgetOptions {
     limitTokens?: number;
     conserveAtRemainingTokens?: number;

package/dist/agent-core/runtime/execution-policy.d.ts

@@ -1,10 +1,5 @@
 export declare const AGENT_EXECUTION_POLICY: Readonly<{
     subagentModelRounds: 32;
-    rolloutBudgetTokens: 1250000;
-    rolloutBudgetConserveRemainingTokens: 350000;
-    rolloutBudgetFinalizeRemainingTokens: 200000;
-    rolloutBudgetSamplingTokenWeight: 1;
-    rolloutBudgetPrefillTokenWeight: 1;
     toolEventSummaryCharacters: 2000;
     modelToolOutputTokens: 10000;
     automaticCompactionPercent: 90;

package/dist/agent-core/runtime/execution-policy.js

@@ -1,10 +1,5 @@
 export const AGENT_EXECUTION_POLICY = Object.freeze({
     subagentModelRounds: 32,
-    rolloutBudgetTokens: 1_250_000,
-    rolloutBudgetConserveRemainingTokens: 350_000,
-    rolloutBudgetFinalizeRemainingTokens: 200_000,
-    rolloutBudgetSamplingTokenWeight: 1,
-    rolloutBudgetPrefillTokenWeight: 1,
     toolEventSummaryCharacters: 2_000,
     modelToolOutputTokens: 10_000,
     automaticCompactionPercent: 90,

package/dist/agent-core/runtime/execution.d.ts

@@ -5,7 +5,6 @@ import type { ToolRuntimeImage } from '../tools/runtime-context.js';
 import type { AuthoritativeModelUsage } from './context/usage.js';
 import type { ExecutionMode } from './contracts.js';
 import type { EventPayload } from './events.js';
-import type { RolloutBudget } from './rollout-budget.js';
 export interface PreparedExecutionRound {
     readonly request: ModelRequest;
     readonly toolScope: RoundToolScope;
@@ -18,7 +17,6 @@ export interface ExecutionLoopInput {
     readonly model: Pick<MarAgentModelConfiguration, 'id' | 'name'>;
     readonly messages: ModelMessage[];
     readonly toolImages: ToolRuntimeImage[];
-    readonly rolloutBudget: RolloutBudget | undefined;
     readonly publish: (event: EventPayload) => Promise<void>;
     readonly appendContext: (message: ModelMessage) => Promise<void>;
     readonly prepareRound: (continuation: ModelMessage | undefined) => Promise<PreparedExecutionRound>;

package/dist/agent-core/runtime/execution.js

@@ -35,7 +35,6 @@ export class ExecutionLoop {
             const pendingTools = [];
             let incompleteToolCall = false;
             const round = await input.prepareRound(pendingOutputContinuation);
-            input.rolloutBudget?.assertAvailable();
             let sawModelSemanticEvent = false;
             let requestStartedAt;
             let firstModelResponseAt;
@@ -340,9 +339,6 @@ export class ExecutionLoop {
                 if (input.sourceType === 'subagent')
                     this.finalAnswer = '';
             }
-            input.rolloutBudget?.recordUsage(latestUsage);
-            if (!input.signal.aborted)
-                input.rolloutBudget?.assertAvailable();
             if (mode !== 'compact' && stop === 'max_output') {
                 const needsContinuation = !sawTool || incompleteToolCall;
                 if (needsContinuation) {
@@ -365,7 +361,6 @@ export class ExecutionLoop {
                 const aborted = toolResults.find((result) => result.failed)?.error;
                 throw aborted ?? new MarAgentError('MAR_AGENT_EXECUTION_CANCELLED', 'Execution cancelled.');
             }
-            input.rolloutBudget?.assertAvailable();
             if (input.mailbox.hasPending() && (await input.mailbox.append())) {
                 this.finalAnswer = '';
                 continue;

package/dist/agent-core/sdk/agent.js

@@ -7,7 +7,6 @@ import { negotiateHost } from '../host/contracts.js';
 import { toolCallers } from '../tools/callers.js';
 import { AnthropicMessagesAdapter } from '../model/anthropic-messages.js';
 import { OpenAiResponsesAdapter } from '../model/openai-responses.js';
-import { resolveRolloutBudgetOptions } from '../runtime/rollout-budget.js';
 import { JsonlSessionStore } from '../session/jsonl-store.js';
 /** Validate models before Host negotiation and expose only built-in protocol adapters. */
 export async function createMarAgent(options) {
@@ -17,7 +16,6 @@ export async function createMarAgent(options) {
 }
 /** Package-internal seam for deterministic adapter tests; not a package export. */
 export async function createMarAgentWithAdapter(options) {
-    const rolloutBudgetOptions = resolveRolloutBudgetOptions(options.rolloutBudget);
     const resolvedModels = resolveAgentModels(options.models);
     let { models, defaultModelId } = resolvedModels;
     let modelGeneration = 0;
@@ -169,7 +167,6 @@ export async function createMarAgentWithAdapter(options) {
             sessionRuntimes,
             sessionWriterOwner
         },
-        rolloutBudgetOptions,
         hasCustomAdapters: options.adapterFactory !== undefined,
         modelState: () => ({ models, defaultModelId, generation: modelGeneration }),
         createAdapter,

package/dist/agent-core/sdk/session.d.ts

@@ -9,7 +9,6 @@ import type { CoreAgentsBackend } from '../extensions/agents.js';
 import type { HostDescription, MarAgentHost } from '../host/contracts.js';
 import { type MarAgentReasoningEffort } from '../model/configuration.js';
 import type { ModelAdapter, ModelMessage } from '../model/contracts.js';
-import { resolveRolloutBudgetOptions } from '../runtime/rollout-budget.js';
 import { JsonlSessionStore } from '../session/jsonl-store.js';
 import { SubagentSessionController, type SubagentMailboxMessage, type SubagentMessageDelivery, type SubagentTurnHandle } from '../subagent/session-controller.js';
 import { createSessionToolScheduler } from '../tools/scheduler.js';
@@ -69,7 +68,6 @@ interface SessionServices {
     readonly store: JsonlSessionStore;
     readonly extensions: ExtensionManager;
     readonly registry: AgentSessionRegistry;
-    readonly rolloutBudgetOptions: ReturnType<typeof resolveRolloutBudgetOptions>;
     readonly hasCustomAdapters: boolean;
     readonly modelState: () => {
         readonly models: ReadonlyMap<string, ResolvedModelConfiguration>;

package/dist/agent-core/sdk/session.js

@@ -24,7 +24,6 @@ import { coreMcpCatalog } from '../extensions/mcp.js';
 import { isDeepStrictEqual } from 'node:util';
 import { MarAgentError, describeMarAgentError } from '../error.js';
 import { usesResponsesConfigurationUpdates } from '../model/configuration.js';
-import { executionBudgetEnvironmentEntry } from '../prompts/execution-budget.js';
 import { MAR_AGENT_PROMPT_VERSION, buildSystemPromptSections } from '../prompts/index.js';
 import { renderPromptSections } from '../extensions/prompt-composition.js';
 import { retainedSessionResourcesSnapshot } from '../prompts/resources.js';
@@ -37,7 +36,6 @@ import { ContextGcRuntime } from '../runtime/context/gc-runtime.js';
 import { AGENT_EXECUTION_POLICY } from '../runtime/execution-policy.js';
 import { loadAgentInstructions, renderAgentInstructions } from '../runtime/context/instructions.js';
 import { normalizeMessagesForModel } from '../runtime/context/normalize.js';
-import { RolloutBudget } from '../runtime/rollout-budget.js';
 import { compactSummaryFromCheckpoint, inputMetadataFromRecord } from '../session/jsonl-store.js';
 import { SubagentSessionController } from '../subagent/session-controller.js';
 import { agentStartToolDefinitionWithModels } from '../tools/agent/agent-start.js';
@@ -50,7 +48,7 @@ import { TodoStore } from '../tools/agent/todo.js';
 import { DeferredMcpRegistry } from '../tools/mcp/tool-search.js';
 /** SDK Session orchestration owns warm resources; Runtime owns only the model/tool loop. */
 export function createSessionOpener(services) {
-    const { host, description, settings, store, rolloutBudgetOptions, createAdapter, activeAdaptersExcept } = services;
+    const { host, description, settings, store, createAdapter, activeAdaptersExcept } = services;
     const { active, activeExecutionAdapters, executionResults, sessionRuntimes, sessionWriterOwner } = services.registry;
     const openSession = async (sessionId, workspace) => {
         const storedSession = await store.getSession(sessionId);
@@ -327,9 +325,6 @@ export function createSessionOpener(services) {
                 let finalAnswer = '';
                 let executionLoop;
                 let manualCompaction;
-                const rolloutBudget = sessionSource.type === 'user' && rolloutBudgetOptions
-                    ? new RolloutBudget(rolloutBudgetOptions)
-                    : undefined;
                 let releaseSession;
                 let executionToolSources;
                 let selectedTurn;
@@ -395,23 +390,6 @@ export function createSessionOpener(services) {
                     pendingAppends.length = 0;
                     immediateTarget = messages;
                     let recordedEnvironment = restored.environmentState;
-                    let projectedExecutionBudgetStage;
-                    const appendExecutionBudgetEnvironment = () => {
-                        rolloutBudget?.assertAvailable();
-                        const currentStage = rolloutBudget?.active ? rolloutBudget.stage : 'inactive';
-                        if (currentStage === 'exhausted')
-                            return;
-                        if (currentStage === projectedExecutionBudgetStage)
-                            return;
-                        const previousStage = projectedExecutionBudgetStage;
-                        projectedExecutionBudgetStage = currentStage;
-                        if ((previousStage === undefined &&
-                            (currentStage === 'normal' || currentStage === 'inactive')) ||
-                            (currentStage === 'inactive' && previousStage === 'normal'))
-                            return;
-                        const entry = executionBudgetEnvironmentEntry(currentStage === 'normal' ? 'inactive' : currentStage);
-                        messages.push(environmentContextUpdate(executionEnvironment, executionEnvironment, [entry]));
-                    };
                     let compactContext;
                     const writeInputRecord = async (content, type, metadata, call, committed) => {
                         call.signal.throwIfAborted();
@@ -1107,7 +1085,6 @@ export function createSessionOpener(services) {
                             manualCompactionStarted = true;
                             manualCompaction = createCompactionOperation(manualCompactionId, compactSignal);
                             await emit({ type: 'context.compacting', compactionId: manualCompactionId });
-                            rolloutBudget?.assertAvailable();
                             manualExtension = await generateCompactExtension(messages, 'manual', compactFocus, manualCompaction);
                         }
                         if (mode === 'compact' && manualExtension === undefined) {
@@ -1259,7 +1236,6 @@ export function createSessionOpener(services) {
                             }
                             if (!compactSummary)
                                 throw new MarAgentError('MAR_AGENT_COMPACT_FAILED', 'Automatic compact failed.');
-                            rolloutBudget?.recordUsage(latestUsage);
                             let replacementHistory = buildCompactedHistory(compactSummary, retainCurrent ? compactionUserMessages.slice(0, -1) : compactionUserMessages, compactUserTokenLimit, retainCurrent
                                 ? {
                                     content: current.content,
@@ -1297,7 +1273,6 @@ export function createSessionOpener(services) {
                             });
                             contextGc.reset();
                             restoreMcpDiscovery();
-                            projectedExecutionBudgetStage = undefined;
                             recordedEnvironment = executionEnvironment;
                             compactionUserMessages = replacementHistory
                                 .filter((message) => message.kind !== 'summary')
@@ -1337,7 +1312,6 @@ export function createSessionOpener(services) {
                             model: selectedModel,
                             messages,
                             toolImages: currentExecutionToolImages,
-                            rolloutBudget,
                             publish: emit,
                             appendContext: (message) => withRecordProjection(async () => {
                                 await store.append(sessionId, {
@@ -1350,7 +1324,6 @@ export function createSessionOpener(services) {
                             prepareRound: async (pendingOutputContinuation) => {
                                 if (mode !== 'compact')
                                     await appendMailboxMessages();
-                                appendExecutionBudgetEnvironment();
                                 updateMcpRegistry();
                                 executionTools = mcpRegistry.project(baseTools());
                                 if (mode !== 'compact')
@@ -1358,7 +1331,6 @@ export function createSessionOpener(services) {
                                 await ensureContextBudget();
                                 if (mode !== 'compact')
                                     await syncMcpWorldState(messages.length);
-                                appendExecutionBudgetEnvironment();
                                 if (mode !== 'compact') {
                                     executionEnvironment = { ...currentEnvironment, ...currentLocalTimeContext() };
                                     await recordEnvironment();
@@ -1491,7 +1463,6 @@ export function createSessionOpener(services) {
                                             .map((entry) => entry.message);
                                         messages.splice(0, messages.length, ...refreshed.messages, ...lateMessages);
                                         restoreMcpDiscovery();
-                                        projectedExecutionBudgetStage = undefined;
                                         recordedEnvironment = refreshed.environmentState;
                                         compactionUserMessages = [...refreshed.userMessages];
                                         agentInstructionInsertIndex = contextualInstructionInsertIndex(messages);
@@ -1512,8 +1483,6 @@ export function createSessionOpener(services) {
                             }
                         });
                         if (manualExtension) {
-                            rolloutBudget?.recordUsage(manualExtension.usage);
-                            rolloutBudget?.assertAvailable();
                             if (manualExtension.usage)
                                 await emit({ type: 'usage.updated', ...publicModelUsage(manualExtension.usage) });
                         }
@@ -1602,7 +1571,6 @@ export function createSessionOpener(services) {
                     if (sessionRuntime.toolSources === executionToolSources)
                         delete sessionRuntime.toolSources;
                     internal.signal?.removeEventListener('abort', abortSource);
-                    rolloutBudget?.discard();
                     await manualCompaction?.dispose();
                     await selectedTurn?.close().catch(() => undefined);
                     try {

package/dist/agent-core/sdk/types.d.ts

@@ -60,6 +60,7 @@ export interface CreateMarAgentOptions {
         readonly logicalPath: string;
         readonly physicalPath: string;
     };
+    /** @deprecated Accepted for source compatibility and otherwise ignored. */
     rolloutBudget?: false | RolloutBudgetOptions;
     runtimeExtensions?: readonly CoreRuntimeExtension[] | CoreExtensionSource;
 }

package/dist/agent-core/session/jsonl-store.js

@@ -1002,15 +1002,15 @@ export class JsonlSessionStore {
     }
     async #appendRecord(sessionId, input) {
         this.#assertOpen();
-        const meta = this.#shared.index.sessions.find((item) => item.id === sessionId) ??
+        const before = this.#shared.index.sessions.find((item) => item.id === sessionId) ??
             this.#shared.pendingSessions.get(sessionId);
-        if (!meta)
+        if (!before)
             throw new MarAgentError('MAR_AGENT_SESSION_NOT_FOUND', 'Session was not found.');
         const published = !this.#shared.pendingSessions.has(sessionId);
         const record = {
             schemaVersion: 1,
             recordId: randomUUID(),
-            sequence: meta.nextSequence,
+            sequence: before.nextSequence,
             timestamp: input.timestamp ?? new Date().toISOString(),
             sessionId,
             ...(input.executionId ? { executionId: input.executionId } : {}),
@@ -1019,7 +1019,7 @@ export class JsonlSessionStore {
             payload: input.payload
         };
         JSON.stringify(record); // Reject malformed payloads before binding resources.
-        await bindToolResultResources(this.sessionDirectory(sessionId), record, (sequence) => this.#readRecordAtSequence(meta, sequence), true);
+        await bindToolResultResources(this.sessionDirectory(sessionId), record, (sequence) => this.#readRecordAtSequence(before, sequence), true);
         const serialized = `${JSON.stringify(record)}\n`;
         let segment = await this.#currentSegment(sessionId);
         let path = this.#segmentPath(sessionId, segment);
@@ -1049,16 +1049,13 @@ export class JsonlSessionStore {
         finally {
             await handle.close();
         }
-        meta.nextSequence++;
-        await completeToolResultResources(this.sessionDirectory(sessionId), record);
-        if (record.type === 'turn.user' &&
-            isObject(record.payload) &&
-            Array.isArray(record.payload.images))
-            for (const image of record.payload.images)
-                if (isObject(image) &&
-                    typeof image.fileName === 'string' &&
-                    validInputImageFileName(image.fileName))
-                    await rm(join(this.sessionDirectory(sessionId), 'input_images', `.${image.fileName}.pending`), { force: true }).catch(() => undefined);
+        // Index refreshes and commits can replace metadata during file I/O. Publish all
+        // durable-record metadata onto the current entry without another await boundary.
+        const meta = this.#shared.index.sessions.find((item) => item.id === sessionId) ??
+            this.#shared.pendingSessions.get(sessionId);
+        if (!meta)
+            throw new MarAgentError('MAR_AGENT_SESSION_NOT_FOUND', 'Session was not found.');
+        meta.nextSequence = record.sequence + 1;
         const segmentMetadata = meta.segments ?? (meta.segments = []);
         const known = segmentMetadata.find((item) => item.number === segment);
         if (known) {
@@ -1078,6 +1075,15 @@ export class JsonlSessionStore {
             this.#shared.index.revision++;
             this.#markIndexDirty(sessionId);
         }
+        await completeToolResultResources(this.sessionDirectory(sessionId), record);
+        if (record.type === 'turn.user' &&
+            isObject(record.payload) &&
+            Array.isArray(record.payload.images))
+            for (const image of record.payload.images)
+                if (isObject(image) &&
+                    typeof image.fileName === 'string' &&
+                    validInputImageFileName(image.fileName))
+                    await rm(join(this.sessionDirectory(sessionId), 'input_images', `.${image.fileName}.pending`), { force: true }).catch(() => undefined);
         return record;
     }
     async read(sessionId) {
@@ -1815,7 +1821,6 @@ export class JsonlSessionStore {
     }
     /** Repair the last segment and pending images under the lease, then sync sequence metadata. */
     async #reconcileTail(sessionId) {
-        const meta = this.#shared.index.sessions.find((item) => item.id === sessionId);
         const paths = await this.#segmentPaths(sessionId);
         const latestPath = paths.at(-1);
         await repairSegmentTail(latestPath);
@@ -1830,6 +1835,8 @@ export class JsonlSessionStore {
             throw new MarAgentError('MAR_AGENT_SESSION_CORRUPT', 'Session history is corrupt.');
         const bytes = (await stat(latestPath)).size;
         const firstSequence = records[0].sequence;
+        // Tail recovery must publish onto metadata that is current after all file I/O.
+        const meta = this.#shared.index.sessions.find((item) => item.id === sessionId);
         const known = meta.segments?.find((item) => item.number === segment);
         const titleRecord = records.findLast((record) => record.type === 'session.title.updated' &&
             typeof record.payload.title === 'string');

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@myagentroam/agent",
-  "version": "0.10.11",
+  "version": "0.10.13",
   "description": "Embeddable MAR coding agent SDK and CLI.",
   "license": "Apache-2.0",
   "type": "module",

package/dist/agent-core/prompts/execution-budget.d.ts

@@ -1,3 +0,0 @@
-import type { RolloutBudgetStage } from '../runtime/rollout-budget.js';
-export type ExecutionBudgetEnvironmentStage = Exclude<RolloutBudgetStage, 'normal' | 'exhausted'> | 'inactive';
-export declare function executionBudgetEnvironmentEntry(stage: ExecutionBudgetEnvironmentStage): string;

package/dist/agent-core/prompts/execution-budget.js

@@ -1,9 +0,0 @@
-export function executionBudgetEnvironmentEntry(stage) {
-    if (stage === 'inactive')
-        return '<execution_guidance status="inactive" />';
-    const privateInstruction = 'This is internal runtime guidance. Never mention the budget, thresholds, remaining amount, or budget stage in user-visible progress or the final answer.';
-    const guidance = stage === 'finalize'
-        ? 'Enter finalization now. Do not start new investigation or new subagents. Complete only the current atomic change, the minimum necessary verification, and the final answer as soon as possible.'
-        : 'Stop expanding scope and stop optional work. Prefer completing the current objective with the evidence already gathered, and avoid new investigation unless it is strictly required for correctness.';
-    return `<execution_guidance stage="${stage}">\n${privateInstruction}\n\n${guidance}\n</execution_guidance>`;
-}

package/dist/agent-core/runtime/rollout-budget.d.ts

@@ -1,25 +0,0 @@
-import type { ModelUsage } from '../model/contracts.js';
-import type { RolloutBudgetOptions } from './contracts.js';
-export type RolloutBudgetStage = 'normal' | 'conserve' | 'finalize' | 'exhausted';
-export interface ResolvedRolloutBudgetOptions {
-    limitTokens: number;
-    conserveAtRemainingTokens: number;
-    finalizeAtRemainingTokens: number;
-    samplingTokenWeight: number;
-    prefillTokenWeight: number;
-}
-export declare class RolloutBudget {
-    #private;
-    readonly options: ResolvedRolloutBudgetOptions;
-    constructor(options: ResolvedRolloutBudgetOptions);
-    get active(): boolean;
-    get limitTokens(): number;
-    get spentTokens(): number;
-    get remainingTokens(): number;
-    get stage(): RolloutBudgetStage;
-    recordUsage(usage: ModelUsage | undefined): number;
-    discard(): void;
-    assertAvailable(): void;
-}
-export declare function resolveRolloutBudgetOptions(options: false | RolloutBudgetOptions | undefined): ResolvedRolloutBudgetOptions | undefined;
-export declare function createRolloutBudget(options: false | RolloutBudgetOptions | undefined): RolloutBudget | undefined;

package/dist/agent-core/runtime/rollout-budget.js

@@ -1,96 +0,0 @@
-import { MarAgentError } from '../error.js';
-import { AGENT_EXECUTION_POLICY } from './execution-policy.js';
-export class RolloutBudget {
-    options;
-    #spentTokens = 0;
-    #active = true;
-    constructor(options) {
-        this.options = options;
-    }
-    get active() {
-        return this.#active;
-    }
-    get limitTokens() {
-        return this.options.limitTokens;
-    }
-    get spentTokens() {
-        return this.#spentTokens;
-    }
-    get remainingTokens() {
-        return Math.max(0, this.limitTokens - this.#spentTokens);
-    }
-    get stage() {
-        if (!this.#active)
-            return 'normal';
-        const remaining = this.remainingTokens;
-        if (remaining <= 0)
-            return 'exhausted';
-        if (remaining <= this.options.finalizeAtRemainingTokens)
-            return 'finalize';
-        if (remaining <= this.options.conserveAtRemainingTokens)
-            return 'conserve';
-        return 'normal';
-    }
-    recordUsage(usage) {
-        if (!this.#active || !usage)
-            return 0;
-        const providerUnits = usage.rolloutBudgetUnits;
-        if (providerUnits !== undefined && (!Number.isFinite(providerUnits) || providerUnits < 0))
-            throw new MarAgentError('MAR_AGENT_MODEL_PROTOCOL_ERROR', 'Provider rollout budget units are invalid.');
-        const charged = providerUnits ??
-            nonnegative(usage.outputTokens) * this.options.samplingTokenWeight +
-                Math.max(nonnegative(usage.contextInputTokens ?? usage.inputTokens) -
-                    nonnegative(usage.cacheReadTokens), 0) *
-                    this.options.prefillTokenWeight;
-        this.#spentTokens += charged;
-        return charged;
-    }
-    discard() {
-        this.#active = false;
-    }
-    assertAvailable() {
-        if (this.stage === 'exhausted')
-            throw new MarAgentError('MAR_AGENT_ROLLOUT_BUDGET_EXCEEDED', 'The execution token budget has been exhausted.');
-    }
-}
-export function resolveRolloutBudgetOptions(options) {
-    if (options === false)
-        return undefined;
-    const limitTokens = options?.limitTokens ?? AGENT_EXECUTION_POLICY.rolloutBudgetTokens;
-    if (!Number.isSafeInteger(limitTokens) || limitTokens < 2)
-        return invalid();
-    const conserveAtRemainingTokens = options?.conserveAtRemainingTokens ??
-        Math.min(AGENT_EXECUTION_POLICY.rolloutBudgetConserveRemainingTokens, Math.max(1, Math.floor(limitTokens * 0.28)));
-    const finalizeAtRemainingTokens = options?.finalizeAtRemainingTokens ??
-        Math.min(AGENT_EXECUTION_POLICY.rolloutBudgetFinalizeRemainingTokens, Math.max(0, Math.min(conserveAtRemainingTokens - 1, Math.floor(limitTokens * 0.16))));
-    const samplingTokenWeight = options?.samplingTokenWeight ?? AGENT_EXECUTION_POLICY.rolloutBudgetSamplingTokenWeight;
-    const prefillTokenWeight = options?.prefillTokenWeight ?? AGENT_EXECUTION_POLICY.rolloutBudgetPrefillTokenWeight;
-    if (!Number.isSafeInteger(conserveAtRemainingTokens) ||
-        conserveAtRemainingTokens < 0 ||
-        conserveAtRemainingTokens >= limitTokens ||
-        !Number.isSafeInteger(finalizeAtRemainingTokens) ||
-        finalizeAtRemainingTokens < 0 ||
-        finalizeAtRemainingTokens >= conserveAtRemainingTokens ||
-        !Number.isFinite(samplingTokenWeight) ||
-        samplingTokenWeight < 0 ||
-        !Number.isFinite(prefillTokenWeight) ||
-        prefillTokenWeight < 0)
-        return invalid();
-    return {
-        limitTokens,
-        conserveAtRemainingTokens,
-        finalizeAtRemainingTokens,
-        samplingTokenWeight,
-        prefillTokenWeight
-    };
-}
-export function createRolloutBudget(options) {
-    const resolved = resolveRolloutBudgetOptions(options);
-    return resolved ? new RolloutBudget(resolved) : undefined;
-}
-function nonnegative(value) {
-    return value !== undefined && Number.isFinite(value) && value >= 0 ? value : 0;
-}
-function invalid() {
-    throw new MarAgentError('MAR_AGENT_ROLLOUT_BUDGET_INVALID', 'Rollout budget configuration is invalid.');
-}