@rk0429/agentic-relay 21.2.3 → 22.0.0

package/dist/application/chat/chat-setup-service.js

@@ -0,0 +1,183 @@
+import { ValidationError } from "../../core/errors.js";
+const SLACK_MANIFEST = {
+    display_information: {
+        name: "agentic-relay",
+        description: "Chat bridge for agentic-relay",
+        background_color: "#1f2937",
+    },
+    features: {
+        bot_user: {
+            display_name: "agentic-relay",
+            always_online: false,
+        },
+    },
+    oauth_config: {
+        scopes: {
+            bot: [
+                "app_mentions:read",
+                "channels:history",
+                "channels:read",
+                "chat:write",
+                "groups:history",
+                "groups:read",
+                "im:history",
+                "im:read",
+                "im:write",
+                "mpim:history",
+                "users:read",
+            ],
+        },
+    },
+    settings: {
+        socket_mode_enabled: true,
+        event_subscriptions: {
+            bot_events: [
+                "app_mention",
+                "message.channels",
+                "message.groups",
+                "message.im",
+            ],
+        },
+    },
+};
+const DISCORD_PERMISSIONS = 0x400n + // View Channels
+    0x800n + // Send Messages
+    0x10000n + // Read Message History
+    0x800000000n + // Create Public Threads
+    0x4000000000n; // Send Messages in Threads
+export class ChatSetupService {
+    deps;
+    constructor(deps) {
+        this.deps = deps;
+    }
+    async setupSlack() {
+        const existing = (await this.deps.credentialsRepository.load()) ?? {};
+        if (existing.slack && !(await this.confirmOverwrite("Slack"))) {
+            throw new ValidationError("Slack setup was cancelled by the user.");
+        }
+        const manifestUrl = `https://api.slack.com/apps?new_app=1&manifest_json=${encodeURIComponent(JSON.stringify(SLACK_MANIFEST))}`;
+        await this.openWithFallback(manifestUrl, "Slack App 作成画面を自動で開けませんでした。以下の URL をブラウザで開いてください。");
+        this.deps.logger?.("1. Slack でアプリを作成し、Install to Workspace を完了してください。");
+        this.deps.logger?.("2. App-Level Tokens で connections:write を付与した xapp トークンを発行してください。");
+        const botToken = (await this.deps.prompt("Slack Bot User OAuth Token (xoxb-...): ")).trim();
+        const appToken = (await this.deps.prompt("Slack App-Level Token (xapp-...): ")).trim();
+        const slackCredentials = await this.validateSlackCredentials(botToken, appToken);
+        await this.deps.credentialsRepository.save({
+            ...existing,
+            slack: slackCredentials,
+        });
+        return {
+            platform: "slack",
+            manifestUrl,
+        };
+    }
+    async setupDiscord() {
+        const existing = (await this.deps.credentialsRepository.load()) ?? {};
+        if (existing.discord && !(await this.confirmOverwrite("Discord"))) {
+            throw new ValidationError("Discord setup was cancelled by the user.");
+        }
+        const portalUrl = "https://discord.com/developers/applications";
+        await this.openWithFallback(portalUrl, "Discord Developer Portal を自動で開けませんでした。以下の URL をブラウザで開いてください。");
+        this.deps.logger?.("1. New Application を作成し、Bot Token を発行してください。");
+        this.deps.logger?.("2. Privileged Gateway Intents の MESSAGE CONTENT INTENT を有効化してください。");
+        const botToken = (await this.deps.prompt("Discord Bot Token: ")).trim();
+        const validated = await this.validateDiscordCredentials(botToken);
+        const inviteUrl = buildDiscordInviteUrl(validated.applicationId);
+        await this.openWithFallback(inviteUrl, "Discord Bot 招待 URL を自動で開けませんでした。以下の URL をブラウザで開いてください。");
+        await this.deps.credentialsRepository.save({
+            ...existing,
+            discord: validated,
+        });
+        return {
+            platform: "discord",
+            inviteUrl,
+        };
+    }
+    async validateSlackCredentials(botToken, appToken) {
+        if (!botToken.startsWith("xoxb-")) {
+            throw new ValidationError("Slack bot token must start with xoxb-.");
+        }
+        if (!appToken.startsWith("xapp-")) {
+            throw new ValidationError("Slack app token must start with xapp-.");
+        }
+        const response = await this.fetchJson("https://slack.com/api/auth.test", {
+            method: "POST",
+            headers: {
+                Authorization: `Bearer ${botToken}`,
+                "Content-Type": "application/x-www-form-urlencoded",
+            },
+            body: "",
+        });
+        if (!response.ok || !response.body?.ok) {
+            throw new ValidationError("Slack bot token validation failed.", {
+                recoveryHint: "Re-run setup and paste a valid Bot User OAuth Token.",
+            });
+        }
+        return {
+            botToken,
+            appToken,
+            teamId: String(response.body.team_id),
+            botUserId: String(response.body.user_id),
+        };
+    }
+    async validateDiscordCredentials(botToken) {
+        const meResponse = await this.fetchJson("https://discord.com/api/users/@me", {
+            headers: {
+                Authorization: `Bot ${botToken}`,
+            },
+        });
+        if (!meResponse.ok || !meResponse.body?.id) {
+            throw new ValidationError("Discord bot token validation failed.", {
+                recoveryHint: "Re-run setup and paste a valid Discord Bot Token.",
+            });
+        }
+        const appResponse = await this.fetchJson("https://discord.com/api/oauth2/applications/@me", {
+            headers: {
+                Authorization: `Bot ${botToken}`,
+            },
+        });
+        const applicationId = String(appResponse.body?.id ?? "").trim() ||
+            (await this.deps.prompt("Discord Application ID: ")).trim();
+        if (!applicationId) {
+            throw new ValidationError("Discord application ID is required.");
+        }
+        return {
+            botToken,
+            applicationId,
+            botUserId: String(meResponse.body.id),
+        };
+    }
+    async confirmOverwrite(platform) {
+        return this.deps.confirm(`${platform} credentials already exist. Overwrite? [y/N] `);
+    }
+    async openWithFallback(url, warning) {
+        try {
+            await this.deps.openUrl(url);
+        }
+        catch {
+            this.deps.logger?.(warning);
+            this.deps.logger?.(url);
+        }
+    }
+    async fetchJson(url, init) {
+        const fetchImpl = this.deps.fetchImpl ?? fetch;
+        const response = await fetchImpl(url, init);
+        const body = (await response.json().catch(() => null));
+        return {
+            ok: response.ok,
+            body,
+        };
+    }
+}
+export function buildSlackManifest() {
+    return SLACK_MANIFEST;
+}
+export function buildDiscordInviteUrl(applicationId) {
+    const params = new URLSearchParams({
+        client_id: applicationId,
+        scope: "bot applications.commands",
+        permissions: DISCORD_PERMISSIONS.toString(),
+    });
+    return `https://discord.com/oauth2/authorize?${params.toString()}`;
+}
+//# sourceMappingURL=chat-setup-service.js.map

