@objectstack/spec 0.2.0 → 0.3.1

package/dist/ai/cost.zod.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cost.zod.d.ts","sourceRoot":"","sources":["../../src/ai/cost.zod.ts"],"names":[],"mappings":"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"}

package/dist/ai/cost.zod.js

@@ -0,0 +1,324 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.CostQueryFiltersSchema = exports.CostReportSchema = exports.CostOptimizationRecommendationSchema = exports.CostAnalyticsSchema = exports.CostBreakdownEntrySchema = exports.CostBreakdownDimensionSchema = exports.CostAlertSchema = exports.CostAlertTypeSchema = exports.BudgetStatusSchema = exports.BudgetLimitSchema = exports.BudgetTypeSchema = exports.CostEntrySchema = exports.BillingPeriodSchema = exports.CostMetricTypeSchema = void 0;
+const zod_1 = require("zod");
+/**
+ * AI Cost Tracking Protocol
+ *
+ * Monitor and control AI API costs with budgets, alerts, and analytics.
+ * Provides cost optimization, budget enforcement, and financial reporting.
+ */
+/**
+ * Cost Metric Type
+ */
+exports.CostMetricTypeSchema = zod_1.z.enum([
+    'token', // Cost per token
+    'request', // Cost per API request
+    'character', // Cost per character (e.g., TTS)
+    'second', // Cost per second (e.g., speech)
+    'image', // Cost per image
+    'embedding', // Cost per embedding
+]);
+/**
+ * Billing Period
+ */
+exports.BillingPeriodSchema = zod_1.z.enum([
+    'hourly',
+    'daily',
+    'weekly',
+    'monthly',
+    'quarterly',
+    'yearly',
+    'custom',
+]);
+/**
+ * Cost Entry
+ */
+exports.CostEntrySchema = zod_1.z.object({
+    /** Identity */
+    id: zod_1.z.string().describe('Unique cost entry ID'),
+    timestamp: zod_1.z.string().describe('ISO 8601 timestamp'),
+    /** Request Details */
+    modelId: zod_1.z.string().describe('AI model used'),
+    provider: zod_1.z.string().describe('AI provider (e.g., "openai", "anthropic")'),
+    operation: zod_1.z.string().describe('Operation type (e.g., "chat_completion", "embedding")'),
+    /** Usage Metrics */
+    promptTokens: zod_1.z.number().int().nonnegative().optional(),
+    completionTokens: zod_1.z.number().int().nonnegative().optional(),
+    totalTokens: zod_1.z.number().int().nonnegative().optional(),
+    requestCount: zod_1.z.number().int().positive().default(1),
+    /** Cost Calculation */
+    promptCost: zod_1.z.number().nonnegative().optional().describe('Cost of prompt tokens'),
+    completionCost: zod_1.z.number().nonnegative().optional().describe('Cost of completion tokens'),
+    totalCost: zod_1.z.number().nonnegative().describe('Total cost in base currency'),
+    currency: zod_1.z.string().default('USD'),
+    /** Context */
+    sessionId: zod_1.z.string().optional().describe('Conversation session ID'),
+    userId: zod_1.z.string().optional().describe('User who triggered the request'),
+    agentId: zod_1.z.string().optional().describe('AI agent ID'),
+    object: zod_1.z.string().optional().describe('Related object (e.g., "case", "project")'),
+    recordId: zod_1.z.string().optional().describe('Related record ID'),
+    /** Metadata */
+    tags: zod_1.z.array(zod_1.z.string()).optional(),
+    metadata: zod_1.z.record(zod_1.z.any()).optional(),
+});
+/**
+ * Budget Type
+ */
+exports.BudgetTypeSchema = zod_1.z.enum([
+    'global', // Organization-wide budget
+    'user', // Per-user budget
+    'agent', // Per-agent budget
+    'object', // Per-object budget (e.g., per case)
+    'project', // Per-project budget
+    'department', // Per-department budget
+]);
+/**
+ * Budget Limit
+ */
+exports.BudgetLimitSchema = zod_1.z.object({
+    /** Limit Configuration */
+    type: exports.BudgetTypeSchema,
+    scope: zod_1.z.string().optional().describe('Scope identifier (userId, agentId, etc.)'),
+    /** Limit Amount */
+    maxCost: zod_1.z.number().nonnegative().describe('Maximum cost limit'),
+    currency: zod_1.z.string().default('USD'),
+    /** Period */
+    period: exports.BillingPeriodSchema,
+    customPeriodDays: zod_1.z.number().int().positive().optional().describe('Custom period in days'),
+    /** Soft Limits & Warnings */
+    softLimit: zod_1.z.number().nonnegative().optional().describe('Soft limit for warnings'),
+    warnThresholds: zod_1.z.array(zod_1.z.number().min(0).max(1)).optional().describe('Warning thresholds (e.g., [0.5, 0.8, 0.95])'),
+    /** Enforcement */
+    enforced: zod_1.z.boolean().default(true).describe('Block requests when exceeded'),
+    gracePeriodSeconds: zod_1.z.number().int().nonnegative().default(0).describe('Grace period after limit exceeded'),
+    /** Rollover */
+    allowRollover: zod_1.z.boolean().default(false).describe('Allow unused budget to rollover'),
+    maxRolloverPercentage: zod_1.z.number().min(0).max(1).optional().describe('Max rollover as % of limit'),
+    /** Metadata */
+    name: zod_1.z.string().optional().describe('Budget name'),
+    description: zod_1.z.string().optional(),
+    active: zod_1.z.boolean().default(true),
+    tags: zod_1.z.array(zod_1.z.string()).optional(),
+});
+/**
+ * Budget Status
+ */
+exports.BudgetStatusSchema = zod_1.z.object({
+    /** Budget Reference */
+    budgetId: zod_1.z.string(),
+    type: exports.BudgetTypeSchema,
+    scope: zod_1.z.string().optional(),
+    /** Current Period */
+    periodStart: zod_1.z.string().describe('ISO 8601 timestamp'),
+    periodEnd: zod_1.z.string().describe('ISO 8601 timestamp'),
+    /** Usage */
+    currentCost: zod_1.z.number().nonnegative().default(0),
+    maxCost: zod_1.z.number().nonnegative(),
+    currency: zod_1.z.string().default('USD'),
+    /** Status */
+    percentageUsed: zod_1.z.number().nonnegative().describe('Usage as percentage (can exceed 1.0 if over budget)'),
+    remainingCost: zod_1.z.number().describe('Remaining budget (can be negative if exceeded)'),
+    isExceeded: zod_1.z.boolean().default(false),
+    isWarning: zod_1.z.boolean().default(false),
+    /** Projections */
+    projectedCost: zod_1.z.number().nonnegative().optional().describe('Projected cost for period'),
+    projectedOverage: zod_1.z.number().nonnegative().optional().describe('Projected overage'),
+    /** Last Update */
+    lastUpdated: zod_1.z.string().describe('ISO 8601 timestamp'),
+});
+/**
+ * Cost Alert Type
+ */
+exports.CostAlertTypeSchema = zod_1.z.enum([
+    'threshold_warning', // Warning threshold reached
+    'threshold_critical', // Critical threshold reached
+    'limit_exceeded', // Budget limit exceeded
+    'anomaly_detected', // Unusual spending pattern
+    'projection_exceeded', // Projected to exceed budget
+]);
+/**
+ * Cost Alert
+ */
+exports.CostAlertSchema = zod_1.z.object({
+    /** Alert Details */
+    id: zod_1.z.string(),
+    timestamp: zod_1.z.string().describe('ISO 8601 timestamp'),
+    type: exports.CostAlertTypeSchema,
+    severity: zod_1.z.enum(['info', 'warning', 'critical']),
+    /** Budget Context */
+    budgetId: zod_1.z.string().optional(),
+    budgetType: exports.BudgetTypeSchema.optional(),
+    scope: zod_1.z.string().optional(),
+    /** Alert Information */
+    message: zod_1.z.string().describe('Alert message'),
+    currentCost: zod_1.z.number().nonnegative(),
+    maxCost: zod_1.z.number().nonnegative().optional(),
+    threshold: zod_1.z.number().min(0).max(1).optional(),
+    currency: zod_1.z.string().default('USD'),
+    /** Recommendations */
+    recommendations: zod_1.z.array(zod_1.z.string()).optional(),
+    /** Status */
+    acknowledged: zod_1.z.boolean().default(false),
+    acknowledgedBy: zod_1.z.string().optional(),
+    acknowledgedAt: zod_1.z.string().optional(),
+    resolved: zod_1.z.boolean().default(false),
+    /** Metadata */
+    metadata: zod_1.z.record(zod_1.z.any()).optional(),
+});
+/**
+ * Cost Breakdown Dimension
+ */
+exports.CostBreakdownDimensionSchema = zod_1.z.enum([
+    'model',
+    'provider',
+    'user',
+    'agent',
+    'object',
+    'operation',
+    'date',
+    'hour',
+    'tag',
+]);
+/**
+ * Cost Breakdown Entry
+ */
+exports.CostBreakdownEntrySchema = zod_1.z.object({
+    dimension: exports.CostBreakdownDimensionSchema,
+    value: zod_1.z.string().describe('Dimension value (e.g., model ID, user ID)'),
+    /** Metrics */
+    totalCost: zod_1.z.number().nonnegative(),
+    requestCount: zod_1.z.number().int().nonnegative(),
+    totalTokens: zod_1.z.number().int().nonnegative().optional(),
+    /** Share */
+    percentageOfTotal: zod_1.z.number().min(0).max(1),
+    /** Time Range */
+    periodStart: zod_1.z.string().optional(),
+    periodEnd: zod_1.z.string().optional(),
+});
+/**
+ * Cost Analytics
+ */
+exports.CostAnalyticsSchema = zod_1.z.object({
+    /** Time Range */
+    periodStart: zod_1.z.string().describe('ISO 8601 timestamp'),
+    periodEnd: zod_1.z.string().describe('ISO 8601 timestamp'),
+    /** Summary Metrics */
+    totalCost: zod_1.z.number().nonnegative(),
+    totalRequests: zod_1.z.number().int().nonnegative(),
+    totalTokens: zod_1.z.number().int().nonnegative().optional(),
+    currency: zod_1.z.string().default('USD'),
+    /** Averages */
+    averageCostPerRequest: zod_1.z.number().nonnegative(),
+    averageCostPerToken: zod_1.z.number().nonnegative().optional(),
+    averageRequestsPerDay: zod_1.z.number().nonnegative(),
+    /** Trends */
+    costTrend: zod_1.z.enum(['increasing', 'decreasing', 'stable']).optional(),
+    trendPercentage: zod_1.z.number().optional().describe('% change vs previous period'),
+    /** Breakdowns */
+    byModel: zod_1.z.array(exports.CostBreakdownEntrySchema).optional(),
+    byProvider: zod_1.z.array(exports.CostBreakdownEntrySchema).optional(),
+    byUser: zod_1.z.array(exports.CostBreakdownEntrySchema).optional(),
+    byAgent: zod_1.z.array(exports.CostBreakdownEntrySchema).optional(),
+    byOperation: zod_1.z.array(exports.CostBreakdownEntrySchema).optional(),
+    byDate: zod_1.z.array(exports.CostBreakdownEntrySchema).optional(),
+    /** Top Consumers */
+    topModels: zod_1.z.array(exports.CostBreakdownEntrySchema).optional(),
+    topUsers: zod_1.z.array(exports.CostBreakdownEntrySchema).optional(),
+    topAgents: zod_1.z.array(exports.CostBreakdownEntrySchema).optional(),
+    /** Efficiency Metrics */
+    tokensPerDollar: zod_1.z.number().nonnegative().optional(),
+    requestsPerDollar: zod_1.z.number().nonnegative().optional(),
+});
+/**
+ * Cost Optimization Recommendation
+ */
+exports.CostOptimizationRecommendationSchema = zod_1.z.object({
+    /** Recommendation Details */
+    id: zod_1.z.string(),
+    type: zod_1.z.enum([
+        'switch_model',
+        'reduce_tokens',
+        'batch_requests',
+        'cache_results',
+        'adjust_parameters',
+        'limit_usage',
+    ]),
+    /** Impact */
+    title: zod_1.z.string(),
+    description: zod_1.z.string(),
+    estimatedSavings: zod_1.z.number().nonnegative().optional(),
+    savingsPercentage: zod_1.z.number().min(0).max(1).optional(),
+    /** Implementation */
+    priority: zod_1.z.enum(['low', 'medium', 'high']),
+    effort: zod_1.z.enum(['low', 'medium', 'high']),
+    actionable: zod_1.z.boolean().default(true),
+    actionSteps: zod_1.z.array(zod_1.z.string()).optional(),
+    /** Context */
+    targetModel: zod_1.z.string().optional(),
+    alternativeModel: zod_1.z.string().optional(),
+    affectedUsers: zod_1.z.array(zod_1.z.string()).optional(),
+    /** Status */
+    status: zod_1.z.enum(['pending', 'accepted', 'rejected', 'implemented']).default('pending'),
+    implementedAt: zod_1.z.string().optional(),
+});
+/**
+ * Cost Report
+ */
+exports.CostReportSchema = zod_1.z.object({
+    /** Report Metadata */
+    id: zod_1.z.string(),
+    name: zod_1.z.string(),
+    generatedAt: zod_1.z.string().describe('ISO 8601 timestamp'),
+    /** Time Range */
+    periodStart: zod_1.z.string().describe('ISO 8601 timestamp'),
+    periodEnd: zod_1.z.string().describe('ISO 8601 timestamp'),
+    period: exports.BillingPeriodSchema,
+    /** Analytics */
+    analytics: exports.CostAnalyticsSchema,
+    /** Budgets */
+    budgets: zod_1.z.array(exports.BudgetStatusSchema).optional(),
+    /** Alerts */
+    alerts: zod_1.z.array(exports.CostAlertSchema).optional(),
+    activeAlertCount: zod_1.z.number().int().nonnegative().default(0),
+    /** Recommendations */
+    recommendations: zod_1.z.array(exports.CostOptimizationRecommendationSchema).optional(),
+    /** Comparisons */
+    previousPeriodCost: zod_1.z.number().nonnegative().optional(),
+    costChange: zod_1.z.number().optional().describe('Change vs previous period'),
+    costChangePercentage: zod_1.z.number().optional(),
+    /** Forecasting */
+    forecastedCost: zod_1.z.number().nonnegative().optional(),
+    forecastedBudgetStatus: zod_1.z.enum(['under', 'at', 'over']).optional(),
+    /** Export */
+    format: zod_1.z.enum(['summary', 'detailed', 'executive']).default('summary'),
+    currency: zod_1.z.string().default('USD'),
+});
+/**
+ * Cost Query Filters
+ */
+exports.CostQueryFiltersSchema = zod_1.z.object({
+    /** Time Range */
+    startDate: zod_1.z.string().optional().describe('ISO 8601 timestamp'),
+    endDate: zod_1.z.string().optional().describe('ISO 8601 timestamp'),
+    /** Dimensions */
+    modelIds: zod_1.z.array(zod_1.z.string()).optional(),
+    providers: zod_1.z.array(zod_1.z.string()).optional(),
+    userIds: zod_1.z.array(zod_1.z.string()).optional(),
+    agentIds: zod_1.z.array(zod_1.z.string()).optional(),
+    operations: zod_1.z.array(zod_1.z.string()).optional(),
+    sessionIds: zod_1.z.array(zod_1.z.string()).optional(),
+    /** Cost Range */
+    minCost: zod_1.z.number().nonnegative().optional(),
+    maxCost: zod_1.z.number().nonnegative().optional(),
+    /** Tags */
+    tags: zod_1.z.array(zod_1.z.string()).optional(),
+    /** Aggregation */
+    groupBy: zod_1.z.array(exports.CostBreakdownDimensionSchema).optional(),
+    /** Sorting */
+    orderBy: zod_1.z.enum(['timestamp', 'cost', 'tokens']).optional().default('timestamp'),
+    orderDirection: zod_1.z.enum(['asc', 'desc']).optional().default('desc'),
+    /** Pagination */
+    limit: zod_1.z.number().int().positive().optional(),
+    offset: zod_1.z.number().int().nonnegative().optional(),
+});

