@vybestack/llxprt-code-core 0.1.23-nightly.250829.6bacfcba → 0.1.23-nightly.250903.97906524

package/dist/src/services/history/IContent.d.ts

@@ -0,0 +1,179 @@
+/**
+ * Copyright 2025 Vybestack LLC
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *   http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+/**
+ * Universal content representation that is provider-agnostic.
+ * All conversation content is represented as blocks within a speaker's turn.
+ */
+export interface IContent {
+    /**
+     * Who is speaking in this content
+     * - 'human': The user
+     * - 'ai': The AI assistant
+     * - 'tool': A tool/function response
+     */
+    speaker: 'human' | 'ai' | 'tool';
+    /**
+     * Array of content blocks that make up this message.
+     * A message can contain multiple blocks of different types.
+     */
+    blocks: ContentBlock[];
+    /**
+     * Optional metadata for the content
+     */
+    metadata?: ContentMetadata;
+}
+/**
+ * Metadata associated with content
+ */
+export interface ContentMetadata {
+    /** When this content was created */
+    timestamp?: number;
+    /** Which model generated this (for AI responses) */
+    model?: string;
+    /** Token usage statistics */
+    usage?: UsageStats;
+    /** Unique identifier for this content */
+    id?: string;
+    /** Provider that generated this content */
+    provider?: string;
+    /** Whether this is a summary of previous messages */
+    isSummary?: boolean;
+    /** Additional provider-specific metadata */
+    providerMetadata?: Record<string, unknown>;
+}
+/**
+ * Token usage statistics
+ */
+export interface UsageStats {
+    promptTokens: number;
+    completionTokens: number;
+    totalTokens: number;
+}
+/**
+ * Union type of all possible content blocks
+ */
+export type ContentBlock = TextBlock | ToolCallBlock | ToolResponseBlock | MediaBlock | ThinkingBlock | CodeBlock;
+/**
+ * Regular text content
+ */
+export interface TextBlock {
+    type: 'text';
+    text: string;
+}
+/**
+ * AI calling a tool/function
+ */
+export interface ToolCallBlock {
+    type: 'tool_call';
+    /** Unique identifier for this tool call */
+    id: string;
+    /** Name of the tool being called */
+    name: string;
+    /** Parameters passed to the tool (must be JSON-serializable) */
+    parameters: unknown;
+    /** Optional description of what this tool call is intended to do */
+    description?: string;
+}
+/**
+ * Response from a tool/function call
+ */
+export interface ToolResponseBlock {
+    type: 'tool_response';
+    /** References the ToolCallBlock.id this is responding to */
+    callId: string;
+    /** The tool that generated this response */
+    toolName: string;
+    /** Result from the tool (must be JSON-serializable) */
+    result: unknown;
+    /** Error message if the tool call failed */
+    error?: string;
+    /** Whether this response completes the tool call */
+    isComplete?: boolean;
+}
+/**
+ * Media content (images, files, etc.)
+ */
+export interface MediaBlock {
+    type: 'media';
+    /** MIME type of the media */
+    mimeType: string;
+    /** Either a URL or base64-encoded data */
+    data: string;
+    /** Whether data is a URL or base64 */
+    encoding: 'url' | 'base64';
+    /** Optional caption or alt text */
+    caption?: string;
+    /** Original filename if applicable */
+    filename?: string;
+}
+/**
+ * Thinking/reasoning content (for models that support it)
+ */
+export interface ThinkingBlock {
+    type: 'thinking';
+    /** The thinking/reasoning text */
+    thought: string;
+    /** Whether this thinking should be hidden from the user */
+    isHidden?: boolean;
+}
+/**
+ * Code content with syntax highlighting support
+ */
+export interface CodeBlock {
+    type: 'code';
+    /** The code content */
+    code: string;
+    /** Programming language for syntax highlighting */
+    language?: string;
+    /** Optional filename this code is from/for */
+    filename?: string;
+    /** Whether this code was executed */
+    executed?: boolean;
+    /** Execution result if executed */
+    executionResult?: unknown;
+}
+/**
+ * Helper type guards for content blocks
+ */
+export declare const ContentBlockGuards: {
+    isTextBlock: (block: ContentBlock) => block is TextBlock;
+    isToolCallBlock: (block: ContentBlock) => block is ToolCallBlock;
+    isToolResponseBlock: (block: ContentBlock) => block is ToolResponseBlock;
+    isMediaBlock: (block: ContentBlock) => block is MediaBlock;
+    isThinkingBlock: (block: ContentBlock) => block is ThinkingBlock;
+    isCodeBlock: (block: ContentBlock) => block is CodeBlock;
+};
+/**
+ * Helper to create IContent instances
+ */
+export declare const ContentFactory: {
+    createUserMessage: (text: string, metadata?: ContentMetadata) => IContent;
+    createAIMessage: (blocks: ContentBlock[], metadata?: ContentMetadata) => IContent;
+    createToolResponse: (callId: string, toolName: string, result: unknown, error?: string, metadata?: ContentMetadata) => IContent;
+};
+/**
+ * Validation helpers
+ */
+export declare const ContentValidation: {
+    /**
+     * Check if content has meaningful content (not empty)
+     */
+    hasContent: (content: IContent) => boolean;
+    /**
+     * Check if content is valid for inclusion in history
+     */
+    isValid: (content: IContent) => boolean;
+};

