@agentuity/aigateway 2.0.15

package/README.md

@@ -0,0 +1,50 @@
+# @agentuity/aigateway
+
+A standalone package for the Agentuity AI Gateway service.
+
+## Installation
+
+```bash
+npm install @agentuity/aigateway
+```
+
+## Quick Start
+
+```typescript
+import { AIGatewayClient } from '@agentuity/aigateway';
+
+const client = new AIGatewayClient();
+
+const models = await client.listModels();
+console.log(Object.keys(models));
+
+const completion = await client.complete({
+	model: 'openai/gpt-4.1-mini',
+	messages: [{ role: 'user', content: 'Say hello' }],
+});
+
+console.log(completion.choices?.[0]);
+```
+
+## Configuration
+
+```typescript
+const client = new AIGatewayClient({
+	apiKey: 'your-api-key',
+	orgId: 'your-org-id',
+	url: 'https://aigateway-usc.agentuity.cloud',
+});
+```
+
+### Environment Variables
+
+| Variable | Description | Default |
+|----------|-------------|---------|
+| `AGENTUITY_AIGATEWAY_KEY` | AI Gateway API key override | Optional |
+| `AGENTUITY_SDK_KEY` | API key for authentication | Required |
+| `AGENTUITY_REGION` | Region for API endpoints | `usc` |
+| `AGENTUITY_AIGATEWAY_URL` | Override AI Gateway API URL | Auto-detected |
+
+## License
+
+Apache-2.0

package/dist/index.d.ts

@@ -0,0 +1,18 @@
+export { AIGatewayService, type AIGatewayChatCompletion, type AIGatewayChatCompletionParams, type AIGatewayChatMessage, type AIGatewayModel, type AIGatewayModelProvider, type AIGatewayModels, type AIGatewayModelsResponse, type AIGatewayPricing, AIGatewayChatCompletionParamsSchema, AIGatewayChatCompletionSchema, AIGatewayChatMessageSchema, AIGatewayModelProviderSchema, AIGatewayModelSchema, AIGatewayModelsResponseSchema, AIGatewayModelsSchema, AIGatewayPricingSchema, } from '@agentuity/core/aigateway';
+import { type AIGatewayChatCompletion, type AIGatewayChatCompletionParams, type AIGatewayModels } from '@agentuity/core/aigateway';
+import { type Logger } from '@agentuity/server';
+import { z } from 'zod';
+export declare const AIGatewayClientOptionsSchema: z.ZodObject<{
+    apiKey: z.ZodOptional<z.ZodString>;
+    url: z.ZodOptional<z.ZodString>;
+    orgId: z.ZodOptional<z.ZodString>;
+    logger: z.ZodOptional<z.ZodCustom<Logger, Logger>>;
+}, z.core.$strip>;
+export type AIGatewayClientOptions = z.infer<typeof AIGatewayClientOptionsSchema>;
+export declare class AIGatewayClient {
+    #private;
+    constructor(options?: AIGatewayClientOptions);
+    listModels(): Promise<AIGatewayModels>;
+    complete(params: AIGatewayChatCompletionParams): Promise<AIGatewayChatCompletion>;
+}
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACN,gBAAgB,EAChB,KAAK,uBAAuB,EAC5B,KAAK,6BAA6B,EAClC,KAAK,oBAAoB,EACzB,KAAK,cAAc,EACnB,KAAK,sBAAsB,EAC3B,KAAK,eAAe,EACpB,KAAK,uBAAuB,EAC5B,KAAK,gBAAgB,EACrB,mCAAmC,EACnC,6BAA6B,EAC7B,0BAA0B,EAC1B,4BAA4B,EAC5B,oBAAoB,EACpB,6BAA6B,EAC7B,qBAAqB,EACrB,sBAAsB,GACtB,MAAM,2BAA2B,CAAC;AAEnC,OAAO,EAEN,KAAK,uBAAuB,EAC5B,KAAK,6BAA6B,EAClC,KAAK,eAAe,EACpB,MAAM,2BAA2B,CAAC;AAGnC,OAAO,EAAgD,KAAK,MAAM,EAAE,MAAM,mBAAmB,CAAC;AAC9F,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AASxB,eAAO,MAAM,4BAA4B;;;;;iBAKvC,CAAC;AAEH,MAAM,MAAM,sBAAsB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,4BAA4B,CAAC,CAAC;AAElF,qBAAa,eAAe;;gBAGf,OAAO,GAAE,sBAA2B;IAqB1C,UAAU,IAAI,OAAO,CAAC,eAAe,CAAC;IAItC,QAAQ,CAAC,MAAM,EAAE,6BAA6B,GAAG,OAAO,CAAC,uBAAuB,CAAC;CAGvF"}

