poly-weaver 0.2.5

package/dist/providers/registry.js

@@ -0,0 +1,49 @@
+import { ClaudeStrategy } from "./claude/index.js";
+import { CodexStrategy } from "./codex/index.js";
+import { CopilotStrategy } from "./copilot/index.js";
+let strategies;
+export function builtinStrategies() {
+    if (!strategies) {
+        const entries = [
+            ["claude", new ClaudeStrategy()],
+            ["codex", new CodexStrategy()],
+            ["copilot", new CopilotStrategy()],
+        ];
+        strategies = new Map(entries);
+    }
+    return strategies;
+}
+export function setProviderVersions(versions) {
+    const map = builtinStrategies();
+    for (const [name, version] of versions) {
+        const strategy = map.get(name);
+        if (strategy)
+            strategy.version = version;
+    }
+}
+/** Safe default: all gates off. */
+export const DEFAULT_GATES = { nativePlanMode: false };
+/**
+ * Derive feature gates from the resolved provider strategy.
+ * Returns DEFAULT_GATES for unknown providers (safe for mock/test drivers).
+ */
+export function computeFeatureGates(plannerName) {
+    try {
+        const strategy = resolveProvider(plannerName);
+        return {
+            nativePlanMode: !!strategy.planMode.nativePlanFile,
+        };
+    }
+    catch {
+        return DEFAULT_GATES;
+    }
+}
+export function resolveProvider(name) {
+    const map = builtinStrategies();
+    const strategy = map.get(name);
+    if (!strategy) {
+        throw new Error(`Unknown provider: "${name}". Available: ${[...map.keys()].join(", ")}`);
+    }
+    return strategy;
+}
+//# sourceMappingURL=registry.js.map

package/dist/providers/registry.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"registry.js","sourceRoot":"","sources":["../../src/providers/registry.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAC;AACnD,OAAO,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC;AACjD,OAAO,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAC;AAErD,IAAI,UAAyD,CAAC;AAE9D,MAAM,UAAU,iBAAiB;IAC/B,IAAI,CAAC,UAAU,EAAE,CAAC;QAChB,MAAM,OAAO,GAAqC;YAChD,CAAC,QAAQ,EAAE,IAAI,cAAc,EAAE,CAAC;YAChC,CAAC,OAAO,EAAE,IAAI,aAAa,EAAE,CAAC;YAC9B,CAAC,SAAS,EAAE,IAAI,eAAe,EAAE,CAAC;SACnC,CAAC;QACF,UAAU,GAAG,IAAI,GAAG,CAAC,OAAO,CAAC,CAAC;IAChC,CAAC;IACD,OAAO,UAAU,CAAC;AACpB,CAAC;AAED,MAAM,UAAU,mBAAmB,CAAC,QAA6B;IAC/D,MAAM,GAAG,GAAG,iBAAiB,EAAE,CAAC;IAChC,KAAK,MAAM,CAAC,IAAI,EAAE,OAAO,CAAC,IAAI,QAAQ,EAAE,CAAC;QACvC,MAAM,QAAQ,GAAG,GAAG,CAAC,GAAG,CAAC,IAAkB,CAAC,CAAC;QAC7C,IAAI,QAAQ;YAAE,QAAQ,CAAC,OAAO,GAAG,OAAO,CAAC;IAC3C,CAAC;AACH,CAAC;AAOD,mCAAmC;AACnC,MAAM,CAAC,MAAM,aAAa,GAAiB,EAAE,cAAc,EAAE,KAAK,EAAE,CAAC;AAErE;;;GAGG;AACH,MAAM,UAAU,mBAAmB,CAAC,WAAmB;IACrD,IAAI,CAAC;QACH,MAAM,QAAQ,GAAG,eAAe,CAAC,WAAW,CAAC,CAAC;QAC9C,OAAO;YACL,cAAc,EAAE,CAAC,CAAC,QAAQ,CAAC,QAAQ,CAAC,cAAc;SACnD,CAAC;IACJ,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,aAAa,CAAC;IACvB,CAAC;AACH,CAAC;AAED,MAAM,UAAU,eAAe,CAAC,IAAY;IAC1C,MAAM,GAAG,GAAG,iBAAiB,EAAE,CAAC;IAChC,MAAM,QAAQ,GAAG,GAAG,CAAC,GAAG,CAAC,IAAkB,CAAC,CAAC;IAC7C,IAAI,CAAC,QAAQ,EAAE,CAAC;QACd,MAAM,IAAI,KAAK,CACb,sBAAsB,IAAI,iBAAiB,CAAC,GAAG,GAAG,CAAC,IAAI,EAAE,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CACxE,CAAC;IACJ,CAAC;IACD,OAAO,QAAQ,CAAC;AAClB,CAAC"}

