claude-flow 3.57.2 → 3.58.0

package/.claude/proven-config.json

@@ -1,5 +1,5 @@
 {
-  "adoptedAt": 1792452783501,
+  "adoptedAt": 1792476754804,
   "championId": "sha256:6141a8ea990c5063b77e090ae8f37f9c539d8aa8f58dcceb30f3a82f97e57319",
   "manifest": {
     "schema": "ruflo.proven-config/v1",

package/.claude-plugin/marketplace.json

@@ -51,6 +51,17 @@
       "source": "./plugins/ruflo-testgen",
       "description": "Test gap detection, coverage analysis, and automated test generation"
     },
+    {
+      "name": "agentic-qe-fleet",
+      "source": {
+        "source": "git-subdir",
+        "url": "https://github.com/proffesor-for-testing/agentic-qe.git",
+        "path": "plugins/agentic-qe-fleet",
+        "ref": "v3.15.10",
+        "sha": "e5814a2f4f3d7995b87ebda9ad30e8a3d92cd555"
+      },
+      "description": "Agentic QE (external: maintained in proffesor-for-testing/agentic-qe, pinned to v3.15.10): a quality-engineering fleet with 11 QE agents, 9 skills, 9 commands, the agentic-qe MCP server pinned to the plugin version, and the aqe-mod guard that refuses destructive operations on AQE learning data"
+    },
     {
       "name": "ruflo-docs",
       "source": "./plugins/ruflo-docs",

package/README.md

@@ -240,6 +240,7 @@ This adds slash commands and agent definitions. `ruflo-core` (installed above) d
 | [**ruflo-browser**](plugins/ruflo-browser/README.md) | Automate browser testing with Playwright |
 | [**ruflo-jujutsu**](plugins/ruflo-jujutsu/README.md) | Analyze git diffs, score risk, suggest reviewers |
 | [**ruflo-docs**](plugins/ruflo-docs/README.md) | Generate and maintain documentation automatically |
+| [**agentic-qe-fleet**](https://github.com/proffesor-for-testing/agentic-qe/tree/v3.15.10/plugins/agentic-qe-fleet) | External, maintained by [Agentic QE](https://github.com/proffesor-for-testing/agentic-qe): 11 QE agents, test generation, coverage, chaos and TDD skills, the `agentic-qe` MCP server, and a guard for AQE learning data (`/plugin install agentic-qe-fleet@ruflo`). Install it from one marketplace only, `agentic-qe` or `ruflo`: enabled from both, its mod and commands load twice |
 
 #### Security & Compliance
 

package/node_modules/@claude-flow/codex/README.md

@@ -1042,6 +1042,84 @@ npx claude-flow memory optimize --rebuild-index
 
 ---
 
+## Inspect an existing Codex session
+
+The `activity` command lets you pick a helper and read its assignment, recorded
+state, public progress messages, and tool calls/results. It reads local rollout
+files without starting model sessions or sending commands to agents.
+
+From a checkout containing this change:
+
+```bash
+npm install --prefix v3/@claude-flow/codex --workspaces=false --ignore-scripts --legacy-peer-deps --package-lock=false
+npm run build --prefix v3/@claude-flow/codex
+node v3/@claude-flow/codex/dist/cli.js activity \
+  --session-file /path/to/sessions/parent-rollout.jsonl \
+  --sessions-dir /path/to/sessions
+```
+
+Choose the parent rollout explicitly. Only helpers whose recorded parent chain
+leads back to that session appear. The selected directory must contain both the
+parent and helper files; use the smallest directory that contains them all.
+
+Use **j/k** or the arrow keys to select a helper, then **Enter** to open it.
+In the detail view, **j/k** scroll, **Space** moves down a page, **g** goes to the
+top, **G** follows the latest activity, and **b** or **Escape** returns to the list.
+Press **q** to quit; the Codex session keeps running.
+
+Use `--agent <thread-id>` to open a specific helper, `--once` to print a snapshot
+without an interactive terminal, or `--interval <seconds>` to change the refresh
+interval (default: 2 seconds; range: 0.2–60).
+
+These screenshots use made-up session records:
+
+![Agent picker with a parser-review helper](docs/images/activity-picker.png)
+
+![Helper assignment, public progress, command and result](docs/images/activity-detail.png)
+
+### What the viewer can read
+
+The parser supports CLI rollout files with a `session_meta` header, helper ancestry
+in `source.subagent.thread_spawn.parent_thread_id`, and an own-thread marker
+(`payload.thread_id`) before helper activity. Public message, function/custom tool
+call and result records, and supported task/item events are shown. Formats without
+these attribution fields may produce an empty list or unavailable activity.
+
+Copied parent history, reasoning, and system/developer messages are excluded.
+Ambiguous identities and paths through symlinks are rejected. The viewer strips
+terminal controls and masks common credential patterns before shortening previews.
+Masking cannot catch every secret in arbitrary command output: check the visible
+content before sharing a screenshot.
+
+State is the last **recorded** state, not a heartbeat. Discovery stops after 4,000
+entries or eight directory levels; ancestry is limited to 64 links. Each detail
+refresh reads at most 1 MiB, lines are limited to 64 KiB, previews to 2,400 characters,
+and history to 80 events. The metadata header must include its terminating newline
+within the first 64 KiB; an oversized or incomplete header excludes that file.
+The screen labels incomplete scans, omitted records and logs that are still being
+read. Missing data stays unavailable.
+
+### Check the viewer locally
+
+```bash
+cd v3/@claude-flow/codex
+npm test -- --run tests/activity-files.test.ts tests/activity-parser.test.ts tests/activity-viewer.test.ts
+cd ../../..
+node scripts/smoke-codex-activity.mjs
+```
+
+The Node smoke check runs the built CLI against synthetic files and checks the
+picker, detail output, history isolation, invalid input and read-only access.
+The screenshots above were captured from the interactive viewer using synthetic
+records; screenshot generation is not part of CI.
+
+### Release integration
+
+Ship the viewer in `@claude-flow/codex` with the next coordinated Ruflo release.
+At release, bump the package version and exported `VERSION` together, update the
+bundled dependency pins and lockfile, and include the built package in the release
+train.
+
 ## Related Packages
 
 | Package | Description |

package/node_modules/@claude-flow/codex/dist/activity/cli.d.ts

@@ -0,0 +1,3 @@
+import { Command } from 'commander';
+export declare function createActivityCommand(): Command;
+//# sourceMappingURL=cli.d.ts.map

package/node_modules/@claude-flow/codex/dist/activity/cli.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli.d.ts","sourceRoot":"","sources":["../../src/activity/cli.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAwB,MAAM,WAAW,CAAC;AAO1D,wBAAgB,qBAAqB,IAAI,OAAO,CA6B/C"}

package/node_modules/@claude-flow/codex/dist/activity/cli.js

@@ -0,0 +1,115 @@
+import { Command, InvalidArgumentError } from 'commander';
+import { realpath } from 'node:fs/promises';
+import path from 'node:path';
+import { emitKeypressEvents } from 'node:readline';
+import { ActivityViewer } from './viewer.js';
+import { sanitize } from './sanitize.js';
+export function createActivityCommand() {
+    return new Command('activity')
+        .description('Inspect helpers from an existing Codex session (read-only)')
+        .requiredOption('--session-file <file>', 'Parent CLI rollout JSONL file')
+        .requiredOption('--sessions-dir <directory>', 'Directory containing parent and helper rollouts')
+        .option('--agent <id>', 'Open a particular helper thread ID')
+        .option('--once', 'Print one bounded snapshot and exit (no interactive terminal needed)')
+        .option('--interval <seconds>', 'Refresh interval, 0.2 to 60 seconds', interval, 2)
+        .action(async (options) => {
+        try {
+            const root = await realpath(path.resolve(options.sessionsDir));
+            // Canonicalize the directory only. A selected file through a symlink is rejected.
+            const file = path.resolve(root, path.relative(path.resolve(options.sessionsDir), path.resolve(options.sessionFile)));
+            const viewer = new ActivityViewer(root, file);
+            await viewer.refresh();
+            if (viewer.list.error)
+                throw new Error(viewer.list.error);
+            if (options.agent) {
+                if (!viewer.list.helpers.some(item => item.id === options.agent))
+                    throw new Error('Agent is not an attributable helper of this session.');
+                viewer.selected = options.agent;
+                viewer.detail = true;
+                await viewer.refresh();
+            }
+            if (options.once)
+                console.log(viewer.render(100, 200));
+            else
+                await runTerminal(viewer, options.interval * 1000);
+        }
+        catch (error) {
+            console.error(`Activity viewer: ${sanitize(error instanceof Error ? error.message : 'Unable to read session.', 300)}`);
+            process.exitCode = 1;
+        }
+    });
+}
+function interval(value) {
+    const parsed = Number(value);
+    if (!Number.isFinite(parsed) || parsed < 0.2 || parsed > 60)
+        throw new InvalidArgumentError('Choose 0.2 to 60 seconds.');
+    return parsed;
+}
+async function runTerminal(viewer, intervalMs) {
+    const input = process.stdin;
+    const output = process.stdout;
+    if (!input.isTTY || !output.isTTY)
+        throw new Error('Use --once when input or output is not a terminal.');
+    const wasRaw = input.isRaw;
+    let stopped = false;
+    let busy = false;
+    let finish = () => { };
+    const done = new Promise(resolve => { finish = resolve; });
+    const draw = () => {
+        if (!stopped)
+            output.write(`\x1b[H\x1b[2J${viewer.render(output.columns || 80, output.rows || 24)}`);
+    };
+    const close = () => { stopped = true; finish(); };
+    const update = async () => {
+        if (busy || stopped)
+            return;
+        busy = true;
+        try {
+            await viewer.refresh();
+            draw();
+        }
+        catch {
+            close();
+            process.exitCode = 1;
+        }
+        finally {
+            busy = false;
+        }
+    };
+    const keypress = (text, key) => {
+        if (key?.name === 'q' || key?.ctrl && key.name === 'c') {
+            close();
+            return;
+        }
+        viewer.key(text === 'G' ? 'G' : key?.name ?? text);
+        draw();
+        if (key?.name === 'return')
+            void update();
+    };
+    emitKeypressEvents(input);
+    const timer = setInterval(() => { void update(); }, intervalMs);
+    try {
+        input.setRawMode(true);
+        input.resume();
+        input.on('keypress', keypress);
+        output.on('resize', draw);
+        process.on('SIGINT', close);
+        process.on('SIGTERM', close);
+        output.write('\x1b[?1049h\x1b[?25l');
+        draw();
+        await done;
+    }
+    finally {
+        stopped = true;
+        clearInterval(timer);
+        input.off('keypress', keypress);
+        output.off('resize', draw);
+        process.off('SIGINT', close);
+        process.off('SIGTERM', close);
+        input.setRawMode(wasRaw);
+        // This command owns stdin. A resumed stream would keep Node alive after q.
+        input.pause();
+        output.write('\x1b[?25h\x1b[?1049l');
+    }
+}
+//# sourceMappingURL=cli.js.map

package/node_modules/@claude-flow/codex/dist/activity/cli.js.map

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

package/node_modules/@claude-flow/codex/dist/activity/files.d.ts

@@ -0,0 +1,14 @@
+import type { FileHandle } from 'node:fs/promises';
+import { type SessionIdentity } from './types.js';
+export declare const MAX_LINE: number;
+/** Only regular files whose resolved path stays inside the selected directory. */
+export declare function openSession(root: string, file: string): Promise<FileHandle>;
+export declare function readIdentity(root: string, file: string): Promise<SessionIdentity | null>;
+export interface SessionList {
+    root: SessionIdentity | null;
+    helpers: SessionIdentity[];
+    partial: boolean;
+    error: string;
+}
+export declare function listSessions(root: string, rootFile: string, expectedId?: string): Promise<SessionList>;
+//# sourceMappingURL=files.d.ts.map

package/node_modules/@claude-flow/codex/dist/activity/files.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"files.d.ts","sourceRoot":"","sources":["../../src/activity/files.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAEnD,OAAO,EAAU,KAAK,eAAe,EAAE,MAAM,YAAY,CAAC;AAG1D,eAAO,MAAM,QAAQ,QAAY,CAAC;AAGlC,kFAAkF;AAClF,wBAAsB,WAAW,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,CAAC,CAmBjF;AAED,wBAAsB,YAAY,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,eAAe,GAAG,IAAI,CAAC,CAyB9F;AAED,MAAM,WAAW,WAAW;IAC1B,IAAI,EAAE,eAAe,GAAG,IAAI,CAAC;IAC7B,OAAO,EAAE,eAAe,EAAE,CAAC;IAC3B,OAAO,EAAE,OAAO,CAAC;IACjB,KAAK,EAAE,MAAM,CAAC;CACf;AAED,wBAAsB,YAAY,CAAC,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,UAAU,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,CAAC,CAsD5G"}

package/node_modules/@claude-flow/codex/dist/activity/files.js

@@ -0,0 +1,142 @@
+import { constants } from 'node:fs';
+import { lstat, open, opendir, realpath } from 'node:fs/promises';
+import path from 'node:path';
+import { object } from './types.js';
+import { sanitize } from './sanitize.js';
+export const MAX_LINE = 64 * 1024;
+const MAX_ENTRIES = 4000;
+/** Only regular files whose resolved path stays inside the selected directory. */
+export async function openSession(root, file) {
+    const absolute = path.resolve(file);
+    const relative = path.relative(root, absolute);
+    if (!relative || relative === '..' || relative.startsWith(`..${path.sep}`)
+        || path.isAbsolute(relative) || await realpath(absolute) !== absolute) {
+        throw new Error('Session file is outside the selected directory or uses a symlink.');
+    }
+    const before = await lstat(absolute);
+    if (!before.isFile())
+        throw new Error('Session is not a regular file.');
+    const handle = await open(absolute, constants.O_RDONLY | (constants.O_NOFOLLOW ?? 0));
+    try {
+        const after = await handle.stat();
+        if (!after.isFile() || after.ino !== before.ino || after.dev !== before.dev
+            || await realpath(absolute) !== absolute)
+            throw new Error('Session changed while opening.');
+        return handle;
+    }
+    catch (error) {
+        await handle.close();
+        throw error;
+    }
+}
+export async function readIdentity(root, file) {
+    const handle = await openSession(root, file);
+    try {
+        const buffer = Buffer.alloc(MAX_LINE);
+        const { bytesRead } = await handle.read(buffer, 0, buffer.length, 0);
+        const newline = buffer.subarray(0, bytesRead).indexOf(10);
+        // A valid JSON prefix is not enough: require the complete metadata line.
+        if (newline < 0)
+            return null;
+        const record = object(JSON.parse(buffer.subarray(0, newline).toString('utf8')));
+        const meta = object(record.payload);
+        if (record.type !== 'session_meta' || typeof meta.id !== 'string' || !meta.id
+            || meta.id.length > 300)
+            return null;
+        const spawn = object(object(object(meta.source).subagent).thread_spawn);
+        const parent = typeof spawn.parent_thread_id === 'string' ? spawn.parent_thread_id : null;
+        const rootSession = meta.source === 'cli' && !meta.forked_from_id
+            && !meta.parent_thread_id && (!meta.thread_source || meta.thread_source === 'user');
+        if (!parent && !rootSession)
+            return null; // Excludes guardians and unknown sources.
+        return {
+            id: meta.id, parent, file,
+            name: sanitize(meta.agent_nickname ?? spawn.agent_nickname ?? '', 120),
+            path: sanitize(meta.agent_path ?? spawn.agent_path ?? meta.id, 200),
+        };
+    }
+    finally {
+        await handle.close();
+    }
+}
+export async function listSessions(root, rootFile, expectedId) {
+    const empty = { root: null, helpers: [], partial: false, error: '' };
+    let selected;
+    try {
+        selected = await readIdentity(root, rootFile);
+    }
+    catch {
+        return { ...empty, error: 'The selected session file is unavailable.' };
+    }
+    if (!selected || selected.parent || (expectedId && selected.id !== expectedId)) {
+        return { ...empty, error: 'Select a root CLI session with an unchanged identity.' };
+    }
+    const sessions = new Map([[selected.id, selected]]);
+    const duplicates = new Set();
+    const queue = [{ directory: root, depth: 0 }];
+    let entries = 0;
+    let partial = false;
+    while (queue.length && entries < MAX_ENTRIES) {
+        const current = queue.shift();
+        try {
+            // Revalidate directories too; never recurse through a symlink.
+            if (await realpath(current.directory) !== current.directory) {
+                partial = true;
+                continue;
+            }
+            const directory = await opendir(current.directory);
+            for await (const entry of directory) {
+                if (++entries > MAX_ENTRIES) {
+                    partial = true;
+                    break;
+                }
+                const file = path.join(current.directory, entry.name);
+                if (entry.isDirectory()) {
+                    if (current.depth < 8)
+                        queue.push({ directory: file, depth: current.depth + 1 });
+                    else
+                        partial = true;
+                }
+                else if (entry.isFile() && entry.name.endsWith('.jsonl') && file !== rootFile) {
+                    try {
+                        const identity = await readIdentity(root, file);
+                        if (!identity)
+                            continue;
+                        if (sessions.has(identity.id))
+                            duplicates.add(identity.id);
+                        else
+                            sessions.set(identity.id, identity);
+                    }
+                    catch {
+                        partial = true;
+                    }
+                }
+            }
+        }
+        catch {
+            partial = true;
+        }
+    }
+    partial ||= queue.length > 0;
+    if (duplicates.has(selected.id))
+        return { ...empty, partial: true, error: 'Root session identity is ambiguous.' };
+    const belongs = (identity) => {
+        const seen = new Set();
+        let node = identity;
+        while (node?.parent && seen.size < 64) {
+            if (seen.has(node.id) || duplicates.has(node.id))
+                return false;
+            seen.add(node.id);
+            if (node.parent === selected.id)
+                return true;
+            node = sessions.get(node.parent);
+        }
+        return false;
+    };
+    return {
+        root: selected,
+        helpers: [...sessions.values()].filter(belongs).sort((a, b) => a.path.localeCompare(b.path)),
+        partial: partial || duplicates.size > 0, error: '',
+    };
+}
+//# sourceMappingURL=files.js.map

package/node_modules/@claude-flow/codex/dist/activity/files.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"files.js","sourceRoot":"","sources":["../../src/activity/files.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,SAAS,CAAC;AACpC,OAAO,EAAE,KAAK,EAAE,IAAI,EAAE,OAAO,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AAElE,OAAO,IAAI,MAAM,WAAW,CAAC;AAC7B,OAAO,EAAE,MAAM,EAAwB,MAAM,YAAY,CAAC;AAC1D,OAAO,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AAEzC,MAAM,CAAC,MAAM,QAAQ,GAAG,EAAE,GAAG,IAAI,CAAC;AAClC,MAAM,WAAW,GAAG,IAAI,CAAC;AAEzB,kFAAkF;AAClF,MAAM,CAAC,KAAK,UAAU,WAAW,CAAC,IAAY,EAAE,IAAY;IAC1D,MAAM,QAAQ,GAAG,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;IACpC,MAAM,QAAQ,GAAG,IAAI,CAAC,QAAQ,CAAC,IAAI,EAAE,QAAQ,CAAC,CAAC;IAC/C,IAAI,CAAC,QAAQ,IAAI,QAAQ,KAAK,IAAI,IAAI,QAAQ,CAAC,UAAU,CAAC,KAAK,IAAI,CAAC,GAAG,EAAE,CAAC;WACrE,IAAI,CAAC,UAAU,CAAC,QAAQ,CAAC,IAAI,MAAM,QAAQ,CAAC,QAAQ,CAAC,KAAK,QAAQ,EAAE,CAAC;QACxE,MAAM,IAAI,KAAK,CAAC,mEAAmE,CAAC,CAAC;IACvF,CAAC;IACD,MAAM,MAAM,GAAG,MAAM,KAAK,CAAC,QAAQ,CAAC,CAAC;IACrC,IAAI,CAAC,MAAM,CAAC,MAAM,EAAE;QAAE,MAAM,IAAI,KAAK,CAAC,gCAAgC,CAAC,CAAC;IACxE,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,QAAQ,EAAE,SAAS,CAAC,QAAQ,GAAG,CAAC,SAAS,CAAC,UAAU,IAAI,CAAC,CAAC,CAAC,CAAC;IACtF,IAAI,CAAC;QACH,MAAM,KAAK,GAAG,MAAM,MAAM,CAAC,IAAI,EAAE,CAAC;QAClC,IAAI,CAAC,KAAK,CAAC,MAAM,EAAE,IAAI,KAAK,CAAC,GAAG,KAAK,MAAM,CAAC,GAAG,IAAI,KAAK,CAAC,GAAG,KAAK,MAAM,CAAC,GAAG;eACtE,MAAM,QAAQ,CAAC,QAAQ,CAAC,KAAK,QAAQ;YAAE,MAAM,IAAI,KAAK,CAAC,gCAAgC,CAAC,CAAC;QAC9F,OAAO,MAAM,CAAC;IAChB,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,MAAM,MAAM,CAAC,KAAK,EAAE,CAAC;QACrB,MAAM,KAAK,CAAC;IACd,CAAC;AACH,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,YAAY,CAAC,IAAY,EAAE,IAAY;IAC3D,MAAM,MAAM,GAAG,MAAM,WAAW,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC;IAC7C,IAAI,CAAC;QACH,MAAM,MAAM,GAAG,MAAM,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC;QACtC,MAAM,EAAE,SAAS,EAAE,GAAG,MAAM,MAAM,CAAC,IAAI,CAAC,MAAM,EAAE,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC;QACrE,MAAM,OAAO,GAAG,MAAM,CAAC,QAAQ,CAAC,CAAC,EAAE,SAAS,CAAC,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC;QAC1D,yEAAyE;QACzE,IAAI,OAAO,GAAG,CAAC;YAAE,OAAO,IAAI,CAAC;QAC7B,MAAM,MAAM,GAAG,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC,EAAE,OAAO,CAAC,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC;QAChF,MAAM,IAAI,GAAG,MAAM,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;QACpC,IAAI,MAAM,CAAC,IAAI,KAAK,cAAc,IAAI,OAAO,IAAI,CAAC,EAAE,KAAK,QAAQ,IAAI,CAAC,IAAI,CAAC,EAAE;eACxE,IAAI,CAAC,EAAE,CAAC,MAAM,GAAG,GAAG;YAAE,OAAO,IAAI,CAAC;QACvC,MAAM,KAAK,GAAG,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,QAAQ,CAAC,CAAC,YAAY,CAAC,CAAC;QACxE,MAAM,MAAM,GAAG,OAAO,KAAK,CAAC,gBAAgB,KAAK,QAAQ,CAAC,CAAC,CAAC,KAAK,CAAC,gBAAgB,CAAC,CAAC,CAAC,IAAI,CAAC;QAC1F,MAAM,WAAW,GAAG,IAAI,CAAC,MAAM,KAAK,KAAK,IAAI,CAAC,IAAI,CAAC,cAAc;eAC5D,CAAC,IAAI,CAAC,gBAAgB,IAAI,CAAC,CAAC,IAAI,CAAC,aAAa,IAAI,IAAI,CAAC,aAAa,KAAK,MAAM,CAAC,CAAC;QACtF,IAAI,CAAC,MAAM,IAAI,CAAC,WAAW;YAAE,OAAO,IAAI,CAAC,CAAC,0CAA0C;QACpF,OAAO;YACL,EAAE,EAAE,IAAI,CAAC,EAAE,EAAE,MAAM,EAAE,IAAI;YACzB,IAAI,EAAE,QAAQ,CAAC,IAAI,CAAC,cAAc,IAAI,KAAK,CAAC,cAAc,IAAI,EAAE,EAAE,GAAG,CAAC;YACtE,IAAI,EAAE,QAAQ,CAAC,IAAI,CAAC,UAAU,IAAI,KAAK,CAAC,UAAU,IAAI,IAAI,CAAC,EAAE,EAAE,GAAG,CAAC;SACpE,CAAC;IACJ,CAAC;YAAS,CAAC;QACT,MAAM,MAAM,CAAC,KAAK,EAAE,CAAC;IACvB,CAAC;AACH,CAAC;AASD,MAAM,CAAC,KAAK,UAAU,YAAY,CAAC,IAAY,EAAE,QAAgB,EAAE,UAAmB;IACpF,MAAM,KAAK,GAAgB,EAAE,IAAI,EAAE,IAAI,EAAE,OAAO,EAAE,EAAE,EAAE,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,EAAE,EAAE,CAAC;IAClF,IAAI,QAAgC,CAAC;IACrC,IAAI,CAAC;QAAC,QAAQ,GAAG,MAAM,YAAY,CAAC,IAAI,EAAE,QAAQ,CAAC,CAAC;IAAC,CAAC;IACtD,MAAM,CAAC;QAAC,OAAO,EAAE,GAAG,KAAK,EAAE,KAAK,EAAE,2CAA2C,EAAE,CAAC;IAAC,CAAC;IAClF,IAAI,CAAC,QAAQ,IAAI,QAAQ,CAAC,MAAM,IAAI,CAAC,UAAU,IAAI,QAAQ,CAAC,EAAE,KAAK,UAAU,CAAC,EAAE,CAAC;QAC/E,OAAO,EAAE,GAAG,KAAK,EAAE,KAAK,EAAE,uDAAuD,EAAE,CAAC;IACtF,CAAC;IACD,MAAM,QAAQ,GAAG,IAAI,GAAG,CAA0B,CAAC,CAAC,QAAQ,CAAC,EAAE,EAAE,QAAQ,CAAC,CAAC,CAAC,CAAC;IAC7E,MAAM,UAAU,GAAG,IAAI,GAAG,EAAU,CAAC;IACrC,MAAM,KAAK,GAAG,CAAC,EAAE,SAAS,EAAE,IAAI,EAAE,KAAK,EAAE,CAAC,EAAE,CAAC,CAAC;IAC9C,IAAI,OAAO,GAAG,CAAC,CAAC;IAChB,IAAI,OAAO,GAAG,KAAK,CAAC;IACpB,OAAO,KAAK,CAAC,MAAM,IAAI,OAAO,GAAG,WAAW,EAAE,CAAC;QAC7C,MAAM,OAAO,GAAG,KAAK,CAAC,KAAK,EAAG,CAAC;QAC/B,IAAI,CAAC;YACH,+DAA+D;YAC/D,IAAI,MAAM,QAAQ,CAAC,OAAO,CAAC,SAAS,CAAC,KAAK,OAAO,CAAC,SAAS,EAAE,CAAC;gBAAC,OAAO,GAAG,IAAI,CAAC;gBAAC,SAAS;YAAC,CAAC;YAC1F,MAAM,SAAS,GAAG,MAAM,OAAO,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC;YACnD,IAAI,KAAK,EAAE,MAAM,KAAK,IAAI,SAAS,EAAE,CAAC;gBACpC,IAAI,EAAE,OAAO,GAAG,WAAW,EAAE,CAAC;oBAAC,OAAO,GAAG,IAAI,CAAC;oBAAC,MAAM;gBAAC,CAAC;gBACvD,MAAM,IAAI,GAAG,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,SAAS,EAAE,KAAK,CAAC,IAAI,CAAC,CAAC;gBACtD,IAAI,KAAK,CAAC,WAAW,EAAE,EAAE,CAAC;oBACxB,IAAI,OAAO,CAAC,KAAK,GAAG,CAAC;wBAAE,KAAK,CAAC,IAAI,CAAC,EAAE,SAAS,EAAE,IAAI,EAAE,KAAK,EAAE,OAAO,CAAC,KAAK,GAAG,CAAC,EAAE,CAAC,CAAC;;wBAC5E,OAAO,GAAG,IAAI,CAAC;gBACtB,CAAC;qBAAM,IAAI,KAAK,CAAC,MAAM,EAAE,IAAI,KAAK,CAAC,IAAI,CAAC,QAAQ,CAAC,QAAQ,CAAC,IAAI,IAAI,KAAK,QAAQ,EAAE,CAAC;oBAChF,IAAI,CAAC;wBACH,MAAM,QAAQ,GAAG,MAAM,YAAY,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC;wBAChD,IAAI,CAAC,QAAQ;4BAAE,SAAS;wBACxB,IAAI,QAAQ,CAAC,GAAG,CAAC,QAAQ,CAAC,EAAE,CAAC;4BAAE,UAAU,CAAC,GAAG,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC;;4BACtD,QAAQ,CAAC,GAAG,CAAC,QAAQ,CAAC,EAAE,EAAE,QAAQ,CAAC,CAAC;oBAC3C,CAAC;oBAAC,MAAM,CAAC;wBAAC,OAAO,GAAG,IAAI,CAAC;oBAAC,CAAC;gBAC7B,CAAC;YACH,CAAC;QACH,CAAC;QAAC,MAAM,CAAC;YAAC,OAAO,GAAG,IAAI,CAAC;QAAC,CAAC;IAC7B,CAAC;IACD,OAAO,KAAK,KAAK,CAAC,MAAM,GAAG,CAAC,CAAC;IAC7B,IAAI,UAAU,CAAC,GAAG,CAAC,QAAQ,CAAC,EAAE,CAAC;QAAE,OAAO,EAAE,GAAG,KAAK,EAAE,OAAO,EAAE,IAAI,EAAE,KAAK,EAAE,qCAAqC,EAAE,CAAC;IAClH,MAAM,OAAO,GAAG,CAAC,QAAyB,EAAW,EAAE;QACrD,MAAM,IAAI,GAAG,IAAI,GAAG,EAAU,CAAC;QAC/B,IAAI,IAAI,GAAgC,QAAQ,CAAC;QACjD,OAAO,IAAI,EAAE,MAAM,IAAI,IAAI,CAAC,IAAI,GAAG,EAAE,EAAE,CAAC;YACtC,IAAI,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC,IAAI,UAAU,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC;gBAAE,OAAO,KAAK,CAAC;YAC/D,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;YAClB,IAAI,IAAI,CAAC,MAAM,KAAK,QAAQ,CAAC,EAAE;gBAAE,OAAO,IAAI,CAAC;YAC7C,IAAI,GAAG,QAAQ,CAAC,GAAG,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;QACnC,CAAC;QACD,OAAO,KAAK,CAAC;IACf,CAAC,CAAC;IACF,OAAO;QACL,IAAI,EAAE,QAAQ;QACd,OAAO,EAAE,CAAC,GAAG,QAAQ,CAAC,MAAM,EAAE,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,aAAa,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC;QAC5F,OAAO,EAAE,OAAO,IAAI,UAAU,CAAC,IAAI,GAAG,CAAC,EAAE,KAAK,EAAE,EAAE;KACnD,CAAC;AACJ,CAAC"}

package/node_modules/@claude-flow/codex/dist/activity/parser.d.ts

@@ -0,0 +1,21 @@
+import { type ActivitySnapshot } from './types.js';
+/** An allowlist parser. Helper logs may begin with a complete copy of parent history. */
+export declare class ActivityParser {
+    private readonly identity;
+    private readonly agentPath;
+    readonly snapshot: ActivitySnapshot;
+    private first;
+    private verified;
+    private own;
+    private calls;
+    constructor(identity: string, agentPath: string);
+    invalidate(): void;
+    consume(value: unknown): void;
+    private append;
+    private message;
+    private tool;
+    private result;
+    private event;
+    private response;
+}
+//# sourceMappingURL=parser.d.ts.map

package/node_modules/@claude-flow/codex/dist/activity/parser.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"parser.d.ts","sourceRoot":"","sources":["../../src/activity/parser.ts"],"names":[],"mappings":"AAAA,OAAO,EAA8B,KAAK,gBAAgB,EAAqB,MAAM,YAAY,CAAC;AAMlG,yFAAyF;AACzF,qBAAa,cAAc;IAUb,OAAO,CAAC,QAAQ,CAAC,QAAQ;IAAU,OAAO,CAAC,QAAQ,CAAC,SAAS;IATzE,QAAQ,CAAC,QAAQ,EAAE,gBAAgB,CAGjC;IACF,OAAO,CAAC,KAAK,CAAQ;IACrB,OAAO,CAAC,QAAQ,CAAS;IACzB,OAAO,CAAC,GAAG,CAAS;IACpB,OAAO,CAAC,KAAK,CAAoC;gBAEpB,QAAQ,EAAE,MAAM,EAAmB,SAAS,EAAE,MAAM;IAEjF,UAAU,IAAI,IAAI;IAOlB,OAAO,CAAC,KAAK,EAAE,OAAO,GAAG,IAAI;IA2B7B,OAAO,CAAC,MAAM;IAUd,OAAO,CAAC,OAAO;IAQf,OAAO,CAAC,IAAI;IAUZ,OAAO,CAAC,MAAM;IAQd,OAAO,CAAC,KAAK;IA0Bb,OAAO,CAAC,QAAQ;CAiBjB"}

package/node_modules/@claude-flow/codex/dist/activity/parser.js

@@ -0,0 +1,179 @@
+import { object } from './types.js';
+import { publicText, sanitize } from './sanitize.js';
+const MAX_EVENTS = 80;
+const CALL_ID = /^[\w.:/-]{1,300}$/;
+/** An allowlist parser. Helper logs may begin with a complete copy of parent history. */
+export class ActivityParser {
+    identity;
+    agentPath;
+    snapshot = {
+        available: false, status: 'unknown', assignment: '', events: [], updatedAt: '',
+        bytesRead: 0, fileSize: 0, partial: false, limited: false, attributed: false, error: '',
+    };
+    first = true;
+    verified = false;
+    own = false;
+    calls = new Map();
+    constructor(identity, agentPath) {
+        this.identity = identity;
+        this.agentPath = agentPath;
+    }
+    invalidate() {
+        this.own = false;
+        this.calls.clear();
+        this.snapshot.limited = true;
+        if (this.first) {
+            this.first = false;
+            this.snapshot.error = 'Invalid first session record.';
+        }
+    }
+    consume(value) {
+        const record = object(value);
+        if (!Object.keys(object(record.payload)).length) {
+            this.invalidate();
+            return;
+        }
+        const payload = object(record.payload);
+        if (this.first) {
+            this.first = false;
+            if (record.type !== 'session_meta' || payload.id !== this.identity) {
+                this.snapshot.error = 'Session identity does not match the selected agent.';
+                return;
+            }
+            this.verified = true;
+            this.snapshot.available = true;
+            return; // A helper's first header never opens the attribution boundary.
+        }
+        if (!this.verified)
+            return;
+        if (record.type === 'session_meta') {
+            this.own = false;
+            this.calls.clear();
+            return;
+        }
+        if (payload.thread_id !== undefined) {
+            this.own = payload.thread_id === this.identity;
+            if (!this.own)
+                this.calls.clear();
+        }
+        if (!this.own)
+            return;
+        this.snapshot.attributed = true;
+        const time = sanitize(record.timestamp ?? '', 80);
+        if (record.type === 'event_msg')
+            this.event(payload, time);
+        if (record.type === 'response_item')
+            this.response(payload, time);
+    }
+    append(event) {
+        this.snapshot.events.push(event);
+        if (this.snapshot.events.length > MAX_EVENTS) {
+            const removed = this.snapshot.events.shift();
+            for (const [id, item] of this.calls)
+                if (item === removed)
+                    this.calls.delete(id);
+            this.snapshot.limited = true;
+        }
+        this.snapshot.updatedAt = event.time;
+    }
+    message(text, label, time) {
+        if (!text)
+            return;
+        const preview = sanitize(text);
+        if (label === 'Assignment')
+            this.snapshot.assignment = preview;
+        if (this.snapshot.events.at(-1)?.text === preview)
+            return;
+        this.append({ kind: 'message', time, label, text: preview, output: '', status: '' });
+    }
+    tool(id, name, input, time) {
+        if (typeof id !== 'string' || !CALL_ID.test(id) || this.calls.has(id))
+            return;
+        const event = {
+            kind: 'tool', time, label: sanitize(name ?? 'tool', 200), text: sanitize(input), output: '', status: 'running',
+        };
+        this.append(event);
+        this.calls.set(id, event);
+        this.snapshot.status = 'running';
+    }
+    result(id, output, time, status) {
+        const call = typeof id === 'string' ? this.calls.get(id) : undefined;
+        if (!call)
+            return;
+        call.output = sanitize(output);
+        call.status = status ?? resultStatus(output);
+        this.snapshot.updatedAt = time;
+    }
+    event(payload, time) {
+        const states = {
+            task_started: 'running', task_complete: 'completed', task_failed: 'failed',
+            turn_failed: 'failed', turn_aborted: 'interrupted', task_aborted: 'interrupted',
+        };
+        const state = typeof payload.type === 'string' ? states[payload.type] : undefined;
+        if (state) {
+            this.snapshot.status = state;
+            this.snapshot.updatedAt = time;
+        }
+        if (payload.type === 'user_message')
+            this.message(publicText(payload.message), 'Assignment', time);
+        if (payload.type === 'agent_message')
+            this.message(publicText(payload.message), 'Assistant', time);
+        if (payload.type !== 'item_started' && payload.type !== 'item_completed')
+            return;
+        const item = object(payload.item);
+        if (item.type === 'AgentMessage' && ['commentary', 'final', 'final_answer'].includes(String(item.phase))) {
+            this.message(publicText(item.content), 'Assistant', time);
+            this.snapshot.status = item.phase === 'commentary' ? 'running' : 'completed';
+            return;
+        }
+        if (item.type !== 'CommandExecution' && item.type !== 'McpToolCall')
+            return;
+        this.tool(item.id, item.type === 'CommandExecution' ? 'command' : `${String(item.server)}.${String(item.tool)}`, item.command ?? item.arguments ?? '', time);
+        if (payload.type === 'item_completed') {
+            const status = ['failed', 'error', 'declined'].includes(String(item.status))
+                || (item.exit_code !== undefined && item.exit_code !== null && item.exit_code !== 0) ? 'failed' : 'completed';
+            this.result(item.id, item.aggregated_output ?? item.result ?? '', time, status);
+        }
+    }
+    response(payload, time) {
+        if (payload.type === 'message') {
+            const phase = payload.channel ?? payload.phase;
+            if (payload.role === 'user')
+                this.message(publicText(payload.content), 'Assignment', time);
+            else if (payload.role === 'assistant' && ['commentary', 'final', 'final_answer'].includes(String(phase))) {
+                this.message(publicText(payload.content), 'Assistant', time);
+                this.snapshot.status = phase === 'commentary' ? 'running' : 'completed';
+            }
+        }
+        else if (payload.type === 'agent_message') {
+            const incoming = !payload.recipient || payload.recipient === this.agentPath || payload.recipient === this.identity;
+            this.message(publicText(payload.content), incoming ? 'Assignment' : 'Assistant', time);
+        }
+        else if (payload.type === 'function_call' || payload.type === 'custom_tool_call') {
+            this.tool(payload.call_id, payload.name, payload.arguments ?? payload.input ?? '', time);
+        }
+        else if (payload.type === 'function_call_output' || payload.type === 'custom_tool_call_output') {
+            this.result(payload.call_id, payload.output ?? '', time);
+        }
+    }
+}
+function resultStatus(output) {
+    if (typeof output === 'string') {
+        try {
+            return resultStatus(JSON.parse(output));
+        }
+        catch {
+            if (/(?:Script running with cell ID|Process running with session ID)/.test(output))
+                return 'running';
+            const code = /(?:Process exited with code|exit_code["']?\s*:)\s*(-?\d+)/.exec(output);
+            return code && Number(code[1]) !== 0 ? 'failed' : 'returned';
+        }
+    }
+    const value = object(output);
+    if (value.isError === true || (value.exit_code != null && value.exit_code !== 0))
+        return 'failed';
+    if (value.session_id != null && value.exit_code == null)
+        return 'running';
+    return value.exit_code === 0 ? 'completed' : 'returned';
+}
+//# sourceMappingURL=parser.js.map