@xopcai/xopcbot 0.1.3 → 0.2.0

package/dist/agent/tools/__tests__/send-media.test.js

@@ -0,0 +1,251 @@
+/**
+ * Send Media Tool Tests
+ *
+ * Tests for send_media tool functionality.
+ */
+import { describe, it, expect, vi, beforeEach, afterEach } from 'vitest';
+import { readFile } from 'fs/promises';
+// Mock fs/promises
+vi.mock('fs/promises', () => ({
+    readFile: vi.fn(),
+}));
+describe('SendMediaTool', () => {
+    const mockReadFile = readFile;
+    beforeEach(() => {
+        mockReadFile.mockClear();
+    });
+    afterEach(() => {
+        vi.restoreAllMocks();
+    });
+    describe('SendMediaSchema', () => {
+        it('should validate required parameters', () => {
+            const params = {
+                filePath: '/path/to/image.jpg',
+            };
+            expect(params.filePath).toBeDefined();
+            expect(params.filePath).toBe('/path/to/image.jpg');
+        });
+        it('should accept optional parameters', () => {
+            const params = {
+                filePath: '/path/to/video.mp4',
+                mediaType: 'video',
+                caption: 'Check out this video!',
+            };
+            expect(params.filePath).toBe('/path/to/video.mp4');
+            expect(params.mediaType).toBe('video');
+            expect(params.caption).toBe('Check out this video!');
+        });
+        it('should handle media type enum values', () => {
+            const validTypes = ['photo', 'video', 'audio', 'document'];
+            validTypes.forEach(type => {
+                const params = { filePath: '/test/file', mediaType: type };
+                expect(params.mediaType).toBe(type);
+            });
+        });
+    });
+    describe('Media Type Detection', () => {
+        const detectMediaType = (filePath) => {
+            const ext = filePath.split('.').pop()?.toLowerCase();
+            const imageExts = ['jpg', 'jpeg', 'png', 'gif', 'webp', 'bmp', 'svg'];
+            const videoExts = ['mp4', 'mov', 'avi', 'webm', 'mkv'];
+            const audioExts = ['mp3', 'wav', 'ogg', 'm4a', 'flac'];
+            if (imageExts.includes(ext || ''))
+                return 'photo';
+            if (videoExts.includes(ext || ''))
+                return 'video';
+            if (audioExts.includes(ext || ''))
+                return 'audio';
+            return 'document';
+        };
+        it('should auto-detect image files', () => {
+            expect(detectMediaType('/path/to/photo.jpg')).toBe('photo');
+            expect(detectMediaType('/path/to/photo.png')).toBe('photo');
+            expect(detectMediaType('/path/to/image.gif')).toBe('photo');
+        });
+        it('should auto-detect video files', () => {
+            expect(detectMediaType('/path/to/video.mp4')).toBe('video');
+            expect(detectMediaType('/path/to/clip.mov')).toBe('video');
+        });
+        it('should auto-detect audio files', () => {
+            expect(detectMediaType('/path/to/audio.mp3')).toBe('audio');
+            expect(detectMediaType('/path/to/sound.wav')).toBe('audio');
+        });
+        it('should default to document for unknown types', () => {
+            expect(detectMediaType('/path/to/file.pdf')).toBe('document');
+            expect(detectMediaType('/path/to/file.txt')).toBe('document');
+            expect(detectMediaType('/path/to/file')).toBe('document');
+        });
+    });
+    describe('MIME Type Detection', () => {
+        const detectMimeType = (filePath) => {
+            const ext = filePath.split('.').pop()?.toLowerCase();
+            const mimeMap = {
+                jpg: 'image/jpeg',
+                jpeg: 'image/jpeg',
+                png: 'image/png',
+                gif: 'image/gif',
+                webp: 'image/webp',
+                bmp: 'image/bmp',
+                svg: 'image/svg+xml',
+                mp4: 'video/mp4',
+                mov: 'video/quicktime',
+                avi: 'video/x-msvideo',
+                webm: 'video/webm',
+                mp3: 'audio/mpeg',
+                wav: 'audio/wav',
+                ogg: 'audio/ogg',
+                m4a: 'audio/mp4',
+                flac: 'audio/flac',
+                pdf: 'application/pdf',
+                doc: 'application/msword',
+                docx: 'application/vnd.openxmlformats-officedocument.wordprocessingml.document',
+                txt: 'text/plain',
+                zip: 'application/zip',
+            };
+            return mimeMap[ext || ''] || 'application/octet-stream';
+        };
+        it('should detect image MIME types', () => {
+            expect(detectMimeType('image.jpg')).toBe('image/jpeg');
+            expect(detectMimeType('image.png')).toBe('image/png');
+            expect(detectMimeType('image.gif')).toBe('image/gif');
+            expect(detectMimeType('image.webp')).toBe('image/webp');
+        });
+        it('should detect video MIME types', () => {
+            expect(detectMimeType('video.mp4')).toBe('video/mp4');
+            expect(detectMimeType('video.mov')).toBe('video/quicktime');
+        });
+        it('should detect audio MIME types', () => {
+            expect(detectMimeType('audio.mp3')).toBe('audio/mpeg');
+            expect(detectMimeType('audio.wav')).toBe('audio/wav');
+        });
+        it('should detect document MIME types', () => {
+            expect(detectMimeType('doc.pdf')).toBe('application/pdf');
+            expect(detectMimeType('doc.docx')).toBe('application/vnd.openxmlformats-officedocument.wordprocessingml.document');
+        });
+    });
+    describe('File Reading and Conversion', () => {
+        it('should read file and convert to base64', async () => {
+            const mockBuffer = Buffer.from('Hello World');
+            mockReadFile.mockResolvedValue(mockBuffer);
+            const filePath = '/test/image.jpg';
+            const fileBuffer = await readFile(filePath);
+            const base64 = fileBuffer.toString('base64');
+            expect(mockReadFile).toHaveBeenCalledWith(filePath);
+            expect(base64).toBe('SGVsbG8gV29ybGQ=');
+        });
+        it('should handle file read errors', async () => {
+            mockReadFile.mockRejectedValue(new Error('ENOENT: file not found'));
+            try {
+                await readFile('/nonexistent/file.jpg');
+                expect.fail('Should have thrown error');
+            }
+            catch (error) {
+                expect(error).toBeInstanceOf(Error);
+                expect(error.message).toContain('ENOENT');
+            }
+        });
+        it('should create data URL from file', async () => {
+            const mockBuffer = Buffer.from([0xFF, 0xD8, 0xFF, 0xE0]); // JPEG magic bytes
+            mockReadFile.mockResolvedValue(mockBuffer);
+            const filePath = '/test/image.jpg';
+            const fileBuffer = await readFile(filePath);
+            const base64 = fileBuffer.toString('base64');
+            const mimeType = 'image/jpeg';
+            const dataUrl = `data:${mimeType};base64,${base64}`;
+            expect(dataUrl).toBe('data:image/jpeg;base64,/9j/4A==');
+        });
+    });
+    describe('OutboundMessage Construction', () => {
+        it('should create OutboundMessage with media', () => {
+            const dataUrl = 'data:image/jpeg;base64,/9j/4AA=';
+            const caption = 'Test caption';
+            const msg = {
+                channel: 'telegram',
+                chat_id: '123456',
+                content: caption,
+                mediaUrl: dataUrl,
+                mediaType: 'photo',
+            };
+            expect(msg.mediaUrl).toBe(dataUrl);
+            expect(msg.mediaType).toBe('photo');
+            expect(msg.content).toBe(caption);
+        });
+        it('should handle message without caption', () => {
+            const msg = {
+                channel: 'telegram',
+                chat_id: '123456',
+                content: '',
+                mediaUrl: 'data:image/png;base64,abc123',
+                mediaType: 'photo',
+            };
+            expect(msg.content).toBe('');
+            expect(msg.mediaUrl).toBeDefined();
+        });
+    });
+    describe('Tool Execution Result', () => {
+        it('should return success result', async () => {
+            const mockBuffer = Buffer.from('test data');
+            mockReadFile.mockResolvedValue(mockBuffer);
+            const filePath = '/test/success.jpg';
+            const fileName = filePath.split('/').pop() || filePath;
+            await readFile(filePath);
+            const result = {
+                content: [{ type: 'text', text: `✅ Media sent: ${fileName} (photo)` }],
+                details: { filePath, mediaType: 'photo' },
+            };
+            expect(result.content[0].text).toContain('✅ Media sent');
+            expect(result.content[0].text).toContain('success.jpg');
+            expect(result.content[0].text).toContain('photo');
+        });
+        it('should return error result on failure', () => {
+            const errorMessage = 'Error sending media: ENOENT: no such file';
+            const result = {
+                content: [{ type: 'text', text: errorMessage }],
+                details: { error: errorMessage },
+            };
+            expect(result.content[0].text).toContain('Error sending media');
+        });
+    });
+    describe('Context Validation', () => {
+        it('should error when no active context', () => {
+            const ctx = null;
+            if (!ctx) {
+                const result = {
+                    content: [{ type: 'text', text: 'Error: No active conversation context' }],
+                    details: {},
+                };
+                expect(result.content[0].text).toContain('No active conversation context');
+            }
+        });
+        it('should proceed when context is available', () => {
+            const ctx = {
+                channel: 'telegram',
+                chatId: '123456',
+            };
+            expect(ctx).not.toBeNull();
+            expect(ctx.channel).toBe('telegram');
+            expect(ctx.chatId).toBe('123456');
+        });
+    });
+    describe('File Name Extraction', () => {
+        it('should extract file name from path', () => {
+            const testCases = [
+                { path: '/path/to/file.jpg', expected: 'file.jpg' },
+                { path: '/home/user/documents/report.pdf', expected: 'report.pdf' },
+                { path: 'relative/path/image.png', expected: 'image.png' },
+                { path: 'simple.txt', expected: 'simple.txt' },
+            ];
+            testCases.forEach(({ path, expected }) => {
+                const fileName = path.split('/').pop() || path;
+                expect(fileName).toBe(expected);
+            });
+        });
+        it('should handle edge cases', () => {
+            const path1 = '/'; // root
+            const path2 = ''; // empty
+            expect(path1.split('/').pop()).toBe('');
+            expect(path2.split('/').pop()).toBe('');
+        });
+    });
+});
+//# sourceMappingURL=send-media.test.js.map

