@myagentroam/agent 0.11.33 → 0.11.34

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

@@ -1,25 +0,0 @@
-import type { SessionMeta, SessionRecord } from './types.js';
-export declare function renameIfExists(from: string, to: string): Promise<boolean>;
-interface StagedSessionSegments {
-    readonly files: readonly {
-        readonly path: string;
-        readonly temporaryPath: string;
-    }[];
-    readonly segments: NonNullable<SessionMeta['segments']>;
-}
-export declare function stageSessionSegments(sessionDirectory: string, records: readonly SessionRecord[], operation?: 'rollback' | 'fork'): Promise<StagedSessionSegments>;
-export declare function stageUnreferencedImages(sessionDirectory: string, directoryName: 'generated_images' | 'tool_results' | 'resources', retained: ReadonlySet<string>, transactionId: string): Promise<Array<{
-    from: string;
-    to: string;
-    trash: string;
-}>>;
-export declare function restoreRenamedFiles(files: readonly {
-    readonly from: string;
-    readonly to: string;
-}[]): Promise<void>;
-export declare function retainedSessionTitle(records: readonly SessionRecord[], fallback: string): string;
-export declare function forkedPayload(type: string, value: unknown, sourceSessionId: string, targetSessionId: string, title: string, identities: ReadonlyMap<string, {
-    recordId: string;
-    sequence: number;
-}>): unknown;
-export {};

package/dist/agent-core/session/store/history.js

