@sprinterai/runtime 0.4.1 → 0.5.0

package/dist/notification/notification-engine.test.js

@@ -0,0 +1,364 @@
+import { describe, it, expect, vi, beforeEach } from 'vitest';
+import { createNotificationEngine, interpolateTemplate } from './notification-engine.js';
+// ─── Helpers ───────────────────────────────────────────────
+function createMockStore() {
+    let idCounter = 0;
+    const notifications = [];
+    return {
+        getNotifications: vi.fn(async () => notifications),
+        getUnreadCount: vi.fn(async () => notifications.filter((n) => !n.read_at).length),
+        markRead: vi.fn(async () => undefined),
+        markAllRead: vi.fn(async () => undefined),
+        createNotification: vi.fn(async (input) => {
+            idCounter += 1;
+            const record = {
+                id: `notif-${idCounter}`,
+                tenant_id: input.tenant_id,
+                user_id: input.user_id,
+                type: input.type,
+                title: input.title,
+                body: input.body,
+                data: input.data,
+                read_at: null,
+                created_at: new Date().toISOString(),
+            };
+            notifications.push(record);
+            return record;
+        }),
+        deleteNotification: vi.fn(async () => undefined),
+    };
+}
+function createMockEventBus() {
+    const handlers = new Map();
+    return {
+        emit: vi.fn(async (type, data) => {
+            const typeHandlers = handlers.get(type);
+            if (typeHandlers) {
+                for (const handler of typeHandlers) {
+                    await handler({
+                        id: 'evt-1',
+                        type,
+                        data,
+                        timestamp: new Date().toISOString(),
+                    });
+                }
+            }
+        }),
+        on: vi.fn((type, handler) => {
+            let typeSet = handlers.get(type);
+            if (!typeSet) {
+                typeSet = new Set();
+                handlers.set(type, typeSet);
+            }
+            typeSet.add(handler);
+            return () => {
+                typeSet.delete(handler);
+            };
+        }),
+        onAny: vi.fn(() => () => undefined),
+        removeAllListeners: vi.fn(),
+    };
+}
+// ─── Tests ─────────────────────────────────────────────────
+describe('interpolateTemplate', () => {
+    it('should replace placeholders with values', () => {
+        const result = interpolateTemplate('Hello {{name}}, welcome to {{place}}!', {
+            name: 'Alice',
+            place: 'Wonderland',
+        });
+        expect(result).toBe('Hello Alice, welcome to Wonderland!');
+    });
+    it('should replace missing fields with empty string', () => {
+        const result = interpolateTemplate('Hello {{name}}, your id is {{id}}', {
+            name: 'Bob',
+        });
+        expect(result).toBe('Hello Bob, your id is ');
+    });
+    it('should handle null values as empty string', () => {
+        const result = interpolateTemplate('Value: {{field}}', { field: null });
+        expect(result).toBe('Value: ');
+    });
+    it('should handle undefined values as empty string', () => {
+        const result = interpolateTemplate('Value: {{field}}', { field: undefined });
+        expect(result).toBe('Value: ');
+    });
+    it('should convert numeric values to string', () => {
+        const result = interpolateTemplate('Count: {{count}}', { count: 42 });
+        expect(result).toBe('Count: 42');
+    });
+    it('should handle template with no placeholders', () => {
+        const result = interpolateTemplate('No placeholders here', { name: 'test' });
+        expect(result).toBe('No placeholders here');
+    });
+    it('should handle empty data', () => {
+        const result = interpolateTemplate('Hello {{name}}', {});
+        expect(result).toBe('Hello ');
+    });
+});
+describe('createNotificationEngine', () => {
+    let store;
+    beforeEach(() => {
+        store = createMockStore();
+    });
+    describe('processEvent', () => {
+        it('should create notifications for matching rules', async () => {
+            const rules = [
+                {
+                    eventType: 'entity.created',
+                    notificationType: 'entity_created',
+                    titleTemplate: 'New {{entityTypeSlug}} created',
+                    resolveRecipients: () => ['user-1'],
+                },
+            ];
+            const engine = createNotificationEngine({ store, rules });
+            const results = await engine.processEvent('entity.created', { entityTypeSlug: 'person', entityId: 'ent-1' }, 'tenant-1');
+            expect(results).toHaveLength(1);
+            expect(results[0].type).toBe('entity_created');
+            expect(results[0].title).toBe('New person created');
+            expect(results[0].tenant_id).toBe('tenant-1');
+            expect(results[0].user_id).toBe('user-1');
+            expect(store.createNotification).toHaveBeenCalledOnce();
+        });
+        it('should return empty array for non-matching event types', async () => {
+            const rules = [
+                {
+                    eventType: 'entity.created',
+                    notificationType: 'entity_created',
+                    titleTemplate: 'New entity',
+                    resolveRecipients: () => ['user-1'],
+                },
+            ];
+            const engine = createNotificationEngine({ store, rules });
+            const results = await engine.processEvent('workflow.completed', {}, 'tenant-1');
+            expect(results).toHaveLength(0);
+            expect(store.createNotification).not.toHaveBeenCalled();
+        });
+        it('should interpolate body template', async () => {
+            const rules = [
+                {
+                    eventType: 'entity.created',
+                    notificationType: 'entity_created',
+                    titleTemplate: 'New entity',
+                    bodyTemplate: '{{triggeredBy}} created a {{entityTypeSlug}}',
+                    resolveRecipients: () => ['user-1'],
+                },
+            ];
+            const engine = createNotificationEngine({ store, rules });
+            const results = await engine.processEvent('entity.created', { triggeredBy: 'Alice', entityTypeSlug: 'person' }, 'tenant-1');
+            expect(results[0].body).toBe('Alice created a person');
+        });
+        it('should set body to null when no bodyTemplate', async () => {
+            const rules = [
+                {
+                    eventType: 'entity.created',
+                    notificationType: 'entity_created',
+                    titleTemplate: 'New entity',
+                    resolveRecipients: () => ['user-1'],
+                },
+            ];
+            const engine = createNotificationEngine({ store, rules });
+            const results = await engine.processEvent('entity.created', {}, 'tenant-1');
+            expect(results[0].body).toBeNull();
+        });
+        it('should filter events based on rule filter', async () => {
+            const rules = [
+                {
+                    eventType: 'entity.created',
+                    notificationType: 'person_created',
+                    titleTemplate: 'New person',
+                    resolveRecipients: () => ['user-1'],
+                    filter: (data) => data.entityTypeSlug === 'person',
+                },
+            ];
+            const engine = createNotificationEngine({ store, rules });
+            // Should match
+            const results1 = await engine.processEvent('entity.created', { entityTypeSlug: 'person' }, 'tenant-1');
+            expect(results1).toHaveLength(1);
+            // Should not match
+            const results2 = await engine.processEvent('entity.created', { entityTypeSlug: 'company' }, 'tenant-1');
+            expect(results2).toHaveLength(0);
+        });
+        it('should resolve multiple recipients', async () => {
+            const rules = [
+                {
+                    eventType: 'approval.requested',
+                    notificationType: 'approval_needed',
+                    titleTemplate: 'Approval needed',
+                    resolveRecipients: () => ['user-1', 'user-2', 'user-3'],
+                },
+            ];
+            const engine = createNotificationEngine({ store, rules });
+            const results = await engine.processEvent('approval.requested', {}, 'tenant-1');
+            expect(results).toHaveLength(3);
+            expect(results[0].user_id).toBe('user-1');
+            expect(results[1].user_id).toBe('user-2');
+            expect(results[2].user_id).toBe('user-3');
+            expect(store.createNotification).toHaveBeenCalledTimes(3);
+        });
+        it('should skip rules with zero recipients', async () => {
+            const rules = [
+                {
+                    eventType: 'entity.created',
+                    notificationType: 'entity_created',
+                    titleTemplate: 'New entity',
+                    resolveRecipients: () => [],
+                },
+            ];
+            const engine = createNotificationEngine({ store, rules });
+            const results = await engine.processEvent('entity.created', {}, 'tenant-1');
+            expect(results).toHaveLength(0);
+            expect(store.createNotification).not.toHaveBeenCalled();
+        });
+        it('should apply buildData to set notification data', async () => {
+            const rules = [
+                {
+                    eventType: 'entity.created',
+                    notificationType: 'entity_created',
+                    titleTemplate: 'New entity',
+                    resolveRecipients: () => ['user-1'],
+                    buildData: (data) => ({
+                        data: { entityId: data.entityId },
+                        link: `/entities/${data.entityId}`,
+                    }),
+                },
+            ];
+            const engine = createNotificationEngine({ store, rules });
+            const results = await engine.processEvent('entity.created', { entityId: 'ent-1' }, 'tenant-1');
+            expect(results[0].data).toEqual({ entityId: 'ent-1' });
+        });
+        it('should handle multiple rules for the same event type', async () => {
+            const rules = [
+                {
+                    eventType: 'entity.created',
+                    notificationType: 'entity_created_admin',
+                    titleTemplate: 'Admin: new entity',
+                    resolveRecipients: () => ['admin-1'],
+                },
+                {
+                    eventType: 'entity.created',
+                    notificationType: 'entity_created_owner',
+                    titleTemplate: 'Owner: new entity',
+                    resolveRecipients: (data) => [data.triggeredBy],
+                },
+            ];
+            const engine = createNotificationEngine({ store, rules });
+            const results = await engine.processEvent('entity.created', { triggeredBy: 'user-1' }, 'tenant-1');
+            expect(results).toHaveLength(2);
+            expect(results[0].type).toBe('entity_created_admin');
+            expect(results[0].user_id).toBe('admin-1');
+            expect(results[1].type).toBe('entity_created_owner');
+            expect(results[1].user_id).toBe('user-1');
+        });
+        it('should use empty data when buildData is not provided', async () => {
+            const rules = [
+                {
+                    eventType: 'entity.created',
+                    notificationType: 'entity_created',
+                    titleTemplate: 'New entity',
+                    resolveRecipients: () => ['user-1'],
+                },
+            ];
+            const engine = createNotificationEngine({ store, rules });
+            const results = await engine.processEvent('entity.created', {}, 'tenant-1');
+            expect(results[0].data).toEqual({});
+        });
+        it('should handle empty rules array', async () => {
+            const engine = createNotificationEngine({ store, rules: [] });
+            const results = await engine.processEvent('entity.created', {}, 'tenant-1');
+            expect(results).toHaveLength(0);
+        });
+    });
+    describe('connectToEventBus', () => {
+        it('should subscribe to event types from rules', () => {
+            const eventBus = createMockEventBus();
+            const rules = [
+                {
+                    eventType: 'entity.created',
+                    notificationType: 'entity_created',
+                    titleTemplate: 'New entity',
+                    resolveRecipients: () => ['user-1'],
+                },
+                {
+                    eventType: 'workflow.completed',
+                    notificationType: 'workflow_done',
+                    titleTemplate: 'Workflow done',
+                    resolveRecipients: () => ['user-1'],
+                },
+            ];
+            const engine = createNotificationEngine({ store, rules, eventBus });
+            const disconnect = engine.connectToEventBus();
+            expect(eventBus.on).toHaveBeenCalledTimes(2);
+            expect(typeof disconnect).toBe('function');
+        });
+        it('should process events from event bus', async () => {
+            const eventBus = createMockEventBus();
+            const rules = [
+                {
+                    eventType: 'entity.created',
+                    notificationType: 'entity_created',
+                    titleTemplate: 'New {{entityTypeSlug}}',
+                    resolveRecipients: () => ['user-1'],
+                },
+            ];
+            const engine = createNotificationEngine({ store, rules, eventBus });
+            engine.connectToEventBus();
+            // Emit an event through the bus
+            await eventBus.emit('entity.created', {
+                entityId: 'ent-1',
+                tenantId: 'tenant-1',
+                entityTypeSlug: 'person',
+            });
+            expect(store.createNotification).toHaveBeenCalledOnce();
+        });
+        it('should disconnect from event bus', () => {
+            const eventBus = createMockEventBus();
+            const rules = [
+                {
+                    eventType: 'entity.created',
+                    notificationType: 'entity_created',
+                    titleTemplate: 'New entity',
+                    resolveRecipients: () => ['user-1'],
+                },
+            ];
+            const engine = createNotificationEngine({ store, rules, eventBus });
+            const disconnect = engine.connectToEventBus();
+            // Disconnect should be callable
+            disconnect();
+            // No error means success
+        });
+        it('should throw when no eventBus provided', () => {
+            const rules = [
+                {
+                    eventType: 'entity.created',
+                    notificationType: 'entity_created',
+                    titleTemplate: 'New entity',
+                    resolveRecipients: () => ['user-1'],
+                },
+            ];
+            const engine = createNotificationEngine({ store, rules });
+            expect(() => engine.connectToEventBus()).toThrow('Cannot connect to event bus: no eventBus provided in options');
+        });
+        it('should deduplicate subscriptions for same event type', () => {
+            const eventBus = createMockEventBus();
+            const rules = [
+                {
+                    eventType: 'entity.created',
+                    notificationType: 'entity_created_v1',
+                    titleTemplate: 'V1: New entity',
+                    resolveRecipients: () => ['user-1'],
+                },
+                {
+                    eventType: 'entity.created',
+                    notificationType: 'entity_created_v2',
+                    titleTemplate: 'V2: New entity',
+                    resolveRecipients: () => ['user-2'],
+                },
+            ];
+            const engine = createNotificationEngine({ store, rules, eventBus });
+            engine.connectToEventBus();
+            // Only one subscription for 'entity.created' even though two rules match
+            expect(eventBus.on).toHaveBeenCalledTimes(1);
+        });
+    });
+});
+//# sourceMappingURL=notification-engine.test.js.map

