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

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` was 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,14 @@ 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`.
+The HTTP `POST /subscriptions` endpoint always returns
+`{ "subscriptions": [...] }`, even when only one subscription is created. That
+keeps shortcut expansion consistent for external callers.
+
+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 +285,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 {