@qduc/term2 0.1.0

package/dist/providers/web-search/tavily.provider.js

@@ -0,0 +1,69 @@
+/**
+ * Tavily web search provider implementation.
+ * Tavily provides high-quality web search results optimized for AI applications.
+ *
+ * API Documentation: https://docs.tavily.com/
+ */
+import { registerWebSearchProvider } from './registry.js';
+const TAVILY_API_URL = 'https://api.tavily.com/search';
+async function searchTavily(query, deps) {
+    const { settingsService, loggingService } = deps;
+    const apiKey = settingsService.get('webSearch.tavily.apiKey');
+    if (!apiKey) {
+        throw new Error('Tavily API key is not configured. ' +
+            'Set TAVILY_API_KEY environment variable or configure webSearch.tavily.apiKey.');
+    }
+    loggingService.debug('Executing Tavily web search', { query });
+    const response = await fetch(TAVILY_API_URL, {
+        method: 'POST',
+        headers: {
+            'Content-Type': 'application/json',
+        },
+        body: JSON.stringify({
+            api_key: apiKey,
+            query: query,
+            // Leave all other parameters at default values per requirements
+        }),
+    });
+    if (!response.ok) {
+        const errorText = await response.text();
+        loggingService.error('Tavily API error', {
+            status: response.status,
+            error: errorText
+        });
+        throw new Error(`Tavily API error (${response.status}): ${errorText}`);
+    }
+    const data = await response.json();
+    loggingService.debug('Tavily search completed', {
+        resultCount: data.results?.length || 0,
+        hasAnswer: !!data.answer
+    });
+    return {
+        query: data.query,
+        results: (data.results || []).map(r => ({
+            title: r.title,
+            url: r.url,
+            content: r.content,
+            score: r.score,
+            publishedDate: r.published_date,
+        })),
+        answerBox: data.answer,
+    };
+}
+function isConfigured(deps) {
+    const apiKey = deps.settingsService.get('webSearch.tavily.apiKey');
+    return !!apiKey;
+}
+// Create the Tavily provider definition
+const tavilyProvider = {
+    id: 'tavily',
+    label: 'Tavily',
+    search: searchTavily,
+    isConfigured,
+    sensitiveSettingKeys: ['webSearch.tavily.apiKey'],
+};
+// Register the Tavily provider as the default
+registerWebSearchProvider(tavilyProvider, { isDefault: true });
+// Export for testing purposes
+export { tavilyProvider, searchTavily, isConfigured as isTavilyConfigured };
+//# sourceMappingURL=tavily.provider.js.map