package/dist/notification/notification-engine.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"notification-engine.test.js","sourceRoot":"","sources":["../../src/notification/notification-engine.test.ts"],"names":[],"mappings":"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"}

package/dist/providers/index.d.ts

@@ -0,0 +1,5 @@
+export type { ErrorTracker, AnalyticsTracker, BillingProvider, EmailProvider, } from './provider-interfaces.js';
+export { noopErrorTracker, noopAnalytics } from './noop-providers.js';
+export { MODEL_REGISTRY, getModelConfig, listModels, getDefaultModel, resolveModel, createProviderRegistry, } from './model-resolver.js';
+export type { ModelProvider, ModelConfig, ModelFilter, ModelFactory, ProviderRegistry, } from './model-resolver.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/providers/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/providers/index.ts"],"names":[],"mappings":"AAAA,YAAY,EACV,YAAY,EACZ,gBAAgB,EAChB,eAAe,EACf,aAAa,GACd,MAAM,uBAAuB,CAAC;AAE/B,OAAO,EAAE,gBAAgB,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC;AAEnE,OAAO,EACL,cAAc,EACd,cAAc,EACd,UAAU,EACV,eAAe,EACf,YAAY,EACZ,sBAAsB,GACvB,MAAM,kBAAkB,CAAC;AAC1B,YAAY,EACV,aAAa,EACb,WAAW,EACX,WAAW,EACX,YAAY,EACZ,gBAAgB,GACjB,MAAM,kBAAkB,CAAC"}