package/dist/application/chat/chat-setup-service.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"chat-setup-service.js","sourceRoot":"","sources":["../../../src/application/chat/chat-setup-service.ts"],"names":[],"mappings":"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"}

package/dist/application/chat/message-queue-manager.d.ts

@@ -0,0 +1,13 @@
+import type { InboundChatEvent } from "../../domain/chat/types.js";
+export declare class MessageQueueManager {
+    private readonly processingThreads;
+    private readonly bufferedMessages;
+    private maxBufferedPerThread;
+    constructor(maxBufferedPerThread?: number);
+    setMaxBufferedPerThread(maxBufferedPerThread: number): void;
+    startProcessing(threadKey: string): void;
+    finishProcessing(threadKey: string): void;
+    enqueue(threadKey: string, event: InboundChatEvent): void;
+    dequeueAll(threadKey: string): InboundChatEvent[];
+    isProcessing(threadKey: string): boolean;
+}

package/dist/application/chat/message-queue-manager.js

@@ -0,0 +1,34 @@
+export class MessageQueueManager {
+    processingThreads = new Set();
+    bufferedMessages = new Map();
+    maxBufferedPerThread;
+    constructor(maxBufferedPerThread = 10) {
+        this.maxBufferedPerThread = maxBufferedPerThread;
+    }
+    setMaxBufferedPerThread(maxBufferedPerThread) {
+        this.maxBufferedPerThread = Math.max(1, Math.floor(maxBufferedPerThread));
+    }
+    startProcessing(threadKey) {
+        this.processingThreads.add(threadKey);
+    }
+    finishProcessing(threadKey) {
+        this.processingThreads.delete(threadKey);
+    }
+    enqueue(threadKey, event) {
+        const queue = this.bufferedMessages.get(threadKey) ?? [];
+        if (queue.length >= this.maxBufferedPerThread) {
+            queue.shift();
+        }
+        queue.push(event);
+        this.bufferedMessages.set(threadKey, queue);
+    }
+    dequeueAll(threadKey) {
+        const queue = this.bufferedMessages.get(threadKey) ?? [];
+        this.bufferedMessages.delete(threadKey);
+        return queue;
+    }
+    isProcessing(threadKey) {
+        return this.processingThreads.has(threadKey);
+    }
+}
+//# sourceMappingURL=message-queue-manager.js.map

