@mrpatronz/nexusflow 2.6.0 → 2.7.0

package/dist/harness/harness.test.js

@@ -0,0 +1,200 @@
+import { describe, expect, it } from 'vitest';
+import { getAdapter } from './index.js';
+import { Pushable } from './pushable.js';
+import { UnsupportedOperationError, AuthRequiredError } from './interface.js';
+describe('Harness Abstraction Layer', () => {
+    describe('Factory getAdapter', () => {
+        it('returns ClaudeCodeAdapter for claude-code', () => {
+            const adapter = getAdapter('claude-code');
+            expect(adapter.vendor).toBe('claude-code');
+        });
+        it('returns CodexAdapter for codex', () => {
+            const adapter = getAdapter('codex');
+            expect(adapter.vendor).toBe('codex');
+        });
+    });
+    describe('Pushable Async Iterable Queue', () => {
+        it('pushes and yields items sequentially', async () => {
+            const queue = new Pushable();
+            queue.push('item-1');
+            queue.push('item-2');
+            queue.end();
+            const items = [];
+            for await (const item of queue) {
+                items.push(item);
+            }
+            expect(items).toEqual(['item-1', 'item-2']);
+        });
+        it('handles async consumption after end', async () => {
+            const queue = new Pushable();
+            queue.push(10);
+            queue.end();
+            const result = [];
+            for await (const n of queue) {
+                result.push(n);
+            }
+            expect(result).toEqual([10]);
+        });
+        it('drains buffered items to a late subscriber', async () => {
+            const queue = new Pushable();
+            queue.push('a');
+            queue.push('b');
+            queue.push('c');
+            queue.end();
+            const received = [];
+            for await (const item of queue) {
+                received.push(item);
+            }
+            expect(received).toEqual(['a', 'b', 'c']);
+        });
+        it('is idempotent on double-end', async () => {
+            const queue = new Pushable();
+            queue.push('x');
+            queue.end();
+            expect(() => queue.end()).not.toThrow();
+            const items = [];
+            for await (const item of queue) {
+                items.push(item);
+            }
+            expect(items).toEqual(['x']);
+        });
+        it('safely handles dispose() mid-turn without unhandled rejections', async () => {
+            const queue = new Pushable();
+            let closed = false;
+            const safePush = (val) => {
+                if (closed)
+                    return;
+                try {
+                    queue.push(val);
+                }
+                catch {
+                    // Disposed concurrently
+                }
+            };
+            safePush('first-turn');
+            // Simulate concurrent dispose
+            closed = true;
+            queue.end();
+            // In-flight producer tries to push post-disposal
+            expect(() => safePush('in-flight-event')).not.toThrow();
+            const events = [];
+            for await (const ev of queue) {
+                events.push(ev);
+            }
+            expect(events).toEqual(['first-turn']);
+        });
+    });
+    describe('Normalized Contract Stream Verification (Fake Engine)', () => {
+        it('normalizes stream events into canonical HarnessEvent sequence', async () => {
+            const events = [];
+            const out = new Pushable();
+            // Push a canonical turn sequence
+            out.push({ type: 'session_started', sessionId: '123e4567-e89b-12d3-a456-426614174000' });
+            out.push({ type: 'text_delta', text: 'Hel' });
+            out.push({ type: 'text_delta', text: 'lo' });
+            out.push({ type: 'assistant_message', text: 'Hello' });
+            out.push({
+                type: 'turn_completed',
+                usage: {
+                    inputTokens: 100,
+                    outputTokens: 25,
+                    cachedInputTokens: 50,
+                    costUsdEstimate: 0.0015,
+                },
+            });
+            out.end();
+            for await (const ev of out) {
+                events.push(ev);
+            }
+            expect(events).toHaveLength(5);
+            expect(events[0]).toEqual({ type: 'session_started', sessionId: '123e4567-e89b-12d3-a456-426614174000' });
+            expect(events[1]).toEqual({ type: 'text_delta', text: 'Hel' });
+            expect(events[2]).toEqual({ type: 'text_delta', text: 'lo' });
+            expect(events[3]).toEqual({ type: 'assistant_message', text: 'Hello' });
+            expect(events[4]).toEqual({
+                type: 'turn_completed',
+                usage: {
+                    inputTokens: 100,
+                    outputTokens: 25,
+                    cachedInputTokens: 50,
+                    costUsdEstimate: 0.0015,
+                },
+            });
+        });
+        it('serializes errors safely for JSON boundary in turn_failed event', () => {
+            const rawError = new TypeError('Network connection reset');
+            const serialized = {
+                message: rawError.message,
+                name: rawError.name,
+                stack: rawError.stack,
+            };
+            const event = {
+                type: 'turn_failed',
+                error: serialized,
+                fatal: true,
+            };
+            const json = JSON.stringify(event);
+            const parsed = JSON.parse(json);
+            expect(parsed.error.message).toBe('Network connection reset');
+            expect(parsed.error.name).toBe('TypeError');
+            expect(parsed.fatal).toBe(true);
+        });
+    });
+    describe('Authentication Status Detection & Preflight', () => {
+        it('checks authStatus for ClaudeCodeAdapter', async () => {
+            const adapter = getAdapter('claude-code');
+            const status = await adapter.authStatus();
+            expect(status).toHaveProperty('configured');
+            expect(status).toHaveProperty('method');
+        });
+        it('checks authStatus for CodexAdapter', async () => {
+            const adapter = getAdapter('codex');
+            const status = await adapter.authStatus();
+            expect(status).toHaveProperty('configured');
+            expect(status).toHaveProperty('method');
+        });
+        it('detects credentials passed via env parameter (multi-tenant / per-spec)', async () => {
+            const adapter = getAdapter('claude-code');
+            const status = await adapter.authStatus(undefined, { ANTHROPIC_API_KEY: 'test-key' });
+            expect(status.configured).toBe(true);
+            expect(status.method).toBe('api-key');
+            const codexAdapter = getAdapter('codex');
+            const codexStatus = await codexAdapter.authStatus(undefined, { OPENAI_API_KEY: 'sk-test' });
+            expect(codexStatus.configured).toBe(true);
+            expect(codexStatus.method).toBe('api-key');
+        });
+        it('throws AuthRequiredError on start() if unauthenticated', async () => {
+            const origKey = process.env.ANTHROPIC_API_KEY;
+            const origToken = process.env.CLAUDE_CODE_OAUTH_TOKEN;
+            delete process.env.ANTHROPIC_API_KEY;
+            delete process.env.CLAUDE_CODE_OAUTH_TOKEN;
+            try {
+                const adapter = getAdapter('claude-code');
+                await expect(adapter.start({
+                    prompt: 'test',
+                    workspace: { workspaceId: 'test-ws', rootPath: 'C:/test' },
+                })).rejects.toThrow(AuthRequiredError);
+            }
+            finally {
+                if (origKey)
+                    process.env.ANTHROPIC_API_KEY = origKey;
+                if (origToken)
+                    process.env.CLAUDE_CODE_OAUTH_TOKEN = origToken;
+            }
+        });
+    });
+    describe('Error Classes', () => {
+        it('formats UnsupportedOperationError message correctly', () => {
+            const err = new UnsupportedOperationError('codex', 'fork', 'no native fork');
+            expect(err.message).toContain('[codex] fork unsupported: no native fork');
+            expect(err.vendor).toBe('codex');
+            expect(err.operation).toBe('fork');
+        });
+        it('formats AuthRequiredError message correctly', () => {
+            const err = new AuthRequiredError('claude-code', 'token missing');
+            expect(err.message).toContain('[claude-code] Authentication required: token missing');
+            expect(err.vendor).toBe('claude-code');
+        });
+    });
+});
+//# sourceMappingURL=harness.test.js.map

