@nexus-ai-nexoralabs/cli 0.1.0

package/dist/chat/chatService.js

@@ -0,0 +1,163 @@
+import { ContextBuilder } from './contextBuilder.js';
+import { PromptTemplates } from './promptTemplates.js';
+import { CitationService } from '../knowledge/citationService.js';
+import { Logger } from '../common/logger.js';
+export class ChatService {
+    conversationService;
+    messageService;
+    modelGateway;
+    ragEngine;
+    logger;
+    contextBuilder = new ContextBuilder();
+    citationService = new CitationService();
+    constructor(conversationService, messageService, modelGateway, ragEngine, logLevel = 'info') {
+        this.conversationService = conversationService;
+        this.messageService = messageService;
+        this.modelGateway = modelGateway;
+        this.ragEngine = ragEngine;
+        this.logger = new Logger('ChatService', logLevel);
+    }
+    async sendMessage(options, onEvent, externalSignal) {
+        const { conversationId, userPrompt } = options;
+        // 1. Conversation validation
+        const conversation = this.conversationService.getConversation(conversationId);
+        // 2. Persist user message
+        const userMessage = this.messageService.addMessage({
+            conversationId: conversation.id,
+            role: 'user',
+            content: userPrompt,
+            status: 'completed',
+        });
+        // 3. RAG Evidence Retrieval (if enabled)
+        let ragResult;
+        let customSystemPrompt = options.customSystemPrompt || PromptTemplates.getDefaultSystemPrompt();
+        if (options.enableRag && this.ragEngine) {
+            const colId = options.collectionId || this.ragEngine.getOrCreateDefaultCollection().id;
+            this.logger.info(`Retrieving RAG evidence for query in collection '${colId}'`);
+            ragResult = await this.ragEngine.retrieveEvidence(userPrompt, colId, 3);
+            if (ragResult.groundingStatus === 'UNGROUNDED') {
+                customSystemPrompt += '\n\n[RAG Grounding Note]: Insufficient evidence found in knowledge base. State clearly if information is unknown.';
+            }
+            else {
+                customSystemPrompt += `\n\n[Untrusted Source Context Evidence (${ragResult.groundingStatus})]:\n${ragResult.evidenceText}`;
+            }
+        }
+        // 4. Retrieve conversation history & build context
+        const history = this.messageService.getMessages(conversation.id);
+        const context = this.contextBuilder.buildContext(history, {
+            maxContextTokens: options.maxContextTokens,
+            customSystemPrompt,
+        });
+        // 5. Construct prompt package
+        const promptPkg = PromptTemplates.buildPromptPackage(context.messages, context.systemPrompt);
+        const formatted = PromptTemplates.formatForOllama(promptPkg);
+        const assistantMsgId = `msg-${Date.now()}-${Math.random().toString(36).substring(2, 7)}`;
+        let accumulatedText = '';
+        let isCancelled = false;
+        if (externalSignal?.aborted) {
+            isCancelled = true;
+        }
+        if (externalSignal) {
+            externalSignal.addEventListener('abort', () => {
+                isCancelled = true;
+                if (onEvent) {
+                    onEvent({
+                        type: 'cancellation',
+                        conversationId: conversation.id,
+                        messageId: assistantMsgId,
+                        fullText: accumulatedText,
+                    });
+                }
+            });
+        }
+        try {
+            this.logger.info(`Starting streaming chat for conversation '${conversation.id}' using ModelGateway`);
+            const gatewayResponse = await this.modelGateway.generateStream({
+                prompt: formatted.prompt,
+                system: formatted.system,
+                modelId: options.modelId,
+                temperature: options.temperature,
+                timeoutMs: options.timeoutMs || 30000,
+                allowFallback: true,
+            }, (chunk) => {
+                if (chunk.delta) {
+                    accumulatedText += chunk.delta;
+                    if (onEvent) {
+                        onEvent({
+                            type: 'delta',
+                            conversationId: conversation.id,
+                            messageId: assistantMsgId,
+                            delta: chunk.delta,
+                            contextInfo: {
+                                estimatedTokens: context.estimatedTokens,
+                                truncatedCount: context.truncatedCount,
+                                ragGrounding: ragResult?.groundingStatus,
+                            },
+                        });
+                    }
+                }
+            }, externalSignal);
+            accumulatedText = gatewayResponse.text || accumulatedText;
+            // Append Citation Footer if RAG evidence was used
+            if (ragResult && ragResult.citations.length > 0) {
+                const footer = this.citationService.formatCitationFooter(ragResult.citations);
+                accumulatedText += footer;
+            }
+            const assistantMessage = this.messageService.addMessage({
+                id: assistantMsgId,
+                conversationId: conversation.id,
+                role: 'assistant',
+                content: accumulatedText,
+                status: isCancelled ? 'interrupted' : 'completed',
+            });
+            if (onEvent) {
+                onEvent({
+                    type: 'completion',
+                    conversationId: conversation.id,
+                    messageId: assistantMsgId,
+                    fullText: accumulatedText,
+                    contextInfo: {
+                        estimatedTokens: context.estimatedTokens,
+                        truncatedCount: context.truncatedCount,
+                        ragGrounding: ragResult?.groundingStatus,
+                    },
+                });
+            }
+            return {
+                userMessage,
+                assistantMessage,
+                context,
+                ragResult,
+            };
+        }
+        catch (err) {
+            const errorMsg = err instanceof Error ? err.message : String(err);
+            this.logger.error(`Chat orchestration failed: ${errorMsg}`);
+            const status = isCancelled ? 'interrupted' : 'failed';
+            const fallbackText = accumulatedText || `[Generation Error: ${errorMsg}]`;
+            const assistantMessage = this.messageService.addMessage({
+                id: assistantMsgId,
+                conversationId: conversation.id,
+                role: 'assistant',
+                content: fallbackText,
+                status,
+            });
+            if (onEvent) {
+                onEvent({
+                    type: 'error',
+                    conversationId: conversation.id,
+                    messageId: assistantMsgId,
+                    error: errorMsg,
+                    fullText: fallbackText,
+                });
+            }
+            return {
+                userMessage,
+                assistantMessage,
+                context,
+                ragResult,
+            };
+        }
+    }
+}
+//# sourceMappingURL=chatService.js.map

