@objectstack/service-ai 4.0.4 → 4.0.5

package/src/conversation/objectql-conversation-service.ts

@@ -1,301 +0,0 @@
-// Copyright (c) 2025 ObjectStack. Licensed under the Apache-2.0 license.
-
-import { randomUUID } from 'node:crypto';
-import type {
-  AIConversation,
-  ModelMessage,
-  ToolCallPart,
-  ToolResultPart,
-  IAIConversationService,
-  IDataEngine,
-} from '@objectstack/spec/contracts';
-
-/** Object names used for persistence. */
-const CONVERSATIONS_OBJECT = 'ai_conversations';
-const MESSAGES_OBJECT = 'ai_messages';
-
-/** Database row shape for ai_conversations. */
-interface DbConversationRow {
-  id: string;
-  title: string | null;
-  agent_id: string | null;
-  user_id: string | null;
-  metadata: string | null;
-  created_at: string;
-  updated_at: string;
-}
-
-/** Database row shape for ai_messages. */
-interface DbMessageRow {
-  id: string;
-  conversation_id: string;
-  role: 'system' | 'user' | 'assistant' | 'tool';
-  content: string;
-  tool_calls: string | null;
-  tool_call_id: string | null;
-  created_at: string;
-}
-
-/** Deterministic ordering for conversations (total order). */
-const CONVERSATION_ORDER = [
-  { field: 'created_at', order: 'asc' as const },
-  { field: 'id', order: 'asc' as const },
-];
-
-/** Deterministic ordering for messages within a conversation. */
-const MESSAGE_ORDER = [
-  { field: 'created_at', order: 'asc' as const },
-  { field: 'id', order: 'asc' as const },
-];
-
-/**
- * ObjectQLConversationService — Persistent implementation of IAIConversationService.
- *
- * Delegates all storage to an {@link IDataEngine} instance, using the
- * `ai_conversations` and `ai_messages` objects. This decouples the service
- * from any specific database driver (Turso, Postgres, SQLite, etc.).
- *
- * Production environments should use this implementation to ensure
- * conversation history survives service restarts.
- */
-export class ObjectQLConversationService implements IAIConversationService {
-  private readonly engine: IDataEngine;
-
-  constructor(engine: IDataEngine) {
-    this.engine = engine;
-  }
-
-  async create(options: {
-    title?: string;
-    agentId?: string;
-    userId?: string;
-    metadata?: Record<string, unknown>;
-  } = {}): Promise<AIConversation> {
-    const now = new Date().toISOString();
-    const id = `conv_${randomUUID()}`;
-
-    const record = {
-      id,
-      title: options.title ?? null,
-      agent_id: options.agentId ?? null,
-      user_id: options.userId ?? null,
-      metadata: options.metadata ? JSON.stringify(options.metadata) : null,
-      created_at: now,
-      updated_at: now,
-    };
-
-    await this.engine.insert(CONVERSATIONS_OBJECT, record);
-
-    return {
-      id,
-      title: options.title,
-      agentId: options.agentId,
-      userId: options.userId,
-      messages: [],
-      createdAt: now,
-      updatedAt: now,
-      metadata: options.metadata,
-    };
-  }
-
-  async get(conversationId: string): Promise<AIConversation | null> {
-    const row: DbConversationRow | null = await this.engine.findOne(CONVERSATIONS_OBJECT, {
-      where: { id: conversationId },
-    });
-
-    if (!row) return null;
-
-    const messages: DbMessageRow[] = await this.engine.find(MESSAGES_OBJECT, {
-      where: { conversation_id: conversationId },
-      orderBy: MESSAGE_ORDER,
-    });
-
-    return this.toConversation(row, messages);
-  }
-
-  async list(options: {
-    userId?: string;
-    agentId?: string;
-    limit?: number;
-    cursor?: string;
-  } = {}): Promise<AIConversation[]> {
-    const where: Record<string, unknown> = {};
-    if (options.userId) where.user_id = options.userId;
-    if (options.agentId) where.agent_id = options.agentId;
-
-    // Stable cursor-based pagination using composite (created_at, id) order.
-    // This avoids skips/duplicates when multiple conversations share a timestamp.
-    if (options.cursor) {
-      const cursorRow = await this.engine.findOne(CONVERSATIONS_OBJECT, {
-        where: { id: options.cursor },
-        fields: ['created_at', 'id'],
-      });
-      if (cursorRow) {
-        where.$or = [
-          { created_at: { $gt: cursorRow.created_at } },
-          { created_at: cursorRow.created_at, id: { $gt: cursorRow.id } },
-        ];
-      }
-    }
-
-    const rows: DbConversationRow[] = await this.engine.find(CONVERSATIONS_OBJECT, {
-      where: Object.keys(where).length > 0 ? where : undefined,
-      orderBy: CONVERSATION_ORDER,
-      limit: options.limit && options.limit > 0 ? options.limit : undefined,
-    });
-
-    // Load messages per conversation in parallel.
-    // N+1 is bounded by the pagination limit; driver-agnostic $in is not guaranteed.
-    const conversations: AIConversation[] = await Promise.all(
-      rows.map(async (row) => {
-        const messages: DbMessageRow[] = await this.engine.find(MESSAGES_OBJECT, {
-          where: { conversation_id: row.id },
-          orderBy: MESSAGE_ORDER,
-        });
-        return this.toConversation(row, messages);
-      }),
-    );
-
-    return conversations;
-  }
-
-  async addMessage(conversationId: string, message: ModelMessage): Promise<AIConversation> {
-    // Verify conversation exists
-    const row: DbConversationRow | null = await this.engine.findOne(CONVERSATIONS_OBJECT, {
-      where: { id: conversationId },
-    });
-    if (!row) {
-      throw new Error(`Conversation "${conversationId}" not found`);
-    }
-
-    const now = new Date().toISOString();
-    const msgId = `msg_${randomUUID()}`;
-
-    // Extract flat fields from the discriminated union
-    let contentStr: string;
-    let toolCallsJson: string | null = null;
-    let toolCallId: string | null = null;
-
-    if (message.role === 'system' || message.role === 'user') {
-      contentStr = typeof message.content === 'string' ? message.content : JSON.stringify(message.content);
-    } else if (message.role === 'assistant') {
-      if (typeof message.content === 'string') {
-        contentStr = message.content;
-      } else {
-        const parts = message.content;
-        const textParts = parts.filter((p): p is { type: 'text'; text: string } => p.type === 'text').map(p => p.text);
-        const toolCalls = parts.filter(p => p.type === 'tool-call');
-        contentStr = textParts.join('');
-        if (toolCalls.length > 0) toolCallsJson = JSON.stringify(toolCalls);
-      }
-    } else if (message.role === 'tool') {
-      contentStr = JSON.stringify(message.content);
-      const firstResult = Array.isArray(message.content) ? message.content[0] : undefined;
-      if (firstResult && 'toolCallId' in firstResult) toolCallId = firstResult.toolCallId;
-    } else {
-      contentStr = '';
-    }
-
-    // Insert the message
-    await this.engine.insert(MESSAGES_OBJECT, {
-      id: msgId,
-      conversation_id: conversationId,
-      role: message.role,
-      content: contentStr,
-      tool_calls: toolCallsJson,
-      tool_call_id: toolCallId,
-      created_at: now,
-    });
-
-    // Update conversation timestamp
-    await this.engine.update(CONVERSATIONS_OBJECT, { id: conversationId, updated_at: now }, {
-      where: { id: conversationId },
-    });
-
-    // Return the full updated conversation
-    return (await this.get(conversationId))!;
-  }
-
-  async delete(conversationId: string): Promise<void> {
-    // Delete messages first (child records)
-    await this.engine.delete(MESSAGES_OBJECT, {
-      where: { conversation_id: conversationId },
-      multi: true,
-    });
-
-    // Delete the conversation
-    await this.engine.delete(CONVERSATIONS_OBJECT, {
-      where: { id: conversationId },
-    });
-  }
-
-  // ── Private helpers ──────────────────────────────────────────────
-
-  /**
-   * Safely parse a JSON string, returning `undefined` on failure.
-   */
-  private safeParse<T>(value: string | null, fallback?: T): T | undefined {
-    if (!value) return undefined;
-    try {
-      return JSON.parse(value) as T;
-    } catch {
-      return fallback;
-    }
-  }
-
-  /**
-   * Map a database row + message rows to an AIConversation.
-   */
-  private toConversation(row: DbConversationRow, messageRows: DbMessageRow[]): AIConversation {
-    return {
-      id: row.id,
-      title: row.title ?? undefined,
-      agentId: row.agent_id ?? undefined,
-      userId: row.user_id ?? undefined,
-      messages: messageRows.map(m => this.toMessage(m)),
-      createdAt: row.created_at,
-      updatedAt: row.updated_at,
-      metadata: this.safeParse<Record<string, unknown>>(row.metadata),
-    };
-  }
-
-  /**
-   * Map a database row to a ModelMessage.
-   */
-  private toMessage(row: DbMessageRow): ModelMessage {
-    switch (row.role) {
-      case 'system':
-        return { role: 'system', content: row.content };
-      case 'user':
-        return { role: 'user', content: row.content };
-      case 'assistant': {
-        const toolCalls = this.safeParse<ToolCallPart[]>(row.tool_calls);
-        if (toolCalls && toolCalls.length > 0) {
-          const content: Array<{ type: 'text'; text: string } | ToolCallPart> = [];
-          if (row.content) content.push({ type: 'text', text: row.content });
-          content.push(...toolCalls);
-          return { role: 'assistant', content };
-        }
-        return { role: 'assistant', content: row.content };
-      }
-      case 'tool': {
-        const toolResults = this.safeParse<ToolResultPart[]>(row.content);
-        if (toolResults && toolResults.length > 0 && toolResults[0]?.type === 'tool-result') {
-          return { role: 'tool', content: toolResults };
-        }
-        // Backward compat: old format was a plain string
-        return {
-          role: 'tool',
-          content: [{
-            type: 'tool-result' as const,
-            toolCallId: row.tool_call_id ?? '',
-            toolName: 'unknown',
-            output: { type: 'text' as const, value: row.content },
-          }],
-        };
-      }
-      default:
-        return { role: 'user', content: row.content };
-    }
-  }
-}