package/dist/harness/harness.test.js.map

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

package/dist/harness/index.d.ts

@@ -0,0 +1,10 @@
+import { CodexAdapter } from "./codex.js";
+import type { HarnessAdapter } from "./interface.js";
+import type { Vendor } from "./types.js";
+export declare function getAdapter(vendor: Vendor, opts?: {
+    sessionStore?: unknown;
+    codexClientOptions?: ConstructorParameters<typeof CodexAdapter>[0];
+}): HarnessAdapter;
+export * from "./types.js";
+export * from "./interface.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/harness/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/harness/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAC1C,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAC;AACrD,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,YAAY,CAAC;AAEzC,wBAAgB,UAAU,CAAC,MAAM,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE;IAChD,YAAY,CAAC,EAAE,OAAO,CAAC;IACvB,kBAAkB,CAAC,EAAE,qBAAqB,CAAC,OAAO,YAAY,CAAC,CAAC,CAAC,CAAC,CAAC;CACpE,GAAG,cAAc,CAOjB;AAED,cAAc,YAAY,CAAC;AAC3B,cAAc,gBAAgB,CAAC"}

package/dist/harness/index.js

@@ -0,0 +1,13 @@
+import { ClaudeCodeAdapter } from "./claude.js";
+import { CodexAdapter } from "./codex.js";
+export function getAdapter(vendor, opts) {
+    switch (vendor) {
+        case "claude-code":
+            return new ClaudeCodeAdapter(opts?.sessionStore);
+        case "codex":
+            return new CodexAdapter(opts?.codexClientOptions);
+    }
+}
+export * from "./types.js";
+export * from "./interface.js";
+//# sourceMappingURL=index.js.map