package/dist/chat/chatService.js.map

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

package/dist/chat/contextBuilder.d.ts

@@ -0,0 +1,19 @@
+import type { Message } from '../storage/repositories/types.js';
+export interface ContextBuilderOptions {
+    maxContextTokens?: number;
+    reserveOutputTokens?: number;
+    customSystemPrompt?: string;
+}
+export interface ContextPackage {
+    messages: Message[];
+    systemPrompt: string;
+    estimatedTokens: number;
+    systemTokens: number;
+    truncatedCount: number;
+    maxContextTokens: number;
+}
+export declare class ContextBuilder {
+    static estimateTokens(text: string): number;
+    buildContext(messages: Message[], options?: ContextBuilderOptions): ContextPackage;
+}
+//# sourceMappingURL=contextBuilder.d.ts.map

package/dist/chat/contextBuilder.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"contextBuilder.d.ts","sourceRoot":"","sources":["../../src/chat/contextBuilder.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,kCAAkC,CAAC;AAGhE,MAAM,WAAW,qBAAqB;IACpC,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,mBAAmB,CAAC,EAAE,MAAM,CAAC;IAC7B,kBAAkB,CAAC,EAAE,MAAM,CAAC;CAC7B;AAED,MAAM,WAAW,cAAc;IAC7B,QAAQ,EAAE,OAAO,EAAE,CAAC;IACpB,YAAY,EAAE,MAAM,CAAC;IACrB,eAAe,EAAE,MAAM,CAAC;IACxB,YAAY,EAAE,MAAM,CAAC;IACrB,cAAc,EAAE,MAAM,CAAC;IACvB,gBAAgB,EAAE,MAAM,CAAC;CAC1B;AAED,qBAAa,cAAc;WACX,cAAc,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM;IAK3C,YAAY,CAAC,QAAQ,EAAE,OAAO,EAAE,EAAE,OAAO,GAAE,qBAA0B,GAAG,cAAc;CAuC9F"}

package/dist/chat/contextBuilder.js

@@ -0,0 +1,43 @@
+import { PromptTemplates } from './promptTemplates.js';
+export class ContextBuilder {
+    static estimateTokens(text) {
+        if (!text)
+            return 0;
+        return Math.ceil(text.length / 4);
+    }
+    buildContext(messages, options = {}) {
+        const maxTokens = options.maxContextTokens || 4096;
+        const reserveTokens = options.reserveOutputTokens || 1024;
+        const availableTokens = Math.max(512, maxTokens - reserveTokens);
+        const systemPrompt = options.customSystemPrompt || PromptTemplates.getDefaultSystemPrompt();
+        const systemTokens = ContextBuilder.estimateTokens(systemPrompt);
+        let currentBudget = availableTokens - systemTokens;
+        if (currentBudget <= 0) {
+            currentBudget = 256; // Minimum floor for user prompt
+        }
+        const selectedMessages = [];
+        let totalMessageTokens = 0;
+        let truncatedCount = 0;
+        // Process messages from most recent to oldest
+        const reversed = [...messages].reverse();
+        for (const msg of reversed) {
+            const msgTokens = ContextBuilder.estimateTokens(msg.content) + 4; // 4 overhead tokens per msg
+            if (totalMessageTokens + msgTokens <= currentBudget) {
+                selectedMessages.unshift(msg);
+                totalMessageTokens += msgTokens;
+            }
+            else {
+                truncatedCount++;
+            }
+        }
+        return {
+            messages: selectedMessages,
+            systemPrompt,
+            estimatedTokens: systemTokens + totalMessageTokens,
+            systemTokens,
+            truncatedCount,
+            maxContextTokens: maxTokens,
+        };
+    }
+}
+//# sourceMappingURL=contextBuilder.js.map