package/dist/providers/index.js

@@ -0,0 +1,3 @@
+export { noopErrorTracker, noopAnalytics } from './noop-providers.js';
+export { MODEL_REGISTRY, getModelConfig, listModels, getDefaultModel, resolveModel, createProviderRegistry, } from './model-resolver.js';
+//# sourceMappingURL=index.js.map

package/dist/providers/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/providers/index.ts"],"names":[],"mappings":"AAOA,OAAO,EAAE,gBAAgB,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC;AAEnE,OAAO,EACL,cAAc,EACd,cAAc,EACd,UAAU,EACV,eAAe,EACf,YAAY,EACZ,sBAAsB,GACvB,MAAM,kBAAkB,CAAC"}

package/dist/providers/model-resolver.d.ts

@@ -0,0 +1,93 @@
+import type { LanguageModel } from 'ai';
+/** Supported AI provider identifiers. */
+export type ModelProvider = 'anthropic' | 'openai' | 'google' | 'deepseek' | 'xai';
+/** Metadata and routing information for a known AI model. */
+export interface ModelConfig {
+    /** Unique model identifier used for resolution (e.g. 'claude-sonnet-4'). */
+    id: string;
+    /** Which AI provider hosts this model. */
+    provider: ModelProvider;
+    /** The provider-specific model ID passed to the SDK (e.g. 'claude-sonnet-4-20250514'). */
+    modelId: string;
+    /** Human-readable display name. */
+    displayName: string;
+    /** Maximum context window in tokens. */
+    contextWindow?: number;
+    /** Whether the model supports image/vision inputs. */
+    supportsVision?: boolean;
+    /** Whether the model supports tool/function calling. */
+    supportsTools?: boolean;
+    /** Cost per 1,000 input tokens in USD. */
+    costPer1kInput?: number;
+    /** Cost per 1,000 output tokens in USD. */
+    costPer1kOutput?: number;
+}
+/** Filter criteria for listing models. */
+export interface ModelFilter {
+    provider?: ModelProvider;
+    supportsTools?: boolean;
+    supportsVision?: boolean;
+}
+/**
+ * Canonical registry of known AI models with metadata.
+ * Consumers use model IDs from this list to resolve provider-specific instances.
+ */
+export declare const MODEL_REGISTRY: readonly ModelConfig[];
+/**
+ * Look up a model configuration by its canonical ID.
+ * Returns undefined if the model ID is not in the registry.
+ */
+export declare function getModelConfig(modelId: string): ModelConfig | undefined;
+/**
+ * List models from the registry, optionally filtering by provider or capabilities.
+ */
+export declare function listModels(filter?: ModelFilter): ModelConfig[];
+/**
+ * Get the default model configuration (GPT-4o).
+ */
+export declare function getDefaultModel(): ModelConfig;
+/**
+ * Factory function that creates an AI SDK LanguageModel from a provider-specific model ID.
+ * Consumers register one factory per provider (e.g. anthropic, openai).
+ */
+export type ModelFactory = (modelId: string) => LanguageModel;
+/**
+ * A map of provider names to their ModelFactory functions.
+ * Consumers populate this with their actual AI SDK provider instances.
+ *
+ * @example
+ * ```ts
+ * import { anthropic } from '@ai-sdk/anthropic';
+ * import { openai } from '@ai-sdk/openai';
+ *
+ * const providers: ProviderRegistry = new Map([
+ *   ['anthropic', (id) => anthropic(id)],
+ *   ['openai', (id) => openai(id)],
+ * ]);
+ * ```
+ */
+export type ProviderRegistry = Map<string, ModelFactory>;
+/**
+ * Resolve a canonical model ID to an AI SDK LanguageModel instance.
+ *
+ * Looks up the model in MODEL_REGISTRY, finds its provider, then delegates
+ * to the matching factory in the ProviderRegistry.
+ *
+ * @throws {Error} If the model ID is not in the registry
+ * @throws {Error} If no provider factory is registered for the model's provider
+ */
+export declare function resolveModel(modelId: string, providers: ProviderRegistry): LanguageModel;
+/**
+ * Create a ProviderRegistry from a plain object of provider name to factory pairs.
+ * Convenience helper to avoid manual Map construction.
+ *
+ * @example
+ * ```ts
+ * const providers = createProviderRegistry({
+ *   anthropic: (id) => anthropic(id),
+ *   openai: (id) => openai(id),
+ * });
+ * ```
+ */
+export declare function createProviderRegistry(factories: Record<string, ModelFactory>): ProviderRegistry;
+//# sourceMappingURL=model-resolver.d.ts.map

