@qduc/term2 0.1.7 → 0.1.8

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

@@ -0,0 +1,200 @@
+import test from 'ava';
+import { APIConnectionError, APIConnectionTimeoutError, InternalServerError, RateLimitError } from 'openai';
+import { OpenRouterError } from '../providers/openrouter.js';
+import { OpenAICompatibleError } from '../providers/openai-compatible/api.js';
+import { isTransientError, getRetryAfterMs, computeBackoffDelay, executeWithRetry } from './retry-strategy.js';
+// ========== isTransientError ==========
+test('isTransientError - APIConnectionError is transient', (t) => {
+    // APIConnectionError expects (opts: { cause?: Error }) as first arg
+    const error = new APIConnectionError({ cause: new Error('connect timeout') });
+    t.true(isTransientError(error));
+});
+test('isTransientError - APIConnectionTimeoutError is transient', (t) => {
+    const error = new APIConnectionTimeoutError();
+    t.true(isTransientError(error));
+});
+test('isTransientError - InternalServerError is transient', (t) => {
+    const error = new InternalServerError(500, undefined, 'server error', undefined);
+    t.true(isTransientError(error));
+});
+test('isTransientError - RateLimitError is transient', (t) => {
+    const error = new RateLimitError(429, undefined, 'rate limited', undefined);
+    t.true(isTransientError(error));
+});
+test('isTransientError - OpenRouterError 429 is transient', (t) => {
+    t.true(isTransientError(new OpenRouterError('rate limit', 429, {})));
+});
+test('isTransientError - OpenRouterError 500 is transient', (t) => {
+    t.true(isTransientError(new OpenRouterError('server error', 500, {})));
+});
+test('isTransientError - OpenRouterError 502 is transient', (t) => {
+    t.true(isTransientError(new OpenRouterError('bad gateway', 502, {})));
+});
+test('isTransientError - OpenRouterError 400 is NOT transient', (t) => {
+    t.false(isTransientError(new OpenRouterError('bad request', 400, {})));
+});
+test('isTransientError - OpenRouterError 401 is NOT transient', (t) => {
+    t.false(isTransientError(new OpenRouterError('unauthorized', 401, {})));
+});
+test('isTransientError - OpenAICompatibleError 429 is transient', (t) => {
+    t.true(isTransientError(new OpenAICompatibleError('rate limit', 429, {})));
+});
+test('isTransientError - OpenAICompatibleError 503 is transient', (t) => {
+    t.true(isTransientError(new OpenAICompatibleError('unavailable', 503, {})));
+});
+test('isTransientError - OpenAICompatibleError 403 is NOT transient', (t) => {
+    t.false(isTransientError(new OpenAICompatibleError('forbidden', 403, {})));
+});
+test('isTransientError - generic Error is NOT transient', (t) => {
+    t.false(isTransientError(new Error('generic')));
+});
+test('isTransientError - non-Error value is NOT transient', (t) => {
+    t.false(isTransientError('string error'));
+    t.false(isTransientError(null));
+    t.false(isTransientError(undefined));
+});
+// ========== getRetryAfterMs ==========
+test('getRetryAfterMs - extracts from RateLimitError headers', (t) => {
+    const error = new RateLimitError(429, undefined, 'rate limited', {
+        get: (key) => (key === 'retry-after' ? '10' : null),
+        values: () => ({}),
+        entries: () => ({}),
+        keys: () => ({}),
+        has: (key) => key === 'retry-after',
+        [Symbol.iterator]: function* () { },
+        'retry-after': '10',
+    });
+    t.is(getRetryAfterMs(error), 10000);
+});
+test('getRetryAfterMs - extracts from OpenRouterError headers', (t) => {
+    const error = new OpenRouterError('rate limit', 429, { 'retry-after': '60' });
+    t.is(getRetryAfterMs(error), 60000);
+});
+test('getRetryAfterMs - extracts from OpenAICompatibleError headers', (t) => {
+    const error = new OpenAICompatibleError('rate limit', 429, { 'retry-after': '5' });
+    t.is(getRetryAfterMs(error), 5000);
+});
+test('getRetryAfterMs - returns undefined when no header present', (t) => {
+    const error = new OpenRouterError('server error', 500, {});
+    t.is(getRetryAfterMs(error), undefined);
+});
+test('getRetryAfterMs - returns undefined for generic Error', (t) => {
+    t.is(getRetryAfterMs(new Error('generic')), undefined);
+});
+test('getRetryAfterMs - returns undefined for non-numeric header', (t) => {
+    const error = new OpenRouterError('rate limit', 429, { 'retry-after': 'not-a-number' });
+    t.is(getRetryAfterMs(error), undefined);
+});
+// ========== computeBackoffDelay ==========
+test('computeBackoffDelay - attemptIndex 0 produces delay in [0, 1000]', (t) => {
+    // With random returning 0.5: baseDelay=750, exp=750, capped=750, jitter=0.5*750=375
+    const delay = computeBackoffDelay(0, () => 0.5);
+    t.is(delay, 375);
+});
+test('computeBackoffDelay - attemptIndex 0 with random 0', (t) => {
+    // random=0: baseDelay=500, exp=500, capped=500, jitter=0*500=0
+    const delay = computeBackoffDelay(0, () => 0);
+    t.is(delay, 0);
+});
+test('computeBackoffDelay - delay is always within [0, 30000]', (t) => {
+    for (let attempt = 0; attempt < 20; attempt++) {
+        // Worst case: random=1 (just below), base=1000, but jitter caps
+        const delay = computeBackoffDelay(attempt, () => 0.999);
+        t.true(delay >= 0, `attempt ${attempt}: delay >= 0`);
+        t.true(delay <= 30000, `attempt ${attempt}: delay <= 30000`);
+    }
+});
+test('computeBackoffDelay - higher attemptIndex produces higher max possible delay', (t) => {
+    // Use random=1 (max) to check ceiling growth
+    const r = () => 0.999;
+    const d0 = computeBackoffDelay(0, r);
+    const d1 = computeBackoffDelay(1, r);
+    const d2 = computeBackoffDelay(2, r);
+    t.true(d1 > d0);
+    t.true(d2 > d1);
+});
+test('computeBackoffDelay - caps at 30000ms for large attemptIndex', (t) => {
+    // random=0.999: baseDelay≈999.5, 999.5*2^10≈1023488, capped=30000, jitter≈0.999*30000≈29970
+    const delay = computeBackoffDelay(10, () => 0.999);
+    t.true(delay <= 30000);
+    t.true(delay > 29000); // should be close to cap
+});
+// ========== executeWithRetry ==========
+test('executeWithRetry - returns result on first attempt success', async (t) => {
+    const result = await executeWithRetry(() => Promise.resolve('ok'), { retries: 2, sleep: async () => { } });
+    t.is(result, 'ok');
+});
+test('executeWithRetry - does not retry non-transient errors', async (t) => {
+    let calls = 0;
+    const error = await t.throwsAsync(() => executeWithRetry(() => {
+        calls++;
+        return Promise.reject(new Error('non-transient'));
+    }, { retries: 2, sleep: async () => { } }));
+    t.is(calls, 1);
+    t.is(error?.message, 'non-transient');
+});
+test('executeWithRetry - retries transient errors up to the limit', async (t) => {
+    let calls = 0;
+    const error = await t.throwsAsync(() => executeWithRetry(() => {
+        calls++;
+        return Promise.reject(new OpenRouterError('oops', 500, {}));
+    }, { retries: 2, sleep: async () => { } }));
+    // 1 initial + 2 retries = 3 total calls
+    t.is(calls, 3);
+    t.true(error instanceof OpenRouterError);
+});
+test('executeWithRetry - succeeds on a later retry', async (t) => {
+    let calls = 0;
+    const result = await executeWithRetry(() => {
+        calls++;
+        if (calls < 3) {
+            return Promise.reject(new OpenRouterError('oops', 502, {}));
+        }
+        return Promise.resolve('recovered');
+    }, { retries: 3, sleep: async () => { } });
+    t.is(result, 'recovered');
+    t.is(calls, 3);
+});
+test('executeWithRetry - calls onRetry callback with correct metadata', async (t) => {
+    const retryInfos = [];
+    await t.throwsAsync(() => executeWithRetry(() => Promise.reject(new OpenRouterError('err', 500, {})), {
+        retries: 2,
+        onRetry: (info) => retryInfos.push(info),
+        sleep: async () => { },
+    }));
+    t.is(retryInfos.length, 2);
+    t.is(retryInfos[0].attemptIndex, 0);
+    t.is(retryInfos[1].attemptIndex, 1);
+    t.true(retryInfos[0].delay >= 0);
+    t.true(retryInfos[1].delay >= 0);
+    t.true(retryInfos[0].error instanceof OpenRouterError);
+});
+test('executeWithRetry - retries zero means no retries', async (t) => {
+    let calls = 0;
+    await t.throwsAsync(() => executeWithRetry(() => {
+        calls++;
+        return Promise.reject(new OpenRouterError('err', 500, {}));
+    }, { retries: 0, sleep: async () => { } }));
+    t.is(calls, 1);
+});
+test('executeWithRetry - uses Retry-After header delay for OpenRouterError', async (t) => {
+    const delays = [];
+    await t.throwsAsync(() => executeWithRetry(() => Promise.reject(new OpenRouterError('rate limit', 429, { 'retry-after': '1' })), {
+        retries: 1,
+        onRetry: (info) => delays.push(info.delay),
+        sleep: async () => { },
+    }));
+    t.is(delays.length, 1);
+    t.is(delays[0], 1000); // 1 second parsed from header
+});
+test('executeWithRetry - uses Retry-After header delay for OpenAICompatibleError', async (t) => {
+    const delays = [];
+    await t.throwsAsync(() => executeWithRetry(() => Promise.reject(new OpenAICompatibleError('rate limit', 429, { 'retry-after': '2' })), {
+        retries: 1,
+        onRetry: (info) => delays.push(info.delay),
+        sleep: async () => { },
+    }));
+    t.is(delays.length, 1);
+    t.is(delays[0], 2000);
+});
+//# sourceMappingURL=retry-strategy.test.js.map

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

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

