@myagentroam/agent 0.11.33 → 0.11.34

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

@@ -1,46 +0,0 @@
-import { MarAgentError } from '../error.js';
-/** Resolve the retained prefix only from records read under the Session maintenance lease. */
-export function rollbackBoundaryIndex(records, input) {
-    const invalid = () => new MarAgentError('MAR_AGENT_ROLLBACK_TARGET_INVALID', 'Session rollback target was not found or is ambiguous.');
-    if (input.beforeInput !== undefined) {
-        const target = input.beforeInput;
-        if (input.boundaryTurnId !== undefined ||
-            target === null ||
-            typeof target !== 'object' ||
-            typeof target.turnId !== 'string' ||
-            !target.turnId.trim() ||
-            typeof target.clientMessageId !== 'string' ||
-            !target.clientMessageId.trim())
-            throw invalid();
-        let firstInput = -1;
-        let selected = -1;
-        for (const [index, record] of records.entries()) {
-            if (record.type !== 'turn.user' || record.turnId !== target.turnId)
-                continue;
-            if (firstInput < 0)
-                firstInput = index;
-            const payload = record.payload;
-            if (payload === null || typeof payload !== 'object' || Array.isArray(payload))
-                continue;
-            if (payload.clientMessageId !== target.clientMessageId)
-                continue;
-            if (selected >= 0)
-                throw invalid();
-            selected = index;
-        }
-        if (selected < 0)
-            throw invalid();
-        // The initial input owns execution-start records; subsequent inputs own only their tail.
-        return ((selected === firstInput
-            ? records.findIndex((record) => record.turnId === target.turnId)
-            : selected) - 1);
-    }
-    if (input.boundaryTurnId === null)
-        return 0;
-    if (typeof input.boundaryTurnId !== 'string' || !input.boundaryTurnId.trim())
-        throw invalid();
-    const index = records.findLastIndex((record) => record.turnId === input.boundaryTurnId);
-    if (index < 0)
-        throw invalid();
-    return index;
-}

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