package/dist/providers/types.d.ts

@@ -0,0 +1,145 @@
+import type { UserClarification } from "../agents/planners/types.js";
+/**
+ * Provider-specific plan mode configuration.
+ * The PlannerAdapter reads this to apply plan mode correctly per provider.
+ */
+export type PlanModeConfig = {
+    /** Text prepended to the prompt content before passing to buildArgs(). */
+    promptPrefix?: string;
+    /** Text appended to the prompt content after the raw prompt. */
+    promptSuffix?: string;
+    /** Extra CLI permission flags (e.g., ["--permission-mode", "plan"]). */
+    permissionFlags?: string[];
+    /** Prefix for the CLI prompt argument in buildArgs() opts.promptPrefix. */
+    argPrefix?: string;
+    /** Tool/function name that signals plan mode exit (e.g., "ExitPlanMode"). */
+    exitToolName?: string;
+    /** When true, the provider writes plans to its own native location (e.g., ~/.claude/plans/). */
+    nativePlanFile?: boolean;
+};
+/**
+ * Opaque snapshot token for session file discovery.
+ * Internal structure varies by provider.
+ */
+export type SessionSnapshot = {
+    skipped: true;
+} | {
+    skipped: false;
+    dir: string;
+    files: Set<string>;
+};
+/** Options bag for {@link ProviderStrategy.buildArgs}. */
+export type BuildArgsOpts = {
+    resumeSessionId?: string;
+    sessionId?: string;
+    permissionFlags?: string[];
+    promptPrefix?: string;
+    yolo?: boolean;
+};
+/** Returns `[flag]` when `condition` is not `false`, else `[]`. */
+export declare function flagIf(condition: boolean | undefined, flag: string): string[];
+/**
+ * Provider-specific strategy for interacting with an AI CLI agent.
+ *
+ * Each provider (Claude Code, Codex CLI, etc.) implements this interface
+ * to encapsulate its CLI command format, session discovery mechanism,
+ * completion detection, and optional capability hooks.
+ *
+ * The AgentRunner uses a ProviderStrategy to execute the shared lifecycle
+ * (spawn → detect → exit) without knowing which CLI is being driven.
+ */
+/**
+ * Handles session file discovery and extraction for a provider.
+ *
+ * Session concerns (snapshot, file discovery, ID extraction, clarifications)
+ * are separated from CLI configuration concerns (command, args, exit signal).
+ * Implementations are stateless — a single instance is shared across runs.
+ */
+export interface SessionHandler {
+    /** Snapshot existing session files before PTY spawn. */
+    snapshot(workdir: string): Promise<SessionSnapshot>;
+    /** Find the new session file created by the PTY process. */
+    findSessionFile(snapshot: SessionSnapshot, workdir: string): Promise<string>;
+    /** Extract the canonical session ID from a session file path. */
+    extractSessionId(sessionFilePath: string): Promise<string>;
+    /**
+     * Optional hook: predict the exact session file path for a pre-assigned
+     * session ID. When implemented, the runner skips snapshot/discovery and
+     * waits for this specific file instead.
+     */
+    predictSessionFile?(workdir: string, sessionId: string): string;
+    /**
+     * Optional hook: extract clarifications from a session file.
+     *
+     * Providers that don't support clarification extraction leave this
+     * undefined. The adapter treats undefined as "no clarifications".
+     * Only Claude implements this (parses AskUserQuestion Q&A from JSONL).
+     */
+    extractClarifications?(sessionFilePath: string, lineOffset: number): Promise<UserClarification[]>;
+    /**
+     * Optional hook: extract the plan file path written by the provider.
+     *
+     * When the provider writes plans to its own native location (e.g., Claude
+     * >= 2.1.74 writes to ~/.claude/plans/), this extracts the actual path
+     * from the session file. Returns undefined if no plan file write was found.
+     */
+    extractPlanFilePath?(sessionFilePath: string, lineOffset: number): Promise<string | undefined>;
+}
+/**
+ * Provider-specific strategy for interacting with an AI CLI agent.
+ *
+ * Each provider (Claude Code, Codex CLI, etc.) implements this interface
+ * to encapsulate its CLI command format, completion detection, and session
+ * handling. Session concerns are delegated to a {@link SessionHandler}.
+ *
+ * The AgentRunner uses a ProviderStrategy to execute the shared lifecycle
+ * (spawn → detect → exit) without knowing which CLI is being driven.
+ */
+export interface ProviderStrategy {
+    /** Detected CLI version (set during preflight). Undefined until detection runs. */
+    version?: string;
+    /** Provider-specific plan mode configuration. */
+    readonly planMode: PlanModeConfig;
+    /** Provider name for logging/diagnostics (e.g., "claude", "codex"). */
+    readonly name: string;
+    /** Human-readable product name for UI display (e.g., "Claude Code"). */
+    readonly displayName: string;
+    /** The CLI command to invoke (e.g., "claude", "codex"). */
+    readonly command: string;
+    /** The exit signal to send to the PTY (e.g., "/exit\n", "\x03"). */
+    readonly exitSignal: string;
+    /** Session handler for file discovery and extraction. */
+    readonly session: SessionHandler;
+    /**
+     * Build CLI args from prompt text and options.
+     *
+     * Provider-specific: Claude passes prompt as positional arg with permission flags;
+     * Codex writes prompt to temp file and references it.
+     */
+    buildArgs(prompt: string, opts: BuildArgsOpts): Promise<string[]>;
+    /** Create a new CompletionDetector for this provider. */
+    createDetector(): CompletionDetector;
+}
+/**
+ * Watches a session file and PTY output to detect when an agent turn is complete.
+ *
+ * Each strategy (Claude, Codex) implements this interface with CLI-specific logic.
+ * The orchestrator calls start() when a PTY spawns, feeds PTY output via onPtyData(),
+ * and awaits the returned promise which resolves when the turn completes.
+ */
+export interface CompletionDetector {
+    /**
+     * Begin monitoring for completion.
+     * @param sessionFile Path to the JSONL session file to poll.
+     * @param lineOffset Number of JSONL lines to skip (for resume — ignores previous turn's data).
+     * @returns A promise that resolves with the extracted response text when the turn completes.
+     */
+    start(sessionFile: string, lineOffset?: number): Promise<string>;
+    /**
+     * Feed PTY output data for secondary signal analysis (quiet debounce, prompt detection).
+     */
+    onPtyData(data: string): void;
+    /** Stop monitoring and clean up timers/watchers. */
+    dispose(): void;
+}
+//# sourceMappingURL=types.d.ts.map

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

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