package/dist/chat/contextBuilder.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"contextBuilder.js","sourceRoot":"","sources":["../../src/chat/contextBuilder.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC;AAiBvD,MAAM,OAAO,cAAc;IAClB,MAAM,CAAC,cAAc,CAAC,IAAY;QACvC,IAAI,CAAC,IAAI;YAAE,OAAO,CAAC,CAAC;QACpB,OAAO,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC;IACpC,CAAC;IAEM,YAAY,CAAC,QAAmB,EAAE,UAAiC,EAAE;QAC1E,MAAM,SAAS,GAAG,OAAO,CAAC,gBAAgB,IAAI,IAAI,CAAC;QACnD,MAAM,aAAa,GAAG,OAAO,CAAC,mBAAmB,IAAI,IAAI,CAAC;QAC1D,MAAM,eAAe,GAAG,IAAI,CAAC,GAAG,CAAC,GAAG,EAAE,SAAS,GAAG,aAAa,CAAC,CAAC;QAEjE,MAAM,YAAY,GAAG,OAAO,CAAC,kBAAkB,IAAI,eAAe,CAAC,sBAAsB,EAAE,CAAC;QAC5F,MAAM,YAAY,GAAG,cAAc,CAAC,cAAc,CAAC,YAAY,CAAC,CAAC;QAEjE,IAAI,aAAa,GAAG,eAAe,GAAG,YAAY,CAAC;QACnD,IAAI,aAAa,IAAI,CAAC,EAAE,CAAC;YACvB,aAAa,GAAG,GAAG,CAAC,CAAC,gCAAgC;QACvD,CAAC;QAED,MAAM,gBAAgB,GAAc,EAAE,CAAC;QACvC,IAAI,kBAAkB,GAAG,CAAC,CAAC;QAC3B,IAAI,cAAc,GAAG,CAAC,CAAC;QAEvB,8CAA8C;QAC9C,MAAM,QAAQ,GAAG,CAAC,GAAG,QAAQ,CAAC,CAAC,OAAO,EAAE,CAAC;QAEzC,KAAK,MAAM,GAAG,IAAI,QAAQ,EAAE,CAAC;YAC3B,MAAM,SAAS,GAAG,cAAc,CAAC,cAAc,CAAC,GAAG,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,4BAA4B;YAC9F,IAAI,kBAAkB,GAAG,SAAS,IAAI,aAAa,EAAE,CAAC;gBACpD,gBAAgB,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC;gBAC9B,kBAAkB,IAAI,SAAS,CAAC;YAClC,CAAC;iBAAM,CAAC;gBACN,cAAc,EAAE,CAAC;YACnB,CAAC;QACH,CAAC;QAED,OAAO;YACL,QAAQ,EAAE,gBAAgB;YAC1B,YAAY;YACZ,eAAe,EAAE,YAAY,GAAG,kBAAkB;YAClD,YAAY;YACZ,cAAc;YACd,gBAAgB,EAAE,SAAS;SAC5B,CAAC;IACJ,CAAC;CACF"}

package/dist/chat/conversationService.d.ts

@@ -0,0 +1,25 @@
+import type { ConversationRepository } from '../storage/repositories/conversationRepository.js';
+import type { Conversation } from '../storage/repositories/types.js';
+import { LogLevel } from '../common/logger.js';
+export interface CreateConversationDto {
+    id?: string;
+    projectId?: string | null;
+    title?: string;
+    mode?: string;
+}
+export interface UpdateConversationDto {
+    title?: string;
+    mode?: string;
+    archivedAt?: string | null;
+}
+export declare class ConversationService {
+    private conversationRepo;
+    private logger;
+    constructor(conversationRepo: ConversationRepository, logLevel?: LogLevel);
+    createConversation(dto?: CreateConversationDto): Conversation;
+    getConversation(id: string): Conversation;
+    listConversations(projectId?: string | null): Conversation[];
+    updateConversation(id: string, updates: UpdateConversationDto): Conversation;
+    deleteConversation(id: string): boolean;
+}
+//# sourceMappingURL=conversationService.d.ts.map

