hive-intelligence 1.6.7 → 1.7.2

package/build/{chunk-P7NLFSZQ.js → chunk-RNVZIPNY.js}

@@ -1,4 +1,7 @@
 import { createRequire } from 'node:module'; const require = createRequire(import.meta.url);
+import {
+  NEVER_RETRY_ERROR_CODES
+} from "./chunk-ZSPPJW4G.js";
 import {
   SERVER_VERSION
 } from "./chunk-ZXKFJQDE.js";
@@ -9,6 +12,56 @@ import {
 } from "./chunk-6PC3HUAK.js";
 
 // src/cli/api-client.ts
+function errorCodeFromBody(body) {
+  if (!body || typeof body !== "object") return null;
+  const error = body.error;
+  if (!error || typeof error !== "object") return null;
+  const direct = error.code;
+  if (typeof direct === "string") return direct;
+  const nested = error.data?.code;
+  return typeof nested === "string" ? nested : null;
+}
+async function peekErrorCode(response) {
+  if (typeof response.clone !== "function") return null;
+  try {
+    return errorCodeFromBody(await response.clone().json());
+  } catch {
+    return null;
+  }
+}
+function parseRetryAfter(header) {
+  if (header == null || header === "") return null;
+  const seconds = Number.parseInt(header, 10);
+  return Number.isFinite(seconds) && seconds >= 0 ? seconds : null;
+}
+function attachResponseMeta(data, response, now = Date.now()) {
+  const meta = { ...data.meta ?? {} };
+  const quotaHeader = response.headers?.get?.("x-quota-remaining");
+  if (quotaHeader != null && quotaHeader !== "") {
+    const quotaRemaining = Number.parseInt(quotaHeader, 10);
+    if (Number.isFinite(quotaRemaining)) meta.quota_remaining = quotaRemaining;
+  }
+  if ("credits_remaining" in meta) {
+    const credits = meta.credits_remaining;
+    if (credits === null || typeof credits === "number") {
+      meta.quota_remaining = credits;
+    }
+  }
+  const retryAfter = parseRetryAfter(response.headers?.get?.("retry-after"));
+  const bodyResetAt = [
+    data.reset_at,
+    data.error?.reset_at,
+    data.error?.data?.reset_at,
+    meta.reset_at
+  ].find((value) => typeof value === "string" && value !== "");
+  if (retryAfter !== null) meta.retry_after_seconds = retryAfter;
+  if (bodyResetAt) {
+    meta.reset_at = bodyResetAt;
+  } else if (retryAfter !== null) {
+    meta.reset_at = new Date(now + retryAfter * 1e3).toISOString();
+  }
+  return { ...data, meta };
+}
 var MAX_RETRIES = 3;
 var BASE_DELAY_MS = 500;
 var MAX_DELAY_MS = 5e3;
@@ -44,6 +97,8 @@ async function fetchWithRetry(url, init, fetchFn = fetch) {
       if (response.ok || !isRetryable(response.status) || attempt === maxRetries) {
         return response;
       }
+      const code = await peekErrorCode(response);
+      if (code && NEVER_RETRY_ERROR_CODES.has(code)) return response;
       lastResponse = response;
       const retryAfter = response.headers?.get?.("retry-after") ?? null;
       const waitMs = computeDelay(attempt, retryAfter);
@@ -87,14 +142,7 @@ async function executeRemoteTool(toolName, args, timeoutMs = 3e4) {
       signal: controller.signal
     });
     const data = await response.json();
