@xopcai/xopc 0.0.126 → 0.0.128

package/dist/src/agent/capabilities/definitions.js

@@ -0,0 +1,175 @@
+//#region src/agent/capabilities/definitions.ts
+const AGENT_CAPABILITY_DEFINITIONS = [
+	{
+		id: "desktop-pet-authoring",
+		label: "Desktop pet authoring",
+		description: "Create, repair, and update local animated desktop pet packages.",
+		category: "authoring",
+		tools: ["create_desktop_pet"],
+		requiredSkills: ["hatch-pet"],
+		promptHint: "Use clarify when the pet concept is vague. Create or update the pet only after appearance, personality, and animation goals are clear.",
+		activation: {
+			mode: "explicit",
+			ttl: "until-complete"
+		},
+		permissions: { writesFiles: true }
+	},
+	{
+		id: "automation-authoring",
+		label: "Automation authoring",
+		description: "Create and update reminders, monitors, recurring checks, and scheduled follow-ups.",
+		category: "authoring",
+		tools: ["automation"],
+		activation: {
+			mode: "explicit",
+			ttl: "until-complete"
+		},
+		permissions: {
+			writesFiles: true,
+			requiresConfirm: true
+		}
+	},
+	{
+		id: "workflow-authoring",
+		label: "Workflow authoring",
+		description: "Design, validate, and run xopc workflows.",
+		category: "authoring",
+		tools: ["workflow"],
+		activation: {
+			mode: "explicit",
+			ttl: "until-complete"
+		},
+		permissions: {
+			writesFiles: true,
+			runsCode: true,
+			requiresConfirm: true
+		}
+	},
+	{
+		id: "extension-authoring",
+		label: "Plugin and extension authoring",
+		description: "Scaffold, inspect, and package xopc plugins or extensions.",
+		category: "authoring",
+		tools: [
+			"read_file",
+			"write_file",
+			"apply_patch",
+			"list_dir",
+			"grep",
+			"find",
+			"exec_command"
+		],
+		activation: {
+			mode: "explicit",
+			ttl: "until-complete"
+		},
+		permissions: {
+			writesFiles: true,
+			runsCode: true,
+			requiresConfirm: true
+		}
+	},
+	{
+		id: "skill-authoring",
+		label: "Skill authoring",
+		description: "Create, edit, inspect, and maintain xopc skills.",
+		category: "authoring",
+		tools: [
+			"skills_list",
+			"skill_view",
+			"skill_manage"
+		],
+		activation: {
+			mode: "explicit",
+			ttl: "until-complete"
+		},
+		permissions: {
+			writesFiles: true,
+			requiresConfirm: true
+		}
+	},
+	{
+		id: "skill-installation",
+		label: "Skill installation",
+		description: "Find, install, and update xopc skills from explicit sources.",
+		category: "authoring",
+		tools: [
+			"skills_list",
+			"skill_view",
+			"skill_install"
+		],
+		activation: {
+			mode: "explicit",
+			ttl: "turn"
+		},
+		permissions: {
+			writesFiles: true,
+			usesNetwork: true
+		}
+	},
+	{
+		id: "visual-asset-authoring",
+		label: "Visual asset authoring",
+		description: "Generate and inspect images, icons, sprites, and other visual assets.",
+		category: "assets",
+		tools: [
+			"image",
+			"image_generate",
+			"read_media",
+			"send_media"
+		],
+		activation: {
+			mode: "explicit",
+			ttl: "session"
+		},
+		permissions: {
+			writesFiles: true,
+			usesNetwork: true
+		}
+	},
+	{
+		id: "browser-research",
+		label: "Browser research",
+		description: "Perform deeper web research with search, extraction, fetch, and browser interaction.",
+		category: "research",
+		tools: [
+			"web_search",
+			"web_fetch",
+			"web_extract",
+			"browser_use"
+		],
+		activation: {
+			mode: "explicit",
+			ttl: "turn"
+		},
+		permissions: {
+			usesBrowser: true,
+			usesNetwork: true
+		}
+	},
+	{
+		id: "data-analysis",
+		label: "Data analysis",
+		description: "Analyze local structured data and produce derived tables, summaries, or artifacts.",
+		category: "analysis",
+		tools: [
+			"read_file",
+			"write_file",
+			"list_dir",
+			"grep",
+			"find"
+		],
+		activation: {
+			mode: "explicit",
+			ttl: "session"
+		},
+		permissions: {
+			writesFiles: true,
+			runsCode: true
+		}
+	}
+];
+//#endregion
+export { AGENT_CAPABILITY_DEFINITIONS };
+
+//# sourceMappingURL=definitions.js.map

package/dist/src/agent/capabilities/definitions.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"definitions.js","names":[],"sources":["../../../../src/agent/capabilities/definitions.ts"],"sourcesContent":["export type AgentCapabilityCategory = 'authoring' | 'research' | 'analysis' | 'assets';\n\nexport type AgentCapabilityActivationMode = 'explicit' | 'ui-entry' | 'workflow-scoped';\n\nexport type AgentCapabilityTtl = 'turn' | 'session' | 'until-complete';\n\nexport type AgentCapabilityActivationSource = 'skill' | 'ui' | 'workflow';\n\nexport type AgentCapabilitySessionStatus = 'collecting' | 'running' | 'complete';\n\nexport type AgentCapabilityPermissions = {\n  writesFiles?: boolean;\n  runsCode?: boolean;\n  usesBrowser?: boolean;\n  usesNetwork?: boolean;\n  requiresConfirm?: boolean;\n};\n\nexport type AgentCapabilityDefinition = {\n  id: string;\n  label: string;\n  description: string;\n  category: AgentCapabilityCategory;\n  tools: readonly string[];\n  requiredSkills?: readonly string[];\n  promptHint?: string;\n  activation: {\n    mode: AgentCapabilityActivationMode;\n    ttl: AgentCapabilityTtl;\n  };\n  permissions: AgentCapabilityPermissions;\n};\n\nexport type AgentCapabilitySessionState = {\n  id: string;\n  source: AgentCapabilityActivationSource;\n  activatedAt: number;\n  ttl: AgentCapabilityTtl;\n  status: AgentCapabilitySessionStatus;\n};\n\nexport type AgentCapabilityCatalogEntry = AgentCapabilityDefinition & {\n  availableTools: string[];\n  unavailableTools: string[];\n};\n\nexport const AGENT_CAPABILITY_DEFINITIONS = [\n  {\n    id: 'desktop-pet-authoring',\n    label: 'Desktop pet authoring',\n    description: 'Create, repair, and update local animated desktop pet packages.',\n    category: 'authoring',\n    tools: ['create_desktop_pet'],\n    requiredSkills: ['hatch-pet'],\n    promptHint:\n      'Use clarify when the pet concept is vague. Create or update the pet only after appearance, personality, and animation goals are clear.',\n    activation: { mode: 'explicit', ttl: 'until-complete' },\n    permissions: { writesFiles: true },\n  },\n  {\n    id: 'automation-authoring',\n    label: 'Automation authoring',\n    description: 'Create and update reminders, monitors, recurring checks, and scheduled follow-ups.',\n    category: 'authoring',\n    tools: ['automation'],\n    activation: { mode: 'explicit', ttl: 'until-complete' },\n    permissions: { writesFiles: true, requiresConfirm: true },\n  },\n  {\n    id: 'workflow-authoring',\n    label: 'Workflow authoring',\n    description: 'Design, validate, and run xopc workflows.',\n    category: 'authoring',\n    tools: ['workflow'],\n    activation: { mode: 'explicit', ttl: 'until-complete' },\n    permissions: { writesFiles: true, runsCode: true, requiresConfirm: true },\n  },\n  {\n    id: 'extension-authoring',\n    label: 'Plugin and extension authoring',\n    description: 'Scaffold, inspect, and package xopc plugins or extensions.',\n    category: 'authoring',\n    tools: ['read_file', 'write_file', 'apply_patch', 'list_dir', 'grep', 'find', 'exec_command'],\n    activation: { mode: 'explicit', ttl: 'until-complete' },\n    permissions: { writesFiles: true, runsCode: true, requiresConfirm: true },\n  },\n  {\n    id: 'skill-authoring',\n    label: 'Skill authoring',\n    description: 'Create, edit, inspect, and maintain xopc skills.',\n    category: 'authoring',\n    tools: ['skills_list', 'skill_view', 'skill_manage'],\n    activation: { mode: 'explicit', ttl: 'until-complete' },\n    permissions: { writesFiles: true, requiresConfirm: true },\n  },\n  {\n    id: 'skill-installation',\n    label: 'Skill installation',\n    description: 'Find, install, and update xopc skills from explicit sources.',\n    category: 'authoring',\n    tools: ['skills_list', 'skill_view', 'skill_install'],\n    activation: { mode: 'explicit', ttl: 'turn' },\n    permissions: { writesFiles: true, usesNetwork: true },\n  },\n  {\n    id: 'visual-asset-authoring',\n    label: 'Visual asset authoring',\n    description: 'Generate and inspect images, icons, sprites, and other visual assets.',\n    category: 'assets',\n    tools: ['image', 'image_generate', 'read_media', 'send_media'],\n    activation: { mode: 'explicit', ttl: 'session' },\n    permissions: { writesFiles: true, usesNetwork: true },\n  },\n  {\n    id: 'browser-research',\n    label: 'Browser research',\n    description: 'Perform deeper web research with search, extraction, fetch, and browser interaction.',\n    category: 'research',\n    tools: ['web_search', 'web_fetch', 'web_extract', 'browser_use'],\n    activation: { mode: 'explicit', ttl: 'turn' },\n    permissions: { usesBrowser: true, usesNetwork: true },\n  },\n  {\n    id: 'data-analysis',\n    label: 'Data analysis',\n    description: 'Analyze local structured data and produce derived tables, summaries, or artifacts.',\n    category: 'analysis',\n    tools: ['read_file', 'write_file', 'list_dir', 'grep', 'find'],\n    activation: { mode: 'explicit', ttl: 'session' },\n    permissions: { writesFiles: true, runsCode: true },\n  },\n] as const satisfies readonly AgentCapabilityDefinition[];\n"],"mappings":";AA8CA,MAAa,+BAA+B;CAC1C;EACE,IAAI;EACJ,OAAO;EACP,aAAa;EACb,UAAU;EACV,OAAO,CAAC,qBAAqB;EAC7B,gBAAgB,CAAC,YAAY;EAC7B,YACE;EACF,YAAY;GAAE,MAAM;GAAY,KAAK;GAAkB;EACvD,aAAa,EAAE,aAAa,MAAM;EACnC;CACD;EACE,IAAI;EACJ,OAAO;EACP,aAAa;EACb,UAAU;EACV,OAAO,CAAC,aAAa;EACrB,YAAY;GAAE,MAAM;GAAY,KAAK;GAAkB;EACvD,aAAa;GAAE,aAAa;GAAM,iBAAiB;GAAM;EAC1D;CACD;EACE,IAAI;EACJ,OAAO;EACP,aAAa;EACb,UAAU;EACV,OAAO,CAAC,WAAW;EACnB,YAAY;GAAE,MAAM;GAAY,KAAK;GAAkB;EACvD,aAAa;GAAE,aAAa;GAAM,UAAU;GAAM,iBAAiB;GAAM;EAC1E;CACD;EACE,IAAI;EACJ,OAAO;EACP,aAAa;EACb,UAAU;EACV,OAAO;GAAC;GAAa;GAAc;GAAe;GAAY;GAAQ;GAAQ;GAAe;EAC7F,YAAY;GAAE,MAAM;GAAY,KAAK;GAAkB;EACvD,aAAa;GAAE,aAAa;GAAM,UAAU;GAAM,iBAAiB;GAAM;EAC1E;CACD;EACE,IAAI;EACJ,OAAO;EACP,aAAa;EACb,UAAU;EACV,OAAO;GAAC;GAAe;GAAc;GAAe;EACpD,YAAY;GAAE,MAAM;GAAY,KAAK;GAAkB;EACvD,aAAa;GAAE,aAAa;GAAM,iBAAiB;GAAM;EAC1D;CACD;EACE,IAAI;EACJ,OAAO;EACP,aAAa;EACb,UAAU;EACV,OAAO;GAAC;GAAe;GAAc;GAAgB;EACrD,YAAY;GAAE,MAAM;GAAY,KAAK;GAAQ;EAC7C,aAAa;GAAE,aAAa;GAAM,aAAa;GAAM;EACtD;CACD;EACE,IAAI;EACJ,OAAO;EACP,aAAa;EACb,UAAU;EACV,OAAO;GAAC;GAAS;GAAkB;GAAc;GAAa;EAC9D,YAAY;GAAE,MAAM;GAAY,KAAK;GAAW;EAChD,aAAa;GAAE,aAAa;GAAM,aAAa;GAAM;EACtD;CACD;EACE,IAAI;EACJ,OAAO;EACP,aAAa;EACb,UAAU;EACV,OAAO;GAAC;GAAc;GAAa;GAAe;GAAc;EAChE,YAAY;GAAE,MAAM;GAAY,KAAK;GAAQ;EAC7C,aAAa;GAAE,aAAa;GAAM,aAAa;GAAM;EACtD;CACD;EACE,IAAI;EACJ,OAAO;EACP,aAAa;EACb,UAAU;EACV,OAAO;GAAC;GAAa;GAAc;GAAY;GAAQ;GAAO;EAC9D,YAAY;GAAE,MAAM;GAAY,KAAK;GAAW;EAChD,aAAa;GAAE,aAAa;GAAM,UAAU;GAAM;EACnD;CACF"}

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

