@myagentroam/node 0.1.2 → 0.1.4

package/dist/util/runner-native-session-parsers.js

@@ -0,0 +1,337 @@
+import { fileURLToPath } from 'node:url';
+import { stripClaudePlanTag } from '../runner-command-engine.js';
+import { compactRunnerText, isClaudeCommandTool, isPlainRecord, nativeClaudeCommand, nativePageEnd } from './node-operation-parsers.js';
+export function extractId(result, key) {
+    if (typeof result === 'object' &&
+        result !== null &&
+        key in result &&
+        typeof result[key] === 'object' &&
+        result[key] !== null &&
+        typeof result[key]['id'] === 'string') {
+        return result[key]['id'];
+    }
+    throw new Error(`CODEX_${key.toUpperCase()}_ID_MISSING`);
+}
+export async function settleWithin(promise, milliseconds) {
+    let timer;
+    try {
+        return await Promise.race([
+            promise,
+            new Promise((resolve) => {
+                timer = setTimeout(() => resolve(undefined), milliseconds);
+                timer.unref();
+            })
+        ]);
+    }
+    finally {
+        if (timer !== undefined)
+            clearTimeout(timer);
+    }
+}
+export function extractCodexThreads(result) {
+    if (typeof result !== 'object' || result === null || !('data' in result))
+        return [];
+    const data = result.data;
+    if (!Array.isArray(data))
+        return [];
+    return data.flatMap((entry) => {
+        if (typeof entry !== 'object' || entry === null)
+            return [];
+        const value = entry;
+        if (typeof value.id !== 'string')
+            return [];
+        const source = typeof value.sourceKind === 'string'
+            ? value.sourceKind
+            : typeof value.source === 'string'
+                ? value.source
+                : typeof value.source === 'object' &&
+                    value.source !== null &&
+                    typeof value.source.kind === 'string'
+                    ? value.source.kind
+                    : undefined;
+        const title = typeof value.name === 'string' && value.name.trim().length > 0
+            ? value.name.trim()
+            : typeof value.preview === 'string' && value.preview.trim().length > 0
+                ? value.preview.trim()
+                : undefined;
+        return [{ id: value.id, source, cwd: value.cwd, title }];
+    });
+}
+export function codexThreadActivity(result) {
+    if (!isPlainRecord(result) || !isPlainRecord(result.thread))
+        return 'UNAVAILABLE';
+    const status = result.thread.status;
+    if (!isPlainRecord(status) || typeof status.type !== 'string')
+        return 'UNAVAILABLE';
+    if (status.type === 'active')
+        return 'EXTERNAL_ACTIVE';
+    if (status.type === 'idle' || status.type === 'notLoaded')
+        return 'IDLE';
+    return 'UNAVAILABLE';
+}
+export function externalResumeFailureDetail(error) {
+    const message = error instanceof Error ? error.message : 'SESSION_RESUME_REJECTED';
+    return [...message]
+        .map((character) => (character <= '\u001f' || character === '\u007f' ? ' ' : character))
+        .join('')
+        .replace(/\s+/g, ' ')
+        .trim()
+        .slice(0, 240);
+}
+export function codexActiveTurnId(result) {
+    if (!isPlainRecord(result) ||
+        !isPlainRecord(result.thread) ||
+        !Array.isArray(result.thread.turns))
+        return undefined;
+    const active = result.thread.turns.find((turn) => isPlainRecord(turn) &&
+        typeof turn.id === 'string' &&
+        (turn.status === 'active' || turn.status === 'inProgress'));
+    return isPlainRecord(active) && typeof active.id === 'string' ? active.id : undefined;
+}
+export function codexThreadCwd(value) {
+    if (typeof value !== 'string' || value.length === 0)
+        throw new Error('CODEX_THREAD_CWD_INVALID');
+    if (!value.startsWith('file:'))
+        return value;
+    try {
+        return fileURLToPath(value);
+    }
+    catch {
+        throw new Error('CODEX_THREAD_CWD_INVALID');
+    }
+}
+export function isWithinWorkspace(cwd, workspacePath) {
+    const normalize = (value) => {
+        const compact = value.replace(/[\\/]+/g, '/').replace(/\/$/, '');
+        return process.platform === 'win32' ? compact.toLowerCase() : compact;
+    };
+    const normalizedCwd = normalize(cwd);
+    const normalizedWorkspace = normalize(workspacePath);
+    if (normalizedCwd === normalizedWorkspace)
+        return true;
+    return normalizedCwd.startsWith(`${normalizedWorkspace}/`);
+}
+export function claudeDiscoveredSession(value, fallbackCwd) {
+    if (typeof value !== 'object' || value === null)
+        return undefined;
+    const record = value;
+    const externalSessionId = typeof record.sessionId === 'string'
+        ? record.sessionId
+        : typeof record.id === 'string'
+            ? record.id
+            : undefined;
+    if (externalSessionId === undefined || externalSessionId.length === 0)
+        return undefined;
+    const title = typeof record.summary === 'string'
+        ? record.summary
+        : typeof record.title === 'string'
+            ? record.title
+            : undefined;
+    const cwd = typeof record.cwd === 'string' && record.cwd.length > 0 ? record.cwd : fallbackCwd;
+    return { externalSessionId, cwd, ...(title === undefined ? {} : { title: title.slice(0, 80) }) };
+}
+export function latestNativeActivity(history) {
+    return history.lastActivityAt;
+}
+export function sameContextUsage(left, right) {
+    return (left.model === right.model &&
+        left.usedTokens === right.usedTokens &&
+        left.maxTokens === right.maxTokens);
+}
+export function isNativeHistory(value) {
+    return (typeof value === 'object' &&
+        value !== null &&
+        Array.isArray(value.items));
+}
+export function deduplicateDirectSessions(sessions) {
+    const values = new Map();
+    for (const session of sessions) {
+        const existing = values.get(session.id);
+        if (existing === undefined || existing.lastActivityAt < session.lastActivityAt)
+            values.set(session.id, session);
+    }
+    return [...values.values()].sort((left, right) => right.lastActivityAt - left.lastActivityAt);
+}
+export function nativeConversationPage(session, history, input, runtimeTurns = [], registerImages = () => []) {
+    const limit = Math.min(Math.max(input.limit ?? 30, 1), 500);
+    const end = nativePageEnd(input.cursor, session.id, history.items.length);
+    const start = Math.max(0, end - limit);
+    const turns = history.items.slice(start, end).map((entry, offset) => {
+        const index = start + offset;
+        const time = entry.createdAt ?? index;
+        const turnId = `${session.id}:native:${index}`;
+        const isToolCall = entry.kind === 'tool_call';
+        const isCommand = isToolCall && isClaudeCommandTool(entry.toolName);
+        const userInputQuestions = session.runner === 'claude-code' &&
+            isToolCall &&
+            entry.toolName === 'AskUserQuestion' &&
+            isPlainRecord(entry.input)
+            ? claudeUserInputQuestions(entry.input)
+            : [];
+        const isUserInputRequest = userInputQuestions.length > 0;
+        const clientMessageId = !isToolCall && entry.role === 'USER'
+            ? nativeUserClientMessageId(entry, time, runtimeTurns)
+            : null;
+        // Claude 标签式 Plan Mode：用户正文剥离注入的规划指令标签，
+        // 完整的 <proposed_plan> Agent 文本归一化为计划卡。
+        const entryText = entry.kind === 'message'
+            ? entry.role === 'USER'
+                ? stripClaudePlanTag(entry.text)
+                : entry.text
+            : '';
+        const planText = entry.kind === 'message' && entry.role !== 'USER' ? claudePlanText(entryText) : undefined;
+        const item = {
+            id: `${turnId}:item`,
+            sessionId: session.id,
+            turnId,
+            runId: null,
+            parentItemId: null,
+            sourceSequence: index,
+            revision: 0,
+            kind: isUserInputRequest
+                ? 'user_input_request'
+                : isToolCall
+                    ? isCommand
+                        ? 'command_execution'
+                        : 'tool_call'
+                    : entry.role === 'USER'
+                        ? 'user_message'
+                        : planText !== undefined
+                            ? 'plan'
+                            : 'assistant_message',
+            status: 'COMPLETED',
+            payload: isUserInputRequest
+                ? {
+                    requestId: `native:${entry.kind === 'tool_call' ? entry.toolUseId : `item-${index}`}`,
+                    questions: userInputQuestions
+                }
+                : isToolCall
+                    ? isCommand
+                        ? {
+                            command: nativeClaudeCommand(entry),
+                            cwd: null,
+                            outputPreview: entry.outputSummary ?? '',
+                            outputRef: null,
+                            exitCode: null,
+                            durationMs: null,
+                            truncated: entry.inputTruncated || entry.outputTruncated
+                        }
+                        : {
+                            namespace: session.runner,
+                            toolName: entry.toolName,
+                            title: entry.toolName,
+                            inputSummary: entry.inputSummary,
+                            outputSummary: entry.outputSummary,
+                            progressLabel: null,
+                            errorCode: entry.failed ? 'TOOL_EXECUTION_FAILED' : null,
+                            truncated: entry.inputTruncated || entry.outputTruncated,
+                            ...(entry.imageAttachments === undefined
+                                ? {}
+                                : { attachments: registerImages(entry.imageAttachments) })
+                        }
+                    : entry.role === 'USER'
+                        ? { clientMessageId, text: entryText, contexts: [], delivery: 'ACCEPTED' }
+                        : planText !== undefined
+                            ? { explanation: compactRunnerText(planText, 20_000), steps: [] }
+                            : { text: entryText, format: 'markdown', source: 'native-file' },
+            startedAt: time,
+            completedAt: time
+        };
+        return {
+            id: turnId,
+            sessionId: session.id,
+            runId: null,
+            userItemId: !isToolCall && entry.role === 'USER' ? item.id : null,
+            status: 'SUCCEEDED',
+            model: null,
+            effort: null,
+            access: null,
+            items: [item],
+            startedAt: time,
+            completedAt: time
+        };
+    });
+    return {
+        turns,
+        nextCursor: start > 0
+            ? Buffer.from(JSON.stringify({ sessionId: session.id, end: start })).toString('base64url')
+            : null
+    };
+}
+/**
+ * Claude JSONL 不保存浏览器请求 ID。Node 进程仍存活时，以正文和生成时刻
+ * 对齐当前运行态的用户消息，让 native 历史页替换同一乐观 Turn，而不是重复一条。
+ */
+export function nativeUserClientMessageId(entry, createdAt, runtimeTurns) {
+    for (const turn of runtimeTurns) {
+        const user = turn.items.find((item) => item.kind === 'user_message');
+        if (user === undefined || !isPlainRecord(user.payload))
+            continue;
+        const payload = user.payload;
+        const clientMessageId = typeof payload.clientMessageId === 'string' ? payload.clientMessageId : null;
+        // 标签式 Plan Mode 的指令标签只存在于原生 transcript，运行态气泡始终是原文。
+        if (clientMessageId === null || payload.text !== stripClaudePlanTag(entry.text))
+            continue;
+        const runtimeCreatedAt = user.startedAt ?? turn.startedAt;
+        if (runtimeCreatedAt !== null &&
+            runtimeCreatedAt !== undefined &&
+            Math.abs(createdAt - runtimeCreatedAt) > 60_000)
+            continue;
+        return clientMessageId;
+    }
+    return null;
+}
+/**
+ * Normalize the documented App Server `thread/read(includeTurns: true)`
+ * result.  Only items with a user-visible Workbench representation are kept;
+ * raw protocol envelopes are deliberately never exposed to Web.
+ */
+export function claudePlanText(text) {
+    const trimmed = text.trim();
+    if (!trimmed.startsWith('<proposed_plan>') || !/<\/proposed_plan>\s*$/.test(trimmed))
+        return undefined;
+    const plan = trimmed
+        .slice('<proposed_plan>'.length)
+        .replace(/<\/proposed_plan>\s*$/, '')
+        .trim();
+    return plan.length > 0 ? plan : undefined;
+}
+export function claudeUserInputQuestions(value) {
+    if (!Array.isArray(value.questions) || value.questions.length === 0 || value.questions.length > 4)
+        return [];
+    const questions = value.questions.map((raw, index) => {
+        if (!isPlainRecord(raw) || typeof raw.question !== 'string')
+            return undefined;
+        const options = Array.isArray(raw.options)
+            ? raw.options.flatMap((option) => {
+                if (!isPlainRecord(option) || typeof option.label !== 'string')
+                    return [];
+                const label = compactRunnerText(option.label, 500);
+                return label.length === 0
+                    ? []
+                    : [
+                        {
+                            value: label,
+                            label,
+                            description: typeof option.description === 'string'
+                                ? compactRunnerText(option.description, 1_000)
+                                : null
+                        }
+                    ];
+            })
+            : [];
+        const multiSelect = raw.multiSelect === true;
+        return {
+            id: `claude-question-${index}`,
+            prompt: compactRunnerText(raw.question, 5_000),
+            input: options.length === 0 ? 'SHORT_TEXT' : multiSelect ? 'MULTI_SELECT' : 'SINGLE_SELECT',
+            options,
+            allowOther: options.length === 0,
+            multiSelect
+        };
+    });
+    return questions.some((question) => question === undefined)
+        ? []
+        : questions;
+}
+//# sourceMappingURL=runner-native-session-parsers.js.map

