@myagentroam/agent 0.11.33 → 0.11.34

package/dist/agent-core/sdk/subagent-backend.d.ts

@@ -1,3 +0,0 @@
-import type { SessionStore } from '../session/store/contracts.js';
-import type { SubagentSessionControllerBackend } from '../subagent/session-controller.js';
-export declare function createSubagentBackend(store: SessionStore, workspace: string): SubagentSessionControllerBackend;

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

@@ -1,49 +0,0 @@
-import { MarAgentError } from '../error.js';
-export function createSubagentBackend(store, workspace) {
-    return {
-        createSession: async (input) => {
-            const session = await store.createSession({
-                workspace,
-                title: input.title,
-                source: input.source
-            });
-            return { id: session.id };
-        },
-        deleteSession: async (sessionId) => {
-            await store.delete(sessionId);
-        },
-        listChildren: async (parentSessionId) => {
-            const sessions = await store.listSubagentChildren(parentSessionId);
-            return sessions.map((session) => ({
-                id: session.id,
-                createdAt: session.createdAt,
-                lastActivityAt: session.lastActivityAt,
-                source: session.source
-            }));
-        },
-        loadChild: async (parentSessionId, childSessionId) => {
-            try {
-                const session = await store.getSession(childSessionId);
-                if (session.source.type !== 'subagent' ||
-                    session.source.parentSessionId !== parentSessionId)
-                    return undefined;
-                return {
-                    id: session.id,
-                    createdAt: session.createdAt,
-                    lastActivityAt: session.lastActivityAt,
-                    source: session.source,
-                    records: await store.read(session.id)
-                };
-            }
-            catch (error) {
-                if (error instanceof MarAgentError && error.code === 'MAR_AGENT_SESSION_NOT_FOUND') {
-                    // A history read failure is not proof that the child was deleted.
-                    const children = await store.listSubagentChildren(parentSessionId);
-                    if (!children.some((child) => child.id === childSessionId))
-                        return undefined;
-                }
-                throw error;
-            }
-        }
-    };
-}

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