@@ -0,0 +1,2 @@
+export { AGENT_CAPABILITY_DEFINITIONS, type AgentCapabilityActivationMode, type AgentCapabilityActivationSource, type AgentCapabilityCatalogEntry, type AgentCapabilityCategory, type AgentCapabilityDefinition, type AgentCapabilityPermissions, type AgentCapabilitySessionState, type AgentCapabilitySessionStatus, type AgentCapabilityTtl, } from './definitions.js';
+export { createAgentCapabilitySessionState, getAgentCapability, getAgentCapabilityToolNames, listAgentCapabilities, resolveAgentCapabilityCatalog, } from './registry.js';

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

@@ -0,0 +1,3 @@
+import { AGENT_CAPABILITY_DEFINITIONS } from "./definitions.js";
+import { createAgentCapabilitySessionState, getAgentCapability, getAgentCapabilityToolNames, listAgentCapabilities, resolveAgentCapabilityCatalog } from "./registry.js";
+export { AGENT_CAPABILITY_DEFINITIONS, createAgentCapabilitySessionState, getAgentCapability, getAgentCapabilityToolNames, listAgentCapabilities, resolveAgentCapabilityCatalog };

package/dist/src/agent/capabilities/registry.d.ts

@@ -0,0 +1,10 @@
+import { type AgentCapabilityActivationSource, type AgentCapabilityCatalogEntry, type AgentCapabilityDefinition, type AgentCapabilitySessionState } from './definitions.js';
+export declare function listAgentCapabilities(): AgentCapabilityDefinition[];
+export declare function getAgentCapability(id: string): AgentCapabilityDefinition | undefined;
+export declare function getAgentCapabilityToolNames(ids: readonly string[]): string[];
+export declare function resolveAgentCapabilityCatalog(options?: {
+    registeredToolNames?: readonly string[];
+    lazyToolNames?: readonly string[];
+    deniedToolNames?: readonly string[];
+}): AgentCapabilityCatalogEntry[];
+export declare function createAgentCapabilitySessionState(id: string, source: AgentCapabilityActivationSource, now?: number): AgentCapabilitySessionState | null;

package/dist/src/agent/capabilities/registry.js

@@ -0,0 +1,51 @@
+import { AGENT_CAPABILITY_DEFINITIONS } from "./definitions.js";
+//#region src/agent/capabilities/registry.ts
+const definitionsById = new Map(AGENT_CAPABILITY_DEFINITIONS.map((definition) => [definition.id, definition]));
+function listAgentCapabilities() {
+	return [...AGENT_CAPABILITY_DEFINITIONS];
+}
+function getAgentCapability(id) {
+	return definitionsById.get(id.trim());
+}
+function getAgentCapabilityToolNames(ids) {
+	const out = [];
+	const seen = /* @__PURE__ */ new Set();
+	for (const id of ids) {
+		const definition = getAgentCapability(id);
+		if (!definition) continue;
+		for (const toolName of definition.tools) {
+			if (seen.has(toolName)) continue;
+			seen.add(toolName);
+			out.push(toolName);
+		}
+	}
+	return out;
+}
+function resolveAgentCapabilityCatalog(options = {}) {
+	const available = new Set([...options.registeredToolNames ?? [], ...options.lazyToolNames ?? []]);
+	const denied = new Set(options.deniedToolNames ?? []);
+	return AGENT_CAPABILITY_DEFINITIONS.map((definition) => {
+		const availableTools = definition.tools.filter((toolName) => available.has(toolName) && !denied.has(toolName));
+		const unavailableTools = definition.tools.filter((toolName) => !availableTools.includes(toolName));
+		return {
+			...definition,
+			availableTools,
+			unavailableTools
+		};
+	});
+}
+function createAgentCapabilitySessionState(id, source, now = Date.now()) {
+	const definition = getAgentCapability(id);
+	if (!definition) return null;
+	return {
+		id: definition.id,
+		source,
+		activatedAt: now,
+		ttl: definition.activation.ttl,
+		status: "collecting"
+	};
+}
+//#endregion
+export { createAgentCapabilitySessionState, getAgentCapability, getAgentCapabilityToolNames, listAgentCapabilities, resolveAgentCapabilityCatalog };
+
+//# sourceMappingURL=registry.js.map

