theokit 0.46.1 → 0.48.0

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

@@ -5,6 +5,95 @@ export { InProcessApprovalRequest, InProcessApprovalRequiredError, InProcessAwai
 import { CustomTool as CustomTool$1 } from '@theokit/sdk';
 import { V as VerifyFn } from '../../webhook-types-CNUZY7o1.js';
 
+/**
+ * Provider Resolver — Strategy + Registry pattern (FAANG-grade).
+ *
+ * Inspiration: Dapr Conversation Registry (`dapr/pkg/components/conversation/registry.go`)
+ * + Encore Manager provider array (`encore/runtimes/go/pubsub/manager_internal.go`).
+ *
+ * Principle: provider routing is the FRAMEWORK's responsibility, not the consumer's.
+ * The consumer template uses a plain `model: { id: 'gpt-4o-mini' }` — no conditionals.
+ *
+ * Wire protocol: OpenAI Chat Completions (universal — implemented by every
+ * os providers: OpenRouter, Groq, Mistral, Together, Anthropic via proxy, etc).
+ *
+ * Resolution by priority (FIRST match wins):
+ *   1. OPENROUTER_API_KEY → baseUrl=openrouter.ai (multi-model gateway)
+ *   2. OPENAI_API_KEY     → baseUrl=api.openai.com
+ *   3. ANTHROPIC_API_KEY  → direct Anthropic (Messages API, not OpenAI-compat)
+ *
+ * Escape hatch: an explicit `options.apiKey` OVERRIDES auto-resolution
+ * (the consumer can force a specific provider if it wants to).
+ */
+/**
+ * Provider configuration descriptor — Registry entry shape.
+ *
+ * @public
+ */
+interface ProviderDescriptor {
+    /** Stable name used internally — not exposed on the wire. */
+    name: string;
+    /** Environment variable that holds the API key for this provider. */
+    envKey: string;
+    /** Base URL for the provider's OpenAI-compatible (or native) API. */
+    baseUrl: string;
+    /** Resolution priority (lower = higher priority). FIRST match wins. */
+    priority: number;
+}
+/**
+ * Resolved provider configuration — output of `resolveProvider()`.
+ *
+ * @public
+ */
+interface ResolvedProvider {
+    name: string;
+    apiKey: string;
+    baseUrl: string;
+}
+/**
+ * Register a new provider (Registry pattern — runtime extension point).
+ * Useful for self-hosted endpoints or custom providers without touching theokit src.
+ *
+ * @example
+ * registerProvider({
+ *   name: 'self-hosted',
+ *   envKey: 'SELF_HOSTED_API_KEY',
+ *   baseUrl: 'https://llm.internal.acme.com/v1',
+ *   priority: 0, // highest priority
+ * })
+ *
+ * @public
+ */
+declare function registerProvider(descriptor: ProviderDescriptor): void;
+/**
+ * Reset registry to DEFAULT_REGISTRY (test-only / dev escape hatch).
+ *
+ * @public
+ */
+declare function resetProviderRegistry(): void;
+/**
+ * Get current registry snapshot (read-only — inspection).
+ *
+ * @public
+ */
+declare function listProviders(): readonly ProviderDescriptor[];
+/**
+ * Resolve provider from env vars by priority. FIRST env var found wins.
+ *
+ * @returns ResolvedProvider with apiKey + baseUrl + name
+ * @throws Error if NO provider env var is set (actionable message)
+ *
+ * @public
+ */
+declare function resolveProvider(): ResolvedProvider;
+/**
+ * Try to resolve — does NOT throw. Returns null if no provider available.
+ * Useful for graceful degradation (e.g., mock mode).
+ *
+ * @public
+ */
+declare function tryResolveProvider(): ResolvedProvider | null;
+
 /**
  * M26 (ADR-0041) — `createWorkflowTool`: wrap an SDK `Workflow` as a `CustomTool`.
  *
@@ -320,4 +409,4 @@ interface StdioStreams {
  */
 declare function serveMcpStdio(mod: unknown, name: string, appResources: readonly AppResource[], streams: StdioStreams): Promise<void>;
 
-export { type AcpToolConfig, type AppResource, type AppResourceInput, type ChannelMessage, type ChannelWebhookConfig, type CodeModeApi, type CodeModeConfig, type CodeModePermission, CodeModePermissionDeniedError, type McpResourceContents, type McpResourceDescriptor, NodeAcpTransport, type Sandbox, type StdioStreams, type VendorAgentClient, type VendorAgentToolConfig, type WorkflowLike, type WorkflowToolConfig, buildResourceDescriptors, createACPTool, createCodeMode, createVendorAgentTool, createWorkflowTool, defineAppResource, extractAppResources, handleChannelWebhook, handleMcpStdioLine, isChannelPath, parseChannelPath, readAppResource, serveMcpStdio };
+export { type AcpToolConfig, type AppResource, type AppResourceInput, type ChannelMessage, type ChannelWebhookConfig, type CodeModeApi, type CodeModeConfig, type CodeModePermission, CodeModePermissionDeniedError, type McpResourceContents, type McpResourceDescriptor, NodeAcpTransport, type ProviderDescriptor, type ResolvedProvider, type Sandbox, type StdioStreams, type VendorAgentClient, type VendorAgentToolConfig, type WorkflowLike, type WorkflowToolConfig, buildResourceDescriptors, createACPTool, createCodeMode, createVendorAgentTool, createWorkflowTool, defineAppResource, extractAppResources, handleChannelWebhook, handleMcpStdioLine, isChannelPath, listProviders, parseChannelPath, readAppResource, registerProvider, resetProviderRegistry, resolveProvider, serveMcpStdio, tryResolveProvider };

package/dist/server/agent/index.js

@@ -12,13 +12,20 @@ import {
   parseChannelPath,
   serveMcpStdio,
   streamAgentTurnInProcess
-} from "../../chunk-FZG3JYB3.js";
+} from "../../chunk-7ZOQN7UH.js";
 import {
   buildResourceDescriptors,
   defineAppResource,
   extractAppResources,
   readAppResource
 } from "../../chunk-YOIVCCZT.js";
