@holon-run/agentinbox 0.6.0 → 1.0.0-beta.0

package/dist/src/sources/{remote_profiles.js → remote_modules.js}

@@ -3,66 +3,66 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
     return (mod && mod.__esModule) ? mod : { "default": mod };
 };
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.RemoteSourceProfileRegistry = void 0;
-exports.builtInProfileIdForSourceType = builtInProfileIdForSourceType;
-exports.profileConfigForSource = profileConfigForSource;
+exports.RemoteSourceModuleRegistry = void 0;
+exports.builtInModuleIdForSourceType = builtInModuleIdForSourceType;
+exports.moduleConfigForSource = moduleConfigForSource;
 const node_fs_1 = __importDefault(require("node:fs"));
 const node_path_1 = __importDefault(require("node:path"));
 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_PROFILE_ROOT_DIR = "source-profiles";
-const BUILTIN_PROFILE_IDS = new Set(["builtin.github_repo", "builtin.github_repo_ci", "builtin.feishu_bot"]);
-class RemoteSourceProfileRegistry {
-    profileCache = new Map();
+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();
     resolve(source, homeDir) {
         if (source.sourceType === "github_repo") {
-            return Promise.resolve(GITHUB_REPO_PROFILE);
+            return Promise.resolve(GITHUB_REPO_MODULE);
         }
         if (source.sourceType === "github_repo_ci") {
-            return Promise.resolve(GITHUB_REPO_CI_PROFILE);
+            return Promise.resolve(GITHUB_REPO_CI_MODULE);
         }
         if (source.sourceType === "feishu_bot") {
-            return Promise.resolve(FEISHU_BOT_PROFILE);
+            return Promise.resolve(FEISHU_BOT_MODULE);
         }
         if (source.sourceType !== "remote_source") {
-            throw new Error(`unsupported source type for remote profile: ${source.sourceType}`);
+            throw new Error(`unsupported source type for remote module: ${source.sourceType}`);
         }
-        return this.loadUserProfile(source, homeDir);
+        return this.loadUserModule(source, homeDir);
     }
-    async loadUserProfile(source, homeDir) {
+    async loadUserModule(source, homeDir) {
         const config = source.config ?? {};
-        const profilePath = asNonEmptyString(config.profilePath);
-        if (!profilePath) {
-            throw new Error("remote_source requires config.profilePath");
+        const modulePath = asNonEmptyString(config.modulePath);
+        if (!modulePath) {
+            throw new Error("remote_source requires config.modulePath (module path)");
         }
-        const profileRoot = node_path_1.default.resolve(homeDir, REMOTE_USER_PROFILE_ROOT_DIR);
-        const resolvedPath = resolveAndValidateProfilePath(profileRoot, profilePath);
+        const moduleRoot = node_path_1.default.resolve(homeDir, REMOTE_USER_MODULE_ROOT_DIR);
+        const resolvedPath = resolveAndValidateModulePath(moduleRoot, modulePath);
         const cacheKey = `${resolvedPath}:${source.sourceKey}`;
-        const cached = this.profileCache.get(cacheKey);
+        const cached = this.moduleCache.get(cacheKey);
         if (cached) {
             return cached;
         }
         if (!node_fs_1.default.existsSync(resolvedPath)) {
-            throw new Error(`remote_source profile not found: ${resolvedPath}`);
+            throw new Error(`remote_source module not found: ${resolvedPath}`);
         }
         const imported = await dynamicImportModule((0, node_url_1.pathToFileURL)(resolvedPath).href);
-        const profile = (imported.default ?? imported);
-        if (!profile || typeof profile !== "object") {
-            throw new Error(`remote_source profile must export default object: ${resolvedPath}`);
+        const module = (imported.default ?? imported);
+        if (!module || typeof module !== "object") {
+            throw new Error(`remote_source module must export default object: ${resolvedPath}`);
         }
-        validateProfileContract(profile, resolvedPath);
-        this.profileCache.set(cacheKey, profile);
-        return profile;
+        validateModuleContract(module, resolvedPath);
+        this.moduleCache.set(cacheKey, module);
+        return module;
     }
 }
-exports.RemoteSourceProfileRegistry = RemoteSourceProfileRegistry;
+exports.RemoteSourceModuleRegistry = RemoteSourceModuleRegistry;
 async function dynamicImportModule(moduleUrl) {
     const importer = new Function("url", "return import(url);");
     return importer(moduleUrl);
 }
-function builtInProfileIdForSourceType(sourceType) {
+function builtInModuleIdForSourceType(sourceType) {
     if (sourceType === "github_repo") {
         return "builtin.github_repo";
     }
@@ -74,42 +74,46 @@ function builtInProfileIdForSourceType(sourceType) {
     }
     return null;
 }
-function validateProfileContract(profile, sourcePath) {
-    if (!profile.id || typeof profile.id !== "string") {
-        throw new Error(`remote_source profile id must be a non-empty string: ${sourcePath}`);
+function validateModuleContract(module, sourcePath) {
+    if (!module.id || typeof module.id !== "string") {
+        throw new Error(`remote_source module id must be a non-empty string: ${sourcePath}`);
     }
-    if (BUILTIN_PROFILE_IDS.has(profile.id)) {
-        throw new Error(`remote_source profile id is reserved: ${profile.id}`);
+    if (BUILTIN_MODULE_IDS.has(module.id)) {
+        throw new Error(`remote_source module id is reserved: ${module.id}`);
     }
-    if (typeof profile.validateConfig !== "function") {
-        throw new Error(`remote_source profile missing validateConfig(): ${sourcePath}`);
+    if (typeof module.validateConfig !== "function") {
+        throw new Error(`remote_source module missing validateConfig(): ${sourcePath}`);
     }
-    if (typeof profile.buildManagedSourceSpec !== "function") {
-        throw new Error(`remote_source profile missing buildManagedSourceSpec(): ${sourcePath}`);
+    if (typeof module.buildManagedSourceSpec !== "function") {
+        throw new Error(`remote_source module missing buildManagedSourceSpec(): ${sourcePath}`);
     }
-    if (typeof profile.mapRawEvent !== "function") {
-        throw new Error(`remote_source profile missing mapRawEvent(): ${sourcePath}`);
+    if (typeof module.mapRawEvent !== "function") {
+        throw new Error(`remote_source module missing mapRawEvent(): ${sourcePath}`);
     }
-    validateOptionalHook(profile.describeCapabilities, "describeCapabilities", sourcePath);
-    validateOptionalHook(profile.listSubscriptionShortcuts, "listSubscriptionShortcuts", sourcePath);
-    validateOptionalHook(profile.expandSubscriptionShortcut, "expandSubscriptionShortcut", sourcePath);
-    validateOptionalHook(profile.deriveTrackedResource, "deriveTrackedResource", sourcePath);
-    validateOptionalHook(profile.projectLifecycleSignal, "projectLifecycleSignal", sourcePath);
-    validateOptionalHook(profile.deriveInlinePreview, "deriveInlinePreview", sourcePath);
+    validateOptionalHook(module.describeCapabilities, "describeCapabilities", sourcePath);
+    validateOptionalHook(module.listSubscriptionShortcuts, "listSubscriptionShortcuts", sourcePath);
+    validateOptionalHook(module.expandSubscriptionShortcut, "expandSubscriptionShortcut", 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 profile ${name} must be a function when provided: ${sourcePath}`);
+        throw new Error(`remote_source module ${name} must be a function when provided: ${sourcePath}`);
     }
 }
-function resolveAndValidateProfilePath(profileRoot, profilePath) {
-    const resolved = node_path_1.default.isAbsolute(profilePath)
-        ? node_path_1.default.resolve(profilePath)
-        : node_path_1.default.resolve(profileRoot, profilePath);
-    const normalizedRoot = ensureTrailingSep(node_path_1.default.resolve(profileRoot));
+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(profileRoot)) {
-        throw new Error(`remote_source profilePath must stay under ${profileRoot}`);
+    if (!normalizedResolved.startsWith(normalizedRoot) && normalizedResolved !== node_path_1.default.resolve(moduleRoot)) {
+        throw new Error(`remote_source modulePath must stay under ${moduleRoot}`);
     }
     return normalizedResolved;
 }
@@ -129,8 +133,14 @@ function asNonEmptyString(value) {
     const trimmed = value.trim();
     return trimmed.length > 0 ? trimmed : null;
 }
-const GITHUB_REPO_PROFILE = {
+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 {
@@ -193,6 +203,54 @@ const GITHUB_REPO_PROFILE = {
     deriveTrackedResource(filter) {
         return (0, github_1.deriveGithubTrackedResource)(filter);
     },
+    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;
+    },
+    summarizeDigestThread(items, _source, grouping) {
+        if (!grouping.summaryHint || items.length === 0) {
+            return null;
+        }
+        const count = items.length;
+        return `${count} ${grouping.summaryHint}`;
+    },
     projectLifecycleSignal(rawPayload) {
         return (0, github_1.projectGithubLifecycleSignal)(rawPayload);
     },
@@ -238,7 +296,7 @@ const GITHUB_REPO_PROFILE = {
         };
     },
 };
-const GITHUB_REPO_CI_PROFILE = {
+const GITHUB_REPO_CI_MODULE = {
     id: "builtin.github_repo_ci",
     describeCapabilities() {
         return {
@@ -298,6 +356,27 @@ const GITHUB_REPO_CI_PROFILE = {
         }
         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);
     },
@@ -349,8 +428,14 @@ const GITHUB_REPO_CI_PROFILE = {
         };
     },
 };
-const FEISHU_BOT_PROFILE = {
+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",
@@ -409,10 +494,10 @@ const FEISHU_BOT_PROFILE = {
         };
     },
 };
-function profileConfigForSource(source) {
+function moduleConfigForSource(source) {
     const config = asRecord(source.config);
     if (source.sourceType === "remote_source") {
-        return asRecord(config.profileConfig);
+        return asRecord(config.moduleConfig);
     }
     return config;
 }