@holon-run/agentinbox 0.1.4 → 0.3.0

package/README.md

@@ -136,6 +136,7 @@ Create a local source and publish an event:
 agentinbox source add local_event local-demo
 agentinbox subscription add <source_id>
 agentinbox subscription add <source_id> --agent-id <agent_id>
+agentinbox subscription add <source_id> --tracked-resource-ref pr:373 --cleanup-policy-json '{"mode":"manual"}'
 agentinbox subscription add <source_id> --filter-file ./filter.json
 cat filter.json | agentinbox subscription add <source_id> --filter-stdin
 agentinbox source event <source_id> --native-id demo-1 --event local.demo

package/dist/src/adapters.js

@@ -1,9 +1,12 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.AdapterRegistry = void 0;
+const paths_1 = require("./paths");
 const feishu_1 = require("./sources/feishu");
 const github_1 = require("./sources/github");
 const remote_1 = require("./sources/remote");
+const remote_profiles_1 = require("./sources/remote_profiles");
+const source_resolution_1 = require("./source_resolution");
 class NoopSourceAdapter {
     sourceType;
     constructor(sourceType) {
@@ -37,11 +40,15 @@ class AdapterRegistry {
     defaultDelivery = new NoopDeliveryAdapter();
     feishuDelivery = new feishu_1.FeishuDeliveryAdapter();
     githubDelivery = new github_1.GithubDeliveryAdapter();
+    homeDir;
+    remoteProfileRegistry;
     constructor(store, appendSourceEvent, options) {
+        this.homeDir = options?.homeDir ?? (0, paths_1.resolveAgentInboxHome)(process.env);
+        this.remoteProfileRegistry = options?.remoteProfileRegistry ?? new remote_profiles_1.RemoteSourceProfileRegistry();
         this.remoteSource = new remote_1.RemoteSourceRuntime(store, appendSourceEvent, {
-            homeDir: options?.homeDir,
+            homeDir: this.homeDir,
             client: options?.remoteSourceClient,
-            profileRegistry: options?.remoteProfileRegistry,
+            profileRegistry: this.remoteProfileRegistry,
         });
     }
     sourceAdapterFor(type) {
@@ -109,6 +116,30 @@ class AdapterRegistry {
         const adapter = this.sourceAdapterFor(source.sourceType);
         await adapter.removeSource?.(source.sourceId);
     }
+    async resolveSourceIdentity(source) {
+        return (0, source_resolution_1.resolveSourceIdentity)(source, {
+            homeDir: this.homeDir,
+            profileRegistry: this.remoteProfileRegistry,
+        });
+    }
+    async resolveSourceSchema(source) {
+        return (0, source_resolution_1.resolveSourceSchema)(source, {
+            homeDir: this.homeDir,
+            profileRegistry: this.remoteProfileRegistry,
+        });
+    }
+    async projectLifecycleSignal(source, rawPayload) {
+        if (source.sourceType === "local_event") {
+            return null;
+        }
+        return this.remoteSource.projectLifecycleSignal(source, rawPayload);
+    }
+    async expandSubscriptionShortcut(source, input) {
+        if (source.sourceType === "local_event") {
+            return null;
+        }
+        return this.remoteSource.expandSubscriptionShortcut(source, input);
+    }
     status() {
         return {
             remote: this.remoteSource.status?.() ?? {},

package/dist/src/cli.js

@@ -76,11 +76,16 @@ async function main() {
         return;
     }
     if (command === "source" && normalized[1] === "remove") {
-        const sourceId = normalized[2];
-        if (!sourceId) {
-            throw new Error("usage: agentinbox source remove <sourceId>");
+        const removeArgs = normalized.slice(2);
+        const positionals = positionalArgs(removeArgs, ["--with-subscriptions"]);
+        const sourceId = positionals[0];
+        if (!sourceId || positionals[1]) {
+            throw new Error("usage: agentinbox source remove <sourceId> [--with-subscriptions]");
         }
-        await printRemote(client, `/sources/${encodeURIComponent(sourceId)}`, undefined, "DELETE");
+        const query = buildQuery({
+            with_subscriptions: hasFlag(normalized, "--with-subscriptions") ? "true" : undefined,
+        });
+        await printRemote(client, `/sources/${encodeURIComponent(sourceId)}${query}`, undefined, "DELETE");
         return;
     }
     if (command === "source" && normalized[1] === "update") {
@@ -120,11 +125,27 @@ async function main() {
         return;
     }
     if (command === "source" && normalized[1] === "schema") {
-        const sourceType = normalized[2];
-        if (!sourceType) {
-            throw new Error("usage: agentinbox source schema <sourceType>");
+        if (normalized[2] === "preview") {
+            const sourceRef = normalized[3];
+            if (!sourceRef) {
+                throw new Error("usage: agentinbox source schema preview <sourceKind|sourceType> [--config-json JSON] [--config-ref REF]");
+            }
+            await printRemote(client, "/sources/schema-preview", {
+                sourceRef,
+                configRef: takeFlagValue(normalized, "--config-ref") ?? undefined,
+                config: (0, util_1.parseJsonArg)(takeFlagValue(normalized, "--config-json")),
+            });
+            return;
+        }
+        const sourceRef = normalized[2];
+        if (!sourceRef) {
+            throw new Error("usage: agentinbox source schema <sourceId|sourceType>");
         }
-        await printRemote(client, `/source-types/${encodeURIComponent(sourceType)}/schema`, undefined, "GET");
+        if (sourceRef.startsWith("src_")) {
+            await printRemote(client, `/sources/${encodeURIComponent(sourceRef)}/schema`, undefined, "GET");
+            return;
+        }
+        await printRemote(client, `/source-types/${encodeURIComponent(sourceRef)}/schema`, undefined, "GET");
         return;
     }
     if (command === "source" && normalized[1] === "poll") {
@@ -159,6 +180,7 @@ async function main() {
             backend: detected.backend,
             runtimeKind: detected.runtimeKind,
             runtimeSessionId: detected.runtimeSessionId ?? undefined,
+            runtimePid: detected.runtimePid ?? undefined,
             tmuxPaneId: detected.tmuxPaneId ?? undefined,
             tty: detected.tty ?? undefined,
             termProgram: detected.termProgram ?? undefined,
@@ -223,19 +245,46 @@ async function main() {
     }
     if (command === "subscription" && normalized[1] === "add") {
         const args = normalized.slice(2);
-        const positionals = positionalArgs(args, ["--agent-id", "--filter-json", "--filter-file", "--start-policy", "--start-offset", "--start-time"]);
+        const positionals = positionalArgs(args, [
+            "--agent-id",
+            "--shortcut",
+            "--shortcut-args-json",
+            "--filter-json",
+            "--filter-file",
+            "--tracked-resource-ref",
+            "--cleanup-policy-json",
+            "--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]");
+            throw new Error("usage: agentinbox subscription add <sourceId> [--agent-id ID] [--shortcut NAME --shortcut-args-json JSON] [--filter-json JSON | --filter-file PATH | --filter-stdin] [--tracked-resource-ref REF] [--cleanup-policy-json JSON] [--start-policy POLICY] [--start-offset N] [--start-time ISO8601]");
         }
         const selection = await selectAgentForCommand(client, {
             explicitAgentId: takeFlagValue(normalized, "--agent-id"),
             autoRegister: true,
         });
+        const shortcutName = takeFlagValue(normalized, "--shortcut");
+        const shortcutArgsJson = takeFlagValue(normalized, "--shortcut-args-json");
+        if (shortcutName && (hasFlag(normalized, "--filter-stdin") || takeFlagValue(normalized, "--filter-json") != null || takeFlagValue(normalized, "--filter-file") != null || takeFlagValue(normalized, "--tracked-resource-ref") != null || takeFlagValue(normalized, "--cleanup-policy-json") != null)) {
+            throw new Error("subscription add shortcut does not allow filter, trackedResourceRef, or cleanupPolicy flags");
+        }
+        const cleanupPolicyJson = takeFlagValue(normalized, "--cleanup-policy-json");
         const response = await requestRemote(client, "/subscriptions", {
             agentId: selection.agentId,
             sourceId,
-            filter: readSubscriptionFilter(normalized),
+            shortcut: shortcutName
+                ? {
+                    name: shortcutName,
+                    args: shortcutArgsJson != null ? (0, util_1.parseJsonArg)(shortcutArgsJson, "--shortcut-args-json") : {},
+                }
+                : undefined,
+            filter: shortcutName ? undefined : readSubscriptionFilter(normalized),
+            trackedResourceRef: takeFlagValue(normalized, "--tracked-resource-ref") ?? undefined,
+            cleanupPolicy: cleanupPolicyJson != null
+                ? (0, util_1.parseJsonArg)(cleanupPolicyJson, "--cleanup-policy-json")
+                : undefined,
             startPolicy: takeFlagValue(normalized, "--start-policy") ?? undefined,
             startOffset: parseOptionalNumber(takeFlagValue(normalized, "--start-offset")),
             startTime: takeFlagValue(normalized, "--start-time") ?? undefined,
@@ -296,6 +345,62 @@ async function main() {
         });
         return;
     }
+    if (command === "timer" && normalized[1] === "add") {
+        const args = normalized.slice(2);
+        const allowedFlags = ["--agent-id", "--at", "--every", "--cron", "--timezone", "--message", "--sender"];
+        if (positionalArgs(args, ["--agent-id", "--at", "--every", "--cron", "--timezone", "--message", "--sender"]).length > 0 || unexpectedFlags(args, allowedFlags).length > 0) {
+            throw new Error("usage: agentinbox timer add --agent-id ID (--at ISO8601 | --every DURATION | --cron EXPR) --message TEXT [--timezone TZ] [--sender SENDER]");
+        }
+        const agentId = takeFlagValue(normalized, "--agent-id");
+        const message = takeFlagValue(normalized, "--message");
+        const at = takeFlagValue(normalized, "--at");
+        const every = takeFlagValue(normalized, "--every");
+        const cron = takeFlagValue(normalized, "--cron");
+        if (!agentId || !message || [at, every, cron].filter(Boolean).length !== 1) {
+            throw new Error("usage: agentinbox timer add --agent-id ID (--at ISO8601 | --every DURATION | --cron EXPR) --message TEXT [--timezone TZ] [--sender SENDER]");
+        }
+        await printRemote(client, "/timers", {
+            agentId,
+            at: at ?? undefined,
+            every: every ? parseDurationMs(every) : undefined,
+            cron: cron ?? undefined,
+            timezone: takeFlagValue(normalized, "--timezone") ?? undefined,
+            message,
+            sender: takeFlagValue(normalized, "--sender") ?? undefined,
+        });
+        return;
+    }
+    if (command === "timer" && normalized[1] === "list") {
+        const query = buildQuery({
+            agent_id: takeFlagValue(normalized, "--agent-id"),
+        });
+        await printRemote(client, `/timers${query}`, undefined, "GET");
+        return;
+    }
+    if (command === "timer" && normalized[1] === "pause") {
+        const scheduleId = normalized[2];
+        if (!scheduleId) {
+            throw new Error("usage: agentinbox timer pause <scheduleId>");
+        }
+        await printRemote(client, `/timers/${encodeURIComponent(scheduleId)}/pause`, {});
+        return;
+    }
+    if (command === "timer" && normalized[1] === "resume") {
+        const scheduleId = normalized[2];
+        if (!scheduleId) {
+            throw new Error("usage: agentinbox timer resume <scheduleId>");
+        }
+        await printRemote(client, `/timers/${encodeURIComponent(scheduleId)}/resume`, {});
+        return;
+    }
+    if (command === "timer" && normalized[1] === "remove") {
+        const scheduleId = normalized[2];
+        if (!scheduleId) {
+            throw new Error("usage: agentinbox timer remove <scheduleId>");
+        }
+        await printRemote(client, `/timers/${encodeURIComponent(scheduleId)}`, undefined, "DELETE");
+        return;
+    }
     if (command === "inbox" && normalized[1] === "list") {
         await printRemote(client, "/agents", undefined, "GET");
         return;
@@ -326,6 +431,23 @@ async function main() {
         console.log((0, util_1.jsonResponse)(withCommandMetadata(response.data, selection)));
         return;
     }
+    if (command === "inbox" && normalized[1] === "send") {
+        const args = normalized.slice(2);
+        const allowedFlags = ["--agent-id", "--message", "--sender"];
+        if (positionalArgs(args, ["--agent-id", "--message", "--sender"]).length > 0 || unexpectedFlags(args, allowedFlags).length > 0) {
+            throw new Error("usage: agentinbox inbox send --agent-id ID --message TEXT [--sender SENDER]");
+        }
+        const agentId = takeFlagValue(normalized, "--agent-id");
+        const message = takeFlagValue(normalized, "--message");
+        if (!agentId || !message) {
+            throw new Error("usage: agentinbox inbox send --agent-id ID --message TEXT [--sender SENDER]");
+        }
+        await printRemote(client, `/agents/${encodeURIComponent(agentId)}/inbox/items`, {
+            message,
+            sender: takeFlagValue(normalized, "--sender") ?? undefined,
+        });
+        return;
+    }
     if (command === "inbox" && normalized[1] === "watch") {
         const args = normalized.slice(2);
         if (positionalArgs(args, ["--agent-id", "--after-item", "--heartbeat-ms"]).length > 0) {
@@ -544,6 +666,7 @@ async function selectAgentForCommand(client, options) {
         backend: contextForCurrent.backend,
         runtimeKind: contextForCurrent.runtimeKind,
         runtimeSessionId: contextForCurrent.runtimeSessionId ?? undefined,
+        runtimePid: contextForCurrent.runtimePid ?? undefined,
         tmuxPaneId: contextForCurrent.tmuxPaneId ?? undefined,
         tty: contextForCurrent.tty ?? undefined,
         termProgram: contextForCurrent.termProgram ?? undefined,
@@ -600,6 +723,30 @@ function parseOptionalNumber(value) {
     }
     return parsed;
 }
+function parseDurationMs(value) {
+    if (/^\d+$/.test(value)) {
+        return Number(value);
+    }
+    const match = /^(\d+)(ms|s|m|h|d)$/.exec(value);
+    if (!match) {
+        throw new Error(`invalid duration: ${value}`);
+    }
+    const amount = Number(match[1]);
+    switch (match[2]) {
+        case "ms":
+            return amount;
+        case "s":
+            return amount * 1_000;
+        case "m":
+            return amount * 60_000;
+        case "h":
+            return amount * 60 * 60_000;
+        case "d":
+            return amount * 24 * 60 * 60_000;
+        default:
+            throw new Error(`invalid duration: ${value}`);
+    }
+}
 function normalizeHelpArgs(args) {
     if (args[0] !== "help") {
         return args;
@@ -714,6 +861,7 @@ Commands:
   daemon
   source
   agent
+  timer
   subscription
   inbox
   gc
@@ -741,10 +889,11 @@ Usage:
   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 remove <sourceId> [--with-subscriptions]
   agentinbox source pause <remoteSourceId>
   agentinbox source resume <remoteSourceId>
-  agentinbox source schema <sourceType>
+  agentinbox source schema <sourceId|sourceType>
+  agentinbox source schema preview <sourceKind|sourceType> [--config-json JSON] [--config-ref REF]
   agentinbox source poll <sourceId>
   agentinbox source event <sourceId> --native-id ID --event EVENT [--occurred-at ISO8601] [--metadata-json JSON] [--payload-json JSON]
 `,
@@ -759,11 +908,20 @@ Usage:
   agentinbox agent target add webhook <agentId> --url URL [--activation-mode MODE] [--notify-lease-ms N]
   agentinbox agent target list <agentId>
   agentinbox agent target remove <agentId> <targetId>
+`,
+        timer: `agentinbox timer
+
+Usage:
+  agentinbox timer add --agent-id ID (--at ISO8601 | --every DURATION | --cron EXPR) --message TEXT [--timezone TZ] [--sender SENDER]
+  agentinbox timer list [--agent-id ID]
+  agentinbox timer pause <scheduleId>
+  agentinbox timer resume <scheduleId>
+  agentinbox timer remove <scheduleId>
 `,
         subscription: `agentinbox subscription
 
 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]
+  agentinbox subscription add <sourceId> [--agent-id ID] [--shortcut NAME --shortcut-args-json JSON] [--filter-json JSON | --filter-file PATH | --filter-stdin] [--tracked-resource-ref REF] [--cleanup-policy-json JSON] [--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>
@@ -777,6 +935,7 @@ Usage:
   agentinbox inbox list
   agentinbox inbox show <agentId>
   agentinbox inbox read [--agent-id ID] [--after-item ID] [--include-acked]
+  agentinbox inbox send --agent-id ID --message TEXT [--sender SENDER]
   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>

package/dist/src/current_agent.js

@@ -16,6 +16,7 @@ function summarizeActivationTarget(target) {
             itermSessionId: target.itermSessionId ?? null,
             runtimeKind: target.runtimeKind ?? null,
             runtimeSessionId: target.runtimeSessionId ?? null,
+            runtimePid: target.runtimePid ?? null,
         };
     }
     return {