@ai-devkit/agent-manager 0.31.0 → 0.33.0

package/dist/runtime/herdr/HerdrAgentRuntime.js

@@ -0,0 +1,184 @@
+import { HerdrCliClient, isCommandMissing } from "./HerdrCliClient.js";
+import { HerdrRuntimeError } from "./HerdrErrors.js";
+import { parseHerdrRuntimeRef } from "./HerdrRuntimeRef.js";
+import { extractAgentRuntimeRef, extractProcessInfoPid, extractWorkspaceStart } from "./HerdrResponseParsers.js";
+const AGENT_START_BUSY_RETRY_MS = 5000;
+const AGENT_START_BUSY_RETRY_INTERVAL_MS = 100;
+export class HerdrAgentRuntime {
+    provider = "herdr";
+    client;
+    env;
+    agentStartBusyRetryMs;
+    agentStartBusyRetryIntervalMs;
+    constructor(options = {}){
+        this.client = new HerdrCliClient(options.runner);
+        this.env = options.env ?? process.env;
+        this.agentStartBusyRetryMs = options.agentStartBusyRetryMs ?? AGENT_START_BUSY_RETRY_MS;
+        this.agentStartBusyRetryIntervalMs = options.agentStartBusyRetryIntervalMs ?? AGENT_START_BUSY_RETRY_INTERVAL_MS;
+    }
+    async isAvailable() {
+        try {
+            await this.client.run([
+                "--version"
+            ]);
+        } catch (error) {
+            if (isCommandMissing(error)) {
+                return {
+                    ok: false,
+                    reason: "binary-missing",
+                    detail: "herdr command was not found in PATH."
+                };
+            }
+            return {
+                ok: false,
+                reason: "backend-unreachable",
+                detail: error.message
+            };
+        }
+        try {
+            await this.client.run([
+                "api",
+                "snapshot"
+            ]);
+        } catch (error) {
+            return {
+                ok: false,
+                reason: "backend-unreachable",
+                detail: error.message
+            };
+        }
+        const currentPaneId = nonEmptyString(this.env.HERDR_PANE_ID);
+        return {
+            ok: true,
+            insideRuntime: this.env.HERDR_ENV === "1",
+            ...currentPaneId ? {
+                currentPaneId
+            } : {}
+        };
+    }
+    async startAgent(input) {
+        const workspace = extractWorkspaceStart(await this.client.runJson([
+            "workspace",
+            "create",
+            "--cwd",
+            input.cwd,
+            "--label",
+            input.name
+        ]));
+        const agentResponse = await this.runAgentStartJson([
+            "agent",
+            "start",
+            input.name,
+            "--kind",
+            input.kind,
+            "--pane",
+            workspace.paneId,
+            ...input.timeoutMs ? [
+                "--timeout",
+                String(input.timeoutMs)
+            ] : [],
+            ...input.args?.length ? [
+                "--",
+                ...input.args
+            ] : []
+        ]);
+        const runtimeRef = extractAgentRuntimeRef(agentResponse, {
+            name: input.name,
+            paneId: workspace.paneId,
+            workspaceId: workspace.workspaceId
+        });
+        const processInfoResponse = await this.client.runJson([
+            "pane",
+            "process-info",
+            "--pane",
+            runtimeRef.paneId
+        ]);
+        const pid = extractProcessInfoPid(processInfoResponse);
+        if (pid === null) {
+            throw new HerdrRuntimeError("Herdr pane process-info response did not include process pid.");
+        }
+        return {
+            pid,
+            runtimeRef
+        };
+    }
+    async send(input) {
+        const ref = parseHerdrRuntimeRef(input.runtimeRef);
+        await this.client.run([
+            "agent",
+            "prompt",
+            ref.paneId,
+            input.prompt
+        ]);
+    }
+    async wait(input) {
+        const ref = parseHerdrRuntimeRef(input.runtimeRef);
+        await this.client.run([
+            "agent",
+            "wait",
+            ref.paneId,
+            "--until",
+            "done",
+            "--until",
+            "blocked",
+            "--timeout",
+            String(input.timeoutMs)
+        ]);
+    }
+    async readOutput(input) {
+        const ref = parseHerdrRuntimeRef(input.runtimeRef);
+        const { stdout } = await this.client.run([
+            "agent",
+            "read",
+            ref.paneId,
+            "--source",
+            "recent-unwrapped",
+            "--lines",
+            String(input.lines ?? 120)
+        ]);
+        return stdout;
+    }
+    async focus(input) {
+        const ref = parseHerdrRuntimeRef(input.runtimeRef);
+        await this.client.run([
+            "agent",
+            "focus",
+            ref.paneId
+        ]);
+        return true;
+    }
+    async stop(input) {
+        const ref = parseHerdrRuntimeRef(input.runtimeRef);
+        await this.client.run([
+            "pane",
+            "close",
+            ref.paneId
+        ]);
+    }
+    async runAgentStartJson(args) {
+        const deadline = Date.now() + this.agentStartBusyRetryMs;
+        let lastBusyError = null;
+        do {
+            try {
+                return await this.client.runJson(args);
+            } catch (error) {
+                if (!(error instanceof HerdrRuntimeError) || error.code !== "agent_pane_busy") throw error;
+                lastBusyError = error;
+                if (Date.now() >= deadline) break;
+                await sleep(this.agentStartBusyRetryIntervalMs);
+            }
+        }while (Date.now() < deadline)
+        throw lastBusyError ?? new HerdrRuntimeError("Herdr agent start failed because the target pane stayed busy.", {
+            code: "agent_pane_busy"
+        });
+    }
+}
+function sleep(ms) {
+    if (ms <= 0) return Promise.resolve();
+    return new Promise((resolve)=>setTimeout(resolve, ms));
+}
+function nonEmptyString(value) {
+    return typeof value === "string" && value.trim() ? value : undefined;
+}
+
+//# sourceMappingURL=HerdrAgentRuntime.js.map

