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

package/dist/src/cli.js

@@ -12,6 +12,7 @@ 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 logging_1 = require("./logging");
 const paths_1 = require("./paths");
 const service_1 = require("./service");
 const store_1 = require("./store");
@@ -50,14 +51,167 @@ async function main() {
         return;
     }
     const client = await createClient(normalized);
+    if (command === "host" && normalized[1] === "add") {
+        const [hostType, hostKey] = normalized.slice(2, 4);
+        if (!hostType || !hostKey) {
+            throw new Error("usage: agentinbox host add <hostType> <hostKey> [--config-json JSON] [--config-ref REF]");
+        }
+        await printRemote(client, "/hosts", {
+            hostType,
+            hostKey,
+            configRef: takeFlagValue(normalized, "--config-ref") ?? undefined,
+            config: (0, util_1.parseJsonArg)(takeFlagValue(normalized, "--config-json")),
+        });
+        return;
+    }
+    if (command === "host" && normalized[1] === "list") {
+        await printRemote(client, "/hosts", undefined, "GET");
+        return;
+    }
+    if (command === "host" && normalized[1] === "show") {
+        const hostId = normalized[2];
+        if (!hostId) {
+            throw new Error("usage: agentinbox host show <hostId>");
+        }
+        await printRemote(client, `/hosts/${encodeURIComponent(hostId)}`, undefined, "GET");
+        return;
+    }
+    if (command === "host" && normalized[1] === "schema") {
+        const hostId = normalized[2];
+        if (!hostId) {
+            throw new Error("usage: agentinbox host schema <hostId>");
+        }
+        await printRemote(client, `/hosts/${encodeURIComponent(hostId)}/schema`, undefined, "GET");
+        return;
+    }
+    if (command === "stream" && normalized[1] === "add") {
+        const [hostId, streamKind, streamKey] = normalized.slice(2, 5);
+        if (!hostId || !streamKind || !streamKey) {
+            throw new Error("usage: agentinbox stream add <hostId> <streamKind> <streamKey> [--config-json JSON] [--config-ref REF]");
+        }
+        await printRemote(client, "/streams", {
+            hostId,
+            streamKind,
+            streamKey,
+            configRef: takeFlagValue(normalized, "--config-ref") ?? undefined,
+            config: (0, util_1.parseJsonArg)(takeFlagValue(normalized, "--config-json")),
+        });
+        return;
+    }
+    if (command === "stream" && normalized[1] === "list") {
+        await printRemote(client, "/streams", undefined, "GET");
+        return;
+    }
+    if (command === "stream" && normalized[1] === "show") {
+        const streamId = normalized[2];
+        if (!streamId) {
+            throw new Error("usage: agentinbox stream show <streamId>");
+        }
+        await printRemote(client, `/streams/${encodeURIComponent(streamId)}`, undefined, "GET");
+        return;
+    }
+    if (command === "stream" && normalized[1] === "remove") {
+        const removeArgs = normalized.slice(2);
+        const positionals = positionalArgs(removeArgs, ["--with-subscriptions"]);
+        const streamId = positionals[0];
+        if (!streamId || positionals[1]) {
+            throw new Error("usage: agentinbox stream remove <streamId> [--with-subscriptions]");
+        }
+        const query = buildQuery({
+            with_subscriptions: hasFlag(normalized, "--with-subscriptions") ? "true" : undefined,
+        });
+        await printRemote(client, `/streams/${encodeURIComponent(streamId)}${query}`, undefined, "DELETE");
+        return;
+    }
+    if (command === "stream" && normalized[1] === "update") {
+        const streamId = normalized[2];
+        if (!streamId) {
+            throw new Error("usage: agentinbox stream update <streamId> [--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("stream update accepts only one of --config-ref or --clear-config-ref");
+        }
+        if (!clearConfigRef && configRef == null && configJson == null) {
+            throw new Error("usage: agentinbox stream update <streamId> [--config-json JSON] [--config-ref REF | --clear-config-ref]");
+        }
+        await printRemote(client, `/streams/${encodeURIComponent(streamId)}`, {
+            ...(clearConfigRef ? { configRef: null } : (configRef != null ? { configRef } : {})),
+            config: configJson != null ? (0, util_1.parseJsonArg)(configJson, "--config-json") : undefined,
+        }, "PATCH");
+        return;
+    }
+    if (command === "stream" && normalized[1] === "pause") {
+        const streamId = normalized[2];
+        if (!streamId) {
+            throw new Error("usage: agentinbox stream pause <streamId>");
+        }
+        await printRemote(client, `/streams/${encodeURIComponent(streamId)}/pause`, {});
+        return;
+    }
+    if (command === "stream" && normalized[1] === "resume") {
+        const streamId = normalized[2];
+        if (!streamId) {
+            throw new Error("usage: agentinbox stream resume <streamId>");
+        }
+        await printRemote(client, `/streams/${encodeURIComponent(streamId)}/resume`, {});
+        return;
+    }
+    if (command === "stream" && normalized[1] === "schema") {
+        if (normalized[2] === "preview") {
+            const sourceRef = normalized[3];
+            if (!sourceRef) {
+                throw new Error("usage: agentinbox stream schema preview <sourceKind|sourceType> [--config-json JSON] [--config-ref REF]");
+            }
+            await printRemote(client, "/streams/schema-preview", {
+                sourceRef,
+                configRef: takeFlagValue(normalized, "--config-ref") ?? undefined,
+                config: (0, util_1.parseJsonArg)(takeFlagValue(normalized, "--config-json")),
+            });
+            return;
+        }
+        const streamRef = normalized[2];
+        if (!streamRef) {
+            throw new Error("usage: agentinbox stream schema <streamId>");
+        }
+        await printRemote(client, `/streams/${encodeURIComponent(streamRef)}/schema`, undefined, "GET");
+        return;
+    }
+    if (command === "stream" && normalized[1] === "poll") {
+        const streamId = normalized[2];
+        if (!streamId) {
+            throw new Error("usage: agentinbox stream poll <streamId>");
+        }
+        await printRemote(client, `/streams/${encodeURIComponent(streamId)}/poll`, {});
+        return;
+    }
+    if (command === "stream" && normalized[1] === "event") {
+        const streamId = normalized[2];
+        const sourceNativeId = takeFlagValue(normalized, "--native-id");
+        const eventVariant = takeFlagValue(normalized, "--event");
+        if (!streamId || !sourceNativeId || !eventVariant) {
+            throw new Error("usage: agentinbox stream event <streamId> --native-id ID --event EVENT [--occurred-at ISO8601] [--metadata-json JSON] [--payload-json JSON]");
+        }
+        await printRemote(client, `/streams/${encodeURIComponent(streamId)}/events`, {
+            sourceNativeId,
+            eventVariant,
+            occurredAt: takeFlagValue(normalized, "--occurred-at") ?? undefined,
+            metadata: (0, util_1.parseJsonArg)(takeFlagValue(normalized, "--metadata-json")),
+            rawPayload: (0, util_1.parseJsonArg)(takeFlagValue(normalized, "--payload-json")),
+        });
+        return;
+    }
     if (command === "source" && normalized[1] === "add") {
-        const [type, sourceKey] = normalized.slice(2, 4);
-        if (!type || !sourceKey) {
-            throw new Error("usage: agentinbox source add <type> <sourceKey> [--config-json JSON] [--config-ref REF]");
+        const [hostId, streamKind, streamKey] = normalized.slice(2, 5);
+        if (!hostId || !streamKind || !streamKey) {
+            throw new Error("usage: agentinbox source add <hostId> <streamKind> <streamKey> [--config-json JSON] [--config-ref REF]");
         }
         await printRemote(client, "/sources", {
-            sourceType: type,
-            sourceKey,
+            hostId,
+            streamKind,
+            streamKey,
             configRef: takeFlagValue(normalized, "--config-ref") ?? undefined,
             config: (0, util_1.parseJsonArg)(takeFlagValue(normalized, "--config-json")),
         });
@@ -125,27 +279,11 @@ async function main() {
         return;
     }
     if (command === "source" && normalized[1] === "schema") {
-        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>");
-        }
-        if (sourceRef.startsWith("src_")) {
-            await printRemote(client, `/sources/${encodeURIComponent(sourceRef)}/schema`, undefined, "GET");
-            return;
+            throw new Error("usage: agentinbox source schema <sourceId>");
         }
-        await printRemote(client, `/source-types/${encodeURIComponent(sourceRef)}/schema`, undefined, "GET");
+        await printRemote(client, `/sources/${encodeURIComponent(sourceRef)}/schema`, undefined, "GET");
         return;
     }
     if (command === "source" && normalized[1] === "poll") {
@@ -186,6 +324,7 @@ async function main() {
             termProgram: detected.termProgram ?? undefined,
             itermSessionId: detected.itermSessionId ?? undefined,
             notifyLeaseMs: parseOptionalNumber(takeFlagValue(normalized, "--notify-lease-ms")) ?? undefined,
+            minUnackedItems: parseOptionalNumber(takeFlagValue(normalized, "--min-unacked-items")) ?? undefined,
         });
         return;
     }
@@ -225,13 +364,14 @@ async function main() {
         const agentId = normalized[4];
         const url = takeFlagValue(normalized, "--url");
         if (!agentId || !url) {
-            throw new Error("usage: agentinbox agent target add webhook <agentId> --url URL [--activation-mode MODE] [--notify-lease-ms N]");
+            throw new Error("usage: agentinbox agent target add webhook <agentId> --url URL [--activation-mode MODE] [--notify-lease-ms N] [--min-unacked-items N]");
         }
         await printRemote(client, `/agents/${encodeURIComponent(agentId)}/targets`, {
             kind: "webhook",
             url,
             activationMode: takeFlagValue(normalized, "--activation-mode") ?? undefined,
             notifyLeaseMs: parseOptionalNumber(takeFlagValue(normalized, "--notify-lease-ms")) ?? undefined,
+            minUnackedItems: parseOptionalNumber(takeFlagValue(normalized, "--min-unacked-items")) ?? undefined,
         });
         return;
     }
@@ -431,19 +571,19 @@ async function main() {
     }
     if (command === "inbox" && normalized[1] === "read") {
         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 allowedFlags = ["--agent-id", "--after-entry", "--include-acked"];
+        if (positionalArgs(args, ["--agent-id", "--after-entry"]).length > 0 || unexpectedFlags(args, allowedFlags).length > 0) {
+            throw new Error("usage: agentinbox inbox read [--agent-id ID] [--after-entry 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"),
+            after_entry_id: takeFlagValue(normalized, "--after-entry"),
             include_acked: hasFlag(normalized, "--include-acked") ? "true" : undefined,
         });
-        const response = await requestRemote(client, `/agents/${encodeURIComponent(selection.agentId)}/inbox/items${query}`, undefined, "GET");
+        const response = await requestRemote(client, `/agents/${encodeURIComponent(selection.agentId)}/inbox/entries${query}`, undefined, "GET");
         console.log((0, util_1.jsonResponse)(withCommandMetadata(response.data, selection)));
         return;
     }
