@cogcoin/client 1.0.1 → 1.0.2

package/dist/wallet/mining/runtime-artifacts.js

@@ -18,6 +18,7 @@ function normalizeLegacyMiningProviderState(raw) {
         case "unavailable":
         case "rate-limited":
         case "auth-error":
+        case "not-found":
             return raw;
         case "hook-error":
         case "n/a":

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

@@ -10,8 +10,8 @@ export interface MiningSentenceSourceOptions {
     fetchImpl?: typeof fetch;
 }
 declare class MiningProviderRequestError extends Error {
-    readonly providerState: "unavailable" | "rate-limited" | "auth-error";
-    constructor(providerState: "unavailable" | "rate-limited" | "auth-error", message: string);
+    readonly providerState: "unavailable" | "rate-limited" | "auth-error" | "not-found";
+    constructor(providerState: "unavailable" | "rate-limited" | "auth-error" | "not-found", message: string);
 }
 export declare function generateMiningSentences(request: MiningSentenceGenerationRequest, options: MiningSentenceSourceOptions): Promise<{
     candidates: MiningSentenceCandidateV1[];

package/dist/wallet/mining/sentences.js

@@ -1,6 +1,7 @@
 import { loadClientConfig } from "./config.js";
 import { MINING_BUILTIN_TIMEOUT_MS, } from "./constants.js";
 import { normalizeMiningSentenceResponse, parseStrictJsonValue, stripMarkdownCodeFence, } from "./sentence-protocol.js";
+import { resolveBuiltInProviderModel } from "./provider-model.js";
 class MiningProviderRequestError extends Error {
     providerState;
     constructor(providerState, message) {
@@ -9,6 +10,14 @@ class MiningProviderRequestError extends Error {
         this.providerState = providerState;
     }
 }
+function createBuiltInProviderNotFoundError(options) {
+    const providerName = options.provider === "anthropic" ? "Anthropic" : "OpenAI";
+    const providerLabel = `The built-in ${providerName} mining provider`;
+    const message = options.usingDefaultModel
+        ? `${providerLabel} returned HTTP 404 for default model "${options.model}". ${providerName} may no longer serve that model. Rerun \`cogcoin mine setup\` to choose a valid override.`
+        : `${providerLabel} returned HTTP 404 for model "${options.model}". The configured model override may be invalid. Rerun \`cogcoin mine setup\` to clear or correct it.`;
+    return new MiningProviderRequestError("not-found", message);
+}
 function buildSystemPrompt(extraPrompt) {
     const lines = [
         "You are helping generate candidate Cogcoin mining sentences.",
@@ -65,7 +74,7 @@ async function requestBuiltInSentences(options) {
     const providerSignal = createProviderSignal(options.signal, Math.min(MINING_BUILTIN_TIMEOUT_MS, options.request.limits.timeoutMs));
     try {
         if (options.provider === "openai") {
-            const model = options.modelOverride ?? "gpt-5.4-mini";
+            const { effectiveModel: model, usingDefaultModel } = resolveBuiltInProviderModel(options.provider, options.modelOverride);
             const response = await fetchImpl("https://api.openai.com/v1/responses", {
                 method: "POST",
                 headers: {
@@ -93,6 +102,13 @@ async function requestBuiltInSentences(options) {
             if (response.status === 429) {
                 throw new MiningProviderRequestError("rate-limited", "The built-in OpenAI mining provider is rate limited.");
             }
+            if (response.status === 404) {
+                throw createBuiltInProviderNotFoundError({
+                    provider: options.provider,
+                    model,
+                    usingDefaultModel,
+                });
+            }
             if (!response.ok) {
                 throw new MiningProviderRequestError("unavailable", `The built-in OpenAI mining provider returned HTTP ${response.status}.`);
             }
@@ -106,7 +122,7 @@ async function requestBuiltInSentences(options) {
                 model,
             });
         }
-        const model = options.modelOverride ?? "claude-sonnet-4-20250514";
+        const { effectiveModel: model, usingDefaultModel } = resolveBuiltInProviderModel(options.provider, options.modelOverride);
         const response = await fetchImpl("https://api.anthropic.com/v1/messages", {
             method: "POST",
             headers: {
@@ -133,6 +149,13 @@ async function requestBuiltInSentences(options) {
         if (response.status === 429) {
             throw new MiningProviderRequestError("rate-limited", "The built-in Anthropic mining provider is rate limited.");
         }
+        if (response.status === 404) {
+            throw createBuiltInProviderNotFoundError({
+                provider: options.provider,
+                model,
+                usingDefaultModel,
+            });
+        }
         if (!response.ok) {
             throw new MiningProviderRequestError("unavailable", `The built-in Anthropic mining provider returned HTTP ${response.status}.`);
         }

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

@@ -1,11 +1,13 @@
 import type { ManagedBitcoindHealth, ManagedIndexerTruthSource } from "../../bitcoind/types.js";
 export type MiningServiceHealth = "synced" | "catching-up" | "reorging" | "starting" | "stale-heartbeat" | "failed" | "schema-mismatch" | "service-version-mismatch" | "wallet-root-mismatch" | "unavailable";
 export type MiningProviderKind = "openai" | "anthropic";
+export type MiningModelSelectionSource = "catalog" | "custom" | "legacy-default" | "legacy-custom";
 export interface MiningProviderConfigRecord {
     provider: MiningProviderKind;
     apiKey: string;
     extraPrompt: string | null;
     modelOverride: string | null;
+    modelSelectionSource: MiningModelSelectionSource;
     updatedAtUnixMs: number;
 }
 export interface ClientConfigV1 {
@@ -56,7 +58,7 @@ export interface MiningRuntimeStatusV1 {
     indexerReorgDepth: number | null;
     indexerTipAligned: boolean | null;
     corePublishState: "unknown" | "network-inactive" | "no-outbound-peers" | "ibd" | "mempool-loading" | "healthy" | null;
-    providerState: "ready" | "backoff" | "unavailable" | "rate-limited" | "auth-error" | null;
+    providerState: "ready" | "backoff" | "unavailable" | "rate-limited" | "auth-error" | "not-found" | null;
     lastSuspendDetectedAtUnixMs: number | null;
     reconnectSettledUntilUnixMs: number | null;
     tipSettledUntilUnixMs: number | null;
@@ -103,8 +105,14 @@ export interface MiningProviderInspection {
     provider: MiningProviderKind | null;
     status: "ready" | "missing" | "error";
     message: string | null;
+    modelId: string | null;
+    effectiveModel: string | null;
     modelOverride: string | null;
+    modelSelectionSource: MiningModelSelectionSource | null;
+    usingDefaultModel: boolean | null;
     extraPromptConfigured: boolean;
+    estimatedDailyCostUsd: number | null;
+    estimatedDailyCostDisplay: string | null;
 }
 export interface MiningControlPlaneView {
     runtime: MiningRuntimeStatusV1;

package/dist/wallet/mining/visualizer.js

@@ -82,6 +82,29 @@ export function createEmptyMiningFollowVisualizerState() {
         recentWin: null,
     };
 }
+function cloneMiningRuntimeSnapshot(snapshot) {
+    return {
+        ...snapshot,
+    };
+}
+function cloneMiningFollowVisualizerState(state) {
+    return {
+        ...state,
+        visibleBlockTimesByHeight: { ...state.visibleBlockTimesByHeight },
+        settledBoardEntries: state.settledBoardEntries.map((entry) => ({
+            ...entry,
+        })),
+        provisionalRequiredWords: [...state.provisionalRequiredWords],
+        provisionalEntry: {
+            ...state.provisionalEntry,
+        },
+        recentWin: state.recentWin === null
+            ? null
+            : {
+                ...state.recentWin,
+            },
+    };
+}
 const VISUALIZER_PROGRESS_SNAPSHOT = {
     url: "",
     filename: "mining-follow-visualizer",
@@ -208,13 +231,13 @@ export class MiningFollowVisualizer {
         if (this.#renderer === null) {
             return;
         }
-        this.#latestSnapshot = snapshot;
+        this.#latestSnapshot = cloneMiningRuntimeSnapshot(snapshot);
         if (uiState !== undefined) {
-            this.#latestUiState = uiState;
+            this.#latestUiState = cloneMiningFollowVisualizerState(uiState);
         }
         replaceFollowBlockTimes(this.#scene, this.#latestUiState.visibleBlockTimesByHeight);
-        const indexedHeight = snapshot.indexerTipHeight ?? snapshot.coreBestHeight ?? null;
-        const nodeHeight = snapshot.coreBestHeight ?? indexedHeight;
+        const indexedHeight = this.#latestSnapshot.indexerTipHeight ?? this.#latestSnapshot.coreBestHeight ?? null;
+        const nodeHeight = this.#latestSnapshot.coreBestHeight ?? indexedHeight;
         syncFollowSceneState(this.#scene, {
             indexedHeight,
             nodeHeight,
@@ -256,7 +279,7 @@ export class MiningFollowVisualizer {
             artworkCogText: formatCompactCogBalanceText(uiState.balanceCogtoshi),
             artworkSatText: formatCompactSatBalanceText(uiState.balanceSats),
             extraLines: [
-                `✎ Block #${uiState.settledBlockHeight ?? "-----"} Sentences ✎`,
+                `✎ Indexed Block #${uiState.settledBlockHeight ?? "-----"} Sentences ✎`,
                 "",
                 ...Array.from({ length: MINING_SENTENCE_BOARD_SIZE }, (_value, index) => {
                     const entry = uiState.settledBoardEntries[index];

package/dist/wallet/read/context.js

@@ -76,6 +76,7 @@ async function normalizeLoadedWalletStateForRead(options) {
         dataDir: options.dataDir,
         chain: "main",
         startHeight: 0,
+        serviceLifetime: "ephemeral",
         walletRootId: options.loaded.state.walletRootId,
     });
     try {
@@ -435,6 +436,7 @@ async function attachNodeStatus(options) {
             dataDir: options.dataDir,
             chain: "main",
             startHeight: resolveCogcoinProcessingStartHeight(genesis),
+            serviceLifetime: "ephemeral",
             walletRootId: options.walletRootId,
             startupTimeoutMs: options.startupTimeoutMs,
         });
@@ -541,6 +543,7 @@ export async function openWalletReadContext(options) {
             daemonClient = await attachOrStartIndexerDaemon({
                 dataDir: options.dataDir,
                 databasePath: options.databasePath,
+                serviceLifetime: "ephemeral",
                 walletRootId,
                 startupTimeoutMs,
             });

package/dist/wallet/reset.js

@@ -232,6 +232,7 @@ async function recreateManagedCoreWalletReplicaForReset(options) {
         dataDir: options.dataDir,
         chain: "main",
         startHeight: 0,
+        serviceLifetime: "ephemeral",
         walletRootId: options.state.walletRootId,
         managedWalletPassphrase: options.state.managedCoreWallet.internalPassphrase,
     });

package/dist/wallet/tx/anchor.js

@@ -394,6 +394,7 @@ export async function anchorDomain(options) {
                 dataDir: options.dataDir,
                 chain: "main",
                 startHeight: 0,
+                serviceLifetime: "ephemeral",
                 walletRootId: state.walletRootId,
             });
             const rpc = (options.rpcFactory ?? createRpcClient)(node.rpc);

package/dist/wallet/tx/bitcoin-transfer.js

@@ -131,6 +131,7 @@ export async function transferBitcoin(options) {
                 dataDir: options.dataDir,
                 chain: "main",
                 startHeight: 0,
+                serviceLifetime: "ephemeral",
                 walletRootId: state.walletRootId,
             });
             const rpc = (options.rpcFactory ?? createRpcClient)(node.rpc);

package/dist/wallet/tx/cog.js

@@ -534,6 +534,7 @@ export async function sendCog(options) {
                 dataDir: options.dataDir,
                 chain: "main",
                 startHeight: 0,
+                serviceLifetime: "ephemeral",
                 walletRootId: operation.state.walletRootId,
             });
             const rpc = (options.rpcFactory ?? createRpcClient)(node.rpc);
@@ -716,6 +717,7 @@ export async function lockCogToDomain(options) {
                 dataDir: options.dataDir,
                 chain: "main",
                 startHeight: 0,
+                serviceLifetime: "ephemeral",
                 walletRootId: operation.state.walletRootId,
             });
             const rpc = (options.rpcFactory ?? createRpcClient)(node.rpc);
@@ -875,6 +877,7 @@ async function runClaimLikeMutation(options, reclaim) {
                 dataDir: options.dataDir,
                 chain: "main",
                 startHeight: 0,
+                serviceLifetime: "ephemeral",
                 walletRootId: operation.state.walletRootId,
             });
             const rpc = (options.rpcFactory ?? createRpcClient)(node.rpc);

package/dist/wallet/tx/domain-admin.js

@@ -518,6 +518,7 @@ async function submitDomainAdminMutation(options) {
                 dataDir: options.dataDir,
                 chain: "main",
                 startHeight: 0,
+                serviceLifetime: "ephemeral",
                 walletRootId: operation.state.walletRootId,
             });
             const rpc = (options.rpcFactory ?? createRpcClient)(node.rpc);

package/dist/wallet/tx/domain-market.js

@@ -609,6 +609,7 @@ export async function transferDomain(options) {
                 dataDir: options.dataDir,
                 chain: "main",
                 startHeight: 0,
+                serviceLifetime: "ephemeral",
                 walletRootId: operation.state.walletRootId,
             });
             const rpc = (options.rpcFactory ?? createRpcClient)(node.rpc);
@@ -867,6 +868,7 @@ async function runSellMutation(options) {
                 dataDir: options.dataDir,
                 chain: "main",
                 startHeight: 0,
+                serviceLifetime: "ephemeral",
                 walletRootId: operation.state.walletRootId,
             });
             const rpc = (options.rpcFactory ?? createRpcClient)(node.rpc);
@@ -1136,6 +1138,7 @@ export async function buyDomain(options) {
                 dataDir: options.dataDir,
                 chain: "main",
                 startHeight: 0,
+                serviceLifetime: "ephemeral",
                 walletRootId: operation.state.walletRootId,
             });
             const rpc = (options.rpcFactory ?? createRpcClient)(node.rpc);

package/dist/wallet/tx/field.js

@@ -686,6 +686,7 @@ async function submitStandaloneFieldMutation(options) {
                 dataDir: options.dataDir,
                 chain: "main",
                 startHeight: 0,
+                serviceLifetime: "ephemeral",
                 walletRootId: operation.state.walletRootId,
             });
             const rpc = (options.rpcFactory ?? createRpcClient)(node.rpc);

package/dist/wallet/tx/register.js

@@ -532,6 +532,7 @@ export async function registerDomain(options) {
                 dataDir: options.dataDir,
                 chain: "main",
                 startHeight: 0,
+                serviceLifetime: "ephemeral",
                 walletRootId: state.walletRootId,
             });
             const rpc = (options.rpcFactory ?? createRpcClient)(node.rpc);

package/dist/wallet/tx/reputation.js

@@ -513,6 +513,7 @@ async function submitReputationMutation(options) {
                 dataDir: options.dataDir,
                 chain: "main",
                 startHeight: 0,
+                serviceLifetime: "ephemeral",
                 walletRootId: operation.state.walletRootId,
             });
             const rpc = (options.rpcFactory ?? createRpcClient)(node.rpc);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@cogcoin/client",
-  "version": "1.0.1",
+  "version": "1.0.2",
   "description": "Store-backed Cogcoin client with wallet flows, SQLite persistence, and managed Bitcoin Core integration.",
   "license": "MIT",
   "type": "module",
@@ -59,7 +59,8 @@
     "build": "rm -rf dist && node ./node_modules/typescript/bin/tsc -p tsconfig.json && node ./scripts/copy-static-assets.mjs build",
     "generate:default-snapshot-chunk-manifest": "node scripts/generate-default-snapshot-chunk-manifest.mjs",
     "verify:default-snapshot-chunk-manifest": "node scripts/generate-default-snapshot-chunk-manifest.mjs --check",
-    "test": "rm -rf .test-dist && node ./node_modules/typescript/bin/tsc -p tsconfig.test.json && node ./scripts/copy-static-assets.mjs test && node --test .test-dist/test/*.test.js"
+    "test": "rm -rf .test-dist && node ./node_modules/typescript/bin/tsc -p tsconfig.test.json && node ./scripts/copy-static-assets.mjs test && node --test .test-dist/test/*.test.js",
+    "test:mining": "rm -rf .test-dist && node ./node_modules/typescript/bin/tsc -p tsconfig.test-mining.json && node ./scripts/copy-static-assets.mjs test && node --test .test-dist/test/mining*.test.js"
   },
   "dependencies": {
     "@cogcoin/bitcoin": "30.2.0",