@xopcai/xopc 0.0.89 → 0.0.91

package/dist/src/agent/workflow/types.d.ts

@@ -64,6 +64,8 @@ export interface WorkflowAgentStep {
     label: string;
     detail?: string;
     status: WorkflowAgentStepStatus;
+    resultPreview?: string;
+    error?: string;
     startedAtMs?: number;
     durationMs?: number;
 }
@@ -134,6 +136,8 @@ export type SubagentProgressEvent = {
     toolCallId: string;
     toolName: string;
     isError: boolean;
+    resultPreview?: string;
+    error?: string;
 } | {
     type: 'iteration';
     count: number;

package/dist/src/chat-commands/agent-edit.d.ts

@@ -0,0 +1,4 @@
+/**
+ * /agent-edit — open the current chat as an agent profile editing session.
+ */
+export declare function registerAgentEditCommand(): void;

package/dist/src/chat-commands/agent-edit.js

@@ -0,0 +1,136 @@
+import { init_agent_scope, normalizeAgentId, resolveAgentProfileDir } from "../agent/agent-scope.js";
+import { init_agent_session_key, resolveAgentIdFromSessionKey } from "../routing/agent-session-key.js";
+import { WORKSPACE_FILES, init_paths } from "../config/paths.js";
+import { commandRegistry } from "./registry.js";
+import { join } from "node:path";
+import { readFile } from "node:fs/promises";
+//#region src/chat-commands/agent-edit.ts
+/**
+* /agent-edit — open the current chat as an agent profile editing session.
+*/
+init_agent_session_key();
+init_agent_scope();
+init_paths();
+const PROFILE_FILE_NAMES = [
+	WORKSPACE_FILES.SOUL,
+	WORKSPACE_FILES.IDENTITY,
+	WORKSPACE_FILES.USER,
+	WORKSPACE_FILES.TOOLS,
+	WORKSPACE_FILES.AGENTS,
+	WORKSPACE_FILES.HEARTBEAT,
+	WORKSPACE_FILES.MEMORY,
+	WORKSPACE_FILES.BOOTSTRAP
+];
+const DEFAULT_PREVIEW_CHARS = 900;
+const MAX_PREVIEW_CHARS = 4e3;
+function parseArgs(args) {
+	const trimmed = args.trim();
+	if (!trimmed) return { previewChars: DEFAULT_PREVIEW_CHARS };
+	const parts = trimmed.split(/\s+/);
+	let fileName;
+	let previewChars = DEFAULT_PREVIEW_CHARS;
+	for (const part of parts) {
+		const limitMatch = /^--limit=(\d+)$/.exec(part);
+		if (limitMatch) {
+			previewChars = Math.min(Number(limitMatch[1]), MAX_PREVIEW_CHARS);
+			continue;
+		}
+		if (!fileName) fileName = part;
+	}
+	return {
+		fileName,
+		previewChars
+	};
+}
+function normalizeProfileFileName(input) {
+	if (!input) return;
+	const basename = input.trim().replace(/\\/g, "/").split("/").pop();
+	return PROFILE_FILE_NAMES.find((name) => name.toLowerCase() === basename?.toLowerCase());
+}
+async function readPreview(path, limit) {
+	try {
+		const trimmed = (await readFile(path, "utf-8")).trimEnd();
+		if (trimmed.length <= limit) return {
+			content: trimmed,
+			missing: false
+		};
+		return {
+			content: `${trimmed.slice(0, limit)}\n\n… truncated, ask me to read the full file before editing …`,
+			missing: false
+		};
+	} catch {
+		return {
+			content: "",
+			missing: true
+		};
+	}
+}
+function buildEditInstructions(agentId, fileNames) {
+	const files = fileNames.map((name) => `\`${name}\``).join(", ");
+	return [
+		`You are editing agent \`${agentId}\`.`,
+		"",
+		"Tell me what to change, or say things like:",
+		"- “Refine `SOUL.md` to sound warmer and more concise.”",
+		"- “Update `IDENTITY.md` so this agent is focused on data analysis.”",
+		"- “Read `SOUL.md` first, propose changes, then write them back.”",
+		"",
+		`Editable profile files: ${files}.`,
+		"I can read and update these by bare filename with `read_file`, `edit_file`, and `write_file`."
+	].join("\n");
+}
+const agentEditCommand = {
+	id: "agent.edit",
+	name: "agent-edit",
+	aliases: ["agentedit"],
+	description: "Show editable profile files for the current agent and prepare this chat for profile edits.",
+	category: "system",
+	scope: [
+		"global",
+		"private",
+		"group"
+	],
+	acceptsArgs: true,
+	examples: [
+		"/agent-edit",
+		"/agent-edit SOUL.md",
+		"/agent-edit IDENTITY.md --limit=2000"
+	],
+	handler: async (ctx, args) => {
+		await ctx.setTyping(true);
+		const { fileName: rawFileName, previewChars } = parseArgs(args);
+		const fileName = normalizeProfileFileName(rawFileName);
+		if (rawFileName && !fileName) return {
+			content: `⚠️ Unsupported profile file: \`${rawFileName}\`. Use one of: ${PROFILE_FILE_NAMES.map((name) => `\`${name}\``).join(", ")}.`,
+			success: false
+		};
+		const agentId = normalizeAgentId(resolveAgentIdFromSessionKey(ctx.sessionKey));
+		const profileDir = resolveAgentProfileDir(ctx.config, agentId);
+		const namesToShow = fileName ? [fileName] : [WORKSPACE_FILES.SOUL, WORKSPACE_FILES.IDENTITY];
+		const sections = [];
+		for (const name of namesToShow) {
+			const preview = await readPreview(join(profileDir, name), previewChars);
+			if (preview.missing) sections.push(`## ${name}\n_missing_`);
+			else sections.push(`## ${name}\n\`\`\`markdown\n${preview.content}\n\`\`\``);
+		}
+		return {
+			content: [
+				"🛠️ Agent editor mode",
+				"",
+				buildEditInstructions(agentId, PROFILE_FILE_NAMES),
+				"",
+				`Profile directory: \`${profileDir}\``,
+				"",
+				...sections
+			].join("\n"),
+			success: true
+		};
+	}
+};
+function registerAgentEditCommand() {
+	commandRegistry.register(agentEditCommand);
+}
+//#endregion
+export { registerAgentEditCommand };
+
+//# sourceMappingURL=agent-edit.js.map

