@ai-devkit/agent-manager 0.32.0 → 0.33.1

package/dist/runtime/herdr/HerdrAgentDiscovery.js

@@ -0,0 +1,183 @@
+import { HerdrCliClient } from "./HerdrCliClient.js";
+export async function fetchHerdrAgentPanes(runner) {
+    const client = new HerdrCliClient(runner);
+    const response = await client.runJson([
+        "pane",
+        "list"
+    ]);
+    return enrichHerdrAgentPanes(client, extractHerdrAgentPanes(response));
+}
+export function extractHerdrAgentPanes(value) {
+    const snapshot = getObject(value, [
+        "result",
+        "snapshot"
+    ]);
+    const rawPanes = getArray(value, [
+        "result",
+        "panes"
+    ]) ?? snapshot?.agents;
+    if (!Array.isArray(rawPanes)) return [];
+    const panes = [];
+    for (const rawPane of rawPanes){
+        if (!rawPane || typeof rawPane !== "object" || Array.isArray(rawPane)) continue;
+        const pane = rawPane;
+        const agent = nonEmptyString(pane.agent);
+        const paneId = nonEmptyString(pane.pane_id);
+        if (!agent || !paneId) continue;
+        const session = getObject(pane, [
+            "agent_session"
+        ]);
+        const agentSessionId = nonEmptyString(session?.value);
+        const cwd = nonEmptyString(pane.cwd);
+        const workspaceId = nonEmptyString(pane.workspace_id);
+        const tabId = nonEmptyString(pane.tab_id);
+        panes.push({
+            agent,
+            paneId,
+            ...agentSessionId ? {
+                agentSessionId
+            } : {},
+            ...cwd ? {
+                cwd
+            } : {},
+            ...workspaceId ? {
+                workspaceId
+            } : {},
+            ...tabId ? {
+                tabId
+            } : {}
+        });
+    }
+    return panes;
+}
+export function findMatchingHerdrPane(agent, panes) {
+    if (agent.sessionId) {
+        const sessionMatches = panes.filter((pane)=>pane.agentSessionId === agent.sessionId);
+        if (sessionMatches.length === 1) return sessionMatches[0];
+        if (sessionMatches.length > 1) return null;
+    }
+    const foregroundPidMatches = panes.filter((pane)=>pane.foregroundPids?.includes(agent.pid));
+    if (foregroundPidMatches.length === 1) return foregroundPidMatches[0];
+    if (foregroundPidMatches.length > 1) return null;
+    const shellPidMatches = panes.filter((pane)=>pane.shellPid === agent.pid);
+    if (shellPidMatches.length === 1) return shellPidMatches[0];
+    if (shellPidMatches.length > 1) return null;
+    const cwdMatches = panes.filter((pane)=>pane.cwd === agent.projectPath && herdrAgentMatchesType(pane.agent, agent.type));
+    return cwdMatches.length === 1 ? cwdMatches[0] : null;
+}
+export function herdrPaneToRuntimeRef(pane, agentName) {
+    return {
+        session: "default",
+        paneId: pane.paneId,
+        agentName,
+        ...pane.workspaceId ? {
+            workspaceId: pane.workspaceId
+        } : {},
+        ...pane.tabId ? {
+            tabId: pane.tabId
+        } : {}
+    };
+}
+function herdrAgentMatchesType(herdrAgent, agentType) {
+    const normalized = herdrAgent.toLowerCase();
+    const candidates = {
+        claude: [
+            "claude"
+        ],
+        codex: [
+            "codex"
+        ],
+        copilot: [
+            "copilot"
+        ],
+        gemini_cli: [
+            "gemini",
+            "gemini_cli"
+        ],
+        grok_cli: [
+            "grok",
+            "grok_cli"
+        ],
+        opencode: [
+            "opencode"
+        ],
+        pi: [
+            "pi"
+        ],
+        other: [
+            "other"
+        ]
+    };
+    return candidates[agentType]?.includes(normalized) ?? false;
+}
+async function enrichHerdrAgentPanes(client, panes) {
+    return Promise.all(panes.map(async (pane)=>{
+        try {
+            const response = await client.runJson([
+                "pane",
+                "process-info",
+                "--pane",
+                pane.paneId
+            ]);
+            return {
+                ...pane,
+                ...extractPaneProcessIds(response)
+            };
+        } catch  {
+            return pane;
+        }
+    }));
+}
+function extractPaneProcessIds(value) {
+    const processInfo = getObject(value, [
+        "result",
+        "process_info"
+    ]);
+    if (!processInfo) return {};
+    const foregroundProcesses = processInfo.foreground_processes;
+    const foregroundPids = [];
+    if (Array.isArray(foregroundProcesses)) {
+        for (const foregroundProcess of foregroundProcesses){
+            if (!foregroundProcess || typeof foregroundProcess !== "object" || Array.isArray(foregroundProcess)) continue;
+            const pid = positiveIntegerOrNull(foregroundProcess.pid);
+            if (pid !== null) foregroundPids.push(pid);
+        }
+    }
+    const shellPid = positiveIntegerOrNull(processInfo.shell_pid);
+    return {
+        ...foregroundPids.length > 0 ? {
+            foregroundPids
+        } : {},
+        ...shellPid !== null ? {
+            shellPid
+        } : {}
+    };
+}
+function getArray(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 Array.isArray(current) ? current : null;
+}
+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 nonEmptyString(value) {
+    return typeof value === "string" && value.trim() ? value : undefined;
+}
+function positiveIntegerOrNull(value) {
+    return typeof value === "number" && Number.isInteger(value) && value > 0 ? value : null;
+}
+
+//# sourceMappingURL=HerdrAgentDiscovery.js.map

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

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../src/runtime/herdr/HerdrAgentDiscovery.ts"],"sourcesContent":["import type { AgentInfo, AgentType } from \"../../adapters/AgentAdapter.js\";\nimport { HerdrCliClient, type HerdrCommandRunner } from \"./HerdrCliClient.js\";\nimport type { HerdrRuntimeRef } from \"./HerdrRuntimeRef.js\";\n\nexport interface HerdrAgentPane {\n  agent: string;\n  agentSessionId?: string;\n  cwd?: string;\n  paneId: string;\n  workspaceId?: string;\n  tabId?: string;\n  foregroundPids?: number[];\n  shellPid?: number;\n}\n\nexport async function fetchHerdrAgentPanes(runner?: HerdrCommandRunner): Promise<HerdrAgentPane[]> {\n  const client = new HerdrCliClient(runner);\n  const response = await client.runJson([\"pane\", \"list\"]);\n  return enrichHerdrAgentPanes(client, extractHerdrAgentPanes(response));\n}\n\nexport function extractHerdrAgentPanes(value: unknown): HerdrAgentPane[] {\n  const snapshot = getObject(value, [\"result\", \"snapshot\"]);\n  const rawPanes = getArray(value, [\"result\", \"panes\"]) ?? snapshot?.agents;\n  if (!Array.isArray(rawPanes)) return [];\n\n  const panes: HerdrAgentPane[] = [];\n  for (const rawPane of rawPanes) {\n    if (!rawPane || typeof rawPane !== \"object\" || Array.isArray(rawPane)) continue;\n    const pane = rawPane as Record<string, unknown>;\n    const agent = nonEmptyString(pane.agent);\n    const paneId = nonEmptyString(pane.pane_id);\n    if (!agent || !paneId) continue;\n\n    const session = getObject(pane, [\"agent_session\"]);\n    const agentSessionId = nonEmptyString(session?.value);\n    const cwd = nonEmptyString(pane.cwd);\n    const workspaceId = nonEmptyString(pane.workspace_id);\n    const tabId = nonEmptyString(pane.tab_id);\n\n    panes.push({\n      agent,\n      paneId,\n      ...(agentSessionId ? { agentSessionId } : {}),\n      ...(cwd ? { cwd } : {}),\n      ...(workspaceId ? { workspaceId } : {}),\n      ...(tabId ? { tabId } : {}),\n    });\n  }\n\n  return panes;\n}\n\nexport function findMatchingHerdrPane(\n  agent: Pick<AgentInfo, \"type\" | \"projectPath\" | \"sessionId\" | \"pid\">,\n  panes: readonly HerdrAgentPane[],\n): HerdrAgentPane | null {\n  if (agent.sessionId) {\n    const sessionMatches = panes.filter((pane) => pane.agentSessionId === agent.sessionId);\n    if (sessionMatches.length === 1) return sessionMatches[0]!;\n    if (sessionMatches.length > 1) return null;\n  }\n\n  const foregroundPidMatches = panes.filter((pane) => pane.foregroundPids?.includes(agent.pid));\n  if (foregroundPidMatches.length === 1) return foregroundPidMatches[0]!;\n  if (foregroundPidMatches.length > 1) return null;\n\n  const shellPidMatches = panes.filter((pane) => pane.shellPid === agent.pid);\n  if (shellPidMatches.length === 1) return shellPidMatches[0]!;\n  if (shellPidMatches.length > 1) return null;\n\n  const cwdMatches = panes.filter(\n    (pane) => pane.cwd === agent.projectPath && herdrAgentMatchesType(pane.agent, agent.type),\n  );\n  return cwdMatches.length === 1 ? cwdMatches[0]! : null;\n}\n\nexport function herdrPaneToRuntimeRef(pane: HerdrAgentPane, agentName: string): HerdrRuntimeRef {\n  return {\n    session: \"default\",\n    paneId: pane.paneId,\n    agentName,\n    ...(pane.workspaceId ? { workspaceId: pane.workspaceId } : {}),\n    ...(pane.tabId ? { tabId: pane.tabId } : {}),\n  };\n}\n\nfunction herdrAgentMatchesType(herdrAgent: string, agentType: AgentType): boolean {\n  const normalized = herdrAgent.toLowerCase();\n  const candidates: Record<AgentType, readonly string[]> = {\n    claude: [\"claude\"],\n    codex: [\"codex\"],\n    copilot: [\"copilot\"],\n    gemini_cli: [\"gemini\", \"gemini_cli\"],\n    grok_cli: [\"grok\", \"grok_cli\"],\n    opencode: [\"opencode\"],\n    pi: [\"pi\"],\n    other: [\"other\"],\n  };\n  return candidates[agentType]?.includes(normalized) ?? false;\n}\n\nasync function enrichHerdrAgentPanes(\n  client: HerdrCliClient,\n  panes: HerdrAgentPane[],\n): Promise<HerdrAgentPane[]> {\n  return Promise.all(\n    panes.map(async (pane) => {\n      try {\n        const response = await client.runJson([\"pane\", \"process-info\", \"--pane\", pane.paneId]);\n        return {\n          ...pane,\n          ...extractPaneProcessIds(response),\n        };\n      } catch {\n        return pane;\n      }\n    }),\n  );\n}\n\nfunction extractPaneProcessIds(value: unknown): Pick<HerdrAgentPane, \"foregroundPids\" | \"shellPid\"> {\n  const processInfo = getObject(value, [\"result\", \"process_info\"]);\n  if (!processInfo) return {};\n\n  const foregroundProcesses = processInfo.foreground_processes;\n  const foregroundPids: number[] = [];\n  if (Array.isArray(foregroundProcesses)) {\n    for (const foregroundProcess of foregroundProcesses) {\n      if (\n        !foregroundProcess ||\n        typeof foregroundProcess !== \"object\" ||\n        Array.isArray(foregroundProcess)\n      )\n        continue;\n      const pid = positiveIntegerOrNull((foregroundProcess as { pid?: unknown }).pid);\n      if (pid !== null) foregroundPids.push(pid);\n    }\n  }\n  const shellPid = positiveIntegerOrNull(processInfo.shell_pid);\n\n  return {\n    ...(foregroundPids.length > 0 ? { foregroundPids } : {}),\n    ...(shellPid !== null ? { shellPid } : {}),\n  };\n}\n\nfunction getArray(value: unknown, path: 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    }\n    current = (current as Record<string, unknown>)[part];\n  }\n  return Array.isArray(current) ? current : null;\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    }\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 nonEmptyString(value: unknown): string | undefined {\n  return typeof value === \"string\" && value.trim() ? value : undefined;\n}\n\nfunction positiveIntegerOrNull(value: unknown): number | null {\n  return typeof value === \"number\" && Number.isInteger(value) && value > 0 ? value : null;\n}\n"],"names":["HerdrCliClient","fetchHerdrAgentPanes","runner","client","response","runJson","enrichHerdrAgentPanes","extractHerdrAgentPanes","value","snapshot","getObject","rawPanes","getArray","agents","Array","isArray","panes","rawPane","pane","agent","nonEmptyString","paneId","pane_id","session","agentSessionId","cwd","workspaceId","workspace_id","tabId","tab_id","push","findMatchingHerdrPane","sessionId","sessionMatches","filter","length","foregroundPidMatches","foregroundPids","includes","pid","shellPidMatches","shellPid","cwdMatches","projectPath","herdrAgentMatchesType","type","herdrPaneToRuntimeRef","agentName","herdrAgent","agentType","normalized","toLowerCase","candidates","claude","codex","copilot","gemini_cli","grok_cli","opencode","pi","other","Promise","all","map","extractPaneProcessIds","processInfo","foregroundProcesses","foreground_processes","foregroundProcess","positiveIntegerOrNull","shell_pid","path","current","part","trim","undefined","Number","isInteger"],"mappings":"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"}

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