package/dist/application/chat/message-queue-manager.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"message-queue-manager.js","sourceRoot":"","sources":["../../../src/application/chat/message-queue-manager.ts"],"names":[],"mappings":"AAEA,MAAM,OAAO,mBAAmB;IACb,iBAAiB,GAAG,IAAI,GAAG,EAAU,CAAC;IACtC,gBAAgB,GAAG,IAAI,GAAG,EAA8B,CAAC;IAClE,oBAAoB,CAAS;IAErC,YAAmB,oBAAoB,GAAG,EAAE;QAC1C,IAAI,CAAC,oBAAoB,GAAG,oBAAoB,CAAC;IACnD,CAAC;IAEM,uBAAuB,CAAC,oBAA4B;QACzD,IAAI,CAAC,oBAAoB,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,KAAK,CAAC,oBAAoB,CAAC,CAAC,CAAC;IAC5E,CAAC;IAEM,eAAe,CAAC,SAAiB;QACtC,IAAI,CAAC,iBAAiB,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC;IACxC,CAAC;IAEM,gBAAgB,CAAC,SAAiB;QACvC,IAAI,CAAC,iBAAiB,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC;IAC3C,CAAC;IAEM,OAAO,CAAC,SAAiB,EAAE,KAAuB;QACvD,MAAM,KAAK,GAAG,IAAI,CAAC,gBAAgB,CAAC,GAAG,CAAC,SAAS,CAAC,IAAI,EAAE,CAAC;QACzD,IAAI,KAAK,CAAC,MAAM,IAAI,IAAI,CAAC,oBAAoB,EAAE,CAAC;YAC9C,KAAK,CAAC,KAAK,EAAE,CAAC;QAChB,CAAC;QACD,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;QAClB,IAAI,CAAC,gBAAgB,CAAC,GAAG,CAAC,SAAS,EAAE,KAAK,CAAC,CAAC;IAC9C,CAAC;IAEM,UAAU,CAAC,SAAiB;QACjC,MAAM,KAAK,GAAG,IAAI,CAAC,gBAAgB,CAAC,GAAG,CAAC,SAAS,CAAC,IAAI,EAAE,CAAC;QACzD,IAAI,CAAC,gBAAgB,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC;QACxC,OAAO,KAAK,CAAC;IACf,CAAC;IAEM,YAAY,CAAC,SAAiB;QACnC,OAAO,IAAI,CAAC,iBAAiB,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC;IAC/C,CAAC;CACF"}

package/dist/application/routine-status-query-service.d.ts

@@ -1,6 +1,7 @@
 import type { LogEntry } from "../core/types.js";
 import type { RoutineCatalogService } from "./routine-catalog-service.js";
 import { RoutineName } from "../domain/routine-name.js";
+import { RoutineExecutionLeaseRepository } from "../infrastructure/store/routine-execution-lease-repository.js";
 import type { RuntimeProjection } from "../infrastructure/store/routine-runtime-projection-repository.js";
 import { RoutineRuntimeProjectionRepository } from "../infrastructure/store/routine-runtime-projection-repository.js";
 import type { NamedPersistedRoutineState } from "../infrastructure/store/routine-state-repository.js";
@@ -48,11 +49,24 @@ export interface RoutineStatusDto extends RoutineSummaryDto {
     runtime?: RuntimeProjection;
     recentExecutions: LogEntry[];
 }