package/dist/src/chat-commands/agent-edit.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"agent-edit.js","names":[],"sources":["../../../src/chat-commands/agent-edit.ts"],"sourcesContent":["/**\n * /agent-edit — open the current chat as an agent profile editing session.\n */\n\nimport { readFile } from 'node:fs/promises';\nimport { join } from 'node:path';\n\nimport type { CommandContext, CommandDefinition } from './types.js';\nimport { commandRegistry } from './registry.js';\nimport { resolveAgentIdFromSessionKey } from '../routing/agent-session-key.js';\nimport { normalizeAgentId, resolveAgentProfileDir } from '../agent/agent-scope.js';\nimport { WORKSPACE_FILES } from '../config/paths.js';\n\nconst PROFILE_FILE_NAMES = [\n  WORKSPACE_FILES.SOUL,\n  WORKSPACE_FILES.IDENTITY,\n  WORKSPACE_FILES.USER,\n  WORKSPACE_FILES.TOOLS,\n  WORKSPACE_FILES.AGENTS,\n  WORKSPACE_FILES.HEARTBEAT,\n  WORKSPACE_FILES.MEMORY,\n  WORKSPACE_FILES.BOOTSTRAP,\n] as const;\n\nconst DEFAULT_PREVIEW_CHARS = 900;\nconst MAX_PREVIEW_CHARS = 4_000;\n\nfunction parseArgs(args: string): { fileName?: string; previewChars: number } {\n  const trimmed = args.trim();\n  if (!trimmed) {\n    return { previewChars: DEFAULT_PREVIEW_CHARS };\n  }\n\n  const parts = trimmed.split(/\\s+/);\n  let fileName: string | undefined;\n  let previewChars = DEFAULT_PREVIEW_CHARS;\n\n  for (const part of parts) {\n    const limitMatch = /^--limit=(\\d+)$/.exec(part);\n    if (limitMatch) {\n      previewChars = Math.min(Number(limitMatch[1]), MAX_PREVIEW_CHARS);\n      continue;\n    }\n    if (!fileName) {\n      fileName = part;\n    }\n  }\n\n  return { fileName, previewChars };\n}\n\nfunction normalizeProfileFileName(input: string | undefined): string | undefined {\n  if (!input) {\n    return undefined;\n  }\n  const basename = input.trim().replace(/\\\\/g, '/').split('/').pop();\n  const matched = PROFILE_FILE_NAMES.find((name) => name.toLowerCase() === basename?.toLowerCase());\n  return matched;\n}\n\nasync function readPreview(path: string, limit: number): Promise<{ content: string; missing: boolean }> {\n  try {\n    const content = await readFile(path, 'utf-8');\n    const trimmed = content.trimEnd();\n    if (trimmed.length <= limit) {\n      return { content: trimmed, missing: false };\n    }\n    return {\n      content: `${trimmed.slice(0, limit)}\\n\\n… truncated, ask me to read the full file before editing …`,\n      missing: false,\n    };\n  } catch {\n    return { content: '', missing: true };\n  }\n}\n\nfunction buildEditInstructions(agentId: string, fileNames: readonly string[]): string {\n  const files = fileNames.map((name) => `\\`${name}\\``).join(', ');\n  return [\n    `You are editing agent \\`${agentId}\\`.`,\n    '',\n    'Tell me what to change, or say things like:',\n    '- “Refine `SOUL.md` to sound warmer and more concise.”',\n    '- “Update `IDENTITY.md` so this agent is focused on data analysis.”',\n    '- “Read `SOUL.md` first, propose changes, then write them back.”',\n    '',\n    `Editable profile files: ${files}.`,\n    'I can read and update these by bare filename with `read_file`, `edit_file`, and `write_file`.',\n  ].join('\\n');\n}\n\nconst agentEditCommand: CommandDefinition = {\n  id: 'agent.edit',\n  name: 'agent-edit',\n  aliases: ['agentedit'],\n  description: 'Show editable profile files for the current agent and prepare this chat for profile edits.',\n  category: 'system',\n  scope: ['global', 'private', 'group'],\n  acceptsArgs: true,\n  examples: ['/agent-edit', '/agent-edit SOUL.md', '/agent-edit IDENTITY.md --limit=2000'],\n  handler: async (ctx: CommandContext, args: string) => {\n    await ctx.setTyping(true);\n\n    const { fileName: rawFileName, previewChars } = parseArgs(args);\n    const fileName = normalizeProfileFileName(rawFileName);\n    if (rawFileName && !fileName) {\n      return {\n        content: `⚠️ Unsupported profile file: \\`${rawFileName}\\`. Use one of: ${PROFILE_FILE_NAMES.map((name) => `\\`${name}\\``).join(', ')}.`,\n        success: false,\n      };\n    }\n\n    const agentId = normalizeAgentId(resolveAgentIdFromSessionKey(ctx.sessionKey));\n    const profileDir = resolveAgentProfileDir(ctx.config, agentId);\n    const namesToShow = fileName ? [fileName] : [WORKSPACE_FILES.SOUL, WORKSPACE_FILES.IDENTITY];\n\n    const sections: string[] = [];\n    for (const name of namesToShow) {\n      const preview = await readPreview(join(profileDir, name), previewChars);\n      if (preview.missing) {\n        sections.push(`## ${name}\\n_missing_`);\n      } else {\n        sections.push(`## ${name}\\n\\`\\`\\`markdown\\n${preview.content}\\n\\`\\`\\``);\n      }\n    }\n\n    return {\n      content: [\n        '🛠️ Agent editor mode',\n        '',\n        buildEditInstructions(agentId, PROFILE_FILE_NAMES),\n        '',\n        `Profile directory: \\`${profileDir}\\``,\n        '',\n        ...sections,\n      ].join('\\n'),\n      success: true,\n    };\n  },\n};\n\nexport function registerAgentEditCommand(): void {\n  commandRegistry.register(agentEditCommand);\n}\n"],"mappings":"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"}

package/dist/src/chat-commands/index.d.ts

@@ -20,6 +20,7 @@ export { registerContextCommands } from './builtins/context.js';
 export { registerGoalCommand } from './builtins/goal.js';
 export { registerSubgoalCommand } from './builtins/subgoal.js';
 export { registerWorkflowCommands } from './builtins/workflow.js';
+export { registerAgentEditCommand } from './agent-edit.js';
 /**
  * Initialize the command system with all built-in commands
  */

package/dist/src/chat-commands/index.js

@@ -11,6 +11,7 @@ import { registerContextCommands } from "./builtins/context.js";
 import { registerGoalCommand } from "./builtins/goal.js";
 import { registerSubgoalCommand } from "./builtins/subgoal.js";
 import { registerWorkflowCommands } from "./builtins/workflow.js";
