@xopcai/xopc 0.0.110 → 0.0.112

package/dist/src/agent/goals/state.js

@@ -1,99 +1,10 @@
 import { CHECKLIST_ITEM_PENDING, TERMINAL_CHECKLIST_STATUSES } from "./checklist-types.js";
 //#region src/agent/goals/state.ts
-/** Persisted under `SessionMetadata.customData.persistentGoal`. */
-const PERSISTENT_GOAL_CUSTOM_KEY = "persistentGoal";
 function defaultMaxTurns(cfg) {
 	const n = cfg?.maxTurns;
 	if (typeof n === "number" && Number.isFinite(n)) return Math.max(1, Math.min(500, Math.floor(n)));
 	return 20;
 }
-function coerceStatus(s) {
-	if (s === "active" || s === "paused" || s === "done" || s === "cleared") return s;
-}
-function coerceChecklistItem(raw) {
-	if (!raw || typeof raw !== "object" || Array.isArray(raw)) return null;
-	const r = raw;
-	const text = typeof r.text === "string" ? r.text.trim() : "";
-	if (!text) return null;
-	const st = typeof r.status === "string" ? r.status.trim().toLowerCase() : "";
-	return {
-		text,
-		status: st === "completed" || st === "impossible" || st === "pending" ? st : CHECKLIST_ITEM_PENDING,
-		addedBy: (typeof r.addedBy === "string" ? r.addedBy.trim().toLowerCase() : "") === "user" ? "user" : "judge",
-		addedAt: typeof r.addedAt === "number" && Number.isFinite(r.addedAt) ? Math.floor(r.addedAt) : Date.now(),
-		completedAt: typeof r.completedAt === "number" && Number.isFinite(r.completedAt) ? Math.floor(r.completedAt) : void 0,
-		evidence: typeof r.evidence === "string" ? r.evidence : void 0
-	};
-}
-function readPersistentGoal(customData) {
-	if (!customData || typeof customData !== "object") return null;
-	const raw = customData[PERSISTENT_GOAL_CUSTOM_KEY];
-	if (raw && typeof raw === "object" && !Array.isArray(raw)) {
-		const o = raw;
-		const goal = typeof o.goal === "string" ? o.goal.trim() : "";
-		if (!goal) return null;
-		const status = coerceStatus(o.status) ?? "active";
-		const maxTurns = typeof o.maxTurns === "number" && Number.isFinite(o.maxTurns) ? Math.max(1, Math.min(500, Math.floor(o.maxTurns))) : 20;
-		const turnsUsed = typeof o.turnsUsed === "number" && Number.isFinite(o.turnsUsed) ? Math.max(0, Math.floor(o.turnsUsed)) : 0;
-		const createdAt = typeof o.createdAt === "number" && Number.isFinite(o.createdAt) ? o.createdAt : Date.now();
-		const lastTurnAt = typeof o.lastTurnAt === "number" && Number.isFinite(o.lastTurnAt) ? o.lastTurnAt : 0;
-		const lastVerdict = o.lastVerdict === "done" || o.lastVerdict === "continue" || o.lastVerdict === "skipped" || o.lastVerdict === "decompose" ? o.lastVerdict : void 0;
-		const lastReason = typeof o.lastReason === "string" ? o.lastReason : void 0;
-		const pausedReason = typeof o.pausedReason === "string" ? o.pausedReason : void 0;
-		const judgeModelRef = typeof o.judgeModelRef === "string" ? o.judgeModelRef.trim() : void 0;
-		const consecutiveParseFailures = typeof o.consecutiveParseFailures === "number" && Number.isFinite(o.consecutiveParseFailures) ? Math.max(0, Math.floor(o.consecutiveParseFailures)) : 0;
-		const decomposed = Boolean(o.decomposed);
-		const uiLocale = o.uiLocale === "zh" || o.uiLocale === "en" ? o.uiLocale : void 0;
-		const checklistRaw = o.checklist;
-		const checklist = [];
-		if (Array.isArray(checklistRaw)) for (const row of checklistRaw) {
-			const it = coerceChecklistItem(row);
-			if (it) checklist.push(it);
-		}
-		return {
-			goal,
-			status,
-			turnsUsed,
-			maxTurns,
-			createdAt,
-			lastTurnAt,
-			lastVerdict,
-			lastReason,
-			pausedReason,
-			judgeModelRef: judgeModelRef || void 0,
-			consecutiveParseFailures,
-			decomposed: decomposed || void 0,
-			checklist: checklist.length ? checklist : void 0,
-			uiLocale
-		};
-	}
-	return null;
-}
-function serializePersistentGoal(s) {
-	return {
-		goal: s.goal,
-		status: s.status,
-		turnsUsed: s.turnsUsed,
-		maxTurns: s.maxTurns,
-		createdAt: s.createdAt,
-		lastTurnAt: s.lastTurnAt,
-		...s.lastVerdict ? { lastVerdict: s.lastVerdict } : {},
-		...s.lastReason ? { lastReason: s.lastReason } : {},
-		...s.pausedReason ? { pausedReason: s.pausedReason } : {},
-		...s.judgeModelRef ? { judgeModelRef: s.judgeModelRef } : {},
-		...s.consecutiveParseFailures ? { consecutiveParseFailures: s.consecutiveParseFailures } : {},
-		...s.decomposed ? { decomposed: true } : {},
-		...s.uiLocale ? { uiLocale: s.uiLocale } : {},
-		...s.checklist?.length ? { checklist: s.checklist.map((it) => ({
-			text: it.text,
-			status: it.status,
-			addedBy: it.addedBy,
-			addedAt: it.addedAt,
-			...it.completedAt !== void 0 ? { completedAt: it.completedAt } : {},
-			...it.evidence ? { evidence: it.evidence } : {}
-		})) } : {}
-	};
-}
 /** Render checklist for continuation prompt (Hermes-style, no numbers in body). */
 function renderChecklistPlain(items) {
 	if (!items.length) return "(empty)";
@@ -165,13 +76,7 @@ function applyJudgeChecklistUpdates(items, parsed) {
 	}
 	return next;
 }
-function mergeCustomDataPatch(existingCustom, patch) {
-	return {
-		...existingCustom ?? {},
-		...patch
-	};
-}
 //#endregion
-export { PERSISTENT_GOAL_CUSTOM_KEY, applyJudgeChecklistUpdates, defaultMaxTurns, mergeCustomDataPatch, mergeDecomposedChecklistItems, readPersistentGoal, renderChecklistNumbered, renderChecklistPlain, serializePersistentGoal };
+export { applyJudgeChecklistUpdates, defaultMaxTurns, mergeDecomposedChecklistItems, renderChecklistNumbered, renderChecklistPlain };
 
 //# sourceMappingURL=state.js.map

package/dist/src/agent/goals/state.js.map

