@objectstack/spec 0.2.0 → 0.3.1

package/dist/ai/model-registry.zod.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"model-registry.zod.d.ts","sourceRoot":"","sources":["../../src/ai/model-registry.zod.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB;;;;;GAKG;AAEH;;GAEG;AACH,eAAO,MAAM,mBAAmB,0GAS9B,CAAC;AAEH;;GAEG;AACH,eAAO,MAAM,qBAAqB;;;;;;;;;;;;;;;;;;;;;;;;EAQhC,CAAC;AAEH;;GAEG;AACH,eAAO,MAAM,iBAAiB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAQ5B,CAAC;AAEH;;GAEG;AACH,eAAO,MAAM,kBAAkB;;;;;;;;;;;;;;;EAK7B,CAAC;AAEH;;GAEG;AACH,eAAO,MAAM,iBAAiB;IAC5B,eAAe;;;;;IAMf,mBAAmB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;IAInB,cAAc;;;;;;;;;;;;;;;;;IAGd,oBAAoB;;;;IAKpB,eAAe;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAKf,CAAC;AAEH;;GAEG;AACH,eAAO,MAAM,oBAAoB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAY/B,CAAC;AAEH;;GAEG;AACH,eAAO,MAAM,oBAAoB;IAC/B,eAAe;;;;IAKf,uBAAuB;;;;IAKvB,gBAAgB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;IAGhB,0BAA0B;;;;;;;;IAS1B,eAAe;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EASf,CAAC;AAEH;;GAEG;AACH,eAAO,MAAM,wBAAwB;;QAlFnC,eAAe;;;;;QAMf,mBAAmB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;QAInB,cAAc;;;;;;;;;;;;;;;;;QAGd,oBAAoB;;;;QAKpB,eAAe;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EA2Ef,CAAC;AAEH;;GAEG;AACH,eAAO,MAAM,mBAAmB;;;;YAlG9B,eAAe;;;;;YAMf,mBAAmB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;YAInB,cAAc;;;;;;;;;;;;;;;;;YAGd,oBAAoB;;;;YAKpB,eAAe;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;QA4Bf,eAAe;;;;QAKf,uBAAuB;;;;QAKvB,gBAAgB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;QAGhB,0BAA0B;;;;;;;;QAS1B,eAAe;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAoCf,CAAC;AAEH;;GAEG;AACH,eAAO,MAAM,4BAA4B;;;;;;;;;;;;;;;;;;;;;EAOvC,CAAC;AAGH,MAAM,MAAM,aAAa,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,mBAAmB,CAAC,CAAC;AAChE,MAAM,MAAM,eAAe,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,qBAAqB,CAAC,CAAC;AACpE,MAAM,MAAM,WAAW,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,iBAAiB,CAAC,CAAC;AAC5D,MAAM,MAAM,YAAY,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,kBAAkB,CAAC,CAAC;AAC9D,MAAM,MAAM,WAAW,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,iBAAiB,CAAC,CAAC;AAC5D,MAAM,MAAM,cAAc,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,oBAAoB,CAAC,CAAC;AAClE,MAAM,MAAM,cAAc,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,oBAAoB,CAAC,CAAC;AAClE,MAAM,MAAM,kBAAkB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,wBAAwB,CAAC,CAAC;AAC1E,MAAM,MAAM,aAAa,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,mBAAmB,CAAC,CAAC;AAChE,MAAM,MAAM,sBAAsB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,4BAA4B,CAAC,CAAC"}

package/dist/ai/model-registry.zod.js

