@a5c-ai/genty-platform 5.1.1-staging.00ceebd28cf2

package/dist/harness/types.d.ts

@@ -0,0 +1,278 @@
+/**
+ * Harness adapter interface.
+ *
+ * A "harness" is the host tool that invokes the babysitter SDK (e.g. Claude Code,
+ * Cursor, Windsurf). Each harness has its own session lifecycle, env vars, and
+ * hook input/output formats. The adapter interface abstracts these differences
+ * so the SDK core remains harness-agnostic.
+ */
+import type { AskUserQuestionUiContext } from "../interaction";
+import type { PromptContext } from "@a5c-ai/babysitter-sdk";
+/** Capabilities that a harness adapter may support. */
+export declare enum HarnessCapability {
+    /** Harness supports programmatic (non-interactive) invocation. */
+    Programmatic = "programmatic",
+    /** Harness can bind a babysitter run to a host session. */
+    SessionBinding = "session-binding",
+    /** Harness implements the stop-hook lifecycle event. */
+    StopHook = "stop-hook",
+    /** Harness exposes an MCP (Model Context Protocol) server. */
+    Mcp = "mcp",
+    /** Harness can accept a prompt without a TTY (headless mode). */
+    HeadlessPrompt = "headless-prompt",
+    /** Harness supports concurrent effect execution (GAP-PAR-001). */
+    ConcurrentEffects = "concurrent-effects",
+    /** Harness supports async/background effects (GAP-PAR-002). */
+    BackgroundEffects = "background-effects",
+    /** Harness supports multi-harness parallel dispatch (GAP-PAR-003). */
+    MultiHarnessDispatch = "multi-harness-dispatch"
+}
+/**
+ * Result of probing the local environment for a specific harness CLI.
+ *
+ * This is the **installed-discovery** result — it answers "is this CLI on
+ * PATH?" and "does config exist?".  It does NOT report whether we are
+ * currently running inside this harness; use `CallerHarnessResult` /
+ * `detectCallerHarness()` for that.
+ */
+export interface HarnessDiscoveryResult {
+    /** Harness identifier (matches HarnessAdapter.name). */
+    name: string;
+    /** Whether the CLI binary was found on the system. */
+    installed: boolean;
+    /** Semantic version reported by the CLI, if obtainable. */
+    version?: string;
+    /** Absolute path to the CLI binary, if resolved. */
+    cliPath?: string;
+    /** Shell command used to invoke the CLI. */
+    cliCommand: string;
+    /** Whether harness-specific configuration was found on disk. */
+    configFound: boolean;
+    /** Capabilities advertised by this harness. */
+    capabilities: HarnessCapability[];
+    /** Platform identifier (e.g. "win32", "linux", "darwin"). */
+    platform: string;
+}
+/** Result of detecting which harness spawned the current process, if any. */
+export interface CallerHarnessResult {
+    /** Harness identifier (matches HarnessAdapter.name). */
+    name: string;
+    /** Environment variable names that matched the active caller. */
+    matchedEnvVars: string[];
+    /** Capabilities advertised by the detected caller harness. */
+    capabilities: HarnessCapability[];
+}
+/** Callback invoked with each raw chunk from stdout or stderr. */
+export type StreamingOutputCallback = (chunk: string) => void;
+/** Callback invoked with each complete line and its source stream. */
+export type StreamingLineCallback = (line: string, source: "stdout" | "stderr") => void;
+/** Options for real-time streaming output capture from harness invocations. */
+export interface StreamingOutputOptions {
+    /** Called with each stdout chunk as it arrives. */
+    onStdout?: StreamingOutputCallback;
+    /** Called with each stderr chunk as it arrives. */
+    onStderr?: StreamingOutputCallback;
+    /** Called with each complete line (from either stream) as it becomes available. */
+    onLine?: StreamingLineCallback;
+}
+/** Options for programmatically invoking a harness CLI. */
+export interface HarnessInvokeOptions {
+    /** The prompt to send to the harness. */
+    prompt: string;
+    /** Working directory for the invocation. */
+    workspace?: string;
+    /** Model override (harness-specific). */
+    model?: string;
+    /** Maximum execution time in milliseconds. */
+    timeout?: number;
+    /** Whether to use RPC/structured-output mode. */
+    rpc?: boolean;
+    /** Additional environment variables passed to the child process. */
+    env?: Record<string, string>;
+    /** Real-time streaming output callbacks (GAP-SUBOBS-001). */
+    streaming?: StreamingOutputOptions;
+    /** AbortSignal to cancel the invocation and kill the child process. */
+    signal?: AbortSignal;
+    /** When true, run the child process with a minimal environment (only PATH, HOME, NODE_PATH + explicit env overrides). */
+    isolated?: boolean;
+}
+/** Result returned after a harness CLI invocation completes. */
+export interface HarnessInvokeResult {
+    /** Whether the invocation completed without error. */
+    success: boolean;
+    /** Combined stdout/stderr output from the CLI. */
+    output: string;
+    /** Process exit code. */
+    exitCode: number;
+    /** Wall-clock duration of the invocation in milliseconds. */
+    duration: number;
+    /** Name of the harness that was invoked. */
+    harness: string;
+    /** GAP-PERF-004: Whether output was streamed in real-time. */
+    streamed?: boolean;
+    /** GAP-PERF-004: Number of streaming chunks emitted. */
+    streamChunkCount?: number;
+}
+/** Options for creating a Pi harness session (programmatic API). */
+export interface AgentCoreSessionOptions {
+    /** Working directory for the session. */
+    workspace?: string;
+    /** Model identifier string (e.g. "claude-opus-4-5"). */
+    model?: string;
+    /** Maximum time in ms to wait for a single prompt to complete. */
+    timeout?: number;
+    /** Thinking level for the model. */
+    thinkingLevel?: "minimal" | "low" | "medium" | "high" | "xhigh";
+    /** Built-in tool mode to expose to the model. */
+    toolsMode?: "default" | "coding" | "readonly";
+    /** Custom tool definitions to register with the session. */
+    customTools?: unknown[];
+    /** Optional extension-style UI context exposed to custom tools inside the PI loop. */
+    uiContext?: AskUserQuestionUiContext;
+    /** Replace the discovered system prompt with a custom one. */
+    systemPrompt?: string;
+    /** Append custom system prompt instructions. */
+    appendSystemPrompt?: string[];
+    /** Isolate the session from discovered extensions, skills, and AGENTS files. */
+    isolated?: boolean;
+    /** Use an in-memory session manager instead of persistent session files. */
+    ephemeral?: boolean;
+    /** Bash tool execution backend. Defaults to native/local PI execution; "secure" opts into the sandbox backend and "auto" falls back to local. */
+    bashSandbox?: "auto" | "secure" | "local";
+    /** Whether PI session compaction should be enabled for this session. */
+    enableCompaction?: boolean;
+    /** Global pi agent config directory (default: ~/.pi/agent). */
+    agentDir?: string;
+    /** Minimum delay before retrying PI session initialization after a failure. */
+    initFailureBackoffMs?: number;
+}
+/**
+ * Event emitted by a Pi session during prompt execution.
+ * Mirrors the AgentSessionEvent union from `@earendil-works/pi-coding-agent`.
+ */
+export interface AgentCoreSessionEvent {
+    type: string;
+    [key: string]: unknown;
+}
+/** Result of sending a prompt through a Pi session. */
+export interface AgentCorePromptResult {
+    /** Collected text output from the agent response. */
+    output: string;
+    /** Wall-clock duration in milliseconds. */
+    duration: number;
+    /** Whether the prompt completed without error. */
+    success: boolean;
+    /** Exit code (0 = success, 1 = failure). */
+    exitCode: number;
+    /** Provider-reported token usage, when available. */
+    usage?: {
+        inputTokens: number;
+        outputTokens: number;
+        totalTokens: number;
+        provider?: string;
+        model?: string;
+    };
+}
+export interface SessionBindOptions {
+    sessionId: string;
+    runId: string;
+    runDir: string;
+    pluginRoot?: string;
+    stateDir?: string;
+    runsDir?: string;
+    maxIterations?: number;
+    prompt: string;
+    verbose: boolean;
+    json: boolean;
+}
+export interface SessionBindResult {
+    harness: string;
+    sessionId: string;
+    stateFile?: string;
+    error?: string;
+    /** When true, the error is fatal and run:create should exit non-zero. */
+    fatal?: boolean;
+}
+export interface HookHandlerArgs {
+    pluginRoot?: string;
+    stateDir?: string;
+    runsDir?: string;
+    json: boolean;
+    verbose?: boolean;
+}
+export interface HarnessInstallOptions {
+    workspace?: string;
+    json: boolean;
+    dryRun: boolean;
+    verbose: boolean;
+}
+export interface HarnessInstallResult {
+    harness: string;
+    dryRun?: boolean;
+    warning?: string;
+    summary?: string;
+    command?: string;
+    output?: string;
+    location?: string;
+}
+export interface HarnessAdapter {
+    /** Harness identifier (e.g. "claude-code") */
+    readonly name: string;
+    /** Does this harness appear to be active? (env var detection) */
+    isActive(): boolean;
+    /** Resolve session ID from CLI args / env vars / env file */
+    resolveSessionId(parsed: {
+        sessionId?: string;
+    }): string | undefined;
+    /** Resolve state directory from args / env */
+    resolveStateDir(args: {
+        stateDir?: string;
+        pluginRoot?: string;
+    }): string | undefined;
+    /** Resolve plugin root from args / env */
+    resolvePluginRoot(args: {
+        pluginRoot?: string;
+    }): string | undefined;
+    /**
+     * Whether this adapter auto-resolves session IDs from environment variables
+     * or other ambient sources.  When true, explicitly passing `--session-id`
+     * is rejected as a conflict.  Defaults to `false` when not implemented.
+     */
+    autoResolvesSessionId?(): boolean;
+    /** Guidance shown when a harness-specific session ID is required but missing. */
+    getMissingSessionIdHint?(): string;
+    /** Whether this harness truthfully supports a given SDK hook entrypoint. */
+    supportsHookType?(hookType: string): boolean;
+    /** Message shown when a hook type is requested but unsupported by the harness. */
+    getUnsupportedHookMessage?(hookType: string): string;
+    /** Bind a run to the caller's session (run:create flow) */
+    bindSession(opts: SessionBindOptions): Promise<SessionBindResult>;
+    /** Handle the stop hook (decision: approve/block) */
+    handleStopHook(args: HookHandlerArgs): Promise<number>;
+    /** Handle the session-start hook (env file + state file setup) */
+    handleSessionStartHook(args: HookHandlerArgs): Promise<number>;
+    /** Find hook dispatcher path (for shell hook execution) */
+    findHookDispatcherPath(startCwd: string): string | null;
+    /** Check whether the harness CLI binary is installed and reachable. */
+    isCliInstalled?(): Promise<boolean>;
+    /** Return CLI metadata (command name, version, resolved path). */
+    getCliInfo?(): Promise<{
+        command: string;
+        version?: string;
+        path?: string;
+    }>;
+    /** List capabilities supported by this harness adapter. */
+    getCapabilities?(): HarnessCapability[];
+    /** Install the harness CLI itself. */
+    installHarness?(options: HarnessInstallOptions): Promise<HarnessInstallResult>;
+    /** Install or materialize the Babysitter plugin/extension integration for this harness. */
+    installPlugin?(options: HarnessInstallOptions): Promise<HarnessInstallResult>;
+    /**
+     * Return a PromptContext pre-configured for this harness.
+     * Centralizes harness-specific prompt configuration in the adapter itself.
+     */
+    getPromptContext?(opts?: {
+        interactive?: boolean | undefined;
+    }): PromptContext;
+}
+//# 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,34 @@
+"use strict";
+/**
+ * Harness adapter interface.
+ *
+ * A "harness" is the host tool that invokes the babysitter SDK (e.g. Claude Code,
+ * Cursor, Windsurf). Each harness has its own session lifecycle, env vars, and
+ * hook input/output formats. The adapter interface abstracts these differences
+ * so the SDK core remains harness-agnostic.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.HarnessCapability = void 0;
+// ---------------------------------------------------------------------------
+// Harness capability enum
+// ---------------------------------------------------------------------------
+/** Capabilities that a harness adapter may support. */
+var HarnessCapability;
+(function (HarnessCapability) {
+    /** Harness supports programmatic (non-interactive) invocation. */
+    HarnessCapability["Programmatic"] = "programmatic";
+    /** Harness can bind a babysitter run to a host session. */
+    HarnessCapability["SessionBinding"] = "session-binding";
+    /** Harness implements the stop-hook lifecycle event. */
+    HarnessCapability["StopHook"] = "stop-hook";
+    /** Harness exposes an MCP (Model Context Protocol) server. */
+    HarnessCapability["Mcp"] = "mcp";
+    /** Harness can accept a prompt without a TTY (headless mode). */
+    HarnessCapability["HeadlessPrompt"] = "headless-prompt";
+    /** Harness supports concurrent effect execution (GAP-PAR-001). */
+    HarnessCapability["ConcurrentEffects"] = "concurrent-effects";
+    /** Harness supports async/background effects (GAP-PAR-002). */
+    HarnessCapability["BackgroundEffects"] = "background-effects";
+    /** Harness supports multi-harness parallel dispatch (GAP-PAR-003). */
+    HarnessCapability["MultiHarnessDispatch"] = "multi-harness-dispatch";
+})(HarnessCapability || (exports.HarnessCapability = HarnessCapability = {}));