@@ -466,8 +606,8 @@ async function main() {
     }
     if (command === "inbox" && normalized[1] === "watch") {
         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]");
+        if (positionalArgs(args, ["--agent-id", "--after-entry", "--heartbeat-ms"]).length > 0) {
+            throw new Error("usage: agentinbox inbox watch [--agent-id ID] [--after-entry ID] [--include-acked] [--heartbeat-ms N]");
         }
         const selection = await selectAgentForCommand(client, {
             explicitAgentId: takeFlagValue(normalized, "--agent-id"),
@@ -480,7 +620,7 @@ async function main() {
             console.log((0, util_1.jsonResponse)(metadata));
         }
         for await (const event of client.watchInbox(selection.agentId, {
-            afterItemId: takeFlagValue(normalized, "--after-item"),
+            afterEntryId: takeFlagValue(normalized, "--after-entry"),
             includeAcked: hasFlag(normalized, "--include-acked"),
             heartbeatMs: parseOptionalNumber(takeFlagValue(normalized, "--heartbeat-ms")),
         })) {
@@ -493,18 +633,41 @@ async function main() {
     }
     if (command === "inbox" && normalized[1] === "ack") {
         const args = normalized.slice(2);
-        const itemId = takeFlagValue(normalized, "--item");
-        const throughItemId = takeFlagValue(normalized, "--through");
+        const itemId = takeFlagValue(normalized, "--entry");
+        const throughEntryId = takeFlagValue(normalized, "--through");
         const ackAll = hasFlag(normalized, "--all");
-        const modeCount = Number(Boolean(itemId)) + Number(Boolean(throughItemId)) + Number(ackAll);
-        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)");
+        const modeCount = Number(Boolean(itemId)) + Number(Boolean(throughEntryId)) + Number(ackAll);
+        if (positionalArgs(args, ["--agent-id", "--entry", "--through"]).length > 0 || modeCount !== 1) {
+            throw new Error("usage: agentinbox inbox ack [--agent-id ID] (--through <entryId> | --entry <entryId> | --all)");
         }
         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] }));