package/dist/runtime/herdr/HerdrAgentRuntime.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../src/runtime/herdr/HerdrAgentRuntime.ts"],"sourcesContent":["import { HerdrCliClient, isCommandMissing, type HerdrCommandRunner } from \"./HerdrCliClient.js\";\nimport { HerdrRuntimeError } from \"./HerdrErrors.js\";\nimport { parseHerdrRuntimeRef } from \"./HerdrRuntimeRef.js\";\nimport {\n  extractAgentRuntimeRef,\n  extractProcessInfoPid,\n  extractWorkspaceStart,\n} from \"./HerdrResponseParsers.js\";\nimport type {\n  AgentRuntimeAvailability,\n  InteractiveAgentRuntime,\n  RuntimeFocusInput,\n  RuntimeSendInput,\n  RuntimeStartInput,\n  RuntimeStartResult,\n  RuntimeStopInput,\n} from \"../types.js\";\n\nconst AGENT_START_BUSY_RETRY_MS = 5000;\nconst AGENT_START_BUSY_RETRY_INTERVAL_MS = 100;\n\nexport interface HerdrRuntimeOptions {\n  runner?: HerdrCommandRunner;\n  env?: NodeJS.ProcessEnv;\n  agentStartBusyRetryMs?: number;\n  agentStartBusyRetryIntervalMs?: number;\n}\n\nexport class HerdrAgentRuntime implements InteractiveAgentRuntime {\n  readonly provider = \"herdr\" as const;\n\n  private readonly client: HerdrCliClient;\n  private readonly env: NodeJS.ProcessEnv;\n  private readonly agentStartBusyRetryMs: number;\n  private readonly agentStartBusyRetryIntervalMs: number;\n\n  constructor(options: HerdrRuntimeOptions = {}) {\n    this.client = new HerdrCliClient(options.runner);\n    this.env = options.env ?? process.env;\n    this.agentStartBusyRetryMs = options.agentStartBusyRetryMs ?? AGENT_START_BUSY_RETRY_MS;\n    this.agentStartBusyRetryIntervalMs =\n      options.agentStartBusyRetryIntervalMs ?? AGENT_START_BUSY_RETRY_INTERVAL_MS;\n  }\n\n  async isAvailable(): Promise<AgentRuntimeAvailability> {\n    try {\n      await this.client.run([\"--version\"]);\n    } catch (error) {\n      if (isCommandMissing(error)) {\n        return {\n          ok: false,\n          reason: \"binary-missing\",\n          detail: \"herdr command was not found in PATH.\",\n        };\n      }\n      return {\n        ok: false,\n        reason: \"backend-unreachable\",\n        detail: (error as Error).message,\n      };\n    }\n\n    try {\n      await this.client.run([\"api\", \"snapshot\"]);\n    } catch (error) {\n      return {\n        ok: false,\n        reason: \"backend-unreachable\",\n        detail: (error as Error).message,\n      };\n    }\n\n    const currentPaneId = nonEmptyString(this.env.HERDR_PANE_ID);\n    return {\n      ok: true,\n      insideRuntime: this.env.HERDR_ENV === \"1\",\n      ...(currentPaneId ? { currentPaneId } : {}),\n    };\n  }\n\n  async startAgent(input: RuntimeStartInput): Promise<RuntimeStartResult> {\n    const workspace = extractWorkspaceStart(\n      await this.client.runJson([\"workspace\", \"create\", \"--cwd\", input.cwd, \"--label\", input.name]),\n    );\n\n    const agentResponse = await this.runAgentStartJson([\n      \"agent\",\n      \"start\",\n      input.name,\n      \"--kind\",\n      input.kind,\n      \"--pane\",\n      workspace.paneId,\n      ...(input.timeoutMs ? [\"--timeout\", String(input.timeoutMs)] : []),\n      ...(input.args?.length ? [\"--\", ...input.args] : []),\n    ]);\n    const runtimeRef = extractAgentRuntimeRef(agentResponse, {\n      name: input.name,\n      paneId: workspace.paneId,\n      workspaceId: workspace.workspaceId,\n    });\n    const processInfoResponse = await this.client.runJson([\n      \"pane\",\n      \"process-info\",\n      \"--pane\",\n      runtimeRef.paneId,\n    ]);\n    const pid = extractProcessInfoPid(processInfoResponse);\n    if (pid === null) {\n      throw new HerdrRuntimeError(\"Herdr pane process-info response did not include process pid.\");\n    }\n\n    return { pid, runtimeRef };\n  }\n\n  async send(input: RuntimeSendInput): Promise<void> {\n    const ref = parseHerdrRuntimeRef(input.runtimeRef);\n    await this.client.run([\"agent\", \"prompt\", ref.paneId, input.prompt]);\n  }\n\n  async wait(input: { runtimeRef: unknown; timeoutMs: number }): Promise<void> {\n    const ref = parseHerdrRuntimeRef(input.runtimeRef);\n    await this.client.run([\n      \"agent\",\n      \"wait\",\n      ref.paneId,\n      \"--until\",\n      \"done\",\n      \"--until\",\n      \"blocked\",\n      \"--timeout\",\n      String(input.timeoutMs),\n    ]);\n  }\n\n  async readOutput(input: { runtimeRef: unknown; lines?: number }): Promise<string> {\n    const ref = parseHerdrRuntimeRef(input.runtimeRef);\n    const { stdout } = await this.client.run([\n      \"agent\",\n      \"read\",\n      ref.paneId,\n      \"--source\",\n      \"recent-unwrapped\",\n      \"--lines\",\n      String(input.lines ?? 120),\n    ]);\n    return stdout;\n  }\n\n  async focus(input: RuntimeFocusInput): Promise<boolean> {\n    const ref = parseHerdrRuntimeRef(input.runtimeRef);\n    await this.client.run([\"agent\", \"focus\", ref.paneId]);\n    return true;\n  }\n\n  async stop(input: RuntimeStopInput): Promise<void> {\n    const ref = parseHerdrRuntimeRef(input.runtimeRef);\n    await this.client.run([\"pane\", \"close\", ref.paneId]);\n  }\n\n  private async runAgentStartJson(args: string[]): Promise<unknown> {\n    const deadline = Date.now() + this.agentStartBusyRetryMs;\n    let lastBusyError: HerdrRuntimeError | null = null;\n    do {\n      try {\n        return await this.client.runJson(args);\n      } catch (error) {\n        if (!(error instanceof HerdrRuntimeError) || error.code !== \"agent_pane_busy\") throw error;\n        lastBusyError = error;\n        if (Date.now() >= deadline) break;\n        await sleep(this.agentStartBusyRetryIntervalMs);\n      }\n    } while (Date.now() < deadline);\n    throw (\n      lastBusyError ??\n      new HerdrRuntimeError(\"Herdr agent start failed because the target pane stayed busy.\", {\n        code: \"agent_pane_busy\",\n      })\n    );\n  }\n}\n\nfunction sleep(ms: number): Promise<void> {\n  if (ms <= 0) return Promise.resolve();\n  return new Promise((resolve) => setTimeout(resolve, ms));\n}\n\nfunction nonEmptyString(value: unknown): string | undefined {\n  return typeof value === \"string\" && value.trim() ? value : undefined;\n}\n"],"names":["HerdrCliClient","isCommandMissing","HerdrRuntimeError","parseHerdrRuntimeRef","extractAgentRuntimeRef","extractProcessInfoPid","extractWorkspaceStart","AGENT_START_BUSY_RETRY_MS","AGENT_START_BUSY_RETRY_INTERVAL_MS","HerdrAgentRuntime","provider","client","env","agentStartBusyRetryMs","agentStartBusyRetryIntervalMs","options","runner","process","isAvailable","run","error","ok","reason","detail","message","currentPaneId","nonEmptyString","HERDR_PANE_ID","insideRuntime","HERDR_ENV","startAgent","input","workspace","runJson","cwd","name","agentResponse","runAgentStartJson","kind","paneId","timeoutMs","String","args","length","runtimeRef","workspaceId","processInfoResponse","pid","send","ref","prompt","wait","readOutput","stdout","lines","focus","stop","deadline","Date","now","lastBusyError","code","sleep","ms","Promise","resolve","setTimeout","value","trim","undefined"],"mappings":"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"}