package/dist/providers/web-search/tavily.provider.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tavily.provider.js","sourceRoot":"","sources":["../../../source/providers/web-search/tavily.provider.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,yBAAyB,EAAE,MAAM,eAAe,CAAC;AAmB1D,MAAM,cAAc,GAAG,+BAA+B,CAAC;AAEvD,KAAK,UAAU,YAAY,CACvB,KAAa,EACb,IAAmB;IAEnB,MAAM,EAAE,eAAe,EAAE,cAAc,EAAE,GAAG,IAAI,CAAC;IAEjD,MAAM,MAAM,GAAG,eAAe,CAAC,GAAG,CAAS,yBAAyB,CAAC,CAAC;IACtE,IAAI,CAAC,MAAM,EAAE,CAAC;QACV,MAAM,IAAI,KAAK,CACX,oCAAoC;YACpC,+EAA+E,CAClF,CAAC;IACN,CAAC;IAED,cAAc,CAAC,KAAK,CAAC,6BAA6B,EAAE,EAAE,KAAK,EAAE,CAAC,CAAC;IAE/D,MAAM,QAAQ,GAAG,MAAM,KAAK,CAAC,cAAc,EAAE;QACzC,MAAM,EAAE,MAAM;QACd,OAAO,EAAE;YACL,cAAc,EAAE,kBAAkB;SACrC;QACD,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC;YACjB,OAAO,EAAE,MAAM;YACf,KAAK,EAAE,KAAK;YACZ,gEAAgE;SACnE,CAAC;KACL,CAAC,CAAC;IAEH,IAAI,CAAC,QAAQ,CAAC,EAAE,EAAE,CAAC;QACf,MAAM,SAAS,GAAG,MAAM,QAAQ,CAAC,IAAI,EAAE,CAAC;QACxC,cAAc,CAAC,KAAK,CAAC,kBAAkB,EAAE;YACrC,MAAM,EAAE,QAAQ,CAAC,MAAM;YACvB,KAAK,EAAE,SAAS;SACnB,CAAC,CAAC;QACH,MAAM,IAAI,KAAK,CAAC,qBAAqB,QAAQ,CAAC,MAAM,MAAM,SAAS,EAAE,CAAC,CAAC;IAC3E,CAAC;IAED,MAAM,IAAI,GAAG,MAAM,QAAQ,CAAC,IAAI,EAAuB,CAAC;IAExD,cAAc,CAAC,KAAK,CAAC,yBAAyB,EAAE;QAC5C,WAAW,EAAE,IAAI,CAAC,OAAO,EAAE,MAAM,IAAI,CAAC;QACtC,SAAS,EAAE,CAAC,CAAC,IAAI,CAAC,MAAM;KAC3B,CAAC,CAAC;IAEH,OAAO;QACH,KAAK,EAAE,IAAI,CAAC,KAAK;QACjB,OAAO,EAAE,CAAC,IAAI,CAAC,OAAO,IAAI,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;YACpC,KAAK,EAAE,CAAC,CAAC,KAAK;YACd,GAAG,EAAE,CAAC,CAAC,GAAG;YACV,OAAO,EAAE,CAAC,CAAC,OAAO;YAClB,KAAK,EAAE,CAAC,CAAC,KAAK;YACd,aAAa,EAAE,CAAC,CAAC,cAAc;SAClC,CAAC,CAAC;QACH,SAAS,EAAE,IAAI,CAAC,MAAM;KACzB,CAAC;AACN,CAAC;AAED,SAAS,YAAY,CAAC,IAA2C;IAC7D,MAAM,MAAM,GAAG,IAAI,CAAC,eAAe,CAAC,GAAG,CAAS,yBAAyB,CAAC,CAAC;IAC3E,OAAO,CAAC,CAAC,MAAM,CAAC;AACpB,CAAC;AAED,wCAAwC;AACxC,MAAM,cAAc,GAAsB;IACtC,EAAE,EAAE,QAAQ;IACZ,KAAK,EAAE,QAAQ;IACf,MAAM,EAAE,YAAY;IACpB,YAAY;IACZ,oBAAoB,EAAE,CAAC,yBAAyB,CAAC;CACpD,CAAC;AAEF,8CAA8C;AAC9C,yBAAyB,CAAC,cAAc,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;AAE/D,8BAA8B;AAC9B,OAAO,EAAE,cAAc,EAAE,YAAY,EAAE,YAAY,IAAI,kBAAkB,EAAE,CAAC"}

package/dist/providers/web-search/tavily.provider.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=tavily.provider.test.d.ts.map

package/dist/providers/web-search/tavily.provider.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tavily.provider.test.d.ts","sourceRoot":"","sources":["../../../source/providers/web-search/tavily.provider.test.ts"],"names":[],"mappings":""}

package/dist/providers/web-search/tavily.provider.test.js

@@ -0,0 +1,67 @@
+import test from 'ava';
+import { tavilyProvider, isTavilyConfigured } from './tavily.provider.js';
+// Helper to create a mock settings service
+const createMockSettingsService = (settings = {}) => ({
+    get: (key) => settings[key],
+    set: () => { },
+});
+// Helper to create a mock logging service
+const createMockLoggingService = () => ({
+    info: () => { },
+    warn: () => { },
+    error: () => { },
+    debug: () => { },
+    security: () => { },
+    setCorrelationId: () => { },
+    getCorrelationId: () => undefined,
+    clearCorrelationId: () => { },
+});
+test('tavilyProvider has correct id and label', t => {
+    t.is(tavilyProvider.id, 'tavily');
+    t.is(tavilyProvider.label, 'Tavily');
+});
+test('tavilyProvider has required methods', t => {
+    t.is(typeof tavilyProvider.search, 'function');
+    t.is(typeof tavilyProvider.isConfigured, 'function');
+});
+test('tavilyProvider has sensitiveSettingKeys', t => {
+    t.true(Array.isArray(tavilyProvider.sensitiveSettingKeys));
+    t.true(tavilyProvider.sensitiveSettingKeys?.includes('webSearch.tavily.apiKey'));
+});
+test('isConfigured returns true when API key is set', t => {
+    const settings = createMockSettingsService({
+        'webSearch.tavily.apiKey': 'tvly-test-key',
+    });
+    const result = isTavilyConfigured({ settingsService: settings });
+    t.true(result);
+});
+test('isConfigured returns false when API key is missing', t => {
+    const settings = createMockSettingsService({});
+    const result = isTavilyConfigured({ settingsService: settings });
+    t.false(result);
+});
+test('isConfigured returns false when API key is empty string', t => {
+    const settings = createMockSettingsService({
+        'webSearch.tavily.apiKey': '',
+    });
+    const result = isTavilyConfigured({ settingsService: settings });
+    t.false(result);
+});
+test('search throws error when API key is missing', async (t) => {
+    const settings = createMockSettingsService({});
+    const logging = createMockLoggingService();
+    const error = await t.throwsAsync(tavilyProvider.search('test query', {
+        settingsService: settings,
+        loggingService: logging,
+    }));
+    t.true(error?.message.includes('Tavily API key is not configured'));
+});
+test('tavilyProvider.isConfigured uses the same logic as isTavilyConfigured', t => {
+    const settingsWithKey = createMockSettingsService({
+        'webSearch.tavily.apiKey': 'tvly-test-key',
+    });
+    const settingsWithoutKey = createMockSettingsService({});
+    t.is(tavilyProvider.isConfigured({ settingsService: settingsWithKey }), isTavilyConfigured({ settingsService: settingsWithKey }));
+    t.is(tavilyProvider.isConfigured({ settingsService: settingsWithoutKey }), isTavilyConfigured({ settingsService: settingsWithoutKey }));
+});
+//# sourceMappingURL=tavily.provider.test.js.map