package/dist/providers/model-resolver.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"model-resolver.d.ts","sourceRoot":"","sources":["../../src/providers/model-resolver.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,IAAI,CAAC;AAExC,yCAAyC;AACzC,MAAM,MAAM,aAAa,GAAG,WAAW,GAAG,QAAQ,GAAG,QAAQ,GAAG,UAAU,GAAG,KAAK,CAAC;AAEnF,6DAA6D;AAC7D,MAAM,WAAW,WAAW;IAC1B,4EAA4E;IAC5E,EAAE,EAAE,MAAM,CAAC;IACX,0CAA0C;IAC1C,QAAQ,EAAE,aAAa,CAAC;IACxB,0FAA0F;IAC1F,OAAO,EAAE,MAAM,CAAC;IAChB,mCAAmC;IACnC,WAAW,EAAE,MAAM,CAAC;IACpB,wCAAwC;IACxC,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,sDAAsD;IACtD,cAAc,CAAC,EAAE,OAAO,CAAC;IACzB,wDAAwD;IACxD,aAAa,CAAC,EAAE,OAAO,CAAC;IACxB,0CAA0C;IAC1C,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,2CAA2C;IAC3C,eAAe,CAAC,EAAE,MAAM,CAAC;CAC1B;AAED,0CAA0C;AAC1C,MAAM,WAAW,WAAW;IAC1B,QAAQ,CAAC,EAAE,aAAa,CAAC;IACzB,aAAa,CAAC,EAAE,OAAO,CAAC;IACxB,cAAc,CAAC,EAAE,OAAO,CAAC;CAC1B;AAED;;;GAGG;AACH,eAAO,MAAM,cAAc,EAAE,SAAS,WAAW,EA4EvC,CAAC;AAKX;;;GAGG;AACH,wBAAgB,cAAc,CAAC,OAAO,EAAE,MAAM,GAAG,WAAW,GAAG,SAAS,CAEvE;AAED;;GAEG;AACH,wBAAgB,UAAU,CAAC,MAAM,CAAC,EAAE,WAAW,GAAG,WAAW,EAAE,CAW9D;AAED;;GAEG;AACH,wBAAgB,eAAe,IAAI,WAAW,CAM7C;AAED;;;GAGG;AACH,MAAM,MAAM,YAAY,GAAG,CAAC,OAAO,EAAE,MAAM,KAAK,aAAa,CAAC;AAE9D;;;;;;;;;;;;;;GAcG;AACH,MAAM,MAAM,gBAAgB,GAAG,GAAG,CAAC,MAAM,EAAE,YAAY,CAAC,CAAC;AAEzD;;;;;;;;GAQG;AACH,wBAAgB,YAAY,CAAC,OAAO,EAAE,MAAM,EAAE,SAAS,EAAE,gBAAgB,GAAG,aAAa,CAcxF;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,sBAAsB,CAAC,SAAS,EAAE,MAAM,CAAC,MAAM,EAAE,YAAY,CAAC,GAAG,gBAAgB,CAEhG"}