@@ -1,81 +0,0 @@
-import type { MarAgentHost } from '../host/contracts.js';
-import type { CoreExtensionSource, CoreRuntimeExtension } from '../extensions/contracts.js';
-import type { MarAgentModelConfiguration } from '../model/configuration.js';
-import type { RolloutBudgetOptions, RunInput } from '../runtime/contracts.js';
-import type { CompactInput, ExecutionHandle } from '../runtime/execution-handle.js';
-import type { MarAgentSessionPage, MarAgentSessionSummary } from '../session/catalog.js';
-import type { SessionListInput, SessionSource, SessionTitleUpdateInput } from '../session/types.js';
-export interface CreateSessionInput {
-    workspace: string;
-    title?: string;
-}
-export type { SessionTitleUpdateInput } from '../session/types.js';
-export type { HostExecutionExtensions, HostSessionResourceSnapshot, HostSkill, MarAgentHost } from '../host/contracts.js';
-export type { AccessMode, ExecutionMode, ExecutionResult, MarAgentImageMetadata, RolloutBudgetOptions, RunInput, RunInputImage } from '../runtime/contracts.js';
-export type { MarAgentEvent, MarAgentEventBase } from '../runtime/events.js';
-export type { CompactInput, ExecutionHandle } from '../runtime/execution-handle.js';
-export type { CodeCellEventData, ExecOutputSnapshot, MarAgentToolArtifact, MarAgentToolImageArtifact, McpCatalogTool, McpToolCallContext, McpToolCatalog, McpToolCatalogContext, ToolCall, ToolExecutionContext, ToolExecutionResult } from '../tools/contracts.js';
-export interface SteerInput {
-    readonly expectedExecutionId: string;
-    readonly prompt: string;
-    readonly modelText?: string;
-    readonly clientMessageId: string;
-    readonly images?: RunInput['images'];
-}
-export type SteerResult = {
-    readonly status: 'accepted';
-    readonly entry: Extract<import('../session/catalog.js').MarAgentHistoryEntry, {
-        kind: 'user';
-    }>;
-} | {
-    readonly status: 'handled';
-} | {
-    readonly status: 'notAccepted';
-};
-/** A persisted Session permits one active main execution at a time. */
-export interface MarAgentSession {
-    readonly id: string;
-    run(input: RunInput): ExecutionHandle;
-    plan(input: RunInput): ExecutionHandle;
-    steer(input: SteerInput): Promise<SteerResult>;
-    compact(input?: CompactInput): ExecutionHandle;
-    cancel(executionId: string): Promise<void>;
-}
-export interface MarAgent {
-    extensionDiagnostics(): readonly import('../extensions/contracts.js').CoreExtensionDiagnostic[];
-    createSession(input: CreateSessionInput): Promise<MarAgentSession>;
-    openSession(sessionId: string): Promise<MarAgentSession>;
-    listSessions(input?: SessionListInput): Promise<MarAgentSessionPage>;
-    getSession(sessionId: string): Promise<MarAgentSessionSummary & {
-        automaticTitlePending: boolean;
-    }>;
-    setSessionTitle(sessionId: string, title: string, input?: SessionTitleUpdateInput): Promise<boolean>;
-    clearSession(sessionId: string): Promise<void>;
-    /** Updates future execution snapshots only; undefined clears the Host instruction extension. */
-    setSystemInstruction(systemInstruction?: string): void;
-    /** Rebinds future main executions only; running subagents keep their captured model providers. */
-    reconfigureModels(input: {
-        readonly models: readonly MarAgentModelConfiguration[];
-        readonly defaultModelId?: string;
-    }): Promise<void>;
-    deleteSession(sessionId: string): Promise<void>;
-    /** Joins executions/reconfiguration, closes owned resources, and releases borrowed Store leases. */
-    dispose(): Promise<void>;
-}
-export interface CreateMarAgentOptions {
-    /** Ready-to-use borrowed Store. The caller closes it after all Agent/Catalog users finish. */
-    sessionStore?: import('../session/store/contracts.js').SessionStore;
-    mode: 'normal' | 'node';
-    host: MarAgentHost;
-    models: readonly MarAgentModelConfiguration[];
-    defaultModelId?: string;
-    systemInstruction?: string;
-    workspaceMapping?: {
-        readonly logicalPath: string;
-        readonly physicalPath: string;
-    };
-    /** @deprecated Accepted for source compatibility and otherwise ignored. */
-    rolloutBudget?: false | RolloutBudgetOptions;
-    runtimeExtensions?: readonly CoreRuntimeExtension[] | CoreExtensionSource;
-}
-export type { MarAgentSessionSummary, SessionListInput, SessionSource };

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