package/dist/harness/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/harness/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAC;AAChD,OAAO,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAI1C,MAAM,UAAU,UAAU,CAAC,MAAc,EAAE,IAG1C;IACC,QAAQ,MAAM,EAAE,CAAC;QACf,KAAK,aAAa;YAChB,OAAO,IAAI,iBAAiB,CAAC,IAAI,EAAE,YAAY,CAAC,CAAC;QACnD,KAAK,OAAO;YACV,OAAO,IAAI,YAAY,CAAC,IAAI,EAAE,kBAAkB,CAAC,CAAC;IACtD,CAAC;AACH,CAAC;AAED,cAAc,YAAY,CAAC;AAC3B,cAAc,gBAAgB,CAAC"}

package/dist/harness/interface.d.ts

@@ -0,0 +1,42 @@
+import type { ApprovalDecision, AuthStatus, HarnessEvent, ResumeSpec, StartSpec, Vendor, WorkspaceRef } from "./types.js";
+export type SessionSummary = {
+    id: string;
+    updatedAt: string;
+    title?: string;
+};
+export interface SessionHandle {
+    readonly vendor: Vendor;
+    /**
+     * LAZY: resolves when the engine reports its ID mid-stream.
+     * Rejects if the turn fails before initialization (see adapters' reject path).
+     */
+    sessionId(): Promise<string>;
+    /** Terminates after explicit dispose() or fatal unrecoverable error. Multi-turn stream stays alive across turns. */
+    events: AsyncIterable<HarnessEvent>;
+    /** Queue a follow-up user turn. One in-flight turn per handle (adapters serialize). */
+    send(prompt: string): void;
+    /** Resolve a pending approval_required event. No-op for unknown IDs. */
+    respondToApproval(requestId: string, decision: ApprovalDecision): void;
+    interrupt(): Promise<void>;
+    /** Closes input queues, cancels active turns, and terminates the event stream. */
+    dispose(): Promise<void>;
+}
+export interface HarnessAdapter {
+    readonly vendor: Vendor;
+    start(spec: StartSpec): Promise<SessionHandle>;
+    resume(spec: ResumeSpec): Promise<SessionHandle>;
+    /** Check engine authentication status (API key presence, OAuth tokens, session validity). */
+    authStatus(workspace?: WorkspaceRef, env?: Record<string, string>): Promise<AuthStatus>;
+    /** Backed by Claude sessionStore. Throws for Codex (known asymmetry). */
+    listSessions(workspace: WorkspaceRef): Promise<SessionSummary[]>;
+}
+export declare class UnsupportedOperationError extends Error {
+    readonly vendor: Vendor;
+    readonly operation: string;
+    constructor(vendor: Vendor, operation: string, reason: string);
+}
+export declare class AuthRequiredError extends Error {
+    readonly vendor: Vendor;
+    constructor(vendor: Vendor, message: string);
+}
+//# sourceMappingURL=interface.d.ts.map

package/dist/harness/interface.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"interface.d.ts","sourceRoot":"","sources":["../../src/harness/interface.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,gBAAgB,EAChB,UAAU,EACV,YAAY,EACZ,UAAU,EACV,SAAS,EACT,MAAM,EACN,YAAY,EACb,MAAM,YAAY,CAAC;AAEpB,MAAM,MAAM,cAAc,GAAG;IAC3B,EAAE,EAAE,MAAM,CAAC;IACX,SAAS,EAAE,MAAM,CAAC;IAClB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB,CAAC;AAEF,MAAM,WAAW,aAAa;IAC5B,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IAExB;;;OAGG;IACH,SAAS,IAAI,OAAO,CAAC,MAAM,CAAC,CAAC;IAE7B,oHAAoH;IACpH,MAAM,EAAE,aAAa,CAAC,YAAY,CAAC,CAAC;IAEpC,uFAAuF;IACvF,IAAI,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;IAE3B,wEAAwE;IACxE,iBAAiB,CAAC,SAAS,EAAE,MAAM,EAAE,QAAQ,EAAE,gBAAgB,GAAG,IAAI,CAAC;IAEvE,SAAS,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IAE3B,kFAAkF;IAClF,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;CAC1B;AAED,MAAM,WAAW,cAAc;IAC7B,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,KAAK,CAAC,IAAI,EAAE,SAAS,GAAG,OAAO,CAAC,aAAa,CAAC,CAAC;IAC/C,MAAM,CAAC,IAAI,EAAE,UAAU,GAAG,OAAO,CAAC,aAAa,CAAC,CAAC;IACjD,6FAA6F;IAC7F,UAAU,CAAC,SAAS,CAAC,EAAE,YAAY,EAAE,GAAG,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,OAAO,CAAC,UAAU,CAAC,CAAC;IACxF,yEAAyE;IACzE,YAAY,CAAC,SAAS,EAAE,YAAY,GAAG,OAAO,CAAC,cAAc,EAAE,CAAC,CAAC;CAClE;AAED,qBAAa,yBAA0B,SAAQ,KAAK;aAEhC,MAAM,EAAE,MAAM;aACd,SAAS,EAAE,MAAM;gBADjB,MAAM,EAAE,MAAM,EACd,SAAS,EAAE,MAAM,EACjC,MAAM,EAAE,MAAM;CAIjB;AAED,qBAAa,iBAAkB,SAAQ,KAAK;aACd,MAAM,EAAE,MAAM;gBAAd,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM;CAG5D"}