package/dist/index.js

@@ -0,0 +1,42 @@
+export { AIGatewayService, AIGatewayChatCompletionParamsSchema, AIGatewayChatCompletionSchema, AIGatewayChatMessageSchema, AIGatewayModelProviderSchema, AIGatewayModelSchema, AIGatewayModelsResponseSchema, AIGatewayModelsSchema, AIGatewayPricingSchema, } from '@agentuity/core/aigateway';
+import { AIGatewayService, } from '@agentuity/core/aigateway';
+import { createMinimalLogger, getEnv } from '@agentuity/core';
+import { getServiceUrls } from '@agentuity/core/config';
+import { buildClientHeaders, createServerFetchAdapter } from '@agentuity/server';
+import { z } from 'zod';
+const isLogger = (val) => typeof val === 'object' &&
+    val !== null &&
+    ['info', 'warn', 'error', 'debug', 'trace'].every((m) => typeof val[m] === 'function');
+export const AIGatewayClientOptionsSchema = z.object({
+    apiKey: z.string().optional().describe('API key for authentication'),
+    url: z.string().optional().describe('Base URL for the AI Gateway API'),
+    orgId: z.string().optional().describe('Organization ID for multi-tenant operations'),
+    logger: z.custom(isLogger).optional().describe('Custom logger instance'),
+});
+export class AIGatewayClient {
+    #service;
+    constructor(options = {}) {
+        const validatedOptions = AIGatewayClientOptionsSchema.parse(options);
+        const apiKey = validatedOptions.apiKey ||
+            getEnv('AGENTUITY_AIGATEWAY_KEY') ||
+            getEnv('AGENTUITY_SDK_KEY') ||
+            getEnv('AGENTUITY_CLI_KEY');
+        const region = getEnv('AGENTUITY_REGION') ?? 'usc';
+        const serviceUrls = getServiceUrls(region);
+        const url = validatedOptions.url || getEnv('AGENTUITY_AIGATEWAY_URL') || serviceUrls.aigateway;
+        const logger = validatedOptions.logger ?? createMinimalLogger();
+        const headers = buildClientHeaders({
+            apiKey,
+            orgId: validatedOptions.orgId,
+        });
+        const adapter = createServerFetchAdapter({ headers }, logger);
+        this.#service = new AIGatewayService(url, adapter);
+    }
+    async listModels() {
+        return this.#service.listModels();
+    }
+    async complete(params) {
+        return this.#service.complete(params);
+    }
+}
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACN,gBAAgB,EAShB,mCAAmC,EACnC,6BAA6B,EAC7B,0BAA0B,EAC1B,4BAA4B,EAC5B,oBAAoB,EACpB,6BAA6B,EAC7B,qBAAqB,EACrB,sBAAsB,GACtB,MAAM,2BAA2B,CAAC;AAEnC,OAAO,EACN,gBAAgB,GAIhB,MAAM,2BAA2B,CAAC;AACnC,OAAO,EAAE,mBAAmB,EAAE,MAAM,EAAE,MAAM,iBAAiB,CAAC;AAC9D,OAAO,EAAE,cAAc,EAAE,MAAM,wBAAwB,CAAC;AACxD,OAAO,EAAE,kBAAkB,EAAE,wBAAwB,EAAe,MAAM,mBAAmB,CAAC;AAC9F,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,MAAM,QAAQ,GAAG,CAAC,GAAY,EAAiB,EAAE,CAChD,OAAO,GAAG,KAAK,QAAQ;IACvB,GAAG,KAAK,IAAI;IACZ,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,OAAO,EAAE,OAAO,CAAC,CAAC,KAAK,CAChD,CAAC,CAAC,EAAE,EAAE,CAAC,OAAQ,GAA+B,CAAC,CAAC,CAAC,KAAK,UAAU,CAChE,CAAC;AAEH,MAAM,CAAC,MAAM,4BAA4B,GAAG,CAAC,CAAC,MAAM,CAAC;IACpD,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,4BAA4B,CAAC;IACpE,GAAG,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,iCAAiC,CAAC;IACtE,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,6CAA6C,CAAC;IACpF,MAAM,EAAE,CAAC,CAAC,MAAM,CAAS,QAAQ,CAAC,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,wBAAwB,CAAC;CAChF,CAAC,CAAC;AAIH,MAAM,OAAO,eAAe;IAClB,QAAQ,CAAmB;IAEpC,YAAY,UAAkC,EAAE;QAC/C,MAAM,gBAAgB,GAAG,4BAA4B,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;QACrE,MAAM,MAAM,GACX,gBAAgB,CAAC,MAAM;YACvB,MAAM,CAAC,yBAAyB,CAAC;YACjC,MAAM,CAAC,mBAAmB,CAAC;YAC3B,MAAM,CAAC,mBAAmB,CAAC,CAAC;QAC7B,MAAM,MAAM,GAAG,MAAM,CAAC,kBAAkB,CAAC,IAAI,KAAK,CAAC;QACnD,MAAM,WAAW,GAAG,cAAc,CAAC,MAAM,CAAC,CAAC;QAC3C,MAAM,GAAG,GACR,gBAAgB,CAAC,GAAG,IAAI,MAAM,CAAC,yBAAyB,CAAC,IAAI,WAAW,CAAC,SAAS,CAAC;QACpF,MAAM,MAAM,GAAG,gBAAgB,CAAC,MAAM,IAAI,mBAAmB,EAAE,CAAC;QAChE,MAAM,OAAO,GAAG,kBAAkB,CAAC;YAClC,MAAM;YACN,KAAK,EAAE,gBAAgB,CAAC,KAAK;SAC7B,CAAC,CAAC;QAEH,MAAM,OAAO,GAAG,wBAAwB,CAAC,EAAE,OAAO,EAAE,EAAE,MAAM,CAAC,CAAC;QAC9D,IAAI,CAAC,QAAQ,GAAG,IAAI,gBAAgB,CAAC,GAAG,EAAE,OAAO,CAAC,CAAC;IACpD,CAAC;IAED,KAAK,CAAC,UAAU;QACf,OAAO,IAAI,CAAC,QAAQ,CAAC,UAAU,EAAE,CAAC;IACnC,CAAC;IAED,KAAK,CAAC,QAAQ,CAAC,MAAqC;QACnD,OAAO,IAAI,CAAC,QAAQ,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC;IACvC,CAAC;CACD"}

