@phuetz/code-buddy 0.1.18 → 0.1.19

package/dist/memory/memory-flush.js.map

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

package/dist/memory/subagent-memory.d.ts

@@ -0,0 +1,73 @@
+/**
+ * Subagent Persistent Memory
+ *
+ * Scoped memory system for subagents with user/project/local scopes,
+ * topic files, and context injection support.
+ */
+export type MemoryScope = 'user' | 'project' | 'local';
+export interface SubagentMemoryConfig {
+    agentName: string;
+    scope: MemoryScope;
+    maxLines: number;
+    memoryDir?: string;
+}
+export declare class SubagentMemory {
+    private config;
+    private memoryPath;
+    constructor(config: SubagentMemoryConfig);
+    /**
+     * Get memory directory path based on scope
+     */
+    static getMemoryDir(agentName: string, scope: MemoryScope): string;
+    /**
+     * Ensure the memory directory exists
+     */
+    private ensureDir;
+    /**
+     * Get the MEMORY.md file path
+     */
+    private getMemoryFilePath;
+    /**
+     * Read MEMORY.md (first maxLines lines)
+     */
+    readMemory(): string;
+    /**
+     * Write to MEMORY.md (replace all content)
+     */
+    writeMemory(content: string): void;
+    /**
+     * Append to MEMORY.md
+     */
+    appendMemory(entry: string): void;
+    /**
+     * Read a specific topic file
+     */
+    readTopic(topicName: string): string | null;
+    /**
+     * Write a topic file
+     */
+    writeTopic(topicName: string, content: string): void;
+    /**
+     * List all memory files
+     */
+    listMemoryFiles(): string[];
+    /**
+     * Check if memory exists (MEMORY.md file)
+     */
+    hasMemory(): boolean;
+    /**
+     * Get memory size in bytes
+     */
+    getMemorySize(): number;
+    /**
+     * Clear all memory
+     */
+    clearMemory(): void;
+    /**
+     * Generate context injection (first maxLines lines of MEMORY.md)
+     */
+    getContextInjection(): string;
+    getAgentName(): string;
+    getScope(): MemoryScope;
+    getMemoryPath(): string;
+}

package/dist/memory/subagent-memory.js