package/dist/harness/interface.js

@@ -0,0 +1,17 @@
+export class UnsupportedOperationError extends Error {
+    vendor;
+    operation;
+    constructor(vendor, operation, reason) {
+        super(`[${vendor}] ${operation} unsupported: ${reason}`);
+        this.vendor = vendor;
+        this.operation = operation;
+    }
+}
+export class AuthRequiredError extends Error {
+    vendor;
+    constructor(vendor, message) {
+        super(`[${vendor}] Authentication required: ${message}`);
+        this.vendor = vendor;
+    }
+}
+//# sourceMappingURL=interface.js.map

package/dist/harness/interface.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"interface.js","sourceRoot":"","sources":["../../src/harness/interface.ts"],"names":[],"mappings":"AAkDA,MAAM,OAAO,yBAA0B,SAAQ,KAAK;IAEhC;IACA;IAFlB,YACkB,MAAc,EACd,SAAiB,EACjC,MAAc;QAEd,KAAK,CAAC,IAAI,MAAM,KAAK,SAAS,iBAAiB,MAAM,EAAE,CAAC,CAAC;QAJzC,WAAM,GAAN,MAAM,CAAQ;QACd,cAAS,GAAT,SAAS,CAAQ;IAInC,CAAC;CACF;AAED,MAAM,OAAO,iBAAkB,SAAQ,KAAK;IACd;IAA5B,YAA4B,MAAc,EAAE,OAAe;QACzD,KAAK,CAAC,IAAI,MAAM,8BAA8B,OAAO,EAAE,CAAC,CAAC;QAD/B,WAAM,GAAN,MAAM,CAAQ;IAE1C,CAAC;CACF"}

package/dist/harness/pushable.d.ts

@@ -0,0 +1,11 @@
+export declare class Pushable<T> implements AsyncIterable<T> {
+    private buffer;
+    private waiters;
+    private done;
+    push(value: T): void;
+    end(): void;
+    [Symbol.asyncIterator](): {
+        next: () => Promise<IteratorResult<T>>;
+    };
+}
+//# sourceMappingURL=pushable.d.ts.map

package/dist/harness/pushable.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"pushable.d.ts","sourceRoot":"","sources":["../../src/harness/pushable.ts"],"names":[],"mappings":"AAAA,qBAAa,QAAQ,CAAC,CAAC,CAAE,YAAW,aAAa,CAAC,CAAC,CAAC;IAClD,OAAO,CAAC,MAAM,CAAW;IACzB,OAAO,CAAC,OAAO,CAA6C;IAC5D,OAAO,CAAC,IAAI,CAAS;IAErB,IAAI,CAAC,KAAK,EAAE,CAAC,GAAG,IAAI;IASpB,GAAG,IAAI,IAAI;IAMX,CAAC,MAAM,CAAC,aAAa,CAAC;oBAER,OAAO,CAAC,cAAc,CAAC,CAAC,CAAC,CAAC;;CAQzC"}

package/dist/harness/pushable.js

@@ -0,0 +1,32 @@
+export class Pushable {
+    buffer = [];
+    waiters = [];
+    done = false;
+    push(value) {
+        if (this.done) {
+            throw new Error("Cannot push to a Pushable stream that has already ended.");
+        }
+        const w = this.waiters.shift();
+        if (w)
+            w({ value, done: false });
+        else
+            this.buffer.push(value);
+    }
+    end() {
+        if (this.done)
+            return;
+        this.done = true;
+        for (const w of this.waiters.splice(0))
+            w({ value: undefined, done: true });
+    }
+    [Symbol.asyncIterator]() {
+        return {
+            next: () => this.buffer.length > 0
+                ? Promise.resolve({ value: this.buffer.shift(), done: false })
+                : this.done
+                    ? Promise.resolve({ value: undefined, done: true })
+                    : new Promise((res) => this.waiters.push(res)),
+        };
+    }
+}
+//# sourceMappingURL=pushable.js.map