@@ -0,0 +1,36 @@
+import { type HerdrCommandRunner } from "./HerdrCliClient.js";
+import type { AgentRuntimeAvailability, InteractiveAgentRuntime, RuntimeFocusInput, RuntimeSendInput, RuntimeStartInput, RuntimeStartResult, RuntimeStopInput } from "../types.js";
+export interface HerdrRuntimeOptions {
+    runner?: HerdrCommandRunner;
+    env?: NodeJS.ProcessEnv;
+    agentStartBusyRetryMs?: number;
+    agentStartBusyRetryIntervalMs?: number;
+    processInfoPollMs?: number;
+    processInfoPollIntervalMs?: number;
+}
+export declare class HerdrAgentRuntime implements InteractiveAgentRuntime {
+    readonly provider: "herdr";
+    private readonly client;
+    private readonly env;
+    private readonly agentStartBusyRetryMs;
+    private readonly agentStartBusyRetryIntervalMs;
+    private readonly processInfoPollMs;
+    private readonly processInfoPollIntervalMs;
+    constructor(options?: HerdrRuntimeOptions);
+    isAvailable(): Promise<AgentRuntimeAvailability>;
+    startAgent(input: RuntimeStartInput): Promise<RuntimeStartResult>;
+    send(input: RuntimeSendInput): Promise<void>;
+    wait(input: {
+        runtimeRef: unknown;
+        timeoutMs: number;
+    }): Promise<void>;
+    readOutput(input: {
+        runtimeRef: unknown;
+        lines?: number;
+    }): Promise<string>;
+    focus(input: RuntimeFocusInput): Promise<boolean>;
+    stop(input: RuntimeStopInput): Promise<void>;
+    private runAgentStartJson;
+    private readStartedAgentPid;
+}
+//# sourceMappingURL=HerdrAgentRuntime.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"HerdrAgentRuntime.d.ts","sourceRoot":"","sources":["../../../src/runtime/herdr/HerdrAgentRuntime.ts"],"names":[],"mappings":"AAAA,OAAO,EAAoC,KAAK,kBAAkB,EAAE,MAAM,qBAAqB,CAAC;AAShG,OAAO,KAAK,EACV,wBAAwB,EACxB,uBAAuB,EACvB,iBAAiB,EACjB,gBAAgB,EAChB,iBAAiB,EACjB,kBAAkB,EAClB,gBAAgB,EACjB,MAAM,aAAa,CAAC;AAOrB,MAAM,WAAW,mBAAmB;IAClC,MAAM,CAAC,EAAE,kBAAkB,CAAC;IAC5B,GAAG,CAAC,EAAE,MAAM,CAAC,UAAU,CAAC;IACxB,qBAAqB,CAAC,EAAE,MAAM,CAAC;IAC/B,6BAA6B,CAAC,EAAE,MAAM,CAAC;IACvC,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,yBAAyB,CAAC,EAAE,MAAM,CAAC;CACpC;AAED,qBAAa,iBAAkB,YAAW,uBAAuB;IAC/D,QAAQ,CAAC,QAAQ,EAAG,OAAO,CAAU;IAErC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAiB;IACxC,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAoB;IACxC,OAAO,CAAC,QAAQ,CAAC,qBAAqB,CAAS;IAC/C,OAAO,CAAC,QAAQ,CAAC,6BAA6B,CAAS;IACvD,OAAO,CAAC,QAAQ,CAAC,iBAAiB,CAAS;IAC3C,OAAO,CAAC,QAAQ,CAAC,yBAAyB,CAAS;gBAEvC,OAAO,GAAE,mBAAwB;IAWvC,WAAW,IAAI,OAAO,CAAC,wBAAwB,CAAC;IAoChD,UAAU,CAAC,KAAK,EAAE,iBAAiB,GAAG,OAAO,CAAC,kBAAkB,CAAC;IA6BjE,IAAI,CAAC,KAAK,EAAE,gBAAgB,GAAG,OAAO,CAAC,IAAI,CAAC;IAK5C,IAAI,CAAC,KAAK,EAAE;QAAE,UAAU,EAAE,OAAO,CAAC;QAAC,SAAS,EAAE,MAAM,CAAA;KAAE,GAAG,OAAO,CAAC,IAAI,CAAC;IAetE,UAAU,CAAC,KAAK,EAAE;QAAE,UAAU,EAAE,OAAO,CAAC;QAAC,KAAK,CAAC,EAAE,MAAM,CAAA;KAAE,GAAG,OAAO,CAAC,MAAM,CAAC;IAc3E,KAAK,CAAC,KAAK,EAAE,iBAAiB,GAAG,OAAO,CAAC,OAAO,CAAC;IAMjD,IAAI,CAAC,KAAK,EAAE,gBAAgB,GAAG,OAAO,CAAC,IAAI,CAAC;YAKpC,iBAAiB;YAqBjB,mBAAmB;CAqBlC"}