@@ -0,0 +1,172 @@
+/**
+ * Subagent Persistent Memory
+ *
+ * Scoped memory system for subagents with user/project/local scopes,
+ * topic files, and context injection support.
+ */
+import * as fs from 'fs';
+import * as path from 'path';
+import * as os from 'os';
+import { logger } from '../utils/logger.js';
+// ============================================================================
+// Defaults
+// ============================================================================
+const DEFAULT_MAX_LINES = 200;
+// ============================================================================
+// Subagent Memory
+// ============================================================================
+export class SubagentMemory {
+    config;
+    memoryPath;
+    constructor(config) {
+        this.config = {
+            ...config,
+            maxLines: config.maxLines || DEFAULT_MAX_LINES,
+        };
+        if (config.memoryDir) {
+            this.memoryPath = config.memoryDir;
+        }
+        else {
+            this.memoryPath = SubagentMemory.getMemoryDir(config.agentName, config.scope);
+        }
+    }
+    /**
+     * Get memory directory path based on scope
+     */
+    static getMemoryDir(agentName, scope) {
+        const safeName = agentName.replace(/[^a-zA-Z0-9_-]/g, '_');
+        switch (scope) {
+            case 'user':
+                return path.join(os.homedir(), '.codebuddy', 'agents', safeName, 'memory');
+            case 'project':
+                return path.join(process.cwd(), '.codebuddy', 'agents', safeName, 'memory');
+            case 'local':
+                return path.join(os.tmpdir(), 'codebuddy-agents', safeName, 'memory');
+        }
+    }
+    /**
+     * Ensure the memory directory exists
+     */
+    ensureDir() {
+        if (!fs.existsSync(this.memoryPath)) {
+            fs.mkdirSync(this.memoryPath, { recursive: true });
+        }
+    }
+    /**
+     * Get the MEMORY.md file path
+     */
+    getMemoryFilePath() {
+        return path.join(this.memoryPath, 'MEMORY.md');
+    }
+    /**
+     * Read MEMORY.md (first maxLines lines)
+     */
+    readMemory() {
+        const filePath = this.getMemoryFilePath();
+        if (!fs.existsSync(filePath)) {
+            return '';
+        }
+        const content = fs.readFileSync(filePath, 'utf-8');
+        const lines = content.split('\n');
+        const limited = lines.slice(0, this.config.maxLines);
+        return limited.join('\n');
+    }
+    /**
+     * Write to MEMORY.md (replace all content)
+     */
+    writeMemory(content) {
+        this.ensureDir();
+        const filePath = this.getMemoryFilePath();
+        fs.writeFileSync(filePath, content, 'utf-8');
+        logger.debug(`Memory written for agent: ${this.config.agentName}`);
+    }
+    /**
+     * Append to MEMORY.md
+     */
+    appendMemory(entry) {
+        this.ensureDir();
+        const filePath = this.getMemoryFilePath();
+        const existing = fs.existsSync(filePath) ? fs.readFileSync(filePath, 'utf-8') : '';
+        const separator = existing.endsWith('\n') || existing === '' ? '' : '\n';
+        fs.writeFileSync(filePath, existing + separator + entry + '\n', 'utf-8');
+        logger.debug(`Memory appended for agent: ${this.config.agentName}`);
+    }
+    /**
+     * Read a specific topic file
+     */
+    readTopic(topicName) {
+        const safeTopic = topicName.replace(/[^a-zA-Z0-9_-]/g, '_');
+        const filePath = path.join(this.memoryPath, `${safeTopic}.md`);
+        if (!fs.existsSync(filePath)) {
+            return null;
+        }
+        return fs.readFileSync(filePath, 'utf-8');
+    }
+    /**
+     * Write a topic file
+     */
+    writeTopic(topicName, content) {
+        this.ensureDir();
+        const safeTopic = topicName.replace(/[^a-zA-Z0-9_-]/g, '_');
+        const filePath = path.join(this.memoryPath, `${safeTopic}.md`);
+        fs.writeFileSync(filePath, content, 'utf-8');
+        logger.debug(`Topic written: ${topicName} for agent: ${this.config.agentName}`);
+    }
+    /**
+     * List all memory files
+     */
+    listMemoryFiles() {
+        if (!fs.existsSync(this.memoryPath)) {
+            return [];
+        }
+        return fs.readdirSync(this.memoryPath).filter(f => f.endsWith('.md'));
+    }
+    /**
+     * Check if memory exists (MEMORY.md file)
+     */
+    hasMemory() {
+        return fs.existsSync(this.getMemoryFilePath());
+    }
+    /**
+     * Get memory size in bytes
+     */
+    getMemorySize() {
+        const filePath = this.getMemoryFilePath();
+        if (!fs.existsSync(filePath)) {
+            return 0;
+        }
+        return fs.statSync(filePath).size;
+    }
+    /**
+     * Clear all memory
+     */
+    clearMemory() {
+        if (!fs.existsSync(this.memoryPath))
+            return;
+        const files = fs.readdirSync(this.memoryPath);
+        for (const file of files) {
+            fs.unlinkSync(path.join(this.memoryPath, file));
+        }
+        logger.info(`Memory cleared for agent: ${this.config.agentName}`);
+    }
+    /**
+     * Generate context injection (first maxLines lines of MEMORY.md)
+     */
+    getContextInjection() {
+        const content = this.readMemory();
+        if (!content) {
+            return '';
+        }
+        return `\n--- SUBAGENT MEMORY (${this.config.agentName}) ---\n${content}\n--- END SUBAGENT MEMORY ---\n`;
+    }
+    getAgentName() {
+        return this.config.agentName;
+    }
+    getScope() {
+        return this.config.scope;
+    }
+    getMemoryPath() {
+        return this.memoryPath;
+    }
+}
+//# sourceMappingURL=subagent-memory.js.map

