@phantomind/core 0.1.0

package/dist/agent/queue.d.ts

@@ -0,0 +1,95 @@
+/**
+ * PhantomMindAI — Task Queue & Scheduler
+ * Manages task queue with priority, scheduling, and cron support.
+ */
+import { EventEmitter } from 'eventemitter3';
+import type { AgentRole, QueueTask } from '../types.js';
+import type { AgentExecutor } from './executor.js';
+export interface QueueOptions {
+    maxConcurrent?: number;
+    maxQueueSize?: number;
+    defaultPriority?: number;
+}
+export interface ScheduledTask {
+    id: string;
+    cronExpression: string;
+    taskTemplate: {
+        description: string;
+        role?: AgentRole;
+        priority?: QueueTask['priority'];
+    };
+    enabled: boolean;
+    lastRun?: string;
+    nextRun?: string;
+}
+export declare class TaskQueue extends EventEmitter {
+    private queue;
+    private running;
+    private completed;
+    private maxConcurrent;
+    private maxQueueSize;
+    private defaultPriority;
+    private executor?;
+    private scheduledTasks;
+    private cronInterval?;
+    private processing;
+    constructor(options?: QueueOptions);
+    /**
+     * Set the executor for running tasks
+     */
+    setExecutor(executor: AgentExecutor): void;
+    /**
+     * Add a task to the queue
+     */
+    enqueue(description: string, options?: {
+        role?: AgentRole;
+        priority?: QueueTask['priority'];
+        dependencies?: string[];
+    }): QueueTask;
+    /**
+     * Process the next task in the queue
+     */
+    processNext(): Promise<void>;
+    /**
+     * Cancel a queued task
+     */
+    cancel(taskId: string): boolean;
+    /**
+     * Get the next task that has all dependencies satisfied
+     */
+    private getNextReady;
+    /**
+     * Sort queue by priority (lower number = higher priority)
+     */
+    private sortQueue;
+    /**
+     * Schedule a recurring task
+     */
+    schedule(cronExpression: string, description: string, options?: {
+        role?: AgentRole;
+        priority?: QueueTask['priority'];
+    }): ScheduledTask;
+    /**
+     * Start the cron scheduler
+     */
+    private startCron;
+    /**
+     * Simple cron matcher (supports basic patterns)
+     */
+    private matchCron;
+    private matchCronField;
+    /**
+     * Get queue status
+     */
+    getStatus(): {
+        queued: number;
+        running: number;
+        completed: number;
+        tasks: QueueTask[];
+    };
+    /**
+     * Stop the scheduler
+     */
+    stop(): void;
+}
+//# sourceMappingURL=queue.d.ts.map