package/dist/harness/pushable.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"pushable.js","sourceRoot":"","sources":["../../src/harness/pushable.ts"],"names":[],"mappings":"AAAA,MAAM,OAAO,QAAQ;IACX,MAAM,GAAQ,EAAE,CAAC;IACjB,OAAO,GAA0C,EAAE,CAAC;IACpD,IAAI,GAAG,KAAK,CAAC;IAErB,IAAI,CAAC,KAAQ;QACX,IAAI,IAAI,CAAC,IAAI,EAAE,CAAC;YACd,MAAM,IAAI,KAAK,CAAC,0DAA0D,CAAC,CAAC;QAC9E,CAAC;QACD,MAAM,CAAC,GAAG,IAAI,CAAC,OAAO,CAAC,KAAK,EAAE,CAAC;QAC/B,IAAI,CAAC;YAAE,CAAC,CAAC,EAAE,KAAK,EAAE,IAAI,EAAE,KAAK,EAAE,CAAC,CAAC;;YAC5B,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IAC/B,CAAC;IAED,GAAG;QACD,IAAI,IAAI,CAAC,IAAI;YAAE,OAAO;QACtB,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC;QACjB,KAAK,MAAM,CAAC,IAAI,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC;YAAE,CAAC,CAAC,EAAE,KAAK,EAAE,SAAS,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC;IAC9E,CAAC;IAED,CAAC,MAAM,CAAC,aAAa,CAAC;QACpB,OAAO;YACL,IAAI,EAAE,GAA+B,EAAE,CACrC,IAAI,CAAC,MAAM,CAAC,MAAM,GAAG,CAAC;gBACpB,CAAC,CAAC,OAAO,CAAC,OAAO,CAAC,EAAE,KAAK,EAAE,IAAI,CAAC,MAAM,CAAC,KAAK,EAAG,EAAE,IAAI,EAAE,KAAK,EAAE,CAAC;gBAC/D,CAAC,CAAC,IAAI,CAAC,IAAI;oBACT,CAAC,CAAC,OAAO,CAAC,OAAO,CAAC,EAAE,KAAK,EAAE,SAAS,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC;oBACnD,CAAC,CAAC,IAAI,OAAO,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;SACrD,CAAC;IACJ,CAAC;CACF"}

package/dist/harness/types.d.ts