+        const response = await requestRemote(client, `/agents/${encodeURIComponent(selection.agentId)}/inbox/ack`, ackAll ? { all: true } : (throughEntryId ? { throughEntryId } : { entryIds: [itemId] }));
+        console.log((0, util_1.jsonResponse)(withCommandMetadata(response.data, selection)));
+        return;
+    }
+    if (command === "inbox" && normalized[1] === "policy" && normalized[2] === "show") {
+        const selection = await selectAgentForCommand(client, {
+            explicitAgentId: takeFlagValue(normalized, "--agent-id"),
+            autoRegister: true,
+        });
+        const response = await requestRemote(client, `/agents/${encodeURIComponent(selection.agentId)}/inbox/policy`, undefined, "GET");
+        console.log((0, util_1.jsonResponse)(withCommandMetadata(response.data, selection)));
+        return;
+    }
+    if (command === "inbox" && normalized[1] === "policy" && normalized[2] === "set") {
+        const selection = await selectAgentForCommand(client, {
+            explicitAgentId: takeFlagValue(normalized, "--agent-id"),
+            autoRegister: true,
+        });
+        const response = await requestRemote(client, `/agents/${encodeURIComponent(selection.agentId)}/inbox/policy`, {
+            enabled: hasFlag(normalized, "--enabled") ? true : (hasFlag(normalized, "--disabled") ? false : undefined),
+            windowMs: parseOptionalNumber(takeFlagValue(normalized, "--window-ms")),
+            maxItems: parseOptionalNumber(takeFlagValue(normalized, "--max-items")),
+            maxThreadAgeMs: parseOptionalNumber(takeFlagValue(normalized, "--max-thread-age-ms")),
+        });
         console.log((0, util_1.jsonResponse)(withCommandMetadata(response.data, selection)));
         return;
     }
