@myagentroam/agent 0.9.116 → 0.9.118

package/dist/session/transaction-recovery.d.ts

@@ -0,0 +1,16 @@
+export declare function isUnjournaledTransactionFile(name: string): boolean;
+export interface SessionStorageTransaction {
+    readonly version: 1;
+    readonly id: string;
+    readonly kind: 'rollback' | 'clear';
+    readonly originalSegments: readonly string[];
+    readonly stagedSegments: readonly {
+        readonly path: string;
+        readonly temporary: string;
+    }[];
+    readonly sidecarBackup: string;
+}
+/** The index's transaction ID, not the journal's existence, decides the commit side. */
+export declare function beginSessionStorageTransaction(directory: string, transaction: SessionStorageTransaction): Promise<void>;
+/** Must run under the corresponding Session writer lock. Safe to repeat after interruption. */
+export declare function recoverSessionStorageTransaction(directory: string, committedTransactionId?: string): Promise<void>;

package/dist/session/transaction-recovery.js

@@ -0,0 +1,135 @@
+import { randomUUID } from 'node:crypto';
+import { lstat, readFile, readdir, rename, rm, writeFile } from 'node:fs/promises';
+import { join } from 'node:path';
+import { MarAgentError } from '../error.js';
+const JOURNAL = 'storage-transaction.json';
+const SEGMENT = /^events-\d{6}\.jsonl$/u;
+const TRANSACTION_ID = /^[0-9a-f-]{36}$/iu;
+const STAGING_FILE = /^events-\d{6}\.jsonl\.[0-9a-f-]{36}\.rollback-tmp$/iu;
+const JOURNAL_TEMP = /^storage-transaction\.json\.[0-9a-f-]{36}\.tmp$/iu;
+export function isUnjournaledTransactionFile(name) {
+    return STAGING_FILE.test(name) || JOURNAL_TEMP.test(name);
+}
+/** The index's transaction ID, not the journal's existence, decides the commit side. */
+export async function beginSessionStorageTransaction(directory, transaction) {
+    const temporary = join(directory, `${JOURNAL}.${randomUUID()}.tmp`);
+    try {
+        await writeFile(temporary, JSON.stringify(transaction), {
+            mode: 0o600,
+            flag: 'wx',
+            flush: true
+        });
+        await rename(temporary, join(directory, JOURNAL));
+    }
+    finally {
+        await rm(temporary, { force: true });
+    }
+}
+/** Must run under the corresponding Session writer lock. Safe to repeat after interruption. */
+export async function recoverSessionStorageTransaction(directory, committedTransactionId) {
+    const journal = join(directory, JOURNAL);
+    let raw;
+    try {
+        raw = await readFile(journal, 'utf8');
+    }
+    catch (error) {
+        if (error.code === 'ENOENT') {
+            await removeUnjournaledTransactionFiles(directory);
+            return;
+        }
+        throw error;
+    }
+    let transaction;
+    try {
+        transaction = JSON.parse(raw);
+        if (transaction?.version !== 1 ||
+            !TRANSACTION_ID.test(transaction.id) ||
+            (transaction.kind !== 'rollback' && transaction.kind !== 'clear') ||
+            !Array.isArray(transaction.originalSegments) ||
+            !transaction.originalSegments.every((name) => typeof name === 'string' && SEGMENT.test(name)) ||
+            !Array.isArray(transaction.stagedSegments) ||
+            !transaction.stagedSegments.every((entry) => typeof entry?.path === 'string' &&
+                SEGMENT.test(entry.path) &&
+                typeof entry.temporary === 'string' &&
+                /^events-\d{6}\.jsonl\.[0-9a-f-]{36}\.rollback-tmp$/iu.test(entry.temporary) &&
+                entry.temporary.startsWith(`${entry.path}.`)) ||
+            typeof transaction.sidecarBackup !== 'string' ||
+            !new RegExp(`^context-world-state\\.json\\.\\d+\\.${transaction.id}\\.${transaction.kind}-backup$`, 'u').test(transaction.sidecarBackup))
+            throw new Error('invalid session transaction');
+    }
+    catch (cause) {
+        throw new MarAgentError('MAR_AGENT_SESSION_CORRUPT', 'Session storage transaction is corrupt.', {
+            cause
+        });
+    }
+    const committed = transaction.id === committedTransactionId;
+    const originals = new Set(transaction.originalSegments);
+    for (const name of transaction.originalSegments) {
+        const canonical = join(directory, name);
+        const backup = `${canonical}.${transaction.id}.${transaction.kind}-backup`;
+        if (!(await exists(backup)))
+            continue;
+        if (committed)
+            await rm(backup, { force: true });
+        else {
+            await rm(canonical, { force: true });
+            await rename(backup, canonical);
+        }
+    }
+    if (!committed)
+        for (const entry of transaction.stagedSegments)
+            if (!originals.has(entry.path))
+                await rm(join(directory, entry.path), { force: true });
+    for (const entry of transaction.stagedSegments)
+        await rm(join(directory, entry.temporary), { force: true });
+    const sidecar = join(directory, 'context-world-state.json');
+    const backup = join(directory, transaction.sidecarBackup);
+    if (await exists(backup)) {
+        if (committed)
+            await rm(backup, { force: true });
+        else {
+            await rm(sidecar, { force: true });
+            await rename(backup, sidecar);
+        }
+    }
+    for (const folder of ['input_images', 'generated_images']) {
+        const path = join(directory, folder);
+        let names;
+        try {
+            names = await readdir(path);
+        }
+        catch (error) {
+            if (error.code === 'ENOENT')
+                continue;
+            throw error;
+        }
+        const suffix = `.${transaction.id}.rollback-trash`;
+        for (const name of names) {
+            if (!name.startsWith('.') || !name.endsWith(suffix))
+                continue;
+            const trash = join(path, name);
+            if (committed)
+                await rm(trash, { force: true });
+            else
+                await rename(trash, join(path, name.slice(1, -suffix.length)));
+        }
+    }
+    await rm(journal);
+    await removeUnjournaledTransactionFiles(directory);
+}
+async function removeUnjournaledTransactionFiles(directory) {
+    for (const name of await readdir(directory))
+        if (isUnjournaledTransactionFile(name))
+            await rm(join(directory, name), { force: true });
+}
+async function exists(path) {
+    try {
+        await lstat(path);
+        return true;
+    }
+    catch (error) {
+        if (error.code === 'ENOENT')
+            return false;
+        throw error;
+    }
+}