package/dist/agent/tools/__tests__/send-media.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"send-media.test.js","sourceRoot":"","sources":["../../../../src/agent/tools/__tests__/send-media.test.ts"],"names":[],"mappings":"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"}

package/dist/agent/types.agent-defaults.d.ts

@@ -0,0 +1,48 @@
+/**
+ * Agent Defaults Types
+ */
+export type ModelRef = string;
+export interface ModelEntry {
+    alias?: string;
+    params?: Record<string, unknown>;
+}
+export type ModelList = Record<string, ModelEntry | undefined>;
+export type ContextPruningMode = 'off' | 'eager' | 'lazy' | 'cache-ttl';
+export interface ContextPruningConfig {
+    mode?: ContextPruningMode;
+    ttl?: string;
+    eagerMaxTokens?: number;
+    eagerThreshold?: number;
+    eagerKeepAtLeast?: number;
+    eagerKeepAtMost?: number;
+}
+export interface HeartbeatConfig {
+    every?: string;
+    enabled?: boolean;
+    target?: string;
+    on?: string[];
+}
+export type CompactionMode = 'off' | 'eager' | 'lazy' | 'safeguard';
+export interface CompactionConfig {
+    mode?: CompactionMode;
+    eagerThreshold?: number;
+    eagerKeepAtLeast?: number;
+    eagerKeepAtMost?: number;
+}
+export interface AgentConcurrencyConfig {
+    maxConcurrent?: number;
+}
+export interface AgentDefaults {
+    model?: ModelRef | {
+        primary?: ModelRef;
+        fallbacks?: ModelRef[];
+    };
+    models?: ModelList;
+    maxConcurrent?: number;
+    subagents?: AgentConcurrencyConfig;
+    contextPruning?: ContextPruningConfig;
+    heartbeat?: HeartbeatConfig;
+    compaction?: CompactionConfig;
+    temperature?: number;
+    maxTokens?: number;
+}

