@fabric-harness/sdk 0.10.0 → 1.1.0

package/dist/vercel-ai-gateway.d.ts

@@ -0,0 +1,57 @@
+import { OpenAICompatibleModelProvider } from './model.js';
+/**
+ * Default base URL for Vercel AI Gateway's OpenAI-compatible Chat Completions
+ * endpoint. The gateway accepts the standard OpenAI request body and routes
+ * through to the configured provider; switching from OpenAI to the gateway
+ * is just a base-URL change.
+ *
+ * See https://vercel.com/docs/ai-gateway/sdks-and-apis/openai-compat
+ */
+export declare const VERCEL_AI_GATEWAY_BASE_URL = "https://ai-gateway.vercel.sh/v1";
+export interface VercelAIGatewayProviderOptions {
+    /**
+     * AI Gateway API key. From the Vercel dashboard, or pass an OIDC token if
+     * you've configured workload identity. Forwarded as `Authorization: Bearer`.
+     */
+    apiKey: string;
+    /**
+     * Default model id (e.g. `anthropic/claude-3-5-sonnet-20241022`,
+     * `openai/gpt-4o`). Used when `init({ model: ... })` isn't set per-call.
+     */
+    defaultModel?: string;
+    /**
+     * Override the gateway base URL. Default is the production gateway
+     * (`https://ai-gateway.vercel.sh/v1`). Override for staging or self-hosted.
+     */
+    baseUrl?: string;
+    /** Optional name override for telemetry. Defaults to `vercel-ai-gateway`. */
+    name?: string;
+    /** Extra headers (e.g. team scoping, observability tags). */
+    headers?: Record<string, string>;
+}
+/**
+ * Vercel AI Gateway model provider.
+ *
+ * The gateway is an OpenAI-compatible HTTP endpoint that brokers between
+ * your agent and any of the major model providers (OpenAI, Anthropic,
+ * Google, xAI, Groq, etc.) with a single key, observability, caching, and
+ * spend controls. Use this provider on any deploy target — Node, Cloudflare
+ * Workers, Vercel — to route inference through the gateway.
+ *
+ * ```ts
+ * import { vercelAIGateway, init } from '@fabric-harness/sdk';
+ *
+ * const fabric = await init({
+ *   modelProvider: vercelAIGateway({
+ *     apiKey: process.env.AI_GATEWAY_API_KEY!,
+ *     defaultModel: 'anthropic/claude-3-5-sonnet-20241022',
+ *   }),
+ * });
+ * ```
+ *
+ * Returns an {@link OpenAICompatibleModelProvider} configured for the gateway
+ * — use it anywhere a `ModelProvider` is accepted. Compatible with
+ * fabric-harness's tool-calling, retries, and timeout semantics.
+ */
+export declare function vercelAIGateway(options: VercelAIGatewayProviderOptions): OpenAICompatibleModelProvider;
+//# sourceMappingURL=vercel-ai-gateway.d.ts.map

package/dist/vercel-ai-gateway.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"vercel-ai-gateway.d.ts","sourceRoot":"","sources":["../src/vercel-ai-gateway.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,6BAA6B,EAAE,MAAM,YAAY,CAAC;AAE3D;;;;;;;GAOG;AACH,eAAO,MAAM,0BAA0B,oCAAoC,CAAC;AAE5E,MAAM,WAAW,8BAA8B;IAC7C;;;OAGG;IACH,MAAM,EAAE,MAAM,CAAC;IACf;;;OAGG;IACH,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB;;;OAGG;IACH,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,6EAA6E;IAC7E,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,6DAA6D;IAC7D,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CAClC;AAED;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,wBAAgB,eAAe,CAAC,OAAO,EAAE,8BAA8B,GAAG,6BAA6B,CAQtG"}

package/dist/vercel-ai-gateway.js

