@phyzess/pappra 0.1.0-beta.13 → 0.1.0-beta.18

package/dist/app/collab-bootstrap-transport.d.ts

@@ -0,0 +1,163 @@
+import type { CommandRunner, HerdrCallerResult, HerdrListResult, HerdrTransport } from './collab-notify.js';
+export interface BootstrapCommandReceipt {
+    readonly operation: string;
+    readonly argv: readonly string[];
+    readonly code: number | null;
+    readonly signal: string | null;
+    readonly spawned: boolean;
+    readonly timed_out: boolean;
+    readonly spawn_error: string | null;
+    readonly stdout: string;
+    readonly stderr: string;
+}
+export type BootstrapReceiptWriter = (receipt: BootstrapCommandReceipt) => void | Promise<void>;
+export interface BootstrapPaneSnapshot {
+    readonly paneId: string;
+    readonly terminalId: string;
+    readonly workspaceId: string;
+    readonly tabId: string;
+    readonly cwd: string | null;
+    readonly foregroundCwd: string | null;
+    readonly agent: string | null;
+    readonly agentStatus: string;
+    readonly focused: boolean;
+    readonly revision: number;
+}
+export interface BootstrapProcessSnapshot {
+    readonly paneId: string;
+    readonly shellPid: number | null;
+    readonly foregroundProcessGroupId: number | null;
+    readonly tty: string | null;
+    readonly foregroundProcesses: readonly {
+        readonly pid: number;
+        readonly name: string;
+    }[];
+}
+export interface BootstrapStartedAgent {
+    readonly name: string | null;
+    readonly harness: string | null;
+    readonly paneId: string;
+    readonly workspaceId: string;
+    readonly terminalId: string;
+    readonly cwd: string | null;
+    readonly agentStatus: string;
+    readonly interactiveReady: boolean;
+    readonly launchPending: boolean;
+    readonly sessionKind: string | null;
+    readonly sessionValue: string | null;
+    /** Herdr's typed executable argv, excluding raw shell/process output. */
+    readonly argv: readonly string[];
+}
+export interface BootstrapManagedSdkLaunchEvidence {
+    readonly runtime: 'sdk';
+    readonly sdkModulePath: string;
+    readonly bootstrapExtensionPath: string;
+    readonly herdrAgentName: string;
+    readonly journalPath: string;
+    readonly sessionId: string;
+    readonly cwd: string;
+    readonly model: {
+        readonly provider: 'openrouter';
+        readonly id: string;
+    };
+    readonly ready: true;
+}
+/** SDK-native identity is sourced from authenticated managed control, not Herdr's session report. */
+export interface BootstrapStartedManagedSdk {
+    readonly agentName: string;
+    readonly harness: string;
+    readonly paneId: string;
+    readonly cwd: string;
+    readonly status: string;
+    readonly sessionId: string;
+    readonly identityProvenance: 'owned-pi-sdk-control';
+    readonly controlSchema: 'harness-collab/pi-managed-sdk-session/1';
+    readonly processPid: number;
+    readonly socketPeerPid: number;
+    readonly foregroundProcessPid: number;
+    readonly pane: BootstrapPaneSnapshot;
+    readonly launch: BootstrapManagedSdkLaunchEvidence;
+}
+export interface BootstrapManagedSdkStartInput {
+    readonly name: string;
+    readonly paneId: string;
+    readonly workspaceId: string;
+    readonly terminalId: string;
+    readonly cwd: string;
+    readonly sessionId: string;
+    readonly openrouterModel: string;
+    readonly sdkModulePath: string;
+    readonly journalPath: string;
+    readonly controlSocketPath: string;
+    readonly bootstrapExtensionPath: string;
+    readonly configPath: string;
+    readonly configDigest: string;
+    readonly automaticHandoffFile?: string;
+    readonly handoffContextFile?: string;
+    readonly timeoutMs?: number;
+    readonly onReceipt?: BootstrapReceiptWriter;
+}
+export type ManagedSdkStartArgs = readonly ['pane', 'run', string, string];
+/** Fixed current-package SDK start command; only path arguments are data. */
+export declare function managedSdkStartArgs(input: {
+    readonly paneId: string;
+    readonly configPath: string;
+}): ManagedSdkStartArgs;
+export declare function acceptedManagedSdkStartReceipt(receipt: BootstrapCommandReceipt, input: {
+    readonly paneId: string;
+    readonly configPath: string;
+}): boolean;
+export type BootstrapOperationResult<T> = {
+    readonly ok: true;
+    readonly value: T;
+    readonly correlationId: string | null;
+    readonly receipt: BootstrapCommandReceipt;
+} | {
+    readonly ok: false;
+    readonly status: 'failed' | 'unavailable' | 'unknown';
+    readonly code: string;
+    readonly detail: string;
+    readonly correlationId: string | null;
+    readonly receipt: BootstrapCommandReceipt;
+};
+export interface HerdrBootstrapOps {
+    readonly id: string;
+    readonly transport: HerdrTransport;
+    verifyCaller(paneId?: string | null): Promise<HerdrCallerResult>;
+    listAgents(): Promise<HerdrListResult>;
+    paneGet(paneId: string, timeoutMs?: number): Promise<BootstrapOperationResult<BootstrapPaneSnapshot>>;
+    paneProcessInfo(paneId: string, timeoutMs?: number): Promise<BootstrapOperationResult<BootstrapProcessSnapshot>>;
+    splitPane(input: {
+        readonly paneId: string;
+        readonly cwd: string;
+        readonly direction?: 'right' | 'down';
+        readonly timeoutMs?: number;
+        readonly onReceipt?: BootstrapReceiptWriter;
+    }): Promise<BootstrapOperationResult<BootstrapPaneSnapshot>>;
+    startAgent(input: {
+        readonly name: string;
+        readonly paneId: string;
+        readonly sessionId: string;
+        readonly extensionEntry: string;
+        readonly openrouterModel?: string;
+        readonly timeoutMs?: number;
+        readonly onReceipt?: BootstrapReceiptWriter;
+    }): Promise<BootstrapOperationResult<BootstrapStartedAgent>>;
+    /** Queue a fixed managed-SDK CLI command and await authenticated runtime evidence. */
+    startManagedSdk?(input: BootstrapManagedSdkStartInput): Promise<BootstrapOperationResult<BootstrapStartedManagedSdk>>;
+    closePane(input: {
+        readonly paneId: string;
+        readonly timeoutMs?: number;
+        readonly onReceipt?: BootstrapReceiptWriter;
+    }): Promise<BootstrapOperationResult<{
+        readonly paneId: string;
+        readonly closed: true;
+    }>>;
+}
+export declare function createHerdrBootstrapOps(options?: {
+    readonly env?: NodeJS.ProcessEnv;
+    readonly run?: CommandRunner;
+    readonly transport?: HerdrTransport;
+    readonly taskRoot?: string;
+    readonly peerPid?: (socketPath: string) => number | null;
+}): HerdrBootstrapOps;