package/dist/providers/types.js

@@ -0,0 +1,5 @@
+/** Returns `[flag]` when `condition` is not `false`, else `[]`. */
+export function flagIf(condition, flag) {
+    return condition !== false ? [flag] : [];
+}
+//# sourceMappingURL=types.js.map

package/dist/providers/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/providers/types.ts"],"names":[],"mappings":"AAsCA,mEAAmE;AACnE,MAAM,UAAU,MAAM,CAAC,SAA8B,EAAE,IAAY;IACjE,OAAO,SAAS,KAAK,KAAK,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;AAC3C,CAAC"}

package/dist/providers/version.d.ts

@@ -0,0 +1,11 @@
+/**
+ * Extract the first semver-like version (X.Y.Z or X.Y) from raw CLI output.
+ * Handles formats like "claude v2.1.72", "codex/0.1.5", "2.1.72\n", etc.
+ * Returns undefined if no version pattern is found.
+ */
+export declare function parseVersion(raw: string): string | undefined;
+/** Compare two dot-separated numeric version strings. Returns -1, 0, or 1. */
+export declare function compareVersions(a: string, b: string): -1 | 0 | 1;
+/** Returns true if `version` satisfies `>= minVersion`. Both must be parsed version strings. */
+export declare function versionGte(version: string | undefined, minVersion: string): boolean;
+//# sourceMappingURL=version.d.ts.map

package/dist/providers/version.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"version.d.ts","sourceRoot":"","sources":["../../src/providers/version.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,wBAAgB,YAAY,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAG5D;AAED,8EAA8E;AAC9E,wBAAgB,eAAe,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,GAAG,CAAC,CAAC,GAAG,CAAC,GAAG,CAAC,CAWhE;AAED,gGAAgG;AAChG,wBAAgB,UAAU,CACxB,OAAO,EAAE,MAAM,GAAG,SAAS,EAC3B,UAAU,EAAE,MAAM,GACjB,OAAO,CAGT"}

package/dist/providers/version.js

