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

package/dist/src/cli.js

@@ -871,7 +871,7 @@ async function printCurrentAgent(client) {
     const records = await listAgentsWithTargets(client);
     const current = (0, current_agent_1.resolveCurrentAgent)(records, context);
     if (!current) {
-        throw new Error("no current agent is registered for this terminal/runtime context; run `agentinbox agent register`");
+        throw new Error(noCurrentAgentMessage());
     }
     console.log((0, util_1.jsonResponse)(current));
 }
@@ -907,7 +907,7 @@ async function selectAgentForCommand(client, options) {
         };
     }
     if (!options.autoRegister) {
-        throw new Error("no current agent is registered for this terminal/runtime context; run `agentinbox agent register`");
+        throw new Error(noCurrentAgentMessage());
     }
     await requestRemote(client, "/agents", {
         backend: contextForCurrent.backend,
@@ -946,6 +946,9 @@ async function requestRemote(client, endpoint, body, method = "POST") {
     }
     return { data: response.data };
 }
+function noCurrentAgentMessage() {
+    return "no current agent is registered for this terminal/runtime context; run `agentinbox agent list` to inspect offline agents, then `agentinbox agent register` or `agentinbox agent register --force-rebind --agent-id <agentId>` to rebind one";
+}
 function takeFlagValue(args, flag) {
     const index = args.indexOf(flag);
     if (index === -1) {

package/dist/src/current_agent.js

@@ -39,6 +39,9 @@ function resolveCurrentAgent(agents, context) {
         matchesCurrentTerminal: matchesCurrentTerminal(agent, context),
         matchesCurrentRuntime: matchesCurrentRuntime(agent, context),
         terminalIdentity: terminalIdentityForAgent(agent),
+        notifyCapable: notifyCapableForAgent(agent),
+        activeTargetCount: activeActivationTargetCount(agent),
+        offlineTargetCount: offlineActivationTargetCount(agent),
     };
 }
 function annotateAgents(agents, context) {
@@ -52,24 +55,27 @@ function annotateAgents(agents, context) {
             matchesCurrentRuntime: context ? matchesCurrentRuntime(entry, context) : false,
             terminalIdentity: terminalIdentityForAgent(entry),
             isCurrent: current?.agentId === entry.agent.agentId,
+            notifyCapable: notifyCapableForAgent(entry),
+            activeTargetCount: activeActivationTargetCount(entry),
+            offlineTargetCount: offlineActivationTargetCount(entry),
         })),
     };
 }
 function resolveAgentRecord(agents, context) {
     if (context.tmuxPaneId) {
-        const match = agents.find((agent) => activeTerminalTargets(agent).some((target) => target.backend === "tmux" && target.tmuxPaneId === context.tmuxPaneId));
+        const match = agents.find((agent) => terminalTargetsForCurrentMatch(agent).some((target) => target.backend === "tmux" && target.tmuxPaneId === context.tmuxPaneId));
         if (match) {
             return match;
         }
     }
     if (context.itermSessionId) {
-        const match = agents.find((agent) => activeTerminalTargets(agent).some((target) => target.backend === "iterm2" && target.itermSessionId === context.itermSessionId));
+        const match = agents.find((agent) => terminalTargetsForCurrentMatch(agent).some((target) => target.backend === "iterm2" && target.itermSessionId === context.itermSessionId));
         if (match) {
             return match;
         }
     }
     if (context.tty) {
-        const match = agents.find((agent) => activeTerminalTargets(agent).some((target) => target.tty === context.tty));
+        const match = agents.find((agent) => terminalTargetsForCurrentMatch(agent).some((target) => target.tty === context.tty));
         if (match) {
             return match;
         }
@@ -94,6 +100,18 @@ function activeTerminalTargets(agent) {
     }
     return terminalTargets(agent).filter((target) => target.status === "active");
 }
+function terminalTargetsForCurrentMatch(agent) {
+    return activeTerminalTargets(agent);
+}
+function activeActivationTargetCount(agent) {
+    return agent.activationTargets.filter((target) => target.status === "active").length;
+}
+function offlineActivationTargetCount(agent) {
+    return agent.activationTargets.filter((target) => target.status === "offline").length;
+}
+function notifyCapableForAgent(agent) {
+    return agent.agent.status === "active" && activeActivationTargetCount(agent) > 0;
+}
 function terminalIdentityForAgent(agent) {
     const target = activeTerminalTargets(agent)[0];
     if (!target) {
@@ -111,7 +129,7 @@ function terminalIdentityForAgent(agent) {
     return null;
 }
 function matchesCurrentTerminal(agent, context) {
-    return activeTerminalTargets(agent).some((target) => (context.tmuxPaneId != null && target.tmuxPaneId === context.tmuxPaneId)
+    return terminalTargetsForCurrentMatch(agent).some((target) => (context.tmuxPaneId != null && target.tmuxPaneId === context.tmuxPaneId)
         || (context.itermSessionId != null && target.itermSessionId === context.itermSessionId)
         || (context.tty != null && target.tty === context.tty));
 }

package/dist/src/service.js

@@ -505,7 +505,7 @@ class AgentInboxService {
         return { removed: true };
     }
     registerTimer(input) {
-        this.getAgent(input.agentId);
+        this.assertAgentNotifyCapable(input.agentId, "timer add");
         const normalized = normalizeTimerInput(input);
         const timezone = normalized.timezone ?? detectHostTimezone();
         assertValidTimeZone(timezone);
@@ -794,7 +794,7 @@ class AgentInboxService {
         return sibling;
     }
     async registerSingleSubscription(input) {
-        this.getAgent(input.agentId);
+        this.assertAgentNotifyCapable(input.agentId, "subscription add");
         const source = this.store.getSource(input.sourceId);
         if (!source) {
             throw new Error(`unknown source: ${input.sourceId}`);
@@ -1595,6 +1595,19 @@ class AgentInboxService {
             watcher.onItems(items);
         }
     }
+    assertAgentNotifyCapable(agentId, operation) {
+        this.getAgent(agentId);
+        const targets = this.store.listActivationTargetsForAgent(agentId);
+        const activeTargetCount = targets.filter((target) => target.status === "active").length;
+        if (activeTargetCount > 0) {
+            return;
+        }
+        const offlineTargetCount = targets.filter((target) => target.status === "offline").length;
+        const targetSummary = targets.length === 0
+            ? "it has no activation targets"
+            : `all ${offlineTargetCount} activation target(s) are offline`;
+        throw new Error(`agent ${agentId} is not notify-capable: ${targetSummary}; refusing ${operation} to avoid a silent notification black hole. Rebind with \`agentinbox agent register --force-rebind --agent-id ${agentId}\` or resume/add a target first.`);
+    }
     resolveAutoAgentId(input) {
         for (let attempt = 0; attempt < 32; attempt += 1) {
             const candidate = (0, terminal_1.assignedAgentIdFromContext)({
@@ -1784,6 +1797,11 @@ class AgentInboxService {
         buffer.inFlight = true;
         const entries = buffer.pending.splice(0, buffer.pending.length);
         try {
+            if (!this.activationTargetExists(buffer.agentId, buffer.targetId)) {
+                this.notificationBuffers.delete(key);
+                buffer.inFlight = false;
+                return;
+            }
             const state = this.store.getActivationDispatchState(buffer.agentId, buffer.targetId);
             const shouldAttemptDispatch = !state || (state.status === "dirty" && state.leaseExpiresAt == null);
             if (shouldAttemptDispatch) {
@@ -1921,7 +1939,11 @@ class AgentInboxService {
         if (!state) {
             return;
         }
-        const target = this.getActivationTarget(targetId);
+        const target = this.getActivationTargetIfExists(agentId, targetId);
+        if (!target) {
+            this.store.deleteActivationDispatchState(agentId, targetId);
+            return;
+        }
         const inbox = this.ensureInboxForAgent(agentId);
         const unacked = this.store.listInboxEntries(inbox.inboxId, { includeAcked: false }).length;
         if (unacked === 0) {
@@ -1988,7 +2010,10 @@ class AgentInboxService {
         }
     }
     async dispatchActivationTarget(input) {
-        const target = this.getActivationTarget(input.targetId);
+        const target = this.getActivationTargetIfExists(input.agentId, input.targetId);
+        if (!target) {
+            return "offline";
+        }
         if (target.status === "offline") {
             return "offline";
         }
@@ -2029,6 +2054,9 @@ class AgentInboxService {
         try {
             if (target.kind === "terminal") {
                 const gate = await this.activationGate.evaluate(target);
+                if (!this.activationTargetExists(input.agentId, input.targetId)) {
+                    return "offline";
+                }
                 this.logger.debug("activation.gate_decision", {
                     agentId: input.agentId,
                     targetId: target.targetId,
@@ -2049,6 +2077,9 @@ class AgentInboxService {
                     return "offline";
                 }
                 const reminder = await this.buildTerminalReminder(target, inbox.inboxId, totalUnackedCount, input.summary, input.entries);
+                if (!this.activationTargetExists(input.agentId, input.targetId)) {
+                    return "offline";
+                }
                 const prompt = reminder.prompt;
                 const promptFingerprint = reminder.fingerprint;
                 terminalPrompt = prompt;
@@ -2134,6 +2165,9 @@ class AgentInboxService {
                     subscriptionIds: input.subscriptionIds,
                 });
                 await this.terminalDispatcher.dispatch(target, prompt);
+                if (!this.activationTargetExists(input.agentId, input.targetId)) {
+                    return "offline";
+                }
                 this.logger.debug("activation.terminal_dispatch_succeeded", {
                     agentId: input.agentId,
                     targetId: target.targetId,
@@ -2162,6 +2196,9 @@ class AgentInboxService {
                     deliveredAt: null,
                 };
                 await this.activationDispatcher.dispatch(target.url, activation);
+                if (!this.activationTargetExists(input.agentId, input.targetId)) {
+                    return "offline";
+                }
                 this.store.insertActivation(activation);
             }
             this.markActivationTargetDelivered(target.targetId);
@@ -2196,8 +2233,14 @@ class AgentInboxService {
                 error,
                 message,
             });
+            if (!this.activationTargetExists(input.agentId, input.targetId)) {
+                return "offline";
+            }
             if (target.kind === "terminal") {
                 const exists = await this.terminalDispatcher.probe(target);
+                if (!this.activationTargetExists(input.agentId, input.targetId)) {
+                    return "offline";
+                }
                 this.logger.debug("activation.terminal_probe_after_failure", {
                     agentId: input.agentId,
                     targetId: target.targetId,
@@ -2219,6 +2262,19 @@ class AgentInboxService {
             return "retryable_failure";
         }
     }
+    getActivationTargetIfExists(agentId, targetId) {
+        if (!this.store.getAgent(agentId)) {
+            return null;
+        }
+        const target = this.store.getActivationTarget(targetId);
+        if (!target || target.agentId !== agentId) {
+            return null;
+        }
+        return target;
+    }
+    activationTargetExists(agentId, targetId) {
+        return this.getActivationTargetIfExists(agentId, targetId) != null;
+    }
     upsertDirtyDispatchState(agentId, targetId, entries) {
         this.store.upsertActivationDispatchState({
             agentId,

package/dist/src/source_schema.js

@@ -89,6 +89,7 @@ const SOURCE_SCHEMAS = {
             { name: "event", type: "string|null", description: "GitHub trigger event for the workflow run." },
             { name: "headBranch", type: "string|null", description: "Head branch for the workflow run." },
             { name: "headSha", type: "string|null", description: "Head commit SHA for the workflow run." },
+            { name: "pullRequestNumbers", type: "number[]", description: "Pull request numbers associated with the workflow run." },
             { name: "actor", type: "string|null", description: "Actor login for the workflow run." },
             { name: "commitMessage", type: "string|null", description: "Head commit message when present." },
             { name: "htmlUrl", type: "string|null", description: "GitHub Actions run URL." },
@@ -101,6 +102,7 @@ const SOURCE_SCHEMAS = {
                 conclusion: "failure",
                 event: "pull_request",
                 head_branch: "main",
+                pull_requests: [{ number: 93 }],
                 actor: "jolestar",
                 head_commit: { message: "fix ci" },
             },

package/dist/src/sources/github.js

@@ -4,6 +4,7 @@ exports.GithubDeliveryAdapter = exports.GithubUxcClient = exports.DEFAULT_GITHUB
 exports.githubDeliveryOperationsForHandle = githubDeliveryOperationsForHandle;
 exports.invokeGithubDeliveryOperation = invokeGithubDeliveryOperation;
 exports.normalizeGithubRepoEvent = normalizeGithubRepoEvent;
+exports.hydrateGithubRepoEventIfNeeded = hydrateGithubRepoEventIfNeeded;
 exports.canonicalGithubPullRequestRef = canonicalGithubPullRequestRef;
 exports.deriveGithubTrackedResource = deriveGithubTrackedResource;
 exports.githubSubscriptionShortcutSpec = githubSubscriptionShortcutSpec;
@@ -12,6 +13,14 @@ exports.projectGithubLifecycleSignal = projectGithubLifecycleSignal;
 exports.parseGithubSourceConfig = parseGithubSourceConfig;
 const uxc_daemon_client_1 = require("@holon-run/uxc-daemon-client");
 exports.GITHUB_ENDPOINT = "https://api.github.com";
+const DEFAULT_GITHUB_CALL_CLIENT = new uxc_daemon_client_1.UxcDaemonClient({ env: process.env });
+const GITHUB_EVENT_HYDRATION_MIN_PER_PAGE = 10;
+const GITHUB_EVENT_HYDRATION_MAX_PER_PAGE = 30;
+const GITHUB_EVENT_HYDRATION_MAX_PAGES = 3;
+const HYDRATABLE_GITHUB_REPO_EVENT_TYPES = new Set([
+    "PullRequestReviewEvent",
+    "PullRequestReviewCommentEvent",
+]);
 exports.DEFAULT_GITHUB_EVENT_TYPES = [
     "IssuesEvent",
     "IssueCommentEvent",
@@ -21,7 +30,7 @@ exports.DEFAULT_GITHUB_EVENT_TYPES = [
 ];
 class GithubUxcClient {
     client;
-    constructor(client = new uxc_daemon_client_1.UxcDaemonClient({ env: process.env })) {
+    constructor(client = DEFAULT_GITHUB_CALL_CLIENT) {
         this.client = client;
     }
     async createIssueComment(input) {
@@ -222,7 +231,7 @@ function normalizeGithubRepoEvent(source, config, raw) {
     if (!eventType || !(config.eventTypes ?? exports.DEFAULT_GITHUB_EVENT_TYPES).includes(eventType)) {
         return null;
     }
-    const eventId = asString(event.id);
+    const eventId = asIdString(event.id);
     if (!eventId) {
         return null;
     }
@@ -234,18 +243,17 @@ function normalizeGithubRepoEvent(source, config, raw) {
     const review = asRecord(payload.review);
     const comment = asRecord(payload.comment);
     const action = asString(payload.action) ?? "observed";
-    const number = asNumber(issue.number) ?? asNumber(pullRequest.number);
+    const url = extractGithubRepoEventUrl(event, issue, pullRequest, review, comment);
+    const number = asNumber(issue.number)
+        ?? asNumber(pullRequest.number)
+        ?? asNumber(payload.number)
+        ?? extractGithubNumberFromUrl(url);
     const isPullRequest = eventType.startsWith("PullRequest");
     const title = asString(issue.title) ?? asString(pullRequest.title) ?? null;
     const reviewState = asString(review.state) ?? null;
     const body = asString(comment.body) ?? asString(review.body) ?? asString(issue.body) ?? asString(pullRequest.body) ?? null;
     const labels = extractLabels(issue.labels);
     const mentions = extractMentions(title, body);
-    const url = asString(comment.html_url) ??
-        asString(review.html_url) ??
-        asString(issue.html_url) ??
-        asString(pullRequest.html_url) ??
-        asString(event.url);
     const deliveryHandle = buildGithubDeliveryHandle(config, eventType, number, comment);
     return {
         sourceId: source.sourceId,
@@ -283,6 +291,47 @@ function normalizeGithubRepoEvent(source, config, raw) {
         deliveryHandle,
     };
 }
+async function hydrateGithubRepoEventIfNeeded(config, raw, client = DEFAULT_GITHUB_CALL_CLIENT) {
+    if (!shouldHydrateGithubRepoEvent(raw)) {
+        return raw;
+    }
+    const eventId = asIdString(raw.id);
+    if (!eventId) {
+        return raw;
+    }
+    const perPage = computeGithubHydrationPerPage(config.perPage);
+    for (let page = 1; page <= GITHUB_EVENT_HYDRATION_MAX_PAGES; page += 1) {
+        let response;
+        try {
+            response = await client.call({
+                endpoint: exports.GITHUB_ENDPOINT,
+                operation: "get:/repos/{owner}/{repo}/events",
+                payload: {
+                    owner: config.owner,
+                    repo: config.repo,
+                    per_page: perPage,
+                    page,
+                },
+                options: { auth: config.uxcAuth },
+            });
+        }
+        catch {
+            return raw;
+        }
+        const candidates = Array.isArray(response.data) ? response.data : [];
+        if (candidates.length === 0) {
+            break;
+        }
+        for (const candidateValue of candidates) {
+            const candidate = asRecord(candidateValue);
+            if (asIdString(candidate.id) !== eventId) {
+                continue;
+            }
+            return hasGithubRepoEventMetadata(candidate) ? candidate : raw;
+        }
+    }
+    return raw;
+}
 function canonicalGithubPullRequestRef(source, number) {
     const config = parseGithubSourceConfig(source);
     return `repo:${config.owner}/${config.repo}:pr:${number}`;
@@ -333,6 +382,11 @@ function expandGithubSubscriptionShortcut(input) {
             ...(withCi
                 ? [{
                         streamKind: "ci_runs",
+                        filter: {
+                            metadata: {
+                                pullRequestNumbers: [number],
+                            },
+                        },
                         trackedResourceRef,
                         cleanupPolicy: { mode: "on_terminal" },
                     }]
@@ -433,6 +487,64 @@ function extractMentions(...values) {
     }
     return Array.from(seen.values()).sort();
 }
+function computeGithubHydrationPerPage(perPage) {
+    const configured = Number.isInteger(perPage) && perPage && perPage > 0
+        ? perPage
+        : GITHUB_EVENT_HYDRATION_MIN_PER_PAGE;
+    return Math.min(GITHUB_EVENT_HYDRATION_MAX_PER_PAGE, Math.max(GITHUB_EVENT_HYDRATION_MIN_PER_PAGE, configured));
+}
+function extractGithubRepoEventUrl(event, issue, pullRequest, review, comment) {
+    return (asString(comment.html_url)
+        ?? asString(review.html_url)
+        ?? asString(issue.html_url)
+        ?? asString(pullRequest.html_url)
+        ?? asString(comment.pull_request_url)
+        ?? asString(review.pull_request_url)
+        ?? asString(event.url));
+}
+function extractGithubNumberFromUrl(url) {
+    if (!url) {
+        return null;
+    }
+    const match = url.match(/\/(?:pull|pulls|issues)\/(\d+)(?:$|[/?#])/);
+    return match ? Number(match[1]) : null;
+}
+function shouldHydrateGithubRepoEvent(raw) {
+    const eventType = asString(raw.type);
+    if (!eventType || !HYDRATABLE_GITHUB_REPO_EVENT_TYPES.has(eventType)) {
+        return false;
+    }
+    const payload = asRecord(raw.payload);
+    const issue = asRecord(payload.issue);
+    const pullRequest = asRecord(payload.pull_request);
+    const review = asRecord(payload.review);
+    const comment = asRecord(payload.comment);
+    const url = extractGithubRepoEventUrl(raw, issue, pullRequest, review, comment);
+    const number = asNumber(issue.number)
+        ?? asNumber(pullRequest.number)
+        ?? asNumber(payload.number)
+        ?? extractGithubNumberFromUrl(url);
+    if (number) {
+        return false;
+    }
+    return [pullRequest, review, comment].some(isUxcPreviewTruncatedObject);
+}
+function hasGithubRepoEventMetadata(raw) {
+    const payload = asRecord(raw.payload);
+    const issue = asRecord(payload.issue);
+    const pullRequest = asRecord(payload.pull_request);
+    const review = asRecord(payload.review);
+    const comment = asRecord(payload.comment);
+    return Boolean(asNumber(issue.number)
+        ?? asNumber(pullRequest.number)
+        ?? asNumber(payload.number)
+        ?? extractGithubNumberFromUrl(extractGithubRepoEventUrl(raw, issue, pullRequest, review, comment))
+        ?? asString(review.state)
+        ?? extractGithubRepoEventUrl(raw, issue, pullRequest, review, comment));
+}
+function isUxcPreviewTruncatedObject(value) {
+    return value._uxc_preview_truncated === true;
+}
 function parseTargetRef(targetRef) {
     const match = targetRef.match(/^([^/]+)\/([^#]+)#(\d+)$/);
     if (!match) {
@@ -495,6 +607,15 @@ function asRecord(value) {
 function asString(value) {
     return typeof value === "string" ? value : null;
 }
+function asIdString(value) {
+    if (typeof value === "string") {
+        return value;
+    }
+    if (typeof value === "number" && Number.isFinite(value)) {
+        return String(value);
+    }
+    return null;
+}
 function asNumber(value) {
     return typeof value === "number" ? value : null;
 }

package/dist/src/sources/github_ci.js

@@ -240,6 +240,7 @@ function normalizeGithubWorkflowRunEvent(source, config, raw) {
     const variant = buildWorkflowRunVariant(workflowName, status, conclusion);
     const actor = asRecord(run.actor);
     const headCommit = asRecord(run.head_commit);
+    const pullRequestNumbers = extractPullRequestNumbers(run.pull_requests);
     return {
         sourceId: source.sourceId,
         sourceNativeId: `workflow_run:${runId}`,
@@ -259,6 +260,7 @@ function normalizeGithubWorkflowRunEvent(source, config, raw) {
             event: asString(run.event),
             headSha: asString(run.head_sha),
             headBranch: asString(run.head_branch),
+            pullRequestNumbers,
             runNumber: asNumber(run.run_number),
             runAttempt: asNumber(run.run_attempt),
             actor: asString(actor.login),
@@ -277,6 +279,7 @@ function normalizeGithubWorkflowRunEvent(source, config, raw) {
             event: asString(run.event),
             head_sha: asString(run.head_sha),
             head_branch: asString(run.head_branch),
+            pull_requests: pullRequestNumbers.map((number) => ({ number })),
             run_number: asNumber(run.run_number),
             run_attempt: asNumber(run.run_attempt),
             html_url: asString(run.html_url),
@@ -343,6 +346,19 @@ function asString(value) {
 function asNumber(value) {
     return typeof value === "number" && Number.isFinite(value) ? value : null;
 }
+function extractPullRequestNumbers(value) {
+    if (!Array.isArray(value)) {
+        return [];
+    }
+    const numbers = new Set();
+    for (const entry of value) {
+        const number = asNumber(asRecord(entry).number);
+        if (number && Number.isInteger(number) && number > 0) {
+            numbers.add(number);
+        }
+    }
+    return Array.from(numbers).sort((left, right) => left - right);
+}
 function inferWorkflowRunStatus(run, conclusion) {
     return asString(run.status)
         ?? (conclusion ? "completed" : null)

package/dist/src/sources/remote.js

@@ -300,7 +300,7 @@ class RemoteSourceRuntime {
                 if (Object.keys(rawPayload).length === 0) {
                     continue;
                 }
-                const mapped = module.mapRawEvent(rawPayload, moduleSource);
+                const mapped = await module.mapRawEvent(rawPayload, moduleSource);
                 if (!mapped) {
                     continue;
                 }

package/dist/src/sources/remote_modules.js

@@ -5,6 +5,7 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.RemoteSourceModuleRegistry = void 0;
 exports.builtInModuleIdForSourceType = builtInModuleIdForSourceType;
+exports.createGithubRepoRemoteModule = createGithubRepoRemoteModule;
 exports.moduleConfigForSource = moduleConfigForSource;
 const node_fs_1 = __importDefault(require("node:fs"));
 const node_path_1 = __importDefault(require("node:path"));
@@ -133,169 +134,173 @@ function asNonEmptyString(value) {
     const trimmed = value.trim();
     return trimmed.length > 0 ? trimmed : null;
 }
-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 {
-            sourceKind: "github_repo",
-            aliases: ["github_repo"],
-            configSchema: [
-                { name: "owner", type: "string", required: true, description: "GitHub repository owner." },
-                { name: "repo", type: "string", required: true, description: "GitHub repository name." },
-                { name: "uxcAuth", type: "string", required: false, description: "Optional uxc auth profile." },
-                { name: "eventTypes", type: "string[]", required: false, description: "Optional GitHub event type allowlist." },
-                { name: "perPage", type: "number", required: false, description: `Repository events requested per poll. Default ${config.perPage ?? 10}.` },
-                { name: "pollIntervalSecs", type: "number", required: false, description: `Polling interval in seconds. Default ${config.pollIntervalSecs ?? 30}.` },
-            ],
-            metadataFields: [
-                { name: "eventType", type: "string", description: "GitHub event type such as IssueCommentEvent." },
-                { name: "action", type: "string", description: "GitHub event action suffix such as created." },
-                { name: "author", type: "string|null", description: "Actor login for the event." },
-                { name: "isPullRequest", type: "boolean", description: "Whether the event targets a pull request surface." },
-                { name: "reviewState", type: "string|null", description: "Review decision state for PullRequestReviewEvent such as approved or changes_requested." },
-                { name: "labels", type: "string[]", description: "Labels extracted from the issue or pull request." },
-                { name: "mentions", type: "string[]", description: "Mention handles extracted from title/body/comment text." },
-                { name: "number", type: "number|null", description: "Issue or pull request number when present." },
-                { name: "repoFullName", type: "string", description: "Repository full name in owner/repo form." },
-                { name: "title", type: "string|null", description: "Issue, pull request, or comment title." },
-                { name: "body", type: "string|null", description: "Issue, pull request, or comment body text." },
-                { name: "url", type: "string|null", description: "Primary GitHub HTML URL for the event target." },
-            ],
-            payloadExamples: [
-                {
-                    id: "1234567891",
-                    type: "PullRequestReviewEvent",
-                    action: "created",
-                    actor: "Copilot",
-                    pull_request: { number: 67, title: "feat: add remote module capability hooks" },
-                    review: { state: "commented", body: "review summary" },
-                },
-                {
-                    id: "1234567892",
-                    type: "PullRequestEvent",
-                    action: "closed",
-                    actor: "jolestar",
-                    pull_request: { number: 72, title: "feat: add cleanup policy lifecycle engine", merged: true },
-                },
-            ],
-            eventVariantExamples: [
-                "IssueCommentEvent.created",
-                "PullRequestEvent.opened",
-                "PullRequestEvent.closed",
-                "PullRequestReviewEvent.created",
-                "PullRequestReviewCommentEvent.created",
-            ],
-        };
-    },
-    listSubscriptionShortcuts() {
-        return (0, github_1.githubSubscriptionShortcutSpec)();
-    },
-    expandSubscriptionShortcut(input) {
-        return (0, github_1.expandGithubSubscriptionShortcut)(input);
-    },
-    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.")) {
+function createGithubRepoRemoteModule(options) {
+    return {
+        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 {
-                groupable: true,
-                resourceRef: `pr:${number}`,
-                eventFamily: "reviews",
-                summaryHint: `reviews on PR #${number}`,
+                sourceKind: "github_repo",
+                aliases: ["github_repo"],
+                configSchema: [
+                    { name: "owner", type: "string", required: true, description: "GitHub repository owner." },
+                    { name: "repo", type: "string", required: true, description: "GitHub repository name." },
+                    { name: "uxcAuth", type: "string", required: false, description: "Optional uxc auth profile." },
+                    { name: "eventTypes", type: "string[]", required: false, description: "Optional GitHub event type allowlist." },
+                    { name: "perPage", type: "number", required: false, description: `Repository events requested per poll. Default ${config.perPage ?? 10}.` },
+                    { name: "pollIntervalSecs", type: "number", required: false, description: `Polling interval in seconds. Default ${config.pollIntervalSecs ?? 30}.` },
+                ],
+                metadataFields: [
+                    { name: "eventType", type: "string", description: "GitHub event type such as IssueCommentEvent." },
+                    { name: "action", type: "string", description: "GitHub event action suffix such as created." },
+                    { name: "author", type: "string|null", description: "Actor login for the event." },
+                    { name: "isPullRequest", type: "boolean", description: "Whether the event targets a pull request surface." },
+                    { name: "reviewState", type: "string|null", description: "Review decision state for PullRequestReviewEvent such as approved or changes_requested." },
+                    { name: "labels", type: "string[]", description: "Labels extracted from the issue or pull request." },
+                    { name: "mentions", type: "string[]", description: "Mention handles extracted from title/body/comment text." },
+                    { name: "number", type: "number|null", description: "Issue or pull request number when present." },
+                    { name: "repoFullName", type: "string", description: "Repository full name in owner/repo form." },
+                    { name: "title", type: "string|null", description: "Issue, pull request, or comment title." },
+                    { name: "body", type: "string|null", description: "Issue, pull request, or comment body text." },
+                    { name: "url", type: "string|null", description: "Primary GitHub HTML URL for the event target." },
+                ],
+                payloadExamples: [
+                    {
+                        id: "1234567891",
+                        type: "PullRequestReviewEvent",
+                        action: "created",
+                        actor: "Copilot",
+                        pull_request: { number: 67, title: "feat: add remote module capability hooks" },
+                        review: { state: "commented", body: "review summary" },
+                    },
+                    {
+                        id: "1234567892",
+                        type: "PullRequestEvent",
+                        action: "closed",
+                        actor: "jolestar",
+                        pull_request: { number: 72, title: "feat: add cleanup policy lifecycle engine", merged: true },
+                    },
+                ],
+                eventVariantExamples: [
+                    "IssueCommentEvent.created",
+                    "PullRequestEvent.opened",
+                    "PullRequestEvent.closed",
+                    "PullRequestReviewEvent.created",
+                    "PullRequestReviewCommentEvent.created",
+                ],
             };
-        }
-        if (variant.startsWith("IssueCommentEvent.")) {
+        },
+        listSubscriptionShortcuts() {
+            return (0, github_1.githubSubscriptionShortcutSpec)();
+        },
+        expandSubscriptionShortcut(input) {
+            return (0, github_1.expandGithubSubscriptionShortcut)(input);
+        },
+        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;
+        },
+        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);
+        },
+        buildManagedSourceSpec(source) {
+            const config = (0, github_1.parseGithubSourceConfig)(source);
             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}`,
+                endpoint: github_1.GITHUB_ENDPOINT,
+                operation_id: "get:/repos/{owner}/{repo}/events",
+                args: {
+                    owner: config.owner,
+                    repo: config.repo,
+                    per_page: config.perPage ?? 10,
+                },
+                mode: "poll",
+                poll_config: {
+                    interval_secs: config.pollIntervalSecs ?? 30,
+                    extract_items_pointer: "",
+                    checkpoint_strategy: {
+                        type: "item_key",
+                        item_key_pointer: "/id",
+                        seen_window: 1024,
+                    },
+                },
+                options: { auth: config.uxcAuth },
             };
-        }
-        if (variant.startsWith("PullRequestEvent.closed")) {
+        },
+        async mapRawEvent(rawPayload, source) {
+            const config = (0, github_1.parseGithubSourceConfig)(source);
+            const hydratedPayload = await (0, github_1.hydrateGithubRepoEventIfNeeded)(config, rawPayload, options?.callClient);
+            const normalized = (0, github_1.normalizeGithubRepoEvent)(source, config, hydratedPayload);
+            if (!normalized) {
+                return null;
+            }
             return {
-                groupable: true,
-                resourceRef: `pr:${number}`,
-                eventFamily: "lifecycle",
-                summaryHint: `PR #${number} lifecycle updates`,
-                flushClass: "immediate",
+                sourceNativeId: normalized.sourceNativeId,
+                eventVariant: normalized.eventVariant,
+                metadata: normalized.metadata ?? {},
+                rawPayload: normalized.rawPayload ?? hydratedPayload,
+                occurredAt: normalized.occurredAt,
+                deliveryHandle: normalized.deliveryHandle,
             };
-        }
-        return null;
-    },
-    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);
-    },
-    buildManagedSourceSpec(source) {
-        const config = (0, github_1.parseGithubSourceConfig)(source);
-        return {
-            endpoint: github_1.GITHUB_ENDPOINT,
-            operation_id: "get:/repos/{owner}/{repo}/events",
-            args: {
-                owner: config.owner,
-                repo: config.repo,
-                per_page: config.perPage ?? 10,
-            },
-            mode: "poll",
-            poll_config: {
-                interval_secs: config.pollIntervalSecs ?? 30,
-                extract_items_pointer: "",
-                checkpoint_strategy: {
-                    type: "item_key",
-                    item_key_pointer: "/id",
-                    seen_window: 1024,
-                },
-            },
-            options: { auth: config.uxcAuth },
-        };
-    },
-    mapRawEvent(rawPayload, source) {
-        const config = (0, github_1.parseGithubSourceConfig)(source);
-        const normalized = (0, github_1.normalizeGithubRepoEvent)(source, config, rawPayload);
-        if (!normalized) {
-            return null;
-        }
-        return {
-            sourceNativeId: normalized.sourceNativeId,
-            eventVariant: normalized.eventVariant,
-            metadata: normalized.metadata ?? {},
-            rawPayload: normalized.rawPayload ?? rawPayload,
-            occurredAt: normalized.occurredAt,
-            deliveryHandle: normalized.deliveryHandle,
-        };
-    },
-};
+        },
+    };
+}
+const GITHUB_REPO_MODULE = createGithubRepoRemoteModule();
 const GITHUB_REPO_CI_MODULE = {
     id: "builtin.github_repo_ci",
     describeCapabilities() {
@@ -319,6 +324,7 @@ const GITHUB_REPO_CI_MODULE = {
                 { name: "event", type: "string|null", description: "GitHub trigger event for the workflow run." },
                 { name: "headBranch", type: "string|null", description: "Head branch for the workflow run." },
                 { name: "headSha", type: "string|null", description: "Head commit SHA for the workflow run." },
+                { name: "pullRequestNumbers", type: "number[]", description: "Pull request numbers associated with the workflow run." },
                 { name: "actor", type: "string|null", description: "Actor login for the workflow run." },
                 { name: "commitMessage", type: "string|null", description: "Head commit message when present." },
                 { name: "htmlUrl", type: "string|null", description: "GitHub Actions run URL." },

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@holon-run/agentinbox",
-  "version": "1.0.0-beta.1",
+  "version": "1.0.0-beta.3",
   "description": "Local event subscription and delivery service for agents.",
   "license": "Apache-2.0",
   "repository": {