package/dist/providers/model-resolver.js

@@ -0,0 +1,152 @@
+/**
+ * Canonical registry of known AI models with metadata.
+ * Consumers use model IDs from this list to resolve provider-specific instances.
+ */
+export const MODEL_REGISTRY = [
+    // Anthropic
+    {
+        id: 'claude-sonnet-4',
+        provider: 'anthropic',
+        modelId: 'claude-sonnet-4-20250514',
+        displayName: 'Claude Sonnet 4',
+        contextWindow: 200_000,
+        supportsVision: true,
+        supportsTools: true,
+    },
+    {
+        id: 'claude-haiku-3.5',
+        provider: 'anthropic',
+        modelId: 'claude-haiku-4-5-20251001',
+        displayName: 'Claude Haiku 3.5',
+        contextWindow: 200_000,
+        supportsVision: true,
+        supportsTools: true,
+    },
+    // OpenAI
+    {
+        id: 'gpt-4o',
+        provider: 'openai',
+        modelId: 'gpt-4o',
+        displayName: 'GPT-4o',
+        contextWindow: 128_000,
+        supportsVision: true,
+        supportsTools: true,
+    },
+    {
+        id: 'gpt-4o-mini',
+        provider: 'openai',
+        modelId: 'gpt-4o-mini',
+        displayName: 'GPT-4o Mini',
+        contextWindow: 128_000,
+        supportsVision: true,
+        supportsTools: true,
+    },
+    // Google
+    {
+        id: 'gemini-2.0-flash',
+        provider: 'google',
+        modelId: 'gemini-2.0-flash',
+        displayName: 'Gemini 2.0 Flash',
+        contextWindow: 1_000_000,
+        supportsVision: true,
+        supportsTools: true,
+    },
+    {
+        id: 'gemini-2.5-pro',
+        provider: 'google',
+        modelId: 'gemini-2.5-pro-preview-06-05',
+        displayName: 'Gemini 2.5 Pro',
+        contextWindow: 1_000_000,
+        supportsVision: true,
+        supportsTools: true,
+    },
+    // DeepSeek
+    {
+        id: 'deepseek-chat',
+        provider: 'deepseek',
+        modelId: 'deepseek-chat',
+        displayName: 'DeepSeek V3',
+        contextWindow: 64_000,
+        supportsTools: true,
+    },
+    // xAI
+    {
+        id: 'grok-3',
+        provider: 'xai',
+        modelId: 'grok-3',
+        displayName: 'Grok 3',
+        contextWindow: 131_072,
+        supportsTools: true,
+    },
+];
+/** Default model ID used when none is specified. */
+const DEFAULT_MODEL_ID = 'gpt-4o';
+/**
+ * Look up a model configuration by its canonical ID.
+ * Returns undefined if the model ID is not in the registry.
+ */
+export function getModelConfig(modelId) {
+    return MODEL_REGISTRY.find((m) => m.id === modelId);
+}
+/**
+ * List models from the registry, optionally filtering by provider or capabilities.
+ */
+export function listModels(filter) {
+    if (!filter)
+        return [...MODEL_REGISTRY];
+    return MODEL_REGISTRY.filter((m) => {
+        if (filter.provider && m.provider !== filter.provider)
+            return false;
+        if (filter.supportsTools !== undefined && m.supportsTools !== filter.supportsTools)
+            return false;
+        if (filter.supportsVision !== undefined && m.supportsVision !== filter.supportsVision)
+            return false;
+        return true;
+    });
+}
+/**
+ * Get the default model configuration (GPT-4o).
+ */
+export function getDefaultModel() {
+    const config = getModelConfig(DEFAULT_MODEL_ID);
+    if (!config) {
+        throw new Error(`Default model '${DEFAULT_MODEL_ID}' not found in MODEL_REGISTRY`);
+    }
+    return config;
+}
+/**
+ * Resolve a canonical model ID to an AI SDK LanguageModel instance.
+ *
+ * Looks up the model in MODEL_REGISTRY, finds its provider, then delegates
+ * to the matching factory in the ProviderRegistry.
+ *
+ * @throws {Error} If the model ID is not in the registry
+ * @throws {Error} If no provider factory is registered for the model's provider
+ */
+export function resolveModel(modelId, providers) {
+    const config = getModelConfig(modelId);
+    if (!config) {
+        throw new Error(`Unknown model '${modelId}'. Use listModels() to see available models.`);
+    }
+    const factory = providers.get(config.provider);
+    if (!factory) {
+        throw new Error(`No provider registered for '${config.provider}'. Register it via providers.set('${config.provider}', factory).`);
+    }
+    return factory(config.modelId);
+}
+/**
+ * Create a ProviderRegistry from a plain object of provider name to factory pairs.
+ * Convenience helper to avoid manual Map construction.
+ *
+ * @example
+ * ```ts
+ * const providers = createProviderRegistry({
+ *   anthropic: (id) => anthropic(id),
+ *   openai: (id) => openai(id),
+ * });
+ * ```
+ */
+export function createProviderRegistry(factories) {
+    return new Map(Object.entries(factories));
+}
+//# sourceMappingURL=model-resolver.js.map