package/dist/runtime/herdr/HerdrCliClient.d.ts

@@ -0,0 +1,13 @@
+export interface HerdrCommandResult {
+    stdout: string;
+    stderr: string;
+}
+export type HerdrCommandRunner = (command: string, args: string[]) => Promise<HerdrCommandResult>;
+export declare class HerdrCliClient {
+    private readonly runner;
+    constructor(runner?: HerdrCommandRunner);
+    run(args: string[]): Promise<HerdrCommandResult>;
+    runJson(args: string[]): Promise<unknown>;
+}
+export declare function isCommandMissing(error: unknown): boolean;
+//# sourceMappingURL=HerdrCliClient.d.ts.map

package/dist/runtime/herdr/HerdrCliClient.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"HerdrCliClient.d.ts","sourceRoot":"","sources":["../../../src/runtime/herdr/HerdrCliClient.ts"],"names":[],"mappings":"AAOA,MAAM,WAAW,kBAAkB;IACjC,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,MAAM,kBAAkB,GAAG,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,KAAK,OAAO,CAAC,kBAAkB,CAAC,CAAC;AAElG,qBAAa,cAAc;IACb,OAAO,CAAC,QAAQ,CAAC,MAAM;gBAAN,MAAM,GAAE,kBAAkC;IAEvE,GAAG,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,kBAAkB,CAAC;IAI1C,OAAO,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,OAAO,CAAC;CAiBhD;AAED,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,OAAO,GAAG,OAAO,CAOxD"}

package/dist/runtime/herdr/HerdrCliClient.js

@@ -0,0 +1,60 @@
+import { execFile } from "child_process";
+import { promisify } from "util";
+import { HerdrRuntimeError } from "./HerdrErrors.js";
+import { herdrErrorFromResponse } from "./HerdrResponseParsers.js";
+const execFileAsync = promisify(execFile);
+export class HerdrCliClient {
+    runner;
+    constructor(runner = defaultRunner){
+        this.runner = runner;
+    }
+    run(args) {
+        return this.runner("herdr", args);
+    }
+    async runJson(args) {
+        let stdout;
+        try {
+            ({ stdout } = await this.run(args));
+        } catch (error) {
+            throw parseHerdrCommandError(error);
+        }
+        try {
+            const parsed = JSON.parse(stdout);
+            const herdrError = herdrErrorFromResponse(parsed);
+            if (herdrError) throw herdrError;
+            return parsed;
+        } catch (error) {
+            if (error instanceof HerdrRuntimeError) throw error;
+            throw new HerdrRuntimeError(`Herdr returned invalid JSON: ${error.message}`);
+        }
+    }
+}
+export function isCommandMissing(error) {
+    return Boolean(error && typeof error === "object" && "code" in error && error.code === "ENOENT");
+}
+function defaultRunner(command, args) {
+    return execFileAsync(command, args).then(({ stdout, stderr })=>({
+            stdout,
+            stderr
+        }));
+}
+function parseHerdrCommandError(error) {
+    const stdout = typeof error === "object" && error && "stdout" in error ? String(error.stdout ?? "") : "";
+    const stderr = typeof error === "object" && error && "stderr" in error ? String(error.stderr ?? "") : "";
+    const parsed = parseJson(stdout) ?? parseJson(stderr);
+    if (parsed) {
+        const herdrError = herdrErrorFromResponse(parsed);
+        if (herdrError) return herdrError;
+    }
+    return new HerdrRuntimeError(error.message);
+}
+function parseJson(value) {
+    if (!value.trim()) return null;
+    try {
+        return JSON.parse(value);
+    } catch  {
+        return null;
+    }
+}
+
+//# sourceMappingURL=HerdrCliClient.js.map

