@qduc/term2 0.1.7 → 0.1.8

package/dist/lib/mentor-client.test.js

@@ -0,0 +1,440 @@
+import test from 'ava';
+import { MentorClient } from './mentor-client.js';
+// ========== Mock Utilities ==========
+function createMockLogger() {
+    return {
+        debug: () => { },
+        info: () => { },
+        warn: () => { },
+        error: () => { },
+        security: () => { },
+        setCorrelationId: () => { },
+        clearCorrelationId: () => { },
+        getCorrelationId: () => undefined,
+        log: () => { },
+    };
+}
+function createMockSettings(values = {}) {
+    const store = {
+        'agent.provider': 'test-provider',
+        'agent.model': 'test-model',
+        'agent.mentorModel': 'mentor-model',
+        'agent.mentorProvider': 'test-mentor-provider',
+        'agent.mentorReasoningEffort': 'default',
+        'app.mentorMode': false,
+        ...values,
+    };
+    return {
+        get: (key) => store[key],
+        set: (key, value) => {
+            store[key] = value;
+        },
+    };
+}
+// ========== consult tests ==========
+test('consult throws when mentorModel is not configured', async (t) => {
+    const settings = createMockSettings({ 'agent.mentorModel': undefined });
+    const runAgent = async () => ({ finalOutput: 'hi' });
+    const createRunner = () => null;
+    const mentor = new MentorClient({
+        runAgent,
+        createRunner,
+        logger: createMockLogger(),
+        settings,
+    });
+    await t.throwsAsync(() => mentor.consult('hello'), {
+        message: 'Mentor model is not configured',
+    });
+});
+test('consult returns finalOutput from agent result', async (t) => {
+    const runAgent = async () => ({
+        finalOutput: 'mentor says hello',
+        history: [],
+        messages: [],
+    });
+    const createRunner = () => ({ run: async () => ({}) });
+    const mentor = new MentorClient({
+        runAgent,
+        createRunner,
+        logger: createMockLogger(),
+        settings: createMockSettings(),
+    });
+    const result = await mentor.consult('hello');
+    t.is(result, 'mentor says hello');
+});
+test('consult extracts response from messages when finalOutput is missing', async (t) => {
+    const runAgent = async () => ({
+        finalOutput: undefined,
+        history: [],
+        messages: [{ content: 'fallback response' }],
+    });
+    const createRunner = () => ({ run: async () => ({}) });
+    const mentor = new MentorClient({
+        runAgent,
+        createRunner,
+        logger: createMockLogger(),
+        settings: createMockSettings(),
+    });
+    const result = await mentor.consult('hello');
+    t.is(result, 'fallback response');
+});
+test('consult extracts response from array message content', async (t) => {
+    const runAgent = async () => ({
+        finalOutput: undefined,
+        history: [],
+        messages: [{ content: [{ text: 'part1' }, { text: 'part2' }] }],
+    });
+    const createRunner = () => ({ run: async () => ({}) });
+    const mentor = new MentorClient({
+        runAgent,
+        createRunner,
+        logger: createMockLogger(),
+        settings: createMockSettings(),
+    });
+    const result = await mentor.consult('hello');
+    t.is(result, 'part1part2');
+});
+test('consult returns empty string when no output available', async (t) => {
+    const runAgent = async () => ({
+        finalOutput: undefined,
+        history: [],
+        messages: [],
+    });
+    const createRunner = () => ({ run: async () => ({}) });
+    const mentor = new MentorClient({
+        runAgent,
+        createRunner,
+        logger: createMockLogger(),
+        settings: createMockSettings(),
+    });
+    const result = await mentor.consult('hello');
+    t.is(result, '');
+});
+test('consult passes correct provider and options to runAgent', async (t) => {
+    const calls = [];
+    const mockRunner = { run: async () => ({}) };
+    const runAgent = async (providerId, runner, _agent, input, options) => {
+        calls.push({ providerId, runner, input, options });
+        return { finalOutput: 'ok', history: [], messages: [] };
+    };
+    const createRunner = () => mockRunner;
+    const mentor = new MentorClient({
+        runAgent,
+        createRunner,
+        logger: createMockLogger(),
+        settings: createMockSettings({ 'agent.mentorProvider': 'custom-provider' }),
+    });
+    await mentor.consult('test question');
+    t.is(calls.length, 1);
+    t.is(calls[0].providerId, 'custom-provider');
+    t.is(calls[0].runner, mockRunner);
+    t.deepEqual(calls[0].options, { stream: false, maxTurns: 1 });
+    // Non-OpenAI providers get full history array
+    t.true(Array.isArray(calls[0].input));
+});
+test('consult uses main provider when mentorProvider is not set', async (t) => {
+    const calls = [];
+    const runAgent = async (providerId, _runner, _agent, _input, _options) => {
+        calls.push({ providerId });
+        return { finalOutput: 'ok', history: [], messages: [] };
+    };
+    const createRunner = () => ({ run: async () => ({}) });
+    const mentor = new MentorClient({
+        runAgent,
+        createRunner,
+        logger: createMockLogger(),
+        settings: createMockSettings({
+            'agent.provider': 'main-provider',
+            'agent.mentorProvider': undefined,
+        }),
+    });
+    await mentor.consult('test');
+    t.is(calls[0].providerId, 'main-provider');
+});
+test('consult builds conversation history across calls for non-OpenAI provider', async (t) => {
+    const inputs = [];
+    let counter = 0;
+    const runAgent = async (_providerId, _runner, _agent, input, _options) => {
+        inputs.push(input);
+        counter++;
+        return {
+            finalOutput: `response-${counter}`,
+            history: [],
+            messages: [],
+        };
+    };
+    const createRunner = () => ({ run: async () => ({}) });
+    const mentor = new MentorClient({
+        runAgent,
+        createRunner,
+        logger: createMockLogger(),
+        settings: createMockSettings({ 'agent.mentorProvider': 'custom' }),
+    });
+    await mentor.consult('question 1');
+    await mentor.consult('question 2');
+    t.is(inputs.length, 2);
+    // First call: single message in history
+    t.true(Array.isArray(inputs[0]));
+    t.is(inputs[0].length, 1);
+    // Second call: two messages in history (first question + second question)
+    t.true(Array.isArray(inputs[1]));
+    t.true(inputs[1].length > 1);
+});
+test('consult passes previousResponseId for OpenAI provider', async (t) => {
+    const calls = [];
+    const runAgent = async (providerId, _runner, _agent, input, options) => {
+        calls.push({ providerId, input, options });
+        return {
+            finalOutput: 'ok',
+            responseId: 'resp-123',
+            history: [],
+            messages: [],
+        };
+    };
+    const createRunner = () => null;
+    const mentor = new MentorClient({
+        runAgent,
+        createRunner,
+        logger: createMockLogger(),
+        settings: createMockSettings({ 'agent.mentorProvider': 'openai' }),
+    });
+    await mentor.consult('first');
+    await mentor.consult('second');
+    // First call should not have previousResponseId
+    t.deepEqual(calls[0].options, { stream: false, maxTurns: 1 });
+    // Second call should include it
+    t.is(calls[1].options.previousResponseId, 'resp-123');
+    // OpenAI provider passes string input, not array
+    t.is(typeof calls[1].input, 'string');
+});
+// ========== reset tests ==========
+test('reset clears conversation history', async (t) => {
+    const inputs = [];
+    const runAgent = async (_providerId, _runner, _agent, input, _options) => {
+        inputs.push(input);
+        return { finalOutput: 'ok', history: [], messages: [] };
+    };
+    const createRunner = () => ({ run: async () => ({}) });
+    const mentor = new MentorClient({
+        runAgent,
+        createRunner,
+        logger: createMockLogger(),
+        settings: createMockSettings({ 'agent.mentorProvider': 'custom' }),
+    });
+    await mentor.consult('question 1');
+    await mentor.consult('question 2');
+    t.true(inputs[1].length > 1); // history accumulated
+    mentor.reset();
+    await mentor.consult('question 3');
+    // After reset, history should be fresh (single message)
+    t.is(inputs[2].length, 1);
+});
+test('reset clears previousResponseId for OpenAI provider', async (t) => {
+    const calls = [];
+    const runAgent = async (_providerId, _runner, _agent, input, options) => {
+        calls.push({ input, options });
+        return {
+            finalOutput: 'ok',
+            responseId: 'resp-abc',
+            history: [],
+            messages: [],
+        };
+    };
+    const createRunner = () => null;
+    const mentor = new MentorClient({
+        runAgent,
+        createRunner,
+        logger: createMockLogger(),
+        settings: createMockSettings({ 'agent.mentorProvider': 'openai' }),
+    });
+    await mentor.consult('first');
+    t.falsy(calls[0].options.previousResponseId);
+    mentor.reset();
+    await mentor.consult('after reset');
+    // After reset, previousResponseId should be cleared
+    t.falsy(calls[1].options.previousResponseId);
+});
+test('reset can be called without prior consult', (t) => {
+    const mentor = new MentorClient({
+        runAgent: async () => ({}),
+        createRunner: () => null,
+        logger: createMockLogger(),
+        settings: createMockSettings(),
+    });
+    t.notThrows(() => mentor.reset());
+});
+// ========== provider switching tests ==========
+test('consult resets state when mentor provider changes', async (t) => {
+    const inputs = [];
+    const settings = createMockSettings({ 'agent.mentorProvider': 'provider-a' });
+    const runAgent = async (_providerId, _runner, _agent, input, _options) => {
+        inputs.push(input);
+        return { finalOutput: 'ok', history: [], messages: [] };
+    };
+    const createRunner = () => ({ run: async () => ({}) });
+    const mentor = new MentorClient({
+        runAgent,
+        createRunner,
+        logger: createMockLogger(),
+        settings,
+    });
+    await mentor.consult('q1');
+    await mentor.consult('q2');
+    t.true(inputs[1].length > 1); // accumulated history
+    // Switch provider
+    settings.set('agent.mentorProvider', 'provider-b');
+    await mentor.consult('q3');
+    // After provider switch, history should be fresh
+    t.is(inputs[2].length, 1);
+});
+test('consult creates new runner when provider changes', async (t) => {
+    const runnersCreated = [];
+    const settings = createMockSettings({ 'agent.mentorProvider': 'provider-a' });
+    const createRunner = (providerId) => {
+        runnersCreated.push(providerId);
+        return { run: async () => ({}) };
+    };
+    const runAgent = async () => ({
+        finalOutput: 'ok',
+        history: [],
+        messages: [],
+    });
+    const mentor = new MentorClient({
+        runAgent,
+        createRunner,
+        logger: createMockLogger(),
+        settings,
+    });
+    await mentor.consult('q1');
+    t.deepEqual(runnersCreated, ['provider-a']);
+    // Switch provider
+    settings.set('agent.mentorProvider', 'provider-b');
+    await mentor.consult('q2');
+    t.deepEqual(runnersCreated, ['provider-a', 'provider-b']);
+});
+// ========== error handling ==========
+test('consult propagates errors from runAgent', async (t) => {
+    const runAgent = async () => {
+        throw new Error('network failure');
+    };
+    const createRunner = () => ({ run: async () => ({}) });
+    const mentor = new MentorClient({
+        runAgent,
+        createRunner,
+        logger: createMockLogger(),
+        settings: createMockSettings(),
+    });
+    await t.throwsAsync(() => mentor.consult('hello'), {
+        message: 'network failure',
+    });
+});
+test('consult logs errors on failure', async (t) => {
+    const loggedErrors = [];
+    const logger = createMockLogger();
+    logger.error = (msg, meta) => {
+        loggedErrors.push({ msg, meta });
+    };
+    const runAgent = async () => {
+        throw new Error('boom');
+    };
+    const mentor = new MentorClient({
+        runAgent,
+        createRunner: () => ({ run: async () => ({}) }),
+        logger,
+        settings: createMockSettings(),
+    });
+    await t.throwsAsync(() => mentor.consult('test'));
+    t.is(loggedErrors.length, 1);
+    t.is(loggedErrors[0].msg, 'Mentor consultation failed');
+});
+// ========== reasoning effort ==========
+test('consult applies mentorReasoningEffort to agent model settings', async (t) => {
+    let capturedAgent = null;
+    const runAgent = async (_providerId, _runner, agent, _input, _options) => {
+        capturedAgent = agent;
+        return { finalOutput: 'ok', history: [], messages: [] };
+    };
+    const mentor = new MentorClient({
+        runAgent,
+        createRunner: () => ({ run: async () => ({}) }),
+        logger: createMockLogger(),
+        settings: createMockSettings({ 'agent.mentorReasoningEffort': 'high' }),
+    });
+    await mentor.consult('test');
+    t.truthy(capturedAgent);
+    // The agent should have reasoning effort in modelSettings
+    t.deepEqual(capturedAgent.modelSettings?.reasoning, { effort: 'high', summary: 'auto' });
+});
+test('consult does not set reasoning when effort is default', async (t) => {
+    let capturedAgent = null;
+    const runAgent = async (_providerId, _runner, agent, _input, _options) => {
+        capturedAgent = agent;
+        return { finalOutput: 'ok', history: [], messages: [] };
+    };
+    const mentor = new MentorClient({
+        runAgent,
+        createRunner: () => ({ run: async () => ({}) }),
+        logger: createMockLogger(),
+        settings: createMockSettings({ 'agent.mentorReasoningEffort': 'default' }),
+    });
+    await mentor.consult('test');
+    t.truthy(capturedAgent);
+    // Should not have reasoning in modelSettings
+    t.falsy(capturedAgent.modelSettings?.reasoning);
+});
+// ========== mentor mode instructions ==========
+test('consult uses mentor mode instructions when app.mentorMode is true', async (t) => {
+    let capturedAgent = null;
+    const runAgent = async (_providerId, _runner, agent, _input, _options) => {
+        capturedAgent = agent;
+        return { finalOutput: 'ok', history: [], messages: [] };
+    };
+    const mentor = new MentorClient({
+        runAgent,
+        createRunner: () => ({ run: async () => ({}) }),
+        logger: createMockLogger(),
+        settings: createMockSettings({ 'app.mentorMode': true }),
+    });
+    await mentor.consult('test');
+    t.truthy(capturedAgent);
+    t.true(capturedAgent.instructions.includes('senior architect'));
+    t.true(capturedAgent.instructions.includes('adversarial review'));
+});
+test('consult uses default mentor instructions when app.mentorMode is false', async (t) => {
+    let capturedAgent = null;
+    const runAgent = async (_providerId, _runner, agent, _input, _options) => {
+        capturedAgent = agent;
+        return { finalOutput: 'ok', history: [], messages: [] };
+    };
+    const mentor = new MentorClient({
+        runAgent,
+        createRunner: () => ({ run: async () => ({}) }),
+        logger: createMockLogger(),
+        settings: createMockSettings({ 'app.mentorMode': false }),
+    });
+    await mentor.consult('test');
+    t.truthy(capturedAgent);
+    t.true(capturedAgent.instructions.includes('helpful mentor assistant'));
+});
+// ========== skips runner creation for openai ==========
+test('consult does not create runner for openai provider', async (t) => {
+    const runnersCreated = [];
+    const createRunner = (providerId) => {
+        runnersCreated.push(providerId);
+        return { run: async () => ({}) };
+    };
+    const runAgent = async () => ({
+        finalOutput: 'ok',
+        history: [],
+        messages: [],
+    });
+    const mentor = new MentorClient({
+        runAgent,
+        createRunner,
+        logger: createMockLogger(),
+        settings: createMockSettings({ 'agent.mentorProvider': 'openai' }),
+    });
+    await mentor.consult('test');
+    t.deepEqual(runnersCreated, []);
+});
+//# sourceMappingURL=mentor-client.test.js.map