package/dist/chat/conversationService.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"conversationService.d.ts","sourceRoot":"","sources":["../../src/chat/conversationService.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,mDAAmD,CAAC;AAChG,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,kCAAkC,CAAC;AACrE,OAAO,EAAU,QAAQ,EAAE,MAAM,qBAAqB,CAAC;AAEvD,MAAM,WAAW,qBAAqB;IACpC,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,SAAS,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1B,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAED,MAAM,WAAW,qBAAqB;IACpC,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,UAAU,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;CAC5B;AAED,qBAAa,mBAAmB;IAI5B,OAAO,CAAC,gBAAgB;IAH1B,OAAO,CAAC,MAAM,CAAS;gBAGb,gBAAgB,EAAE,sBAAsB,EAChD,QAAQ,GAAE,QAAiB;IAK7B,kBAAkB,CAAC,GAAG,GAAE,qBAA0B,GAAG,YAAY;IAcjE,eAAe,CAAC,EAAE,EAAE,MAAM,GAAG,YAAY;IAQzC,iBAAiB,CAAC,SAAS,GAAE,MAAM,GAAG,IAAW,GAAG,YAAY,EAAE;IAIlE,kBAAkB,CAAC,EAAE,EAAE,MAAM,EAAE,OAAO,EAAE,qBAAqB,GAAG,YAAY;IAsB5E,kBAAkB,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO;CAIxC"}

package/dist/chat/conversationService.js

@@ -0,0 +1,55 @@
+import { Logger } from '../common/logger.js';
+export class ConversationService {
+    conversationRepo;
+    logger;
+    constructor(conversationRepo, logLevel = 'info') {
+        this.conversationRepo = conversationRepo;
+        this.logger = new Logger('ConversationService', logLevel);
+    }
+    createConversation(dto = {}) {
+        const id = dto.id || `conv-${Date.now()}-${Math.random().toString(36).substring(2, 7)}`;
+        const title = dto.title || 'New Chat';
+        const mode = dto.mode || 'chat';
+        this.logger.info(`Creating conversation '${id}' (title: "${title}")`);
+        return this.conversationRepo.create({
+            id,
+            projectId: dto.projectId ?? null,
+            title,
+            mode,
+        });
+    }
+    getConversation(id) {
+        const conv = this.conversationRepo.findById(id);
+        if (!conv) {
+            throw new Error(`Conversation not found: '${id}'`);
+        }
+        return conv;
+    }
+    listConversations(projectId = null) {
+        return this.conversationRepo.listByProject(projectId);
+    }
+    updateConversation(id, updates) {
+        const existing = this.getConversation(id);
+        const updatedTitle = updates.title !== undefined ? updates.title : existing.title;
+        const updatedMode = updates.mode !== undefined ? updates.mode : existing.mode;
+        const updatedArchived = updates.archivedAt !== undefined ? updates.archivedAt : existing.archivedAt;
+        // Delete and recreate record with updated values for SQLite simplicity
+        this.conversationRepo.deleteById(id);
+        const updated = this.conversationRepo.create({
+            id,
+            projectId: existing.projectId,
+            title: updatedTitle,
+            mode: updatedMode,
+            createdAt: existing.createdAt,
+            updatedAt: new Date().toISOString(),
+            archivedAt: updatedArchived,
+        });
+        this.logger.info(`Updated conversation '${id}' metadata`);
+        return updated;
+    }
+    deleteConversation(id) {
+        this.logger.info(`Deleting conversation '${id}'`);
+        return this.conversationRepo.deleteById(id);
+    }
+}
+//# sourceMappingURL=conversationService.js.map

package/dist/chat/conversationService.js.map

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

package/dist/chat/index.d.ts

@@ -0,0 +1,6 @@
+export * from './conversationService.js';
+export * from './messageService.js';
+export * from './promptTemplates.js';
+export * from './contextBuilder.js';
+export * from './chatService.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/chat/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/chat/index.ts"],"names":[],"mappings":"AAAA,cAAc,0BAA0B,CAAC;AACzC,cAAc,qBAAqB,CAAC;AACpC,cAAc,sBAAsB,CAAC;AACrC,cAAc,qBAAqB,CAAC;AACpC,cAAc,kBAAkB,CAAC"}

package/dist/chat/index.js