package/dist/agent/queue.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"queue.d.ts","sourceRoot":"","sources":["../../src/agent/queue.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAGH,OAAO,EAAE,YAAY,EAAE,MAAM,eAAe,CAAC;AAC7C,OAAO,KAAK,EAAE,SAAS,EAAE,SAAS,EAAc,MAAM,aAAa,CAAC;AACpE,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,eAAe,CAAC;AAEnD,MAAM,WAAW,YAAY;IAC3B,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,eAAe,CAAC,EAAE,MAAM,CAAC;CAC1B;AAED,MAAM,WAAW,aAAa;IAC5B,EAAE,EAAE,MAAM,CAAC;IACX,cAAc,EAAE,MAAM,CAAC;IACvB,YAAY,EAAE;QACZ,WAAW,EAAE,MAAM,CAAC;QACpB,IAAI,CAAC,EAAE,SAAS,CAAC;QACjB,QAAQ,CAAC,EAAE,SAAS,CAAC,UAAU,CAAC,CAAC;KAClC,CAAC;IACF,OAAO,EAAE,OAAO,CAAC;IACjB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED,qBAAa,SAAU,SAAQ,YAAY;IACzC,OAAO,CAAC,KAAK,CAAmB;IAChC,OAAO,CAAC,OAAO,CAAgC;IAC/C,OAAO,CAAC,SAAS,CAAmB;IACpC,OAAO,CAAC,aAAa,CAAS;IAC9B,OAAO,CAAC,YAAY,CAAS;IAC7B,OAAO,CAAC,eAAe,CAAS;IAChC,OAAO,CAAC,QAAQ,CAAC,CAAgB;IACjC,OAAO,CAAC,cAAc,CAAuB;IAC7C,OAAO,CAAC,YAAY,CAAC,CAAiC;IACtD,OAAO,CAAC,UAAU,CAAS;gBAEf,OAAO,GAAE,YAAiB;IAOtC;;OAEG;IACH,WAAW,CAAC,QAAQ,EAAE,aAAa,GAAG,IAAI;IAI1C;;OAEG;IACH,OAAO,CACL,WAAW,EAAE,MAAM,EACnB,OAAO,GAAE;QACP,IAAI,CAAC,EAAE,SAAS,CAAC;QACjB,QAAQ,CAAC,EAAE,SAAS,CAAC,UAAU,CAAC,CAAC;QACjC,YAAY,CAAC,EAAE,MAAM,EAAE,CAAC;KACpB,GACL,SAAS;IA2BZ;;OAEG;IACG,WAAW,IAAI,OAAO,CAAC,IAAI,CAAC;IAsClC;;OAEG;IACH,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO;IAU/B;;OAEG;IACH,OAAO,CAAC,YAAY;IAUpB;;OAEG;IACH,OAAO,CAAC,SAAS;IAKjB;;OAEG;IACH,QAAQ,CACN,cAAc,EAAE,MAAM,EACtB,WAAW,EAAE,MAAM,EACnB,OAAO,GAAE;QAAE,IAAI,CAAC,EAAE,SAAS,CAAC;QAAC,QAAQ,CAAC,EAAE,SAAS,CAAC,UAAU,CAAC,CAAA;KAAO,GACnE,aAAa;IAkBhB;;OAEG;IACH,OAAO,CAAC,SAAS;IAkBjB;;OAEG;IACH,OAAO,CAAC,SAAS;IAsBjB,OAAO,CAAC,cAAc;IAuBtB;;OAEG;IACH,SAAS,IAAI;QACX,MAAM,EAAE,MAAM,CAAC;QACf,OAAO,EAAE,MAAM,CAAC;QAChB,SAAS,EAAE,MAAM,CAAC;QAClB,KAAK,EAAE,SAAS,EAAE,CAAC;KACpB;IAaD;;OAEG;IACH,IAAI,IAAI,IAAI;CAOb"}

package/dist/agent/queue.js