package/dist/src/services/history/IContent.js

@@ -0,0 +1,104 @@
+/**
+ * Copyright 2025 Vybestack LLC
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *   http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+/**
+ * Helper type guards for content blocks
+ */
+export const ContentBlockGuards = {
+    isTextBlock: (block) => block.type === 'text',
+    isToolCallBlock: (block) => block.type === 'tool_call',
+    isToolResponseBlock: (block) => block.type === 'tool_response',
+    isMediaBlock: (block) => block.type === 'media',
+    isThinkingBlock: (block) => block.type === 'thinking',
+    isCodeBlock: (block) => block.type === 'code',
+};
+/**
+ * Helper to create IContent instances
+ */
+export const ContentFactory = {
+    createUserMessage: (text, metadata) => ({
+        speaker: 'human',
+        blocks: [{ type: 'text', text }],
+        metadata,
+    }),
+    createAIMessage: (blocks, metadata) => ({
+        speaker: 'ai',
+        blocks,
+        metadata,
+    }),
+    createToolResponse: (callId, toolName, result, error, metadata) => ({
+        speaker: 'tool',
+        blocks: [
+            {
+                type: 'tool_response',
+                callId,
+                toolName,
+                result,
+                error,
+            },
+        ],
+        metadata,
+    }),
+};
+/**
+ * Validation helpers
+ */
+export const ContentValidation = {
+    /**
+     * Check if content has meaningful content (not empty)
+     */
+    hasContent: (content) => {
+        if (!content.blocks || content.blocks.length === 0) {
+            return false;
+        }
+        return content.blocks.some((block) => {
+            switch (block.type) {
+                case 'text':
+                    return block.text.trim().length > 0;
+                case 'tool_call':
+                case 'tool_response':
+                case 'media':
+                case 'code':
+                    return true;
+                case 'thinking':
+                    return block.thought.trim().length > 0;
+                default:
+                    return false;
+            }
+        });
+    },
+    /**
+     * Check if content is valid for inclusion in history
+     */
+    isValid: (content) => {
+        // Must have a valid speaker
+        if (!['human', 'ai', 'tool'].includes(content.speaker)) {
+            return false;
+        }
+        // Must have at least one block
+        if (!content.blocks || content.blocks.length === 0) {
+            return false;
+        }
+        // Tool responses must have tool_response blocks
+        if (content.speaker === 'tool') {
+            const hasToolResponse = content.blocks.some((b) => b.type === 'tool_response');
+            if (!hasToolResponse) {
+                return false;
+            }
+        }
+        return true;
+    },
+};
+//# sourceMappingURL=IContent.js.map

package/dist/src/services/history/IContent.js.map

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@vybestack/llxprt-code-core",
-  "version": "0.1.23-nightly.250829.6bacfcba",
+  "version": "0.1.23-nightly.250903.97906524",
   "description": "LLxprt Code Core",
   "repository": {
     "type": "git",