@@ -0,0 +1,31 @@
+/**
+ * Extract the first semver-like version (X.Y.Z or X.Y) from raw CLI output.
+ * Handles formats like "claude v2.1.72", "codex/0.1.5", "2.1.72\n", etc.
+ * Returns undefined if no version pattern is found.
+ */
+export function parseVersion(raw) {
+    const match = raw.match(/(\d+\.\d+(?:\.\d+)*)/);
+    return match ? match[1] : undefined;
+}
+/** Compare two dot-separated numeric version strings. Returns -1, 0, or 1. */
+export function compareVersions(a, b) {
+    const aParts = a.split(".").map(Number);
+    const bParts = b.split(".").map(Number);
+    const len = Math.max(aParts.length, bParts.length);
+    for (let i = 0; i < len; i++) {
+        const av = aParts[i] ?? 0;
+        const bv = bParts[i] ?? 0;
+        if (av < bv)
+            return -1;
+        if (av > bv)
+            return 1;
+    }
+    return 0;
+}
+/** Returns true if `version` satisfies `>= minVersion`. Both must be parsed version strings. */
+export function versionGte(version, minVersion) {
+    if (version === undefined)
+        return false;
+    return compareVersions(version, minVersion) >= 0;
+}
+//# sourceMappingURL=version.js.map

package/dist/providers/version.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"version.js","sourceRoot":"","sources":["../../src/providers/version.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,MAAM,UAAU,YAAY,CAAC,GAAW;IACtC,MAAM,KAAK,GAAG,GAAG,CAAC,KAAK,CAAC,sBAAsB,CAAC,CAAC;IAChD,OAAO,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;AACtC,CAAC;AAED,8EAA8E;AAC9E,MAAM,UAAU,eAAe,CAAC,CAAS,EAAE,CAAS;IAClD,MAAM,MAAM,GAAG,CAAC,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;IACxC,MAAM,MAAM,GAAG,CAAC,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;IACxC,MAAM,GAAG,GAAG,IAAI,CAAC,GAAG,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,CAAC,CAAC;IACnD,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,GAAG,EAAE,CAAC,EAAE,EAAE,CAAC;QAC7B,MAAM,EAAE,GAAG,MAAM,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC;QAC1B,MAAM,EAAE,GAAG,MAAM,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC;QAC1B,IAAI,EAAE,GAAG,EAAE;YAAE,OAAO,CAAC,CAAC,CAAC;QACvB,IAAI,EAAE,GAAG,EAAE;YAAE,OAAO,CAAC,CAAC;IACxB,CAAC;IACD,OAAO,CAAC,CAAC;AACX,CAAC;AAED,gGAAgG;AAChG,MAAM,UAAU,UAAU,CACxB,OAA2B,EAC3B,UAAkB;IAElB,IAAI,OAAO,KAAK,SAAS;QAAE,OAAO,KAAK,CAAC;IACxC,OAAO,eAAe,CAAC,OAAO,EAAE,UAAU,CAAC,IAAI,CAAC,CAAC;AACnD,CAAC"}

package/dist/pty/exit.d.ts

@@ -0,0 +1,12 @@
+import type { PtyHandle } from "./types.js";
+/**
+ * Send an exit command to the PTY and wait for the process to exit.
+ *
+ * Falls back to SIGTERM if the exit command doesn't work within the timeout.
+ *
+ * @param handle The PTY handle
+ * @param exitCommand The CLI-specific exit command (e.g., "/exit\n" for Claude)
+ * @param timeoutMs Max time to wait for graceful exit (default: 5000ms)
+ */
+export declare function sendExit(handle: PtyHandle, exitCommand: string, timeoutMs?: number): Promise<number>;
+//# sourceMappingURL=exit.d.ts.map

package/dist/pty/exit.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"exit.d.ts","sourceRoot":"","sources":["../../src/pty/exit.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC;AAE5C;;;;;;;;GAQG;AACH,wBAAsB,QAAQ,CAC5B,MAAM,EAAE,SAAS,EACjB,WAAW,EAAE,MAAM,EACnB,SAAS,SAAO,GACf,OAAO,CAAC,MAAM,CAAC,CAmCjB"}

package/dist/pty/exit.js