@@ -1,158 +0,0 @@
-import type { CoreCheckpoint, CoreJsonValue } from '../../extensions/data.js';
-import type { ModelMessage, ModelUsage } from '../../model/contracts.js';
-import type { EnvironmentContextState } from '../../runtime/context/contracts.js';
-import type { CodeModeStateEntry } from '../../tools/code-mode/state.js';
-import type { AvailableToolResultResource } from '../../tools/result-extensions.js';
-import type { MarAgentSessionPage, MarAgentSessionSummary } from '../catalog.js';
-import type { ContextGcCheckpointDraft } from '../context-gc-checkpoint.js';
-import type { ToolResultResourceInput, ToolResultResourcePage } from '../tool-result-resources.js';
-import type { SessionListInput, SessionSource, SessionTitleUpdateInput } from '../types.js';
-import type { MarAgentSessionRollbackInput } from '../rollback.js';
-import type { CompactHistoryMessage, RestoredSessionInputImage, SessionExecutionState, SessionInputImage, SessionInputImageData, SessionInputImageMetadata, SessionRecord } from './types.js';
-export type { CompactHistoryMessage, CompactUserInput, RestoredSessionInputImage, SessionExecutionState, SessionInputImage, SessionInputImageData, SessionInputImageMetadata, SessionRecord } from './types.js';
-export type { CodeModeStateEntry } from '../../tools/code-mode/state.js';
-export type { SessionResource } from './resources.js';
-export type { TodoSnapshot, TodoItem } from '../../tools/contracts.js';
-export type { CodeToolCallRecord, CodeObservation } from '../../tools/code-mode/observations.js';
-export type { ModelMessage, ModelUsage, ModelInputMetadata, ModelTextBlock, ModelContextualBlock } from '../../model/contracts.js';
-export type { EnvironmentContextState } from '../../runtime/context/contracts.js';
-export type { ContextGcCheckpointDraft, ContextGcBase, ContextGcPlatform, ContextGcEconomicsPolicy, ContextGcMetrics, ContextGcReplacement, ContextGcTarget, ContextGcReadItemReplacement } from '../context-gc-checkpoint.js';
-export type { ContextGcWebToolName } from '../context-gc-replacements.js';
-export type { ContextGcSubagentToolName } from '../context-gc-subagent.js';
-export type { AvailableToolResultResource } from '../../tools/result-extensions.js';
-/** Logical Session identity, without a physical index or recovery layout. */
-export interface SessionStoreSession {
-    id: string;
-    title: string;
-    workspace: string;
-    createdAt: string;
-    lastActivityAt: string;
-    source?: SessionSource | undefined;
-}
-export interface SessionRecordInput {
-    type: string;
-    payload: unknown;
-    executionId?: string;
-    turnId?: string;
-    timestamp?: string;
-}
-export interface SessionStoreCompactInput {
-    summary: string;
-    replacementHistory?: readonly CompactHistoryMessage[];
-    retainedModelContext?: readonly ModelMessage[];
-    inlineMediaState?: import('../inline-media.js').InlineMediaState;
-    pendingInputs?: readonly SessionRecord[];
-    snapshotRecordId?: string;
-    snapshotMessageCount?: number;
-    environment?: EnvironmentContextState;
-    automatic?: boolean;
-    modelId?: string;
-    contextWindowTokens?: number;
-    usage?: ModelUsage;
-    executionId?: string;
-    turnId?: string;
-}
-/** Store-issued ownership spanning SDK cleanup and the final durable mutation. */
-export interface SessionStoreMaintenance {
-    readonly sessionIds: readonly string[];
-    /** Idempotent; releases maintenance only, never another owner's Execution/retained references. */
-    release(): Promise<void>;
-}
-/**
- * Session persistence port. Implementations preserve record order, committed-resource
- * visibility and the existing per-Session writer/checkpoint atomic boundaries.
- * Owned handles are closed by their creator; injected instances are borrowed.
- */
-export interface SessionStore {
-    createSession(input: {
-        title?: string;
-        workspace: string;
-        source?: SessionSource;
-    }): Promise<SessionStoreSession>;
-    getSession(sessionId: string): Promise<MarAgentSessionSummary & {
-        automaticTitlePending: boolean;
-    }>;
-    list(input?: SessionListInput): Promise<MarAgentSessionPage>;
-    listSubagentChildren(parentSessionId: string): Promise<Array<MarAgentSessionSummary & {
-        source: Extract<SessionSource, {
-            type: 'subagent';
-        }>;
-    }>>;
-    executionConfiguration(sessionId: string): Promise<{
-        readonly modelId: string;
-        readonly modelName?: string;
-        readonly reasoningEffort?: string;
-    } | undefined>;
-    firstUserMessagePreview(sessionId: string): Promise<string | undefined>;
-    sessionTree(sessionId: string): Promise<readonly string[]>;
-    updateTitle(sessionId: string, title: string, input?: SessionTitleUpdateInput, owner?: object): Promise<boolean>;
-    append(sessionId: string, input: SessionRecordInput, options?: {
-        readonly signal?: AbortSignal;
-    }): Promise<SessionRecord>;
-    read(sessionId: string): Promise<SessionRecord[]>;
-    readPage(sessionId: string, input?: {
-        limit?: number;
-        beforeSequence?: number;
-    }): Promise<{
-        records: SessionRecord[];
-        previousBeforeSequence?: number;
-    }>;
-    readExecutionState(sessionId: string): Promise<SessionExecutionState>;
-    userTurnCount(sessionId: string): Promise<number>;
-    readContextualWorldState(sessionId: string): Promise<unknown | undefined>;
-    writeContextualWorldState(sessionId: string, state: unknown): Promise<void>;
-    readCodeModeState(sessionId: string): Promise<CodeModeStateEntry[]>;
-    commitCodeModeState(sessionId: string, mutations: unknown, input: {
-        readonly executionId: string;
-        readonly turnId: string;
-        readonly expectedState?: readonly CodeModeStateEntry[];
-    }): Promise<CodeModeStateEntry[]>;
-    readExtensionCheckpoint(sessionId: string, extensionId: string, key: string): Promise<CoreCheckpoint>;
-    writeExtensionCheckpoint(sessionId: string, extensionId: string, key: string, value: CoreJsonValue | undefined, expectedRevision: number | undefined, input: {
-        owner: object;
-        signal: AbortSignal;
-        executionId?: string;
-        turnId?: string;
-    }): Promise<CoreCheckpoint>;
-    compact(sessionId: string, input: SessionStoreCompactInput, options?: {
-        readonly signal?: AbortSignal;
-    }): Promise<SessionRecord>;
-    commitContextGc(sessionId: string, draft: ContextGcCheckpointDraft, planningRecords?: readonly SessionRecord[]): Promise<SessionRecord>;
-    persistInputImages(sessionId: string, images: readonly SessionInputImage[]): Promise<SessionInputImageMetadata[]>;
-    persistResource(sessionId: string, image: import('../../model/image.js').ModelImage): Promise<import('./resources.js').SessionResource>;
-    setResourceUrl(sessionId: string, resourceId: string, published: {
-        url: string;
-        urlExpiresAt: number;
-    }): Promise<import('./resources.js').SessionResource>;
-    readResource(sessionId: string, resourceId: string): Promise<{
-        mimeType: string;
-        dataBase64: string;
-    } | undefined>;
-    readInputImages(sessionId: string, value: unknown): Promise<RestoredSessionInputImage[]>;
-    readInputImage(sessionId: string, input: {
-        readonly sequence: number;
-        readonly imageIndex: number;
-    }): Promise<SessionInputImageData | undefined>;
-    writeToolResultResource(sessionId: string, text: string): Promise<AvailableToolResultResource>;
-    readToolResultResource(sessionId: string, input: ToolResultResourceInput): Promise<ToolResultResourcePage>;
-    /** One main Execution per Session; an owner may reuse its healthy retained writer. */
-    acquireSessionLease(sessionId: string, owner?: object): Promise<() => Promise<void>>;
-    /** Native writes join the same owner's writer, without admitting another Execution. */
-    acquireSessionWriteLease(sessionId: string, owner: object): Promise<() => Promise<void>>;
-    /** Retention requires the originating owner to hold an active Execution lease. */
-    retainSessionLease(sessionId: string, owner: object): Promise<() => Promise<void>>;
-    hasRetainedSessionLease(sessionId: string, owner: object): boolean;
-    /** Conflicts fail before cleanup; delete includes the Store's current Session tree. */
-    acquireSessionMaintenance(sessionId: string, kind: 'clear' | 'delete', owner?: object): Promise<SessionStoreMaintenance>;
-    forkSession(sessionId: string, input: {
-        readonly boundaryTurnId: string | null;
-        readonly title: string;
-    }): Promise<SessionStoreSession>;
-    rollbackSession(sessionId: string, input: MarAgentSessionRollbackInput): Promise<MarAgentSessionSummary>;
-    clearSession(sessionId: string, maintenance?: SessionStoreMaintenance): Promise<MarAgentSessionSummary>;
-    delete(sessionId: string, maintenance?: SessionStoreMaintenance): Promise<{
-        readonly deleted: boolean;
-    }>;
-    /** Stop using the handle and release its leases before closing it. Never preempts other owners. */
-    close(): Promise<void>;
-}