package/dist/util/runner-native-session-parsers.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"runner-native-session-parsers.js","sourceRoot":"","sources":["../../src/util/runner-native-session-parsers.ts"],"names":[],"mappings":"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"}

package/dist/util/secret-environment.d.ts

@@ -0,0 +1 @@
+export declare function parseSecretEnvironment(value: unknown): Readonly<Record<string, string>>;

package/dist/util/secret-environment.js

@@ -0,0 +1,26 @@
+const ENVIRONMENT_NAME = /^[A-Za-z_][A-Za-z0-9_]{0,127}$/;
+const MAX_SECRET_COUNT = 128;
+const MAX_SECRET_VALUE_BYTES = 16 * 1024;
+const MAX_SECRET_TOTAL_BYTES = 64 * 1024;
+export function parseSecretEnvironment(value) {
+    if (value === undefined)
+        return {};
+    if (value === null || typeof value !== 'object' || Array.isArray(value))
+        throw new Error('SECRET_ENVIRONMENT_INVALID');
+    const entries = Object.entries(value);
+    if (entries.length > MAX_SECRET_COUNT)
+        throw new Error('SECRET_ENVIRONMENT_LIMIT_EXCEEDED');
+    const environment = {};
+    let bytes = 0;
+    for (const [name, secret] of entries) {
+        if (!ENVIRONMENT_NAME.test(name) || typeof secret !== 'string' || secret.includes('\0'))
+            throw new Error('SECRET_ENVIRONMENT_INVALID');
+        const valueBytes = Buffer.byteLength(secret);
+        bytes += Buffer.byteLength(name) + valueBytes;
+        if (valueBytes > MAX_SECRET_VALUE_BYTES || bytes > MAX_SECRET_TOTAL_BYTES)
+            throw new Error('SECRET_ENVIRONMENT_LIMIT_EXCEEDED');
+        environment[name] = secret;
+    }
+    return environment;
+}
+//# sourceMappingURL=secret-environment.js.map