package/dist/runtime/herdr/HerdrCliClient.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../src/runtime/herdr/HerdrCliClient.ts"],"sourcesContent":["import { execFile } from \"child_process\";\nimport { promisify } from \"util\";\nimport { HerdrRuntimeError } from \"./HerdrErrors.js\";\nimport { herdrErrorFromResponse } from \"./HerdrResponseParsers.js\";\n\nconst execFileAsync = promisify(execFile);\n\nexport interface HerdrCommandResult {\n  stdout: string;\n  stderr: string;\n}\n\nexport type HerdrCommandRunner = (command: string, args: string[]) => Promise<HerdrCommandResult>;\n\nexport class HerdrCliClient {\n  constructor(private readonly runner: HerdrCommandRunner = defaultRunner) {}\n\n  run(args: string[]): Promise<HerdrCommandResult> {\n    return this.runner(\"herdr\", args);\n  }\n\n  async runJson(args: string[]): Promise<unknown> {\n    let stdout: string;\n    try {\n      ({ stdout } = await this.run(args));\n    } catch (error) {\n      throw parseHerdrCommandError(error);\n    }\n    try {\n      const parsed = JSON.parse(stdout) as unknown;\n      const herdrError = herdrErrorFromResponse(parsed);\n      if (herdrError) throw herdrError;\n      return parsed;\n    } catch (error) {\n      if (error instanceof HerdrRuntimeError) throw error;\n      throw new HerdrRuntimeError(`Herdr returned invalid JSON: ${(error as Error).message}`);\n    }\n  }\n}\n\nexport function isCommandMissing(error: unknown): boolean {\n  return Boolean(\n    error &&\n    typeof error === \"object\" &&\n    \"code\" in error &&\n    (error as NodeJS.ErrnoException).code === \"ENOENT\",\n  );\n}\n\nfunction defaultRunner(command: string, args: string[]): Promise<HerdrCommandResult> {\n  return execFileAsync(command, args).then(({ stdout, stderr }) => ({ stdout, stderr }));\n}\n\nfunction parseHerdrCommandError(error: unknown): HerdrRuntimeError {\n  const stdout =\n    typeof error === \"object\" && error && \"stdout\" in error\n      ? String((error as { stdout?: unknown }).stdout ?? \"\")\n      : \"\";\n  const stderr =\n    typeof error === \"object\" && error && \"stderr\" in error\n      ? String((error as { stderr?: unknown }).stderr ?? \"\")\n      : \"\";\n  const parsed = parseJson(stdout) ?? parseJson(stderr);\n  if (parsed) {\n    const herdrError = herdrErrorFromResponse(parsed);\n    if (herdrError) return herdrError;\n  }\n  return new HerdrRuntimeError((error as Error).message);\n}\n\nfunction parseJson(value: string): unknown | null {\n  if (!value.trim()) return null;\n  try {\n    return JSON.parse(value) as unknown;\n  } catch {\n    return null;\n  }\n}\n"],"names":["execFile","promisify","HerdrRuntimeError","herdrErrorFromResponse","execFileAsync","HerdrCliClient","runner","defaultRunner","run","args","runJson","stdout","error","parseHerdrCommandError","parsed","JSON","parse","herdrError","message","isCommandMissing","Boolean","code","command","then","stderr","String","parseJson","value","trim"],"mappings":"AAAA,SAASA,QAAQ,QAAQ,gBAAgB;AACzC,SAASC,SAAS,QAAQ,OAAO;AACjC,SAASC,iBAAiB,QAAQ,mBAAmB;AACrD,SAASC,sBAAsB,QAAQ,4BAA4B;AAEnE,MAAMC,gBAAgBH,UAAUD;AAShC,OAAO,MAAMK;;IACX,YAAY,AAAiBC,SAA6BC,aAAa,CAAE;aAA5CD,SAAAA;IAA6C;IAE1EE,IAAIC,IAAc,EAA+B;QAC/C,OAAO,IAAI,CAACH,MAAM,CAAC,SAASG;IAC9B;IAEA,MAAMC,QAAQD,IAAc,EAAoB;QAC9C,IAAIE;QACJ,IAAI;YACD,CAAA,EAAEA,MAAM,EAAE,GAAG,MAAM,IAAI,CAACH,GAAG,CAACC,KAAI;QACnC,EAAE,OAAOG,OAAO;YACd,MAAMC,uBAAuBD;QAC/B;QACA,IAAI;YACF,MAAME,SAASC,KAAKC,KAAK,CAACL;YAC1B,MAAMM,aAAad,uBAAuBW;YAC1C,IAAIG,YAAY,MAAMA;YACtB,OAAOH;QACT,EAAE,OAAOF,OAAO;YACd,IAAIA,iBAAiBV,mBAAmB,MAAMU;YAC9C,MAAM,IAAIV,kBAAkB,CAAC,6BAA6B,EAAE,AAACU,MAAgBM,OAAO,EAAE;QACxF;IACF;AACF;AAEA,OAAO,SAASC,iBAAiBP,KAAc;IAC7C,OAAOQ,QACLR,SACA,OAAOA,UAAU,YACjB,UAAUA,SACV,AAACA,MAAgCS,IAAI,KAAK;AAE9C;AAEA,SAASd,cAAce,OAAe,EAAEb,IAAc;IACpD,OAAOL,cAAckB,SAASb,MAAMc,IAAI,CAAC,CAAC,EAAEZ,MAAM,EAAEa,MAAM,EAAE,GAAM,CAAA;YAAEb;YAAQa;QAAO,CAAA;AACrF;AAEA,SAASX,uBAAuBD,KAAc;IAC5C,MAAMD,SACJ,OAAOC,UAAU,YAAYA,SAAS,YAAYA,QAC9Ca,OAAO,AAACb,MAA+BD,MAAM,IAAI,MACjD;IACN,MAAMa,SACJ,OAAOZ,UAAU,YAAYA,SAAS,YAAYA,QAC9Ca,OAAO,AAACb,MAA+BY,MAAM,IAAI,MACjD;IACN,MAAMV,SAASY,UAAUf,WAAWe,UAAUF;IAC9C,IAAIV,QAAQ;QACV,MAAMG,aAAad,uBAAuBW;QAC1C,IAAIG,YAAY,OAAOA;IACzB;IACA,OAAO,IAAIf,kBAAkB,AAACU,MAAgBM,OAAO;AACvD;AAEA,SAASQ,UAAUC,KAAa;IAC9B,IAAI,CAACA,MAAMC,IAAI,IAAI,OAAO;IAC1B,IAAI;QACF,OAAOb,KAAKC,KAAK,CAACW;IACpB,EAAE,OAAM;QACN,OAAO;IACT;AACF"}

package/dist/runtime/herdr/HerdrErrors.d.ts

@@ -0,0 +1,7 @@
+export declare class HerdrRuntimeError extends Error {
+    readonly code?: string;
+    constructor(message: string, options?: {
+        code?: string;
+    });
+}
+//# sourceMappingURL=HerdrErrors.d.ts.map

package/dist/runtime/herdr/HerdrErrors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"HerdrErrors.d.ts","sourceRoot":"","sources":["../../../src/runtime/herdr/HerdrErrors.ts"],"names":[],"mappings":"AAAA,qBAAa,iBAAkB,SAAQ,KAAK;IAC1C,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC;gBAEX,OAAO,EAAE,MAAM,EAAE,OAAO,GAAE;QAAE,IAAI,CAAC,EAAE,MAAM,CAAA;KAAO;CAK7D"}

package/dist/runtime/herdr/HerdrErrors.js

@@ -0,0 +1,10 @@
+export class HerdrRuntimeError extends Error {
+    code;
+    constructor(message, options = {}){
+        super(message);
+        this.name = "HerdrRuntimeError";
+        this.code = options.code;
+    }
+}
+
+//# sourceMappingURL=HerdrErrors.js.map

package/dist/runtime/herdr/HerdrErrors.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../src/runtime/herdr/HerdrErrors.ts"],"sourcesContent":["export class HerdrRuntimeError extends Error {\n  readonly code?: string;\n\n  constructor(message: string, options: { code?: string } = {}) {\n    super(message);\n    this.name = \"HerdrRuntimeError\";\n    this.code = options.code;\n  }\n}\n"],"names":["HerdrRuntimeError","Error","code","message","options","name"],"mappings":"AAAA,OAAO,MAAMA,0BAA0BC;IAC5BC,KAAc;IAEvB,YAAYC,OAAe,EAAEC,UAA6B,CAAC,CAAC,CAAE;QAC5D,KAAK,CAACD;QACN,IAAI,CAACE,IAAI,GAAG;QACZ,IAAI,CAACH,IAAI,GAAGE,QAAQF,IAAI;IAC1B;AACF"}

package/dist/runtime/herdr/HerdrResponseParsers.d.ts

@@ -0,0 +1,14 @@
+import { HerdrRuntimeError } from "./HerdrErrors.js";
+import type { HerdrRuntimeRef } from "./HerdrRuntimeRef.js";
+export declare function extractWorkspaceStart(value: unknown): {
+    workspaceId?: string;
+    paneId: string;
+};
+export declare function extractAgentRuntimeRef(value: unknown, fallback: {
+    paneId: string;
+    name: string;
+    workspaceId?: string;
+}): HerdrRuntimeRef;
+export declare function extractProcessInfoPid(value: unknown): number | null;
+export declare function herdrErrorFromResponse(value: unknown): HerdrRuntimeError | null;
+//# sourceMappingURL=HerdrResponseParsers.d.ts.map