@@ -0,0 +1,43 @@
+/**
+ * Send an exit command to the PTY and wait for the process to exit.
+ *
+ * Falls back to SIGTERM if the exit command doesn't work within the timeout.
+ *
+ * @param handle The PTY handle
+ * @param exitCommand The CLI-specific exit command (e.g., "/exit\n" for Claude)
+ * @param timeoutMs Max time to wait for graceful exit (default: 5000ms)
+ */
+export async function sendExit(handle, exitCommand, timeoutMs = 5000) {
+    handle.suppressOutput();
+    return new Promise((resolve) => {
+        let resolved = false;
+        let fallbackTimer;
+        const onExit = (code) => {
+            if (resolved)
+                return;
+            resolved = true;
+            if (fallbackTimer) {
+                clearTimeout(fallbackTimer);
+            }
+            // Clean up stdin listener
+            handle.kill();
+            resolve(code);
+        };
+        handle.onExit(onExit);
+        // The process may already have exited before onExit was registered.
+        if (resolved) {
+            return;
+        }
+        // Send the exit command
+        handle.write(exitCommand);
+        // Fallback: kill with SIGTERM if exit command doesn't work
+        fallbackTimer = setTimeout(() => {
+            if (resolved)
+                return;
+            resolved = true;
+            handle.kill("SIGTERM");
+            resolve(-1);
+        }, timeoutMs);
+    });
+}
+//# sourceMappingURL=exit.js.map

package/dist/pty/exit.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"exit.js","sourceRoot":"","sources":["../../src/pty/exit.ts"],"names":[],"mappings":"AAEA;;;;;;;;GAQG;AACH,MAAM,CAAC,KAAK,UAAU,QAAQ,CAC5B,MAAiB,EACjB,WAAmB,EACnB,SAAS,GAAG,IAAI;IAEhB,MAAM,CAAC,cAAc,EAAE,CAAC;IACxB,OAAO,IAAI,OAAO,CAAS,CAAC,OAAO,EAAE,EAAE;QACrC,IAAI,QAAQ,GAAG,KAAK,CAAC;QACrB,IAAI,aAAwD,CAAC;QAE7D,MAAM,MAAM,GAAG,CAAC,IAAY,EAAE,EAAE;YAC9B,IAAI,QAAQ;gBAAE,OAAO;YACrB,QAAQ,GAAG,IAAI,CAAC;YAChB,IAAI,aAAa,EAAE,CAAC;gBAClB,YAAY,CAAC,aAAa,CAAC,CAAC;YAC9B,CAAC;YACD,0BAA0B;YAC1B,MAAM,CAAC,IAAI,EAAE,CAAC;YACd,OAAO,CAAC,IAAI,CAAC,CAAC;QAChB,CAAC,CAAC;QAEF,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;QAEtB,oEAAoE;QACpE,IAAI,QAAQ,EAAE,CAAC;YACb,OAAO;QACT,CAAC;QAED,wBAAwB;QACxB,MAAM,CAAC,KAAK,CAAC,WAAW,CAAC,CAAC;QAE1B,2DAA2D;QAC3D,aAAa,GAAG,UAAU,CAAC,GAAG,EAAE;YAC9B,IAAI,QAAQ;gBAAE,OAAO;YACrB,QAAQ,GAAG,IAAI,CAAC;YAChB,MAAM,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;YACvB,OAAO,CAAC,CAAC,CAAC,CAAC,CAAC;QACd,CAAC,EAAE,SAAS,CAAC,CAAC;IAChB,CAAC,CAAC,CAAC;AACL,CAAC"}

package/dist/pty/spawn.d.ts

@@ -0,0 +1,20 @@
+import type { PtyHandle } from "./types.js";
+export declare function setReservedRows(n: number): void;
+export declare function getReservedRows(): number;
+export interface SpawnOptions {
+    command: string;
+    args: string[];
+    cwd: string;
+    env?: Record<string, string>;
+    cols?: number;
+    rows?: number;
+    interactive?: boolean;
+}
+/**
+ * Spawn a PTY process and return a PtyHandle.
+ *
+ * The PTY output is piped to process.stdout for TUI passthrough.
+ * Stdin is gated by default — user keystrokes are blocked until openGate() is called.
+ */
+export declare function spawnPty(opts: SpawnOptions): PtyHandle;
+//# sourceMappingURL=spawn.d.ts.map

package/dist/pty/spawn.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"spawn.d.ts","sourceRoot":"","sources":["../../src/pty/spawn.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC;AAG5C,wBAAgB,eAAe,CAAC,CAAC,EAAE,MAAM,GAAG,IAAI,CAAsB;AACtE,wBAAgB,eAAe,IAAI,MAAM,CAAyB;AAElE,MAAM,WAAW,YAAY;IAC3B,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,MAAM,EAAE,CAAC;IACf,GAAG,EAAE,MAAM,CAAC;IACZ,GAAG,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC7B,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,WAAW,CAAC,EAAE,OAAO,CAAC;CACvB;AAwCD;;;;;GAKG;AACH,wBAAgB,QAAQ,CAAC,IAAI,EAAE,YAAY,GAAG,SAAS,CAmItD"}