package/dist/agent-core/session/store/current-state.d.ts

@@ -1,17 +0,0 @@
-import { type CoreCheckpoint } from '../../extensions/data.js';
-import { type CodeModeStateEntry } from '../../tools/code-mode/state.js';
-interface StateRecord {
-    readonly type: string;
-    readonly payload: unknown;
-}
-export type ExtensionCheckpointIndex = Map<string, Map<string, Record<string, unknown>>>;
-/** Derived non-model state owned by one physical Session writer lease. */
-export interface SessionCurrentState {
-    codeState?: CodeModeStateEntry[];
-    extensionCheckpoints?: ExtensionCheckpointIndex;
-}
-export declare function updateSessionCurrentState(cache: SessionCurrentState | undefined, type: string, serialized: string): void;
-export declare function restoreExtensionCheckpoint(records: readonly StateRecord[], extensionId: string, key: string): CoreCheckpoint;
-export declare function indexExtensionCheckpoint(index: ExtensionCheckpointIndex, payload: unknown): void;
-export declare function extensionCheckpointFromPayload(payload: Record<string, unknown> | undefined): CoreCheckpoint;
-export {};

package/dist/agent-core/session/store/current-state.js

@@ -1,53 +0,0 @@
-import { MarAgentError } from '../../error.js';
-import { cloneCoreJson } from '../../extensions/data.js';
-import { restoreCodeModeState } from '../../tools/code-mode/state.js';
-export function updateSessionCurrentState(cache, type, serialized) {
-    if (!cache)
-        return;
-    if (type === 'code.state.updated' && cache.codeState !== undefined) {
-        try {
-            cache.codeState = restoreCodeModeState([JSON.parse(serialized)], cache.codeState);
-        }
-        catch {
-            // Cache maintenance must not fail an already durable append.
-            delete cache.codeState;
-        }
-    }
-    else if (type === 'extension.checkpoint.updated' && cache.extensionCheckpoints) {
-        indexExtensionCheckpoint(cache.extensionCheckpoints, JSON.parse(serialized).payload);
-    }
-}
-export function restoreExtensionCheckpoint(records, extensionId, key) {
-    for (const record of records.toReversed()) {
-        if (record.type !== 'extension.checkpoint.updated')
-            continue;
-        const payload = record.payload;
-        if (!payload || payload.extensionId !== extensionId || payload.key !== key)
-            continue;
-        return extensionCheckpointFromPayload(payload);
-    }
-    return { revision: 0 };
-}
-export function indexExtensionCheckpoint(index, payload) {
-    if (typeof payload !== 'object' || payload === null || Array.isArray(payload))
-        return;
-    const value = payload;
-    if (typeof value.extensionId !== 'string' || typeof value.key !== 'string')
-        return;
-    let namespace = index.get(value.extensionId);
-    if (!namespace)
-        index.set(value.extensionId, (namespace = new Map()));
-    namespace.set(value.key, value);
-}
-export function extensionCheckpointFromPayload(payload) {
-    if (!payload)
-        return { revision: 0 };
-    if (typeof payload.revision !== 'number' ||
-        !Number.isSafeInteger(payload.revision) ||
-        payload.revision < 1)
-        throw new MarAgentError('MAR_AGENT_SESSION_CORRUPT', 'Extension checkpoint revision is corrupt.');
-    return {
-        revision: payload.revision,
-        ...(payload.deleted === true ? {} : { value: cloneCoreJson(payload.value) })
-    };
-}

