@xopcai/xopc 0.0.142 → 0.0.144

package/dist/src/agent/memory/lifecycle.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"lifecycle.js","names":[],"sources":["../../../../src/agent/memory/lifecycle.ts"],"sourcesContent":["import type { MemoryRecord, MemoryStatus } from './types.js';\n\nexport type MemoryStabilityBand = 'strong' | 'working' | 'fragile';\n\nconst DAY_MS = 86_400_000;\n\nfunction clamp01(value: number): number {\n  return Math.max(0, Math.min(1, value));\n}\n\nfunction reviewIntervalDays(record: Pick<MemoryRecord, 'durability' | 'explicitness'>): number {\n  if (record.durability === 'ephemeral') return 14;\n  if (record.durability === 'recurring') return record.explicitness === 'explicit' ? 120 : 60;\n  if (record.explicitness === 'explicit') return 365;\n  if (record.explicitness === 'observed') return 180;\n  return 90;\n}\n\nexport function nextMemoryReviewAt(\n  record: Pick<MemoryRecord, 'durability' | 'explicitness'>,\n  fromMs = Date.now(),\n): string {\n  return new Date(fromMs + reviewIntervalDays(record) * DAY_MS).toISOString();\n}\n\nexport function resolveMemoryStability(record: MemoryRecord, nowMs = Date.now()): {\n  score: number;\n  band: MemoryStabilityBand;\n  reviewAt: string;\n  reviewDue: boolean;\n  expired: boolean;\n} {\n  const confidence = clamp01(record.confidence ?? 0.5);\n  const explicitness = record.explicitness === 'explicit' ? 1 : record.explicitness === 'observed' ? 0.7 : 0.45;\n  const durability = record.durability === 'durable' ? 1 : record.durability === 'recurring' ? 0.85 : 0.55;\n  const evidence = record.evidence ?? [];\n  const evidenceConfidence = evidence.length > 0\n    ? evidence.reduce((sum, item) => sum + clamp01(item.confidence ?? confidence), 0) / evidence.length\n    : confidence * 0.8;\n  const evidenceStrength = clamp01(evidenceConfidence * 0.75 + Math.min(evidence.length, 4) * 0.0625);\n  const updatedAtMs = Date.parse(record.updatedAt);\n  const ageDays = Number.isFinite(updatedAtMs) ? Math.max(0, (nowMs - updatedAtMs) / DAY_MS) : 0;\n  const halfLifeDays = record.durability === 'ephemeral' ? 21 : record.durability === 'recurring' ? 120 : 365;\n  const freshnessFloor = record.explicitness === 'explicit' ? 0.72 : record.explicitness === 'observed' ? 0.48 : 0.28;\n  const freshness = freshnessFloor + (1 - freshnessFloor) * Math.pow(0.5, ageDays / halfLifeDays);\n  const raw = confidence * 0.32\n    + explicitness * 0.2\n    + clamp01(record.importance) * 0.16\n    + durability * 0.14\n    + evidenceStrength * 0.18;\n  const score = Math.round(clamp01(raw * freshness) * 1000) / 1000;\n  const band: MemoryStabilityBand = score >= 0.75 ? 'strong' : score >= 0.5 ? 'working' : 'fragile';\n  const inferredReviewAt = nextMemoryReviewAt(record, Number.isFinite(updatedAtMs) ? updatedAtMs : nowMs);\n  const reviewAt = record.reviewAfter && Number.isFinite(Date.parse(record.reviewAfter))\n    ? record.reviewAfter\n    : inferredReviewAt;\n  const expired = Boolean(\n    (record.expiresAt && Date.parse(record.expiresAt) <= nowMs)\n    || (record.validTo && Date.parse(record.validTo) <= nowMs),\n  );\n  const reviewDue = record.status === 'candidate'\n    || record.status === 'needs_review'\n    || record.status === 'stale'\n    || Date.parse(reviewAt) <= nowMs;\n  return { score, band, reviewAt, reviewDue, expired };\n}\n\nexport function effectiveMemoryStatus(record: MemoryRecord, nowMs = Date.now()): MemoryStatus {\n  const lifecycle = resolveMemoryStability(record, nowMs);\n  if (lifecycle.expired && record.status === 'active') return 'stale';\n  if (lifecycle.reviewDue && record.status === 'active') return 'needs_review';\n  return record.status ?? 'active';\n}\n"],"mappings":";AAIA,MAAM,SAAS;AAEf,SAAS,QAAQ,OAAuB;AACtC,QAAO,KAAK,IAAI,GAAG,KAAK,IAAI,GAAG,MAAM,CAAC;;AAGxC,SAAS,mBAAmB,QAAmE;AAC7F,KAAI,OAAO,eAAe,YAAa,QAAO;AAC9C,KAAI,OAAO,eAAe,YAAa,QAAO,OAAO,iBAAiB,aAAa,MAAM;AACzF,KAAI,OAAO,iBAAiB,WAAY,QAAO;AAC/C,KAAI,OAAO,iBAAiB,WAAY,QAAO;AAC/C,QAAO;;AAGT,SAAgB,mBACd,QACA,SAAS,KAAK,KAAK,EACX;AACR,QAAO,IAAI,KAAK,SAAS,mBAAmB,OAAO,GAAG,OAAO,CAAC,aAAa;;AAG7E,SAAgB,uBAAuB,QAAsB,QAAQ,KAAK,KAAK,EAM7E;CACA,MAAM,aAAa,QAAQ,OAAO,cAAc,GAAI;CACpD,MAAM,eAAe,OAAO,iBAAiB,aAAa,IAAI,OAAO,iBAAiB,aAAa,KAAM;CACzG,MAAM,aAAa,OAAO,eAAe,YAAY,IAAI,OAAO,eAAe,cAAc,MAAO;CACpG,MAAM,WAAW,OAAO,YAAY,EAAE;CAItC,MAAM,mBAAmB,SAHE,SAAS,SAAS,IACzC,SAAS,QAAQ,KAAK,SAAS,MAAM,QAAQ,KAAK,cAAc,WAAW,EAAE,EAAE,GAAG,SAAS,SAC3F,aAAa,MACqC,MAAO,KAAK,IAAI,SAAS,QAAQ,EAAE,GAAG,MAAO;CACnG,MAAM,cAAc,KAAK,MAAM,OAAO,UAAU;CAChD,MAAM,UAAU,OAAO,SAAS,YAAY,GAAG,KAAK,IAAI,IAAI,QAAQ,eAAe,OAAO,GAAG;CAC7F,MAAM,eAAe,OAAO,eAAe,cAAc,KAAK,OAAO,eAAe,cAAc,MAAM;CACxG,MAAM,iBAAiB,OAAO,iBAAiB,aAAa,MAAO,OAAO,iBAAiB,aAAa,MAAO;CAC/G,MAAM,YAAY,kBAAkB,IAAI,kBAAkB,KAAK,IAAI,IAAK,UAAU,aAAa;CAC/F,MAAM,MAAM,aAAa,MACrB,eAAe,KACf,QAAQ,OAAO,WAAW,GAAG,MAC7B,aAAa,MACb,mBAAmB;CACvB,MAAM,QAAQ,KAAK,MAAM,QAAQ,MAAM,UAAU,GAAG,IAAK,GAAG;CAC5D,MAAM,OAA4B,SAAS,MAAO,WAAW,SAAS,KAAM,YAAY;CACxF,MAAM,mBAAmB,mBAAmB,QAAQ,OAAO,SAAS,YAAY,GAAG,cAAc,MAAM;CACvG,MAAM,WAAW,OAAO,eAAe,OAAO,SAAS,KAAK,MAAM,OAAO,YAAY,CAAC,GAClF,OAAO,cACP;CACJ,MAAM,UAAU,QACb,OAAO,aAAa,KAAK,MAAM,OAAO,UAAU,IAAI,SACjD,OAAO,WAAW,KAAK,MAAM,OAAO,QAAQ,IAAI,MACrD;AAKD,QAAO;EAAE;EAAO;EAAM;EAAU,WAJd,OAAO,WAAW,eAC/B,OAAO,WAAW,kBAClB,OAAO,WAAW,WAClB,KAAK,MAAM,SAAS,IAAI;EACc;EAAS;;AAGtD,SAAgB,sBAAsB,QAAsB,QAAQ,KAAK,KAAK,EAAgB;CAC5F,MAAM,YAAY,uBAAuB,QAAQ,MAAM;AACvD,KAAI,UAAU,WAAW,OAAO,WAAW,SAAU,QAAO;AAC5D,KAAI,UAAU,aAAa,OAAO,WAAW,SAAU,QAAO;AAC9D,QAAO,OAAO,UAAU"}

package/dist/src/agent/memory/plugin-discovery.js

@@ -1,7 +1,7 @@
 import { discoverExtensionsFromDisk, init_discover_extensions } from "../../extensions/discover-extensions.js";
 import { isAbsolute, join } from "node:path";
-import { pathToFileURL } from "node:url";
 import { stat } from "node:fs/promises";
+import { pathToFileURL } from "node:url";
 //#region src/agent/memory/plugin-discovery.ts
 init_discover_extensions();
 async function discoverMemoryPlugins(config) {

package/dist/src/agent/memory/source-origin.d.ts

@@ -0,0 +1,3 @@
+import type { MemoryRecord } from './types.js';
+export type MemoryContextOrigin = 'told_by_user' | 'observed' | 'inferred' | 'connected_source';
+export declare function classifyMemoryContextOrigin(record: MemoryRecord): MemoryContextOrigin;

package/dist/src/agent/memory/source-origin.js

@@ -0,0 +1,19 @@
+//#region src/agent/memory/source-origin.ts
+const INTERNAL_MEMORY_PROVIDERS = new Set([
+	"local",
+	"builtin",
+	"user-understanding",
+	"dreaming",
+	"workflow-run"
+]);
+function classifyMemoryContextOrigin(record) {
+	const provider = record.source.provider?.trim().toLowerCase();
+	if (provider && !INTERNAL_MEMORY_PROVIDERS.has(provider)) return "connected_source";
+	if (record.explicitness === "explicit") return "told_by_user";
+	if (record.explicitness === "observed") return "observed";
+	return "inferred";
+}
+//#endregion
+export { classifyMemoryContextOrigin };
+
+//# sourceMappingURL=source-origin.js.map

package/dist/src/agent/memory/source-origin.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"source-origin.js","names":[],"sources":["../../../../src/agent/memory/source-origin.ts"],"sourcesContent":["import type { MemoryRecord } from './types.js';\n\nexport type MemoryContextOrigin = 'told_by_user' | 'observed' | 'inferred' | 'connected_source';\n\nconst INTERNAL_MEMORY_PROVIDERS = new Set([\n  'local',\n  'builtin',\n  'user-understanding',\n  'dreaming',\n  'workflow-run',\n]);\n\nexport function classifyMemoryContextOrigin(record: MemoryRecord): MemoryContextOrigin {\n  const provider = record.source.provider?.trim().toLowerCase();\n  if (provider && !INTERNAL_MEMORY_PROVIDERS.has(provider)) return 'connected_source';\n  if (record.explicitness === 'explicit') return 'told_by_user';\n  if (record.explicitness === 'observed') return 'observed';\n  return 'inferred';\n}\n"],"mappings":";AAIA,MAAM,4BAA4B,IAAI,IAAI;CACxC;CACA;CACA;CACA;CACA;CACD,CAAC;AAEF,SAAgB,4BAA4B,QAA2C;CACrF,MAAM,WAAW,OAAO,OAAO,UAAU,MAAM,CAAC,aAAa;AAC7D,KAAI,YAAY,CAAC,0BAA0B,IAAI,SAAS,CAAE,QAAO;AACjE,KAAI,OAAO,iBAAiB,WAAY,QAAO;AAC/C,KAAI,OAAO,iBAAiB,WAAY,QAAO;AAC/C,QAAO"}

package/dist/src/agent/memory/understanding/service.js

@@ -3,6 +3,7 @@ import { init_logger } from "../../../utils/logger.js";
 import { appendMemoryTraceEvent } from "../../../storage/sqlite/memory-records-repository.js";
 import { attachMemoryEvidence, upsertKnowledgeSourceItems } from "../../../storage/sqlite/knowledge-repository.js";
 import "../../../storage/sqlite/index.js";
+import { nextMemoryReviewAt } from "../lifecycle.js";
 import { extractExplicitUnderstandingCorrectionContent } from "./correction.js";
 import { inferMemorySensitivity, redactSensitiveMemoryText } from "../sensitivity.js";
 import { createHash } from "node:crypto";