@@ -0,0 +1,44 @@
+import { OpenAICompatibleModelProvider } from './model.js';
+/**
+ * Default base URL for Vercel AI Gateway's OpenAI-compatible Chat Completions
+ * endpoint. The gateway accepts the standard OpenAI request body and routes
+ * through to the configured provider; switching from OpenAI to the gateway
+ * is just a base-URL change.
+ *
+ * See https://vercel.com/docs/ai-gateway/sdks-and-apis/openai-compat
+ */
+export const VERCEL_AI_GATEWAY_BASE_URL = 'https://ai-gateway.vercel.sh/v1';
+/**
+ * Vercel AI Gateway model provider.
+ *
+ * The gateway is an OpenAI-compatible HTTP endpoint that brokers between
+ * your agent and any of the major model providers (OpenAI, Anthropic,
+ * Google, xAI, Groq, etc.) with a single key, observability, caching, and
+ * spend controls. Use this provider on any deploy target — Node, Cloudflare
+ * Workers, Vercel — to route inference through the gateway.
+ *
+ * ```ts
+ * import { vercelAIGateway, init } from '@fabric-harness/sdk';
+ *
+ * const fabric = await init({
+ *   modelProvider: vercelAIGateway({
+ *     apiKey: process.env.AI_GATEWAY_API_KEY!,
+ *     defaultModel: 'anthropic/claude-3-5-sonnet-20241022',
+ *   }),
+ * });
+ * ```
+ *
+ * Returns an {@link OpenAICompatibleModelProvider} configured for the gateway
+ * — use it anywhere a `ModelProvider` is accepted. Compatible with
+ * fabric-harness's tool-calling, retries, and timeout semantics.
+ */
+export function vercelAIGateway(options) {
+    return new OpenAICompatibleModelProvider({
+        name: options.name ?? 'vercel-ai-gateway',
+        baseUrl: options.baseUrl ?? VERCEL_AI_GATEWAY_BASE_URL,
+        apiKey: options.apiKey,
+        ...(options.defaultModel !== undefined ? { defaultModel: options.defaultModel } : {}),
+        ...(options.headers !== undefined ? { headers: options.headers } : {}),
+    });
+}
+//# sourceMappingURL=vercel-ai-gateway.js.map

package/dist/vercel-ai-gateway.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"vercel-ai-gateway.js","sourceRoot":"","sources":["../src/vercel-ai-gateway.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,6BAA6B,EAAE,MAAM,YAAY,CAAC;AAE3D;;;;;;;GAOG;AACH,MAAM,CAAC,MAAM,0BAA0B,GAAG,iCAAiC,CAAC;AAwB5E;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,MAAM,UAAU,eAAe,CAAC,OAAuC;IACrE,OAAO,IAAI,6BAA6B,CAAC;QACvC,IAAI,EAAE,OAAO,CAAC,IAAI,IAAI,mBAAmB;QACzC,OAAO,EAAE,OAAO,CAAC,OAAO,IAAI,0BAA0B;QACtD,MAAM,EAAE,OAAO,CAAC,MAAM;QACtB,GAAG,CAAC,OAAO,CAAC,YAAY,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,YAAY,EAAE,OAAO,CAAC,YAAY,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QACrF,GAAG,CAAC,OAAO,CAAC,OAAO,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,OAAO,EAAE,OAAO,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;KACvE,CAAC,CAAC;AACL,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@fabric-harness/sdk",
-  "version": "0.10.0",
+  "version": "1.1.0",
   "description": "Headless TypeScript framework for building durable, deployable autonomous agents — core SDK.",
   "license": "Apache-2.0",
   "author": "Fabric",
@@ -26,7 +26,7 @@
   "type": "module",
   "sideEffects": false,
   "engines": {
-    "node": ">=22.0.0"
+    "node": ">=20.18.0"
   },
   "publishConfig": {
     "registry": "https://registry.npmjs.org",
@@ -44,6 +44,14 @@
     "./cloudflare": {
       "types": "./dist/cloudflare-source.d.ts",
       "import": "./dist/cloudflare-source.js"
+    },
+    "./experimental": {
+      "types": "./dist/experimental.d.ts",
+      "import": "./dist/experimental.js"
+    },
+    "./testing": {
+      "types": "./dist/testing.d.ts",
+      "import": "./dist/testing.js"
     }
   },
   "files": [