@codetreker/daynight 0.21.9 → 0.21.13

package/dist/commands/worker/herdr/agents.d.ts

@@ -0,0 +1,186 @@
+import type { Operation } from "../../../api/operation.js";
+import type { WorkerAgent } from "../../../api/types.js";
+import type { HerdrAgentConfiguration } from "./arguments.js";
+import type { HerdrRpcClient } from "./rpc.js";
+export type { HerdrAgentConfiguration } from "./arguments.js";
+export { buildHerdrAgentArguments, validateHerdrAgentArguments } from "./arguments.js";
+export type HerdrExecutionContext = {
+    serverOrigin: string;
+    projectId: string;
+    taskId: string;
+    claimId: string;
+    worktreeId: string;
+    cwd: string;
+    agent: WorkerAgent;
+};
+export type HerdrExecutionOwner = Pick<HerdrExecutionContext, "serverOrigin" | "projectId" | "taskId" | "claimId" | "worktreeId">;
+export type HerdrTaskBinding = {
+    session: string;
+    workspaceId: string;
+    paneId: string;
+    terminalId: string;
+};
+export type HerdrWorkspaceEvidence = {
+    binding: HerdrTaskBinding;
+    ownerLabel: string;
+    environment: HerdrWorkspaceEnvironment;
+};
+export type HerdrPreparedWorkspace = {
+    binding: HerdrTaskBinding;
+    workspaceEvidence: HerdrWorkspaceEvidence | null;
+};
+export type HerdrLaunchEvidence = {
+    binding: HerdrTaskBinding;
+    ownerLabel: string;
+    agent: WorkerAgent;
+    argv: readonly string[];
+    referenceBaseline: "empty";
+    workspaceEvidence: HerdrWorkspaceEvidence;
+};
+export type HerdrNativeReference = {
+    source: string;
+    agent: WorkerAgent;
+    sessionId: string;
+};
+export type HerdrAgentObservation = {
+    binding: HerdrTaskBinding;
+    kind: string | null;
+    name: string | null;
+    status: string;
+    launchPending: boolean;
+    interactiveReady: boolean;
+    nativeSession: HerdrNativeReference | null;
+    stateChangeSeq: number | null;
+    completionSeq: number | null;
+};
+export type HerdrStopObservation = {
+    binding: HerdrTaskBinding;
+    ownerLabel: string;
+    agent: WorkerAgent;
+    nativeSessionId: string | null;
+    shellPid: number;
+    processIds: readonly number[];
+    nativeProcessIds: readonly number[] | null;
+    observedAt: number;
+};
+export type HerdrOwnedWorkspace = {
+    owner: HerdrExecutionOwner;
+    workspaceId: string;
+    panes: {
+        binding: HerdrTaskBinding;
+        cwd: string | null;
+        kind: WorkerAgent | null;
+        status: string;
+        launchPending: boolean;
+        interactiveReady: boolean;
+        nativeSession: HerdrNativeReference | null;
+        stateChangeSeq: number | null;
+        completionSeq: number | null;
+    }[];
+};
+export type HerdrAgentPreflight = {
+    verifyStart(input: {
+        context: HerdrExecutionContext;
+        configuration: HerdrAgentConfiguration;
+        resumeSessionId?: string;
+    }, operation: Operation): Promise<unknown>;
+};
+export type HerdrWorkspaceEnvironment = Readonly<{
+    XDG_CONFIG_HOME: string;
+    XDG_STATE_HOME: string;
+}>;
+export declare const herdrExecutionLabel: (context: HerdrExecutionContext) => string;
+export declare const herdrExecutionAgentName: (context: HerdrExecutionContext) => string;
+export declare const parseHerdrExecutionLabel: (label: string) => HerdrExecutionOwner | null;
+export declare class HerdrAgentActionError extends Error {
+    readonly action: string;
+    readonly submission: "not-submitted" | "rejected" | "unknown";
+    readonly promptSubmission: "not-submitted" | "submitted" | "unknown" | null;
+    readonly launchEvidence: HerdrLaunchEvidence | null;
+    constructor(message: string, action: string, submission: "not-submitted" | "rejected" | "unknown", options?: ErrorOptions & {
+        promptSubmission?: "not-submitted" | "submitted" | "unknown";
+        launchEvidence?: HerdrLaunchEvidence;
+    });
+}
+export declare const createHerdrAgentManager: (options: {
+    rpc: HerdrRpcClient;
+    session: string;
+    preflight: HerdrAgentPreflight;
+    workspaceEnvironment: HerdrWorkspaceEnvironment;
+    processExecuting?: (pid: number) => Promise<boolean>;
+    pollIntervalMs?: number;
+}) => {
+    listResources: (operation: Operation) => Promise<HerdrOwnedWorkspace[]>;
+    prepareWorkspace: (context: HerdrExecutionContext, operation: Operation) => Promise<HerdrPreparedWorkspace>;
+    observe: (context: HerdrExecutionContext, binding: HerdrTaskBinding, operation: Operation) => Promise<HerdrAgentObservation>;
+    start: (context: HerdrExecutionContext, binding: HerdrTaskBinding, input: {
+        configuration: HerdrAgentConfiguration;
+        prompt: string;
+        resumeSessionId?: string;
+        initialPromptNotSubmitted?: true;
+        launchEvidence?: HerdrLaunchEvidence;
+        workspaceEvidence?: HerdrWorkspaceEvidence | null;
+    }, operation: Operation) => Promise<{
+        kind: "rebind-required";
+        reason: "retained-native-reference" | "unverified-launch" | "unverified-workspace-environment";
+        observation: HerdrAgentObservation;
+        promptSubmission: "not-submitted";
+        launchEvidence: null;
+    } | {
+        kind: "reconnected";
+        observation: HerdrAgentObservation;
+        promptSubmission: "not-submitted";
+        launchEvidence: null;
+    } | {
+        kind: "waiting";
+        observation: HerdrAgentObservation;
+        promptSubmission: "not-submitted";
+        launchEvidence: HerdrLaunchEvidence | null;
+    } | {
+        kind: "started";
+        observation: HerdrAgentObservation;
+        promptSubmission: "submitted";
+        launchEvidence: HerdrLaunchEvidence | null;
+    } | {
+        kind: "waiting";
+        observation: HerdrAgentObservation;
+        promptSubmission: "submitted";
+        launchEvidence: HerdrLaunchEvidence | null;
+    }>;
+    submitPrompt: (context: HerdrExecutionContext, binding: HerdrTaskBinding, prompt: string, operation: Operation) => Promise<{
+        submission: "submitted";
+        observation: HerdrAgentObservation;
+    }>;
+    captureStop: (context: HerdrExecutionContext, binding: HerdrTaskBinding, operation: Operation) => Promise<HerdrStopObservation>;
+    requestGracefulStop: (context: HerdrExecutionContext, binding: HerdrTaskBinding, operation: Operation) => Promise<{
+        submission: "submitted";
+        observation: HerdrAgentObservation;
+    }>;
+    confirmEmptyPane: (context: HerdrExecutionContext, binding: HerdrTaskBinding, operation: Operation) => Promise<{
+        noNativeProcess: true;
+    }>;
+    confirmStopped: (context: HerdrExecutionContext, binding: HerdrTaskBinding, evidence: HerdrStopObservation, operation: Operation) => Promise<{
+        agentStopped: true;
+    }>;
+    confirmMissingWorkspaceStopped: (context: HerdrExecutionContext, originalBinding: HerdrTaskBinding, evidence: HerdrStopObservation, operation: Operation) => Promise<{
+        agentStopped: true;
+    }>;
+    confirmRestoredStop: (context: HerdrExecutionContext, originalBinding: HerdrTaskBinding, restoredBinding: HerdrTaskBinding, evidence: HerdrStopObservation, operation: Operation) => Promise<{
+        agentStopped: true;
+        binding: HerdrTaskBinding;
+    }>;
+    confirmReplacedStop: (context: HerdrExecutionContext, originalBinding: HerdrTaskBinding, replacementBinding: HerdrTaskBinding, evidence: HerdrStopObservation, operation: Operation) => Promise<{
+        agentStopped: true;
+        binding: HerdrTaskBinding;
+    }>;
+    forceStop: (context: HerdrExecutionContext, binding: HerdrTaskBinding, evidence: HerdrStopObservation, operation: Operation) => Promise<{
+        agentStopped: true;
+        originalPaneClosed: true;
+    }>;
+    closeWorkspace: (context: HerdrExecutionContext, binding: HerdrTaskBinding, proof: {
+        agentStopped: true;
+    }, operation: Operation) => Promise<{
+        workspaceClosed: true;
+    }>;
+};
+export type HerdrAgentManager = ReturnType<typeof createHerdrAgentManager>;