package/src/index.ts

@@ -1,60 +0,0 @@
-// Copyright (c) 2025 ObjectStack. Licensed under the Apache-2.0 license.
-
-// Core service
-export { AIService } from './ai-service.js';
-export type { AIServiceConfig } from './ai-service.js';
-
-// Kernel plugin
-export { AIServicePlugin } from './plugin.js';
-export type { AIServicePluginOptions } from './plugin.js';
-
-// Adapters
-export { MemoryLLMAdapter } from './adapters/memory-adapter.js';
-export { VercelLLMAdapter } from './adapters/vercel-adapter.js';
-export type { VercelLLMAdapterConfig } from './adapters/vercel-adapter.js';
-export type { LLMAdapter } from '@objectstack/spec/contracts';
-
-// Vercel Data Stream encoder
-export { encodeStreamPart, encodeVercelDataStream } from './stream/vercel-stream-encoder.js';
-
-// Conversation
-export { InMemoryConversationService } from './conversation/in-memory-conversation-service.js';
-export { ObjectQLConversationService } from './conversation/objectql-conversation-service.js';
-
-// Tool registry
-export { ToolRegistry } from './tools/tool-registry.js';
-export type { ToolHandler, ToolExecutionResult } from './tools/tool-registry.js';
-
-// Data tools
-export { registerDataTools, DATA_TOOL_DEFINITIONS } from './tools/data-tools.js';
-export type { DataToolContext } from './tools/data-tools.js';
-
-// Metadata tools
-export { registerMetadataTools, METADATA_TOOL_DEFINITIONS } from './tools/metadata-tools.js';
-export type { MetadataToolContext } from './tools/metadata-tools.js';
-
-// Individual tool metadata (first-class Tool definitions via defineTool)
-export {
-  createObjectTool,
-  addFieldTool,
-  modifyFieldTool,
-  deleteFieldTool,
-  listObjectsTool,
-  describeObjectTool,
-} from './tools/metadata-tools.js';
-
-// Agent runtime
-export { AgentRuntime } from './agent-runtime.js';
-export type { AgentChatContext } from './agent-runtime.js';
-
-// Built-in agents
-export { DATA_CHAT_AGENT, METADATA_ASSISTANT_AGENT } from './agents/index.js';
-
-// Object definitions
-export { AiConversationObject, AiMessageObject } from './objects/index.js';
-
-// Routes
-export { buildAIRoutes } from './routes/ai-routes.js';
-export { buildAgentRoutes } from './routes/agent-routes.js';
-export { buildToolRoutes } from './routes/tool-routes.js';
-export type { RouteDefinition, RouteRequest, RouteResponse, RouteUserContext } from './routes/ai-routes.js';