package/dist/session/types.d.ts

@@ -0,0 +1,18 @@
+/** Public session provenance; storage may persist additional private metadata. */
+export type SessionSource = {
+    readonly type: 'user';
+} | {
+    readonly type: 'subagent';
+    readonly parentSessionId: string;
+    readonly rootSessionId: string;
+    readonly parentExecutionId: string;
+    readonly role: 'general-purpose' | 'explore';
+    readonly description: string;
+};
+export interface SessionListInput {
+    readonly limit?: number;
+    readonly cursor?: string;
+    readonly source?: SessionSource['type'];
+    readonly parentSessionId?: string;
+    readonly rootSessionId?: string;
+}

package/dist/session/types.js

@@ -0,0 +1 @@
+export {};

package/dist/tools/agent-cancel.d.ts

@@ -3,5 +3,5 @@ import type { ToolRuntimeContext } from './runtime-context.js';
 export declare const agentCancelToolDefinition: ClientToolDefinition;
 export declare function executeAgentCancel(arguments_: unknown, context: ToolRuntimeContext): Promise<{
     content: string;
-    data: import("../index.js").SubagentTaskSnapshot;
+    data: import("../subagent/scheduler.js").SubagentTaskSnapshot;
 }>;

package/dist/tools/agent-wait.d.ts

@@ -3,5 +3,5 @@ import type { ToolRuntimeContext } from './runtime-context.js';
 export declare const agentWaitToolDefinition: ClientToolDefinition;
 export declare function executeAgentWait(arguments_: unknown, context: ToolRuntimeContext): Promise<{
     content: string;
-    data: import("../index.js").SubagentTaskSnapshot;
+    data: import("../subagent/scheduler.js").SubagentTaskSnapshot;
 }>;

package/dist/tools/exec.js

@@ -6,7 +6,7 @@ import { TOOL_EXECUTION_LIMITS } from './execution-limits.js';
 export const execToolDefinition = {
     name: 'exec',
     parallelSafety: 'safe',
-    description: 'Unrestricted general system execution. Providing command starts any platform-native command, script, text/file tool, builder, generator, network client, or program in workspace/default cwd; action may be omitted for start. poll waits up to yieldMs for new output or termination and returns incremental output while running; after termination, poll returns a bounded cached result with earlier output for up to five minutes while the Session remains hosted. write sends stdin to running processes; cancel terminates a running process or removes a completed result. Returns status, processId, stdout/stderr, cumulative stdoutBytes/stderrBytes, per-result dropped bytes, exitCode, and truncated; a completed status does not imply exitCode 0. Always inspect stderr/exitCode and consume terminal output or cancel.',
+    description: 'Unrestricted general system execution. Providing command starts any platform-native command, script, text/file tool, builder, generator, network client, or program in workspace/default cwd; action may be omitted for start. poll waits up to yieldMs for new output or termination and returns incremental stdout/stderr while running; after termination, poll returns a bounded cached result with earlier output for up to five minutes while the Session remains hosted. write sends stdin to running processes; cancel terminates a running process or removes a completed result. Returns status, processId, stdout/stderr, cumulative stdoutBytes/stderrBytes, per-result dropped bytes, exitCode, and truncated; a completed status does not imply exitCode 0. Always inspect stderr/exitCode and consume terminal output or cancel.',
     outputSchema: {
         type: 'object',
         required: ['content', 'data'],

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@myagentroam/agent",
-  "version": "0.9.116",
+  "version": "0.9.118",
   "description": "Embeddable MAR coding agent SDK and CLI.",
   "license": "Apache-2.0",
   "type": "module",