package/dist/agent-core/session/store/directory-index.d.ts

@@ -1,18 +0,0 @@
-import type { SessionListInput, SessionSource } from '../types.js';
-import type { SessionIndex, SessionMeta } from './types.js';
-/** Merge only derived fields, and only onto the history they were computed from. */
-export declare function mergeSessionDerivedCache(current: SessionMeta, cached: SessionMeta): SessionMeta;
-export declare function readSessionIndex(path: string): Promise<SessionIndex | undefined>;
-export declare function persistSessionIndex(path: string, index: SessionIndex): Promise<void>;
-export declare function normalizeSessionSource(value: SessionSource | undefined): SessionSource;
-interface SessionListFilter {
-    readonly source: SessionSource['type'];
-    readonly parentSessionId?: string;
-    readonly rootSessionId?: string;
-}
-export declare function sessionListFilter(input: SessionListInput): SessionListFilter;
-export declare function sessionMatchesFilter(meta: SessionMeta, filter: SessionListFilter): boolean;
-export declare function encodeSessionListCursor(revision: number, offset: number, filter: SessionListFilter): string;
-export declare function decodeSessionListCursor(cursor: string | undefined, revision: number, filter: SessionListFilter): number;
-export declare function sessionTreeIds(sessions: readonly SessionMeta[], sessionId: string): string[];
-export {};