package/dist/memory/subagent-memory.js.map

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

package/dist/nodes/device-node.d.ts

@@ -0,0 +1,40 @@
+/**
+ * Device Node System
+ *
+ * Manages paired device nodes (macOS, iOS, Android) with capabilities
+ * like camera, screen recording, location, notifications, and system commands.
+ */
+export type DeviceType = 'macos' | 'ios' | 'android';
+export type DeviceCapability = 'camera' | 'screen_record' | 'location' | 'notifications' | 'system_run';
+export interface DeviceNode {
+    id: string;
+    name: string;
+    type: DeviceType;
+    capabilities: DeviceCapability[];
+    paired: boolean;
+    lastSeen: number;
+    address?: string;
+}
+export interface LocationCoords {
+    lat: number;
+    lon: number;
+}
+export declare class DeviceNodeManager {
+    private static instance;
+    private devices;
+    static getInstance(): DeviceNodeManager;
+    static resetInstance(): void;
+    pairDevice(id: string, name: string, type: DeviceType, capabilities: DeviceCapability[]): DeviceNode;
+    unpairDevice(id: string): boolean;
+    getDevice(id: string): DeviceNode | undefined;
+    listDevices(): DeviceNode[];
+    listPairedDevices(): DeviceNode[];
+    isDevicePaired(id: string): boolean;
+    cameraSnap(deviceId: string): string | null;
+    screenRecord(deviceId: string, duration?: number): string | null;
+    getLocation(deviceId: string): LocationCoords | null;
+    sendNotification(deviceId: string, title: string, body: string): boolean;
+    systemRun(deviceId: string, command: string): string | null;
+    generatePairingCode(): string;
+    updateLastSeen(deviceId: string): boolean;
+}

package/dist/nodes/device-node.js