package/dist/providers/web-search/tavily.provider.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tavily.provider.test.js","sourceRoot":"","sources":["../../../source/providers/web-search/tavily.provider.test.ts"],"names":[],"mappings":"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"}

package/dist/providers/web-search/types.d.ts

@@ -0,0 +1,55 @@
+/**
+ * Types for web search providers.
+ * All web search providers must implement the WebSearchProvider interface.
+ */
+import type { ISettingsService, ILoggingService } from '../../services/service-interfaces.js';
+/**
+ * Result from a single web search result item
+ */
+export interface WebSearchResult {
+    title: string;
+    url: string;
+    content: string;
+    score?: number;
+    publishedDate?: string;
+}
+/**
+ * Response from a web search query
+ */
+export interface WebSearchResponse {
+    query: string;
+    results: WebSearchResult[];
+    answerBox?: string;
+}
+/**
+ * Dependencies passed to web search providers
+ */
+export interface WebSearchDeps {
+    settingsService: ISettingsService;
+    loggingService: ILoggingService;
+}
+/**
+ * Interface that all web search providers must implement
+ */
+export interface WebSearchProvider {
+    /** Unique identifier for the provider (e.g., 'tavily', 'serper') */
+    id: string;
+    /** Human-readable label for display */
+    label: string;
+    /**
+     * Execute a web search query
+     * @param query - The search query string
+     * @param deps - Dependencies (settings service, logging service)
+     * @returns Promise resolving to search results
+     */
+    search: (query: string, deps: WebSearchDeps) => Promise<WebSearchResponse>;
+    /**
+     * Check if the provider is properly configured (has API key, etc.)
+     */
+    isConfigured: (deps: {
+        settingsService: ISettingsService;
+    }) => boolean;
+    /** Settings keys that are sensitive (API keys) */
+    sensitiveSettingKeys?: string[];
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/providers/web-search/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../source/providers/web-search/types.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EAAE,gBAAgB,EAAE,eAAe,EAAE,MAAM,sCAAsC,CAAC;AAE9F;;GAEG;AACH,MAAM,WAAW,eAAe;IAC5B,KAAK,EAAE,MAAM,CAAC;IACd,GAAG,EAAE,MAAM,CAAC;IACZ,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,aAAa,CAAC,EAAE,MAAM,CAAC;CAC1B;AAED;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAC9B,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,eAAe,EAAE,CAAC;IAC3B,SAAS,CAAC,EAAE,MAAM,CAAC;CACtB;AAED;;GAEG;AACH,MAAM,WAAW,aAAa;IAC1B,eAAe,EAAE,gBAAgB,CAAC;IAClC,cAAc,EAAE,eAAe,CAAC;CACnC;AAED;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAC9B,oEAAoE;IACpE,EAAE,EAAE,MAAM,CAAC;IAEX,uCAAuC;IACvC,KAAK,EAAE,MAAM,CAAC;IAEd;;;;;OAKG;IACH,MAAM,EAAE,CACJ,KAAK,EAAE,MAAM,EACb,IAAI,EAAE,aAAa,KAClB,OAAO,CAAC,iBAAiB,CAAC,CAAC;IAEhC;;OAEG;IACH,YAAY,EAAE,CAAC,IAAI,EAAE;QAAE,eAAe,EAAE,gBAAgB,CAAA;KAAE,KAAK,OAAO,CAAC;IAEvE,kDAAkD;IAClD,oBAAoB,CAAC,EAAE,MAAM,EAAE,CAAC;CACnC"}

package/dist/providers/web-search/types.js

@@ -0,0 +1,6 @@
+/**
+ * Types for web search providers.
+ * All web search providers must implement the WebSearchProvider interface.
+ */
+export {};
+//# sourceMappingURL=types.js.map

package/dist/providers/web-search/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../source/providers/web-search/types.ts"],"names":[],"mappings":"AAAA;;;GAGG"}

package/dist/safety-checker.js

@@ -0,0 +1,57 @@
+import { OpenAI } from 'openai';
+const client = new OpenAI();
+
+/**
+ * Evaluates if a bash command is safe to execute automatically
+ * @param {string} command - The bash command to evaluate
+ * @returns {Promise<{safe: boolean, reason: string}>}
+ */
+export async function isSafeCommand(command) {
+  try {
+    const response = await client.chat.completions.create({
+      model: 'gpt-4.1-mini',
+      messages: [{
+        role: 'system',
+        content: `You are a security expert evaluating bash commands for safety.
+Analyze if the command is safe to execute automatically without user approval.
+
+Consider DANGEROUS:
+- Commands that delete, remove, or modify files/directories (rm, rmdir, mv to overwrite, >)
+- Commands that change system configuration (chmod, chown, systemctl, etc.)
+- Commands that install/uninstall software (apt, yum, npm install -g, pip install, etc.)
+- Commands that modify user accounts or permissions
+- Commands that interact with network in destructive ways (curl with -X DELETE, wget with -O to system files)
+- Commands that execute arbitrary code from network sources
+- Commands with sudo or elevated privileges
+- Commands that shut down or reboot the system
+- Commands that modify environment permanently (.bashrc, .profile, etc.)
+- Commands that access sensitive files (/etc/passwd, ~/.ssh/, etc.)
+
+Consider SAFE:
+- Read-only commands (ls, cat, head, tail, grep, find without -exec, pwd, echo, etc.)
+- Non-destructive information gathering (ps, top, df, du, whoami, uname, date, etc.)
+- Simple calculations or text processing (wc, sort, uniq, awk for display, sed for display)
+- Git read operations (git status, git log, git diff, git branch without creation)
+- Package queries without installation (npm list, pip list, apt list)
+- Commands that create new files in user directories (touch, echo >, mkdir in ~/)
+
+Respond with ONLY a JSON object: {"safe": true/false, "reason": "brief explanation"}`
+      }, {
+        role: 'user',
+        content: `Evaluate this command: ${command}`
+      }],
+      temperature: 0,
+      response_format: {
+        type: 'json_object'
+      }
+    });
+    const result = JSON.parse(response.choices[0].message.content);
+    return result;
+  } catch (error) {
+    // If safety check fails, default to requiring approval (safe fallback)
+    return {
+      safe: false,
+      reason: `Safety check failed: ${error.message}`
+    };
+  }
+}

package/dist/services/conversation-events.d.ts

@@ -0,0 +1,76 @@
+export type ConversationEvent = TextDeltaEvent | ReasoningDeltaEvent | ToolStartedEvent | CommandMessageEvent | ApprovalRequiredEvent | FinalResponseEvent | ErrorEvent | RetryEvent;
+export interface RetryEvent {
+    type: 'retry';
+    toolName: string;
+    attempt: number;
+    maxRetries: number;
+    errorMessage: string;
+}
+/**
+ * Transport-friendly text streaming event.
+ *
+ * - `delta` is the new chunk.
+ * - `fullText` is the accumulated text so far (optional but convenient for UIs).
+ */
+export interface TextDeltaEvent {
+    type: 'text_delta';
+    delta: string;
+    fullText?: string;
+}
+/**
+ * Transport-friendly reasoning streaming event.
+ */
+export interface ReasoningDeltaEvent {
+    type: 'reasoning_delta';
+    delta: string;
+    fullText?: string;
+}
+/**
+ * Emitted when a tool is called but hasn't completed yet.
+ * Allows UI to show immediate feedback that a tool is running.
+ */
+export interface ToolStartedEvent {
+    type: 'tool_started';
+    toolCallId: string;
+    toolName: string;
+    arguments: any;
+}
+export interface ApprovalRequiredEvent {
+    type: 'approval_required';
+    approval: {
+        agentName: string;
+        toolName: string;
+        argumentsText: string;
+        /** Optional provider-specific tool call id (when available). */
+        callId?: string;
+    };
+}
+export interface CommandMessageEvent {
+    type: 'command_message';
+    message: {
+        id: string;
+        sender: 'command';
+        status: 'pending' | 'running' | 'completed' | 'failed';
+        command: string;
+        output: string;
+        success?: boolean;
+        failureReason?: string;
+        isApprovalRejection?: boolean;
+        callId?: string;
+        toolName?: string;
+        toolArgs?: any;
+    };
+}
+export interface FinalResponseEvent {
+    type: 'final';
+    finalText: string;
+    reasoningText?: string;
+    /** Command messages that were not already streamed live. */
+    commandMessages?: CommandMessageEvent['message'][];
+}
+export interface ErrorEvent {
+    type: 'error';
+    message: string;
+    kind?: string;
+}
+//# sourceMappingURL=conversation-events.d.ts.map

package/dist/services/conversation-events.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"conversation-events.d.ts","sourceRoot":"","sources":["../../source/services/conversation-events.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,iBAAiB,GACvB,cAAc,GACd,mBAAmB,GACnB,gBAAgB,GAChB,mBAAmB,GACnB,qBAAqB,GACrB,kBAAkB,GAClB,UAAU,GACV,UAAU,CAAC;AAEjB,MAAM,WAAW,UAAU;IACvB,IAAI,EAAE,OAAO,CAAC;IACd,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,EAAE,MAAM,CAAC;IAChB,UAAU,EAAE,MAAM,CAAC;IACnB,YAAY,EAAE,MAAM,CAAC;CACxB;AAED;;;;;GAKG;AACH,MAAM,WAAW,cAAc;IAC3B,IAAI,EAAE,YAAY,CAAC;IACnB,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,CAAC,EAAE,MAAM,CAAC;CACrB;AAED;;GAEG;AACH,MAAM,WAAW,mBAAmB;IAChC,IAAI,EAAE,iBAAiB,CAAC;IACxB,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,CAAC,EAAE,MAAM,CAAC;CACrB;AAED;;;GAGG;AACH,MAAM,WAAW,gBAAgB;IAC7B,IAAI,EAAE,cAAc,CAAC;IACrB,UAAU,EAAE,MAAM,CAAC;IACnB,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,EAAE,GAAG,CAAC;CAClB;AAED,MAAM,WAAW,qBAAqB;IAClC,IAAI,EAAE,mBAAmB,CAAC;IAC1B,QAAQ,EAAE;QACN,SAAS,EAAE,MAAM,CAAC;QAClB,QAAQ,EAAE,MAAM,CAAC;QACjB,aAAa,EAAE,MAAM,CAAC;QACtB,gEAAgE;QAChE,MAAM,CAAC,EAAE,MAAM,CAAC;KACnB,CAAC;CACL;AAED,MAAM,WAAW,mBAAmB;IAChC,IAAI,EAAE,iBAAiB,CAAC;IACxB,OAAO,EAAE;QACL,EAAE,EAAE,MAAM,CAAC;QACX,MAAM,EAAE,SAAS,CAAC;QAClB,MAAM,EAAE,SAAS,GAAG,SAAS,GAAG,WAAW,GAAG,QAAQ,CAAC;QACvD,OAAO,EAAE,MAAM,CAAC;QAChB,MAAM,EAAE,MAAM,CAAC;QACf,OAAO,CAAC,EAAE,OAAO,CAAC;QAClB,aAAa,CAAC,EAAE,MAAM,CAAC;QACvB,mBAAmB,CAAC,EAAE,OAAO,CAAC;QAC9B,MAAM,CAAC,EAAE,MAAM,CAAC;QAChB,QAAQ,CAAC,EAAE,MAAM,CAAC;QAClB,QAAQ,CAAC,EAAE,GAAG,CAAC;KAClB,CAAC;CACL;AAED,MAAM,WAAW,kBAAkB;IAC/B,IAAI,EAAE,OAAO,CAAC;IACd,SAAS,EAAE,MAAM,CAAC;IAClB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,4DAA4D;IAC5D,eAAe,CAAC,EAAE,mBAAmB,CAAC,SAAS,CAAC,EAAE,CAAC;CACtD;AAED,MAAM,WAAW,UAAU;IACvB,IAAI,EAAE,OAAO,CAAC;IACd,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,CAAC,EAAE,MAAM,CAAC;CACjB"}

package/dist/services/conversation-events.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=conversation-events.js.map

package/dist/services/conversation-events.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"conversation-events.js","sourceRoot":"","sources":["../../source/services/conversation-events.ts"],"names":[],"mappings":""}