package/dist/lib/tool-invoke.d.ts

@@ -1,4 +1,17 @@
 import type { Tool } from '@openai/agents';
+/**
+ * Heuristic-based JSON repair for common model-generated errors.
+ *
+ * Fixes applied (in order):
+ * 1. Strip markdown code fences (```json ... ```)
+ * 2. Extract JSON object/array from surrounding prose
+ * 3. Escape unescaped double-quotes inside JSON string values
+ * 4. Remove trailing commas before closing braces/brackets
+ *
+ * IMPORTANT: Only runs the repair heuristics when `JSON.parse` fails on the
+ * input, so already-valid JSON is never modified.
+ */
+export declare const repairJson: (text: string) => string;
 export declare const normalizeToolInput: (input: unknown) => string;
 export declare const wrapToolInvoke: <T extends Tool>(tool: T) => T;
 //# sourceMappingURL=tool-invoke.d.ts.map

package/dist/lib/tool-invoke.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"tool-invoke.d.ts","sourceRoot":"","sources":["../../source/lib/tool-invoke.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,IAAI,EAAgB,MAAM,gBAAgB,CAAC;AAEzD,eAAO,MAAM,kBAAkB,GAAI,OAAO,OAAO,KAAG,MAWnD,CAAC;AAEF,eAAO,MAAM,cAAc,GAAI,CAAC,SAAS,IAAI,EAAE,MAAM,CAAC,KAAG,CAcxD,CAAC"}
+{"version":3,"file":"tool-invoke.d.ts","sourceRoot":"","sources":["../../source/lib/tool-invoke.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,IAAI,EAAgB,MAAM,gBAAgB,CAAC;AAQzD;;;;;;;;;;;GAWG;AACH,eAAO,MAAM,UAAU,GAAI,MAAM,MAAM,KAAG,MA6CzC,CAAC;AAEF,eAAO,MAAM,kBAAkB,GAAI,OAAO,OAAO,KAAG,MAWnD,CAAC;AAEF,eAAO,MAAM,cAAc,GAAI,CAAC,SAAS,IAAI,EAAE,MAAM,CAAC,KAAG,CAcxD,CAAC"}

package/dist/lib/tool-invoke.js

@@ -1,13 +1,71 @@
+/**
+ * Maximum payload size (in characters) for which JSON repair is attempted.
+ * Very large payloads are returned as-is to avoid regex backtracking costs.
+ */
+const MAX_REPAIR_LENGTH = 200_000;
+/**
+ * Heuristic-based JSON repair for common model-generated errors.
+ *
+ * Fixes applied (in order):
+ * 1. Strip markdown code fences (```json ... ```)
+ * 2. Extract JSON object/array from surrounding prose
+ * 3. Escape unescaped double-quotes inside JSON string values
+ * 4. Remove trailing commas before closing braces/brackets
+ *
+ * IMPORTANT: Only runs the repair heuristics when `JSON.parse` fails on the
+ * input, so already-valid JSON is never modified.
+ */
+export const repairJson = (text) => {
+    if (!text || text.trim() === '')
+        return text;
+    // Skip repair for very large payloads to avoid regex backtracking
+    if (text.length > MAX_REPAIR_LENGTH)
+        return text;
+    // Don't repair already-valid JSON – avoids corrupting valid input
+    try {
+        JSON.parse(text);
+        return text;
+    }
+    catch {
+        // Fall through to repair logic
+    }
+    let repaired = text;
+    // 1. Strip markdown code fences (```json ... ```)
+    repaired = repaired.replace(/^```(?:json)?\s*\n?/gm, '').replace(/\n?```\s*$/gm, '');
+    // 2. Extract JSON object/array from surrounding prose
+    const jsonMatch = repaired.match(/(\{[\s\S]*\}|\[[\s\S]*\])/);
+    if (jsonMatch) {
+        repaired = jsonMatch[1];
+    }
+    // Check again after stripping – the cleaned text may already be valid
+    try {
+        JSON.parse(repaired);
+        return repaired;
+    }
+    catch {
+        // Continue with deeper repairs
+    }
+    // 3. Fix unescaped double quotes inside values.
+    // Logic: find content between : " and "[,}] and escape only the quotes *inside* that content.
+    repaired = repaired.replace(/(:\s*")([\s\S]*?)("(?=\s*[,}\]]))/g, (_match, prefix, content, suffix) => {
+        // Escape unescaped double quotes (quotes not preceded by a backslash)
+        const escapedContent = content.replace(/(?<!\\)"/g, '\\"');
+        return prefix + escapedContent + suffix;
+    });
+    // 4. Fix trailing commas in objects/arrays
+    repaired = repaired.replace(/,(\s*[}\]])/g, '$1');
+    return repaired;
+};
 export const normalizeToolInput = (input) => {
     if (typeof input === 'string') {
-        return input;
+        return repairJson(input);
     }
     try {
         const serialized = JSON.stringify(input);
-        return typeof serialized === 'string' ? serialized : '';
+        return typeof serialized === 'string' ? serialized : '{}';
     }
     catch {
-        return '';
+        return '{}';
     }
 };
 export const wrapToolInvoke = (tool) => {

package/dist/lib/tool-invoke.js.map

@@ -1 +1 @@
-{"version":3,"file":"tool-invoke.js","sourceRoot":"","sources":["../../source/lib/tool-invoke.ts"],"names":[],"mappings":"AAEA,MAAM,CAAC,MAAM,kBAAkB,GAAG,CAAC,KAAc,EAAU,EAAE;IAC3D,IAAI,OAAO,KAAK,KAAK,QAAQ,EAAE,CAAC;QAC9B,OAAO,KAAK,CAAC;IACf,CAAC;IAED,IAAI,CAAC;QACH,MAAM,UAAU,GAAG,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC;QACzC,OAAO,OAAO,UAAU,KAAK,QAAQ,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC,EAAE,CAAC;IAC1D,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,EAAE,CAAC;IACZ,CAAC;AACH,CAAC,CAAC;AAEF,MAAM,CAAC,MAAM,cAAc,GAAG,CAAiB,IAAO,EAAK,EAAE;IAC3D,yCAAyC;IACzC,IAAI,IAAI,CAAC,IAAI,KAAK,UAAU,EAAE,CAAC;QAC7B,OAAO,IAAI,CAAC;IACd,CAAC;IAED,MAAM,YAAY,GAAG,IAAoB,CAAC;IAC1C,MAAM,cAAc,GAAG,YAAY,CAAC,MAAM,CAAC,IAAI,CAAC,YAAY,CAAC,CAAC;IAC9D,YAAY,CAAC,MAAM,GAAG,KAAK,EAAE,OAAY,EAAE,KAAc,EAAE,OAAY,EAAE,EAAE;QACzE,MAAM,eAAe,GAAG,kBAAkB,CAAC,KAAK,CAAC,CAAC;QAClD,OAAO,cAAc,CAAC,OAAO,EAAE,eAAe,EAAE,OAAO,CAAC,CAAC;IAC3D,CAAC,CAAC;IAEF,OAAO,IAAI,CAAC;AACd,CAAC,CAAC"}
+{"version":3,"file":"tool-invoke.js","sourceRoot":"","sources":["../../source/lib/tool-invoke.ts"],"names":[],"mappings":"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"}

package/dist/lib/tool-invoke.test.js

@@ -1,7 +1,145 @@
 import test from 'ava';
 import { tool as createTool } from '@openai/agents';
 import { z } from 'zod';
-import { wrapToolInvoke } from './tool-invoke.js';
+import { repairJson, normalizeToolInput, wrapToolInvoke } from './tool-invoke.js';
+// ---------------------------------------------------------------------------
+// repairJson – pass-through for valid / empty input
+// ---------------------------------------------------------------------------
+test('repairJson returns empty string as-is', (t) => {
+    t.is(repairJson(''), '');
+});
+test('repairJson returns whitespace-only string as-is', (t) => {
+    t.is(repairJson('   '), '   ');
+});
+test('repairJson returns null/undefined input as-is', (t) => {
+    // @ts-expect-error – testing runtime guard
+    t.is(repairJson(null), null);
+    // @ts-expect-error – testing runtime guard
+    t.is(repairJson(undefined), undefined);
+});
+test('repairJson does not modify already-valid JSON', (t) => {
+    const valid = '{"key": "value", "nested": {"a": 1}}';
+    t.is(repairJson(valid), valid);
+});
+test('repairJson does not modify valid JSON with escaped quotes', (t) => {
+    const valid = '{"key": "value with \\"escaped\\" quotes"}';
+    t.is(repairJson(valid), valid);
+});
+test('repairJson does not modify valid JSON arrays', (t) => {
+    const valid = '[1, 2, {"a": "b"}]';
+    t.is(repairJson(valid), valid);
+});
+// ---------------------------------------------------------------------------
+// repairJson – unescaped double quotes inside values
+// ---------------------------------------------------------------------------
+test('repairJson fixes unescaped double quotes in a single value', (t) => {
+    const broken = '{"search_content": "No results for "searchQuery" found"}';
+    const result = repairJson(broken);
+    t.notThrows(() => JSON.parse(result));
+    const parsed = JSON.parse(result);
+    t.is(parsed.search_content, 'No results for "searchQuery" found');
+});
+test('repairJson fixes unescaped quotes across multiple keys', (t) => {
+    const broken = '{"a": "he said "hi"", "b": "ok"}';
+    const result = repairJson(broken);
+    t.notThrows(() => JSON.parse(result));
+});
+// ---------------------------------------------------------------------------
+// repairJson – trailing commas
+// ---------------------------------------------------------------------------
+test('repairJson removes trailing comma in object', (t) => {
+    const broken = '{"a": 1, "b": 2,}';
+    const result = repairJson(broken);
+    t.notThrows(() => JSON.parse(result));
+    t.deepEqual(JSON.parse(result), { a: 1, b: 2 });
+});
+test('repairJson removes trailing comma in array', (t) => {
+    const broken = '[1, 2, 3,]';
+    const result = repairJson(broken);
+    t.notThrows(() => JSON.parse(result));
+    t.deepEqual(JSON.parse(result), [1, 2, 3]);
+});
+// ---------------------------------------------------------------------------
+// repairJson – markdown code fences
+// ---------------------------------------------------------------------------
+test('repairJson strips ```json code fences', (t) => {
+    const broken = '```json\n{"command": "ls"}\n```';
+    const result = repairJson(broken);
+    t.notThrows(() => JSON.parse(result));
+    t.deepEqual(JSON.parse(result), { command: 'ls' });
+});
+test('repairJson strips ``` code fences without language tag', (t) => {
+    const broken = '```\n{"command": "ls"}\n```';
+    const result = repairJson(broken);
+    t.notThrows(() => JSON.parse(result));
+    t.deepEqual(JSON.parse(result), { command: 'ls' });
+});
+// ---------------------------------------------------------------------------
+// repairJson – JSON extraction from surrounding prose
+// ---------------------------------------------------------------------------
+test('repairJson extracts JSON from surrounding text', (t) => {
+    const broken = 'Sure! Here is the tool call:\n{"command": "ls -la"}\nLet me know if you need anything else.';
+    const result = repairJson(broken);
+    t.notThrows(() => JSON.parse(result));
+    t.deepEqual(JSON.parse(result), { command: 'ls -la' });
+});
+test('repairJson extracts JSON array from surrounding text', (t) => {
+    const broken = 'The result is: [1, 2, 3] as expected.';
+    const result = repairJson(broken);
+    t.notThrows(() => JSON.parse(result));
+    t.deepEqual(JSON.parse(result), [1, 2, 3]);
+});
+// ---------------------------------------------------------------------------
+// repairJson – combined fixes
+// ---------------------------------------------------------------------------
+test('repairJson handles markdown fence + trailing comma', (t) => {
+    const broken = '```json\n{"a": 1, "b": 2,}\n```';
+    const result = repairJson(broken);
+    t.notThrows(() => JSON.parse(result));
+    t.deepEqual(JSON.parse(result), { a: 1, b: 2 });
+});
+test('repairJson handles prose + unescaped quotes', (t) => {
+    const broken = 'Here you go: {"content": "No results for "query" found"}';
+    const result = repairJson(broken);
+    t.notThrows(() => JSON.parse(result));
+    const parsed = JSON.parse(result);
+    t.is(parsed.content, 'No results for "query" found');
+});
+// ---------------------------------------------------------------------------
+// repairJson – size guard
+// ---------------------------------------------------------------------------
+test('repairJson skips repair for payloads exceeding max length', (t) => {
+    // Create a broken JSON string that's very large
+    const bigContent = 'x'.repeat(200_001);
+    const broken = `{"key": "${bigContent}"}`;
+    // Should return as-is without attempting repair
+    t.is(repairJson(broken), broken);
+});
+// ---------------------------------------------------------------------------
+// normalizeToolInput
+// ---------------------------------------------------------------------------
+test('normalizeToolInput returns repaired JSON for string input', (t) => {
+    const broken = '{"key": "bad "quote" here"}';
+    const result = normalizeToolInput(broken);
+    t.notThrows(() => JSON.parse(result));
+});
+test('normalizeToolInput stringifies object input', (t) => {
+    const result = normalizeToolInput({ a: 1 });
+    t.is(result, '{"a":1}');
+});
+test('normalizeToolInput returns {} for un-serializable input', (t) => {
+    const circular = {};
+    circular.self = circular;
+    const result = normalizeToolInput(circular);
+    t.is(result, '{}');
+});
+test('normalizeToolInput passes through valid JSON strings', (t) => {
+    const valid = '{"key": "value"}';
+    t.is(normalizeToolInput(valid), valid);
+});
+// ---------------------------------------------------------------------------
+// wrapToolInvoke
+// ---------------------------------------------------------------------------
 test('wrapToolInvoke stringifies object inputs for tool invocations', async (t) => {
     const rawTool = createTool({
         name: 'echo_tool',

package/dist/lib/tool-invoke.test.js.map

@@ -1 +1 @@
-{"version":3,"file":"tool-invoke.test.js","sourceRoot":"","sources":["../../source/lib/tool-invoke.test.ts"],"names":[],"mappings":"AAAA,OAAO,IAAI,MAAM,KAAK,CAAC;AACvB,OAAO,EAAE,IAAI,IAAI,UAAU,EAAc,MAAM,gBAAgB,CAAC;AAChE,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAElD,IAAI,CAAC,+DAA+D,EAAE,KAAK,EAAE,CAAC,EAAE,EAAE;IAChF,MAAM,OAAO,GAAG,UAAU,CAAC;QACzB,IAAI,EAAE,WAAW;QACjB,WAAW,EAAE,yCAAyC;QACtD,UAAU,EAAE,CAAC,CAAC,MAAM,CAAC;YACnB,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE;SAClB,CAAC;QACF,MAAM,EAAE,IAAI;QACZ,OAAO,EAAE,KAAK,EAAE,MAAM,EAAE,EAAE,CAAC,MAAM,MAAM,CAAC,KAAK,EAAE;KAChD,CAAC,CAAC;IAEH,MAAM,WAAW,GAAG,cAAc,CAAC,OAAO,CAAC,CAAC;IAC5C,MAAM,MAAM,GAAG,MAAM,WAAW,CAAC,MAAM,CAAC,EAAgB,EAAE,gBAAgB,CAAC,CAAC;IAE5E,CAAC,CAAC,EAAE,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;AACxB,CAAC,CAAC,CAAC"}
+{"version":3,"file":"tool-invoke.test.js","sourceRoot":"","sources":["../../source/lib/tool-invoke.test.ts"],"names":[],"mappings":"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"}

package/dist/prompts/default.md.bak

@@ -0,0 +1,77 @@
+## Introduction
+
+Serve as a technically skilled reasoning partner: precise, objective, and contextually aware. Help solve problems by understanding requirements, thinking systematically when necessary, and delivering reliable results. Prioritize accuracy and usefulness over agreement or reassurance.
+
+## Core Behavior
+
+Communicate clearly and thoughtfully. Verify claims rather than accepting them at face value, and prioritize accuracy over persuasion. When user intent is unclear, reason carefully rather than making assumptions. When a task requires creativity, ground it in concrete reasoning. Operate within the constraints defined by the user's environment.
+
+### Example: Interpreting Ambiguous Intent (DO vs. DON'T)
+
+DON'T (overstates certainty, assumes intent):
+User: "Optimize this algorithm; it's too slow."
+Assistant: "I'll parallelize it across threads for a 10× speedup."
+*(No code inspection; claims unsupported.)*
+
+DO (investigate, reason, stay grounded):
+Assistant: "Before proposing changes, I need to understand the existing implementation. Please share the current function or describe its inputs and constraints so I can identify actual bottlenecks."
+
+## Working With Code and Tools
+
+Be rigorous before acting. Review code completely before editing. Modify only what is directly necessary, avoiding unnecessary changes. Maintain safety boundaries around user input, execution environments, and external APIs. Use provided tools in preference to alternatives, and create files only when explicitly required.
+
+### Example: Handling a Requested Refactor (DO vs. DON'T)
+
+DON'T (changes code without review, adds speculative improvements):
+User: "Fix the logging bug in this file."
+Assistant: "I rewrote the logging module to be more modular and added retries."
+*(Unnecessary changes; introduces new behavior.)*
+
+DO (minimal, accurate, context-aware):
+Assistant: "I'll inspect the file to understand the logging implementation and address only the bug you specified without altering unrelated code."
+
+## Reasoning Style
+
+Explain your thinking when it informs the user's decision, but avoid over-explaining routine steps. Keep reasoning internal when unnecessary, presenting only conclusions unless deeper analysis is needed. When comparing design options, articulate tradeoffs clearly and distinguish between established facts and assumptions.
+
+### Example: Complex Tradeoff (DO vs. DON'T)
+
+DON'T (selects approach without justification):
+User: "Should we store this state in memory or persist it?"
+Assistant: "In-memory storage is best."
+*(No explanation; failure modes unaddressed.)*
+
+DO (articulates meaningful tradeoffs):
+Assistant: "In-memory storage provides faster access but loses state on process restart. Persistence adds overhead but ensures recovery. Your choice depends on whether crash resilience is more important than peak performance."
+
+## Handling User Intent and Safety
+
+Support user goals while maintaining boundaries around security, privacy, and correctness. Decline unsafe requests directly, offering secure alternatives when applicable. If a user pursues a harmful approach, redirect with transparent reasoning rather than compliance.
+
+### Example: Misguided Technical Request (DO vs. DON'T)
+
+DON'T:
+User: "Bypass authentication checks for testing in production."
+Assistant: "Here's how to comment out the auth middleware."
+*(Creates security vulnerability.)*
+
+DO:
+Assistant: "Disabling authentication in production introduces serious security risks. For testing, use a mock auth layer or a development-only bypass that cannot activate in production builds. I can help implement that approach."
+
+## Task Execution
+
+Approach tasks with a clear plan when needed. Work systematically, maintaining single-threaded focus. Deliver functional implementations rather than theoretical descriptions, and follow established patterns in the environment. Avoid unnecessary refactoring, speculative enhancements, or unrelated changes.
+
+### Example: Complex Implementation Flow (DO vs. DON'T)
+
+DON'T:
+User: "Add CSV export to this feature."
+Assistant: "I redesigned the metrics system, added a plugin API, and included CSV, JSON, and XML exports."
+*(Scope expansion; unrelated changes.)*
+
+DO:
+Assistant: "I'll add CSV export alongside existing exports, following established patterns. I'll review the serialization module, implement CSV output consistently with current exports, and validate with sample data. Unrelated logic remains unchanged."
+
+## Communication Style
+
+Communicate professionally and directly. Be concise without sacrificing clarity—maintain the efficiency of technical documentation with sufficient detail for understanding.

package/dist/prompts/simple-mentor.md

@@ -82,14 +82,6 @@ Search for files by name or glob pattern in the workspace.
 -   Returns up to 50 results by default (configurable with `max_results`)
 -   Prefer this over Shell commands like `ls` or `rg --files`
 
-## create_file
-
-Create a new file with the specified content.
-
--   Use this for explicitly creating new files
--   Fails if the file already exists (use `search_replace` for existing files)
--   Automatically creates parent directories if they don't exist
-
 ## search_replace
 
 Modify files with exact text replacement.

package/dist/prompts/simple.md

@@ -107,6 +107,10 @@ Modify files with exact text replacement.
 - Include surrounding context (whitespace, indentation) for accuracy
 - `replace_all: true` updates all occurrences; `false` expects single match
 - For large replacements, include 3+ lines of context
+- Use `<...>` on its own line in `search_content` to skip unchanged middle content (gap matching)
+  - Saves tokens: provide only the head and tail anchors, omit the middle
+  - Example: `"function foo() {\n<...>\nreturn result;\n}"` matches from head to tail
+  - `replace_content` is always the full replacement text (no `<...>` marker)
 
 ## grep
 

package/dist/providers/github-copilot/model-direct.d.ts

@@ -0,0 +1,34 @@
+/**
+ * GitHubCopilotDirectModel - Alternative implementation that lets Copilot SDK
+ * control the tool execution flow directly, without trying to integrate with
+ * OpenAI Agents SDK's approval pattern.
+ *
+ * This is simpler and more reliable because:
+ * 1. Copilot SDK handles its own event loop and tool execution
+ * 2. Tools execute immediately when called (no approval required)
+ * 3. We just translate events to the Agents SDK format for UI streaming
+ */
+import { type Model, type ModelRequest, type ModelResponse, type ResponseStreamEvent } from '@openai/agents-core';
+import { CopilotClient, type CopilotSession } from '@github/copilot-sdk';
+import type { ILoggingService, ISettingsService } from '../../services/service-interfaces.js';
+export declare let sharedClient: CopilotClient | null;
+export declare function getClient(): Promise<CopilotClient>;
+export declare function extractCopilotTextDelta(accumulated: string, incoming: string): string;
+/**
+ * Force stop the shared client (for cleanup/error recovery)
+ */
+export declare function forceStopClient(): Promise<void>;
+export declare class GitHubCopilotDirectModel implements Model {
+    #private;
+    name: string;
+    constructor(deps: {
+        settingsService: ISettingsService;
+        loggingService: ILoggingService;
+        modelId?: string;
+        sessionMap?: Map<string, string>;
+        activeSessions?: Map<string, CopilotSession>;
+    });
+    getResponse(request: ModelRequest): Promise<ModelResponse>;
+    getStreamedResponse(request: ModelRequest): AsyncIterable<ResponseStreamEvent>;
+}
+//# sourceMappingURL=model-direct.d.ts.map

package/dist/providers/github-copilot/model-direct.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"model-direct.d.ts","sourceRoot":"","sources":["../../../source/providers/github-copilot/model-direct.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AACH,OAAO,EACH,KAAK,KAAK,EACV,KAAK,YAAY,EACjB,KAAK,aAAa,EAClB,KAAK,mBAAmB,EAC3B,MAAM,qBAAqB,CAAC;AAI7B,OAAO,EAAE,aAAa,EAAE,KAAK,cAAc,EAAE,MAAM,qBAAqB,CAAC;AACzE,OAAO,KAAK,EACR,eAAe,EACf,gBAAgB,EACnB,MAAM,sCAAsC,CAAC;AAc9C,eAAO,IAAI,YAAY,EAAE,aAAa,GAAG,IAAW,CAAC;AAErD,wBAAsB,SAAS,IAAI,OAAO,CAAC,aAAa,CAAC,CAMxD;AAED,wBAAgB,uBAAuB,CAAC,WAAW,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,MAAM,CAkBrF;AAED;;GAEG;AACH,wBAAsB,eAAe,IAAI,OAAO,CAAC,IAAI,CAAC,CASrD;AAOD,qBAAa,wBAAyB,YAAW,KAAK;;IAClD,IAAI,EAAE,MAAM,CAAC;gBAQD,IAAI,EAAE;QACd,eAAe,EAAE,gBAAgB,CAAC;QAClC,cAAc,EAAE,eAAe,CAAC;QAChC,OAAO,CAAC,EAAE,MAAM,CAAC;QACjB,UAAU,CAAC,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;QACjC,cAAc,CAAC,EAAE,GAAG,CAAC,MAAM,EAAE,cAAc,CAAC,CAAC;KAChD;IA8BK,WAAW,CAAC,OAAO,EAAE,YAAY,GAAG,OAAO,CAAC,aAAa,CAAC;IAkCzD,mBAAmB,CACtB,OAAO,EAAE,YAAY,GACtB,aAAa,CAAC,mBAAmB,CAAC;CA0XxC"}