@@ -1,181 +0,0 @@
-import { randomUUID } from 'node:crypto';
-import { open, readdir, rename, rm } from 'node:fs/promises';
-import { join } from 'node:path';
-import { MarAgentError } from '../../error.js';
-import { parseInlineMediaState } from '../inline-media.js';
-import { MAX_SEGMENT_BYTES } from './records.js';
-export async function renameIfExists(from, to) {
-    try {
-        await rename(from, to);
-        return true;
-    }
-    catch (error) {
-        if (error.code === 'ENOENT')
-            return false;
-        throw error;
-    }
-}
-export async function stageSessionSegments(sessionDirectory, records, operation = 'rollback') {
-    let group;
-    if (records.length === 0)
-        throw new MarAgentError('MAR_AGENT_SESSION_CORRUPT', 'Session history is corrupt.');
-    const transactionId = randomUUID();
-    const files = [];
-    const segments = [];
-    const flush = async () => {
-        if (group === undefined)
-            return;
-        const number = segments.length + 1;
-        const path = join(sessionDirectory, `events-${String(number).padStart(6, '0')}.jsonl`);
-        const temporaryPath = `${path}.${transactionId}.${operation}-tmp`;
-        const handle = await open(temporaryPath, 'wx', 0o600);
-        files.push({ path, temporaryPath });
-        try {
-            await handle.writeFile(group.lines.join(''));
-            await handle.sync();
-        }
-        finally {
-            await handle.close();
-        }
-        segments.push({
-            number,
-            firstSequence: group.firstSequence,
-            lastSequence: group.lastSequence,
-            bytes: group.bytes
-        });
-        group = undefined;
-    };
-    try {
-        for (const record of records) {
-            const line = `${JSON.stringify(record)}\n`;
-            const bytes = Buffer.byteLength(line);
-            if (group !== undefined && group.bytes > 0 && group.bytes + bytes > MAX_SEGMENT_BYTES)
-                await flush();
-            if (group === undefined) {
-                group = {
-                    lines: [],
-                    bytes: 0,
-                    firstSequence: record.sequence,
-                    lastSequence: record.sequence
-                };
-            }
-            group.lines.push(line);
-            group.bytes += bytes;
-            group.lastSequence = record.sequence;
-        }
-        await flush();
-        return { files, segments };
-    }
-    catch (error) {
-        await Promise.all(files.map((item) => rm(item.temporaryPath, { force: true }))).catch(() => undefined);
-        throw error;
-    }
-}
-export async function stageUnreferencedImages(sessionDirectory, directoryName, retained, transactionId) {
-    const directory = join(sessionDirectory, directoryName);
-    let names;
-    try {
-        names = await readdir(directory);
-    }
-    catch (error) {
-        if (error.code === 'ENOENT')
-            return [];
-        throw error;
-    }
-    const moved = [];
-    try {
-        for (const name of names) {
-            if (retained.has(name))
-                continue;
-            const from = join(directory, name);
-            const trash = join(directory, `.${name}.${transactionId}.rollback-trash`);
-            await rename(from, trash);
-            moved.push({ from: trash, to: from, trash });
-        }
-        return moved;
-    }
-    catch (error) {
-        await restoreRenamedFiles(moved);
-        throw error;
-    }
-}
-export async function restoreRenamedFiles(files) {
-    for (const file of files.toReversed())
-        await rename(file.from, file.to).catch(() => undefined);
-}
-export function retainedSessionTitle(records, fallback) {
-    let title = fallback;
-    for (const record of records) {
-        if ((record.type === 'session.created' || record.type === 'session.title.updated') &&
-            isObject(record.payload) &&
-            typeof record.payload.title === 'string' &&
-            record.payload.title.trim().length > 0)
-            title = record.payload.title;
-    }
-    return title;
-}
-export function forkedPayload(type, value, sourceSessionId, targetSessionId, title, identities) {
-    if (value === null || typeof value !== 'object' || Array.isArray(value))
-        return value;
-    const payload = { ...value };
-    const remapWindow = (value) => {
-        const state = parseInlineMediaState(value);
-        if (!state)
-            return value;
-        for (const cursor of [state.consideredThrough, state.evictedThrough]) {
-            if (!cursor?.sourceId.startsWith('input:'))
-                continue;
-            const target = identities.get(cursor.sourceId.slice(6));
-            if (!target)
-                throw new MarAgentError('MAR_AGENT_SESSION_CORRUPT', 'Fork media reference is missing.');
-            cursor.sourceId = `input:${target.recordId}`;
-        }
-        return state;
-    };
-    if (type === 'resource.window')
-        return remapWindow(payload);
-    if (payload.sessionId === sourceSessionId)
-        payload.sessionId = targetSessionId;
-    const application = (input) => {
-        if (typeof input.inputRef !== 'string') {
-            const recordId = isObject(input.metadata) ? input.metadata.recordId : undefined;
-            const identity = typeof recordId === 'string' ? identities.get(recordId) : undefined;
-            return identity && isObject(input.metadata)
-                ? { ...input, metadata: { ...input.metadata, recordId: identity.recordId } }
-                : input;
-        }
-        const identity = identities.get(input.inputRef);
-        if (!identity)
-            throw new MarAgentError('MAR_AGENT_SESSION_CORRUPT', 'Fork input reference is missing.');
-        return {
-            ...input,
-            inputRef: identity.recordId,
-            ...(isObject(input.metadata)
-                ? { metadata: { ...input.metadata, recordId: identity.recordId } }
-                : {})
-        };
-    };
-    if (type === 'model.context')
-        return application(payload);
-    if (type === 'compact.completed') {
-        if (payload.inlineMediaState)
-            payload.inlineMediaState = remapWindow(payload.inlineMediaState);
-        if (Array.isArray(payload.retainedModelContext))
-            payload.retainedModelContext = payload.retainedModelContext.map((item) => isObject(item) ? application(item) : item);
-        if (Array.isArray(payload.pendingInputs))
-            payload.pendingInputs = payload.pendingInputs.map((record) => {
-                const identity = identities.get(record.recordId);
-                if (!identity)
-                    throw new MarAgentError('MAR_AGENT_SESSION_CORRUPT', 'Fork pending input reference is missing.');
-                return { ...record, ...identity, sessionId: targetSessionId };
-            });
-    }
-    if (type === 'session.title.updated') {
-        payload.title = title;
-        payload.automatic = false;
-    }
-    return payload;
-}
-function isObject(value) {
-    return value !== null && typeof value === 'object' && !Array.isArray(value);
-}

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

@@ -1,19 +0,0 @@
-import type { SessionRecord } from './types.js';
-export declare const MAX_INPUT_IMAGES = 5;
-export declare function generatedImageFileNames(records: readonly SessionRecord[]): readonly string[];
-export declare function copyGeneratedImages(sourceSessionDirectory: string, targetSessionDirectory: string, fileNames: readonly string[]): Promise<void>;
-interface InputImageReference {
-    readonly name: string;
-    readonly fileName: string;
-    readonly mimeType: string;
-    readonly byteSize: number;
-    readonly sha256: string;
-    readonly resourceId?: string;
-    readonly url?: string;
-    readonly urlExpiresAt?: number;
-}
-export declare function inputImageReferences(value: unknown): InputImageReference[];
-export declare function inputImageReference(value: unknown): InputImageReference | undefined;
-export declare function validInputImageFileName(fileName: string): boolean;
-export declare function readInputImageBytes(directory: string, reference: InputImageReference): Promise<Buffer>;
-export {};