@@ -0,0 +1,231 @@
+/**
+ * PhantomMindAI — Task Queue & Scheduler
+ * Manages task queue with priority, scheduling, and cron support.
+ */
+import { randomUUID } from 'node:crypto';
+import { EventEmitter } from 'eventemitter3';
+export class TaskQueue extends EventEmitter {
+    queue = [];
+    running = new Map();
+    completed = [];
+    maxConcurrent;
+    maxQueueSize;
+    defaultPriority;
+    executor;
+    scheduledTasks = [];
+    cronInterval;
+    processing = false;
+    constructor(options = {}) {
+        super();
+        this.maxConcurrent = options.maxConcurrent ?? 3;
+        this.maxQueueSize = options.maxQueueSize ?? 100;
+        this.defaultPriority = options.defaultPriority ?? 5;
+    }
+    /**
+     * Set the executor for running tasks
+     */
+    setExecutor(executor) {
+        this.executor = executor;
+    }
+    /**
+     * Add a task to the queue
+     */
+    enqueue(description, options = {}) {
+        if (this.queue.length >= this.maxQueueSize) {
+            throw new Error(`Queue is full (max ${this.maxQueueSize} tasks)`);
+        }
+        const task = {
+            id: randomUUID(),
+            description,
+            role: options.role ?? 'implementer',
+            priority: options.priority ?? 'normal',
+            status: 'queued',
+            dependencies: options.dependencies ?? [],
+            createdAt: new Date().toISOString(),
+        };
+        this.queue.push(task);
+        this.sortQueue();
+        this.emit('task:queued', task);
+        // Auto-process if not already
+        if (!this.processing) {
+            this.processNext();
+        }
+        return task;
+    }
+    /**
+     * Process the next task in the queue
+     */
+    async processNext() {
+        if (!this.executor)
+            return;
+        if (this.running.size >= this.maxConcurrent)
+            return;
+        const task = this.getNextReady();
+        if (!task) {
+            this.processing = false;
+            return;
+        }
+        this.processing = true;
+        task.status = 'running';
+        task.startedAt = new Date().toISOString();
+        this.running.set(task.id, task);
+        // Remove from queue
+        this.queue = this.queue.filter(t => t.id !== task.id);
+        this.emit('task:running', task);
+        try {
+            const result = await this.executor.run(task.description);
+            task.status = 'completed';
+            task.completedAt = new Date().toISOString();
+            task.result = result;
+            this.emit('task:completed', { task, result });
+        }
+        catch (error) {
+            task.status = 'failed';
+            task.completedAt = new Date().toISOString();
+            task.error = error.message;
+            this.emit('task:failed', { task, error });
+        }
+        finally {
+            this.running.delete(task.id);
+            this.completed.push(task);
+            // Process next
+            this.processNext();
+        }
+    }
+    /**
+     * Cancel a queued task
+     */
+    cancel(taskId) {
+        const idx = this.queue.findIndex(t => t.id === taskId);
+        if (idx === -1)
+            return false;
+        const [task] = this.queue.splice(idx, 1);
+        task.status = 'cancelled';
+        this.emit('task:cancelled', task);
+        return true;
+    }
+    /**
+     * Get the next task that has all dependencies satisfied
+     */
+    getNextReady() {
+        return this.queue.find(task => {
+            const deps = task.dependencies ?? [];
+            if (deps.length === 0)
+                return true;
+            return deps.every(depId => this.completed.some(c => c.id === depId && c.status === 'completed'));
+        });
+    }
+    /**
+     * Sort queue by priority (lower number = higher priority)
+     */
+    sortQueue() {
+        const priorityOrder = { critical: 0, high: 1, normal: 2, low: 3 };
+        this.queue.sort((a, b) => (priorityOrder[a.priority] ?? 2) - (priorityOrder[b.priority] ?? 2));
+    }
+    /**
+     * Schedule a recurring task
+     */
+    schedule(cronExpression, description, options = {}) {
+        const task = {
+            id: randomUUID(),
+            cronExpression,
+            taskTemplate: {
+                description,
+                role: options.role,
+                priority: options.priority,
+            },
+            enabled: true,
+        };
+        this.scheduledTasks.push(task);
+        this.startCron();
+        this.emit('task:scheduled', task);
+        return task;
+    }
+    /**
+     * Start the cron scheduler
+     */
+    startCron() {
+        if (this.cronInterval)
+            return;
+        this.cronInterval = setInterval(() => {
+            const now = new Date();
+            for (const task of this.scheduledTasks) {
+                if (!task.enabled)
+                    continue;
+                if (this.matchCron(task.cronExpression, now)) {
+                    task.lastRun = now.toISOString();
+                    this.enqueue(task.taskTemplate.description, {
+                        role: task.taskTemplate.role,
+                        priority: task.taskTemplate.priority,
+                    });
+                }
+            }
+        }, 60_000); // Check every minute
+    }
+    /**
+     * Simple cron matcher (supports basic patterns)
+     */
+    matchCron(expression, date) {
+        const parts = expression.split(' ');
+        if (parts.length !== 5)
+            return false;
+        const [minute, hour, dayOfMonth, month, dayOfWeek] = parts;
+        const now = {
+            minute: date.getMinutes(),
+            hour: date.getHours(),
+            dayOfMonth: date.getDate(),
+            month: date.getMonth() + 1,
+            dayOfWeek: date.getDay(),
+        };
+        return (this.matchCronField(minute, now.minute) &&
+            this.matchCronField(hour, now.hour) &&
+            this.matchCronField(dayOfMonth, now.dayOfMonth) &&
+            this.matchCronField(month, now.month) &&
+            this.matchCronField(dayOfWeek, now.dayOfWeek));
+    }
+    matchCronField(field, value) {
+        if (field === '*')
+            return true;
+        // Handle */n (every n)
+        if (field.startsWith('*/')) {
+            const interval = parseInt(field.slice(2), 10);
+            return value % interval === 0;
+        }
+        // Handle comma-separated values
+        if (field.includes(',')) {
+            return field.split(',').some(v => parseInt(v, 10) === value);
+        }
+        // Handle ranges (n-m)
+        if (field.includes('-')) {
+            const [start, end] = field.split('-').map(v => parseInt(v, 10));
+            return value >= start && value <= end;
+        }
+        return parseInt(field, 10) === value;
+    }
+    /**
+     * Get queue status
+     */
+    getStatus() {
+        return {
+            queued: this.queue.length,
+            running: this.running.size,
+            completed: this.completed.length,
+            tasks: [
+                ...this.queue,
+                ...Array.from(this.running.values()),
+                ...this.completed.slice(-20),
+            ],
+        };
+    }
+    /**
+     * Stop the scheduler
+     */
+    stop() {
+        if (this.cronInterval) {
+            clearInterval(this.cronInterval);
+            this.cronInterval = undefined;
+        }
+        this.processing = false;
+    }
+}
+//# sourceMappingURL=queue.js.map

