@rk0429/agentic-relay 21.3.0 → 22.0.0

package/dist/bin/relay.js

@@ -1,11 +1,18 @@
 #!/usr/bin/env -S node --disable-warning=ExperimentalWarning
-import { fork } from "node:child_process";
+import { execFile, fork } from "node:child_process";
 import { randomUUID } from "node:crypto";
 import { existsSync } from "node:fs";
 import { access, readFile, realpath, rm } from "node:fs/promises";
 import path from "node:path";
 import { createInterface } from "node:readline";
 import { fileURLToPath } from "node:url";
+import { promisify } from "node:util";
+import { ChatDaemonService, } from "../application/chat/chat-daemon-service.js";
+import { ChatInboundHandler } from "../application/chat/chat-inbound-handler.js";
+import { ChatOutboundHandler } from "../application/chat/chat-outbound-handler.js";
+import { ChatQuestionService, InMemoryUserQuestionRepository, } from "../application/chat/chat-question-service.js";
+import { ChatSetupService } from "../application/chat/chat-setup-service.js";
+import { MessageQueueManager } from "../application/chat/message-queue-manager.js";
 import { CoreManagementService, } from "../application/core-management-service.js";
 import { LoopEventLogSink } from "../application/event-log-sink.js";
 import { isProcessAlive, reconcileAbandonedRunningTaskSessions, runStartupHousekeeping, } from "../application/housekeeping.js";
@@ -28,6 +35,12 @@ import { resolveRole } from "../domain/role.js";
 import { resolveBackend, validateRoutingRules } from "../domain/routing.js";
 import { loadRoutine } from "../domain/routine-loader.js";
 import { BackendRegistry } from "../infrastructure/backends/backend-registry.js";
+import { AdapterFactory } from "../infrastructure/chat/adapter-factory.js";
+import { AgentGatewayImpl } from "../infrastructure/chat/agent-gateway-impl.js";
+import { ChatIpcServer } from "../infrastructure/chat/chat-ipc-server.js";
+import { ChatLogger } from "../infrastructure/chat/chat-logger.js";
+import { CredentialsFileRepository } from "../infrastructure/chat/credentials-repository.js";
+import { SessionBridgeFileRepository } from "../infrastructure/chat/session-bridge-repository.js";
 import { CommandExecutionGateway } from "../infrastructure/command-execution-gateway.js";
 import { CliBackendExecutor } from "../infrastructure/backends/cli-backend-executor.js";
 import { ChildProcessExecutor, ChildProcessInteractiveRunner, } from "../infrastructure/process/process-executor.js";
@@ -37,11 +50,13 @@ import { isMissingFileError } from "../infrastructure/store/file-utils.js";
 import { RoutineExecutionLeaseRepository } from "../infrastructure/store/routine-execution-lease-repository.js";
 import { RoutineRuntimeProjectionRepository } from "../infrastructure/store/routine-runtime-projection-repository.js";
 import { RoutineStateRepository } from "../infrastructure/store/routine-state-repository.js";
+import { handleChatCommand, } from "../interfaces/cli/chat-cli.js";
 import { parseRelayCliArgs, } from "../interfaces/cli/relay-cli-args.js";
 import { createLoopProgressReporter } from "../interfaces/cli/loop-progress-shell.js";
 import { runRelayInteractiveShell } from "../interfaces/cli/relay-shell.js";
 import { renderVisualization } from "../interfaces/cli/visualization-renderer.js";
 import { createRelayMcpServer, serveRelayMcpServer, } from "../interfaces/mcp/relay-mcp-server.js";