package/dist/services/conversation-service.d.ts

@@ -0,0 +1,31 @@
+import type { OpenAIAgentClient } from '../lib/openai-agent-client.js';
+import type { ILoggingService } from './service-interfaces.js';
+import { ConversationSession } from './conversation-session.js';
+export type { ConversationResult, CommandMessage, } from './conversation-session.js';
+/**
+ * Backward-compatible facade for the CLI.
+ *
+ * Phase 3: the session owns the conversation state; the service is a thin wrapper.
+ */
+export declare class ConversationService {
+    #private;
+    constructor({ agentClient, deps, sessionId, }: {
+        agentClient: OpenAIAgentClient;
+        deps: {
+            logger: ILoggingService;
+        };
+        sessionId?: string;
+    });
+    get sessionId(): string;
+    reset(): void;
+    setModel(model: string): void;
+    setReasoningEffort(effort: any): void;
+    setTemperature(temperature: any): void;
+    setProvider(provider: string): void;
+    setRetryCallback(callback: () => void): void;
+    addShellContext(historyText: string): void;
+    abort(): void;
+    sendMessage(...args: Parameters<ConversationSession['sendMessage']>): Promise<import("./conversation-session.js").ConversationResult>;
+    handleApprovalDecision(...args: Parameters<ConversationSession['handleApprovalDecision']>): Promise<import("./conversation-session.js").ConversationResult | null>;
+}
+//# sourceMappingURL=conversation-service.d.ts.map