-    const quotaHeader = response.headers?.get?.("x-quota-remaining");
-    if (quotaHeader != null && quotaHeader !== "") {
-      const quotaRemaining = Number.parseInt(quotaHeader, 10);
-      if (Number.isFinite(quotaRemaining)) {
-        data.meta = { ...data.meta ?? {}, quota_remaining: quotaRemaining };
-      }
-    }
-    return data;
+    return attachResponseMeta(data, response);
   } catch (error) {
     if (error instanceof Error && error.name === "AbortError") {
       return {
@@ -192,10 +240,53 @@ async function getUsage() {
   });
   return response.json();
 }
+var SMALL_REQUEST_TIMEOUT_MS = 1e4;
+async function parseJsonBody(response) {
+  try {
+    const body = await response.json();
+    return body && typeof body === "object" ? body : null;
+  } catch {
+    return null;
+  }
+}
+async function postFeedback(payload) {
+  const url = buildApiUrl("/api/v1/feedback");
+  const response = await fetchWithRetry(url, {
+    method: "POST",
+    headers: getHeaders(resolveApiKey()),
+    body: JSON.stringify(payload),
+    signal: AbortSignal.timeout(SMALL_REQUEST_TIMEOUT_MS)
+  });
+  const body = await parseJsonBody(response);
+  if (!body) {
+    return {
+      ok: false,
+      error: {
+        code: "API_ERROR",
+        message: `Feedback endpoint answered HTTP ${response.status} without a JSON body`,
+        suggestion: `Check HIVE_API_URL (${resolveApiUrl()})`
+      },
+      meta: { http_status: response.status }
+    };
+  }
+  return attachResponseMeta(body, response);
+}
+async function getAnonQuota() {
+  const url = buildApiUrl("/api/v1/quota");
+  const response = await fetchWithRetry(url, {
+    headers: getHeaders(),
+    signal: AbortSignal.timeout(SMALL_REQUEST_TIMEOUT_MS)
+  });
+  return { status: response.status, body: await parseJsonBody(response) };
+}
 
 export {
+  errorCodeFromBody,
+  attachResponseMeta,
   fetchWithRetry,
   executeRemoteTool,
   fetchToolCatalog,
-  getUsage
+  getUsage,
+  postFeedback,
+  getAnonQuota
 };

package/build/chunk-XN3T6YOG.js

@@ -0,0 +1,32 @@
+import { createRequire } from 'node:module'; const require = createRequire(import.meta.url);
+import {
+  ensureConfigDir,
+  getConfigDir,
+  readJsonFile,
+  writeJsonFile
+} from "./chunk-6PC3HUAK.js";
+
+// src/cli/last-receipt.ts
+import { join } from "path";
+function lastReceiptPath() {
+  return join(getConfigDir(), "last-receipt.json");
+}
+function saveLastReceipt(receipt) {
+  try {
+    ensureConfigDir();
+    writeJsonFile(lastReceiptPath(), receipt);
+  } catch {
+  }
+}
+function readLastReceipt() {
+  const stored = readJsonFile(lastReceiptPath());
+  if (!stored || typeof stored.receipt_id !== "string" || typeof stored.tool !== "string" || typeof stored.at !== "string") {
+    return null;
+  }
+  return { receipt_id: stored.receipt_id, tool: stored.tool, at: stored.at };
+}
+
+export {
+  saveLastReceipt,
+  readLastReceipt
+};

package/build/{chunk-KUF754NT.js → chunk-YLHNUAFT.js}

@@ -1,16 +1,23 @@
 import { createRequire } from 'node:module'; const require = createRequire(import.meta.url);
+import {
+  saveLastReceipt
+} from "./chunk-XN3T6YOG.js";
 import {
   executeRemoteTool
-} from "./chunk-P7NLFSZQ.js";
+} from "./chunk-RNVZIPNY.js";
 import {
   trackCommand
 } from "./chunk-RU6QOFHH.js";
+import {
+  ExitCode
+} from "./chunk-ZSPPJW4G.js";
 import {
   debug,
   dim,
+  isQuiet,
   shouldOutputJson,
   writeOutput
-} from "./chunk-LP5ECG7A.js";
+} from "./chunk-ZDXMZPC6.js";
 import {
   resolveApiKey
 } from "./chunk-6PC3HUAK.js";
@@ -79,8 +86,38 @@ function remapForKeylessHero(toolName, args) {
 }
 
 // src/cli/execute.ts