+export type CleanupTargetKind = "orphan_state" | "stale_runtime" | "stale_loop_state" | "stale_lease";
+export interface CleanupTarget {
+    kind: CleanupTargetKind;
+    filePath: string;
+    reason: string;
+}
+export interface CleanupResult {
+    targets: CleanupTarget[];
+    deleted: number;
+}
 export interface RoutineStatusQueryServiceDeps {
     catalogService: Pick<RoutineCatalogService, "getCatalog" | "getSnapshot" | "rescan">;
     stateRepo: RoutineStateRepository;
     runtimeRepo: RoutineRuntimeProjectionRepository;
     store: RelayStore;
+    leaseRepo?: RoutineExecutionLeaseRepository;
+    loopStateFiles?: () => Promise<string[]>;
+    deleteLoopState?: (filename: string) => Promise<void>;
     checkProcessAlive?: (pid: number) => boolean;
 }
 export declare class RoutineStatusQueryService {
@@ -63,5 +77,8 @@ export declare class RoutineStatusQueryService {
     status(name: RoutineName | string, options?: {
         limit?: number;
     }): Promise<RoutineStatusDto>;
+    cleanup(dryRun: boolean): Promise<CleanupResult>;
     private buildMergedView;
+    private buildRoutineFilePath;
+    private buildLoopStateFilePath;
 }

package/dist/application/routine-status-query-service.js

@@ -1,3 +1,4 @@
+import path from "node:path";
 import { ValidationError } from "../core/errors.js";
 import { isProcessAlive } from "./housekeeping.js";
 import { RoutineName } from "../domain/routine-name.js";
@@ -37,6 +38,95 @@ export class RoutineStatusQueryService {
         }
         return entry;
     }
+    async cleanup(dryRun) {
+        const merged = await this.buildMergedView(0);
+        const targets = [];
+        for (const entry of merged.entries) {
+            if (entry.orphan && entry.state !== undefined) {
+                targets.push({
+                    kind: "orphan_state",
+                    filePath: this.buildRoutineFilePath(entry.name, "state"),
+                    reason: "Routine state exists without a matching workflow definition.",
+                });
+            }
+            if (entry.status === "stale_runtime") {
+                targets.push({
+                    kind: "stale_runtime",
+                    filePath: this.buildRoutineFilePath(entry.name, "runtime"),
+                    reason: "Runtime projection is stale because the owner process or heartbeat is missing.",
+                });
+            }
+        }
+        if (this.deps.leaseRepo) {
+            const leases = await this.deps.leaseRepo.list();
+            for (const lease of leases) {
+                if (!this.deps.leaseRepo.isStale(lease.lease)) {
+                    continue;
+                }
+                targets.push({
+                    kind: "stale_lease",
+                    filePath: this.buildRoutineFilePath(lease.name.value, "lease"),
+                    reason: "Routine execution lease is stale.",
+                });
+            }
+        }
+        if (this.deps.loopStateFiles && this.deps.deleteLoopState) {
+            const filenames = await this.deps.loopStateFiles();
+            for (const filename of filenames) {
+                let parsed;
+                try {
+                    parsed = await this.deps.store.readLoopState(filename);
+                }
+                catch (error) {
+                    if (error instanceof SyntaxError) {
+                        targets.push({
+                            kind: "stale_loop_state",
+                            filePath: this.buildLoopStateFilePath(filename),
+                            reason: "Loop state file contains invalid JSON.",
+                        });
+                        continue;
+                    }
+                    throw error;
+                }
+                if (!hasInterruptedAt(parsed)) {
+                    targets.push({
+                        kind: "stale_loop_state",
+                        filePath: this.buildLoopStateFilePath(filename),
+                        reason: parsed === null
+                            ? "Loop state file could not be loaded."
+                            : "Loop state file is malformed or missing interruptedAt.",
+                    });
+                }
+            }
+        }
+        if (dryRun) {
+            return {
+                targets,
+                deleted: 0,
+            };
+        }
+        for (const target of targets) {
+            if (target.kind === "orphan_state") {
+                await this.deps.stateRepo.delete(new RoutineName(extractRoutineName(target.filePath)));
+                continue;
+            }
+            if (target.kind === "stale_runtime") {
+                await this.deps.runtimeRepo.remove(new RoutineName(extractRoutineName(target.filePath)));
+                continue;
+            }
+            if (target.kind === "stale_lease" && this.deps.leaseRepo) {
+                await this.deps.leaseRepo.release(new RoutineName(extractRoutineName(target.filePath)));
+                continue;
+            }
+            if (target.kind === "stale_loop_state" && this.deps.deleteLoopState) {
+                await this.deps.deleteLoopState(path.basename(target.filePath));
+            }
+        }
+        return {
+            targets,
+            deleted: targets.length,
+        };
+    }
     async buildMergedView(limit = 10) {
         const now = new Date();
         let snapshot = this.deps.catalogService.getSnapshot();
@@ -91,6 +181,27 @@ export class RoutineStatusQueryService {
             })),
         };
     }