package/src/objects/ai-conversation.object.ts

@@ -1,86 +0,0 @@
-// Copyright (c) 2025 ObjectStack. Licensed under the Apache-2.0 license.
-
-import { ObjectSchema, Field } from '@objectstack/spec/data';
-
-/**
- * ai_conversations — AI Conversation Object
- *
- * Stores conversation metadata for persistent AI conversation management.
- * Messages are stored separately in `ai_messages` to support efficient
- * querying and pagination.
- *
- * @namespace ai
- */
-export const AiConversationObject = ObjectSchema.create({
-  namespace: 'ai',
-  name: 'conversations',
-  label: 'AI Conversation',
-  pluralLabel: 'AI Conversations',
-  icon: 'message-square',
-  isSystem: true,
-  description: 'Persistent AI conversation metadata',
-
-  fields: {
-    id: Field.text({
-      label: 'Conversation ID',
-      required: true,
-      readonly: true,
-    }),
-
-    title: Field.text({
-      label: 'Title',
-      required: false,
-      maxLength: 500,
-      description: 'Conversation title or summary',
-    }),
-
-    agent_id: Field.text({
-      label: 'Agent ID',
-      required: false,
-      maxLength: 255,
-      description: 'Associated AI agent identifier',
-    }),
-
-    user_id: Field.text({
-      label: 'User ID',
-      required: false,
-      maxLength: 255,
-      description: 'User who owns the conversation',
-    }),
-
-    metadata: Field.textarea({
-      label: 'Metadata',
-      required: false,
-      description: 'JSON-serialized conversation metadata',
-    }),
-
-    created_at: Field.datetime({
-      label: 'Created At',
-      required: true,
-      defaultValue: 'NOW()',
-      readonly: true,
-    }),
-
-    updated_at: Field.datetime({
-      label: 'Updated At',
-      required: true,
-      defaultValue: 'NOW()',
-      readonly: true,
-    }),
-  },
-
-  indexes: [
-    { fields: ['user_id'] },
-    { fields: ['agent_id'] },
-    { fields: ['created_at'] },
-  ],
-
-  enable: {
-    trackHistory: false,
-    searchable: false,
-    apiEnabled: true,
-    apiMethods: ['get', 'list', 'create', 'update', 'delete'],
-    trash: false,
-    mru: false,
-  },
-});

