@cogcoin/client 1.0.2 → 1.1.1

package/dist/wallet/mining/runner.d.ts

@@ -1,5 +1,5 @@
 import { spawn } from "node:child_process";
-import { attachOrStartManagedBitcoindService } from "../../bitcoind/service.js";
+import { attachOrStartManagedBitcoindService, probeManagedBitcoindService, stopManagedBitcoindService } from "../../bitcoind/service.js";
 import { createRpcClient } from "../../bitcoind/node.js";
 import type { ProgressOutputMode } from "../../bitcoind/types.js";
 import { type FixedWalletInput, type MutationSender, type WalletMutationRpcClient } from "../tx/common.js";
@@ -10,6 +10,7 @@ import { type WalletRuntimePaths } from "../runtime.js";
 import { type WalletSecretProvider } from "../state/provider.js";
 import type { MiningStateRecord, OutpointRecord, WalletStateV1 } from "../types.js";
 import { requestMiningGenerationPreemption } from "./coordination.js";
+import { type MiningSentenceGenerationRequest } from "./sentences.js";
 import type { MiningControlPlaneView, MiningEventRecord, MiningRuntimeStatusV1 } from "./types.js";
 import { type MiningFollowVisualizerState, type MiningSentenceBoardEntry, MiningFollowVisualizer } from "./visualizer.js";
 type MiningRpcClient = WalletMutationRpcClient & {
@@ -94,6 +95,8 @@ interface MiningRunnerStatusOverrides {
     currentAbsoluteFeeSats?: number | null;
     currentBlockFeeSpentSats?: string;
     lastSuspendDetectedAtUnixMs?: number | null;
+    reconnectSettledUntilUnixMs?: number | null;
+    tipSettledUntilUnixMs?: number | null;
     providerState?: MiningRuntimeStatusV1["providerState"];
     corePublishState?: MiningRuntimeStatusV1["corePublishState"];
     currentPublishDecision?: string | null;
@@ -175,10 +178,19 @@ interface MiningLoopState {
     selectedCandidate: MiningCandidate | null;
     ui: MiningFollowVisualizerState;
     waitingNote: string | null;
+    bitcoinRecoveryFirstFailureAtUnixMs: number | null;
+    bitcoinRecoveryFirstUnreachableAtUnixMs: number | null;
+    bitcoinRecoveryLastRestartAttemptAtUnixMs: number | null;
+    bitcoinRecoveryServiceInstanceId: string | null;
+    bitcoinRecoveryProcessId: number | null;
+    reconnectSettledUntilUnixMs: number | null;
+    tipSettledUntilUnixMs: number | null;
 }
 export interface RunForegroundMiningOptions extends RunnerDependencies {
     dataDir: string;
     databasePath: string;
+    clientVersion?: string | null;
+    updateAvailable?: boolean;
     provider?: WalletSecretProvider;
     prompter: WalletPrompter;
     builtInSetupEnsured?: boolean;
@@ -224,6 +236,7 @@ export declare function resetMiningUiForTipForTesting(loopState: MiningLoopState
 export declare function resolveSettledBoardForTesting(options: {
     snapshotState: NonNullable<WalletReadContext["snapshot"]>["state"] | null | undefined;
     snapshotTipHeight: number | null;
+    snapshotTipPreviousHashHex?: string | null;
     nodeBestHeight: number | null;
 }): {
     settledBlockHeight: number | null;
@@ -273,7 +286,7 @@ export declare function createMiningPlanForTesting(options: {
         referencedBlockHashInternal: Uint8Array;
         targetBlockHeight: number;
     };
-    conflictOutpoint: OutpointRecord;
+    conflictOutpoint: OutpointRecord | null;
     allUtxos: Awaited<ReturnType<MiningRpcClient["listUnspent"]>>;
     feeRateSatVb: number;
 }): {
@@ -294,6 +307,19 @@ export declare function resolveMiningConflictOutpointForTesting(options: {
     state: WalletStateV1;
     allUtxos: Awaited<ReturnType<MiningRpcClient["listUnspent"]>>;
 }): OutpointRecord | null;
+export declare function buildMiningGenerationRequestForTesting(options: {
+    targetBlockHeight: number;
+    referencedBlockHashDisplay: string;
+    generatedAtUnixMs?: number;
+    requestId?: string;
+    domains: Array<{
+        domainId: number;
+        domainName: string;
+        requiredWords: [string, string, string, string, string];
+    }>;
+    domainExtraPrompts?: Record<string, string>;
+    extraPrompt?: string | null;
+}): MiningSentenceGenerationRequest;
 declare function publishCandidateOnce(options: {
     readContext: WalletReadContext & {
         localState: {
@@ -356,11 +382,15 @@ declare function runMiningLoop(options: {
     fetchImpl?: typeof fetch;
     openReadContext: typeof openWalletReadContext;
     attachService: typeof attachOrStartManagedBitcoindService;
+    probeService?: typeof probeManagedBitcoindService;
+    stopService?: typeof stopManagedBitcoindService;
     rpcFactory: (config: Parameters<typeof createRpcClient>[0]) => MiningRpcClient;
     stdout?: {
         write(chunk: string): void;
     };
     visualizer?: MiningFollowVisualizer;
+    nowImpl?: () => number;
+    sleepImpl?: typeof sleep;
 }): Promise<void>;
 declare function waitForBackgroundHealthy(paths: WalletRuntimePaths): Promise<MiningRuntimeStatusV1 | null>;
 export declare function runForegroundMining(options: RunForegroundMiningOptions): Promise<void>;
@@ -384,6 +414,7 @@ export declare function handleDetectedMiningRuntimeResumeForTesting(options: {
     detectedAtUnixMs: number;
     openReadContext: typeof openWalletReadContext;
     visualizer?: MiningFollowVisualizer;
+    loopState?: MiningLoopState;
 }): Promise<void>;
 export declare function takeOverMiningRuntimeForTesting(options: {
     paths: WalletRuntimePaths;
@@ -406,11 +437,36 @@ export declare function performMiningCycleForTesting(options: {
     fetchImpl?: typeof fetch;
     openReadContext: typeof openWalletReadContext;
     attachService: typeof attachOrStartManagedBitcoindService;
+    probeService?: typeof probeManagedBitcoindService;
+    stopService?: typeof stopManagedBitcoindService;
     rpcFactory: (config: Parameters<typeof createRpcClient>[0]) => MiningRpcClient;
     stdout?: {
         write(chunk: string): void;
     };
     loopState?: MiningLoopState;
+    nowImpl?: () => number;
+}): Promise<void>;
+export declare function runMiningLoopForTesting(options: {
+    dataDir: string;
+    databasePath: string;
+    provider: WalletSecretProvider;
+    paths: WalletRuntimePaths;
+    runMode: "foreground" | "background";
+    backgroundWorkerPid: number | null;
+    backgroundWorkerRunId: string | null;
+    signal?: AbortSignal;
+    fetchImpl?: typeof fetch;
+    openReadContext: typeof openWalletReadContext;
+    attachService: typeof attachOrStartManagedBitcoindService;
+    probeService?: typeof probeManagedBitcoindService;
+    stopService?: typeof stopManagedBitcoindService;
+    rpcFactory: (config: Parameters<typeof createRpcClient>[0]) => MiningRpcClient;
+    stdout?: {
+        write(chunk: string): void;
+    };
+    visualizer?: MiningFollowVisualizer;
+    nowImpl?: () => number;
+    sleepImpl?: typeof sleep;
 }): Promise<void>;
 export declare function buildPrePublishStatusOverridesForTesting(options: {
     state: WalletStateV1;