botmux 2.33.0 → 2.34.0

package/dist/workflows/cold-scan.js

@@ -0,0 +1,70 @@
+import { promises as fs } from 'node:fs';
+import { join } from 'node:path';
+import { parseWorkflowDefinition } from './definition.js';
+import { EventLog } from './events/append.js';
+import { replay } from './events/replay.js';
+import { getRunsDir } from './runs-dir.js';
+import { readRunChatBinding } from './loader.js';
+export async function scanColdWorkflowRuns(opts) {
+    const runsDir = opts.runsDir ?? getRunsDir();
+    let entries;
+    try {
+        entries = await fs.readdir(runsDir, { withFileTypes: true });
+    }
+    catch (err) {
+        if (err.code === 'ENOENT')
+            return [];
+        throw err;
+    }
+    const out = [];
+    for (const entry of entries) {
+        if (!entry.isDirectory())
+            continue;
+        const runId = entry.name;
+        const dir = join(runsDir, runId);
+        let binding;
+        try {
+            binding = await readRunChatBinding(runId, { runDir: dir });
+        }
+        catch {
+            opts.onSkip?.(runId, 'missing-or-invalid-chat-binding');
+            continue;
+        }
+        if (binding.larkAppId !== opts.ownerLarkAppId) {
+            opts.onSkip?.(runId, 'owned-by-another-lark-app');
+            continue;
+        }
+        let def;
+        try {
+            const raw = await fs.readFile(join(dir, 'workflow.json'), 'utf-8');
+            def = parseWorkflowDefinition(JSON.parse(raw));
+        }
+        catch (err) {
+            opts.onSkip?.(runId, `invalid-workflow-json: ${err instanceof Error ? err.message : String(err)}`);
+            continue;
+        }
+        let snapshot;
+        try {
+            const log = new EventLog(runId, runsDir);
+            const events = await log.readAll();
+            if (events.length === 0) {
+                opts.onSkip?.(runId, 'empty-event-log');
+                continue;
+            }
+            snapshot = replay(events);
+        }
+        catch (err) {
+            opts.onSkip?.(runId, `unreplayable-event-log: ${err instanceof Error ? err.message : String(err)}`);
+            continue;
+        }
+        if (snapshot.run.status === 'succeeded' ||
+            snapshot.run.status === 'failed' ||
+            snapshot.run.status === 'cancelled') {
+            opts.onSkip?.(runId, `terminal-${snapshot.run.status}`);
+            continue;
+        }
+        out.push({ runId, def, snapshot, binding });
+    }
+    return out;
+}
+//# sourceMappingURL=cold-scan.js.map

package/dist/workflows/cold-scan.js.map

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

package/dist/workflows/daemon-spawn.d.ts