package/dist/util/secret-environment.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"secret-environment.js","sourceRoot":"","sources":["../../src/util/secret-environment.ts"],"names":[],"mappings":"AAAA,MAAM,gBAAgB,GAAG,gCAAgC,CAAC;AAC1D,MAAM,gBAAgB,GAAG,GAAG,CAAC;AAC7B,MAAM,sBAAsB,GAAG,EAAE,GAAG,IAAI,CAAC;AACzC,MAAM,sBAAsB,GAAG,EAAE,GAAG,IAAI,CAAC;AAEzC,MAAM,UAAU,sBAAsB,CAAC,KAAc;IACnD,IAAI,KAAK,KAAK,SAAS;QAAE,OAAO,EAAE,CAAC;IACnC,IAAI,KAAK,KAAK,IAAI,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC;QACrE,MAAM,IAAI,KAAK,CAAC,4BAA4B,CAAC,CAAC;IAChD,MAAM,OAAO,GAAG,MAAM,CAAC,OAAO,CAAC,KAAgC,CAAC,CAAC;IACjE,IAAI,OAAO,CAAC,MAAM,GAAG,gBAAgB;QAAE,MAAM,IAAI,KAAK,CAAC,mCAAmC,CAAC,CAAC;IAC5F,MAAM,WAAW,GAA2B,EAAE,CAAC;IAC/C,IAAI,KAAK,GAAG,CAAC,CAAC;IACd,KAAK,MAAM,CAAC,IAAI,EAAE,MAAM,CAAC,IAAI,OAAO,EAAE,CAAC;QACrC,IAAI,CAAC,gBAAgB,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,OAAO,MAAM,KAAK,QAAQ,IAAI,MAAM,CAAC,QAAQ,CAAC,IAAI,CAAC;YACrF,MAAM,IAAI,KAAK,CAAC,4BAA4B,CAAC,CAAC;QAChD,MAAM,UAAU,GAAG,MAAM,CAAC,UAAU,CAAC,MAAM,CAAC,CAAC;QAC7C,KAAK,IAAI,MAAM,CAAC,UAAU,CAAC,IAAI,CAAC,GAAG,UAAU,CAAC;QAC9C,IAAI,UAAU,GAAG,sBAAsB,IAAI,KAAK,GAAG,sBAAsB;YACvE,MAAM,IAAI,KAAK,CAAC,mCAAmC,CAAC,CAAC;QACvD,WAAW,CAAC,IAAI,CAAC,GAAG,MAAM,CAAC;IAC7B,CAAC;IACD,OAAO,WAAW,CAAC;AACrB,CAAC"}