package/dist/lib/mentor-client.test.js.map

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

package/dist/lib/retry-strategy.d.ts

@@ -0,0 +1,43 @@
+/**
+ * Returns true when the error is transient and the request can be retried.
+ */
+export declare function isTransientError(error: unknown): boolean;
+/**
+ * Extracts the Retry-After header value (in ms) from a supported error type.
+ * Returns `undefined` when the header is absent.
+ */
+export declare function getRetryAfterMs(error: unknown): number | undefined;
+/**
+ * Computes an exponential-backoff delay with full jitter.
+ *
+ * Formula: random in [0, min(baseDelay * 2^attemptIndex, maxDelay)]
+ * where baseDelay ∈ [500, 1000) ms, maxDelay = 30 000 ms.
+ *
+ * @param attemptIndex  Zero-based retry attempt (0 = first retry).
+ * @param random        RNG returning [0, 1). Defaults to Math.random.
+ */
+export declare function computeBackoffDelay(attemptIndex: number, random?: () => number): number;
+export interface RetryOptions {
+    /** Maximum number of retries (default 2). */
+    retries: number;
+    /** RNG returning [0, 1). Defaults to Math.random. Primarily for deterministic tests. */
+    random?: () => number;
+    /** Sleep implementation. Defaults to setTimeout-based sleep. Primarily for tests. */
+    sleep?: (ms: number) => Promise<void>;
+    /**
+     * Called just before each retry sleep.
+     * Receives attempt metadata so callers can log / notify.
+     */
+    onRetry?: (info: {
+        attemptIndex: number;
+        delay: number;
+        error: unknown;
+    }) => void;
+}
+/**
+ * Runs `operation`, retrying on transient errors with exponential backoff + jitter.
+ *
+ * Mirrors the behaviour previously embedded in OpenAIAgentClient.#executeWithRetry.
+ */
+export declare function executeWithRetry<T>(operation: () => Promise<T>, opts: RetryOptions): Promise<T>;
+//# sourceMappingURL=retry-strategy.d.ts.map