package/src/objects/ai-message.object.ts

@@ -1,86 +0,0 @@
-// Copyright (c) 2025 ObjectStack. Licensed under the Apache-2.0 license.
-
-import { ObjectSchema, Field } from '@objectstack/spec/data';
-
-/**
- * ai_messages — AI Message Object
- *
- * Stores individual messages within an AI conversation.
- * Each message belongs to a conversation via `conversation_id` foreign key.
- *
- * @namespace ai
- */
-export const AiMessageObject = ObjectSchema.create({
-  namespace: 'ai',
-  name: 'messages',
-  label: 'AI Message',
-  pluralLabel: 'AI Messages',
-  icon: 'message-circle',
-  isSystem: true,
-  description: 'Individual messages within AI conversations',
-
-  fields: {
-    id: Field.text({
-      label: 'Message ID',
-      required: true,
-      readonly: true,
-    }),
-
-    conversation_id: Field.text({
-      label: 'Conversation ID',
-      required: true,
-      description: 'Foreign key to ai_conversations',
-    }),
-
-    role: Field.select({
-      label: 'Role',
-      required: true,
-      options: [
-        { label: 'System', value: 'system' },
-        { label: 'User', value: 'user' },
-        { label: 'Assistant', value: 'assistant' },
-        { label: 'Tool', value: 'tool' },
-      ],
-    }),
-
-    content: Field.textarea({
-      label: 'Content',
-      required: true,
-      description: 'Message content',
-    }),
-
-    tool_calls: Field.textarea({
-      label: 'Tool Calls',
-      required: false,
-      description: 'JSON-serialized tool calls (when role=assistant)',
-    }),
-
-    tool_call_id: Field.text({
-      label: 'Tool Call ID',
-      required: false,
-      maxLength: 255,
-      description: 'ID of the tool call this message responds to (when role=tool)',
-    }),
-
-    created_at: Field.datetime({
-      label: 'Created At',
-      required: true,
-      defaultValue: 'NOW()',
-      readonly: true,
-    }),
-  },
-
-  indexes: [
-    { fields: ['conversation_id'] },
-    { fields: ['conversation_id', 'created_at'] },
-  ],
-
-  enable: {
-    trackHistory: false,
-    searchable: false,
-    apiEnabled: true,
-    apiMethods: ['get', 'list', 'create'],
-    trash: false,
-    mru: false,
-  },
-});

package/src/objects/index.ts

@@ -1,10 +0,0 @@
-// Copyright (c) 2025 ObjectStack. Licensed under the Apache-2.0 license.
-
-/**
- * AI Service — System Object Definitions (ai namespace)
- *
- * Canonical ObjectSchema definitions for AI conversation persistence.
- */
-
-export { AiConversationObject } from './ai-conversation.object.js';
-export { AiMessageObject } from './ai-message.object.js';