package/dist/harness/websocketSession.d.ts

@@ -0,0 +1,63 @@
+/**
+ * Remote sessions via WebSocket (GAP-REMOTE-003).
+ *
+ * Provides a WebSocket session abstraction with auto-reconnect,
+ * exponential backoff, and typed message handling.
+ */
+export interface WebSocketSessionConfig {
+    url: string;
+    /** Base reconnect interval in ms. Default: 1000. */
+    reconnectIntervalMs?: number;
+    /** Max reconnect attempts before giving up. Default: 10. */
+    maxReconnects?: number;
+    /** Optional auth token sent in the initial handshake. */
+    authToken?: string;
+}
+export type WsMessageType = 'prompt' | 'response' | 'event' | 'error';
+export interface WsMessage {
+    type: WsMessageType;
+    payload: unknown;
+    timestamp: number;
+}
+export type WsMessageCallback = (message: WsMessage) => void;
+/**
+ * Minimal WebSocket-like interface for dependency injection / testing.
+ */
+export interface WebSocketLike {
+    readyState: number;
+    send(data: string): void;
+    close(): void;
+    onopen: ((ev: unknown) => void) | null;
+    onclose: ((ev: unknown) => void) | null;
+    onmessage: ((ev: {
+        data: string;
+    }) => void) | null;
+    onerror: ((ev: unknown) => void) | null;
+}
+export type WebSocketFactory = (url: string, protocols?: string[]) => WebSocketLike;
+export declare class WebSocketSession {
+    private ws;
+    private listeners;
+    private reconnectCount;
+    private reconnectTimer;
+    private intentionalClose;
+    private readonly url;
+    private readonly reconnectIntervalMs;
+    private readonly maxReconnects;
+    private readonly authToken;
+    private readonly wsFactory;
+    constructor(config: WebSocketSessionConfig, wsFactory: WebSocketFactory);
+    /** Open a WebSocket connection. */
+    connect(): void;
+    /** Gracefully close the connection (no auto-reconnect). */
+    disconnect(): void;
+    /** Send a typed message over the WebSocket. */
+    send(message: WsMessage): void;
+    /** Register a callback for incoming messages. */
+    onMessage(callback: WsMessageCallback): void;
+    /** Whether the underlying WebSocket is currently open. */
+    isConnected(): boolean;
+    private doConnect;
+    private scheduleReconnect;
+}
+//# sourceMappingURL=websocketSession.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"websocketSession.d.ts","sourceRoot":"","sources":["../../src/harness/websocketSession.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAMH,MAAM,WAAW,sBAAsB;IACrC,GAAG,EAAE,MAAM,CAAC;IACZ,oDAAoD;IACpD,mBAAmB,CAAC,EAAE,MAAM,CAAC;IAC7B,4DAA4D;IAC5D,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,yDAAyD;IACzD,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,MAAM,aAAa,GAAG,QAAQ,GAAG,UAAU,GAAG,OAAO,GAAG,OAAO,CAAC;AAEtE,MAAM,WAAW,SAAS;IACxB,IAAI,EAAE,aAAa,CAAC;IACpB,OAAO,EAAE,OAAO,CAAC;IACjB,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,MAAM,iBAAiB,GAAG,CAAC,OAAO,EAAE,SAAS,KAAK,IAAI,CAAC;AAE7D;;GAEG;AACH,MAAM,WAAW,aAAa;IAC5B,UAAU,EAAE,MAAM,CAAC;IACnB,IAAI,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,KAAK,IAAI,IAAI,CAAC;IACd,MAAM,EAAE,CAAC,CAAC,EAAE,EAAE,OAAO,KAAK,IAAI,CAAC,GAAG,IAAI,CAAC;IACvC,OAAO,EAAE,CAAC,CAAC,EAAE,EAAE,OAAO,KAAK,IAAI,CAAC,GAAG,IAAI,CAAC;IACxC,SAAS,EAAE,CAAC,CAAC,EAAE,EAAE;QAAE,IAAI,EAAE,MAAM,CAAA;KAAE,KAAK,IAAI,CAAC,GAAG,IAAI,CAAC;IACnD,OAAO,EAAE,CAAC,CAAC,EAAE,EAAE,OAAO,KAAK,IAAI,CAAC,GAAG,IAAI,CAAC;CACzC;AAED,MAAM,MAAM,gBAAgB,GAAG,CAAC,GAAG,EAAE,MAAM,EAAE,SAAS,CAAC,EAAE,MAAM,EAAE,KAAK,aAAa,CAAC;AAYpF,qBAAa,gBAAgB;IAC3B,OAAO,CAAC,EAAE,CAA8B;IACxC,OAAO,CAAC,SAAS,CAA2B;IAC5C,OAAO,CAAC,cAAc,CAAK;IAC3B,OAAO,CAAC,cAAc,CAA8C;IACpE,OAAO,CAAC,gBAAgB,CAAS;IAEjC,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAS;IAC7B,OAAO,CAAC,QAAQ,CAAC,mBAAmB,CAAS;IAC7C,OAAO,CAAC,QAAQ,CAAC,aAAa,CAAS;IACvC,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAqB;IAC/C,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAmB;gBAEjC,MAAM,EAAE,sBAAsB,EAAE,SAAS,EAAE,gBAAgB;IAYvE,mCAAmC;IACnC,OAAO,IAAI,IAAI;IAMf,2DAA2D;IAC3D,UAAU,IAAI,IAAI;IAYlB,+CAA+C;IAC/C,IAAI,CAAC,OAAO,EAAE,SAAS,GAAG,IAAI;IAO9B,iDAAiD;IACjD,SAAS,CAAC,QAAQ,EAAE,iBAAiB,GAAG,IAAI;IAI5C,0DAA0D;IAC1D,WAAW,IAAI,OAAO;IAQtB,OAAO,CAAC,SAAS;IAgCjB,OAAO,CAAC,iBAAiB;CAU1B"}

