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

package/README.md

@@ -64,6 +64,22 @@ manually or relying on the agent runtime to expose its own notification API.
 - filtering and source model are still evolving
 - first-run onboarding is currently skill-first rather than wizard-first
 
+## v1.0.0 Beta Upgrade Notes
+
+`v1.0.0-beta.0` is the first release on the final v1 storage and API boundary.
+
+- pre-v1 local databases are archived and replaced with a fresh v1 database
+- old local state is not imported into the new v1 database
+- canonical public surfaces are now host + stream registration, entry/thread
+  inbox reads, and handle-scoped delivery operations
+- pre-v1 compatibility shims such as legacy source-kind registration aliases,
+  raw inbox-item read paths, and deprecated remote-module aliases are no longer
+  part of the supported surface
+
+If you are upgrading from any pre-v1 build, expect `AgentInbox` to archive the
+existing local database under `~/.agentinbox/` and start with a fresh v1
+database.
+
 ## Install
 
 Requires:
@@ -127,13 +143,21 @@ Register the current terminal session:
 ```bash
 agentinbox agent register
 agentinbox agent register --agent-id agent-alpha
+agentinbox agent register --notify-lease-ms 600000 --min-unacked-items 5
 agentinbox agent current
 ```
 
+`notifyLeaseMs` and `minUnackedItems` are target-facing notification policy:
+they control how often a target may be reminded and how many unacked items must
+accumulate before AgentInbox notifies it. Service-wide activation batching
+(`windowMs`, `maxItems`) and terminal gating heuristics remain daemon-level
+policy, not per-agent knobs.
+
 Create a local source and publish an event:
 
 ```bash
-agentinbox source add local_event local-demo
+agentinbox host add local_event local-demo
+agentinbox source add <host_id> events local-demo
 agentinbox subscription add <source_id>
 agentinbox subscription add <source_id> --agent-id <agent_id>
 agentinbox source schema <source_id>
@@ -144,10 +168,10 @@ cat filter.json | agentinbox subscription add <source_id> --filter-stdin
 agentinbox source event <source_id> --native-id demo-1 --event local.demo
 agentinbox inbox read
 agentinbox inbox read --agent-id <agent_id>
-agentinbox inbox ack --agent-id <agent_id> --through <last_item_id>
+agentinbox inbox ack --agent-id <agent_id> --through <last_entry_id>
 ```
 
-When acking a reviewed batch, prefer `--through <last_item_id>` over `--all`.
+When acking a reviewed batch, prefer `--through <last_entry_id>` over `--all`.
 That preserves the boundary of the items you actually inspected. Use
 `ack --all` only when you have intentionally verified that every current
 unacked item should be cleared.
