@knpkv/herdr-connect 0.2.0

package/dist/terminal.d.ts

@@ -0,0 +1,794 @@
+import type { Scope } from "effect";
+import { Crypto, Effect, Stream } from "effect";
+import { ChildProcessSpawner } from "effect/unstable/process";
+import { TerminalAgentNotFoundError, TerminalProtocolError, TerminalTransportError } from "./errors.js";
+import { HerdrTerminalEvent, type TerminalClientCommand, type TerminalSelection } from "./model.js";
+export type TerminalError = TerminalAgentNotFoundError | TerminalProtocolError | TerminalTransportError;
+export interface TerminalSession {
+    readonly events: Stream.Stream<HerdrTerminalEvent, TerminalError>;
+    readonly send: (command: TerminalClientCommand) => Effect.Effect<void, TerminalTransportError>;
+}
+export interface TerminalConnector {
+    readonly open: (selection: TerminalSelection) => Effect.Effect<TerminalSession, TerminalError, Scope.Scope>;
+}
+export declare const terminalStderrMaxBytes: number;
+export declare const terminalEventMaxLineBytes: number;
+/** @internal Exposes copied-byte accounting only for the deterministic complexity regression. */
+export declare const boundedTerminalLines: <E, R>(stream: Stream.Stream<Uint8Array, E, R>, onBufferCopy?: (bytes: number) => void) => Stream.Stream<string, E | TerminalProtocolError, R>;
+export declare const makeHerdrTerminalConnector: (config: {
+    readonly host: string;
+    readonly repository: string;
+    readonly stateDirectory: string;
+    readonly crossHost: boolean;
+    readonly port: number;
+    readonly localPort: number;
+    readonly approvalPort: number;
+    readonly allowedUsers: readonly string[];
+    readonly approvalNodes: readonly string[];
+    readonly machines: readonly {
+        readonly host: string;
+        readonly nodeId: string;
+    }[];
+    readonly applyMachines: readonly string[];
+    readonly checkCommand: readonly string[];
+    readonly applyCommand: readonly string[] | null;
+    readonly browserMcpRecoverCommand: readonly string[] | null;
+    readonly coordinatorCommand: readonly string[];
+    readonly herdrCommand: string;
+    readonly tailscaleCommand: string;
+    readonly approvalTls: {
+        readonly certificatePath: string;
+        readonly privateKeyPath: string;
+    } | null;
+    readonly approvalHub: {
+        readonly host: string;
+        readonly nodeId: string;
+        readonly url: string;
+    };
+    readonly pushAllowedOrigins: readonly string[];
+    readonly pushSubject: string;
+}, service: {
+    submit: (request: {
+        readonly payload: {
+            readonly kind: "nix.check";
+        } | {
+            readonly kind: "nix.apply";
+            readonly ref: string;
+        } | {
+            readonly kind: "agent.delegate";
+            readonly repository: string;
+            readonly prompt: string;
+            readonly mode: "consult" | "review" | "work";
+            readonly channel?: "coordinator_chat";
+        } | {
+            readonly kind: "agent.message";
+            readonly session: string;
+            readonly message: string;
+        } | {
+            readonly kind: "browser.mcp.recover";
+        };
+    }, actor: string) => Effect.Effect<{
+        readonly id: string;
+        readonly createdAt: number;
+        readonly updatedAt: number;
+        readonly actor: string;
+        readonly hash: string;
+        readonly approvalNonce: string | null;
+        readonly approvalExpiresAt?: number | null;
+        readonly approvedBy: string | null;
+        readonly approvedAt?: number | null;
+        readonly rejectedBy?: string | null;
+        readonly rejectedAt?: number | null;
+        readonly expiredAt?: number | null;
+        readonly status: "expired" | "failed" | "interrupted" | "pending_approval" | "queued" | "rejected" | "running" | "succeeded";
+        readonly payload: {
+            readonly kind: "nix.check";
+        } | {
+            readonly kind: "nix.apply";
+            readonly ref: string;
+        } | {
+            readonly kind: "agent.delegate";
+            readonly repository: string;
+            readonly prompt: string;
+            readonly mode: "consult" | "review" | "work";
+            readonly channel?: "coordinator_chat";
+        } | {
+            readonly kind: "agent.message";
+            readonly session: string;
+            readonly message: string;
+        } | {
+            readonly kind: "browser.mcp.recover";
+        };
+        readonly result: string | null;
+        readonly error: string | null;
+        readonly worker?: {
+            readonly host: string;
+            readonly agentId: string;
+            readonly name: string;
+            readonly paneId: string;
+            readonly relationship?: {
+                readonly parentAgentId: string;
+                readonly relation: "delegated" | "pair" | "review";
+            };
+        };
+        readonly connectTarget?: {
+            readonly host: string;
+            readonly agentId: string;
+            readonly url: string;
+        };
+        readonly workerTerminalObservedAt?: number | null;
+    }, import("@knpkv/herdr-fleet").FleetJobConflictError | import("@knpkv/herdr-fleet").FleetOperationError | import("@knpkv/herdr-fleet").FleetStoreError | import("@knpkv/herdr-fleet").FleetValidationError, never>;
+    approve: (jobId: string, approval: import("@knpkv/herdr-fleet").Approval, actor: string) => Effect.Effect<{
+        readonly id: string;
+        readonly createdAt: number;
+        readonly updatedAt: number;
+        readonly actor: string;
+        readonly hash: string;
+        readonly approvalNonce: string | null;
+        readonly approvalExpiresAt?: number | null;
+        readonly approvedBy: string | null;
+        readonly approvedAt?: number | null;
+        readonly rejectedBy?: string | null;
+        readonly rejectedAt?: number | null;
+        readonly expiredAt?: number | null;
+        readonly status: "expired" | "failed" | "interrupted" | "pending_approval" | "queued" | "rejected" | "running" | "succeeded";
+        readonly payload: {
+            readonly kind: "nix.check";
+        } | {
+            readonly kind: "nix.apply";
+            readonly ref: string;
+        } | {
+            readonly kind: "agent.delegate";
+            readonly repository: string;
+            readonly prompt: string;
+            readonly mode: "consult" | "review" | "work";
+            readonly channel?: "coordinator_chat";
+        } | {
+            readonly kind: "agent.message";
+            readonly session: string;
+            readonly message: string;
+        } | {
+            readonly kind: "browser.mcp.recover";
+        };
+        readonly result: string | null;
+        readonly error: string | null;
+        readonly worker?: {
+            readonly host: string;
+            readonly agentId: string;
+            readonly name: string;
+            readonly paneId: string;
+            readonly relationship?: {
+                readonly parentAgentId: string;
+                readonly relation: "delegated" | "pair" | "review";
+            };
+        };
+        readonly connectTarget?: {
+            readonly host: string;
+            readonly agentId: string;
+            readonly url: string;
+        };
+        readonly workerTerminalObservedAt?: number | null;
+    }, import("@knpkv/herdr-fleet").FleetApprovalError | import("@knpkv/herdr-fleet").FleetJobNotFoundError | import("@knpkv/herdr-fleet").FleetStoreError | import("@knpkv/herdr-fleet").FleetTransitionConflictError | import("@knpkv/herdr-fleet").FleetValidationError, never>;
+    reject: (jobId: string, approval: import("@knpkv/herdr-fleet").Approval, actor: string) => Effect.Effect<{
+        readonly id: string;
+        readonly createdAt: number;
+        readonly updatedAt: number;
+        readonly actor: string;
+        readonly hash: string;
+        readonly approvalNonce: string | null;
+        readonly approvalExpiresAt?: number | null;
+        readonly approvedBy: string | null;
+        readonly approvedAt?: number | null;
+        readonly rejectedBy?: string | null;
+        readonly rejectedAt?: number | null;
+        readonly expiredAt?: number | null;
+        readonly status: "expired" | "failed" | "interrupted" | "pending_approval" | "queued" | "rejected" | "running" | "succeeded";
+        readonly payload: {
+            readonly kind: "nix.check";
+        } | {
+            readonly kind: "nix.apply";
+            readonly ref: string;
+        } | {
+            readonly kind: "agent.delegate";
+            readonly repository: string;
+            readonly prompt: string;
+            readonly mode: "consult" | "review" | "work";
+            readonly channel?: "coordinator_chat";
+        } | {
+            readonly kind: "agent.message";
+            readonly session: string;
+            readonly message: string;
+        } | {
+            readonly kind: "browser.mcp.recover";
+        };
+        readonly result: string | null;
+        readonly error: string | null;
+        readonly worker?: {
+            readonly host: string;
+            readonly agentId: string;
+            readonly name: string;
+            readonly paneId: string;
+            readonly relationship?: {
+                readonly parentAgentId: string;
+                readonly relation: "delegated" | "pair" | "review";
+            };
+        };
+        readonly connectTarget?: {
+            readonly host: string;
+            readonly agentId: string;
+            readonly url: string;
+        };
+        readonly workerTerminalObservedAt?: number | null;
+    }, import("@knpkv/herdr-fleet").FleetApprovalError | import("@knpkv/herdr-fleet").FleetJobNotFoundError | import("@knpkv/herdr-fleet").FleetStoreError | import("@knpkv/herdr-fleet").FleetTransitionConflictError | import("@knpkv/herdr-fleet").FleetValidationError, never>;
+    run: (jobId: string) => Effect.Effect<{
+        readonly id: string;
+        readonly createdAt: number;
+        readonly updatedAt: number;
+        readonly actor: string;
+        readonly hash: string;
+        readonly approvalNonce: string | null;
+        readonly approvalExpiresAt?: number | null;
+        readonly approvedBy: string | null;
+        readonly approvedAt?: number | null;
+        readonly rejectedBy?: string | null;
+        readonly rejectedAt?: number | null;
+        readonly expiredAt?: number | null;
+        readonly status: "expired" | "failed" | "interrupted" | "pending_approval" | "queued" | "rejected" | "running" | "succeeded";
+        readonly payload: {
+            readonly kind: "nix.check";
+        } | {
+            readonly kind: "nix.apply";
+            readonly ref: string;
+        } | {
+            readonly kind: "agent.delegate";
+            readonly repository: string;
+            readonly prompt: string;
+            readonly mode: "consult" | "review" | "work";
+            readonly channel?: "coordinator_chat";
+        } | {
+            readonly kind: "agent.message";
+            readonly session: string;
+            readonly message: string;
+        } | {
+            readonly kind: "browser.mcp.recover";
+        };
+        readonly result: string | null;
+        readonly error: string | null;
+        readonly worker?: {
+            readonly host: string;
+            readonly agentId: string;
+            readonly name: string;
+            readonly paneId: string;
+            readonly relationship?: {
+                readonly parentAgentId: string;
+                readonly relation: "delegated" | "pair" | "review";
+            };
+        };
+        readonly connectTarget?: {
+            readonly host: string;
+            readonly agentId: string;
+            readonly url: string;
+        };
+        readonly workerTerminalObservedAt?: number | null;
+    }, import("@knpkv/herdr-fleet").FleetApprovalError | import("@knpkv/herdr-fleet").FleetJobNotFoundError | import("@knpkv/herdr-fleet").FleetStoreError | import("@knpkv/herdr-fleet").FleetTransitionConflictError, never>;
+    runCoordinatorChat: (jobId: string) => Effect.Effect<{
+        readonly id: string;
+        readonly createdAt: number;
+        readonly updatedAt: number;
+        readonly actor: string;
+        readonly hash: string;
+        readonly approvalNonce: string | null;
+        readonly approvalExpiresAt?: number | null;
+        readonly approvedBy: string | null;
+        readonly approvedAt?: number | null;
+        readonly rejectedBy?: string | null;
+        readonly rejectedAt?: number | null;
+        readonly expiredAt?: number | null;
+        readonly status: "expired" | "failed" | "interrupted" | "pending_approval" | "queued" | "rejected" | "running" | "succeeded";
+        readonly payload: {
+            readonly kind: "nix.check";
+        } | {
+            readonly kind: "nix.apply";
+            readonly ref: string;
+        } | {
+            readonly kind: "agent.delegate";
+            readonly repository: string;
+            readonly prompt: string;
+            readonly mode: "consult" | "review" | "work";
+            readonly channel?: "coordinator_chat";
+        } | {
+            readonly kind: "agent.message";
+            readonly session: string;
+            readonly message: string;
+        } | {
+            readonly kind: "browser.mcp.recover";
+        };
+        readonly result: string | null;
+        readonly error: string | null;
+        readonly worker?: {
+            readonly host: string;
+            readonly agentId: string;
+            readonly name: string;
+            readonly paneId: string;
+            readonly relationship?: {
+                readonly parentAgentId: string;
+                readonly relation: "delegated" | "pair" | "review";
+            };
+        };
+        readonly connectTarget?: {
+            readonly host: string;
+            readonly agentId: string;
+            readonly url: string;
+        };
+        readonly workerTerminalObservedAt?: number | null;
+    }, import("@knpkv/herdr-fleet").FleetApprovalError | import("@knpkv/herdr-fleet").FleetJobNotFoundError | import("@knpkv/herdr-fleet").FleetStoreError | import("@knpkv/herdr-fleet").FleetTransitionConflictError | import("@knpkv/herdr-fleet").FleetValidationError, never>;
+    get: (jobId: string) => Effect.Effect<{
+        readonly id: string;
+        readonly createdAt: number;
+        readonly updatedAt: number;
+        readonly actor: string;
+        readonly hash: string;
+        readonly approvalNonce: string | null;
+        readonly approvalExpiresAt?: number | null;
+        readonly approvedBy: string | null;
+        readonly approvedAt?: number | null;
+        readonly rejectedBy?: string | null;
+        readonly rejectedAt?: number | null;
+        readonly expiredAt?: number | null;
+        readonly status: "expired" | "failed" | "interrupted" | "pending_approval" | "queued" | "rejected" | "running" | "succeeded";
+        readonly payload: {
+            readonly kind: "nix.check";
+        } | {
+            readonly kind: "nix.apply";
+            readonly ref: string;
+        } | {
+            readonly kind: "agent.delegate";
+            readonly repository: string;
+            readonly prompt: string;
+            readonly mode: "consult" | "review" | "work";
+            readonly channel?: "coordinator_chat";
+        } | {
+            readonly kind: "agent.message";
+            readonly session: string;
+            readonly message: string;
+        } | {
+            readonly kind: "browser.mcp.recover";
+        };
+        readonly result: string | null;
+        readonly error: string | null;
+        readonly worker?: {
+            readonly host: string;
+            readonly agentId: string;
+            readonly name: string;
+            readonly paneId: string;
+            readonly relationship?: {
+                readonly parentAgentId: string;
+                readonly relation: "delegated" | "pair" | "review";
+            };
+        };
+        readonly connectTarget?: {
+            readonly host: string;
+            readonly agentId: string;
+            readonly url: string;
+        };
+        readonly workerTerminalObservedAt?: number | null;
+    }, import("@knpkv/herdr-fleet").FleetJobNotFoundError | import("@knpkv/herdr-fleet").FleetStoreError, never>;
+    history: (limit: number) => Effect.Effect<{
+        readonly id: string;
+        readonly createdAt: number;
+        readonly updatedAt: number;
+        readonly actor: string;
+        readonly hash: string;
+        readonly approvalNonce: string | null;
+        readonly approvalExpiresAt?: number | null;
+        readonly approvedBy: string | null;
+        readonly approvedAt?: number | null;
+        readonly rejectedBy?: string | null;
+        readonly rejectedAt?: number | null;
+        readonly expiredAt?: number | null;
+        readonly status: "expired" | "failed" | "interrupted" | "pending_approval" | "queued" | "rejected" | "running" | "succeeded";
+        readonly payload: {
+            readonly kind: "nix.check";
+        } | {
+            readonly kind: "nix.apply";
+            readonly ref: string;
+        } | {
+            readonly kind: "agent.delegate";
+            readonly repository: string;
+            readonly prompt: string;
+            readonly mode: "consult" | "review" | "work";
+            readonly channel?: "coordinator_chat";
+        } | {
+            readonly kind: "agent.message";
+            readonly session: string;
+            readonly message: string;
+        } | {
+            readonly kind: "browser.mcp.recover";
+        };
+        readonly result: string | null;
+        readonly error: string | null;
+        readonly worker?: {
+            readonly host: string;
+            readonly agentId: string;
+            readonly name: string;
+            readonly paneId: string;
+            readonly relationship?: {
+                readonly parentAgentId: string;
+                readonly relation: "delegated" | "pair" | "review";
+            };
+        };
+        readonly connectTarget?: {
+            readonly host: string;
+            readonly agentId: string;
+            readonly url: string;
+        };
+        readonly workerTerminalObservedAt?: number | null;
+    }[], import("@knpkv/herdr-fleet").FleetStoreError, never>;
+    historyAfter: (cursor: {
+        readonly createdAt: number;
+        readonly id: string;
+    } | null, limit: number) => Effect.Effect<{
+        readonly id: string;
+        readonly createdAt: number;
+        readonly updatedAt: number;
+        readonly actor: string;
+        readonly hash: string;
+        readonly approvalNonce: string | null;
+        readonly approvalExpiresAt?: number | null;
+        readonly approvedBy: string | null;
+        readonly approvedAt?: number | null;
+        readonly rejectedBy?: string | null;
+        readonly rejectedAt?: number | null;
+        readonly expiredAt?: number | null;
+        readonly status: "expired" | "failed" | "interrupted" | "pending_approval" | "queued" | "rejected" | "running" | "succeeded";
+        readonly payload: {
+            readonly kind: "nix.check";
+        } | {
+            readonly kind: "nix.apply";
+            readonly ref: string;
+        } | {
+            readonly kind: "agent.delegate";
+            readonly repository: string;
+            readonly prompt: string;
+            readonly mode: "consult" | "review" | "work";
+            readonly channel?: "coordinator_chat";
+        } | {
+            readonly kind: "agent.message";
+            readonly session: string;
+            readonly message: string;
+        } | {
+            readonly kind: "browser.mcp.recover";
+        };
+        readonly result: string | null;
+        readonly error: string | null;
+        readonly worker?: {
+            readonly host: string;
+            readonly agentId: string;
+            readonly name: string;
+            readonly paneId: string;
+            readonly relationship?: {
+                readonly parentAgentId: string;
+                readonly relation: "delegated" | "pair" | "review";
+            };
+        };
+        readonly connectTarget?: {
+            readonly host: string;
+            readonly agentId: string;
+            readonly url: string;
+        };
+        readonly workerTerminalObservedAt?: number | null;
+    }[], import("@knpkv/herdr-fleet").FleetStoreError, never>;
+    historyPage: (cursor: {
+        readonly createdAt: number;
+        readonly id: string;
+    } | null, limit: number) => Effect.Effect<{
+        records: {
+            readonly id: string;
+            readonly createdAt: number;
+            readonly updatedAt: number;
+            readonly actor: string;
+            readonly hash: string;
+            readonly approvalNonce: string | null;
+            readonly approvalExpiresAt?: number | null;
+            readonly approvedBy: string | null;
+            readonly approvedAt?: number | null;
+            readonly rejectedBy?: string | null;
+            readonly rejectedAt?: number | null;
+            readonly expiredAt?: number | null;
+            readonly status: "expired" | "failed" | "interrupted" | "pending_approval" | "queued" | "rejected" | "running" | "succeeded";
+            readonly payload: {
+                readonly kind: "nix.check";
+            } | {
+                readonly kind: "nix.apply";
+                readonly ref: string;
+            } | {
+                readonly kind: "agent.delegate";
+                readonly repository: string;
+                readonly prompt: string;
+                readonly mode: "consult" | "review" | "work";
+                readonly channel?: "coordinator_chat";
+            } | {
+                readonly kind: "agent.message";
+                readonly session: string;
+                readonly message: string;
+            } | {
+                readonly kind: "browser.mcp.recover";
+            };
+            readonly result: string | null;
+            readonly error: string | null;
+            readonly worker?: {
+                readonly host: string;
+                readonly agentId: string;
+                readonly name: string;
+                readonly paneId: string;
+                readonly relationship?: {
+                    readonly parentAgentId: string;
+                    readonly relation: "delegated" | "pair" | "review";
+                };
+            };
+            readonly connectTarget?: {
+                readonly host: string;
+                readonly agentId: string;
+                readonly url: string;
+            };
+            readonly workerTerminalObservedAt?: number | null;
+        }[];
+        nextCursor: {
+            readonly createdAt: number;
+            readonly id: string;
+        } | null;
+    }, import("@knpkv/herdr-fleet").FleetStoreError, never>;
+    pendingApprovalPage: (cursor: {
+        readonly createdAt: number;
+        readonly id: string;
+    } | null) => Effect.Effect<{
+        records: {
+            readonly id: string;
+            readonly createdAt: number;
+            readonly updatedAt: number;
+            readonly actor: string;
+            readonly hash: string;
+            readonly approvalNonce: string | null;
+            readonly approvalExpiresAt?: number | null;
+            readonly approvedBy: string | null;
+            readonly approvedAt?: number | null;
+            readonly rejectedBy?: string | null;
+            readonly rejectedAt?: number | null;
+            readonly expiredAt?: number | null;
+            readonly status: "expired" | "failed" | "interrupted" | "pending_approval" | "queued" | "rejected" | "running" | "succeeded";
+            readonly payload: {
+                readonly kind: "nix.check";
+            } | {
+                readonly kind: "nix.apply";
+                readonly ref: string;
+            } | {
+                readonly kind: "agent.delegate";
+                readonly repository: string;
+                readonly prompt: string;
+                readonly mode: "consult" | "review" | "work";
+                readonly channel?: "coordinator_chat";
+            } | {
+                readonly kind: "agent.message";
+                readonly session: string;
+                readonly message: string;
+            } | {
+                readonly kind: "browser.mcp.recover";
+            };
+            readonly result: string | null;
+            readonly error: string | null;
+            readonly worker?: {
+                readonly host: string;
+                readonly agentId: string;
+                readonly name: string;
+                readonly paneId: string;
+                readonly relationship?: {
+                    readonly parentAgentId: string;
+                    readonly relation: "delegated" | "pair" | "review";
+                };
+            };
+            readonly connectTarget?: {
+                readonly host: string;
+                readonly agentId: string;
+                readonly url: string;
+            };
+            readonly workerTerminalObservedAt?: number | null;
+        }[];
+        nextCursor: {
+            createdAt: number;
+            id: string;
+        } | null;
+    }, import("@knpkv/herdr-fleet").FleetJobNotFoundError | import("@knpkv/herdr-fleet").FleetStoreError, never>;
+    pendingApprovals: () => Effect.Effect<{
+        readonly id: string;
+        readonly createdAt: number;
+        readonly updatedAt: number;
+        readonly actor: string;
+        readonly hash: string;
+        readonly approvalNonce: string | null;
+        readonly approvalExpiresAt?: number | null;
+        readonly approvedBy: string | null;
+        readonly approvedAt?: number | null;
+        readonly rejectedBy?: string | null;
+        readonly rejectedAt?: number | null;
+        readonly expiredAt?: number | null;
+        readonly status: "expired" | "failed" | "interrupted" | "pending_approval" | "queued" | "rejected" | "running" | "succeeded";
+        readonly payload: {
+            readonly kind: "nix.check";
+        } | {
+            readonly kind: "nix.apply";
+            readonly ref: string;
+        } | {
+            readonly kind: "agent.delegate";
+            readonly repository: string;
+            readonly prompt: string;
+            readonly mode: "consult" | "review" | "work";
+            readonly channel?: "coordinator_chat";
+        } | {
+            readonly kind: "agent.message";
+            readonly session: string;
+            readonly message: string;
+        } | {
+            readonly kind: "browser.mcp.recover";
+        };
+        readonly result: string | null;
+        readonly error: string | null;
+        readonly worker?: {
+            readonly host: string;
+            readonly agentId: string;
+            readonly name: string;
+            readonly paneId: string;
+            readonly relationship?: {
+                readonly parentAgentId: string;
+                readonly relation: "delegated" | "pair" | "review";
+            };
+        };
+        readonly connectTarget?: {
+            readonly host: string;
+            readonly agentId: string;
+            readonly url: string;
+        };
+        readonly workerTerminalObservedAt?: number | null;
+    }[], import("@knpkv/herdr-fleet").FleetJobNotFoundError | import("@knpkv/herdr-fleet").FleetStoreError, never>;
+    agents: () => Effect.Effect<{
+        readonly agents: readonly {
+            readonly agentId: string | null;
+            readonly activityRevision: number;
+            readonly kind: string;
+            readonly name: string;
+            readonly paneId: string;
+            readonly parentAgentId: string | null;
+            readonly relation: "delegated" | "pair" | "review" | null;
+            readonly status: string;
+            readonly work: string;
+        }[];
+        readonly available: boolean;
+        readonly error: string | null;
+    }, import("@knpkv/herdr-fleet").FleetOperationError, never>;
+    workers: () => Effect.Effect<readonly {
+        readonly host: string;
+        readonly agentId: string;
+        readonly name: string;
+        readonly paneId: string;
+        readonly relationship?: {
+            readonly parentAgentId: string;
+            readonly relation: "delegated" | "pair" | "review";
+        };
+        readonly jobId: string;
+        readonly status: "expired" | "failed" | "interrupted" | "pending_approval" | "queued" | "rejected" | "running" | "succeeded";
+        readonly terminalObservedAt: number | null;
+    }[], import("@knpkv/herdr-fleet").FleetStoreError, never>;
+    status: () => Effect.Effect<{
+        applyConfigured: boolean;
+        branch: string;
+        dirty: boolean;
+        repository: string;
+        revision: string;
+        host: string;
+        herdr: {
+            readonly agents: readonly {
+                readonly agentId: string | null;
+                readonly activityRevision: number;
+                readonly kind: string;
+                readonly name: string;
+                readonly paneId: string;
+                readonly parentAgentId: string | null;
+                readonly relation: "delegated" | "pair" | "review" | null;
+                readonly status: string;
+                readonly work: string;
+            }[];
+            readonly available: boolean;
+            readonly error: string | null;
+        };
+    }, import("@knpkv/herdr-fleet").FleetOperationError, never>;
+    recover: () => Effect.Effect<string[], import("@knpkv/herdr-fleet").FleetStoreError | import("@knpkv/herdr-fleet").FleetTransitionConflictError, never>;
+    abortSubmission: (jobId: string, detail: string) => Effect.Effect<{
+        readonly id: string;
+        readonly createdAt: number;
+        readonly updatedAt: number;
+        readonly actor: string;
+        readonly hash: string;
+        readonly approvalNonce: string | null;
+        readonly approvalExpiresAt?: number | null;
+        readonly approvedBy: string | null;
+        readonly approvedAt?: number | null;
+        readonly rejectedBy?: string | null;
+        readonly rejectedAt?: number | null;
+        readonly expiredAt?: number | null;
+        readonly status: "expired" | "failed" | "interrupted" | "pending_approval" | "queued" | "rejected" | "running" | "succeeded";
+        readonly payload: {
+            readonly kind: "nix.check";
+        } | {
+            readonly kind: "nix.apply";
+            readonly ref: string;
+        } | {
+            readonly kind: "agent.delegate";
+            readonly repository: string;
+            readonly prompt: string;
+            readonly mode: "consult" | "review" | "work";
+            readonly channel?: "coordinator_chat";
+        } | {
+            readonly kind: "agent.message";
+            readonly session: string;
+            readonly message: string;
+        } | {
+            readonly kind: "browser.mcp.recover";
+        };
+        readonly result: string | null;
+        readonly error: string | null;
+        readonly worker?: {
+            readonly host: string;
+            readonly agentId: string;
+            readonly name: string;
+            readonly paneId: string;
+            readonly relationship?: {
+                readonly parentAgentId: string;
+                readonly relation: "delegated" | "pair" | "review";
+            };
+        };
+        readonly connectTarget?: {
+            readonly host: string;
+            readonly agentId: string;
+            readonly url: string;
+        };
+        readonly workerTerminalObservedAt?: number | null;
+    }, import("@knpkv/herdr-fleet").FleetJobNotFoundError | import("@knpkv/herdr-fleet").FleetStoreError | import("@knpkv/herdr-fleet").FleetTransitionConflictError, never>;
+}) => Effect.Effect<{
+    open: (selection: {
+        readonly host: string;
+        readonly agentId: string;
+        readonly cols: number;
+        readonly rows: number;
+    }) => Effect.Effect<{
+        events: Stream.Stream<{
+            readonly type: "terminal.frame";
+            readonly seq: number;
+            readonly encoding: "ansi";
+            readonly width: number;
+            readonly height: number;
+            readonly full: boolean;
+            readonly bytes: string;
+        } | {
+            readonly type: "terminal.closed";
+            readonly reason: string;
+        }, TerminalProtocolError | TerminalTransportError, never>;
+        send: (command: {
+            readonly type: "terminal.input";
+            readonly text: string;
+        } | {
+            readonly type: "terminal.resize";
+            readonly cols: number;
+            readonly rows: number;
+            readonly cell_width_px: number;
+            readonly cell_height_px: number;
+        } | {
+            readonly type: "terminal.release";
+        } | {
+            readonly type: "terminal.scroll";
+            readonly direction: "down" | "up";
+            readonly lines: number;
+            readonly source: "page_key" | "wheel";
+            readonly modifiers: number;
+        }) => Effect.Effect<void, TerminalTransportError, never>;
+    }, TerminalAgentNotFoundError | TerminalTransportError, Scope.Scope>;
+}, never, ChildProcessSpawner.ChildProcessSpawner | Crypto.Crypto>;
+//# sourceMappingURL=terminal.d.ts.map