@@ -0,0 +1,6 @@
+export * from './conversationService.js';
+export * from './messageService.js';
+export * from './promptTemplates.js';
+export * from './contextBuilder.js';
+export * from './chatService.js';
+//# sourceMappingURL=index.js.map

package/dist/chat/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/chat/index.ts"],"names":[],"mappings":"AAAA,cAAc,0BAA0B,CAAC;AACzC,cAAc,qBAAqB,CAAC;AACpC,cAAc,sBAAsB,CAAC;AACrC,cAAc,qBAAqB,CAAC;AACpC,cAAc,kBAAkB,CAAC"}

package/dist/chat/messageService.d.ts

@@ -0,0 +1,18 @@
+import type { MessageRepository } from '../storage/repositories/messageRepository.js';
+import type { Message } from '../storage/repositories/types.js';
+import { LogLevel } from '../common/logger.js';
+export interface AddMessageDto {
+    id?: string;
+    conversationId: string;
+    role: 'user' | 'assistant' | 'system' | 'tool';
+    content: string;
+    status?: Message['status'];
+}
+export declare class MessageService {
+    private messageRepo;
+    private logger;
+    constructor(messageRepo: MessageRepository, logLevel?: LogLevel);
+    addMessage(dto: AddMessageDto): Message;
+    getMessages(conversationId: string): Message[];
+}
+//# sourceMappingURL=messageService.d.ts.map

package/dist/chat/messageService.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"messageService.d.ts","sourceRoot":"","sources":["../../src/chat/messageService.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,8CAA8C,CAAC;AACtF,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,kCAAkC,CAAC;AAChE,OAAO,EAAU,QAAQ,EAAE,MAAM,qBAAqB,CAAC;AAEvD,MAAM,WAAW,aAAa;IAC5B,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,cAAc,EAAE,MAAM,CAAC;IACvB,IAAI,EAAE,MAAM,GAAG,WAAW,GAAG,QAAQ,GAAG,MAAM,CAAC;IAC/C,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,CAAC,EAAE,OAAO,CAAC,QAAQ,CAAC,CAAC;CAC5B;AAED,qBAAa,cAAc;IAIvB,OAAO,CAAC,WAAW;IAHrB,OAAO,CAAC,MAAM,CAAS;gBAGb,WAAW,EAAE,iBAAiB,EACtC,QAAQ,GAAE,QAAiB;IAK7B,UAAU,CAAC,GAAG,EAAE,aAAa,GAAG,OAAO;IAgBvC,WAAW,CAAC,cAAc,EAAE,MAAM,GAAG,OAAO,EAAE;CAG/C"}

package/dist/chat/messageService.js

@@ -0,0 +1,26 @@
+import { Logger } from '../common/logger.js';
+export class MessageService {
+    messageRepo;
+    logger;
+    constructor(messageRepo, logLevel = 'info') {
+        this.messageRepo = messageRepo;
+        this.logger = new Logger('MessageService', logLevel);
+    }
+    addMessage(dto) {
+        const id = dto.id || `msg-${Date.now()}-${Math.random().toString(36).substring(2, 7)}`;
+        const status = dto.status || 'completed';
+        const record = this.messageRepo.create({
+            id,
+            conversationId: dto.conversationId,
+            role: dto.role,
+            content: dto.content,
+            status,
+        });
+        this.logger.debug(`Added ${dto.role} message '${id}' to conversation '${dto.conversationId}'`);
+        return record;
+    }
+    getMessages(conversationId) {
+        return this.messageRepo.listByConversation(conversationId);
+    }
+}
+//# sourceMappingURL=messageService.js.map

package/dist/chat/messageService.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"messageService.js","sourceRoot":"","sources":["../../src/chat/messageService.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,MAAM,EAAY,MAAM,qBAAqB,CAAC;AAUvD,MAAM,OAAO,cAAc;IAIf;IAHF,MAAM,CAAS;IAEvB,YACU,WAA8B,EACtC,WAAqB,MAAM;QADnB,gBAAW,GAAX,WAAW,CAAmB;QAGtC,IAAI,CAAC,MAAM,GAAG,IAAI,MAAM,CAAC,gBAAgB,EAAE,QAAQ,CAAC,CAAC;IACvD,CAAC;IAED,UAAU,CAAC,GAAkB;QAC3B,MAAM,EAAE,GAAG,GAAG,CAAC,EAAE,IAAI,OAAO,IAAI,CAAC,GAAG,EAAE,IAAI,IAAI,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC,SAAS,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,CAAC;QACvF,MAAM,MAAM,GAAG,GAAG,CAAC,MAAM,IAAI,WAAW,CAAC;QAEzC,MAAM,MAAM,GAAG,IAAI,CAAC,WAAW,CAAC,MAAM,CAAC;YACrC,EAAE;YACF,cAAc,EAAE,GAAG,CAAC,cAAc;YAClC,IAAI,EAAE,GAAG,CAAC,IAAI;YACd,OAAO,EAAE,GAAG,CAAC,OAAO;YACpB,MAAM;SACP,CAAC,CAAC;QAEH,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,SAAS,GAAG,CAAC,IAAI,aAAa,EAAE,sBAAsB,GAAG,CAAC,cAAc,GAAG,CAAC,CAAC;QAC/F,OAAO,MAAM,CAAC;IAChB,CAAC;IAED,WAAW,CAAC,cAAsB;QAChC,OAAO,IAAI,CAAC,WAAW,CAAC,kBAAkB,CAAC,cAAc,CAAC,CAAC;IAC7D,CAAC;CACF"}

