@xopcai/xopc 0.0.119 → 0.0.121

package/dist/src/agent/memory/dreaming/utils.js

@@ -18,7 +18,7 @@ function buildEntryKey(parts) {
 	const a = Math.max(1, Math.floor(parts.startLine));
 	return `${p}#${a}-${Math.max(a, Math.floor(parts.endLine))}`;
 }
-/** YYYY-MM-DD in local time (for daily `memory/YYYY-MM-DD.md` names). */
+/** YYYY-MM-DD in local time. */
 function isoDay(d) {
 	return `${d.getFullYear()}-${String(d.getMonth() + 1).padStart(2, "0")}-${String(d.getDate()).padStart(2, "0")}`;
 }
@@ -71,7 +71,7 @@ function computeCandidateScore(entry, nowMs, recencyHalfLifeDays) {
 	const qCount = entry.queryHashes?.length ?? 0;
 	const uniqueQueryTerm = Math.min(1, qCount / 6) * DIVERSITY_WEIGHT;
 	const signalDiversity = [
-		entry.dailyCount,
+		entry.sourceCount,
 		entry.groundedCount,
 		entry.lightHits,
 		entry.remHits

package/dist/src/agent/memory/dreaming/utils.js.map

@@ -1 +1 @@
-{"version":3,"file":"utils.js","names":[],"sources":["../../../../../src/agent/memory/dreaming/utils.ts"],"sourcesContent":["import fs from 'node:fs/promises';\nimport path from 'node:path';\nimport { createHash } from 'node:crypto';\n\nimport type { DreamingDeepConfig } from './config.js';\nimport {\n  DEFAULT_DEEP_CRON,\n  DEFAULT_MAX_AGE_DAYS,\n  DEFAULT_RECENCY_HALF_LIFE_DAYS,\n  DIVERSITY_DIMENSION_COUNT,\n  DIVERSITY_WEIGHT,\n  MS_PER_DAY,\n  REINFORCEMENT_WEIGHT,\n} from './constants.js';\n// `DreamingStoreEntry` lives in `./short-term-store.js`, which imports value\n// helpers from THIS file — so importing it back creates a circular cycle.\n// `computeCandidateScore` only reads three numeric/string fields; declaring a\n// narrow structural type keeps the helper decoupled.\ntype DreamingStoreEntryScoringView = {\n  recallCount: number;\n  totalScore: number;\n  lastRecalledAt?: string;\n  queryHashes?: readonly string[];\n  dailyCount: number;\n  groundedCount: number;\n  lightHits: number;\n  remHits: number;\n};\n\n// ── Path + keying ─────────────────────────────────────────────────────\n\n/** Normalize a workspace-relative memory path: forward slashes, no odd ../ escapes at start. */\nexport function normalizeMemoryPath(rel: string): string {\n  if (typeof rel !== 'string' || !rel.trim()) return '';\n  const s = rel.trim().replace(/\\\\/g, '/');\n  return path.posix\n    .normalize(s)\n    .replace(/^(\\.\\/)+/, '')\n    .replace(/\\/+/g, '/');\n}\n\n/**\n * Stable id for a short-term store entry (path + line range).\n * Format: `{normalizedPath}#{start}-{end}` (1-based, inclusive end).\n */\nexport function buildEntryKey(parts: { path: string; startLine: number; endLine: number }): string {\n  const p = normalizeMemoryPath(parts.path);\n  const a = Math.max(1, Math.floor(parts.startLine));\n  const b = Math.max(a, Math.floor(parts.endLine));\n  return `${p}#${a}-${b}`;\n}\n\n/** YYYY-MM-DD in local time (for daily `memory/YYYY-MM-DD.md` names). */\nexport function isoDay(d: Date): string {\n  const y = d.getFullYear();\n  const m = String(d.getMonth() + 1).padStart(2, '0');\n  const day = String(d.getDate()).padStart(2, '0');\n  return `${y}-${m}-${day}`;\n}\n\n// ── Numbers + deep config defaults ────────────────────────────────────\n\nexport function clamp01(value: number): number {\n  if (!Number.isFinite(value)) return 0;\n  return Math.max(0, Math.min(1, value));\n}\n\nfunction toPositiveInt(value: unknown, fallback: number): number {\n  const num = typeof value === 'string' ? Number(value) : Number(value);\n  if (!Number.isFinite(num)) return fallback;\n  const floored = Math.floor(num);\n  return floored > 0 ? floored : fallback;\n}\n\nfunction toNonNegInt(value: unknown, fallback: number): number {\n  const num = typeof value === 'string' ? Number(value) : Number(value);\n  if (!Number.isFinite(num)) return fallback;\n  const floored = Math.floor(num);\n  return floored >= 0 ? floored : fallback;\n}\n\nfunction clampScore(value: number, fallback: number): number {\n  if (!Number.isFinite(value)) return fallback;\n  return Math.max(0, Math.min(1, value));\n}\n\nfunction trimmedCron(value: unknown, fallback: string): string {\n  return typeof value === 'string' && value.trim() ? value.trim() : fallback;\n}\n\n/** Fills in deep-phase defaults; mirrors `resolveDreamingConfig` deep object when only partial overrides are given. */\nexport function resolveDeepDefaults(overrides?: Partial<DreamingDeepConfig>): DreamingDeepConfig {\n  return {\n    enabled: overrides?.enabled !== false,\n    cron: trimmedCron(overrides?.cron, DEFAULT_DEEP_CRON),\n    minScore: clampScore(Number(overrides?.minScore), 0.8),\n    minRecallCount: toPositiveInt(overrides?.minRecallCount, 3),\n    minUniqueQueries: toPositiveInt(overrides?.minUniqueQueries, 3),\n    limit: toNonNegInt(overrides?.limit, 10),\n    recencyHalfLifeDays: toPositiveInt(overrides?.recencyHalfLifeDays, DEFAULT_RECENCY_HALF_LIFE_DAYS),\n    maxAgeDays: toPositiveInt(overrides?.maxAgeDays, DEFAULT_MAX_AGE_DAYS),\n  };\n}\n\n// ── Scoring (deep promotion) ─────────────────────────────────────────\n\nexport function computeCandidateScore(\n  entry: DreamingStoreEntryScoringView,\n  nowMs: number,\n  recencyHalfLifeDays: number,\n): { avgScore: number; score: number; recencyDecay: number } {\n  const recall = Math.max(0, entry.recallCount);\n  const avgRaw = recall > 0 ? entry.totalScore / recall : 0;\n  const avgScore = clamp01(avgRaw);\n\n  let recencyDecay = 1;\n  if (entry.lastRecalledAt) {\n    const last = Date.parse(entry.lastRecalledAt);\n    if (Number.isFinite(last)) {\n      const days = Math.max(0, (nowMs - last) / MS_PER_DAY);\n      const hl = Math.max(0.1, recencyHalfLifeDays);\n      recencyDecay = 0.5 ** (days / hl);\n    }\n  }\n\n  const logRecall = Math.log(1 + recall);\n  const reinforcement = REINFORCEMENT_WEIGHT * Math.min(logRecall, 3);\n\n  const qCount = entry.queryHashes?.length ?? 0;\n  const uniqueQueryTerm = Math.min(1, qCount / 6) * DIVERSITY_WEIGHT;\n\n  const dims = [entry.dailyCount, entry.groundedCount, entry.lightHits, entry.remHits].filter(\n    (n) => n > 0,\n  ).length;\n  const signalDiversity = ((dims / DIVERSITY_DIMENSION_COUNT) * DIVERSITY_WEIGHT) / 2;\n\n  const score = clamp01(avgScore * recencyDecay + reinforcement * 0.25 + uniqueQueryTerm + signalDiversity);\n\n  return { avgScore, score, recencyDecay };\n}\n\nexport function compareCandidatesByScore(\n  a: { score: number; key: string },\n  b: { score: number; key: string },\n): number {\n  if (b.score !== a.score) return b.score - a.score;\n  return a.key.localeCompare(b.key);\n}\n\n// ── File slices + integrity ─────────────────────────────────────────\n\nexport async function readFileLines(fullPath: string): Promise<string[] | null> {\n  try {\n    const raw = await fs.readFile(fullPath, 'utf-8');\n    return raw.split(/\\r?\\n/);\n  } catch (err) {\n    if ((err as NodeJS.ErrnoException | undefined)?.code === 'ENOENT') return null;\n    throw err;\n  }\n}\n\n/** 1-based inclusive line range. Joins with newlines. */\nexport function sliceRange(lines: string[], startLine: number, endLine: number): string {\n  const a = Math.max(1, Math.floor(startLine));\n  const b = Math.max(a, Math.floor(endLine));\n  const out = lines.slice(a - 1, b);\n  return out.join('\\n').trimEnd();\n}\n\nexport function isExpiredEntry(\n  lastRecalledAt: string | undefined,\n  nowMs: number,\n  maxAgeDays: number,\n): boolean {\n  if (!lastRecalledAt) return true;\n  const t = Date.parse(lastRecalledAt);\n  if (!Number.isFinite(t)) return true;\n  return (nowMs - t) / MS_PER_DAY > maxAgeDays;\n}\n\n/** Reject empty, tiny, or absurdly long snippets; blocks obvious “tool error” text. */\nexport function isContaminatedSnippet(snippet: string): boolean {\n  const s = snippet.trim();\n  if (s.length < 3) return true;\n  if (s.length > 12_000) return true;\n  if (!/\\p{L}/u.test(s) && !/\\d/.test(s)) return true;\n  return false;\n}\n\nexport function normalizeSnippetForHash(text: string): string {\n  return text\n    .toLowerCase()\n    .replace(/\\s+/g, ' ')\n    .replace(/['\"`]/g, '')\n    .trim();\n}\n\nexport function snippetHash(text: string): string {\n  const n = normalizeSnippetForHash(text);\n  return createHash('sha1').update(n, 'utf8').digest('hex').slice(0, 20);\n}\n\nexport function extractPromotionMarkers(markdown: string): { keys: Set<string>; hashes: Set<string> } {\n  const keys = new Set<string>();\n  const hashes = new Set<string>();\n  let m: RegExpExecArray | null;\n  const re = /<!--\\s*xopc-memory-promotion\\s+key=\"([^\"]*)\"\\s+hash=\"([^\"]*)\"\\s*-->/g;\n  while ((m = re.exec(markdown)) !== null) {\n    if (m[1]) keys.add(m[1]);\n    if (m[2]) hashes.add(m[2]);\n  }\n  return { keys, hashes };\n}\n"],"mappings":"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"}
+{"version":3,"file":"utils.js","names":[],"sources":["../../../../../src/agent/memory/dreaming/utils.ts"],"sourcesContent":["import fs from 'node:fs/promises';\nimport path from 'node:path';\nimport { createHash } from 'node:crypto';\n\nimport type { DreamingDeepConfig } from './config.js';\nimport {\n  DEFAULT_DEEP_CRON,\n  DEFAULT_MAX_AGE_DAYS,\n  DEFAULT_RECENCY_HALF_LIFE_DAYS,\n  DIVERSITY_DIMENSION_COUNT,\n  DIVERSITY_WEIGHT,\n  MS_PER_DAY,\n  REINFORCEMENT_WEIGHT,\n} from './constants.js';\n// `DreamingStoreEntry` lives in `./short-term-store.js`, which imports value\n// helpers from THIS file — so importing it back creates a circular cycle.\n// `computeCandidateScore` only reads three numeric/string fields; declaring a\n// narrow structural type keeps the helper decoupled.\ntype DreamingStoreEntryScoringView = {\n  recallCount: number;\n  totalScore: number;\n  lastRecalledAt?: string;\n  queryHashes?: readonly string[];\n  sourceCount: number;\n  groundedCount: number;\n  lightHits: number;\n  remHits: number;\n};\n\n// ── Path + keying ─────────────────────────────────────────────────────\n\n/** Normalize a workspace-relative memory path: forward slashes, no odd ../ escapes at start. */\nexport function normalizeMemoryPath(rel: string): string {\n  if (typeof rel !== 'string' || !rel.trim()) return '';\n  const s = rel.trim().replace(/\\\\/g, '/');\n  return path.posix\n    .normalize(s)\n    .replace(/^(\\.\\/)+/, '')\n    .replace(/\\/+/g, '/');\n}\n\n/**\n * Stable id for a short-term store entry (path + line range).\n * Format: `{normalizedPath}#{start}-{end}` (1-based, inclusive end).\n */\nexport function buildEntryKey(parts: { path: string; startLine: number; endLine: number }): string {\n  const p = normalizeMemoryPath(parts.path);\n  const a = Math.max(1, Math.floor(parts.startLine));\n  const b = Math.max(a, Math.floor(parts.endLine));\n  return `${p}#${a}-${b}`;\n}\n\n/** YYYY-MM-DD in local time. */\nexport function isoDay(d: Date): string {\n  const y = d.getFullYear();\n  const m = String(d.getMonth() + 1).padStart(2, '0');\n  const day = String(d.getDate()).padStart(2, '0');\n  return `${y}-${m}-${day}`;\n}\n\n// ── Numbers + deep config defaults ────────────────────────────────────\n\nexport function clamp01(value: number): number {\n  if (!Number.isFinite(value)) return 0;\n  return Math.max(0, Math.min(1, value));\n}\n\nfunction toPositiveInt(value: unknown, fallback: number): number {\n  const num = typeof value === 'string' ? Number(value) : Number(value);\n  if (!Number.isFinite(num)) return fallback;\n  const floored = Math.floor(num);\n  return floored > 0 ? floored : fallback;\n}\n\nfunction toNonNegInt(value: unknown, fallback: number): number {\n  const num = typeof value === 'string' ? Number(value) : Number(value);\n  if (!Number.isFinite(num)) return fallback;\n  const floored = Math.floor(num);\n  return floored >= 0 ? floored : fallback;\n}\n\nfunction clampScore(value: number, fallback: number): number {\n  if (!Number.isFinite(value)) return fallback;\n  return Math.max(0, Math.min(1, value));\n}\n\nfunction trimmedCron(value: unknown, fallback: string): string {\n  return typeof value === 'string' && value.trim() ? value.trim() : fallback;\n}\n\n/** Fills in deep-phase defaults; mirrors `resolveDreamingConfig` deep object when only partial overrides are given. */\nexport function resolveDeepDefaults(overrides?: Partial<DreamingDeepConfig>): DreamingDeepConfig {\n  return {\n    enabled: overrides?.enabled !== false,\n    cron: trimmedCron(overrides?.cron, DEFAULT_DEEP_CRON),\n    minScore: clampScore(Number(overrides?.minScore), 0.8),\n    minRecallCount: toPositiveInt(overrides?.minRecallCount, 3),\n    minUniqueQueries: toPositiveInt(overrides?.minUniqueQueries, 3),\n    limit: toNonNegInt(overrides?.limit, 10),\n    recencyHalfLifeDays: toPositiveInt(overrides?.recencyHalfLifeDays, DEFAULT_RECENCY_HALF_LIFE_DAYS),\n    maxAgeDays: toPositiveInt(overrides?.maxAgeDays, DEFAULT_MAX_AGE_DAYS),\n  };\n}\n\n// ── Scoring (deep promotion) ─────────────────────────────────────────\n\nexport function computeCandidateScore(\n  entry: DreamingStoreEntryScoringView,\n  nowMs: number,\n  recencyHalfLifeDays: number,\n): { avgScore: number; score: number; recencyDecay: number } {\n  const recall = Math.max(0, entry.recallCount);\n  const avgRaw = recall > 0 ? entry.totalScore / recall : 0;\n  const avgScore = clamp01(avgRaw);\n\n  let recencyDecay = 1;\n  if (entry.lastRecalledAt) {\n    const last = Date.parse(entry.lastRecalledAt);\n    if (Number.isFinite(last)) {\n      const days = Math.max(0, (nowMs - last) / MS_PER_DAY);\n      const hl = Math.max(0.1, recencyHalfLifeDays);\n      recencyDecay = 0.5 ** (days / hl);\n    }\n  }\n\n  const logRecall = Math.log(1 + recall);\n  const reinforcement = REINFORCEMENT_WEIGHT * Math.min(logRecall, 3);\n\n  const qCount = entry.queryHashes?.length ?? 0;\n  const uniqueQueryTerm = Math.min(1, qCount / 6) * DIVERSITY_WEIGHT;\n\n  const dims = [entry.sourceCount, entry.groundedCount, entry.lightHits, entry.remHits].filter(\n    (n) => n > 0,\n  ).length;\n  const signalDiversity = ((dims / DIVERSITY_DIMENSION_COUNT) * DIVERSITY_WEIGHT) / 2;\n\n  const score = clamp01(avgScore * recencyDecay + reinforcement * 0.25 + uniqueQueryTerm + signalDiversity);\n\n  return { avgScore, score, recencyDecay };\n}\n\nexport function compareCandidatesByScore(\n  a: { score: number; key: string },\n  b: { score: number; key: string },\n): number {\n  if (b.score !== a.score) return b.score - a.score;\n  return a.key.localeCompare(b.key);\n}\n\n// ── File slices + integrity ─────────────────────────────────────────\n\nexport async function readFileLines(fullPath: string): Promise<string[] | null> {\n  try {\n    const raw = await fs.readFile(fullPath, 'utf-8');\n    return raw.split(/\\r?\\n/);\n  } catch (err) {\n    if ((err as NodeJS.ErrnoException | undefined)?.code === 'ENOENT') return null;\n    throw err;\n  }\n}\n\n/** 1-based inclusive line range. Joins with newlines. */\nexport function sliceRange(lines: string[], startLine: number, endLine: number): string {\n  const a = Math.max(1, Math.floor(startLine));\n  const b = Math.max(a, Math.floor(endLine));\n  const out = lines.slice(a - 1, b);\n  return out.join('\\n').trimEnd();\n}\n\nexport function isExpiredEntry(\n  lastRecalledAt: string | undefined,\n  nowMs: number,\n  maxAgeDays: number,\n): boolean {\n  if (!lastRecalledAt) return true;\n  const t = Date.parse(lastRecalledAt);\n  if (!Number.isFinite(t)) return true;\n  return (nowMs - t) / MS_PER_DAY > maxAgeDays;\n}\n\n/** Reject empty, tiny, or absurdly long snippets; blocks obvious “tool error” text. */\nexport function isContaminatedSnippet(snippet: string): boolean {\n  const s = snippet.trim();\n  if (s.length < 3) return true;\n  if (s.length > 12_000) return true;\n  if (!/\\p{L}/u.test(s) && !/\\d/.test(s)) return true;\n  return false;\n}\n\nexport function normalizeSnippetForHash(text: string): string {\n  return text\n    .toLowerCase()\n    .replace(/\\s+/g, ' ')\n    .replace(/['\"`]/g, '')\n    .trim();\n}\n\nexport function snippetHash(text: string): string {\n  const n = normalizeSnippetForHash(text);\n  return createHash('sha1').update(n, 'utf8').digest('hex').slice(0, 20);\n}\n\nexport function extractPromotionMarkers(markdown: string): { keys: Set<string>; hashes: Set<string> } {\n  const keys = new Set<string>();\n  const hashes = new Set<string>();\n  let m: RegExpExecArray | null;\n  const re = /<!--\\s*xopc-memory-promotion\\s+key=\"([^\"]*)\"\\s+hash=\"([^\"]*)\"\\s*-->/g;\n  while ((m = re.exec(markdown)) !== null) {\n    if (m[1]) keys.add(m[1]);\n    if (m[2]) hashes.add(m[2]);\n  }\n  return { keys, hashes };\n}\n"],"mappings":";;;;;;AAgCA,SAAgB,oBAAoB,KAAqB;AACvD,KAAI,OAAO,QAAQ,YAAY,CAAC,IAAI,MAAM,CAAE,QAAO;CACnD,MAAM,IAAI,IAAI,MAAM,CAAC,QAAQ,OAAO,IAAI;AACxC,QAAO,KAAK,MACT,UAAU,EAAE,CACZ,QAAQ,YAAY,GAAG,CACvB,QAAQ,QAAQ,IAAI;;;;;;AAOzB,SAAgB,cAAc,OAAqE;CACjG,MAAM,IAAI,oBAAoB,MAAM,KAAK;CACzC,MAAM,IAAI,KAAK,IAAI,GAAG,KAAK,MAAM,MAAM,UAAU,CAAC;AAElD,QAAO,GAAG,EAAE,GAAG,EAAE,GADP,KAAK,IAAI,GAAG,KAAK,MAAM,MAAM,QAAQ,CAC1B;;;AAIvB,SAAgB,OAAO,GAAiB;AAItC,QAAO,GAHG,EAAE,aAGD,CAAC,GAFF,OAAO,EAAE,UAAU,GAAG,EAAE,CAAC,SAAS,GAAG,IAE/B,CAAC,GADL,OAAO,EAAE,SAAS,CAAC,CAAC,SAAS,GAAG,IACrB;;AAKzB,SAAgB,QAAQ,OAAuB;AAC7C,KAAI,CAAC,OAAO,SAAS,MAAM,CAAE,QAAO;AACpC,QAAO,KAAK,IAAI,GAAG,KAAK,IAAI,GAAG,MAAM,CAAC;;AAGxC,SAAS,cAAc,OAAgB,UAA0B;CAC/D,MAAM,MAAM,OAAO,UAAU,WAAW,OAAO,MAAM,GAAG,OAAO,MAAM;AACrE,KAAI,CAAC,OAAO,SAAS,IAAI,CAAE,QAAO;CAClC,MAAM,UAAU,KAAK,MAAM,IAAI;AAC/B,QAAO,UAAU,IAAI,UAAU;;AAGjC,SAAS,YAAY,OAAgB,UAA0B;CAC7D,MAAM,MAAM,OAAO,UAAU,WAAW,OAAO,MAAM,GAAG,OAAO,MAAM;AACrE,KAAI,CAAC,OAAO,SAAS,IAAI,CAAE,QAAO;CAClC,MAAM,UAAU,KAAK,MAAM,IAAI;AAC/B,QAAO,WAAW,IAAI,UAAU;;AAGlC,SAAS,WAAW,OAAe,UAA0B;AAC3D,KAAI,CAAC,OAAO,SAAS,MAAM,CAAE,QAAO;AACpC,QAAO,KAAK,IAAI,GAAG,KAAK,IAAI,GAAG,MAAM,CAAC;;AAGxC,SAAS,YAAY,OAAgB,UAA0B;AAC7D,QAAO,OAAO,UAAU,YAAY,MAAM,MAAM,GAAG,MAAM,MAAM,GAAG;;;AAIpE,SAAgB,oBAAoB,WAA6D;AAC/F,QAAO;EACL,SAAS,WAAW,YAAY;EAChC,MAAM,YAAY,WAAW,MAAM,kBAAkB;EACrD,UAAU,WAAW,OAAO,WAAW,SAAS,EAAE,GAAI;EACtD,gBAAgB,cAAc,WAAW,gBAAgB,EAAE;EAC3D,kBAAkB,cAAc,WAAW,kBAAkB,EAAE;EAC/D,OAAO,YAAY,WAAW,OAAO,GAAG;EACxC,qBAAqB,cAAc,WAAW,qBAAA,GAAoD;EAClG,YAAY,cAAc,WAAW,YAAA,GAAiC;EACvE;;AAKH,SAAgB,sBACd,OACA,OACA,qBAC2D;CAC3D,MAAM,SAAS,KAAK,IAAI,GAAG,MAAM,YAAY;CAE7C,MAAM,WAAW,QADF,SAAS,IAAI,MAAM,aAAa,SAAS,EACxB;CAEhC,IAAI,eAAe;AACnB,KAAI,MAAM,gBAAgB;EACxB,MAAM,OAAO,KAAK,MAAM,MAAM,eAAe;AAC7C,MAAI,OAAO,SAAS,KAAK,CAGvB,gBAAe,OAFF,KAAK,IAAI,IAAI,QAAQ,QAAQ,WAEf,GADhB,KAAK,IAAI,IAAK,oBACO;;CAIpC,MAAM,YAAY,KAAK,IAAI,IAAI,OAAO;CACtC,MAAM,gBAAgB,uBAAuB,KAAK,IAAI,WAAW,EAAE;CAEnE,MAAM,SAAS,MAAM,aAAa,UAAU;CAC5C,MAAM,kBAAkB,KAAK,IAAI,GAAG,SAAS,EAAE,GAAG;CAKlD,MAAM,kBAHO;EAAC,MAAM;EAAa,MAAM;EAAe,MAAM;EAAW,MAAM;EAAQ,CAAC,QACnF,MAAM,IAAI,EACZ,CAAC,SAAA,IAC4D,mBAAoB;AAIlF,QAAO;EAAE;EAAU,OAFL,QAAQ,WAAW,eAAe,gBAAgB,MAAO,kBAAkB,gBAEjE;EAAE;EAAc;;AAG1C,SAAgB,yBACd,GACA,GACQ;AACR,KAAI,EAAE,UAAU,EAAE,MAAO,QAAO,EAAE,QAAQ,EAAE;AAC5C,QAAO,EAAE,IAAI,cAAc,EAAE,IAAI;;AAKnC,eAAsB,cAAc,UAA4C;AAC9E,KAAI;AAEF,UAAO,MADW,GAAG,SAAS,UAAU,QAAQ,EACrC,MAAM,QAAQ;UAClB,KAAK;AACZ,MAAK,KAA2C,SAAS,SAAU,QAAO;AAC1E,QAAM;;;;AAKV,SAAgB,WAAW,OAAiB,WAAmB,SAAyB;CACtF,MAAM,IAAI,KAAK,IAAI,GAAG,KAAK,MAAM,UAAU,CAAC;CAC5C,MAAM,IAAI,KAAK,IAAI,GAAG,KAAK,MAAM,QAAQ,CAAC;AAE1C,QADY,MAAM,MAAM,IAAI,GAAG,EACrB,CAAC,KAAK,KAAK,CAAC,SAAS;;AAGjC,SAAgB,eACd,gBACA,OACA,YACS;AACT,KAAI,CAAC,eAAgB,QAAO;CAC5B,MAAM,IAAI,KAAK,MAAM,eAAe;AACpC,KAAI,CAAC,OAAO,SAAS,EAAE,CAAE,QAAO;AAChC,SAAQ,QAAQ,KAAK,aAAa;;;AAIpC,SAAgB,sBAAsB,SAA0B;CAC9D,MAAM,IAAI,QAAQ,MAAM;AACxB,KAAI,EAAE,SAAS,EAAG,QAAO;AACzB,KAAI,EAAE,SAAS,KAAQ,QAAO;AAC9B,KAAI,CAAC,SAAS,KAAK,EAAE,IAAI,CAAC,KAAK,KAAK,EAAE,CAAE,QAAO;AAC/C,QAAO;;AAGT,SAAgB,wBAAwB,MAAsB;AAC5D,QAAO,KACJ,aAAa,CACb,QAAQ,QAAQ,IAAI,CACpB,QAAQ,UAAU,GAAG,CACrB,MAAM;;AAGX,SAAgB,YAAY,MAAsB;CAChD,MAAM,IAAI,wBAAwB,KAAK;AACvC,QAAO,WAAW,OAAO,CAAC,OAAO,GAAG,OAAO,CAAC,OAAO,MAAM,CAAC,MAAM,GAAG,GAAG;;AAGxE,SAAgB,wBAAwB,UAA8D;CACpG,MAAM,uBAAO,IAAI,KAAa;CAC9B,MAAM,yBAAS,IAAI,KAAa;CAChC,IAAI;CACJ,MAAM,KAAK;AACX,SAAQ,IAAI,GAAG,KAAK,SAAS,MAAM,MAAM;AACvC,MAAI,EAAE,GAAI,MAAK,IAAI,EAAE,GAAG;AACxB,MAAI,EAAE,GAAI,QAAO,IAAI,EAAE,GAAG;;AAE5B,QAAO;EAAE;EAAM;EAAQ"}

package/dist/src/agent/memory/index.d.ts

@@ -12,5 +12,3 @@ export type { MemoryProvider, MemoryProviderInitOptions } from './provider.js';
 export { StubMemoryProvider } from './stub-memory-provider.js';
 export type { MemorySnapshot, MemoryStoreConfig } from './types.js';
 export { extractAgentUserPlainText } from './user-message-text.js';
-export { MemoryFlushService } from './memory-flush.js';
-export type { MemoryFlushConfig, MemoryFlushOptions, MemoryFlushResult } from './memory-flush.js';

package/dist/src/agent/memory/index.js

@@ -8,6 +8,5 @@ import { BuiltinMemoryProvider } from "./builtin-provider.js";
 import { MemoryManager } from "./manager.js";
 import { discoverMemoryPlugins } from "./plugin-discovery.js";
 import { createMemoryManagerFromConfig } from "./create-memory-manager.js";
-import { MemoryFlushService } from "./memory-flush.js";
 import { StubMemoryProvider } from "./stub-memory-provider.js";
-export { BuiltinMemoryProvider, BuiltinMemoryStore, MEMORY_ENTRY_DELIMITER, MemoryContextAssembler, MemoryFlushService, MemoryManager, StubMemoryProvider, buildMemoryContextBlock, createMemoryManagerFromConfig, discoverMemoryPlugins, extractAgentUserPlainText, injectPrefetchIntoUserMessage, isCuratedMemoryInPrompt, isMemorySubsystemEnabled, resolveBuiltinMemoryStoreConfig, sanitizeMemoryContextFenceEscapes, scanForThreats, shouldInjectMemoryPrefetchThisTurn, shouldRegisterCuratedMemoryTool };
+export { BuiltinMemoryProvider, BuiltinMemoryStore, MEMORY_ENTRY_DELIMITER, MemoryContextAssembler, MemoryManager, StubMemoryProvider, buildMemoryContextBlock, createMemoryManagerFromConfig, discoverMemoryPlugins, extractAgentUserPlainText, injectPrefetchIntoUserMessage, isCuratedMemoryInPrompt, isMemorySubsystemEnabled, resolveBuiltinMemoryStoreConfig, sanitizeMemoryContextFenceEscapes, scanForThreats, shouldInjectMemoryPrefetchThisTurn, shouldRegisterCuratedMemoryTool };

package/dist/src/agent/middleware/self-verify.d.ts

@@ -32,11 +32,13 @@ export declare class SelfVerifyMiddleware {
     private config;
     private turnCount;
     private verificationRequested;
+    private hasUnverifiedEdits;
     constructor(config?: Partial<SelfVerifyConfig>);
     /**
      * Record a file edit operation
      */
     recordEdit(filePath: string, operation: 'write' | 'edit' | 'shell'): void;
+    recordVerification(toolName: string, args?: unknown): void;
     /**
      * Get edit count for a specific file
      */
@@ -56,6 +58,7 @@ export declare class SelfVerifyMiddleware {
      * Reset all tracking (e.g., after successful task completion)
      */
     reset(): void;
+    consumePostEditReminder(): string;
     /**
      * Get context injection for system prompt
      * Adds verification guidance based on current state

package/dist/src/agent/middleware/self-verify.js

@@ -17,6 +17,7 @@ var SelfVerifyMiddleware = class {
 	config;
 	turnCount = 0;
 	verificationRequested = false;
+	hasUnverifiedEdits = false;
 	constructor(config = {}) {
 		this.config = {
 			...DEFAULT_CONFIG,
@@ -39,12 +40,22 @@ var SelfVerifyMiddleware = class {
 			lastEditTime: now,
 			operations: [operation]
 		});
+		this.hasUnverifiedEdits = true;
 		log.debug({
 			filePath,
 			editCount: this.getEditCount(filePath),
 			operation
 		}, "File edit recorded");
 	}
+	recordVerification(toolName, args) {
+		const name = toolName.toLowerCase();
+		if (name === "shell") {
+			const command = args && typeof args === "object" && typeof args.command === "string" ? args.command.toLowerCase() : "";
+			if (/\b(test|vitest|jest|mocha|ava|playwright|typecheck|tsc|build|lint)\b/.test(command)) this.hasUnverifiedEdits = false;
+			return;
+		}
+		if (name.includes("test") || name.includes("verify") || name.includes("lint")) this.hasUnverifiedEdits = false;
+	}
 	/**
 	* Get edit count for a specific file
 	*/
@@ -75,8 +86,15 @@ var SelfVerifyMiddleware = class {
 		this.fileEdits.clear();
 		this.turnCount = 0;
 		this.verificationRequested = false;
+		this.hasUnverifiedEdits = false;
 		log.debug("Self-verify middleware reset");
 	}
+	consumePostEditReminder() {
+		if (!this.config.enablePreCompletionCheck || !this.hasUnverifiedEdits) return "";
+		if (this.verificationRequested) return "";
+		this.verificationRequested = true;
+		return ["Coder check: source files changed. Before final response, inspect the diff and run the smallest meaningful verification; if you cannot, explain why and state the remaining risk."].join("\n");
+	}
 	/**
 	* Get context injection for system prompt
 	* Adds verification guidance based on current state

package/dist/src/agent/middleware/self-verify.js.map

@@ -1 +1 @@
-{"version":3,"file":"self-verify.js","names":[],"sources":["../../../../src/agent/middleware/self-verify.ts"],"sourcesContent":["/**\n * Self-Verification Middleware\n *\n * Implements the \"Build & Self-Verify\" pattern from harness engineering:\n * - Intercepts agent before completion to remind verification\n * - Tracks file edits to detect potential issues\n * - Injects verification reminders into context\n *\n * Inspired by: https://blog.langchain.com/improving-deep-agents-with-harness-engineering/\n */\n\nimport { createLogger } from '../../utils/logger.js';\n\nconst log = createLogger('SelfVerifyMiddleware');\n\nexport interface FileEditRecord {\n  path: string;\n  editCount: number;\n  lastEditTime: number;\n  operations: string[]; // 'write', 'edit', 'shell' (for build commands)\n}\n\nexport interface SelfVerifyConfig {\n  /** Max edits to same file before warning (default: 5) */\n  maxEditsPerFile: number;\n  /** Enable pre-completion verification check (default: true) */\n  enablePreCompletionCheck: boolean;\n  /** Min turns before triggering verification reminder (default: 3) */\n  minTurnsForVerification: number;\n  /** Reset counters on successful verification (default: true) */\n  resetOnVerification: boolean;\n}\n\nconst DEFAULT_CONFIG: SelfVerifyConfig = {\n  maxEditsPerFile: 5,\n  enablePreCompletionCheck: true,\n  minTurnsForVerification: 3,\n  resetOnVerification: true,\n};\n\n/**\n * Tracks file modifications and provides verification guidance\n */\nexport class SelfVerifyMiddleware {\n  private fileEdits: Map<string, FileEditRecord> = new Map();\n  private config: SelfVerifyConfig;\n  private turnCount = 0;\n  private verificationRequested = false;\n\n  constructor(config: Partial<SelfVerifyConfig> = {}) {\n    this.config = { ...DEFAULT_CONFIG, ...config };\n  }\n\n  /**\n   * Record a file edit operation\n   */\n  recordEdit(filePath: string, operation: 'write' | 'edit' | 'shell'): void {\n    const now = Date.now();\n    const existing = this.fileEdits.get(filePath);\n\n    if (existing) {\n      existing.editCount++;\n      existing.lastEditTime = now;\n      if (!existing.operations.includes(operation)) {\n        existing.operations.push(operation);\n      }\n    } else {\n      this.fileEdits.set(filePath, {\n        path: filePath,\n        editCount: 1,\n        lastEditTime: now,\n        operations: [operation],\n      });\n    }\n\n    log.debug({ filePath, editCount: this.getEditCount(filePath), operation }, 'File edit recorded');\n  }\n\n  /**\n   * Get edit count for a specific file\n   */\n  getEditCount(filePath: string): number {\n    return this.fileEdits.get(filePath)?.editCount || 0;\n  }\n\n  /**\n   * Check if any file has excessive edits (potential doom loop)\n   */\n  hasExcessiveEdits(): { file: string; count: number } | null {\n    for (const [path, record] of this.fileEdits.entries()) {\n      if (record.editCount >= this.config.maxEditsPerFile) {\n        return { file: path, count: record.editCount };\n      }\n    }\n    return null;\n  }\n\n  /**\n   * Increment turn counter\n   */\n  onTurnStart(): void {\n    this.turnCount++;\n    this.verificationRequested = false;\n  }\n\n  /**\n   * Reset all tracking (e.g., after successful task completion)\n   */\n  reset(): void {\n    this.fileEdits.clear();\n    this.turnCount = 0;\n    this.verificationRequested = false;\n    log.debug('Self-verify middleware reset');\n  }\n\n  /**\n   * Get context injection for system prompt\n   * Adds verification guidance based on current state\n   */\n  getContextInjection(): string {\n    const sections: string[] = [];\n\n    // Add workflow guidance\n    sections.push(this.buildWorkflowGuidance());\n\n    // Add excessive edit warning if needed\n    const excessive = this.hasExcessiveEdits();\n    if (excessive) {\n      sections.push(this.buildExcessiveEditWarning(excessive.file, excessive.count));\n    }\n\n    // Add pre-completion check reminder for long sessions\n    if (this.shouldPromptForVerification()) {\n      sections.push(this.buildPreCompletionReminder());\n    }\n\n    return sections.filter(Boolean).join('\\n\\n');\n  }\n\n  /**\n   * Check if we should inject verification reminder\n   */\n  private shouldPromptForVerification(): boolean {\n    if (!this.config.enablePreCompletionCheck) return false;\n    if (this.turnCount < this.config.minTurnsForVerification) return false;\n    if (this.verificationRequested) return false;\n    return true;\n  }\n\n  /**\n   * Mark verification as requested (to avoid spam)\n   */\n  markVerificationRequested(): void {\n    this.verificationRequested = true;\n  }\n\n  /**\n   * Build workflow guidance section\n   */\n  private buildWorkflowGuidance(): string {\n    return `## Problem Solving Workflow\n\nFollow this iterative process for all tasks:\n\n1. **Plan**: Understand the task, read relevant files, and create a plan\n2. **Build**: Implement your solution with verification in mind\n3. **Verify**: Test your work, run checks, compare against requirements\n4. **Fix**: If issues found, analyze and fix them\n\n**Important**: Before declaring a task complete:\n- Re-read the original requirements\n- Verify your solution meets ALL requirements\n- Run any available tests or validation\n- Check for edge cases\n\nDo not skip verification. Incomplete verification leads to incorrect solutions.`;\n  }\n\n  /**\n   * Build warning for excessive file edits (doom loop detection)\n   */\n  private buildExcessiveEditWarning(filePath: string, count: number): string {\n    return `⚠️ **Pattern Alert**: You have edited \"${filePath}\" ${count} times.\n\nThis may indicate:\n- You're fixing symptoms rather than root causes\n- The approach needs reconsideration\n- Requirements may be unclear\n\n**Recommendation**: \n- Step back and re-read the original task\n- Consider if there's a better approach\n- Verify you understand the requirements correctly`;\n  }\n\n  /**\n   * Build pre-completion verification reminder\n   */\n  private buildPreCompletionReminder(): string {\n    this.markVerificationRequested();\n    return `⏳ **Verification Check**: You've made ${this.turnCount} turns on this task.\n\nBefore completing:\n1. ✅ Verify your solution matches the original requirements\n2. ✅ Run tests or validation if available\n3. ✅ Check edge cases and error handling\n4. ✅ Review your changes one final time\n\nIf you're confident, proceed. If unsure, continue refining.`;\n  }\n\n  /**\n   * Get summary of file edits for debugging\n   */\n  getEditSummary(): { totalFiles: number; totalEdits: number; topFiles: Array<{ path: string; count: number }> } {\n    const entries = Array.from(this.fileEdits.entries());\n    const totalEdits = entries.reduce((sum, [, record]) => sum + record.editCount, 0);\n    const topFiles = entries\n      .sort((a, b) => b[1].editCount - a[1].editCount)\n      .slice(0, 5)\n      .map(([path, record]) => ({ path, count: record.editCount }));\n\n    return {\n      totalFiles: entries.length,\n      totalEdits,\n      topFiles,\n    };\n  }\n\n  /**\n   * Update configuration\n   */\n  setConfig(config: Partial<SelfVerifyConfig>): void {\n    this.config = { ...this.config, ...config };\n  }\n\n  /**\n   * Get current configuration\n   */\n  getConfig(): SelfVerifyConfig {\n    return { ...this.config };\n  }\n}\n"],"mappings":";;;aAWqD;AAErD,MAAM,MAAM,aAAa,uBAAuB;AAoBhD,MAAM,iBAAmC;CACvC,iBAAiB;CACjB,0BAA0B;CAC1B,yBAAyB;CACzB,qBAAqB;CACtB;;;;AAKD,IAAa,uBAAb,MAAkC;CAChC,4BAAiD,IAAI,KAAK;CAC1D;CACA,YAAoB;CACpB,wBAAgC;CAEhC,YAAY,SAAoC,EAAE,EAAE;AAClD,OAAK,SAAS;GAAE,GAAG;GAAgB,GAAG;GAAQ;;;;;CAMhD,WAAW,UAAkB,WAA6C;EACxE,MAAM,MAAM,KAAK,KAAK;EACtB,MAAM,WAAW,KAAK,UAAU,IAAI,SAAS;AAE7C,MAAI,UAAU;AACZ,YAAS;AACT,YAAS,eAAe;AACxB,OAAI,CAAC,SAAS,WAAW,SAAS,UAAU,CAC1C,UAAS,WAAW,KAAK,UAAU;QAGrC,MAAK,UAAU,IAAI,UAAU;GAC3B,MAAM;GACN,WAAW;GACX,cAAc;GACd,YAAY,CAAC,UAAU;GACxB,CAAC;AAGJ,MAAI,MAAM;GAAE;GAAU,WAAW,KAAK,aAAa,SAAS;GAAE;GAAW,EAAE,qBAAqB;;;;;CAMlG,aAAa,UAA0B;AACrC,SAAO,KAAK,UAAU,IAAI,SAAS,EAAE,aAAa;;;;;CAMpD,oBAA4D;AAC1D,OAAK,MAAM,CAAC,MAAM,WAAW,KAAK,UAAU,SAAS,CACnD,KAAI,OAAO,aAAa,KAAK,OAAO,gBAClC,QAAO;GAAE,MAAM;GAAM,OAAO,OAAO;GAAW;AAGlD,SAAO;;;;;CAMT,cAAoB;AAClB,OAAK;AACL,OAAK,wBAAwB;;;;;CAM/B,QAAc;AACZ,OAAK,UAAU,OAAO;AACtB,OAAK,YAAY;AACjB,OAAK,wBAAwB;AAC7B,MAAI,MAAM,+BAA+B;;;;;;CAO3C,sBAA8B;EAC5B,MAAM,WAAqB,EAAE;AAG7B,WAAS,KAAK,KAAK,uBAAuB,CAAC;EAG3C,MAAM,YAAY,KAAK,mBAAmB;AAC1C,MAAI,UACF,UAAS,KAAK,KAAK,0BAA0B,UAAU,MAAM,UAAU,MAAM,CAAC;AAIhF,MAAI,KAAK,6BAA6B,CACpC,UAAS,KAAK,KAAK,4BAA4B,CAAC;AAGlD,SAAO,SAAS,OAAO,QAAQ,CAAC,KAAK,OAAO;;;;;CAM9C,8BAA+C;AAC7C,MAAI,CAAC,KAAK,OAAO,yBAA0B,QAAO;AAClD,MAAI,KAAK,YAAY,KAAK,OAAO,wBAAyB,QAAO;AACjE,MAAI,KAAK,sBAAuB,QAAO;AACvC,SAAO;;;;;CAMT,4BAAkC;AAChC,OAAK,wBAAwB;;;;;CAM/B,wBAAwC;AACtC,SAAO;;;;;;;;;;;;;;;;;;;;CAqBT,0BAAkC,UAAkB,OAAuB;AACzE,SAAO,0CAA0C,SAAS,IAAI,MAAM;;;;;;;;;;;;;;;CAgBtE,6BAA6C;AAC3C,OAAK,2BAA2B;AAChC,SAAO,yCAAyC,KAAK,UAAU;;;;;;;;;;;;;CAcjE,iBAA+G;EAC7G,MAAM,UAAU,MAAM,KAAK,KAAK,UAAU,SAAS,CAAC;EACpD,MAAM,aAAa,QAAQ,QAAQ,KAAK,GAAG,YAAY,MAAM,OAAO,WAAW,EAAE;EACjF,MAAM,WAAW,QACd,MAAM,GAAG,MAAM,EAAE,GAAG,YAAY,EAAE,GAAG,UAAU,CAC/C,MAAM,GAAG,EAAE,CACX,KAAK,CAAC,MAAM,aAAa;GAAE;GAAM,OAAO,OAAO;GAAW,EAAE;AAE/D,SAAO;GACL,YAAY,QAAQ;GACpB;GACA;GACD;;;;;CAMH,UAAU,QAAyC;AACjD,OAAK,SAAS;GAAE,GAAG,KAAK;GAAQ,GAAG;GAAQ;;;;;CAM7C,YAA8B;AAC5B,SAAO,EAAE,GAAG,KAAK,QAAQ"}
+{"version":3,"file":"self-verify.js","names":[],"sources":["../../../../src/agent/middleware/self-verify.ts"],"sourcesContent":["/**\n * Self-Verification Middleware\n *\n * Implements the \"Build & Self-Verify\" pattern from harness engineering:\n * - Intercepts agent before completion to remind verification\n * - Tracks file edits to detect potential issues\n * - Injects verification reminders into context\n *\n * Inspired by: https://blog.langchain.com/improving-deep-agents-with-harness-engineering/\n */\n\nimport { createLogger } from '../../utils/logger.js';\n\nconst log = createLogger('SelfVerifyMiddleware');\n\nexport interface FileEditRecord {\n  path: string;\n  editCount: number;\n  lastEditTime: number;\n  operations: string[]; // 'write', 'edit', 'shell' (for build commands)\n}\n\nexport interface SelfVerifyConfig {\n  /** Max edits to same file before warning (default: 5) */\n  maxEditsPerFile: number;\n  /** Enable pre-completion verification check (default: true) */\n  enablePreCompletionCheck: boolean;\n  /** Min turns before triggering verification reminder (default: 3) */\n  minTurnsForVerification: number;\n  /** Reset counters on successful verification (default: true) */\n  resetOnVerification: boolean;\n}\n\nconst DEFAULT_CONFIG: SelfVerifyConfig = {\n  maxEditsPerFile: 5,\n  enablePreCompletionCheck: true,\n  minTurnsForVerification: 3,\n  resetOnVerification: true,\n};\n\n/**\n * Tracks file modifications and provides verification guidance\n */\nexport class SelfVerifyMiddleware {\n  private fileEdits: Map<string, FileEditRecord> = new Map();\n  private config: SelfVerifyConfig;\n  private turnCount = 0;\n  private verificationRequested = false;\n  private hasUnverifiedEdits = false;\n\n  constructor(config: Partial<SelfVerifyConfig> = {}) {\n    this.config = { ...DEFAULT_CONFIG, ...config };\n  }\n\n  /**\n   * Record a file edit operation\n   */\n  recordEdit(filePath: string, operation: 'write' | 'edit' | 'shell'): void {\n    const now = Date.now();\n    const existing = this.fileEdits.get(filePath);\n\n    if (existing) {\n      existing.editCount++;\n      existing.lastEditTime = now;\n      if (!existing.operations.includes(operation)) {\n        existing.operations.push(operation);\n      }\n    } else {\n      this.fileEdits.set(filePath, {\n        path: filePath,\n        editCount: 1,\n        lastEditTime: now,\n        operations: [operation],\n      });\n    }\n\n    this.hasUnverifiedEdits = true;\n    log.debug({ filePath, editCount: this.getEditCount(filePath), operation }, 'File edit recorded');\n  }\n\n  recordVerification(toolName: string, args?: unknown): void {\n    const name = toolName.toLowerCase();\n    if (name === 'shell') {\n      const command =\n        args && typeof args === 'object' && typeof (args as { command?: unknown }).command === 'string'\n          ? (args as { command: string }).command.toLowerCase()\n          : '';\n      if (/\\b(test|vitest|jest|mocha|ava|playwright|typecheck|tsc|build|lint)\\b/.test(command)) {\n        this.hasUnverifiedEdits = false;\n      }\n      return;\n    }\n    if (name.includes('test') || name.includes('verify') || name.includes('lint')) {\n      this.hasUnverifiedEdits = false;\n    }\n  }\n\n  /**\n   * Get edit count for a specific file\n   */\n  getEditCount(filePath: string): number {\n    return this.fileEdits.get(filePath)?.editCount || 0;\n  }\n\n  /**\n   * Check if any file has excessive edits (potential doom loop)\n   */\n  hasExcessiveEdits(): { file: string; count: number } | null {\n    for (const [path, record] of this.fileEdits.entries()) {\n      if (record.editCount >= this.config.maxEditsPerFile) {\n        return { file: path, count: record.editCount };\n      }\n    }\n    return null;\n  }\n\n  /**\n   * Increment turn counter\n   */\n  onTurnStart(): void {\n    this.turnCount++;\n    this.verificationRequested = false;\n  }\n\n  /**\n   * Reset all tracking (e.g., after successful task completion)\n   */\n  reset(): void {\n    this.fileEdits.clear();\n    this.turnCount = 0;\n    this.verificationRequested = false;\n    this.hasUnverifiedEdits = false;\n    log.debug('Self-verify middleware reset');\n  }\n\n  consumePostEditReminder(): string {\n    if (!this.config.enablePreCompletionCheck || !this.hasUnverifiedEdits) {\n      return '';\n    }\n    if (this.verificationRequested) {\n      return '';\n    }\n    this.verificationRequested = true;\n    return [\n      'Coder check: source files changed. Before final response, inspect the diff and run the smallest meaningful verification; if you cannot, explain why and state the remaining risk.',\n    ].join('\\n');\n  }\n\n  /**\n   * Get context injection for system prompt\n   * Adds verification guidance based on current state\n   */\n  getContextInjection(): string {\n    const sections: string[] = [];\n\n    // Add workflow guidance\n    sections.push(this.buildWorkflowGuidance());\n\n    // Add excessive edit warning if needed\n    const excessive = this.hasExcessiveEdits();\n    if (excessive) {\n      sections.push(this.buildExcessiveEditWarning(excessive.file, excessive.count));\n    }\n\n    // Add pre-completion check reminder for long sessions\n    if (this.shouldPromptForVerification()) {\n      sections.push(this.buildPreCompletionReminder());\n    }\n\n    return sections.filter(Boolean).join('\\n\\n');\n  }\n\n  /**\n   * Check if we should inject verification reminder\n   */\n  private shouldPromptForVerification(): boolean {\n    if (!this.config.enablePreCompletionCheck) return false;\n    if (this.turnCount < this.config.minTurnsForVerification) return false;\n    if (this.verificationRequested) return false;\n    return true;\n  }\n\n  /**\n   * Mark verification as requested (to avoid spam)\n   */\n  markVerificationRequested(): void {\n    this.verificationRequested = true;\n  }\n\n  /**\n   * Build workflow guidance section\n   */\n  private buildWorkflowGuidance(): string {\n    return `## Problem Solving Workflow\n\nFollow this iterative process for all tasks:\n\n1. **Plan**: Understand the task, read relevant files, and create a plan\n2. **Build**: Implement your solution with verification in mind\n3. **Verify**: Test your work, run checks, compare against requirements\n4. **Fix**: If issues found, analyze and fix them\n\n**Important**: Before declaring a task complete:\n- Re-read the original requirements\n- Verify your solution meets ALL requirements\n- Run any available tests or validation\n- Check for edge cases\n\nDo not skip verification. Incomplete verification leads to incorrect solutions.`;\n  }\n\n  /**\n   * Build warning for excessive file edits (doom loop detection)\n   */\n  private buildExcessiveEditWarning(filePath: string, count: number): string {\n    return `⚠️ **Pattern Alert**: You have edited \"${filePath}\" ${count} times.\n\nThis may indicate:\n- You're fixing symptoms rather than root causes\n- The approach needs reconsideration\n- Requirements may be unclear\n\n**Recommendation**: \n- Step back and re-read the original task\n- Consider if there's a better approach\n- Verify you understand the requirements correctly`;\n  }\n\n  /**\n   * Build pre-completion verification reminder\n   */\n  private buildPreCompletionReminder(): string {\n    this.markVerificationRequested();\n    return `⏳ **Verification Check**: You've made ${this.turnCount} turns on this task.\n\nBefore completing:\n1. ✅ Verify your solution matches the original requirements\n2. ✅ Run tests or validation if available\n3. ✅ Check edge cases and error handling\n4. ✅ Review your changes one final time\n\nIf you're confident, proceed. If unsure, continue refining.`;\n  }\n\n  /**\n   * Get summary of file edits for debugging\n   */\n  getEditSummary(): { totalFiles: number; totalEdits: number; topFiles: Array<{ path: string; count: number }> } {\n    const entries = Array.from(this.fileEdits.entries());\n    const totalEdits = entries.reduce((sum, [, record]) => sum + record.editCount, 0);\n    const topFiles = entries\n      .sort((a, b) => b[1].editCount - a[1].editCount)\n      .slice(0, 5)\n      .map(([path, record]) => ({ path, count: record.editCount }));\n\n    return {\n      totalFiles: entries.length,\n      totalEdits,\n      topFiles,\n    };\n  }\n\n  /**\n   * Update configuration\n   */\n  setConfig(config: Partial<SelfVerifyConfig>): void {\n    this.config = { ...this.config, ...config };\n  }\n\n  /**\n   * Get current configuration\n   */\n  getConfig(): SelfVerifyConfig {\n    return { ...this.config };\n  }\n}\n"],"mappings":"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"}

package/dist/src/agent/orchestration/agent-event-handler.js

@@ -153,9 +153,27 @@ function installLifecycleHookListener(bus, lifecycleManager) {
 function installSystemReminderListener(bus, systemReminder) {
 	bus.on("tool_execution_end", (event) => {
 		const e = event;
-		e.result = systemReminder.appendToResult(e.result);
+		e.result = systemReminder.appendToResult(e.result, e.toolName);
 	});
 }
+function appendTextToToolResult(result, text) {
+	if (!text.trim()) return result;
+	if (result && typeof result === "object") {
+		const res = result;
+		if (Array.isArray(res.content)) {
+			res.content = [...res.content, {
+				type: "text",
+				text: `\n${text}`
+			}];
+			return res;
+		}
+		if (typeof res.content === "string") {
+			res.content = `${res.content}\n${text}`;
+			return res;
+		}
+	}
+	return result;
+}
 function installToolChainListener(bus, toolChainTracker) {
 	bus.on("turn_start", (_event, context) => {
 		toolChainTracker.startChain(context.sessionKey);
@@ -222,8 +240,15 @@ function installSelfVerifyListener(bus, selfVerifyMiddleware) {
 		const name = toolName.toLowerCase();
 		if (name.includes("write") && args.path) selfVerifyMiddleware.recordEdit(String(args.path), "write");
 		else if (name.includes("edit") && args.path) selfVerifyMiddleware.recordEdit(String(args.path), "edit");
+		else selfVerifyMiddleware.recordVerification(toolName, args);
 	});
-	bus.on("turn_end", () => {
+	bus.on("tool_execution_end", (event) => {
+		const e = event;
+		const name = e.toolName?.toLowerCase() ?? "";
+		if (!name.includes("write") && !name.includes("edit")) return;
+		e.result = appendTextToToolResult(e.result, selfVerifyMiddleware.consumePostEditReminder());
+	});
+	bus.on("turn_start", () => {
 		selfVerifyMiddleware.onTurnStart();
 	});
 }
@@ -245,13 +270,13 @@ var AgentEventHandler = class {
 		});
 		installLifecycleHookListener(this.bus, config.lifecycleManager);
 		installSystemReminderListener(this.bus, config.systemReminder);
+		installSelfVerifyListener(this.bus, config.selfVerifyMiddleware);
 		installToolUsageListener(this.bus, config.toolUsageAnalyzer);
 		installToolChainListener(this.bus, config.toolChainTracker);
 		installErrorTrackingListener(this.bus, {
 			errorTracker: config.errorTracker,
 			errorPatternMatcher: config.errorPatternMatcher
 		});
-		installSelfVerifyListener(this.bus, config.selfVerifyMiddleware);
 	}
 	/** Dispatch a pi-agent event to all registered listeners. */
 	handle(event, context) {

package/dist/src/agent/orchestration/agent-event-handler.js.map

@@ -1 +1 @@
-{"version":3,"file":"agent-event-handler.js","names":[],"sources":["../../../../src/agent/orchestration/agent-event-handler.ts"],"sourcesContent":["/**\n * Agent Event Handler — coordinates listeners on pi-agent events.\n *\n * Previously a single god-handler with ten manager fields and one `switch`. Now a\n * thin façade around {@link SessionEventBus}: each concern (progress, lifecycle\n * hooks, tool-chain recording, error tracking, self-verify, etc.) registers its\n * own listener at construction time, and external code can add new listeners via\n * {@link AgentEventHandler.registerListener} without modifying this file (OCP).\n *\n * Ordering note: a few listeners are order-sensitive (notably the\n * `tool_execution_end` chain — `SystemReminder` mutates `event.result` in place\n * and downstream listeners read the mutated value). The `installX` calls below\n * preserve the exact order from the previous implementation.\n */\n\nimport type { AgentEvent } from '@earendil-works/pi-agent-core';\nimport type { SessionContext } from '../session/session-context.js';\nimport type { ProgressFeedbackManager } from '../lifecycle/progress.js';\nimport type { ToolErrorTracker } from '../tools/error-tracker.js';\nimport type { RequestLimiter } from '../models/request-limiter.js';\nimport type { LifecycleManager } from '../lifecycle/index.js';\nimport type { ToolChainTracker } from '../tools/chain-tracker.js';\nimport type { SelfVerifyMiddleware } from '../middleware/index.js';\nimport type { SystemReminder } from '../prompt/system-reminder.js';\nimport type { ToolUsageAnalyzer } from '../tools/usage-analyzer.js';\nimport type { ErrorPatternMatcher } from '../tools/error-pattern-matcher.js';\nimport { extractTextContent } from '../context/workspace.js';\nimport { createLogger } from '../../utils/logger.js';\n\nconst log = createLogger('AgentEventHandler');\n\n// ── Event bus ──────────────────────────────────────────────────────────────\n\nexport type SessionEventListener = (event: AgentEvent, context: SessionContext) => void;\nexport type SessionEventTypeFilter = AgentEvent['type'] | 'all';\n\n/**\n * Typed pub/sub for agent events. Listeners run in registration order; the bus\n * itself is synchronous — listeners that need async work must dispatch their own\n * promises (typically by awaiting and logging on error, like the lifecycle hooks).\n */\nexport class SessionEventBus {\n  private readonly listeners = new Map<SessionEventTypeFilter, SessionEventListener[]>();\n\n  on(type: SessionEventTypeFilter, listener: SessionEventListener): () => void {\n    const bucket = this.listeners.get(type) ?? [];\n    bucket.push(listener);\n    this.listeners.set(type, bucket);\n    return () => {\n      const current = this.listeners.get(type);\n      if (!current) return;\n      const idx = current.indexOf(listener);\n      if (idx >= 0) current.splice(idx, 1);\n    };\n  }\n\n  dispatch(event: AgentEvent, context: SessionContext | null): void {\n    if (!context) {\n      if (event.type !== 'message_update') {\n        log.warn(\n          { eventType: event.type },\n          `Agent event ignored (no SessionContext): ${event.type}`,\n        );\n      }\n      return;\n    }\n    const exact = this.listeners.get(event.type);\n    if (exact) {\n      for (const listener of exact) {\n        listener(event, context);\n      }\n    }\n    const all = this.listeners.get('all');\n    if (all) {\n      for (const listener of all) {\n        listener(event, context);\n      }\n    }\n  }\n}\n\n// ── Built-in listener installers ───────────────────────────────────────────\n\nfunction installProgressListener(bus: SessionEventBus, progressManager: ProgressFeedbackManager): void {\n  bus.on('agent_start', () => {\n    log.debug('Agent turn started');\n    progressManager.startTask();\n  });\n  bus.on('turn_start', () => {\n    log.debug('Turn started');\n    progressManager.onTurnStart();\n  });\n  bus.on('tool_execution_start', (event) => {\n    const e = event as Extract<AgentEvent, { type: 'tool_execution_start' }>;\n    log.debug({ tool: e.toolName, args: e.args }, 'Tool execution started');\n    progressManager.onToolStart(e.toolName, e.args || {});\n  });\n  bus.on('tool_execution_update', (event) => {\n    const e = event as Extract<AgentEvent, { type: 'tool_execution_update' }>;\n    progressManager.onToolUpdate(e.toolName, e.partialResult);\n  });\n  bus.on('tool_execution_end', (event) => {\n    const e = event as Extract<AgentEvent, { type: 'tool_execution_end' }>;\n    log.debug({ tool: e.toolName, isError: e.isError }, 'Tool execution complete');\n    progressManager.onToolEnd(e.toolName, e.result, e.isError);\n  });\n  bus.on('agent_end', () => {\n    progressManager.endTask();\n  });\n}\n\nfunction installRequestLimitListener(\n  bus: SessionEventBus,\n  deps: {\n    requestLimiter: RequestLimiter;\n    progressManager: ProgressFeedbackManager;\n    lifecycleManager: LifecycleManager;\n  },\n): void {\n  bus.on('agent_start', (_event, context) => {\n    const result = deps.requestLimiter.recordRequest();\n\n    deps.lifecycleManager\n      .emit(\n        'llm_request',\n        context.sessionKey,\n        { requestNumber: result.count, maxRequests: result.limit },\n        context,\n      )\n      .catch((err) => {\n        const em = err instanceof Error ? err.message : String(err);\n        log.warn(\n          {\n            err,\n            errorMessage: em,\n            sessionKey: context.sessionKey,\n            requestNumber: result.count,\n            maxRequests: result.limit,\n          },\n          `Lifecycle emit llm_request failed: ${em}`,\n        );\n      });\n\n    deps.progressManager.onRequestLimitStatus(\n      result.count,\n      result.limit,\n      result.remaining,\n      result.isWarning,\n      result.shouldStop,\n    );\n\n    if (result.shouldStop) {\n      log.error(\n        { count: result.count, limit: result.limit, sessionKey: context.sessionKey },\n        `Request limit reached (${result.count}/${result.limit}) for session`,\n      );\n    }\n  });\n\n  bus.on('turn_end', () => {\n    deps.requestLimiter.reset();\n  });\n}\n\nfunction installLifecycleHookListener(bus: SessionEventBus, lifecycleManager: LifecycleManager): void {\n  bus.on('message_end', (event, context) => {\n    const e = event as Extract<AgentEvent, { type: 'message_end' }>;\n    if (e.message?.role !== 'assistant') return;\n    const content = e.message.content;\n    const text = Array.isArray(content)\n      ? extractTextContent(content as Array<{ type: string; text?: string }>)\n      : String(content);\n    log.debug({ contentLength: text.length }, 'Assistant response complete');\n\n    lifecycleManager\n      .emit(\n        'llm_response',\n        context.sessionKey,\n        { response: text, usage: (e.message as { usage?: unknown }).usage },\n        context,\n      )\n      .catch((err) => {\n        const em = err instanceof Error ? err.message : String(err);\n        log.warn(\n          { err, errorMessage: em, sessionKey: context.sessionKey, responseChars: text.length },\n          `Lifecycle emit llm_response failed: ${em}`,\n        );\n      });\n  });\n\n  bus.on('tool_execution_start', (event, context) => {\n    const e = event as Extract<AgentEvent, { type: 'tool_execution_start' }>;\n    lifecycleManager\n      .emit(\n        'tool_call_start',\n        context.sessionKey,\n        {\n          toolName: e.toolName,\n          arguments: e.args || {},\n          attemptNumber: 1,\n          maxAttempts: 3,\n        },\n        context,\n      )\n      .catch((err) => {\n        const em = err instanceof Error ? err.message : String(err);\n        log.warn(\n          { err, errorMessage: em, sessionKey: context.sessionKey, tool: e.toolName },\n          `Lifecycle emit tool_call_start failed: ${em}`,\n        );\n      });\n  });\n\n  bus.on('tool_execution_end', (event, context) => {\n    const e = event as Extract<AgentEvent, { type: 'tool_execution_end' }>;\n    const durationMs = (e as { durationMs?: number }).durationMs || 0;\n    lifecycleManager\n      .emit(\n        'tool_call_end',\n        context.sessionKey,\n        {\n          toolName: e.toolName,\n          success: !e.isError,\n          result: e.result,\n          error: e.isError ? String(e.result) : undefined,\n          durationMs,\n        },\n        context,\n      )\n      .catch((err) => {\n        const em = err instanceof Error ? err.message : String(err);\n        log.warn(\n          { err, errorMessage: em, sessionKey: context.sessionKey, tool: e.toolName },\n          `Lifecycle hook tool_call_end failed: ${em}`,\n        );\n      });\n  });\n}\n\nfunction installSystemReminderListener(bus: SessionEventBus, systemReminder: SystemReminder): void {\n  // MUTATES `event.result` so downstream listeners (tool-chain, error-tracking) see\n  // the decorated text. Must run AFTER progress + lifecycle hooks (they consume the\n  // original) and BEFORE tool-chain + error-tracking.\n  bus.on('tool_execution_end', (event) => {\n    const e = event as Extract<AgentEvent, { type: 'tool_execution_end' }> & { result: unknown };\n    e.result = systemReminder.appendToResult(e.result);\n  });\n}\n\nfunction installToolChainListener(bus: SessionEventBus, toolChainTracker: ToolChainTracker): void {\n  bus.on('turn_start', (_event, context) => {\n    // One chain per LLM turn (pi-agent emits turn_start each round; turn_end clears the chain).\n    toolChainTracker.startChain(context.sessionKey);\n  });\n  bus.on('tool_execution_start', (event, context) => {\n    const e = event as Extract<AgentEvent, { type: 'tool_execution_start' }>;\n    toolChainTracker.recordCall(context.sessionKey, e.toolName, e.args || {}, 0);\n  });\n  bus.on('tool_execution_end', (event, context) => {\n    const e = event as Extract<AgentEvent, { type: 'tool_execution_end' }>;\n    const durationMs = (e as { durationMs?: number }).durationMs || 0;\n    const chain = toolChainTracker.getCurrentChain(context.sessionKey);\n    if (!chain) return;\n    const lastNode = chain.nodes[chain.nodes.length - 1];\n    if (lastNode && lastNode.toolName === e.toolName) {\n      toolChainTracker.recordResult(\n        context.sessionKey,\n        lastNode.id,\n        e.result,\n        e.isError ? 'Tool execution failed' : undefined,\n        durationMs,\n      );\n    }\n  });\n  bus.on('turn_end', (_event, context) => {\n    toolChainTracker.endChain(context.sessionKey);\n  });\n}\n\nfunction installToolUsageListener(bus: SessionEventBus, toolUsageAnalyzer: ToolUsageAnalyzer): void {\n  bus.on('tool_execution_end', (event) => {\n    const e = event as Extract<AgentEvent, { type: 'tool_execution_end' }>;\n    const durationMs = (e as { durationMs?: number }).durationMs || 0;\n    toolUsageAnalyzer.recordUsage(e.toolName, !e.isError, durationMs);\n  });\n}\n\nfunction extractErrorText(result: unknown): string {\n  if (typeof result === 'string') return result;\n  if (result && typeof result === 'object') {\n    const obj = result as Record<string, unknown>;\n    if (typeof obj.error === 'string') return obj.error;\n    if (typeof obj.message === 'string') return obj.message;\n    return JSON.stringify(result);\n  }\n  return String(result);\n}\n\nfunction installErrorTrackingListener(\n  bus: SessionEventBus,\n  deps: { errorTracker: ToolErrorTracker; errorPatternMatcher: ErrorPatternMatcher },\n): void {\n  bus.on('tool_execution_end', (event) => {\n    const e = event as Extract<AgentEvent, { type: 'tool_execution_end' }>;\n    if (!e.isError) return;\n    const errorText = extractErrorText(e.result);\n    deps.errorTracker.recordFailure(e.toolName, errorText);\n\n    const errorMatch = deps.errorPatternMatcher.matchError(errorText);\n    if (errorMatch.matched && errorMatch.pattern) {\n      const preview = errorText.length > 120 ? `${errorText.slice(0, 120)}…` : errorText;\n      log.warn(\n        { tool: e.toolName, pattern: errorMatch.pattern.name, errorPreview: preview },\n        `Tool error matched pattern \"${errorMatch.pattern.name}\" (${e.toolName}): ${preview}`,\n      );\n    }\n  });\n  bus.on('turn_end', () => {\n    deps.errorTracker.reset();\n  });\n}\n\nfunction installSelfVerifyListener(bus: SessionEventBus, selfVerifyMiddleware: SelfVerifyMiddleware): void {\n  bus.on('tool_execution_start', (event) => {\n    const e = event as Extract<AgentEvent, { type: 'tool_execution_start' }>;\n    const args = e.args;\n    const toolName = e.toolName;\n    if (!toolName || !args) return;\n    const name = toolName.toLowerCase();\n    if (name.includes('write') && args.path) {\n      selfVerifyMiddleware.recordEdit(String(args.path), 'write');\n    } else if (name.includes('edit') && args.path) {\n      selfVerifyMiddleware.recordEdit(String(args.path), 'edit');\n    }\n  });\n  bus.on('turn_end', () => {\n    selfVerifyMiddleware.onTurnStart();\n  });\n}\n\n// ── Public façade ───────────────────────────────────────────────────────────\n\nexport interface AgentEventHandlerConfig {\n  progressManager: ProgressFeedbackManager;\n  errorTracker: ToolErrorTracker;\n  requestLimiter: RequestLimiter;\n  lifecycleManager: LifecycleManager;\n  toolChainTracker: ToolChainTracker;\n  selfVerifyMiddleware: SelfVerifyMiddleware;\n  systemReminder: SystemReminder;\n  toolUsageAnalyzer: ToolUsageAnalyzer;\n  errorPatternMatcher: ErrorPatternMatcher;\n}\n\n/**\n * Thin façade over {@link SessionEventBus} that pre-registers all built-in\n * listeners in their required order. `handle(event, ctx)` is the entry point\n * used by `AgentService.handleSessionEvent`; extensions can hook in via\n * {@link registerListener} without touching this class.\n */\nexport class AgentEventHandler {\n  private readonly bus: SessionEventBus;\n\n  constructor(config: AgentEventHandlerConfig) {\n    this.bus = new SessionEventBus();\n\n    // Order matters for `tool_execution_end`: SystemReminder mutates `event.result`\n    // and ToolChain + ErrorTracking depend on the mutated value. Keep these in this\n    // exact sequence.\n    installProgressListener(this.bus, config.progressManager);\n    installRequestLimitListener(this.bus, {\n      requestLimiter: config.requestLimiter,\n      progressManager: config.progressManager,\n      lifecycleManager: config.lifecycleManager,\n    });\n    installLifecycleHookListener(this.bus, config.lifecycleManager);\n    installSystemReminderListener(this.bus, config.systemReminder);\n    installToolUsageListener(this.bus, config.toolUsageAnalyzer);\n    installToolChainListener(this.bus, config.toolChainTracker);\n    installErrorTrackingListener(this.bus, {\n      errorTracker: config.errorTracker,\n      errorPatternMatcher: config.errorPatternMatcher,\n    });\n    installSelfVerifyListener(this.bus, config.selfVerifyMiddleware);\n  }\n\n  /** Dispatch a pi-agent event to all registered listeners. */\n  handle(event: AgentEvent, context: SessionContext | null): void {\n    this.bus.dispatch(event, context);\n  }\n\n  /**\n   * Register an additional listener (e.g. from an extension). Returns an\n   * unsubscribe function. Listeners run after the built-ins in registration\n   * order; if you need to run before a built-in, you must create your own\n   * {@link SessionEventBus} instance.\n   */\n  registerListener(type: SessionEventTypeFilter, listener: SessionEventListener): () => void {\n    return this.bus.on(type, listener);\n  }\n}\n"],"mappings":"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"}
+{"version":3,"file":"agent-event-handler.js","names":[],"sources":["../../../../src/agent/orchestration/agent-event-handler.ts"],"sourcesContent":["/**\n * Agent Event Handler — coordinates listeners on pi-agent events.\n *\n * Previously a single god-handler with ten manager fields and one `switch`. Now a\n * thin façade around {@link SessionEventBus}: each concern (progress, lifecycle\n * hooks, tool-chain recording, error tracking, self-verify, etc.) registers its\n * own listener at construction time, and external code can add new listeners via\n * {@link AgentEventHandler.registerListener} without modifying this file (OCP).\n *\n * Ordering note: a few listeners are order-sensitive (notably the\n * `tool_execution_end` chain — `SystemReminder` mutates `event.result` in place\n * and downstream listeners read the mutated value). The `installX` calls below\n * preserve the exact order from the previous implementation.\n */\n\nimport type { AgentEvent } from '@earendil-works/pi-agent-core';\nimport type { SessionContext } from '../session/session-context.js';\nimport type { ProgressFeedbackManager } from '../lifecycle/progress.js';\nimport type { ToolErrorTracker } from '../tools/error-tracker.js';\nimport type { RequestLimiter } from '../models/request-limiter.js';\nimport type { LifecycleManager } from '../lifecycle/index.js';\nimport type { ToolChainTracker } from '../tools/chain-tracker.js';\nimport type { SelfVerifyMiddleware } from '../middleware/index.js';\nimport type { SystemReminder } from '../prompt/system-reminder.js';\nimport type { ToolUsageAnalyzer } from '../tools/usage-analyzer.js';\nimport type { ErrorPatternMatcher } from '../tools/error-pattern-matcher.js';\nimport { extractTextContent } from '../context/workspace.js';\nimport { createLogger } from '../../utils/logger.js';\n\nconst log = createLogger('AgentEventHandler');\n\n// ── Event bus ──────────────────────────────────────────────────────────────\n\nexport type SessionEventListener = (event: AgentEvent, context: SessionContext) => void;\nexport type SessionEventTypeFilter = AgentEvent['type'] | 'all';\n\n/**\n * Typed pub/sub for agent events. Listeners run in registration order; the bus\n * itself is synchronous — listeners that need async work must dispatch their own\n * promises (typically by awaiting and logging on error, like the lifecycle hooks).\n */\nexport class SessionEventBus {\n  private readonly listeners = new Map<SessionEventTypeFilter, SessionEventListener[]>();\n\n  on(type: SessionEventTypeFilter, listener: SessionEventListener): () => void {\n    const bucket = this.listeners.get(type) ?? [];\n    bucket.push(listener);\n    this.listeners.set(type, bucket);\n    return () => {\n      const current = this.listeners.get(type);\n      if (!current) return;\n      const idx = current.indexOf(listener);\n      if (idx >= 0) current.splice(idx, 1);\n    };\n  }\n\n  dispatch(event: AgentEvent, context: SessionContext | null): void {\n    if (!context) {\n      if (event.type !== 'message_update') {\n        log.warn(\n          { eventType: event.type },\n          `Agent event ignored (no SessionContext): ${event.type}`,\n        );\n      }\n      return;\n    }\n    const exact = this.listeners.get(event.type);\n    if (exact) {\n      for (const listener of exact) {\n        listener(event, context);\n      }\n    }\n    const all = this.listeners.get('all');\n    if (all) {\n      for (const listener of all) {\n        listener(event, context);\n      }\n    }\n  }\n}\n\n// ── Built-in listener installers ───────────────────────────────────────────\n\nfunction installProgressListener(bus: SessionEventBus, progressManager: ProgressFeedbackManager): void {\n  bus.on('agent_start', () => {\n    log.debug('Agent turn started');\n    progressManager.startTask();\n  });\n  bus.on('turn_start', () => {\n    log.debug('Turn started');\n    progressManager.onTurnStart();\n  });\n  bus.on('tool_execution_start', (event) => {\n    const e = event as Extract<AgentEvent, { type: 'tool_execution_start' }>;\n    log.debug({ tool: e.toolName, args: e.args }, 'Tool execution started');\n    progressManager.onToolStart(e.toolName, e.args || {});\n  });\n  bus.on('tool_execution_update', (event) => {\n    const e = event as Extract<AgentEvent, { type: 'tool_execution_update' }>;\n    progressManager.onToolUpdate(e.toolName, e.partialResult);\n  });\n  bus.on('tool_execution_end', (event) => {\n    const e = event as Extract<AgentEvent, { type: 'tool_execution_end' }>;\n    log.debug({ tool: e.toolName, isError: e.isError }, 'Tool execution complete');\n    progressManager.onToolEnd(e.toolName, e.result, e.isError);\n  });\n  bus.on('agent_end', () => {\n    progressManager.endTask();\n  });\n}\n\nfunction installRequestLimitListener(\n  bus: SessionEventBus,\n  deps: {\n    requestLimiter: RequestLimiter;\n    progressManager: ProgressFeedbackManager;\n    lifecycleManager: LifecycleManager;\n  },\n): void {\n  bus.on('agent_start', (_event, context) => {\n    const result = deps.requestLimiter.recordRequest();\n\n    deps.lifecycleManager\n      .emit(\n        'llm_request',\n        context.sessionKey,\n        { requestNumber: result.count, maxRequests: result.limit },\n        context,\n      )\n      .catch((err) => {\n        const em = err instanceof Error ? err.message : String(err);\n        log.warn(\n          {\n            err,\n            errorMessage: em,\n            sessionKey: context.sessionKey,\n            requestNumber: result.count,\n            maxRequests: result.limit,\n          },\n          `Lifecycle emit llm_request failed: ${em}`,\n        );\n      });\n\n    deps.progressManager.onRequestLimitStatus(\n      result.count,\n      result.limit,\n      result.remaining,\n      result.isWarning,\n      result.shouldStop,\n    );\n\n    if (result.shouldStop) {\n      log.error(\n        { count: result.count, limit: result.limit, sessionKey: context.sessionKey },\n        `Request limit reached (${result.count}/${result.limit}) for session`,\n      );\n    }\n  });\n\n  bus.on('turn_end', () => {\n    deps.requestLimiter.reset();\n  });\n}\n\nfunction installLifecycleHookListener(bus: SessionEventBus, lifecycleManager: LifecycleManager): void {\n  bus.on('message_end', (event, context) => {\n    const e = event as Extract<AgentEvent, { type: 'message_end' }>;\n    if (e.message?.role !== 'assistant') return;\n    const content = e.message.content;\n    const text = Array.isArray(content)\n      ? extractTextContent(content as Array<{ type: string; text?: string }>)\n      : String(content);\n    log.debug({ contentLength: text.length }, 'Assistant response complete');\n\n    lifecycleManager\n      .emit(\n        'llm_response',\n        context.sessionKey,\n        { response: text, usage: (e.message as { usage?: unknown }).usage },\n        context,\n      )\n      .catch((err) => {\n        const em = err instanceof Error ? err.message : String(err);\n        log.warn(\n          { err, errorMessage: em, sessionKey: context.sessionKey, responseChars: text.length },\n          `Lifecycle emit llm_response failed: ${em}`,\n        );\n      });\n  });\n\n  bus.on('tool_execution_start', (event, context) => {\n    const e = event as Extract<AgentEvent, { type: 'tool_execution_start' }>;\n    lifecycleManager\n      .emit(\n        'tool_call_start',\n        context.sessionKey,\n        {\n          toolName: e.toolName,\n          arguments: e.args || {},\n          attemptNumber: 1,\n          maxAttempts: 3,\n        },\n        context,\n      )\n      .catch((err) => {\n        const em = err instanceof Error ? err.message : String(err);\n        log.warn(\n          { err, errorMessage: em, sessionKey: context.sessionKey, tool: e.toolName },\n          `Lifecycle emit tool_call_start failed: ${em}`,\n        );\n      });\n  });\n\n  bus.on('tool_execution_end', (event, context) => {\n    const e = event as Extract<AgentEvent, { type: 'tool_execution_end' }>;\n    const durationMs = (e as { durationMs?: number }).durationMs || 0;\n    lifecycleManager\n      .emit(\n        'tool_call_end',\n        context.sessionKey,\n        {\n          toolName: e.toolName,\n          success: !e.isError,\n          result: e.result,\n          error: e.isError ? String(e.result) : undefined,\n          durationMs,\n        },\n        context,\n      )\n      .catch((err) => {\n        const em = err instanceof Error ? err.message : String(err);\n        log.warn(\n          { err, errorMessage: em, sessionKey: context.sessionKey, tool: e.toolName },\n          `Lifecycle hook tool_call_end failed: ${em}`,\n        );\n      });\n  });\n}\n\nfunction installSystemReminderListener(bus: SessionEventBus, systemReminder: SystemReminder): void {\n  // MUTATES `event.result` so downstream listeners (tool-chain, error-tracking) see\n  // the decorated text. Must run AFTER progress + lifecycle hooks (they consume the\n  // original) and BEFORE tool-chain + error-tracking.\n  bus.on('tool_execution_end', (event) => {\n    const e = event as Extract<AgentEvent, { type: 'tool_execution_end' }> & { result: unknown };\n    e.result = systemReminder.appendToResult(e.result, e.toolName);\n  });\n}\n\nfunction appendTextToToolResult(result: unknown, text: string): unknown {\n  if (!text.trim()) {\n    return result;\n  }\n  if (result && typeof result === 'object') {\n    const res = result as Record<string, unknown>;\n    if (Array.isArray(res.content)) {\n      res.content = [\n        ...res.content,\n        { type: 'text', text: `\\n${text}` },\n      ];\n      return res;\n    }\n    if (typeof res.content === 'string') {\n      res.content = `${res.content}\\n${text}`;\n      return res;\n    }\n  }\n  return result;\n}\n\nfunction installToolChainListener(bus: SessionEventBus, toolChainTracker: ToolChainTracker): void {\n  bus.on('turn_start', (_event, context) => {\n    // One chain per LLM turn (pi-agent emits turn_start each round; turn_end clears the chain).\n    toolChainTracker.startChain(context.sessionKey);\n  });\n  bus.on('tool_execution_start', (event, context) => {\n    const e = event as Extract<AgentEvent, { type: 'tool_execution_start' }>;\n    toolChainTracker.recordCall(context.sessionKey, e.toolName, e.args || {}, 0);\n  });\n  bus.on('tool_execution_end', (event, context) => {\n    const e = event as Extract<AgentEvent, { type: 'tool_execution_end' }>;\n    const durationMs = (e as { durationMs?: number }).durationMs || 0;\n    const chain = toolChainTracker.getCurrentChain(context.sessionKey);\n    if (!chain) return;\n    const lastNode = chain.nodes[chain.nodes.length - 1];\n    if (lastNode && lastNode.toolName === e.toolName) {\n      toolChainTracker.recordResult(\n        context.sessionKey,\n        lastNode.id,\n        e.result,\n        e.isError ? 'Tool execution failed' : undefined,\n        durationMs,\n      );\n    }\n  });\n  bus.on('turn_end', (_event, context) => {\n    toolChainTracker.endChain(context.sessionKey);\n  });\n}\n\nfunction installToolUsageListener(bus: SessionEventBus, toolUsageAnalyzer: ToolUsageAnalyzer): void {\n  bus.on('tool_execution_end', (event) => {\n    const e = event as Extract<AgentEvent, { type: 'tool_execution_end' }>;\n    const durationMs = (e as { durationMs?: number }).durationMs || 0;\n    toolUsageAnalyzer.recordUsage(e.toolName, !e.isError, durationMs);\n  });\n}\n\nfunction extractErrorText(result: unknown): string {\n  if (typeof result === 'string') return result;\n  if (result && typeof result === 'object') {\n    const obj = result as Record<string, unknown>;\n    if (typeof obj.error === 'string') return obj.error;\n    if (typeof obj.message === 'string') return obj.message;\n    return JSON.stringify(result);\n  }\n  return String(result);\n}\n\nfunction installErrorTrackingListener(\n  bus: SessionEventBus,\n  deps: { errorTracker: ToolErrorTracker; errorPatternMatcher: ErrorPatternMatcher },\n): void {\n  bus.on('tool_execution_end', (event) => {\n    const e = event as Extract<AgentEvent, { type: 'tool_execution_end' }>;\n    if (!e.isError) return;\n    const errorText = extractErrorText(e.result);\n    deps.errorTracker.recordFailure(e.toolName, errorText);\n\n    const errorMatch = deps.errorPatternMatcher.matchError(errorText);\n    if (errorMatch.matched && errorMatch.pattern) {\n      const preview = errorText.length > 120 ? `${errorText.slice(0, 120)}…` : errorText;\n      log.warn(\n        { tool: e.toolName, pattern: errorMatch.pattern.name, errorPreview: preview },\n        `Tool error matched pattern \"${errorMatch.pattern.name}\" (${e.toolName}): ${preview}`,\n      );\n    }\n  });\n  bus.on('turn_end', () => {\n    deps.errorTracker.reset();\n  });\n}\n\nfunction installSelfVerifyListener(bus: SessionEventBus, selfVerifyMiddleware: SelfVerifyMiddleware): void {\n  bus.on('tool_execution_start', (event) => {\n    const e = event as Extract<AgentEvent, { type: 'tool_execution_start' }>;\n    const args = e.args;\n    const toolName = e.toolName;\n    if (!toolName || !args) return;\n    const name = toolName.toLowerCase();\n    if (name.includes('write') && args.path) {\n      selfVerifyMiddleware.recordEdit(String(args.path), 'write');\n    } else if (name.includes('edit') && args.path) {\n      selfVerifyMiddleware.recordEdit(String(args.path), 'edit');\n    } else {\n      selfVerifyMiddleware.recordVerification(toolName, args);\n    }\n  });\n  bus.on('tool_execution_end', (event) => {\n    const e = event as Extract<AgentEvent, { type: 'tool_execution_end' }> & { result: unknown };\n    const name = e.toolName?.toLowerCase() ?? '';\n    if (!name.includes('write') && !name.includes('edit')) {\n      return;\n    }\n    e.result = appendTextToToolResult(e.result, selfVerifyMiddleware.consumePostEditReminder());\n  });\n  bus.on('turn_start', () => {\n    selfVerifyMiddleware.onTurnStart();\n  });\n}\n\n// ── Public façade ───────────────────────────────────────────────────────────\n\nexport interface AgentEventHandlerConfig {\n  progressManager: ProgressFeedbackManager;\n  errorTracker: ToolErrorTracker;\n  requestLimiter: RequestLimiter;\n  lifecycleManager: LifecycleManager;\n  toolChainTracker: ToolChainTracker;\n  selfVerifyMiddleware: SelfVerifyMiddleware;\n  systemReminder: SystemReminder;\n  toolUsageAnalyzer: ToolUsageAnalyzer;\n  errorPatternMatcher: ErrorPatternMatcher;\n}\n\n/**\n * Thin façade over {@link SessionEventBus} that pre-registers all built-in\n * listeners in their required order. `handle(event, ctx)` is the entry point\n * used by `AgentService.handleSessionEvent`; extensions can hook in via\n * {@link registerListener} without touching this class.\n */\nexport class AgentEventHandler {\n  private readonly bus: SessionEventBus;\n\n  constructor(config: AgentEventHandlerConfig) {\n    this.bus = new SessionEventBus();\n\n    // Order matters for `tool_execution_end`: SystemReminder mutates `event.result`\n    // and ToolChain + ErrorTracking depend on the mutated value. Keep these in this\n    // exact sequence.\n    installProgressListener(this.bus, config.progressManager);\n    installRequestLimitListener(this.bus, {\n      requestLimiter: config.requestLimiter,\n      progressManager: config.progressManager,\n      lifecycleManager: config.lifecycleManager,\n    });\n    installLifecycleHookListener(this.bus, config.lifecycleManager);\n    installSystemReminderListener(this.bus, config.systemReminder);\n    installSelfVerifyListener(this.bus, config.selfVerifyMiddleware);\n    installToolUsageListener(this.bus, config.toolUsageAnalyzer);\n    installToolChainListener(this.bus, config.toolChainTracker);\n    installErrorTrackingListener(this.bus, {\n      errorTracker: config.errorTracker,\n      errorPatternMatcher: config.errorPatternMatcher,\n    });\n  }\n\n  /** Dispatch a pi-agent event to all registered listeners. */\n  handle(event: AgentEvent, context: SessionContext | null): void {\n    this.bus.dispatch(event, context);\n  }\n\n  /**\n   * Register an additional listener (e.g. from an extension). Returns an\n   * unsubscribe function. Listeners run after the built-ins in registration\n   * order; if you need to run before a built-in, you must create your own\n   * {@link SessionEventBus} instance.\n   */\n  registerListener(type: SessionEventTypeFilter, listener: SessionEventListener): () => void {\n    return this.bus.on(type, listener);\n  }\n}\n"],"mappings":"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"}

package/dist/src/agent/prompt/sections/memory-skills.js

@@ -5,10 +5,10 @@ function buildMemorySection(params) {
 	const citationsMode = params.citationsMode ?? "on";
 	const citationInstruction = citationsMode === "off" ? "Citations are disabled: do not mention file paths or line numbers in replies." : citationsMode === "source-only" ? "Citations: mention file path when it helps (e.g., Source: MEMORY.md)." : "Citations: include Source: <path#line> when it helps the user verify memory snippets.";
 	const toolLines = [];
-	if (params.availableTools.has("memory_search")) toolLines.push("1. Run `memory_search` on profile MEMORY.md and workspace `memory/*.md`");
+	if (params.availableTools.has("memory_search")) toolLines.push("1. Run `memory_search` to search indexed profile and curated memory sources");
 	if (params.availableTools.has("session_search")) toolLines.push(`${toolLines.length + 1}. For **other chat sessions** / cross-session history, use \`session_search\` with keywords (or omit \`query\` to list recent sessions)`);
-	if (params.availableTools.has("memory_get")) toolLines.push(`${toolLines.length + 1}. Use \`memory_get\` to pull only the needed lines from files`);
-	if (params.availableTools.has("curated_memory")) toolLines.push(`${toolLines.length + 1}. For structured curated notes under agent home \`memories/\`, use \`curated_memory\``);
+	if (params.availableTools.has("memory_get")) toolLines.push(`${toolLines.length + 1}. Use \`memory_get\` only for paths returned by \`memory_search\``);
+	if (params.availableTools.has("curated_memory")) toolLines.push(`${toolLines.length + 1}. For durable facts, preferences, and user-approved notes, use \`curated_memory\``);
 	toolLines.push(`${toolLines.length + 1}. If low confidence after search, say you checked`);
 	return [
 		"## Memory Recall",
@@ -20,17 +20,18 @@ function buildMemorySection(params) {
 		"Before answering anything about prior work, decisions, dates, people, preferences, or todos:",
 		...toolLines,
 		"",
-		"### Memory Files",
+		"### Memory Sources",
 		"",
-		"- **Daily notes:** `memory/YYYY-MM-DD.md` — raw logs (runtime may preload recent days on /new or reset)",
-		"- **Long-term:** profile `MEMORY.md` — curated memories in Project Context when present",
-		"- **Curated store:** agent home `memories/MEMORY.md` and global `user/MEMORY.md` — use `curated_memory` for live read/write",
+		"- **Session history:** use `session_search` when available for other chats and prior turns.",
+		"- **Profile memory:** injected `MEMORY.md` content may appear in Project Context when present.",
+		"- **Indexed memory:** cite only paths and line numbers returned by `memory_search` / `memory_get`.",
+		"- **Curated memory:** use `curated_memory` for live read/write of durable facts and preferences.",
 		"",
 		"### Writing to Memory",
 		"",
-		"- **Declarative vs procedural:** Save facts and preferences via workspace memory files and/or `curated_memory`. Save reusable task playbooks with `skill_manage` as skills.",
-		"- **Memory is limited** — if you want to remember something, WRITE IT TO A FILE",
-		"- When someone says \"remember this\" → update `memory/YYYY-MM-DD.md` or relevant file",
+		"- **Declarative vs procedural:** Save facts and preferences with `curated_memory`. Save reusable task playbooks with `skill_manage` as skills.",
+		"- When someone says \"remember this\" → use `curated_memory` when available; otherwise explain that durable memory is not writable from this turn.",
+		"- Do not invent, cite, or promise memory file paths that were not returned by a memory tool.",
 		"- **Text > Brain**"
 	].join("\n");
 }

package/dist/src/agent/prompt/sections/memory-skills.js.map

@@ -1 +1 @@
-{"version":3,"file":"memory-skills.js","names":[],"sources":["../../../../../src/agent/prompt/sections/memory-skills.ts"],"sourcesContent":["import type { MemoryCitationsMode } from '../types.js';\n\nexport function buildMemorySection(params: {\n  availableTools: Set<string>;\n  citationsMode?: MemoryCitationsMode;\n  hasProfileMemory?: boolean;\n  includeMemorySection?: boolean;\n}): string {\n  if (params.includeMemorySection === false) {\n    return '';\n  }\n  const hasMemoryTools =\n    params.availableTools.has('memory_search') ||\n    params.availableTools.has('memory_get') ||\n    params.availableTools.has('curated_memory');\n  if (!hasMemoryTools && !params.hasProfileMemory) {\n    return '';\n  }\n\n  const citationsMode = params.citationsMode ?? 'on';\n  const citationInstruction =\n    citationsMode === 'off'\n      ? 'Citations are disabled: do not mention file paths or line numbers in replies.'\n      : citationsMode === 'source-only'\n        ? 'Citations: mention file path when it helps (e.g., Source: MEMORY.md).'\n        : 'Citations: include Source: <path#line> when it helps the user verify memory snippets.';\n\n  const toolLines: string[] = [];\n  if (params.availableTools.has('memory_search')) {\n    toolLines.push('1. Run `memory_search` on profile MEMORY.md and workspace `memory/*.md`');\n  }\n  if (params.availableTools.has('session_search')) {\n    toolLines.push(\n      `${toolLines.length + 1}. For **other chat sessions** / cross-session history, use \\`session_search\\` with keywords (or omit \\`query\\` to list recent sessions)`,\n    );\n  }\n  if (params.availableTools.has('memory_get')) {\n    toolLines.push(`${toolLines.length + 1}. Use \\`memory_get\\` to pull only the needed lines from files`);\n  }\n  if (params.availableTools.has('curated_memory')) {\n    toolLines.push(\n      `${toolLines.length + 1}. For structured curated notes under agent home \\`memories/\\`, use \\`curated_memory\\``,\n    );\n  }\n  toolLines.push(`${toolLines.length + 1}. If low confidence after search, say you checked`);\n\n  return [\n    '## Memory Recall',\n    '',\n    citationInstruction,\n    '',\n    'Startup profile files (SOUL, USER, MEMORY, etc.) are already in Project Context above when injected. Do not re-read them unless the user asks or you need lines beyond what was injected.',\n    '',\n    'Before answering anything about prior work, decisions, dates, people, preferences, or todos:',\n    ...toolLines,\n    '',\n    '### Memory Files',\n    '',\n    '- **Daily notes:** `memory/YYYY-MM-DD.md` — raw logs (runtime may preload recent days on /new or reset)',\n    '- **Long-term:** profile `MEMORY.md` — curated memories in Project Context when present',\n    '- **Curated store:** agent home `memories/MEMORY.md` and global `user/MEMORY.md` — use `curated_memory` for live read/write',\n    '',\n    '### Writing to Memory',\n    '',\n    '- **Declarative vs procedural:** Save facts and preferences via workspace memory files and/or `curated_memory`. Save reusable task playbooks with `skill_manage` as skills.',\n    '- **Memory is limited** — if you want to remember something, WRITE IT TO A FILE',\n    '- When someone says \"remember this\" → update `memory/YYYY-MM-DD.md` or relevant file',\n    '- **Text > Brain**',\n  ].join('\\n');\n}\n\nexport function buildExternalMemorySection(text: string | undefined): string {\n  const t = text?.trim();\n  if (!t) {\n    return '';\n  }\n  return `## External memory provider\\n\\n${t}`;\n}\n\nexport function buildSkillsSection(hasSkillTools: boolean): string {\n  if (!hasSkillTools) {\n    return '';\n  }\n\n  return [\n    '## Skills (mandatory)',\n    'Before replying: scan <available_skills> <description> entries.',\n    '- If exactly one skill clearly applies: use `skill_view(name)` to load its SKILL.md, then follow it.',\n    '- If multiple could apply: choose the most specific one, then load/follow it.',\n    '- If none clearly apply: do not load any SKILL.md.',\n    'Constraints: never load more than one skill up front; only load after selecting.',\n    '- When a skill drives external API writes, assume rate limits: prefer fewer larger writes, avoid tight one-item loops, serialize bursts when possible, and respect 429/Retry-After.',\n    '',\n    '**Division of labor with memory:** Skills = **procedural** workflows; memory / `curated_memory` = **declarative** facts and preferences.',\n  ].join('\\n');\n}\n"],"mappings":";AAEA,SAAgB,mBAAmB,QAKxB;AACT,KAAI,OAAO,yBAAyB,MAClC,QAAO;AAMT,KAAI,EAHF,OAAO,eAAe,IAAI,gBAAgB,IAC1C,OAAO,eAAe,IAAI,aAAa,IACvC,OAAO,eAAe,IAAI,iBAAiB,KACtB,CAAC,OAAO,iBAC7B,QAAO;CAGT,MAAM,gBAAgB,OAAO,iBAAiB;CAC9C,MAAM,sBACJ,kBAAkB,QACd,kFACA,kBAAkB,gBAChB,0EACA;CAER,MAAM,YAAsB,EAAE;AAC9B,KAAI,OAAO,eAAe,IAAI,gBAAgB,CAC5C,WAAU,KAAK,0EAA0E;AAE3F,KAAI,OAAO,eAAe,IAAI,iBAAiB,CAC7C,WAAU,KACR,GAAG,UAAU,SAAS,EAAE,yIACzB;AAEH,KAAI,OAAO,eAAe,IAAI,aAAa,CACzC,WAAU,KAAK,GAAG,UAAU,SAAS,EAAE,+DAA+D;AAExG,KAAI,OAAO,eAAe,IAAI,iBAAiB,CAC7C,WAAU,KACR,GAAG,UAAU,SAAS,EAAE,uFACzB;AAEH,WAAU,KAAK,GAAG,UAAU,SAAS,EAAE,mDAAmD;AAE1F,QAAO;EACL;EACA;EACA;EACA;EACA;EACA;EACA;EACA,GAAG;EACH;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACD,CAAC,KAAK,KAAK;;AAGd,SAAgB,2BAA2B,MAAkC;CAC3E,MAAM,IAAI,MAAM,MAAM;AACtB,KAAI,CAAC,EACH,QAAO;AAET,QAAO,kCAAkC;;AAG3C,SAAgB,mBAAmB,eAAgC;AACjE,KAAI,CAAC,cACH,QAAO;AAGT,QAAO;EACL;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACD,CAAC,KAAK,KAAK"}
+{"version":3,"file":"memory-skills.js","names":[],"sources":["../../../../../src/agent/prompt/sections/memory-skills.ts"],"sourcesContent":["import type { MemoryCitationsMode } from '../types.js';\n\nexport function buildMemorySection(params: {\n  availableTools: Set<string>;\n  citationsMode?: MemoryCitationsMode;\n  hasProfileMemory?: boolean;\n  includeMemorySection?: boolean;\n}): string {\n  if (params.includeMemorySection === false) {\n    return '';\n  }\n  const hasMemoryTools =\n    params.availableTools.has('memory_search') ||\n    params.availableTools.has('memory_get') ||\n    params.availableTools.has('curated_memory');\n  if (!hasMemoryTools && !params.hasProfileMemory) {\n    return '';\n  }\n\n  const citationsMode = params.citationsMode ?? 'on';\n  const citationInstruction =\n    citationsMode === 'off'\n      ? 'Citations are disabled: do not mention file paths or line numbers in replies.'\n      : citationsMode === 'source-only'\n        ? 'Citations: mention file path when it helps (e.g., Source: MEMORY.md).'\n        : 'Citations: include Source: <path#line> when it helps the user verify memory snippets.';\n\n  const toolLines: string[] = [];\n  if (params.availableTools.has('memory_search')) {\n    toolLines.push('1. Run `memory_search` to search indexed profile and curated memory sources');\n  }\n  if (params.availableTools.has('session_search')) {\n    toolLines.push(\n      `${toolLines.length + 1}. For **other chat sessions** / cross-session history, use \\`session_search\\` with keywords (or omit \\`query\\` to list recent sessions)`,\n    );\n  }\n  if (params.availableTools.has('memory_get')) {\n    toolLines.push(`${toolLines.length + 1}. Use \\`memory_get\\` only for paths returned by \\`memory_search\\``);\n  }\n  if (params.availableTools.has('curated_memory')) {\n    toolLines.push(\n      `${toolLines.length + 1}. For durable facts, preferences, and user-approved notes, use \\`curated_memory\\``,\n    );\n  }\n  toolLines.push(`${toolLines.length + 1}. If low confidence after search, say you checked`);\n\n  return [\n    '## Memory Recall',\n    '',\n    citationInstruction,\n    '',\n    'Startup profile files (SOUL, USER, MEMORY, etc.) are already in Project Context above when injected. Do not re-read them unless the user asks or you need lines beyond what was injected.',\n    '',\n    'Before answering anything about prior work, decisions, dates, people, preferences, or todos:',\n    ...toolLines,\n    '',\n    '### Memory Sources',\n    '',\n    '- **Session history:** use `session_search` when available for other chats and prior turns.',\n    '- **Profile memory:** injected `MEMORY.md` content may appear in Project Context when present.',\n    '- **Indexed memory:** cite only paths and line numbers returned by `memory_search` / `memory_get`.',\n    '- **Curated memory:** use `curated_memory` for live read/write of durable facts and preferences.',\n    '',\n    '### Writing to Memory',\n    '',\n    '- **Declarative vs procedural:** Save facts and preferences with `curated_memory`. Save reusable task playbooks with `skill_manage` as skills.',\n    '- When someone says \"remember this\" → use `curated_memory` when available; otherwise explain that durable memory is not writable from this turn.',\n    '- Do not invent, cite, or promise memory file paths that were not returned by a memory tool.',\n    '- **Text > Brain**',\n  ].join('\\n');\n}\n\nexport function buildExternalMemorySection(text: string | undefined): string {\n  const t = text?.trim();\n  if (!t) {\n    return '';\n  }\n  return `## External memory provider\\n\\n${t}`;\n}\n\nexport function buildSkillsSection(hasSkillTools: boolean): string {\n  if (!hasSkillTools) {\n    return '';\n  }\n\n  return [\n    '## Skills (mandatory)',\n    'Before replying: scan <available_skills> <description> entries.',\n    '- If exactly one skill clearly applies: use `skill_view(name)` to load its SKILL.md, then follow it.',\n    '- If multiple could apply: choose the most specific one, then load/follow it.',\n    '- If none clearly apply: do not load any SKILL.md.',\n    'Constraints: never load more than one skill up front; only load after selecting.',\n    '- When a skill drives external API writes, assume rate limits: prefer fewer larger writes, avoid tight one-item loops, serialize bursts when possible, and respect 429/Retry-After.',\n    '',\n    '**Division of labor with memory:** Skills = **procedural** workflows; memory / `curated_memory` = **declarative** facts and preferences.',\n  ].join('\\n');\n}\n"],"mappings":";AAEA,SAAgB,mBAAmB,QAKxB;AACT,KAAI,OAAO,yBAAyB,MAClC,QAAO;AAMT,KAAI,EAHF,OAAO,eAAe,IAAI,gBAAgB,IAC1C,OAAO,eAAe,IAAI,aAAa,IACvC,OAAO,eAAe,IAAI,iBAAiB,KACtB,CAAC,OAAO,iBAC7B,QAAO;CAGT,MAAM,gBAAgB,OAAO,iBAAiB;CAC9C,MAAM,sBACJ,kBAAkB,QACd,kFACA,kBAAkB,gBAChB,0EACA;CAER,MAAM,YAAsB,EAAE;AAC9B,KAAI,OAAO,eAAe,IAAI,gBAAgB,CAC5C,WAAU,KAAK,8EAA8E;AAE/F,KAAI,OAAO,eAAe,IAAI,iBAAiB,CAC7C,WAAU,KACR,GAAG,UAAU,SAAS,EAAE,yIACzB;AAEH,KAAI,OAAO,eAAe,IAAI,aAAa,CACzC,WAAU,KAAK,GAAG,UAAU,SAAS,EAAE,mEAAmE;AAE5G,KAAI,OAAO,eAAe,IAAI,iBAAiB,CAC7C,WAAU,KACR,GAAG,UAAU,SAAS,EAAE,mFACzB;AAEH,WAAU,KAAK,GAAG,UAAU,SAAS,EAAE,mDAAmD;AAE1F,QAAO;EACL;EACA;EACA;EACA;EACA;EACA;EACA;EACA,GAAG;EACH;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACD,CAAC,KAAK,KAAK;;AAGd,SAAgB,2BAA2B,MAAkC;CAC3E,MAAM,IAAI,MAAM,MAAM;AACtB,KAAI,CAAC,EACH,QAAO;AAET,QAAO,kCAAkC;;AAG3C,SAAgB,mBAAmB,eAAgC;AACjE,KAAI,CAAC,cACH,QAAO;AAGT,QAAO;EACL;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACD,CAAC,KAAK,KAAK"}

package/dist/src/agent/prompt/sections/tooling.js

@@ -34,21 +34,21 @@ const CORE_TOOL_ORDER = [
 	"execute_code"
 ];
 const CORE_TOOL_SUMMARIES = {
-	read_file: "Read file contents",
-	write_file: "Create or overwrite files",
-	edit_file: "Make precise edits to files",
-	grep: "Search file contents for patterns",
+	read_file: "Read targeted file contents; prefer this over shell cat/sed for inspection",
+	write_file: "Create new files or intentional complete rewrites",
+	edit_file: "Make precise, minimal edits to existing files",
+	grep: "Search file contents for literals, errors, config values, and docs",
 	find: "Find files by glob pattern",
 	list_dir: "List directory contents",
-	shell: "Run shell commands (supports background via yieldMs/background)",
+	shell: "Run tests, type checks, builds, package scripts, and safe inspection commands",
 	web_search: "Search the web",
 	web_fetch: "Fetch and extract readable content from a URL",
 	web_extract: "Extract structured content from a URL",
 	browser_use: "Control the configured browser",
 	send_message: "Send messages to the current channel",
 	send_media: "Send media attachments to the current channel",
-	memory_search: "Semantic search over workspace and profile memory files",
-	memory_get: "Read specific lines from memory files",
+	memory_search: "Semantic search over indexed memory sources",
+	memory_get: "Read specific lines from memory sources returned by search",
 	session_search: "Search other chat sessions or list recent sessions",
 	curated_memory: "Read/write structured notes under agent home memories/",
 	session_status: "Show session usage/time/model state",
@@ -95,9 +95,20 @@ function buildToolingSection(params) {
 		toolLines.push(summary ? `- ${name}: ${summary}` : `- ${name}`);
 	}
 	const shellToolName = resolveToolName("shell");
+	const readToolName = resolveToolName("read_file");
+	const editToolName = resolveToolName("edit_file");
+	const writeToolName = resolveToolName("write_file");
+	const grepToolName = resolveToolName("grep");
+	const findToolName = resolveToolName("find");
 	const hasDelegate = availableTools.has("delegate_task");
 	const hasWorkflow = availableTools.has("workflow");
 	const hasToolManual = availableTools.has("tool_manual");
+	const hasRead = availableTools.has("read_file");
+	const hasEdit = availableTools.has("edit_file");
+	const hasWrite = availableTools.has("write_file");
+	const hasGrep = availableTools.has("grep");
+	const hasFind = availableTools.has("find");
+	const hasShell = availableTools.has("shell");
 	const orchestrationLines = [];
 	if (hasDelegate) orchestrationLines.push("- Sub-agent delegation → use `delegate_task(goal, context?, toolset?)` for focused parallel work; results return to you automatically.");
 	if (hasWorkflow) orchestrationLines.push("- Multi-phase workflows → use `workflow` to start persisted runs with subagents when a script defines phases.");
@@ -107,6 +118,11 @@ function buildToolingSection(params) {
 		"Tool names are case-sensitive. Call tools exactly as listed.",
 		toolLines.length > 0 ? toolLines.join("\n") : "- No tools are registered for this session.",
 		`For long waits, avoid rapid poll loops: use \`${shellToolName}\` with enough yieldMs or poll in reasonable intervals.`,
+		hasRead ? `Use \`${readToolName}\` for targeted file inspection before editing; do not rely on filenames alone.` : "",
+		hasEdit ? `Use \`${editToolName}\` for small source changes; keep patches focused.` : "",
+		hasWrite ? `Use \`${writeToolName}\` only for new files or intentional complete rewrites.` : "",
+		hasGrep || hasFind ? `Use ${[hasGrep ? `\`${grepToolName}\`` : "", hasFind ? `\`${findToolName}\`` : ""].filter(Boolean).join(" and ")} for text/file discovery; use code graph or symbol tools when available for definitions and call relationships.` : "",
+		hasShell ? `Use \`${shellToolName}\` for verification and safe inspection, not routine file editing.` : "",
 		hasToolManual ? "Some complex tools have built-in manuals. Use `tool_manual(tool)` before non-trivial use." : "",
 		hasDelegate ? "If a task is complex or long-running, delegate it. Completion is push-based: the sub-agent result returns when done." : "",
 		...orchestrationLines,

package/dist/src/agent/prompt/sections/tooling.js.map

@@ -1 +1 @@
-{"version":3,"file":"tooling.js","names":[],"sources":["../../../../../src/agent/prompt/sections/tooling.ts"],"sourcesContent":["const CORE_TOOL_ORDER = [\n  'read_file',\n  'write_file',\n  'edit_file',\n  'grep',\n  'find',\n  'list_dir',\n  'shell',\n  'web_search',\n  'web_fetch',\n  'web_extract',\n  'browser_use',\n  'send_message',\n  'send_media',\n  'memory_search',\n  'memory_get',\n  'session_search',\n  'curated_memory',\n  'session_status',\n  'tool_manual',\n  'delegate_task',\n  'workflow',\n  'automation',\n  'skills_list',\n  'skill_view',\n  'skill_manage',\n  'todo',\n  'clarify',\n  'text_to_speech',\n  'image',\n  'image_generate',\n  'create_share',\n  'execute_code',\n] as const;\n\nconst CORE_TOOL_SUMMARIES: Record<string, string> = {\n  read_file: 'Read file contents',\n  write_file: 'Create or overwrite files',\n  edit_file: 'Make precise edits to files',\n  grep: 'Search file contents for patterns',\n  find: 'Find files by glob pattern',\n  list_dir: 'List directory contents',\n  shell: 'Run shell commands (supports background via yieldMs/background)',\n  web_search: 'Search the web',\n  web_fetch: 'Fetch and extract readable content from a URL',\n  web_extract: 'Extract structured content from a URL',\n  browser_use: 'Control the configured browser',\n  send_message: 'Send messages to the current channel',\n  send_media: 'Send media attachments to the current channel',\n  memory_search: 'Semantic search over workspace and profile memory files',\n  memory_get: 'Read specific lines from memory files',\n  session_search: 'Search other chat sessions or list recent sessions',\n  curated_memory: 'Read/write structured notes under agent home memories/',\n  session_status: 'Show session usage/time/model state',\n  tool_manual: 'Load built-in usage manuals for complex tools',\n  delegate_task: 'Spawn an isolated sub-agent for a delegated task',\n  workflow: 'Start a persisted multi-phase workflow run',\n  automation: 'Manage product automations',\n  skills_list: 'List available skills',\n  skill_view: 'Load a skill SKILL.md or sub-documents',\n  skill_manage: 'Create or update skills on disk',\n  todo: 'Manage in-session todo items',\n  clarify: 'Ask the user a blocking clarification question',\n  text_to_speech: 'Send a standalone voice message',\n  image: 'Analyze an image with the configured vision model',\n  image_generate: 'Generate images with the configured image model',\n  create_share: 'Create a shareable link for workspace files',\n  execute_code: 'Run code in a sandbox with a restricted tool subset',\n};\n\nexport function buildToolingSection(params: {\n  toolNames?: string[];\n  toolSummaries?: Record<string, string>;\n}): string {\n  const rawToolNames = (params.toolNames ?? []).map((tool) => tool.trim()).filter(Boolean);\n  const canonicalByNormalized = new Map<string, string>();\n  for (const name of rawToolNames) {\n    const normalized = name.toLowerCase();\n    if (!canonicalByNormalized.has(normalized)) {\n      canonicalByNormalized.set(normalized, name);\n    }\n  }\n  const resolveToolName = (normalized: string) =>\n    canonicalByNormalized.get(normalized) ?? normalized;\n\n  const normalizedTools = rawToolNames.map((tool) => tool.toLowerCase());\n  const availableTools = new Set(normalizedTools);\n\n  const externalToolSummaries = new Map<string, string>();\n  for (const [key, value] of Object.entries(params.toolSummaries ?? {})) {\n    const normalized = key.trim().toLowerCase();\n    if (!normalized || !value?.trim()) {\n      continue;\n    }\n    externalToolSummaries.set(normalized, value.trim());\n  }\n\n  const extraTools = Array.from(\n    new Set(normalizedTools.filter((tool) => !CORE_TOOL_ORDER.includes(tool as (typeof CORE_TOOL_ORDER)[number]))),\n  );\n  const enabledTools = CORE_TOOL_ORDER.filter((tool) => availableTools.has(tool));\n  const toolLines = enabledTools.map((tool) => {\n    const summary = CORE_TOOL_SUMMARIES[tool] ?? externalToolSummaries.get(tool);\n    const name = resolveToolName(tool);\n    return summary ? `- ${name}: ${summary}` : `- ${name}`;\n  });\n  for (const tool of extraTools.toSorted()) {\n    const summary = CORE_TOOL_SUMMARIES[tool] ?? externalToolSummaries.get(tool);\n    const name = resolveToolName(tool);\n    toolLines.push(summary ? `- ${name}: ${summary}` : `- ${name}`);\n  }\n\n  const shellToolName = resolveToolName('shell');\n  const hasDelegate = availableTools.has('delegate_task');\n  const hasWorkflow = availableTools.has('workflow');\n  const hasToolManual = availableTools.has('tool_manual');\n\n  const orchestrationLines: string[] = [];\n  if (hasDelegate) {\n    orchestrationLines.push(\n      '- Sub-agent delegation → use `delegate_task(goal, context?, toolset?)` for focused parallel work; results return to you automatically.',\n    );\n  }\n  if (hasWorkflow) {\n    orchestrationLines.push(\n      '- Multi-phase workflows → use `workflow` to start persisted runs with subagents when a script defines phases.',\n    );\n  }\n\n  return [\n    '## Tooling',\n    'Tool availability (filtered by policy):',\n    'Tool names are case-sensitive. Call tools exactly as listed.',\n    toolLines.length > 0\n      ? toolLines.join('\\n')\n      : '- No tools are registered for this session.',\n    `For long waits, avoid rapid poll loops: use \\`${shellToolName}\\` with enough yieldMs or poll in reasonable intervals.`,\n    hasToolManual\n      ? 'Some complex tools have built-in manuals. Use `tool_manual(tool)` before non-trivial use.'\n      : '',\n    hasDelegate\n      ? 'If a task is complex or long-running, delegate it. Completion is push-based: the sub-agent result returns when done.'\n      : '',\n    ...orchestrationLines,\n    'Do not poll delegate/workflow status in a tight loop; check on-demand or wait for completion.',\n  ]\n    .filter(Boolean)\n    .join('\\n');\n}\n\nexport function hasSkillsTools(toolNames: string[]): boolean {\n  const normalized = new Set(toolNames.map((t) => t.toLowerCase()));\n  return normalized.has('skills_list') || normalized.has('skill_view');\n}\n"],"mappings":"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"}
+{"version":3,"file":"tooling.js","names":[],"sources":["../../../../../src/agent/prompt/sections/tooling.ts"],"sourcesContent":["const CORE_TOOL_ORDER = [\n  'read_file',\n  'write_file',\n  'edit_file',\n  'grep',\n  'find',\n  'list_dir',\n  'shell',\n  'web_search',\n  'web_fetch',\n  'web_extract',\n  'browser_use',\n  'send_message',\n  'send_media',\n  'memory_search',\n  'memory_get',\n  'session_search',\n  'curated_memory',\n  'session_status',\n  'tool_manual',\n  'delegate_task',\n  'workflow',\n  'automation',\n  'skills_list',\n  'skill_view',\n  'skill_manage',\n  'todo',\n  'clarify',\n  'text_to_speech',\n  'image',\n  'image_generate',\n  'create_share',\n  'execute_code',\n] as const;\n\nconst CORE_TOOL_SUMMARIES: Record<string, string> = {\n  read_file: 'Read targeted file contents; prefer this over shell cat/sed for inspection',\n  write_file: 'Create new files or intentional complete rewrites',\n  edit_file: 'Make precise, minimal edits to existing files',\n  grep: 'Search file contents for literals, errors, config values, and docs',\n  find: 'Find files by glob pattern',\n  list_dir: 'List directory contents',\n  shell: 'Run tests, type checks, builds, package scripts, and safe inspection commands',\n  web_search: 'Search the web',\n  web_fetch: 'Fetch and extract readable content from a URL',\n  web_extract: 'Extract structured content from a URL',\n  browser_use: 'Control the configured browser',\n  send_message: 'Send messages to the current channel',\n  send_media: 'Send media attachments to the current channel',\n  memory_search: 'Semantic search over indexed memory sources',\n  memory_get: 'Read specific lines from memory sources returned by search',\n  session_search: 'Search other chat sessions or list recent sessions',\n  curated_memory: 'Read/write structured notes under agent home memories/',\n  session_status: 'Show session usage/time/model state',\n  tool_manual: 'Load built-in usage manuals for complex tools',\n  delegate_task: 'Spawn an isolated sub-agent for a delegated task',\n  workflow: 'Start a persisted multi-phase workflow run',\n  automation: 'Manage product automations',\n  skills_list: 'List available skills',\n  skill_view: 'Load a skill SKILL.md or sub-documents',\n  skill_manage: 'Create or update skills on disk',\n  todo: 'Manage in-session todo items',\n  clarify: 'Ask the user a blocking clarification question',\n  text_to_speech: 'Send a standalone voice message',\n  image: 'Analyze an image with the configured vision model',\n  image_generate: 'Generate images with the configured image model',\n  create_share: 'Create a shareable link for workspace files',\n  execute_code: 'Run code in a sandbox with a restricted tool subset',\n};\n\nexport function buildToolingSection(params: {\n  toolNames?: string[];\n  toolSummaries?: Record<string, string>;\n}): string {\n  const rawToolNames = (params.toolNames ?? []).map((tool) => tool.trim()).filter(Boolean);\n  const canonicalByNormalized = new Map<string, string>();\n  for (const name of rawToolNames) {\n    const normalized = name.toLowerCase();\n    if (!canonicalByNormalized.has(normalized)) {\n      canonicalByNormalized.set(normalized, name);\n    }\n  }\n  const resolveToolName = (normalized: string) =>\n    canonicalByNormalized.get(normalized) ?? normalized;\n\n  const normalizedTools = rawToolNames.map((tool) => tool.toLowerCase());\n  const availableTools = new Set(normalizedTools);\n\n  const externalToolSummaries = new Map<string, string>();\n  for (const [key, value] of Object.entries(params.toolSummaries ?? {})) {\n    const normalized = key.trim().toLowerCase();\n    if (!normalized || !value?.trim()) {\n      continue;\n    }\n    externalToolSummaries.set(normalized, value.trim());\n  }\n\n  const extraTools = Array.from(\n    new Set(normalizedTools.filter((tool) => !CORE_TOOL_ORDER.includes(tool as (typeof CORE_TOOL_ORDER)[number]))),\n  );\n  const enabledTools = CORE_TOOL_ORDER.filter((tool) => availableTools.has(tool));\n  const toolLines = enabledTools.map((tool) => {\n    const summary = CORE_TOOL_SUMMARIES[tool] ?? externalToolSummaries.get(tool);\n    const name = resolveToolName(tool);\n    return summary ? `- ${name}: ${summary}` : `- ${name}`;\n  });\n  for (const tool of extraTools.toSorted()) {\n    const summary = CORE_TOOL_SUMMARIES[tool] ?? externalToolSummaries.get(tool);\n    const name = resolveToolName(tool);\n    toolLines.push(summary ? `- ${name}: ${summary}` : `- ${name}`);\n  }\n\n  const shellToolName = resolveToolName('shell');\n  const readToolName = resolveToolName('read_file');\n  const editToolName = resolveToolName('edit_file');\n  const writeToolName = resolveToolName('write_file');\n  const grepToolName = resolveToolName('grep');\n  const findToolName = resolveToolName('find');\n  const hasDelegate = availableTools.has('delegate_task');\n  const hasWorkflow = availableTools.has('workflow');\n  const hasToolManual = availableTools.has('tool_manual');\n  const hasRead = availableTools.has('read_file');\n  const hasEdit = availableTools.has('edit_file');\n  const hasWrite = availableTools.has('write_file');\n  const hasGrep = availableTools.has('grep');\n  const hasFind = availableTools.has('find');\n  const hasShell = availableTools.has('shell');\n\n  const orchestrationLines: string[] = [];\n  if (hasDelegate) {\n    orchestrationLines.push(\n      '- Sub-agent delegation → use `delegate_task(goal, context?, toolset?)` for focused parallel work; results return to you automatically.',\n    );\n  }\n  if (hasWorkflow) {\n    orchestrationLines.push(\n      '- Multi-phase workflows → use `workflow` to start persisted runs with subagents when a script defines phases.',\n    );\n  }\n\n  return [\n    '## Tooling',\n    'Tool availability (filtered by policy):',\n    'Tool names are case-sensitive. Call tools exactly as listed.',\n    toolLines.length > 0\n      ? toolLines.join('\\n')\n      : '- No tools are registered for this session.',\n    `For long waits, avoid rapid poll loops: use \\`${shellToolName}\\` with enough yieldMs or poll in reasonable intervals.`,\n    hasRead\n      ? `Use \\`${readToolName}\\` for targeted file inspection before editing; do not rely on filenames alone.`\n      : '',\n    hasEdit\n      ? `Use \\`${editToolName}\\` for small source changes; keep patches focused.`\n      : '',\n    hasWrite\n      ? `Use \\`${writeToolName}\\` only for new files or intentional complete rewrites.`\n      : '',\n    hasGrep || hasFind\n      ? `Use ${[\n          hasGrep ? `\\`${grepToolName}\\`` : '',\n          hasFind ? `\\`${findToolName}\\`` : '',\n        ].filter(Boolean).join(' and ')} for text/file discovery; use code graph or symbol tools when available for definitions and call relationships.`\n      : '',\n    hasShell\n      ? `Use \\`${shellToolName}\\` for verification and safe inspection, not routine file editing.`\n      : '',\n    hasToolManual\n      ? 'Some complex tools have built-in manuals. Use `tool_manual(tool)` before non-trivial use.'\n      : '',\n    hasDelegate\n      ? 'If a task is complex or long-running, delegate it. Completion is push-based: the sub-agent result returns when done.'\n      : '',\n    ...orchestrationLines,\n    'Do not poll delegate/workflow status in a tight loop; check on-demand or wait for completion.',\n  ]\n    .filter(Boolean)\n    .join('\\n');\n}\n\nexport function hasSkillsTools(toolNames: string[]): boolean {\n  const normalized = new Set(toolNames.map((t) => t.toLowerCase()));\n  return normalized.has('skills_list') || normalized.has('skill_view');\n}\n"],"mappings":"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"}

package/dist/src/agent/prompt/service-prompt-builder.js

@@ -78,6 +78,7 @@ var SystemPromptBuilder = class {
 			includeMemorySection: resolved.includeMemorySection,
 			userTimezone: resolved.userTimezone,
 			runtime: resolved.runtimeInfo,
+			agentId: options.agentId,
 			channels: resolved.channels,
 			externalMemoryInstructions: resolved.externalMemoryInstructions,
 			ttsSystemHint: resolved.ttsSystemHint,