@holon-run/agentinbox 1.0.0-beta.2 → 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)({

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

@@ -382,6 +382,11 @@ function expandGithubSubscriptionShortcut(input) {
             ...(withCi
                 ? [{
                         streamKind: "ci_runs",
+                        filter: {
+                            metadata: {
+                                pullRequestNumbers: [number],
+                            },
+                        },
                         trackedResourceRef,
                         cleanupPolicy: { mode: "on_terminal" },
                     }]

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_modules.js

@@ -324,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.2",
+  "version": "1.0.0-beta.3",
   "description": "Local event subscription and delivery service for agents.",
   "license": "Apache-2.0",
   "repository": {