@@ -1 +1 @@
-{"version":3,"file":"state.js","names":[],"sources":["../../../../src/agent/goals/state.ts"],"sourcesContent":["import {\n  CHECKLIST_ITEM_PENDING,\n  TERMINAL_CHECKLIST_STATUSES,\n  type ChecklistItemAddedBy,\n  type ChecklistItemStatus,\n  type GoalChecklistItem,\n} from './checklist-types.js';\n\n// Direct import of the underlying locale type — `goal-locale.ts` aliases this as\n// `GoalUiLocale` AND imports values from `state.ts`, so going through `./goal-locale.js`\n// would create a circular module cycle.\nimport type { ServerLocale as GoalUiLocale } from '../../i18n/locale.js';\n\n/** Persisted under `SessionMetadata.customData.persistentGoal`. */\nexport const PERSISTENT_GOAL_CUSTOM_KEY = 'persistentGoal';\n\nexport type PersistentGoalStatus = 'active' | 'paused' | 'done' | 'cleared';\n\nexport interface PersistentGoalState {\n  goal: string;\n  status: PersistentGoalStatus;\n  turnsUsed: number;\n  maxTurns: number;\n  createdAt: number;\n  lastTurnAt: number;\n  lastVerdict?: 'done' | 'continue' | 'skipped' | 'decompose';\n  lastReason?: string;\n  pausedReason?: string;\n  judgeModelRef?: string;\n  /** Hermes-style: judge JSON parse failures in a row (API errors do not increment). */\n  consecutiveParseFailures?: number;\n  /** After first successful decomposition, checklist drives Phase-B judging. */\n  decomposed?: boolean;\n  checklist?: GoalChecklistItem[];\n  /** Gateway console language: drives judge `reason` language and system messages. */\n  uiLocale?: GoalUiLocale;\n}\n\nexport function defaultMaxTurns(cfg: { maxTurns?: number } | undefined): number {\n  const n = cfg?.maxTurns;\n  if (typeof n === 'number' && Number.isFinite(n)) {\n    return Math.max(1, Math.min(500, Math.floor(n)));\n  }\n  return 20;\n}\n\nfunction coerceStatus(s: unknown): PersistentGoalStatus | undefined {\n  if (s === 'active' || s === 'paused' || s === 'done' || s === 'cleared') return s;\n  return undefined;\n}\n\nfunction coerceChecklistItem(raw: unknown): GoalChecklistItem | null {\n  if (!raw || typeof raw !== 'object' || Array.isArray(raw)) return null;\n  const r = raw as Record<string, unknown>;\n  const text = typeof r.text === 'string' ? r.text.trim() : '';\n  if (!text) return null;\n  const st = typeof r.status === 'string' ? r.status.trim().toLowerCase() : '';\n  const status: ChecklistItemStatus =\n    st === 'completed' || st === 'impossible' || st === 'pending' ? st : CHECKLIST_ITEM_PENDING;\n  const ab = typeof r.addedBy === 'string' ? r.addedBy.trim().toLowerCase() : '';\n  const addedBy: ChecklistItemAddedBy = ab === 'user' ? 'user' : 'judge';\n  const addedAt =\n    typeof r.addedAt === 'number' && Number.isFinite(r.addedAt) ? Math.floor(r.addedAt) : Date.now();\n  const completedAt =\n    typeof r.completedAt === 'number' && Number.isFinite(r.completedAt) ? Math.floor(r.completedAt) : undefined;\n  const evidence = typeof r.evidence === 'string' ? r.evidence : undefined;\n  return { text, status, addedBy, addedAt, completedAt, evidence };\n}\n\nexport function readPersistentGoal(customData: Record<string, unknown> | undefined): PersistentGoalState | null {\n  if (!customData || typeof customData !== 'object') return null;\n\n  const raw = customData[PERSISTENT_GOAL_CUSTOM_KEY];\n  if (raw && typeof raw === 'object' && !Array.isArray(raw)) {\n    const o = raw as Record<string, unknown>;\n    const goal = typeof o.goal === 'string' ? o.goal.trim() : '';\n    if (!goal) return null;\n    const status = coerceStatus(o.status) ?? 'active';\n    const maxTurns =\n      typeof o.maxTurns === 'number' && Number.isFinite(o.maxTurns)\n        ? Math.max(1, Math.min(500, Math.floor(o.maxTurns)))\n        : 20;\n    const turnsUsed =\n      typeof o.turnsUsed === 'number' && Number.isFinite(o.turnsUsed)\n        ? Math.max(0, Math.floor(o.turnsUsed))\n        : 0;\n    const createdAt =\n      typeof o.createdAt === 'number' && Number.isFinite(o.createdAt) ? o.createdAt : Date.now();\n    const lastTurnAt =\n      typeof o.lastTurnAt === 'number' && Number.isFinite(o.lastTurnAt) ? o.lastTurnAt : 0;\n    const lastVerdict =\n      o.lastVerdict === 'done' ||\n      o.lastVerdict === 'continue' ||\n      o.lastVerdict === 'skipped' ||\n      o.lastVerdict === 'decompose'\n        ? o.lastVerdict\n        : undefined;\n    const lastReason = typeof o.lastReason === 'string' ? o.lastReason : undefined;\n    const pausedReason = typeof o.pausedReason === 'string' ? o.pausedReason : undefined;\n    const judgeModelRef = typeof o.judgeModelRef === 'string' ? o.judgeModelRef.trim() : undefined;\n    const consecutiveParseFailures =\n      typeof o.consecutiveParseFailures === 'number' && Number.isFinite(o.consecutiveParseFailures)\n        ? Math.max(0, Math.floor(o.consecutiveParseFailures))\n        : 0;\n    const decomposed = Boolean(o.decomposed);\n    const uiLocale = o.uiLocale === 'zh' || o.uiLocale === 'en' ? o.uiLocale : undefined;\n    const checklistRaw = o.checklist;\n    const checklist: GoalChecklistItem[] = [];\n    if (Array.isArray(checklistRaw)) {\n      for (const row of checklistRaw) {\n        const it = coerceChecklistItem(row);\n        if (it) checklist.push(it);\n      }\n    }\n    return {\n      goal,\n      status,\n      turnsUsed,\n      maxTurns,\n      createdAt,\n      lastTurnAt,\n      lastVerdict,\n      lastReason,\n      pausedReason,\n      judgeModelRef: judgeModelRef || undefined,\n      consecutiveParseFailures,\n      decomposed: decomposed || undefined,\n      checklist: checklist.length ? checklist : undefined,\n      uiLocale,\n    };\n  }\n\n  return null;\n}\n\nexport function serializePersistentGoal(s: PersistentGoalState): Record<string, unknown> {\n  return {\n    goal: s.goal,\n    status: s.status,\n    turnsUsed: s.turnsUsed,\n    maxTurns: s.maxTurns,\n    createdAt: s.createdAt,\n    lastTurnAt: s.lastTurnAt,\n    ...(s.lastVerdict ? { lastVerdict: s.lastVerdict } : {}),\n    ...(s.lastReason ? { lastReason: s.lastReason } : {}),\n    ...(s.pausedReason ? { pausedReason: s.pausedReason } : {}),\n    ...(s.judgeModelRef ? { judgeModelRef: s.judgeModelRef } : {}),\n    ...(s.consecutiveParseFailures ? { consecutiveParseFailures: s.consecutiveParseFailures } : {}),\n    ...(s.decomposed ? { decomposed: true } : {}),\n    ...(s.uiLocale ? { uiLocale: s.uiLocale } : {}),\n    ...(s.checklist?.length\n      ? {\n          checklist: s.checklist.map((it) => ({\n            text: it.text,\n            status: it.status,\n            addedBy: it.addedBy,\n            addedAt: it.addedAt,\n            ...(it.completedAt !== undefined ? { completedAt: it.completedAt } : {}),\n            ...(it.evidence ? { evidence: it.evidence } : {}),\n          })),\n        }\n      : {}),\n  };\n}\n\n/** Render checklist for continuation prompt (Hermes-style, no numbers in body). */\nexport function renderChecklistPlain(items: GoalChecklistItem[]): string {\n  if (!items.length) return '(empty)';\n  const lines: string[] = [];\n  for (const it of items) {\n    const marker =\n      it.status === 'completed' ? '[x]' : it.status === 'impossible' ? '[!]' : '[ ]';\n    let line = `${marker} ${it.text}`;\n    if (it.status === 'impossible' && it.evidence) line += ` (impossible: ${it.evidence})`;\n    lines.push(line);\n  }\n  return lines.join('\\n');\n}\n\n/** Numbered checklist for judge user prompts (1-based indices). */\nexport function renderChecklistNumbered(items: GoalChecklistItem[]): string {\n  if (!items.length) return '(empty)';\n  const lines: string[] = [];\n  for (let i = 0; i < items.length; i++) {\n    const it = items[i]!;\n    const n = i + 1;\n    const marker =\n      it.status === 'completed' ? '[x]' : it.status === 'impossible' ? '[!]' : '[ ]';\n    let line = `${n}. ${marker} ${it.text}`;\n    if (it.status === 'impossible' && it.evidence) line += ` (impossible: ${it.evidence})`;\n    lines.push(line);\n  }\n  return lines.join('\\n');\n}\n\n/**\n * After LLM decomposition, keep existing checklist rows (e.g. user-added acceptance criteria)\n * and append judge-generated items, skipping duplicate text (case-insensitive trim).\n */\nexport function mergeDecomposedChecklistItems(\n  existing: GoalChecklistItem[],\n  decomposedTexts: { text: string }[],\n): GoalChecklistItem[] {\n  const now = Date.now();\n  const next = existing.map((it) => ({ ...it }));\n  const seen = new Set(next.map((it) => it.text.trim().toLowerCase()));\n  for (const row of decomposedTexts) {\n    const t = row.text.trim();\n    if (!t) continue;\n    const key = t.toLowerCase();\n    if (seen.has(key)) continue;\n    seen.add(key);\n    next.push({\n      text: t,\n      status: CHECKLIST_ITEM_PENDING,\n      addedBy: 'judge',\n      addedAt: now,\n    });\n  }\n  return next;\n}\n\nexport function applyJudgeChecklistUpdates(\n  items: GoalChecklistItem[],\n  parsed: {\n    updates: { index: number; status: ChecklistItemStatus; evidence?: string | null }[];\n    newItems: { text: string }[];\n  },\n): GoalChecklistItem[] {\n  const next = items.map((it) => ({ ...it }));\n  const now = Date.now();\n  for (const upd of parsed.updates) {\n    const idx = upd.index;\n    if (idx < 0 || idx >= next.length) continue;\n    const item = next[idx]!;\n    if (TERMINAL_CHECKLIST_STATUSES.has(item.status)) continue;\n    if (!TERMINAL_CHECKLIST_STATUSES.has(upd.status)) continue;\n    item.status = upd.status;\n    item.completedAt = now;\n    if (upd.evidence?.trim()) item.evidence = upd.evidence.trim();\n  }\n  for (const ni of parsed.newItems) {\n    const t = ni.text.trim();\n    if (!t) continue;\n    next.push({\n      text: t,\n      status: CHECKLIST_ITEM_PENDING,\n      addedBy: 'judge',\n      addedAt: now,\n    });\n  }\n  return next;\n}\n\n\nexport function mergeCustomDataPatch(\n  existingCustom: Record<string, unknown> | undefined,\n  patch: Record<string, unknown>,\n): Record<string, unknown> {\n  return { ...(existingCustom ?? {}), ...patch };\n}\n"],"mappings":"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"}
+{"version":3,"file":"state.js","names":[],"sources":["../../../../src/agent/goals/state.ts"],"sourcesContent":["import {\n  CHECKLIST_ITEM_PENDING,\n  TERMINAL_CHECKLIST_STATUSES,\n  type ChecklistItemStatus,\n  type GoalChecklistItem,\n} from './checklist-types.js';\n\n// Direct import of the underlying locale type — `goal-locale.ts` aliases this as\n// `GoalUiLocale` AND imports values from `state.ts`, so going through `./goal-locale.js`\n// would create a circular module cycle.\nimport type { ServerLocale as GoalUiLocale } from '../../i18n/locale.js';\n\nexport type PersistentGoalStatus = 'active' | 'paused' | 'done' | 'cleared';\n\nexport interface PersistentGoalState {\n  goal: string;\n  status: PersistentGoalStatus;\n  turnsUsed: number;\n  maxTurns: number;\n  createdAt: number;\n  lastTurnAt: number;\n  lastVerdict?: 'done' | 'continue' | 'skipped' | 'decompose';\n  lastReason?: string;\n  pausedReason?: string;\n  judgeModelRef?: string;\n  /** Hermes-style: judge JSON parse failures in a row (API errors do not increment). */\n  consecutiveParseFailures?: number;\n  /** After first successful decomposition, checklist drives Phase-B judging. */\n  decomposed?: boolean;\n  checklist?: GoalChecklistItem[];\n  /** Gateway console language: drives judge `reason` language and system messages. */\n  uiLocale?: GoalUiLocale;\n}\n\nexport function defaultMaxTurns(cfg: { maxTurns?: number } | undefined): number {\n  const n = cfg?.maxTurns;\n  if (typeof n === 'number' && Number.isFinite(n)) {\n    return Math.max(1, Math.min(500, Math.floor(n)));\n  }\n  return 20;\n}\n\n/** Render checklist for continuation prompt (Hermes-style, no numbers in body). */\nexport function renderChecklistPlain(items: GoalChecklistItem[]): string {\n  if (!items.length) return '(empty)';\n  const lines: string[] = [];\n  for (const it of items) {\n    const marker =\n      it.status === 'completed' ? '[x]' : it.status === 'impossible' ? '[!]' : '[ ]';\n    let line = `${marker} ${it.text}`;\n    if (it.status === 'impossible' && it.evidence) line += ` (impossible: ${it.evidence})`;\n    lines.push(line);\n  }\n  return lines.join('\\n');\n}\n\n/** Numbered checklist for judge user prompts (1-based indices). */\nexport function renderChecklistNumbered(items: GoalChecklistItem[]): string {\n  if (!items.length) return '(empty)';\n  const lines: string[] = [];\n  for (let i = 0; i < items.length; i++) {\n    const it = items[i]!;\n    const n = i + 1;\n    const marker =\n      it.status === 'completed' ? '[x]' : it.status === 'impossible' ? '[!]' : '[ ]';\n    let line = `${n}. ${marker} ${it.text}`;\n    if (it.status === 'impossible' && it.evidence) line += ` (impossible: ${it.evidence})`;\n    lines.push(line);\n  }\n  return lines.join('\\n');\n}\n\n/**\n * After LLM decomposition, keep existing checklist rows (e.g. user-added acceptance criteria)\n * and append judge-generated items, skipping duplicate text (case-insensitive trim).\n */\nexport function mergeDecomposedChecklistItems(\n  existing: GoalChecklistItem[],\n  decomposedTexts: { text: string }[],\n): GoalChecklistItem[] {\n  const now = Date.now();\n  const next = existing.map((it) => ({ ...it }));\n  const seen = new Set(next.map((it) => it.text.trim().toLowerCase()));\n  for (const row of decomposedTexts) {\n    const t = row.text.trim();\n    if (!t) continue;\n    const key = t.toLowerCase();\n    if (seen.has(key)) continue;\n    seen.add(key);\n    next.push({\n      text: t,\n      status: CHECKLIST_ITEM_PENDING,\n      addedBy: 'judge',\n      addedAt: now,\n    });\n  }\n  return next;\n}\n\nexport function applyJudgeChecklistUpdates(\n  items: GoalChecklistItem[],\n  parsed: {\n    updates: { index: number; status: ChecklistItemStatus; evidence?: string | null }[];\n    newItems: { text: string }[];\n  },\n): GoalChecklistItem[] {\n  const next = items.map((it) => ({ ...it }));\n  const now = Date.now();\n  for (const upd of parsed.updates) {\n    const idx = upd.index;\n    if (idx < 0 || idx >= next.length) continue;\n    const item = next[idx]!;\n    if (TERMINAL_CHECKLIST_STATUSES.has(item.status)) continue;\n    if (!TERMINAL_CHECKLIST_STATUSES.has(upd.status)) continue;\n    item.status = upd.status;\n    item.completedAt = now;\n    if (upd.evidence?.trim()) item.evidence = upd.evidence.trim();\n  }\n  for (const ni of parsed.newItems) {\n    const t = ni.text.trim();\n    if (!t) continue;\n    next.push({\n      text: t,\n      status: CHECKLIST_ITEM_PENDING,\n      addedBy: 'judge',\n      addedAt: now,\n    });\n  }\n  return next;\n}\n"],"mappings":";;AAkCA,SAAgB,gBAAgB,KAAgD;CAC9E,MAAM,IAAI,KAAK;AACf,KAAI,OAAO,MAAM,YAAY,OAAO,SAAS,EAAE,CAC7C,QAAO,KAAK,IAAI,GAAG,KAAK,IAAI,KAAK,KAAK,MAAM,EAAE,CAAC,CAAC;AAElD,QAAO;;;AAIT,SAAgB,qBAAqB,OAAoC;AACvE,KAAI,CAAC,MAAM,OAAQ,QAAO;CAC1B,MAAM,QAAkB,EAAE;AAC1B,MAAK,MAAM,MAAM,OAAO;EAGtB,IAAI,OAAO,GADT,GAAG,WAAW,cAAc,QAAQ,GAAG,WAAW,eAAe,QAAQ,MACtD,GAAG,GAAG;AAC3B,MAAI,GAAG,WAAW,gBAAgB,GAAG,SAAU,SAAQ,iBAAiB,GAAG,SAAS;AACpF,QAAM,KAAK,KAAK;;AAElB,QAAO,MAAM,KAAK,KAAK;;;AAIzB,SAAgB,wBAAwB,OAAoC;AAC1E,KAAI,CAAC,MAAM,OAAQ,QAAO;CAC1B,MAAM,QAAkB,EAAE;AAC1B,MAAK,IAAI,IAAI,GAAG,IAAI,MAAM,QAAQ,KAAK;EACrC,MAAM,KAAK,MAAM;EAIjB,IAAI,OAAO,GAHD,IAAI,EAGE,IADd,GAAG,WAAW,cAAc,QAAQ,GAAG,WAAW,eAAe,QAAQ,MAChD,GAAG,GAAG;AACjC,MAAI,GAAG,WAAW,gBAAgB,GAAG,SAAU,SAAQ,iBAAiB,GAAG,SAAS;AACpF,QAAM,KAAK,KAAK;;AAElB,QAAO,MAAM,KAAK,KAAK;;;;;;AAOzB,SAAgB,8BACd,UACA,iBACqB;CACrB,MAAM,MAAM,KAAK,KAAK;CACtB,MAAM,OAAO,SAAS,KAAK,QAAQ,EAAE,GAAG,IAAI,EAAE;CAC9C,MAAM,OAAO,IAAI,IAAI,KAAK,KAAK,OAAO,GAAG,KAAK,MAAM,CAAC,aAAa,CAAC,CAAC;AACpE,MAAK,MAAM,OAAO,iBAAiB;EACjC,MAAM,IAAI,IAAI,KAAK,MAAM;AACzB,MAAI,CAAC,EAAG;EACR,MAAM,MAAM,EAAE,aAAa;AAC3B,MAAI,KAAK,IAAI,IAAI,CAAE;AACnB,OAAK,IAAI,IAAI;AACb,OAAK,KAAK;GACR,MAAM;GACN,QAAQ;GACR,SAAS;GACT,SAAS;GACV,CAAC;;AAEJ,QAAO;;AAGT,SAAgB,2BACd,OACA,QAIqB;CACrB,MAAM,OAAO,MAAM,KAAK,QAAQ,EAAE,GAAG,IAAI,EAAE;CAC3C,MAAM,MAAM,KAAK,KAAK;AACtB,MAAK,MAAM,OAAO,OAAO,SAAS;EAChC,MAAM,MAAM,IAAI;AAChB,MAAI,MAAM,KAAK,OAAO,KAAK,OAAQ;EACnC,MAAM,OAAO,KAAK;AAClB,MAAI,4BAA4B,IAAI,KAAK,OAAO,CAAE;AAClD,MAAI,CAAC,4BAA4B,IAAI,IAAI,OAAO,CAAE;AAClD,OAAK,SAAS,IAAI;AAClB,OAAK,cAAc;AACnB,MAAI,IAAI,UAAU,MAAM,CAAE,MAAK,WAAW,IAAI,SAAS,MAAM;;AAE/D,MAAK,MAAM,MAAM,OAAO,UAAU;EAChC,MAAM,IAAI,GAAG,KAAK,MAAM;AACxB,MAAI,CAAC,EAAG;AACR,OAAK,KAAK;GACR,MAAM;GACN,QAAQ;GACR,SAAS;GACT,SAAS;GACV,CAAC;;AAEJ,QAAO"}

