ai-foreman 1.7.8 → 1.7.9

package/dist/sessionLifecycle.d.ts

@@ -1,8 +1,7 @@
 import type { ConfigurableAgentRole, ContextSample, ProviderSessionRefV1, ResolvedAgentSettings, SessionAvailabilityV1, SessionStrategy, WorkflowIssue } from "rafi-spec";
-import type { BuilderAdapter, BuilderEvent, CompactResult, ContextManagementPolicy, ContextUsage, InterruptResult, PreparedContextManagement, ProviderSessionUsage, ProviderSettingSwitch, TurnResult } from "./adapters/types.js";
-import { type ThresholdLifecycleState } from "./workflowDb.js";
+import type { BuilderAdapter, ContextUsage } from "./adapters/types.js";
 export interface SessionTransition {
-    kind: "initial" | "continued" | "compacted" | "fresh" | "missing" | "compaction-retry" | "compaction-fallback" | "settings-attempt" | "settings-continued" | "settings-fallback";
+    kind: "initial" | "compacted" | "fresh" | "missing" | "compaction-retry" | "compaction-fallback" | "settings-attempt" | "settings-continued" | "settings-fallback";
     role: ConfigurableAgentRole;
     workSession: number;
     sessionId?: string;
@@ -49,10 +48,9 @@ export declare class RoleSessionController {
      */
     static managed(options: ThresholdCompactionOptions): RoleSessionController;
     atSafeBoundary(adapter: BuilderAdapter, frozenAction: string): Promise<ContextBoundaryResult>;
-    /** Return the stable role facade whose sendTurn() contains the lifecycle gate. */
-    manage(adapter: BuilderAdapter): ManagedRoleAdapter;
-    contextSnapshot(): ManagedContextSnapshot | undefined;
     atWorkSessionBoundary(adapter: BuilderAdapter, frozenAction: string, strategy?: SessionStrategy): Promise<ContextBoundaryResult>;
+    /** Record provider-native automatic compaction immediately after a role turn. */
+    observeNativeCompactions(adapter: BuilderAdapter): Promise<number | undefined>;
     effectiveSettings(): ResolvedAgentSettings;
     effectiveThreshold(): number;
     next(durableHandoff: string, nextSettings?: ResolvedAgentSettings): Promise<SessionBoundary>;
@@ -103,10 +101,6 @@ export interface ThresholdCompactionOptions {
     }) => void;
     contextRetries?: number;
     historicalCountUncertain?: boolean;
-    /** Production Builder/QA runs require native prepare/update/interrupt support. */
-    requireNativeContextManagement?: boolean;
-    /** Dedicated live-settings watcher interval. */
-    settingsPollMs?: number;
     now?: () => Date;
 }
 export interface ContextBoundaryResult {
@@ -116,115 +110,32 @@ export interface ContextBoundaryResult {
     effectiveThreshold: number;
     compactionCount: number;
 }
-export interface ManagedContextSnapshot {
-    role: "builder" | "qa";
-    provider: "claude" | "codex";
-    model: string;
-    lifecycleState: ThresholdLifecycleState;
-    contextSample: ContextSample;
-    configuredCeilingPercent: number;
-    installedNativeTokenLimit?: number;
-    installedNativePercent?: number;
-    compactionCount: number;
-    compactMaximum: number;
-    settingsRevision: number;
-}
-/** Stable facade: every Builder/QA provider turn enters the coordinator here. */
-export declare class ManagedRoleAdapter implements BuilderAdapter {
-    readonly coordinator: ThresholdCompactionController;
-    private adapter;
-    private readonly queue;
-    private eventPump?;
-    private processing;
-    private closed;
-    private activeSessionKeyValue?;
-    constructor(coordinator: ThresholdCompactionController, adapter: BuilderAdapter);
-    get agent(): "claude" | "codex";
-    sendTurn(text: string): Promise<TurnResult>;
-    sessionId(): string | undefined;
-    sessionRef(): ProviderSessionRefV1 | undefined;
-    adoptSessionRef(ref: ProviderSessionRefV1): void;
-    validateSession(): Promise<SessionAvailabilityV1>;
-    compact(): Promise<CompactResult>;
-    prepareContextManagement(policy: ContextManagementPolicy): Promise<PreparedContextManagement>;
-    updateContextManagement(policy: ContextManagementPolicy): Promise<PreparedContextManagement>;
-    interruptTurnAtCompactionBoundary(providerEventId?: string): Promise<InterruptResult>;
-    contextUsage(): Promise<ContextUsage | undefined>;
-    sessionUsage(): Promise<ProviderSessionUsage | undefined>;
-    switchSettings(settings: ProviderSettingSwitch): Promise<CompactResult>;
-    events(): AsyncIterable<BuilderEvent>;
-    underlying(): BuilderAdapter;
-    noteActiveSession(key: string): string | undefined;
-    activeSessionKey(): string | undefined;
-    isClosed(): boolean;
-    replace(adapter: BuilderAdapter): void;
-    settleEvents(): Promise<void>;
-    close(): Promise<void>;
-    private pump;
-    private attachDispatcher;
-}
-/** Per-scoped-session context state machine and the sole occupancy sample store. */
+/** Threshold-triggered native compaction at host-owned safe boundaries. */
 export declare class ThresholdCompactionController {
     private readonly options;
     private settings;
+    private armed;
+    private crossing;
+    private readonly seenSessions;
+    private runOnlyThreshold?;
+    private bootstrapScheduled;
+    private bootstrapRecoveryDepth;
     private historicalCountUncertain;
-    private readonly managed;
-    private readonly states;
-    private readonly nativeAttempts;
-    private readonly observedCompactionPhases;
-    private readonly settingsWatchers;
-    private active?;
-    private provisional;
-    private refreshingSettings?;
-    private dispatchDepth;
-    constructor(options: ThresholdCompactionOptions & {
-        requireNativeContextManagement?: boolean;
-        settingsPollMs?: number;
-    });
-    manage(adapter: BuilderAdapter): ManagedRoleAdapter;
+    constructor(options: ThresholdCompactionOptions);
     atSafeBoundary(adapter: BuilderAdapter, frozenAction: string): Promise<ContextBoundaryResult>;
+    /** Apply the configured ordinary work-session boundary without bypassing handoff or compaction accounting. */
     atWorkSessionBoundary(adapter: BuilderAdapter, frozenAction: string, strategy?: SessionStrategy): Promise<ContextBoundaryResult>;
     effectiveSettings(): ResolvedAgentSettings;
     effectiveThreshold(): number;
-    snapshot(): ManagedContextSnapshot | undefined;
-    contextUsage(adapter: ManagedRoleAdapter): ContextUsage | undefined;
-    dispatch(managed: ManagedRoleAdapter, frozenAction: string, resumed?: boolean): Promise<TurnResult>;
-    /** Same gate for continuity repair, recursive continuation, and runtime retry. */
-    dispatchFollowup(managed: ManagedRoleAdapter, frozenAction: string, invoke: () => Promise<TurnResult>): Promise<TurnResult>;
-    compactExplicit(managed: ManagedRoleAdapter): Promise<CompactResult>;
-    unregister(managed: ManagedRoleAdapter): void;
-    observe(managed: ManagedRoleAdapter, source: BuilderAdapter, event: BuilderEvent): Promise<void>;
-    private ensureInitialized;
-    private installNative;
-    private recoverOrCreateState;
-    private reconcileIncompleteCompaction;
-    private stateFor;
-    private measureIntoState;
-    private recoverMeasurementFailure;
-    private acceptUsage;
-    private enforceThreshold;
-    private compactAndVerify;
+    /** Persist provider-triggered compactions at a host-owned boundary. */
+    observeNativeCompactions(adapter: BuilderAdapter, afterSample?: ContextSample): Promise<number | undefined>;
+    private compactSession;
     private performHandoff;
-    private observeCompaction;
-    private interruptForHandoff;
-    private generationTerminalAttempts;
-    private refreshSettings;
-    private ensureSettingsWatcher;
-    private beginGeneration;
-    private transition;
-    private persist;
-    private invalidateSample;
-    private measuringSample;
-    private result;
-    private markActive;
-    private providerSequence;
-    private recordCompactionSessionUnavailable;
-    private persistedMaximum;
+    private adoptSettings;
+    private measure;
+    private sampleFromUsage;
     private compactionCount;
     private handoffGeneration;
-    private generationId;
     private threshold;
-    private maximum;
     private now;
-    private capability;
 }