package/dist/runtime/herdr/HerdrResponseParsers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"HerdrResponseParsers.d.ts","sourceRoot":"","sources":["../../../src/runtime/herdr/HerdrResponseParsers.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,iBAAiB,EAAE,MAAM,kBAAkB,CAAC;AACrD,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC;AAE5D,wBAAgB,qBAAqB,CAAC,KAAK,EAAE,OAAO,GAAG;IAAE,WAAW,CAAC,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,CAU9F;AAED,wBAAgB,sBAAsB,CACpC,KAAK,EAAE,OAAO,EACd,QAAQ,EAAE;IAAE,MAAM,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC;IAAC,WAAW,CAAC,EAAE,MAAM,CAAA;CAAE,GAC/D,eAAe,CAWjB;AAED,wBAAgB,qBAAqB,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,GAAG,IAAI,CAWnE;AAED,wBAAgB,sBAAsB,CAAC,KAAK,EAAE,OAAO,GAAG,iBAAiB,GAAG,IAAI,CAM/E"}

package/dist/runtime/herdr/HerdrResponseParsers.js

@@ -0,0 +1,96 @@
+import { HerdrRuntimeError } from "./HerdrErrors.js";
+export function extractWorkspaceStart(value) {
+    const workspaceId = getString(value, [
+        "result",
+        "workspace",
+        "workspace_id"
+    ]);
+    const paneId = getString(value, [
+        "result",
+        "root_pane",
+        "pane_id"
+    ]);
+    if (!paneId) {
+        throw new HerdrRuntimeError("Herdr workspace create response did not include root pane id.");
+    }
+    return {
+        ...workspaceId ? {
+            workspaceId
+        } : {},
+        paneId
+    };
+}
+export function extractAgentRuntimeRef(value, fallback) {
+    const agentPaneId = getString(value, [
+        "result",
+        "agent",
+        "pane_id"
+    ]) ?? fallback.paneId;
+    const agentName = getString(value, [
+        "result",
+        "agent",
+        "name"
+    ]) ?? fallback.name;
+    const tabId = getString(value, [
+        "result",
+        "agent",
+        "tab_id"
+    ]);
+    return {
+        session: "default",
+        ...fallback.workspaceId ? {
+            workspaceId: fallback.workspaceId
+        } : {},
+        ...tabId ? {
+            tabId
+        } : {},
+        paneId: agentPaneId,
+        agentName
+    };
+}
+export function extractProcessInfoPid(value) {
+    const processInfo = getObject(value, [
+        "result",
+        "process_info"
+    ]);
+    if (!processInfo) return null;
+    const processes = processInfo.foreground_processes;
+    if (!Array.isArray(processes)) return numberOrNull(processInfo.shell_pid);
+    for (const processInfo of processes){
+        if (!processInfo || typeof processInfo !== "object") continue;
+        const pid = numberOrNull(processInfo.pid);
+        if (pid !== null) return pid;
+    }
+    return numberOrNull(processInfo.shell_pid);
+}
+export function herdrErrorFromResponse(value) {
+    const error = getObject(value, [
+        "error"
+    ]);
+    if (!error) return null;
+    const message = nonEmptyString(error.message) ?? "Herdr command failed.";
+    const code = nonEmptyString(error.code);
+    return new HerdrRuntimeError(message, code ? {
+        code
+    } : {});
+}
+function getObject(value, path) {
+    let current = value;
+    for (const part of path){
+        if (!current || typeof current !== "object" || Array.isArray(current) || !(part in current)) return null;
+        current = current[part];
+    }
+    return current && typeof current === "object" && !Array.isArray(current) ? current : null;
+}
+function getString(value, path) {
+    const parent = getObject(value, path.slice(0, -1));
+    return parent ? nonEmptyString(parent[path[path.length - 1]]) : undefined;
+}
+function nonEmptyString(value) {
+    return typeof value === "string" && value.trim() ? value : undefined;
+}
+function numberOrNull(value) {
+    return typeof value === "number" && Number.isInteger(value) && value > 0 ? value : null;
+}
+
+//# sourceMappingURL=HerdrResponseParsers.js.map