@@ -0,0 +1,117 @@
+/**
+ * Daemon-backed `WorkerSpawnFn` implementation.
+ *
+ * Forks `worker.js` for a single workflow step, sends the prompt via
+ * the `init` IPC, and resolves with the agent's final transcript when
+ * the worker emits `final_output` and quiesces.
+ *
+ * Why not reuse `forkWorker` from `core/worker-pool.ts`: that path is
+ * tightly coupled to chat / card / streaming state (DaemonSession,
+ * dashboardEventBus, sessionStore writes).  Workflow steps don't have
+ * a real chat to bind to — we mint a synthetic chatId / rootMessageId
+ * and ignore the worker's chat-side side effects (streaming card POST,
+ * screenshot uploads).  The bot's real `larkAppId / larkAppSecret`
+ * still flow through so the CLI adapter's environment matches a real
+ * spawn.
+ *
+ * The `WorkerProcessFactory` indirection keeps the module unit-testable:
+ * tests inject a scripted process that emits canned IPC frames, real
+ * code injects `forkWorkerJs` (defined below).
+ */
+import type { DaemonSpawnDeps } from './spawn-bot.js';
+type WorkerEvent = {
+    type: 'ready';
+    port: number;
+    token: string;
+} | {
+    type: 'cli_session_id';
+    cliSessionId: string;
+} | {
+    type: 'final_output';
+    content: string;
+    lastUuid: string;
+    turnId: string;
+    kind?: 'bridge' | 'local-turn' | 'local-turn-headless';
+    userText?: string;
+} | {
+    type: 'screen_update';
+    content: string;
+    status: 'working' | 'idle' | 'analyzing';
+} | {
+    type: 'prompt_ready';
+} | {
+    type: 'claude_exit';
+    code: number | null;
+    signal: string | null;
+} | {
+    type: 'error';
+    message: string;
+};
+export interface WorkerHandle {
+    send(msg: unknown): void;
+    on(event: 'message', cb: (msg: WorkerEvent) => void): void;
+    on(event: 'exit', cb: (code: number | null) => void): void;
+    on(event: 'error', cb: (err: Error) => void): void;
+    kill(signal?: NodeJS.Signals): void;
+    readonly pid?: number;
+    readonly stdout?: NodeJS.ReadableStream | null;
+    readonly stderr?: NodeJS.ReadableStream | null;
+}
+export interface WorkerProcessFactory {
+    spawn(opts: WorkerSpawnOptions): WorkerHandle;
+}
+export type WorkerSpawnOptions = {
+    workerPath: string;
+    cwd: string;
+    env: NodeJS.ProcessEnv;
+};
+/** Default factory: real `node:child_process.fork` against `worker.js`. */
+export declare const forkWorkerJsFactory: WorkerProcessFactory;
+export type WorkflowDaemonSpawnDeps = {
+    /** Real workers need access to bot credentials per step. */
+    resolveLarkCredentials(botName: string): {
+        larkAppId: string;
+        larkAppSecret: string;
+    };
+    /** Override worker.js path (tests).  Default: `<dist>/worker.js`. */
+    workerPath?: string;
+    /** Override process factory (tests). */
+    factory?: WorkerProcessFactory;
+    /**
+     * Override how long we wait for the worker's first final_output after
+     * init.  Defaults to 5 minutes — long enough for typical agent steps
+     * with tool use.  Workflow `node.timeoutMs` overrides on a per-step
+     * basis.
+     */
+    defaultTimeoutMs?: number;
+    /**
+     * After we receive `final_output` we wait `quiesceMs` before resolving,
+     * in case the worker emits additional turns (multi-step agent loops).
+     * Tests can shrink this.  Default 800 ms.
+     */
+    quiesceMs?: number;
+    /**
+     * Grace period after cancel SIGINT before escalating to SIGKILL.
+     * Default 5000 ms — long enough for a CLI to flush its current chunk
+     * and exit cleanly, short enough that a stuck worker doesn't keep
+     * `cancelWorkflowRunOnDaemon` blocked.  Per-CLI tuning lives in
+     * v0.1.4-b's `cancelPolicy` schema; we keep a single constant here.
+     */
+    cancelGraceMs?: number;
+};
+export declare function createWorkflowDaemonSpawn(deps: WorkflowDaemonSpawnDeps): DaemonSpawnDeps;
+export declare function expandWorkflowWorkingDir(workingDir: string | undefined): string | undefined;
+/**
+ * Deterministically map any string id to a UUID-v4-shaped hex token.
+ *
+ * Why: Claude Code CLI ≥ 2.1.146 rejects `--session-id` values that
+ * aren't valid UUIDs ("Invalid session ID. Must be a valid UUID."). The
+ * workflow runtime mints synthetic ids by concatenating runId /
+ * activityId / attemptId (which embed `::` separators), so the raw form
+ * fails validation. We keep determinism (same input → same uuid, so the
+ * jsonl bridge path & resume both work) by hashing through SHA-256 and
+ * rewriting the version + variant nibbles to satisfy the v4 shape.
+ */
+export declare function syntheticSessionUuid(rawId: string): string;
+export {};
+//# sourceMappingURL=daemon-spawn.d.ts.map

package/dist/workflows/daemon-spawn.d.ts.map

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