@@ -0,0 +1,126 @@
+/**
+ * Normalized harness contract for NexusFlow.
+ *
+ * RULES:
+ * - Nothing vendor-specific leaks past this boundary except through
+ *   `nativeOptions` (input) and `raw` events (output). Both are deliberate
+ *   escape hatches and must stay typed `unknown`/opaque forever.
+ * - Every event is fire-and-forget except `approval_required`, which expects
+ *   a matching `respondToApproval()` call.
+ */
+export type Vendor = "claude-code" | "codex";
+export type WorkspaceRef = {
+    workspaceId: string;
+    /** Absolute path to workspace root. May be a multi-repo root. */
+    rootPath: string;
+    /** Per-repo dirs Claude may additionally access. Ignored by Codex. */
+    additionalDirectories?: string[];
+};
+export type NormalizedUsage = {
+    inputTokens: number;
+    outputTokens: number;
+    /** cache reads + cache creation, summed */
+    cachedInputTokens?: number;
+    /** Client-side ESTIMATE of equivalent API cost. Never authoritative. Never use for chargeback. */
+    costUsdEstimate?: number;
+};
+/** Derived from auth method: plan-included sessions render tokens prominently and suppress or label dollar estimates. */
+export type BillingMode = "per-token" | "plan-included";
+export type ApprovalDecision = {
+    behavior: "allow";
+    updatedInput?: unknown;
+} | {
+    behavior: "deny";
+    message: string;
+};
+export type PermissionMode = "default" | "acceptEdits" | "bypassPermissions";
+/** Mirrors Claude's ResumeMode. Codex ignores `mode:"fork"` (see adapter). */
+export type ResumeMode = "resume" | "fork";
+export type StartSpec = {
+    prompt: string;
+    workspace: WorkspaceRef;
+    model?: string;
+    maxTurns?: number;
+    permissionMode?: PermissionMode;
+    /**
+     * Extra env vars for the child process.
+     * Callers MUST inject CLAUDE_CODE_PROJECT_DIR_NAME=<workspaceId> (+ CLAUDE_CONFIG_DIR)
+     * here for cross-host sessionStore keying (Phase 1 requirement).
+     * Note: Merged on top of process.env (spread-overrides); cannot unset host variables.
+     */
+    env?: Record<string, string>;
+    mcpServers?: Record<string, unknown>;
+    /**
+     * ESCAPE HATCH — vendor-native option bag, spread LAST so it overrides
+     * everything above. Never widen this type.
+     */
+    nativeOptions?: unknown;
+    /** Mirror every underlying vendor message/event as `raw`. Dev/debug only. */
+    debugMirrorRaw?: boolean;
+};
+export type ResumeSpec = Omit<StartSpec, "prompt"> & {
+    sessionId: string;
+    /** Omit to resume without a new user turn (e.g. orphan-sweep "resume?" action). */
+    prompt?: string;
+    /**
+     * "fork" = branch transcript, preserve original (audit-safe retries).
+     * NOTE: forks conversation history ONLY — file mutations stay shared.
+     * Pair with worktree/checkpointing for isolated exploration.
+     */
+    mode: ResumeMode;
+};
+export type SerializedError = {
+    message: string;
+    name?: string;
+    stack?: string;
+};
+export type AuthMethod = "api-key" | "subscription-oauth" | "chatgpt-signin" | "cloud-gateway" | "unauthenticated";
+export type AuthStatus = {
+    configured: boolean;
+    method?: AuthMethod;
+    email?: string;
+    hasApiKeyFallback?: boolean;
+    message?: string;
+};
+export type PatchKind = "write" | "edit" | "delete" | string;
+export type HarnessEvent = {
+    type: "session_started";
+    sessionId: string;
+} | {
+    type: "text_delta";
+    text: string;
+} | {
+    type: "assistant_message";
+    text: string;
+} | {
+    type: "tool_requested";
+    callId?: string;
+    tool: string;
+    input?: unknown;
+} | {
+    type: "tool_completed";
+    callId?: string;
+    ok: boolean;
+    outputSummary?: string;
+} | {
+    type: "file_changed";
+    kind: PatchKind;
+    paths: string[];
+} | {
+    type: "approval_required";
+    requestId: string;
+    tool: string;
+    input?: unknown;
+} | {
+    type: "turn_completed";
+    usage: NormalizedUsage;
+} | {
+    type: "turn_failed";
+    error: SerializedError;
+    fatal: boolean;
+} | {
+    type: "raw";
+    vendor: Vendor;
+    payload: unknown;
+};
+//# sourceMappingURL=types.d.ts.map

package/dist/harness/types.d.ts.map

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

package/dist/harness/types.js

@@ -0,0 +1,12 @@
+/**
+ * Normalized harness contract for NexusFlow.
+ *
+ * RULES:
+ * - Nothing vendor-specific leaks past this boundary except through
+ *   `nativeOptions` (input) and `raw` events (output). Both are deliberate
+ *   escape hatches and must stay typed `unknown`/opaque forever.
+ * - Every event is fire-and-forget except `approval_required`, which expects
+ *   a matching `respondToApproval()` call.
+ */
+export {};
+//# sourceMappingURL=types.js.map

package/dist/harness/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/harness/types.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG"}

package/dist/orchestration/runner.d.ts