package/dist/pty/spawn.js

@@ -0,0 +1,163 @@
+import { execFileSync } from "node:child_process";
+import * as pty from "node-pty";
+let reservedRows = 0;
+export function setReservedRows(n) { reservedRows = n; }
+export function getReservedRows() { return reservedRows; }
+/**
+ * On Windows, node-pty's CreateProcess cannot launch .cmd/.bat shims or
+ * WinGet app execution aliases directly. Resolve the command to a real
+ * executable path, or fall back to `cmd.exe /c` for script shims.
+ */
+function resolveWindowsCommand(command, args) {
+    try {
+        const raw = execFileSync("where.exe", [command], {
+            encoding: "utf-8",
+            timeout: 5000,
+        }).trim();
+        const candidates = raw.split(/\r?\n/).map((l) => l.trim()).filter(Boolean);
+        // Prefer .exe — can be launched directly via CreateProcess.
+        const exe = candidates.find((c) => c.endsWith(".exe"));
+        if (exe) {
+            return { command: exe, args };
+        }
+        // .cmd/.bat need a cmd.exe wrapper.
+        const cmd = candidates.find((c) => c.endsWith(".cmd") || c.endsWith(".bat"));
+        if (cmd) {
+            return { command: "cmd.exe", args: ["/c", cmd, ...args] };
+        }
+        // Unknown type (e.g. extensionless npm shim) — wrap with cmd.exe.
+        return { command: "cmd.exe", args: ["/c", command, ...args] };
+    }
+    catch {
+        // `where` failed — wrap with cmd.exe as a last resort.
+        return { command: "cmd.exe", args: ["/c", command, ...args] };
+    }
+}
+/**
+ * Spawn a PTY process and return a PtyHandle.
+ *
+ * The PTY output is piped to process.stdout for TUI passthrough.
+ * Stdin is gated by default — user keystrokes are blocked until openGate() is called.
+ */
+export function spawnPty(opts) {
+    const resolved = process.platform === "win32"
+        ? resolveWindowsCommand(opts.command, opts.args)
+        : { command: opts.command, args: opts.args };
+    // Strip CLAUDECODE so the spawned process doesn't think it's nested.
+    const { CLAUDECODE: _, ...baseEnv } = process.env;
+    const proc = pty.spawn(resolved.command, resolved.args, {
+        name: "xterm-256color",
+        cols: opts.cols ?? process.stdout.columns ?? 120,
+        rows: opts.rows ?? Math.max((process.stdout.rows ?? 30) - reservedRows, 1),
+        cwd: opts.cwd,
+        env: { ...baseEnv, ...opts.env },
+        // ConPTY kill-path can emit noisy AttachConsole failures in some hosts.
+        // WinPTY is slower but more stable for our orchestrated test/runtime flows.
+        ...(process.platform === "win32" ? { useConpty: false } : {}),
+    });
+    const isInteractive = opts.interactive !== false;
+    let gateOpen = false;
+    let outputSuppressed = !isInteractive;
+    let exited = false;
+    let lastExitCode = null;
+    let cleanedUp = false;
+    const dataCallbacks = [];
+    const exitCallbacks = [];
+    // Stdin forwarding when gate is open
+    const stdinListener = (data) => {
+        if (gateOpen) {
+            proc.write(data.toString());
+        }
+    };
+    if (isInteractive) {
+        if (process.stdin.isTTY) {
+            process.stdin.setRawMode(true);
+        }
+        process.stdin.on("data", stdinListener);
+    }
+    const cleanupTerminalState = () => {
+        if (cleanedUp)
+            return;
+        cleanedUp = true;
+        // Stdin cleanup — only when interactive
+        if (isInteractive) {
+            process.stdin.removeListener("data", stdinListener);
+            if (process.stdin.isTTY) {
+                process.stdin.setRawMode(false);
+            }
+        }
+        // Terminal-mode cleanup — always run
+        process.stdout.write("\x1b[<99u"); // pop all kitty keyboard protocol levels
+        process.stdout.write("\x1b[?2004l"); // disable bracketed paste
+        process.stdout.write("\x1b[?1003l"); // disable any-event mouse tracking
+        process.stdout.write("\x1b[?1006l"); // disable SGR mouse mode
+    };
+    // Pipe PTY output to stdout (TUI passthrough)
+    proc.onData((data) => {
+        if (!outputSuppressed) {
+            process.stdout.write(data);
+        }
+        for (const cb of dataCallbacks) {
+            cb(data);
+        }
+    });
+    proc.onExit(({ exitCode }) => {
+        exited = true;
+        lastExitCode = exitCode;
+        cleanupTerminalState();
+        for (const cb of exitCallbacks) {
+            cb(exitCode);
+        }
+    });
+    const handle = {
+        get process() {
+            return proc;
+        },
+        write(data) {
+            proc.write(data);
+        },
+        onData(callback) {
+            dataCallbacks.push(callback);
+        },
+        onExit(callback) {
+            if (exited && lastExitCode !== null) {
+                callback(lastExitCode);
+                return;
+            }
+            exitCallbacks.push(callback);
+        },
+        kill(signal) {
+            cleanupTerminalState();
+            if (exited) {
+                return;
+            }
+            // node-pty on Windows does not support signals — call kill() without args.
+            if (process.platform === "win32") {
+                proc.kill();
+            }
+            else {
+                proc.kill(signal);
+            }
+        },
+        openGate() {
+            gateOpen = true;
+        },
+        closeGate() {
+            gateOpen = false;
+        },
+        get gateOpen() {
+            return gateOpen;
+        },
+        suppressOutput() {
+            outputSuppressed = true;
+        },
+        resumeOutput() {
+            outputSuppressed = false;
+        },
+        get pid() {
+            return proc.pid;
+        },
+    };
+    return handle;
+}
+//# sourceMappingURL=spawn.js.map

