@phyzess/pappra 0.0.0-stage → 0.1.0-beta.2

package/dist/hosts/pi/rpc.d.ts

@@ -0,0 +1,937 @@
+import type { Identity } from '../../collab/types.js';
+export interface PiOptions {
+    taskRoot: string;
+    cwd: string;
+    assignmentFile: string;
+    capabilitiesFile: string;
+    promptFile: string;
+    evidenceDir: string;
+    namespaceGuard?: () => void;
+    sessionDir?: string;
+    outputName?: string;
+    profile?: string;
+    phase?: string;
+    resume?: string;
+    sessionId?: string;
+    launchKind?: string;
+    discovery?: boolean;
+    trustProject?: boolean;
+    piBin?: string;
+    action?: string;
+    requestTimeoutMs?: number;
+    operationTimeoutMs?: number;
+    shutdownTimeoutMs?: number;
+    settleTimeoutMs?: number;
+    signalGraceMs?: number;
+    streamCloseGraceMs?: number;
+    maxBytes?: number;
+    maxAgeMinutes?: number;
+    clock?: number;
+}
+export interface PiFinish {
+    ok: boolean;
+    schema: string;
+    reason: string | null;
+    detail: string | null;
+    outcome: string;
+    [key: string]: unknown;
+}
+/** A classified refusal: `code` is stable, `status` is `invalid` | `needs_input` | `failed`. */
+export declare class PiRpcRefusal extends Error {
+    readonly code: string;
+    readonly status: string;
+    readonly detail: string | null;
+    constructor(code: string, status?: string, detail?: string | null);
+}
+/**
+ * Start exactly one owned Pi RPC child under the same admission/reservation gates as the native
+ * pilot launcher, bind the native session header, and return a handle.
+ *
+ * Returns `{ ok: true as const, session, reservation_id }` on success. Every pre-handle failure returns
+ * `{ ok: false as const, refused: true, stage, reason, ... }`; a failure after the reservation exists has
+ * already been settled honestly.
+ */
+export declare function startOwnedPiRpc(options: PiOptions): Promise<{
+    reservation?: never;
+    result?: never;
+    detail?: never;
+    ok: false;
+    refused: boolean;
+    stage: string;
+    reason: string;
+    admission: {
+        ok: false;
+        reason: string;
+        checks: Record<string, unknown>[];
+        expected: string;
+        actual: string;
+        required_skills?: never;
+        required_tools?: never;
+        preflight?: never;
+        state_revision?: never;
+        owner_epoch?: never;
+        attempt_state?: never;
+        resources?: never;
+        mode?: never;
+        launch_kind?: never;
+        resume_selector?: never;
+        pre_bound_identity?: never;
+        expected_identity?: never;
+        capability_evidence?: never;
+        assignment_digest?: never;
+        input_revision?: never;
+        state?: never;
+        detail?: never;
+    } | {
+        ok: false;
+        reason: string;
+        checks: Record<string, unknown>[];
+        detail: string;
+        required_skills?: never;
+        required_tools?: never;
+        preflight?: never;
+        state_revision?: never;
+        owner_epoch?: never;
+        attempt_state?: never;
+        resources?: never;
+        mode?: never;
+        launch_kind?: never;
+        resume_selector?: never;
+        pre_bound_identity?: never;
+        expected_identity?: never;
+        capability_evidence?: never;
+        assignment_digest?: never;
+        input_revision?: never;
+        expected?: never;
+        actual?: never;
+        state?: never;
+    } | {
+        ok: false;
+        reason: string;
+        checks: Record<string, unknown>[];
+        required_skills?: never;
+        required_tools?: never;
+        preflight?: never;
+        state_revision?: never;
+        owner_epoch?: never;
+        attempt_state?: never;
+        resources?: never;
+        mode?: never;
+        launch_kind?: never;
+        resume_selector?: never;
+        pre_bound_identity?: never;
+        expected_identity?: never;
+        capability_evidence?: never;
+        assignment_digest?: never;
+        input_revision?: never;
+        expected?: never;
+        actual?: never;
+        state?: never;
+        detail?: never;
+    } | {
+        ok: false;
+        reason: string;
+        checks: Record<string, unknown>[];
+        expected: number;
+        actual: number;
+        required_skills?: never;
+        required_tools?: never;
+        preflight?: never;
+        state_revision?: never;
+        owner_epoch?: never;
+        attempt_state?: never;
+        resources?: never;
+        mode?: never;
+        launch_kind?: never;
+        resume_selector?: never;
+        pre_bound_identity?: never;
+        expected_identity?: never;
+        capability_evidence?: never;
+        assignment_digest?: never;
+        input_revision?: never;
+        state?: never;
+        detail?: never;
+    } | {
+        ok: false;
+        reason: string;
+        checks: Record<string, unknown>[];
+        expected: Identity;
+        actual: Identity & {
+            harness: string;
+            cwd: string;
+            surface: string;
+            configuration_id: string;
+        };
+        required_skills?: never;
+        required_tools?: never;
+        preflight?: never;
+        state_revision?: never;
+        owner_epoch?: never;
+        attempt_state?: never;
+        resources?: never;
+        mode?: never;
+        launch_kind?: never;
+        resume_selector?: never;
+        pre_bound_identity?: never;
+        expected_identity?: never;
+        capability_evidence?: never;
+        assignment_digest?: never;
+        input_revision?: never;
+        state?: never;
+        detail?: never;
+    } | {
+        ok: false;
+        reason: string;
+        checks: Record<string, unknown>[];
+        expected: string;
+        actual: string;
+        detail: string;
+        required_skills?: never;
+        required_tools?: never;
+        preflight?: never;
+        state_revision?: never;
+        owner_epoch?: never;
+        attempt_state?: never;
+        resources?: never;
+        mode?: never;
+        launch_kind?: never;
+        resume_selector?: never;
+        pre_bound_identity?: never;
+        expected_identity?: never;
+        capability_evidence?: never;
+        assignment_digest?: never;
+        input_revision?: never;
+        state?: never;
+    } | {
+        ok: false;
+        reason: string;
+        checks: Record<string, unknown>[];
+        required_skills: number;
+        required_tools: number;
+        preflight?: never;
+        state_revision?: never;
+        owner_epoch?: never;
+        attempt_state?: never;
+        resources?: never;
+        mode?: never;
+        launch_kind?: never;
+        resume_selector?: never;
+        pre_bound_identity?: never;
+        expected_identity?: never;
+        capability_evidence?: never;
+        assignment_digest?: never;
+        input_revision?: never;
+        expected?: never;
+        actual?: never;
+        state?: never;
+        detail?: never;
+    } | {
+        required_skills?: never;
+        required_tools?: never;
+        ok: false;
+        reason: string;
+        checks: Record<string, unknown>[];
+        preflight: {
+            status: string;
+            errors: string[];
+            blockers: never[];
+            warnings: never[];
+            task_id?: never;
+            assignment_id?: never;
+            attempt?: never;
+            checked_at?: never;
+            limits?: never;
+        } | {
+            status: string;
+            task_id: string;
+            assignment_id: string;
+            attempt: number;
+            checked_at: string;
+            errors: never[];
+            blockers: import("../../collab/preflight.js").Check[];
+            warnings: import("../../collab/preflight.js").Check[];
+            limits: string[];
+        };
+        state_revision?: never;
+        owner_epoch?: never;
+        attempt_state?: never;
+        resources?: never;
+        mode?: never;
+        launch_kind?: never;
+        resume_selector?: never;
+        pre_bound_identity?: never;
+        expected_identity?: never;
+        capability_evidence?: never;
+        assignment_digest?: never;
+        input_revision?: never;
+        expected?: never;
+        actual?: never;
+        state?: never;
+        detail?: never;
+    } | {
+        required_skills?: never;
+        required_tools?: never;
+        preflight?: never;
+        ok: false;
+        reason: string;
+        checks: Record<string, unknown>[];
+        state: string;
+        state_revision?: never;
+        owner_epoch?: never;
+        attempt_state?: never;
+        resources?: never;
+        mode?: never;
+        launch_kind?: never;
+        resume_selector?: never;
+        pre_bound_identity?: never;
+        expected_identity?: never;
+        capability_evidence?: never;
+        assignment_digest?: never;
+        input_revision?: never;
+        expected?: never;
+        actual?: never;
+        detail?: never;
+    } | {
+        required_skills?: never;
+        required_tools?: never;
+        preflight?: never;
+        ok: false;
+        reason: string;
+        checks: Record<string, unknown>[];
+        expected: (string | null)[];
+        actual: string;
+        state_revision?: never;
+        owner_epoch?: never;
+        attempt_state?: never;
+        resources?: never;
+        mode?: never;
+        launch_kind?: never;
+        resume_selector?: never;
+        pre_bound_identity?: never;
+        expected_identity?: never;
+        capability_evidence?: never;
+        assignment_digest?: never;
+        input_revision?: never;
+        state?: never;
+        detail?: never;
+    } | {
+        required_skills?: never;
+        required_tools?: never;
+        preflight?: never;
+        ok: false;
+        reason: string;
+        checks: Record<string, unknown>[];
+        resources: Record<string, unknown>[];
+        detail: string;
+        state_revision?: never;
+        owner_epoch?: never;
+        attempt_state?: never;
+        mode?: never;
+        launch_kind?: never;
+        resume_selector?: never;
+        pre_bound_identity?: never;
+        expected_identity?: never;
+        capability_evidence?: never;
+        assignment_digest?: never;
+        input_revision?: never;
+        expected?: never;
+        actual?: never;
+        state?: never;
+    } | {
+        required_skills?: never;
+        required_tools?: never;
+        preflight?: never;
+        ok: false;
+        reason: string;
+        checks: Record<string, unknown>[];
+        resources: Record<string, unknown>[];
+        expected: number | undefined;
+        actual: number;
+        state_revision?: never;
+        owner_epoch?: never;
+        attempt_state?: never;
+        mode?: never;
+        launch_kind?: never;
+        resume_selector?: never;
+        pre_bound_identity?: never;
+        expected_identity?: never;
+        capability_evidence?: never;
+        assignment_digest?: never;
+        input_revision?: never;
+        state?: never;
+        detail?: never;
+    } | {
+        required_skills?: never;
+        required_tools?: never;
+        preflight?: never;
+        ok: false;
+        reason: string;
+        checks: Record<string, unknown>[];
+        resources: Record<string, unknown>[];
+        state_revision?: never;
+        owner_epoch?: never;
+        attempt_state?: never;
+        mode?: never;
+        launch_kind?: never;
+        resume_selector?: never;
+        pre_bound_identity?: never;
+        expected_identity?: never;
+        capability_evidence?: never;
+        assignment_digest?: never;
+        input_revision?: never;
+        expected?: never;
+        actual?: never;
+        state?: never;
+        detail?: never;
+    };
+    outcome?: never;
+    settlement?: never;
+    evidence?: never;
+    session?: never;
+    reservation_id?: never;
+} | {
+    result?: never;
+    detail?: never;
+    ok: false;
+    refused: boolean;
+    stage: string;
+    reason: string;
+    admission: {
+        required_skills?: never;
+        required_tools?: never;
+        preflight?: never;
+        ok: true;
+        checks: Record<string, unknown>[];
+        state_revision: number;
+        owner_epoch: number | null;
+        attempt_state: string;
+        resources: Record<string, unknown>[];
+        mode: string;
+        launch_kind: string;
+        resume_selector: string | null;
+        pre_bound_identity: string | null;
+        expected_identity: string | null;
+        capability_evidence: string;
+        assignment_digest: string;
+        input_revision: string | null;
+        reason?: never;
+        expected?: never;
+        actual?: never;
+        state?: never;
+        detail?: never;
+    };
+    reservation: {
+        [key: string]: unknown;
+        ok: false;
+        reason: string;
+    };
+    outcome?: never;
+    settlement?: never;
+    evidence?: never;
+    session?: never;
+    reservation_id?: never;
+} | {
+    reservation?: never;
+    admission?: never;
+    ok: false;
+    refused: boolean;
+    stage: string;
+    reason: string | undefined;
+    detail: string | null;
+    outcome: string;
+    settlement: unknown;
+    result: unknown;
+    evidence: unknown;
+    session?: never;
+    reservation_id?: never;
+} | {
+    reservation?: never;
+    result?: never;
+    reason?: never;
+    detail?: never;
+    admission?: never;
+    refused?: never;
+    stage?: never;
+    outcome?: never;
+    settlement?: never;
+    evidence?: never;
+    ok: true;
+    session: {
+        schema: string;
+        pid: number | null;
+        expectedSessionId: string | null;
+        sessionFile: () => string | null;
+        /** Read-only native query. Repeatable; always recorded through the protocol. */
+        query(): Promise<{
+            at: string;
+            session_id: string | undefined;
+            session_file: string | null;
+            header_bound: boolean;
+            is_streaming: boolean | undefined;
+            is_compacting: boolean | undefined;
+            pending_message_count: number | undefined;
+            message_count: number | null | undefined;
+            evidence_ref: string;
+            evidence_digest: string;
+            status_query_message_id: string;
+            status_message_id: string;
+        }>;
+        /** Send the one frozen prompt for this launch. A second call is refused. */
+        prompt(): Promise<{
+            disposition: string;
+        }>;
+        /** Bounded wait for the run started by `prompt` to settle. Used by the run helper. */
+        awaitSettled({ timeoutMs }?: {
+            timeoutMs?: number | undefined;
+        }): Promise<{
+            ordinal: number;
+            at: string;
+        } | null>;
+        /**
+         * Explicit cancellation of this owned runtime. It never sends a prompt, never sends
+         * CANCELLED and never releases claims: a caller must reconcile the stop externally.
+         */
+        cancel({ reason }?: {
+            reason?: string | undefined;
+        }): Promise<Record<string, unknown>>;
+        shutdown: () => Promise<{
+            exit_code: number | null;
+            signal: NodeJS.Signals | null;
+            parent_exited: boolean;
+            stream_closed: boolean;
+            streams_detached: boolean;
+            killed_after_eof_timeout: boolean;
+            signaled_kill: boolean;
+        }>;
+        finalize: () => Promise<PiFinish>;
+        /**
+         * Bounded shutdown, evidence persistence and one honest settlement. Serializable and safe to
+         * call once on every path; no caller-supplied result or outcome can override the outcome.
+         */
+        finish(): Promise<PiFinish>;
+    };
+    reservation_id: string;
+} | {
+    ok: false;
+    refused: boolean;
+    stage: string;
+    reason: string;
+    detail: string | null;
+}>;
+/**
+ * One bounded gated operation. `action` is `query` (default) or `prompt`; unsupported actions
+ * are refused before anything is spawned. `prompt` sends the single frozen prompt and waits for
+ * it to settle. A cancellation is never implicit here; callers cancel explicitly on the handle.
+ */
+export declare function runOwnedPiRpc(options: PiOptions): Promise<{
+    reservation?: never;
+    result?: never;
+    detail?: never;
+    ok: false;
+    refused: boolean;
+    stage: string;
+    reason: string;
+    admission: {
+        ok: false;
+        reason: string;
+        checks: Record<string, unknown>[];
+        expected: string;
+        actual: string;
+        required_skills?: never;
+        required_tools?: never;
+        preflight?: never;
+        state_revision?: never;
+        owner_epoch?: never;
+        attempt_state?: never;
+        resources?: never;
+        mode?: never;
+        launch_kind?: never;
+        resume_selector?: never;
+        pre_bound_identity?: never;
+        expected_identity?: never;
+        capability_evidence?: never;
+        assignment_digest?: never;
+        input_revision?: never;
+        state?: never;
+        detail?: never;
+    } | {
+        ok: false;
+        reason: string;
+        checks: Record<string, unknown>[];
+        detail: string;
+        required_skills?: never;
+        required_tools?: never;
+        preflight?: never;
+        state_revision?: never;
+        owner_epoch?: never;
+        attempt_state?: never;
+        resources?: never;
+        mode?: never;
+        launch_kind?: never;
+        resume_selector?: never;
+        pre_bound_identity?: never;
+        expected_identity?: never;
+        capability_evidence?: never;
+        assignment_digest?: never;
+        input_revision?: never;
+        expected?: never;
+        actual?: never;
+        state?: never;
+    } | {
+        ok: false;
+        reason: string;
+        checks: Record<string, unknown>[];
+        required_skills?: never;
+        required_tools?: never;
+        preflight?: never;
+        state_revision?: never;
+        owner_epoch?: never;
+        attempt_state?: never;
+        resources?: never;
+        mode?: never;
+        launch_kind?: never;
+        resume_selector?: never;
+        pre_bound_identity?: never;
+        expected_identity?: never;
+        capability_evidence?: never;
+        assignment_digest?: never;
+        input_revision?: never;
+        expected?: never;
+        actual?: never;
+        state?: never;
+        detail?: never;
+    } | {
+        ok: false;
+        reason: string;
+        checks: Record<string, unknown>[];
+        expected: number;
+        actual: number;
+        required_skills?: never;
+        required_tools?: never;
+        preflight?: never;
+        state_revision?: never;
+        owner_epoch?: never;
+        attempt_state?: never;
+        resources?: never;
+        mode?: never;
+        launch_kind?: never;
+        resume_selector?: never;
+        pre_bound_identity?: never;
+        expected_identity?: never;
+        capability_evidence?: never;
+        assignment_digest?: never;
+        input_revision?: never;
+        state?: never;
+        detail?: never;
+    } | {
+        ok: false;
+        reason: string;
+        checks: Record<string, unknown>[];
+        expected: Identity;
+        actual: Identity & {
+            harness: string;
+            cwd: string;
+            surface: string;
+            configuration_id: string;
+        };
+        required_skills?: never;
+        required_tools?: never;
+        preflight?: never;
+        state_revision?: never;
+        owner_epoch?: never;
+        attempt_state?: never;
+        resources?: never;
+        mode?: never;
+        launch_kind?: never;
+        resume_selector?: never;
+        pre_bound_identity?: never;
+        expected_identity?: never;
+        capability_evidence?: never;
+        assignment_digest?: never;
+        input_revision?: never;
+        state?: never;
+        detail?: never;
+    } | {
+        ok: false;
+        reason: string;
+        checks: Record<string, unknown>[];
+        expected: string;
+        actual: string;
+        detail: string;
+        required_skills?: never;
+        required_tools?: never;
+        preflight?: never;
+        state_revision?: never;
+        owner_epoch?: never;
+        attempt_state?: never;
+        resources?: never;
+        mode?: never;
+        launch_kind?: never;
+        resume_selector?: never;
+        pre_bound_identity?: never;
+        expected_identity?: never;
+        capability_evidence?: never;
+        assignment_digest?: never;
+        input_revision?: never;
+        state?: never;
+    } | {
+        ok: false;
+        reason: string;
+        checks: Record<string, unknown>[];
+        required_skills: number;
+        required_tools: number;
+        preflight?: never;
+        state_revision?: never;
+        owner_epoch?: never;
+        attempt_state?: never;
+        resources?: never;
+        mode?: never;
+        launch_kind?: never;
+        resume_selector?: never;
+        pre_bound_identity?: never;
+        expected_identity?: never;
+        capability_evidence?: never;
+        assignment_digest?: never;
+        input_revision?: never;
+        expected?: never;
+        actual?: never;
+        state?: never;
+        detail?: never;
+    } | {
+        required_skills?: never;
+        required_tools?: never;
+        ok: false;
+        reason: string;
+        checks: Record<string, unknown>[];
+        preflight: {
+            status: string;
+            errors: string[];
+            blockers: never[];
+            warnings: never[];
+            task_id?: never;
+            assignment_id?: never;
+            attempt?: never;
+            checked_at?: never;
+            limits?: never;
+        } | {
+            status: string;
+            task_id: string;
+            assignment_id: string;
+            attempt: number;
+            checked_at: string;
+            errors: never[];
+            blockers: import("../../collab/preflight.js").Check[];
+            warnings: import("../../collab/preflight.js").Check[];
+            limits: string[];
+        };
+        state_revision?: never;
+        owner_epoch?: never;
+        attempt_state?: never;
+        resources?: never;
+        mode?: never;
+        launch_kind?: never;
+        resume_selector?: never;
+        pre_bound_identity?: never;
+        expected_identity?: never;
+        capability_evidence?: never;
+        assignment_digest?: never;
+        input_revision?: never;
+        expected?: never;
+        actual?: never;
+        state?: never;
+        detail?: never;
+    } | {
+        required_skills?: never;
+        required_tools?: never;
+        preflight?: never;
+        ok: false;
+        reason: string;
+        checks: Record<string, unknown>[];
+        state: string;
+        state_revision?: never;
+        owner_epoch?: never;
+        attempt_state?: never;
+        resources?: never;
+        mode?: never;
+        launch_kind?: never;
+        resume_selector?: never;
+        pre_bound_identity?: never;
+        expected_identity?: never;
+        capability_evidence?: never;
+        assignment_digest?: never;
+        input_revision?: never;
+        expected?: never;
+        actual?: never;
+        detail?: never;
+    } | {
+        required_skills?: never;
+        required_tools?: never;
+        preflight?: never;
+        ok: false;
+        reason: string;
+        checks: Record<string, unknown>[];
+        expected: (string | null)[];
+        actual: string;
+        state_revision?: never;
+        owner_epoch?: never;
+        attempt_state?: never;
+        resources?: never;
+        mode?: never;
+        launch_kind?: never;
+        resume_selector?: never;
+        pre_bound_identity?: never;
+        expected_identity?: never;
+        capability_evidence?: never;
+        assignment_digest?: never;
+        input_revision?: never;
+        state?: never;
+        detail?: never;
+    } | {
+        required_skills?: never;
+        required_tools?: never;
+        preflight?: never;
+        ok: false;
+        reason: string;
+        checks: Record<string, unknown>[];
+        resources: Record<string, unknown>[];
+        detail: string;
+        state_revision?: never;
+        owner_epoch?: never;
+        attempt_state?: never;
+        mode?: never;
+        launch_kind?: never;
+        resume_selector?: never;
+        pre_bound_identity?: never;
+        expected_identity?: never;
+        capability_evidence?: never;
+        assignment_digest?: never;
+        input_revision?: never;
+        expected?: never;
+        actual?: never;
+        state?: never;
+    } | {
+        required_skills?: never;
+        required_tools?: never;
+        preflight?: never;
+        ok: false;
+        reason: string;
+        checks: Record<string, unknown>[];
+        resources: Record<string, unknown>[];
+        expected: number | undefined;
+        actual: number;
+        state_revision?: never;
+        owner_epoch?: never;
+        attempt_state?: never;
+        mode?: never;
+        launch_kind?: never;
+        resume_selector?: never;
+        pre_bound_identity?: never;
+        expected_identity?: never;
+        capability_evidence?: never;
+        assignment_digest?: never;
+        input_revision?: never;
+        state?: never;
+        detail?: never;
+    } | {
+        required_skills?: never;
+        required_tools?: never;
+        preflight?: never;
+        ok: false;
+        reason: string;
+        checks: Record<string, unknown>[];
+        resources: Record<string, unknown>[];
+        state_revision?: never;
+        owner_epoch?: never;
+        attempt_state?: never;
+        mode?: never;
+        launch_kind?: never;
+        resume_selector?: never;
+        pre_bound_identity?: never;
+        expected_identity?: never;
+        capability_evidence?: never;
+        assignment_digest?: never;
+        input_revision?: never;
+        expected?: never;
+        actual?: never;
+        state?: never;
+        detail?: never;
+    };
+    outcome?: never;
+    settlement?: never;
+    evidence?: never;
+    session?: never;
+    reservation_id?: never;
+    action: string;
+} | {
+    result?: never;
+    detail?: never;
+    ok: false;
+    refused: boolean;
+    stage: string;
+    reason: string;
+    admission: {
+        required_skills?: never;
+        required_tools?: never;
+        preflight?: never;
+        ok: true;
+        checks: Record<string, unknown>[];
+        state_revision: number;
+        owner_epoch: number | null;
+        attempt_state: string;
+        resources: Record<string, unknown>[];
+        mode: string;
+        launch_kind: string;
+        resume_selector: string | null;
+        pre_bound_identity: string | null;
+        expected_identity: string | null;
+        capability_evidence: string;
+        assignment_digest: string;
+        input_revision: string | null;
+        reason?: never;
+        expected?: never;
+        actual?: never;
+        state?: never;
+        detail?: never;
+    };
+    reservation: {
+        [key: string]: unknown;
+        ok: false;
+        reason: string;
+    };
+    outcome?: never;
+    settlement?: never;
+    evidence?: never;
+    session?: never;
+    reservation_id?: never;
+    action: string;
+} | {
+    reservation?: never;
+    admission?: never;
+    ok: false;
+    refused: boolean;
+    stage: string;
+    reason: string | undefined;
+    detail: string | null;
+    outcome: string;
+    settlement: unknown;
+    result: unknown;
+    evidence: unknown;
+    session?: never;
+    reservation_id?: never;
+    action: string;
+} | {
+    action: string;
+    ok: false;
+    refused: boolean;
+    stage: string;
+    reason: string;
+    detail: string | null;
+} | {
+    ok: boolean;
+    schema: string;
+    reason: string | null;
+    detail: string | null;
+    outcome: string;
+    action: string;
+}>;
+export declare const PI_RPC_SCHEMA = "harness-collab/pi-rpc/1";