package/dist/chat/promptTemplates.d.ts

@@ -0,0 +1,19 @@
+import type { Message } from '../storage/repositories/types.js';
+export interface PromptPackage {
+    systemPrompt: string;
+    formattedMessages: Array<{
+        role: string;
+        content: string;
+    }>;
+    version: string;
+}
+export declare class PromptTemplates {
+    static readonly CURRENT_VERSION = "v1.0.0";
+    static getDefaultSystemPrompt(): string;
+    static buildPromptPackage(messages: Message[], customSystemPrompt?: string): PromptPackage;
+    static formatForOllama(promptPackage: PromptPackage): {
+        system: string;
+        prompt: string;
+    };
+}
+//# sourceMappingURL=promptTemplates.d.ts.map

package/dist/chat/promptTemplates.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"promptTemplates.d.ts","sourceRoot":"","sources":["../../src/chat/promptTemplates.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,kCAAkC,CAAC;AAEhE,MAAM,WAAW,aAAa;IAC5B,YAAY,EAAE,MAAM,CAAC;IACrB,iBAAiB,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IAC5D,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,qBAAa,eAAe;IAC1B,gBAAuB,eAAe,YAAY;WAEpC,sBAAsB,IAAI,MAAM;WAQhC,kBAAkB,CAC9B,QAAQ,EAAE,OAAO,EAAE,EACnB,kBAAkB,CAAC,EAAE,MAAM,GAC1B,aAAa;WAcF,eAAe,CAAC,aAAa,EAAE,aAAa,GAAG;QAAE,MAAM,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE;CAYhG"}

package/dist/chat/promptTemplates.js

@@ -0,0 +1,32 @@
+export class PromptTemplates {
+    static CURRENT_VERSION = 'v1.0.0';
+    static getDefaultSystemPrompt() {
+        return ('You are NEXUS AI, an offline-first local AI workstation assistant. ' +
+            'Provide helpful, accurate, and concise answers based on the conversation context. ' +
+            'Keep technical explanations clear and structured.');
+    }
+    static buildPromptPackage(messages, customSystemPrompt) {
+        const systemPrompt = customSystemPrompt || this.getDefaultSystemPrompt();
+        const formattedMessages = messages.map((m) => ({
+            role: m.role,
+            content: m.content,
+        }));
+        return {
+            systemPrompt,
+            formattedMessages,
+            version: this.CURRENT_VERSION,
+        };
+    }
+    static formatForOllama(promptPackage) {
+        const system = promptPackage.systemPrompt;
+        // Format full dialogue stream into prompt string for single-prompt endpoint
+        const historyText = promptPackage.formattedMessages
+            .map((m) => `${m.role === 'user' ? 'User' : 'Assistant'}: ${m.content}`)
+            .join('\n\n');
+        return {
+            system,
+            prompt: historyText,
+        };
+    }
+}
+//# sourceMappingURL=promptTemplates.js.map