package/dist/runtime/herdr/HerdrAgentRuntime.js

@@ -0,0 +1,202 @@
+import { HerdrCliClient, isCommandMissing } from "./HerdrCliClient.js";
+import { HerdrRuntimeError } from "./HerdrErrors.js";
+import { parseHerdrRuntimeRef } from "./HerdrRuntimeRef.js";
+import { extractAgentRuntimeRef, extractForegroundProcessInfoPid, extractProcessInfoPid, extractWorkspaceStart } from "./HerdrResponseParsers.js";
+const AGENT_START_BUSY_RETRY_MS = 5000;
+const AGENT_START_BUSY_RETRY_INTERVAL_MS = 100;
+const PROCESS_INFO_POLL_MS = 3000;
+const PROCESS_INFO_POLL_INTERVAL_MS = 100;
+export class HerdrAgentRuntime {
+    provider = "herdr";
+    client;
+    env;
+    agentStartBusyRetryMs;
+    agentStartBusyRetryIntervalMs;
+    processInfoPollMs;
+    processInfoPollIntervalMs;
+    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;
+        this.processInfoPollMs = options.processInfoPollMs ?? PROCESS_INFO_POLL_MS;
+        this.processInfoPollIntervalMs = options.processInfoPollIntervalMs ?? PROCESS_INFO_POLL_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 pid = await this.readStartedAgentPid(runtimeRef.paneId);
+        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"
+        });
+    }
+    async readStartedAgentPid(paneId) {
+        const deadline = Date.now() + this.processInfoPollMs;
+        let fallbackPid = null;
+        do {
+            const processInfoResponse = await this.client.runJson([
+                "pane",
+                "process-info",
+                "--pane",
+                paneId
+            ]);
+            const foregroundPid = extractForegroundProcessInfoPid(processInfoResponse);
+            if (foregroundPid !== null) return foregroundPid;
+            fallbackPid ??= extractProcessInfoPid(processInfoResponse);
+            if (Date.now() >= deadline) break;
+            await sleep(this.processInfoPollIntervalMs);
+        }while (Date.now() < deadline)
+        return fallbackPid;
+    }
+}
+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  extractForegroundProcessInfoPid,\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;\nconst PROCESS_INFO_POLL_MS = 3000;\nconst PROCESS_INFO_POLL_INTERVAL_MS = 100;\n\nexport interface HerdrRuntimeOptions {\n  runner?: HerdrCommandRunner;\n  env?: NodeJS.ProcessEnv;\n  agentStartBusyRetryMs?: number;\n  agentStartBusyRetryIntervalMs?: number;\n  processInfoPollMs?: number;\n  processInfoPollIntervalMs?: 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  private readonly processInfoPollMs: number;\n  private readonly processInfoPollIntervalMs: 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    this.processInfoPollMs = options.processInfoPollMs ?? PROCESS_INFO_POLL_MS;\n    this.processInfoPollIntervalMs =\n      options.processInfoPollIntervalMs ?? PROCESS_INFO_POLL_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 pid = await this.readStartedAgentPid(runtimeRef.paneId);\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  private async readStartedAgentPid(paneId: string): Promise<number | null> {\n    const deadline = Date.now() + this.processInfoPollMs;\n    let fallbackPid: number | null = null;\n\n    do {\n      const processInfoResponse = await this.client.runJson([\n        \"pane\",\n        \"process-info\",\n        \"--pane\",\n        paneId,\n      ]);\n      const foregroundPid = extractForegroundProcessInfoPid(processInfoResponse);\n      if (foregroundPid !== null) return foregroundPid;\n      fallbackPid ??= extractProcessInfoPid(processInfoResponse);\n\n      if (Date.now() >= deadline) break;\n      await sleep(this.processInfoPollIntervalMs);\n    } while (Date.now() < deadline);\n\n    return fallbackPid;\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","extractForegroundProcessInfoPid","extractProcessInfoPid","extractWorkspaceStart","AGENT_START_BUSY_RETRY_MS","AGENT_START_BUSY_RETRY_INTERVAL_MS","PROCESS_INFO_POLL_MS","PROCESS_INFO_POLL_INTERVAL_MS","HerdrAgentRuntime","provider","client","env","agentStartBusyRetryMs","agentStartBusyRetryIntervalMs","processInfoPollMs","processInfoPollIntervalMs","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","pid","readStartedAgentPid","send","ref","prompt","wait","readOutput","stdout","lines","focus","stop","deadline","Date","now","lastBusyError","code","sleep","fallbackPid","processInfoResponse","foregroundPid","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,16 @@
+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 extractForegroundProcessInfoPid(value: unknown): number | null;
+export declare function extractShellPid(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,CAEnE;AAED,wBAAgB,+BAA+B,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,GAAG,IAAI,CAW7E;AAED,wBAAgB,eAAe,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,GAAG,IAAI,CAI7D;AAED,wBAAgB,sBAAsB,CAAC,KAAK,EAAE,OAAO,GAAG,iBAAiB,GAAG,IAAI,CAM/E"}