package/dist/lib/retry-strategy.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"retry-strategy.d.ts","sourceRoot":"","sources":["../../source/lib/retry-strategy.ts"],"names":[],"mappings":"AAIA;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,OAAO,GAAG,OAAO,CAmBxD;AAED;;;GAGG;AACH,wBAAgB,eAAe,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,GAAG,SAAS,CAmBlE;AAED;;;;;;;;GAQG;AACH,wBAAgB,mBAAmB,CAAC,YAAY,EAAE,MAAM,EAAE,MAAM,GAAE,MAAM,MAAoB,GAAG,MAAM,CAOpG;AAED,MAAM,WAAW,YAAY;IAC3B,6CAA6C;IAC7C,OAAO,EAAE,MAAM,CAAC;IAChB,wFAAwF;IACxF,MAAM,CAAC,EAAE,MAAM,MAAM,CAAC;IACtB,qFAAqF;IACrF,KAAK,CAAC,EAAE,CAAC,EAAE,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IACtC;;;OAGG;IACH,OAAO,CAAC,EAAE,CAAC,IAAI,EAAE;QAAE,YAAY,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,OAAO,CAAA;KAAE,KAAK,IAAI,CAAC;CACnF;AAMD;;;;GAIG;AACH,wBAAsB,gBAAgB,CAAC,CAAC,EAAE,SAAS,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,YAAY,GAAG,OAAO,CAAC,CAAC,CAAC,CA0BrG"}