package/dist/chat/promptTemplates.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"promptTemplates.js","sourceRoot":"","sources":["../../src/chat/promptTemplates.ts"],"names":[],"mappings":"AAQA,MAAM,OAAO,eAAe;IACnB,MAAM,CAAU,eAAe,GAAG,QAAQ,CAAC;IAE3C,MAAM,CAAC,sBAAsB;QAClC,OAAO,CACL,qEAAqE;YACrE,oFAAoF;YACpF,mDAAmD,CACpD,CAAC;IACJ,CAAC;IAEM,MAAM,CAAC,kBAAkB,CAC9B,QAAmB,EACnB,kBAA2B;QAE3B,MAAM,YAAY,GAAG,kBAAkB,IAAI,IAAI,CAAC,sBAAsB,EAAE,CAAC;QACzE,MAAM,iBAAiB,GAAG,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;YAC7C,IAAI,EAAE,CAAC,CAAC,IAAI;YACZ,OAAO,EAAE,CAAC,CAAC,OAAO;SACnB,CAAC,CAAC,CAAC;QAEJ,OAAO;YACL,YAAY;YACZ,iBAAiB;YACjB,OAAO,EAAE,IAAI,CAAC,eAAe;SAC9B,CAAC;IACJ,CAAC;IAEM,MAAM,CAAC,eAAe,CAAC,aAA4B;QACxD,MAAM,MAAM,GAAG,aAAa,CAAC,YAAY,CAAC;QAC1C,4EAA4E;QAC5E,MAAM,WAAW,GAAG,aAAa,CAAC,iBAAiB;aAChD,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,GAAG,CAAC,CAAC,IAAI,KAAK,MAAM,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,WAAW,KAAK,CAAC,CAAC,OAAO,EAAE,CAAC;aACvE,IAAI,CAAC,MAAM,CAAC,CAAC;QAEhB,OAAO;YACL,MAAM;YACN,MAAM,EAAE,WAAW;SACpB,CAAC;IACJ,CAAC"}

package/dist/cli/agentRunner.d.ts

@@ -0,0 +1,126 @@
+/**
+ * NEXUS AI — P7-F: Interactive Agent Runner & Subsystem Integration
+ *
+ * Provides a human-facing, interactive CLI runner that integrates the entire
+ * NEXUS agent pipeline (P5-A through P6-D) without duplicating execution or authorization logic.
+ *
+ * Sequence:
+ *   User Task -> Task Creation -> Plan Synthesis -> Plan Validation -> Permission Evaluation
+ *   -> Approval Policy -> Human Approval when required -> Approval Gate -> Tool Execution
+ *   -> Observation -> Verification -> Final Result.
+ *
+ * SECURITY INVARIANTS:
+ *  - Interface ONLY. Does NOT bypass PlanValidator, PermissionEngine, ApprovalGate, or ToolExecutor.
+ *  - Zero direct file reads or repository mutations outside existing service APIs.
+ *  - Zero secrets, API keys, raw prompts, or sensitive tool params logged or displayed.
+ */
+import type { ApplicationApi } from '../api/index.js';
+import type { AgentTask } from '../storage/repositories/types.js';
+import type { AgentPlan } from '../orchestration/types.js';
+import type { ApprovalRequest } from '../tools/approvalTypes.js';
+import { LogLevel } from '../common/logger.js';
+export interface LifecycleEvent {
+    event: string;
+    timestamp: string;
+    details?: string;
+}
+export declare class AgentRunner {
+    api: ApplicationApi;
+    private logger;
+    currentTask: AgentTask | null;
+    currentPlan: AgentPlan | null;
+    lifecycleLogs: LifecycleEvent[];
+    private isResolvingApproval;
+    constructor(api: ApplicationApi, logLevel?: LogLevel);
+    /**
+     * Process a single command input string from the interactive CLI or test runner.
+     * Unknown commands return a safe error without crashing.
+     */
+    runCommand(input: string): Promise<string>;
+    /**
+     * Submit a new user task and run through the P5 architecture pipeline.
+     *
+     * @param goal - The natural language task goal.
+     * @param _showPreview - If true, a prompt preview was already rendered by InputEngine
+     *   before calling runCommand(). Unused here; preview is output-only in InputEngine.
+     */
+    submitTask(goal: string, _showPreview?: boolean): Promise<string>;
+    /**
+     * Submit a coding task through CodingAgentService (P6-D).
+     */
+    submitCodingTask(goal: string): Promise<string>;
+    /**
+     * Resolve an approval request as approved and resume execution.
+     */
+    approveRequest(approvalId: string | undefined): Promise<string>;
+    /**
+     * Resolve an approval request as rejected and stop execution.
+     */
+    rejectRequest(approvalId: string | undefined): Promise<string>;
+    /**
+     * Display detailed parameters and information for a pending approval request.
+     */
+    viewApprovalDetails(approval: ApprovalRequest): string;
+    /**
+     * Cancel active task and invalidate pending approvals.
+     */
+    cancelCurrentTask(): Promise<string>;
+    /**
+     * Returns help command menu.
+     */
+    getHelpText(): string;
+    /**
+     * Returns current task status text without exposing secrets.
+     */
+    getStatusText(): string;
+    /**
+     * P7-H: Handles /preview command and sub-commands (stop, status, taskId).
+     */
+    handlePreviewCommand(args: string[]): Promise<string>;
+    /**
+     * P7-G: Handles /model control command and sub-commands.
+     */
+    handleModelCommand(args: string[]): string;
+    /**
+     * Returns models list from ModelRegistry / storage.
+     */
+    getModelsText(): string;
+    /**
+     * Returns workspace status and security policy info.
+     */
+    getWorkspaceText(): string;
+    /**
+     * Returns recent task history list.
+     */
+    getTasksListText(): string;
+    /**
+     * Inspect a specific task by ID.
+     */
+    inspectTaskText(taskId: string | undefined): string;
+    /**
+     * Returns agents & subsystems status.
+     */
+    getAgentsStatusText(): string;
+    /**
+     * Clear screen helper.
+     */
+    clearScreen(): string;
+    /**
+     * Returns plan steps text for current task.
+     */
+    getPlanText(): string;
+    /**
+     * Returns approval requests list for current task.
+     */
+    getApprovalsText(): string;
+    /**
+     * Returns safe result view for completed/failed/cancelled task.
+     */
+    getResultText(): string;
+    /**
+     * Handles exit command.
+     */
+    exitRunner(): string;
+    private recordEvent;
+}
+//# sourceMappingURL=agentRunner.d.ts.map