package/dist/src/agent/capabilities/registry.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"registry.js","names":[],"sources":["../../../../src/agent/capabilities/registry.ts"],"sourcesContent":["import {\n  AGENT_CAPABILITY_DEFINITIONS,\n  type AgentCapabilityActivationSource,\n  type AgentCapabilityCatalogEntry,\n  type AgentCapabilityDefinition,\n  type AgentCapabilitySessionState,\n} from './definitions.js';\n\nconst definitionsById: Map<string, AgentCapabilityDefinition> = new Map(\n  AGENT_CAPABILITY_DEFINITIONS.map((definition) => [definition.id, definition]),\n);\n\nexport function listAgentCapabilities(): AgentCapabilityDefinition[] {\n  return [...AGENT_CAPABILITY_DEFINITIONS];\n}\n\nexport function getAgentCapability(id: string): AgentCapabilityDefinition | undefined {\n  return definitionsById.get(id.trim());\n}\n\nexport function getAgentCapabilityToolNames(ids: readonly string[]): string[] {\n  const out: string[] = [];\n  const seen = new Set<string>();\n  for (const id of ids) {\n    const definition = getAgentCapability(id);\n    if (!definition) continue;\n    for (const toolName of definition.tools) {\n      if (seen.has(toolName)) continue;\n      seen.add(toolName);\n      out.push(toolName);\n    }\n  }\n  return out;\n}\n\nexport function resolveAgentCapabilityCatalog(options: {\n  registeredToolNames?: readonly string[];\n  lazyToolNames?: readonly string[];\n  deniedToolNames?: readonly string[];\n} = {}): AgentCapabilityCatalogEntry[] {\n  const available = new Set([\n    ...(options.registeredToolNames ?? []),\n    ...(options.lazyToolNames ?? []),\n  ]);\n  const denied = new Set(options.deniedToolNames ?? []);\n  return AGENT_CAPABILITY_DEFINITIONS.map((definition) => {\n    const availableTools = definition.tools.filter((toolName) => available.has(toolName) && !denied.has(toolName));\n    const unavailableTools = definition.tools.filter((toolName) => !availableTools.includes(toolName));\n    return {\n      ...definition,\n      availableTools,\n      unavailableTools,\n    };\n  });\n}\n\nexport function createAgentCapabilitySessionState(\n  id: string,\n  source: AgentCapabilityActivationSource,\n  now = Date.now(),\n): AgentCapabilitySessionState | null {\n  const definition = getAgentCapability(id);\n  if (!definition) return null;\n  return {\n    id: definition.id,\n    source,\n    activatedAt: now,\n    ttl: definition.activation.ttl,\n    status: 'collecting',\n  };\n}\n"],"mappings":";;AAQA,MAAM,kBAA0D,IAAI,IAClE,6BAA6B,KAAK,eAAe,CAAC,WAAW,IAAI,WAAW,CAAC,CAC9E;AAED,SAAgB,wBAAqD;AACnE,QAAO,CAAC,GAAG,6BAA6B;;AAG1C,SAAgB,mBAAmB,IAAmD;AACpF,QAAO,gBAAgB,IAAI,GAAG,MAAM,CAAC;;AAGvC,SAAgB,4BAA4B,KAAkC;CAC5E,MAAM,MAAgB,EAAE;CACxB,MAAM,uBAAO,IAAI,KAAa;AAC9B,MAAK,MAAM,MAAM,KAAK;EACpB,MAAM,aAAa,mBAAmB,GAAG;AACzC,MAAI,CAAC,WAAY;AACjB,OAAK,MAAM,YAAY,WAAW,OAAO;AACvC,OAAI,KAAK,IAAI,SAAS,CAAE;AACxB,QAAK,IAAI,SAAS;AAClB,OAAI,KAAK,SAAS;;;AAGtB,QAAO;;AAGT,SAAgB,8BAA8B,UAI1C,EAAE,EAAiC;CACrC,MAAM,YAAY,IAAI,IAAI,CACxB,GAAI,QAAQ,uBAAuB,EAAE,EACrC,GAAI,QAAQ,iBAAiB,EAAE,CAChC,CAAC;CACF,MAAM,SAAS,IAAI,IAAI,QAAQ,mBAAmB,EAAE,CAAC;AACrD,QAAO,6BAA6B,KAAK,eAAe;EACtD,MAAM,iBAAiB,WAAW,MAAM,QAAQ,aAAa,UAAU,IAAI,SAAS,IAAI,CAAC,OAAO,IAAI,SAAS,CAAC;EAC9G,MAAM,mBAAmB,WAAW,MAAM,QAAQ,aAAa,CAAC,eAAe,SAAS,SAAS,CAAC;AAClG,SAAO;GACL,GAAG;GACH;GACA;GACD;GACD;;AAGJ,SAAgB,kCACd,IACA,QACA,MAAM,KAAK,KAAK,EACoB;CACpC,MAAM,aAAa,mBAAmB,GAAG;AACzC,KAAI,CAAC,WAAY,QAAO;AACxB,QAAO;EACL,IAAI,WAAW;EACf;EACA,aAAa;EACb,KAAK,WAAW,WAAW;EAC3B,QAAQ;EACT"}

package/dist/src/agent/goals/post-turn.js

@@ -22,7 +22,9 @@ function buildHistoryExcerpt(messages, maxChars) {
 	}
 }
 function buildGoalContextText(goal) {
-	const lines = [`Title: ${goal.title}`];
+	const lines = [`Title: ${goal.contract?.objective || goal.title}`];
+	if (goal.contract?.scopeBoundary) lines.push(`Scope boundary:\n${goal.contract.scopeBoundary}`);
+	if (goal.contract?.evidencePlan.length) lines.push(`Expected completion evidence:\n${goal.contract.evidencePlan.map((item) => `- ${item}`).join("\n")}`);
 	if (goal.contextMessage?.text.trim()) lines.push(`Context:\n${goal.contextMessage.text.trim()}`);
 	if (goal.contextMessage?.attachments.length) lines.push(["Attachments:", ...goal.contextMessage.attachments.map((attachment) => `- ${attachment.name} (${attachment.mimeType}, ${attachment.size} bytes) ${attachment.uri}`)].join("\n"));
 	return lines.join("\n\n");
@@ -93,12 +95,31 @@ async function handlePersistentGoalPostTurn(opts) {
 			sessionKey
 		}, `Persistent goal: could not load messages for judge context: ${err instanceof Error ? err.message : String(err)}`);
 	}