package/dist/agent-core/session/store/directory-index.js

@@ -1,169 +0,0 @@
-import { randomUUID } from 'node:crypto';
-import { readFile, rename, rm, writeFile } from 'node:fs/promises';
-import { isDeepStrictEqual } from 'node:util';
-import { MarAgentError } from '../../error.js';
-/** Merge only derived fields, and only onto the history they were computed from. */
-export function mergeSessionDerivedCache(current, cached) {
-    if (current.nextSequence !== cached.nextSequence ||
-        current.storageTransactionId !== cached.storageTransactionId)
-        return current;
-    const preview = cached.resume?.firstUserMessageIndexed === true &&
-        current.resume?.firstUserMessagePreview === undefined &&
-        !(current.resume?.firstUserMessageIndexed === true &&
-            cached.resume.firstUserMessagePreview === undefined);
-    const count = current.resume?.userTurns === undefined && cached.resume?.userTurns !== undefined;
-    if (!preview && !count)
-        return current;
-    return {
-        ...current,
-        resume: {
-            ...(current.resume ?? { version: 1, todoRevision: 0 }),
-            ...(count ? { userTurns: cached.resume.userTurns } : {}),
-            ...(preview ? { firstUserMessageIndexed: true } : {}),
-            ...(!preview || cached.resume?.firstUserMessagePreview === undefined
-                ? {}
-                : { firstUserMessagePreview: cached.resume.firstUserMessagePreview })
-        }
-    };
-}
-export async function readSessionIndex(path) {
-    let raw;
-    try {
-        raw = await readFile(path, 'utf8');
-    }
-    catch (cause) {
-        if (cause.code === 'ENOENT')
-            return undefined;
-        throw cause;
-    }
-    try {
-        const value = JSON.parse(raw);
-        if (value?.version !== 1 ||
-            !Number.isSafeInteger(value.revision) ||
-            value.revision < 0 ||
-            !Array.isArray(value.sessions) ||
-            value.sessions.some((session) => typeof session?.id !== 'string' ||
-                !/^[0-9a-f-]{36}$/iu.test(session.id) ||
-                typeof session.title !== 'string' ||
-                typeof session.workspace !== 'string' ||
-                typeof session.createdAt !== 'string' ||
-                typeof session.lastActivityAt !== 'string' ||
-                !Number.isSafeInteger(session.nextSequence) ||
-                session.nextSequence < 1 ||
-                (session.resume?.userTurns !== undefined &&
-                    (!Number.isSafeInteger(session.resume.userTurns) || session.resume.userTurns < 0))))
-            throw new Error('invalid index shape');
-        return value;
-    }
-    catch (cause) {
-        throw new MarAgentError('MAR_AGENT_SESSION_CORRUPT', 'Session index is corrupt.', { cause });
-    }
-}
-export async function persistSessionIndex(path, index) {
-    const temporary = `${path}.${randomUUID()}.tmp`;
-    try {
-        await writeFile(temporary, JSON.stringify(index), { mode: 0o600, flag: 'wx', flush: true });
-        await rename(temporary, path);
-    }
-    finally {
-        await rm(temporary, { force: true });
-    }
-}
-export function normalizeSessionSource(value) {
-    if (value === undefined || value.type === 'user')
-        return { type: 'user' };
-    if (value.type !== 'subagent' ||
-        typeof value.parentSessionId !== 'string' ||
-        !value.parentSessionId.trim() ||
-        typeof value.rootSessionId !== 'string' ||
-        !value.rootSessionId.trim() ||
-        (!value.parentExecutionId && !value.parentOperationId) ||
-        [
-            value.parentExecutionId,
-            value.parentOperationId,
-            value.ownerInstanceId,
-            value.extensionId
-        ].some((identity) => identity !== undefined && (typeof identity !== 'string' || !identity.trim())) ||
-        ((value.ownerInstanceId !== undefined || value.extensionId !== undefined) &&
-            value.parentOperationId === undefined) ||
-        typeof value.description !== 'string' ||
-        !value.description.trim() ||
-        (value.role !== 'general-purpose' && value.role !== 'explore'))
-        throw new MarAgentError('MAR_AGENT_TOOL_INPUT_INVALID', 'Session source is invalid.');
-    return {
-        type: 'subagent',
-        parentSessionId: value.parentSessionId,
-        rootSessionId: value.rootSessionId,
-        ...(value.parentExecutionId === undefined
-            ? {}
-            : { parentExecutionId: value.parentExecutionId }),
-        ...(value.parentOperationId === undefined
-            ? {}
-            : { parentOperationId: value.parentOperationId }),
-        ...(value.ownerInstanceId === undefined ? {} : { ownerInstanceId: value.ownerInstanceId }),
-        ...(value.extensionId === undefined ? {} : { extensionId: value.extensionId }),
-        role: value.role,
-        description: value.description.trim()
-    };
-}
-export function sessionListFilter(input) {
-    const source = input.source ??
-        (input.parentSessionId !== undefined || input.rootSessionId !== undefined
-            ? 'subagent'
-            : 'user');
-    if ((source !== 'user' && source !== 'subagent') ||
-        (input.parentSessionId !== undefined &&
-            (source !== 'subagent' || input.parentSessionId.length === 0)) ||
-        (input.rootSessionId !== undefined &&
-            (source !== 'subagent' || input.rootSessionId.length === 0)))
-        throw new MarAgentError('MAR_AGENT_TOOL_INPUT_INVALID', 'Session list filter is invalid.');
-    return {
-        source,
-        ...(input.parentSessionId === undefined ? {} : { parentSessionId: input.parentSessionId }),
-        ...(input.rootSessionId === undefined ? {} : { rootSessionId: input.rootSessionId })
-    };
-}
-export function sessionMatchesFilter(meta, filter) {
-    const source = normalizeSessionSource(meta.source);
-    return (source.type === filter.source &&
-        (filter.parentSessionId === undefined ||
-            (source.type === 'subagent' && source.parentSessionId === filter.parentSessionId)) &&
-        (filter.rootSessionId === undefined ||
-            (source.type === 'subagent' && source.rootSessionId === filter.rootSessionId)));
-}
-export function encodeSessionListCursor(revision, offset, filter) {
-    return Buffer.from(JSON.stringify({ version: 1, revision, offset, filter })).toString('base64url');
-}
-export function decodeSessionListCursor(cursor, revision, filter) {
-    if (cursor === undefined)
-        return 0;
-    try {
-        const value = JSON.parse(Buffer.from(cursor, 'base64url').toString('utf8'));
-        if (value.version !== 1 ||
-            value.revision !== revision ||
-            !Number.isSafeInteger(value.offset) ||
-            value.offset < 0 ||
-            !isDeepStrictEqual(value.filter, filter))
-            throw new Error('invalid cursor');
-        return value.offset;
-    }
-    catch {
-        throw new MarAgentError('MAR_AGENT_TOOL_INPUT_INVALID', 'Session list cursor is invalid.');
-    }
-}
-export function sessionTreeIds(sessions, sessionId) {
-    if (!sessions.some((session) => session.id === sessionId))
-        return [];
-    const ids = [sessionId];
-    for (let index = 0; index < ids.length; index++) {
-        const parentId = ids[index];
-        for (const session of sessions) {
-            const source = normalizeSessionSource(session.source);
-            if (source.type === 'subagent' &&
-                source.parentSessionId === parentId &&
-                !ids.includes(session.id))
-                ids.push(session.id);
-        }
-    }
-    return ids;
-}

