@johpaz/hive-sdk 0.1.6 → 0.2.0

package/packages/core/src/config/loader.ts

@@ -20,7 +20,14 @@ export function loadEnv(hiveDir: string): void {
         const [key, ...valueParts] = trimmed.split("=");
         if (key && valueParts.length > 0) {
           const value = valueParts.join("=").trim().replace(/^['"]|['"]$/g, "");
-          process.env[key.trim()] = value;
+          const normalizedKey = key.trim();
+          // Explicit process environment values (for example the random
+          // port assigned by the desktop shell) must take precedence over the
+          // persisted .env file. This follows dotenv conventions and prevents
+          // a previous CLI port from breaking desktop startup.
+          if (process.env[normalizedKey] === undefined) {
+            process.env[normalizedKey] = value;
+          }
         }
       }
     } catch (e) {
@@ -120,11 +127,13 @@ const BrowserConfigSchema = z.object({
   headless: z.boolean().optional(),
   timeoutMs: z.number().optional(),
   sessionName: z.string().optional(),
-  // "agent-browser" (default) usa Chrome via CLI y sirve headless/Docker.
-  // "webview" usa Bun.WebView in-process — mucho más rápido y sin instalación,
-  // pero requiere Chrome instalado (o macOS con WebKit). "auto" toma webview
-  // sólo si hay motor. Lo pisa HIVE_BROWSER_BACKEND.
+  // Queda un solo backend: Bun.WebView in-process. La clave sobrevive para no
+  // romper configs viejas —"agent-browser" se acepta, avisa y usa el WebView—
+  // y se puede quitar sin más. Lo pisa HIVE_BROWSER_BACKEND.
   backend: z.enum(["agent-browser", "webview", "auto"]).optional(),
+  // Guarda las cookies para que los logins sobrevivan a un reinicio. Default
+  // activo; apagarlo hace que cada arranque empiece sin historia.
+  persistSession: z.boolean().optional(),
 });
 
 const CanvasConfigSchema = z.object({

package/packages/core/src/events/agent-bus.ts

@@ -10,9 +10,9 @@
  */
 
 import { EventEmitter } from "events";
-import { logger } from "../utils/logger";
-import { col, nextId, toIndexable, fromIndexable, BROADCAST } from "../storage/hive";
-import type { AgentBusMessageDoc, TaskDoc } from "../storage/collections";
+import { logger } from "../utils/logger.ts";
+import { col, nextId, toIndexable, fromIndexable, BROADCAST } from "../storage/hive.ts";
+import type { AgentBusMessageDoc, TaskDoc } from "../storage/collections.ts";
 
 const log = logger.child("agent-bus");
 

package/packages/core/src/events/channel-narration.ts

@@ -6,9 +6,9 @@
 // messages before the actual answer — noise for the user and a rate-limit /
 // ban risk on WhatsApp. This module decides what reaches those channels.
 
-import { col } from "../storage/hive";
-import type { ChannelDoc, NarrationEventDoc } from "../storage/collections";
-import { logger } from "../utils/logger";
+import { col } from "../storage/hive.ts";
+import type { ChannelDoc, NarrationEventDoc } from "../storage/collections.ts";
+import { logger } from "../utils/logger.ts";
 
 const log = logger.child("narration:channel");
 

package/packages/core/src/events/event-bus.ts

@@ -1,5 +1,5 @@
 import { EventEmitter } from "events";
-import { logger } from "../utils/logger";
+import { logger } from "../utils/logger.ts";
 
 export interface EventMap {
   "message:received": {

package/packages/core/src/events/narration.ts

@@ -1,7 +1,7 @@
 import { createHash } from "node:crypto";
-import { col } from "../storage/hive";
-import type { NarrationEventDoc } from "../storage/collections";
-import { logger } from "../utils/logger";
+import { col } from "../storage/hive.ts";
+import type { NarrationEventDoc } from "../storage/collections.ts";
+import { logger } from "../utils/logger.ts";
 
 const log = logger.child("narration");
 

package/packages/core/src/gateway/delegation-groups.ts

@@ -1,10 +1,10 @@
-import { col } from "../storage/hive";
+import { col } from "../storage/hive.ts";
 import type {
   DelegationGroupDoc,
   DelegationGroupOutcome,
-} from "../storage/collections";
-import { logger } from "../utils/logger";
-import { publishNarration } from "../events/narration";
+} from "../storage/collections.ts";
+import { logger } from "../utils/logger.ts";
+import { publishNarration } from "../events/narration.ts";
 
 const log = logger.child("delegation-groups");
 const MAX_RETRIES = 8;

package/packages/core/src/gateway/durable-queue.ts

@@ -14,7 +14,7 @@
  * is preserved, while all queue state is mirrored to the DB.
  */
 
-import { logger } from "../utils/logger";
+import { logger } from "../utils/logger.ts";
 import {
   createJob,
   claimJob,
@@ -30,9 +30,9 @@ import {
   loadJobRetryPolicy,
   DEFAULT_JOB_RETRY_POLICY,
   type JobRetryPolicy,
-} from "./job-store";
-import type { JobDoc } from "../storage/collections";
-import { getBootId } from "../storage/boot-id";
+} from "./job-store.ts";
+import type { JobDoc } from "../storage/collections.ts";
+import { getBootId } from "../storage/boot-id.ts";
 
 const log = logger.child("durable-queue");
 
@@ -287,7 +287,7 @@ export class DurableLaneQueue {
     let leasedHere = true;
     const leaseRenewer = setInterval(async () => {
       if (leasedHere) {
-        const { renewLease } = await import("./job-store");
+        const { renewLease } = await import("./job-store.ts");
         await renewLease(job.id, this.bootId).catch(() => {});
       }
     }, 30_000);

package/packages/core/src/gateway/job-store.ts

@@ -5,11 +5,11 @@
  * path guarantees only one process wins the race for the same job.
  */
 
-import { col, nextId, updateDoc, toIndexable } from "../storage/hive";
-import type { JobDoc } from "../storage/collections";
-import { getBootId } from "../storage/boot-id";
-import { logger } from "../utils/logger";
-import { loadConfig } from "../config/loader";
+import { col, nextId, updateDoc, toIndexable } from "../storage/hive.ts";
+import type { JobDoc } from "../storage/collections.ts";
+import { getBootId } from "../storage/boot-id.ts";
+import { logger } from "../utils/logger.ts";
+import { loadConfig } from "../config/loader.ts";
 
 const log = logger.child("job-store");
 

package/packages/core/src/gateway/notification-inbox.ts

@@ -1,6 +1,6 @@
 import { randomUUID } from "node:crypto";
-import type { NotificationDoc } from "../storage/collections";
-import { col, updateDoc } from "../storage/hive";
+import type { NotificationDoc } from "../storage/collections.ts";
+import { col, updateDoc } from "../storage/hive.ts";
 
 export async function createNotification(input: {
   userId: string;

package/packages/core/src/gateway/server.ts

@@ -7,9 +7,9 @@
  * - WebSocket /ws — real-time streaming
  */
 
-import { logger } from "../utils/logger";
+import { logger } from "../utils/logger.ts";
 import { runAgent } from "../agent/agent-loop.ts";
-import type { MCPClientManager } from "../mcp/index";
+import type { MCPClientManager } from "../mcp/index.ts";
 
 const log = logger.child("gateway");
 

package/packages/core/src/mcp/MCPClient.ts

@@ -1,12 +1,12 @@
 import { Client } from "@modelcontextprotocol/sdk/client/index.js";
 import type { Transport } from "@modelcontextprotocol/sdk/shared/transport.js";
-import type { MCPConfig, MCPServerConfig } from "./config";
-import { logger, type LogHandler } from "./logger";
+import type { MCPConfig, MCPServerConfig } from "./config.ts";
+import { logger, type LogHandler } from "./logger.ts";
 import * as path from "node:path";
 import {
   createTransport,
   type TransportType,
-} from "./transports/index";
+} from "./transports/index.ts";
 
 export interface MCPTool {
   name: string;

package/packages/core/src/mcp/hot-reload.ts

@@ -8,11 +8,11 @@
  * - MCP tools are loaded at runtime from connected servers (not stored in DB)
  */
 
-import { col, updateDoc } from "../storage/hive";
-import type { McpServerDoc } from "../storage/collections";
-import { logger } from "../utils/logger";
-import { loadMcpHeaders } from "../storage/crypto";
-import { syncMCPToolsToDB, syncMCPToolsToIndex, clearMCPToolsFromDB } from "./tool-sync";
+import { col, updateDoc } from "../storage/hive.ts";
+import type { McpServerDoc } from "../storage/collections.ts";
+import { logger } from "../utils/logger.ts";
+import { loadMcpHeaders } from "../storage/crypto.ts";
+import { syncMCPToolsToDB, syncMCPToolsToIndex, clearMCPToolsFromDB } from "./tool-sync.ts";
 import type { MCPClientManager } from "./MCPClient.ts";
 
 const log = logger.child("mcp:hot-reload");

package/packages/core/src/mcp/tool-sync.ts

@@ -13,15 +13,15 @@
  * 3. Offline visibility of what MCP tools were available
  */
 
-import { col } from "../storage/hive"
-import type { McpToolDoc } from "../storage/collections"
-import { logger } from "../utils/logger"
-import { mcpToolFullName } from "../agent/tool-selector"
+import { col } from "../storage/hive.ts"
+import type { McpToolDoc } from "../storage/collections.ts"
+import { logger } from "../utils/logger.ts"
+import { mcpToolFullName } from "../agent/tool-selector.ts"
 import {
     replaceCapabilityDocs,
     deleteCapabilitiesByServer,
     type CapabilityDoc,
-} from "../agent/capability-search"
+} from "../agent/capability-search.ts"
 
 const log = logger.child("mcp:tool-sync")
 

package/packages/core/src/mcp/transports/index.ts

@@ -4,8 +4,8 @@ import type { Transport } from "@modelcontextprotocol/sdk/shared/transport.js";
 // CORRECCIÓN 1 — quitar extensión .ts de los imports
 // Bun resuelve los módulos sin extensión correctamente
 // Con .ts puede fallar en algunos contextos de build/bundle
-import { SSETransport, type SSETransportConfig } from "./sse";
-import { WebSocketTransport, type WebSocketTransportConfig } from "./websocket";
+import { SSETransport, type SSETransportConfig } from "./sse.ts";
+import { WebSocketTransport, type WebSocketTransportConfig } from "./websocket.ts";
 
 export { SSETransport, type SSETransportConfig };
 export { WebSocketTransport, type WebSocketTransportConfig };

package/packages/core/src/mcp/transports/sse.ts

@@ -1,5 +1,5 @@
 import type { Transport } from "@modelcontextprotocol/sdk/shared/transport.js";
-import { logger } from "../logger";
+import { logger } from "../logger.ts";
 
 export interface SSETransportConfig {
   url: string;                        // URL base

package/packages/core/src/models/index.ts

@@ -0,0 +1,36 @@
+/**
+ * Models — el catálogo de proveedores y modelos con el que arranca una colmena.
+ *
+ * El "seed de modelos" ya existía, pero repartido en `storage/`: los datos en
+ * `seed.ts`, las claves en `model-id.ts`, el precio en `usage.ts`. Quien quería
+ * consumirlo tenía que saber que un catálogo de modelos vive bajo "storage".
+ * Esto le da nombre y un punto de entrada; no mueve la implementación ni
+ * duplica nada.
+ *
+ * `SEED_DATA` es la fuente de verdad del catálogo (18 proveedores, ~110 modelos)
+ * y `seedAllData()` la aplica de forma idempotente en cada arranque — la llama
+ * `ensureHiveDb()`, así que normalmente no hace falta invocarla a mano.
+ *
+ * Nota de precios: cada modelo LLM declara `inputPer1M`/`outputPer1M`. Un modelo
+ * sin ellos no es "gratis", es un modelo cuyo costo no se puede calcular.
+ */
+
+// ─── Catálogo ────────────────────────────────────────────────────────────────
+export { SEED_DATA, seedAllData, seedToolsAndSkills } from "../storage/seed.ts";
+export type { SeedData } from "../storage/seed.ts";
+export { activateElement, deactivateElement, getAllElements, getActiveElements } from "../storage/seed.ts";
+
+// ─── Identidad de modelo ─────────────────────────────────────────────────────
+/**
+ * Los revendedores (openrouter, nvidia, groq, opencode-go, modelscope) sirven
+ * modelos de terceros bajo su propio endpoint, así que el id del wire colisiona
+ * entre proveedores. `catalogModelKey` prefija; `wireModelId` deshace el prefijo
+ * antes de salir a la API.
+ */
+export { catalogModelKey, wireModelId, isResellerProvider } from "../storage/model-id.ts";
+
+// ─── Costos ──────────────────────────────────────────────────────────────────
+export { calculateCost, invalidateModelPricingCache } from "../storage/usage.ts";
+
+// ─── Shapes ──────────────────────────────────────────────────────────────────
+export type { ModelDoc, ProviderDoc } from "../storage/collections.ts";

package/packages/core/src/multimodal/index.ts

@@ -1,2 +1,2 @@
-export type { ContentPart, ImageInput, DocumentInput, VisionConfig, MultimodalMessageType } from "./types"
-export { multimodalService } from "./vision-service"
+export type { ContentPart, ImageInput, DocumentInput, VisionConfig, MultimodalMessageType } from "./types.ts"
+export { multimodalService } from "./vision-service.ts"

package/packages/core/src/multimodal/vision-service.ts

@@ -1,9 +1,9 @@
-import { col } from "../storage/hive"
-import type { ChannelDoc, ModelDoc, ProviderDoc } from "../storage/collections"
-import { loadProviderApiKey } from "../storage/crypto"
-import { logger } from "../utils/logger"
-import type { ImageInput, DocumentInput, VisionConfig } from "./types"
-import type { ContentPart } from "./types"
+import { col } from "../storage/hive.ts"
+import type { ChannelDoc, ModelDoc, ProviderDoc } from "../storage/collections.ts"
+import { loadProviderApiKey } from "../storage/crypto.ts"
+import { logger } from "../utils/logger.ts"
+import type { ImageInput, DocumentInput, VisionConfig } from "./types.ts"
+import type { ContentPart } from "./types.ts"
 
 const log = logger.child("multimodal")
 

package/packages/core/src/plugins/loader.ts

@@ -30,7 +30,10 @@ export class PluginLoader {
   private commands: Map<string, CLICommand> = new Map();
   private log = logger.child("plugins");
 
-  constructor(private options: PluginLoaderOptions) {
+  private options: PluginLoaderOptions;
+
+  constructor(options: PluginLoaderOptions) {
+    this.options = options;
     if (!existsSync(options.pluginDir)) {
       mkdirSync(options.pluginDir, { recursive: true });
     }

package/packages/core/src/resilience/circuit-breaker.ts

@@ -39,10 +39,16 @@ export class CircuitBreaker {
   private totalFailures = 0;
   private totalSuccesses = 0;
 
+  private readonly name: string;
+  private readonly options: CircuitBreakerOptions;
+
   constructor(
-    private readonly name: string,
-    private readonly options: CircuitBreakerOptions = defaultOptions
-  ) { }
+    name: string,
+    options: CircuitBreakerOptions = defaultOptions
+  ) {
+    this.name = name;
+    this.options = options;
+  }
 
   async execute<T>(fn: () => Promise<T>): Promise<T> {
     if (this.state === "open") {
@@ -175,12 +181,17 @@ export class CircuitBreaker {
 }
 
 export class CircuitBreakerOpenError extends Error {
+  public readonly circuitName: string;
+  public readonly retryAfterMs: number;
+
   constructor(
     message: string,
-    public readonly circuitName: string,
-    public readonly retryAfterMs: number
+    circuitName: string,
+    retryAfterMs: number
   ) {
     super(message);
+    this.circuitName = circuitName;
+    this.retryAfterMs = retryAfterMs;
     this.name = "CircuitBreakerOpenError";
   }
 }

package/packages/core/src/resilience/retry.ts

@@ -5,7 +5,7 @@
  * only decides whether a single call should be retried and how long to wait.
  */
 
-import { logger } from "../utils/logger";
+import { logger } from "../utils/logger.ts";
 
 const log = logger.child("retry");
 

package/packages/core/src/scheduler/CronScheduler.ts

@@ -6,11 +6,11 @@
  */
 
 import { Cron } from "croner";
-import { logger } from "../utils/logger";
-import { notifyTaskCompletion } from "./integration";
-import { col, toIndexable, fromIndexable } from "../storage/hive";
-import type { CronJobDoc, TaskRunDoc } from "../storage/collections";
-import { expireArtifacts } from "../artifacts/store";
+import { logger } from "../utils/logger.ts";
+import { notifyTaskCompletion } from "./integration.ts";
+import { col, toIndexable, fromIndexable } from "../storage/hive.ts";
+import type { CronJobDoc, TaskRunDoc } from "../storage/collections.ts";
+import { expireArtifacts } from "../artifacts/store.ts";
 import type {
   CronJob,
   TaskRun,
@@ -18,7 +18,7 @@ import type {
   UpdateCronJobInput,
   CronJobStatus,
   CronJobExecutionHandler,
-} from "./types";
+} from "./types.ts";
 
 const log = logger.child("CronScheduler");
 

package/packages/core/src/scheduler/integration.ts

@@ -5,16 +5,16 @@
  * Converts cron jobs into system messages that flow through the agent system.
  */
 
-import type { CronJob, CronJobExecutionResult } from "./types";
-import { logger } from "../utils/logger";
-import { buildAgentLoop } from "../agent/agent-loop";
-import { resolveAgentId } from "../storage/onboarding";
-import { sendToUserChannel } from "../gateway/channel-notify";
+import type { CronJob, CronJobExecutionResult } from "./types.ts";
+import { logger } from "../utils/logger.ts";
+import { buildAgentLoop } from "../agent/agent-loop.ts";
+import { resolveAgentId } from "../storage/onboarding.ts";
+import { sendToUserChannel } from "../gateway/channel-notify.ts";
 import { getNarration } from "../events/tool-narration.ts";
-import { addMessage } from "../agent/conversation-store";
-import { resolveBestChannel } from "../tools/cron/index";
-import { col } from "../storage/hive";
-import type { UserDoc, CronJobDoc } from "../storage/collections";
+import { addMessage } from "../agent/conversation-store.ts";
+import { resolveBestChannel } from "../tools/cron/index.ts";
+import { col } from "../storage/hive.ts";
+import type { UserDoc, CronJobDoc } from "../storage/collections.ts";
 
 const log = logger.child("SchedulerIntegration");