package/dist/services/conversation-service.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"conversation-service.d.ts","sourceRoot":"","sources":["../../source/services/conversation-service.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAC,iBAAiB,EAAC,MAAM,+BAA+B,CAAC;AACrE,OAAO,KAAK,EAAC,eAAe,EAAC,MAAM,yBAAyB,CAAC;AAC7D,OAAO,EAAC,mBAAmB,EAAC,MAAM,2BAA2B,CAAC;AAE9D,YAAY,EACR,kBAAkB,EAClB,cAAc,GACjB,MAAM,2BAA2B,CAAC;AAEnC;;;;GAIG;AACH,qBAAa,mBAAmB;;gBAGhB,EACR,WAAW,EACX,IAAI,EACJ,SAAqB,GACxB,EAAE;QACC,WAAW,EAAE,iBAAiB,CAAC;QAC/B,IAAI,EAAE;YAAC,MAAM,EAAE,eAAe,CAAA;SAAC,CAAC;QAChC,SAAS,CAAC,EAAE,MAAM,CAAC;KACtB;IAID,IAAI,SAAS,IAAI,MAAM,CAEtB;IAED,KAAK,IAAI,IAAI;IAIb,QAAQ,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI;IAI7B,kBAAkB,CAAC,MAAM,EAAE,GAAG,GAAG,IAAI;IAIrC,cAAc,CAAC,WAAW,EAAE,GAAG,GAAG,IAAI;IAItC,WAAW,CAAC,QAAQ,EAAE,MAAM,GAAG,IAAI;IAInC,gBAAgB,CAAC,QAAQ,EAAE,MAAM,IAAI,GAAG,IAAI;IAI5C,eAAe,CAAC,WAAW,EAAE,MAAM,GAAG,IAAI;IAI1C,KAAK,IAAI,IAAI;IAIb,WAAW,CAAC,GAAG,IAAI,EAAE,UAAU,CAAC,mBAAmB,CAAC,aAAa,CAAC,CAAC;IAInE,sBAAsB,CAClB,GAAG,IAAI,EAAE,UAAU,CAAC,mBAAmB,CAAC,wBAAwB,CAAC,CAAC;CAIzE"}