@@ -0,0 +1,117 @@
+/**
+ * Device Node System
+ *
+ * Manages paired device nodes (macOS, iOS, Android) with capabilities
+ * like camera, screen recording, location, notifications, and system commands.
+ */
+import { logger } from '../utils/logger.js';
+// ============================================================================
+// DeviceNodeManager
+// ============================================================================
+export class DeviceNodeManager {
+    static instance = null;
+    devices = new Map();
+    static getInstance() {
+        if (!DeviceNodeManager.instance) {
+            DeviceNodeManager.instance = new DeviceNodeManager();
+        }
+        return DeviceNodeManager.instance;
+    }
+    static resetInstance() {
+        DeviceNodeManager.instance = null;
+    }
+    pairDevice(id, name, type, capabilities) {
+        logger.info(`Pairing device: ${name} (${id})`);
+        const device = {
+            id,
+            name,
+            type,
+            capabilities,
+            paired: true,
+            lastSeen: Date.now(),
+        };
+        this.devices.set(id, device);
+        return device;
+    }
+    unpairDevice(id) {
+        logger.info(`Unpairing device: ${id}`);
+        return this.devices.delete(id);
+    }
+    getDevice(id) {
+        return this.devices.get(id);
+    }
+    listDevices() {
+        return Array.from(this.devices.values());
+    }
+    listPairedDevices() {
+        return Array.from(this.devices.values()).filter(d => d.paired);
+    }
+    isDevicePaired(id) {
+        const device = this.devices.get(id);
+        return device?.paired === true;
+    }
+    cameraSnap(deviceId) {
+        const device = this.devices.get(deviceId);
+        if (!device || !device.capabilities.includes('camera')) {
+            logger.warn(`Device ${deviceId} does not support camera`);
+            return null;
+        }
+        logger.info(`Camera snap on device ${deviceId}`);
+        return `/tmp/snap-${deviceId}-${Date.now()}.jpg`;
+    }
+    screenRecord(deviceId, duration) {
+        const device = this.devices.get(deviceId);
+        if (!device || !device.capabilities.includes('screen_record')) {
+            logger.warn(`Device ${deviceId} does not support screen recording`);
+            return null;
+        }
+        const dur = duration || 10;
+        logger.info(`Screen record on device ${deviceId} for ${dur}s`);
+        return `/tmp/screen-${deviceId}-${Date.now()}.mp4`;
+    }
+    getLocation(deviceId) {
+        const device = this.devices.get(deviceId);
+        if (!device || !device.capabilities.includes('location')) {
+            logger.warn(`Device ${deviceId} does not support location`);
+            return null;
+        }
+        logger.info(`Getting location for device ${deviceId}`);
+        return { lat: 0, lon: 0 };
+    }
+    sendNotification(deviceId, title, body) {
+        const device = this.devices.get(deviceId);
+        if (!device || !device.capabilities.includes('notifications')) {
+            logger.warn(`Device ${deviceId} does not support notifications`);
+            return false;
+        }
+        logger.info(`Sending notification to ${deviceId}: ${title}`);
+        return true;
+    }
+    systemRun(deviceId, command) {
+        const device = this.devices.get(deviceId);
+        if (!device || !device.capabilities.includes('system_run')) {
+            logger.warn(`Device ${deviceId} does not support system_run`);
+            return null;
+        }
+        if (device.type !== 'macos') {
+            logger.warn(`system_run only supported on macOS, device ${deviceId} is ${device.type}`);
+            return null;
+        }
+        logger.info(`Running command on device ${deviceId}: ${command}`);
+        return `stub: executed "${command}" on ${deviceId}`;
+    }
+    generatePairingCode() {
+        const code = Math.floor(100000 + Math.random() * 900000).toString();
+        logger.info(`Generated pairing code: ${code}`);
+        return code;
+    }
+    updateLastSeen(deviceId) {
+        const device = this.devices.get(deviceId);
+        if (!device) {
+            return false;
+        }
+        device.lastSeen = Date.now();
+        return true;
+    }
+}
+//# sourceMappingURL=device-node.js.map

package/dist/nodes/device-node.js.map

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

package/dist/output/json-schema-output.d.ts

@@ -0,0 +1,67 @@
+/**
+ * JSON Schema Output Validation
+ *
+ * Validates LLM output against a JSON Schema definition.
+ * Includes JSON extraction from markdown code blocks and
+ * a built-in schema validator (no external deps).
+ */
+export interface JsonSchemaConfig {
+    schema: Record<string, any>;
+    strict: boolean;
+    extractFromMarkdown: boolean;
+}
+export interface ValidationError {
+    path: string;
+    message: string;
+    expected?: string;
+    actual?: string;
+}
+export interface ValidationResult {
+    valid: boolean;
+    errors: ValidationError[];
+    data?: any;
+}
+export declare class JsonSchemaOutput {
+    private config;
+    constructor(config: JsonSchemaConfig);
+    /**
+     * Validate output against schema
+     */
+    validate(output: string): ValidationResult;
+    /**
+     * Extract JSON from various formats
+     */
+    extractJson(text: string): string | null;
+    /**
+     * Extract from markdown code blocks
+     */
+    private extractFromCodeBlock;
+    /**
+     * Simple JSON Schema validator
+     */
+    private validateSchema;
+    /**
+     * Check if value matches expected type
+     */
+    private checkType;
+    /**
+     * Check enum values
+     */
+    private checkEnum;
+    /**
+     * Check required fields
+     */
+    private checkRequired;
+    /**
+     * Check pattern match
+     */
+    private checkPattern;
+    /**
+     * Format valid output as pretty JSON
+     */
+    formatValidOutput(data: any): string;
+    /**
+     * Get the schema
+     */
+    getSchema(): Record<string, any>;
+}