@@ -1,99 +0,0 @@
-import type { MarAgentImageMetadata } from '../runtime/contracts.js';
-import type { MarAgentEvent } from '../runtime/events.js';
-import type { SessionStore } from './store/contracts.js';
-import type { SessionListInput, SessionSource } from './types.js';
-import type { MarAgentSessionRollbackInput } from './rollback.js';
-export interface MarAgentSessionSummary {
-    id: string;
-    title: string;
-    /** First non-empty user input, whitespace-normalized and bounded to 160 characters. */
-    firstUserMessagePreview?: string;
-    workspace: string;
-    createdAt: string;
-    lastActivityAt: string;
-    source: SessionSource;
-    modelId?: string;
-    modelName?: string;
-    reasoningEffort?: string;
-}
-export interface MarAgentSessionPage {
-    sessions: MarAgentSessionSummary[];
-    nextCursor?: string;
-}
-export interface MarAgentHistoryImageMetadata extends MarAgentImageMetadata {
-    readable: boolean;
-}
-export type MarAgentHistoryEntry = {
-    kind: 'user';
-    recordId?: string;
-    sequence: number;
-    timestamp: string;
-    sessionId: string;
-    executionId: string;
-    turnId: string;
-    text: string;
-    clientMessageId?: string;
-    inputSource?: 'user' | 'parent_agent';
-    images?: readonly MarAgentHistoryImageMetadata[];
-} | {
-    kind: 'event';
-    sequence: number;
-    event: MarAgentEvent;
-};
-export interface MarAgentHistoryPage {
-    entries: MarAgentHistoryEntry[];
-    nextCursor?: string;
-}
-export interface MarAgentContextUsage {
-    inputTokens: number;
-}
-export interface MarAgentSessionDeleteResult {
-    readonly deleted: boolean;
-}
-export interface MarAgentSessionImage {
-    name: string;
-    mimeType: string;
-    byteSize: number;
-    dataBase64: string;
-}
-/** Public session catalog facade. Storage details remain SDK-private. */
-export interface MarAgentSessionCatalog {
-    list(input?: SessionListInput): Promise<MarAgentSessionPage>;
-    firstUserMessagePreview(sessionId: string): Promise<string | undefined>;
-    executionConfiguration(sessionId: string): Promise<{
-        readonly modelId: string;
-        readonly modelName?: string;
-        readonly reasoningEffort?: string;
-    } | undefined>;
-    history(sessionId: string, input?: {
-        limit?: number;
-        cursor?: string;
-    }): Promise<MarAgentHistoryPage>;
-    readImage(sessionId: string, input: {
-        readonly sequence: number;
-        readonly imageIndex: number;
-    }): Promise<MarAgentSessionImage | undefined>;
-    readResource(sessionId: string, resourceId: string): Promise<{
-        mimeType: string;
-        dataBase64: string;
-    } | undefined>;
-    contextUsage(sessionId: string): Promise<MarAgentContextUsage | undefined>;
-    readToolResultResource(sessionId: string, input: import('./tool-result-resources.js').ToolResultResourceInput): Promise<import('./tool-result-resources.js').ToolResultResourcePage>;
-    fork(sessionId: string, input: {
-        readonly boundaryTurnId: string | null;
-        readonly title: string;
-    }): Promise<MarAgentSessionSummary>;
-    rollback(sessionId: string, input: MarAgentSessionRollbackInput): Promise<MarAgentSessionSummary>;
-    clear(sessionId: string): Promise<MarAgentSessionSummary>;
-    delete(sessionId: string): Promise<MarAgentSessionDeleteResult>;
-    close(): Promise<void>;
-}
-export type OpenMarAgentSessionCatalogInput = {
-    homeDirectory: string;
-    sessionStore?: never;
-} | {
-    sessionStore: SessionStore;
-    homeDirectory?: never;
-};
-export declare function openMarAgentSessionCatalog(input: OpenMarAgentSessionCatalogInput): Promise<MarAgentSessionCatalog>;
-export declare function imageMetadata(value: unknown): MarAgentHistoryImageMetadata[];

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