package/dist/agent/queue.js.map

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

package/dist/agent/retry.d.ts

@@ -0,0 +1,61 @@
+/**
+ * PhantomMindAI — Retry Intelligence
+ * 5 strategies: decompose, add-schema, switch-provider, add-grounding, escalate.
+ */
+import type { ProviderRouter } from '../providers/router.js';
+import type { ContextEngine } from '../context/engine.js';
+import type { CompletionRequest, CompletionResponse } from '../types.js';
+export type RetryStrategy = 'decompose' | 'add-schema' | 'switch-provider' | 'add-grounding' | 'escalate';
+export interface RetryContext {
+    request: CompletionRequest;
+    error: Error;
+    attempt: number;
+    previousStrategies: RetryStrategy[];
+}
+export interface RetryResult {
+    success: boolean;
+    response?: CompletionResponse;
+    strategy: RetryStrategy;
+    attempts: number;
+    error?: string;
+}
+export declare class RetryIntelligence {
+    private router;
+    private contextEngine;
+    private maxRetries;
+    private strategyOrder;
+    constructor(router: ProviderRouter, contextEngine: ContextEngine, maxRetries?: number);
+    /**
+     * Execute a request with intelligent retry
+     */
+    execute(request: CompletionRequest): Promise<RetryResult>;
+    /**
+     * Select the best retry strategy based on the error and context
+     */
+    private selectStrategy;
+    /**
+     * Apply a retry strategy to the request
+     */
+    private applyStrategy;
+    /**
+     * Strategy: Decompose — simplify the prompt
+     */
+    private strategyDecompose;
+    /**
+     * Strategy: Add Schema — enforce JSON output format
+     */
+    private strategyAddSchema;
+    /**
+     * Strategy: Switch Provider — try a different LLM provider
+     */
+    private strategySwitchProvider;
+    /**
+     * Strategy: Add Grounding — provide more context
+     */
+    private strategyAddGrounding;
+    /**
+     * Strategy: Escalate — last resort, add explicit error context
+     */
+    private strategyEscalate;
+}
+//# sourceMappingURL=retry.d.ts.map

package/dist/agent/retry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"retry.d.ts","sourceRoot":"","sources":["../../src/agent/retry.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,wBAAwB,CAAC;AAC7D,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AAC1D,OAAO,KAAK,EAAE,iBAAiB,EAAE,kBAAkB,EAAE,MAAM,aAAa,CAAC;AAEzE,MAAM,MAAM,aAAa,GACrB,WAAW,GACX,YAAY,GACZ,iBAAiB,GACjB,eAAe,GACf,UAAU,CAAC;AAEf,MAAM,WAAW,YAAY;IAC3B,OAAO,EAAE,iBAAiB,CAAC;IAC3B,KAAK,EAAE,KAAK,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,kBAAkB,EAAE,aAAa,EAAE,CAAC;CACrC;AAED,MAAM,WAAW,WAAW;IAC1B,OAAO,EAAE,OAAO,CAAC;IACjB,QAAQ,CAAC,EAAE,kBAAkB,CAAC;IAC9B,QAAQ,EAAE,aAAa,CAAC;IACxB,QAAQ,EAAE,MAAM,CAAC;IACjB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,qBAAa,iBAAiB;IAC5B,OAAO,CAAC,MAAM,CAAiB;IAC/B,OAAO,CAAC,aAAa,CAAgB;IACrC,OAAO,CAAC,UAAU,CAAS;IAE3B,OAAO,CAAC,aAAa,CAMnB;gBAGA,MAAM,EAAE,cAAc,EACtB,aAAa,EAAE,aAAa,EAC5B,UAAU,SAAI;IAOhB;;OAEG;IACG,OAAO,CAAC,OAAO,EAAE,iBAAiB,GAAG,OAAO,CAAC,WAAW,CAAC;IAsC/D;;OAEG;IACH,OAAO,CAAC,cAAc;IAiCtB;;OAEG;YACW,aAAa;IAmB3B;;OAEG;IACH,OAAO,CAAC,iBAAiB;IAQzB;;OAEG;IACH,OAAO,CAAC,iBAAiB;IAUzB;;OAEG;IACH,OAAO,CAAC,sBAAsB;IAS9B;;OAEG;YACW,oBAAoB;IAUlC;;OAEG;IACH,OAAO,CAAC,gBAAgB;CAOzB"}