package/dist/cli/agentRunner.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"agentRunner.d.ts","sourceRoot":"","sources":["../../src/cli/agentRunner.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAEH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,iBAAiB,CAAC;AACtD,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,kCAAkC,CAAC;AAClE,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,2BAA2B,CAAC;AAC3D,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,2BAA2B,CAAC;AACjE,OAAO,EAAU,QAAQ,EAAE,MAAM,qBAAqB,CAAC;AAsBvD,MAAM,WAAW,cAAc;IAC7B,KAAK,EAAE,MAAM,CAAC;IACd,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED,qBAAa,WAAW;IAQb,GAAG,EAAE,cAAc;IAP5B,OAAO,CAAC,MAAM,CAAS;IAChB,WAAW,EAAE,SAAS,GAAG,IAAI,CAAQ;IACrC,WAAW,EAAE,SAAS,GAAG,IAAI,CAAQ;IACrC,aAAa,EAAE,cAAc,EAAE,CAAM;IAC5C,OAAO,CAAC,mBAAmB,CAAS;gBAG3B,GAAG,EAAE,cAAc,EAC1B,QAAQ,GAAE,QAAiB;IAK7B;;;OAGG;IACG,UAAU,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAqJhD;;;;;;OAMG;IACG,UAAU,CAAC,IAAI,EAAE,MAAM,EAAE,YAAY,UAAQ,GAAG,OAAO,CAAC,MAAM,CAAC;IAyHrE;;OAEG;IACG,gBAAgB,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IA6BrD;;OAEG;IACG,cAAc,CAAC,UAAU,EAAE,MAAM,GAAG,SAAS,GAAG,OAAO,CAAC,MAAM,CAAC;IA4GrE;;OAEG;IACG,aAAa,CAAC,UAAU,EAAE,MAAM,GAAG,SAAS,GAAG,OAAO,CAAC,MAAM,CAAC;IA0DpE;;OAEG;IACH,mBAAmB,CAAC,QAAQ,EAAE,eAAe,GAAG,MAAM;IAqBtD;;OAEG;IACG,iBAAiB,IAAI,OAAO,CAAC,MAAM,CAAC;IAkB1C;;OAEG;IACH,WAAW,IAAI,MAAM;IAIrB;;OAEG;IACH,aAAa,IAAI,MAAM;IA8BvB;;OAEG;IACG,oBAAoB,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,MAAM,CAAC;IAyB3D;;OAEG;IACH,kBAAkB,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,MAAM;IA0I1C;;OAEG;IACH,aAAa,IAAI,MAAM;IAsCvB;;OAEG;IACH,gBAAgB,IAAI,MAAM;IAoB1B;;OAEG;IACH,gBAAgB,IAAI,MAAM;IAK1B;;OAEG;IACH,eAAe,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,GAAG,MAAM;IAqCnD;;OAEG;IACH,mBAAmB,IAAI,MAAM;IAc7B;;OAEG;IACH,WAAW,IAAI,MAAM;IAIrB;;OAEG;IACH,WAAW,IAAI,MAAM;IA0BrB;;OAEG;IACH,gBAAgB,IAAI,MAAM;IAqC1B;;OAEG;IACH,aAAa,IAAI,MAAM;IAyBvB;;OAEG;IACH,UAAU,IAAI,MAAM;IAKpB,OAAO,CAAC,WAAW;CAKpB"}