@@ -526,9 +689,10 @@ async function main() {
         const targetRef = takeFlagValue(normalized, "--target");
         const kind = takeFlagValue(normalized, "--kind") ?? "reply";
         if (!provider || !surface || !targetRef) {
-            throw new Error("usage: agentinbox deliver send --provider PROVIDER --surface SURFACE --target TARGET [--kind KIND] [--payload-json JSON]");
+            throw new Error("usage: agentinbox deliver send --provider PROVIDER --surface SURFACE --target TARGET [--source-id SOURCE_ID] [--kind KIND] [--payload-json JSON]");
         }
         await printRemote(client, "/deliveries/send", {
+            sourceId: takeFlagValue(normalized, "--source-id") ?? undefined,
             provider,
             surface,
             targetRef,
@@ -539,6 +703,58 @@ async function main() {
         });
         return;
     }
+    if (command === "deliver" && normalized[1] === "actions") {
+        const provider = takeFlagValue(normalized, "--provider");
+        const surface = takeFlagValue(normalized, "--surface");
+        const targetRef = takeFlagValue(normalized, "--target");
+        const handleJson = takeFlagValue(normalized, "--handle-json");
+        if (!handleJson && (!provider || !surface || !targetRef)) {
+            throw new Error("usage: agentinbox deliver actions (--handle-json JSON | --provider PROVIDER --surface SURFACE --target TARGET) [--source-id SOURCE_ID]");
+        }
+        await printRemote(client, "/deliveries/actions", handleJson
+            ? {
+                sourceId: takeFlagValue(normalized, "--source-id") ?? undefined,
+                deliveryHandle: (0, util_1.parseJsonArg)(handleJson),
+            }
+            : {
+                sourceId: takeFlagValue(normalized, "--source-id") ?? undefined,
+                provider,
+                surface,
+                targetRef,
+                threadRef: takeFlagValue(normalized, "--thread") ?? undefined,
+                replyMode: takeFlagValue(normalized, "--reply-mode") ?? undefined,
+            });
+        return;
+    }
+    if (command === "deliver" && normalized[1] === "invoke") {
+        const provider = takeFlagValue(normalized, "--provider");
+        const surface = takeFlagValue(normalized, "--surface");
+        const targetRef = takeFlagValue(normalized, "--target");
+        const handleJson = takeFlagValue(normalized, "--handle-json");
+        const operation = takeFlagValue(normalized, "--operation");
+        const inputJson = takeFlagValue(normalized, "--input-json");
+        if (!operation || !inputJson || (!handleJson && (!provider || !surface || !targetRef))) {
+            throw new Error("usage: agentinbox deliver invoke (--handle-json JSON | --provider PROVIDER --surface SURFACE --target TARGET) --operation NAME --input-json JSON [--source-id SOURCE_ID]");
+        }
+        await printRemote(client, "/deliveries/invoke", handleJson
+            ? {
+                sourceId: takeFlagValue(normalized, "--source-id") ?? undefined,
+                deliveryHandle: (0, util_1.parseJsonArg)(handleJson),
+                operation,
+                input: (0, util_1.parseJsonArg)(inputJson, "--input-json"),
+            }
+            : {
+                sourceId: takeFlagValue(normalized, "--source-id") ?? undefined,
+                provider,
+                surface,
+                targetRef,
+                threadRef: takeFlagValue(normalized, "--thread") ?? undefined,
+                replyMode: takeFlagValue(normalized, "--reply-mode") ?? undefined,
+                operation,
+                input: (0, util_1.parseJsonArg)(inputJson, "--input-json"),
+            });
+        return;
+    }
     if (command === "status") {
         await printRemote(client, "/status", undefined, "GET");
         return;
@@ -555,27 +771,37 @@ async function main() {
 }
 async function runServe(args) {
     const port = parseOptionalNumber(takeFlagValue(args, "--port"));
+    const homeOverride = takeFlagValue(args, "--home");
     const serveConfig = (0, paths_1.resolveServeConfig)({
         env: process.env,
-        homeDirOverride: takeFlagValue(args, "--home"),
+        homeDirOverride: homeOverride,
         statePathOverride: takeFlagValue(args, "--state"),
         socketPathOverride: takeFlagValue(args, "--socket"),
         portOverride: port,
     });
+    const daemonPaths = (0, paths_1.resolveDaemonPaths)(process.env, homeOverride);
+    const logLevel = (0, logging_1.parseLogLevel)(takeFlagValue(args, "--log-level") ?? process.env.AGENTINBOX_LOG_LEVEL);
+    const logger = new logging_1.JsonLogger(logLevel, "agentinbox");
     const store = await store_1.AgentInboxStore.open(serveConfig.dbPath);
     let service;
     const adapters = new adapters_1.AdapterRegistry(store, async (input) => service.appendSourceEvent(input), {
         homeDir: serveConfig.homeDir,
     });
-    service = new service_1.AgentInboxService(store, adapters);
+    service = new service_1.AgentInboxService(store, adapters, undefined, undefined, undefined, undefined, undefined, logger.child("service"));
     const server = (0, http_1.createServer)(service);
     await adapters.start();
     await service.start();
     const controlServer = await (0, control_server_1.startControlServer)(server, serveConfig.transport);
-    const daemonPaths = (0, paths_1.resolveDaemonPaths)(process.env, takeFlagValue(args, "--home"));
     if (serveConfig.transport.kind === "socket") {
         (0, daemon_1.writePidFile)(daemonPaths.pidPath, process.pid);
     }
+    (0, daemon_1.writeDaemonMetadata)(daemonPaths.metadataPath, { logLevel });
+    logger.info("daemon.ready", {
+        homeDir: serveConfig.homeDir,
+        dbPath: serveConfig.dbPath,
+        transport: controlServer.info,
+        logLevel,
+    });
     console.log((0, util_1.jsonResponse)({
         ok: true,
         homeDir: serveConfig.homeDir,
@@ -590,6 +816,7 @@ async function runServe(args) {
             if (serveConfig.transport.kind === "socket") {
                 (0, daemon_1.removePidFile)(daemonPaths.pidPath);
             }
+            (0, daemon_1.removePidFile)(daemonPaths.metadataPath);
             process.exit(0);
         });
     };
@@ -603,6 +830,7 @@ async function runDaemon(args) {
         homeDirOverride: takeFlagValue(args, "--home"),
         socketPathOverride: takeFlagValue(args, "--socket"),
         baseUrlOverride: takeFlagValue(args, "--url"),
+        logLevelOverride: (0, logging_1.parseLogLevel)(takeFlagValue(args, "--log-level") ?? process.env.AGENTINBOX_LOG_LEVEL),
     };
     if (action === "start") {
         const result = await (0, daemon_1.startDaemon)(options);
@@ -888,41 +1116,63 @@ Commands:
         serve: `agentinbox serve
 
 Usage:
-  agentinbox serve [--home ~/.agentinbox] [--socket ~/.agentinbox/agentinbox.sock]
+  agentinbox serve [--home ~/.agentinbox] [--socket ~/.agentinbox/agentinbox.sock] [--log-level error|warn|info|debug|trace]
   agentinbox serve --port 4747 [--state ~/.agentinbox/agentinbox.sqlite]
 `,
         daemon: `agentinbox daemon
 
 Usage:
-  agentinbox daemon start [--home ~/.agentinbox] [--socket ~/.agentinbox/agentinbox.sock]
+  agentinbox daemon start [--home ~/.agentinbox] [--socket ~/.agentinbox/agentinbox.sock] [--log-level error|warn|info|debug|trace]
   agentinbox daemon stop [--home ~/.agentinbox] [--socket ~/.agentinbox/agentinbox.sock]
   agentinbox daemon status [--home ~/.agentinbox] [--socket ~/.agentinbox/agentinbox.sock]
+`,
+        host: `agentinbox host
+
+Usage:
+  agentinbox host add <hostType> <hostKey> [--config-json JSON] [--config-ref REF]
+  agentinbox host list
+  agentinbox host show <hostId>
+  agentinbox host schema <hostId>
+`,
+        stream: `agentinbox stream
+
+Usage:
+  agentinbox stream add <hostId> <streamKind> <streamKey> [--config-json JSON] [--config-ref REF]
+  agentinbox stream list
+  agentinbox stream show <streamId>
+  agentinbox stream update <streamId> [--config-json JSON] [--config-ref REF | --clear-config-ref]
+  agentinbox stream remove <streamId> [--with-subscriptions]
+  agentinbox stream pause <streamId>
+  agentinbox stream resume <streamId>
+  agentinbox stream schema <streamId>
+  agentinbox stream schema preview <sourceKind|sourceType> [--config-json JSON] [--config-ref REF]
+  agentinbox stream poll <streamId>
+  agentinbox stream event <streamId> --native-id ID --event EVENT [--occurred-at ISO8601] [--metadata-json JSON] [--payload-json JSON]
 `,
         source: `agentinbox source
 
 Usage:
-  agentinbox source add <type> <sourceKey> [--config-json JSON] [--config-ref REF]
+  agentinbox source add <hostId> <streamKind> <streamKey> [--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> [--with-subscriptions]
   agentinbox source pause <remoteSourceId>
   agentinbox source resume <remoteSourceId>
-  agentinbox source schema <sourceId|sourceType>
-  agentinbox source schema preview <sourceKind|sourceType> [--config-json JSON] [--config-ref REF]
+  agentinbox source schema <sourceId>
   agentinbox source poll <sourceId>
   agentinbox source event <sourceId> --native-id ID --event EVENT [--occurred-at ISO8601] [--metadata-json JSON] [--payload-json JSON]
 `,
         agent: `agentinbox agent
 
 Usage:
-  agentinbox agent register [--agent-id ID] [--force-rebind] [--notify-lease-ms N]
+  agentinbox agent register [--agent-id ID] [--force-rebind] [--notify-lease-ms N] [--min-unacked-items N]
   agentinbox agent list
   agentinbox agent current
   agentinbox agent show <agentId>
   agentinbox agent remove <agentId>
   agentinbox agent resume <agentId>
-  agentinbox agent target add webhook <agentId> --url URL [--activation-mode MODE] [--notify-lease-ms N]
+  agentinbox agent target add webhook <agentId> --url URL [--activation-mode MODE] [--notify-lease-ms N] [--min-unacked-items N]
   agentinbox agent target list <agentId>
   agentinbox agent target remove <agentId> <targetId>
   agentinbox agent target resume <agentId> <targetId>
@@ -952,16 +1202,20 @@ Usage:
 Usage:
   agentinbox inbox list
   agentinbox inbox show <agentId>
-  agentinbox inbox read [--agent-id ID] [--after-item ID] [--include-acked]
+  agentinbox inbox read [--agent-id ID] [--after-entry 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 watch [--agent-id ID] [--after-entry ID] [--include-acked] [--heartbeat-ms N]
+  agentinbox inbox ack [--agent-id ID] (--through <entryId> | --entry <entryId> | --all)
+  agentinbox inbox policy show [--agent-id ID]
+  agentinbox inbox policy set [--agent-id ID] [--enabled|--disabled] [--window-ms N] [--max-items N] [--max-thread-age-ms N]
   agentinbox inbox compact <agentId>
 `,
         deliver: `agentinbox deliver
 
 Usage:
-  agentinbox deliver send --provider PROVIDER --surface SURFACE --target TARGET [--kind KIND] [--payload-json JSON]
+  agentinbox deliver send --provider PROVIDER --surface SURFACE --target TARGET [--source-id SOURCE_ID] [--kind KIND] [--payload-json JSON]
+  agentinbox deliver actions (--handle-json JSON | --provider PROVIDER --surface SURFACE --target TARGET) [--source-id SOURCE_ID]
+  agentinbox deliver invoke (--handle-json JSON | --provider PROVIDER --surface SURFACE --target TARGET) --operation NAME --input-json JSON [--source-id SOURCE_ID]
 `,
         status: `agentinbox status
 

package/dist/src/client.js

@@ -19,8 +19,8 @@ class AgentInboxClient {
     }
     watchInbox(agentId, options = {}) {
         const query = new URLSearchParams();
-        if (options.afterItemId) {
-            query.set("after_item_id", options.afterItemId);
+        if (options.afterEntryId) {
+            query.set("after_entry_id", options.afterEntryId);
         }
         if (options.includeAcked) {
             query.set("include_acked", "true");