+var EXIT_CODE_BY_ERROR = {
+  TOOL_NOT_FOUND: ExitCode.TOOL_NOT_FOUND,
+  TOOL_RETIRED: ExitCode.TOOL_NOT_FOUND,
+  PROVIDER_UNAVAILABLE: ExitCode.AUTH_FAILURE,
+  RATE_LIMITED: ExitCode.RATE_LIMITED,
+  TIMEOUT: ExitCode.TIMEOUT,
+  // Cap lane (exit 6): the call is outside what this credential can do
+  // today; the human message carries the reset time.
+  ANON_QUOTA_EXCEEDED: ExitCode.RATE_LIMITED,
+  ANON_GLOBAL_CAP_EXCEEDED: ExitCode.RATE_LIMITED,
+  ANON_AUTH_REQUIRED: ExitCode.RATE_LIMITED,
+  QUOTA_EXCEEDED: ExitCode.RATE_LIMITED,
+  FEEDBACK_RATE_LIMITED: ExitCode.RATE_LIMITED,
+  // Account state, not a cap: no reset time, retrying cannot help.
+  NO_WALLET: ExitCode.API_ERROR
+};
+function exitCodeForError(code) {
+  return code && EXIT_CODE_BY_ERROR[code] || ExitCode.API_ERROR;
+}
+function creditFooter(meta, keyed) {
+  if (!meta) return null;
+  if (keyed) {
+    if (typeof meta.credits_used !== "number") return null;
+    const remaining = meta.credits_remaining === null ? "unlimited" : typeof meta.credits_remaining === "number" ? String(meta.credits_remaining) : null;
+    return remaining === null ? `credits: used ${meta.credits_used}` : `credits: used ${meta.credits_used}, remaining ${remaining}`;
+  }
+  if (typeof meta.quota_remaining !== "number") return null;
+  return `free calls left today: ${meta.quota_remaining} (run \`hive auth login\` for a full key)`;
+}
 async function executeTool(toolName, args, timeoutMs = 3e4) {
-  if (!resolveApiKey()) {
+  const keyed = Boolean(resolveApiKey());
+  if (!keyed) {
     const remap = remapForKeylessHero(toolName, args);
     if (remap) {
       debug(remap.note);
@@ -106,17 +143,20 @@ async function executeTool(toolName, args, timeoutMs = 3e4) {
     response.ok ? void 0 : response.error?.code
   );
   await writeOutput(response);
-  const quotaRemaining = response.meta?.quota_remaining;
-  if (typeof quotaRemaining === "number" && !resolveApiKey() && !shouldOutputJson()) {
-    process.stderr.write(
-      dim(
-        `${quotaRemaining} free call${quotaRemaining === 1 ? "" : "s"} left today. Run \`hive auth login\` for a full key.`
-      ) + "\n"
-    );
+  const receiptId = response.meta?.receipt_id;
+  if (response.ok && typeof receiptId === "string" && receiptId) {
+    saveLastReceipt({
+      receipt_id: receiptId,
+      tool: toolName,
+      at: (/* @__PURE__ */ new Date()).toISOString()
+    });
+  }
+  const footer = creditFooter(response.meta, keyed);
+  if (footer && !shouldOutputJson() && !isQuiet()) {
+    process.stderr.write(dim(footer) + "\n");
   }
   if (!response.ok) {
-    const exitCode = response.error?.code === "TOOL_NOT_FOUND" || response.error?.code === "TOOL_RETIRED" ? 3 : response.error?.code === "PROVIDER_UNAVAILABLE" ? 5 : response.error?.code === "RATE_LIMITED" ? 6 : response.error?.code === "TIMEOUT" ? 124 : 4;
-    process.exit(exitCode);
+    process.exit(exitCodeForError(response.error?.code));
   }
 }
 

package/build/{chunk-G23ZAW36.js → chunk-ZBMMJ6LE.js}

@@ -7,7 +7,7 @@ import {
   getSupabaseAdmin,
   resolveEndpoint,
   secureLogger
-} from "./chunk-J2PXISXW.js";
+} from "./chunk-LP7PDQCO.js";
 
 // src/services/wallet-service.ts
 async function consumeCredits(args) {
@@ -134,7 +134,8 @@ async function executeToolByName(toolName, args, options) {
     requestId: options?.requestId,
     clients: getSharedClients(),
     analytics: options?.analytics,
-    beforeExecution: options?.beforeExecution
+    beforeExecution: options?.beforeExecution,
+    creditCost: options?.creditCost
   });
   if (result.validationErrors) {
     return {

package/build/{chunk-LP5ECG7A.js → chunk-ZDXMZPC6.js}

@@ -119,6 +119,9 @@ function shouldOutputJson() {
   if (globalOpts.pretty) return false;
   return !process.stdout.isTTY;
 }
+function isQuiet() {
+  return Boolean(globalOpts.quiet);
+}
 function colorEnabled() {
   if (globalOpts.noColor) return false;
   if (process.env.NO_COLOR) return false;
@@ -140,6 +143,20 @@ function dim(s) {
 function bold(s) {
   return colorEnabled() ? `\x1B[1m${s}\x1B[0m` : s;
 }
+function formatDuration(totalSeconds) {
+  const seconds = Math.max(0, Math.round(totalSeconds));
+  const hours = Math.floor(seconds / 3600);
+  const minutes = Math.floor(seconds % 3600 / 60);
+  const rest = seconds % 60;
+  if (hours > 0) return `${hours}h ${minutes}m`;
+  if (minutes > 0) return `${minutes}m ${rest}s`;
+  return `${rest}s`;
+}
+function describeReset(meta) {
+  if (!meta.reset_at) return null;
+  const relative = typeof meta.retry_after_seconds === "number" ? ` (in ${formatDuration(meta.retry_after_seconds)})` : "";
+  return `Resets: ${meta.reset_at}${relative}`;
+}
 function successEnvelope(data, meta) {
   return { ok: true, data, meta };
 }
@@ -219,7 +236,9 @@ async function writeOutput(envelope) {
 `));
     }
     if (envelope.meta.truncated) {
-      process.stderr.write(yellow("Evidence warning: response was truncated.\n"));
+      process.stderr.write(
+        yellow("Evidence warning: response was truncated.\n")
+      );
     }
     for (const warning of envelope.meta.warnings ?? []) {
       process.stderr.write(yellow(`Evidence warning: ${warning}
@@ -247,11 +266,14 @@ async function writeOutput(envelope) {
 `)
       );
     }
-    const nextAction = envelope.meta?.next_action;
+    const nextAction = envelope.meta.next_action;
     if (typeof nextAction === "string" && nextAction.trim()) {
       process.stderr.write(yellow(`  Next: ${nextAction}
 `));
     }
+    const reset = describeReset(envelope.meta);
+    if (reset) process.stderr.write(yellow(`  ${reset}
+`));
   }
 }
 async function outputSuccess(data, meta) {
@@ -289,12 +311,14 @@ function formatCsv(data) {
 export {
   setOutputOptions,
   shouldOutputJson,
+  isQuiet,
   colorEnabled,
   red,
   green,
   yellow,
   dim,
   bold,
+  describeReset,
   successEnvelope,
   errorEnvelope,
   writeOutput,

package/build/{chunk-S4HBVZ7O.js → chunk-ZSPPJW4G.js}

@@ -12,6 +12,14 @@ var ExitCode = {
   RATE_LIMITED: 6,
   TIMEOUT: 124
 };
+var NEVER_RETRY_ERROR_CODES = /* @__PURE__ */ new Set([
+  "ANON_QUOTA_EXCEEDED",
+  "ANON_GLOBAL_CAP_EXCEEDED",
+  "ANON_AUTH_REQUIRED",
+  "QUOTA_EXCEEDED",
+  "NO_WALLET",
+  "FEEDBACK_RATE_LIMITED"
+]);
 var ERROR_CODE_TO_EXIT = {
   GENERAL_ERROR: ExitCode.GENERAL_ERROR,
   INVALID_ARGS: ExitCode.INVALID_ARGS,
@@ -22,16 +30,45 @@ var ERROR_CODE_TO_EXIT = {
   AUTH_REQUIRED: ExitCode.AUTH_FAILURE,
   RATE_LIMITED: ExitCode.RATE_LIMITED,
   TIMEOUT: ExitCode.TIMEOUT,
-  VALIDATION_ERROR: ExitCode.INVALID_ARGS
+  VALIDATION_ERROR: ExitCode.INVALID_ARGS,
+  // Cap lane: exit 6, the same class as RATE_LIMITED, because the fix is
+  // "wait for the reset or bring a key", not "fix the call".
+  ANON_QUOTA_EXCEEDED: ExitCode.RATE_LIMITED,
+  ANON_GLOBAL_CAP_EXCEEDED: ExitCode.RATE_LIMITED,
+  ANON_AUTH_REQUIRED: ExitCode.RATE_LIMITED,
+  QUOTA_EXCEEDED: ExitCode.RATE_LIMITED,
+  FEEDBACK_RATE_LIMITED: ExitCode.RATE_LIMITED,
+  // Account state, not a cap: there is no reset time and retrying cannot help.
+  NO_WALLET: ExitCode.API_ERROR,
+  // Credential rejected: same class as AUTH_REQUIRED, because the fix is the
+  // key, not the call.
+  UNAUTHORIZED: ExitCode.AUTH_FAILURE,
+  INVALID_API_KEY: ExitCode.AUTH_FAILURE,
+  // The server answered, the call failed there.
+  TOOL_ERROR: ExitCode.API_ERROR,
+  INTERNAL_ERROR: ExitCode.API_ERROR
 };
+var ERROR_DOCS_BASE = "https://www.hiveintelligence.xyz/errors#";
+function errorDocSlug(code) {
+  return code.toLowerCase().replace(/_/g, "-");
+}
 var ERROR_DOC_URLS = {
   AUTH_REQUIRED: "https://www.hiveintelligence.xyz/errors#auth-required",
   RATE_LIMITED: "https://www.hiveintelligence.xyz/errors#rate-limited",
   TIMEOUT: "https://www.hiveintelligence.xyz/errors#timeout",
   PROVIDER_UNAVAILABLE: "https://www.hiveintelligence.xyz/errors#provider-unavailable",
   TOOL_NOT_FOUND: "https://www.hiveintelligence.xyz/errors#tool-not-found",
-  TOOL_RETIRED: "https://www.hiveintelligence.xyz/errors#tool-retired"
+  TOOL_RETIRED: "https://www.hiveintelligence.xyz/errors#tool-retired",
+  ANON_QUOTA_EXCEEDED: `${ERROR_DOCS_BASE}${errorDocSlug("ANON_QUOTA_EXCEEDED")}`,
+  ANON_GLOBAL_CAP_EXCEEDED: `${ERROR_DOCS_BASE}${errorDocSlug("ANON_GLOBAL_CAP_EXCEEDED")}`,
+  ANON_AUTH_REQUIRED: `${ERROR_DOCS_BASE}${errorDocSlug("ANON_AUTH_REQUIRED")}`,
+  QUOTA_EXCEEDED: `${ERROR_DOCS_BASE}${errorDocSlug("QUOTA_EXCEEDED")}`,
+  NO_WALLET: `${ERROR_DOCS_BASE}${errorDocSlug("NO_WALLET")}`,
+  FEEDBACK_RATE_LIMITED: `${ERROR_DOCS_BASE}${errorDocSlug("FEEDBACK_RATE_LIMITED")}`
 };
+function isCliErrorCode(code) {
+  return typeof code === "string" && code in ERROR_CODE_TO_EXIT;
+}
 var CliError = class extends Error {
   code;
   exitCode;
@@ -61,11 +98,7 @@ function classifyError(error, toolName) {
     );
   }
   if (lower.includes("api key") || lower.includes("unauthorized") || lower.includes("not configured") || lower.includes("unavailable")) {
-    return new CliError(
-      "PROVIDER_UNAVAILABLE",
-      msg,
-      "Run: hive auth login"
-    );
+    return new CliError("PROVIDER_UNAVAILABLE", msg, "Run: hive auth login");
   }
   if (lower.includes("not found") && toolName) {
     return new CliError(
@@ -82,7 +115,11 @@ function suggestSimilarTools(input, toolNames, maxDistance = 3) {
 
 export {
   ExitCode,
+  NEVER_RETRY_ERROR_CODES,
+  ERROR_CODE_TO_EXIT,
+  errorDocSlug,
   ERROR_DOC_URLS,
+  isCliErrorCode,
   CliError,
   classifyError,
   suggestSimilarTools