@@ -0,0 +1,164 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ModelSelectionCriteriaSchema = exports.ModelRegistrySchema = exports.ModelRegistryEntrySchema = exports.PromptTemplateSchema = exports.PromptVariableSchema = exports.ModelConfigSchema = exports.ModelPricingSchema = exports.ModelLimitsSchema = exports.ModelCapabilitySchema = exports.ModelProviderSchema = void 0;
+const zod_1 = require("zod");
+/**
+ * AI Model Registry Protocol
+ *
+ * Centralized registry for managing AI models, prompt templates, and model versioning.
+ * Enables AI-powered ObjectStack applications to discover and use LLMs consistently.
+ */
+/**
+ * Model Provider Type
+ */
+exports.ModelProviderSchema = zod_1.z.enum([
+    'openai',
+    'azure_openai',
+    'anthropic',
+    'google',
+    'cohere',
+    'huggingface',
+    'local',
+    'custom',
+]);
+/**
+ * Model Capability
+ */
+exports.ModelCapabilitySchema = zod_1.z.object({
+    textGeneration: zod_1.z.boolean().optional().default(true).describe('Supports text generation'),
+    textEmbedding: zod_1.z.boolean().optional().default(false).describe('Supports text embedding'),
+    imageGeneration: zod_1.z.boolean().optional().default(false).describe('Supports image generation'),
+    imageUnderstanding: zod_1.z.boolean().optional().default(false).describe('Supports image understanding'),
+    functionCalling: zod_1.z.boolean().optional().default(false).describe('Supports function calling'),
+    codeGeneration: zod_1.z.boolean().optional().default(false).describe('Supports code generation'),
+    reasoning: zod_1.z.boolean().optional().default(false).describe('Supports advanced reasoning'),
+});
+/**
+ * Model Limits
+ */
+exports.ModelLimitsSchema = zod_1.z.object({
+    maxTokens: zod_1.z.number().int().positive().describe('Maximum tokens per request'),
+    contextWindow: zod_1.z.number().int().positive().describe('Context window size'),
+    maxOutputTokens: zod_1.z.number().int().positive().optional().describe('Maximum output tokens'),
+    rateLimit: zod_1.z.object({
+        requestsPerMinute: zod_1.z.number().int().positive().optional(),
+        tokensPerMinute: zod_1.z.number().int().positive().optional(),
+    }).optional(),
+});
+/**
+ * Model Pricing
+ */
+exports.ModelPricingSchema = zod_1.z.object({
+    currency: zod_1.z.string().optional().default('USD'),
+    inputCostPer1kTokens: zod_1.z.number().optional().describe('Cost per 1K input tokens'),
+    outputCostPer1kTokens: zod_1.z.number().optional().describe('Cost per 1K output tokens'),
+    embeddingCostPer1kTokens: zod_1.z.number().optional().describe('Cost per 1K embedding tokens'),
+});
+/**
+ * Model Configuration
+ */
+exports.ModelConfigSchema = zod_1.z.object({
+    /** Identity */
+    id: zod_1.z.string().describe('Unique model identifier'),
+    name: zod_1.z.string().describe('Model display name'),
+    version: zod_1.z.string().describe('Model version (e.g., "gpt-4-turbo-2024-04-09")'),
+    provider: exports.ModelProviderSchema,
+    /** Capabilities */
+    capabilities: exports.ModelCapabilitySchema,
+    limits: exports.ModelLimitsSchema,
+    /** Pricing */
+    pricing: exports.ModelPricingSchema.optional(),
+    /** Configuration */
+    endpoint: zod_1.z.string().url().optional().describe('Custom API endpoint'),
+    apiKey: zod_1.z.string().optional().describe('API key or reference to secret'),
+    region: zod_1.z.string().optional().describe('Deployment region (e.g., "us-east-1")'),
+    /** Metadata */
+    description: zod_1.z.string().optional(),
+    tags: zod_1.z.array(zod_1.z.string()).optional().describe('Tags for categorization'),
+    deprecated: zod_1.z.boolean().optional().default(false),
+    recommendedFor: zod_1.z.array(zod_1.z.string()).optional().describe('Use case recommendations'),
+});
+/**
+ * Prompt Template Variable
+ */
+exports.PromptVariableSchema = zod_1.z.object({
+    name: zod_1.z.string().describe('Variable name (e.g., "user_name", "context")'),
+    type: zod_1.z.enum(['string', 'number', 'boolean', 'object', 'array']).default('string'),
+    required: zod_1.z.boolean().default(false),
+    defaultValue: zod_1.z.any().optional(),
+    description: zod_1.z.string().optional(),
+    validation: zod_1.z.object({
+        minLength: zod_1.z.number().optional(),
+        maxLength: zod_1.z.number().optional(),
+        pattern: zod_1.z.string().optional(),
+        enum: zod_1.z.array(zod_1.z.any()).optional(),
+    }).optional(),
+});
+/**
+ * Prompt Template
+ */
+exports.PromptTemplateSchema = zod_1.z.object({
+    /** Identity */
+    id: zod_1.z.string().describe('Unique template identifier'),
+    name: zod_1.z.string().regex(/^[a-z_][a-z0-9_]*$/).describe('Template name (snake_case)'),
+    label: zod_1.z.string().describe('Display name'),
+    /** Template Content */
+    system: zod_1.z.string().optional().describe('System prompt'),
+    user: zod_1.z.string().describe('User prompt template with variables'),
+    assistant: zod_1.z.string().optional().describe('Assistant message prefix'),
+    /** Variables */
+    variables: zod_1.z.array(exports.PromptVariableSchema).optional().describe('Template variables'),
+    /** Model Configuration */
+    modelId: zod_1.z.string().optional().describe('Recommended model ID'),
+    temperature: zod_1.z.number().min(0).max(2).optional(),
+    maxTokens: zod_1.z.number().optional(),
+    topP: zod_1.z.number().optional(),
+    frequencyPenalty: zod_1.z.number().optional(),
+    presencePenalty: zod_1.z.number().optional(),
+    stopSequences: zod_1.z.array(zod_1.z.string()).optional(),
+    /** Metadata */
+    version: zod_1.z.string().optional().default('1.0.0'),
+    description: zod_1.z.string().optional(),
+    category: zod_1.z.string().optional().describe('Template category (e.g., "code_generation", "support")'),
+    tags: zod_1.z.array(zod_1.z.string()).optional(),
+    examples: zod_1.z.array(zod_1.z.object({
+        input: zod_1.z.record(zod_1.z.any()).describe('Example variable values'),
+        output: zod_1.z.string().describe('Expected output'),
+    })).optional(),
+});
+/**
+ * Model Registry Entry
+ */
+exports.ModelRegistryEntrySchema = zod_1.z.object({
+    model: exports.ModelConfigSchema,
+    status: zod_1.z.enum(['active', 'deprecated', 'experimental', 'disabled']).default('active'),
+    priority: zod_1.z.number().int().default(0).describe('Priority for model selection'),
+    fallbackModels: zod_1.z.array(zod_1.z.string()).optional().describe('Fallback model IDs'),
+    healthCheck: zod_1.z.object({
+        enabled: zod_1.z.boolean().default(true),
+        intervalSeconds: zod_1.z.number().int().default(300),
+        lastChecked: zod_1.z.string().optional().describe('ISO timestamp'),
+        status: zod_1.z.enum(['healthy', 'unhealthy', 'unknown']).default('unknown'),
+    }).optional(),
+});
+/**
+ * Model Registry
+ */
+exports.ModelRegistrySchema = zod_1.z.object({
+    name: zod_1.z.string().describe('Registry name'),
+    models: zod_1.z.record(exports.ModelRegistryEntrySchema).describe('Model entries by ID'),
+    promptTemplates: zod_1.z.record(exports.PromptTemplateSchema).optional().describe('Prompt templates by name'),
+    defaultModel: zod_1.z.string().optional().describe('Default model ID'),
+    enableAutoFallback: zod_1.z.boolean().default(true).describe('Auto-fallback on errors'),
+});
+/**
+ * Model Selection Criteria
+ */
+exports.ModelSelectionCriteriaSchema = zod_1.z.object({
+    capabilities: zod_1.z.array(zod_1.z.string()).optional().describe('Required capabilities'),
+    maxCostPer1kTokens: zod_1.z.number().optional().describe('Maximum acceptable cost'),
+    minContextWindow: zod_1.z.number().optional().describe('Minimum context window size'),
+    provider: exports.ModelProviderSchema.optional(),
+    tags: zod_1.z.array(zod_1.z.string()).optional(),
+    excludeDeprecated: zod_1.z.boolean().default(true),
+});