package/dist/ai/index.d.ts

@@ -0,0 +1,22 @@
+/**
+ * AI Protocol Exports
+ *
+ * AI/ML Capabilities
+ * - Agent Configuration
+ * - Model Registry & Selection
+ * - RAG Pipeline
+ * - Natural Language Query (NLQ)
+ * - Workflow Automation
+ * - Predictive Analytics
+ * - Conversation Memory & Token Management
+ * - Cost Tracking & Budget Management
+ */
+export * from './agent.zod';
+export * from './model-registry.zod';
+export * from './rag-pipeline.zod';
+export * from './nlq.zod';
+export * from './workflow-automation.zod';
+export * from './predictive.zod';
+export * from './conversation.zod';
+export * from './cost.zod';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/ai/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH,cAAc,aAAa,CAAC;AAC5B,cAAc,sBAAsB,CAAC;AACrC,cAAc,oBAAoB,CAAC;AACnC,cAAc,WAAW,CAAC;AAC1B,cAAc,2BAA2B,CAAC;AAC1C,cAAc,kBAAkB,CAAC;AACjC,cAAc,oBAAoB,CAAC;AACnC,cAAc,YAAY,CAAC"}

package/dist/ai/index.js

@@ -0,0 +1,37 @@
+"use strict";
+/**
+ * AI Protocol Exports
+ *
+ * AI/ML Capabilities
+ * - Agent Configuration
+ * - Model Registry & Selection
+ * - RAG Pipeline
+ * - Natural Language Query (NLQ)
+ * - Workflow Automation
+ * - Predictive Analytics
+ * - Conversation Memory & Token Management
+ * - Cost Tracking & Budget Management
+ */
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+__exportStar(require("./agent.zod"), exports);
+__exportStar(require("./model-registry.zod"), exports);
+__exportStar(require("./rag-pipeline.zod"), exports);
+__exportStar(require("./nlq.zod"), exports);
+__exportStar(require("./workflow-automation.zod"), exports);
+__exportStar(require("./predictive.zod"), exports);
+__exportStar(require("./conversation.zod"), exports);
+__exportStar(require("./cost.zod"), exports);