package/dist/workspace.d.ts

@@ -111,15 +111,23 @@ export declare function readRestrictedDiff(workspacePath: string, fromRef: strin
     readonly summary?: string;
     readonly truncated: boolean;
 }>;
-type CurrentChange = {
+export type CurrentChange = {
     readonly path: string;
     readonly state: 'STAGED' | 'UNSTAGED' | 'UNTRACKED';
     readonly change: 'ADDED' | 'MODIFIED' | 'DELETED' | 'RENAMED' | 'COPIED' | 'TYPE_CHANGED';
 };
+export interface CurrentChangesRepository {
+    readonly repositoryPath: string;
+    readonly repositoryName: string;
+    readonly branch: string | null;
+    readonly changes: readonly CurrentChange[];
+}
 export declare function readCurrentChangesSummary(workspacePath: string): Promise<{
     readonly branch: string | null;
     readonly changes: readonly CurrentChange[];
 }>;
+export declare function listInitializedSubmodulePaths(workspacePath: string): Promise<readonly string[]>;
+export declare function resolveGitRepository(workspacePath: string, repositoryPath: string): Promise<string>;
 export declare function readCurrentChanges(workspacePath: string): Promise<readonly {
     readonly path: string;
     readonly state: 'STAGED' | 'UNSTAGED' | 'UNTRACKED';
@@ -141,4 +149,3 @@ export declare class GitCommandError extends Error {
     readonly stderr: string;
     constructor(code: number, stderr: string);
 }
-export {};

package/dist/workspace.js

@@ -738,6 +738,44 @@ export async function readCurrentChangesSummary(workspacePath) {
         changes: output
     };
 }
+export async function listInitializedSubmodulePaths(workspacePath) {
+    const result = await runGit(workspacePath, ['submodule', 'status', '--recursive']);
+    return result.text
+        .split(/\r?\n/)
+        .flatMap((line) => {
+        if (line.length < 42)
+            return [];
+        const marker = line[0];
+        if (marker === '-')
+            return [];
+        const match = /^.[0-9a-f]+\s+(.+?)(?:\s+\([^)]*\))?$/.exec(line);
+        const path = match?.[1]?.replaceAll('\\', '/');
+        return path === undefined || path.length === 0 ? [] : [path];
+    })
+        .sort((left, right) => left.localeCompare(right));
+}
+export async function resolveGitRepository(workspacePath, repositoryPath) {
+    if (repositoryPath.length === 0)
+        return realpath(workspacePath);
+    if (repositoryPath.includes('\0') ||
+        repositoryPath.startsWith('/') ||
+        repositoryPath.startsWith('\\') ||
+        repositoryPath
+            .split('/')
+            .some((segment) => segment.length === 0 || segment === '.' || segment === '..'))
+        throw new Error('GIT_REPOSITORY_INVALID');
+    const repositories = await listInitializedSubmodulePaths(workspacePath);
+    if (!repositories.includes(repositoryPath))
+        throw new Error('GIT_REPOSITORY_INVALID');
+    const repository = resolve(await realpath(workspacePath), repositoryPath);
+    try {
+        await readGitSummary(repository);
+    }
+    catch {
+        throw new Error('GIT_REPOSITORY_INVALID');
+    }
+    return repository;
+}
 export async function readCurrentChanges(workspacePath) {
     return (await readCurrentChangesSummary(workspacePath)).changes;
 }
@@ -807,6 +845,9 @@ async function readWorkingTreeText(workspacePath, path) {
             return undefined;
         throw error;
     }
+    const metadata = await lstat(file);
+    if (!metadata.isFile())
+        return undefined;
     const source = await readFile(file);
     return diffTextFromBuffer(source, source.length > GIT_OUTPUT_LIMIT);
 }