@sema-agent/core 5.7.0 → 5.9.0

package/dist/engine/session/repo-utils.js

@@ -10,13 +10,6 @@ export function createTimestamp() {
 export function toSession(storage) {
     return new StoredSession(storage);
 }
-export function getFileSystemResultOrThrow(result, message) {
-    if (!result.ok) {
-        const code = result.error.code === "not_found" ? "not_found" : "storage";
-        throw new SessionError(code, `${message}: ${result.error.message}`, result.error);
-    }
-    return result.value;
-}
 function rerootIfHeadless(storage, entries) {
     const head = entries[0];
     if (head === undefined || head.parentId === null)

package/dist/index.d.ts

@@ -1,4 +1,6 @@
-export { Runner, runTask, DEFAULT_MAX_TURNS } from "./core/runner/runtask.js";
+export { Runner, runTask } from "./core/runner/runtask.js";
+export { resolveTaskLimits } from "./core/runner/prepare-task.js";
+export type { BudgetAxis } from "./core/runner/assemble-result.js";
 export { SESSION_LOG_DIGEST_SCHEME, sessionEntryDigest, sessionLogDigest, sessionLogDigestsComparable, } from "./engine/session/log-digest.js";
 export type { ResumeTaskConfig } from "./core/runner/runtask.js";
 export { defineTool } from "./core/tools.js";
@@ -75,7 +77,10 @@ export { HAND_TOOL_EFFECTS, bashReversibilityProbe, BASH_READONLY_DEFAULT_ALLOW,
 export { classifyCompoundReadonlyDetailed, formatOutOfRootReadApprovalOption, type BashReadonlyRootBoundary, type CompoundReadonlyVerdict, } from "./tools/fs/index.js";
 export { resolveBashTimeoutCaps } from "./tools/fs/index.js";
 export { InMemoryToolResultStore, OFFLOAD_TOOL_NAME, DEFAULT_TOOL_RESULT_THRESHOLD_CHARS, assertSafeToolResultRef, type ToolResultStore, type ToolResultSlice, } from "./core/tool-result-store.js";
-export { InMemoryCheckpointStore, CheckpointError, mintCheckpointToken, checkpointVersionOf, CURRENT_CHECKPOINT_VERSION, MAX_SUPPORTED_CHECKPOINT_VERSION, RESOURCE_CHECKPOINT_VERSION, WALLTIME_CHECKPOINT_VERSION, debitLedger, remainingBudgetMicroUsd, remainingWalltimeMs, winnerFromOutcome, validatePendingSteer, riskSeverity, buildRiskDescriptor, summarizeCheckpoint, type RiskDescriptor, type CheckpointStore, type CheckpointSummary, type Checkpoint, type CheckpointToken, type CheckpointGate, type CheckpointState, type SerializedCheckpointState, type CheckpointFaultMode, type PendingAction, type ResumeOutcome, type ResolvedOutcome, type ReopenReason, type ResolveExpectation, type SafetyAxis, type ResourceLedger, type ResourceLimitReason, } from "./core/checkpoint-store.js";
+export { InMemoryCheckpointStore, CheckpointError, mintCheckpointToken, checkpointVersionOf, CURRENT_CHECKPOINT_VERSION, MAX_SUPPORTED_CHECKPOINT_VERSION, RESOURCE_CHECKPOINT_VERSION, TOKEN_CHECKPOINT_VERSION, debitLedger, remainingBudgetMicroUsd, remainingTokens, winnerFromOutcome, validatePendingSteer, riskSeverity, buildRiskDescriptor, summarizeCheckpoint, type RiskDescriptor, type CheckpointStore, type CheckpointSummary, type Checkpoint, type CheckpointToken, type CheckpointGate, type CheckpointState, type SerializedCheckpointState, type CheckpointFaultMode, type PendingAction, type ResumeOutcome, type ResolvedOutcome, type ReopenReason, type ResolveExpectation, type SafetyAxis, type ResourceLedger, type ResourceLimitReason, type PlatformLimitReason, } from "./core/checkpoint-store.js";
+export { InMemoryUsageWindowStore, GLOBAL_USAGE_KEY, EMPTY_USAGE_WINDOW_RECORD, chargeUsageRecord, readUsageRecord, usageRetryAfterMs, resolveUsageWindows, type UsageWindow, type UsageWindowStore, type UsageWindowReading, type UsageWindowRecord, type UsageSlot, type UsageBucketRow, } from "./core/usage-window-store.js";
+export { FileUsageWindowStore } from "./stores/file/usage-window-store.js";
+export { ENV_LIFETIME_SUSPEND_MARGIN_MS, USAGE_WINDOW_REAP_MARGIN_MS } from "./core/runner/prepare-task.js";
 export { InMemoryFileSnapshotStore, DEFAULT_SNAPSHOT_BOUNDS } from "./core/file-snapshot-store.js";
 export { captureManifest, applyManifest } from "./core/file-snapshot-store.js";
 export type { FileSnapshotStore, FileSnapshotResult, FileSnapshotError, FileSnapshotBounds } from "./core/file-snapshot-store.js";
@@ -86,7 +91,7 @@ export { brainToRuntime } from "./core/runtime.js";
 export { createSensitivePathPolicy, RECOMMENDED_SENSITIVE_PATTERNS } from "./core/sensitive-path-policy.js";
 export { createFsWriteGatePolicy, type FsWriteGatePolicyOptions } from "./core/fs-write-gate-policy.js";
 export { RETIRED_TOOL_NAMES } from "./core/tool-name-aliases.js";
-export { DEFAULT_SUBAGENT_TOOL_NAME, SESSION_BG_DEFAULT_TIMEOUT_SEC } from "./agents/subagent.js";
+export { DEFAULT_SUBAGENT_TOOL_NAME } from "./agents/subagent.js";
 export { renderTaskNotificationXml, taskNotificationDedupKey, SystemInjectionQueue, type TaskNotificationPayload, type TaskNotificationStatus, type ExternalNotificationInput, type SystemInjection, type SystemInjectionPriority, } from "./core/task-notification.js";
 export { TaskRegistry, defaultTaskRegistry, createTaskOutputTool, createTaskStopTool, type SemaTaskType, type SemaTaskStatus, type SemaTaskHandle, type ParkedClaimTicket, type TaskAccess, type UnifiedTaskOutput, type TaskRetrievalStatus, type StopSource, type RegisterMonitorInput, type MonitorTimers, MONITOR_BATCH_WINDOW_MS, MONITOR_DEFAULT_TIMEOUT_MS, MONITOR_MAX_TIMEOUT_MS, MONITOR_MAX_BATCHES_PER_MINUTE, canAccessWorkflowRun, DURABLE_AGENT_HANDLE_RE, } from "./core/task-registry.js";
 export { InMemoryMailboxStore, type MailboxStore, type MailboxMessage, type MailboxLease } from "./core/mailbox-store.js";
@@ -108,7 +113,7 @@ export type { SchedulerCapability, SchedulerErrorCode, ScheduledIntent, Schedule
 export { createSchedulerTools, type SchedulerToolContext, SCHEDULE_WAKEUP_TOOL_NAME, AUTONOMOUS_LOOP_SENTINEL, AUTONOMOUS_LOOP_DYNAMIC_SENTINEL, } from "./tools/scheduler-tools.js";
 export { resolveAutonomousLoopPrompt, AUTONOMOUS_LOOP_PREAMBLE, AUTONOMOUS_LOOP_PREAMBLE_PERSISTENT, type AutonomousLoopPromptOptions, } from "./tools/loop-tick.js";
 export { tightenTaskSpec, TaskSpecTightenError } from "./core/tighten-task-spec.js";
-export { createAllowDenyPolicy, createApprovalPolicy, COARSE_SHELL_TOOLS, createCoarseCommandNamePolicy, createTranscriptIntegrityPolicy, createUnverifiableDeletePolicy, findUnverifiableRecursiveDelete, combinePolicies, decisionText, resolveAsk, toolPolicyNameSets, type ToolPolicyNameSets, type NamedToolPolicy, type ToolPolicy, type ToolCallRequest, type PermissionResult, type DecisionReason, type OnAsk, type AskOutcome, type ResolvedAsk, type AskRequest, } from "./core/tool-policy.js";
+export { createAllowDenyPolicy, createApprovalPolicy, COARSE_SHELL_TOOLS, createCoarseCommandNamePolicy, createTranscriptIntegrityPolicy, createUnverifiableDeletePolicy, findUnverifiableRecursiveDelete, combinePolicies, decisionText, resolveAsk, toolPolicyNameSets, type ToolPolicyNameSets, type NamedToolPolicy, type ToolPolicy, type ToolCallRequest, type PermissionResult, type DecisionReason, type OnAsk, type AskOutcome, type ResolvedAsk, type AskRequest, type AskDelegationProvenance, } from "./core/tool-policy.js";
 export { parseAutoModeResponse, createAutoModeDecider, type AutoModeVerdict, type AutoModeDecider, type AutoModeDeciderOptions, type AutoModeClassifyFn, type AutoModeClassifyInput, } from "./core/auto-mode.js";
 export { buildAutoModePrompt, renderAutoModeWindow, renderAutoModeAction, AUTO_MODE_DEFAULTS_SENTINEL, type AutoModeRules, type BuildAutoModePromptOptions, type AutoModeWindowOptions, } from "./core/auto-mode-prompt.js";
 export { AUTO_MODE_BASE_PROMPT, AUTO_MODE_PERMISSIONS_EXTERNAL } from "./core/auto-mode-prompt-assets.js";
@@ -146,7 +151,7 @@ export { runSpec, type RunSpecOptions, type RunSpecResult, type RunSpecOracleRep
 export { isSelfOrchestrationActive, workflowsCapability, selfOrchestrationFailClosedReason, type WorkflowScriptRunner, type WorkflowMeta, type WorkflowPrimitives, } from "./orchestration/workflow-script-runner.js";
 export { devWorkflowScriptRunner } from "./orchestration/dev-vm-script-runner.js";
 export { parseWorkflowMeta, splitWorkflowMeta, WorkflowScriptError, workflowScriptReadsClockOrRandom } from "./orchestration/workflow-meta.js";
-export { assertWorkflowSandboxConformance, assertWorkflowPrimitivesWiring } from "./orchestration/workflow-sandbox-conformance.js";
+export { assertWorkflowSandboxConformance, assertWorkflowPrimitivesWiring, assertWorkflowDeterminism } from "./orchestration/workflow-sandbox-conformance.js";
 export { WorkflowModelNotAllowedError, type WorkflowAgentSpec } from "./orchestration/workflow-governance.js";
 export { WorkflowMaxAgentsError, WorkflowResultTooLargeError } from "./orchestration/workflow.js";
 export { createFileWorkflowScriptStore, mergeWorkflowArgs, type WorkflowScriptStore, type NamedWorkflowResolution, type NamedWorkflowListing, } from "./orchestration/workflow-script-store.js";
@@ -179,7 +184,7 @@ export { MemoryRosterStore, FileRosterStore, type RosterStore, type RosterEntry,
 export { CONFIG_CATALOG_VERSION, describeConfigCatalog, resolveEffectiveConfig, type ConfigKnob, type ConfigOverrideDeclaration, type ConfigProvenance, type EffectiveConfigField, } from "./config/catalog.js";
 export { normalizeAgentName } from "./core/task-registry.js";
 export { COORDINATOR_ROLE_PROMPT, TEAMMATE_COMMUNICATION_ADDENDUM, TEAMMATE_TASK_LIST_ADDENDUM } from "./prompts/coordinator.js";
-export { createSubagentTool, FORK_SUBAGENT_TYPE, GENERAL_PURPOSE_SUBAGENT_TYPE, FORK_DEFAULT_MAX_TURNS, agentWhenToUseText, FORK_DIRECTIVE_FRAME, SUBAGENT_SYSTEM_NOTE, type SubagentToolOptions, type SubagentSpawnContext, type SubagentSteerHandle, type SubagentStep, type SubagentEditedFile, } from "./agents/subagent.js";
+export { createSubagentTool, FORK_SUBAGENT_TYPE, GENERAL_PURPOSE_SUBAGENT_TYPE, agentWhenToUseText, FORK_DIRECTIVE_FRAME, SUBAGENT_SYSTEM_NOTE, type SubagentToolOptions, type SubagentSpawnContext, type SubagentSteerHandle, type SubagentStep, type SubagentEditedFile, } from "./agents/subagent.js";
 export { getSessionRetainLedger, releaseSessionRetainLedger, } from "./agents/retain-ledger.js";
 export { createSendMessageTool, SEND_MESSAGE_TOOL_NAME, type SendMessageToolOptions } from "./agents/send-message-tool.js";
 export { createAgentTranscriptTool, AGENT_TRANSCRIPT_TOOL_NAME, type AgentTranscriptToolOptions, } from "./agents/agent-transcript-tool.js";
@@ -190,6 +195,7 @@ export { createTaskServer, type TaskServerOptions, type TaskRequestBody, } from
 export { clearStaleToolResults, COMPACTABLE_TOOLS, editBudget, type ContextEditOptions, } from "./core/context-edit.js";
 export { createOpenAIBrain, type OpenAIBrainConfig } from "./brain/openai.js";
 export { createAnthropicBrain, type AnthropicBrainConfig } from "./brain/anthropic.js";
+export { createOpenResponsesBrain, type OpenResponsesBrainConfig } from "./brain/open-responses.js";
 export { FABLE_5_COMPAT, fable5Model } from "./brain/model-presets.js";
 export { createFailoverBrain } from "./brain/failover.js";
 export { createRoutingBrain, type RoutingBrainOptions } from "./brain/routing.js";
@@ -200,7 +206,7 @@ export { retryBackoffMs, parseRetryAfter } from "./brain/retry.js";
 export { type BrainTimeoutConfig } from "./brain/timeout.js";
 export { createAssistantMessageEventStream } from "./internal/llm.js";
 export type { AssistantMessage, AssistantMessageEvent, CompleteSimpleFn, Context, DocumentContent, ImageContent, Message, StopReason, StreamFn, TextContent, ThinkingContent, ToolCall, ToolResultMessage, Usage, UserMessage, } from "./internal/llm.js";
-export type { AgentDefinition, BeforeWriteHook, BeforeWriteRequest, BeforeWriteResult, HandsBandOptions, Brain, BrainStatus, BrainStatusPhase, ImageInput, McpElicitRequest, McpElicitResponse, McpServerSpec, A2aServerSpec, OnElicit, Model, ModelRef, ProjectMemoryLoad, RunnerDeps, RuntimeCaps, BackgroundChildEvent, SkillManifest, SkillSpec, TaskEvent, TaskEventIdentity, ToolActivity, TaskResult, RemoteEnvFailureNote, TaskSpec, TaskStatus, TaskStream, CompactOutcome, ThinkingLevel, ToolExecuteContext, ToolReturn, ToolSpec, ToolEffect, WorkflowGovernanceBaseline, } from "./core/types.js";
+export type { AgentDefinition, BeforeWriteHook, BeforeWriteRequest, BeforeWriteResult, HandsBandOptions, Brain, BrainStatus, BrainStatusPhase, ImageInput, McpElicitRequest, McpElicitResponse, McpServerSpec, A2aServerSpec, OnElicit, Model, ModelRef, ProjectMemoryLoad, RunnerDeps, RuntimeCaps, BackgroundChildEvent, SkillManifest, SkillSpec, TaskEvent, TaskEventIdentity, ToolActivity, TaskLimits, TaskResult, RemoteEnvFailureNote, TaskSpec, TaskStatus, TaskStream, CompactOutcome, ThinkingLevel, ToolExecuteContext, ToolReturn, ToolSpec, ToolEffect, WorkflowGovernanceBaseline, } from "./core/types.js";
 export { Type } from "typebox";
 export type { TSchema, Static } from "typebox";
 export { explainPromptAssembly, describeDefaultPack, type DefaultPackDescription, type ExplainInput } from "./prompt-assembly/explain.js";

package/dist/index.js

@@ -1,4 +1,5 @@
-export { Runner, runTask, DEFAULT_MAX_TURNS } from "./core/runner/runtask.js";
+export { Runner, runTask } from "./core/runner/runtask.js";
+export { resolveTaskLimits } from "./core/runner/prepare-task.js";
 export { SESSION_LOG_DIGEST_SCHEME, sessionEntryDigest, sessionLogDigest, sessionLogDigestsComparable, } from "./engine/session/log-digest.js";
 export { defineTool } from "./core/tools.js";
 export { SKILL_TOOL_NAME } from "./core/runner/synthetic-tools.js";
@@ -64,7 +65,10 @@ export { HAND_TOOL_EFFECTS, bashReversibilityProbe, BASH_READONLY_DEFAULT_ALLOW,
 export { classifyCompoundReadonlyDetailed, formatOutOfRootReadApprovalOption, } from "./tools/fs/index.js";
 export { resolveBashTimeoutCaps } from "./tools/fs/index.js";
 export { InMemoryToolResultStore, OFFLOAD_TOOL_NAME, DEFAULT_TOOL_RESULT_THRESHOLD_CHARS, assertSafeToolResultRef, } from "./core/tool-result-store.js";
-export { InMemoryCheckpointStore, CheckpointError, mintCheckpointToken, checkpointVersionOf, CURRENT_CHECKPOINT_VERSION, MAX_SUPPORTED_CHECKPOINT_VERSION, RESOURCE_CHECKPOINT_VERSION, WALLTIME_CHECKPOINT_VERSION, debitLedger, remainingBudgetMicroUsd, remainingWalltimeMs, winnerFromOutcome, validatePendingSteer, riskSeverity, buildRiskDescriptor, summarizeCheckpoint, } from "./core/checkpoint-store.js";
+export { InMemoryCheckpointStore, CheckpointError, mintCheckpointToken, checkpointVersionOf, CURRENT_CHECKPOINT_VERSION, MAX_SUPPORTED_CHECKPOINT_VERSION, RESOURCE_CHECKPOINT_VERSION, TOKEN_CHECKPOINT_VERSION, debitLedger, remainingBudgetMicroUsd, remainingTokens, winnerFromOutcome, validatePendingSteer, riskSeverity, buildRiskDescriptor, summarizeCheckpoint, } from "./core/checkpoint-store.js";
+export { InMemoryUsageWindowStore, GLOBAL_USAGE_KEY, EMPTY_USAGE_WINDOW_RECORD, chargeUsageRecord, readUsageRecord, usageRetryAfterMs, resolveUsageWindows, } from "./core/usage-window-store.js";
+export { FileUsageWindowStore } from "./stores/file/usage-window-store.js";
+export { ENV_LIFETIME_SUSPEND_MARGIN_MS, USAGE_WINDOW_REAP_MARGIN_MS } from "./core/runner/prepare-task.js";
 export { InMemoryFileSnapshotStore, DEFAULT_SNAPSHOT_BOUNDS } from "./core/file-snapshot-store.js";
 export { captureManifest, applyManifest } from "./core/file-snapshot-store.js";
 export { FileStorageBackend, FileSessionRepo, FileCheckpointStore, FileMemoryStore, FileToolResultStore, FileSessionPolicyStore, FileFileSnapshotStore, FileWorkflowJournalStore, MAX_JOURNAL_RESULT_BYTES, oversizeJournalResult, resolveDataRoot, sanitizeScope, sanitizePathComponent, createFileConsolidationLock, atomicWriteFile, writeThenLink, ensureDir, readJsonlRecords, AppendLog, } from "./stores/file/index.js";
@@ -74,7 +78,7 @@ export { brainToRuntime } from "./core/runtime.js";
 export { createSensitivePathPolicy, RECOMMENDED_SENSITIVE_PATTERNS } from "./core/sensitive-path-policy.js";
 export { createFsWriteGatePolicy } from "./core/fs-write-gate-policy.js";
 export { RETIRED_TOOL_NAMES } from "./core/tool-name-aliases.js";
-export { DEFAULT_SUBAGENT_TOOL_NAME, SESSION_BG_DEFAULT_TIMEOUT_SEC } from "./agents/subagent.js";
+export { DEFAULT_SUBAGENT_TOOL_NAME } from "./agents/subagent.js";
 export { renderTaskNotificationXml, taskNotificationDedupKey, SystemInjectionQueue, } from "./core/task-notification.js";
 export { TaskRegistry, defaultTaskRegistry, createTaskOutputTool, createTaskStopTool, MONITOR_BATCH_WINDOW_MS, MONITOR_DEFAULT_TIMEOUT_MS, MONITOR_MAX_TIMEOUT_MS, MONITOR_MAX_BATCHES_PER_MINUTE, canAccessWorkflowRun, DURABLE_AGENT_HANDLE_RE, } from "./core/task-registry.js";
 export { InMemoryMailboxStore } from "./core/mailbox-store.js";
@@ -131,7 +135,7 @@ export { runSpec } from "./orchestration/run-spec.js";
 export { isSelfOrchestrationActive, workflowsCapability, selfOrchestrationFailClosedReason, } from "./orchestration/workflow-script-runner.js";
 export { devWorkflowScriptRunner } from "./orchestration/dev-vm-script-runner.js";
 export { parseWorkflowMeta, splitWorkflowMeta, WorkflowScriptError, workflowScriptReadsClockOrRandom } from "./orchestration/workflow-meta.js";
-export { assertWorkflowSandboxConformance, assertWorkflowPrimitivesWiring } from "./orchestration/workflow-sandbox-conformance.js";
+export { assertWorkflowSandboxConformance, assertWorkflowPrimitivesWiring, assertWorkflowDeterminism } from "./orchestration/workflow-sandbox-conformance.js";
 export { WorkflowModelNotAllowedError } from "./orchestration/workflow-governance.js";
 export { WorkflowMaxAgentsError, WorkflowResultTooLargeError } from "./orchestration/workflow.js";
 export { createFileWorkflowScriptStore, mergeWorkflowArgs, } from "./orchestration/workflow-script-store.js";
@@ -162,7 +166,7 @@ export { MemoryRosterStore, FileRosterStore } from "./agents/roster-store.js";
 export { CONFIG_CATALOG_VERSION, describeConfigCatalog, resolveEffectiveConfig, } from "./config/catalog.js";
 export { normalizeAgentName } from "./core/task-registry.js";
 export { COORDINATOR_ROLE_PROMPT, TEAMMATE_COMMUNICATION_ADDENDUM, TEAMMATE_TASK_LIST_ADDENDUM } from "./prompts/coordinator.js";
-export { createSubagentTool, FORK_SUBAGENT_TYPE, GENERAL_PURPOSE_SUBAGENT_TYPE, FORK_DEFAULT_MAX_TURNS, agentWhenToUseText, FORK_DIRECTIVE_FRAME, SUBAGENT_SYSTEM_NOTE, } from "./agents/subagent.js";
+export { createSubagentTool, FORK_SUBAGENT_TYPE, GENERAL_PURPOSE_SUBAGENT_TYPE, agentWhenToUseText, FORK_DIRECTIVE_FRAME, SUBAGENT_SYSTEM_NOTE, } from "./agents/subagent.js";
 export { getSessionRetainLedger, releaseSessionRetainLedger, } from "./agents/retain-ledger.js";
 export { createSendMessageTool, SEND_MESSAGE_TOOL_NAME } from "./agents/send-message-tool.js";
 export { createAgentTranscriptTool, AGENT_TRANSCRIPT_TOOL_NAME, } from "./agents/agent-transcript-tool.js";
@@ -173,6 +177,7 @@ export { createTaskServer, } from "./server/http.js";
 export { clearStaleToolResults, COMPACTABLE_TOOLS, editBudget, } from "./core/context-edit.js";
 export { createOpenAIBrain } from "./brain/openai.js";
 export { createAnthropicBrain } from "./brain/anthropic.js";
+export { createOpenResponsesBrain } from "./brain/open-responses.js";
 export { FABLE_5_COMPAT, fable5Model } from "./brain/model-presets.js";
 export { createFailoverBrain } from "./brain/failover.js";
 export { createRoutingBrain } from "./brain/routing.js";

package/dist/internal/llm.d.ts

@@ -1,2 +1,2 @@
 export { createAssistantMessageEventStream, stripEngineMetadata } from "../engine/llm/index.js";
-export type { AnthropicMessagesCompat, AssistantMessage, AssistantMessageDiagnostic, AssistantMessageEvent, CompleteSimpleFn, Context, DocumentContent, ImageContent, Message, Model, ResilienceOptions, SimpleStreamOptions, StallTimeouts, StopReason, StreamFn, TextContent, ThinkingContent, Tool, ToolCall, ToolResultMessage, Usage, UserMessage, } from "../engine/llm/index.js";
+export type { AnthropicMessagesCompat, OpenAICompletionsCompat, OpenAIResponsesCompat, AssistantMessage, AssistantMessageDiagnostic, AssistantMessageEvent, CompleteSimpleFn, Context, DocumentContent, ImageContent, Message, Model, ResilienceOptions, SimpleStreamOptions, StallTimeouts, StopReason, StreamFn, TextContent, ThinkingContent, Tool, ToolCall, ToolResultMessage, Usage, UserMessage, } from "../engine/llm/index.js";

package/dist/orchestration/goal.js

@@ -148,16 +148,12 @@ export async function runGoal(runner, spec) {
             if (result.status === "blocked")
                 return mk("blocked", iteration, { result });
             if (result.status === "failed") {
-                if (result.errorCode === "limit.max_turns") {
+                if (result.errorCode !== undefined && result.errorCode.startsWith("limits.max_")) {
                     lastFeedback = TIMEOUT_FEEDBACK;
                     continue;
                 }
                 return mk("failed", iteration, { result, errorCode: result.errorCode });
             }
-            if (result.status === "timeout") {
-                lastFeedback = TIMEOUT_FEEDBACK;
-                continue;
-            }
             const gate1 = hasOutputSchema ? result.structuredOutput !== undefined : doneRef.declared === true;
             if (!gate1) {
                 lastFeedback = NOT_DECLARED_FEEDBACK;

package/dist/orchestration/run-workflow-tool.d.ts

@@ -38,7 +38,7 @@ export interface WorkflowLimits {
     maxScriptChars?: number;
     maxAgents?: number;
     totalTimeoutMs?: number;
-    perAgentTimeoutSec?: number;
+    perAgentMaxWalltimeMs?: number;
     childMaxCostUsd?: number;
     childMaxTokens?: number;
     childMaxTurns?: number;

package/dist/orchestration/run-workflow-tool.js

@@ -17,7 +17,6 @@ const DEFAULTS = {
     maxScriptChars: 100_000,
     maxAgents: 50,
     totalTimeoutMs: 600_000,
-    perAgentTimeoutSec: 300,
     maxResultChars: 100_000,
     maxLogChars: 10_000,
 };
@@ -141,7 +140,7 @@ export async function createRunWorkflowTool(d) {
     const lim = d.limits ?? {};
     const maxScriptChars = lim.maxScriptChars ?? DEFAULTS.maxScriptChars;
     const childCaps = {
-        perAgentTimeoutSec: lim.perAgentTimeoutSec ?? DEFAULTS.perAgentTimeoutSec,
+        perAgentMaxWalltimeMs: lim.perAgentMaxWalltimeMs,
         childMaxCostUsd: lim.childMaxCostUsd,
         childMaxTokens: lim.childMaxTokens,
         childMaxTurns: lim.childMaxTurns,

package/dist/orchestration/workflow-governance.d.ts

@@ -13,20 +13,20 @@ export interface WorkflowAgentSpec {
     images?: ImageInput[];
     limits?: {
         maxTurns?: number;
-        timeoutSec?: number;
+        maxWalltimeMs?: number;
+        maxTokens?: number;
+        maxCostUsd?: number;
     };
-    maxCostUsd?: number;
-    maxTokens?: number;
 }
-export declare const WHITELIST_KEYS: readonly ["objective", "modelName", "thinking", "systemPrompt", "images", "limits", "maxCostUsd", "maxTokens"];
+export declare const WHITELIST_KEYS: readonly ["objective", "modelName", "thinking", "systemPrompt", "images", "limits"];
 export interface WorkflowChildCaps {
-    perAgentTimeoutSec?: number;
+    perAgentMaxWalltimeMs?: number;
     childMaxCostUsd?: number;
     childMaxTokens?: number;
     childMaxTurns?: number;
 }
 export interface ResourceClampNote {
-    field: "maxCostUsd" | "maxTokens" | "timeoutSec" | "maxTurns";
+    field: "maxCostUsd" | "maxTokens" | "maxWalltimeMs" | "maxTurns";
     requested: number | undefined;
     applied: number;
 }

package/dist/orchestration/workflow-governance.js

@@ -17,8 +17,6 @@ export const WHITELIST_KEYS = [
     "systemPrompt",
     "images",
     "limits",
-    "maxCostUsd",
-    "maxTokens",
 ];
 const VALID_THINKING = new Set(["off", "minimal", "low", "medium", "high", "xhigh", "max"]);
 export function resolveModelName(name, allowlist, models) {
@@ -91,36 +89,26 @@ function pickWhitelist(scriptSpec) {
     }
     if (s.limits !== undefined) {
         if (typeof s.limits !== "object" || s.limits === null || Array.isArray(s.limits)) {
-            throw new WorkflowScriptError("agent(spec): `limits` must be an object { maxTurns?, timeoutSec? }");
+            throw new WorkflowScriptError("agent(spec): `limits` must be an object { maxTurns?, maxWalltimeMs?, maxTokens?, maxCostUsd? }");
         }
         const l = s.limits;
         const limits = {};
-        if (l.maxTurns !== undefined) {
-            if (typeof l.maxTurns !== "number" || !Number.isFinite(l.maxTurns))
-                throw new WorkflowScriptError("agent(spec): `limits.maxTurns` must be a number");
-            if (l.maxTurns <= 0)
-                throw new WorkflowScriptError(NON_POSITIVE_LIMIT_MSG("maxTurns", "turn cap"));
-            limits.maxTurns = l.maxTurns;
-        }
-        if (l.timeoutSec !== undefined) {
-            if (typeof l.timeoutSec !== "number" || !Number.isFinite(l.timeoutSec))
-                throw new WorkflowScriptError("agent(spec): `limits.timeoutSec` must be a number");
-            if (l.timeoutSec <= 0)
-                throw new WorkflowScriptError(NON_POSITIVE_LIMIT_MSG("timeoutSec", "wall-clock window"));
-            limits.timeoutSec = l.timeoutSec;
-        }
+        const readAxis = (field, what) => {
+            const raw = l[field];
+            if (raw === undefined)
+                return;
+            if (typeof raw !== "number" || !Number.isFinite(raw))
+                throw new WorkflowScriptError(`agent(spec): \`limits.${field}\` must be a number`);
+            if (raw <= 0)
+                throw new WorkflowScriptError(NON_POSITIVE_LIMIT_MSG(field, what));
+            limits[field] = raw;
+        };
+        readAxis("maxTurns", "turn cap");
+        readAxis("maxWalltimeMs", "wall-clock window");
+        readAxis("maxTokens", "token budget");
+        readAxis("maxCostUsd", "spend ceiling");
         safe.limits = limits;
     }
-    if (s.maxCostUsd !== undefined) {
-        if (typeof s.maxCostUsd !== "number" || !Number.isFinite(s.maxCostUsd))
-            throw new WorkflowScriptError("agent(spec): `maxCostUsd` must be a number");
-        safe.maxCostUsd = s.maxCostUsd;
-    }
-    if (s.maxTokens !== undefined) {
-        if (typeof s.maxTokens !== "number" || !Number.isFinite(s.maxTokens))
-            throw new WorkflowScriptError("agent(spec): `maxTokens` must be a number");
-        safe.maxTokens = s.maxTokens;
-    }
     let modelName;
     if (s.modelName !== undefined) {
         if (typeof s.modelName !== "string")
@@ -131,37 +119,35 @@ function pickWhitelist(scriptSpec) {
 }
 function clampResourceLimits(safe, base, caps) {
     const notes = [];
-    const requestedCost = safe.maxCostUsd;
-    const cost = minDefined(safe.maxCostUsd, base.maxCostUsd, caps?.childMaxCostUsd);
-    if (cost !== undefined) {
-        if (cost !== requestedCost)
-            notes.push({ field: "maxCostUsd", requested: requestedCost, applied: cost });
-        safe.maxCostUsd = cost;
-    }
-    const requestedTokens = safe.maxTokens;
-    const tokens = minDefined(safe.maxTokens, base.maxTokens, caps?.childMaxTokens);
-    if (tokens !== undefined) {
-        if (tokens !== requestedTokens)
-            notes.push({ field: "maxTokens", requested: requestedTokens, applied: tokens });
-        safe.maxTokens = tokens;
-    }
-    const requestedTimeoutSec = safe.limits?.timeoutSec;
+    const requestedCost = safe.limits?.maxCostUsd;
+    const requestedTokens = safe.limits?.maxTokens;
+    const requestedWalltimeMs = safe.limits?.maxWalltimeMs;
     const requestedMaxTurns = safe.limits?.maxTurns;
-    const timeoutSec = minPositiveDefined(safe.limits?.timeoutSec, base.limits?.timeoutSec, caps?.perAgentTimeoutSec);
+    const cost = minDefined(safe.limits?.maxCostUsd, base.limits?.maxCostUsd, caps?.childMaxCostUsd);
+    const tokens = minDefined(safe.limits?.maxTokens, base.limits?.maxTokens, caps?.childMaxTokens);
+    const maxWalltimeMs = minPositiveDefined(safe.limits?.maxWalltimeMs, base.limits?.maxWalltimeMs, caps?.perAgentMaxWalltimeMs);
     const maxTurns = minPositiveDefined(safe.limits?.maxTurns, base.limits?.maxTurns, caps?.childMaxTurns);
-    if (timeoutSec !== undefined && timeoutSec !== requestedTimeoutSec) {
-        notes.push({ field: "timeoutSec", requested: requestedTimeoutSec, applied: timeoutSec });
+    if (cost !== undefined && cost !== requestedCost)
+        notes.push({ field: "maxCostUsd", requested: requestedCost, applied: cost });
+    if (tokens !== undefined && tokens !== requestedTokens)
+        notes.push({ field: "maxTokens", requested: requestedTokens, applied: tokens });
+    if (maxWalltimeMs !== undefined && maxWalltimeMs !== requestedWalltimeMs) {
+        notes.push({ field: "maxWalltimeMs", requested: requestedWalltimeMs, applied: maxWalltimeMs });
     }
     if (maxTurns !== undefined && maxTurns !== requestedMaxTurns) {
         notes.push({ field: "maxTurns", requested: requestedMaxTurns, applied: maxTurns });
     }
     const baseOtherLimits = { ...base.limits };
     delete baseOtherLimits.maxTurns;
-    delete baseOtherLimits.timeoutSec;
+    delete baseOtherLimits.maxWalltimeMs;
+    delete baseOtherLimits.maxTokens;
+    delete baseOtherLimits.maxCostUsd;
     const rebuilt = {
         ...baseOtherLimits,
         ...(maxTurns !== undefined ? { maxTurns } : {}),
-        ...(timeoutSec !== undefined ? { timeoutSec } : {}),
+        ...(maxWalltimeMs !== undefined ? { maxWalltimeMs } : {}),
+        ...(tokens !== undefined ? { maxTokens: tokens } : {}),
+        ...(cost !== undefined ? { maxCostUsd: cost } : {}),
     };
     if (base.limits !== undefined || Object.keys(rebuilt).length > 0)
         safe.limits = rebuilt;

package/dist/orchestration/workflow.js

@@ -222,6 +222,14 @@ function normalizeWorkflowHardCap(name, v) {
     }
     return v;
 }
+function normalizeWorkflowStallMs(v) {
+    if (v === undefined)
+        return WORKFLOW_AGENT_STALL_MS;
+    if (!Number.isFinite(v)) {
+        throw new Error(`runWorkflow: stallMs must be a finite number of milliseconds (got ${v}); 0 or a negative value is the documented explicit "off", not NaN/Infinity`);
+    }
+    return v;
+}
 function createSemaphore(max) {
     let active = 0;
     const waiters = [];
@@ -307,12 +315,13 @@ export function startWorkflow(runner, fn, opts = {}, internals) {
     const maxAgents = normalizeWorkflowHardCap("maxAgents", opts.maxAgents);
     const maxLogChars = normalizeWorkflowHardCap("maxLogChars", opts.maxLogChars);
     const maxResultChars = normalizeWorkflowHardCap("maxResultChars", opts.maxResultChars);
-    const stallMs = opts.stallMs ?? WORKFLOW_AGENT_STALL_MS;
-    const agentMaxRetries = opts.agentMaxRetries ?? WORKFLOW_AGENT_MAX_RETRIES;
-    const throttleBackoffMs = opts.throttleBackoffMs ?? WORKFLOW_AGENT_THROTTLE_BACKOFF_MS;
+    const totalTimeoutMs = normalizeWorkflowHardCap("totalTimeoutMs", opts.totalTimeoutMs);
+    const stallMs = normalizeWorkflowStallMs(opts.stallMs);
+    const agentMaxRetries = normalizeWorkflowHardCap("agentMaxRetries", opts.agentMaxRetries) ?? WORKFLOW_AGENT_MAX_RETRIES;
+    const throttleBackoffMs = normalizeWorkflowHardCap("throttleBackoffMs", opts.throttleBackoffMs) ?? WORKFLOW_AGENT_THROTTLE_BACKOFF_MS;
     const timers = opts.timers ?? REAL_WORKFLOW_TIMERS;
     const cancelController = new AbortController();
-    const timeoutController = opts.totalTimeoutMs !== undefined ? new AbortController() : undefined;
+    const timeoutController = totalTimeoutMs !== undefined ? new AbortController() : undefined;
     const signalSources = [cancelController.signal];
     if (opts.signal)
         signalSources.push(opts.signal);
@@ -375,7 +384,7 @@ export function startWorkflow(runner, fn, opts = {}, internals) {
     };
     markWorkflowActive(runId, scope);
     if (timeoutController) {
-        timeoutTimer = setTimeout(() => timeoutController.abort(new Error("workflow total timeout")), opts.totalTimeoutMs);
+        timeoutTimer = setTimeout(() => timeoutController.abort(new Error("workflow total timeout")), totalTimeoutMs);
         timeoutTimer.unref?.();
     }
     emit({ type: "run_start", runId, scope, ts: t0 });

package/dist/prompt-assembly/event-registry.js

@@ -13,9 +13,8 @@ export const EVENT_PROMPT_REGISTRY = new Map([
     { kind: "skills_listing", carrier: "message.user-prefix", trust: "operator", dedupe: "replace-by-key", defaultPolicy: "on", rendererRef: "turn-attachments.ts#renderSkillsListingDelta" },
     { kind: "mcp_instructions", carrier: "message.user-prefix", trust: "external", dedupe: "replace-by-key", defaultPolicy: "off", rendererRef: "turn-attachments.ts#renderMcpInstructionsDelta" },
     { kind: "mcp_dropped_tools", carrier: "message.user-prefix", trust: "external", dedupe: "replace-by-key", defaultPolicy: "off", rendererRef: "turn-attachments.ts#renderMcpDroppedTools" },
-    { kind: "deadline_converge", carrier: "message.user-prefix", trust: "operator", dedupe: "once-per-run", defaultPolicy: "always", rendererRef: "runtask.ts#nudgeSchedule" },
-    { kind: "deadline_deliver_now", carrier: "message.user-prefix", trust: "operator", dedupe: "once-per-run", defaultPolicy: "always", rendererRef: "runtask.ts#nudgeSchedule" },
-    { kind: "deadline_finalize", carrier: "message.user-prefix", trust: "operator", dedupe: "once-per-run", defaultPolicy: "always", rendererRef: "runtask.ts#buildFinalizeText" },
+    { kind: "limit_approach_converge", carrier: "message.user-prefix", trust: "operator", dedupe: "once-per-run", defaultPolicy: "always", rendererRef: "runtask.ts#limitApproachFrames" },
+    { kind: "limit_approach_deliver", carrier: "message.user-prefix", trust: "operator", dedupe: "once-per-run", defaultPolicy: "always", rendererRef: "runtask.ts#limitApproachFrames" },
     { kind: "final_verification", carrier: "message.user-prefix", trust: "operator", dedupe: "once-per-run", defaultPolicy: "always", rendererRef: "runtask.ts#final-verification" },
 ].map((e) => [e.kind, e]));
 export function eventDefaultOn(kind) {

package/dist/stores/cc/lockfile.js

@@ -20,6 +20,9 @@ export async function acquireCcLock(target, opts) {
         }
     };
     for (let attempt = 0;; attempt++) {
+        if (attempt >= RETRIES) {
+            throw new Error(`cc lockfile: could not acquire ${lockPath} after ${RETRIES} retries`);
+        }
         try {
             mkdirSync(lockPath);
             writeFileSync(ownerPath, nonce);
@@ -60,21 +63,16 @@ export async function acquireCcLock(target, opts) {
                 const st = statSync(lockPath);
                 if (Date.now() - st.mtimeMs > staleMs) {
                     const st2 = statSync(lockPath);
-                    if (st2.mtimeMs !== st.mtimeMs)
-                        continue;
-                    try {
-                        rmSync(lockPath, { recursive: true, force: true });
-                    }
-                    catch {
+                    if (st2.mtimeMs === st.mtimeMs) {
+                        try {
+                            rmSync(lockPath, { recursive: true, force: true });
+                        }
+                        catch {
+                        }
                     }
-                    continue;
                 }
             }
             catch {
-                continue;
-            }
-            if (attempt >= RETRIES) {
-                throw new Error(`cc lockfile: could not acquire ${lockPath} after ${RETRIES} retries (held and fresh)`);
             }
             const backoff = Math.min(MAX_TIMEOUT_MS, MIN_TIMEOUT_MS * 2 ** attempt);
             await sleep(backoff / 2 + Math.random() * (backoff / 2));

package/dist/stores/cc/mailbox-store.js

@@ -3,6 +3,7 @@ import { join, resolve } from "node:path";
 import { randomUUID } from "node:crypto";
 import { atomicWriteFile, canonicalStoreKey } from "../file/fs-atomic.js";
 import { withCcLock } from "./lockfile.js";
+const INBOX_FILE_EXT = ".json";
 export function sanitizeCcAgentName(name) {
     return name.replace(/[^a-zA-Z0-9]/g, "-").toLowerCase();
 }
@@ -23,10 +24,8 @@ export function createCcFileMailboxStore(opts) {
             throw new Error(`CcFileMailboxStore: CC inbox files carry no tenant axis — scope:"default" only (D-1); got ${JSON.stringify(scope)}`);
         }
     };
-    const inboxPath = (handle) => {
-        const name = opts.agentNameOf?.(handle) ?? handle;
-        return join(inboxDir, `${sanitizeCcAgentName(name)}.json`);
-    };
+    const leaseKey = (handle) => sanitizeCcAgentName(opts.agentNameOf?.(handle) ?? handle);
+    const inboxPath = (handle) => join(inboxDir, `${leaseKey(handle)}${INBOX_FILE_EXT}`);
     const discloseCorrupt = (path, reason) => {
         try {
             opts.onCorruptRead?.({ path, reason });
@@ -98,6 +97,42 @@ export function createCcFileMailboxStore(opts) {
     const saveBox = (path, box) => {
         atomicWriteFile(inboxDir, path, JSON.stringify(box, null, 2));
     };
+    const isColderThan = (box, now, maxAgeMs) => {
+        if (box.length === 0)
+            return false;
+        const newest = box.reduce((acc, e) => {
+            const t = typeof e.timestamp === "string" ? Date.parse(e.timestamp) : Number.NaN;
+            return Number.isFinite(t) ? Math.max(acc, t) : Number.POSITIVE_INFINITY;
+        }, 0);
+        return newest !== Number.POSITIVE_INFINITY && now - newest > maxAgeMs;
+    };
+    const sweepColdBoxes = async (now, maxAgeMs) => {
+        let dropped = 0;
+        for (const f of readdirSync(inboxDir)) {
+            if (!f.endsWith(INBOX_FILE_EXT))
+                continue;
+            const path = join(inboxDir, f);
+            const boxKey = f.slice(0, -INBOX_FILE_EXT.length);
+            const preNotes = deferredNotes();
+            if (!isColderThan(loadBox(path, preNotes.note), now, maxAgeMs)) {
+                preNotes.flush();
+                continue;
+            }
+            const notes = deferredNotes();
+            const swept = await withCcLock(path, () => {
+                if (!isColderThan(loadBox(path, notes.note), now, maxAgeMs))
+                    return false;
+                leases.delete(boxKey);
+                rmSync(path, { force: true });
+                return true;
+            }).finally(() => {
+                notes.flush();
+            });
+            if (swept)
+                dropped += 1;
+        }
+        return dropped;
+    };
     return {
         append: (scope, handle, msg) => {
             requireDefaultScope(scope);
@@ -124,11 +159,12 @@ export function createCcFileMailboxStore(opts) {
         claimLease: (scope, handle, owner, ttlMs, now) => {
             requireDefaultScope(scope);
             const t = now ?? opts.now?.() ?? Date.now();
-            const key = inboxPath(handle);
+            const key = leaseKey(handle);
+            const path = inboxPath(handle);
             const held = leases.get(key);
             if (held !== undefined && held.expiresAt > t && held.owner !== owner)
                 return Promise.resolve(null);
-            const box = loadBox(key, discloseCorrupt);
+            const box = loadBox(path, discloseCorrupt);
             const maxSeq = box.length;
             const pending = box
                 .map((e, i) => ({ e, seq: i + 1 }))
@@ -147,7 +183,7 @@ export function createCcFileMailboxStore(opts) {
         ack: (scope, handle, owner, upToSeq) => {
             requireDefaultScope(scope);
             const path = inboxPath(handle);
-            const held = leases.get(path);
+            const held = leases.get(leaseKey(handle));
             if (held === undefined || held.owner !== owner)
                 return Promise.resolve();
             if (!existsSync(path))
@@ -165,14 +201,14 @@ export function createCcFileMailboxStore(opts) {
                 if (changed)
                     saveBox(path, box);
                 if (held.maxSeq <= upToSeq)
-                    leases.delete(path);
+                    leases.delete(leaseKey(handle));
             }).finally(() => {
                 notes.flush();
             });
         },
         releaseLease: (scope, handle, owner) => {
             requireDefaultScope(scope);
-            const key = inboxPath(handle);
+            const key = leaseKey(handle);
             const held = leases.get(key);
             if (held !== undefined && held.owner === owner)
                 leases.delete(key);
@@ -185,42 +221,17 @@ export function createCcFileMailboxStore(opts) {
         drop: (scope, handle) => {
             requireDefaultScope(scope);
             const path = inboxPath(handle);
-            leases.delete(path);
-            try {
+            leases.delete(leaseKey(handle));
+            return withCcLock(path, () => {
                 rmSync(path, { force: true });
-                rmSync(`${path}.lock`, { recursive: true, force: true });
-            }
-            catch {
-            }
-            return Promise.resolve();
+            });
         },
         reap: (scope, now, reapOpts) => {
             requireDefaultScope(scope);
             const maxAgeMs = reapOpts?.maxAgeMs;
             if (maxAgeMs === undefined || !existsSync(inboxDir))
                 return Promise.resolve(0);
-            let dropped = 0;
-            for (const f of readdirSync(inboxDir)) {
-                if (!f.endsWith(".json"))
-                    continue;
-                const path = join(inboxDir, f);
-                const box = loadBox(path, discloseCorrupt);
-                const newest = box.reduce((acc, e) => {
-                    const t = typeof e.timestamp === "string" ? Date.parse(e.timestamp) : Number.NaN;
-                    return Number.isFinite(t) ? Math.max(acc, t) : Number.POSITIVE_INFINITY;
-                }, 0);
-                if (box.length > 0 && newest !== Number.POSITIVE_INFINITY && now - newest > maxAgeMs) {
-                    leases.delete(path);
-                    try {
-                        rmSync(path, { force: true });
-                        rmSync(`${path}.lock`, { recursive: true, force: true });
-                        dropped += 1;
-                    }
-                    catch {
-                    }
-                }
-            }
-            return Promise.resolve(dropped);
+            return sweepColdBoxes(now, maxAgeMs);
         },
     };
 }

package/dist/stores/file/index.d.ts

@@ -7,6 +7,7 @@ import { type FileCheckpointStoreOptions } from "./checkpoint-store.js";
 import type { SessionPolicyStore } from "../../core/session-policy-store.js";
 import type { FileSnapshotStore } from "../../core/file-snapshot-store.js";
 import type { WorkflowJournalStore } from "../../core/workflow-journal-store.js";
+import type { UsageWindowStore } from "../../core/usage-window-store.js";
 export { FileCheckpointStore, type FileCheckpointStoreOptions } from "./checkpoint-store.js";
 export { FileMemoryStore } from "./memory-store.js";
 export { FileSessionRepo, type FileSessionRepoOptions } from "./session-store.js";
@@ -14,6 +15,7 @@ export { FileToolResultStore } from "./tool-result-store.js";
 export { FileSessionPolicyStore, type FileSessionPolicyStoreOptions, type SessionPolicyCorruptReadInfo } from "./session-policy-store.js";
 export { FileFileSnapshotStore, type FileFileSnapshotStoreOptions } from "./file-snapshot-store.js";
 export { FileWorkflowJournalStore, MAX_JOURNAL_RESULT_BYTES, oversizeJournalResult } from "./workflow-journal-store.js";
+export { FileUsageWindowStore } from "./usage-window-store.js";
 export { resolveDataRoot, sanitizeScope, sanitizePathComponent, createFileConsolidationLock } from "./fs-atomic.js";
 export { atomicWriteFile, writeThenLink, ensureDir, readJsonlRecords, AppendLog } from "./fs-atomic.js";
 export interface FileStorageBackendOptions {
@@ -40,6 +42,7 @@ export declare class FileStorageBackend {
     readonly sessionPolicyStore: SessionPolicyStore;
     readonly fileSnapshotStore: FileSnapshotStore;
     readonly workflowJournalStore: WorkflowJournalStore;
+    readonly usageWindowStore: UsageWindowStore;
     readonly consolidationLock: (scope: string) => (() => void) | undefined;
     private readonly lock;
     private readonly fileCheckpoints;