package/dist/agent/types.agent-defaults.js

@@ -0,0 +1,5 @@
+/**
+ * Agent Defaults Types
+ */
+export {};
+//# sourceMappingURL=types.agent-defaults.js.map

package/dist/agent/types.agent-defaults.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.agent-defaults.js","sourceRoot":"","sources":["../../src/agent/types.agent-defaults.ts"],"names":[],"mappings":"AAAA;;GAEG"}

package/dist/agent/types.d.ts

@@ -1,8 +1,16 @@
-import type { AgentMessage as BaseAgentMessage } from '@mariozechner/pi-agent-core';
-export type { BaseAgentMessage };
+/**
+ * Agent Types
+ *
+ * Core type definitions for agent configuration
+ */
+import type { AgentDefaults } from './types.agent-defaults.js';
 export interface AgentConfig {
-    workspace: string;
-    model?: string;
-    systemPrompt?: string;
+    defaults?: AgentDefaults;
+    list?: Record<string, AgentDefaults>;
+}
+export interface AgentRuntimeState {
+    sessionKey: string;
+    currentModel?: string;
+    messageCount: number;
+    lastActivity: number;
 }
-export type { AgentMessage } from '@mariozechner/pi-agent-core';

package/dist/agent/types.js

@@ -1,2 +1,7 @@
+/**
+ * Agent Types
+ *
+ * Core type definitions for agent configuration
+ */
 export {};
 //# sourceMappingURL=types.js.map

package/dist/agent/types.js.map