package/dist/agent/retry.js

@@ -0,0 +1,162 @@
+/**
+ * PhantomMindAI — Retry Intelligence
+ * 5 strategies: decompose, add-schema, switch-provider, add-grounding, escalate.
+ */
+export class RetryIntelligence {
+    router;
+    contextEngine;
+    maxRetries;
+    strategyOrder = [
+        'decompose',
+        'add-schema',
+        'switch-provider',
+        'add-grounding',
+        'escalate',
+    ];
+    constructor(router, contextEngine, maxRetries = 5) {
+        this.router = router;
+        this.contextEngine = contextEngine;
+        this.maxRetries = maxRetries;
+    }
+    /**
+     * Execute a request with intelligent retry
+     */
+    async execute(request) {
+        let lastError;
+        const usedStrategies = [];
+        for (let attempt = 0; attempt <= this.maxRetries; attempt++) {
+            try {
+                const response = await this.router.complete(request);
+                return {
+                    success: true,
+                    response,
+                    strategy: usedStrategies[usedStrategies.length - 1] ?? 'decompose',
+                    attempts: attempt + 1,
+                };
+            }
+            catch (error) {
+                lastError = error;
+                if (attempt >= this.maxRetries)
+                    break;
+                const strategy = this.selectStrategy({
+                    request,
+                    error: lastError,
+                    attempt,
+                    previousStrategies: usedStrategies,
+                });
+                usedStrategies.push(strategy);
+                request = await this.applyStrategy(strategy, request, lastError);
+            }
+        }
+        return {
+            success: false,
+            strategy: usedStrategies[usedStrategies.length - 1] ?? 'escalate',
+            attempts: this.maxRetries + 1,
+            error: lastError?.message,
+        };
+    }
+    /**
+     * Select the best retry strategy based on the error and context
+     */
+    selectStrategy(ctx) {
+        const errorMsg = ctx.error.message.toLowerCase();
+        // Rate limiting or quota → switch provider
+        if (errorMsg.includes('rate limit') || errorMsg.includes('429') || errorMsg.includes('quota')) {
+            if (!ctx.previousStrategies.includes('switch-provider'))
+                return 'switch-provider';
+        }
+        // Token limit exceeded → decompose
+        if (errorMsg.includes('token') || errorMsg.includes('context length') || errorMsg.includes('too long')) {
+            if (!ctx.previousStrategies.includes('decompose'))
+                return 'decompose';
+        }
+        // JSON parse error or format issue → add schema
+        if (errorMsg.includes('json') || errorMsg.includes('parse') || errorMsg.includes('format')) {
+            if (!ctx.previousStrategies.includes('add-schema'))
+                return 'add-schema';
+        }
+        // Hallucination or accuracy issue → add grounding
+        if (errorMsg.includes('hallucination') || errorMsg.includes('incorrect') || errorMsg.includes('invalid')) {
+            if (!ctx.previousStrategies.includes('add-grounding'))
+                return 'add-grounding';
+        }
+        // Use the next unused strategy in order
+        for (const strategy of this.strategyOrder) {
+            if (!ctx.previousStrategies.includes(strategy)) {
+                return strategy;
+            }
+        }
+        return 'escalate';
+    }
+    /**
+     * Apply a retry strategy to the request
+     */
+    async applyStrategy(strategy, request, error) {
+        switch (strategy) {
+            case 'decompose':
+                return this.strategyDecompose(request);
+            case 'add-schema':
+                return this.strategyAddSchema(request);
+            case 'switch-provider':
+                return this.strategySwitchProvider(request);
+            case 'add-grounding':
+                return await this.strategyAddGrounding(request);
+            case 'escalate':
+                return this.strategyEscalate(request, error);
+        }
+    }
+    /**
+     * Strategy: Decompose — simplify the prompt
+     */
+    strategyDecompose(request) {
+        return {
+            ...request,
+            prompt: `Focus on the most important aspect of this request and provide a concise response:\n\n${request.prompt}`,
+            maxTokens: Math.min(request.maxTokens ?? 2000, 1000),
+        };
+    }
+    /**
+     * Strategy: Add Schema — enforce JSON output format
+     */
+    strategyAddSchema(request) {
+        const schemaInstruction = `\n\nIMPORTANT: Respond ONLY with valid JSON. No markdown fences, no explanations outside JSON. If you need to include code, escape it properly within JSON strings.`;
+        return {
+            ...request,
+            systemPrompt: (request.systemPrompt ?? '') + schemaInstruction,
+            temperature: Math.max((request.temperature ?? 0.7) - 0.2, 0),
+        };
+    }
+    /**
+     * Strategy: Switch Provider — try a different LLM provider
+     */
+    strategySwitchProvider(request) {
+        return {
+            ...request,
+            // The router's fallback mechanism will handle provider switching
+            // We just need to modify the request slightly to trigger a fresh attempt
+            temperature: (request.temperature ?? 0.7) + 0.1,
+        };
+    }
+    /**
+     * Strategy: Add Grounding — provide more context
+     */
+    async strategyAddGrounding(request) {
+        const context = await this.contextEngine.getProjectContext({ maxTokens: 1500 });
+        const groundingContext = context.layers.map(l => l.content).join('\n\n');
+        return {
+            ...request,
+            systemPrompt: `${request.systemPrompt ?? ''}\n\n## Grounding Context\nUse the following verified project information to ensure accuracy:\n${groundingContext}`,
+        };
+    }
+    /**
+     * Strategy: Escalate — last resort, add explicit error context
+     */
+    strategyEscalate(request, error) {
+        return {
+            ...request,
+            systemPrompt: `${request.systemPrompt ?? ''}\n\nIMPORTANT: Previous attempt failed with error: "${error.message}". Please adjust your response to avoid this issue. Be more conservative and precise.`,
+            temperature: 0.1,
+        };
+    }
+}
+//# sourceMappingURL=retry.js.map

