@theokit/sdk 4.9.1 → 4.10.0

package/dist/{cron-D_0p_gXd.d.ts → cron-BF_AI5NP.d.ts}

@@ -1185,6 +1185,32 @@ interface MemoryProvider {
  */
 type ApiMode = "chat_completions" | "anthropic_messages" | "responses_api" | "bedrock" | "bedrock_anthropic";
 type AuthType = "api_key" | "oauth_device_code" | "oauth_external" | "aws_sdk" | "aws_bearer" | "gcp_oauth" | "none";
+/**
+ * M41 (agent-builder provider framework) — the context a provider's `transform` receives per request. An
+ * object from day one so it can grow without breaking (M42 adds the resolved `credential`).
+ *
+ * @public
+ */
+interface ProviderTransformContext {
+    /** The bearer the router resolved for this request (env var, injected key, or an oauth access token). */
+    apiKey: string;
+}
+/**
+ * M41 — the one OPTIONAL behavior seam on a provider profile. It lets a provider own its per-request auth:
+ * `fetch` is the universal seam (a provider that returns its own fetch fully controls headers + refresh, for
+ * every transport that accepts a fetch); `headers` is a convenience merged over `extraHeaders` on transports
+ * that carry them (responses_api). This is the CONTRACT-shape adaptation of OpenCode's provider `auth.loader`
+ * (MIT © 2025 opencode — `packages/core/src/plugin/provider/*.ts`), retargeted to theokit's transport model.
+ * Closes the gap where a `ProviderProfile` could only declare STATIC headers.
+ *
+ * @public
+ */
+interface ProviderTransform {
+    /** Dynamic per-request headers, merged OVER the profile's static `extraHeaders`. */
+    headers?(ctx: ProviderTransformContext): Record<string, string>;
+    /** A fetch to use for this provider's requests (refresh-aware / fully provider-controlled). */
+    fetch?(ctx: ProviderTransformContext): typeof fetch;
+}
 interface ProviderProfile {
     name: string;
     apiMode: ApiMode;
@@ -1200,6 +1226,11 @@ interface ProviderProfile {
     fallbackModels: ReadonlyArray<string>;
     extraHeaders?: Record<string, string>;
     bodyOverrides?: Record<string, unknown>;
+    /**
+     * M41 — the optional per-request behavior seam (dynamic headers + refresh-aware fetch). Absent ⇒ the profile
+     * is pure data and takes the static path byte-for-byte. See {@link ProviderTransform}.
+     */
+    transform?: ProviderTransform;
     /**
      * Opt-in leaked-dialect safe-parse (theokit#58 follow-up). When `true`, a chat_completions finish
      * with ZERO native `tool_calls` has its assistant content scanned for the Hermes

package/dist/{cron-26WH1n7o.d.cts → cron-DXEhagMa.d.cts}

@@ -1185,6 +1185,32 @@ interface MemoryProvider {
  */
 type ApiMode = "chat_completions" | "anthropic_messages" | "responses_api" | "bedrock" | "bedrock_anthropic";
 type AuthType = "api_key" | "oauth_device_code" | "oauth_external" | "aws_sdk" | "aws_bearer" | "gcp_oauth" | "none";
+/**
+ * M41 (agent-builder provider framework) — the context a provider's `transform` receives per request. An
+ * object from day one so it can grow without breaking (M42 adds the resolved `credential`).
+ *
+ * @public
+ */
+interface ProviderTransformContext {
+    /** The bearer the router resolved for this request (env var, injected key, or an oauth access token). */
+    apiKey: string;
+}
+/**
+ * M41 — the one OPTIONAL behavior seam on a provider profile. It lets a provider own its per-request auth:
+ * `fetch` is the universal seam (a provider that returns its own fetch fully controls headers + refresh, for
+ * every transport that accepts a fetch); `headers` is a convenience merged over `extraHeaders` on transports
+ * that carry them (responses_api). This is the CONTRACT-shape adaptation of OpenCode's provider `auth.loader`
+ * (MIT © 2025 opencode — `packages/core/src/plugin/provider/*.ts`), retargeted to theokit's transport model.
+ * Closes the gap where a `ProviderProfile` could only declare STATIC headers.
+ *
+ * @public
+ */
+interface ProviderTransform {
+    /** Dynamic per-request headers, merged OVER the profile's static `extraHeaders`. */
+    headers?(ctx: ProviderTransformContext): Record<string, string>;
+    /** A fetch to use for this provider's requests (refresh-aware / fully provider-controlled). */
+    fetch?(ctx: ProviderTransformContext): typeof fetch;
+}
 interface ProviderProfile {
     name: string;
     apiMode: ApiMode;
@@ -1200,6 +1226,11 @@ interface ProviderProfile {
     fallbackModels: ReadonlyArray<string>;
     extraHeaders?: Record<string, string>;
     bodyOverrides?: Record<string, unknown>;
+    /**
+     * M41 — the optional per-request behavior seam (dynamic headers + refresh-aware fetch). Absent ⇒ the profile
+     * is pure data and takes the static path byte-for-byte. See {@link ProviderTransform}.
+     */
+    transform?: ProviderTransform;
     /**
      * Opt-in leaked-dialect safe-parse (theokit#58 follow-up). When `true`, a chat_completions finish
      * with ZERO native `tool_calls` has its assistant content scanned for the Hermes

package/dist/cron.cjs

@@ -13685,6 +13685,9 @@ function resolveApiKey2(envVars) {
   return void 0;
 }
 function selectTransport(profile, apiKey) {
+  const transformCtx = { apiKey };
+  const transformFetch = profile.transform?.fetch?.(transformCtx);
+  const transformHeaders = profile.transform?.headers?.(transformCtx);
   if (profile.apiMode === "chat_completions") {
     if (profile.name === "ollama") {
       const ollamaBase = process.env.OLLAMA_HOST ?? profile.baseUrl;
@@ -13701,6 +13704,7 @@ function selectTransport(profile, apiKey) {
     }
     const envOverride = resolveBaseUrlEnvOverride(profile.name);
     if (envOverride !== void 0) opts.baseUrl = envOverride;
+    if (transformFetch !== void 0) opts.fetch = transformFetch;
     return new OpenAIClient(opts);
   }
   if (profile.apiMode === "anthropic_messages") {
@@ -13717,10 +13721,12 @@ function selectTransport(profile, apiKey) {
     return new BedrockAnthropicClient(realKey !== void 0 ? { apiKey: realKey } : {});
   }
   if (profile.apiMode === "responses_api") {
+    const mergedHeaders = profile.extraHeaders !== void 0 || transformHeaders !== void 0 ? { ...profile.extraHeaders, ...transformHeaders } : void 0;
     return new ResponsesApiClient({
       apiKey,
       ...profile.baseUrl !== void 0 ? { baseUrl: profile.baseUrl } : {},
-      ...profile.extraHeaders !== void 0 ? { extraHeaders: profile.extraHeaders } : {},
+      ...mergedHeaders !== void 0 ? { extraHeaders: mergedHeaders } : {},
+      ...transformFetch !== void 0 ? { fetch: transformFetch } : {},
       providerName: profile.name
     });
   }