package/dist/pty/spawn.js.map

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

package/dist/pty/types.d.ts

@@ -0,0 +1,44 @@
+import type { IPty } from "node-pty";
+export type AgentEvent = {
+    type: "text";
+    text: string;
+} | {
+    type: "tool_call";
+    name: string;
+    input: unknown;
+} | {
+    type: "tool_result";
+    id: string;
+    output: string;
+} | {
+    type: "done";
+    result: string;
+} | {
+    type: "error";
+    message: string;
+};
+export interface PtyHandle {
+    /** The underlying node-pty process. */
+    readonly process: IPty;
+    /** Write data to the PTY (bypasses stdin gate). */
+    write(data: string): void;
+    /** Subscribe to PTY output data. */
+    onData(callback: (data: string) => void): void;
+    /** Subscribe to PTY exit. */
+    onExit(callback: (exitCode: number) => void): void;
+    /** Kill the PTY process. */
+    kill(signal?: string): void;
+    /** Open the stdin gate — user keystrokes flow to PTY. */
+    openGate(): void;
+    /** Close the stdin gate — user keystrokes are blocked. */
+    closeGate(): void;
+    /** Whether the stdin gate is currently open. */
+    readonly gateOpen: boolean;
+    /** Suppress PTY output from being written to stdout. */
+    suppressOutput(): void;
+    /** Resume writing PTY output to stdout. */
+    resumeOutput(): void;
+    /** PID of the spawned process. */
+    readonly pid: number;
+}
+//# sourceMappingURL=types.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/pty/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,UAAU,CAAC;AAErC,MAAM,MAAM,UAAU,GAClB;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,GAC9B;IAAE,IAAI,EAAE,WAAW,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,OAAO,CAAA;CAAE,GACnD;IAAE,IAAI,EAAE,aAAa,CAAC;IAAC,EAAE,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,GACnD;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,GAChC;IAAE,IAAI,EAAE,OAAO,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,CAAC;AAEvC,MAAM,WAAW,SAAS;IACxB,uCAAuC;IACvC,QAAQ,CAAC,OAAO,EAAE,IAAI,CAAC;IACvB,mDAAmD;IACnD,KAAK,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1B,oCAAoC;IACpC,MAAM,CAAC,QAAQ,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,GAAG,IAAI,CAAC;IAC/C,6BAA6B;IAC7B,MAAM,CAAC,QAAQ,EAAE,CAAC,QAAQ,EAAE,MAAM,KAAK,IAAI,GAAG,IAAI,CAAC;IACnD,4BAA4B;IAC5B,IAAI,CAAC,MAAM,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC5B,yDAAyD;IACzD,QAAQ,IAAI,IAAI,CAAC;IACjB,0DAA0D;IAC1D,SAAS,IAAI,IAAI,CAAC;IAClB,gDAAgD;IAChD,QAAQ,CAAC,QAAQ,EAAE,OAAO,CAAC;IAC3B,wDAAwD;IACxD,cAAc,IAAI,IAAI,CAAC;IACvB,2CAA2C;IAC3C,YAAY,IAAI,IAAI,CAAC;IACrB,kCAAkC;IAClC,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;CACtB"}