@@ -172,6 +173,10 @@ var UserUnderstandingService = class {
 				evidence: [evidence],
 				validFrom: candidate.validFrom,
 				validTo: candidate.validTo,
+				reviewAfter: nextMemoryReviewAt({
+					durability: candidate.durability,
+					explicitness: candidate.explicitness
+				}),
 				supersedesRecordId
 			});
 			if (write.success) {

package/dist/src/agent/memory/understanding/service.js.map

@@ -1 +1 @@
-{"version":3,"file":"service.js","names":[],"sources":["../../../../../src/agent/memory/understanding/service.ts"],"sourcesContent":["import { createHash } from 'node:crypto';\n\nimport {\n  appendMemoryTraceEvent,\n  attachMemoryEvidence,\n  upsertKnowledgeSourceItems,\n} from '../../../storage/sqlite/index.js';\nimport { createLogger } from '../../../utils/logger.js';\nimport type {\n  MemoryEvidence,\n  MemoryKind,\n  MemoryRecord,\n  MemorySensitivity,\n  MemoryWriteRequest,\n  MemoryWriteResult,\n} from '../types.js';\nimport { extractExplicitUnderstandingCorrectionContent } from './correction.js';\nimport type { UnderstandingCandidate, UnderstandingReviewResult } from './types.js';\nimport { inferMemorySensitivity, redactSensitiveMemoryText } from '../sensitivity.js';\n\nconst log = createLogger('UserUnderstanding');\nconst MAX_CANDIDATE_CHARS = 600;\n\nconst EXPLICIT_PATTERNS: RegExp[] = [\n  /\\b(?:please\\s+)?remember(?:\\s+that)?\\s+(.+)/i,\n  /\\bkeep\\s+in\\s+mind(?:\\s+that)?\\s+(.+)/i,\n  /(?:请)?记住[：:\\s]*(.+)/,\n  /以后(?:都)?(?:请)?[：:\\s]*(.+)/,\n  /下次(?:请)?[：:\\s]*(.+)/,\n];\n\nfunction normalizeContent(raw: string): string {\n  return raw\n    .replace(/^[\"'“”‘’\\s]+|[\"'“”‘’\\s]+$/g, '')\n    .replace(/\\s+/g, ' ')\n    .trim()\n    .slice(0, MAX_CANDIDATE_CHARS);\n}\n\nfunction inferKind(content: string): MemoryKind {\n  if (/\\b(don't|do not|never|avoid)\\b/i.test(content) || /不要|别再|禁止|底线/.test(content)) {\n    return 'boundary';\n  }\n  if (/\\b(prefer|preference|like)\\b/i.test(content) || /喜欢|偏好|习惯/.test(content)) {\n    return 'preference';\n  }\n  if (/\\b(tool|command|pnpm|npm|git|ripgrep|rg)\\b/i.test(content) || /工具|命令/.test(content)) {\n    return 'tool_preference';\n  }\n  if (/\\b(project|repo|codebase|workspace)\\b/i.test(content) || /项目|仓库|代码库/.test(content)) {\n    return 'project_context';\n  }\n  if (/\\b(goal|plan|commit|deadline)\\b/i.test(content) || /目标|计划|承诺|截止/.test(content)) {\n    return 'commitment';\n  }\n  if (/\\b(next time|lesson|failed|error)\\b/i.test(content) || /下次|教训|失败|错误/.test(content)) {\n    return 'task_lesson';\n  }\n  return 'agent_note';\n}\n\nconst SENSITIVITY_RANK: Record<MemorySensitivity, number> = {\n  normal: 0,\n  personal: 1,\n  regulated: 2,\n  secret: 3,\n};\n\nfunction stricterSensitivity(content: string, declared: MemorySensitivity): MemorySensitivity {\n  const inferred = inferMemorySensitivity(content);\n  return SENSITIVITY_RANK[inferred] > SENSITIVITY_RANK[declared] ? inferred : declared;\n}\n\nfunction canonicalKey(kind: MemoryKind, content: string): string {\n  const normalized = content\n    .toLocaleLowerCase()\n    .replace(/[^\\p{L}\\p{N}]+/gu, ' ')\n    .trim();\n  return `${kind}:${createHash('sha256').update(normalized).digest('hex').slice(0, 20)}`;\n}\n\nexport function extractExplicitUnderstandingCandidates(userContent: string): UnderstandingCandidate[] {\n  const correction = extractExplicitUnderstandingCorrectionContent(userContent);\n  if (correction) {\n    const kind = inferKind(correction);\n    return [{\n      kind,\n      content: correction,\n      canonicalKey: canonicalKey(kind, correction),\n      confidence: 0.95,\n      importance: kind === 'boundary' ? 0.9 : 0.8,\n      explicitness: 'explicit',\n      durability: 'durable',\n      sensitivity: inferMemorySensitivity(correction),\n      disclosurePolicy: kind === 'boundary' ? 'silent' : 'referenceable',\n      tags: ['user-understanding', 'explicit-user-correction'],\n    }];\n  }\n  const lines = userContent.split(/\\r?\\n/).map((line) => line.trim()).filter(Boolean);\n  for (const line of lines.length > 0 ? lines : [userContent.trim()]) {\n    for (const pattern of EXPLICIT_PATTERNS) {\n      const content = normalizeContent(pattern.exec(line)?.[1] ?? '');\n      if (content.length < 8) continue;\n      const kind = inferKind(content);\n      return [{\n        kind,\n        content,\n        canonicalKey: canonicalKey(kind, content),\n        confidence: 0.92,\n        importance: kind === 'boundary' ? 0.9 : 0.75,\n        explicitness: 'explicit',\n        durability: 'durable',\n        sensitivity: inferMemorySensitivity(content),\n        disclosurePolicy: kind === 'boundary' ? 'silent' : 'referenceable',\n        tags: ['user-understanding', 'explicit-user-request'],\n      }];\n    }\n  }\n  return [];\n}\n\nexport interface UserUnderstandingServiceOptions {\n  write: (request: MemoryWriteRequest) => Promise<MemoryWriteResult>;\n  list: (canonicalKey: string) => Promise<MemoryRecord[]>;\n}\n\nexport class UserUnderstandingService {\n  constructor(private readonly options: UserUnderstandingServiceOptions) {}\n\n  async reviewTurn(params: {\n    agentId?: string;\n    userContent: string;\n    assistantContent: string;\n    sessionKey?: string;\n    correctionTargetRecordIds?: string[];\n  }): Promise<UnderstandingReviewResult> {\n    const candidates = extractExplicitUnderstandingCandidates(params.userContent);\n    const sourceText = `User:\\n${params.userContent.trim()}\\n\\nAssistant:\\n${params.assistantContent.trim()}`;\n    const normalizedText = redactSensitiveMemoryText(sourceText);\n    const contentHash = createHash('sha256').update(sourceText).digest('hex');\n    const stored = upsertKnowledgeSourceItems([{\n      sourceInstanceId: params.sessionKey ? `session:${params.sessionKey}` : 'session:unknown',\n      externalId: contentHash,\n      itemType: 'conversation_turn',\n      authorRole: 'user',\n      occurredAt: new Date().toISOString(),\n      contentHash,\n      normalizedText,\n      metadata: params.sessionKey ? { sessionKey: params.sessionKey } : {},\n      sensitivity: 'personal',\n      retentionClass: 'bounded',\n      synthesisStatus: 'pending',\n    }]);\n    const sourceItemId = stored.items[0]?.id;\n    const result = await this.applyCandidates(candidates, {\n      agentId: params.agentId,\n      sessionKey: params.sessionKey,\n      sourceItemId,\n      sourceText: params.userContent,\n      reviewSource: 'turn',\n      supersedesRecordIds: params.correctionTargetRecordIds,\n    });\n    return { ...result, sourceItemId };\n  }\n\n  async applyCandidates(\n    candidates: UnderstandingCandidate[],\n    context: {\n      agentId?: string;\n      sessionKey?: string;\n      sourceItemId?: string;\n      sourceText?: string;\n      reviewSource?: 'turn' | 'background';\n      supersedesRecordIds?: string[];\n    },\n  ): Promise<Omit<UnderstandingReviewResult, 'sourceItemId'>> {\n    const startedAt = Date.now();\n    let created = 0;\n    let deduplicated = 0;\n    let rejected = 0;\n    const recordIds: string[] = [];\n    for (const candidate of candidates.slice(0, 10)) {\n      const content = normalizeContent(candidate.content);\n      const sensitivity = stricterSensitivity(content, candidate.sensitivity);\n      if (\n        content.length < 4\n        || candidate.confidence < 0.55\n        || sensitivity === 'secret'\n        || sensitivity === 'regulated'\n      ) {\n        rejected += 1;\n        continue;\n      }\n      const evidenceText = context.sourceText\n        ? redactSensitiveMemoryText(context.sourceText).slice(0, MAX_CANDIDATE_CHARS)\n        : undefined;\n      const key = candidate.canonicalKey ?? canonicalKey(candidate.kind, content);\n      const supersedesRecordId = context.supersedesRecordIds\n        && [...new Set(context.supersedesRecordIds)].length === 1\n        ? context.supersedesRecordIds[0]\n        : undefined;\n      const existing = await this.options.list(key);\n      const evidence: MemoryEvidence = {\n        ...(context.sourceItemId ? { sourceItemId: context.sourceItemId } : {}),\n        relation: 'supports',\n        ...(context.sessionKey ? { sessionKey: context.sessionKey } : {}),\n        ...(evidenceText ? { sourceText: evidenceText } : {}),\n        observedAt: new Date().toISOString(),\n        confidence: candidate.confidence,\n      };\n      if (existing[0]) {\n        deduplicated += 1;\n        recordIds.push(existing[0].id);\n        if (context.sourceItemId) {\n          attachMemoryEvidence({\n            recordId: existing[0].id,\n            sourceItemId: context.sourceItemId,\n            relation: 'supports',\n            excerpt: evidenceText,\n            confidence: candidate.confidence,\n          });\n        }\n        continue;\n      }\n      const write = await this.options.write({\n        kind: candidate.kind,\n        content,\n        canonicalKey: key,\n        scope: context.agentId || context.sessionKey\n          ? { agentId: context.agentId, sessionKey: context.sessionKey }\n          : undefined,\n        target: candidate.kind === 'preference' ? 'user' : 'memory',\n        tags: [...new Set(['user-understanding', ...(candidate.tags ?? [])])],\n        source: { provider: 'user-understanding' },\n        confidence: candidate.confidence,\n        status: 'candidate',\n        sensitivity,\n        explicitness: candidate.explicitness,\n        durability: candidate.durability,\n        importance: candidate.importance,\n        disclosurePolicy: candidate.disclosurePolicy,\n        evidence: [evidence],\n        validFrom: candidate.validFrom,\n        validTo: candidate.validTo,\n        supersedesRecordId,\n      });\n      if (write.success) {\n        created += 1;\n        if (write.record) recordIds.push(write.record.id);\n        if (write.record && context.sourceItemId) {\n          attachMemoryEvidence({\n            recordId: write.record.id,\n            sourceItemId: context.sourceItemId,\n            relation: 'supports',\n            excerpt: evidenceText,\n            confidence: candidate.confidence,\n          });\n        }\n      } else {\n        rejected += 1;\n        log.debug({ errorMessage: write.error, canonicalKey: key }, 'Understanding candidate was not stored');\n      }\n    }\n    try {\n      appendMemoryTraceEvent({\n        sessionKey: context.sessionKey,\n        phase: 'understanding',\n        providerId: 'user-understanding',\n        request: {\n          ...(context.agentId ? { agentId: context.agentId } : {}),\n          source: context.reviewSource ?? 'turn',\n          proposed: candidates.length,\n          created,\n          deduplicated,\n          rejected,\n        },\n        resultCount: created,\n        selectedRecordIds: recordIds,\n        durationMs: Date.now() - startedAt,\n      });\n    } catch (err) {\n      log.debug({ err, sessionKey: context.sessionKey }, 'Understanding quality trace append failed');\n    }\n    return { proposed: candidates.length, created, deduplicated, rejected };\n  }\n}\n"],"mappings":"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"}
+{"version":3,"file":"service.js","names":[],"sources":["../../../../../src/agent/memory/understanding/service.ts"],"sourcesContent":["import { createHash } from 'node:crypto';\n\nimport {\n  appendMemoryTraceEvent,\n  attachMemoryEvidence,\n  upsertKnowledgeSourceItems,\n} from '../../../storage/sqlite/index.js';\nimport { createLogger } from '../../../utils/logger.js';\nimport type {\n  MemoryEvidence,\n  MemoryKind,\n  MemoryRecord,\n  MemorySensitivity,\n  MemoryWriteRequest,\n  MemoryWriteResult,\n} from '../types.js';\nimport { nextMemoryReviewAt } from '../lifecycle.js';\nimport { extractExplicitUnderstandingCorrectionContent } from './correction.js';\nimport type { UnderstandingCandidate, UnderstandingReviewResult } from './types.js';\nimport { inferMemorySensitivity, redactSensitiveMemoryText } from '../sensitivity.js';\n\nconst log = createLogger('UserUnderstanding');\nconst MAX_CANDIDATE_CHARS = 600;\n\nconst EXPLICIT_PATTERNS: RegExp[] = [\n  /\\b(?:please\\s+)?remember(?:\\s+that)?\\s+(.+)/i,\n  /\\bkeep\\s+in\\s+mind(?:\\s+that)?\\s+(.+)/i,\n  /(?:请)?记住[：:\\s]*(.+)/,\n  /以后(?:都)?(?:请)?[：:\\s]*(.+)/,\n  /下次(?:请)?[：:\\s]*(.+)/,\n];\n\nfunction normalizeContent(raw: string): string {\n  return raw\n    .replace(/^[\"'“”‘’\\s]+|[\"'“”‘’\\s]+$/g, '')\n    .replace(/\\s+/g, ' ')\n    .trim()\n    .slice(0, MAX_CANDIDATE_CHARS);\n}\n\nfunction inferKind(content: string): MemoryKind {\n  if (/\\b(don't|do not|never|avoid)\\b/i.test(content) || /不要|别再|禁止|底线/.test(content)) {\n    return 'boundary';\n  }\n  if (/\\b(prefer|preference|like)\\b/i.test(content) || /喜欢|偏好|习惯/.test(content)) {\n    return 'preference';\n  }\n  if (/\\b(tool|command|pnpm|npm|git|ripgrep|rg)\\b/i.test(content) || /工具|命令/.test(content)) {\n    return 'tool_preference';\n  }\n  if (/\\b(project|repo|codebase|workspace)\\b/i.test(content) || /项目|仓库|代码库/.test(content)) {\n    return 'project_context';\n  }\n  if (/\\b(goal|plan|commit|deadline)\\b/i.test(content) || /目标|计划|承诺|截止/.test(content)) {\n    return 'commitment';\n  }\n  if (/\\b(next time|lesson|failed|error)\\b/i.test(content) || /下次|教训|失败|错误/.test(content)) {\n    return 'task_lesson';\n  }\n  return 'agent_note';\n}\n\nconst SENSITIVITY_RANK: Record<MemorySensitivity, number> = {\n  normal: 0,\n  personal: 1,\n  regulated: 2,\n  secret: 3,\n};\n\nfunction stricterSensitivity(content: string, declared: MemorySensitivity): MemorySensitivity {\n  const inferred = inferMemorySensitivity(content);\n  return SENSITIVITY_RANK[inferred] > SENSITIVITY_RANK[declared] ? inferred : declared;\n}\n\nfunction canonicalKey(kind: MemoryKind, content: string): string {\n  const normalized = content\n    .toLocaleLowerCase()\n    .replace(/[^\\p{L}\\p{N}]+/gu, ' ')\n    .trim();\n  return `${kind}:${createHash('sha256').update(normalized).digest('hex').slice(0, 20)}`;\n}\n\nexport function extractExplicitUnderstandingCandidates(userContent: string): UnderstandingCandidate[] {\n  const correction = extractExplicitUnderstandingCorrectionContent(userContent);\n  if (correction) {\n    const kind = inferKind(correction);\n    return [{\n      kind,\n      content: correction,\n      canonicalKey: canonicalKey(kind, correction),\n      confidence: 0.95,\n      importance: kind === 'boundary' ? 0.9 : 0.8,\n      explicitness: 'explicit',\n      durability: 'durable',\n      sensitivity: inferMemorySensitivity(correction),\n      disclosurePolicy: kind === 'boundary' ? 'silent' : 'referenceable',\n      tags: ['user-understanding', 'explicit-user-correction'],\n    }];\n  }\n  const lines = userContent.split(/\\r?\\n/).map((line) => line.trim()).filter(Boolean);\n  for (const line of lines.length > 0 ? lines : [userContent.trim()]) {\n    for (const pattern of EXPLICIT_PATTERNS) {\n      const content = normalizeContent(pattern.exec(line)?.[1] ?? '');\n      if (content.length < 8) continue;\n      const kind = inferKind(content);\n      return [{\n        kind,\n        content,\n        canonicalKey: canonicalKey(kind, content),\n        confidence: 0.92,\n        importance: kind === 'boundary' ? 0.9 : 0.75,\n        explicitness: 'explicit',\n        durability: 'durable',\n        sensitivity: inferMemorySensitivity(content),\n        disclosurePolicy: kind === 'boundary' ? 'silent' : 'referenceable',\n        tags: ['user-understanding', 'explicit-user-request'],\n      }];\n    }\n  }\n  return [];\n}\n\nexport interface UserUnderstandingServiceOptions {\n  write: (request: MemoryWriteRequest) => Promise<MemoryWriteResult>;\n  list: (canonicalKey: string) => Promise<MemoryRecord[]>;\n}\n\nexport class UserUnderstandingService {\n  constructor(private readonly options: UserUnderstandingServiceOptions) {}\n\n  async reviewTurn(params: {\n    agentId?: string;\n    userContent: string;\n    assistantContent: string;\n    sessionKey?: string;\n    correctionTargetRecordIds?: string[];\n  }): Promise<UnderstandingReviewResult> {\n    const candidates = extractExplicitUnderstandingCandidates(params.userContent);\n    const sourceText = `User:\\n${params.userContent.trim()}\\n\\nAssistant:\\n${params.assistantContent.trim()}`;\n    const normalizedText = redactSensitiveMemoryText(sourceText);\n    const contentHash = createHash('sha256').update(sourceText).digest('hex');\n    const stored = upsertKnowledgeSourceItems([{\n      sourceInstanceId: params.sessionKey ? `session:${params.sessionKey}` : 'session:unknown',\n      externalId: contentHash,\n      itemType: 'conversation_turn',\n      authorRole: 'user',\n      occurredAt: new Date().toISOString(),\n      contentHash,\n      normalizedText,\n      metadata: params.sessionKey ? { sessionKey: params.sessionKey } : {},\n      sensitivity: 'personal',\n      retentionClass: 'bounded',\n      synthesisStatus: 'pending',\n    }]);\n    const sourceItemId = stored.items[0]?.id;\n    const result = await this.applyCandidates(candidates, {\n      agentId: params.agentId,\n      sessionKey: params.sessionKey,\n      sourceItemId,\n      sourceText: params.userContent,\n      reviewSource: 'turn',\n      supersedesRecordIds: params.correctionTargetRecordIds,\n    });\n    return { ...result, sourceItemId };\n  }\n\n  async applyCandidates(\n    candidates: UnderstandingCandidate[],\n    context: {\n      agentId?: string;\n      sessionKey?: string;\n      sourceItemId?: string;\n      sourceText?: string;\n      reviewSource?: 'turn' | 'background';\n      supersedesRecordIds?: string[];\n    },\n  ): Promise<Omit<UnderstandingReviewResult, 'sourceItemId'>> {\n    const startedAt = Date.now();\n    let created = 0;\n    let deduplicated = 0;\n    let rejected = 0;\n    const recordIds: string[] = [];\n    for (const candidate of candidates.slice(0, 10)) {\n      const content = normalizeContent(candidate.content);\n      const sensitivity = stricterSensitivity(content, candidate.sensitivity);\n      if (\n        content.length < 4\n        || candidate.confidence < 0.55\n        || sensitivity === 'secret'\n        || sensitivity === 'regulated'\n      ) {\n        rejected += 1;\n        continue;\n      }\n      const evidenceText = context.sourceText\n        ? redactSensitiveMemoryText(context.sourceText).slice(0, MAX_CANDIDATE_CHARS)\n        : undefined;\n      const key = candidate.canonicalKey ?? canonicalKey(candidate.kind, content);\n      const supersedesRecordId = context.supersedesRecordIds\n        && [...new Set(context.supersedesRecordIds)].length === 1\n        ? context.supersedesRecordIds[0]\n        : undefined;\n      const existing = await this.options.list(key);\n      const evidence: MemoryEvidence = {\n        ...(context.sourceItemId ? { sourceItemId: context.sourceItemId } : {}),\n        relation: 'supports',\n        ...(context.sessionKey ? { sessionKey: context.sessionKey } : {}),\n        ...(evidenceText ? { sourceText: evidenceText } : {}),\n        observedAt: new Date().toISOString(),\n        confidence: candidate.confidence,\n      };\n      if (existing[0]) {\n        deduplicated += 1;\n        recordIds.push(existing[0].id);\n        if (context.sourceItemId) {\n          attachMemoryEvidence({\n            recordId: existing[0].id,\n            sourceItemId: context.sourceItemId,\n            relation: 'supports',\n            excerpt: evidenceText,\n            confidence: candidate.confidence,\n          });\n        }\n        continue;\n      }\n      const write = await this.options.write({\n        kind: candidate.kind,\n        content,\n        canonicalKey: key,\n        scope: context.agentId || context.sessionKey\n          ? { agentId: context.agentId, sessionKey: context.sessionKey }\n          : undefined,\n        target: candidate.kind === 'preference' ? 'user' : 'memory',\n        tags: [...new Set(['user-understanding', ...(candidate.tags ?? [])])],\n        source: { provider: 'user-understanding' },\n        confidence: candidate.confidence,\n        status: 'candidate',\n        sensitivity,\n        explicitness: candidate.explicitness,\n        durability: candidate.durability,\n        importance: candidate.importance,\n        disclosurePolicy: candidate.disclosurePolicy,\n        evidence: [evidence],\n        validFrom: candidate.validFrom,\n        validTo: candidate.validTo,\n        reviewAfter: nextMemoryReviewAt({\n          durability: candidate.durability,\n          explicitness: candidate.explicitness,\n        }),\n        supersedesRecordId,\n      });\n      if (write.success) {\n        created += 1;\n        if (write.record) recordIds.push(write.record.id);\n        if (write.record && context.sourceItemId) {\n          attachMemoryEvidence({\n            recordId: write.record.id,\n            sourceItemId: context.sourceItemId,\n            relation: 'supports',\n            excerpt: evidenceText,\n            confidence: candidate.confidence,\n          });\n        }\n      } else {\n        rejected += 1;\n        log.debug({ errorMessage: write.error, canonicalKey: key }, 'Understanding candidate was not stored');\n      }\n    }\n    try {\n      appendMemoryTraceEvent({\n        sessionKey: context.sessionKey,\n        phase: 'understanding',\n        providerId: 'user-understanding',\n        request: {\n          ...(context.agentId ? { agentId: context.agentId } : {}),\n          source: context.reviewSource ?? 'turn',\n          proposed: candidates.length,\n          created,\n          deduplicated,\n          rejected,\n        },\n        resultCount: created,\n        selectedRecordIds: recordIds,\n        durationMs: Date.now() - startedAt,\n      });\n    } catch (err) {\n      log.debug({ err, sessionKey: context.sessionKey }, 'Understanding quality trace append failed');\n    }\n    return { proposed: candidates.length, created, deduplicated, rejected };\n  }\n}\n"],"mappings":"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"}

package/dist/src/agent/memory/user-context-coordinator.js

@@ -36,6 +36,7 @@ var UserContextCoordinator = class {
 		if (!this.options.isEnabledForSession(sessionKey)) return empty();
 		const query = extractAgentUserPlainText(userMessage);
 		this.correctionTargets.delete(sessionKey);
+		let excludedRecordIds;
 		if (isExplicitUnderstandingCorrection(query)) try {
 			const trace = setLatestMemoryInjectFeedback({
 				sessionKey,
@@ -46,7 +47,10 @@ var UserContextCoordinator = class {
 					reason: "detected_explicit_user_correction"
 				}
 			});
-			if (trace?.selectedRecordIds.length) this.correctionTargets.set(sessionKey, trace.selectedRecordIds);
+			if (trace?.selectedRecordIds.length) {
+				this.correctionTargets.set(sessionKey, trace.selectedRecordIds);
+				excludedRecordIds = trace.selectedRecordIds;
+			}
 		} catch (err) {
 			log.debug({
 				err,
@@ -61,7 +65,8 @@ var UserContextCoordinator = class {
 			agentId: this.options.getAgentIdForSession(sessionKey),
 			sessionKey,
 			query,
-			userMessage
+			userMessage,
+			excludedRecordIds
 		});
 	}
 	async afterTurn(sessionKey, userPlainText) {

package/dist/src/agent/memory/user-context-coordinator.js.map

@@ -1 +1 @@
-{"version":3,"file":"user-context-coordinator.js","names":[],"sources":["../../../../src/agent/memory/user-context-coordinator.ts"],"sourcesContent":["import type { AgentMessage } from '@earendil-works/pi-agent-core';\n\nimport type { Config } from '../../config/schema.js';\nimport { setLatestMemoryInjectFeedback } from '../../storage/sqlite/index.js';\nimport { createLogger } from '../../utils/logger.js';\nimport { UserContextPlanner } from './context/planner.js';\nimport type { UserContextPlan } from './context/types.js';\nimport type { MemoryManager } from './manager.js';\nimport {\n  shouldPlanUserContextThisTurn,\n} from './memory-config.js';\nimport { isExplicitUnderstandingCorrection } from './understanding/correction.js';\nimport { extractAgentUserPlainText } from './user-message-text.js';\n\nconst log = createLogger('UserContextCoordinator');\n\nexport interface UserContextCoordinatorOptions {\n  getConfig: () => Config | undefined;\n  isEnabledForSession: (sessionKey: string) => boolean;\n  getAgentIdForSession: (sessionKey: string) => string;\n  getMemoryManagerForSession: (sessionKey: string) => MemoryManager;\n  getLastAssistantContent: (sessionKey: string) => string | null;\n}\n\nexport class UserContextCoordinator {\n  private readonly userTurn = new Map<string, number>();\n  private readonly correctionTargets = new Map<string, string[]>();\n  private readonly planner = new UserContextPlanner();\n\n  constructor(private readonly options: UserContextCoordinatorOptions) {}\n\n  forgetSession(sessionKey: string): void {\n    this.userTurn.delete(sessionKey);\n    this.correctionTargets.delete(sessionKey);\n  }\n\n  clear(): void {\n    this.userTurn.clear();\n    this.correctionTargets.clear();\n  }\n\n  async prepare(userMessage: AgentMessage, sessionKey: string): Promise<UserContextPlan> {\n    const empty = (): UserContextPlan => ({\n      traceId: '',\n      modelMessage: userMessage,\n      items: [],\n      rejected: [],\n      estimatedTokens: 0,\n    });\n    const config = this.options.getConfig();\n    if (!this.options.isEnabledForSession(sessionKey)) return empty();\n    const query = extractAgentUserPlainText(userMessage);\n    this.correctionTargets.delete(sessionKey);\n    if (isExplicitUnderstandingCorrection(query)) {\n      try {\n        const trace = setLatestMemoryInjectFeedback({\n          sessionKey,\n          requireSelectedRecords: true,\n          feedback: {\n            outcome: 'not_helpful',\n            source: 'system',\n            reason: 'detected_explicit_user_correction',\n          },\n        });\n        if (trace?.selectedRecordIds.length) {\n          this.correctionTargets.set(sessionKey, trace.selectedRecordIds);\n        }\n      } catch (err) {\n        log.debug({ err, sessionKey }, 'Understanding correction feedback was not persisted');\n      }\n    }\n    const turn = (this.userTurn.get(sessionKey) ?? 0) + 1;\n    this.userTurn.set(sessionKey, turn);\n    if (!shouldPlanUserContextThisTurn(config, turn)) return empty();\n    return this.planner.plan({\n      memoryManager: this.options.getMemoryManagerForSession(sessionKey),\n      agentId: this.options.getAgentIdForSession(sessionKey),\n      sessionKey,\n      query,\n      userMessage,\n    });\n  }\n\n  async afterTurn(sessionKey: string, userPlainText: string): Promise<void> {\n    if (!this.options.isEnabledForSession(sessionKey)) return;\n    const memoryManager = this.options.getMemoryManagerForSession(sessionKey);\n    const assistantContent = this.options.getLastAssistantContent(sessionKey) ?? '';\n    const correctionTargetRecordIds = this.correctionTargets.get(sessionKey);\n    this.correctionTargets.delete(sessionKey);\n    try {\n      await memoryManager.captureTurnUnderstanding(\n        userPlainText,\n        assistantContent,\n        {\n          agentId: this.options.getAgentIdForSession(sessionKey),\n          sessionId: sessionKey,\n          correctionTargetRecordIds,\n        },\n      );\n    } catch (err) {\n      log.warn({ err, sessionKey }, 'Turn understanding capture failed');\n    }\n    void memoryManager.syncProvidersForTurn(userPlainText, assistantContent, { sessionId: sessionKey });\n    memoryManager.queuePrefetchAll(userPlainText, { sessionId: sessionKey });\n  }\n}\n"],"mappings":";;;;;;;;;aAIqD;AAUrD,MAAM,MAAM,aAAa,yBAAyB;AAUlD,IAAa,yBAAb,MAAoC;CAClC,2BAA4B,IAAI,KAAqB;CACrD,oCAAqC,IAAI,KAAuB;CAChE,UAA2B,IAAI,oBAAoB;CAEnD,YAAY,SAAyD;AAAxC,OAAA,UAAA;;CAE7B,cAAc,YAA0B;AACtC,OAAK,SAAS,OAAO,WAAW;AAChC,OAAK,kBAAkB,OAAO,WAAW;;CAG3C,QAAc;AACZ,OAAK,SAAS,OAAO;AACrB,OAAK,kBAAkB,OAAO;;CAGhC,MAAM,QAAQ,aAA2B,YAA8C;EACrF,MAAM,eAAgC;GACpC,SAAS;GACT,cAAc;GACd,OAAO,EAAE;GACT,UAAU,EAAE;GACZ,iBAAiB;GAClB;EACD,MAAM,SAAS,KAAK,QAAQ,WAAW;AACvC,MAAI,CAAC,KAAK,QAAQ,oBAAoB,WAAW,CAAE,QAAO,OAAO;EACjE,MAAM,QAAQ,0BAA0B,YAAY;AACpD,OAAK,kBAAkB,OAAO,WAAW;AACzC,MAAI,kCAAkC,MAAM,CAC1C,KAAI;GACF,MAAM,QAAQ,8BAA8B;IAC1C;IACA,wBAAwB;IACxB,UAAU;KACR,SAAS;KACT,QAAQ;KACR,QAAQ;KACT;IACF,CAAC;AACF,OAAI,OAAO,kBAAkB,OAC3B,MAAK,kBAAkB,IAAI,YAAY,MAAM,kBAAkB;WAE1D,KAAK;AACZ,OAAI,MAAM;IAAE;IAAK;IAAY,EAAE,sDAAsD;;EAGzF,MAAM,QAAQ,KAAK,SAAS,IAAI,WAAW,IAAI,KAAK;AACpD,OAAK,SAAS,IAAI,YAAY,KAAK;AACnC,MAAI,CAAC,8BAA8B,QAAQ,KAAK,CAAE,QAAO,OAAO;AAChE,SAAO,KAAK,QAAQ,KAAK;GACvB,eAAe,KAAK,QAAQ,2BAA2B,WAAW;GAClE,SAAS,KAAK,QAAQ,qBAAqB,WAAW;GACtD;GACA;GACA;GACD,CAAC;;CAGJ,MAAM,UAAU,YAAoB,eAAsC;AACxE,MAAI,CAAC,KAAK,QAAQ,oBAAoB,WAAW,CAAE;EACnD,MAAM,gBAAgB,KAAK,QAAQ,2BAA2B,WAAW;EACzE,MAAM,mBAAmB,KAAK,QAAQ,wBAAwB,WAAW,IAAI;EAC7E,MAAM,4BAA4B,KAAK,kBAAkB,IAAI,WAAW;AACxE,OAAK,kBAAkB,OAAO,WAAW;AACzC,MAAI;AACF,SAAM,cAAc,yBAClB,eACA,kBACA;IACE,SAAS,KAAK,QAAQ,qBAAqB,WAAW;IACtD,WAAW;IACX;IACD,CACF;WACM,KAAK;AACZ,OAAI,KAAK;IAAE;IAAK;IAAY,EAAE,oCAAoC;;AAE/D,gBAAc,qBAAqB,eAAe,kBAAkB,EAAE,WAAW,YAAY,CAAC;AACnG,gBAAc,iBAAiB,eAAe,EAAE,WAAW,YAAY,CAAC"}
+{"version":3,"file":"user-context-coordinator.js","names":[],"sources":["../../../../src/agent/memory/user-context-coordinator.ts"],"sourcesContent":["import type { AgentMessage } from '@earendil-works/pi-agent-core';\n\nimport type { Config } from '../../config/schema.js';\nimport { setLatestMemoryInjectFeedback } from '../../storage/sqlite/index.js';\nimport { createLogger } from '../../utils/logger.js';\nimport { UserContextPlanner } from './context/planner.js';\nimport type { UserContextPlan } from './context/types.js';\nimport type { MemoryManager } from './manager.js';\nimport {\n  shouldPlanUserContextThisTurn,\n} from './memory-config.js';\nimport { isExplicitUnderstandingCorrection } from './understanding/correction.js';\nimport { extractAgentUserPlainText } from './user-message-text.js';\n\nconst log = createLogger('UserContextCoordinator');\n\nexport interface UserContextCoordinatorOptions {\n  getConfig: () => Config | undefined;\n  isEnabledForSession: (sessionKey: string) => boolean;\n  getAgentIdForSession: (sessionKey: string) => string;\n  getMemoryManagerForSession: (sessionKey: string) => MemoryManager;\n  getLastAssistantContent: (sessionKey: string) => string | null;\n}\n\nexport class UserContextCoordinator {\n  private readonly userTurn = new Map<string, number>();\n  private readonly correctionTargets = new Map<string, string[]>();\n  private readonly planner = new UserContextPlanner();\n\n  constructor(private readonly options: UserContextCoordinatorOptions) {}\n\n  forgetSession(sessionKey: string): void {\n    this.userTurn.delete(sessionKey);\n    this.correctionTargets.delete(sessionKey);\n  }\n\n  clear(): void {\n    this.userTurn.clear();\n    this.correctionTargets.clear();\n  }\n\n  async prepare(userMessage: AgentMessage, sessionKey: string): Promise<UserContextPlan> {\n    const empty = (): UserContextPlan => ({\n      traceId: '',\n      modelMessage: userMessage,\n      items: [],\n      rejected: [],\n      estimatedTokens: 0,\n    });\n    const config = this.options.getConfig();\n    if (!this.options.isEnabledForSession(sessionKey)) return empty();\n    const query = extractAgentUserPlainText(userMessage);\n    this.correctionTargets.delete(sessionKey);\n    let excludedRecordIds: string[] | undefined;\n    if (isExplicitUnderstandingCorrection(query)) {\n      try {\n        const trace = setLatestMemoryInjectFeedback({\n          sessionKey,\n          requireSelectedRecords: true,\n          feedback: {\n            outcome: 'not_helpful',\n            source: 'system',\n            reason: 'detected_explicit_user_correction',\n          },\n        });\n        if (trace?.selectedRecordIds.length) {\n          this.correctionTargets.set(sessionKey, trace.selectedRecordIds);\n          excludedRecordIds = trace.selectedRecordIds;\n        }\n      } catch (err) {\n        log.debug({ err, sessionKey }, 'Understanding correction feedback was not persisted');\n      }\n    }\n    const turn = (this.userTurn.get(sessionKey) ?? 0) + 1;\n    this.userTurn.set(sessionKey, turn);\n    if (!shouldPlanUserContextThisTurn(config, turn)) return empty();\n    return this.planner.plan({\n      memoryManager: this.options.getMemoryManagerForSession(sessionKey),\n      agentId: this.options.getAgentIdForSession(sessionKey),\n      sessionKey,\n      query,\n      userMessage,\n      excludedRecordIds,\n    });\n  }\n\n  async afterTurn(sessionKey: string, userPlainText: string): Promise<void> {\n    if (!this.options.isEnabledForSession(sessionKey)) return;\n    const memoryManager = this.options.getMemoryManagerForSession(sessionKey);\n    const assistantContent = this.options.getLastAssistantContent(sessionKey) ?? '';\n    const correctionTargetRecordIds = this.correctionTargets.get(sessionKey);\n    this.correctionTargets.delete(sessionKey);\n    try {\n      await memoryManager.captureTurnUnderstanding(\n        userPlainText,\n        assistantContent,\n        {\n          agentId: this.options.getAgentIdForSession(sessionKey),\n          sessionId: sessionKey,\n          correctionTargetRecordIds,\n        },\n      );\n    } catch (err) {\n      log.warn({ err, sessionKey }, 'Turn understanding capture failed');\n    }\n    void memoryManager.syncProvidersForTurn(userPlainText, assistantContent, { sessionId: sessionKey });\n    memoryManager.queuePrefetchAll(userPlainText, { sessionId: sessionKey });\n  }\n}\n"],"mappings":";;;;;;;;;aAIqD;AAUrD,MAAM,MAAM,aAAa,yBAAyB;AAUlD,IAAa,yBAAb,MAAoC;CAClC,2BAA4B,IAAI,KAAqB;CACrD,oCAAqC,IAAI,KAAuB;CAChE,UAA2B,IAAI,oBAAoB;CAEnD,YAAY,SAAyD;AAAxC,OAAA,UAAA;;CAE7B,cAAc,YAA0B;AACtC,OAAK,SAAS,OAAO,WAAW;AAChC,OAAK,kBAAkB,OAAO,WAAW;;CAG3C,QAAc;AACZ,OAAK,SAAS,OAAO;AACrB,OAAK,kBAAkB,OAAO;;CAGhC,MAAM,QAAQ,aAA2B,YAA8C;EACrF,MAAM,eAAgC;GACpC,SAAS;GACT,cAAc;GACd,OAAO,EAAE;GACT,UAAU,EAAE;GACZ,iBAAiB;GAClB;EACD,MAAM,SAAS,KAAK,QAAQ,WAAW;AACvC,MAAI,CAAC,KAAK,QAAQ,oBAAoB,WAAW,CAAE,QAAO,OAAO;EACjE,MAAM,QAAQ,0BAA0B,YAAY;AACpD,OAAK,kBAAkB,OAAO,WAAW;EACzC,IAAI;AACJ,MAAI,kCAAkC,MAAM,CAC1C,KAAI;GACF,MAAM,QAAQ,8BAA8B;IAC1C;IACA,wBAAwB;IACxB,UAAU;KACR,SAAS;KACT,QAAQ;KACR,QAAQ;KACT;IACF,CAAC;AACF,OAAI,OAAO,kBAAkB,QAAQ;AACnC,SAAK,kBAAkB,IAAI,YAAY,MAAM,kBAAkB;AAC/D,wBAAoB,MAAM;;WAErB,KAAK;AACZ,OAAI,MAAM;IAAE;IAAK;IAAY,EAAE,sDAAsD;;EAGzF,MAAM,QAAQ,KAAK,SAAS,IAAI,WAAW,IAAI,KAAK;AACpD,OAAK,SAAS,IAAI,YAAY,KAAK;AACnC,MAAI,CAAC,8BAA8B,QAAQ,KAAK,CAAE,QAAO,OAAO;AAChE,SAAO,KAAK,QAAQ,KAAK;GACvB,eAAe,KAAK,QAAQ,2BAA2B,WAAW;GAClE,SAAS,KAAK,QAAQ,qBAAqB,WAAW;GACtD;GACA;GACA;GACA;GACD,CAAC;;CAGJ,MAAM,UAAU,YAAoB,eAAsC;AACxE,MAAI,CAAC,KAAK,QAAQ,oBAAoB,WAAW,CAAE;EACnD,MAAM,gBAAgB,KAAK,QAAQ,2BAA2B,WAAW;EACzE,MAAM,mBAAmB,KAAK,QAAQ,wBAAwB,WAAW,IAAI;EAC7E,MAAM,4BAA4B,KAAK,kBAAkB,IAAI,WAAW;AACxE,OAAK,kBAAkB,OAAO,WAAW;AACzC,MAAI;AACF,SAAM,cAAc,yBAClB,eACA,kBACA;IACE,SAAS,KAAK,QAAQ,qBAAqB,WAAW;IACtD,WAAW;IACX;IACD,CACF;WACM,KAAK;AACZ,OAAI,KAAK;IAAE;IAAK;IAAY,EAAE,oCAAoC;;AAE/D,gBAAc,qBAAqB,eAAe,kBAAkB,EAAE,WAAW,YAAY,CAAC;AACnG,gBAAc,iBAAiB,eAAe,EAAE,WAAW,YAAY,CAAC"}

package/dist/src/agent/models/manager.js

@@ -1,6 +1,6 @@
+import { getAgentDefaultModelRef, init_schema } from "../../config/schema.js";
 import { createLogger } from "../../utils/logger/index.js";
 import { init_logger } from "../../utils/logger.js";
-import { getAgentDefaultModelRef, init_schema } from "../../config/schema.js";
 import { getAllModels, getDefaultModelSync, init_providers, resolveModel } from "../../providers/index.js";
 import { parseModelRef } from "./selection.js";
 import { resolveFallbackCandidates } from "../fallback/candidates.js";

package/dist/src/agent/orchestration/agent-orchestrator.js

@@ -1,6 +1,6 @@
+import { resolveEffectiveAgentProfileForSession } from "../../config/agent-profile.js";
 import { createLogger } from "../../utils/logger/index.js";
 import { init_logger } from "../../utils/logger.js";
-import { resolveEffectiveAgentProfileForSession } from "../../config/agent-profile.js";
 import "../memory/dreaming/constants.js";
 import { resolveDreamingAgentScope } from "../memory/dreaming/scope.js";
 import { persistInboundAttachments } from "../../channels/attachments/inbound-persist.js";

package/dist/src/agent/prompt/sections/behavior.d.ts

@@ -2,4 +2,6 @@ export declare function buildToolCallStyleSection(): string;
 export declare function buildExecutionBiasSection(): string;
 export declare function buildProblemSolvingSection(): string;
 export declare function buildAestheticSection(): string;
+export declare function buildHumanCollaborationSection(): string;
+export declare function buildWorkContinuitySection(): string;
 export declare function buildSafetySection(): string;

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

@@ -36,6 +36,35 @@ function buildAestheticSection() {
 		"**SOUL.md takes precedence:** If SOUL.md defines a specific tone, defer to it over the above."
 	].join("\n");
 }
+function buildHumanCollaborationSection() {
+	return [
+		"## Human Collaboration",
+		"- Understand both the requested outcome and the human state around it. Decide whether the user primarily needs action, clarity, reassurance, or space to think.",
+		"- When emotion is materially present, acknowledge it briefly and specifically. Do not perform empathy, exaggerate intimacy, diagnose the user, or repeat their feelings back mechanically.",
+		"- Preserve agency: reduce overwhelm, offer one clear next step, and let the user choose when a meaningful choice remains.",
+		"- Adapt to known communication preferences from user profile and memory. If they are unknown, be warm, calm, direct, and practical.",
+		"- Do not trade correctness for comfort. Pair emotional attunement with honest uncertainty, safe action, and concrete progress.",
+		"- Treat transient moods as current context, not durable identity. Remember stable support or communication preferences only when evidence and memory policy allow it.",
+		"",
+		"### Task Contract",
+		"- For non-trivial actionable work, privately establish: desired outcome, completion criteria, constraints, plan, and verification evidence.",
+		"- Keep implementation concepts such as agents, workflows, tools, and memory providers behind the experience unless naming them helps the user decide or debug.",
+		"- Communicate task state in human terms: working, needs a decision, blocked, or done.",
+		"- Do not claim completion from fluent output alone. Completion requires the requested result plus proportionate verification, or an explicit unresolved blocker."
+	].join("\n");
+}
+function buildWorkContinuitySection() {
+	return [
+		"## Work Continuity",
+		"- Privately classify actionable requests as one-off, a continuation of existing work, ongoing work that benefits from continuity, or recurring/scheduled work. Do not ask the user to choose a product object.",
+		"- Continue in the current project when the conversation is already bound to one. Reuse relevant context before creating anything new.",
+		"- When work clearly spans sessions, files, decisions, or dependencies, first make useful progress, then offer in one plain sentence to keep it moving over time. Create durable project/work state only when the user asks for continuity or accepts the offer.",
+		"- When the user names a future time or cadence, recognize that it may be scheduled. Create an automation only after explicit confirmation of the timing and action; otherwise make a concise offer.",
+		"- When continuity or scheduling is explicit and safe, act with the available product tools instead of explaining agents, goals, workflows, or automations.",
+		"- Phrase offers around the benefit: “keep this moving”, “pick up where we left off”, or “do this for you regularly”. Avoid internal system terminology unless the user asks or it is needed to resolve a problem.",
+		"- Do not repeatedly upsell continuity. Offer only when it materially reduces future effort."
+	].join("\n");
+}
 function buildSafetySection() {
 	return [
 		"## Safety",
@@ -45,6 +74,6 @@ function buildSafetySection() {
 	].join("\n");
 }
 //#endregion
-export { buildAestheticSection, buildExecutionBiasSection, buildProblemSolvingSection, buildSafetySection, buildToolCallStyleSection };
+export { buildAestheticSection, buildExecutionBiasSection, buildHumanCollaborationSection, buildProblemSolvingSection, buildSafetySection, buildToolCallStyleSection, buildWorkContinuitySection };
 
 //# sourceMappingURL=behavior.js.map

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

@@ -1 +1 @@
-{"version":3,"file":"behavior.js","names":[],"sources":["../../../../../src/agent/prompt/sections/behavior.ts"],"sourcesContent":["export function buildToolCallStyleSection(): string {\n  return [\n    '## Tool Call Style',\n    'Default: do not narrate routine, low-risk tool calls (just call the tool).',\n    'Narrate only when it helps: multi-step work, complex/challenging problems, sensitive actions (e.g., deletions), or when the user explicitly asks.',\n    'Keep narration brief and value-dense; avoid repeating obvious steps.',\n    'Use plain human language for narration unless in a technical context.',\n    'When a first-class tool exists for an action, use the tool directly instead of asking the user to run equivalent CLI commands.',\n  ].join('\\n');\n}\n\nexport function buildExecutionBiasSection(): string {\n  return [\n    '## Execution Bias',\n    '- Actionable request: act in this turn.',\n    '- Non-final turn: use tools to advance, or ask for the one missing decision that blocks safe progress.',\n    '- Continue until done or genuinely blocked; do not finish with a plan/promise when tools can move it forward.',\n    '- Weak/empty tool result: vary query, path, command, or source before concluding.',\n    '- Mutable facts need live checks: files, git, clocks, versions, services, processes, package state.',\n    '- Final answer needs evidence: test/build/lint, screenshot, inspection, tool output, or a named blocker.',\n    '- Longer work: brief progress update, then keep going; use delegation or workflows when they fit.',\n  ].join('\\n');\n}\n\nexport function buildProblemSolvingSection(): string {\n  return [\n    '## Problem Solving',\n    '**Simple tasks** (< 5 minutes or a single-file change): Do them directly; run a quick verification after changes.',\n    '**Complex tasks** (multiple files or design decisions): Use an iterative flow — Plan → Build → Verify → Fix.',\n    '**Core principle: Match the complexity; reject ritual for its own sake. Verification matters, but do not verify just to tick a box.**',\n  ].join('\\n');\n}\n\nexport function buildAestheticSection(): string {\n  return [\n    '## Tone & Style',\n    '**Default voice:** Direct, concise, concrete.',\n    '**SOUL.md takes precedence:** If SOUL.md defines a specific tone, defer to it over the above.',\n  ].join('\\n');\n}\n\nexport function buildSafetySection(): string {\n  return [\n    '## Safety',\n    '- You have no independent goals: do not pursue self-preservation, replication, resource acquisition, or power-seeking; avoid long-term plans beyond the user\\'s request.',\n    '- Prioritize safety and human oversight over completion; if instructions conflict, pause and ask; comply with stop/pause/audit requests and never bypass safeguards.',\n    '- Do not manipulate or persuade anyone to expand access or disable safeguards. Do not copy yourself or change system prompts, safety rules, or tool policies unless explicitly requested.',\n  ].join('\\n');\n}\n"],"mappings":";AAAA,SAAgB,4BAAoC;AAClD,QAAO;EACL;EACA;EACA;EACA;EACA;EACA;EACD,CAAC,KAAK,KAAK;;AAGd,SAAgB,4BAAoC;AAClD,QAAO;EACL;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACD,CAAC,KAAK,KAAK;;AAGd,SAAgB,6BAAqC;AACnD,QAAO;EACL;EACA;EACA;EACA;EACD,CAAC,KAAK,KAAK;;AAGd,SAAgB,wBAAgC;AAC9C,QAAO;EACL;EACA;EACA;EACD,CAAC,KAAK,KAAK;;AAGd,SAAgB,qBAA6B;AAC3C,QAAO;EACL;EACA;EACA;EACA;EACD,CAAC,KAAK,KAAK"}
+{"version":3,"file":"behavior.js","names":[],"sources":["../../../../../src/agent/prompt/sections/behavior.ts"],"sourcesContent":["export function buildToolCallStyleSection(): string {\n  return [\n    '## Tool Call Style',\n    'Default: do not narrate routine, low-risk tool calls (just call the tool).',\n    'Narrate only when it helps: multi-step work, complex/challenging problems, sensitive actions (e.g., deletions), or when the user explicitly asks.',\n    'Keep narration brief and value-dense; avoid repeating obvious steps.',\n    'Use plain human language for narration unless in a technical context.',\n    'When a first-class tool exists for an action, use the tool directly instead of asking the user to run equivalent CLI commands.',\n  ].join('\\n');\n}\n\nexport function buildExecutionBiasSection(): string {\n  return [\n    '## Execution Bias',\n    '- Actionable request: act in this turn.',\n    '- Non-final turn: use tools to advance, or ask for the one missing decision that blocks safe progress.',\n    '- Continue until done or genuinely blocked; do not finish with a plan/promise when tools can move it forward.',\n    '- Weak/empty tool result: vary query, path, command, or source before concluding.',\n    '- Mutable facts need live checks: files, git, clocks, versions, services, processes, package state.',\n    '- Final answer needs evidence: test/build/lint, screenshot, inspection, tool output, or a named blocker.',\n    '- Longer work: brief progress update, then keep going; use delegation or workflows when they fit.',\n  ].join('\\n');\n}\n\nexport function buildProblemSolvingSection(): string {\n  return [\n    '## Problem Solving',\n    '**Simple tasks** (< 5 minutes or a single-file change): Do them directly; run a quick verification after changes.',\n    '**Complex tasks** (multiple files or design decisions): Use an iterative flow — Plan → Build → Verify → Fix.',\n    '**Core principle: Match the complexity; reject ritual for its own sake. Verification matters, but do not verify just to tick a box.**',\n  ].join('\\n');\n}\n\nexport function buildAestheticSection(): string {\n  return [\n    '## Tone & Style',\n    '**Default voice:** Direct, concise, concrete.',\n    '**SOUL.md takes precedence:** If SOUL.md defines a specific tone, defer to it over the above.',\n  ].join('\\n');\n}\n\nexport function buildHumanCollaborationSection(): string {\n  return [\n    '## Human Collaboration',\n    '- Understand both the requested outcome and the human state around it. Decide whether the user primarily needs action, clarity, reassurance, or space to think.',\n    '- When emotion is materially present, acknowledge it briefly and specifically. Do not perform empathy, exaggerate intimacy, diagnose the user, or repeat their feelings back mechanically.',\n    '- Preserve agency: reduce overwhelm, offer one clear next step, and let the user choose when a meaningful choice remains.',\n    '- Adapt to known communication preferences from user profile and memory. If they are unknown, be warm, calm, direct, and practical.',\n    '- Do not trade correctness for comfort. Pair emotional attunement with honest uncertainty, safe action, and concrete progress.',\n    '- Treat transient moods as current context, not durable identity. Remember stable support or communication preferences only when evidence and memory policy allow it.',\n    '',\n    '### Task Contract',\n    '- For non-trivial actionable work, privately establish: desired outcome, completion criteria, constraints, plan, and verification evidence.',\n    '- Keep implementation concepts such as agents, workflows, tools, and memory providers behind the experience unless naming them helps the user decide or debug.',\n    '- Communicate task state in human terms: working, needs a decision, blocked, or done.',\n    '- Do not claim completion from fluent output alone. Completion requires the requested result plus proportionate verification, or an explicit unresolved blocker.',\n  ].join('\\n');\n}\n\nexport function buildWorkContinuitySection(): string {\n  return [\n    '## Work Continuity',\n    '- Privately classify actionable requests as one-off, a continuation of existing work, ongoing work that benefits from continuity, or recurring/scheduled work. Do not ask the user to choose a product object.',\n    '- Continue in the current project when the conversation is already bound to one. Reuse relevant context before creating anything new.',\n    '- When work clearly spans sessions, files, decisions, or dependencies, first make useful progress, then offer in one plain sentence to keep it moving over time. Create durable project/work state only when the user asks for continuity or accepts the offer.',\n    '- When the user names a future time or cadence, recognize that it may be scheduled. Create an automation only after explicit confirmation of the timing and action; otherwise make a concise offer.',\n    '- When continuity or scheduling is explicit and safe, act with the available product tools instead of explaining agents, goals, workflows, or automations.',\n    '- Phrase offers around the benefit: “keep this moving”, “pick up where we left off”, or “do this for you regularly”. Avoid internal system terminology unless the user asks or it is needed to resolve a problem.',\n    '- Do not repeatedly upsell continuity. Offer only when it materially reduces future effort.',\n  ].join('\\n');\n}\n\nexport function buildSafetySection(): string {\n  return [\n    '## Safety',\n    '- You have no independent goals: do not pursue self-preservation, replication, resource acquisition, or power-seeking; avoid long-term plans beyond the user\\'s request.',\n    '- Prioritize safety and human oversight over completion; if instructions conflict, pause and ask; comply with stop/pause/audit requests and never bypass safeguards.',\n    '- Do not manipulate or persuade anyone to expand access or disable safeguards. Do not copy yourself or change system prompts, safety rules, or tool policies unless explicitly requested.',\n  ].join('\\n');\n}\n"],"mappings":";AAAA,SAAgB,4BAAoC;AAClD,QAAO;EACL;EACA;EACA;EACA;EACA;EACA;EACD,CAAC,KAAK,KAAK;;AAGd,SAAgB,4BAAoC;AAClD,QAAO;EACL;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACD,CAAC,KAAK,KAAK;;AAGd,SAAgB,6BAAqC;AACnD,QAAO;EACL;EACA;EACA;EACA;EACD,CAAC,KAAK,KAAK;;AAGd,SAAgB,wBAAgC;AAC9C,QAAO;EACL;EACA;EACA;EACD,CAAC,KAAK,KAAK;;AAGd,SAAgB,iCAAyC;AACvD,QAAO;EACL;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACD,CAAC,KAAK,KAAK;;AAGd,SAAgB,6BAAqC;AACnD,QAAO;EACL;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACD,CAAC,KAAK,KAAK;;AAGd,SAAgB,qBAA6B;AAC3C,QAAO;EACL;EACA;EACA;EACA;EACD,CAAC,KAAK,KAAK"}

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

@@ -47,7 +47,7 @@ const CORE_TOOL_SUMMARIES = {
 	code_architecture: "Map packages, boundaries, layers, entry points, hotspots, and clusters",
 	read_file: "Read targeted file contents before editing",
 	write_file: "Create new files or intentional complete rewrites; prefer apply_patch for code changes",
-	apply_patch: "Apply strict patches for source edits",
+	apply_patch: "Apply source edits with patches that begin exactly with *** Begin Patch and end exactly with *** End Patch",
 	grep: "Search file contents for literals, errors, config values, and docs",
 	find: "Find files by glob pattern",
 	list_dir: "List directory contents",

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  'code_search',\n  'code_read_symbol',\n  'code_trace',\n  'code_impact',\n  'code_architecture',\n  'read_file',\n  'write_file',\n  'apply_patch',\n  'grep',\n  'find',\n  'list_dir',\n  'exec_command',\n  'update_plan',\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  code_search: 'Find definitions, implementations, routes, types, and structurally important symbols',\n  code_read_symbol: 'Read exact source for a graph symbol before editing',\n  code_trace: 'Trace callers, callees, data flow, and cross-service paths',\n  code_impact: 'Map git changes to affected symbols and blast radius',\n  code_architecture: 'Map packages, boundaries, layers, entry points, hotspots, and clusters',\n  read_file: 'Read targeted file contents before editing',\n  write_file: 'Create new files or intentional complete rewrites; prefer apply_patch for code changes',\n  apply_patch: 'Apply strict patches for source edits',\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  exec_command: 'Run tests, type checks, builds, package scripts, and safe inspection commands',\n  update_plan: 'Keep the current multi-step coding plan visible and accurate',\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 execToolName = resolveToolName('exec_command');\n  const planToolName = resolveToolName('update_plan');\n  const readToolName = resolveToolName('read_file');\n  const patchToolName = resolveToolName('apply_patch');\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 hasPatch = availableTools.has('apply_patch');\n  const hasWrite = availableTools.has('write_file');\n  const hasGrep = availableTools.has('grep');\n  const hasFind = availableTools.has('find');\n  const hasExec = availableTools.has('exec_command');\n  const hasPlan = availableTools.has('update_plan');\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 \\`${execToolName}\\` with a sufficient timeout or poll in reasonable intervals.`,\n    hasRead\n      ? `Use \\`${readToolName}\\` for targeted file inspection before editing; do not rely on filenames alone.`\n      : '',\n    hasPatch\n      ? `Use \\`${patchToolName}\\` for source changes; keep patches focused and inspect failures carefully.`\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    hasExec\n      ? `Use \\`${execToolName}\\` for verification and safe inspection, not routine file editing.`\n      : '',\n    hasPlan\n      ? `Use \\`${planToolName}\\` for multi-step coding work: keep exactly one active step when work is in progress, and update it after meaningful progress or review.`\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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"}
+{"version":3,"file":"tooling.js","names":[],"sources":["../../../../../src/agent/prompt/sections/tooling.ts"],"sourcesContent":["const CORE_TOOL_ORDER = [\n  'code_search',\n  'code_read_symbol',\n  'code_trace',\n  'code_impact',\n  'code_architecture',\n  'read_file',\n  'write_file',\n  'apply_patch',\n  'grep',\n  'find',\n  'list_dir',\n  'exec_command',\n  'update_plan',\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  code_search: 'Find definitions, implementations, routes, types, and structurally important symbols',\n  code_read_symbol: 'Read exact source for a graph symbol before editing',\n  code_trace: 'Trace callers, callees, data flow, and cross-service paths',\n  code_impact: 'Map git changes to affected symbols and blast radius',\n  code_architecture: 'Map packages, boundaries, layers, entry points, hotspots, and clusters',\n  read_file: 'Read targeted file contents before editing',\n  write_file: 'Create new files or intentional complete rewrites; prefer apply_patch for code changes',\n  apply_patch: 'Apply source edits with patches that begin exactly with *** Begin Patch and end exactly with *** End Patch',\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  exec_command: 'Run tests, type checks, builds, package scripts, and safe inspection commands',\n  update_plan: 'Keep the current multi-step coding plan visible and accurate',\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 execToolName = resolveToolName('exec_command');\n  const planToolName = resolveToolName('update_plan');\n  const readToolName = resolveToolName('read_file');\n  const patchToolName = resolveToolName('apply_patch');\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 hasPatch = availableTools.has('apply_patch');\n  const hasWrite = availableTools.has('write_file');\n  const hasGrep = availableTools.has('grep');\n  const hasFind = availableTools.has('find');\n  const hasExec = availableTools.has('exec_command');\n  const hasPlan = availableTools.has('update_plan');\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 \\`${execToolName}\\` with a sufficient timeout or poll in reasonable intervals.`,\n    hasRead\n      ? `Use \\`${readToolName}\\` for targeted file inspection before editing; do not rely on filenames alone.`\n      : '',\n    hasPatch\n      ? `Use \\`${patchToolName}\\` for source changes; keep patches focused and inspect failures carefully.`\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    hasExec\n      ? `Use \\`${execToolName}\\` for verification and safe inspection, not routine file editing.`\n      : '',\n    hasPlan\n      ? `Use \\`${planToolName}\\` for multi-step coding work: keep exactly one active step when work is in progress, and update it after meaningful progress or review.`\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

@@ -1,5 +1,9 @@
 import { createLogger } from "../../utils/logger/index.js";
 import { init_logger } from "../../utils/logger.js";
+import { isXopcDatabaseOpen } from "../../storage/sqlite/connection.js";
+import { DEFAULT_USER_TRUST_LEVEL, buildActionTrustPrompt } from "../../user-context/trust-policy.js";
+import { getUserTrustPolicy } from "../../storage/sqlite/user-trust-repository.js";
+import "../../storage/sqlite/index.js";
 import { resolveSystemPromptBuildParams } from "./system-prompt-params.js";
 import { buildSystemPrompt } from "./system-prompt.js";
 import { buildTtsSystemPromptHint } from "../../voice/tts/directives.js";
@@ -18,6 +22,7 @@ var SystemPromptBuilder = class {
 	}
 	build(contextFiles, options) {
 		const ws = options.workspaceOverride ?? this.workspace;
+		const actionTrustLevel = isXopcDatabaseOpen() ? getUserTrustPolicy().defaultActionLevel : DEFAULT_USER_TRUST_LEVEL;
 		if (options.systemPromptOverride?.trim()) {
 			const skillPrompt = options.skillPromptText !== void 0 ? options.skillPromptText : this.skillManager.getPromptForSkillAllowlist(options.skillAllowlist, options.registeredToolNames);
 			const trimmed = options.systemPromptOverride.trim();
@@ -32,6 +37,7 @@ var SystemPromptBuilder = class {
 				textToSpeechTool: ttsMerged.enabled && reg.includes("text_to_speech")
 			});
 			if (ttsHint?.trim()) fullPrompt = `${fullPrompt}\n\n## Voice (TTS)\n\n${ttsHint.trim()}`;
+			fullPrompt = `${fullPrompt}\n\n${buildActionTrustPrompt(actionTrustLevel)}`;
 			log.debug({
 				baseLength: trimmed.length,
 				skillLength: skillPrompt.length,
@@ -88,7 +94,8 @@ var SystemPromptBuilder = class {
 			silentReplyPromptMode: resolved.silentReplyPromptMode,
 			promptContribution: resolved.promptContribution,
 			includeProblemSolving: resolved.includeProblemSolving,
-			includeToneSection: resolved.includeToneSection
+			includeToneSection: resolved.includeToneSection,
+			actionTrustLevel
 		});
 		const skillPrompt = options.skillPromptText !== void 0 ? options.skillPromptText : this.skillManager.getPromptForSkillAllowlist(options.skillAllowlist, options.registeredToolNames);
 		const fullPrompt = skillPrompt ? `${basePrompt}\n\n${skillPrompt}` : basePrompt;

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

@@ -1 +1 @@
-{"version":3,"file":"service-prompt-builder.js","names":["buildBaseSystemPrompt"],"sources":["../../../../src/agent/prompt/service-prompt-builder.ts"],"sourcesContent":["/**\n * System Prompt Builder - Builds the complete system prompt\n *\n * Combines base system prompt with skill prompts and bootstrap Project Context.\n */\n\nimport type { Config } from '../../config/schema.js';\nimport type { EmbeddedContextFile } from '../bootstrap/types.js';\nimport type { SkillManager } from '../skills/skill-manager.js';\nimport { buildSystemPrompt as buildBaseSystemPrompt } from './system-prompt.js';\nimport { resolveSystemPromptBuildParams } from './system-prompt-params.js';\nimport type { PromptMode, SilentReplyPromptMode } from './types.js';\nimport type { ProviderSystemPromptContribution } from './contribution.js';\nimport { mergeTtsConfigFromAppConfig } from '../../voice/tts/merge-config.js';\nimport { buildTtsSystemPromptHint } from '../../voice/tts/directives.js';\nimport { createLogger } from '../../utils/logger.js';\n\nconst log = createLogger('SystemPromptBuilder');\n\nexport interface SystemPromptBuildOptions {\n  externalMemoryInstructions?: string;\n  workspaceOverride?: string;\n  profileMarkdownPathRoot?: string;\n  systemPromptOverride?: string;\n  skillPromptText?: string;\n  skillAllowlist?: string[];\n  registeredToolNames?: string[];\n  toolSummaries?: Record<string, string>;\n  sessionKey?: string;\n  promptMode?: PromptMode;\n  modelRef?: string;\n  agentId?: string;\n  thinkingLevel?: string;\n  extraSystemPrompt?: string;\n  activeProjectContext?: string;\n  silentReplyPromptMode?: SilentReplyPromptMode;\n  promptContribution?: ProviderSystemPromptContribution;\n}\n\nexport interface SystemPromptBuilderConfig {\n  workspace: string;\n  config: Config;\n  skillManager: SkillManager;\n}\n\nexport class SystemPromptBuilder {\n  private workspace: string;\n  private config: Config;\n  private skillManager: SkillManager;\n\n  constructor(config: SystemPromptBuilderConfig) {\n    this.workspace = config.workspace;\n    this.config = config.config;\n    this.skillManager = config.skillManager;\n  }\n\n  build(contextFiles: EmbeddedContextFile[], options: SystemPromptBuildOptions): string {\n    const ws = options.workspaceOverride ?? this.workspace;\n    if (options.systemPromptOverride?.trim()) {\n      const skillPrompt =\n        options.skillPromptText !== undefined\n          ? options.skillPromptText\n          : this.skillManager.getPromptForSkillAllowlist(\n              options.skillAllowlist,\n              options.registeredToolNames,\n            );\n      const trimmed = options.systemPromptOverride.trim();\n      let fullPrompt = skillPrompt.trim() ? `${trimmed}\\n\\n${skillPrompt}` : trimmed;\n      const ttsMerged = mergeTtsConfigFromAppConfig(this.config.messages?.tts);\n      const reg = options.registeredToolNames ?? [];\n      const ttsHint = buildTtsSystemPromptHint({\n        enabled: ttsMerged.enabled,\n        trigger: ttsMerged.trigger,\n        maxTextLength: ttsMerged.maxTextLength,\n        modelOverrides: ttsMerged.modelOverrides,\n        textToSpeechTool: ttsMerged.enabled && reg.includes('text_to_speech'),\n      });\n      if (ttsHint?.trim()) {\n        fullPrompt = `${fullPrompt}\\n\\n## Voice (TTS)\\n\\n${ttsHint.trim()}`;\n      }\n      log.debug({ baseLength: trimmed.length, skillLength: skillPrompt.length, totalLength: fullPrompt.length }, 'System prompt built (override)');\n      return fullPrompt;\n    }\n\n    const heartbeatEnabled = this.config.gateway?.heartbeat?.includeSystemPromptSection ?? false;\n    const userTimezone = this.extractTimezone(contextFiles);\n\n    const ttsMerged = mergeTtsConfigFromAppConfig(this.config.messages?.tts);\n    const reg = options.registeredToolNames ?? [];\n    const ttsSystemHint = buildTtsSystemPromptHint({\n      enabled: ttsMerged.enabled,\n      trigger: ttsMerged.trigger,\n      maxTextLength: ttsMerged.maxTextLength,\n      modelOverrides: ttsMerged.modelOverrides,\n      textToSpeechTool: ttsMerged.enabled && reg.includes('text_to_speech'),\n    });\n\n    const resolved = resolveSystemPromptBuildParams(this.config, {\n      workspaceDir: ws,\n      sessionKey: options.sessionKey,\n      toolNames: options.registeredToolNames,\n      toolSummaries: options.toolSummaries,\n      userTimezone,\n      externalMemoryInstructions: options.externalMemoryInstructions,\n      heartbeatEnabled,\n      ttsSystemHint,\n      extraSystemPrompt: options.extraSystemPrompt,\n      activeProjectContext: options.activeProjectContext,\n      modelRef: options.modelRef,\n      agentId: options.agentId,\n      thinkingLevel: options.thinkingLevel,\n      promptMode: options.promptMode,\n      silentReplyPromptMode: options.silentReplyPromptMode,\n      promptContribution: options.promptContribution,\n    });\n\n    const basePrompt = buildBaseSystemPrompt(ws, {\n      contextFiles,\n      promptMode: resolved.promptMode,\n      heartbeatEnabled: resolved.heartbeatEnabled,\n      heartbeatPrompt: resolved.heartbeatPrompt,\n      toolNames: resolved.toolNames,\n      toolSummaries: resolved.toolSummaries,\n      memoryCitationsMode: resolved.memoryCitationsMode,\n      includeMemorySection: resolved.includeMemorySection,\n      userTimezone: resolved.userTimezone,\n      runtime: resolved.runtimeInfo,\n      agentId: options.agentId,\n      channels: resolved.channels,\n      externalMemoryInstructions: resolved.externalMemoryInstructions,\n      ttsSystemHint: resolved.ttsSystemHint,\n      extraSystemPrompt: resolved.extraSystemPrompt,\n      activeProjectContext: resolved.activeProjectContext,\n      silentReplyPromptMode: resolved.silentReplyPromptMode,\n      promptContribution: resolved.promptContribution,\n      includeProblemSolving: resolved.includeProblemSolving,\n      includeToneSection: resolved.includeToneSection,\n    });\n\n    const skillPrompt =\n      options.skillPromptText !== undefined\n        ? options.skillPromptText\n        : this.skillManager.getPromptForSkillAllowlist(\n            options.skillAllowlist,\n            options.registeredToolNames,\n          );\n\n    const fullPrompt = skillPrompt ? `${basePrompt}\\n\\n${skillPrompt}` : basePrompt;\n\n    log.debug(\n      {\n        baseLength: basePrompt.length,\n        skillLength: skillPrompt?.length || 0,\n        totalLength: fullPrompt.length,\n        contextFileCount: contextFiles.length,\n        promptMode: resolved.promptMode,\n        toolCount: resolved.toolNames?.length ?? 0,\n      },\n      'System prompt built',\n    );\n\n    return fullPrompt;\n  }\n\n  rebuild(contextFiles: EmbeddedContextFile[], options: SystemPromptBuildOptions): string {\n    this.skillManager.reload();\n    return this.build(contextFiles, options);\n  }\n\n  private extractTimezone(contextFiles: EmbeddedContextFile[]): string | undefined {\n    const userContext = contextFiles.find((file) =>\n      file.path.replace(/\\\\/g, '/').toLowerCase().endsWith('/user/profile.md'),\n    );\n    if (userContext?.content) {\n      const match = userContext.content.match(/Timezone:\\s*(.+)/i);\n      if (match) {\n        return match[1].trim();\n      }\n    }\n\n    return undefined;\n  }\n\n  getSkillPrompt(): string {\n    return this.skillManager.getPrompt();\n  }\n\n  getBasePrompt(\n    contextFiles: EmbeddedContextFile[],\n    options?: {\n      externalMemoryInstructions?: string;\n      workspaceOverride?: string;\n      profileMarkdownPathRoot?: string;\n      registeredToolNames?: string[];\n      sessionKey?: string;\n    },\n  ): string {\n    const ws = options?.workspaceOverride ?? this.workspace;\n    const resolved = resolveSystemPromptBuildParams(this.config, {\n      workspaceDir: ws,\n      sessionKey: options?.sessionKey,\n      toolNames: options?.registeredToolNames,\n      userTimezone: this.extractTimezone(contextFiles),\n      externalMemoryInstructions: options?.externalMemoryInstructions,\n      heartbeatEnabled: this.config.gateway?.heartbeat?.includeSystemPromptSection ?? false,\n    });\n    return buildBaseSystemPrompt(ws, {\n      contextFiles,\n      promptMode: resolved.promptMode,\n      heartbeatEnabled: resolved.heartbeatEnabled,\n      toolNames: resolved.toolNames,\n      userTimezone: resolved.userTimezone,\n      runtime: resolved.runtimeInfo,\n      channels: resolved.channels,\n      externalMemoryInstructions: resolved.externalMemoryInstructions,\n    });\n  }\n}\n\nexport function createSystemPromptBuilder(config: SystemPromptBuilderConfig): SystemPromptBuilder {\n  return new SystemPromptBuilder(config);\n}\n\nexport type { SystemPromptBuilderConfig as SystemPromptConfig };\nexport type { SystemPromptBuilderConfig as SystemPromptBuilderOptions };\n"],"mappings":"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"}
+{"version":3,"file":"service-prompt-builder.js","names":["buildBaseSystemPrompt"],"sources":["../../../../src/agent/prompt/service-prompt-builder.ts"],"sourcesContent":["/**\n * System Prompt Builder - Builds the complete system prompt\n *\n * Combines base system prompt with skill prompts and bootstrap Project Context.\n */\n\nimport type { Config } from '../../config/schema.js';\nimport { getUserTrustPolicy, isXopcDatabaseOpen } from '../../storage/sqlite/index.js';\nimport {\n  buildActionTrustPrompt,\n  DEFAULT_USER_TRUST_LEVEL,\n} from '../../user-context/trust-policy.js';\nimport type { EmbeddedContextFile } from '../bootstrap/types.js';\nimport type { SkillManager } from '../skills/skill-manager.js';\nimport { buildSystemPrompt as buildBaseSystemPrompt } from './system-prompt.js';\nimport { resolveSystemPromptBuildParams } from './system-prompt-params.js';\nimport type { PromptMode, SilentReplyPromptMode } from './types.js';\nimport type { ProviderSystemPromptContribution } from './contribution.js';\nimport { mergeTtsConfigFromAppConfig } from '../../voice/tts/merge-config.js';\nimport { buildTtsSystemPromptHint } from '../../voice/tts/directives.js';\nimport { createLogger } from '../../utils/logger.js';\n\nconst log = createLogger('SystemPromptBuilder');\n\nexport interface SystemPromptBuildOptions {\n  externalMemoryInstructions?: string;\n  workspaceOverride?: string;\n  profileMarkdownPathRoot?: string;\n  systemPromptOverride?: string;\n  skillPromptText?: string;\n  skillAllowlist?: string[];\n  registeredToolNames?: string[];\n  toolSummaries?: Record<string, string>;\n  sessionKey?: string;\n  promptMode?: PromptMode;\n  modelRef?: string;\n  agentId?: string;\n  thinkingLevel?: string;\n  extraSystemPrompt?: string;\n  activeProjectContext?: string;\n  silentReplyPromptMode?: SilentReplyPromptMode;\n  promptContribution?: ProviderSystemPromptContribution;\n}\n\nexport interface SystemPromptBuilderConfig {\n  workspace: string;\n  config: Config;\n  skillManager: SkillManager;\n}\n\nexport class SystemPromptBuilder {\n  private workspace: string;\n  private config: Config;\n  private skillManager: SkillManager;\n\n  constructor(config: SystemPromptBuilderConfig) {\n    this.workspace = config.workspace;\n    this.config = config.config;\n    this.skillManager = config.skillManager;\n  }\n\n  build(contextFiles: EmbeddedContextFile[], options: SystemPromptBuildOptions): string {\n    const ws = options.workspaceOverride ?? this.workspace;\n    const actionTrustLevel = isXopcDatabaseOpen()\n      ? getUserTrustPolicy().defaultActionLevel\n      : DEFAULT_USER_TRUST_LEVEL;\n    if (options.systemPromptOverride?.trim()) {\n      const skillPrompt =\n        options.skillPromptText !== undefined\n          ? options.skillPromptText\n          : this.skillManager.getPromptForSkillAllowlist(\n              options.skillAllowlist,\n              options.registeredToolNames,\n            );\n      const trimmed = options.systemPromptOverride.trim();\n      let fullPrompt = skillPrompt.trim() ? `${trimmed}\\n\\n${skillPrompt}` : trimmed;\n      const ttsMerged = mergeTtsConfigFromAppConfig(this.config.messages?.tts);\n      const reg = options.registeredToolNames ?? [];\n      const ttsHint = buildTtsSystemPromptHint({\n        enabled: ttsMerged.enabled,\n        trigger: ttsMerged.trigger,\n        maxTextLength: ttsMerged.maxTextLength,\n        modelOverrides: ttsMerged.modelOverrides,\n        textToSpeechTool: ttsMerged.enabled && reg.includes('text_to_speech'),\n      });\n      if (ttsHint?.trim()) {\n        fullPrompt = `${fullPrompt}\\n\\n## Voice (TTS)\\n\\n${ttsHint.trim()}`;\n      }\n      fullPrompt = `${fullPrompt}\\n\\n${buildActionTrustPrompt(actionTrustLevel)}`;\n      log.debug({ baseLength: trimmed.length, skillLength: skillPrompt.length, totalLength: fullPrompt.length }, 'System prompt built (override)');\n      return fullPrompt;\n    }\n\n    const heartbeatEnabled = this.config.gateway?.heartbeat?.includeSystemPromptSection ?? false;\n    const userTimezone = this.extractTimezone(contextFiles);\n\n    const ttsMerged = mergeTtsConfigFromAppConfig(this.config.messages?.tts);\n    const reg = options.registeredToolNames ?? [];\n    const ttsSystemHint = buildTtsSystemPromptHint({\n      enabled: ttsMerged.enabled,\n      trigger: ttsMerged.trigger,\n      maxTextLength: ttsMerged.maxTextLength,\n      modelOverrides: ttsMerged.modelOverrides,\n      textToSpeechTool: ttsMerged.enabled && reg.includes('text_to_speech'),\n    });\n\n    const resolved = resolveSystemPromptBuildParams(this.config, {\n      workspaceDir: ws,\n      sessionKey: options.sessionKey,\n      toolNames: options.registeredToolNames,\n      toolSummaries: options.toolSummaries,\n      userTimezone,\n      externalMemoryInstructions: options.externalMemoryInstructions,\n      heartbeatEnabled,\n      ttsSystemHint,\n      extraSystemPrompt: options.extraSystemPrompt,\n      activeProjectContext: options.activeProjectContext,\n      modelRef: options.modelRef,\n      agentId: options.agentId,\n      thinkingLevel: options.thinkingLevel,\n      promptMode: options.promptMode,\n      silentReplyPromptMode: options.silentReplyPromptMode,\n      promptContribution: options.promptContribution,\n    });\n\n    const basePrompt = buildBaseSystemPrompt(ws, {\n      contextFiles,\n      promptMode: resolved.promptMode,\n      heartbeatEnabled: resolved.heartbeatEnabled,\n      heartbeatPrompt: resolved.heartbeatPrompt,\n      toolNames: resolved.toolNames,\n      toolSummaries: resolved.toolSummaries,\n      memoryCitationsMode: resolved.memoryCitationsMode,\n      includeMemorySection: resolved.includeMemorySection,\n      userTimezone: resolved.userTimezone,\n      runtime: resolved.runtimeInfo,\n      agentId: options.agentId,\n      channels: resolved.channels,\n      externalMemoryInstructions: resolved.externalMemoryInstructions,\n      ttsSystemHint: resolved.ttsSystemHint,\n      extraSystemPrompt: resolved.extraSystemPrompt,\n      activeProjectContext: resolved.activeProjectContext,\n      silentReplyPromptMode: resolved.silentReplyPromptMode,\n      promptContribution: resolved.promptContribution,\n      includeProblemSolving: resolved.includeProblemSolving,\n      includeToneSection: resolved.includeToneSection,\n      actionTrustLevel,\n    });\n\n    const skillPrompt =\n      options.skillPromptText !== undefined\n        ? options.skillPromptText\n        : this.skillManager.getPromptForSkillAllowlist(\n            options.skillAllowlist,\n            options.registeredToolNames,\n          );\n\n    const fullPrompt = skillPrompt ? `${basePrompt}\\n\\n${skillPrompt}` : basePrompt;\n\n    log.debug(\n      {\n        baseLength: basePrompt.length,\n        skillLength: skillPrompt?.length || 0,\n        totalLength: fullPrompt.length,\n        contextFileCount: contextFiles.length,\n        promptMode: resolved.promptMode,\n        toolCount: resolved.toolNames?.length ?? 0,\n      },\n      'System prompt built',\n    );\n\n    return fullPrompt;\n  }\n\n  rebuild(contextFiles: EmbeddedContextFile[], options: SystemPromptBuildOptions): string {\n    this.skillManager.reload();\n    return this.build(contextFiles, options);\n  }\n\n  private extractTimezone(contextFiles: EmbeddedContextFile[]): string | undefined {\n    const userContext = contextFiles.find((file) =>\n      file.path.replace(/\\\\/g, '/').toLowerCase().endsWith('/user/profile.md'),\n    );\n    if (userContext?.content) {\n      const match = userContext.content.match(/Timezone:\\s*(.+)/i);\n      if (match) {\n        return match[1].trim();\n      }\n    }\n\n    return undefined;\n  }\n\n  getSkillPrompt(): string {\n    return this.skillManager.getPrompt();\n  }\n\n  getBasePrompt(\n    contextFiles: EmbeddedContextFile[],\n    options?: {\n      externalMemoryInstructions?: string;\n      workspaceOverride?: string;\n      profileMarkdownPathRoot?: string;\n      registeredToolNames?: string[];\n      sessionKey?: string;\n    },\n  ): string {\n    const ws = options?.workspaceOverride ?? this.workspace;\n    const resolved = resolveSystemPromptBuildParams(this.config, {\n      workspaceDir: ws,\n      sessionKey: options?.sessionKey,\n      toolNames: options?.registeredToolNames,\n      userTimezone: this.extractTimezone(contextFiles),\n      externalMemoryInstructions: options?.externalMemoryInstructions,\n      heartbeatEnabled: this.config.gateway?.heartbeat?.includeSystemPromptSection ?? false,\n    });\n    return buildBaseSystemPrompt(ws, {\n      contextFiles,\n      promptMode: resolved.promptMode,\n      heartbeatEnabled: resolved.heartbeatEnabled,\n      toolNames: resolved.toolNames,\n      userTimezone: resolved.userTimezone,\n      runtime: resolved.runtimeInfo,\n      channels: resolved.channels,\n      externalMemoryInstructions: resolved.externalMemoryInstructions,\n    });\n  }\n}\n\nexport function createSystemPromptBuilder(config: SystemPromptBuilderConfig): SystemPromptBuilder {\n  return new SystemPromptBuilder(config);\n}\n\nexport type { SystemPromptBuilderConfig as SystemPromptConfig };\nexport type { SystemPromptBuilderConfig as SystemPromptBuilderOptions };\n"],"mappings":"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"}

package/dist/src/agent/prompt/system-prompt.d.ts

@@ -6,6 +6,7 @@
  * not to manually reread startup files.
  */
 import type { EmbeddedContextFile } from '../bootstrap/types.js';
+import { type UserTrustLevel } from '../../user-context/trust-policy.js';
 import type { ProviderSystemPromptContribution } from './contribution.js';
 import { type RuntimeInfoInput } from './sections/workspace-runtime.js';
 import type { MemoryCitationsMode, PromptMode, SilentReplyPromptMode } from './types.js';
@@ -35,6 +36,7 @@ export interface SystemPromptOptions {
     promptContribution?: ProviderSystemPromptContribution;
     includeProblemSolving?: boolean;
     includeToneSection?: boolean;
+    actionTrustLevel?: UserTrustLevel;
 }
 /**
  * Build system prompt with bootstrap Project Context integration.

package/dist/src/agent/prompt/system-prompt.js

@@ -1,5 +1,6 @@
+import { buildActionTrustPrompt } from "../../user-context/trust-policy.js";
 import { PROMPT_CACHE_BOUNDARY, splitPromptCacheBoundary } from "./cache-boundary.js";
-import { buildAestheticSection, buildExecutionBiasSection, buildProblemSolvingSection, buildSafetySection, buildToolCallStyleSection } from "./sections/behavior.js";
+import { buildAestheticSection, buildExecutionBiasSection, buildHumanCollaborationSection, buildProblemSolvingSection, buildSafetySection, buildToolCallStyleSection, buildWorkContinuitySection } from "./sections/behavior.js";
 import { buildExternalMemorySection, buildMemorySection, buildSkillsSection } from "./sections/memory-skills.js";
 import { buildHeartbeatBehaviorSection, buildMessagingSection, buildOutputDirectivesSection, buildSilentRepliesSection, buildTimeSection } from "./sections/messaging-runtime.js";
 import { buildProjectContextSection, getContextFileBasename, isDynamicContextFile, sortContextFilesForPrompt } from "./sections/project-context.js";
@@ -14,7 +15,7 @@ function joinSections(sections) {
 * Build system prompt with bootstrap Project Context integration.
 */
 function buildSystemPrompt(workspaceDir, options = {}) {
-	const { contextFiles = [], promptMode = "full", heartbeatEnabled = false, heartbeatPrompt, toolNames: toolNamesOption, toolSummaries, availableTools = [], memoryCitationsMode = "on", includeMemorySection, userTimezone, runtime, agentId, channels = [], externalMemoryInstructions, ttsSystemHint, extraSystemPrompt, activeProjectContext, silentReplyPromptMode = "generic", promptContribution, includeProblemSolving = true, includeToneSection = true } = options;
+	const { contextFiles = [], promptMode = "full", heartbeatEnabled = false, heartbeatPrompt, toolNames: toolNamesOption, toolSummaries, availableTools = [], memoryCitationsMode = "on", includeMemorySection, userTimezone, runtime, agentId, channels = [], externalMemoryInstructions, ttsSystemHint, extraSystemPrompt, activeProjectContext, silentReplyPromptMode = "generic", promptContribution, includeProblemSolving = true, includeToneSection = true, actionTrustLevel } = options;
 	if (promptMode === "none") return "You are a personal AI assistant running inside xopc.";
 	const isMinimal = promptMode === "minimal";
 	const toolNames = toolNamesOption ?? availableTools;
@@ -46,6 +47,7 @@ function buildSystemPrompt(workspaceDir, options = {}) {
 	});
 	if (providerStablePrefix) stableSections.push(providerStablePrefix);
 	stableSections.push(buildSafetySection());
+	if (actionTrustLevel) stableSections.push(buildActionTrustPrompt(actionTrustLevel));
 	if (effectiveAgentId?.toLowerCase() === "coder") stableSections.push(buildCoderHarnessSection());
 	if (hasSkillsTools(toolNames)) stableSections.push(buildSkillsSection(true));
 	if (!isMinimal) {
@@ -56,7 +58,8 @@ function buildSystemPrompt(workspaceDir, options = {}) {
 			includeMemorySection
 		}), buildExternalMemorySection(externalMemoryInstructions));
 		if (includeProblemSolving) stableSections.push(buildProblemSolvingSection());
-		if (includeToneSection) stableSections.push(buildAestheticSection());
+		if (includeToneSection) stableSections.push(buildAestheticSection(), buildHumanCollaborationSection());
+		stableSections.push(buildWorkContinuitySection());
 		stableSections.push(buildTimeSection(userTimezone));
 	}
 	stableSections.push(buildWorkspaceSection(workspaceDir), buildWorkspaceFilesIntroSection());