package/dist/lib/retry-strategy.js

@@ -0,0 +1,93 @@
+import { APIConnectionError, APIConnectionTimeoutError, InternalServerError, RateLimitError } from 'openai';
+import { OpenRouterError } from '../providers/openrouter.js';
+import { OpenAICompatibleError } from '../providers/openai-compatible/api.js';
+/**
+ * Returns true when the error is transient and the request can be retried.
+ */
+export function isTransientError(error) {
+    if (error instanceof APIConnectionError ||
+        error instanceof APIConnectionTimeoutError ||
+        error instanceof InternalServerError ||
+        error instanceof RateLimitError) {
+        return true;
+    }
+    if (error instanceof OpenRouterError && (error.status === 429 || error.status >= 500)) {
+        return true;
+    }
+    if (error instanceof OpenAICompatibleError && (error.status === 429 || error.status >= 500)) {
+        return true;
+    }
+    return false;
+}
+/**
+ * Extracts the Retry-After header value (in ms) from a supported error type.
+ * Returns `undefined` when the header is absent.
+ */
+export function getRetryAfterMs(error) {
+    let header;
+    if (error instanceof RateLimitError) {
+        header = error.headers?.['retry-after'] ?? undefined;
+    }
+    else if (error instanceof OpenRouterError) {
+        header = error.headers['retry-after'];
+    }
+    else if (error instanceof OpenAICompatibleError) {
+        header = error.headers['retry-after'];
+    }
+    if (header) {
+        const seconds = parseInt(header, 10);
+        if (!Number.isNaN(seconds)) {
+            return seconds * 1000;
+        }
+    }
+    return undefined;
+}
+/**
+ * Computes an exponential-backoff delay with full jitter.
+ *
+ * Formula: random in [0, min(baseDelay * 2^attemptIndex, maxDelay)]
+ * where baseDelay ∈ [500, 1000) ms, maxDelay = 30 000 ms.
+ *
+ * @param attemptIndex  Zero-based retry attempt (0 = first retry).
+ * @param random        RNG returning [0, 1). Defaults to Math.random.
+ */
+export function computeBackoffDelay(attemptIndex, random = Math.random) {
+    const baseDelay = 500 + random() * 500; // 500-1000ms
+    const exponentialDelay = baseDelay * Math.pow(2, attemptIndex);
+    const maxDelay = 30_000;
+    const cappedDelay = Math.min(exponentialDelay, maxDelay);
+    // Full jitter: random value between 0 and cappedDelay
+    return random() * cappedDelay;
+}
+function defaultSleep(ms) {
+    return new Promise((resolve) => setTimeout(resolve, ms));
+}
+/**
+ * Runs `operation`, retrying on transient errors with exponential backoff + jitter.
+ *
+ * Mirrors the behaviour previously embedded in OpenAIAgentClient.#executeWithRetry.
+ */
+export async function executeWithRetry(operation, opts) {
+    let retriesRemaining = opts.retries;
+    let attemptIndex = 0;
+    const sleep = opts.sleep ?? defaultSleep;
+    const random = opts.random ?? Math.random;
+    // eslint-disable-next-line no-constant-condition
+    while (true) {
+        try {
+            return await operation();
+        }
+        catch (error) {
+            if (retriesRemaining <= 0 || !isTransientError(error)) {
+                throw error;
+            }
+            const retryAfter = getRetryAfterMs(error);
+            const delay = retryAfter ?? computeBackoffDelay(attemptIndex, random);
+            opts.onRetry?.({ attemptIndex, delay, error });
+            await sleep(delay);
+            retriesRemaining--;
+            attemptIndex++;
+        }
+    }
+}
+//# sourceMappingURL=retry-strategy.js.map

package/dist/lib/retry-strategy.js.map

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

package/dist/lib/retry-strategy.test.d.ts

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

package/dist/lib/retry-strategy.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"retry-strategy.test.d.ts","sourceRoot":"","sources":["../../source/lib/retry-strategy.test.ts"],"names":[],"mappings":""}