package/dist/harness/websocketSession.js

@@ -0,0 +1,113 @@
+"use strict";
+/**
+ * Remote sessions via WebSocket (GAP-REMOTE-003).
+ *
+ * Provides a WebSocket session abstraction with auto-reconnect,
+ * exponential backoff, and typed message handling.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.WebSocketSession = void 0;
+// ---------------------------------------------------------------------------
+// Constants (mirroring WebSocket readyState)
+// ---------------------------------------------------------------------------
+const WS_OPEN = 1;
+// ---------------------------------------------------------------------------
+// WebSocketSession
+// ---------------------------------------------------------------------------
+class WebSocketSession {
+    ws = null;
+    listeners = [];
+    reconnectCount = 0;
+    reconnectTimer = null;
+    intentionalClose = false;
+    url;
+    reconnectIntervalMs;
+    maxReconnects;
+    authToken;
+    wsFactory;
+    constructor(config, wsFactory) {
+        this.url = config.url;
+        this.reconnectIntervalMs = config.reconnectIntervalMs ?? 1_000;
+        this.maxReconnects = config.maxReconnects ?? 10;
+        this.authToken = config.authToken;
+        this.wsFactory = wsFactory;
+    }
+    // -----------------------------------------------------------------------
+    // Public API
+    // -----------------------------------------------------------------------
+    /** Open a WebSocket connection. */
+    connect() {
+        this.intentionalClose = false;
+        this.reconnectCount = 0;
+        this.doConnect();
+    }
+    /** Gracefully close the connection (no auto-reconnect). */
+    disconnect() {
+        this.intentionalClose = true;
+        if (this.reconnectTimer) {
+            clearTimeout(this.reconnectTimer);
+            this.reconnectTimer = null;
+        }
+        if (this.ws) {
+            this.ws.close();
+            this.ws = null;
+        }
+    }
+    /** Send a typed message over the WebSocket. */
+    send(message) {
+        if (!this.ws || this.ws.readyState !== WS_OPEN) {
+            throw new Error('WebSocket is not connected');
+        }
+        this.ws.send(JSON.stringify(message));
+    }
+    /** Register a callback for incoming messages. */
+    onMessage(callback) {
+        this.listeners.push(callback);
+    }
+    /** Whether the underlying WebSocket is currently open. */
+    isConnected() {
+        return this.ws != null && this.ws.readyState === WS_OPEN;
+    }
+    // -----------------------------------------------------------------------
+    // Internal
+    // -----------------------------------------------------------------------
+    doConnect() {
+        const protocols = this.authToken ? [`auth-${this.authToken}`] : undefined;
+        const ws = this.wsFactory(this.url, protocols);
+        this.ws = ws;
+        ws.onopen = () => {
+            this.reconnectCount = 0;
+        };
+        ws.onmessage = (ev) => {
+            let msg;
+            try {
+                msg = JSON.parse(ev.data);
+            }
+            catch {
+                return; // ignore unparseable frames
+            }
+            for (const cb of this.listeners) {
+                cb(msg);
+            }
+        };
+        ws.onclose = () => {
+            if (!this.intentionalClose) {
+                this.scheduleReconnect();
+            }
+        };
+        ws.onerror = () => {
+            // Error is typically followed by close — let onclose handle reconnect.
+        };
+    }
+    scheduleReconnect() {
+        if (this.reconnectCount >= this.maxReconnects) {
+            return; // give up
+        }
+        const delay = this.reconnectIntervalMs * Math.pow(2, this.reconnectCount);
+        this.reconnectCount++;
+        this.reconnectTimer = setTimeout(() => {
+            this.doConnect();
+        }, delay);
+    }
+}
+exports.WebSocketSession = WebSocketSession;