package/dist/providers/model-resolver.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"model-resolver.js","sourceRoot":"","sources":["../../src/providers/model-resolver.ts"],"names":[],"mappings":"AAkCA;;;GAGG;AACH,MAAM,CAAC,MAAM,cAAc,GAA2B;IACpD,YAAY;IACZ;QACE,EAAE,EAAE,iBAAiB;QACrB,QAAQ,EAAE,WAAW;QACrB,OAAO,EAAE,0BAA0B;QACnC,WAAW,EAAE,iBAAiB;QAC9B,aAAa,EAAE,OAAO;QACtB,cAAc,EAAE,IAAI;QACpB,aAAa,EAAE,IAAI;KACpB;IACD;QACE,EAAE,EAAE,kBAAkB;QACtB,QAAQ,EAAE,WAAW;QACrB,OAAO,EAAE,2BAA2B;QACpC,WAAW,EAAE,kBAAkB;QAC/B,aAAa,EAAE,OAAO;QACtB,cAAc,EAAE,IAAI;QACpB,aAAa,EAAE,IAAI;KACpB;IACD,SAAS;IACT;QACE,EAAE,EAAE,QAAQ;QACZ,QAAQ,EAAE,QAAQ;QAClB,OAAO,EAAE,QAAQ;QACjB,WAAW,EAAE,QAAQ;QACrB,aAAa,EAAE,OAAO;QACtB,cAAc,EAAE,IAAI;QACpB,aAAa,EAAE,IAAI;KACpB;IACD;QACE,EAAE,EAAE,aAAa;QACjB,QAAQ,EAAE,QAAQ;QAClB,OAAO,EAAE,aAAa;QACtB,WAAW,EAAE,aAAa;QAC1B,aAAa,EAAE,OAAO;QACtB,cAAc,EAAE,IAAI;QACpB,aAAa,EAAE,IAAI;KACpB;IACD,SAAS;IACT;QACE,EAAE,EAAE,kBAAkB;QACtB,QAAQ,EAAE,QAAQ;QAClB,OAAO,EAAE,kBAAkB;QAC3B,WAAW,EAAE,kBAAkB;QAC/B,aAAa,EAAE,SAAS;QACxB,cAAc,EAAE,IAAI;QACpB,aAAa,EAAE,IAAI;KACpB;IACD;QACE,EAAE,EAAE,gBAAgB;QACpB,QAAQ,EAAE,QAAQ;QAClB,OAAO,EAAE,8BAA8B;QACvC,WAAW,EAAE,gBAAgB;QAC7B,aAAa,EAAE,SAAS;QACxB,cAAc,EAAE,IAAI;QACpB,aAAa,EAAE,IAAI;KACpB;IACD,WAAW;IACX;QACE,EAAE,EAAE,eAAe;QACnB,QAAQ,EAAE,UAAU;QACpB,OAAO,EAAE,eAAe;QACxB,WAAW,EAAE,aAAa;QAC1B,aAAa,EAAE,MAAM;QACrB,aAAa,EAAE,IAAI;KACpB;IACD,MAAM;IACN;QACE,EAAE,EAAE,QAAQ;QACZ,QAAQ,EAAE,KAAK;QACf,OAAO,EAAE,QAAQ;QACjB,WAAW,EAAE,QAAQ;QACrB,aAAa,EAAE,OAAO;QACtB,aAAa,EAAE,IAAI;KACpB;CACO,CAAC;AAEX,oDAAoD;AACpD,MAAM,gBAAgB,GAAG,QAAQ,CAAC;AAElC;;;GAGG;AACH,MAAM,UAAU,cAAc,CAAC,OAAe;IAC5C,OAAO,cAAc,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,KAAK,OAAO,CAAC,CAAC;AACtD,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,UAAU,CAAC,MAAoB;IAC7C,IAAI,CAAC,MAAM;QAAE,OAAO,CAAC,GAAG,cAAc,CAAC,CAAC;IAExC,OAAO,cAAc,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE;QACjC,IAAI,MAAM,CAAC,QAAQ,IAAI,CAAC,CAAC,QAAQ,KAAK,MAAM,CAAC,QAAQ;YAAE,OAAO,KAAK,CAAC;QACpE,IAAI,MAAM,CAAC,aAAa,KAAK,SAAS,IAAI,CAAC,CAAC,aAAa,KAAK,MAAM,CAAC,aAAa;YAChF,OAAO,KAAK,CAAC;QACf,IAAI,MAAM,CAAC,cAAc,KAAK,SAAS,IAAI,CAAC,CAAC,cAAc,KAAK,MAAM,CAAC,cAAc;YACnF,OAAO,KAAK,CAAC;QACf,OAAO,IAAI,CAAC;IACd,CAAC,CAAC,CAAC;AACL,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,eAAe;IAC7B,MAAM,MAAM,GAAG,cAAc,CAAC,gBAAgB,CAAC,CAAC;IAChD,IAAI,CAAC,MAAM,EAAE,CAAC;QACZ,MAAM,IAAI,KAAK,CAAC,kBAAkB,gBAAgB,+BAA+B,CAAC,CAAC;IACrF,CAAC;IACD,OAAO,MAAM,CAAC;AAChB,CAAC;AAyBD;;;;;;;;GAQG;AACH,MAAM,UAAU,YAAY,CAAC,OAAe,EAAE,SAA2B;IACvE,MAAM,MAAM,GAAG,cAAc,CAAC,OAAO,CAAC,CAAC;IACvC,IAAI,CAAC,MAAM,EAAE,CAAC;QACZ,MAAM,IAAI,KAAK,CAAC,kBAAkB,OAAO,8CAA8C,CAAC,CAAC;IAC3F,CAAC;IAED,MAAM,OAAO,GAAG,SAAS,CAAC,GAAG,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC;IAC/C,IAAI,CAAC,OAAO,EAAE,CAAC;QACb,MAAM,IAAI,KAAK,CACb,+BAA+B,MAAM,CAAC,QAAQ,qCAAqC,MAAM,CAAC,QAAQ,cAAc,CACjH,CAAC;IACJ,CAAC;IAED,OAAO,OAAO,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;AACjC,CAAC;AAED;;;;;;;;;;;GAWG;AACH,MAAM,UAAU,sBAAsB,CAAC,SAAuC;IAC5E,OAAO,IAAI,GAAG,CAAC,MAAM,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC,CAAC;AAC5C,CAAC"}