+const execFileAsync = promisify(execFile);
 export const AGENTIC_SETUP_PROMPT = "ワークスペースのエージェント基盤をセットアップしてください。 .agents/skills/agentic-setup/SKILL.md の手順に従って実行してください。";
 export function buildRoutineStatusQueryService(options) {
     return new RoutineStatusQueryService({
@@ -52,6 +67,9 @@ export function buildRoutineStatusQueryService(options) {
         stateRepo: new RoutineStateRepository(options.store),
         runtimeRepo: new RoutineRuntimeProjectionRepository(options.store),
         store: options.store,
+        leaseRepo: new RoutineExecutionLeaseRepository(options.store),
+        loopStateFiles: () => options.store.listLoopStateFiles(),
+        deleteLoopState: (filename) => options.store.deleteLoopState(filename),
     });
 }
 async function main() {
@@ -184,9 +202,57 @@ async function main() {
         workflowRepo,
         configDir,
     });
+    const createChatSetupService = () => new ChatSetupService({
+        credentialsRepository: new CredentialsFileRepository(store.rootDir),
+        prompt: promptFromStdin,
+        confirm: confirmFromStdin,
+        openUrl: openUrlInBrowser,
+        logger: (message) => writeLine(process.stderr, message),
+    });
+    const createChatDaemonService = () => {
+        const credentialsRepository = new CredentialsFileRepository(store.rootDir);
+        const sessionBridgeRepository = new SessionBridgeFileRepository(store.rootDir);
+        const outboundHandler = new ChatOutboundHandler();
+        const questionService = new ChatQuestionService({
+            userQuestionRepository: new InMemoryUserQuestionRepository(),
+        });
+        const spawnService = new SpawnAgentsService({
+            backendRegistry,
+            backendExecutor,
+            store,
+            taskService,
+            cwd,
+            env: process.env,
+        });
+        const inboundHandler = new ChatInboundHandler({
+            agentGateway: new AgentGatewayImpl(spawnService, taskService, store, backendRegistry),
+            sessionBridgeRepository,
+            outboundHandler,
+            questionService,
+            messageQueueManager: new MessageQueueManager(),
+            logger: (message) => writeLine(process.stderr, message),
+        });
+        const ipcServer = new ChatIpcServer({
+            rootDir: store.rootDir,
+            outboundHandler,
+            questionService,
+        });
+        return new ChatDaemonService({
+            store,
+            credentialsRepository,
+            sessionBridgeRepository,
+            adapterFactory: new AdapterFactory(),
+            outboundHandler,
+            questionService,
+            inboundHandler,
+            ipcServer,
+            createLogger: (options) => new ChatLogger(options),
+        });
+    };
     if (command.kind === "routine-run" ||
         command.kind === "routine-start" ||
         command.kind === "routine-stop" ||
+        command.kind === "routine-cleanup" ||
         command.kind === "routine-list" ||
         command.kind === "routine-status") {
         const exitCode = await handleRoutineCommand(command, {
@@ -217,6 +283,26 @@ async function main() {
         }
         return;
     }
+    if (command.kind === "chat-setup" ||
+        command.kind === "chat-start" ||
+        command.kind === "chat-stop" ||
+        command.kind === "chat-status") {
+        const exitCode = await handleChatCommand(command, {
+            cwd,
+            argv: process.argv.slice(2),
+            scriptPath: process.argv[1] ?? fileURLToPath(import.meta.url),
+            env: process.env,
+            stdout: process.stdout,
+            stderr: process.stderr,
+            createSetupService: createChatSetupService,
+            createDaemonService: createChatDaemonService,
+            forkProcess: (modulePath, args, options) => fork(modulePath, args, options),
+        });
+        if (exitCode !== undefined) {
+            process.exitCode = exitCode;
+        }
+        return;
+    }
     if (command.kind === "mcp") {
         const installed = await backendRegistry.detectInstalled();
         if (installed.length === 0) {
@@ -246,6 +332,7 @@ async function main() {
             routineStatusQueryService: buildRoutineStatusQueryService({
                 store,
                 workflowRepo,
+                configDir: command.configDir,
             }),
             allowSpawnAgents: process.env.RELAY_ALLOW_SPAWN_AGENTS !== "0",
             shutdownSignal: shutdownController.signal,
@@ -351,9 +438,9 @@ export async function handleRoutineCommand(command, dependencies) {
             const placeholderTime = new Date().toISOString();
             warnOnBuiltInRoutineVarOverrides(command.vars, dependencies.stderr);
             const routineVars = buildRoutineLoadVars(command.vars, placeholderTime);
-            await dependencies.runStartupHousekeeping(dependencies.store, {
+            await suppressLoopStateWarnings(() => dependencies.runStartupHousekeeping(dependencies.store, {
                 protectedLoopStateFile: command.resumeStateFile,
-            });
+            }));
             await dependencies.reconcileAbandonedRunningTaskSessions(dependencies.store, dependencies.taskService);
             const loadedRoutine = await dependencies.loadRoutine(workflowPath, dependencies.workflowRepo, routineVars);
             warnOnBuiltInRoutineYamlVarOverrides(loadedRoutine.rawYamlVarKeys, dependencies.stderr);
@@ -375,7 +462,7 @@ export async function handleRoutineCommand(command, dependencies) {
                         vars: command.vars ?? {},
                     })
                     : undefined;
-                dependencies.stdout.write(renderRoutineDryRun(loadedRoutine, workflowPath, resumePreflight));
+                dependencies.stdout.write(renderRoutineDryRun(loadedRoutine, workflowPath, resumePreflight, command.vars, loadedRoutine.rawYamlVars));
                 return 0;
             }
             enforceAllowCommandRun(workflowPath, loadedRoutine.capabilitySummary, command.allowCommandRun ?? false);
@@ -481,6 +568,26 @@ export async function handleRoutineCommand(command, dependencies) {
             await stopRoutineDaemon(dependencies);
             return 0;
         }
+        case "routine-cleanup": {
+            const service = dependencies.createRoutineStatusQueryService({
+                configDir: resolveRoutineConfigDir(command.configDir, dependencies.store, dependencies.cwd),
+            });
+            const result = await service.cleanup(command.dryRun ?? false);
+            if (result.targets.length === 0) {
+                dependencies.stderr.write("No cleanup targets found.\n");
+                return 0;
+            }
+            if (command.dryRun) {
+                dependencies.stderr.write("Cleanup targets (dry-run):\n");
+            }
+            else {
+                dependencies.stderr.write(`Cleaned up ${result.deleted} file(s):\n`);
+            }
+            for (const target of result.targets) {
+                dependencies.stderr.write(`  ${target.kind}: ${target.filePath} — ${target.reason}\n`);
+            }
+            return 0;
+        }
         case "routine-list": {
             const service = dependencies.createRoutineStatusQueryService({
                 configDir: resolveRoutineConfigDir(command.configDir, dependencies.store, dependencies.cwd),
@@ -501,11 +608,31 @@ export async function handleRoutineCommand(command, dependencies) {
         }
     }
 }
+async function suppressLoopStateWarnings(fn) {
+    const origWarn = console.warn;
+    console.warn = (...args) => {
+        const msg = typeof args[0] === "string" ? args[0] : "";
+        if (msg.startsWith("Ignoring invalid loop state file")) {
+            console.debug(...args);
+            return;
+        }
+        origWarn.apply(console, args);
+    };
+    try {
+        return await fn();
+    }
+    finally {
+        console.warn = origWarn;
+    }
+}
 export function renderHelpText(topic, scriptName = path.basename(fileURLToPath(import.meta.url))) {
     if (topic) {
         if (isRoutineHelpTopic(topic)) {
             return renderRoutineHelp(topic, scriptName);
         }
+        if (isChatHelpTopic(topic)) {
+            return renderChatHelp(topic, scriptName);
+        }
         return renderCoreSubcommandHelp(topic, scriptName);
     }
     const commandName = path.parse(scriptName).name;
@@ -514,8 +641,13 @@ export function renderHelpText(topic, scriptName = path.basename(fileURLToPath(i
         `       ${scriptName} routine run <path> [--config <dir>] [--var key=value ...] [--dry-run] [--resume-state <file>] [--force-resume] [--allow-command-run]`,
         `       ${scriptName} routine start [--config <dir>] [--daemon] [--allow-command-run]`,
         `       ${scriptName} routine stop`,
+        `       ${scriptName} routine cleanup [--config <dir>] [--dry-run]`,
         `       ${scriptName} routine list [--config <dir>] [--format <table|tsv|json>]`,
         `       ${scriptName} routine status [name] [--config <dir>] [--format <table|tsv|json>] [--limit <n>]`,
+        `       ${scriptName} chat setup (--slack | --discord)`,
+        `       ${scriptName} chat start [--foreground]`,
+        `       ${scriptName} chat stop`,
+        `       ${scriptName} chat status`,
         `       ${scriptName} core <setup|update|remove> [options]`,
         `       ${scriptName} setup-vscode [--target <code|code-insiders|cursor>] [--uninstall]`,
         `       ${scriptName} visualize`,
@@ -527,8 +659,13 @@ export function renderHelpText(topic, scriptName = path.basename(fileURLToPath(i
         `  ${commandName} routine run    [options]  Run one routine YAML immediately`,
         `  ${commandName} routine start  [options]  Start the routine daemon`,
         `  ${commandName} routine stop              Stop the routine daemon`,
+        `  ${commandName} routine cleanup [options]  Remove stale routine metadata`,
         `  ${commandName} routine list   [options]  List known routines`,
         `  ${commandName} routine status [options]  Show routine status details`,
+        `  ${commandName} chat setup   [options]  Configure Slack or Discord integration`,
+        `  ${commandName} chat start   [options]  Start the chat daemon`,
+        `  ${commandName} chat stop               Stop the chat daemon`,
+        `  ${commandName} chat status             Show chat daemon status`,
         `  ${commandName} core setup   [options]  Setup .agents/ from agentic-core dist`,
         `  ${commandName} core update  [options]  Update .agents/ from latest dist`,
         `  ${commandName} core remove  [options]  Remove relay core managed files`,
@@ -584,6 +721,82 @@ function renderCoreSubcommandHelp(topic, scriptName) {
 function isRoutineHelpTopic(topic) {
     return topic.startsWith("routine");
 }
+function isChatHelpTopic(topic) {
+    return topic.startsWith("chat");
+}
+function renderChatHelp(topic, scriptName) {
+    if (topic === "chat") {
+        return [
+            `Usage: ${scriptName} chat setup (--slack | --discord)`,
+            `       ${scriptName} chat start [--foreground]`,
+            `       ${scriptName} chat stop`,
+            `       ${scriptName} chat status`,
+            "",
+            "Chat commands:",
+            "  setup             Configure Slack or Discord credentials",
+            "  start             Start the chat daemon",
+            "  stop              Stop the chat daemon",
+            "  status            Show chat daemon status",
+            "",
+            "Options:",
+            "  --slack               Setup Slack integration",
+            "  --discord             Setup Discord integration",
+            "  --foreground          Run the chat daemon in the foreground",
+            "  -h, --help            Show this help",
+        ].join("\n");
+    }
+    const commandName = path.parse(scriptName).name;
+    const allSubcommandsReference = `See '${commandName} chat --help' for all subcommands.`;
+    switch (topic) {
+        case "chat-setup":
+            return [
+                `Usage: ${scriptName} chat setup (--slack | --discord)`,
+                "",
+                "Configure Slack or Discord credentials for the chat daemon.",
+                "",
+                "Options:",
+                "  --slack               Configure Slack",
+                "  --discord             Configure Discord",
+                "  -h, --help            Show this help",
+                "",
+                allSubcommandsReference,
+            ].join("\n");
+        case "chat-start":
+            return [
+                `Usage: ${scriptName} chat start [--foreground]`,
+                "",
+                "Start the chat daemon.",
+                "",
+                "Options:",
+                "  --foreground          Run in the foreground for debugging",
+                "  -h, --help            Show this help",
+                "",
+                allSubcommandsReference,
+            ].join("\n");
+        case "chat-stop":
+            return [
+                `Usage: ${scriptName} chat stop`,
+                "",
+                "Stop the chat daemon.",
+                "",
+                "Options:",
+                "  -h, --help            Show this help",
+                "",
+                allSubcommandsReference,
+            ].join("\n");
+        case "chat-status":
+            return [
+                `Usage: ${scriptName} chat status`,
+                "",
+                "Show chat daemon status.",
+                "",
+                "Options:",
+                "  -h, --help            Show this help",
+                "",
+                allSubcommandsReference,
+            ].join("\n");
+    }
+}
 function renderRoutineHelp(topic, scriptName) {
     if (topic === "routine") {
         return renderRoutineAggregateHelp(scriptName);
@@ -633,6 +846,19 @@ function renderRoutineHelp(topic, scriptName) {
                 "",
                 allSubcommandsReference,
             ].join("\n");
+        case "routine-cleanup":
+            return [
+                `Usage: ${scriptName} routine cleanup [options]`,
+                "",
+                "Remove stale routine metadata files.",
+                "",
+                "Options:",
+                "  --config <dir>        Override the routine config directory",
+                "  --dry-run             Show cleanup targets without deleting them",
+                "  -h, --help            Show this help",
+                "",
+                allSubcommandsReference,
+            ].join("\n");
         case "routine-list":
             return [
                 `Usage: ${scriptName} routine list [options]`,
@@ -655,7 +881,7 @@ function renderRoutineHelp(topic, scriptName) {
                 "Options:",
                 "  --config <dir>        Override the routine config directory",
                 "  --format <fmt>        Output format (table, tsv, json)",
-                "  --limit <n>           Limit the number of status log entries",
+                "  --limit <n>           Limit the number of status log entries (default: 10)",
                 "  -h, --help            Show this help",
                 "",
                 allSubcommandsReference,
@@ -667,6 +893,7 @@ function renderRoutineAggregateHelp(scriptName) {
         `Usage: ${scriptName} routine run <workflow.yaml> [options]`,
         `       ${scriptName} routine start [options]`,
         `       ${scriptName} routine stop`,
+        `       ${scriptName} routine cleanup [options]`,
         `       ${scriptName} routine list [options]`,
         `       ${scriptName} routine status [name] [options]`,
         "",
@@ -674,6 +901,7 @@ function renderRoutineAggregateHelp(scriptName) {
         "  run               Run one routine YAML immediately",
         "  start             Start the routine daemon",
         "  stop              Stop the routine daemon",
+        "  cleanup           Remove stale routine metadata",
         "  list              List known routines",
         "  status            Show routine status details",
         "",
@@ -684,9 +912,9 @@ function renderRoutineAggregateHelp(scriptName) {
         "  --allow-command-run   Allow trusted workflows that declare command.run",
         "  --resume-state <file> Resume a loop-capable routine from checkpoint state",
         "  --force-resume        Override workflow digest mismatch during resume",
-        "  --dry-run             Render routine structure without executing it",
+        "  --dry-run             Render routine structure or cleanup targets without executing deletion",
         "  --var key=value       Set template variables for one routine run",
-        "  --limit <n>           Limit the number of status log entries",
+        "  --limit <n>           Limit the number of status log entries (default: 10)",
         "  -h, --help            Show this help",
     ].join("\n");
 }
@@ -953,6 +1181,9 @@ function printRoutineRunResult(result, writer = process.stderr) {
     writeLine(writer, lines.join("\n"));
 }
 const BUILT_IN_ROUTINE_VAR_KEYS = ["scheduled_time", "trigger_time"];
+function isBuiltInRoutineVarKey(key) {
+    return BUILT_IN_ROUTINE_VAR_KEYS.includes(key);
+}
 function buildRoutineLoadVars(vars, placeholderValue) {
     return {
         ...(vars ?? {}),
@@ -1034,7 +1265,18 @@ async function validateRoutineDryRunResumeState(options) {
         });
     }
 }
-function renderRoutineDryRun(loadedRoutine, workflowPath, resumePreflight) {
+function renderRoutineDryRun(loadedRoutine, workflowPath, resumePreflight, vars, yamlVars) {
+    const cliVarKeys = new Set(Object.keys(vars ?? {}));
+    const emptyVarWarnings = [
+        ...Object.entries(vars ?? {})
+            .filter(([key, value]) => value === "" && !isBuiltInRoutineVarKey(key))
+            .map(([key]) => key),
+        ...Object.entries(yamlVars ?? {})
+            .filter(([key, value]) => value === "" &&
+            !isBuiltInRoutineVarKey(key) &&
+            !cliVarKeys.has(key))
+            .map(([key]) => key),
+    ].map((key) => `  - Template variable "{{${key}}}" resolved to empty string.`);
     const lines = [
         `Routine: ${loadedRoutine.routineDefinition.name.value}`,
         ...(loadedRoutine.routineDefinition.description
@@ -1058,6 +1300,7 @@ function renderRoutineDryRun(loadedRoutine, workflowPath, resumePreflight) {
                     : []),
             ]
             : []),
+        ...(emptyVarWarnings.length > 0 ? ["Warnings:", ...emptyVarWarnings] : []),
         "",
         renderDryRun(loadedRoutine.routineDefinition.workflow, workflowPath),
     ];
@@ -1087,7 +1330,7 @@ function renderRoutineList(result, format = "table") {
                 formatOptionalTimestamp(entry.nextScheduledAt),
                 formatRoutineStatusWithOrphan(entry.status, entry.orphan),
             ].join("\t")),
-            ...invalid.map((entry) => `# Skipped: ${path.basename(entry.yamlPath)}: ${entry.error.replace(/\r?\n/g, " | ")}`),
+            ...invalid.map((entry) => `# ${path.basename(entry.yamlPath)}: ${firstLine(stripYamlPathPrefix(entry.yamlPath, entry.error))}`),
         ];
         return `${lines.join("\n")}\n`;
     }
@@ -1117,10 +1360,14 @@ function renderRoutineList(result, format = "table") {
 }
 function renderInvalidRoutineFiles(invalid) {
     return [
-        `Skipped ${invalid.length} file(s):`,
-        ...invalid.map((entry) => `  - ${path.basename(entry.yamlPath)}: ${firstLine(entry.error)}`),
+        `Skipped (${invalid.length}):`,
+        ...invalid.map((entry) => `  - ${path.basename(entry.yamlPath)}: ${firstLine(stripYamlPathPrefix(entry.yamlPath, entry.error))}`),
     ].join("\n");
 }
+function stripYamlPathPrefix(yamlPath, error) {
+    const prefix = `${yamlPath}: `;
+    return error.startsWith(prefix) ? error.slice(prefix.length) : error;
+}
 function firstLine(value) {
     return value.split(/\r?\n/u, 1)[0] ?? "";
 }
@@ -1446,6 +1693,26 @@ function confirmFromStdin(message) {
         });
     });
 }
+function promptFromStdin(message) {
+    const rl = createInterface({ input: process.stdin, output: process.stderr });
+    return new Promise((resolve) => {
+        rl.question(message, (answer) => {
+            rl.close();
+            resolve(answer);
+        });
+    });
+}
+async function openUrlInBrowser(url) {
+    if (process.platform === "darwin") {
+        await execFileAsync("open", [url]);
+        return;
+    }
+    if (process.platform === "win32") {
+        await execFileAsync("cmd", ["/c", "start", "", url]);
+        return;
+    }
+    await execFileAsync("xdg-open", [url]);
+}
 async function isExecutedAsScript(metaUrl) {
     const entryPath = process.argv[1];
     if (!entryPath) {