theokit 0.1.0-alpha.6 → 0.2.0

package/dist/server/cost/index.d.ts

@@ -90,6 +90,8 @@ interface TrackAgentRunInput {
     costUsd: number;
     /** Defaults to `new Date()`. */
     timestamp?: Date;
+    /** Optional execution status surfaced to devtools (default 'finished'). */
+    status?: 'finished' | 'error' | 'aborted';
 }
 interface TrackAgentRunOptions {
     /** Adapter resolved from `theo.config.ts > cost.storage`. */
@@ -106,6 +108,11 @@ interface TrackAgentRunOptions {
  *
  * No-op when `storage` is undefined (cost tracking unconfigured).
  *
+ * In dev mode (Vite OR tsup-built with NODE_ENV != 'production'), fires a
+ * `theokit-evolution-ci-and-dx` Phase 3 dispatcher event so the devtools
+ * Agents tab can render the run. Prod tree-shakes the entire dispatcher
+ * import via the `__IS_DEV` IIFE guard.
+ *
  * @see docs/concepts/cost-tracking.md (when implemented in T6.3)
  */
 declare function trackAgentRun(input: TrackAgentRunInput, opts: TrackAgentRunOptions): Promise<void>;

package/dist/server/cost/index.js

@@ -2,7 +2,7 @@ import {
   InMemoryUsageStorage,
   trackAgentRun,
   trackAgentTools
-} from "../../chunk-MCP6Y5BA.js";
+} from "../../chunk-JBC7PFV4.js";
 import "../../chunk-DGUM43GV.js";
 export {
   InMemoryUsageStorage,

package/dist/server/index.js

@@ -28,7 +28,7 @@ import {
   InMemoryUsageStorage,
   trackAgentRun,
   trackAgentTools
-} from "../chunk-MCP6Y5BA.js";
+} from "../chunk-JBC7PFV4.js";
 import {
   CRON_MANIFEST_SCHEMA_VERSION,
   DuplicateCronNameError,
@@ -551,6 +551,53 @@ async function* streamAgentRun(run) {
   }
 }
 
+// src/server/agent/provider-resolver.ts
+var DEFAULT_REGISTRY = [
+  {
+    name: "openrouter",
+    envKey: "OPENROUTER_API_KEY",
+    baseUrl: "https://openrouter.ai/api/v1",
+    priority: 1
+  },
+  {
+    name: "openai",
+    envKey: "OPENAI_API_KEY",
+    baseUrl: "https://api.openai.com/v1",
+    priority: 2
+  },
+  {
+    name: "anthropic",
+    envKey: "ANTHROPIC_API_KEY",
+    baseUrl: "https://api.anthropic.com",
+    priority: 3
+  }
+];
+var registry = [...DEFAULT_REGISTRY];
+function resolveProvider() {
+  const sorted = [...registry].sort((a, b) => a.priority - b.priority);
+  for (const desc of sorted) {
+    const apiKey = process.env[desc.envKey];
+    if (apiKey && apiKey.length > 0) {
+      return {
+        name: desc.name,
+        apiKey,
+        baseUrl: desc.baseUrl
+      };
+    }
+  }
+  const envKeys = sorted.map((p) => p.envKey).join(" OR ");
+  throw new Error(
+    `No LLM provider API key found in environment. Set one of: ${envKeys}. Get a free OpenRouter key at https://openrouter.ai/keys (recommended \u2014 one key, many models).`
+  );
+}
+function tryResolveProvider() {
+  try {
+    return resolveProvider();
+  } catch {
+    return null;
+  }
+}
+
 // src/server/agent/create-conversation-history.ts
 var sdkOverride = void 0;
 function __setSdkForTests(sdk) {
@@ -645,10 +692,31 @@ async function createConversationHistory(args) {
     });
     args.response.headers.append("set-cookie", cookie);
   }
+  const resolvedOptions = autoResolveProviderIfNeeded(args.options);
   const sdk = await loadSdk();
-  const agent = await sdk.Agent.getOrCreate(conversationId, args.options);
+  const agent = await sdk.Agent.getOrCreate(conversationId, resolvedOptions);
   return { agent, conversationId, isNew };
 }
+function autoResolveProviderIfNeeded(options) {
+  if (typeof options.apiKey === "string" && options.apiKey.length > 0) {
+    return options;
+  }
+  const resolved = tryResolveProvider();
+  if (resolved === null) {
+    throw new Error(
+      "No LLM provider API key found in environment. Set OPENROUTER_API_KEY (recommended \u2014 gateway to many models) OR OPENAI_API_KEY OR ANTHROPIC_API_KEY in your .env. Get a free OpenRouter key at https://openrouter.ai/keys. (Pass `options.apiKey` explicitly to bypass auto-resolution.)"
+    );
+  }
+  return {
+    ...options,
+    apiKey: resolved.apiKey,
+    providers: {
+      routes: [
+        { capability: "chat", provider: resolved.name, baseUrl: resolved.baseUrl }
+      ]
+    }
+  };
+}
 
 // src/server/rate-limit/rate-limit-per-route.ts
 import { createHash } from "crypto";