package/dist/agent/retry.js.map

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

package/dist/agent/roles.d.ts

@@ -0,0 +1,35 @@
+/**
+ * PhantomMindAI — Agent Roles
+ * Persona & role system with specialized system prompts.
+ */
+import type { AgentRole } from '../types.js';
+export interface RoleDefinition {
+    name: AgentRole;
+    displayName: string;
+    description: string;
+    systemPrompt: string;
+    temperature: number;
+    focus: string[];
+    constraints: string[];
+}
+/**
+ * Get the system prompt for a role
+ */
+export declare function getRoleSystemPrompt(role: AgentRole): string;
+/**
+ * Get the full role definition
+ */
+export declare function getRoleDefinition(role: AgentRole): RoleDefinition;
+/**
+ * Get all available roles
+ */
+export declare function getAvailableRoles(): RoleDefinition[];
+/**
+ * Get recommended temperature for a role
+ */
+export declare function getRoleTemperature(role: AgentRole): number;
+/**
+ * Build a composite system prompt from multiple roles
+ */
+export declare function buildMultiRolePrompt(roles: AgentRole[]): string;
+//# sourceMappingURL=roles.d.ts.map

package/dist/agent/roles.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"roles.d.ts","sourceRoot":"","sources":["../../src/agent/roles.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AAE7C,MAAM,WAAW,cAAc;IAC7B,IAAI,EAAE,SAAS,CAAC;IAChB,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,EAAE,MAAM,CAAC;IACpB,YAAY,EAAE,MAAM,CAAC;IACrB,WAAW,EAAE,MAAM,CAAC;IACpB,KAAK,EAAE,MAAM,EAAE,CAAC;IAChB,WAAW,EAAE,MAAM,EAAE,CAAC;CACvB;AA6OD;;GAEG;AACH,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,SAAS,GAAG,MAAM,CAE3D;AAED;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,SAAS,GAAG,cAAc,CAEjE;AAED;;GAEG;AACH,wBAAgB,iBAAiB,IAAI,cAAc,EAAE,CAEpD;AAED;;GAEG;AACH,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,SAAS,GAAG,MAAM,CAE1D;AAED;;GAEG;AACH,wBAAgB,oBAAoB,CAAC,KAAK,EAAE,SAAS,EAAE,GAAG,MAAM,CAO/D"}