package/package.json

@@ -0,0 +1,42 @@
+{
+	"name": "@agentuity/aigateway",
+	"version": "2.0.15",
+	"license": "Apache-2.0",
+	"author": "Agentuity employees and contributors",
+	"type": "module",
+	"main": "./dist/index.js",
+	"types": "./dist/index.d.ts",
+	"files": [
+		"AGENTS.md",
+		"README.md",
+		"src",
+		"dist"
+	],
+	"exports": {
+		".": {
+			"import": "./dist/index.js",
+			"types": "./dist/index.d.ts"
+		}
+	},
+	"scripts": {
+		"clean": "rm -rf dist tsconfig.tsbuildinfo",
+		"build": "bunx tsc --build --force",
+		"typecheck": "bunx tsc --noEmit",
+		"prepublishOnly": "bun run clean && bun run build"
+	},
+	"dependencies": {
+		"@agentuity/core": "2.0.15",
+		"@agentuity/server": "2.0.15",
+		"zod": "^4.3.5"
+	},
+	"devDependencies": {
+		"@types/bun": "latest",
+		"@types/node": "^22.0.0",
+		"bun-types": "latest",
+		"typescript": "^5.9.0"
+	},
+	"publishConfig": {
+		"access": "public"
+	},
+	"sideEffects": false
+}

