@holon-run/agentinbox 0.7.0 → 1.0.0-beta.1

package/dist/src/sources/remote_modules.js

@@ -12,7 +12,7 @@ const node_url_1 = require("node:url");
 const github_1 = require("./github");
 const github_ci_1 = require("./github_ci");
 const feishu_1 = require("./feishu");
-const REMOTE_USER_MODULE_ROOT_DIR = "source-profiles";
+const REMOTE_USER_MODULE_ROOT_DIR = "source-modules";
 const BUILTIN_MODULE_IDS = new Set(["builtin.github_repo", "builtin.github_repo_ci", "builtin.feishu_bot"]);
 class RemoteSourceModuleRegistry {
     moduleCache = new Map();
@@ -33,12 +33,12 @@ class RemoteSourceModuleRegistry {
     }
     async loadUserModule(source, homeDir) {
         const config = source.config ?? {};
-        const profilePath = asNonEmptyString(config.profilePath);
-        if (!profilePath) {
-            throw new Error("remote_source requires config.profilePath (module path)");
+        const modulePath = asNonEmptyString(config.modulePath);
+        if (!modulePath) {
+            throw new Error("remote_source requires config.modulePath (module path)");
         }
         const moduleRoot = node_path_1.default.resolve(homeDir, REMOTE_USER_MODULE_ROOT_DIR);
-        const resolvedPath = resolveAndValidateModulePath(moduleRoot, profilePath);
+        const resolvedPath = resolveAndValidateModulePath(moduleRoot, modulePath);
         const cacheKey = `${resolvedPath}:${source.sourceKey}`;
         const cached = this.moduleCache.get(cacheKey);
         if (cached) {
@@ -96,20 +96,24 @@ function validateModuleContract(module, sourcePath) {
     validateOptionalHook(module.deriveTrackedResource, "deriveTrackedResource", sourcePath);
     validateOptionalHook(module.projectLifecycleSignal, "projectLifecycleSignal", sourcePath);
     validateOptionalHook(module.deriveInlinePreview, "deriveInlinePreview", sourcePath);
+    validateOptionalHook(module.deriveNotificationGrouping, "deriveNotificationGrouping", sourcePath);
+    validateOptionalHook(module.listDeliveryOperations, "listDeliveryOperations", sourcePath);
+    validateOptionalHook(module.invokeDeliveryOperation, "invokeDeliveryOperation", sourcePath);
+    validateOptionalHook(module.summarizeDigestThread, "summarizeDigestThread", sourcePath);
 }
 function validateOptionalHook(value, name, sourcePath) {
     if (value !== undefined && typeof value !== "function") {
         throw new Error(`remote_source module ${name} must be a function when provided: ${sourcePath}`);
     }
 }
-function resolveAndValidateModulePath(moduleRoot, profilePath) {
-    const resolved = node_path_1.default.isAbsolute(profilePath)
-        ? node_path_1.default.resolve(profilePath)
-        : node_path_1.default.resolve(moduleRoot, profilePath);
+function resolveAndValidateModulePath(moduleRoot, modulePath) {
+    const resolved = node_path_1.default.isAbsolute(modulePath)
+        ? node_path_1.default.resolve(modulePath)
+        : node_path_1.default.resolve(moduleRoot, modulePath);
     const normalizedRoot = ensureTrailingSep(node_path_1.default.resolve(moduleRoot));
     const normalizedResolved = node_path_1.default.resolve(resolved);
     if (!normalizedResolved.startsWith(normalizedRoot) && normalizedResolved !== node_path_1.default.resolve(moduleRoot)) {
-        throw new Error(`remote_source profilePath must stay under ${moduleRoot}`);
+        throw new Error(`remote_source modulePath must stay under ${moduleRoot}`);
     }
     return normalizedResolved;
 }
@@ -131,6 +135,12 @@ function asNonEmptyString(value) {
 }
 const GITHUB_REPO_MODULE = {
     id: "builtin.github_repo",
+    listDeliveryOperations(input) {
+        return (0, github_1.githubDeliveryOperationsForHandle)(input.handle);
+    },
+    async invokeDeliveryOperation(input) {
+        return (0, github_1.invokeGithubDeliveryOperation)(input.handle, input.operation, input.input);
+    },
     describeCapabilities(source) {
         const config = (0, github_1.parseGithubSourceConfig)(source);
         return {
@@ -190,11 +200,59 @@ const GITHUB_REPO_MODULE = {
     expandSubscriptionShortcut(input) {
         return (0, github_1.expandGithubSubscriptionShortcut)(input);
     },
-    deriveTrackedResource(filter) {
-        return (0, github_1.deriveGithubTrackedResource)(filter);
+    deriveTrackedResource(filter, source) {
+        return (0, github_1.deriveGithubTrackedResource)(filter, source);
+    },
+    deriveNotificationGrouping(item) {
+        const number = typeof item.metadata.number === "number" ? item.metadata.number : null;
+        if (!number) {
+            return null;
+        }
+        const variant = item.eventVariant;
+        if (variant.startsWith("PullRequestReviewCommentEvent.")) {
+            return {
+                groupable: true,
+                resourceRef: `pr:${number}`,
+                eventFamily: "review_comments",
+                summaryHint: `review comments on PR #${number}`,
+            };
+        }
+        if (variant.startsWith("PullRequestReviewEvent.")) {
+            return {
+                groupable: true,
+                resourceRef: `pr:${number}`,
+                eventFamily: "reviews",
+                summaryHint: `reviews on PR #${number}`,
+            };
+        }
+        if (variant.startsWith("IssueCommentEvent.")) {
+            return {
+                groupable: true,
+                resourceRef: item.metadata.isPullRequest === true ? `pr:${number}` : `issue:${number}`,
+                eventFamily: "comments",
+                summaryHint: item.metadata.isPullRequest === true ? `comments on PR #${number}` : `comments on issue #${number}`,
+            };
+        }
+        if (variant.startsWith("PullRequestEvent.closed")) {
+            return {
+                groupable: true,
+                resourceRef: `pr:${number}`,
+                eventFamily: "lifecycle",
+                summaryHint: `PR #${number} lifecycle updates`,
+                flushClass: "immediate",
+            };
+        }
+        return null;
     },
-    projectLifecycleSignal(rawPayload) {
-        return (0, github_1.projectGithubLifecycleSignal)(rawPayload);
+    summarizeDigestThread(items, _source, grouping) {
+        if (!grouping.summaryHint || items.length === 0) {
+            return null;
+        }
+        const count = items.length;
+        return `${count} ${grouping.summaryHint}`;
+    },
+    projectLifecycleSignal(rawPayload, source) {
+        return (0, github_1.projectGithubLifecycleSignal)(rawPayload, source);
     },
     validateConfig(source) {
         (0, github_1.parseGithubSourceConfig)(source);
@@ -298,6 +356,27 @@ const GITHUB_REPO_CI_MODULE = {
         }
         return parts.join(" ");
     },
+    deriveNotificationGrouping(item) {
+        const workflowRunId = typeof item.metadata.workflowRunId === "number" ? item.metadata.workflowRunId : null;
+        if (!workflowRunId) {
+            return null;
+        }
+        const conclusion = asNonEmptyString(item.metadata.conclusion);
+        const status = asNonEmptyString(item.metadata.status);
+        return {
+            groupable: true,
+            resourceRef: `workflow_run:${workflowRunId}`,
+            eventFamily: "ci_updates",
+            summaryHint: `CI updates for run #${workflowRunId}`,
+            flushClass: conclusion || status === "completed" ? "immediate" : "normal",
+        };
+    },
+    summarizeDigestThread(items, _source, grouping) {
+        if (!grouping.summaryHint || items.length === 0) {
+            return null;
+        }
+        return `${items.length} ${grouping.summaryHint}`;
+    },
     validateConfig(source) {
         (0, github_ci_1.parseGithubCiSourceConfig)(source);
     },
@@ -351,6 +430,12 @@ const GITHUB_REPO_CI_MODULE = {
 };
 const FEISHU_BOT_MODULE = {
     id: "builtin.feishu_bot",
+    listDeliveryOperations(input) {
+        return (0, feishu_1.feishuDeliveryOperationsForHandle)(input.handle);
+    },
+    async invokeDeliveryOperation(input) {
+        return (0, feishu_1.invokeFeishuDeliveryOperation)(input.handle, input.operation, input.input);
+    },
     describeCapabilities() {
         return {
             sourceKind: "feishu_bot",
@@ -412,7 +497,7 @@ const FEISHU_BOT_MODULE = {
 function moduleConfigForSource(source) {
     const config = asRecord(source.config);
     if (source.sourceType === "remote_source") {
-        return asRecord(config.profileConfig);
+        return asRecord(config.moduleConfig);
     }
     return config;
 }