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

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

@@ -0,0 +1,137 @@
+import { notifyRegisteredMessage, type HerdrTransport } from './collab-notify.js';
+import { type HerdrBootstrapOps } from './collab-bootstrap-transport.js';
+import { type ShellReadinessEvidence } from './shell-readiness.js';
+export declare const COLLAB_BOOTSTRAP_REQUEST_SCHEMA = "pappra/collab-bootstrap-request/1";
+export declare const COLLAB_BOOTSTRAP_REPORT_SCHEMA = "pappra/collab-bootstrap-report/1";
+export type BootstrapAction = 'plan' | 'apply';
+export type BootstrapStatus = 'planned' | 'applied' | 'already_recorded' | 'needs_input' | 'invalid' | 'failed' | 'unknown' | 'reconcile_required';
+export interface VisibleBootstrapRequest {
+    readonly schema: typeof COLLAB_BOOTSTRAP_REQUEST_SCHEMA;
+    /** Optional legacy field in request examples; the CLI action remains authoritative. */
+    readonly action?: 'apply';
+    readonly request_id: string;
+    readonly task_root: string;
+    readonly admission: {
+        readonly assignment_id: string;
+        readonly subtask_id: string;
+        readonly attempt: number;
+        readonly input_revision: string;
+        readonly capability_card_ref: string;
+        readonly capability_card_digest: string;
+    };
+    readonly caller: {
+        readonly require_herdr_env: true;
+        readonly pane_id: string | null;
+    };
+    readonly participant: {
+        readonly agent_id: string;
+        readonly harness: 'pi';
+        readonly native_session_selector: string;
+        readonly herdr_agent?: string;
+        readonly capability_card_ref?: string;
+        readonly capability_card_digest?: string;
+    };
+    readonly target: {
+        readonly choice: 'reuse' | 'sibling';
+        readonly cwd: string;
+        readonly direction?: 'right' | 'down';
+        readonly preserve_focus: true;
+        readonly start_timeout_ms?: number;
+    };
+    readonly selected_model: {
+        readonly preserve_daily: true;
+        readonly openrouter_model?: string;
+    };
+    readonly managed_runtime?: {
+        readonly sdk_module_path: string;
+        readonly journal_path: string;
+        readonly automatic_handoff_file?: string;
+        readonly handoff_context_file?: string;
+    };
+    readonly bootstrap: {
+        readonly config_ref: string;
+        readonly config_digest: string;
+        readonly bundle_ref: string;
+        readonly bundle_digest: string;
+        readonly extension_entry: string;
+    };
+    readonly message_pointer: {
+        readonly message_id: string;
+        readonly content_ref: string;
+        readonly content_digest: string;
+    };
+    /** Required for live routing; remains separate from task authority and the request pointer. */
+    readonly binding_ref?: string;
+    readonly readiness?: {
+        readonly budget_ms?: number;
+        readonly interval_ms?: number;
+        readonly max_samples?: number;
+    };
+}
+export interface LoadedVisibleBootstrapRequest {
+    readonly request: VisibleBootstrapRequest;
+    readonly digest: string;
+    readonly file: string;
+}
+export interface BootstrapStep {
+    readonly step: string;
+    readonly status: string;
+    readonly detail: string | null;
+}
+export interface VisibleBootstrapReport {
+    readonly schema: typeof COLLAB_BOOTSTRAP_REPORT_SCHEMA;
+    readonly action: BootstrapAction;
+    readonly ok: boolean;
+    readonly status: BootstrapStatus;
+    readonly code: string | null;
+    readonly message: string | null;
+    readonly next_action: string | null;
+    readonly request_id: string | null;
+    readonly request_digest: string | null;
+    readonly task_id: string | null;
+    readonly task_root: string | null;
+    readonly state_revision: number | null;
+    readonly caller: Record<string, unknown> | null;
+    readonly participant: Record<string, unknown> | null;
+    readonly target: Record<string, unknown> | null;
+    readonly bootstrap: Record<string, unknown> | null;
+    readonly reservation: Record<string, unknown> | null;
+    readonly readiness: ShellReadinessEvidence | null;
+    readonly effects: readonly BootstrapStep[];
+    readonly notification: Record<string, unknown> | null;
+    readonly downstream: {
+        readonly host_stop_proof: 'unavailable';
+        readonly first_work: 'unverified';
+        readonly routing_removal: 'pending';
+        readonly native_archive: 'unavailable';
+    };
+    readonly limits: readonly string[];
+}
+export interface VisibleBootstrapDependencies {
+    readonly ops?: HerdrBootstrapOps;
+    readonly transport?: HerdrTransport;
+    readonly clock?: () => number;
+    readonly sleeper?: (milliseconds: number) => Promise<void>;
+    readonly signal?: AbortSignal;
+    readonly acceptedArtifactPath?: string;
+    readonly notify?: typeof notifyRegisteredMessage;
+}
+export type BootstrapRequestLoadResult = {
+    readonly ok: true;
+    readonly value: LoadedVisibleBootstrapRequest;
+} | {
+    readonly ok: false;
+    readonly code: string;
+    readonly message: string;
+};
+export declare function validateVisibleBootstrapRequest(value: unknown): {
+    readonly ok: true;
+    readonly request: VisibleBootstrapRequest;
+} | {
+    readonly ok: false;
+    readonly code: string;
+    readonly message: string;
+};
+export declare function loadVisibleBootstrapRequest(file: string): BootstrapRequestLoadResult;
+export declare function planVisibleBootstrap(input: LoadedVisibleBootstrapRequest | VisibleBootstrapRequest, dependencies?: VisibleBootstrapDependencies): Promise<VisibleBootstrapReport>;
+export declare function applyVisibleBootstrap(input: LoadedVisibleBootstrapRequest | VisibleBootstrapRequest, dependencies?: VisibleBootstrapDependencies): Promise<VisibleBootstrapReport>;