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

package/dist/hosts/claude/native.d.ts

@@ -0,0 +1,79 @@
+export interface ClaudeOptions {
+    taskRoot: string;
+    subtaskId: string;
+    attempt: number;
+    ownerEpoch: number;
+    agentId: string;
+    sessionId: string;
+    cwd: string;
+    claudeBin?: string;
+    env?: NodeJS.ProcessEnv;
+    nativeSessionId?: string;
+    expectedPid?: number;
+    expectedStartedAt?: number;
+    evidenceDir?: string;
+    timeoutMs?: number;
+    pollMs?: number;
+    stopTimeoutMs?: number;
+    maxBytes?: number;
+    streamGraceMs?: number;
+    reason?: string;
+}
+interface CaptureOptions {
+    timeoutMs?: number;
+    maxBytes?: number;
+    streamGraceMs?: number;
+    cwd?: string;
+    env?: NodeJS.ProcessEnv | undefined;
+}
+export interface CaptureResult {
+    exit_code: number | null;
+    signal: NodeJS.Signals | null;
+    parent_exited: boolean;
+    stream_closed: boolean;
+    streams_detached: boolean;
+    timed_out: boolean;
+    killed_after_eof_timeout: boolean;
+    spawn_failed: boolean;
+    spawn_error: string | null;
+    truncated: boolean;
+    stdout: Buffer;
+    stderr: Buffer;
+}
+export interface ClaudeObservation {
+    schema: string;
+    status: string;
+    blockers: string[];
+    claims_retained: boolean;
+    reconciliation_required?: boolean;
+    cancelled_message_sent?: boolean;
+    task_result_claimed?: boolean;
+    [key: string]: unknown;
+}
+export declare class ClaudeNativeRefusal extends Error {
+    readonly status: string;
+    readonly code: string;
+    readonly detail: string | null;
+    constructor(status: string, code: string, detail?: string | null);
+}
+/**
+ * Bounded local subprocess capture. Parent exit is separate from stream close: after the parent
+ * exits, only this module's own pipe handles are detached after a bounded grace, so a descendant
+ * that inherited stdout cannot hold the promise open past its deadline. No descendant is
+ * signalled. `streams_detached: true` means the output may be incomplete.
+ */
+export declare function runBounded(bin: string, args: string[], options?: CaptureOptions): Promise<CaptureResult>;
+/**
+ * Read-only observation of one exact recorded background session. Registers the intent first,
+ * then reads native state; a missing/unknown row is `unknown`, never `stopped`.
+ */
+export declare function queryClaudeSession(options: ClaudeOptions): Promise<ClaudeObservation>;
+/**
+ * Request a stop of one exact recorded background session. A fresh active observation is
+ * required first, the CANCEL intent is recorded, and only the matching command key is stopped.
+ * The command's exit code is never the proof: the polled terminal native row is. Claims are
+ * retained, no CANCELLED is sent, and any failure after the recorded intent still returns
+ * `reconciliation_required: true` together with the known native observation.
+ */
+export declare function cancelClaudeSession(options: ClaudeOptions): Promise<ClaudeObservation>;
+export {};