package/dist/harness/worktreeIsolation.d.ts

@@ -0,0 +1,39 @@
+/**
+ * Git Worktree Isolation (GAP-TOOLS-017).
+ *
+ * Helpers for creating, listing, and removing git worktrees
+ * to isolate concurrent agent work. Uses injectable command
+ * executor for testability.
+ */
+export interface WorktreeConfig {
+    baseBranch: string;
+    worktreePath: string;
+    label: string;
+}
+export interface WorktreeInfo {
+    worktree: string;
+    head: string;
+    branch: string;
+    bare: boolean;
+}
+export type ExecSyncFn = (cmd: string, opts?: {
+    cwd?: string;
+}) => Buffer;
+/**
+ * Create a new git worktree.
+ */
+export declare function createWorktree(repoDir: string, config: WorktreeConfig, exec?: ExecSyncFn): void;
+/**
+ * Remove a git worktree.
+ */
+export declare function removeWorktree(worktreePath: string, exec?: ExecSyncFn): void;
+/**
+ * List all worktrees for a repository by parsing `git worktree list --porcelain`.
+ */
+export declare function listWorktrees(repoDir: string, exec?: ExecSyncFn): WorktreeInfo[];
+/**
+ * Check if a directory is inside a git worktree (as opposed to the main working tree).
+ */
+export declare function isInsideWorktree(dir: string, exec?: ExecSyncFn): boolean;
+export declare function parsePorcelainOutput(output: string): WorktreeInfo[];
+//# sourceMappingURL=worktreeIsolation.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"worktreeIsolation.d.ts","sourceRoot":"","sources":["../../src/harness/worktreeIsolation.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAQH,MAAM,WAAW,cAAc;IAC7B,UAAU,EAAE,MAAM,CAAC;IACnB,YAAY,EAAE,MAAM,CAAC;IACrB,KAAK,EAAE,MAAM,CAAC;CACf;AAED,MAAM,WAAW,YAAY;IAC3B,QAAQ,EAAE,MAAM,CAAC;IACjB,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,OAAO,CAAC;CACf;AAED,MAAM,MAAM,UAAU,GAAG,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE;IAAE,GAAG,CAAC,EAAE,MAAM,CAAA;CAAE,KAAK,MAAM,CAAC;AAM1E;;GAEG;AACH,wBAAgB,cAAc,CAC5B,OAAO,EAAE,MAAM,EACf,MAAM,EAAE,cAAc,EACtB,IAAI,GAAE,UAA4B,GACjC,IAAI,CAKN;AAED;;GAEG;AACH,wBAAgB,cAAc,CAC5B,YAAY,EAAE,MAAM,EACpB,IAAI,GAAE,UAA4B,GACjC,IAAI,CAEN;AAED;;GAEG;AACH,wBAAgB,aAAa,CAC3B,OAAO,EAAE,MAAM,EACf,IAAI,GAAE,UAA4B,GACjC,YAAY,EAAE,CAGhB;AAED;;GAEG;AACH,wBAAgB,gBAAgB,CAC9B,GAAG,EAAE,MAAM,EACX,IAAI,GAAE,UAA4B,GACjC,OAAO,CAST;AAMD,wBAAgB,oBAAoB,CAAC,MAAM,EAAE,MAAM,GAAG,YAAY,EAAE,CA+BnE"}