package/src/index.ts

@@ -0,0 +1,79 @@
+export {
+	AIGatewayService,
+	type AIGatewayChatCompletion,
+	type AIGatewayChatCompletionParams,
+	type AIGatewayChatMessage,
+	type AIGatewayModel,
+	type AIGatewayModelProvider,
+	type AIGatewayModels,
+	type AIGatewayModelsResponse,
+	type AIGatewayPricing,
+	AIGatewayChatCompletionParamsSchema,
+	AIGatewayChatCompletionSchema,
+	AIGatewayChatMessageSchema,
+	AIGatewayModelProviderSchema,
+	AIGatewayModelSchema,
+	AIGatewayModelsResponseSchema,
+	AIGatewayModelsSchema,
+	AIGatewayPricingSchema,
+} from '@agentuity/core/aigateway';
+
+import {
+	AIGatewayService,
+	type AIGatewayChatCompletion,
+	type AIGatewayChatCompletionParams,
+	type AIGatewayModels,
+} from '@agentuity/core/aigateway';
+import { createMinimalLogger, getEnv } from '@agentuity/core';
+import { getServiceUrls } from '@agentuity/core/config';
+import { buildClientHeaders, createServerFetchAdapter, type Logger } from '@agentuity/server';
+import { z } from 'zod';
+
+const isLogger = (val: unknown): val is Logger =>
+	typeof val === 'object' &&
+	val !== null &&
+	['info', 'warn', 'error', 'debug', 'trace'].every(
+		(m) => typeof (val as Record<string, unknown>)[m] === 'function'
+	);
+
+export const AIGatewayClientOptionsSchema = z.object({
+	apiKey: z.string().optional().describe('API key for authentication'),
+	url: z.string().optional().describe('Base URL for the AI Gateway API'),
+	orgId: z.string().optional().describe('Organization ID for multi-tenant operations'),
+	logger: z.custom<Logger>(isLogger).optional().describe('Custom logger instance'),
+});
+
+export type AIGatewayClientOptions = z.infer<typeof AIGatewayClientOptionsSchema>;
+
+export class AIGatewayClient {
+	readonly #service: AIGatewayService;
+
+	constructor(options: AIGatewayClientOptions = {}) {
+		const validatedOptions = AIGatewayClientOptionsSchema.parse(options);
+		const apiKey =
+			validatedOptions.apiKey ||
+			getEnv('AGENTUITY_AIGATEWAY_KEY') ||
+			getEnv('AGENTUITY_SDK_KEY') ||
+			getEnv('AGENTUITY_CLI_KEY');
+		const region = getEnv('AGENTUITY_REGION') ?? 'usc';
+		const serviceUrls = getServiceUrls(region);
+		const url =
+			validatedOptions.url || getEnv('AGENTUITY_AIGATEWAY_URL') || serviceUrls.aigateway;
+		const logger = validatedOptions.logger ?? createMinimalLogger();
+		const headers = buildClientHeaders({
+			apiKey,
+			orgId: validatedOptions.orgId,
+		});
+
+		const adapter = createServerFetchAdapter({ headers }, logger);
+		this.#service = new AIGatewayService(url, adapter);
+	}
+
+	async listModels(): Promise<AIGatewayModels> {
+		return this.#service.listModels();
+	}
+
+	async complete(params: AIGatewayChatCompletionParams): Promise<AIGatewayChatCompletion> {
+		return this.#service.complete(params);
+	}
+}