+import {
+  listProviders,
+  registerProvider,
+  resetProviderRegistry,
+  resolveProvider,
+  tryResolveProvider
+} from "../../chunk-6E5WKMDS.js";
 import "../../chunk-SAFGDIPQ.js";
 import "../../chunk-XTHN6JBX.js";
 export {
@@ -35,9 +42,14 @@ export {
   handleChannelWebhook,
   handleMcpStdioLine,
   isChannelPath,
+  listProviders,
   parseChannelPath,
   readAppResource,
+  registerProvider,
+  resetProviderRegistry,
+  resolveProvider,
   serveMcpStdio,
-  streamAgentTurnInProcess
+  streamAgentTurnInProcess,
+  tryResolveProvider
 };
 //# sourceMappingURL=index.js.map

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

@@ -1,4 +1,5 @@
 import { d as StorageAdapter } from '../../storage-types-DsDTCPbp.js';
+export { InMemoryUsageStorage as NeutralUsageStorage } from '@theokit/agents/usage';
 
 /**
  * Cost tracking types (R0.5.11).

package/dist/server/cost/index.js

@@ -1,11 +1,13 @@
 import {
   InMemoryUsageStorage,
+  InMemoryUsageStorage2,
   trackAgentRun,
   trackAgentTools
-} from "../../chunk-SEELKQUM.js";
+} from "../../chunk-Y2KHTD2W.js";
 import "../../chunk-XTHN6JBX.js";
 export {
   InMemoryUsageStorage,
+  InMemoryUsageStorage2 as NeutralUsageStorage,
   trackAgentRun,
   trackAgentTools
 };

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

@@ -1,5 +1,5 @@
-export { B as BATCH_PATH, a as BatchExecuteFn, b as BatchPathConflictError, c as BatchPayload, d as BatchRequestItem, e as BatchResponse, f as BatchResultItem, C as CookieOptions, g as CorsConfig, h as CorsHandler, i as CorsOrigin, j as CorsWebHandler, k as CustomErrorPages, E as ExecuteActionOptions, l as ExecuteRouteContext, H as HandleBatchOptions, M as MAX_ERROR_HTML_BYTES, m as MiddlewareResult, N as NotFoundError, S as STRIPPED_HEADERS, n as SendErrorInput, o as SendErrorOptions, T as TRACE_HEADER, p as TRACE_PARENT_HEADER, q as TheoError, _ as _resetMiddlewareCacheForTests, s as appendCookieToHeaders, t as appendDeleteCookieToHeaders, u as createCorsHandler, v as createCorsWebHandler, w as deleteCookie, x as envelopeCodeToStatus, y as executeAction, z as executeRoute, A as extractTraceId, D as extractTraceIdFromRequest, F as fromUnknown, G as getCookie, I as getCookieFromRequest, J as handleBatchRequest, K as handleRequestError, L as handleWebRequestError, P as loadCustomErrorPages, Q as matchesOrigin, R as parseCookieHeader, U as parseTraceparent, W as runMiddlewareAndContext, X as sendError, Y as sendJson, Z as serializeCookie, $ as serveStaticFile, a0 as serverErrorToEnvelope, a1 as setCookie } from '../../index-BeAsvfPr.js';
-import '../../error-envelope-BsNzzAV5.js';
+export { B as BATCH_PATH, a as BatchExecuteFn, b as BatchPathConflictError, c as BatchPayload, d as BatchRequestItem, e as BatchResponse, f as BatchResultItem, C as CookieOptions, g as CorsConfig, h as CorsHandler, i as CorsOrigin, j as CorsWebHandler, k as CustomErrorPages, E as ExecuteActionOptions, l as ExecuteRouteContext, H as HandleBatchOptions, M as MAX_ERROR_HTML_BYTES, m as MiddlewareResult, N as NotFoundError, S as STRIPPED_HEADERS, n as SendErrorInput, o as SendErrorOptions, T as TRACE_HEADER, p as TRACE_PARENT_HEADER, q as TheoError, _ as _resetMiddlewareCacheForTests, s as appendCookieToHeaders, t as appendDeleteCookieToHeaders, u as createCorsHandler, v as createCorsWebHandler, w as deleteCookie, x as envelopeCodeToStatus, y as executeAction, z as executeRoute, A as extractTraceId, D as extractTraceIdFromRequest, F as fromUnknown, G as getCookie, I as getCookieFromRequest, J as handleBatchRequest, K as handleRequestError, L as handleWebRequestError, P as loadCustomErrorPages, Q as matchesOrigin, R as parseCookieHeader, U as parseTraceparent, W as runMiddlewareAndContext, X as sendError, Y as sendJson, Z as serializeCookie, $ as serveStaticFile, a0 as serverErrorToEnvelope, a1 as setCookie } from '../../index-BEtEv6ZH.js';
+import '../../error-envelope-DG47lt8E.js';
 import 'node:http';
 import '../../plugin-types-D69-lJZ9.js';
 import '../../plugin-runner-BFEcgtmJ.js';

package/dist/server/http/index.js

@@ -24,7 +24,7 @@ import {
   runMiddlewareAndContext,
   sendError,
   sendJson
-} from "../../chunk-37ZO643S.js";
+} from "../../chunk-XALU5LCU.js";
 import "../../chunk-47FFT43U.js";
 import "../../chunk-KD5G3YXI.js";
 import "../../chunk-FB2HBNIC.js";
@@ -38,7 +38,7 @@ import {
   TheoError,
   fromUnknown,
   serverErrorToEnvelope
-} from "../../chunk-7SABX4DJ.js";
+} from "../../chunk-IZ3TIL6K.js";
 import {
   appendCookieToHeaders,
   appendDeleteCookieToHeaders,