package/dist/agent-core/session/store/execution-state.d.ts

@@ -1,18 +0,0 @@
-import type { ModelInputMetadata } from '../../model/contracts.js';
-import type { CompactHistoryMessage, SessionExecutionState, SessionMeta, SessionRecord } from './types.js';
-export declare function deriveExecutionState(records: readonly SessionRecord[]): SessionExecutionState & {
-    resume: NonNullable<SessionMeta['resume']>;
-};
-export declare function isNativeUserTurn(record: SessionRecord): boolean;
-export declare function userMessagePreviewFromRecord(record: SessionRecord): string | undefined;
-export declare function executionModelFromRecord(record: SessionRecord): {
-    modelId: string;
-    modelName?: string;
-    reasoningEffort?: string;
-} | undefined;
-export declare function compactSummaryFromCheckpoint(record: SessionRecord | undefined): string | undefined;
-export declare function replacementHistoryFromCheckpoint(record: SessionRecord): CompactHistoryMessage[] | undefined;
-export declare function parseModelInputMetadata(value: unknown): ModelInputMetadata | undefined;
-export declare function inputMetadataFromRecord(record: SessionRecord): ModelInputMetadata;
-export declare function isCompactCheckpoint(record: SessionRecord | undefined): boolean;
-export declare function sameResumeIndex(left: SessionMeta['resume'], right: NonNullable<SessionMeta['resume']>): boolean;