-	const decision = await evaluateAfterTurnHermesLike(state, assistantPlainText, judgeRef, signal, {
+	let decision = await evaluateAfterTurnHermesLike(state, assistantPlainText, judgeRef, signal, {
 		goalsSlice: goalsCfg,
 		historyExcerpt,
 		goalContextExcerpt: buildGoalContextText(goal),
 		uiLocale: resolveGoalUiLocale(state)
 	});
+	const completionReadiness = goalService.getCompletionReadiness(goal.id);
+	if (decision.verdict === "done" && completionReadiness && !completionReadiness.ready && decision.newState) {
+		const reason = `Completion evidence still needed: ${completionReadiness.missingEvidence.join("; ")}`;
+		decision = {
+			...decision,
+			newState: {
+				...decision.newState,
+				status: "active",
+				lastVerdict: "continue",
+				lastReason: reason
+			},
+			shouldContinue: true,
+			continuationPrompt: `Before declaring the goal complete, collect this evidence:\n${completionReadiness.missingEvidence.map((item) => `- ${item}`).join("\n")}`,
+			verdict: "continue",
+			reason,
+			message: reason,
+			missingEvidence: completionReadiness.missingEvidence
+		};
+	}
 	if (decision.newState) {
 		const ns = decision.newState;
 		const completedChecklistItemIds = decision.completedChecklistItemIndexes?.map((index) => goal.checklist[index]?.id).filter((id) => typeof id === "string" && id.length > 0);

package/dist/src/agent/goals/post-turn.js.map

@@ -1 +1 @@
-{"version":3,"file":"post-turn.js","names":[],"sources":["../../../../src/agent/goals/post-turn.ts"],"sourcesContent":["import type { AgentMessage } from '@earendil-works/pi-agent-core';\n\nimport type { Config, GoalsConfig } from '../../config/schema.js';\nimport { getAgentDefaultModelRef } from '../../config/schema.js';\nimport { resolveEffectiveAgentProfileForSession } from '../../config/agent-profile.js';\nimport { GoalService } from '../../goals/index.js';\nimport { createLogger } from '../../utils/logger.js';\n\nimport { evaluateAfterTurnHermesLike } from './evaluate-turn.js';\nimport { resolveGoalUiLocale } from './goal-locale.js';\nimport type { PersistentGoalApis } from './persistent-goal-apis.js';\nimport type { PersistentGoalState } from './state.js';\n\nconst log = createLogger('PersistentGoal');\nconst goalService = new GoalService();\n\nfunction buildHistoryExcerpt(messages: AgentMessage[], maxChars: number): string {\n  if (maxChars <= 0) return '';\n  try {\n    const raw = JSON.stringify(messages);\n    if (raw.length <= maxChars) return raw;\n    return raw.slice(-maxChars);\n  } catch {\n    return '';\n  }\n}\n\nfunction buildGoalContextText(goal: NonNullable<ReturnType<GoalService['get']>>): string {\n  const lines = [`Title: ${goal.title}`];\n  if (goal.contextMessage?.text.trim()) {\n    lines.push(`Context:\\n${goal.contextMessage.text.trim()}`);\n  }\n  if (goal.contextMessage?.attachments.length) {\n    lines.push(\n      [\n        'Attachments:',\n        ...goal.contextMessage.attachments.map((attachment) =>\n          `- ${attachment.name} (${attachment.mimeType}, ${attachment.size} bytes) ${attachment.uri}`,\n        ),\n      ].join('\\n'),\n    );\n  }\n  return lines.join('\\n\\n');\n}\n\nfunction resolveJudgeModelRef(\n  config: Config | undefined,\n  sessionKey: string,\n  storedJudge?: string,\n  runtimeSessionModelRef?: string,\n): string | undefined {\n  const fromCfg = config?.goals?.judgeModelRef?.trim();\n  if (fromCfg) return fromCfg;\n  if (storedJudge?.trim()) return storedJudge.trim();\n  if (config) {\n    const profile = resolveEffectiveAgentProfileForSession(config, sessionKey);\n    if (profile.primaryModelRef?.trim()) return profile.primaryModelRef.trim();\n  }\n  if (runtimeSessionModelRef?.trim()) return runtimeSessionModelRef.trim();\n  if (config) return getAgentDefaultModelRef(config);\n  return undefined;\n}\n\nexport function shouldRunInitialChecklistDecomposition(input: {\n  checklistLength: number;\n  turnsUsed: number;\n  checklistDecomposePolicy?: GoalsConfig['checklistDecomposePolicy'];\n}): boolean {\n  if (input.checklistLength === 0) return true;\n  return input.checklistDecomposePolicy === 'supplement_existing' && input.turnsUsed === 0;\n}\n\nasync function appendAssistantLine(apis: PersistentGoalApis, sessionKey: string, text: string): Promise<void> {\n  await apis.appendAssistantReceipt(sessionKey, text);\n}\n\nexport async function handlePersistentGoalPostTurn(opts: {\n  apis: PersistentGoalApis;\n  sessionKey: string;\n  assistantPlainText: string;\n  aborted: boolean;\n  streamError?: string;\n  skipPersistentGoalPostTurn: boolean;\n  config: Config | undefined;\n  /** Active session model (overrides, per-agent defaults) when goals/global defaults are unset. */\n  runtimeSessionModelRef?: string;\n  signal?: AbortSignal;\n  /** Hermes-style: verdict line also sent as a normal outbound message (non-webchat). */\n  publishVerdictToChannel?: (text: string) => Promise<void>;\n  onGoalStatusUpdated?: (payload: {\n    goalId: string;\n    sessionKey: string;\n    previousStatus: string;\n    status: string;\n    goal: import('../../goals/types.js').GoalWithDetails;\n  }) => void;\n}): Promise<void> {\n  const {\n    apis,\n    sessionKey,\n    assistantPlainText,\n    aborted,\n    streamError,\n    skipPersistentGoalPostTurn,\n    config,\n    runtimeSessionModelRef,\n    signal,\n    publishVerdictToChannel,\n    onGoalStatusUpdated,\n  } = opts;\n\n  if (skipPersistentGoalPostTurn) return;\n  if (aborted || streamError) return;\n\n  const meta = await apis.getSessionMetadata(sessionKey);\n  if (!meta) return;\n\n  const goal = goalService.getActiveForSession(sessionKey);\n  if (!goal || goal.status !== 'active') return;\n\n  const goalsCfg = config?.goals;\n  const shouldDecomposeChecklist = shouldRunInitialChecklistDecomposition({\n    checklistLength: goal.checklist.length,\n    turnsUsed: goal.turnsUsed,\n    checklistDecomposePolicy: goalsCfg?.checklistDecomposePolicy,\n  });\n  const state: PersistentGoalState = {\n    goal: buildGoalContextText(goal),\n    status: 'active',\n    turnsUsed: goal.turnsUsed,\n    maxTurns: goal.maxTurns,\n    createdAt: goal.createdAt,\n    lastTurnAt: goal.updatedAt,\n    lastReason: goal.blockedReason,\n    judgeModelRef: goal.judgeModelRef,\n    decomposed: shouldDecomposeChecklist ? undefined : true,\n    uiLocale: goal.uiLocale,\n    checklist: goal.checklist.map((it) => ({\n      text: it.text,\n      status: it.status,\n      addedBy: it.addedBy,\n      addedAt: it.addedAt,\n      completedAt: it.completedAt,\n      evidence: it.evidenceSummary,\n    })),\n  };\n\n  const judgeRef = resolveJudgeModelRef(config, sessionKey, state.judgeModelRef, runtimeSessionModelRef);\n  if (!judgeRef) {\n    log.warn({ sessionKey }, 'Persistent goal: no judge model ref; skipping post-turn');\n    return;\n  }\n\n  const historyCap = goalsCfg?.checklistHistoryChars ?? 24_000;\n  let historyExcerpt = '';\n  try {\n    const msgs = await apis.loadMessages(sessionKey);\n    historyExcerpt = buildHistoryExcerpt(msgs, historyCap);\n  } catch (err) {\n    log.debug(\n      { err, sessionKey },\n      `Persistent goal: could not load messages for judge context: ${err instanceof Error ? err.message : String(err)}`,\n    );\n  }\n\n  const decision = await evaluateAfterTurnHermesLike(state, assistantPlainText, judgeRef, signal, {\n    goalsSlice: goalsCfg,\n    historyExcerpt,\n    goalContextExcerpt: buildGoalContextText(goal),\n    uiLocale: resolveGoalUiLocale(state),\n  });\n\n  if (decision.newState) {\n    const ns = decision.newState;\n    const completedChecklistItemIds = decision.completedChecklistItemIndexes\n      ?.map((index) => goal.checklist[index]?.id)\n      .filter((id): id is string => typeof id === 'string' && id.length > 0);\n    try {\n      const updatedGoal = goalService.syncPostTurnState({\n        goalId: goal.id,\n        sessionKey,\n        source: 'chat',\n        status: ns.status === 'done'\n          ? 'done'\n          : decision.verdict === 'blocked'\n            ? 'blocked'\n            : decision.verdict === 'needs_input'\n              ? 'needs_input'\n              : ns.status === 'paused'\n                ? 'paused'\n                : 'active',\n        turnsUsed: ns.turnsUsed,\n        maxTurns: ns.maxTurns,\n        reason: ns.pausedReason ?? decision.reason,\n        nextAction: decision.continuationPrompt ?? undefined,\n        assistantPreview: assistantPlainText,\n        verdict: decision.verdict === 'done'\n          ? 'done'\n          : decision.verdict === 'decompose'\n            ? 'decompose'\n            : decision.verdict === 'blocked'\n              ? 'blocked'\n              : decision.verdict === 'needs_input'\n                ? 'needs_input'\n                : 'continue',\n        confidence: decision.confidence,\n        missingEvidence: decision.missingEvidence,\n        userQuestion: decision.userQuestion,\n        completedChecklistItemIds,\n        checklist: ns.checklist?.map((it) => ({\n          text: it.text,\n          status: it.status,\n          addedBy: it.addedBy,\n          addedAt: it.addedAt,\n          completedAt: it.completedAt,\n          evidenceSummary: it.evidence,\n        })),\n      });\n      if (updatedGoal && updatedGoal.status !== goal.status) {\n        onGoalStatusUpdated?.({\n          goalId: goal.id,\n          sessionKey,\n          previousStatus: goal.status,\n          status: updatedGoal.status,\n          goal: updatedGoal,\n        });\n      }\n    } catch (err) {\n      log.warn(\n        { err, sessionKey, goalId: goal.id },\n        `Persistent goal: SQLite goal update failed: ${err instanceof Error ? err.message : String(err)}`,\n      );\n    }\n  }\n\n  if (decision.message) {\n    if (publishVerdictToChannel) {\n      try {\n        await publishVerdictToChannel(decision.message);\n      } catch (err) {\n        log.warn(\n          { err, sessionKey },\n          `Persistent goal: channel verdict send failed: ${err instanceof Error ? err.message : String(err)}`,\n        );\n      }\n    } else {\n      try {\n        await appendAssistantLine(apis, sessionKey, decision.message);\n      } catch (err) {\n        log.warn(\n          { err, sessionKey },\n          `Persistent goal: failed to append status message: ${err instanceof Error ? err.message : String(err)}`,\n        );\n      }\n    }\n  }\n\n  if (decision.shouldContinue && decision.continuationPrompt) {\n    apis.scheduleContinuation(sessionKey, decision.continuationPrompt);\n  }\n}\n"],"mappings":";;;;;;;;;aAGiE;aAGZ;AAOrD,MAAM,MAAM,aAAa,iBAAiB;AAC1C,MAAM,cAAc,IAAI,aAAa;AAErC,SAAS,oBAAoB,UAA0B,UAA0B;AAC/E,KAAI,YAAY,EAAG,QAAO;AAC1B,KAAI;EACF,MAAM,MAAM,KAAK,UAAU,SAAS;AACpC,MAAI,IAAI,UAAU,SAAU,QAAO;AACnC,SAAO,IAAI,MAAM,CAAC,SAAS;SACrB;AACN,SAAO;;;AAIX,SAAS,qBAAqB,MAA2D;CACvF,MAAM,QAAQ,CAAC,UAAU,KAAK,QAAQ;AACtC,KAAI,KAAK,gBAAgB,KAAK,MAAM,CAClC,OAAM,KAAK,aAAa,KAAK,eAAe,KAAK,MAAM,GAAG;AAE5D,KAAI,KAAK,gBAAgB,YAAY,OACnC,OAAM,KACJ,CACE,gBACA,GAAG,KAAK,eAAe,YAAY,KAAK,eACtC,KAAK,WAAW,KAAK,IAAI,WAAW,SAAS,IAAI,WAAW,KAAK,UAAU,WAAW,MACvF,CACF,CAAC,KAAK,KAAK,CACb;AAEH,QAAO,MAAM,KAAK,OAAO;;AAG3B,SAAS,qBACP,QACA,YACA,aACA,wBACoB;CACpB,MAAM,UAAU,QAAQ,OAAO,eAAe,MAAM;AACpD,KAAI,QAAS,QAAO;AACpB,KAAI,aAAa,MAAM,CAAE,QAAO,YAAY,MAAM;AAClD,KAAI,QAAQ;EACV,MAAM,UAAU,uCAAuC,QAAQ,WAAW;AAC1E,MAAI,QAAQ,iBAAiB,MAAM,CAAE,QAAO,QAAQ,gBAAgB,MAAM;;AAE5E,KAAI,wBAAwB,MAAM,CAAE,QAAO,uBAAuB,MAAM;AACxE,KAAI,OAAQ,QAAO,wBAAwB,OAAO;;AAIpD,SAAgB,uCAAuC,OAI3C;AACV,KAAI,MAAM,oBAAoB,EAAG,QAAO;AACxC,QAAO,MAAM,6BAA6B,yBAAyB,MAAM,cAAc;;AAGzF,eAAe,oBAAoB,MAA0B,YAAoB,MAA6B;AAC5G,OAAM,KAAK,uBAAuB,YAAY,KAAK;;AAGrD,eAAsB,6BAA6B,MAoBjC;CAChB,MAAM,EACJ,MACA,YACA,oBACA,SACA,aACA,4BACA,QACA,wBACA,QACA,yBACA,wBACE;AAEJ,KAAI,2BAA4B;AAChC,KAAI,WAAW,YAAa;AAG5B,KAAI,CAAC,MADc,KAAK,mBAAmB,WAAW,CAC3C;CAEX,MAAM,OAAO,YAAY,oBAAoB,WAAW;AACxD,KAAI,CAAC,QAAQ,KAAK,WAAW,SAAU;CAEvC,MAAM,WAAW,QAAQ;CACzB,MAAM,2BAA2B,uCAAuC;EACtE,iBAAiB,KAAK,UAAU;EAChC,WAAW,KAAK;EAChB,0BAA0B,UAAU;EACrC,CAAC;CACF,MAAM,QAA6B;EACjC,MAAM,qBAAqB,KAAK;EAChC,QAAQ;EACR,WAAW,KAAK;EAChB,UAAU,KAAK;EACf,WAAW,KAAK;EAChB,YAAY,KAAK;EACjB,YAAY,KAAK;EACjB,eAAe,KAAK;EACpB,YAAY,2BAA2B,KAAA,IAAY;EACnD,UAAU,KAAK;EACf,WAAW,KAAK,UAAU,KAAK,QAAQ;GACrC,MAAM,GAAG;GACT,QAAQ,GAAG;GACX,SAAS,GAAG;GACZ,SAAS,GAAG;GACZ,aAAa,GAAG;GAChB,UAAU,GAAG;GACd,EAAE;EACJ;CAED,MAAM,WAAW,qBAAqB,QAAQ,YAAY,MAAM,eAAe,uBAAuB;AACtG,KAAI,CAAC,UAAU;AACb,MAAI,KAAK,EAAE,YAAY,EAAE,0DAA0D;AACnF;;CAGF,MAAM,aAAa,UAAU,yBAAyB;CACtD,IAAI,iBAAiB;AACrB,KAAI;AAEF,mBAAiB,oBAAoB,MADlB,KAAK,aAAa,WAAW,EACL,WAAW;UAC/C,KAAK;AACZ,MAAI,MACF;GAAE;GAAK;GAAY,EACnB,+DAA+D,eAAe,QAAQ,IAAI,UAAU,OAAO,IAAI,GAChH;;CAGH,MAAM,WAAW,MAAM,4BAA4B,OAAO,oBAAoB,UAAU,QAAQ;EAC9F,YAAY;EACZ;EACA,oBAAoB,qBAAqB,KAAK;EAC9C,UAAU,oBAAoB,MAAM;EACrC,CAAC;AAEF,KAAI,SAAS,UAAU;EACrB,MAAM,KAAK,SAAS;EACpB,MAAM,4BAA4B,SAAS,+BACvC,KAAK,UAAU,KAAK,UAAU,QAAQ,GAAG,CAC1C,QAAQ,OAAqB,OAAO,OAAO,YAAY,GAAG,SAAS,EAAE;AACxE,MAAI;GACF,MAAM,cAAc,YAAY,kBAAkB;IAChD,QAAQ,KAAK;IACb;IACA,QAAQ;IACR,QAAQ,GAAG,WAAW,SAClB,SACA,SAAS,YAAY,YACnB,YACA,SAAS,YAAY,gBACnB,gBACA,GAAG,WAAW,WACZ,WACA;IACV,WAAW,GAAG;IACd,UAAU,GAAG;IACb,QAAQ,GAAG,gBAAgB,SAAS;IACpC,YAAY,SAAS,sBAAsB,KAAA;IAC3C,kBAAkB;IAClB,SAAS,SAAS,YAAY,SAC1B,SACA,SAAS,YAAY,cACnB,cACA,SAAS,YAAY,YACnB,YACA,SAAS,YAAY,gBACnB,gBACA;IACV,YAAY,SAAS;IACrB,iBAAiB,SAAS;IAC1B,cAAc,SAAS;IACvB;IACA,WAAW,GAAG,WAAW,KAAK,QAAQ;KACpC,MAAM,GAAG;KACT,QAAQ,GAAG;KACX,SAAS,GAAG;KACZ,SAAS,GAAG;KACZ,aAAa,GAAG;KAChB,iBAAiB,GAAG;KACrB,EAAE;IACJ,CAAC;AACF,OAAI,eAAe,YAAY,WAAW,KAAK,OAC7C,uBAAsB;IACpB,QAAQ,KAAK;IACb;IACA,gBAAgB,KAAK;IACrB,QAAQ,YAAY;IACpB,MAAM;IACP,CAAC;WAEG,KAAK;AACZ,OAAI,KACF;IAAE;IAAK;IAAY,QAAQ,KAAK;IAAI,EACpC,+CAA+C,eAAe,QAAQ,IAAI,UAAU,OAAO,IAAI,GAChG;;;AAIL,KAAI,SAAS,QACX,KAAI,wBACF,KAAI;AACF,QAAM,wBAAwB,SAAS,QAAQ;UACxC,KAAK;AACZ,MAAI,KACF;GAAE;GAAK;GAAY,EACnB,iDAAiD,eAAe,QAAQ,IAAI,UAAU,OAAO,IAAI,GAClG;;KAGH,KAAI;AACF,QAAM,oBAAoB,MAAM,YAAY,SAAS,QAAQ;UACtD,KAAK;AACZ,MAAI,KACF;GAAE;GAAK;GAAY,EACnB,qDAAqD,eAAe,QAAQ,IAAI,UAAU,OAAO,IAAI,GACtG;;AAKP,KAAI,SAAS,kBAAkB,SAAS,mBACtC,MAAK,qBAAqB,YAAY,SAAS,mBAAmB"}
+{"version":3,"file":"post-turn.js","names":[],"sources":["../../../../src/agent/goals/post-turn.ts"],"sourcesContent":["import type { AgentMessage } from '@earendil-works/pi-agent-core';\n\nimport type { Config, GoalsConfig } from '../../config/schema.js';\nimport { getAgentDefaultModelRef } from '../../config/schema.js';\nimport { resolveEffectiveAgentProfileForSession } from '../../config/agent-profile.js';\nimport { GoalService } from '../../goals/index.js';\nimport { createLogger } from '../../utils/logger.js';\n\nimport { evaluateAfterTurnHermesLike } from './evaluate-turn.js';\nimport { resolveGoalUiLocale } from './goal-locale.js';\nimport type { PersistentGoalApis } from './persistent-goal-apis.js';\nimport type { PersistentGoalState } from './state.js';\n\nconst log = createLogger('PersistentGoal');\nconst goalService = new GoalService();\n\nfunction buildHistoryExcerpt(messages: AgentMessage[], maxChars: number): string {\n  if (maxChars <= 0) return '';\n  try {\n    const raw = JSON.stringify(messages);\n    if (raw.length <= maxChars) return raw;\n    return raw.slice(-maxChars);\n  } catch {\n    return '';\n  }\n}\n\nfunction buildGoalContextText(goal: NonNullable<ReturnType<GoalService['get']>>): string {\n  const lines = [`Title: ${goal.contract?.objective || goal.title}`];\n  if (goal.contract?.scopeBoundary) {\n    lines.push(`Scope boundary:\\n${goal.contract.scopeBoundary}`);\n  }\n  if (goal.contract?.evidencePlan.length) {\n    lines.push(`Expected completion evidence:\\n${goal.contract.evidencePlan.map((item) => `- ${item}`).join('\\n')}`);\n  }\n  if (goal.contextMessage?.text.trim()) {\n    lines.push(`Context:\\n${goal.contextMessage.text.trim()}`);\n  }\n  if (goal.contextMessage?.attachments.length) {\n    lines.push(\n      [\n        'Attachments:',\n        ...goal.contextMessage.attachments.map((attachment) =>\n          `- ${attachment.name} (${attachment.mimeType}, ${attachment.size} bytes) ${attachment.uri}`,\n        ),\n      ].join('\\n'),\n    );\n  }\n  return lines.join('\\n\\n');\n}\n\nfunction resolveJudgeModelRef(\n  config: Config | undefined,\n  sessionKey: string,\n  storedJudge?: string,\n  runtimeSessionModelRef?: string,\n): string | undefined {\n  const fromCfg = config?.goals?.judgeModelRef?.trim();\n  if (fromCfg) return fromCfg;\n  if (storedJudge?.trim()) return storedJudge.trim();\n  if (config) {\n    const profile = resolveEffectiveAgentProfileForSession(config, sessionKey);\n    if (profile.primaryModelRef?.trim()) return profile.primaryModelRef.trim();\n  }\n  if (runtimeSessionModelRef?.trim()) return runtimeSessionModelRef.trim();\n  if (config) return getAgentDefaultModelRef(config);\n  return undefined;\n}\n\nexport function shouldRunInitialChecklistDecomposition(input: {\n  checklistLength: number;\n  turnsUsed: number;\n  checklistDecomposePolicy?: GoalsConfig['checklistDecomposePolicy'];\n}): boolean {\n  if (input.checklistLength === 0) return true;\n  return input.checklistDecomposePolicy === 'supplement_existing' && input.turnsUsed === 0;\n}\n\nasync function appendAssistantLine(apis: PersistentGoalApis, sessionKey: string, text: string): Promise<void> {\n  await apis.appendAssistantReceipt(sessionKey, text);\n}\n\nexport async function handlePersistentGoalPostTurn(opts: {\n  apis: PersistentGoalApis;\n  sessionKey: string;\n  assistantPlainText: string;\n  aborted: boolean;\n  streamError?: string;\n  skipPersistentGoalPostTurn: boolean;\n  config: Config | undefined;\n  /** Active session model (overrides, per-agent defaults) when goals/global defaults are unset. */\n  runtimeSessionModelRef?: string;\n  signal?: AbortSignal;\n  /** Hermes-style: verdict line also sent as a normal outbound message (non-webchat). */\n  publishVerdictToChannel?: (text: string) => Promise<void>;\n  onGoalStatusUpdated?: (payload: {\n    goalId: string;\n    sessionKey: string;\n    previousStatus: string;\n    status: string;\n    goal: import('../../goals/types.js').GoalWithDetails;\n  }) => void;\n}): Promise<void> {\n  const {\n    apis,\n    sessionKey,\n    assistantPlainText,\n    aborted,\n    streamError,\n    skipPersistentGoalPostTurn,\n    config,\n    runtimeSessionModelRef,\n    signal,\n    publishVerdictToChannel,\n    onGoalStatusUpdated,\n  } = opts;\n\n  if (skipPersistentGoalPostTurn) return;\n  if (aborted || streamError) return;\n\n  const meta = await apis.getSessionMetadata(sessionKey);\n  if (!meta) return;\n\n  const goal = goalService.getActiveForSession(sessionKey);\n  if (!goal || goal.status !== 'active') return;\n\n  const goalsCfg = config?.goals;\n  const shouldDecomposeChecklist = shouldRunInitialChecklistDecomposition({\n    checklistLength: goal.checklist.length,\n    turnsUsed: goal.turnsUsed,\n    checklistDecomposePolicy: goalsCfg?.checklistDecomposePolicy,\n  });\n  const state: PersistentGoalState = {\n    goal: buildGoalContextText(goal),\n    status: 'active',\n    turnsUsed: goal.turnsUsed,\n    maxTurns: goal.maxTurns,\n    createdAt: goal.createdAt,\n    lastTurnAt: goal.updatedAt,\n    lastReason: goal.blockedReason,\n    judgeModelRef: goal.judgeModelRef,\n    decomposed: shouldDecomposeChecklist ? undefined : true,\n    uiLocale: goal.uiLocale,\n    checklist: goal.checklist.map((it) => ({\n      text: it.text,\n      status: it.status,\n      addedBy: it.addedBy,\n      addedAt: it.addedAt,\n      completedAt: it.completedAt,\n      evidence: it.evidenceSummary,\n    })),\n  };\n\n  const judgeRef = resolveJudgeModelRef(config, sessionKey, state.judgeModelRef, runtimeSessionModelRef);\n  if (!judgeRef) {\n    log.warn({ sessionKey }, 'Persistent goal: no judge model ref; skipping post-turn');\n    return;\n  }\n\n  const historyCap = goalsCfg?.checklistHistoryChars ?? 24_000;\n  let historyExcerpt = '';\n  try {\n    const msgs = await apis.loadMessages(sessionKey);\n    historyExcerpt = buildHistoryExcerpt(msgs, historyCap);\n  } catch (err) {\n    log.debug(\n      { err, sessionKey },\n      `Persistent goal: could not load messages for judge context: ${err instanceof Error ? err.message : String(err)}`,\n    );\n  }\n\n  let decision = await evaluateAfterTurnHermesLike(state, assistantPlainText, judgeRef, signal, {\n    goalsSlice: goalsCfg,\n    historyExcerpt,\n    goalContextExcerpt: buildGoalContextText(goal),\n    uiLocale: resolveGoalUiLocale(state),\n  });\n\n  const completionReadiness = goalService.getCompletionReadiness(goal.id);\n  if (decision.verdict === 'done' && completionReadiness && !completionReadiness.ready && decision.newState) {\n    const reason = `Completion evidence still needed: ${completionReadiness.missingEvidence.join('; ')}`;\n    decision = {\n      ...decision,\n      newState: {\n        ...decision.newState,\n        status: 'active',\n        lastVerdict: 'continue',\n        lastReason: reason,\n      },\n      shouldContinue: true,\n      continuationPrompt: `Before declaring the goal complete, collect this evidence:\\n${completionReadiness.missingEvidence.map((item) => `- ${item}`).join('\\n')}`,\n      verdict: 'continue',\n      reason,\n      message: reason,\n      missingEvidence: completionReadiness.missingEvidence,\n    };\n  }\n\n  if (decision.newState) {\n    const ns = decision.newState;\n    const completedChecklistItemIds = decision.completedChecklistItemIndexes\n      ?.map((index) => goal.checklist[index]?.id)\n      .filter((id): id is string => typeof id === 'string' && id.length > 0);\n    try {\n      const updatedGoal = goalService.syncPostTurnState({\n        goalId: goal.id,\n        sessionKey,\n        source: 'chat',\n        status: ns.status === 'done'\n          ? 'done'\n          : decision.verdict === 'blocked'\n            ? 'blocked'\n            : decision.verdict === 'needs_input'\n              ? 'needs_input'\n              : ns.status === 'paused'\n                ? 'paused'\n                : 'active',\n        turnsUsed: ns.turnsUsed,\n        maxTurns: ns.maxTurns,\n        reason: ns.pausedReason ?? decision.reason,\n        nextAction: decision.continuationPrompt ?? undefined,\n        assistantPreview: assistantPlainText,\n        verdict: decision.verdict === 'done'\n          ? 'done'\n          : decision.verdict === 'decompose'\n            ? 'decompose'\n            : decision.verdict === 'blocked'\n              ? 'blocked'\n              : decision.verdict === 'needs_input'\n                ? 'needs_input'\n                : 'continue',\n        confidence: decision.confidence,\n        missingEvidence: decision.missingEvidence,\n        userQuestion: decision.userQuestion,\n        completedChecklistItemIds,\n        checklist: ns.checklist?.map((it) => ({\n          text: it.text,\n          status: it.status,\n          addedBy: it.addedBy,\n          addedAt: it.addedAt,\n          completedAt: it.completedAt,\n          evidenceSummary: it.evidence,\n        })),\n      });\n      if (updatedGoal && updatedGoal.status !== goal.status) {\n        onGoalStatusUpdated?.({\n          goalId: goal.id,\n          sessionKey,\n          previousStatus: goal.status,\n          status: updatedGoal.status,\n          goal: updatedGoal,\n        });\n      }\n    } catch (err) {\n      log.warn(\n        { err, sessionKey, goalId: goal.id },\n        `Persistent goal: SQLite goal update failed: ${err instanceof Error ? err.message : String(err)}`,\n      );\n    }\n  }\n\n  if (decision.message) {\n    if (publishVerdictToChannel) {\n      try {\n        await publishVerdictToChannel(decision.message);\n      } catch (err) {\n        log.warn(\n          { err, sessionKey },\n          `Persistent goal: channel verdict send failed: ${err instanceof Error ? err.message : String(err)}`,\n        );\n      }\n    } else {\n      try {\n        await appendAssistantLine(apis, sessionKey, decision.message);\n      } catch (err) {\n        log.warn(\n          { err, sessionKey },\n          `Persistent goal: failed to append status message: ${err instanceof Error ? err.message : String(err)}`,\n        );\n      }\n    }\n  }\n\n  if (decision.shouldContinue && decision.continuationPrompt) {\n    apis.scheduleContinuation(sessionKey, decision.continuationPrompt);\n  }\n}\n"],"mappings":"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"}

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

@@ -10,6 +10,7 @@ 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';
+import type { SkillInstallToolOptions, SkillInstallToolResult } from '../tools/skill-install-tool.js';
 export interface CommandContext {
     sessionKey: string;
     channel: string;
@@ -39,6 +40,8 @@ export interface CommandHandlerConfig {
     abortSessionTurn?: (sessionKey: string) => Promise<void>;
     /** Reload skills from disk and refresh active agent prompts. */
     reloadSkills?: () => void | Promise<void>;
+    /** Install a managed skill from an explicit source and refresh active agent prompts. */
+    installSkillFromSource?: (opts: SkillInstallToolOptions) => Promise<SkillInstallToolResult>;
     compactSession?: (sessionKey: string, options?: {
         instructions?: string;
         force?: boolean;
@@ -67,6 +70,7 @@ export declare class CommandHandler {
     private invalidateAgentSession?;
     private abortSessionTurn?;
     private reloadSkills?;
+    private installSkillFromSource?;
     private compactSession?;
     private btwQuery?;
     private getSessionContextReport?;

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

@@ -23,6 +23,7 @@ var CommandHandler = class {
 	invalidateAgentSession;
 	abortSessionTurn;
 	reloadSkills;
+	installSkillFromSource;
 	compactSession;
 	btwQuery;
 	getSessionContextReport;
@@ -40,6 +41,7 @@ var CommandHandler = class {
 		this.invalidateAgentSession = handlerConfig.invalidateAgentSession;
 		this.abortSessionTurn = handlerConfig.abortSessionTurn;
 		this.reloadSkills = handlerConfig.reloadSkills;
+		this.installSkillFromSource = handlerConfig.installSkillFromSource;
 		this.compactSession = handlerConfig.compactSession;
 		this.btwQuery = handlerConfig.btwQuery;
 		this.getSessionContextReport = handlerConfig.getSessionContextReport;
@@ -131,6 +133,10 @@ var CommandHandler = class {
 			reloadSkills: this.reloadSkills ? async () => {
 				await this.reloadSkills();
 			} : void 0,
+			installSkillFromSource: this.installSkillFromSource ? (opts) => this.installSkillFromSource({
+				...opts,
+				sessionKey: context.sessionKey
+			}) : void 0,
 			compactSession: this.compactSession,
 			btwQuery: this.btwQuery,
 			getSessionContextReport: this.getSessionContextReport,

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';\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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"}
+{"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';\nimport type {\n  SkillInstallToolOptions,\n  SkillInstallToolResult,\n} from '../tools/skill-install-tool.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  /** Install a managed skill from an explicit source and refresh active agent prompts. */\n  installSkillFromSource?: (opts: SkillInstallToolOptions) => Promise<SkillInstallToolResult>;\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 installSkillFromSource?: CommandHandlerConfig['installSkillFromSource'];\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.installSkillFromSource = handlerConfig.installSkillFromSource;\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      installSkillFromSource: this.installSkillFromSource\n        ? (opts) => this.installSkillFromSource!({ ...opts, sessionKey: context.sessionKey })\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/service/process-direct-one-shot.js

@@ -42,8 +42,10 @@ async function runProcessDirect(deps, input) {
 			});
 			return slash.aggregatedText ?? "";
 		}
+		const skillTurn = deps.agentManager.prepareSkillTurn(input.sessionKey, turnBody);
+		const textForDirect = skillTurn.text;
 		const userMessage = await buildDirectUserMessageContent({
-			content: turnBody.trimStart().startsWith("/skill:") ? deps.agentManager.expandSkillUserText(turnBody) : turnBody,
+			content: textForDirect,
 			attachments: prepared,
 			sessionKey: input.sessionKey,
 			config: deps.config,
@@ -54,13 +56,13 @@ async function runProcessDirect(deps, input) {
 		setPendingTranscriptUserMessage(input.sessionKey, pendingUserMessage);
 		const result = await (async () => {
 			try {
-				return await runDirectAgentTurn({
+				return await deps.agentManager.withSkillCapabilities(input.sessionKey, skillTurn.activatedCapabilityNames, () => runDirectAgentTurn({
 					...deps,
 					config: deps.config
 				}, {
 					sessionKey: input.sessionKey,
 					userMessage
-				});
+				}));
 			} finally {
 				clearPendingTranscriptUserMessage(input.sessionKey, pendingUserMessage);
 			}

package/dist/src/agent/service/process-direct-one-shot.js.map

@@ -1 +1 @@
-{"version":3,"file":"process-direct-one-shot.js","names":[],"sources":["../../../../src/agent/service/process-direct-one-shot.ts"],"sourcesContent":["import type { AgentMessage } from '@earendil-works/pi-agent-core';\n\nimport type { CommandHandler } from '../messaging/command-handler.js';\nimport type { AgentInstanceGateway } from '../agent-instance-gateway.js';\nimport type { ModelManager } from '../models/index.js';\nimport type { SessionStore } from '../../session/index.js';\nimport type { Config } from '../../config/schema.js';\nimport { initSessionTurn } from '../../session/index.js';\nimport {\n  buildDirectUserMessageContent,\n} from './build-direct-message-content.js';\nimport type { ProcessDirectStreamLog } from './process-direct-streaming.js';\nimport type {\n  InboundAttachmentInput,\n  MediaRef,\n} from '../../channels/attachments/inbound-persist.js';\nimport {\n  hydratePerTurnState,\n  runDirectAgentTurn,\n  tryRunSlashCommand,\n} from './direct-turn-helpers.js';\nimport {\n  clearPendingTranscriptUserMessage,\n  setPendingTranscriptUserMessage,\n  type TranscriptUserMessage,\n} from '../inbound/attachment-pipeline.js';\nimport type { ReviewOutput } from '../../review/review-types.js';\n\nexport type RunProcessDirectDeps = {\n  log: ProcessDirectStreamLog;\n  config: Config;\n  resolveSessionEndpoint: (sessionKey: string) => Promise<{ channel: string; chatId: string }>;\n  initSessionContext: (sessionKey: string, channel: string, chatId: string) => void;\n  hydrateSessionWorkspaceFromStore: (sessionKey: string) => Promise<void>;\n  hydrateSessionModelFromStore: (sessionKey: string) => Promise<void>;\n  agentManager: AgentInstanceGateway;\n  sessionStore: SessionStore;\n  modelManager: ModelManager;\n  applyResolvedThinkingLevel: (sessionKey: string, thinking?: string | null) => Promise<void>;\n  prepareInboundAttachments: (\n    sessionKey: string,\n    attachments?: InboundAttachmentInput[],\n  ) => Promise<MediaRef[] | undefined>;\n  commandHandler: Pick<CommandHandler, 'executeCommandAndAggregateReply'>;\n  onTurnComplete?: (sessionKey: string, lastAssistantText?: string) => void;\n  endDirectRequestContext: () => void;\n  resetSession: (sessionKey: string) => Promise<{ sessionId: string; previousSessionId: string } | null>;\n};\n\nfunction isReviewOutput(value: unknown): value is ReviewOutput {\n  return !!value && typeof value === 'object' && !Array.isArray(value)\n    && (value as { type?: unknown }).type === 'review';\n}\n\nexport async function runProcessDirect(\n  deps: RunProcessDirectDeps,\n  input: {\n    content: string;\n    sessionKey: string;\n    attachments?: InboundAttachmentInput[];\n    thinking?: string;\n  },\n): Promise<string> {\n  const { channel, chatId } = await deps.resolveSessionEndpoint(input.sessionKey);\n  deps.initSessionContext(input.sessionKey, channel, chatId);\n\n  try {\n    let turnBody = input.content;\n    let resetTriggeredAtInit = false;\n    const turn = await initSessionTurn({\n      cfg: deps.config,\n      sessionKey: input.sessionKey,\n      body: input.content,\n      resetSession: deps.resetSession,\n    });\n    resetTriggeredAtInit = turn.resetTriggered;\n    if (turn.bareReset && turn.ackMessage) {\n      return turn.ackMessage;\n    }\n    turnBody = turn.bodyStripped;\n\n    await hydratePerTurnState(deps, input.sessionKey, input.thinking);\n    const prepared = await deps.prepareInboundAttachments(input.sessionKey, input.attachments);\n\n    const slash = await tryRunSlashCommand(\n      deps,\n      { sessionKey: input.sessionKey, channel, chatId },\n      turnBody,\n      { skipResetCommands: resetTriggeredAtInit },\n    );\n    if (slash.matched) {\n      const trimmed = slash.aggregatedText.trim();\n      if (trimmed) {\n        await deps.sessionStore.appendTranscriptMessage(input.sessionKey, {\n          role: 'assistant',\n          content: isReviewOutput(slash.metadata?.review)\n            ? [slash.metadata.review]\n            : [{ type: 'text', text: trimmed }],\n          timestamp: Date.now(),\n          ...(slash.metadata && Object.keys(slash.metadata).length > 0\n            ? { metadata: slash.metadata }\n            : {}),\n        } as AgentMessage);\n      }\n      return slash.aggregatedText ?? '';\n    }\n\n    const textForDirect = turnBody.trimStart().startsWith('/skill:')\n      ? deps.agentManager.expandSkillUserText(turnBody)\n      : turnBody;\n    const userMessage = await buildDirectUserMessageContent({\n      content: textForDirect,\n      attachments: prepared,\n      sessionKey: input.sessionKey,\n      config: deps.config,\n      agentManager: deps.agentManager,\n      modelManager: deps.modelManager,\n    });\n\n    const pendingUserMessage = userMessage as TranscriptUserMessage;\n    setPendingTranscriptUserMessage(input.sessionKey, pendingUserMessage);\n\n    const result = await (async () => {\n      try {\n        return await runDirectAgentTurn(\n          { ...deps, config: deps.config },\n          {\n            sessionKey: input.sessionKey,\n            userMessage,\n          },\n        );\n      } finally {\n        clearPendingTranscriptUserMessage(input.sessionKey, pendingUserMessage);\n      }\n    })();\n\n    if (result.lastAssistantText) {\n      deps.onTurnComplete?.(input.sessionKey, result.lastAssistantText);\n    }\n\n    return result.lastAssistantText ?? '';\n  } finally {\n    deps.endDirectRequestContext();\n  }\n}\n"],"mappings":";;;;;;AAiDA,SAAS,eAAe,OAAuC;AAC7D,QAAO,CAAC,CAAC,SAAS,OAAO,UAAU,YAAY,CAAC,MAAM,QAAQ,MAAM,IAC9D,MAA6B,SAAS;;AAG9C,eAAsB,iBACpB,MACA,OAMiB;CACjB,MAAM,EAAE,SAAS,WAAW,MAAM,KAAK,uBAAuB,MAAM,WAAW;AAC/E,MAAK,mBAAmB,MAAM,YAAY,SAAS,OAAO;AAE1D,KAAI;EACF,IAAI,WAAW,MAAM;EACrB,IAAI,uBAAuB;EAC3B,MAAM,OAAO,MAAM,gBAAgB;GACjC,KAAK,KAAK;GACV,YAAY,MAAM;GAClB,MAAM,MAAM;GACZ,cAAc,KAAK;GACpB,CAAC;AACF,yBAAuB,KAAK;AAC5B,MAAI,KAAK,aAAa,KAAK,WACzB,QAAO,KAAK;AAEd,aAAW,KAAK;AAEhB,QAAM,oBAAoB,MAAM,MAAM,YAAY,MAAM,SAAS;EACjE,MAAM,WAAW,MAAM,KAAK,0BAA0B,MAAM,YAAY,MAAM,YAAY;EAE1F,MAAM,QAAQ,MAAM,mBAClB,MACA;GAAE,YAAY,MAAM;GAAY;GAAS;GAAQ,EACjD,UACA,EAAE,mBAAmB,sBAAsB,CAC5C;AACD,MAAI,MAAM,SAAS;GACjB,MAAM,UAAU,MAAM,eAAe,MAAM;AAC3C,OAAI,QACF,OAAM,KAAK,aAAa,wBAAwB,MAAM,YAAY;IAChE,MAAM;IACN,SAAS,eAAe,MAAM,UAAU,OAAO,GAC3C,CAAC,MAAM,SAAS,OAAO,GACvB,CAAC;KAAE,MAAM;KAAQ,MAAM;KAAS,CAAC;IACrC,WAAW,KAAK,KAAK;IACrB,GAAI,MAAM,YAAY,OAAO,KAAK,MAAM,SAAS,CAAC,SAAS,IACvD,EAAE,UAAU,MAAM,UAAU,GAC5B,EAAE;IACP,CAAiB;AAEpB,UAAO,MAAM,kBAAkB;;EAMjC,MAAM,cAAc,MAAM,8BAA8B;GACtD,SAJoB,SAAS,WAAW,CAAC,WAAW,UAAU,GAC5D,KAAK,aAAa,oBAAoB,SAAS,GAC/C;GAGF,aAAa;GACb,YAAY,MAAM;GAClB,QAAQ,KAAK;GACb,cAAc,KAAK;GACnB,cAAc,KAAK;GACpB,CAAC;EAEF,MAAM,qBAAqB;AAC3B,kCAAgC,MAAM,YAAY,mBAAmB;EAErE,MAAM,SAAS,OAAO,YAAY;AAChC,OAAI;AACF,WAAO,MAAM,mBACX;KAAE,GAAG;KAAM,QAAQ,KAAK;KAAQ,EAChC;KACE,YAAY,MAAM;KAClB;KACD,CACF;aACO;AACR,sCAAkC,MAAM,YAAY,mBAAmB;;MAEvE;AAEJ,MAAI,OAAO,kBACT,MAAK,iBAAiB,MAAM,YAAY,OAAO,kBAAkB;AAGnE,SAAO,OAAO,qBAAqB;WAC3B;AACR,OAAK,yBAAyB"}
+{"version":3,"file":"process-direct-one-shot.js","names":[],"sources":["../../../../src/agent/service/process-direct-one-shot.ts"],"sourcesContent":["import type { AgentMessage } from '@earendil-works/pi-agent-core';\n\nimport type { CommandHandler } from '../messaging/command-handler.js';\nimport type { AgentInstanceGateway } from '../agent-instance-gateway.js';\nimport type { ModelManager } from '../models/index.js';\nimport type { SessionStore } from '../../session/index.js';\nimport type { Config } from '../../config/schema.js';\nimport { initSessionTurn } from '../../session/index.js';\nimport {\n  buildDirectUserMessageContent,\n} from './build-direct-message-content.js';\nimport type { ProcessDirectStreamLog } from './process-direct-streaming.js';\nimport type {\n  InboundAttachmentInput,\n  MediaRef,\n} from '../../channels/attachments/inbound-persist.js';\nimport {\n  hydratePerTurnState,\n  runDirectAgentTurn,\n  tryRunSlashCommand,\n} from './direct-turn-helpers.js';\nimport {\n  clearPendingTranscriptUserMessage,\n  setPendingTranscriptUserMessage,\n  type TranscriptUserMessage,\n} from '../inbound/attachment-pipeline.js';\nimport type { ReviewOutput } from '../../review/review-types.js';\n\nexport type RunProcessDirectDeps = {\n  log: ProcessDirectStreamLog;\n  config: Config;\n  resolveSessionEndpoint: (sessionKey: string) => Promise<{ channel: string; chatId: string }>;\n  initSessionContext: (sessionKey: string, channel: string, chatId: string) => void;\n  hydrateSessionWorkspaceFromStore: (sessionKey: string) => Promise<void>;\n  hydrateSessionModelFromStore: (sessionKey: string) => Promise<void>;\n  agentManager: AgentInstanceGateway;\n  sessionStore: SessionStore;\n  modelManager: ModelManager;\n  applyResolvedThinkingLevel: (sessionKey: string, thinking?: string | null) => Promise<void>;\n  prepareInboundAttachments: (\n    sessionKey: string,\n    attachments?: InboundAttachmentInput[],\n  ) => Promise<MediaRef[] | undefined>;\n  commandHandler: Pick<CommandHandler, 'executeCommandAndAggregateReply'>;\n  onTurnComplete?: (sessionKey: string, lastAssistantText?: string) => void;\n  endDirectRequestContext: () => void;\n  resetSession: (sessionKey: string) => Promise<{ sessionId: string; previousSessionId: string } | null>;\n};\n\nfunction isReviewOutput(value: unknown): value is ReviewOutput {\n  return !!value && typeof value === 'object' && !Array.isArray(value)\n    && (value as { type?: unknown }).type === 'review';\n}\n\nexport async function runProcessDirect(\n  deps: RunProcessDirectDeps,\n  input: {\n    content: string;\n    sessionKey: string;\n    attachments?: InboundAttachmentInput[];\n    thinking?: string;\n  },\n): Promise<string> {\n  const { channel, chatId } = await deps.resolveSessionEndpoint(input.sessionKey);\n  deps.initSessionContext(input.sessionKey, channel, chatId);\n\n  try {\n    let turnBody = input.content;\n    let resetTriggeredAtInit = false;\n    const turn = await initSessionTurn({\n      cfg: deps.config,\n      sessionKey: input.sessionKey,\n      body: input.content,\n      resetSession: deps.resetSession,\n    });\n    resetTriggeredAtInit = turn.resetTriggered;\n    if (turn.bareReset && turn.ackMessage) {\n      return turn.ackMessage;\n    }\n    turnBody = turn.bodyStripped;\n\n    await hydratePerTurnState(deps, input.sessionKey, input.thinking);\n    const prepared = await deps.prepareInboundAttachments(input.sessionKey, input.attachments);\n\n    const slash = await tryRunSlashCommand(\n      deps,\n      { sessionKey: input.sessionKey, channel, chatId },\n      turnBody,\n      { skipResetCommands: resetTriggeredAtInit },\n    );\n    if (slash.matched) {\n      const trimmed = slash.aggregatedText.trim();\n      if (trimmed) {\n        await deps.sessionStore.appendTranscriptMessage(input.sessionKey, {\n          role: 'assistant',\n          content: isReviewOutput(slash.metadata?.review)\n            ? [slash.metadata.review]\n            : [{ type: 'text', text: trimmed }],\n          timestamp: Date.now(),\n          ...(slash.metadata && Object.keys(slash.metadata).length > 0\n            ? { metadata: slash.metadata }\n            : {}),\n        } as AgentMessage);\n      }\n      return slash.aggregatedText ?? '';\n    }\n\n    const skillTurn = deps.agentManager.prepareSkillTurn(input.sessionKey, turnBody);\n    const textForDirect = skillTurn.text;\n    const userMessage = await buildDirectUserMessageContent({\n      content: textForDirect,\n      attachments: prepared,\n      sessionKey: input.sessionKey,\n      config: deps.config,\n      agentManager: deps.agentManager,\n      modelManager: deps.modelManager,\n    });\n\n    const pendingUserMessage = userMessage as TranscriptUserMessage;\n    setPendingTranscriptUserMessage(input.sessionKey, pendingUserMessage);\n\n    const result = await (async () => {\n      try {\n        return await deps.agentManager.withSkillCapabilities(\n          input.sessionKey,\n          skillTurn.activatedCapabilityNames,\n          () =>\n            runDirectAgentTurn(\n              { ...deps, config: deps.config },\n              {\n                sessionKey: input.sessionKey,\n                userMessage,\n              },\n            ),\n        );\n      } finally {\n        clearPendingTranscriptUserMessage(input.sessionKey, pendingUserMessage);\n      }\n    })();\n\n    if (result.lastAssistantText) {\n      deps.onTurnComplete?.(input.sessionKey, result.lastAssistantText);\n    }\n\n    return result.lastAssistantText ?? '';\n  } finally {\n    deps.endDirectRequestContext();\n  }\n}\n"],"mappings":";;;;;;AAiDA,SAAS,eAAe,OAAuC;AAC7D,QAAO,CAAC,CAAC,SAAS,OAAO,UAAU,YAAY,CAAC,MAAM,QAAQ,MAAM,IAC9D,MAA6B,SAAS;;AAG9C,eAAsB,iBACpB,MACA,OAMiB;CACjB,MAAM,EAAE,SAAS,WAAW,MAAM,KAAK,uBAAuB,MAAM,WAAW;AAC/E,MAAK,mBAAmB,MAAM,YAAY,SAAS,OAAO;AAE1D,KAAI;EACF,IAAI,WAAW,MAAM;EACrB,IAAI,uBAAuB;EAC3B,MAAM,OAAO,MAAM,gBAAgB;GACjC,KAAK,KAAK;GACV,YAAY,MAAM;GAClB,MAAM,MAAM;GACZ,cAAc,KAAK;GACpB,CAAC;AACF,yBAAuB,KAAK;AAC5B,MAAI,KAAK,aAAa,KAAK,WACzB,QAAO,KAAK;AAEd,aAAW,KAAK;AAEhB,QAAM,oBAAoB,MAAM,MAAM,YAAY,MAAM,SAAS;EACjE,MAAM,WAAW,MAAM,KAAK,0BAA0B,MAAM,YAAY,MAAM,YAAY;EAE1F,MAAM,QAAQ,MAAM,mBAClB,MACA;GAAE,YAAY,MAAM;GAAY;GAAS;GAAQ,EACjD,UACA,EAAE,mBAAmB,sBAAsB,CAC5C;AACD,MAAI,MAAM,SAAS;GACjB,MAAM,UAAU,MAAM,eAAe,MAAM;AAC3C,OAAI,QACF,OAAM,KAAK,aAAa,wBAAwB,MAAM,YAAY;IAChE,MAAM;IACN,SAAS,eAAe,MAAM,UAAU,OAAO,GAC3C,CAAC,MAAM,SAAS,OAAO,GACvB,CAAC;KAAE,MAAM;KAAQ,MAAM;KAAS,CAAC;IACrC,WAAW,KAAK,KAAK;IACrB,GAAI,MAAM,YAAY,OAAO,KAAK,MAAM,SAAS,CAAC,SAAS,IACvD,EAAE,UAAU,MAAM,UAAU,GAC5B,EAAE;IACP,CAAiB;AAEpB,UAAO,MAAM,kBAAkB;;EAGjC,MAAM,YAAY,KAAK,aAAa,iBAAiB,MAAM,YAAY,SAAS;EAChF,MAAM,gBAAgB,UAAU;EAChC,MAAM,cAAc,MAAM,8BAA8B;GACtD,SAAS;GACT,aAAa;GACb,YAAY,MAAM;GAClB,QAAQ,KAAK;GACb,cAAc,KAAK;GACnB,cAAc,KAAK;GACpB,CAAC;EAEF,MAAM,qBAAqB;AAC3B,kCAAgC,MAAM,YAAY,mBAAmB;EAErE,MAAM,SAAS,OAAO,YAAY;AAChC,OAAI;AACF,WAAO,MAAM,KAAK,aAAa,sBAC7B,MAAM,YACN,UAAU,gCAER,mBACE;KAAE,GAAG;KAAM,QAAQ,KAAK;KAAQ,EAChC;KACE,YAAY,MAAM;KAClB;KACD,CACF,CACJ;aACO;AACR,sCAAkC,MAAM,YAAY,mBAAmB;;MAEvE;AAEJ,MAAI,OAAO,kBACT,MAAK,iBAAiB,MAAM,YAAY,OAAO,kBAAkB;AAGnE,SAAO,OAAO,qBAAqB;WAC3B;AACR,OAAK,yBAAyB"}

package/dist/src/agent/service/process-direct-streaming.js

@@ -165,7 +165,8 @@ async function* runProcessDirectStreaming(deps, input) {
 				});
 				return;
 			}
-			const textForAgent = mergedUserText.trimStart().startsWith("/skill:") ? deps.agentManager.expandSkillUserText(mergedUserText) : mergedUserText;
+			const skillTurn = deps.agentManager.prepareSkillTurn(sessionKey, mergedUserText);
+			const textForAgent = skillTurn.text;
 			const userMessage = await deps.buildTranscriptUserMessage(textForAgent, prepared, sessionKey);
 			let sourceEnrichedUserMessage = userMessage;
 			let sourceImages;
@@ -190,7 +191,7 @@ async function* runProcessDirectStreaming(deps, input) {
 			const pendingUserMessage = userMessage;
 			setPendingTranscriptUserMessage(sessionKey, pendingUserMessage);
 			try {
-				const result = await runDirectAgentTurn({
+				const result = await deps.agentManager.withSkillCapabilities(sessionKey, skillTurn.activatedCapabilityNames, () => runDirectAgentTurn({
 					sessionStore: deps.sessionStore,
 					agentManager: deps.agentManager,
 					modelManager: deps.modelManager,
@@ -206,7 +207,7 @@ async function* runProcessDirectStreaming(deps, input) {
 						if (event.type === "error" && typeof event.content === "string") event.content = formatStreamError(event.content);
 						pushVisible(event);
 					}
-				});
+				}));
 				if (result.lastAssistantText) deps.onTurnComplete?.(sessionKey, result.lastAssistantText);
 				if (!result.ok && result.errorMessage && !abortHandled) pushVisible({
 					type: "error",