package/dist/pty/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/dist/pty/types.js.map

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

package/dist/session/dir.d.ts

@@ -0,0 +1,19 @@
+/**
+ * Sanitize a workdir path for use as a directory name.
+ * Lowercases and replaces every non-alphanumeric character with `-`.
+ */
+export declare function sanitizeWorkdir(workdir: string): string;
+/**
+ * Create a session temp directory.
+ * Directory: {os.tmpdir()}/poly-weaver/{sanitized-workdir}/{uuid}/
+ * Returns the root path as a string.
+ */
+export declare function createSessionDir(workdir: string): Promise<string>;
+/**
+ * Clean up the session temp directory.
+ * If opts.preserve is true, the directory is kept (for --verbose debugging).
+ */
+export declare function cleanupSessionDir(root: string, opts?: {
+    preserve?: boolean;
+}): Promise<void>;
+//# sourceMappingURL=dir.d.ts.map

package/dist/session/dir.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"dir.d.ts","sourceRoot":"","sources":["../../src/session/dir.ts"],"names":[],"mappings":"AAKA;;;GAGG;AACH,wBAAgB,eAAe,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAEvD;AAED;;;;GAIG;AACH,wBAAsB,gBAAgB,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAIvE;AAED;;;GAGG;AACH,wBAAsB,iBAAiB,CACrC,IAAI,EAAE,MAAM,EACZ,IAAI,CAAC,EAAE;IAAE,QAAQ,CAAC,EAAE,OAAO,CAAA;CAAE,GAC5B,OAAO,CAAC,IAAI,CAAC,CAGf"}

package/dist/session/dir.js

@@ -0,0 +1,31 @@
+import { mkdir, rm } from "node:fs/promises";
+import { tmpdir } from "node:os";
+import { join } from "node:path";
+import { v4 as uuidv4 } from "uuid";
+/**
+ * Sanitize a workdir path for use as a directory name.
+ * Lowercases and replaces every non-alphanumeric character with `-`.
+ */
+export function sanitizeWorkdir(workdir) {
+    return workdir.toLowerCase().replace(/[^a-z0-9]/g, "-");
+}
+/**
+ * Create a session temp directory.
+ * Directory: {os.tmpdir()}/poly-weaver/{sanitized-workdir}/{uuid}/
+ * Returns the root path as a string.
+ */
+export async function createSessionDir(workdir) {
+    const root = join(tmpdir(), "poly-weaver", sanitizeWorkdir(workdir), uuidv4());
+    await mkdir(root, { recursive: true });
+    return root;
+}
+/**
+ * Clean up the session temp directory.
+ * If opts.preserve is true, the directory is kept (for --verbose debugging).
+ */
+export async function cleanupSessionDir(root, opts) {
+    if (opts?.preserve)
+        return;
+    await rm(root, { recursive: true, force: true });
+}
+//# sourceMappingURL=dir.js.map

package/dist/session/dir.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"dir.js","sourceRoot":"","sources":["../../src/session/dir.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,EAAE,EAAE,MAAM,kBAAkB,CAAC;AAC7C,OAAO,EAAE,MAAM,EAAE,MAAM,SAAS,CAAC;AACjC,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AACjC,OAAO,EAAE,EAAE,IAAI,MAAM,EAAE,MAAM,MAAM,CAAC;AAEpC;;;GAGG;AACH,MAAM,UAAU,eAAe,CAAC,OAAe;IAC7C,OAAO,OAAO,CAAC,WAAW,EAAE,CAAC,OAAO,CAAC,YAAY,EAAE,GAAG,CAAC,CAAC;AAC1D,CAAC;AAED;;;;GAIG;AACH,MAAM,CAAC,KAAK,UAAU,gBAAgB,CAAC,OAAe;IACpD,MAAM,IAAI,GAAG,IAAI,CAAC,MAAM,EAAE,EAAE,aAAa,EAAE,eAAe,CAAC,OAAO,CAAC,EAAE,MAAM,EAAE,CAAC,CAAC;IAC/E,MAAM,KAAK,CAAC,IAAI,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IACvC,OAAO,IAAI,CAAC;AACd,CAAC;AAED;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,iBAAiB,CACrC,IAAY,EACZ,IAA6B;IAE7B,IAAI,IAAI,EAAE,QAAQ;QAAE,OAAO;IAC3B,MAAM,EAAE,CAAC,IAAI,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC;AACnD,CAAC"}