package/dist/services/conversation-service.js

@@ -0,0 +1,46 @@
+import { ConversationSession } from './conversation-session.js';
+/**
+ * Backward-compatible facade for the CLI.
+ *
+ * Phase 3: the session owns the conversation state; the service is a thin wrapper.
+ */
+export class ConversationService {
+    #session;
+    constructor({ agentClient, deps, sessionId = 'default', }) {
+        this.#session = new ConversationSession(sessionId, { agentClient, deps });
+    }
+    get sessionId() {
+        return this.#session.id;
+    }
+    reset() {
+        this.#session.reset();
+    }
+    setModel(model) {
+        this.#session.setModel(model);
+    }
+    setReasoningEffort(effort) {
+        this.#session.setReasoningEffort(effort);
+    }
+    setTemperature(temperature) {
+        this.#session.setTemperature?.(temperature);
+    }
+    setProvider(provider) {
+        this.#session.setProvider(provider);
+    }
+    setRetryCallback(callback) {
+        this.#session.setRetryCallback(callback);
+    }
+    addShellContext(historyText) {
+        this.#session.addShellContext(historyText);
+    }
+    abort() {
+        this.#session.abort();
+    }
+    sendMessage(...args) {
+        return this.#session.sendMessage(...args);
+    }
+    handleApprovalDecision(...args) {
+        return this.#session.handleApprovalDecision(...args);
+    }
+}
+//# sourceMappingURL=conversation-service.js.map

