pi-subagents 0.69.0 → 0.70.0

package/src/runs/shared/herdr-machine.js

@@ -0,0 +1,247 @@
+import { spawnSync } from "node:child_process";
+import * as fs from "node:fs";
+import * as path from "node:path";
+import { getAgentDir, getProjectConfigDir } from "../../shared/utils.js";
+import { CODE_OWNED_EXTERNAL_CLI_ADAPTER_IDS } from "./external-cli-contract.js";
+export { shellQuoteRemote as shellQuote } from "./herdr-connection.js";
+/**
+ * Herdr saved-machine placement for external CLI children.
+ *
+ * Herdr owns which machines exist and how ssh reaches them (`herdr machine list --json`).
+ * pi-subagents owns what runs there: native Pi and the six code-owned external profiles are
+ * launched in fresh Herdr-owned visible panes. SSH is bounded transport and never owns the agent.
+ * `cwd` means the directory on that machine; the remote `cd` is the directory check.
+ */
+const MAX_MACHINE_NAME_LENGTH = 128;
+const HERDR_MACHINE_LIST_TIMEOUT_MS = 7_500;
+const MAX_HERDR_MACHINE_LIST_BYTES = 1024 * 1024;
+const CONTROL_CHARS = /[\u0000-\u001f\u007f]/u;
+const SUPPORTED_MACHINE_ADAPTERS = new Set(CODE_OWNED_EXTERNAL_CLI_ADAPTER_IDS);
+/** The local ssh process gets only what ssh itself needs; remote runs use the machine's own credentials. */
+export const HERDR_SSH_ENV_ALLOWLIST = ["PATH", "HOME", "USER", "LOGNAME", "TMPDIR", "SSH_AUTH_SOCK"];
+function validateMachineName(value) {
+    const trimmed = value.trim();
+    if (!trimmed)
+        throw new Error("Herdr machine id or label is required.");
+    if (trimmed.length > MAX_MACHINE_NAME_LENGTH)
+        throw new Error(`Herdr machine '${trimmed.slice(0, 24)}…' exceeds ${MAX_MACHINE_NAME_LENGTH} characters.`);
+    if (CONTROL_CHARS.test(trimmed))
+        throw new Error("Herdr machine id or label contains control characters.");
+    return trimmed;
+}
+function validateTarget(value, requested) {
+    const target = value.trim();
+    if (!target || target.startsWith("-") || /[\s\u0000-\u001f\u007f]/u.test(target)) {
+        throw new Error(`Herdr machine '${requested}' has an ssh target that cannot be passed safely: ${JSON.stringify(target)}.`);
+    }
+    return target;
+}
+function isRemoteAbsolute(value) {
+    return value.startsWith("/") || value === "~" || value.startsWith("~/");
+}
+function validateRemoteCwd(value, requested) {
+    const cwd = value.trim();
+    if (!isRemoteAbsolute(cwd))
+        throw new Error(`Herdr machine '${requested}' cwd must be an absolute POSIX path or start with '~': ${JSON.stringify(cwd)}.`);
+    if (CONTROL_CHARS.test(cwd))
+        throw new Error(`Herdr machine '${requested}' cwd contains control characters.`);
+    return cwd.length > 1 ? cwd.replace(/\/+$/u, "") : cwd;
+}
+function parseMachineCatalog(json) {
+    let parsed;
+    try {
+        parsed = JSON.parse(json);
+    }
+    catch (error) {
+        throw new Error(`Failed to parse herdr machine list --json: ${error instanceof Error ? error.message : String(error)}`);
+    }
+    const entries = Array.isArray(parsed) ? parsed : (parsed && typeof parsed === "object" && Array.isArray(parsed.machines) ? parsed.machines : undefined);
+    if (!entries)
+        throw new Error("herdr machine list --json returned no machine list.");
+    return entries.flatMap((entry) => {
+        if (!entry || typeof entry !== "object" || Array.isArray(entry))
+            return [];
+        const record = entry;
+        if (typeof record.id !== "string" || !record.id.trim() || typeof record.target !== "string")
+            return [];
+        return [{
+                id: record.id.trim(),
+                ...(typeof record.label === "string" && record.label.trim() ? { label: record.label.trim() } : {}),
+                target: record.target,
+                ...(typeof record.session === "string" && record.session.trim() ? { session: record.session.trim() } : {}),
+                enabled: record.enabled !== false,
+            }];
+    });
+}
+function readHerdrMachineCatalog(env, herdrBin) {
+    const result = spawnSync(herdrBin, ["machine", "list", "--json"], {
+        env,
+        encoding: "utf-8",
+        maxBuffer: MAX_HERDR_MACHINE_LIST_BYTES,
+        timeout: HERDR_MACHINE_LIST_TIMEOUT_MS,
+        windowsHide: true,
+    });
+    if (result.error) {
+        const code = result.error.code;
+        if (code === "ENOENT")
+            throw new Error(`Herdr CLI '${herdrBin}' was not found on PATH. Saved-machine placement needs Herdr installed locally.`);
+        throw new Error(`Failed to run herdr machine list --json: ${result.error.message}`);
+    }
+    if (result.status !== 0)
+        throw new Error(`herdr machine list --json exited with code ${result.status}: ${(result.stderr || result.stdout).trim()}`);
+    return parseMachineCatalog(result.stdout);
+}
+/** Mirrors Herdr's own selector rules: profile id first, then a unique case-sensitive label; disabled fails closed. */
+function selectMachine(catalog, requested) {
+    const byId = catalog.find((entry) => entry.id === requested);
+    const matches = byId ? [byId] : catalog.filter((entry) => entry.label === requested);
+    if (matches.length > 1)
+        throw new Error(`Machine label '${requested}' is ambiguous; use its profile ID.`);
+    const machine = matches[0];
+    if (!machine) {
+        const saved = catalog.filter((entry) => entry.enabled).map((entry) => entry.label ?? entry.id);
+        throw new Error(`Herdr machine '${requested}' was not found. Saved machines: ${saved.length ? saved.join(", ") : "none"}. Add one with herdr machine add <target> --label <name>.`);
+    }
+    if (!machine.enabled)
+        throw new Error(`Machine '${requested}' is disabled. Run herdr machine enable ${machine.id}.`);
+    return machine;
+}
+function readJsonObject(filePath) {
+    if (!fs.existsSync(filePath))
+        return {};
+    let parsed;
+    try {
+        parsed = JSON.parse(fs.readFileSync(filePath, "utf-8"));
+    }
+    catch (error) {
+        throw new Error(`Failed to read settings file '${filePath}': ${error instanceof Error ? error.message : String(error)}`);
+    }
+    return parsed && typeof parsed === "object" && !Array.isArray(parsed) ? parsed : {};
+}
+function machineSettingsFrom(settings, keys, filePath) {
+    const subagents = settings.subagents;
+    if (!subagents || typeof subagents !== "object" || Array.isArray(subagents))
+        return undefined;
+    const machines = subagents.machines;
+    if (machines === undefined)
+        return undefined;
+    if (!machines || typeof machines !== "object" || Array.isArray(machines))
+        throw new Error(`Subagent settings in '${filePath}' have invalid 'machines'; expected an object keyed by machine label or id.`);
+    const key = keys.find((candidate) => candidate in machines);
+    if (key === undefined)
+        return undefined;
+    const value = machines[key];
+    if (!value || typeof value !== "object" || Array.isArray(value))
+        throw new Error(`Subagent settings in '${filePath}' have invalid 'machines.${key}'; expected an object with 'cwd' and optional 'env'.`);
+    const record = value;
+    const entry = {};
+    if (record.cwd !== undefined) {
+        if (typeof record.cwd !== "string" || !record.cwd.trim())
+            throw new Error(`Subagent settings in '${filePath}' have invalid 'machines.${key}.cwd'; expected a non-empty string.`);
+        entry.cwd = validateRemoteCwd(record.cwd, key);
+    }
+    if (record.env !== undefined) {
+        if (!record.env || typeof record.env !== "object" || Array.isArray(record.env) || Object.entries(record.env).some(([name, item]) => !/^[A-Za-z_][A-Za-z0-9_]*$/u.test(name) || typeof item !== "string")) {
+            throw new Error(`Subagent settings in '${filePath}' have invalid 'machines.${key}.env'; expected an object of string values keyed by variable name.`);
+        }
+        entry.env = { ...record.env };
+        if (Object.keys(entry.env).length > 0) {
+            throw new Error(`Subagent settings in '${filePath}' set 'machines.${key}.env'. Saved-machine runs use the remote Herdr/Pi environment; configure credentials and environment on '${key}' and remove the local env map.`);
+        }
+    }
+    return entry;
+}
+/** Project settings beat user settings, field by field; the entry may be keyed by label, id, or the typed selector. */
+function readMachineSettings(cwd, keys) {
+    const userPath = path.join(getAgentDir(), "settings.json");
+    const projectPath = path.join(getProjectConfigDir(findProjectRootForSettings(cwd)), "settings.json");
+    const user = machineSettingsFrom(readJsonObject(userPath), keys, userPath);
+    const project = projectPath === userPath ? undefined : machineSettingsFrom(readJsonObject(projectPath), keys, projectPath);
+    if (!user && !project)
+        return undefined;
+    return { ...user, ...project };
+}
+function findProjectRootForSettings(cwd) {
+    let current = path.resolve(cwd);
+    while (true) {
+        if (fs.existsSync(path.join(getProjectConfigDir(current), "settings.json")))
+            return current;
+        const parent = path.dirname(current);
+        if (parent === current)
+            return path.resolve(cwd);
+        current = parent;
+    }
+}
+export function resolveHerdrMachinePlacement(input) {
+    const requested = validateMachineName(input.machine);
+    const catalog = input.catalogJson !== undefined
+        ? parseMachineCatalog(input.catalogJson)
+        : readHerdrMachineCatalog(input.env ?? process.env, input.herdrBin ?? process.env.HERDR_BIN ?? "herdr");
+    const selected = selectMachine(catalog, requested);
+    const name = selected.label ?? selected.id;
+    const keys = [...new Set([requested, ...(selected.label ? [selected.label] : []), selected.id])];
+    const settings = input.settings ?? readMachineSettings(input.cwd, keys);
+    if (settings?.env && Object.keys(settings.env).length > 0) {
+        throw new Error(`Saved-machine environment for '${name}' must be configured remotely. Remove machines.${name}.env and configure the remote Herdr/Pi session instead.`);
+    }
+    const stepCwd = input.stepCwd?.trim();
+    let cwd;
+    if (stepCwd && isRemoteAbsolute(stepCwd))
+        cwd = stepCwd;
+    else if (settings?.cwd)
+        cwd = stepCwd ? path.posix.join(settings.cwd, stepCwd) : settings.cwd;
+    else
+        throw new Error(`No root for ${name} in this repo. Set subagents.machines.${name}.cwd in .pi/settings.json or pass an absolute cwd on that machine.`);
+    return {
+        machine: {
+            provider: "herdr",
+            id: selected.id,
+            ...(selected.label ? { label: selected.label } : {}),
+            target: validateTarget(selected.target, requested),
+            ...(selected.session && selected.session !== "default" ? { session: selected.session } : {}),
+            cwd: validateRemoteCwd(cwd, requested),
+        },
+        ...(settings?.env ? { env: settings.env } : {}),
+    };
+}
+export function formatHerdrMachineRunnerUnsupported(input) {
+    if (input.machine === undefined)
+        return undefined;
+    if (input.runnerType !== undefined && input.runnerType !== "pi" && input.runnerType !== "external-cli") {
+        return `Agent '${input.agentName}' requested machine '${input.machine}', but this runner cannot use pane-native Herdr placement. Use native Pi or a built-in Claude, Codex, or Cursor profile.`;
+    }
+    if (input.runnerType === "external-cli" && (input.adapter === undefined || !SUPPORTED_MACHINE_ADAPTERS.has(input.adapter))) {
+        return `Agent '${input.agentName}' requested machine '${input.machine}', but generic external-cli commands cannot be remote-wrapped safely. Use claude-code, claude-code-writer, codex-exec, codex-exec-writer, cursor-agent, or cursor-agent-writer.`;
+    }
+    if (input.worktree === true)
+        return `Agent '${input.agentName}' requested machine '${input.machine}', but managed worktrees are local git operations and cannot be combined with a Herdr saved machine.`;
+    if (process.platform === "win32")
+        return "Herdr saved-machine pane transport requires hardened OpenSSH StreamLocal forwarding, which is not supported from a Windows host yet.";
+    return undefined;
+}
+/** Legacy local-child SSH wrapping is intentionally unavailable after the pane-native cut-over. */
+export function prepareHerdrMachineExternalCliRun(input, placement, _options) {
+    if (placement)
+        throw new Error("Saved-machine external profiles must run in a Herdr-owned pane.");
+    return { input, decorateProcess: (process) => process };
+}
+const HINTS = [
+    [/Host key verification failed|REMOTE HOST IDENTIFICATION HAS CHANGED|Permission denied \(publickey|Permission denied, please try again|No such identity|Could not resolve hostname|Connection (timed out|refused)/iu,
+        (machine) => `ssh could not reach or authenticate with ${machine.target}. Connect once interactively with ssh ${machine.target} to accept the host key or fix the identity; BatchMode never prompts.`],
+    [/is not recognized as|CommandNotFoundException|PowerShell|At line:\d+ char:\d+/u,
+        (machine) => `Machine '${machine.label ?? machine.id}' is not a POSIX host. External-cli runs support POSIX ssh targets only.`],
+    [/\bcd: .*(No such file or directory|not a directory|can't cd)|exit(?:ed with)? code 125\b/iu,
+        (machine) => `Nothing at ${machine.cwd} on ${machine.label ?? machine.id}. Clone the repo there first; pi-subagents never clones, pulls, or checks out on a machine.`],
+    [/(?:command not found|not found)\s*$|No such file or directory\s*$|exit(?:ed with)? code 127\b/imu,
+        (machine) => `The agent CLI was not found on ${machine.label ?? machine.id}. Non-interactive shells skip rc files and the PATH prefix did not find it; set the agent's command to the absolute path on that machine.`],
+    [/not logged in|unauthorized|authentication_error|invalid api key|please run .*login|OAuth token/iu,
+        (machine) => `Remote runs use the machine's own credentials. Log in to the agent CLI on ${machine.label ?? machine.id} once.`],
+];
+/** One-line operator hint for a predictable remote failure, matched against error text and the stderr tail. */
+export function formatHerdrMachineHint(machine, text) {
+    for (const [pattern, hint] of HINTS)
+        if (pattern.test(text))
+            return hint(machine);
+    return undefined;
+}
+//# sourceMappingURL=herdr-machine.js.map

package/src/runs/shared/herdr-machine.js.map

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

package/src/runs/shared/herdr-pi-protocol.d.ts

@@ -0,0 +1,22 @@
+export declare const HERDR_PI_PROTOCOL = 1;
+export declare const HERDR_PI_MAX_FRAME_BYTES: number;
+export declare const HERDR_PI_MODE_ENV = "PI_SUBAGENTS_HERDR_BRIDGE";
+export declare const HERDR_PI_RUN_ENV = "PI_SUBAGENTS_HERDR_RUN_ID";
+export declare const HERDR_PI_RUNTIME_DIR_ENV = "PI_SUBAGENTS_HERDR_RUNTIME_DIR";
+export declare function validateHerdrPiRunId(value: unknown): string;
+export declare function herdrPiRuntimeRoot(agentDir: string): string;
+export declare function herdrPiRunDir(agentDir: string, runId: string): string;
+export interface HerdrPiFrame {
+    protocol: number;
+    runId: string;
+    type: string;
+    requestId?: string;
+    [key: string]: unknown;
+}
+export declare function encodeHerdrPiFrame(frame: HerdrPiFrame): Buffer;
+export declare class HerdrPiFrameDecoder {
+    #private;
+    push(chunk: Buffer): HerdrPiFrame[];
+    end(): void;
+}
+//# sourceMappingURL=herdr-pi-protocol.d.ts.map

package/src/runs/shared/herdr-pi-protocol.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"herdr-pi-protocol.d.ts","sourceRoot":"","sources":["../../../../src/runs/shared/herdr-pi-protocol.ts"],"names":[],"mappings":"AAEA,eAAO,MAAM,iBAAiB,IAAI,CAAC;AACnC,eAAO,MAAM,wBAAwB,QAAc,CAAC;AACpD,eAAO,MAAM,iBAAiB,8BAA8B,CAAC;AAC7D,eAAO,MAAM,gBAAgB,8BAA8B,CAAC;AAC5D,eAAO,MAAM,wBAAwB,mCAAmC,CAAC;AAGzE,wBAAgB,oBAAoB,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,CAG3D;AAED,wBAAgB,kBAAkB,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,CAE3D;AAED,wBAAgB,aAAa,CAAC,QAAQ,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,MAAM,CAErE;AAED,MAAM,WAAW,YAAY;IAC5B,QAAQ,EAAE,MAAM,CAAC;IACjB,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;CACvB;AAED,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,YAAY,GAAG,MAAM,CAI9D;AAED,qBAAa,mBAAmB;;IAE/B,IAAI,CAAC,KAAK,EAAE,MAAM,GAAG,YAAY,EAAE;IAmBnC,GAAG,IAAI,IAAI;CACX"}

package/src/runs/shared/herdr-pi-protocol.js

@@ -0,0 +1,58 @@
+import * as path from "node:path";
+export const HERDR_PI_PROTOCOL = 1;
+export const HERDR_PI_MAX_FRAME_BYTES = 1024 * 1024;
+export const HERDR_PI_MODE_ENV = "PI_SUBAGENTS_HERDR_BRIDGE";
+export const HERDR_PI_RUN_ENV = "PI_SUBAGENTS_HERDR_RUN_ID";
+export const HERDR_PI_RUNTIME_DIR_ENV = "PI_SUBAGENTS_HERDR_RUNTIME_DIR";
+const SAFE_ID = /^[A-Za-z0-9_-]{8,96}$/u;
+export function validateHerdrPiRunId(value) {
+    if (typeof value !== "string" || !SAFE_ID.test(value))
+        throw new Error("Herdr Pi bridge run identity is invalid.");
+    return value;
+}
+export function herdrPiRuntimeRoot(agentDir) {
+    return path.join(agentDir, "pi-subagents", "herdr-runs");
+}
+export function herdrPiRunDir(agentDir, runId) {
+    return path.join(herdrPiRuntimeRoot(agentDir), validateHerdrPiRunId(runId));
+}
+export function encodeHerdrPiFrame(frame) {
+    const data = Buffer.from(`${JSON.stringify(frame)}\n`, "utf8");
+    if (data.byteLength > HERDR_PI_MAX_FRAME_BYTES)
+        throw new Error(`Herdr Pi frame exceeds ${HERDR_PI_MAX_FRAME_BYTES} bytes.`);
+    return data;
+}
+export class HerdrPiFrameDecoder {
+    #buffer = Buffer.alloc(0);
+    push(chunk) {
+        this.#buffer = Buffer.concat([this.#buffer, chunk]);
+        if (this.#buffer.byteLength > HERDR_PI_MAX_FRAME_BYTES)
+            throw new Error(`Herdr Pi frame exceeds ${HERDR_PI_MAX_FRAME_BYTES} bytes.`);
+        const frames = [];
+        for (;;) {
+            const newline = this.#buffer.indexOf(10);
+            if (newline < 0)
+                break;
+            const line = this.#buffer.subarray(0, newline);
+            this.#buffer = this.#buffer.subarray(newline + 1);
+            let value;
+            try {
+                value = JSON.parse(new TextDecoder("utf-8", { fatal: true }).decode(line));
+            }
+            catch {
+                throw new Error("Herdr Pi bridge emitted malformed JSON or UTF-8.");
+            }
+            if (!value || typeof value !== "object" || Array.isArray(value))
+                throw new Error("Herdr Pi bridge frame must be an object.");
+            const frame = value;
+            if (frame.protocol !== HERDR_PI_PROTOCOL || typeof frame.type !== "string")
+                throw new Error("Herdr Pi bridge protocol mismatch.");
+            validateHerdrPiRunId(frame.runId);
+            frames.push(frame);
+        }
+        return frames;
+    }
+    end() { if (this.#buffer.byteLength)
+        throw new Error("Herdr Pi bridge ended with a partial frame."); }
+}
+//# sourceMappingURL=herdr-pi-protocol.js.map

package/src/runs/shared/herdr-pi-protocol.js.map

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

package/src/runs/shared/herdr-placed-run.d.ts

@@ -0,0 +1,267 @@
+import * as net from "node:net";
+import type { AgentMessage } from "@earendil-works/pi-agent-core";
+import type { HerdrMachineReference, HerdrRemoteGitStatus } from "../../shared/types.ts";
+import type { ChildSession, ChildSessionEvent, ChildSessionFactory, ChildSessionLaunch } from "./child-session.ts";
+import type { ChildRuntimeConfig } from "./child-runtime-config.ts";
+import { connectHerdrMachine, type HerdrForwardedConnection, type HerdrRpcClient } from "./herdr-connection.ts";
+import { HerdrPiFrameDecoder, type HerdrPiFrame } from "./herdr-pi-protocol.ts";
+export interface HerdrRunIdentity {
+    runId: string;
+    machineId: string;
+    target: string;
+    session: string | null;
+    workspaceId: string;
+    tabId: string;
+    paneId: string;
+    terminalId: string;
+    agentName: string;
+    nativeSessionId: string;
+    cwd: string;
+    runtimeDir: string;
+}
+export interface HerdrRunSnapshot {
+    connection: "connected" | "unknown" | "closed";
+    state: "ready" | "working" | "blocked" | "settled" | "unknown";
+    identity?: HerdrRunIdentity;
+    revision: number;
+}
+export interface HerdrReconnectCandidate {
+    endpoint: {
+        session: string | null;
+        protocol: number;
+        version: string;
+    };
+    agents: Array<{
+        terminal_id?: string;
+        pane_id?: string;
+        agent_status?: string;
+    }>;
+    bridge: {
+        runId?: string;
+        nativeSessionId?: string;
+        packageVersion?: string;
+        protocol?: number;
+        evidenceCursor?: number;
+        evidenceFloor?: number;
+    };
+}
+export declare function herdrStatusSubscriptions(paneId: string): unknown[];
+export declare function reconcileHerdrPlacedRun(identity: HerdrRunIdentity, candidate: HerdrReconnectCandidate, proveEvidence: () => {
+    ok: true;
+    cursor: number;
+} | {
+    ok: false;
+    reason: string;
+}): {
+    ok: true;
+    state: HerdrRunSnapshot["state"];
+    paneId: string;
+    cursor: number;
+} | {
+    ok: false;
+    reason: string;
+};
+export declare function reconcileHerdrReconnect(identity: HerdrRunIdentity, candidate: HerdrReconnectCandidate, lastEvidenceCursor: number): {
+    ok: true;
+    state: HerdrRunSnapshot["state"];
+    paneId: string;
+    cursor: number;
+} | {
+    ok: false;
+    reason: string;
+};
+export declare function boundedHerdrReconnect(identity: HerdrRunIdentity, lastEvidenceCursor: number, attempt: (number: number) => Promise<HerdrReconnectCandidate>, options?: {
+    attempts?: number;
+    deadlineMs?: number;
+    disposed?: () => boolean;
+}): Promise<{
+    ok: true;
+    state: HerdrRunSnapshot["state"];
+    paneId: string;
+    cursor: number;
+} | {
+    ok: false;
+    reason: string;
+}>;
+export declare function parseHerdrCreated(value: unknown, type: "workspace_created" | "tab_created"): {
+    workspaceId?: string;
+    tabId: string;
+    paneId: string;
+};
+export declare function parseHerdrAgent(value: unknown, type: "agent_started" | "agent_info" | "agent_prompted"): Record<string, unknown>;
+export declare function parseHerdrSessionSnapshot(value: unknown): Record<string, unknown>;
+export declare function ownsHerdrPane(agent: Record<string, unknown>, terminalId: string, paneId: string): boolean;
+export declare const HERDR_MAX_OWNED_PANES = 20;
+export declare function herdrPaneAllocationKey(target: string, session: string | null, cwd: string): string;
+export declare function withHerdrPaneAllocationLock<T>(key: string, action: () => Promise<T>, options?: {
+    timeoutMs?: number;
+    pollMs?: number;
+}): Promise<T>;
+export declare function serializeHerdrPiLaunch(launch: ChildSessionLaunch): {
+    args: string[];
+    resources: {
+        agent: string;
+        skills?: string[];
+        toolCeiling?: string[];
+        reads?: string[] | false;
+    };
+};
+export declare function provisionHerdrPane(client: HerdrRpcClient, cwd: string, runId: string, runtimeDir: string, environment?: Record<string, string>, allocationKey?: string): Promise<{
+    workspaceId: string;
+    tabId: string;
+    paneId: string;
+}>;
+export declare function discoverBridgeManifest(machine: HerdrMachineReference, runId: string, runtimeDir: string, options?: {
+    sshBin?: string;
+    env?: NodeJS.ProcessEnv;
+}): Promise<{
+    socketPath: string;
+    nativeSessionId: string;
+    packageVersion: string;
+    protocol: number;
+}>;
+export declare function createRemoteRuntimeDir(machine: HerdrMachineReference, runId: string, options?: {
+    sshBin?: string;
+    env?: NodeJS.ProcessEnv;
+}): Promise<string>;
+export declare function removeRemoteRuntimeDir(machine: HerdrMachineReference, runtimeDir: string, options?: {
+    sshBin?: string;
+    env?: NodeJS.ProcessEnv;
+}): void;
+/** The single private owner for allocation shared by every pane-native backend projection. */
+export declare class HerdrPlacedRunOwner {
+    #private;
+    readonly machine: HerdrMachineReference;
+    readonly runId: string;
+    readonly runtimeDir: string;
+    connection: HerdrForwardedConnection;
+    owned?: {
+        workspaceId: string;
+        tabId: string;
+        paneId: string;
+    };
+    terminalId?: string;
+    agentName?: string;
+    startedArgv?: string[];
+    identity?: HerdrRunIdentity;
+    private constructor();
+    static create(machine: HerdrMachineReference, runId: string, beforePane?: (owner: HerdrPlacedRunOwner) => void | Promise<void>): Promise<HerdrPlacedRunOwner>;
+    observeEvent(event: unknown): void;
+    markConnectionUnknown(observed: HerdrForwardedConnection): boolean;
+    statusSubscriptions(paneId?: string | undefined): unknown[];
+    subscribe(listener: (event: unknown) => void, disconnected: (error: Error) => void): Promise<void>;
+    provision(environment?: Record<string, string>): Promise<{
+        workspaceId: string;
+        tabId: string;
+        paneId: string;
+    }>;
+    start(kind: "pi" | "claude" | "cursor" | "codex", name: string, args: string[], options?: {
+        timeoutMs?: number;
+        pollMs?: number;
+        clock?: {
+            now(): number;
+            wait(ms: number): Promise<void>;
+        };
+    }): Promise<{
+        terminalId: string;
+        paneId: string;
+        argv: string[];
+    }>;
+    journal(identity: HerdrRunIdentity): void;
+    get snapshot(): HerdrRunSnapshot;
+    runRemote(command: string, options?: {
+        timeout?: number;
+        maxBuffer?: number;
+    }): import("child_process").SpawnSyncReturns<string>;
+    replaceConnection(input: {
+        connection: HerdrForwardedConnection;
+        unsubscribe: () => void;
+        paneId: string;
+        state: HerdrRunSnapshot["state"];
+    }): Promise<void>;
+    cleanup(closeStartedPane?: boolean): Promise<void>;
+}
+export declare class BridgeChannel {
+    #private;
+    readonly socket: net.Socket;
+    readonly decoder: HerdrPiFrameDecoder;
+    readonly listeners: Set<(frame: HerdrPiFrame) => void>;
+    readonly waiters: Map<string, {
+        resolve(frame: HerdrPiFrame): void;
+        reject(error: Error): void;
+    }>;
+    readonly runId: string;
+    readonly frames: HerdrPiFrame[];
+    readonly failure: Promise<never>;
+    constructor(socketPath: string, runId: string);
+    fail(error: Error): void;
+    get failed(): boolean;
+    wait(type: string, requestId: string): Promise<HerdrPiFrame>;
+    configure(resources: {
+        agent: string;
+        skills?: string[];
+        toolCeiling?: string[];
+        reads?: string[] | false;
+    }): Promise<HerdrPiFrame>;
+    supervisorDelivered(requestId: string): void;
+    prepare(requestId: string, operation: string, text?: string, supervisorId?: string): Promise<HerdrPiFrame>;
+    close(): void;
+}
+export declare class HerdrPiSession implements ChildSession {
+    #private;
+    bridgeForward: {
+        close(): Promise<void>;
+    };
+    bridge: BridgeChannel;
+    readonly requestedTools: string[] | undefined;
+    readonly model: string | undefined;
+    readonly supervisorDir: string | undefined;
+    readonly runtime: ChildRuntimeConfig;
+    readonly owner: HerdrPlacedRunOwner;
+    constructor(owner: HerdrPlacedRunOwner, bridgeForward: {
+        close(): Promise<void>;
+    }, bridge: BridgeChannel, requestedTools: string[] | undefined, model: string | undefined, runtime: ChildRuntimeConfig, initialGit?: HerdrRemoteGitStatus);
+    get identity(): HerdrRunIdentity;
+    set identity(value: HerdrRunIdentity);
+    get connection(): HerdrForwardedConnection;
+    set connection(value: HerdrForwardedConnection);
+    armReconnect(factory: () => Promise<void>): void;
+    get evidenceCursor(): number;
+    reconnect(): Promise<void>;
+    replaceTransport(input: {
+        connection: HerdrForwardedConnection;
+        bridgeForward: {
+            close(): Promise<void>;
+        };
+        bridge: BridgeChannel;
+        unsubscribe: () => void;
+        paneId: string;
+        cursor: number;
+        state: HerdrRunSnapshot["state"];
+    }): Promise<void>;
+    observeHerdr(value: unknown): void;
+    subscribe(listener: (event: ChildSessionEvent) => void): () => boolean;
+    prompt(text: string): Promise<void>;
+    steer(text: string): Promise<void>;
+    followUp(text: string): Promise<void>;
+    abort(): Promise<void>;
+    dispose(): Promise<void>;
+    get messages(): AgentMessage[];
+    get sessionFile(): undefined;
+    get sessionId(): string;
+    get modelId(): string | undefined;
+    get machineEvidence(): {
+        final?: HerdrRemoteGitStatus | undefined;
+        initial?: HerdrRemoteGitStatus | undefined;
+        machineId: string;
+    };
+    get placementSnapshot(): HerdrRunSnapshot;
+}
+export declare function reconnectHerdrPiSession(session: HerdrPiSession, launch: ChildSessionLaunch, dependencies?: {
+    connect?: typeof connectHerdrMachine;
+    discoverManifest?: typeof discoverBridgeManifest;
+    createBridge?: (socketPath: string, runId: string) => BridgeChannel;
+}): Promise<void>;
+export declare function createHerdrPiSession(launch: ChildSessionLaunch): Promise<ChildSession>;
+export declare function createPlacementAwareChildSessionFactory(local: ChildSessionFactory, createRemote?: (launch: ChildSessionLaunch) => Promise<ChildSession>): ChildSessionFactory;
+//# sourceMappingURL=herdr-placed-run.d.ts.map

package/src/runs/shared/herdr-placed-run.d.ts.map

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