@@ -1 +1 @@
-{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/agent/types.ts"],"names":[],"mappings":""}
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/agent/types.ts"],"names":[],"mappings":"AAAA;;;;GAIG"}

package/dist/agent/workspace.d.ts

@@ -0,0 +1,94 @@
+/**
+ * Workspace Management - Core bootstrap file handling
+ *
+ * Workspace architecture for xopcbot:
+ * - Default filenames constants
+ * - File caching with mtime invalidation
+ * - Template loading and seeding
+ * - Bootstrap file loading with filtering
+ */
+export declare const DEFAULT_AGENTS_FILENAME = "AGENTS.md";
+export declare const DEFAULT_SOUL_FILENAME = "SOUL.md";
+export declare const DEFAULT_TOOLS_FILENAME = "TOOLS.md";
+export declare const DEFAULT_IDENTITY_FILENAME = "IDENTITY.md";
+export declare const DEFAULT_USER_FILENAME = "USER.md";
+export declare const DEFAULT_HEARTBEAT_FILENAME = "HEARTBEAT.md";
+export declare const DEFAULT_BOOTSTRAP_FILENAME = "BOOTSTRAP.md";
+export declare const DEFAULT_MEMORY_FILENAME = "MEMORY.md";
+export declare const DEFAULT_MEMORY_ALT_FILENAME = "memory.md";
+export declare const DEFAULT_WORKSPACE_STATE_DIR = ".xopcbot";
+export declare const DEFAULT_WORKSPACE_STATE_FILE = "workspace-state.json";
+export type WorkspaceBootstrapFileName = typeof DEFAULT_AGENTS_FILENAME | typeof DEFAULT_SOUL_FILENAME | typeof DEFAULT_TOOLS_FILENAME | typeof DEFAULT_IDENTITY_FILENAME | typeof DEFAULT_USER_FILENAME | typeof DEFAULT_HEARTBEAT_FILENAME | typeof DEFAULT_BOOTSTRAP_FILENAME | typeof DEFAULT_MEMORY_FILENAME | typeof DEFAULT_MEMORY_ALT_FILENAME;
+export interface WorkspaceBootstrapFile {
+    name: WorkspaceBootstrapFileName;
+    path: string;
+    content?: string;
+    missing: boolean;
+}
+export interface WorkspaceBootstrapOptions {
+    ensureBootstrapFiles?: boolean;
+    templateDir?: string;
+}
+export interface WorkspaceOnboardingState {
+    version: number;
+    bootstrapSeededAt?: string;
+    onboardingCompletedAt?: string;
+}
+export declare function isValidBootstrapFileName(name: string): boolean;
+/**
+ * Read file with caching based on mtime. Returns cached content if file
+ * hasn't changed, otherwise reads from disk and updates cache.
+ *
+ * Performance optimization approach.
+ */
+export declare function readFileWithCache(filePath: string): Promise<string>;
+/**
+ * Invalidate cache for a specific file
+ */
+export declare function invalidateCache(filePath: string): void;
+/**
+ * Clear entire workspace file cache
+ */
+export declare function clearWorkspaceCache(): void;
+/**
+ * Check if file exists
+ */
+export declare function fileExists(filePath: string): Promise<boolean>;
+/**
+ * Strip YAML front matter from markdown content.
+ * Removes the --- header if present.
+ */
+export declare function stripFrontMatter(content: string): string;
+/**
+ * Load workspace template from bundled templates
+ */
+export declare function loadTemplate(name: string): Promise<string>;
+export declare function isWorkspaceOnboardingCompleted(dir: string): Promise<boolean>;
+/**
+ * Ensure workspace directory exists
+ */
+export declare function ensureWorkspaceDir(dir: string): Promise<string>;
+/**
+ * Ensure workspace has bootstrap files, seeding from templates if needed
+ */
+export declare function ensureBootstrapFiles(dir: string, options?: WorkspaceBootstrapOptions): Promise<{
+    dir: string;
+    agentsPath?: string;
+    soulPath?: string;
+    toolsPath?: string;
+    identityPath?: string;
+    userPath?: string;
+    heartbeatPath?: string;
+    bootstrapPath?: string;
+    memoryPath?: string;
+}>;
+/**
+ * Load all workspace bootstrap files
+ */
+export declare function loadWorkspaceBootstrapFiles(dir: string): Promise<WorkspaceBootstrapFile[]>;
+/**
+ * Filter bootstrap files for session type (subagent/cron vs main)
+ *
+ * Subagents and cron jobs only get minimal files for security
+ */
+export declare function filterBootstrapFilesForSession(files: WorkspaceBootstrapFile[], isSubagentOrCron: boolean): WorkspaceBootstrapFile[];