+import { registerAgentEditCommand } from "./agent-edit.js";
 import { CommandContextImpl, createCommandContext } from "./context.js";
 //#region src/chat-commands/index.ts
 /**
@@ -33,8 +34,9 @@ function initializeCommands() {
 	registerGoalCommand();
 	registerSubgoalCommand();
 	registerWorkflowCommands();
+	registerAgentEditCommand();
 }
 //#endregion
-export { CommandContextImpl, CommandRegistry, commandRegistry, createCommandContext, generateSessionKey, getRoutingInfo, getSessionDisplayName, initializeCommands, isValidSessionKey, normalizeTelegramCommandName, parseSessionKey, parseSlashCommand, registerConfigCommand, registerContextCommands, registerGoalCommand, registerModelCommands, registerSessionCommands, registerSubgoalCommand, registerSystemCommands, registerTTSCommands, registerThinkingCommands, registerWorkflowCommands };
+export { CommandContextImpl, CommandRegistry, commandRegistry, createCommandContext, generateSessionKey, getRoutingInfo, getSessionDisplayName, initializeCommands, isValidSessionKey, normalizeTelegramCommandName, parseSessionKey, parseSlashCommand, registerAgentEditCommand, registerConfigCommand, registerContextCommands, registerGoalCommand, registerModelCommands, registerSessionCommands, registerSubgoalCommand, registerSystemCommands, registerTTSCommands, registerThinkingCommands, registerWorkflowCommands };
 
 //# sourceMappingURL=index.js.map

package/dist/src/chat-commands/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","names":[],"sources":["../../../src/chat-commands/index.ts"],"sourcesContent":["/**\n * Unified Command System\n *\n * Provides a platform-agnostic command system that works across\n * Telegram, Feishu, Web UI, CLI, and other channel surfaces.\n */\n\n// Built-in Commands (import first to avoid circular deps)\nimport { registerSessionCommands } from './builtins/session.js';\nimport { registerModelCommands } from './builtins/model.js';\nimport { registerSystemCommands } from './builtins/system.js';\nimport { registerTTSCommands } from './builtins/tts.js';\nimport { registerThinkingCommands } from './builtins/thinking.js';\nimport { registerConfigCommand } from './builtins/config.js';\nimport { registerContextCommands } from './builtins/context.js';\nimport { registerGoalCommand } from './builtins/goal.js';\nimport { registerSubgoalCommand } from './builtins/subgoal.js';\nimport { registerWorkflowCommands } from './builtins/workflow.js';\n\n// Types\nexport type {\n  MessageSource,\n  UnifiedMessage,\n  PlatformMetadata,\n  MessageAttachment,\n  CommandDefinition,\n  CommandCategory,\n  CommandScope,\n  CommandHandler,\n  CommandResult,\n  CommandContext,\n  ReplyOptions,\n  UIComponent,\n  ButtonGroup,\n  SelectMenu,\n  ModelPicker,\n  UsageDisplay,\n  SessionList,\n  TextInput,\n  ProviderInfo,\n  ModelInfo,\n  UsageStats,\n  SessionInfo,\n  PlatformFeature,\n  ChannelAdapter,\n  ReplyPayload,\n} from './types.js';\n\n// Session Key\nexport {\n  generateSessionKey,\n  parseSessionKey,\n  isValidSessionKey,\n  getSessionDisplayName,\n  getRoutingInfo,\n  type SessionKeyContext,\n} from './session-key.js';\n\n// Command parsing helpers\nexport { normalizeTelegramCommandName, parseSlashCommand } from './command-parse.js';\n\n// Registry\nexport { CommandRegistry, commandRegistry } from './registry.js';\nexport type { CommandRegistry as CommandRegistryType } from './types.js';\n\n// Context\nexport { CommandContextImpl, createCommandContext } from './context.js';\n\n// Built-in Commands\nexport { registerSessionCommands } from './builtins/session.js';\nexport { registerModelCommands } from './builtins/model.js';\nexport { registerSystemCommands } from './builtins/system.js';\nexport { registerTTSCommands } from './builtins/tts.js';\nexport { registerThinkingCommands } from './builtins/thinking.js';\nexport { registerConfigCommand } from './builtins/config.js';\nexport { registerContextCommands } from './builtins/context.js';\nexport { registerGoalCommand } from './builtins/goal.js';\nexport { registerSubgoalCommand } from './builtins/subgoal.js';\nexport { registerWorkflowCommands } from './builtins/workflow.js';\n\n/**\n * Initialize the command system with all built-in commands\n */\nexport function initializeCommands(): void {\n  registerSessionCommands();\n  registerModelCommands();\n  registerSystemCommands();\n  registerConfigCommand();\n  registerContextCommands();\n  registerTTSCommands();\n  registerThinkingCommands();\n  registerGoalCommand();\n  registerSubgoalCommand();\n  registerWorkflowCommands();\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;AAmFA,SAAgB,qBAA2B;AACzC,0BAAyB;AACzB,wBAAuB;AACvB,yBAAwB;AACxB,wBAAuB;AACvB,0BAAyB;AACzB,sBAAqB;AACrB,2BAA0B;AAC1B,sBAAqB;AACrB,yBAAwB;AACxB,2BAA0B"}
+{"version":3,"file":"index.js","names":[],"sources":["../../../src/chat-commands/index.ts"],"sourcesContent":["/**\n * Unified Command System\n *\n * Provides a platform-agnostic command system that works across\n * Telegram, Feishu, Web UI, CLI, and other channel surfaces.\n */\n\n// Built-in Commands (import first to avoid circular deps)\nimport { registerSessionCommands } from './builtins/session.js';\nimport { registerModelCommands } from './builtins/model.js';\nimport { registerSystemCommands } from './builtins/system.js';\nimport { registerTTSCommands } from './builtins/tts.js';\nimport { registerThinkingCommands } from './builtins/thinking.js';\nimport { registerConfigCommand } from './builtins/config.js';\nimport { registerContextCommands } from './builtins/context.js';\nimport { registerGoalCommand } from './builtins/goal.js';\nimport { registerSubgoalCommand } from './builtins/subgoal.js';\nimport { registerWorkflowCommands } from './builtins/workflow.js';\nimport { registerAgentEditCommand } from './agent-edit.js';\n\n// Types\nexport type {\n  MessageSource,\n  UnifiedMessage,\n  PlatformMetadata,\n  MessageAttachment,\n  CommandDefinition,\n  CommandCategory,\n  CommandScope,\n  CommandHandler,\n  CommandResult,\n  CommandContext,\n  ReplyOptions,\n  UIComponent,\n  ButtonGroup,\n  SelectMenu,\n  ModelPicker,\n  UsageDisplay,\n  SessionList,\n  TextInput,\n  ProviderInfo,\n  ModelInfo,\n  UsageStats,\n  SessionInfo,\n  PlatformFeature,\n  ChannelAdapter,\n  ReplyPayload,\n} from './types.js';\n\n// Session Key\nexport {\n  generateSessionKey,\n  parseSessionKey,\n  isValidSessionKey,\n  getSessionDisplayName,\n  getRoutingInfo,\n  type SessionKeyContext,\n} from './session-key.js';\n\n// Command parsing helpers\nexport { normalizeTelegramCommandName, parseSlashCommand } from './command-parse.js';\n\n// Registry\nexport { CommandRegistry, commandRegistry } from './registry.js';\nexport type { CommandRegistry as CommandRegistryType } from './types.js';\n\n// Context\nexport { CommandContextImpl, createCommandContext } from './context.js';\n\n// Built-in Commands\nexport { registerSessionCommands } from './builtins/session.js';\nexport { registerModelCommands } from './builtins/model.js';\nexport { registerSystemCommands } from './builtins/system.js';\nexport { registerTTSCommands } from './builtins/tts.js';\nexport { registerThinkingCommands } from './builtins/thinking.js';\nexport { registerConfigCommand } from './builtins/config.js';\nexport { registerContextCommands } from './builtins/context.js';\nexport { registerGoalCommand } from './builtins/goal.js';\nexport { registerSubgoalCommand } from './builtins/subgoal.js';\nexport { registerWorkflowCommands } from './builtins/workflow.js';\nexport { registerAgentEditCommand } from './agent-edit.js';\n\n/**\n * Initialize the command system with all built-in commands\n */\nexport function initializeCommands(): void {\n  registerSessionCommands();\n  registerModelCommands();\n  registerSystemCommands();\n  registerConfigCommand();\n  registerContextCommands();\n  registerTTSCommands();\n  registerThinkingCommands();\n  registerGoalCommand();\n  registerSubgoalCommand();\n  registerWorkflowCommands();\n  registerAgentEditCommand();\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;AAqFA,SAAgB,qBAA2B;AACzC,0BAAyB;AACzB,wBAAuB;AACvB,yBAAwB;AACxB,wBAAuB;AACvB,0BAAyB;AACzB,sBAAqB;AACrB,2BAA0B;AAC1B,sBAAqB;AACrB,yBAAwB;AACxB,2BAA0B;AAC1B,2BAA0B"}

package/dist/src/cli/bin.js

@@ -1,8 +1,10 @@
 #!/usr/bin/env node
 import { version } from "../../package.js";
 import "./cli-log-level-preset.js";
+import { ensureXopcCliOnPath } from "../infra/path-env.js";
 import { formatRootHelp } from "./command-manifest.js";
 //#region src/cli/bin.ts
+ensureXopcCliOnPath();
 function printRootHelp() {
 	console.log(formatRootHelp());
 }

package/dist/src/cli/bin.js.map

@@ -1 +1 @@
-{"version":3,"file":"bin.js","names":["pkg.version"],"sources":["../../../src/cli/bin.ts"],"sourcesContent":["#!/usr/bin/env node\n/**\n * CLI entry: log-level preset must run before any module that initializes the logger.\n * (Bundlers may reorder imports in `index.ts`; this file stays dependency-minimal.)\n */\nimport './cli-log-level-preset.js';\n\nimport pkg from '../../package.json' with { type: 'json' };\nimport { formatRootHelp } from './command-manifest.js';\n\nfunction printRootHelp(): void {\n  console.log(formatRootHelp());\n}\n\nconst rootArgs = process.argv.slice(2).filter((arg) => arg !== '--');\nif (rootArgs.length === 1 && (rootArgs[0] === '--version' || rootArgs[0] === '-V')) {\n  console.log(pkg.version);\n  process.exit(0);\n}\nif (rootArgs.length === 1 && (rootArgs[0] === '--help' || rootArgs[0] === '-h' || rootArgs[0] === 'help')) {\n  printRootHelp();\n  process.exit(0);\n}\n\nconst filteredArgv = process.argv.filter((arg, index) => {\n  if (arg !== '--') return true;\n  return index < 2;\n});\n\nconst { tryRunGatewayRunFastPath } = await import('./gateway-run-fast-path.js');\nif (await tryRunGatewayRunFastPath(filteredArgv)) {\n  process.exit(typeof process.exitCode === 'number' ? process.exitCode : 0);\n}\n\nconst { runCli } = await import('./index.js');\nawait runCli(process.argv);\n"],"mappings":";;;;;AAUA,SAAS,gBAAsB;AAC7B,SAAQ,IAAI,gBAAgB,CAAC;;AAG/B,MAAM,WAAW,QAAQ,KAAK,MAAM,EAAE,CAAC,QAAQ,QAAQ,QAAQ,KAAK;AACpE,IAAI,SAAS,WAAW,MAAM,SAAS,OAAO,eAAe,SAAS,OAAO,OAAO;AAClF,SAAQ,IAAIA,QAAY;AACxB,SAAQ,KAAK,EAAE;;AAEjB,IAAI,SAAS,WAAW,MAAM,SAAS,OAAO,YAAY,SAAS,OAAO,QAAQ,SAAS,OAAO,SAAS;AACzG,gBAAe;AACf,SAAQ,KAAK,EAAE;;AAGjB,MAAM,eAAe,QAAQ,KAAK,QAAQ,KAAK,UAAU;AACvD,KAAI,QAAQ,KAAM,QAAO;AACzB,QAAO,QAAQ;EACf;AAEF,MAAM,EAAE,6BAA6B,MAAM,OAAO;AAClD,IAAI,MAAM,yBAAyB,aAAa,CAC9C,SAAQ,KAAK,OAAO,QAAQ,aAAa,WAAW,QAAQ,WAAW,EAAE;AAG3E,MAAM,EAAE,WAAW,MAAM,OAAO;AAChC,MAAM,OAAO,QAAQ,KAAK"}
+{"version":3,"file":"bin.js","names":["pkg.version"],"sources":["../../../src/cli/bin.ts"],"sourcesContent":["#!/usr/bin/env node\n/**\n * CLI entry: log-level preset must run before any module that initializes the logger.\n * (Bundlers may reorder imports in `index.ts`; this file stays dependency-minimal.)\n */\nimport './cli-log-level-preset.js';\n\nimport pkg from '../../package.json' with { type: 'json' };\nimport { ensureXopcCliOnPath } from '../infra/path-env.js';\nimport { formatRootHelp } from './command-manifest.js';\n\nensureXopcCliOnPath();\n\nfunction printRootHelp(): void {\n  console.log(formatRootHelp());\n}\n\nconst rootArgs = process.argv.slice(2).filter((arg) => arg !== '--');\nif (rootArgs.length === 1 && (rootArgs[0] === '--version' || rootArgs[0] === '-V')) {\n  console.log(pkg.version);\n  process.exit(0);\n}\nif (rootArgs.length === 1 && (rootArgs[0] === '--help' || rootArgs[0] === '-h' || rootArgs[0] === 'help')) {\n  printRootHelp();\n  process.exit(0);\n}\n\nconst filteredArgv = process.argv.filter((arg, index) => {\n  if (arg !== '--') return true;\n  return index < 2;\n});\n\nconst { tryRunGatewayRunFastPath } = await import('./gateway-run-fast-path.js');\nif (await tryRunGatewayRunFastPath(filteredArgv)) {\n  process.exit(typeof process.exitCode === 'number' ? process.exitCode : 0);\n}\n\nconst { runCli } = await import('./index.js');\nawait runCli(process.argv);\n"],"mappings":";;;;;;AAWA,qBAAqB;AAErB,SAAS,gBAAsB;AAC7B,SAAQ,IAAI,gBAAgB,CAAC;;AAG/B,MAAM,WAAW,QAAQ,KAAK,MAAM,EAAE,CAAC,QAAQ,QAAQ,QAAQ,KAAK;AACpE,IAAI,SAAS,WAAW,MAAM,SAAS,OAAO,eAAe,SAAS,OAAO,OAAO;AAClF,SAAQ,IAAIA,QAAY;AACxB,SAAQ,KAAK,EAAE;;AAEjB,IAAI,SAAS,WAAW,MAAM,SAAS,OAAO,YAAY,SAAS,OAAO,QAAQ,SAAS,OAAO,SAAS;AACzG,gBAAe;AACf,SAAQ,KAAK,EAAE;;AAGjB,MAAM,eAAe,QAAQ,KAAK,QAAQ,KAAK,UAAU;AACvD,KAAI,QAAQ,KAAM,QAAO;AACzB,QAAO,QAAQ;EACf;AAEF,MAAM,EAAE,6BAA6B,MAAM,OAAO;AAClD,IAAI,MAAM,yBAAyB,aAAa,CAC9C,SAAQ,KAAK,OAAO,QAAQ,aAAa,WAAW,QAAQ,WAAW,EAAE;AAG3E,MAAM,EAAE,WAAW,MAAM,OAAO;AAChC,MAAM,OAAO,QAAQ,KAAK"}

package/dist/src/cli/commands/cron.js

@@ -6,6 +6,7 @@ function createCronCommand(_ctx) {
 	const cmd = new Command("cron").description("Manage scheduled tasks").addHelpText("after", formatExamples([
 		"xopc cron list                              # List all tasks",
 		"xopc cron add --schedule \"0 9 * * *\" --message \"Good morning\"",
+		"xopc cron add --schedule \"0 17 * * 5\" --workflow weekly_review --goal \"Weekly review\"",
 		"xopc cron enable <job-id>                   # Enable a task",
 		"xopc cron disable <job-id>                  # Disable a task",
 		"xopc cron run <job-id>                      # Run a task now",
@@ -29,12 +30,49 @@ function createCronCommand(_ctx) {
 			}
 		});
 	}));
