@7n/test 0.13.0 → 0.14.0

package/CHANGELOG.md

@@ -1,5 +1,15 @@
 # Changelog
 
+## [0.14.0] - 2026-07-11
+
+### Added
+
+- Ланцюжки (chains) @nitra/llm-lib ^1.1.0: mutant-classify — chain per mutant (tier1/tier2 = кроки, cache hit без chain), test-generate — chain per file (header + local/cloud спроби + vitest/length-retry = кроки), test-fix — chain per прогін (batch-виклики = кроки); адаптер callText/callAgent прокидає opts.chain. Аналітика ланцюжків — n-llm-chains-report і вкладка «Ланцюжки» в myllm.
+
+### Changed
+
+- підняти @7n/llm-lib до ^2.0.2 (rename @nitra/llm-lib → @7n/llm-lib уже застосовано в dacc051; нова мажорна версія без змін API — chains/компресія/body-capture, лише перейменування пакета)
+
 ## [0.13.0] - 2026-07-05
 
 ### Changed

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@7n/test",
-  "version": "0.13.0",
+  "version": "0.14.0",
   "description": "CLI-утиліта @7n/test",
   "keywords": [
     "7n",
@@ -41,7 +41,7 @@
   "dependencies": {
     "@earendil-works/pi-coding-agent": "^0.80.3",
     "@nitra/check-env": "^4.2.1",
-    "@nitra/llm-lib": "^1.0.0",
+    "@7n/llm-lib": "^2.0.2",
     "@vitest/coverage-v8": "^4.1.9",
     "rollup": "^4.62.2",
     "vitest": "^4.1.9",

package/src/coverage-classify/docs/index.md

@@ -3,7 +3,7 @@ type: JS Module
 title: index.mjs
 resource: npm/src/coverage-classify/index.mjs
 docgen:
-  crc: bc7320ff
+  crc: 6f120c02
   model: omlx/gemma-4-e4b-it-OptiQ-4bit
 ---
 

package/src/coverage-classify/index.mjs

@@ -10,7 +10,8 @@
 import { join } from 'node:path'
 
 import { callText } from '../lib/llm.mjs'
-import { CLOUD_MIN, LOCAL_MIN } from '@nitra/llm-lib/model-tiers'
+import { CLOUD_MIN, LOCAL_MIN } from '@7n/llm-lib/model-tiers'
+import { startChain } from '@7n/llm-lib/chain'
 import { deriveCacheKey, readCache, writeCache } from './cache.mjs'
 import { buildUserPrompt, SYSTEM_PROMPT } from './prompt.mjs'
 import { parseVerdict } from './verdict-schema.mjs'
@@ -26,52 +27,77 @@ const FALLBACK_VERDICT = {
  * @param {string} prompt
  * @param {string} model provider/model-id або '' для pi-дефолту
  * @param {string} cwd
+ * @param {{chain?: object}} [callOpts] chain handle поточного мутанта
  * @returns {Promise<string>}
  */
-function callModel(prompt, model, cwd) {
-  return callText(prompt, { cwd, ...(model && { model }) })
+function callModel(prompt, model, cwd, { chain } = {}) {
+  return callText(prompt, { cwd, chain, ...(model && { model }) })
 }
 
 /**
  * Два тири: tier1 (local-min) → tier2 (cloud-min) → FALLBACK_VERDICT.
+ * Кожен мутант — окремий ланцюжок (kind: mutant-classify): tier1 = крок 1,
+ * tier2 = крок 2; fallback-вердикт = outcome:'fail' (LLM не впорався).
  * @param {{file: string, mutants: object[]}} group
  * @param {object} mutant
  * @param {string} cwd
- * @param {(prompt: string, model: string, cwd: string) => Promise<string>} callModelFn
+ * @param {(prompt: string, model: string, cwd: string, callOpts?: {chain?: object}) => Promise<string>} callModelFn
  * @param {string} tier1 model-spec першого тиру ('' = pi-дефолт)
  * @param {string} tier2 model-spec другого тиру ('' = pi-дефолт)
+ * @param {typeof startChain} makeChain фабрика ланцюжка
  * @returns {Promise<object>} verdict
  */
-async function classifyOne(group, mutant, cwd, callModelFn, tier1, tier2) {
+async function classifyOne(group, mutant, cwd, callModelFn, tier1, tier2, makeChain) {
   const prompt = `${SYSTEM_PROMPT}\n\n${buildUserPrompt({ ...mutant, file: group.file }, cwd)}`
   const loc = `${group.file}:${mutant.line}:${mutant.col}`
+  const chain = makeChain({ kind: 'mutant-classify', unit: loc, cwd })
 
   try {
-    const text = await callModelFn(prompt, tier1, cwd)
-    return parseVerdict(text)
+    const text = await callModelFn(prompt, tier1, cwd, { chain })
+    const verdict = parseVerdict(text)
+    chain.end({ outcome: 'success', extra: verdictExtra(verdict, mutant) })
+    return verdict
   } catch {
     try {
-      const text = await callModelFn(prompt, tier2, cwd)
-      return parseVerdict(text)
+      const text = await callModelFn(prompt, tier2, cwd, { chain })
+      const verdict = parseVerdict(text)
+      chain.end({ outcome: 'success', extra: verdictExtra(verdict, mutant) })
+      return verdict
     } catch (error) {
       console.warn(`⚠ coverage classify: ${loc} both tiers failed: ${error.message}`)
+      chain.end({ outcome: 'fail', extra: { error: String(error.message ?? error).slice(0, 200) } })
       return { ...FALLBACK_VERDICT }
     }
   }
 }
 
+/**
+ * Extra-поля фінального chain-запису мутанта.
+ * @param {{verdict: string, confidence: number}} verdict розпарсений вердикт
+ * @param {{replacement?: string}} mutant мутант
+ * @returns {object} extra
+ */
+function verdictExtra(verdict, mutant) {
+  return {
+    verdict: verdict.verdict,
+    confidence: verdict.confidence,
+    replacement: String(mutant.replacement ?? '').slice(0, 120)
+  }
+}
+
 /**
  * Класифікує survived мутантів через pi (N_LOCAL_MIN_MODEL → N_CLOUD_MIN_MODEL → fallback).
  * @param {Array<{file: string, mutants: object[], exampleTest?: object|null, recommendationText?: string|null}>} survived
  * @param {string} cwd
- * @param {{cachePath?: string, callModel?: (prompt: string, model: string, cwd: string) => Promise<string>,
- *   tier1?: string, tier2?: string}} [opts] `tier1`/`tier2` — явні model-specs (дефолт: LOCAL_MIN/CLOUD_MIN пакета;
- *   інжектовні, бо тир-константи фіксуються при імпорті й у тестах не стабляться через env)
+ * @param {{cachePath?: string, callModel?: (prompt: string, model: string, cwd: string, callOpts?: {chain?: object}) => Promise<string>,
+ *   tier1?: string, tier2?: string, startChain?: typeof startChain}} [opts] `tier1`/`tier2` — явні model-specs (дефолт: LOCAL_MIN/CLOUD_MIN пакета;
+ *   інжектовні, бо тир-константи фіксуються при імпорті й у тестах не стабляться через env); `startChain` — фабрика ланцюжка (інжект для тестів)
  * @returns {Promise<Array<{key: string, verdict: object}>>}
  */
 export async function classify(survived, cwd, opts = {}) {
   const cachePath = opts.cachePath ?? join(cwd, 'npm/reports/coverage-classify.cache.json')
   const callModelFn = opts.callModel ?? callModel
+  const makeChain = opts.startChain ?? startChain
   const tier1 = opts.tier1 ?? LOCAL_MIN
   const tier2 = opts.tier2 ?? CLOUD_MIN
   const cacheModel = `${tier1 || 'default'}+${tier2 || 'cloud'}`
@@ -99,7 +125,7 @@ export async function classify(survived, cwd, opts = {}) {
         }
       }
       if (!verdict) {
-        verdict = await classifyOne(group, mutant, cwd, callModelFn, tier1, tier2)
+        verdict = await classifyOne(group, mutant, cwd, callModelFn, tier1, tier2, makeChain)
         if (cacheKey) {
           cache.entries[cacheKey] = { ...verdict, classifiedAt: new Date().toISOString() }
         }

package/src/coverage-fix.mjs

@@ -9,7 +9,7 @@
 import { readFile } from 'node:fs/promises'
 import { join } from 'node:path'
 import { env } from 'node:process'
-import { CLOUD_MAX } from '@nitra/llm-lib/model-tiers'
+import { CLOUD_MAX } from '@7n/llm-lib/model-tiers'
 import { callAgent } from './lib/llm.mjs'
 
 const MODEL = env.N_CURSOR_COVERAGE_FIX_MODEL ?? CLOUD_MAX
@@ -41,7 +41,7 @@ export async function fixSurvivedMutants(survived, projectRoot, opts = {}) {
 }
 
 /**
- * Викликає агента через @nitra/llm-lib (SDK-embed, live-output до stdout) —
+ * Викликає агента через `@7n/llm-lib` (SDK-embed, live-output до stdout) —
  * заміна колишнього spawnSync pi CLI.
  * @param {string} prompt текст промпта
  * @param {string} model  provider/model-id або '' для pi-дефолту

package/src/docs/assess-need.md

@@ -3,7 +3,7 @@ type: JS Module
 title: assess-need.mjs
 resource: npm/src/assess-need.mjs
 docgen:
-  crc: 960f8332
+  crc: 20c3d440
   model: omlx/gemma-4-e4b-it-OptiQ-4bit
 ---
 

package/src/docs/coverage-fix.md

@@ -3,7 +3,7 @@ type: JS Module
 title: coverage-fix.mjs
 resource: npm/src/coverage-fix.mjs
 docgen:
-  crc: d0a20c67
+  crc: db577cf1
   model: omlx/gemma-4-e4b-it-OptiQ-4bit
 ---
 

package/src/docs/fix-tests.md

@@ -3,7 +3,7 @@ type: JS Module
 title: fix-tests.mjs
 resource: npm/src/fix-tests.mjs
 docgen:
-  crc: 6597b7fc
+  crc: 713e7889
   model: omlx/gemma-4-e4b-it-OptiQ-4bit
 ---
 

package/src/docs/gen-tests.md

@@ -3,7 +3,7 @@ type: JS Module
 title: gen-tests.mjs
 resource: npm/src/gen-tests.mjs
 docgen:
-  crc: 99d3e9b7
+  crc: 0183f9b9
   model: omlx/gemma-4-e4b-it-OptiQ-4bit
 ---
 

package/src/fix-tests.mjs

@@ -20,8 +20,9 @@ import { tmpdir } from 'node:os'
 import { join, relative } from 'node:path'
 import { env } from 'node:process'
 import { callText, MEMORY_ERROR_RE } from './lib/llm.mjs'
-import { CLOUD_MAX } from '@nitra/llm-lib/model-tiers'
-import { budgetFor, capText, packBatch } from '@nitra/llm-lib/prompt-budget'
+import { CLOUD_MAX } from '@7n/llm-lib/model-tiers'
+import { startChain } from '@7n/llm-lib/chain'
+import { budgetFor, capText, packBatch } from '@7n/llm-lib/prompt-budget'
 import { findTestRules } from './gen-tests.mjs'
 import { parseFailingTests } from './coverage-per-file.mjs'
 import { resolveVitestRun } from './lib/vitest-shim.mjs'
@@ -322,17 +323,28 @@ function writeFixedFiles(fixed, remaining, dir) {
  * @param {string} dir project root
  * @param {{
  *   failures?: Array<{file: string, errors: string[]}>,
- *   callTextFn?: (prompt: string, opts?: object) => Promise<string>
- * }} [opts] overrides for callText and pre-fetched failures
+ *   callTextFn?: (prompt: string, opts?: object) => Promise<string>,
+ *   startChain?: typeof startChain
+ * }} [opts] overrides for callText, pre-fetched failures і фабрика ланцюжка (інжект для тестів)
  * @returns {Promise<{count: number, fixed: number, remaining: number}>} fix result summary
  */
 export async function fixFailingTests(dir, opts = {}) {
-  const callTextFn =
-    opts.callTextFn ?? (prompt => callText(prompt, { model: MODEL, cwd: dir, maxTokens: budgetFor('fix').maxTokens }))
   const failures = opts.failures ?? (await getFailingTests(dir))
 
   if (failures.length === 0) return { count: 0, fixed: 0, remaining: 0 }
 
+  // Один ланцюжок на прогін: батчі змішують файли, per-file chain неможливий
+  // без ламання батчингу; кожен batch-виклик = крок.
+  const chain = (opts.startChain ?? startChain)({
+    kind: 'test-fix',
+    unit: `fix:${failures.length}files`,
+    cwd: dir
+  })
+  let batches = 0
+  const callTextFn =
+    opts.callTextFn ??
+    (prompt => callText(prompt, { model: MODEL, cwd: dir, maxTokens: budgetFor('fix').maxTokens, chain }))
+
   console.log(`\n🔧 Виправляю ${failures.length} падаючих test-файлів (pi text mode)...\n`)
   for (const f of failures) {
     console.log(`  • ${f.file} (${f.errors.length} помилок)`)
@@ -342,50 +354,64 @@ export async function fixFailingTests(dir, opts = {}) {
   let remaining = failures
   const attempts = new Map()
   let prevDeferred = new Set()
-  for (;;) {
-    // Спроби рахуються per-file (лише коли файл реально був у батчі),
-    // тож deferred-черга не з'їдає ліміт файлів, які ще не пробували
-    const eligible = remaining
-      .filter(f => (attempts.get(f.file) ?? 0) < MAX_FIX_ATTEMPTS)
-      // Анти-starvation: відкладені минулого разу файли йдуть першими
-      .toSorted((a, b) => (prevDeferred.has(b.file) ? 1 : 0) - (prevDeferred.has(a.file) ? 1 : 0))
-    if (eligible.length === 0) break
-
-    const batch = buildFixTestsBatch(eligible, dir)
-    if (batch.deferred.length) {
-      console.log(
-        `  📦 батч: ${batch.included.length} файлів, відкладено на наступний прохід: ${batch.deferred.length}`
+  try {
+    for (;;) {
+      // Спроби рахуються per-file (лише коли файл реально був у батчі),
+      // тож deferred-черга не з'їдає ліміт файлів, які ще не пробували
+      const eligible = remaining
+        .filter(f => (attempts.get(f.file) ?? 0) < MAX_FIX_ATTEMPTS)
+        // Анти-starvation: відкладені минулого разу файли йдуть першими
+        .toSorted((a, b) => (prevDeferred.has(b.file) ? 1 : 0) - (prevDeferred.has(a.file) ? 1 : 0))
+      if (eligible.length === 0) break
+
+      const batch = buildFixTestsBatch(eligible, dir)
+      if (batch.deferred.length) {
+        console.log(
+          `  📦 батч: ${batch.included.length} файлів, відкладено на наступний прохід: ${batch.deferred.length}`
+        )
+      }
+      for (const file of batch.included) attempts.set(file, (attempts.get(file) ?? 0) + 1)
+      prevDeferred = new Set(batch.deferred)
+
+      let response
+      try {
+        batches++
+        response = await callTextFn(batch.prompt)
+      } catch (error) {
+        // memory-guard: не звичайна per-file помилка — RAM-стеля фіксована, продовжувати
+        // до наступного файлу немає сенсу. Пробиваємо нагору до CLI, аби процес завершився.
+        if (MEMORY_ERROR_RE.test(error.message ?? '')) throw error
+        console.error(`  ✗ pi помилка: ${error.message}`)
+        break
+      }
+
+      const fixed = parseFixedFiles(response)
+
+      if (fixed.length === 0) {
+        console.error('  ✗ pi не повернула виправлений код')
+        break
+      }
+
+      const includedSet = new Set(batch.included)
+      writeFixedFiles(
+        fixed,
+        eligible.filter(f => includedSet.has(f.file)),
+        dir
       )
-    }
-    for (const file of batch.included) attempts.set(file, (attempts.get(file) ?? 0) + 1)
-    prevDeferred = new Set(batch.deferred)
 
-    let response
-    try {
-      response = await callTextFn(batch.prompt)
-    } catch (error) {
-      // memory-guard: не звичайна per-file помилка — RAM-стеля фіксована, продовжувати
-      // до наступного файлу немає сенсу. Пробиваємо нагору до CLI, аби процес завершився.
-      if (MEMORY_ERROR_RE.test(error.message ?? '')) throw error
-      console.error(`  ✗ pi помилка: ${error.message}`)
-      break
+      remaining = await getFailingTests(dir)
     }
-
-    const fixed = parseFixedFiles(response)
-
-    if (fixed.length === 0) {
-      console.error('  ✗ pi не повернула виправлений код')
-      break
-    }
-
-    const includedSet = new Set(batch.included)
-    writeFixedFiles(
-      fixed,
-      eligible.filter(f => includedSet.has(f.file)),
-      dir
-    )
-
-    remaining = await getFailingTests(dir)
+  } finally {
+    const fixedSoFar = failures.length - remaining.length
+    chain.end({
+      outcome: remaining.length === 0 ? 'success' : fixedSoFar > 0 ? 'partial' : 'fail',
+      extra: {
+        files: failures.map(f => f.file),
+        batches,
+        fixed: fixedSoFar,
+        remaining: remaining.length
+      }
+    })
   }
 
   const fixedCount = failures.length - remaining.length

package/src/gen-tests.mjs

@@ -18,7 +18,8 @@ import { spawnSync } from 'node:child_process'
 import { join, relative, dirname } from 'node:path'
 import { callText, MEMORY_ERROR_RE } from './lib/llm.mjs'
 import { env } from 'node:process'
-import { budgetFor } from '@nitra/llm-lib/prompt-budget'
+import { budgetFor } from '@7n/llm-lib/prompt-budget'
+import { startChain } from '@7n/llm-lib/chain'
 import { resolveVitestRun } from './lib/vitest-shim.mjs'
 import { extractExportsWithComplexity } from './classify-exports.mjs'
 import { analyzeModule } from './lib/ast-analyze.mjs'
@@ -1149,9 +1150,10 @@ function resolveLocalModel(opts) {
  * @param {PiCallFn} callTextFn cloud LLM caller
  * @param {PiCallFn | null} localFn local LLM caller
  * @param {GenerateOneFn | undefined} generateOne custom single-file generator
+ * @param {typeof startChain} [makeChain] фабрика ланцюжка (інжект для тестів)
  * @returns {Promise<void>} resolves after generation for this file completes
  */
-async function generateTestsForFile(fileInfo, dir, callTextFn, localFn, generateOne) {
+async function generateTestsForFile(fileInfo, dir, callTextFn, localFn, generateOne, makeChain = startChain) {
   console.log(`  → ${fileInfo.file} (${fileInfo.pct.toFixed(1)}%)`)
 
   if (generateOne) {
@@ -1159,13 +1161,26 @@ async function generateTestsForFile(fileInfo, dir, callTextFn, localFn, generate
     return
   }
 
-  const exportsInfo = extractExportsWithComplexity(readSourceSnippet(join(dir, fileInfo.file)))
-  if (localFn && exportsInfo.length > 0) {
-    await generatePerExport(fileInfo, dir, callTextFn, localFn)
-    return
-  }
+  // Ланцюжок файлу: усі виклики (header, per-export local/cloud спроби,
+  // vitest-retry, length-retry) — кроки одного chain.
+  const chain = makeChain({ kind: 'test-generate', unit: fileInfo.file, cwd: dir })
+  const chainedCloud = (prompt, callOpts = {}) => callTextFn(prompt, { ...callOpts, chain })
+  const chainedLocal = localFn ? (prompt, callOpts = {}) => localFn(prompt, { ...callOpts, chain }) : null
+  let failed = null
+  try {
+    const exportsInfo = extractExportsWithComplexity(readSourceSnippet(join(dir, fileInfo.file)))
+    if (chainedLocal && exportsInfo.length > 0) {
+      await generatePerExport(fileInfo, dir, chainedCloud, chainedLocal)
+      return
+    }
 
-  await generateOneTest(fileInfo, dir, callTextFn)
+    await generateOneTest(fileInfo, dir, chainedCloud)
+  } catch (error) {
+    failed = String(error.message ?? error).slice(0, 200)
+    throw error
+  } finally {
+    chain.end({ outcome: failed ? 'fail' : 'success', extra: failed ? { error: failed } : {} })
+  }
 }
 
 /**

package/src/index.js

@@ -11,9 +11,22 @@ export async function run(args) {
     console.log('  Runs coverage analysis, generates missing tests, then mutation testing.')
     console.log('  --no-mutation  Skip mutation testing phase.')
     console.log('  Defaults to current directory when no argument is given.')
+    console.log('Usage: n coverage [--fix] [--changed]')
+    console.log('  Coverage + mutation testing only (no test generation) — writes COVERAGE.md.')
+    console.log('  --fix      Agent fixes survived mutants, then re-runs coverage.')
+    console.log('  --changed  Scope to files changed vs merge-base with main — no COVERAGE.md write.')
     return 0
   }
 
+  if (first === 'coverage') {
+    const { runCoverageCli } = await import('./coverage/coverage.mjs')
+    return runCoverageCli({
+      cwd: getCwd(),
+      fix: flags.includes('--fix'),
+      changed: flags.includes('--changed')
+    })
+  }
+
   const dir = first ? resolve(first) : getCwd()
   const noMutation = flags.includes('--no-mutation')
   const { runAutoTest } = await import('./run.mjs')

package/src/lib/docs/llm.md

@@ -3,12 +3,12 @@ type: JS Module
 title: llm.mjs
 resource: npm/src/lib/llm.mjs
 docgen:
-  crc: 41c6ec97
+  crc: b126a1aa
 ---
 
 ## Огляд
 
-Тонкий адаптер @7n/test над пакетом `@nitra/llm-lib` (Ф3 спеки llm-lib-extraction у репо cursor): зберігає звичний контракт `callText`/`callAgent` для внутрішніх колерів (gen-tests, fix-tests, assess-need, coverage-classify, coverage-fix), а транспорт, registry і трасування повністю живуть у пакеті. Замінив колишній `pi-client.mjs` з власним SDK-плюмбінгом, retry/backoff і прямим omlx-HTTP.
+Тонкий адаптер @7n/test над пакетом `@7n/llm-lib` (Ф3 спеки llm-lib-extraction у репо cursor): зберігає звичний контракт `callText`/`callAgent` для внутрішніх колерів (gen-tests, fix-tests, assess-need, coverage-classify, coverage-fix), а транспорт, registry і трасування повністю живуть у пакеті. Замінив колишній `pi-client.mjs` з власним SDK-плюмбінгом, retry/backoff і прямим omlx-HTTP.
 
 ## Поведінка
 

package/src/lib/llm.mjs

@@ -1,5 +1,5 @@
 /**
- * Тонкий адаптер @7n/test над @nitra/llm-lib (Ф3 спеки llm-lib-extraction):
+ * Тонкий адаптер `@7n/test` над `@7n/llm-lib` (Ф3 спеки llm-lib-extraction):
  * зберігає звичний контракт `callText`/`callAgent` для внутрішніх колерів,
  * але транспорт/registry/trace повністю живуть у пакеті.
  *
@@ -10,10 +10,10 @@
  * подвоєння `maxTokens` на обрізаній відповіді (`stopReason: 'length'`):
  * це семантичний повтор без пауз, а не очікування зайнятого сервера.
  */
-import { MEMORY_ERROR_RE, runOneShot } from '@nitra/llm-lib/one-shot'
-import { runAgentSkill } from '@nitra/llm-lib/agent-skill'
+import {  runOneShot } from '@7n/llm-lib/one-shot'
+import { runAgentSkill } from '@7n/llm-lib/agent-skill'
+
 
-export { MEMORY_ERROR_RE }
 
 /**
  * Стеля відповіді моделі для подвоєння на `stopReason: 'length'` — межа
@@ -33,6 +33,7 @@ const AGENT_TIMEOUT_MS = 900_000
  * @param {string} [opts.model] provider/model-id (напр. "openai/gpt-5.5"); без значення — default pi
  * @param {number} [opts.maxTokens] стеля відповіді для цього виклику; на
  *   `stopReason: 'length'` виклик повторюється один раз із подвоєною стелею
+ * @param {object} [opts.chain] chain handle (`@7n/llm-lib/chain`) — виклик стає кроком ланцюжка
  * @param {object} [opts.deps] інжекти для тестів (прокидаються у runOneShot)
  * @returns {Promise<string>} текстова відповідь моделі
  */
@@ -44,6 +45,7 @@ export async function callText(prompt, opts = {}) {
     timeoutMs: 0,
     cwd: opts.cwd,
     caller: '7n-test:text',
+    chain: opts.chain ?? null,
     deps: opts.deps
   })
   if (r.error) throw new Error(r.error)
@@ -66,6 +68,7 @@ export async function callText(prompt, opts = {}) {
  * @param {string} cwd робоча директорія, куди агент може писати файли
  * @param {object} [opts] додаткові параметри
  * @param {string} [opts.model] provider/model-id або '' для pi-дефолту
+ * @param {object} [opts.chain] chain handle (`@7n/llm-lib/chain`) — виклик стає кроком ланцюжка
  * @param {object} [opts.deps] інжекти для тестів (прокидаються у runAgentSkill)
  * @returns {Promise<void>} проміс завершується після виконання агента
  */
@@ -77,7 +80,10 @@ export async function callAgent(prompt, cwd, opts = {}) {
     timeoutMs: AGENT_TIMEOUT_MS,
     maxTokens: 0, // без стелі: агент пише цілі тест-файли (паритет зі старим CLI-шляхом)
     caller: 'agent:7n-test',
+    chain: opts.chain ?? null,
     deps: opts.deps
   })
   if (r.error) throw new Error(r.error)
 }
+
+export {MEMORY_ERROR_RE} from '@7n/llm-lib/one-shot'