@indigoai-us/hq-cli 5.126.0 → 5.127.0

package/dist/commands/lanes.d.ts

@@ -5,7 +5,14 @@
  * `accounts login`, which hands the terminal to the vendor's own sign-in.
  */
 import { Command } from "commander";
-import { type LaneCompanyRef, type LaneRecord, type QuestionRecord, type ResolvedLaneWorker, type SeniorRef, type ThrottleDeps } from "../lib/lanes/index.js";
+import { type OutpostDispatchResult } from "../lib/lanes/outpost-dispatch.js";
+import { emitLaneDecisionEvents, type LaneMesh } from "../lib/lanes/mesh-events.js";
+import { type LaneCompanyRef, type LaneRecord, type QuestionRecord, type ResolvedLaneWorker, type SeniorRef, type LivenessDeps, type MachineIdentity, type RunCommand, type ThrottleDeps } from "../lib/lanes/index.js";
+import { questionBodyAbsPath } from "../lib/lanes/questions.js";
+import { type RunCompactionFn } from "../lib/lanes/compaction.js";
+import { spawnLaneWorker, type KillProcessFn, type ProveDetachedFn, type SpawnProcessFn } from "../lib/lanes/spawn.js";
+export { spawnLaneWorker };
+export { questionBodyAbsPath };
 export declare const MAX_LANE_DEPTH = 2;
 export declare const OUTPOST_ID_PATH = "/etc/outpost/outpost-id";
 export declare const OUTPOST_DIR = "/etc/outpost";
@@ -21,13 +28,13 @@ export type OutpostIdentity = {
 export interface SpawnLoginResult {
     status: number;
 }
-export interface LanesMesh {
-    ensureProjectThread: (company: LaneCompanyRef, projectId: string) => Promise<string>;
-    appendThreadEvent: (company: LaneCompanyRef, threadId: string, eventKind: string, payload: Record<string, unknown>) => Promise<void>;
-    patchStoryStatus: (company: LaneCompanyRef, projectId: string, storyId: string, status: string) => Promise<void>;
-}
+/** The lane → mesh seam. Defined in lib/lanes/mesh-events.ts; the watcher shares it. */
+export type LanesMesh = LaneMesh;
+export { emitLaneDecisionEvents };
 export interface LanesCommandDeps {
     hqRoot?: () => string;
+    /** Start HQ-root walk here instead of process.cwd(). Tests only. */
+    cwd?: () => string;
     env?: NodeJS.ProcessEnv;
     now?: () => Date;
     hostname?: () => string;
@@ -46,24 +53,55 @@ export interface LanesCommandDeps {
     homedir?: () => string;
     mesh?: LanesMesh;
     sleep?: (ms: number) => Promise<void>;
+    spawnProcess?: SpawnProcessFn;
+    proveDetached?: ProveDetachedFn;
+    killProcess?: KillProcessFn;
+    isAlive?: (pid: number) => boolean;
+    stopSleepMs?: (ms: number) => void;
+    livenessDeps?: LivenessDeps;
+    presenceConnected?: boolean;
+    systemdRoot?: string;
+    runSystemctl?: RunCommand;
+    resolveMachineIdentity?: () => MachineIdentity;
+    stageOutpostPayload?: (outpostId: string, bytes: Uint8Array) => Promise<{
+        getUrl: string;
+    }>;
+    dispatchOutpostExec?: (input: {
+        outpostId: string;
+        command: string;
+    }) => Promise<OutpostDispatchResult>;
+    fetchText?: (url: string) => Promise<string>;
+    runCompaction?: RunCompactionFn;
+    locateTranscript?: (home: string, sessionId: string) => string | null;
 }
-/**
- * Spawn seam for the worker process (spec §5). Process spawning and the
- * reconcile daemon are out of scope for this command surface; calling this
- * throws rather than faking a running lane.
- */
-export declare function spawnLaneWorker(lane: LaneRecord): never;
 export declare function readOutpostIdentity(existsSync?: (p: string) => boolean, readFileSync?: (p: string) => string): OutpostIdentity;
 export declare function parseSeniorRef(raw: string): SeniorRef;
 export declare function resolveAnswerChoice(choice: string, options: string[], freeform: boolean): string;
-/** Tenant-store path for a question body (spec §6.2 / §10). Never the personal vault for company prose. */
-export declare function questionBodyAbsPath(hqRoot: string, question: Pick<QuestionRecord, "company" | "body" | "question_id">): string;
+/**
+ * Spec §5.1: `hq lanes ask` from inside a lane can hit a binary or dist
+ * being replaced mid-call (ENOENT / ETXTBSY / a module that no longer
+ * resolves) or a record written by a newer CLI. Three attempts, waits of
+ * 5 s then 15 s, 20 s of backoff in total, inside the 30 s bound.
+ */
+export declare const ASK_BACKOFF_MS: readonly [5000, 15000];
+export declare const ASK_ATTEMPTS: number;
 export declare function casUpdateQuestion(hqRoot: string, questionId: string, updater: (current: QuestionRecord) => QuestionRecord): QuestionRecord;
 export declare function casUpdateLane(hqRoot: string, laneId: string, updater: (current: LaneRecord) => LaneRecord): LaneRecord;
+/**
+ * Spec §5.3: an approval gate ends the run. The lane stops at each
+ * checkpoint with a `decision: ask` envelope whose question names it; the
+ * reconcile pass resumes the lane once every question is answered.
+ */
+export declare function checkpointInstruction(worker: Pick<ResolvedLaneWorker, "approvalRequired" | "humanCheckpoints">): string;
 export declare function composeWorkerBrief(worker: ResolvedLaneWorker, taskBrief: string): string;
+/**
+ * A lane with no worker still carries the standing authorization paragraph
+ * and the foreground-only rule.
+ */
+export declare function composeGeneralBrief(taskBrief: string): string;
 export declare function parseMaxRuntimeSeconds(raw: unknown, workerId: string): number | undefined;
-export declare function emitLaneDecisionEvents(mesh: LanesMesh, lane: LaneRecord, decision: "blocked" | "done", extra?: Record<string, unknown>): Promise<void>;
 export declare const PICKUP_TERMINAL_REASONS: readonly ["account_not_logged_in", "unknown_account", "account_disabled"];
+export declare const DISPATCH_TERMINAL_REASON: "outpost_dispatch_failed";
 export type PickupTerminalReason = (typeof PICKUP_TERMINAL_REASONS)[number];
 /**
  * Outpost-side account bind (spec §5.2). Writes a named terminal reason,
@@ -71,5 +109,6 @@ export type PickupTerminalReason = (typeof PICKUP_TERMINAL_REASONS)[number];
  */
 export declare function applyOutpostAccountPickup(hqRoot: string, laneId: string): LaneRecord;
 export declare function cancelPendingQuestionsForLane(hqRoot: string, laneId: string, nowIso: string, operatorReason?: string): QuestionRecord[];
-export declare function registerLanesCommand(parent: Command, deps?: LanesCommandDeps): void;
+export declare function stopCommittedState(state: LaneRecord["state"]): "cancelled" | "killed";
+export declare function registerLanesCommand(parent: Command, deps?: LanesCommandDeps): Command;
 //# sourceMappingURL=lanes.d.ts.map