-	cmd.addCommand(new Command("add").description("Add a scheduled task").option("--name <text>", "Task name").option("--schedule <cron>", "Cron expression (e.g., \"0 9 * * *\")").option("--message <text>", "Message to send").action(async (options) => {
-		if (!options.schedule || !options.message) {
-			console.error("Error: --schedule and --message are required");
+	cmd.addCommand(new Command("add").description("Add a scheduled task").option("--name <text>", "Task name").option("--schedule <cron>", "Cron expression (e.g., \"0 9 * * *\")").option("--message <text>", "Message to send (system event)").option("--workflow <id>", "Workflow definition id (direct workflow run)").option("--goal <text>", "Optional workflow goal").option("--input-json <json>", "Workflow input payload as JSON object").option("--agent-id <id>", "Agent profile for workflow or isolated jobs").option("--no-wait", "Start workflow and return without waiting for completion").option("--channel <name>", "Delivery channel (e.g. telegram)").option("--to <chatId>", "Delivery recipient chat id").action(async (options) => {
+		const hasWorkflow = Boolean(options.workflow?.trim());
+		const hasMessage = Boolean(options.message?.trim());
+		if (!options.schedule || !hasWorkflow && !hasMessage || hasWorkflow && hasMessage) {
+			console.error("Error: --schedule is required; provide exactly one of --message or --workflow");
 			process.exit(1);
 		}
 		await withCronService(async (cronService) => {
+			if (hasWorkflow) {
+				const { DEFAULT_WORKFLOW_CRON_WAIT_MS } = await import("../../cron/workflow-run-completion.js");
+				let inputEnvelope;
+				if (options.inputJson) try {
+					inputEnvelope = { payload: JSON.parse(options.inputJson) };
+				} catch {
+					console.error("Error: --input-json must be valid JSON");
+					process.exit(1);
+				}
+				const agentId = options.agentId?.trim() || void 0;
+				const delivery = options.channel?.trim() && options.to?.trim() ? {
+					mode: "direct",
+					channel: options.channel.trim(),
+					to: options.to.trim()
+				} : void 0;
+				const result = await cronService.addJob(options.schedule, {
+					name: options.name,
+					sessionTarget: "isolated",
+					timeout: DEFAULT_WORKFLOW_CRON_WAIT_MS,
+					...agentId ? { agentId } : {},
+					delivery,
+					payload: {
+						kind: "workflowRun",
+						definitionId: options.workflow.trim(),
+						...options.goal?.trim() ? { goal: options.goal.trim() } : {},
+						...inputEnvelope ? { inputEnvelope } : {},
+						...agentId ? { agentId } : {},
+						...options.noWait ? { waitForCompletion: false } : {}
+					}
+				});
+				console.log(`✅ Added workflow job ${result.id}`);
+				console.log(`   Schedule: ${result.schedule}`);
+				console.log(`   Workflow: ${options.workflow.trim()}`);
+				return;
+			}
 			const result = await cronService.addJob(options.schedule, {
 				name: options.name,
 				payload: {
@@ -99,6 +137,7 @@ register({
 		examples: [
 			"xopc cron list",
 			"xopc cron add --schedule \"0 9 * * *\" --message \"Hello\"",
+			"xopc cron add --schedule \"0 17 * * 5\" --workflow weekly_review",
 			"xopc cron enable abc12345",
 			"xopc cron run abc12345"
 		]

package/dist/src/cli/commands/cron.js.map

@@ -1 +1 @@
-{"version":3,"file":"cron.js","names":[],"sources":["../../../../src/cli/commands/cron.ts"],"sourcesContent":["import { Command } from 'commander';\nimport { register, formatExamples } from '../registry.js';\nimport type { CLIContext } from '../registry.js';\nimport { withCronService } from './cron-cli.js';\n\nfunction createCronCommand(_ctx: CLIContext): Command {\n  const cmd = new Command('cron')\n    .description('Manage scheduled tasks')\n    .addHelpText(\n      'after',\n      formatExamples([\n        'xopc cron list                              # List all tasks',\n        'xopc cron add --schedule \"0 9 * * *\" --message \"Good morning\"',\n        'xopc cron enable <job-id>                   # Enable a task',\n        'xopc cron disable <job-id>                  # Disable a task',\n        'xopc cron run <job-id>                      # Run a task now',\n        'xopc cron remove <job-id>                   # Remove a task',\n      ]),\n    );\n\n  cmd.addCommand(\n    new Command('list')\n      .description('List all scheduled tasks')\n      .action(async () => {\n        await withCronService(async (cronService) => {\n          const jobs = await cronService.listJobs();\n\n          if (jobs.length === 0) {\n            console.log('No scheduled tasks.');\n            return;\n          }\n\n          console.log('Scheduled Tasks:\\n');\n          const { getCronPayloadText } = await import('../../cron/job-content.js');\n          for (const job of jobs) {\n            const state = job.enabled ? 'enabled ' : 'disabled';\n            console.log(`  ${job.id} [${state}] - ${job.schedule}`);\n            console.log(`     ${getCronPayloadText({ payload: job.payload })}`);\n            console.log(`     Next: ${job.next_run || 'N/A'}`);\n            console.log();\n          }\n        });\n      }),\n  );\n\n  cmd.addCommand(\n    new Command('add')\n      .description('Add a scheduled task')\n      .option('--name <text>', 'Task name')\n      .option('--schedule <cron>', 'Cron expression (e.g., \"0 9 * * *\")')\n      .option('--message <text>', 'Message to send')\n      .action(async (options) => {\n        if (!options.schedule || !options.message) {\n          console.error('Error: --schedule and --message are required');\n          process.exit(1);\n        }\n\n        await withCronService(async (cronService) => {\n          const result = await cronService.addJob(options.schedule, {\n            name: options.name,\n            payload: { kind: 'systemEvent', text: options.message },\n          });\n\n          console.log(`✅ Added job ${result.id}`);\n          console.log(`   Schedule: ${result.schedule}`);\n        });\n      }),\n  );\n\n  cmd.addCommand(\n    new Command('remove')\n      .description('Remove a scheduled task')\n      .argument('<id>', 'Job ID')\n      .action(async (id) => {\n        await withCronService(async (cronService) => {\n          const success = await cronService.removeJob(id);\n          if (success) {\n            console.log(`✅ Removed job ${id}`);\n          } else {\n            console.error(`Job ${id} not found`);\n            process.exit(1);\n          }\n        });\n      }),\n  );\n\n  cmd.addCommand(\n    new Command('enable')\n      .description('Enable a scheduled task')\n      .argument('<id>', 'Job ID')\n      .action(async (id) => {\n        await withCronService(async (cronService) => {\n          const success = await cronService.toggleJob(id, true);\n          if (success) {\n            console.log(`✅ Enabled job ${id}`);\n          } else {\n            console.error(`Job ${id} not found`);\n            process.exit(1);\n          }\n        });\n      }),\n  );\n\n  cmd.addCommand(\n    new Command('disable')\n      .description('Disable a scheduled task')\n      .argument('<id>', 'Job ID')\n      .action(async (id) => {\n        await withCronService(async (cronService) => {\n          const success = await cronService.toggleJob(id, false);\n          if (success) {\n            console.log(`✅ Disabled job ${id}`);\n          } else {\n            console.error(`Job ${id} not found`);\n            process.exit(1);\n          }\n        });\n      }),\n  );\n\n  const runNowAction = async (id: string) => {\n    await withCronService(async (cronService) => {\n      try {\n        await cronService.runJobNow(id);\n        console.log(`✅ Triggered job ${id}`);\n      } catch (err) {\n        const message = err instanceof Error ? err.message : String(err);\n        console.error(message);\n        process.exit(1);\n      }\n    });\n  };\n\n  cmd.addCommand(\n    new Command('run')\n      .description('Run a scheduled task immediately')\n      .argument('<id>', 'Job ID')\n      .action(runNowAction),\n  );\n\n  cmd.addCommand(\n    new Command('trigger')\n      .description('Alias for `cron run`')\n      .argument('<id>', 'Job ID')\n      .action(runNowAction),\n  );\n\n  return cmd;\n}\n\nregister({\n  id: 'cron',\n  name: 'cron',\n  description: 'Manage scheduled tasks',\n  factory: createCronCommand,\n  metadata: {\n    category: 'utility',\n    examples: [\n      'xopc cron list',\n      'xopc cron add --schedule \"0 9 * * *\" --message \"Hello\"',\n      'xopc cron enable abc12345',\n      'xopc cron run abc12345',\n    ],\n  },\n});\n\nexport { createCronCommand };\n"],"mappings":"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"}
+{"version":3,"file":"cron.js","names":[],"sources":["../../../../src/cli/commands/cron.ts"],"sourcesContent":["import { Command } from 'commander';\nimport { register, formatExamples } from '../registry.js';\nimport type { CLIContext } from '../registry.js';\nimport { withCronService } from './cron-cli.js';\n\nfunction createCronCommand(_ctx: CLIContext): Command {\n  const cmd = new Command('cron')\n    .description('Manage scheduled tasks')\n    .addHelpText(\n      'after',\n      formatExamples([\n        'xopc cron list                              # List all tasks',\n        'xopc cron add --schedule \"0 9 * * *\" --message \"Good morning\"',\n        'xopc cron add --schedule \"0 17 * * 5\" --workflow weekly_review --goal \"Weekly review\"',\n        'xopc cron enable <job-id>                   # Enable a task',\n        'xopc cron disable <job-id>                  # Disable a task',\n        'xopc cron run <job-id>                      # Run a task now',\n        'xopc cron remove <job-id>                   # Remove a task',\n      ]),\n    );\n\n  cmd.addCommand(\n    new Command('list')\n      .description('List all scheduled tasks')\n      .action(async () => {\n        await withCronService(async (cronService) => {\n          const jobs = await cronService.listJobs();\n\n          if (jobs.length === 0) {\n            console.log('No scheduled tasks.');\n            return;\n          }\n\n          console.log('Scheduled Tasks:\\n');\n          const { getCronPayloadText } = await import('../../cron/job-content.js');\n          for (const job of jobs) {\n            const state = job.enabled ? 'enabled ' : 'disabled';\n            console.log(`  ${job.id} [${state}] - ${job.schedule}`);\n            console.log(`     ${getCronPayloadText({ payload: job.payload })}`);\n            console.log(`     Next: ${job.next_run || 'N/A'}`);\n            console.log();\n          }\n        });\n      }),\n  );\n\n  cmd.addCommand(\n    new Command('add')\n      .description('Add a scheduled task')\n      .option('--name <text>', 'Task name')\n      .option('--schedule <cron>', 'Cron expression (e.g., \"0 9 * * *\")')\n      .option('--message <text>', 'Message to send (system event)')\n      .option('--workflow <id>', 'Workflow definition id (direct workflow run)')\n      .option('--goal <text>', 'Optional workflow goal')\n      .option('--input-json <json>', 'Workflow input payload as JSON object')\n      .option('--agent-id <id>', 'Agent profile for workflow or isolated jobs')\n      .option('--no-wait', 'Start workflow and return without waiting for completion')\n      .option('--channel <name>', 'Delivery channel (e.g. telegram)')\n      .option('--to <chatId>', 'Delivery recipient chat id')\n      .action(async (options) => {\n        const hasWorkflow = Boolean(options.workflow?.trim());\n        const hasMessage = Boolean(options.message?.trim());\n        if (!options.schedule || (!hasWorkflow && !hasMessage) || (hasWorkflow && hasMessage)) {\n          console.error(\n            'Error: --schedule is required; provide exactly one of --message or --workflow',\n          );\n          process.exit(1);\n        }\n\n        await withCronService(async (cronService) => {\n          if (hasWorkflow) {\n            const { DEFAULT_WORKFLOW_CRON_WAIT_MS } = await import(\n              '../../cron/workflow-run-completion.js'\n            );\n            let inputEnvelope: { payload: unknown } | undefined;\n            if (options.inputJson) {\n              try {\n                inputEnvelope = { payload: JSON.parse(options.inputJson) as unknown };\n              } catch {\n                console.error('Error: --input-json must be valid JSON');\n                process.exit(1);\n              }\n            }\n            const agentId = options.agentId?.trim() || undefined;\n            const delivery =\n              options.channel?.trim() && options.to?.trim()\n                ? {\n                    mode: 'direct' as const,\n                    channel: options.channel.trim(),\n                    to: options.to.trim(),\n                  }\n                : undefined;\n            const result = await cronService.addJob(options.schedule, {\n              name: options.name,\n              sessionTarget: 'isolated',\n              timeout: DEFAULT_WORKFLOW_CRON_WAIT_MS,\n              ...(agentId ? { agentId } : {}),\n              delivery,\n              payload: {\n                kind: 'workflowRun',\n                definitionId: options.workflow.trim(),\n                ...(options.goal?.trim() ? { goal: options.goal.trim() } : {}),\n                ...(inputEnvelope ? { inputEnvelope } : {}),\n                ...(agentId ? { agentId } : {}),\n                ...(options.noWait ? { waitForCompletion: false } : {}),\n              },\n            });\n            console.log(`✅ Added workflow job ${result.id}`);\n            console.log(`   Schedule: ${result.schedule}`);\n            console.log(`   Workflow: ${options.workflow.trim()}`);\n            return;\n          }\n\n          const result = await cronService.addJob(options.schedule, {\n            name: options.name,\n            payload: { kind: 'systemEvent', text: options.message },\n          });\n\n          console.log(`✅ Added job ${result.id}`);\n          console.log(`   Schedule: ${result.schedule}`);\n        });\n      }),\n  );\n\n  cmd.addCommand(\n    new Command('remove')\n      .description('Remove a scheduled task')\n      .argument('<id>', 'Job ID')\n      .action(async (id) => {\n        await withCronService(async (cronService) => {\n          const success = await cronService.removeJob(id);\n          if (success) {\n            console.log(`✅ Removed job ${id}`);\n          } else {\n            console.error(`Job ${id} not found`);\n            process.exit(1);\n          }\n        });\n      }),\n  );\n\n  cmd.addCommand(\n    new Command('enable')\n      .description('Enable a scheduled task')\n      .argument('<id>', 'Job ID')\n      .action(async (id) => {\n        await withCronService(async (cronService) => {\n          const success = await cronService.toggleJob(id, true);\n          if (success) {\n            console.log(`✅ Enabled job ${id}`);\n          } else {\n            console.error(`Job ${id} not found`);\n            process.exit(1);\n          }\n        });\n      }),\n  );\n\n  cmd.addCommand(\n    new Command('disable')\n      .description('Disable a scheduled task')\n      .argument('<id>', 'Job ID')\n      .action(async (id) => {\n        await withCronService(async (cronService) => {\n          const success = await cronService.toggleJob(id, false);\n          if (success) {\n            console.log(`✅ Disabled job ${id}`);\n          } else {\n            console.error(`Job ${id} not found`);\n            process.exit(1);\n          }\n        });\n      }),\n  );\n\n  const runNowAction = async (id: string) => {\n    await withCronService(async (cronService) => {\n      try {\n        await cronService.runJobNow(id);\n        console.log(`✅ Triggered job ${id}`);\n      } catch (err) {\n        const message = err instanceof Error ? err.message : String(err);\n        console.error(message);\n        process.exit(1);\n      }\n    });\n  };\n\n  cmd.addCommand(\n    new Command('run')\n      .description('Run a scheduled task immediately')\n      .argument('<id>', 'Job ID')\n      .action(runNowAction),\n  );\n\n  cmd.addCommand(\n    new Command('trigger')\n      .description('Alias for `cron run`')\n      .argument('<id>', 'Job ID')\n      .action(runNowAction),\n  );\n\n  return cmd;\n}\n\nregister({\n  id: 'cron',\n  name: 'cron',\n  description: 'Manage scheduled tasks',\n  factory: createCronCommand,\n  metadata: {\n    category: 'utility',\n    examples: [\n      'xopc cron list',\n      'xopc cron add --schedule \"0 9 * * *\" --message \"Hello\"',\n      'xopc cron add --schedule \"0 17 * * 5\" --workflow weekly_review',\n      'xopc cron enable abc12345',\n      'xopc cron run abc12345',\n    ],\n  },\n});\n\nexport { createCronCommand };\n"],"mappings":"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"}

package/dist/src/cli/commands/doctor/checks/session-integrity.js

@@ -1,14 +1,42 @@
-import { init_agent_scope, resolveDefaultAgentId } from "../../../../agent/agent-scope.js";
+import { init_agent_scope, listAgentEntries, resolveDefaultAgentId } from "../../../../agent/agent-scope.js";
+import { init_session_key, parseSessionKey } from "../../../../routing/session-key.js";
 import { init_transcript_paths, resolveSessionFilePath } from "../../../../session/parity/transcript-paths.js";
 import { FILENAMES, init_paths, resolveSessionsDir } from "../../../../config/paths.js";
 import { init_loader, loadConfig } from "../../../../config/loader.js";
-import { join } from "node:path";
-import { existsSync, readFileSync } from "node:fs";
+import { basename, join } from "node:path";
+import { existsSync, readFileSync, readdirSync } from "node:fs";
 //#region src/cli/commands/doctor/checks/session-integrity.ts
 init_agent_scope();
 init_loader();
 init_paths();
+init_session_key();
 init_transcript_paths();
+function discoverSessionMapLocations(config, stateDir) {
+	const agentIds = new Set([resolveDefaultAgentId(config), ...listAgentEntries(config).map((agent) => agent.id)]);
+	const agentsRoot = join(stateDir, "agents");
+	if (existsSync(agentsRoot)) {
+		for (const entry of readdirSync(agentsRoot, { withFileTypes: true })) if (entry.isDirectory()) agentIds.add(entry.name);
+	}
+	const seenMapPaths = /* @__PURE__ */ new Set();
+	const locations = [];
+	for (const agentId of agentIds) {
+		const sessionsDir = resolveSessionsDir(config, agentId);
+		const mapPath = join(sessionsDir, FILENAMES.SESSIONS_MAP);
+		if (seenMapPaths.has(mapPath)) continue;
+		seenMapPaths.add(mapPath);
+		locations.push({
+			agentId,
+			sessionsDir,
+			mapPath
+		});
+	}
+	return locations;
+}
+function readSessionMap(mapPath) {
+	const parsed = JSON.parse(readFileSync(mapPath, "utf-8"));
+	if (!parsed || typeof parsed !== "object" || Array.isArray(parsed)) throw new Error("invalid sessions map");
+	return parsed;
+}
 async function checkSessionIntegrity(ctx) {
 	if (!ctx.options.deep) return {
 		id: "session-integrity",
@@ -36,73 +64,68 @@ async function checkSessionIntegrity(ctx) {
 			hints: []
 		};
 	}
-	const agentId = resolveDefaultAgentId(config);
-	const sessionsDir = resolveSessionsDir(config, agentId);
-	const mapPath = join(sessionsDir, FILENAMES.SESSIONS_MAP);
-	if (!existsSync(sessionsDir)) return {
-		id: "session-integrity",
-		label: "Sessions",
-		status: "warn",
-		message: "Sessions directory is missing.",
-		hints: [sessionsDir]
-	};
-	if (!existsSync(mapPath)) return {
-		id: "session-integrity",
-		label: "Sessions",
-		status: "warn",
-		message: "`sessions.json` is missing.",
-		hints: [mapPath]
-	};
-	let map;
-	try {
-		const parsed = JSON.parse(readFileSync(mapPath, "utf-8"));
-		if (!parsed || typeof parsed !== "object" || Array.isArray(parsed)) throw new Error("invalid");
-		map = parsed;
-	} catch {
-		return {
-			id: "session-integrity",
-			label: "Sessions",
-			status: "warn",
-			message: "`sessions.json` is not valid JSON.",
-			hints: [mapPath]
-		};
-	}
-	const sample = [...Object.keys(map)].sort((a, b) => {
-		const ta = map[a]?.updatedAt ?? 0;
-		return (map[b]?.updatedAt ?? 0) - ta;
-	}).slice(0, 20);
-	if (sample.length === 0) return {
-		id: "session-integrity",
-		label: "Sessions",
-		status: "pass",
-		message: "`sessions.json` is valid; no sessions to sample.",
-		hints: []
-	};
-	const missing = [];
-	for (const sessionKey of sample) {
-		const entry = map[sessionKey];
-		if (!entry?.sessionId) {
-			missing.push(sessionKey);
+	const locations = discoverSessionMapLocations(config, ctx.stateDir);
+	const missingMaps = [];
+	const invalidMaps = [];
+	const missingTranscripts = [];
+	const agentMismatches = [];
+	const orphanTranscripts = [];
+	let sessionCount = 0;
+	for (const location of locations) {
+		if (!existsSync(location.sessionsDir)) continue;
+		if (!existsSync(location.mapPath)) {
+			missingMaps.push(location.mapPath);
 			continue;
 		}
+		let map;
 		try {
-			if (!existsSync(resolveSessionFilePath(entry.sessionId, entry, { sessionsDir }))) missing.push(sessionKey);
+			map = readSessionMap(location.mapPath);
 		} catch {
-			missing.push(sessionKey);
+			invalidMaps.push(location.mapPath);
+			continue;
+		}
+		const referencedTranscriptFiles = /* @__PURE__ */ new Set();
+		for (const [sessionKey, entry] of Object.entries(map)) {
+			sessionCount++;
+			const parsed = parseSessionKey(sessionKey);
+			if (parsed && parsed.agentId !== location.agentId) agentMismatches.push(`${sessionKey} in agent ${location.agentId}`);
+			if (!entry?.sessionId) {
+				missingTranscripts.push(sessionKey);
+				continue;
+			}
+			try {
+				const transcriptPath = resolveSessionFilePath(entry.sessionId, entry, { sessionsDir: location.sessionsDir });
+				referencedTranscriptFiles.add(basename(transcriptPath));
+				if (!existsSync(transcriptPath)) missingTranscripts.push(sessionKey);
+			} catch {
+				missingTranscripts.push(sessionKey);
+			}
+		}
+		for (const file of readdirSync(location.sessionsDir, { withFileTypes: true })) {
+			if (!file.isFile() || !file.name.endsWith(".jsonl") || file.name.includes(".checkpoint.")) continue;
+			if (!referencedTranscriptFiles.has(file.name)) orphanTranscripts.push(join(location.sessionsDir, file.name));
 		}
 	}
-	if (missing.length > 0) return {
+	const hints = [
+		...missingMaps.slice(0, 3).map((path) => `Missing sessions.json: ${path}`),
+		...invalidMaps.slice(0, 3).map((path) => `Invalid sessions.json: ${path}`),
+		...agentMismatches.slice(0, 3).map((item) => `Session key agent mismatch: ${item}`),
+		...missingTranscripts.slice(0, 3).map((key) => `Missing transcript for: ${key}`),
+		...orphanTranscripts.slice(0, 3).map((path) => `Orphan transcript: ${path}`)
+	];
+	const warningCount = missingMaps.length + invalidMaps.length + missingTranscripts.length + agentMismatches.length + orphanTranscripts.length;
+	if (warningCount > 0) return {
 		id: "session-integrity",
 		label: "Sessions",
 		status: "warn",
-		message: `${missing.length} of ${sample.length} sampled session transcripts are missing on disk.`,
-		hints: missing.slice(0, 5).map((k) => `Missing transcript for: ${k}`)
+		message: `Scanned ${locations.length} agent session dir(s), ${sessionCount} session(s); found ${warningCount} issue(s).`,
+		hints
 	};
 	return {
 		id: "session-integrity",
 		label: "Sessions",
 		status: "pass",
-		message: `Sampled ${sample.length} recent session(s); JSONL transcripts are present.`,
+		message: `Scanned ${locations.length} agent session dir(s), ${sessionCount} session(s); session maps and JSONL transcripts are consistent.`,
 		hints: []
 	};
 }

package/dist/src/cli/commands/doctor/checks/session-integrity.js.map

@@ -1 +1 @@
-{"version":3,"file":"session-integrity.js","names":[],"sources":["../../../../../../src/cli/commands/doctor/checks/session-integrity.ts"],"sourcesContent":["import { existsSync, readFileSync } from 'node:fs';\nimport { join } from 'node:path';\n\nimport { resolveDefaultAgentId } from '../../../../agent/agent-scope.js';\nimport { loadConfig } from '../../../../config/loader.js';\nimport { FILENAMES, resolveSessionsDir } from '../../../../config/paths.js';\nimport { resolveSessionFilePath } from '../../../../session/parity/transcript-paths.js';\nimport type { XopcSessionDiskEntry } from '../../../../session/parity/xopc-session-disk-entry.js';\nimport type { CheckResult, DoctorContext } from '../types.js';\n\nexport async function checkSessionIntegrity(ctx: DoctorContext): Promise<CheckResult> {\n  if (!ctx.options.deep) {\n    return {\n      id: 'session-integrity',\n      label: 'Sessions',\n      status: 'skip',\n      message: 'Deep mode off; session scan skipped.',\n      hints: ['Run: xopc doctor --deep'],\n    };\n  }\n\n  if (!existsSync(ctx.configPath)) {\n    return {\n      id: 'session-integrity',\n      label: 'Sessions',\n      status: 'skip',\n      message: 'No config file; skipped.',\n      hints: [],\n    };\n  }\n\n  let config;\n  try {\n    config = loadConfig(ctx.configPath);\n  } catch {\n    return {\n      id: 'session-integrity',\n      label: 'Sessions',\n      status: 'skip',\n      message: 'Config could not be loaded; skipped.',\n      hints: [],\n    };\n  }\n\n  const agentId = resolveDefaultAgentId(config);\n  const sessionsDir = resolveSessionsDir(config, agentId);\n  const mapPath = join(sessionsDir, FILENAMES.SESSIONS_MAP);\n\n  if (!existsSync(sessionsDir)) {\n    return {\n      id: 'session-integrity',\n      label: 'Sessions',\n      status: 'warn',\n      message: 'Sessions directory is missing.',\n      hints: [sessionsDir],\n    };\n  }\n\n  if (!existsSync(mapPath)) {\n    return {\n      id: 'session-integrity',\n      label: 'Sessions',\n      status: 'warn',\n      message: '`sessions.json` is missing.',\n      hints: [mapPath],\n    };\n  }\n\n  let map: Record<string, XopcSessionDiskEntry>;\n  try {\n    const parsed = JSON.parse(readFileSync(mapPath, 'utf-8')) as unknown;\n    if (!parsed || typeof parsed !== 'object' || Array.isArray(parsed)) {\n      throw new Error('invalid');\n    }\n    map = parsed as Record<string, XopcSessionDiskEntry>;\n  } catch {\n    return {\n      id: 'session-integrity',\n      label: 'Sessions',\n      status: 'warn',\n      message: '`sessions.json` is not valid JSON.',\n      hints: [mapPath],\n    };\n  }\n\n  const keys = Object.keys(map);\n  const sorted = [...keys].sort((a, b) => {\n    const ta = map[a]?.updatedAt ?? 0;\n    const tb = map[b]?.updatedAt ?? 0;\n    return tb - ta;\n  });\n  const sample = sorted.slice(0, 20);\n  if (sample.length === 0) {\n    return {\n      id: 'session-integrity',\n      label: 'Sessions',\n      status: 'pass',\n      message: '`sessions.json` is valid; no sessions to sample.',\n      hints: [],\n    };\n  }\n\n  const missing: string[] = [];\n  for (const sessionKey of sample) {\n    const entry = map[sessionKey];\n    if (!entry?.sessionId) {\n      missing.push(sessionKey);\n      continue;\n    }\n    try {\n      const p = resolveSessionFilePath(entry.sessionId, entry, { sessionsDir });\n      if (!existsSync(p)) {\n        missing.push(sessionKey);\n      }\n    } catch {\n      missing.push(sessionKey);\n    }\n  }\n\n  if (missing.length > 0) {\n    return {\n      id: 'session-integrity',\n      label: 'Sessions',\n      status: 'warn',\n      message: `${missing.length} of ${sample.length} sampled session transcripts are missing on disk.`,\n      hints: missing.slice(0, 5).map((k) => `Missing transcript for: ${k}`),\n    };\n  }\n\n  return {\n    id: 'session-integrity',\n    label: 'Sessions',\n    status: 'pass',\n    message: `Sampled ${sample.length} recent session(s); JSONL transcripts are present.`,\n    hints: [],\n  };\n}\n"],"mappings":";;;;;;;kBAGyE;aACf;YACkB;uBACY;AAIxF,eAAsB,sBAAsB,KAA0C;AACpF,KAAI,CAAC,IAAI,QAAQ,KACf,QAAO;EACL,IAAI;EACJ,OAAO;EACP,QAAQ;EACR,SAAS;EACT,OAAO,CAAC,0BAA0B;EACnC;AAGH,KAAI,CAAC,WAAW,IAAI,WAAW,CAC7B,QAAO;EACL,IAAI;EACJ,OAAO;EACP,QAAQ;EACR,SAAS;EACT,OAAO,EAAE;EACV;CAGH,IAAI;AACJ,KAAI;AACF,WAAS,WAAW,IAAI,WAAW;SAC7B;AACN,SAAO;GACL,IAAI;GACJ,OAAO;GACP,QAAQ;GACR,SAAS;GACT,OAAO,EAAE;GACV;;CAGH,MAAM,UAAU,sBAAsB,OAAO;CAC7C,MAAM,cAAc,mBAAmB,QAAQ,QAAQ;CACvD,MAAM,UAAU,KAAK,aAAa,UAAU,aAAa;AAEzD,KAAI,CAAC,WAAW,YAAY,CAC1B,QAAO;EACL,IAAI;EACJ,OAAO;EACP,QAAQ;EACR,SAAS;EACT,OAAO,CAAC,YAAY;EACrB;AAGH,KAAI,CAAC,WAAW,QAAQ,CACtB,QAAO;EACL,IAAI;EACJ,OAAO;EACP,QAAQ;EACR,SAAS;EACT,OAAO,CAAC,QAAQ;EACjB;CAGH,IAAI;AACJ,KAAI;EACF,MAAM,SAAS,KAAK,MAAM,aAAa,SAAS,QAAQ,CAAC;AACzD,MAAI,CAAC,UAAU,OAAO,WAAW,YAAY,MAAM,QAAQ,OAAO,CAChE,OAAM,IAAI,MAAM,UAAU;AAE5B,QAAM;SACA;AACN,SAAO;GACL,IAAI;GACJ,OAAO;GACP,QAAQ;GACR,SAAS;GACT,OAAO,CAAC,QAAQ;GACjB;;CASH,MAAM,SALS,CAAC,GADH,OAAO,KAAK,IACF,CAAC,CAAC,MAAM,GAAG,MAAM;EACtC,MAAM,KAAK,IAAI,IAAI,aAAa;AAEhC,UADW,IAAI,IAAI,aAAa,KACpB;GAEO,CAAC,MAAM,GAAG,GAAG;AAClC,KAAI,OAAO,WAAW,EACpB,QAAO;EACL,IAAI;EACJ,OAAO;EACP,QAAQ;EACR,SAAS;EACT,OAAO,EAAE;EACV;CAGH,MAAM,UAAoB,EAAE;AAC5B,MAAK,MAAM,cAAc,QAAQ;EAC/B,MAAM,QAAQ,IAAI;AAClB,MAAI,CAAC,OAAO,WAAW;AACrB,WAAQ,KAAK,WAAW;AACxB;;AAEF,MAAI;AAEF,OAAI,CAAC,WADK,uBAAuB,MAAM,WAAW,OAAO,EAAE,aAAa,CACvD,CAAC,CAChB,SAAQ,KAAK,WAAW;UAEpB;AACN,WAAQ,KAAK,WAAW;;;AAI5B,KAAI,QAAQ,SAAS,EACnB,QAAO;EACL,IAAI;EACJ,OAAO;EACP,QAAQ;EACR,SAAS,GAAG,QAAQ,OAAO,MAAM,OAAO,OAAO;EAC/C,OAAO,QAAQ,MAAM,GAAG,EAAE,CAAC,KAAK,MAAM,2BAA2B,IAAI;EACtE;AAGH,QAAO;EACL,IAAI;EACJ,OAAO;EACP,QAAQ;EACR,SAAS,WAAW,OAAO,OAAO;EAClC,OAAO,EAAE;EACV"}
+{"version":3,"file":"session-integrity.js","names":[],"sources":["../../../../../../src/cli/commands/doctor/checks/session-integrity.ts"],"sourcesContent":["import { existsSync, readdirSync, readFileSync } from 'node:fs';\nimport { basename, join } from 'node:path';\n\nimport { listAgentEntries, resolveDefaultAgentId } from '../../../../agent/agent-scope.js';\nimport { loadConfig } from '../../../../config/loader.js';\nimport type { Config } from '../../../../config/schema.js';\nimport { FILENAMES, resolveSessionsDir } from '../../../../config/paths.js';\nimport { parseSessionKey } from '../../../../routing/session-key.js';\nimport { resolveSessionFilePath } from '../../../../session/parity/transcript-paths.js';\nimport type { XopcSessionDiskEntry } from '../../../../session/parity/xopc-session-disk-entry.js';\nimport type { CheckResult, DoctorContext } from '../types.js';\n\ninterface SessionMapLocation {\n  agentId: string;\n  sessionsDir: string;\n  mapPath: string;\n}\n\nfunction discoverSessionMapLocations(config: Config, stateDir: string): SessionMapLocation[] {\n  const agentIds = new Set<string>([\n    resolveDefaultAgentId(config),\n    ...listAgentEntries(config).map((agent) => agent.id),\n  ]);\n\n  const agentsRoot = join(stateDir, 'agents');\n  if (existsSync(agentsRoot)) {\n    for (const entry of readdirSync(agentsRoot, { withFileTypes: true })) {\n      if (entry.isDirectory()) {\n        agentIds.add(entry.name);\n      }\n    }\n  }\n\n  const seenMapPaths = new Set<string>();\n  const locations: SessionMapLocation[] = [];\n  for (const agentId of agentIds) {\n    const sessionsDir = resolveSessionsDir(config, agentId);\n    const mapPath = join(sessionsDir, FILENAMES.SESSIONS_MAP);\n    if (seenMapPaths.has(mapPath)) {\n      continue;\n    }\n    seenMapPaths.add(mapPath);\n    locations.push({ agentId, sessionsDir, mapPath });\n  }\n  return locations;\n}\n\nfunction readSessionMap(mapPath: string): Record<string, XopcSessionDiskEntry> {\n  const parsed = JSON.parse(readFileSync(mapPath, 'utf-8')) as unknown;\n  if (!parsed || typeof parsed !== 'object' || Array.isArray(parsed)) {\n    throw new Error('invalid sessions map');\n  }\n  return parsed as Record<string, XopcSessionDiskEntry>;\n}\n\nexport async function checkSessionIntegrity(ctx: DoctorContext): Promise<CheckResult> {\n  if (!ctx.options.deep) {\n    return {\n      id: 'session-integrity',\n      label: 'Sessions',\n      status: 'skip',\n      message: 'Deep mode off; session scan skipped.',\n      hints: ['Run: xopc doctor --deep'],\n    };\n  }\n\n  if (!existsSync(ctx.configPath)) {\n    return {\n      id: 'session-integrity',\n      label: 'Sessions',\n      status: 'skip',\n      message: 'No config file; skipped.',\n      hints: [],\n    };\n  }\n\n  let config: Config;\n  try {\n    config = loadConfig(ctx.configPath);\n  } catch {\n    return {\n      id: 'session-integrity',\n      label: 'Sessions',\n      status: 'skip',\n      message: 'Config could not be loaded; skipped.',\n      hints: [],\n    };\n  }\n\n  const locations = discoverSessionMapLocations(config, ctx.stateDir);\n  const missingMaps: string[] = [];\n  const invalidMaps: string[] = [];\n  const missingTranscripts: string[] = [];\n  const agentMismatches: string[] = [];\n  const orphanTranscripts: string[] = [];\n  let sessionCount = 0;\n\n  for (const location of locations) {\n    if (!existsSync(location.sessionsDir)) {\n      continue;\n    }\n    if (!existsSync(location.mapPath)) {\n      missingMaps.push(location.mapPath);\n      continue;\n    }\n\n    let map: Record<string, XopcSessionDiskEntry>;\n    try {\n      map = readSessionMap(location.mapPath);\n    } catch {\n      invalidMaps.push(location.mapPath);\n      continue;\n    }\n\n    const referencedTranscriptFiles = new Set<string>();\n    for (const [sessionKey, entry] of Object.entries(map)) {\n      sessionCount++;\n      const parsed = parseSessionKey(sessionKey);\n      if (parsed && parsed.agentId !== location.agentId) {\n        agentMismatches.push(`${sessionKey} in agent ${location.agentId}`);\n      }\n      if (!entry?.sessionId) {\n        missingTranscripts.push(sessionKey);\n        continue;\n      }\n      try {\n        const transcriptPath = resolveSessionFilePath(entry.sessionId, entry, { sessionsDir: location.sessionsDir });\n        referencedTranscriptFiles.add(basename(transcriptPath));\n        if (!existsSync(transcriptPath)) {\n          missingTranscripts.push(sessionKey);\n        }\n      } catch {\n        missingTranscripts.push(sessionKey);\n      }\n    }\n\n    for (const file of readdirSync(location.sessionsDir, { withFileTypes: true })) {\n      if (!file.isFile() || !file.name.endsWith('.jsonl') || file.name.includes('.checkpoint.')) {\n        continue;\n      }\n      if (!referencedTranscriptFiles.has(file.name)) {\n        orphanTranscripts.push(join(location.sessionsDir, file.name));\n      }\n    }\n  }\n\n  const hints = [\n    ...missingMaps.slice(0, 3).map((path) => `Missing sessions.json: ${path}`),\n    ...invalidMaps.slice(0, 3).map((path) => `Invalid sessions.json: ${path}`),\n    ...agentMismatches.slice(0, 3).map((item) => `Session key agent mismatch: ${item}`),\n    ...missingTranscripts.slice(0, 3).map((key) => `Missing transcript for: ${key}`),\n    ...orphanTranscripts.slice(0, 3).map((path) => `Orphan transcript: ${path}`),\n  ];\n\n  const warningCount =\n    missingMaps.length + invalidMaps.length + missingTranscripts.length + agentMismatches.length + orphanTranscripts.length;\n\n  if (warningCount > 0) {\n    return {\n      id: 'session-integrity',\n      label: 'Sessions',\n      status: 'warn',\n      message: `Scanned ${locations.length} agent session dir(s), ${sessionCount} session(s); found ${warningCount} issue(s).`,\n      hints,\n    };\n  }\n\n  return {\n    id: 'session-integrity',\n    label: 'Sessions',\n    status: 'pass',\n    message: `Scanned ${locations.length} agent session dir(s), ${sessionCount} session(s); session maps and JSONL transcripts are consistent.`,\n    hints: [],\n  };\n}\n"],"mappings":"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"}

package/dist/src/cli/commands/gateway/lifecycle.js

@@ -1,8 +1,8 @@
 import { init_paths, resolveConfigPath } from "../../../config/paths.js";
 import { loadConfig } from "../../../config/loader.js";
 import "../../../config/index.js";
-import { resolveGatewayService } from "../../../daemon/service.js";
 import { isRestartEnabled } from "../../../config/commands.flags.js";
+import { resolveGatewayService } from "../../../daemon/service.js";
 import { authorizeGatewaySigusr1Restart, writeGatewayRestartIntentSync } from "../../../infra/restart.js";
 import { findVerifiedGatewayListenerPidsOnPortSync, formatGatewayPidList, signalVerifiedGatewayPidSync } from "../../../infra/gateway-processes.js";
 import { runServiceRestart, runServiceStop } from "./lifecycle-core.js";