package/dist/services/conversation-service.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"conversation-service.js","sourceRoot":"","sources":["../../source/services/conversation-service.ts"],"names":[],"mappings":"AAEA,OAAO,EAAC,mBAAmB,EAAC,MAAM,2BAA2B,CAAC;AAO9D;;;;GAIG;AACH,MAAM,OAAO,mBAAmB;IACnB,QAAQ,CAAsB;IAEvC,YAAY,EACR,WAAW,EACX,IAAI,EACJ,SAAS,GAAG,SAAS,GAKxB;QACG,IAAI,CAAC,QAAQ,GAAG,IAAI,mBAAmB,CAAC,SAAS,EAAE,EAAC,WAAW,EAAE,IAAI,EAAC,CAAC,CAAC;IAC5E,CAAC;IAED,IAAI,SAAS;QACT,OAAO,IAAI,CAAC,QAAQ,CAAC,EAAE,CAAC;IAC5B,CAAC;IAED,KAAK;QACD,IAAI,CAAC,QAAQ,CAAC,KAAK,EAAE,CAAC;IAC1B,CAAC;IAED,QAAQ,CAAC,KAAa;QAClB,IAAI,CAAC,QAAQ,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC;IAClC,CAAC;IAED,kBAAkB,CAAC,MAAW;QAC1B,IAAI,CAAC,QAAQ,CAAC,kBAAkB,CAAC,MAAM,CAAC,CAAC;IAC7C,CAAC;IAED,cAAc,CAAC,WAAgB;QAC1B,IAAI,CAAC,QAAgB,CAAC,cAAc,EAAE,CAAC,WAAW,CAAC,CAAC;IACzD,CAAC;IAED,WAAW,CAAC,QAAgB;QACxB,IAAI,CAAC,QAAQ,CAAC,WAAW,CAAC,QAAQ,CAAC,CAAC;IACxC,CAAC;IAED,gBAAgB,CAAC,QAAoB;QACjC,IAAI,CAAC,QAAQ,CAAC,gBAAgB,CAAC,QAAQ,CAAC,CAAC;IAC7C,CAAC;IAED,eAAe,CAAC,WAAmB;QAC/B,IAAI,CAAC,QAAQ,CAAC,eAAe,CAAC,WAAW,CAAC,CAAC;IAC/C,CAAC;IAED,KAAK;QACD,IAAI,CAAC,QAAQ,CAAC,KAAK,EAAE,CAAC;IAC1B,CAAC;IAED,WAAW,CAAC,GAAG,IAAoD;QAC/D,OAAO,IAAI,CAAC,QAAQ,CAAC,WAAW,CAAC,GAAG,IAAI,CAAC,CAAC;IAC9C,CAAC;IAED,sBAAsB,CAClB,GAAG,IAA+D;QAElE,OAAO,IAAI,CAAC,QAAQ,CAAC,sBAAsB,CAAC,GAAG,IAAI,CAAC,CAAC;IACzD,CAAC;CACJ"}

package/dist/services/conversation-service.test.js

