@holon-run/agentinbox 0.1.0 → 0.1.3

package/dist/src/cli.js

@@ -9,6 +9,7 @@ const node_path_1 = __importDefault(require("node:path"));
 const adapters_1 = require("./adapters");
 const client_1 = require("./client");
 const control_server_1 = require("./control_server");
+const current_agent_1 = require("./current_agent");
 const daemon_1 = require("./daemon");
 const http_1 = require("./http");
 const paths_1 = require("./paths");
@@ -54,10 +55,10 @@ async function main() {
         if (!type || !sourceKey) {
             throw new Error("usage: agentinbox source add <type> <sourceKey> [--config-json JSON] [--config-ref REF]");
         }
-        await printRemote(client, "/sources/register", {
+        await printRemote(client, "/sources", {
             sourceType: type,
             sourceKey,
-            configRef: takeFlagValue(normalized, "--config-ref") ?? null,
+            configRef: takeFlagValue(normalized, "--config-ref") ?? undefined,
             config: (0, util_1.parseJsonArg)(takeFlagValue(normalized, "--config-json")),
         });
         return;
@@ -74,6 +75,50 @@ async function main() {
         await printRemote(client, `/sources/${encodeURIComponent(sourceId)}`, undefined, "GET");
         return;
     }
+    if (command === "source" && normalized[1] === "remove") {
+        const sourceId = normalized[2];
+        if (!sourceId) {
+            throw new Error("usage: agentinbox source remove <sourceId>");
+        }
+        await printRemote(client, `/sources/${encodeURIComponent(sourceId)}`, undefined, "DELETE");
+        return;
+    }
+    if (command === "source" && normalized[1] === "update") {
+        const sourceId = normalized[2];
+        if (!sourceId) {
+            throw new Error("usage: agentinbox source update <sourceId> [--config-json JSON] [--config-ref REF | --clear-config-ref]");
+        }
+        const configRef = takeFlagValue(normalized, "--config-ref");
+        const clearConfigRef = hasFlag(normalized, "--clear-config-ref");
+        const configJson = takeFlagValue(normalized, "--config-json");
+        if (configRef != null && clearConfigRef) {
+            throw new Error("source update accepts only one of --config-ref or --clear-config-ref");
+        }
+        if (!clearConfigRef && configRef == null && configJson == null) {
+            throw new Error("usage: agentinbox source update <sourceId> [--config-json JSON] [--config-ref REF | --clear-config-ref]");
+        }
+        await printRemote(client, `/sources/${encodeURIComponent(sourceId)}`, {
+            ...(clearConfigRef ? { configRef: null } : (configRef != null ? { configRef } : {})),
+            config: configJson != null ? (0, util_1.parseJsonArg)(configJson, "--config-json") : undefined,
+        }, "PATCH");
+        return;
+    }
+    if (command === "source" && normalized[1] === "pause") {
+        const sourceId = normalized[2];
+        if (!sourceId) {
+            throw new Error("usage: agentinbox source pause <remoteSourceId>");
+        }
+        await printRemote(client, `/sources/${encodeURIComponent(sourceId)}/pause`, {});
+        return;
+    }
+    if (command === "source" && normalized[1] === "resume") {
+        const sourceId = normalized[2];
+        if (!sourceId) {
+            throw new Error("usage: agentinbox source resume <remoteSourceId>");
+        }
+        await printRemote(client, `/sources/${encodeURIComponent(sourceId)}/resume`, {});
+        return;
+    }
     if (command === "source" && normalized[1] === "schema") {
         const sourceType = normalized[2];
         if (!sourceType) {
@@ -108,22 +153,26 @@ async function main() {
     }
     if (command === "agent" && normalized[1] === "register") {
         const detected = (0, terminal_1.detectTerminalContext)(process.env);
-        await printRemote(client, "/agents/register", {
-            agentId: takeFlagValue(normalized, "--agent-id") ?? null,
+        await printRemote(client, "/agents", {
+            agentId: takeFlagValue(normalized, "--agent-id") ?? undefined,
             forceRebind: normalized.includes("--force-rebind"),
             backend: detected.backend,
             runtimeKind: detected.runtimeKind,
-            runtimeSessionId: detected.runtimeSessionId ?? null,
-            tmuxPaneId: detected.tmuxPaneId ?? null,
-            tty: detected.tty ?? null,
-            termProgram: detected.termProgram ?? null,
-            itermSessionId: detected.itermSessionId ?? null,
-            notifyLeaseMs: parseOptionalNumber(takeFlagValue(normalized, "--notify-lease-ms")) ?? null,
+            runtimeSessionId: detected.runtimeSessionId ?? undefined,
+            tmuxPaneId: detected.tmuxPaneId ?? undefined,
+            tty: detected.tty ?? undefined,
+            termProgram: detected.termProgram ?? undefined,
+            itermSessionId: detected.itermSessionId ?? undefined,
+            notifyLeaseMs: parseOptionalNumber(takeFlagValue(normalized, "--notify-lease-ms")) ?? undefined,
         });
         return;
     }
     if (command === "agent" && normalized[1] === "list") {
-        await printRemote(client, "/agents", undefined, "GET");
+        await printAgentList(client);
+        return;
+    }
+    if (command === "agent" && normalized[1] === "current") {
+        await printCurrentAgent(client);
         return;
     }
     if (command === "agent" && normalized[1] === "show") {
@@ -152,7 +201,7 @@ async function main() {
             kind: "webhook",
             url,
             activationMode: takeFlagValue(normalized, "--activation-mode") ?? undefined,
-            notifyLeaseMs: parseOptionalNumber(takeFlagValue(normalized, "--notify-lease-ms")) ?? null,
+            notifyLeaseMs: parseOptionalNumber(takeFlagValue(normalized, "--notify-lease-ms")) ?? undefined,
         });
         return;
     }
@@ -173,18 +222,25 @@ async function main() {
         return;
     }
     if (command === "subscription" && normalized[1] === "add") {
-        const [agentId, sourceId] = normalized.slice(2, 4);
-        if (!agentId || !sourceId) {
-            throw new Error("usage: agentinbox subscription add <agentId> <sourceId> [--filter-json JSON] [--start-policy POLICY] [--start-offset N] [--start-time ISO8601]");
+        const args = normalized.slice(2);
+        const positionals = positionalArgs(args, ["--agent-id", "--filter-json", "--filter-file", "--start-policy", "--start-offset", "--start-time"]);
+        const sourceId = positionals[0];
+        if (!sourceId || positionals[1]) {
+            throw new Error("usage: agentinbox subscription add <sourceId> [--agent-id ID] [--filter-json JSON | --filter-file PATH | --filter-stdin] [--start-policy POLICY] [--start-offset N] [--start-time ISO8601]");
         }
-        await printRemote(client, "/subscriptions/register", {
-            agentId,
+        const selection = await selectAgentForCommand(client, {
+            explicitAgentId: takeFlagValue(normalized, "--agent-id"),
+            autoRegister: true,
+        });
+        const response = await requestRemote(client, "/subscriptions", {
+            agentId: selection.agentId,
             sourceId,
-            filter: (0, util_1.parseJsonArg)(takeFlagValue(normalized, "--filter-json")),
+            filter: readSubscriptionFilter(normalized),
             startPolicy: takeFlagValue(normalized, "--start-policy") ?? undefined,
             startOffset: parseOptionalNumber(takeFlagValue(normalized, "--start-offset")),
             startTime: takeFlagValue(normalized, "--start-time") ?? undefined,
         });
+        console.log((0, util_1.jsonResponse)(withCommandMetadata(response.data, selection)));
         return;
     }
     if (command === "subscription" && normalized[1] === "list") {
@@ -253,23 +309,39 @@ async function main() {
         return;
     }
     if (command === "inbox" && normalized[1] === "read") {
-        const agentId = normalized[2];
-        if (!agentId) {
-            throw new Error("usage: agentinbox inbox read <agentId>");
+        const args = normalized.slice(2);
+        const allowedFlags = ["--agent-id", "--after-item", "--include-acked"];
+        if (positionalArgs(args, ["--agent-id", "--after-item"]).length > 0 || unexpectedFlags(args, allowedFlags).length > 0) {
+            throw new Error("usage: agentinbox inbox read [--agent-id ID] [--after-item ID] [--include-acked]");
         }
+        const selection = await selectAgentForCommand(client, {
+            explicitAgentId: takeFlagValue(normalized, "--agent-id"),
+            autoRegister: true,
+        });
         const query = buildQuery({
             after_item_id: takeFlagValue(normalized, "--after-item"),
             include_acked: hasFlag(normalized, "--include-acked") ? "true" : undefined,
         });
-        await printRemote(client, `/agents/${encodeURIComponent(agentId)}/inbox/items${query}`, undefined, "GET");
+        const response = await requestRemote(client, `/agents/${encodeURIComponent(selection.agentId)}/inbox/items${query}`, undefined, "GET");
+        console.log((0, util_1.jsonResponse)(withCommandMetadata(response.data, selection)));
         return;
     }
     if (command === "inbox" && normalized[1] === "watch") {
-        const agentId = normalized[2];
-        if (!agentId) {
-            throw new Error("usage: agentinbox inbox watch <agentId> [--after-item ID] [--include-acked] [--heartbeat-ms N]");
+        const args = normalized.slice(2);
+        if (positionalArgs(args, ["--agent-id", "--after-item", "--heartbeat-ms"]).length > 0) {
+            throw new Error("usage: agentinbox inbox watch [--agent-id ID] [--after-item ID] [--include-acked] [--heartbeat-ms N]");
+        }
+        const selection = await selectAgentForCommand(client, {
+            explicitAgentId: takeFlagValue(normalized, "--agent-id"),
+            autoRegister: true,
+        });
+        const metadata = withCommandMetadata({
+            event: "watch_notice",
+        }, selection);
+        if (selection.autoRegistered || selection.warnings.length > 0) {
+            console.log((0, util_1.jsonResponse)(metadata));
         }
-        for await (const event of client.watchInbox(agentId, {
+        for await (const event of client.watchInbox(selection.agentId, {
             afterItemId: takeFlagValue(normalized, "--after-item"),
             includeAcked: hasFlag(normalized, "--include-acked"),
             heartbeatMs: parseOptionalNumber(takeFlagValue(normalized, "--heartbeat-ms")),
@@ -282,19 +354,20 @@ async function main() {
         return;
     }
     if (command === "inbox" && normalized[1] === "ack") {
-        const agentId = normalized[2];
+        const args = normalized.slice(2);
         const itemId = takeFlagValue(normalized, "--item");
         const throughItemId = takeFlagValue(normalized, "--through");
         const ackAll = hasFlag(normalized, "--all");
         const modeCount = Number(Boolean(itemId)) + Number(Boolean(throughItemId)) + Number(ackAll);
-        if (!agentId || modeCount !== 1) {
-            throw new Error("usage: agentinbox inbox ack <agentId> (--through <itemId> | --item <itemId> | --all)");
-        }
-        if (ackAll) {
-            await printRemote(client, `/agents/${encodeURIComponent(agentId)}/inbox/ack-all`, {});
-            return;
+        if (positionalArgs(args, ["--agent-id", "--item", "--through"]).length > 0 || modeCount !== 1) {
+            throw new Error("usage: agentinbox inbox ack [--agent-id ID] (--through <itemId> | --item <itemId> | --all)");
         }
-        await printRemote(client, `/agents/${encodeURIComponent(agentId)}/inbox/ack`, throughItemId ? { throughItemId } : { itemIds: [itemId] });
+        const selection = await selectAgentForCommand(client, {
+            explicitAgentId: takeFlagValue(normalized, "--agent-id"),
+            autoRegister: true,
+        });
+        const response = await requestRemote(client, `/agents/${encodeURIComponent(selection.agentId)}/inbox/ack`, ackAll ? { all: true } : (throughItemId ? { throughItemId } : { itemIds: [itemId] }));
+        console.log((0, util_1.jsonResponse)(withCommandMetadata(response.data, selection)));
         return;
     }
     if (command === "inbox" && normalized[1] === "compact") {
@@ -309,22 +382,6 @@ async function main() {
         await printRemote(client, "/gc", {});
         return;
     }
-    if (command === "fixture" && normalized[1] === "emit") {
-        const sourceId = normalized[2];
-        const sourceNativeId = takeFlagValue(normalized, "--native-id") ?? `fixture-${Date.now()}`;
-        const eventVariant = takeFlagValue(normalized, "--event") ?? "message";
-        if (!sourceId) {
-            throw new Error("usage: agentinbox fixture emit <sourceId> [--native-id ID] [--event EVENT] [--metadata-json JSON] [--payload-json JSON]");
-        }
-        await printRemote(client, "/fixtures/emit", {
-            sourceId,
-            sourceNativeId,
-            eventVariant,
-            metadata: (0, util_1.parseJsonArg)(takeFlagValue(normalized, "--metadata-json")),
-            rawPayload: (0, util_1.parseJsonArg)(takeFlagValue(normalized, "--payload-json")),
-        });
-        return;
-    }
     if (command === "deliver" && normalized[1] === "send") {
         const provider = takeFlagValue(normalized, "--provider");
         const surface = takeFlagValue(normalized, "--surface");
@@ -337,8 +394,8 @@ async function main() {
             provider,
             surface,
             targetRef,
-            threadRef: takeFlagValue(normalized, "--thread") ?? null,
-            replyMode: takeFlagValue(normalized, "--reply-mode") ?? null,
+            threadRef: takeFlagValue(normalized, "--thread") ?? undefined,
+            replyMode: takeFlagValue(normalized, "--reply-mode") ?? undefined,
             kind,
             payload: (0, util_1.parseJsonArg)(takeFlagValue(normalized, "--payload-json")),
         });
@@ -369,7 +426,9 @@ async function runServe(args) {
     });
     const store = await store_1.AgentInboxStore.open(serveConfig.dbPath);
     let service;
-    const adapters = new adapters_1.AdapterRegistry(store, async (input) => service.appendSourceEvent(input));
+    const adapters = new adapters_1.AdapterRegistry(store, async (input) => service.appendSourceEvent(input), {
+        homeDir: serveConfig.homeDir,
+    });
     service = new service_1.AgentInboxService(store, adapters);
     const server = (0, http_1.createServer)(service);
     await adapters.start();
@@ -434,19 +493,99 @@ async function createClient(args) {
     });
     return new client_1.AgentInboxClient(transport);
 }
+async function printAgentList(client) {
+    const records = await listAgentsWithTargets(client);
+    console.log((0, util_1.jsonResponse)((0, current_agent_1.annotateAgents)(records, tryDetectTerminalContext())));
+}
+async function printCurrentAgent(client) {
+    const context = getRequiredTerminalContext();
+    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`");
+    }
+    console.log((0, util_1.jsonResponse)(current));
+}
+async function selectAgentForCommand(client, options) {
+    const records = await listAgentsWithTargets(client);
+    const context = tryDetectTerminalContext();
+    if (options.explicitAgentId) {
+        const current = context ? (0, current_agent_1.resolveCurrentAgent)(records, context) : null;
+        const requested = records.find((entry) => entry.agent.agentId === options.explicitAgentId);
+        const warnings = [];
+        if (current && requested && current.agentId !== requested.agent.agentId && current.bindingKind === "session_bound"
+            && bindingKindForRecord(requested) === "session_bound") {
+            warnings.push({
+                code: "cross_session_agent",
+                message: "Requested agent does not match the current terminal session.",
+                currentAgentId: current.agentId,
+                requestedAgentId: requested.agent.agentId,
+            });
+        }
+        return {
+            agentId: options.explicitAgentId,
+            autoRegistered: false,
+            warnings,
+        };
+    }
+    const contextForCurrent = getRequiredTerminalContext();
+    const current = (0, current_agent_1.resolveCurrentAgent)(records, contextForCurrent);
+    if (current) {
+        return {
+            agentId: current.agentId,
+            autoRegistered: false,
+            warnings: [],
+        };
+    }
+    if (!options.autoRegister) {
+        throw new Error("no current agent is registered for this terminal/runtime context; run `agentinbox agent register`");
+    }
+    await requestRemote(client, "/agents", {
+        backend: contextForCurrent.backend,
+        runtimeKind: contextForCurrent.runtimeKind,
+        runtimeSessionId: contextForCurrent.runtimeSessionId ?? undefined,
+        tmuxPaneId: contextForCurrent.tmuxPaneId ?? undefined,
+        tty: contextForCurrent.tty ?? undefined,
+        termProgram: contextForCurrent.termProgram ?? undefined,
+        itermSessionId: contextForCurrent.itermSessionId ?? undefined,
+        notifyLeaseMs: undefined,
+    });
+    const refreshed = await listAgentsWithTargets(client);
+    const registered = (0, current_agent_1.resolveCurrentAgent)(refreshed, contextForCurrent);
+    if (!registered) {
+        throw new Error("failed to resolve current agent after auto-register");
+    }
+    return {
+        agentId: registered.agentId,
+        autoRegistered: true,
+        warnings: [],
+    };
+}
+async function listAgentsWithTargets(client) {
+    const response = await requestRemote(client, "/agents?include_targets=true", undefined, "GET");
+    return response.data.agents;
+}
 async function printRemote(client, endpoint, body, method = "POST") {
+    const response = await requestRemote(client, endpoint, body, method);
+    console.log((0, util_1.jsonResponse)(response.data));
+}
+async function requestRemote(client, endpoint, body, method = "POST") {
     const response = await client.request(endpoint, body, method);
     if (response.statusCode < 200 || response.statusCode >= 300) {
         throw new Error((0, util_1.jsonResponse)(response.data));
     }
-    console.log((0, util_1.jsonResponse)(response.data));
+    return { data: response.data };
 }
 function takeFlagValue(args, flag) {
     const index = args.indexOf(flag);
     if (index === -1) {
         return undefined;
     }
-    return args[index + 1];
+    const value = args[index + 1];
+    if (!value || value.startsWith("--")) {
+        throw new Error(`flag ${flag} requires a value`);
+    }
+    return value;
 }
 function hasFlag(args, flag) {
     return args.includes(flag);
@@ -483,6 +622,82 @@ function buildQuery(params) {
     const query = search.toString();
     return query ? `?${query}` : "";
 }
+function readSubscriptionFilter(args) {
+    const filterJson = takeFlagValue(args, "--filter-json");
+    const filterFile = takeFlagValue(args, "--filter-file");
+    const filterStdin = hasFlag(args, "--filter-stdin");
+    const configured = [filterJson != null, filterFile != null, filterStdin].filter(Boolean).length;
+    if (configured > 1) {
+        throw new Error("subscription add accepts only one of --filter-json, --filter-file, or --filter-stdin");
+    }
+    if (filterJson != null) {
+        return (0, util_1.parseJsonArg)(filterJson, "--filter-json", {
+            requireNonEmptyObject: true,
+        });
+    }
+    if (filterFile != null) {
+        return (0, util_1.parseJsonArg)(node_fs_1.default.readFileSync(filterFile, "utf8"), `filter file ${filterFile}`, {
+            requireNonEmptyObject: true,
+        });
+    }
+    if (filterStdin) {
+        const stdin = node_fs_1.default.readFileSync(0, "utf8");
+        return (0, util_1.parseJsonArg)(stdin, "stdin filter", {
+            requireNonEmptyObject: true,
+        });
+    }
+    return {};
+}
+function withCommandMetadata(data, selection) {
+    return {
+        ...data,
+        agentId: selection.agentId,
+        ...(selection.autoRegistered ? { autoRegistered: true } : {}),
+        ...(selection.warnings.length > 0 ? { warnings: selection.warnings } : {}),
+    };
+}
+function getRequiredTerminalContext() {
+    try {
+        return (0, terminal_1.detectTerminalContext)(process.env);
+    }
+    catch (error) {
+        const message = error instanceof Error ? error.message : String(error);
+        throw new Error(`unable to resolve current agent: ${message}`);
+    }
+}
+function tryDetectTerminalContext() {
+    try {
+        return (0, terminal_1.detectTerminalContext)(process.env);
+    }
+    catch {
+        return null;
+    }
+}
+function bindingKindForRecord(record) {
+    return record.agent.status === "active" && record.activationTargets.some((target) => target.kind === "terminal" && target.status === "active")
+        ? "session_bound"
+        : "detached";
+}
+function positionalArgs(args, flagsWithValues) {
+    const flags = new Set(flagsWithValues);
+    const positionals = [];
+    for (let index = 0; index < args.length; index += 1) {
+        const token = args[index];
+        if (flags.has(token)) {
+            index += 1;
+            continue;
+        }
+        if (token.startsWith("--")) {
+            continue;
+        }
+        positionals.push(token);
+    }
+    return positionals;
+}
+function unexpectedFlags(args, allowedFlags) {
+    const allowed = new Set(allowedFlags);
+    return args.filter((token) => token.startsWith("--") && !allowed.has(token));
+}
 function printHelp(path = []) {
     const key = path[0] ?? "root";
     const helpByKey = {
@@ -502,10 +717,8 @@ Commands:
   subscription
   inbox
   gc
-  fixture
   deliver
   status
-  gc
   version
 `,
         serve: `agentinbox serve
@@ -527,6 +740,10 @@ Usage:
   agentinbox source add <type> <sourceKey> [--config-json JSON] [--config-ref REF]
   agentinbox source list
   agentinbox source show <sourceId>
+  agentinbox source update <sourceId> [--config-json JSON] [--config-ref REF | --clear-config-ref]
+  agentinbox source remove <sourceId>
+  agentinbox source pause <remoteSourceId>
+  agentinbox source resume <remoteSourceId>
   agentinbox source schema <sourceType>
   agentinbox source poll <sourceId>
   agentinbox source event <sourceId> --native-id ID --event EVENT [--occurred-at ISO8601] [--metadata-json JSON] [--payload-json JSON]
@@ -536,6 +753,7 @@ Usage:
 Usage:
   agentinbox agent register [--agent-id ID] [--force-rebind] [--notify-lease-ms N]
   agentinbox agent list
+  agentinbox agent current
   agentinbox agent show <agentId>
   agentinbox agent remove <agentId>
   agentinbox agent target add webhook <agentId> --url URL [--activation-mode MODE] [--notify-lease-ms N]
@@ -545,7 +763,7 @@ Usage:
         subscription: `agentinbox subscription
 
 Usage:
-  agentinbox subscription add <agentId> <sourceId> [--filter-json JSON] [--start-policy POLICY] [--start-offset N] [--start-time ISO8601]
+  agentinbox subscription add <sourceId> [--agent-id ID] [--filter-json JSON | --filter-file PATH | --filter-stdin] [--start-policy POLICY] [--start-offset N] [--start-time ISO8601]
   agentinbox subscription list [--source-id ID] [--agent-id ID]
   agentinbox subscription show <subscriptionId>
   agentinbox subscription remove <subscriptionId>
@@ -558,15 +776,10 @@ Usage:
 Usage:
   agentinbox inbox list
   agentinbox inbox show <agentId>
-  agentinbox inbox read <agentId> [--after-item ID] [--include-acked]
-  agentinbox inbox watch <agentId> [--after-item ID] [--include-acked] [--heartbeat-ms N]
-  agentinbox inbox ack <agentId> (--through <itemId> | --item <itemId> | --all)
+  agentinbox inbox read [--agent-id ID] [--after-item ID] [--include-acked]
+  agentinbox inbox watch [--agent-id ID] [--after-item ID] [--include-acked] [--heartbeat-ms N]
+  agentinbox inbox ack [--agent-id ID] (--through <itemId> | --item <itemId> | --all)
   agentinbox inbox compact <agentId>
-`,
-        fixture: `agentinbox fixture
-
-Usage:
-  agentinbox fixture emit <sourceId> [--native-id ID] [--event EVENT] [--metadata-json JSON] [--payload-json JSON]
 `,
         deliver: `agentinbox deliver
 

package/dist/src/current_agent.js

@@ -0,0 +1,126 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.summarizeActivationTarget = summarizeActivationTarget;
+exports.resolveCurrentAgent = resolveCurrentAgent;
+exports.annotateAgents = annotateAgents;
+function summarizeActivationTarget(target) {
+    if (target.kind === "terminal") {
+        return {
+            targetId: target.targetId,
+            kind: "terminal",
+            status: target.status,
+            backend: target.backend,
+            tmuxPaneId: target.tmuxPaneId ?? null,
+            tty: target.tty ?? null,
+            termProgram: target.termProgram ?? null,
+            itermSessionId: target.itermSessionId ?? null,
+            runtimeKind: target.runtimeKind ?? null,
+            runtimeSessionId: target.runtimeSessionId ?? null,
+        };
+    }
+    return {
+        targetId: target.targetId,
+        kind: "webhook",
+        status: target.status,
+    };
+}
+function resolveCurrentAgent(agents, context) {
+    if (!context) {
+        return null;
+    }
+    const agent = resolveAgentRecord(agents, context);
+    if (!agent) {
+        return null;
+    }
+    return {
+        agentId: agent.agent.agentId,
+        bindingKind: bindingKindForAgent(agent),
+        matchesCurrentTerminal: matchesCurrentTerminal(agent, context),
+        matchesCurrentRuntime: matchesCurrentRuntime(agent, context),
+        terminalIdentity: terminalIdentityForAgent(agent),
+    };
+}
+function annotateAgents(agents, context) {
+    const current = resolveCurrentAgent(agents, context);
+    return {
+        currentAgentId: current?.agentId ?? null,
+        agents: agents.map((entry) => ({
+            ...entry.agent,
+            bindingKind: bindingKindForAgent(entry),
+            matchesCurrentTerminal: context ? matchesCurrentTerminal(entry, context) : false,
+            matchesCurrentRuntime: context ? matchesCurrentRuntime(entry, context) : false,
+            terminalIdentity: terminalIdentityForAgent(entry),
+            isCurrent: current?.agentId === entry.agent.agentId,
+        })),
+    };
+}
+function resolveAgentRecord(agents, context) {
+    if (context.tmuxPaneId) {
+        const match = agents.find((agent) => activeTerminalTargets(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));
+        if (match) {
+            return match;
+        }
+    }
+    if (context.tty) {
+        const match = agents.find((agent) => activeTerminalTargets(agent).some((target) => target.tty === context.tty));
+        if (match) {
+            return match;
+        }
+    }
+    if (context.runtimeSessionId) {
+        const match = agents.find((agent) => matchesCurrentRuntime(agent, context));
+        if (match) {
+            return match;
+        }
+    }
+    return null;
+}
+function bindingKindForAgent(agent) {
+    return activeTerminalTargets(agent).length > 0 ? "session_bound" : "detached";
+}
+function terminalTargets(agent) {
+    return agent.activationTargets.filter((target) => target.kind === "terminal");
+}
+function activeTerminalTargets(agent) {
+    if (agent.agent.status !== "active") {
+        return [];
+    }
+    return terminalTargets(agent).filter((target) => target.status === "active");
+}
+function terminalIdentityForAgent(agent) {
+    const target = activeTerminalTargets(agent)[0];
+    if (!target) {
+        return null;
+    }
+    if (target.tmuxPaneId) {
+        return `tmux:${target.tmuxPaneId}`;
+    }
+    if (target.itermSessionId) {
+        return `iterm2:${target.itermSessionId}`;
+    }
+    if (target.tty) {
+        return `tty:${target.tty}`;
+    }
+    return null;
+}
+function matchesCurrentTerminal(agent, context) {
+    return activeTerminalTargets(agent).some((target) => (context.tmuxPaneId != null && target.tmuxPaneId === context.tmuxPaneId)
+        || (context.itermSessionId != null && target.itermSessionId === context.itermSessionId)
+        || (context.tty != null && target.tty === context.tty));
+}
+function matchesCurrentRuntime(agent, context) {
+    if (agent.agent.status !== "active") {
+        return false;
+    }
+    if (!context.runtimeSessionId) {
+        return false;
+    }
+    return activeTerminalTargets(agent).some((target) => target.runtimeKind === context.runtimeKind && target.runtimeSessionId === context.runtimeSessionId) || (agent.agent.runtimeKind === context.runtimeKind
+        && agent.agent.runtimeSessionId === context.runtimeSessionId);
+}