@@ -1,200 +0,0 @@
-import { MarAgentError } from '../error.js';
-import { publicHostedToolEvents } from '../runtime/event-projection.js';
-import { JsonlSessionStore } from './store/jsonl-store.js';
-const MAX_INPUT_IMAGE_BYTES = 5 * 1024 * 1024;
-const INPUT_IMAGE_MIME_TYPES = new Set(['image/png', 'image/jpeg', 'image/gif', 'image/webp']);
-export async function openMarAgentSessionCatalog(input) {
-    const borrowed = input.sessionStore !== undefined;
-    if (input.sessionStore === null ||
-        borrowed === (input.homeDirectory !== undefined) ||
-        (!borrowed && (typeof input.homeDirectory !== 'string' || !input.homeDirectory)))
-        throw new MarAgentError('MAR_AGENT_SESSION_STORE_INVALID', 'Specify exactly one Session store or home directory.');
-    const store = input.sessionStore ?? (await JsonlSessionStore.open(input.homeDirectory));
-    let closure;
-    const assertOpen = () => {
-        if (closure)
-            throw new MarAgentError('MAR_AGENT_DISPOSED', 'Session catalog is closed.');
-    };
-    return {
-        list: async (options) => {
-            assertOpen();
-            return store.list(options);
-        },
-        firstUserMessagePreview: async (sessionId) => {
-            assertOpen();
-            return store.firstUserMessagePreview(sessionId);
-        },
-        executionConfiguration: async (sessionId) => {
-            assertOpen();
-            return store.executionConfiguration(sessionId);
-        },
-        history: async (sessionId, options = {}) => {
-            assertOpen();
-            const beforeSequence = parseCursor(options.cursor);
-            const page = await store.readPage(sessionId, {
-                ...(options.limit === undefined ? {} : { limit: options.limit }),
-                ...(beforeSequence === undefined ? {} : { beforeSequence })
-            });
-            const entries = page.records.flatMap((record) => {
-                if (record.type === 'turn.user' &&
-                    record.executionId !== undefined &&
-                    record.turnId !== undefined &&
-                    isRecord(record.payload) &&
-                    typeof record.payload.prompt === 'string') {
-                    const images = imageMetadata(record.payload.images);
-                    return [
-                        {
-                            kind: 'user',
-                            ...(record.payload.deferred === true ? { recordId: record.recordId } : {}),
-                            sequence: record.sequence,
-                            timestamp: record.timestamp,
-                            sessionId: record.sessionId,
-                            executionId: record.executionId,
-                            turnId: record.turnId,
-                            text: record.payload.prompt,
-                            ...(typeof record.payload.clientMessageId === 'string'
-                                ? { clientMessageId: record.payload.clientMessageId }
-                                : {}),
-                            ...(record.payload.inputSource === 'parent_agent'
-                                ? { inputSource: 'parent_agent' }
-                                : {}),
-                            ...(images.length > 0 ? { images } : {})
-                        }
-                    ];
-                }
-                if (isMarAgentEvent(record.payload) && record.payload.type === 'hosted_tool.updated') {
-                    const legacy = record.payload;
-                    return publicHostedToolEvents({ ...legacy, type: 'hosted_tool' }).map((event) => ({
-                        kind: 'event',
-                        sequence: record.sequence,
-                        event: {
-                            sequence: legacy.sequence,
-                            timestamp: legacy.timestamp,
-                            sessionId: legacy.sessionId,
-                            executionId: legacy.executionId,
-                            ...(legacy.turnId === undefined ? {} : { turnId: legacy.turnId }),
-                            ...event,
-                            eventId: `${legacy.eventId}:${event.type}`
-                        }
-                    }));
-                }
-                if (isMarAgentEvent(record.payload)) {
-                    const event = record.payload;
-                    return [{ kind: 'event', sequence: record.sequence, event }];
-                }
-                return [];
-            });
-            return {
-                entries,
-                ...(page.previousBeforeSequence === undefined
-                    ? {}
-                    : { nextCursor: String(page.previousBeforeSequence) })
-            };
-        },
-        readImage: async (sessionId, input) => {
-            assertOpen();
-            const image = await store.readInputImage(sessionId, input);
-            return image === undefined
-                ? undefined
-                : {
-                    name: image.name,
-                    mimeType: image.mimeType,
-                    byteSize: image.byteSize,
-                    dataBase64: image.dataBase64
-                };
-        },
-        readResource: async (sessionId, resourceId) => {
-            assertOpen();
-            return store.readResource(sessionId, resourceId);
-        },
-        readToolResultResource: async (sessionId, input) => {
-            assertOpen();
-            return store.readToolResultResource(sessionId, input);
-        },
-        contextUsage: async (sessionId) => {
-            assertOpen();
-            const page = await store.readPage(sessionId, { limit: 1000 });
-            for (const record of page.records.toReversed()) {
-                if (!isMarAgentEvent(record.payload))
-                    continue;
-                if (record.payload.type === 'context.compacted')
-                    return record.payload.retainedContext === true ? undefined : { inputTokens: 0 };
-                if (record.payload.type === 'usage.updated' && record.payload.purpose !== 'compact') {
-                    const inputTokens = record.payload.contextInputTokens ?? record.payload.inputTokens;
-                    if (typeof inputTokens === 'number' &&
-                        Number.isSafeInteger(inputTokens) &&
-                        inputTokens >= 0)
-                        return { inputTokens };
-                }
-            }
-            return undefined;
-        },
-        fork: async (sessionId, options) => {
-            assertOpen();
-            const session = await store.forkSession(sessionId, options);
-            return { ...session, source: session.source ?? { type: 'user' } };
-        },
-        rollback: async (sessionId, options) => {
-            assertOpen();
-            return store.rollbackSession(sessionId, options);
-        },
-        clear: async (sessionId) => {
-            assertOpen();
-            return store.clearSession(sessionId);
-        },
-        delete: async (sessionId) => {
-            assertOpen();
-            return store.delete(sessionId);
-        },
-        close: () => {
-            closure ??= Promise.resolve().then(() => (borrowed ? undefined : store.close()));
-            return closure;
-        }
-    };
-}
-function parseCursor(cursor) {
-    if (cursor === undefined)
-        return undefined;
-    const value = Number(cursor);
-    if (!/^[1-9]\d*$/u.test(cursor) || !Number.isSafeInteger(value))
-        throw new MarAgentError('MAR_AGENT_TOOL_INPUT_INVALID', 'Session history cursor is invalid.');
-    return value;
-}
-function isRecord(value) {
-    return value !== null && typeof value === 'object' && !Array.isArray(value);
-}
-export function imageMetadata(value) {
-    if (!Array.isArray(value))
-        return [];
-    return value.flatMap((image) => isRecord(image) &&
-        typeof image.name === 'string' &&
-        typeof image.mimeType === 'string' &&
-        typeof image.byteSize === 'number' &&
-        Number.isSafeInteger(image.byteSize) &&
-        image.byteSize >= 0
-        ? [
-            {
-                name: image.name,
-                mimeType: image.mimeType,
-                byteSize: image.byteSize,
-                readable: INPUT_IMAGE_MIME_TYPES.has(image.mimeType) &&
-                    image.byteSize > 0 &&
-                    image.byteSize <= MAX_INPUT_IMAGE_BYTES &&
-                    typeof image.fileName === 'string' &&
-                    /^[a-zA-Z0-9][a-zA-Z0-9._-]{0,127}\.bin$/u.test(image.fileName) &&
-                    typeof image.sha256 === 'string' &&
-                    /^[a-f0-9]{64}$/u.test(image.sha256)
-            }
-        ]
-        : []);
-}
-function isMarAgentEvent(value) {
-    return (isRecord(value) &&
-        typeof value.type === 'string' &&
-        value.type !== 'reasoning.summary' &&
-        typeof value.eventId === 'string' &&
-        typeof value.sequence === 'number' &&
-        typeof value.timestamp === 'string' &&
-        typeof value.sessionId === 'string' &&
-        typeof value.executionId === 'string');
-}