package/dist/harness/worktreeIsolation.js

@@ -0,0 +1,85 @@
+"use strict";
+/**
+ * Git Worktree Isolation (GAP-TOOLS-017).
+ *
+ * Helpers for creating, listing, and removing git worktrees
+ * to isolate concurrent agent work. Uses injectable command
+ * executor for testability.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createWorktree = createWorktree;
+exports.removeWorktree = removeWorktree;
+exports.listWorktrees = listWorktrees;
+exports.isInsideWorktree = isInsideWorktree;
+exports.parsePorcelainOutput = parsePorcelainOutput;
+const node_child_process_1 = require("node:child_process");
+// ---------------------------------------------------------------------------
+// Public API
+// ---------------------------------------------------------------------------
+/**
+ * Create a new git worktree.
+ */
+function createWorktree(repoDir, config, exec = node_child_process_1.execSync) {
+    exec(`git worktree add "${config.worktreePath}" "${config.baseBranch}"`, { cwd: repoDir });
+}
+/**
+ * Remove a git worktree.
+ */
+function removeWorktree(worktreePath, exec = node_child_process_1.execSync) {
+    exec(`git worktree remove "${worktreePath}"`);
+}
+/**
+ * List all worktrees for a repository by parsing `git worktree list --porcelain`.
+ */
+function listWorktrees(repoDir, exec = node_child_process_1.execSync) {
+    const output = exec('git worktree list --porcelain', { cwd: repoDir }).toString('utf8');
+    return parsePorcelainOutput(output);
+}
+/**
+ * Check if a directory is inside a git worktree (as opposed to the main working tree).
+ */
+function isInsideWorktree(dir, exec = node_child_process_1.execSync) {
+    try {
+        const gitDir = exec('git rev-parse --git-dir', { cwd: dir }).toString('utf8').trim();
+        // A worktree's .git is a file pointing to the main repo's .git/worktrees/<name>,
+        // so the git-dir path will contain '/worktrees/' or '\\worktrees\\'.
+        return gitDir.includes('/worktrees/') || gitDir.includes('\\worktrees\\');
+    }
+    catch {
+        return false;
+    }
+}
+// ---------------------------------------------------------------------------
+// Internal
+// ---------------------------------------------------------------------------
+function parsePorcelainOutput(output) {
+    const results = [];
+    const blocks = output.trim().split('\n\n');
+    for (const block of blocks) {
+        if (!block.trim())
+            continue;
+        const lines = block.trim().split('\n');
+        let worktree = '';
+        let head = '';
+        let branch = '';
+        let bare = false;
+        for (const line of lines) {
+            if (line.startsWith('worktree ')) {
+                worktree = line.slice('worktree '.length);
+            }
+            else if (line.startsWith('HEAD ')) {
+                head = line.slice('HEAD '.length);
+            }
+            else if (line.startsWith('branch ')) {
+                branch = line.slice('branch '.length);
+            }
+            else if (line === 'bare') {
+                bare = true;
+            }
+        }
+        if (worktree) {
+            results.push({ worktree, head, branch, bare });
+        }
+    }
+    return results;
+}