package/dist/runtime/herdr/HerdrResponseParsers.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../src/runtime/herdr/HerdrResponseParsers.ts"],"sourcesContent":["import { HerdrRuntimeError } from \"./HerdrErrors.js\";\nimport type { HerdrRuntimeRef } from \"./HerdrRuntimeRef.js\";\n\nexport function extractWorkspaceStart(value: unknown): { workspaceId?: string; paneId: string } {\n  const workspaceId = getString(value, [\"result\", \"workspace\", \"workspace_id\"]);\n  const paneId = getString(value, [\"result\", \"root_pane\", \"pane_id\"]);\n  if (!paneId) {\n    throw new HerdrRuntimeError(\"Herdr workspace create response did not include root pane id.\");\n  }\n  return {\n    ...(workspaceId ? { workspaceId } : {}),\n    paneId,\n  };\n}\n\nexport function extractAgentRuntimeRef(\n  value: unknown,\n  fallback: { paneId: string; name: string; workspaceId?: string },\n): HerdrRuntimeRef {\n  const agentPaneId = getString(value, [\"result\", \"agent\", \"pane_id\"]) ?? fallback.paneId;\n  const agentName = getString(value, [\"result\", \"agent\", \"name\"]) ?? fallback.name;\n  const tabId = getString(value, [\"result\", \"agent\", \"tab_id\"]);\n  return {\n    session: \"default\",\n    ...(fallback.workspaceId ? { workspaceId: fallback.workspaceId } : {}),\n    ...(tabId ? { tabId } : {}),\n    paneId: agentPaneId,\n    agentName,\n  };\n}\n\nexport function extractProcessInfoPid(value: unknown): number | null {\n  const processInfo = getObject(value, [\"result\", \"process_info\"]);\n  if (!processInfo) return null;\n  const processes = processInfo.foreground_processes;\n  if (!Array.isArray(processes)) return numberOrNull(processInfo.shell_pid);\n  for (const processInfo of processes) {\n    if (!processInfo || typeof processInfo !== \"object\") continue;\n    const pid = numberOrNull((processInfo as { pid?: unknown }).pid);\n    if (pid !== null) return pid;\n  }\n  return numberOrNull(processInfo.shell_pid);\n}\n\nexport function herdrErrorFromResponse(value: unknown): HerdrRuntimeError | null {\n  const error = getObject(value, [\"error\"]);\n  if (!error) return null;\n  const message = nonEmptyString(error.message) ?? \"Herdr command failed.\";\n  const code = nonEmptyString(error.code);\n  return new HerdrRuntimeError(message, code ? { code } : {});\n}\n\nfunction getObject(value: unknown, path: string[]): Record<string, unknown> | null {\n  let current = value;\n  for (const part of path) {\n    if (!current || typeof current !== \"object\" || Array.isArray(current) || !(part in current))\n      return null;\n    current = (current as Record<string, unknown>)[part];\n  }\n  return current && typeof current === \"object\" && !Array.isArray(current)\n    ? (current as Record<string, unknown>)\n    : null;\n}\n\nfunction getString(value: unknown, path: string[]): string | undefined {\n  const parent = getObject(value, path.slice(0, -1));\n  return parent ? nonEmptyString(parent[path[path.length - 1]!]) : undefined;\n}\n\nfunction nonEmptyString(value: unknown): string | undefined {\n  return typeof value === \"string\" && value.trim() ? value : undefined;\n}\n\nfunction numberOrNull(value: unknown): number | null {\n  return typeof value === \"number\" && Number.isInteger(value) && value > 0 ? value : null;\n}\n"],"names":["HerdrRuntimeError","extractWorkspaceStart","value","workspaceId","getString","paneId","extractAgentRuntimeRef","fallback","agentPaneId","agentName","name","tabId","session","extractProcessInfoPid","processInfo","getObject","processes","foreground_processes","Array","isArray","numberOrNull","shell_pid","pid","herdrErrorFromResponse","error","message","nonEmptyString","code","path","current","part","parent","slice","length","undefined","trim","Number","isInteger"],"mappings":"AAAA,SAASA,iBAAiB,QAAQ,mBAAmB;AAGrD,OAAO,SAASC,sBAAsBC,KAAc;IAClD,MAAMC,cAAcC,UAAUF,OAAO;QAAC;QAAU;QAAa;KAAe;IAC5E,MAAMG,SAASD,UAAUF,OAAO;QAAC;QAAU;QAAa;KAAU;IAClE,IAAI,CAACG,QAAQ;QACX,MAAM,IAAIL,kBAAkB;IAC9B;IACA,OAAO;QACL,GAAIG,cAAc;YAAEA;QAAY,IAAI,CAAC,CAAC;QACtCE;IACF;AACF;AAEA,OAAO,SAASC,uBACdJ,KAAc,EACdK,QAAgE;IAEhE,MAAMC,cAAcJ,UAAUF,OAAO;QAAC;QAAU;QAAS;KAAU,KAAKK,SAASF,MAAM;IACvF,MAAMI,YAAYL,UAAUF,OAAO;QAAC;QAAU;QAAS;KAAO,KAAKK,SAASG,IAAI;IAChF,MAAMC,QAAQP,UAAUF,OAAO;QAAC;QAAU;QAAS;KAAS;IAC5D,OAAO;QACLU,SAAS;QACT,GAAIL,SAASJ,WAAW,GAAG;YAAEA,aAAaI,SAASJ,WAAW;QAAC,IAAI,CAAC,CAAC;QACrE,GAAIQ,QAAQ;YAAEA;QAAM,IAAI,CAAC,CAAC;QAC1BN,QAAQG;QACRC;IACF;AACF;AAEA,OAAO,SAASI,sBAAsBX,KAAc;IAClD,MAAMY,cAAcC,UAAUb,OAAO;QAAC;QAAU;KAAe;IAC/D,IAAI,CAACY,aAAa,OAAO;IACzB,MAAME,YAAYF,YAAYG,oBAAoB;IAClD,IAAI,CAACC,MAAMC,OAAO,CAACH,YAAY,OAAOI,aAAaN,YAAYO,SAAS;IACxE,KAAK,MAAMP,eAAeE,UAAW;QACnC,IAAI,CAACF,eAAe,OAAOA,gBAAgB,UAAU;QACrD,MAAMQ,MAAMF,aAAa,AAACN,YAAkCQ,GAAG;QAC/D,IAAIA,QAAQ,MAAM,OAAOA;IAC3B;IACA,OAAOF,aAAaN,YAAYO,SAAS;AAC3C;AAEA,OAAO,SAASE,uBAAuBrB,KAAc;IACnD,MAAMsB,QAAQT,UAAUb,OAAO;QAAC;KAAQ;IACxC,IAAI,CAACsB,OAAO,OAAO;IACnB,MAAMC,UAAUC,eAAeF,MAAMC,OAAO,KAAK;IACjD,MAAME,OAAOD,eAAeF,MAAMG,IAAI;IACtC,OAAO,IAAI3B,kBAAkByB,SAASE,OAAO;QAAEA;IAAK,IAAI,CAAC;AAC3D;AAEA,SAASZ,UAAUb,KAAc,EAAE0B,IAAc;IAC/C,IAAIC,UAAU3B;IACd,KAAK,MAAM4B,QAAQF,KAAM;QACvB,IAAI,CAACC,WAAW,OAAOA,YAAY,YAAYX,MAAMC,OAAO,CAACU,YAAY,CAAEC,CAAAA,QAAQD,OAAM,GACvF,OAAO;QACTA,UAAU,AAACA,OAAmC,CAACC,KAAK;IACtD;IACA,OAAOD,WAAW,OAAOA,YAAY,YAAY,CAACX,MAAMC,OAAO,CAACU,WAC3DA,UACD;AACN;AAEA,SAASzB,UAAUF,KAAc,EAAE0B,IAAc;IAC/C,MAAMG,SAAShB,UAAUb,OAAO0B,KAAKI,KAAK,CAAC,GAAG,CAAC;IAC/C,OAAOD,SAASL,eAAeK,MAAM,CAACH,IAAI,CAACA,KAAKK,MAAM,GAAG,EAAE,CAAE,IAAIC;AACnE;AAEA,SAASR,eAAexB,KAAc;IACpC,OAAO,OAAOA,UAAU,YAAYA,MAAMiC,IAAI,KAAKjC,QAAQgC;AAC7D;AAEA,SAASd,aAAalB,KAAc;IAClC,OAAO,OAAOA,UAAU,YAAYkC,OAAOC,SAAS,CAACnC,UAAUA,QAAQ,IAAIA,QAAQ;AACrF"}

package/dist/runtime/herdr/HerdrRuntimeRef.d.ts

@@ -0,0 +1,9 @@
+export interface HerdrRuntimeRef {
+    session: string;
+    workspaceId?: string;
+    tabId?: string;
+    paneId: string;
+    agentName?: string;
+}
+export declare function parseHerdrRuntimeRef(value: unknown): HerdrRuntimeRef;
+//# sourceMappingURL=HerdrRuntimeRef.d.ts.map