package/dist/src/agent/image/load-image-media.js

@@ -1,8 +1,8 @@
 import { checkFileSafety } from "../prompt/safety.js";
 import { decodeDataUrl } from "./image-helpers.js";
-import { homedir } from "node:os";
-import path from "node:path";
 import { promises } from "node:fs";
+import path from "node:path";
+import { homedir } from "node:os";
 //#region src/agent/image/load-image-media.ts
 function expandUser(p) {
 	if (p.startsWith("~/") || p === "~") return path.join(homedir(), p.slice(1));

package/dist/src/agent/ipc/inbox.js

@@ -1,9 +1,9 @@
+import { init_write_file_atomic, writeTextAtomic } from "../../infra/write-file-atomic.js";
+import { init_paths, resolveAgentDir } from "../../config/paths.js";
 import { createLogger } from "../../utils/logger/index.js";
 import { init_logger } from "../../utils/logger.js";
-import { init_paths, resolveAgentDir } from "../../config/paths.js";
-import { init_write_file_atomic, writeTextAtomic } from "../../infra/write-file-atomic.js";
-import { join } from "path";
 import { existsSync, watch } from "fs";
+import { join } from "path";
 import { mkdir, readFile, readdir, rename } from "fs/promises";
 //#region src/agent/ipc/inbox.ts
 init_write_file_atomic();

package/dist/src/agent/ipc/socket.js

@@ -1,6 +1,6 @@
+import { init_paths, resolveSocketPath } from "../../config/paths.js";
 import { createLogger } from "../../utils/logger/index.js";
 import { init_logger } from "../../utils/logger.js";
-import { init_paths, resolveSocketPath } from "../../config/paths.js";
 import { isValidIPCMessage } from "./types.js";
 import { dirname } from "path";
 import { mkdir } from "fs/promises";

package/dist/src/agent/mcp/bundle-mcp-materialize.js

@@ -1,6 +1,6 @@
-import { init_string_coerce, normalizeLowercaseStringOrEmpty, normalizeOptionalString } from "../../utils/string-coerce.js";
 import { createLogger } from "../../utils/logger/index.js";
 import { init_logger } from "../../utils/logger.js";
+import { init_string_coerce, normalizeLowercaseStringOrEmpty, normalizeOptionalString } from "../../utils/string-coerce.js";
 import { buildSafeToolName, normalizeReservedToolNames } from "./bundle-mcp-names.js";
 import { setPluginToolMeta } from "./mcp-tool-meta.js";
 import crypto from "node:crypto";

package/dist/src/agent/mcp/bundle-mcp-runtime.js

@@ -1,6 +1,6 @@
-import { init_string_coerce, normalizeOptionalString } from "../../utils/string-coerce.js";
 import { createLogger } from "../../utils/logger/index.js";
 import { init_logger } from "../../utils/logger.js";
+import { init_string_coerce, normalizeOptionalString } from "../../utils/string-coerce.js";
 import { resolveGlobalSingleton } from "../../utils/global-singleton.js";
 import { sanitizeServerName } from "./bundle-mcp-names.js";
 import { redactSensitiveUrlLikeString } from "../../utils/redact-sensitive-url.js";

package/dist/src/agent/mcp/mcp-transport-config.js

@@ -1,6 +1,6 @@
-import { init_string_coerce, normalizeLowercaseStringOrEmpty } from "../../utils/string-coerce.js";
 import { createLogger } from "../../utils/logger/index.js";
 import { init_logger } from "../../utils/logger.js";
+import { init_string_coerce, normalizeLowercaseStringOrEmpty } from "../../utils/string-coerce.js";
 import { resolveXopcMcpTransportAlias } from "../../config/mcp-config-normalize.js";
 import { sanitizeForLog } from "../../utils/sanitize-log.js";
 import { describeHttpMcpServerLaunchConfig, resolveHttpMcpServerLaunchConfig } from "./mcp-http.js";

package/dist/src/agent/mcp/mcp-transport.js

@@ -1,6 +1,6 @@
-import { init_string_coerce, normalizeOptionalString } from "../../utils/string-coerce.js";
 import { createLogger } from "../../utils/logger/index.js";
 import { init_logger } from "../../utils/logger.js";
+import { init_string_coerce, normalizeOptionalString } from "../../utils/string-coerce.js";
 import { XopcStdioClientTransport } from "./mcp-stdio-transport.js";
 import { resolveMcpTransportConfig } from "./mcp-transport-config.js";
 import { SSEClientTransport } from "@modelcontextprotocol/sdk/client/sse.js";

package/dist/src/agent/memory/builtin-memory-store.js

@@ -1,6 +1,6 @@
-import { join } from "node:path";
 import { existsSync, mkdirSync, readFileSync } from "node:fs";
 import { mkdir, readFile, rename, writeFile } from "node:fs/promises";
+import { join } from "node:path";
 import lockfile from "proper-lockfile";
 //#region src/agent/memory/builtin-memory-store.ts
 /**

package/dist/src/agent/memory/dreaming/deep-promotion.js

@@ -4,8 +4,8 @@ import { MEMORY_MD_FILENAME } from "./constants.js";
 import { clamp01, compareCandidatesByScore, computeCandidateScore, extractPromotionMarkers, isContaminatedSnippet, isExpiredEntry, isoDay, readFileLines, resolveDeepDefaults, sliceRange, snippetHash } from "./utils.js";
 import { loadDreamingStore, saveDreamingStore, withDreamingPromotionLock } from "./short-term-store.js";
 import { emptyDeepPhaseSkipped, writeDreamingDeepLastRun } from "./last-run.js";
-import path from "node:path";
 import fs from "node:fs/promises";
+import path from "node:path";
 //#region src/agent/memory/dreaming/deep-promotion.ts
 init_logger();
 const log = createLogger("Dreaming:Deep");

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

@@ -1,6 +1,6 @@
 import { DREAMING_DIR_RELATIVE, DREAMING_EVENTS_LOG_RELATIVE } from "./constants.js";
-import path from "node:path";
 import fs from "node:fs/promises";
+import path from "node:path";
 //#region src/agent/memory/dreaming/events.ts
 /**
 * Append a single event line to `memory/.dreams/events.jsonl`.

package/dist/src/agent/memory/dreaming/last-run.js

@@ -1,6 +1,6 @@
 import { DREAMING_LAST_RUN_RELATIVE } from "./constants.js";
-import path from "node:path";
 import fs from "node:fs/promises";
+import path from "node:path";
 //#region src/agent/memory/dreaming/last-run.ts
 const DREAMING_LAST_RUN_FORMAT_VERSION = 2;
 function isRecord(v) {

package/dist/src/agent/memory/dreaming/light-sweep.js

@@ -4,8 +4,8 @@ import { DREAMING_DIR_RELATIVE } from "./constants.js";
 import { buildEntryKey, isoDay, normalizeMemoryPath, normalizeSnippetForHash, snippetHash } from "./utils.js";
 import { bumpEntryPhaseSignal, loadDreamingStore, saveDreamingStore } from "./short-term-store.js";
 import "./last-run.js";
-import path from "node:path";
 import fs from "node:fs/promises";
+import path from "node:path";
 //#region src/agent/memory/dreaming/light-sweep.ts
 init_logger();
 const log = createLogger("Dreaming:Light");

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

@@ -1,8 +1,8 @@
 import { MEMORY_MD_FILENAME } from "./constants.js";
 import { clamp01, compareCandidatesByScore, computeCandidateScore, extractPromotionMarkers, isContaminatedSnippet, isExpiredEntry, readFileLines, resolveDeepDefaults, sliceRange, snippetHash } from "./utils.js";
 import { loadDreamingStore } from "./short-term-store.js";
-import path from "node:path";
 import fs from "node:fs/promises";
+import path from "node:path";
 //#region src/agent/memory/dreaming/preview.ts
 async function previewDreamingDeepPromotion(params) {
 	const cfg = resolveDeepDefaults(params.config);

package/dist/src/agent/memory/dreaming/rem-patterns.js

@@ -4,8 +4,8 @@ import { DREAMING_DIR_RELATIVE, DREAMS_MD_FILENAME, MS_PER_DAY } from "./constan
 import { isoDay } from "./utils.js";
 import { bumpEntryPhaseSignal, loadDreamingStore, saveDreamingStore } from "./short-term-store.js";
 import "./last-run.js";
-import path from "node:path";
 import fs from "node:fs/promises";
+import path from "node:path";
 //#region src/agent/memory/dreaming/rem-patterns.ts
 init_logger();
 const log = createLogger("Dreaming:REM");

package/dist/src/agent/memory/dreaming/short-term-store.js

@@ -2,9 +2,9 @@ import { createLogger } from "../../../utils/logger/index.js";
 import { init_logger } from "../../../utils/logger.js";
 import { SHORT_TERM_PROMOTION_LOCK_RELATIVE, SHORT_TERM_RECALL_STORE_RELATIVE } from "./constants.js";
 import { buildEntryKey, clamp01, isoDay, normalizeMemoryPath } from "./utils.js";
-import path from "node:path";
 import { createHash, randomUUID } from "node:crypto";
 import fs from "node:fs/promises";
+import path from "node:path";
 //#region src/agent/memory/dreaming/short-term-store.ts
 init_logger();
 const log = createLogger("Dreaming:Store");

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

@@ -1,7 +1,7 @@
 import { DEFAULT_DEEP_CRON, DIVERSITY_WEIGHT, MS_PER_DAY, REINFORCEMENT_WEIGHT } from "./constants.js";
-import path from "node:path";
 import { createHash } from "node:crypto";
 import fs from "node:fs/promises";
+import path from "node:path";
 //#region src/agent/memory/dreaming/utils.ts
 /** Normalize a workspace-relative memory path: forward slashes, no odd ../ escapes at start. */
 function normalizeMemoryPath(rel) {

package/dist/src/agent/memory/memory-flush.js

@@ -1,8 +1,8 @@
 import { createLogger } from "../../utils/logger/index.js";
 import { init_logger } from "../../utils/logger.js";
-import { join } from "node:path";
 import { existsSync } from "node:fs";
 import { appendFile, mkdir, readFile, writeFile } from "node:fs/promises";
+import { join } from "node:path";
 //#region src/agent/memory/memory-flush.ts
 init_logger();
 const log = createLogger("MemoryFlush");

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

@@ -1,5 +1,5 @@
-import { dirname, join } from "node:path";
 import { readdir, stat } from "node:fs/promises";
+import { dirname, join } from "node:path";
 import { fileURLToPath } from "node:url";
 //#region src/agent/memory/plugin-discovery.ts
 async function discoverMemoryPlugins() {

package/dist/src/agent/messaging/command-handler.d.ts

@@ -9,6 +9,7 @@ import type { SessionConfigStore, SessionStore } from '../../session/index.js';
 import type { ThinkLevel } from '../transcript/thinking-types.js';
 import type { CompactionResult } from '../memory/compaction.js';
 import type { PersistentGoalApis } from '../goals/persistent-goal-apis.js';
+import type { WorkflowRunServiceLike } from '../../workflows/service/workflow-run-service.types.js';
 export interface CommandContext {
     sessionKey: string;
     channel: string;
@@ -36,6 +37,8 @@ export interface CommandHandlerConfig {
     } | null>;
     /** Cancel streaming preview + in-flight LLM work for this session (e.g. /abort) */
     abortSessionTurn?: (sessionKey: string) => Promise<void>;
+    /** Reload skills from disk and refresh active agent prompts. */
+    reloadSkills?: () => void | Promise<void>;
     compactSession?: (sessionKey: string, options?: {
         instructions?: string;
         force?: boolean;
@@ -51,6 +54,7 @@ export interface CommandHandlerConfig {
         chatId: string;
         inboundMetadata?: Record<string, unknown>;
     }) => PersistentGoalApis;
+    getWorkflowRunService?: () => WorkflowRunServiceLike | undefined;
 }
 export declare class CommandHandler {
     private config;
@@ -62,11 +66,13 @@ export declare class CommandHandler {
     private switchModelForSession;
     private invalidateAgentSession?;
     private abortSessionTurn?;
+    private reloadSkills?;
     private compactSession?;
     private btwQuery?;
     private getSessionContextReport?;
     private getPersistentGoalApisForCommand;
     private resetSession?;
+    private getWorkflowRunService?;
     constructor(handlerConfig: CommandHandlerConfig);
     /** Replace config reference after hot reload or gateway PATCH so commands see current defaults. */
     updateAgentConfig(config: Config): void;
@@ -86,5 +92,6 @@ export declare class CommandHandler {
     executeCommandAndAggregateReply(commandName: string, args: string, context: CommandContext): Promise<{
         handled: boolean;
         aggregatedText: string;
+        metadata?: Record<string, unknown>;
     }>;
 }

package/dist/src/agent/messaging/command-handler.js

@@ -22,11 +22,13 @@ var CommandHandler = class {
 	switchModelForSession;
 	invalidateAgentSession;
 	abortSessionTurn;
+	reloadSkills;
 	compactSession;
 	btwQuery;
 	getSessionContextReport;
 	getPersistentGoalApisForCommand;
 	resetSession;
+	getWorkflowRunService;
 	constructor(handlerConfig) {
 		this.config = handlerConfig.config;
 		this.bus = handlerConfig.bus;
@@ -37,11 +39,13 @@ var CommandHandler = class {
 		this.switchModelForSession = handlerConfig.switchModelForSession;
 		this.invalidateAgentSession = handlerConfig.invalidateAgentSession;
 		this.abortSessionTurn = handlerConfig.abortSessionTurn;
+		this.reloadSkills = handlerConfig.reloadSkills;
 		this.compactSession = handlerConfig.compactSession;
 		this.btwQuery = handlerConfig.btwQuery;
 		this.getSessionContextReport = handlerConfig.getSessionContextReport;
 		this.getPersistentGoalApisForCommand = handlerConfig.getPersistentGoalApisForCommand;
 		this.resetSession = handlerConfig.resetSession;
+		this.getWorkflowRunService = handlerConfig.getWorkflowRunService;
 	}
 	/** Replace config reference after hot reload or gateway PATCH so commands see current defaults. */
 	updateAgentConfig(config) {
@@ -124,6 +128,9 @@ var CommandHandler = class {
 			abortCurrentTurn: this.abortSessionTurn ? async () => {
 				await this.abortSessionTurn(context.sessionKey);
 			} : void 0,
+			reloadSkills: this.reloadSkills ? async () => {
+				await this.reloadSkills();
+			} : void 0,
 			compactSession: this.compactSession,
 			btwQuery: this.btwQuery,
 			getSessionContextReport: this.getSessionContextReport,
@@ -132,7 +139,8 @@ var CommandHandler = class {
 				channel: context.channel,
 				chatId: context.chatId,
 				inboundMetadata: context.inboundMetadata
-			})
+			}),
+			workflowRunService: this.getWorkflowRunService?.()
 		});
 	}
 	/**
@@ -181,7 +189,8 @@ var CommandHandler = class {
 		}
 		return {
 			handled: true,
-			aggregatedText: segments.filter((s) => s && s.trim()).join("\n\n")
+			aggregatedText: segments.filter((s) => s && s.trim()).join("\n\n"),
+			metadata: result.metadata
 		};
 	}
 };

package/dist/src/agent/messaging/command-handler.js.map

@@ -1 +1 @@
-{"version":3,"file":"command-handler.js","names":[],"sources":["../../../../src/agent/messaging/command-handler.ts"],"sourcesContent":["/**\n * Command Handler - Parses and executes commands\n *\n * Handles command execution using the unified command system.\n */\n\nimport type { MessageBus } from '../../infra/bus/index.js';\nimport type { Config } from '../../config/schema.js';\nimport { isProviderConfiguredSync } from '../../providers/index.js';\nimport type { SessionConfigStore, SessionStore } from '../../session/index.js';\nimport type { ThinkLevel } from '../transcript/thinking-types.js';\nimport type { CompactionResult } from '../memory/compaction.js';\nimport { createLogger } from '../../utils/logger.js';\nimport {\n  commandRegistry,\n  createCommandContext,\n  type CommandContext as UnifiedCommandContext,\n} from '../../chat-commands/index.js';\nimport { getAllProviders, getModelsByProvider, getProviderDisplayName } from '../../providers/index.js';\nimport type { PersistentGoalApis } from '../goals/persistent-goal-apis.js';\n\nconst log = createLogger('CommandHandler');\n\n/** Gateway console direct stream uses SSE tokens; there is no ChannelPlugin outbound for `webchat`. */\nfunction shouldSkipBusOutboundForChannel(channel: string): boolean {\n  return channel === 'webchat';\n}\n\nexport interface CommandContext {\n  sessionKey: string;\n  channel: string;\n  chatId: string;\n  senderId: string;\n  isGroup: boolean;\n  /** From inbound message metadata (thread/account, etc.) for `/goal` continuation routing. */\n  inboundMetadata?: Record<string, unknown>;\n}\n\nexport interface CommandHandlerConfig {\n  config: Config;\n  bus: MessageBus;\n  sessionStore: SessionStore;\n  sessionConfigStore?: SessionConfigStore;\n  /** After /think persists, sync pi-agent */\n  applySessionThinkingLevel?: (sessionKey: string, level: ThinkLevel) => void;\n  getCurrentModel: () => string;\n  switchModelForSession: (sessionKey: string, modelId: string) => Promise<boolean>;\n  /** Drop in-memory agent after session file is cleared (e.g. /new) */\n  invalidateAgentSession?: (sessionKey: string) => void;\n  /** Reset session in place (archive transcript, new session id; preserve overrides) */\n  resetSession?: (sessionKey: string) => Promise<{ sessionId: string; previousSessionId: string } | null>;\n  /** Cancel streaming preview + in-flight LLM work for this session (e.g. /abort) */\n  abortSessionTurn?: (sessionKey: string) => Promise<void>;\n\n  compactSession?: (\n    sessionKey: string,\n    options?: { instructions?: string; force?: boolean },\n  ) => Promise<CompactionResult>;\n\n  btwQuery?: (sessionKey: string, question: string) => Promise<{ text: string; error?: string }>;\n\n  getSessionContextReport?: (\n    sessionKey: string,\n    mode: 'list' | 'detail' | 'json',\n  ) => Promise<string>;\n\n  getPersistentGoalApisForCommand: (routing: {\n    sessionKey: string;\n    channel: string;\n    chatId: string;\n    inboundMetadata?: Record<string, unknown>;\n  }) => PersistentGoalApis;\n}\n\nexport class CommandHandler {\n  private config: Config;\n  private bus: MessageBus;\n  private sessionStore: SessionStore;\n  private sessionConfigStore?: SessionConfigStore;\n  private applySessionThinkingLevel?: (sessionKey: string, level: ThinkLevel) => void;\n  private getCurrentModel: () => string;\n  private switchModelForSession: (sessionKey: string, modelId: string) => Promise<boolean>;\n  private invalidateAgentSession?: (sessionKey: string) => void;\n  private abortSessionTurn?: (sessionKey: string) => Promise<void>;\n  private compactSession?: CommandHandlerConfig['compactSession'];\n  private btwQuery?: CommandHandlerConfig['btwQuery'];\n  private getSessionContextReport?: CommandHandlerConfig['getSessionContextReport'];\n  private getPersistentGoalApisForCommand: CommandHandlerConfig['getPersistentGoalApisForCommand'];\n  private resetSession?: CommandHandlerConfig['resetSession'];\n\n  constructor(handlerConfig: CommandHandlerConfig) {\n    this.config = handlerConfig.config;\n    this.bus = handlerConfig.bus;\n    this.sessionStore = handlerConfig.sessionStore;\n    this.sessionConfigStore = handlerConfig.sessionConfigStore;\n    this.applySessionThinkingLevel = handlerConfig.applySessionThinkingLevel;\n    this.getCurrentModel = handlerConfig.getCurrentModel;\n    this.switchModelForSession = handlerConfig.switchModelForSession;\n    this.invalidateAgentSession = handlerConfig.invalidateAgentSession;\n    this.abortSessionTurn = handlerConfig.abortSessionTurn;\n    this.compactSession = handlerConfig.compactSession;\n    this.btwQuery = handlerConfig.btwQuery;\n    this.getSessionContextReport = handlerConfig.getSessionContextReport;\n    this.getPersistentGoalApisForCommand = handlerConfig.getPersistentGoalApisForCommand;\n    this.resetSession = handlerConfig.resetSession;\n  }\n\n  /** Replace config reference after hot reload or gateway PATCH so commands see current defaults. */\n  updateAgentConfig(config: Config): void {\n    this.config = config;\n  }\n\n  /**\n   * Build the unified command context shared by all execute paths.\n   * When `recorder` is set, every reply text is also captured (for SSE / CLI aggregation).\n   */\n  private buildCommandContext(\n    context: CommandContext,\n    recorder?: (text: string) => void,\n  ): UnifiedCommandContext {\n    const skipBusOutbound = shouldSkipBusOutboundForChannel(context.channel);\n\n    return createCommandContext({\n      sessionKey: context.sessionKey,\n      source: context.channel as 'telegram' | 'webui' | 'cli' | 'api' | 'system' | 'gateway',\n      channelId: context.channel,\n      chatId: context.chatId,\n      senderId: context.senderId,\n      isGroup: context.isGroup,\n      config: this.config,\n      bus: this.bus,\n      sessionStore: this.sessionStore,\n      sessionConfigStore: this.sessionConfigStore,\n      applySessionThinkingLevel: this.applySessionThinkingLevel,\n\n      replyHandler: async (text: string, _options?) => {\n        recorder?.(text);\n        if (skipBusOutbound) return;\n        await this.bus.publishOutbound({\n          channel: context.channel,\n          chat_id: context.chatId,\n          content: text,\n          type: 'message',\n        });\n      },\n\n      typingHandler: async (typing: boolean) => {\n        if (skipBusOutbound) return;\n        await this.bus.publishOutbound({\n          channel: context.channel,\n          chat_id: context.chatId,\n          type: typing ? 'typing_on' : 'typing_off',\n        });\n      },\n\n      supportedFeatures: ['markdown', 'typing'],\n\n      getCurrentModel: this.getCurrentModel,\n\n      switchModel: async (modelId: string) => {\n        return this.switchModelForSession(context.sessionKey, modelId);\n      },\n\n      listModels: async () => {\n        const providers = getAllProviders();\n        const models: Array<{ id: string; name: string; provider: string }> = [];\n\n        for (const providerId of providers) {\n          if (isProviderConfiguredSync(providerId)) {\n            const providerModels = getModelsByProvider(providerId);\n            for (const m of providerModels) {\n              models.push({\n                id: `${m.provider}/${m.id}`,\n                name: m.name || m.id,\n                provider: getProviderDisplayName(providerId),\n              });\n            }\n          }\n        }\n\n        return models;\n      },\n\n      getUsage: async () => {\n        const messages = await this.sessionStore.load(context.sessionKey);\n        let promptTokens = 0;\n        let completionTokens = 0;\n\n        for (const msg of messages) {\n          if ('usage' in msg && msg.usage) {\n            const usage = msg.usage as { input?: number; output?: number };\n            promptTokens += usage.input || 0;\n            completionTokens += usage.output || 0;\n          }\n        }\n\n        return {\n          promptTokens,\n          completionTokens,\n          totalTokens: promptTokens + completionTokens,\n          messageCount: messages.length,\n        };\n      },\n\n      invalidateAgentSession: this.invalidateAgentSession,\n\n      resetSession: this.resetSession\n        ? async (sk) => {\n            await this.resetSession!(sk);\n          }\n        : undefined,\n\n      abortCurrentTurn: this.abortSessionTurn\n        ? async () => {\n            await this.abortSessionTurn!(context.sessionKey);\n          }\n        : undefined,\n\n      compactSession: this.compactSession,\n      btwQuery: this.btwQuery,\n      getSessionContextReport: this.getSessionContextReport,\n      persistentGoalApis: this.getPersistentGoalApisForCommand({\n        sessionKey: context.sessionKey,\n        channel: context.channel,\n        chatId: context.chatId,\n        inboundMetadata: context.inboundMetadata,\n      }),\n    });\n  }\n\n  /**\n   * Execute a command using the unified command system\n   */\n  async executeCommand(\n    commandName: string,\n    args: string,\n    context: CommandContext,\n  ): Promise<boolean> {\n    if (!commandRegistry.has(commandName)) {\n      return false;\n    }\n\n    log.info({ command: commandName, sessionKey: context.sessionKey }, 'Executing command via new system');\n\n    const cmdCtx = this.buildCommandContext(context);\n    const result = await commandRegistry.execute(commandName, cmdCtx, args);\n\n    if (result.content && !shouldSkipBusOutboundForChannel(context.channel)) {\n      await this.bus.publishOutbound({\n        channel: context.channel,\n        chat_id: context.chatId,\n        content: result.content,\n        type: 'message',\n      });\n    }\n\n    return true;\n  }\n\n  /**\n   * Run command and return all user-visible text (ctx.reply + result.content) for SSE/CLI.\n   * Same bus side effects as {@link executeCommand}.\n   */\n  async executeCommandAndAggregateReply(\n    commandName: string,\n    args: string,\n    context: CommandContext,\n  ): Promise<{ handled: boolean; aggregatedText: string }> {\n    if (!commandRegistry.has(commandName)) {\n      return { handled: false, aggregatedText: '' };\n    }\n\n    log.info({ command: commandName, sessionKey: context.sessionKey }, 'Executing command (aggregate reply)');\n\n    const segments: string[] = [];\n    const wrapped = this.buildCommandContext(context, (text) => segments.push(text));\n    const result = await commandRegistry.execute(commandName, wrapped, args);\n\n    if (result.content) {\n      segments.push(result.content);\n      if (!shouldSkipBusOutboundForChannel(context.channel)) {\n        await this.bus.publishOutbound({\n          channel: context.channel,\n          chat_id: context.chatId,\n          content: result.content,\n          type: 'message',\n        });\n      }\n    }\n\n    const aggregatedText = segments.filter((s) => s && s.trim()).join('\\n\\n');\n    return { handled: true, aggregatedText };\n  }\n}\n"],"mappings":"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"}
+{"version":3,"file":"command-handler.js","names":[],"sources":["../../../../src/agent/messaging/command-handler.ts"],"sourcesContent":["/**\n * Command Handler - Parses and executes commands\n *\n * Handles command execution using the unified command system.\n */\n\nimport type { MessageBus } from '../../infra/bus/index.js';\nimport type { Config } from '../../config/schema.js';\nimport { isProviderConfiguredSync } from '../../providers/index.js';\nimport type { SessionConfigStore, SessionStore } from '../../session/index.js';\nimport type { ThinkLevel } from '../transcript/thinking-types.js';\nimport type { CompactionResult } from '../memory/compaction.js';\nimport { createLogger } from '../../utils/logger.js';\nimport {\n  commandRegistry,\n  createCommandContext,\n  type CommandContext as UnifiedCommandContext,\n} from '../../chat-commands/index.js';\nimport { getAllProviders, getModelsByProvider, getProviderDisplayName } from '../../providers/index.js';\nimport type { PersistentGoalApis } from '../goals/persistent-goal-apis.js';\nimport type { WorkflowRunServiceLike } from '../../workflows/service/workflow-run-service.types.js';\n\nconst log = createLogger('CommandHandler');\n\n/** Gateway console direct stream uses SSE tokens; there is no ChannelPlugin outbound for `webchat`. */\nfunction shouldSkipBusOutboundForChannel(channel: string): boolean {\n  return channel === 'webchat';\n}\n\nexport interface CommandContext {\n  sessionKey: string;\n  channel: string;\n  chatId: string;\n  senderId: string;\n  isGroup: boolean;\n  /** From inbound message metadata (thread/account, etc.) for `/goal` continuation routing. */\n  inboundMetadata?: Record<string, unknown>;\n}\n\nexport interface CommandHandlerConfig {\n  config: Config;\n  bus: MessageBus;\n  sessionStore: SessionStore;\n  sessionConfigStore?: SessionConfigStore;\n  /** After /think persists, sync pi-agent */\n  applySessionThinkingLevel?: (sessionKey: string, level: ThinkLevel) => void;\n  getCurrentModel: () => string;\n  switchModelForSession: (sessionKey: string, modelId: string) => Promise<boolean>;\n  /** Drop in-memory agent after session file is cleared (e.g. /new) */\n  invalidateAgentSession?: (sessionKey: string) => void;\n  /** Reset session in place (archive transcript, new session id; preserve overrides) */\n  resetSession?: (sessionKey: string) => Promise<{ sessionId: string; previousSessionId: string } | null>;\n  /** Cancel streaming preview + in-flight LLM work for this session (e.g. /abort) */\n  abortSessionTurn?: (sessionKey: string) => Promise<void>;\n  /** Reload skills from disk and refresh active agent prompts. */\n  reloadSkills?: () => void | Promise<void>;\n\n  compactSession?: (\n    sessionKey: string,\n    options?: { instructions?: string; force?: boolean },\n  ) => Promise<CompactionResult>;\n\n  btwQuery?: (sessionKey: string, question: string) => Promise<{ text: string; error?: string }>;\n\n  getSessionContextReport?: (\n    sessionKey: string,\n    mode: 'list' | 'detail' | 'json',\n  ) => Promise<string>;\n\n  getPersistentGoalApisForCommand: (routing: {\n    sessionKey: string;\n    channel: string;\n    chatId: string;\n    inboundMetadata?: Record<string, unknown>;\n  }) => PersistentGoalApis;\n  getWorkflowRunService?: () => WorkflowRunServiceLike | undefined;\n}\n\nexport class CommandHandler {\n  private config: Config;\n  private bus: MessageBus;\n  private sessionStore: SessionStore;\n  private sessionConfigStore?: SessionConfigStore;\n  private applySessionThinkingLevel?: (sessionKey: string, level: ThinkLevel) => void;\n  private getCurrentModel: () => string;\n  private switchModelForSession: (sessionKey: string, modelId: string) => Promise<boolean>;\n  private invalidateAgentSession?: (sessionKey: string) => void;\n  private abortSessionTurn?: (sessionKey: string) => Promise<void>;\n  private reloadSkills?: CommandHandlerConfig['reloadSkills'];\n  private compactSession?: CommandHandlerConfig['compactSession'];\n  private btwQuery?: CommandHandlerConfig['btwQuery'];\n  private getSessionContextReport?: CommandHandlerConfig['getSessionContextReport'];\n  private getPersistentGoalApisForCommand: CommandHandlerConfig['getPersistentGoalApisForCommand'];\n  private resetSession?: CommandHandlerConfig['resetSession'];\n  private getWorkflowRunService?: CommandHandlerConfig['getWorkflowRunService'];\n\n  constructor(handlerConfig: CommandHandlerConfig) {\n    this.config = handlerConfig.config;\n    this.bus = handlerConfig.bus;\n    this.sessionStore = handlerConfig.sessionStore;\n    this.sessionConfigStore = handlerConfig.sessionConfigStore;\n    this.applySessionThinkingLevel = handlerConfig.applySessionThinkingLevel;\n    this.getCurrentModel = handlerConfig.getCurrentModel;\n    this.switchModelForSession = handlerConfig.switchModelForSession;\n    this.invalidateAgentSession = handlerConfig.invalidateAgentSession;\n    this.abortSessionTurn = handlerConfig.abortSessionTurn;\n    this.reloadSkills = handlerConfig.reloadSkills;\n    this.compactSession = handlerConfig.compactSession;\n    this.btwQuery = handlerConfig.btwQuery;\n    this.getSessionContextReport = handlerConfig.getSessionContextReport;\n    this.getPersistentGoalApisForCommand = handlerConfig.getPersistentGoalApisForCommand;\n    this.resetSession = handlerConfig.resetSession;\n    this.getWorkflowRunService = handlerConfig.getWorkflowRunService;\n  }\n\n  /** Replace config reference after hot reload or gateway PATCH so commands see current defaults. */\n  updateAgentConfig(config: Config): void {\n    this.config = config;\n  }\n\n  /**\n   * Build the unified command context shared by all execute paths.\n   * When `recorder` is set, every reply text is also captured (for SSE / CLI aggregation).\n   */\n  private buildCommandContext(\n    context: CommandContext,\n    recorder?: (text: string) => void,\n  ): UnifiedCommandContext {\n    const skipBusOutbound = shouldSkipBusOutboundForChannel(context.channel);\n\n    return createCommandContext({\n      sessionKey: context.sessionKey,\n      source: context.channel as 'telegram' | 'webui' | 'cli' | 'api' | 'system' | 'gateway',\n      channelId: context.channel,\n      chatId: context.chatId,\n      senderId: context.senderId,\n      isGroup: context.isGroup,\n      config: this.config,\n      bus: this.bus,\n      sessionStore: this.sessionStore,\n      sessionConfigStore: this.sessionConfigStore,\n      applySessionThinkingLevel: this.applySessionThinkingLevel,\n\n      replyHandler: async (text: string, _options?) => {\n        recorder?.(text);\n        if (skipBusOutbound) return;\n        await this.bus.publishOutbound({\n          channel: context.channel,\n          chat_id: context.chatId,\n          content: text,\n          type: 'message',\n        });\n      },\n\n      typingHandler: async (typing: boolean) => {\n        if (skipBusOutbound) return;\n        await this.bus.publishOutbound({\n          channel: context.channel,\n          chat_id: context.chatId,\n          type: typing ? 'typing_on' : 'typing_off',\n        });\n      },\n\n      supportedFeatures: ['markdown', 'typing'],\n\n      getCurrentModel: this.getCurrentModel,\n\n      switchModel: async (modelId: string) => {\n        return this.switchModelForSession(context.sessionKey, modelId);\n      },\n\n      listModels: async () => {\n        const providers = getAllProviders();\n        const models: Array<{ id: string; name: string; provider: string }> = [];\n\n        for (const providerId of providers) {\n          if (isProviderConfiguredSync(providerId)) {\n            const providerModels = getModelsByProvider(providerId);\n            for (const m of providerModels) {\n              models.push({\n                id: `${m.provider}/${m.id}`,\n                name: m.name || m.id,\n                provider: getProviderDisplayName(providerId),\n              });\n            }\n          }\n        }\n\n        return models;\n      },\n\n      getUsage: async () => {\n        const messages = await this.sessionStore.load(context.sessionKey);\n        let promptTokens = 0;\n        let completionTokens = 0;\n\n        for (const msg of messages) {\n          if ('usage' in msg && msg.usage) {\n            const usage = msg.usage as { input?: number; output?: number };\n            promptTokens += usage.input || 0;\n            completionTokens += usage.output || 0;\n          }\n        }\n\n        return {\n          promptTokens,\n          completionTokens,\n          totalTokens: promptTokens + completionTokens,\n          messageCount: messages.length,\n        };\n      },\n\n      invalidateAgentSession: this.invalidateAgentSession,\n\n      resetSession: this.resetSession\n        ? async (sk) => {\n            await this.resetSession!(sk);\n          }\n        : undefined,\n\n      abortCurrentTurn: this.abortSessionTurn\n        ? async () => {\n            await this.abortSessionTurn!(context.sessionKey);\n          }\n        : undefined,\n      reloadSkills: this.reloadSkills\n        ? async () => {\n            await this.reloadSkills!();\n          }\n        : undefined,\n\n      compactSession: this.compactSession,\n      btwQuery: this.btwQuery,\n      getSessionContextReport: this.getSessionContextReport,\n      persistentGoalApis: this.getPersistentGoalApisForCommand({\n        sessionKey: context.sessionKey,\n        channel: context.channel,\n        chatId: context.chatId,\n        inboundMetadata: context.inboundMetadata,\n      }),\n      workflowRunService: this.getWorkflowRunService?.(),\n    });\n  }\n\n  /**\n   * Execute a command using the unified command system\n   */\n  async executeCommand(\n    commandName: string,\n    args: string,\n    context: CommandContext,\n  ): Promise<boolean> {\n    if (!commandRegistry.has(commandName)) {\n      return false;\n    }\n\n    log.info({ command: commandName, sessionKey: context.sessionKey }, 'Executing command via new system');\n\n    const cmdCtx = this.buildCommandContext(context);\n    const result = await commandRegistry.execute(commandName, cmdCtx, args);\n\n    if (result.content && !shouldSkipBusOutboundForChannel(context.channel)) {\n      await this.bus.publishOutbound({\n        channel: context.channel,\n        chat_id: context.chatId,\n        content: result.content,\n        type: 'message',\n      });\n    }\n\n    return true;\n  }\n\n  /**\n   * Run command and return all user-visible text (ctx.reply + result.content) for SSE/CLI.\n   * Same bus side effects as {@link executeCommand}.\n   */\n  async executeCommandAndAggregateReply(\n    commandName: string,\n    args: string,\n    context: CommandContext,\n  ): Promise<{ handled: boolean; aggregatedText: string; metadata?: Record<string, unknown> }> {\n    if (!commandRegistry.has(commandName)) {\n      return { handled: false, aggregatedText: '' };\n    }\n\n    log.info({ command: commandName, sessionKey: context.sessionKey }, 'Executing command (aggregate reply)');\n\n    const segments: string[] = [];\n    const wrapped = this.buildCommandContext(context, (text) => segments.push(text));\n    const result = await commandRegistry.execute(commandName, wrapped, args);\n\n    if (result.content) {\n      segments.push(result.content);\n      if (!shouldSkipBusOutboundForChannel(context.channel)) {\n        await this.bus.publishOutbound({\n          channel: context.channel,\n          chat_id: context.chatId,\n          content: result.content,\n          type: 'message',\n        });\n      }\n    }\n\n    const aggregatedText = segments.filter((s) => s && s.trim()).join('\\n\\n');\n    return { handled: true, aggregatedText, metadata: result.metadata };\n  }\n}\n"],"mappings":"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"}

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 { resolveAgentTurnTimeoutMs, runAgentTurnWithTimeout } from "../orchestration/run-agent-turn-with-timeout.js";
 import { isAssistantTurnAborted, isAssistantTurnFailed, maybeRetryTurnAfterTransientLlmFailure } from "../orchestration/llm-turn-retry.js";

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

@@ -3,8 +3,8 @@ import { init_logger } from "../../../utils/logger.js";
 import { requireXopcDatabase } from "../../../storage/sqlite/connection.js";
 import { resolveAgentIdFromMemoriesDir, searchMemoryIndex, syncMemoryIndex } from "../../../storage/sqlite/memory-index-repository.js";
 import "../../../storage/sqlite/index.js";
-import { join, relative } from "path";
 import { existsSync, readFileSync } from "fs";
+import { join, relative } from "path";
 //#region src/agent/prompt/memory/index.ts
 init_logger();
 const log = createLogger("MemorySearch");

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

@@ -1,7 +1,7 @@
 import { resolveStateDir } from "../../config/paths-state.js";
+import { init_paths } from "../../config/paths.js";
 import { createLogger } from "../../utils/logger/index.js";
 import { init_logger } from "../../utils/logger.js";
-import { init_paths } from "../../config/paths.js";
 import { DEFAULT_USER_FILENAME } from "../context/workspace.js";
 import { resolveSystemPromptBuildParams } from "./system-prompt-params.js";
 import { buildSystemPrompt } from "./system-prompt.js";
@@ -9,8 +9,8 @@ import { createSkillConfigManager } from "../skills/config.js";
 import { buildTtsSystemPromptHint } from "../../voice/tts/directives.js";
 import { mergeTtsConfigFromAppConfig } from "../../voice/tts/merge-config.js";
 import { selectSkillsVisibleInPrompt } from "../skills/format-skills-prompt.js";
-import { join } from "node:path";
 import { existsSync, readFileSync } from "node:fs";
+import { join } from "node:path";
 //#region src/agent/prompt/service-prompt-builder.ts
 /**
 * System Prompt Builder - Builds the complete system prompt

package/dist/src/agent/reply/post-compaction-context.js

@@ -1,7 +1,7 @@
 import { init_agent_scope, resolveAgentProfileDir } from "../agent-scope.js";
 import { resolveEffectiveAgentProfileForSession } from "../../config/agent-profile.js";
-import { join, resolve } from "node:path";
 import { readFileSync } from "node:fs";
+import { join, resolve } from "node:path";
 //#region src/agent/reply/post-compaction-context.ts
 init_agent_scope();
 const MAX_CONTEXT_CHARS = 1800;

package/dist/src/agent/reply/workspace-boundary-read.js

@@ -1,5 +1,5 @@
-import { resolve } from "node:path";
 import { readFileSync } from "node:fs";
+import { resolve } from "node:path";
 //#region src/agent/reply/workspace-boundary-read.ts
 /**
 * Read a file relative to workspace root with path traversal guard and byte cap.

package/dist/src/agent/sandbox/path-policy.js

@@ -1,6 +1,6 @@
-import { homedir } from "node:os";
-import { isAbsolute, normalize, resolve, sep } from "node:path";
 import { realpathSync } from "node:fs";
+import { isAbsolute, normalize, resolve, sep } from "node:path";
+import { homedir } from "node:os";
 //#region src/agent/sandbox/path-policy.ts
 /**
 * Path safety validation for sandbox isolation.

package/dist/src/agent/service/direct-turn-helpers.d.ts

@@ -27,6 +27,8 @@ export interface SlashCommandOutcome {
     aggregatedText: string;
     /** The parsed command name when matched. */
     command?: string;
+    /** Structured command result metadata for webchat and other rich clients. */
+    metadata?: Record<string, unknown>;
 }
 export interface TryRunSlashCommandDeps {
     commandHandler: Pick<CommandHandler, 'executeCommandAndAggregateReply'>;