@objectstack/spec 0.3.0 → 0.3.2

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

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

package/dist/ai/conversation.zod.js

@@ -0,0 +1,248 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ConversationAnalyticsSchema = exports.MessagePruningEventSchema = exports.ConversationSummarySchema = exports.ConversationSessionSchema = exports.ConversationContextSchema = exports.TokenUsageStatsSchema = exports.TokenBudgetConfigSchema = exports.TokenBudgetStrategySchema = exports.ConversationMessageSchema = exports.ToolCallSchema = exports.FunctionCallSchema = exports.MessageContentSchema = exports.MessageContentTypeSchema = exports.MessageRoleSchema = void 0;
+const zod_1 = require("zod");
+/**
+ * AI Conversation Memory Protocol
+ *
+ * Multi-turn AI conversations with token budget management.
+ * Enables context preservation, conversation history, and token optimization.
+ */
+/**
+ * Message Role
+ */
+exports.MessageRoleSchema = zod_1.z.enum([
+    'system',
+    'user',
+    'assistant',
+    'function',
+    'tool',
+]);
+/**
+ * Message Content Type
+ */
+exports.MessageContentTypeSchema = zod_1.z.enum([
+    'text',
+    'image',
+    'file',
+    'code',
+    'structured',
+]);
+/**
+ * Message Content
+ */
+exports.MessageContentSchema = zod_1.z.object({
+    type: exports.MessageContentTypeSchema.default('text'),
+    text: zod_1.z.string().optional().describe('Text content'),
+    imageUrl: zod_1.z.string().url().optional().describe('Image URL for vision models'),
+    fileUrl: zod_1.z.string().url().optional().describe('File attachment URL'),
+    mimeType: zod_1.z.string().optional().describe('MIME type for files'),
+    metadata: zod_1.z.record(zod_1.z.any()).optional().describe('Additional metadata'),
+});
+/**
+ * Function Call
+ */
+exports.FunctionCallSchema = zod_1.z.object({
+    name: zod_1.z.string().describe('Function name'),
+    arguments: zod_1.z.string().describe('JSON string of function arguments'),
+    result: zod_1.z.string().optional().describe('Function execution result'),
+});
+/**
+ * Tool Call
+ */
+exports.ToolCallSchema = zod_1.z.object({
+    id: zod_1.z.string().describe('Tool call ID'),
+    type: zod_1.z.enum(['function']).default('function'),
+    function: exports.FunctionCallSchema,
+});
+/**
+ * Conversation Message
+ */
+exports.ConversationMessageSchema = zod_1.z.object({
+    /** Identity */
+    id: zod_1.z.string().describe('Unique message ID'),
+    timestamp: zod_1.z.string().describe('ISO 8601 timestamp'),
+    /** Content */
+    role: exports.MessageRoleSchema,
+    content: zod_1.z.union([
+        zod_1.z.string(),
+        zod_1.z.array(exports.MessageContentSchema),
+    ]).describe('Message content (text or multimodal)'),
+    /** Function/Tool Calls */
+    functionCall: exports.FunctionCallSchema.optional().describe('Legacy function call'),
+    toolCalls: zod_1.z.array(exports.ToolCallSchema).optional().describe('Tool calls'),
+    toolCallId: zod_1.z.string().optional().describe('Tool call ID this message responds to'),
+    /** Metadata */
+    name: zod_1.z.string().optional().describe('Name of the function/user'),
+    tokens: zod_1.z.object({
+        prompt: zod_1.z.number().int().nonnegative().optional().describe('Tokens in prompt'),
+        completion: zod_1.z.number().int().nonnegative().optional().describe('Tokens in completion'),
+        total: zod_1.z.number().int().nonnegative().optional().describe('Total tokens'),
+    }).optional().describe('Token usage for this message'),
+    /** Context Management */
+    pinned: zod_1.z.boolean().optional().default(false).describe('Prevent removal during pruning'),
+    importance: zod_1.z.number().min(0).max(1).optional().describe('Importance score for pruning'),
+    embedding: zod_1.z.array(zod_1.z.number()).optional().describe('Vector embedding for semantic search'),
+    /** Annotations */
+    metadata: zod_1.z.record(zod_1.z.any()).optional(),
+});
+/**
+ * Token Budget Strategy
+ */
+exports.TokenBudgetStrategySchema = zod_1.z.enum([
+    'fifo', // First-in-first-out (oldest messages dropped)
+    'importance', // Drop by importance score
+    'semantic', // Keep semantically relevant messages
+    'sliding_window', // Fixed window of recent messages
+    'summary', // Summarize old context
+]);
+/**
+ * Token Budget Configuration
+ */
+exports.TokenBudgetConfigSchema = zod_1.z.object({
+    /** Budget Limits */
+    maxTokens: zod_1.z.number().int().positive().describe('Maximum total tokens'),
+    maxPromptTokens: zod_1.z.number().int().positive().optional().describe('Max tokens for prompt'),
+    maxCompletionTokens: zod_1.z.number().int().positive().optional().describe('Max tokens for completion'),
+    /** Buffer & Reserves */
+    reserveTokens: zod_1.z.number().int().nonnegative().default(500).describe('Reserve tokens for system messages'),
+    bufferPercentage: zod_1.z.number().min(0).max(1).default(0.1).describe('Buffer percentage (0.1 = 10%)'),
+    /** Pruning Strategy */
+    strategy: exports.TokenBudgetStrategySchema.default('sliding_window'),
+    /** Strategy-Specific Options */
+    slidingWindowSize: zod_1.z.number().int().positive().optional().describe('Number of recent messages to keep'),
+    minImportanceScore: zod_1.z.number().min(0).max(1).optional().describe('Minimum importance to keep'),
+    semanticThreshold: zod_1.z.number().min(0).max(1).optional().describe('Semantic similarity threshold'),
+    /** Summarization */
+    enableSummarization: zod_1.z.boolean().default(false).describe('Enable context summarization'),
+    summarizationThreshold: zod_1.z.number().int().positive().optional().describe('Trigger summarization at N tokens'),
+    summaryModel: zod_1.z.string().optional().describe('Model ID for summarization'),
+    /** Monitoring */
+    warnThreshold: zod_1.z.number().min(0).max(1).default(0.8).describe('Warn at % of budget (0.8 = 80%)'),
+});
+/**
+ * Token Usage Stats
+ */
+exports.TokenUsageStatsSchema = zod_1.z.object({
+    promptTokens: zod_1.z.number().int().nonnegative().default(0),
+    completionTokens: zod_1.z.number().int().nonnegative().default(0),
+    totalTokens: zod_1.z.number().int().nonnegative().default(0),
+    /** Budget Status */
+    budgetLimit: zod_1.z.number().int().positive(),
+    budgetUsed: zod_1.z.number().int().nonnegative().default(0),
+    budgetRemaining: zod_1.z.number().int().nonnegative(),
+    budgetPercentage: zod_1.z.number().min(0).max(1).describe('Usage as percentage of budget'),
+    /** Message Stats */
+    messageCount: zod_1.z.number().int().nonnegative().default(0),
+    prunedMessageCount: zod_1.z.number().int().nonnegative().default(0),
+    summarizedMessageCount: zod_1.z.number().int().nonnegative().default(0),
+});
+/**
+ * Conversation Context
+ */
+exports.ConversationContextSchema = zod_1.z.object({
+    /** Identity */
+    sessionId: zod_1.z.string().describe('Conversation session ID'),
+    userId: zod_1.z.string().optional().describe('User identifier'),
+    agentId: zod_1.z.string().optional().describe('AI agent identifier'),
+    /** Context Data */
+    object: zod_1.z.string().optional().describe('Related object (e.g., "case", "project")'),
+    recordId: zod_1.z.string().optional().describe('Related record ID'),
+    scope: zod_1.z.record(zod_1.z.any()).optional().describe('Additional context scope'),
+    /** System Instructions */
+    systemMessage: zod_1.z.string().optional().describe('System prompt/instructions'),
+    /** Metadata */
+    metadata: zod_1.z.record(zod_1.z.any()).optional(),
+});
+/**
+ * Conversation Session
+ */
+exports.ConversationSessionSchema = zod_1.z.object({
+    /** Identity */
+    id: zod_1.z.string().describe('Unique session ID'),
+    name: zod_1.z.string().optional().describe('Session name/title'),
+    /** Configuration */
+    context: exports.ConversationContextSchema,
+    modelId: zod_1.z.string().optional().describe('AI model ID'),
+    tokenBudget: exports.TokenBudgetConfigSchema,
+    /** Messages */
+    messages: zod_1.z.array(exports.ConversationMessageSchema).default([]),
+    /** Token Tracking */
+    tokens: exports.TokenUsageStatsSchema.optional(),
+    /** Session Status */
+    status: zod_1.z.enum(['active', 'paused', 'completed', 'archived']).default('active'),
+    /** Timestamps */
+    createdAt: zod_1.z.string().describe('ISO 8601 timestamp'),
+    updatedAt: zod_1.z.string().describe('ISO 8601 timestamp'),
+    expiresAt: zod_1.z.string().optional().describe('ISO 8601 timestamp'),
+    /** Metadata */
+    tags: zod_1.z.array(zod_1.z.string()).optional(),
+    metadata: zod_1.z.record(zod_1.z.any()).optional(),
+});
+/**
+ * Conversation Summary
+ */
+exports.ConversationSummarySchema = zod_1.z.object({
+    /** Summary Content */
+    summary: zod_1.z.string().describe('Conversation summary'),
+    keyPoints: zod_1.z.array(zod_1.z.string()).optional().describe('Key discussion points'),
+    /** Token Savings */
+    originalTokens: zod_1.z.number().int().nonnegative().describe('Original token count'),
+    summaryTokens: zod_1.z.number().int().nonnegative().describe('Summary token count'),
+    tokensSaved: zod_1.z.number().int().nonnegative().describe('Tokens saved'),
+    /** Source Messages */
+    messageRange: zod_1.z.object({
+        startIndex: zod_1.z.number().int().nonnegative(),
+        endIndex: zod_1.z.number().int().nonnegative(),
+    }).describe('Range of messages summarized'),
+    /** Metadata */
+    generatedAt: zod_1.z.string().describe('ISO 8601 timestamp'),
+    modelId: zod_1.z.string().optional().describe('Model used for summarization'),
+});
+/**
+ * Message Pruning Event
+ */
+exports.MessagePruningEventSchema = zod_1.z.object({
+    /** Event Details */
+    timestamp: zod_1.z.string().describe('ISO 8601 timestamp'),
+    strategy: exports.TokenBudgetStrategySchema,
+    reason: zod_1.z.string().describe('Reason for pruning'),
+    /** Pruned Messages */
+    prunedMessages: zod_1.z.array(zod_1.z.object({
+        messageId: zod_1.z.string(),
+        role: exports.MessageRoleSchema,
+        tokens: zod_1.z.number().int().nonnegative(),
+        importance: zod_1.z.number().min(0).max(1).optional(),
+    })),
+    /** Impact */
+    tokensFreed: zod_1.z.number().int().nonnegative(),
+    messagesRemoved: zod_1.z.number().int().nonnegative(),
+    /** Post-Pruning State */
+    remainingTokens: zod_1.z.number().int().nonnegative(),
+    remainingMessages: zod_1.z.number().int().nonnegative(),
+});
+/**
+ * Conversation Analytics
+ */
+exports.ConversationAnalyticsSchema = zod_1.z.object({
+    /** Session Info */
+    sessionId: zod_1.z.string(),
+    /** Message Statistics */
+    totalMessages: zod_1.z.number().int().nonnegative(),
+    userMessages: zod_1.z.number().int().nonnegative(),
+    assistantMessages: zod_1.z.number().int().nonnegative(),
+    systemMessages: zod_1.z.number().int().nonnegative(),
+    /** Token Statistics */
+    totalTokens: zod_1.z.number().int().nonnegative(),
+    averageTokensPerMessage: zod_1.z.number().nonnegative(),
+    peakTokenUsage: zod_1.z.number().int().nonnegative(),
+    /** Efficiency Metrics */
+    pruningEvents: zod_1.z.number().int().nonnegative().default(0),
+    summarizationEvents: zod_1.z.number().int().nonnegative().default(0),
+    tokensSavedByPruning: zod_1.z.number().int().nonnegative().default(0),
+    tokensSavedBySummarization: zod_1.z.number().int().nonnegative().default(0),
+    /** Duration */
+    duration: zod_1.z.number().nonnegative().optional().describe('Session duration in seconds'),
+    firstMessageAt: zod_1.z.string().optional().describe('ISO 8601 timestamp'),
+    lastMessageAt: zod_1.z.string().optional().describe('ISO 8601 timestamp'),
+});