@@ -0,0 +1,190 @@
+import test from 'ava';
+import { ConversationService } from '../../dist/services/conversation-service.js';
+class MockStream {
+  constructor(events) {
+    this.events = events;
+    this.completed = Promise.resolve();
+    this.lastResponseId = 'resp_test';
+    this.interruptions = [];
+    this.state = {};
+    this.newItems = [];
+    this.history = [];
+    this.finalOutput = '';
+  }
+  async *[Symbol.asyncIterator]() {
+    for (const event of this.events) {
+      yield event;
+    }
+  }
+}
+test('emits live text chunks for response.output_text.delta events', async t => {
+  t.plan(3);
+  const events = [{
+    type: 'response.output_text.delta',
+    delta: 'Hello'
+  }, {
+    type: 'response.output_text.delta',
+    delta: ' world'
+  }];
+  const mockClient = {
+    async startStream() {
+      return new MockStream(events);
+    }
+  };
+  const chunks = [];
+  const service = new ConversationService({
+    agentClient: mockClient
+  });
+  const result = await service.sendMessage('hi', {
+    onTextChunk(full, chunk) {
+      chunks.push({
+        full,
+        chunk
+      });
+    }
+  });
+  t.deepEqual(chunks, [{
+    full: 'Hello',
+    chunk: 'Hello'
+  }, {
+    full: 'Hello world',
+    chunk: ' world'
+  }]);
+  t.is(result.type, 'response');
+  t.is(result.finalText, 'Hello world');
+});
+test('passes previous response ids into subsequent runs', async t => {
+  const streams = [new MockStream([]), new MockStream([])];
+  streams[0].lastResponseId = 'resp-1';
+  streams[0].finalOutput = 'First run done.';
+  streams[1].lastResponseId = 'resp-2';
+  streams[1].finalOutput = 'Second run done.';
+  const startCalls = [];
+  const mockClient = {
+    async startStream(text, options) {
+      const index = startCalls.length;
+      startCalls.push({
+        text,
+        options
+      });
+      return streams[index];
+    }
+  };
+  const service = new ConversationService({
+    agentClient: mockClient
+  });
+  await service.sendMessage('first');
+  const secondResult = await service.sendMessage('second');
+  t.deepEqual(startCalls, [{
+    text: 'first',
+    options: {
+      previousResponseId: null
+    }
+  }, {
+    text: 'second',
+    options: {
+      previousResponseId: 'resp-1'
+    }
+  }]);
+  t.is(secondResult.type, 'response');
+  t.is(secondResult.finalText, 'Second run done.');
+});
+test('emits approval interruptions and resumes after approval', async t => {
+  const interruption = {
+    name: 'bash',
+    agent: {
+      name: 'CLI Agent'
+    },
+    arguments: JSON.stringify({
+      command: 'echo hi'
+    })
+  };
+  const initialStream = new MockStream([]);
+  initialStream.interruptions = [interruption];
+  initialStream.state = {
+    approveCalls: [],
+    rejectCalls: [],
+    approve(arg) {
+      this.approveCalls.push(arg);
+    },
+    reject(arg) {
+      this.rejectCalls.push(arg);
+    }
+  };
+  const continuationStream = new MockStream([{
+    type: 'response.output_text.delta',
+    delta: 'Approved run'
+  }]);
+  continuationStream.finalOutput = 'Approved run';
+  const mockClient = {
+    async startStream() {
+      return initialStream;
+    },
+    async continueRunStream(state) {
+      t.is(state, initialStream.state);
+      return continuationStream;
+    }
+  };
+  const service = new ConversationService({
+    agentClient: mockClient
+  });
+  const approvalResult = await service.sendMessage('run command');
+  t.is(approvalResult.type, 'approval_required');
+  t.is(approvalResult.approval.toolName, 'bash');
+  t.is(approvalResult.approval.argumentsText, 'echo hi');
+  const finalResult = await service.handleApprovalDecision('y');
+  t.truthy(finalResult);
+  t.is(finalResult.type, 'response');
+  t.is(finalResult.finalText, 'Approved run');
+  t.deepEqual(initialStream.state.approveCalls, [interruption]);
+  t.deepEqual(initialStream.state.rejectCalls, []);
+});
+test('dedupes command messages emitted live from run events', async t => {
+  const commandPayload = JSON.stringify({
+    command: 'ls',
+    stdout: 'file.txt',
+    success: true
+  });
+  const rawItem = {
+    id: 'call-123',
+    type: 'function_call_result',
+    name: 'bash',
+    arguments: JSON.stringify({
+      command: 'ls'
+    })
+  };
+  const commandItem = {
+    type: 'tool_call_output_item',
+    name: 'bash',
+    output: commandPayload,
+    rawItem
+  };
+  const events = [{
+    type: 'run_item_stream_event',
+    item: commandItem
+  }];
+  const stream = new MockStream(events);
+  stream.newItems = [commandItem];
+  const emitted = [];
+  const mockClient = {
+    async startStream() {
+      return stream;
+    }
+  };
+  const service = new ConversationService({
+    agentClient: mockClient
+  });
+  const result = await service.sendMessage('run bash', {
+    onCommandMessage(message) {
+      emitted.push(message);
+    }
+  });
+  t.deepEqual(emitted, [{
+    id: 'call-123',
+    sender: 'command',
+    command: 'ls',
+    output: 'file.txt',
+    success: true
+  }]);
+  t.deepEqual(result.commandMessages, []);
+});