package/dist/agent-core/session/store/images.js

@@ -1,110 +0,0 @@
-import { copyFile, mkdir, readFile } from 'node:fs/promises';
-import { basename, join } from 'node:path';
-import { MarAgentError } from '../../error.js';
-import { isModelImageUrl } from '../../model/image.js';
-export const MAX_INPUT_IMAGES = 5;
-const MAX_INPUT_IMAGE_BYTES = 5 * 1024 * 1024;
-const MAX_INPUT_IMAGES_BYTES = 10 * 1024 * 1024;
-const INPUT_IMAGE_MIME_TYPES = new Set(['image/png', 'image/jpeg', 'image/gif', 'image/webp']);
-export function generatedImageFileNames(records) {
-    const names = new Set();
-    for (const record of records) {
-        if (record.type !== 'tool.completed' || !isObject(record.payload))
-            continue;
-        const artifacts = record.payload.artifacts;
-        if (!Array.isArray(artifacts))
-            continue;
-        for (const artifact of artifacts) {
-            if (!isObject(artifact) ||
-                artifact.kind !== 'image' ||
-                typeof artifact.fileName !== 'string' ||
-                basename(artifact.fileName) !== artifact.fileName ||
-                !/^[a-zA-Z0-9][a-zA-Z0-9._-]{0,127}\.png$/u.test(artifact.fileName))
-                continue;
-            names.add(artifact.fileName);
-        }
-    }
-    return [...names];
-}
-export async function copyGeneratedImages(sourceSessionDirectory, targetSessionDirectory, fileNames) {
-    if (fileNames.length === 0)
-        return;
-    const source = join(sourceSessionDirectory, 'generated_images');
-    const target = join(targetSessionDirectory, 'generated_images');
-    await mkdir(target, { recursive: true });
-    for (const fileName of fileNames)
-        await copyFile(join(source, fileName), join(target, fileName));
-}
-export function inputImageReferences(value) {
-    if (!Array.isArray(value))
-        return [];
-    const references = [];
-    let totalBytes = 0;
-    for (const image of value) {
-        const reference = inputImageReference(image);
-        if (reference === undefined)
-            continue;
-        totalBytes += reference.byteSize;
-        if (references.length >= MAX_INPUT_IMAGES || totalBytes > MAX_INPUT_IMAGES_BYTES)
-            throw corruptInputImageReference();
-        references.push(reference);
-    }
-    return references;
-}
-export function inputImageReference(value) {
-    if (!isObject(value) || !Object.hasOwn(value, 'fileName'))
-        return undefined;
-    if (typeof value.name !== 'string' ||
-        typeof value.mimeType !== 'string' ||
-        !INPUT_IMAGE_MIME_TYPES.has(value.mimeType) ||
-        typeof value.byteSize !== 'number' ||
-        !Number.isSafeInteger(value.byteSize) ||
-        value.byteSize <= 0 ||
-        value.byteSize > MAX_INPUT_IMAGE_BYTES ||
-        typeof value.fileName !== 'string' ||
-        !validInputImageFileName(value.fileName) ||
-        typeof value.sha256 !== 'string' ||
-        !/^[a-f0-9]{64}$/u.test(value.sha256) ||
-        (value.resourceId !== undefined &&
-            (typeof value.resourceId !== 'string' ||
-                !/^[a-f0-9]{64}$/u.test(value.resourceId) ||
-                value.fileName !== `${value.resourceId}.bin`)) ||
-        (value.url !== undefined && !isModelImageUrl(value.url)) ||
-        (value.urlExpiresAt !== undefined &&
-            (typeof value.urlExpiresAt !== 'number' ||
-                !Number.isSafeInteger(value.urlExpiresAt) ||
-                value.urlExpiresAt <= 0)) ||
-        (value.urlExpiresAt !== undefined && value.url === undefined))
-        throw corruptInputImageReference();
-    return {
-        name: value.name,
-        fileName: value.fileName,
-        mimeType: value.mimeType,
-        byteSize: value.byteSize,
-        sha256: value.sha256,
-        ...(typeof value.resourceId === 'string' ? { resourceId: value.resourceId } : {}),
-        ...(value.url === undefined ? {} : { url: value.url }),
-        ...(typeof value.urlExpiresAt === 'number' ? { urlExpiresAt: value.urlExpiresAt } : {})
-    };
-}
-export function validInputImageFileName(fileName) {
-    return (basename(fileName) === fileName && /^[a-zA-Z0-9][a-zA-Z0-9._-]{0,127}\.bin$/u.test(fileName));
-}
-export async function readInputImageBytes(directory, reference) {
-    try {
-        return await readFile(join(directory, reference.fileName));
-    }
-    catch (cause) {
-        throw new MarAgentError('MAR_AGENT_IMAGE_UNAVAILABLE', 'Session input image is unavailable.', {
-            cause
-        });
-    }
-}
-function corruptInputImageReference(cause) {
-    return new MarAgentError('MAR_AGENT_SESSION_CORRUPT', 'Session input image is corrupt.', {
-        ...(cause === undefined ? {} : { cause })
-    });
-}
-function isObject(value) {
-    return value !== null && typeof value === 'object' && !Array.isArray(value);
-}

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