@@ -257,10 +281,11 @@ Generate new SQLite migrations after schema changes:
 npm run db:migrations:generate
 ```
 
-`AgentInbox` now upgrades SQLite state with versioned SQL migrations in
-`drizzle/migrations`. On upgrade with pending migrations, the daemon creates a
-local backup next to the DB file (for example,
-`~/.agentinbox/agentinbox.sqlite.backup-<timestamp>`).
+`AgentInbox` now initializes SQLite state from a single v1 baseline migration in
+`drizzle/migrations`. If startup detects a pre-v1 local database, it archives
+that database next to the DB path (for example,
+`~/.agentinbox/agentinbox.sqlite.pre-v1.<timestamp>.bak`) and starts with a
+fresh v1 database; pre-v1 local data is not imported.
 
 ## License
 

package/dist/src/adapters.js

@@ -146,10 +146,65 @@ class AdapterRegistry {
         }
         return this.remoteSource.deriveInlinePreview(source, item);
     }
+    async deriveNotificationGrouping(source, item) {
+        if (source.sourceType === "local_event") {
+            return null;
+        }
+        return this.remoteSource.deriveNotificationGrouping(source, item);
+    }
+    async summarizeDigestThread(source, items, grouping) {
+        if (source.sourceType === "local_event") {
+            return null;
+        }
+        return this.remoteSource.summarizeDigestThread(source, items, grouping);
+    }
+    async listDeliveryOperations(source, handle) {
+        const module = await this.resolveDeliveryModule(source, handle);
+        if (!module?.listDeliveryOperations) {
+            return [];
+        }
+        return module.listDeliveryOperations({ handle, source });
+    }
+    async invokeDeliveryOperation(source, handle, operation, input, attempt) {
+        const module = await this.resolveDeliveryModule(source, handle);
+        if (!module?.invokeDeliveryOperation) {
+            throw new Error(`delivery operations are not supported for provider ${handle.provider}`);
+        }
+        return module.invokeDeliveryOperation({ handle, operation, input, attempt, source });
+    }
     status() {
         return {
             remote: this.remoteSource.status?.() ?? {},
         };
     }
+    async resolveDeliveryModule(source, handle) {
+        if (source) {
+            if (source.sourceType === "local_event") {
+                return null;
+            }
+            return this.remoteModuleRegistry.resolve(source, this.homeDir);
+        }
+        if (handle.provider === "github") {
+            return this.remoteModuleRegistry.resolve(syntheticBuiltinSource("github_repo"), this.homeDir);
+        }
+        if (handle.provider === "feishu") {
+            return this.remoteModuleRegistry.resolve(syntheticBuiltinSource("feishu_bot"), this.homeDir);
+        }
+        return null;
+    }
 }
 exports.AdapterRegistry = AdapterRegistry;
+function syntheticBuiltinSource(sourceType) {
+    return {
+        sourceId: `builtin:${sourceType}`,
+        hostId: `builtin-host:${sourceType}`,
+        streamKind: sourceType === "github_repo" ? "repo_events" : "message_events",
+        streamKey: sourceType,
+        sourceType,
+        sourceKey: sourceType,
+        status: "active",
+        createdAt: "",
+        updatedAt: "",
+        config: {},
+    };
+}

package/dist/src/backend.js

@@ -1,9 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.SqliteEventBusBackend = void 0;
-exports.streamIdForSource = streamIdForSource;
-exports.consumerIdForSubscription = consumerIdForSubscription;
-exports.defaultInboxIdForAgent = defaultInboxIdForAgent;
 exports.streamKeyForSource = streamKeyForSource;
 exports.toAppendResult = toAppendResult;
 const util_1 = require("./util");
@@ -18,7 +15,7 @@ class SqliteEventBusBackend {
             return existing;
         }
         const stream = {
-            streamId: streamIdForSource(input.sourceId),
+            streamId: (0, util_1.generateCanonicalId)("str"),
             sourceId: input.sourceId,
             streamKey: input.streamKey,
             backend: input.backend,
@@ -46,7 +43,7 @@ class SqliteEventBusBackend {
         }
         const nextOffset = this.resolveInitialOffset(input.streamId, input.startPolicy, input.startOffset ?? null, input.startTime ?? null);
         const consumer = {
-            consumerId: consumerIdForSubscription(input.subscriptionId),
+            consumerId: (0, util_1.generateCanonicalId)("con"),
             streamId: input.streamId,
             subscriptionId: input.subscriptionId,
             consumerKey: input.consumerKey,
@@ -154,17 +151,8 @@ class SqliteEventBusBackend {
     }
 }
 exports.SqliteEventBusBackend = SqliteEventBusBackend;
-function streamIdForSource(sourceId) {
-    return `stream_${sourceId}`;
-}
-function consumerIdForSubscription(subscriptionId) {
-    return `consumer_${subscriptionId}`;
-}
-function defaultInboxIdForAgent(agentId) {
-    return `inbox_${agentId}`;
-}
-function streamKeyForSource(sourceType, sourceKey) {
-    return `${sourceType}:${sourceKey}`;
+function streamKeyForSource(sourceId) {
+    return `source:${sourceId}`;
 }
 function toAppendResult(result) {
     return {

package/dist/src/cli.js

@@ -51,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")),
         });
@@ -126,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") {
@@ -187,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;
     }
@@ -226,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;
     }
@@ -432,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;
     }
@@ -467,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"),
@@ -481,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")),
         })) {
@@ -494,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;
     }
@@ -527,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,
@@ -540,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;
@@ -910,32 +1125,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 +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