+    buildRoutineFilePath(name, kind) {
+        const suffix = kind === "state"
+            ? ".state.json"
+            : kind === "runtime"
+                ? ".runtime.json"
+                : ".lock.json";
+        return path.join(this.deps.store.routinesDir(), `${name}${suffix}`);
+    }
+    buildLoopStateFilePath(filename) {
+        return path.join(this.deps.store.rootDir, "loops", filename);
+    }
+}
+function hasInterruptedAt(value) {
+    return (typeof value === "object" &&
+        value !== null &&
+        "interruptedAt" in value &&
+        typeof value.interruptedAt === "string" &&
+        value.interruptedAt.length > 0);
+}
+function extractRoutineName(filePath) {
+    return path.basename(filePath).replace(/\.(state|runtime|lock)\.json$/, "");
 }
 function filterRoutineLogs(logs, routineName) {
     return logs

package/dist/application/routine-status-query-service.js.map

@@ -1 +1 @@
-{"version":3,"file":"routine-status-query-service.js","sourceRoot":"","sources":["../../src/application/routine-status-query-service.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"routine-status-query-service.js","sourceRoot":"","sources":["../../src/application/routine-status-query-service.ts"],"names":[],"mappings":"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"}

package/dist/bin/relay.d.ts

@@ -22,6 +22,8 @@ type RoutineCommand = Extract<RelayCliCommand, {
     kind: "routine-start";
 } | {
     kind: "routine-stop";
+} | {
+    kind: "routine-cleanup";
 } | {
     kind: "routine-list";
 } | {
@@ -68,7 +70,7 @@ interface RoutineCommandHandlerDependencies {
     }) => Promise<Pick<RoutineDaemonService, "start">>;
     createRoutineStatusQueryService: (options: {
         configDir: string;
-    }) => Pick<RoutineStatusQueryService, "list" | "status">;
+    }) => Pick<RoutineStatusQueryService, "list" | "status" | "cleanup">;
     forkProcess: (modulePath: string, args: string[], options: ForkOptions) => ForkedProcessHandle;
     readTextFile: (filePath: string, encoding: BufferEncoding) => Promise<string>;
     removeFile: (filePath: string) => Promise<void>;
@@ -76,8 +78,13 @@ interface RoutineCommandHandlerDependencies {
     killProcess: (pid: number, signal: NodeJS.Signals) => void;
 }
 export declare const AGENTIC_SETUP_PROMPT = "\u30EF\u30FC\u30AF\u30B9\u30DA\u30FC\u30B9\u306E\u30A8\u30FC\u30B8\u30A7\u30F3\u30C8\u57FA\u76E4\u3092\u30BB\u30C3\u30C8\u30A2\u30C3\u30D7\u3057\u3066\u304F\u3060\u3055\u3044\u3002 .agents/skills/agentic-setup/SKILL.md \u306E\u624B\u9806\u306B\u5F93\u3063\u3066\u5B9F\u884C\u3057\u3066\u304F\u3060\u3055\u3044\u3002";
+export declare function buildRoutineStatusQueryService(options: {
+    store: RelayStore;
+    workflowRepo: WorkflowFileRepository;
+    configDir?: string;
+}): RoutineStatusQueryService;
 export declare function handleCoreManagementCommand(command: CoreCommand, dependencies: CoreCommandHandlerDependencies): Promise<void>;
 export declare function handleRoutineCommand(command: RoutineCommand, dependencies: RoutineCommandHandlerDependencies): Promise<number | undefined>;
-export type HelpTopic = "core-setup" | "core-update" | "core-remove" | "routine" | "routine-run" | "routine-start" | "routine-stop" | "routine-list" | "routine-status";
+export type HelpTopic = "core-setup" | "core-update" | "core-remove" | "chat" | "chat-setup" | "chat-start" | "chat-stop" | "chat-status" | "routine" | "routine-run" | "routine-start" | "routine-stop" | "routine-list" | "routine-status" | "routine-cleanup";
 export declare function renderHelpText(topic?: HelpTopic, scriptName?: string): string;
 export {};