package/dist/index.d.ts

@@ -0,0 +1,16 @@
+export * from "./harness";
+export * from "./runtime";
+export * from "./api";
+export * from "./daemon";
+export * from "./interaction";
+export * as anycli from "./anycli";
+export * as cost from "./cost";
+export * as governance from "./governance";
+export * from "./observability";
+export * as session from "./session";
+export * as storage from "./storage";
+export * as tasks from "./tasks";
+export * as processes from "./processes";
+export * as skills from "./skills";
+export * as plugins from "./plugins";
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,WAAW,CAAC;AAC1B,cAAc,WAAW,CAAC;AAC1B,cAAc,OAAO,CAAC;AACtB,cAAc,UAAU,CAAC;AACzB,cAAc,eAAe,CAAC;AAC9B,OAAO,KAAK,MAAM,MAAM,UAAU,CAAC;AACnC,OAAO,KAAK,IAAI,MAAM,QAAQ,CAAC;AAC/B,OAAO,KAAK,UAAU,MAAM,cAAc,CAAC;AAC3C,cAAc,iBAAiB,CAAC;AAChC,OAAO,KAAK,OAAO,MAAM,WAAW,CAAC;AACrC,OAAO,KAAK,OAAO,MAAM,WAAW,CAAC;AACrC,OAAO,KAAK,KAAK,MAAM,SAAS,CAAC;AACjC,OAAO,KAAK,SAAS,MAAM,aAAa,CAAC;AACzC,OAAO,KAAK,MAAM,MAAM,UAAU,CAAC;AACnC,OAAO,KAAK,OAAO,MAAM,WAAW,CAAC"}