package/dist/runtime/herdr/HerdrRuntimeRef.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"HerdrRuntimeRef.d.ts","sourceRoot":"","sources":["../../../src/runtime/herdr/HerdrRuntimeRef.ts"],"names":[],"mappings":"AAEA,MAAM,WAAW,eAAe;IAC9B,OAAO,EAAE,MAAM,CAAC;IAChB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;IACf,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,wBAAgB,oBAAoB,CAAC,KAAK,EAAE,OAAO,GAAG,eAAe,CA0BpE"}

package/dist/runtime/herdr/HerdrRuntimeRef.js

@@ -0,0 +1,33 @@
+import { HerdrRuntimeError } from "./HerdrErrors.js";
+export function parseHerdrRuntimeRef(value) {
+    if (!value || typeof value !== "object" || Array.isArray(value)) {
+        throw new HerdrRuntimeError("Herdr runtime ref is missing or invalid.");
+    }
+    const ref = value;
+    const session = nonEmptyString(ref.session) ?? "default";
+    const workspaceId = nonEmptyString(ref.workspaceId);
+    const tabId = nonEmptyString(ref.tabId);
+    const paneId = nonEmptyString(ref.paneId);
+    const agentName = nonEmptyString(ref.agentName);
+    if (!paneId) {
+        throw new HerdrRuntimeError("Herdr runtime ref is missing paneId.");
+    }
+    return {
+        session,
+        paneId,
+        ...workspaceId ? {
+            workspaceId
+        } : {},
+        ...tabId ? {
+            tabId
+        } : {},
+        ...agentName ? {
+            agentName
+        } : {}
+    };
+}
+function nonEmptyString(value) {
+    return typeof value === "string" && value.trim() ? value : undefined;
+}
+
+//# sourceMappingURL=HerdrRuntimeRef.js.map

package/dist/runtime/herdr/HerdrRuntimeRef.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../src/runtime/herdr/HerdrRuntimeRef.ts"],"sourcesContent":["import { HerdrRuntimeError } from \"./HerdrErrors.js\";\n\nexport interface HerdrRuntimeRef {\n  session: string;\n  workspaceId?: string;\n  tabId?: string;\n  paneId: string;\n  agentName?: string;\n}\n\nexport function parseHerdrRuntimeRef(value: unknown): HerdrRuntimeRef {\n  if (!value || typeof value !== \"object\" || Array.isArray(value)) {\n    throw new HerdrRuntimeError(\"Herdr runtime ref is missing or invalid.\");\n  }\n  const ref = value as {\n    session?: unknown;\n    workspaceId?: unknown;\n    tabId?: unknown;\n    paneId?: unknown;\n    agentName?: unknown;\n  };\n  const session = nonEmptyString(ref.session) ?? \"default\";\n  const workspaceId = nonEmptyString(ref.workspaceId);\n  const tabId = nonEmptyString(ref.tabId);\n  const paneId = nonEmptyString(ref.paneId);\n  const agentName = nonEmptyString(ref.agentName);\n  if (!paneId) {\n    throw new HerdrRuntimeError(\"Herdr runtime ref is missing paneId.\");\n  }\n  return {\n    session,\n    paneId,\n    ...(workspaceId ? { workspaceId } : {}),\n    ...(tabId ? { tabId } : {}),\n    ...(agentName ? { agentName } : {}),\n  };\n}\n\nfunction nonEmptyString(value: unknown): string | undefined {\n  return typeof value === \"string\" && value.trim() ? value : undefined;\n}\n"],"names":["HerdrRuntimeError","parseHerdrRuntimeRef","value","Array","isArray","ref","session","nonEmptyString","workspaceId","tabId","paneId","agentName","trim","undefined"],"mappings":"AAAA,SAASA,iBAAiB,QAAQ,mBAAmB;AAUrD,OAAO,SAASC,qBAAqBC,KAAc;IACjD,IAAI,CAACA,SAAS,OAAOA,UAAU,YAAYC,MAAMC,OAAO,CAACF,QAAQ;QAC/D,MAAM,IAAIF,kBAAkB;IAC9B;IACA,MAAMK,MAAMH;IAOZ,MAAMI,UAAUC,eAAeF,IAAIC,OAAO,KAAK;IAC/C,MAAME,cAAcD,eAAeF,IAAIG,WAAW;IAClD,MAAMC,QAAQF,eAAeF,IAAII,KAAK;IACtC,MAAMC,SAASH,eAAeF,IAAIK,MAAM;IACxC,MAAMC,YAAYJ,eAAeF,IAAIM,SAAS;IAC9C,IAAI,CAACD,QAAQ;QACX,MAAM,IAAIV,kBAAkB;IAC9B;IACA,OAAO;QACLM;QACAI;QACA,GAAIF,cAAc;YAAEA;QAAY,IAAI,CAAC,CAAC;QACtC,GAAIC,QAAQ;YAAEA;QAAM,IAAI,CAAC,CAAC;QAC1B,GAAIE,YAAY;YAAEA;QAAU,IAAI,CAAC,CAAC;IACpC;AACF;AAEA,SAASJ,eAAeL,KAAc;IACpC,OAAO,OAAOA,UAAU,YAAYA,MAAMU,IAAI,KAAKV,QAAQW;AAC7D"}

package/dist/runtime/tmux/PidPolling.d.ts

@@ -0,0 +1,5 @@
+import type { TmuxManager } from "../../terminal/TmuxManager.js";
+export declare const DEFAULT_PID_POLL_INTERVAL_MS = 500;
+export declare const DEFAULT_PID_POLL_TIMEOUT_MS = 15000;
+export declare function pollForPid(tmux: Pick<TmuxManager, "findAgentPid">, session: string, matches: (psCommand: string) => boolean, intervalMs: number, timeoutMs: number): Promise<number | null>;
+//# sourceMappingURL=PidPolling.d.ts.map

package/dist/runtime/tmux/PidPolling.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"PidPolling.d.ts","sourceRoot":"","sources":["../../../src/runtime/tmux/PidPolling.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,+BAA+B,CAAC;AAEjE,eAAO,MAAM,4BAA4B,MAAM,CAAC;AAChD,eAAO,MAAM,2BAA2B,QAAS,CAAC;AAGlD,wBAAsB,UAAU,CAC9B,IAAI,EAAE,IAAI,CAAC,WAAW,EAAE,cAAc,CAAC,EACvC,OAAO,EAAE,MAAM,EACf,OAAO,EAAE,CAAC,SAAS,EAAE,MAAM,KAAK,OAAO,EACvC,UAAU,EAAE,MAAM,EAClB,SAAS,EAAE,MAAM,GAChB,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAqBxB"}

package/dist/runtime/tmux/PidPolling.js

