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

package/dist/src/cli.js

@@ -19,8 +19,11 @@ const store_1 = require("./store");
 const terminal_1 = require("./terminal");
 const util_1 = require("./util");
 async function main() {
-    const args = process.argv.slice(2);
-    const normalized = normalizeHelpArgs(args);
+    const rawArgs = process.argv.slice(2);
+    const detectedArgs = normalizeHelpArgs(rawArgs);
+    const normalized = shouldTreatJsonFlagAsNoop(detectedArgs)
+        ? stripNoopJsonFlag(detectedArgs)
+        : detectedArgs;
     const command = normalized[0];
     if (!command || command === "help" || command === "--help" || command === "-h") {
         printHelp(normalized.slice(1));
@@ -51,14 +54,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")),
         });
@@ -126,27 +282,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") {
@@ -187,6 +327,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;
     }
@@ -226,13 +367,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;
     }
@@ -306,7 +448,7 @@ async function main() {
             startOffset: parseOptionalNumber(takeFlagValue(normalized, "--start-offset")),
             startTime: takeFlagValue(normalized, "--start-time") ?? undefined,
         });
-        console.log((0, util_1.jsonResponse)(withCommandMetadata(response.data, selection)));
+        console.log((0, util_1.jsonResponse)(withCommandMetadata(normalizeSubscriptionAddOutput(response.data, Boolean(shortcutName)), selection)));
         return;
     }
     if (command === "subscription" && normalized[1] === "list") {
@@ -432,19 +574,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;
     }
@@ -467,8 +609,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"),
@@ -481,7 +623,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")),
         })) {
@@ -494,18 +636,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;
     }
@@ -527,9 +692,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,
@@ -540,6 +706,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;
@@ -552,7 +770,7 @@ async function main() {
         printHelp([command]);
         return;
     }
-    throw new Error(`unknown command: ${args.join(" ")}`);
+    throw new Error(`unknown command: ${normalized.join(" ")}`);
 }
 async function runServe(args) {
     const port = parseOptionalNumber(takeFlagValue(args, "--port"));
@@ -785,6 +1003,26 @@ function normalizeHelpArgs(args) {
     }
     return [args[1], "--help"];
 }
+function stripNoopJsonFlag(args) {
+    return args.filter((arg) => arg !== "--json");
+}
+function shouldTreatJsonFlagAsNoop(args) {
+    if (!args.includes("--json")) {
+        return false;
+    }
+    const command = args[0];
+    if (!command) {
+        return false;
+    }
+    if (args.includes("--help") || args.includes("-h")) {
+        return false;
+    }
+    return command !== "help" &&
+        command !== "version" &&
+        command !== "--version" &&
+        command !== "-v" &&
+        command !== "serve";
+}
 function hasHelpFlag(args) {
     return args.includes("--help") || args.includes("-h");
 }
@@ -832,6 +1070,19 @@ function withCommandMetadata(data, selection) {
         ...(selection.warnings.length > 0 ? { warnings: selection.warnings } : {}),
     };
 }
+function normalizeSubscriptionAddOutput(data, shortcutUsed) {
+    if (shortcutUsed) {
+        return data;
+    }
+    const subscriptions = data.subscriptions;
+    if (Array.isArray(subscriptions) &&
+        subscriptions.length === 1 &&
+        subscriptions[0] &&
+        typeof subscriptions[0] === "object") {
+        return subscriptions[0];
+    }
+    return data;
+}
 function getRequiredTerminalContext() {
     try {
         return (0, terminal_1.detectTerminalContext)(process.env);
@@ -910,32 +1161,54 @@ Usage:
   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>
@@ -965,16 +1238,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");