package/dist/agent-core/session/store/execution-state.js

@@ -1,175 +0,0 @@
-import { todoItemsFromSnapshot } from '../../tools/agent/todo.js';
-export function deriveExecutionState(records) {
-    let automaticTitle = false;
-    let sawUserTurn = false;
-    let compactSequence;
-    let todoSequence;
-    let todoRevision = 0;
-    let todoItems = [];
-    let executionModel;
-    let firstUserMessagePreview;
-    let userTurns = 0;
-    for (const record of records) {
-        if (isNativeUserTurn(record))
-            userTurns++;
-        firstUserMessagePreview ??= userMessagePreviewFromRecord(record);
-        if (record.type === 'session.created')
-            automaticTitle =
-                record.payload?.automaticTitle === true;
-        else if (record.type === 'turn.user')
-            sawUserTurn = true;
-        else if (record.type === 'session.title.updated')
-            automaticTitle = false;
-        else if (isCompactCheckpoint(record))
-            compactSequence = record.sequence;
-        else if (record.type === 'todo.updated') {
-            const items = todoItemsFromSnapshot(record.payload);
-            if (!items)
-                continue;
-            todoSequence = record.sequence;
-            todoRevision++;
-            todoItems = items;
-        }
-        const candidate = executionModelFromRecord(record);
-        if (candidate !== undefined)
-            executionModel = candidate;
-    }
-    const boundary = records.findLastIndex(isCompactCheckpoint);
-    return {
-        automaticTitlePending: automaticTitle && !sawUserTurn,
-        todo: { revision: todoRevision, items: todoItems },
-        contextRecords: boundary < 0 ? [...records] : records.slice(boundary),
-        resume: {
-            version: 1,
-            userTurns,
-            ...(compactSequence === undefined ? {} : { compactSequence }),
-            ...(todoSequence === undefined ? {} : { todoSequence }),
-            todoRevision,
-            executionModelIndexed: true,
-            firstUserMessageIndexed: true,
-            ...(firstUserMessagePreview === undefined ? {} : { firstUserMessagePreview }),
-            ...(executionModel === undefined ? {} : executionModel)
-        }
-    };
-}
-export function isNativeUserTurn(record) {
-    return (record.type === 'turn.user' &&
-        record.payload.inputSource === undefined);
-}
-export function userMessagePreviewFromRecord(record) {
-    if (record.type !== 'turn.user' ||
-        !isObject(record.payload) ||
-        record.payload.inputSource === 'parent_agent' ||
-        typeof record.payload.prompt !== 'string')
-        return undefined;
-    const preview = record.payload.prompt.trim().replace(/\s+/gu, ' ').slice(0, 160);
-    return preview || undefined;
-}
-export function executionModelFromRecord(record) {
-    if (record.type !== 'execution.header' || !isObject(record.payload))
-        return undefined;
-    const modelId = record.payload.modelId;
-    if (typeof modelId !== 'string' || modelId.trim().length === 0)
-        return undefined;
-    const modelName = record.payload.modelName;
-    const reasoningEffort = record.payload.reasoningEffort;
-    return {
-        modelId,
-        ...(typeof modelName === 'string' && modelName.trim().length > 0 ? { modelName } : {}),
-        ...(typeof reasoningEffort === 'string' && reasoningEffort.trim().length > 0
-            ? { reasoningEffort }
-            : {})
-    };
-}
-export function compactSummaryFromCheckpoint(record) {
-    if (record?.type !== 'compact.completed')
-        return undefined;
-    const payload = record.payload;
-    if (payload === null || typeof payload !== 'object' || Array.isArray(payload))
-        return undefined;
-    const summary = payload.summary;
-    return typeof summary === 'string' && summary.trim().length > 0 ? summary : undefined;
-}
-export function replacementHistoryFromCheckpoint(record) {
-    if (compactSummaryFromCheckpoint(record) === undefined)
-        return undefined;
-    const history = record.payload.replacementHistory;
-    if (!Array.isArray(history) ||
-        !history.every((message) => message !== null &&
-            typeof message === 'object' &&
-            message.role === 'user' &&
-            typeof message.content === 'string' &&
-            (message.metadata === undefined ||
-                (parseModelInputMetadata(message.metadata) !== undefined &&
-                    (message.kind === 'extension_input'
-                        ? message.metadata.source === 'extension'
-                        : message.kind === 'user_input' && message.metadata.source !== 'extension'))) &&
-            (message.kind === 'user_input' ||
-                message.kind === 'extension_input' ||
-                (message.kind === 'summary' && message.content.trim().length > 0))) ||
-        history.filter((message) => message.kind === 'summary').length !== 1)
-        return undefined;
-    return history.map(({ role, content, kind, metadata }) => ({
-        role,
-        content,
-        kind,
-        ...(parseModelInputMetadata(metadata) === undefined
-            ? {}
-            : { metadata: parseModelInputMetadata(metadata) })
-    }));
-}
-export function parseModelInputMetadata(value) {
-    if (value === null || typeof value !== 'object' || Array.isArray(value))
-        return undefined;
-    const metadata = value;
-    if (metadata.source !== 'user' &&
-        metadata.source !== 'parent_agent' &&
-        metadata.source !== 'extension')
-        return undefined;
-    return {
-        source: metadata.source,
-        ...(typeof metadata.recordId === 'string' && metadata.recordId.length <= 128
-            ? { recordId: metadata.recordId }
-            : {}),
-        ...(typeof metadata.extensionId === 'string' && metadata.extensionId.length <= 128
-            ? { extensionId: metadata.extensionId }
-            : {}),
-        ...(metadata.truncated === true ? { truncated: true } : {}),
-        ...(metadata.smartCompaction === true ? { smartCompaction: true } : {})
-    };
-}
-export function inputMetadataFromRecord(record) {
-    const payload = record.payload;
-    const source = payload.source;
-    return {
-        source: record.type === 'extension.input' || payload.inputSource === 'extension'
-            ? 'extension'
-            : payload.inputSource === 'parent_agent'
-                ? 'parent_agent'
-                : 'user',
-        recordId: record.recordId,
-        ...(payload.smartCompaction === true ? { smartCompaction: true } : {}),
-        ...(typeof source?.extensionId === 'string' && source.extensionId.length <= 128
-            ? { extensionId: source.extensionId }
-            : {})
-    };
-}
-export function isCompactCheckpoint(record) {
-    return compactSummaryFromCheckpoint(record) !== undefined;
-}
-export function sameResumeIndex(left, right) {
-    return (left?.version === right.version &&
-        left.userTurns === right.userTurns &&
-        left.compactSequence === right.compactSequence &&
-        left.todoSequence === right.todoSequence &&
-        left.todoRevision === right.todoRevision &&
-        left.executionModelIndexed === right.executionModelIndexed &&
-        left.firstUserMessageIndexed === right.firstUserMessageIndexed &&
-        left.firstUserMessagePreview === right.firstUserMessagePreview &&
-        left.modelId === right.modelId &&
-        left.modelName === right.modelName &&
-        left.reasoningEffort === right.reasoningEffort);
-}
-function isObject(value) {
-    return value !== null && typeof value === 'object' && !Array.isArray(value);
-}