@@ -0,0 +1,24 @@
+export const DEFAULT_PID_POLL_INTERVAL_MS = 500;
+export const DEFAULT_PID_POLL_TIMEOUT_MS = 15_000;
+const REQUIRED_STABLE_PID_POLLS = 5;
+export async function pollForPid(tmux, session, matches, intervalMs, timeoutMs) {
+    const deadline = Date.now() + timeoutMs;
+    let candidatePid = null;
+    let stablePolls = 0;
+    while(Date.now() < deadline){
+        const pid = await tmux.findAgentPid(session, matches);
+        if (pid !== null) {
+            if (pid === candidatePid) {
+                stablePolls += 1;
+            } else {
+                candidatePid = pid;
+                stablePolls = 1;
+            }
+            if (stablePolls >= REQUIRED_STABLE_PID_POLLS) return pid;
+        }
+        await new Promise((resolve)=>setTimeout(resolve, intervalMs));
+    }
+    return null;
+}
+
+//# sourceMappingURL=PidPolling.js.map

package/dist/runtime/tmux/PidPolling.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../src/runtime/tmux/PidPolling.ts"],"sourcesContent":["import type { TmuxManager } from \"../../terminal/TmuxManager.js\";\n\nexport const DEFAULT_PID_POLL_INTERVAL_MS = 500;\nexport const DEFAULT_PID_POLL_TIMEOUT_MS = 15_000;\nconst REQUIRED_STABLE_PID_POLLS = 5;\n\nexport async function pollForPid(\n  tmux: Pick<TmuxManager, \"findAgentPid\">,\n  session: string,\n  matches: (psCommand: string) => boolean,\n  intervalMs: number,\n  timeoutMs: number,\n): Promise<number | null> {\n  const deadline = Date.now() + timeoutMs;\n  let candidatePid: number | null = null;\n  let stablePolls = 0;\n\n  while (Date.now() < deadline) {\n    const pid = await tmux.findAgentPid(session, matches);\n    if (pid !== null) {\n      if (pid === candidatePid) {\n        stablePolls += 1;\n      } else {\n        candidatePid = pid;\n        stablePolls = 1;\n      }\n\n      if (stablePolls >= REQUIRED_STABLE_PID_POLLS) return pid;\n    }\n    await new Promise((resolve) => setTimeout(resolve, intervalMs));\n  }\n\n  return null;\n}\n"],"names":["DEFAULT_PID_POLL_INTERVAL_MS","DEFAULT_PID_POLL_TIMEOUT_MS","REQUIRED_STABLE_PID_POLLS","pollForPid","tmux","session","matches","intervalMs","timeoutMs","deadline","Date","now","candidatePid","stablePolls","pid","findAgentPid","Promise","resolve","setTimeout"],"mappings":"AAEA,OAAO,MAAMA,+BAA+B,IAAI;AAChD,OAAO,MAAMC,8BAA8B,OAAO;AAClD,MAAMC,4BAA4B;AAElC,OAAO,eAAeC,WACpBC,IAAuC,EACvCC,OAAe,EACfC,OAAuC,EACvCC,UAAkB,EAClBC,SAAiB;IAEjB,MAAMC,WAAWC,KAAKC,GAAG,KAAKH;IAC9B,IAAII,eAA8B;IAClC,IAAIC,cAAc;IAElB,MAAOH,KAAKC,GAAG,KAAKF,SAAU;QAC5B,MAAMK,MAAM,MAAMV,KAAKW,YAAY,CAACV,SAASC;QAC7C,IAAIQ,QAAQ,MAAM;YAChB,IAAIA,QAAQF,cAAc;gBACxBC,eAAe;YACjB,OAAO;gBACLD,eAAeE;gBACfD,cAAc;YAChB;YAEA,IAAIA,eAAeX,2BAA2B,OAAOY;QACvD;QACA,MAAM,IAAIE,QAAQ,CAACC,UAAYC,WAAWD,SAASV;IACrD;IAEA,OAAO;AACT"}

package/dist/runtime/tmux/TmuxAgentRuntime.d.ts

@@ -0,0 +1,17 @@
+import { TmuxManager } from "../../terminal/TmuxManager.js";
+import type { AgentRuntimeAvailability, InteractiveAgentRuntime, RuntimeFocusInput, RuntimeSendDeps, RuntimeSendInput, RuntimeStartInput, RuntimeStartResult, RuntimeStopInput } from "../types.js";
+export declare class TmuxAgentRuntime implements InteractiveAgentRuntime {
+    readonly provider: "tmux";
+    private readonly tmux;
+    constructor(tmux?: TmuxManager);
+    isAvailable(): Promise<AgentRuntimeAvailability>;
+    startAgent(input: RuntimeStartInput & {
+        command?: string;
+        matches?: (psCommand: string) => boolean;
+        pollIntervalMs?: number;
+    }): Promise<RuntimeStartResult>;
+    send(input: RuntimeSendInput, deps?: RuntimeSendDeps): Promise<void>;
+    focus(input: RuntimeFocusInput): Promise<boolean>;
+    stop(input: RuntimeStopInput): Promise<void>;
+}
+//# sourceMappingURL=TmuxAgentRuntime.d.ts.map

package/dist/runtime/tmux/TmuxAgentRuntime.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"TmuxAgentRuntime.d.ts","sourceRoot":"","sources":["../../../src/runtime/tmux/TmuxAgentRuntime.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,+BAA+B,CAAC;AAK5D,OAAO,KAAK,EACV,wBAAwB,EACxB,uBAAuB,EACvB,iBAAiB,EACjB,eAAe,EACf,gBAAgB,EAChB,iBAAiB,EACjB,kBAAkB,EAClB,gBAAgB,EACjB,MAAM,aAAa,CAAC;AAErB,qBAAa,gBAAiB,YAAW,uBAAuB;IAC9D,QAAQ,CAAC,QAAQ,EAAG,MAAM,CAAU;IACpC,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAc;gBAEvB,IAAI,GAAE,WAA+B;IAI3C,WAAW,IAAI,OAAO,CAAC,wBAAwB,CAAC;IAWhD,UAAU,CACd,KAAK,EAAE,iBAAiB,GAAG;QACzB,OAAO,CAAC,EAAE,MAAM,CAAC;QACjB,OAAO,CAAC,EAAE,CAAC,SAAS,EAAE,MAAM,KAAK,OAAO,CAAC;QACzC,cAAc,CAAC,EAAE,MAAM,CAAC;KACzB,GACA,OAAO,CAAC,kBAAkB,CAAC;IA8BxB,IAAI,CAAC,KAAK,EAAE,gBAAgB,EAAE,IAAI,CAAC,EAAE,eAAe,GAAG,OAAO,CAAC,IAAI,CAAC;IAWpE,KAAK,CAAC,KAAK,EAAE,iBAAiB,GAAG,OAAO,CAAC,OAAO,CAAC;IAMjD,IAAI,CAAC,KAAK,EAAE,gBAAgB,GAAG,OAAO,CAAC,IAAI,CAAC;CAenD"}