open-multi-agent-kit 0.96.1 → 0.97.0

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

@@ -19,11 +19,14 @@ import type { BashResult } from "./bash-executor.ts";
 import { type CompactionResult } from "./compaction/index.ts";
 import { type ContextCacheInvalidationSnapshot } from "./context-budget-v2-cache-invalidation.ts";
 import { type ContextUsage, type ExtensionCommandContextActions, type ExtensionErrorListener, type ExtensionMode, ExtensionRunner, type ExtensionUIContext, type InputSource, type ReplacedSessionContext, type SessionStartEvent, type ShutdownHandler, type ToolDefinition, type ToolInfo } from "./extensions/index.ts";
+import { type HostResourceSnapshot } from "./host-resource-snapshot.ts";
 import { type LoadoutAccessPolicy } from "./loadout-access-policy.ts";
 import { type McpServerConfig, type McpServerStatus } from "./mcp/manager.ts";
 import type { CustomMessage } from "./messages.ts";
 import type { ModelRegistry } from "./model-registry.ts";
+import { type PromptSettledEvent } from "./prompt-settlement.ts";
 import { type PromptTemplate } from "./prompt-templates.ts";
+import { type ResourceAdmissionDecision } from "./resource-admission.ts";
 import type { ResourceLoader } from "./resource-loader.ts";
 import type { RunJournalRecord } from "./run-journal.ts";
 import { type RunJournalQuarantineReport } from "./run-journal-store.ts";
@@ -31,6 +34,7 @@ import type { BranchSummaryEntry, SessionManager } from "./session-manager.ts";
 import { type SessionProcessSignal, type SessionTermination } from "./session-termination.ts";
 import type { SettingsManager } from "./settings-manager.ts";
 import { type BashOperations, type BashSandboxPreflight } from "./tools/bash.ts";
+import { WorkloadPermitPool, type WorkloadPermitPoolSnapshot } from "./workload-permit-pool.ts";
 /** Parsed skill block from a user message */
 export interface ParsedSkillBlock {
     name: string;
@@ -56,7 +60,7 @@ export type AgentSessionEvent = Exclude<AgentEvent, {
     type: "agent_end";
     messages: AgentMessage[];
     willRetry: boolean;
-} | {
+} | PromptSettledEvent | {
     type: "queue_update";
     steering: readonly string[];
     followUp: readonly string[];
@@ -334,6 +338,12 @@ export declare class AgentSession {
     private readonly _runJournalStore;
     private _ownedSessionOwnerLease;
     private _activeRunId;
+    private _resourceLeaseController;
+    private _resourceObservations;
+    private readonly _resourceObservationJournals;
+    private _latestResourcePromptRunId;
+    private _lastResourceAdmission;
+    private _workloadPermitPool;
     private _pendingRuntimeTerminationCause;
     private _activeRunToolTermination;
     private _lastTermination;
@@ -548,8 +558,34 @@ export declare class AgentSession {
      * Prefers the model's own maxTokens when available, otherwise uses a ratio.
      */
     private _recordPromptCachePlan;
+    private _getDefaultActiveSkills;
     private _rebuildSystemPrompt;
     private _runAgentPrompt;
+    /**
+     * Emit `prompt_settled` when the §16.4 conditions hold. Called exactly
+     * once per promptRunId (from `_runAgentPrompt`'s finally), so the same
+     * run can never emit twice; late-queued messages block emission
+     * conservatively — the continuation run settles under its own id.
+     * Settlement is a UX signal only and must never affect the run (§16.1).
+     */
+    private _emitPromptSettledIfReady;
+    private _beginResourceGovernedRun;
+    private _openResourceObservations;
+    /** §20.2: record the TUI-side completion sound result in its originating run journal. */
+    recordCompletionSoundResult(promptRunId: string, result: import("./completion-sound.ts").CompletionSoundResult): void;
+    /** §19.4 read-only SDK surface: the most recent resource admission decision, if any. */
+    getCurrentResourceAdmission(): ResourceAdmissionDecision | null;
+    /** §19.4 read-only SDK surface: capture a fresh host resource snapshot. */
+    getHostResourceSnapshot(): Promise<HostResourceSnapshot>;
+    /** §19.4 read-only SDK surface: shared workload permit pool state, if any. */
+    getWorkloadPermitSnapshot(): WorkloadPermitPoolSnapshot | null;
+    /**
+     * §14.1 shared-budget seam: child subagents must reuse this instance
+     * instead of creating a private pool (host oversubscription). The live
+     * child launcher wiring lands in M6.
+     */
+    get workloadPermitPool(): WorkloadPermitPool;
+    private _acquireBashResourcePermit;
     private _handlePostAgentRun;
     /**
      * Send a prompt to the agent.
@@ -767,6 +803,13 @@ export declare class AgentSession {
     private _runThresholdCompaction;
     private _recordCompactionCommitForHysteresis;
     private _resolveCompactionModel;
+    /**
+     * Authenticated failover candidates for compaction summarization, in
+     * resilience-chain order, excluding the primary compaction model itself.
+     * Used when the primary model's quota is exhausted (same-model retry is
+     * useless until reset; another provider can still save the compaction).
+     */
+    private _compactionFailoverModels;
     /**
      * Manually compact the session context.
      * Aborts current agent operation first.
@@ -786,7 +829,7 @@ export declare class AgentSession {
     /**
      * Effective context window for the upcoming turn.
      * Image-bearing turns with a text-only session model are auto-routed to the
-     * vision model (gpt-5.6-luna, 400K) — that window is the real limit. Text-only
+     * vision model (gpt-5.6-luna, 1M) — that window is the real limit. Text-only
      * turns keep the session model's (typically much larger) window.
      */
     private _effectiveTurnContextWindow;
@@ -849,6 +892,7 @@ export declare class AgentSession {
      */
     private _summarizationRetryCallbacks;
     private _ejectStickySafetyModelIfNeeded;
+    private _maybeRotateModelRoutes;
     private _maybeFailoverFromSafetyStop;
     private _prepareRetry;
     /**