package/dist/agent-core/session/context-gc-checkpoint.d.ts

@@ -1,165 +0,0 @@
-import { type InlineMediaGcCheckpoint } from './inline-media.js';
-import { type ContextGcWebToolName } from './context-gc-replacements.js';
-import { type ContextGcSubagentToolName } from './context-gc-subagent.js';
-import type { SessionRecord } from './store/index.js';
-export declare const CONTEXT_GC_CHECKPOINT_VERSION: 1;
-export declare const CONTEXT_GC_MAX_TARGETS = 4096;
-export type ContextGcPlatform = 'linux' | 'darwin' | 'win32';
-export interface ContextGcEconomicsPolicy {
-    readonly version: 1;
-    readonly immediatePaybackRollouts: number;
-    readonly maximumPaybackRollouts: number;
-    readonly contextGrowthSampleWindow: number;
-    readonly minimumContextGrowthSamples: number;
-    readonly minimumObservationRollouts: number;
-    readonly stageAProtectionRollouts: number;
-    readonly largeExecProtectionRollouts: number;
-    readonly normalInputCostRate: number;
-    readonly cacheReadCostRate: number;
-    readonly cacheWriteCostRate: number;
-    readonly outputCostRate: number;
-    readonly minimumGrossReductionRate: number;
-    readonly minimumCacheInvestmentRoi: number;
-}
-export type ContextGcBase = {
-    readonly type: 'SESSION_START';
-    readonly firstSequence: number;
-} | {
-    readonly type: 'COMPACT';
-    readonly sequence: number;
-    readonly recordId: string;
-};
-export interface ContextGcTarget {
-    readonly observationId?: string;
-    readonly sequence: number;
-    readonly recordId: string;
-    readonly role: 'tool_call' | 'tool' | 'provider';
-    readonly callId?: string;
-    readonly toolName?: string;
-}
-export interface ContextGcReadItemReplacement {
-    readonly supersededByCallId?: string;
-    readonly index: number;
-    readonly path: string;
-    readonly replacement: string;
-    readonly evidenceSequence: number;
-}
-export type ContextGcReplacement = {
-    readonly kind: 'READ_OUTPUT_ITEMS';
-    readonly callId: string;
-    readonly target: ContextGcTarget;
-    readonly items: readonly ContextGcReadItemReplacement[];
-    readonly evidenceSequences: readonly number[];
-} | {
-    readonly kind: 'TOOL_CALL_INPUT';
-    readonly toolName: 'apply_patch' | 'exec' | 'exec_wait' | 'code_exec';
-    readonly callId: string;
-    readonly target: ContextGcTarget;
-    readonly replacementArguments: unknown;
-    readonly providerAliasTargets: readonly ContextGcTarget[];
-    readonly evidenceSequence: number;
-} | {
-    readonly kind: 'EXEC_OUTPUT';
-    readonly terminalCallId?: string;
-    readonly callId: string;
-    readonly target: ContextGcTarget;
-    readonly replacementContent: string;
-    readonly evidenceSequence: number;
-} | {
-    readonly kind: 'CODE_MODE_OUTPUT';
-    readonly callId: string;
-    readonly target: ContextGcTarget;
-    readonly replacementContent: string;
-    readonly evidenceSequence: number;
-} | {
-    readonly kind: 'SUBAGENT_OUTPUT';
-    readonly toolName: 'agent_wait' | 'agent_message' | 'agent_cancel';
-    readonly callId: string;
-    readonly target: ContextGcTarget;
-    readonly replacementContent: string;
-    readonly terminalToolName: ContextGcSubagentToolName;
-    readonly terminalCallId: string;
-    readonly evidenceSequence: number;
-    readonly retainedPriorFinal?: {
-        readonly toolName: ContextGcSubagentToolName;
-        readonly callId: string;
-        readonly evidenceSequence: number;
-    };
-} | {
-    readonly kind: 'WEB_OUTPUT';
-    readonly toolName: ContextGcWebToolName;
-    readonly callId: string;
-    readonly target: ContextGcTarget;
-    readonly replacementContent: string;
-    readonly evidenceSequence: number;
-};
-export interface ContextGcMetrics {
-    readonly stage: 'STAGE_A' | 'STAGE_A_AND_EXEC' | 'INLINE_MEDIA';
-    readonly tokenEstimator?: 'UTF8_BYTES_V1';
-    readonly beforeTokens: number;
-    readonly afterTokens: number;
-    readonly reclaimedTokens: number;
-    readonly grossReductionRate: number;
-    readonly effectiveMinimumGrossReductionRate?: number;
-    readonly minimumRequiredReclaimedTokens?: number;
-    readonly cacheRebuildPenaltyCostUnits: number;
-    readonly compactDeferralCreditCostUnits: number;
-    readonly imminentCompactAvoidanceCreditCostUnits?: number;
-    readonly appliedCompactCreditCostUnits?: number;
-    readonly requiredPositiveNetRollouts: number | null;
-    readonly requiredTargetRoiRollouts: number | null;
-    readonly projectedRolloutsUntilCompactAfterGc: number;
-    readonly projectedTokensBeforeGc?: number;
-    readonly projectedTokensAfterGc?: number;
-    readonly contextGrowthSampleCount: number;
-    readonly contextGrowthP75Tokens: number;
-    readonly expectedNetSavedCostUnits: number;
-    readonly cacheInvestmentRoi: number;
-    readonly minimumObservedRollouts: number;
-    readonly protectedCandidateTokens: number;
-    readonly eligibleCandidateCount: number;
-    readonly eligibleTargetCount: number;
-    readonly cachePenaltyKnown?: boolean;
-}
-export interface ContextGcCheckpointDraft {
-    readonly inlineMedia?: InlineMediaGcCheckpoint;
-    readonly version: 1;
-    readonly base: ContextGcBase;
-    readonly boundarySequence: number;
-    readonly replacements: readonly ContextGcReplacement[];
-    readonly trigger: {
-        readonly usageSequence: number | null;
-        readonly contextInputTokens: number;
-        readonly contextWindowTokens: number;
-        readonly normalRolloutOrdinal: number;
-        readonly modelId: string;
-        readonly platform: ContextGcPlatform;
-    };
-    readonly economics: ContextGcEconomicsPolicy;
-    readonly metrics: ContextGcMetrics;
-}
-export interface ContextGcCheckpointPayload extends ContextGcCheckpointDraft {
-    readonly checkpointId: string;
-    readonly generation: number;
-}
-/** Disposable memoization for one evaluation's immutable record snapshot. */
-export declare class ContextGcCheckpointCache {
-    #private;
-    read(records: readonly SessionRecord[], boundarySequence?: number): ReturnType<typeof latestValidContextGcCheckpoint>;
-}
-export declare function contextGcMinimumUsageGrowth(contextWindowTokens: number): number;
-/** Compare adjacent checkpoint triggers only within the same model/window scope. */
-export declare function contextGcCheckpointIntervalEligible(trigger: ContextGcCheckpointDraft['trigger'], previous?: ContextGcCheckpointDraft['trigger']): boolean;
-export declare function contextGcLogicalPathKey(path: string, workspace: string, platform?: ContextGcPlatform): string | undefined;
-export declare function contextGcTargetKey(target: ContextGcTarget): string;
-export declare function contextGcReplacementKey(replacement: ContextGcReplacement): string;
-export declare function contextGcBaseFromRecords(records: readonly SessionRecord[], boundarySequence?: number): ContextGcBase | undefined;
-export declare function contextGcBaseSequence(base: ContextGcBase): number;
-export declare function normalizeContextGcReplacements(replacements: readonly ContextGcReplacement[]): ContextGcReplacement[] | undefined;
-export declare function parseContextGcCheckpoint(record: SessionRecord | undefined): ContextGcCheckpointPayload | undefined;
-export declare function validateContextGcCheckpoint(records: readonly SessionRecord[], record: SessionRecord, workspace?: string | undefined, committedReplacements?: readonly ContextGcReplacement[]): ContextGcCheckpointPayload | undefined;
-export declare function latestValidContextGcCheckpoint(records: readonly SessionRecord[], boundarySequence?: number): {
-    readonly record: SessionRecord;
-    readonly payload: ContextGcCheckpointPayload;
-} | undefined;
-export declare function sameContextGcBase(left: ContextGcBase | undefined, right: ContextGcBase | undefined): boolean;