@@ -107,7 +107,7 @@ export declare function stopServices(workspacePath: string): Promise<void>;
  */
 export declare function getServiceStatus(workspacePath: string): Promise<void>;
 /**
- * Tails log files for all services in a workspace.
+ * Tails log files for all services in a workspace, including nested services.
  *
  * @param workspacePath - Workspace root path.
  * @param logDir        - Directory containing log files.

package/dist/orchestration/runner.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"runner.d.ts","sourceRoot":"","sources":["../../src/orchestration/runner.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAQH,OAAO,KAAK,EAAE,aAAa,EAAE,cAAc,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAY/E,yEAAyE;AACzE,wBAAgB,aAAa,CAAC,aAAa,EAAE,MAAM,GAAG,MAAM,CAE3D;AAED,2FAA2F;AAC3F,wBAAgB,SAAS,CAAC,aAAa,EAAE,MAAM,GAAG,MAAM,CAGvD;AAED,8EAA8E;AAC9E,wBAAgB,UAAU,CAAC,aAAa,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,GAAG,MAAM,CAE7E;AAED;;;GAGG;AACH,wBAAgB,cAAc,CAAC,MAAM,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,GAAG,MAAM,CAE1E;AAED;;;;;;GAMG;AACH,wBAAsB,QAAQ,CAAC,IAAI,EAAE;IACnC,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,MAAM,EAAE,CAAC;IACf,GAAG,EAAE,MAAM,CAAC;IACZ,OAAO,EAAE,MAAM,CAAC;CACjB,GAAG,OAAO,CAAC,IAAI,CAAC,CAmBhB;AAED;;;;GAIG;AACH,wBAAgB,YAAY,CAAC,MAAM,EAAE,MAAM,GAAG,GAAG,EAAE,CAYlD;AAED;;;;GAIG;AACH,wBAAsB,UAAU,IAAI,OAAO,CAAC,GAAG,EAAE,CAAC,CAOjD;AAED;;;;;;;GAOG;AACH,wBAAsB,mBAAmB,CAAC,aAAa,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,GAAG,IAAI,CAAC,CAM7F;AAED;;;;;;;;;;GAUG;AACH,wBAAsB,gBAAgB,CAAC,aAAa,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,GAAG,EAAE,GAAG,OAAO,CAAC,YAAY,GAAG,IAAI,CAAC,CAoC3G;AAOD;;;;;GAKG;AACH,wBAAsB,kBAAkB,CACtC,aAAa,EAAE,MAAM,EACrB,OAAO,EAAE,CAAC,KAAK,EAAE,YAAY,KAAK,YAAY,GAC7C,OAAO,CAAC,IAAI,CAAC,CAsBf;AAID;;;;GAIG;AACH,wBAAsB,YAAY,CAChC,OAAO,EAAE,aAAa,EACtB,aAAa,EAAE,MAAM,EACrB,MAAM,EAAE,MAAM,GACb,OAAO,CAAC,cAAc,GAAG,IAAI,CAAC,CAgDhC;AAED;;;GAGG;AACH,wBAAsB,WAAW,CAAC,aAAa,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAgB9F;AAED;;;GAGG;AACH,wBAAsB,cAAc,CAClC,OAAO,EAAE,aAAa,EACtB,aAAa,EAAE,MAAM,EACrB,MAAM,EAAE,MAAM,GACb,OAAO,CAAC,cAAc,GAAG,IAAI,CAAC,CAEhC;AAED;;;;;;GAMG;AACH,wBAAsB,aAAa,CACjC,QAAQ,EAAE,aAAa,EAAE,EACzB,aAAa,EAAE,MAAM,EACrB,MAAM,EAAE,MAAM,GACb,OAAO,CAAC,IAAI,CAAC,CAKf;AAED;;;;;GAKG;AACH,wBAAsB,YAAY,CAAC,aAAa,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAqCvE;AAED;;;;GAIG;AACH,wBAAsB,gBAAgB,CAAC,aAAa,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CA2B3E;AAED;;;;;;GAMG;AACH,wBAAsB,QAAQ,CAC5B,aAAa,EAAE,MAAM,EACrB,MAAM,EAAE,MAAM,EACd,KAAK,GAAE,MAAW,GACjB,OAAO,CAAC,IAAI,CAAC,CAkCf"}
+{"version":3,"file":"runner.d.ts","sourceRoot":"","sources":["../../src/orchestration/runner.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAQH,OAAO,KAAK,EAAE,aAAa,EAAE,cAAc,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAY/E,yEAAyE;AACzE,wBAAgB,aAAa,CAAC,aAAa,EAAE,MAAM,GAAG,MAAM,CAE3D;AAED,2FAA2F;AAC3F,wBAAgB,SAAS,CAAC,aAAa,EAAE,MAAM,GAAG,MAAM,CAGvD;AAED,8EAA8E;AAC9E,wBAAgB,UAAU,CAAC,aAAa,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,GAAG,MAAM,CAE7E;AAED;;;GAGG;AACH,wBAAgB,cAAc,CAAC,MAAM,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,GAAG,MAAM,CAE1E;AAED;;;;;;GAMG;AACH,wBAAsB,QAAQ,CAAC,IAAI,EAAE;IACnC,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,MAAM,EAAE,CAAC;IACf,GAAG,EAAE,MAAM,CAAC;IACZ,OAAO,EAAE,MAAM,CAAC;CACjB,GAAG,OAAO,CAAC,IAAI,CAAC,CAmBhB;AAED;;;;GAIG;AACH,wBAAgB,YAAY,CAAC,MAAM,EAAE,MAAM,GAAG,GAAG,EAAE,CAYlD;AAED;;;;GAIG;AACH,wBAAsB,UAAU,IAAI,OAAO,CAAC,GAAG,EAAE,CAAC,CAOjD;AAED;;;;;;;GAOG;AACH,wBAAsB,mBAAmB,CAAC,aAAa,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,GAAG,IAAI,CAAC,CAM7F;AAED;;;;;;;;;;GAUG;AACH,wBAAsB,gBAAgB,CAAC,aAAa,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,GAAG,EAAE,GAAG,OAAO,CAAC,YAAY,GAAG,IAAI,CAAC,CAoC3G;AAOD;;;;;GAKG;AACH,wBAAsB,kBAAkB,CACtC,aAAa,EAAE,MAAM,EACrB,OAAO,EAAE,CAAC,KAAK,EAAE,YAAY,KAAK,YAAY,GAC7C,OAAO,CAAC,IAAI,CAAC,CAsBf;AAID;;;;GAIG;AACH,wBAAsB,YAAY,CAChC,OAAO,EAAE,aAAa,EACtB,aAAa,EAAE,MAAM,EACrB,MAAM,EAAE,MAAM,GACb,OAAO,CAAC,cAAc,GAAG,IAAI,CAAC,CAgDhC;AAED;;;GAGG;AACH,wBAAsB,WAAW,CAAC,aAAa,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAgB9F;AAED;;;GAGG;AACH,wBAAsB,cAAc,CAClC,OAAO,EAAE,aAAa,EACtB,aAAa,EAAE,MAAM,EACrB,MAAM,EAAE,MAAM,GACb,OAAO,CAAC,cAAc,GAAG,IAAI,CAAC,CAEhC;AAED;;;;;;GAMG;AACH,wBAAsB,aAAa,CACjC,QAAQ,EAAE,aAAa,EAAE,EACzB,aAAa,EAAE,MAAM,EACrB,MAAM,EAAE,MAAM,GACb,OAAO,CAAC,IAAI,CAAC,CAKf;AAED;;;;;GAKG;AACH,wBAAsB,YAAY,CAAC,aAAa,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAqCvE;AAED;;;;GAIG;AACH,wBAAsB,gBAAgB,CAAC,aAAa,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CA2B3E;AAwBD;;;;;;GAMG;AACH,wBAAsB,QAAQ,CAC5B,aAAa,EAAE,MAAM,EACrB,MAAM,EAAE,MAAM,EACd,KAAK,GAAE,MAAW,GACjB,OAAO,CAAC,IAAI,CAAC,CA0Bf"}

package/dist/orchestration/runner.js

@@ -342,30 +342,45 @@ export async function getServiceStatus(workspacePath) {
         console.error(chalk.red(`  ✖ Failed to query PM2 status: ${error.message}`));
     }
 }
+/** Recursively collects all .log file paths within a directory. */
+async function collectLogFiles(dir) {
+    const results = [];
+    try {
+        const entries = await fs.readdir(dir, { withFileTypes: true });
+        for (const entry of entries) {
+            const fullPath = path.join(dir, entry.name);
+            if (entry.isDirectory()) {
+                const subFiles = await collectLogFiles(fullPath);
+                results.push(...subFiles);
+            }
+            else if (entry.isFile() && entry.name.endsWith('.log')) {
+                results.push(fullPath);
+            }
+        }
+    }
+    catch (error) {
+        if (error?.code !== 'ENOENT') {
+            console.warn(chalk.yellow(`  Warning: could not read directory ${dir}: ${error?.message || error}`));
+        }
+    }
+    return results.sort((a, b) => a.localeCompare(b));
+}
 /**
- * Tails log files for all services in a workspace.
+ * Tails log files for all services in a workspace, including nested services.
  *
  * @param workspacePath - Workspace root path.
  * @param logDir        - Directory containing log files.
  * @param lines         - Number of lines to show per service.
  */
 export async function showLogs(workspacePath, logDir, lines = 20) {
-    let entries;
-    try {
-        entries = await fs.readdir(logDir);
-    }
-    catch {
-        console.log(chalk.yellow('  No log directory found.'));
-        return;
-    }
-    const logFiles = entries.filter((e) => e.endsWith('.log'));
+    const logFiles = await collectLogFiles(logDir);
     if (logFiles.length === 0) {
         console.log(chalk.yellow('  No log files found.'));
         return;
     }
-    for (const logFile of logFiles) {
-        const serviceName = logFile.replace('.log', '');
-        const filePath = path.join(logDir, logFile);
+    for (const filePath of logFiles) {
+        const rel = path.relative(logDir, filePath);
+        const serviceName = rel.replace(/\.log$/i, '').replace(/\\/g, '/');
         try {
             const content = await fs.readFile(filePath, 'utf-8');
             const allLines = content.split('\n');
@@ -379,7 +394,7 @@ export async function showLogs(workspacePath, logDir, lines = 20) {
             }
         }
         catch {
-            console.log(chalk.dim(`  Could not read ${logFile}`));
+            console.log(chalk.dim(`  Could not read ${rel}`));
         }
     }
 }