@@ -1,4 +0,0 @@
-export type { SessionListInput, SessionSource } from '../types.js';
-export { compactSummaryFromCheckpoint, inputMetadataFromRecord, parseModelInputMetadata, replacementHistoryFromCheckpoint } from './execution-state.js';
-export { JsonlSessionStore } from './jsonl-store.js';
-export type { CompactHistoryMessage, CompactUserInput, RestoredSessionInputImage, SessionExecutionState, SessionInputImage, SessionInputImageData, SessionInputImageMetadata, SessionRecord } from './types.js';

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

@@ -1,2 +0,0 @@
-export { compactSummaryFromCheckpoint, inputMetadataFromRecord, parseModelInputMetadata, replacementHistoryFromCheckpoint } from './execution-state.js';
-export { JsonlSessionStore } from './jsonl-store.js';

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

@@ -1,171 +0,0 @@
-import { type MarAgentSessionRollbackInput } from '../rollback.js';
-import type { SessionStore, SessionStoreMaintenance, SessionRecordInput, SessionStoreCompactInput } from './contracts.js';
-import { type CoreCheckpoint, type CoreJsonValue } from '../../extensions/data.js';
-import { type CodeModeStateEntry } from '../../tools/code-mode/state.js';
-import { type ContextGcCheckpointDraft } from '../context-gc-checkpoint.js';
-import { type ToolResultResourceInput } from '../tool-result-resources.js';
-import type { SessionListInput, SessionSource, SessionTitleUpdateInput } from '../types.js';
-import type { RestoredSessionInputImage, SessionExecutionState, SessionInputImage, SessionInputImageData, SessionInputImageMetadata, SessionMeta, SessionRecord } from './types.js';
-/** SDK-owned JSONL history with per-HOME in-process sharing and cross-process file locks. */
-export declare class JsonlSessionStore implements SessionStore {
-    #private;
-    private constructor();
-    static open(home: string): Promise<JsonlSessionStore>;
-    createSession(input: {
-        title?: string;
-        workspace: string;
-        source?: SessionSource;
-    }): Promise<SessionMeta>;
-    readContextualWorldState(sessionId: string): Promise<unknown | undefined>;
-    writeContextualWorldState(sessionId: string, state: unknown): Promise<void>;
-    /** Mark each image pending before publication; turn.user or lease recovery resolves ownership. */
-    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>;
-    writeToolResultResource(sessionId: string, text: string): Promise<{
-        status: "available";
-        resourceRef: string;
-        format: "unified-diff";
-        byteSize: number;
-        sha256: string;
-    }>;
-    readToolResultResource(sessionId: string, input: ToolResultResourceInput): Promise<import("../tool-result-resources.js").ToolResultResourcePage>;
-    readInputImages(sessionId: string, value: unknown): Promise<RestoredSessionInputImage[]>;
-    readInputImage(sessionId: string, input: {
-        readonly sequence: number;
-        readonly imageIndex: number;
-    }): Promise<SessionInputImageData | undefined>;
-    forkSession(sourceSessionId: string, input: {
-        readonly boundaryTurnId: string | null;
-        readonly title: string;
-    }): Promise<{
-        id: string;
-        title: string;
-        workspace: string;
-        createdAt: string;
-        lastActivityAt: string;
-        source: SessionSource | undefined;
-    }>;
-    /** Replace history under a journal; the indexed transaction ID decides the commit side. */
-    rollbackSession(sessionId: string, input: MarAgentSessionRollbackInput): Promise<{
-        id: string;
-        title: string;
-        workspace: string;
-        createdAt: string;
-        lastActivityAt: string;
-        source: SessionSource;
-    }>;
-    updateTitle(sessionId: string, title: string, input?: SessionTitleUpdateInput, owner?: object): Promise<boolean>;
-    /** Reset history with the same recovery journal while preserving the Session identity. */
-    clearSession(sessionId: string, maintenance?: SessionStoreMaintenance): Promise<{
-        id: string;
-        title: string;
-        workspace: string;
-        createdAt: string;
-        lastActivityAt: string;
-        source: SessionSource;
-    }>;
-    getSession(sessionId: string): Promise<{
-        id: string;
-        title: string;
-        workspace: string;
-        createdAt: string;
-        lastActivityAt: string;
-        source: SessionSource;
-        automaticTitlePending: boolean;
-    }>;
-    /** Serialize physical writes and honor cancellation before entering the writer. */
-    append(sessionId: string, input: SessionRecordInput, options?: {
-        readonly signal?: AbortSignal;
-    }): Promise<SessionRecord>;
-    read(sessionId: string): Promise<SessionRecord[]>;
-    readCodeModeState(sessionId: string): 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>;
-    commitCodeModeState(sessionId: string, mutations: unknown, input: {
-        readonly executionId: string;
-        readonly turnId: string;
-        readonly expectedState?: readonly CodeModeStateEntry[];
-    }): Promise<CodeModeStateEntry[]>;
-    readExecutionState(sessionId: string): Promise<SessionExecutionState>;
-    /** Compare the planned sequence inside the existing record writer queue. */
-    commitContextGc(sessionId: string, draft: ContextGcCheckpointDraft, planningRecords?: readonly SessionRecord[]): Promise<SessionRecord>;
-    readPage(sessionId: string, input?: {
-        limit?: number;
-        beforeSequence?: number;
-    }): Promise<{
-        records: SessionRecord[];
-        previousBeforeSequence?: number;
-    }>;
-    compact(sessionId: string, input: SessionStoreCompactInput, options?: {
-        readonly signal?: AbortSignal;
-    }): Promise<SessionRecord>;
-    /** A warm cell retains physical writer ownership between Executions of the same Agent. */
-    acquireSessionLease(sessionId: string, owner?: object): Promise<() => Promise<void>>;
-    hasRetainedSessionLease(sessionId: string, owner: object): boolean;
-    acquireSessionMaintenance(sessionId: string, kind: 'clear' | 'delete', owner?: object): Promise<SessionStoreMaintenance>;
-    /** Native writes join their Agent's sole writer, without admitting another Execution. */
-    acquireSessionWriteLease(sessionId: string, owner: object): Promise<() => Promise<void>>;
-    retainSessionLease(sessionId: string, owner: object): Promise<() => Promise<void>>;
-    list(input?: SessionListInput): Promise<{
-        nextCursor?: string;
-        sessions: {
-            reasoningEffort?: string;
-            modelName?: string;
-            modelId?: string;
-            workspace: string;
-            createdAt: string;
-            lastActivityAt: string;
-            source: SessionSource;
-            firstUserMessagePreview?: string;
-            id: string;
-            title: string;
-        }[];
-    }>;
-    listSubagentChildren(parentSessionId: string): Promise<{
-        reasoningEffort?: string;
-        modelName?: string;
-        modelId?: string;
-        id: string;
-        title: string;
-        workspace: string;
-        createdAt: string;
-        lastActivityAt: string;
-        source: {
-            readonly type: "subagent";
-            readonly parentSessionId: string;
-            readonly rootSessionId: string;
-            readonly parentExecutionId?: string;
-            readonly parentOperationId?: string;
-            readonly ownerInstanceId?: string;
-            readonly extensionId?: string;
-            readonly role: "general-purpose" | "explore";
-            readonly description: string;
-        };
-    }[]>;
-    executionConfiguration(sessionId: string): Promise<{
-        readonly modelId: string;
-        readonly modelName?: string;
-        readonly reasoningEffort?: string;
-    } | undefined>;
-    sessionTree(sessionId: string): Promise<readonly string[]>;
-    /** Counts native input records, not the post-Compact model context. */
-    userTurnCount(sessionId: string): Promise<number>;
-    firstUserMessagePreview(sessionId: string): Promise<string | undefined>;
-    delete(sessionId: string, maintenance?: SessionStoreMaintenance): Promise<{
-        readonly deleted: boolean;
-    }>;
-    close(): Promise<void>;
-}