@holon-run/agentinbox 1.0.3 → 1.0.5

package/dist/src/sources/github.js

@@ -46,7 +46,7 @@ class GithubUxcClient {
                 issue_number: input.issueNumber,
                 body: input.body,
             },
-            options: { auth: input.auth },
+            options: githubAuthOptions(input.auth),
         });
     }
     async replyToReviewComment(input) {
@@ -60,7 +60,7 @@ class GithubUxcClient {
                 comment_id: input.commentId,
                 body: input.body,
             },
-            options: { auth: input.auth },
+            options: githubAuthOptions(input.auth),
         });
     }
     async updateIssueState(input) {
@@ -73,7 +73,7 @@ class GithubUxcClient {
                 issue_number: input.issueNumber,
                 state: input.state,
             },
-            options: { auth: input.auth },
+            options: githubAuthOptions(input.auth),
         });
     }
     async mergePullRequest(input) {
@@ -88,7 +88,7 @@ class GithubUxcClient {
                 commit_title: input.commitTitle ?? null,
                 commit_message: input.commitMessage ?? null,
             },
-            options: { auth: input.auth },
+            options: githubAuthOptions(input.auth),
         });
     }
     async getPullRequestDetails(input) {
@@ -100,7 +100,7 @@ class GithubUxcClient {
                 repo: input.repo,
                 pull_number: input.pullNumber,
             },
-            options: { auth: input.auth },
+            options: githubReadOptions(input.auth),
         });
         const data = asRecord(response.data);
         const head = asRecord(data.head);
@@ -333,7 +333,7 @@ async function hydrateGithubRepoEventIfNeeded(config, raw, client = DEFAULT_GITH
                     per_page: perPage,
                     page,
                 },
-                options: { auth: config.uxcAuth },
+                options: githubReadOptions(config.uxcAuth),
             });
         }
         catch {
@@ -705,6 +705,15 @@ function computeGithubHydrationPerPage(perPage) {
         : GITHUB_EVENT_HYDRATION_MIN_PER_PAGE;
     return Math.min(GITHUB_EVENT_HYDRATION_MAX_PER_PAGE, Math.max(GITHUB_EVENT_HYDRATION_MIN_PER_PAGE, configured));
 }
+function githubAuthOptions(auth) {
+    return { auth };
+}
+function githubReadOptions(auth) {
+    return {
+        auth,
+        artifact_compaction: false,
+    };
+}
 function extractGithubRepoEventUrl(event, issue, pullRequest, review, comment) {
     return (asString(comment.html_url)
         ?? asString(review.html_url)

package/dist/src/sources/remote.js

@@ -302,6 +302,30 @@ class RemoteSourceRuntime {
         }
         return module.summarizeDigestThread(items, moduleInputSource(source), grouping);
     }
+    async listSourceOperations(source) {
+        if (!REMOTE_SOURCE_TYPES.has(source.sourceType)) {
+            return [];
+        }
+        const module = await this.moduleRegistry.resolve(source, this.homeDir);
+        if (typeof module.listSourceOperations !== "function") {
+            return [];
+        }
+        return module.listSourceOperations({ source: moduleInputSource(source) });
+    }
+    async invokeSourceOperation(source, operation, input) {
+        if (!REMOTE_SOURCE_TYPES.has(source.sourceType)) {
+            throw new Error(`source operations are not supported for source type ${source.sourceType}`);
+        }
+        const module = await this.moduleRegistry.resolve(source, this.homeDir);
+        if (typeof module.invokeSourceOperation !== "function") {
+            throw new Error(`source operations are not supported for source type ${source.sourceType}`);
+        }
+        return module.invokeSourceOperation({
+            source: moduleInputSource(source),
+            operation,
+            input,
+        });
+    }
     async syncAll() {
         const sources = this.store
             .listSources()
@@ -391,6 +415,7 @@ class RemoteSourceRuntime {
                     occurredAt: mapped.occurredAt,
                     metadata: mapped.metadata,
                     rawPayload: mapped.rawPayload,
+                    providerRawPayload: mapped.providerRawPayload,
                     deliveryHandle: mapped.deliveryHandle ?? null,
                 });
                 appended += result.appended;

package/dist/src/sources/remote_modules.js

@@ -111,6 +111,8 @@ function validateModuleContract(module, sourcePath) {
     validateOptionalHook(module.deriveNotificationGrouping, "deriveNotificationGrouping", sourcePath);
     validateOptionalHook(module.listDeliveryOperations, "listDeliveryOperations", sourcePath);
     validateOptionalHook(module.invokeDeliveryOperation, "invokeDeliveryOperation", sourcePath);
+    validateOptionalHook(module.listSourceOperations, "listSourceOperations", sourcePath);
+    validateOptionalHook(module.invokeSourceOperation, "invokeSourceOperation", sourcePath);
     validateOptionalHook(module.summarizeDigestThread, "summarizeDigestThread", sourcePath);
 }
 function validateOptionalHook(value, name, sourcePath) {
@@ -297,7 +299,10 @@ function createGithubRepoRemoteModule(options) {
                         seen_window: 1024,
                     },
                 },
-                options: { auth: config.uxcAuth },
+                options: {
+                    auth: config.uxcAuth,
+                    artifact_compaction: false,
+                },
             };
         },
         async mapRawEvent(rawPayload, source) {
@@ -312,6 +317,7 @@ function createGithubRepoRemoteModule(options) {
                 eventVariant: normalized.eventVariant,
                 metadata: normalized.metadata ?? {},
                 rawPayload: normalized.rawPayload ?? hydratedPayload,
+                providerRawPayload: hydratedPayload,
                 occurredAt: normalized.occurredAt,
                 deliveryHandle: normalized.deliveryHandle,
             };
@@ -434,7 +440,10 @@ const GITHUB_REPO_CI_MODULE = {
                     seen_window: 1024,
                 },
             },
-            options: { auth: config.uxcAuth },
+            options: {
+                auth: config.uxcAuth,
+                artifact_compaction: false,
+            },
         };
     },
     mapRawEvent(rawPayload, source) {
@@ -448,6 +457,7 @@ const GITHUB_REPO_CI_MODULE = {
             eventVariant: normalized.eventVariant,
             metadata: normalized.metadata ?? {},
             rawPayload: normalized.rawPayload ?? rawPayload,
+            providerRawPayload: rawPayload,
             occurredAt: normalized.occurredAt,
             deliveryHandle: normalized.deliveryHandle,
         };
@@ -461,18 +471,22 @@ const FEISHU_BOT_MODULE = {
     async invokeDeliveryOperation(input) {
         return (0, feishu_1.invokeFeishuDeliveryOperation)(input.handle, input.operation, input.input);
     },
+    listSourceOperations() {
+        return (0, feishu_1.feishuSourceOperations)();
+    },
+    async invokeSourceOperation(input) {
+        return (0, feishu_1.invokeFeishuSourceOperation)(input.source, input.operation, input.input);
+    },
     describeCapabilities() {
         return {
             sourceKind: "feishu_bot",
             aliases: ["feishu_bot"],
             configSchema: [
-                { name: "appId", type: "string", required: true, description: "Feishu app ID." },
-                { name: "appSecret", type: "string", required: true, description: "Feishu app secret." },
+                { name: "uxcAuth", type: "string", required: false, description: "Optional UXC auth profile for the Feishu/Lark app." },
                 { name: "eventTypes", type: "string[]", required: false, description: "Optional Feishu event type allowlist." },
                 { name: "chatIds", type: "string[]", required: false, description: "Optional Feishu chat allowlist." },
                 { name: "schemaUrl", type: "string", required: false, description: "Optional Feishu OpenAPI schema URL." },
                 { name: "replyInThread", type: "boolean", required: false, description: "Reply in thread when sending outbound messages." },
-                { name: "uxcAuth", type: "string", required: false, description: "Optional uxc auth profile." },
             ],
             metadataFields: [
                 { name: "eventType", type: "string", description: "Feishu event type." },
@@ -494,13 +508,22 @@ const FEISHU_BOT_MODULE = {
     validateConfig(source) {
         (0, feishu_1.parseFeishuSourceConfig)(source);
     },
+    listFollowTemplates() {
+        return (0, feishu_1.feishuFollowTemplateSpec)();
+    },
+    async expandFollowTemplate(input) {
+        return (0, feishu_1.expandFeishuFollowTemplate)(input);
+    },
     buildManagedSourceSpec(source) {
         const config = (0, feishu_1.parseFeishuSourceConfig)(source);
         return {
             endpoint: config.endpoint ?? feishu_1.FEISHU_OPENAPI_ENDPOINT,
             mode: "stream",
             transport_hint: "feishu_long_connection",
-            options: { auth: config.uxcAuth },
+            options: {
+                auth: config.uxcAuth,
+                artifact_compaction: false,
+            },
         };
     },
     mapRawEvent(rawPayload, source) {
@@ -514,6 +537,7 @@ const FEISHU_BOT_MODULE = {
             eventVariant: normalized.eventVariant,
             metadata: normalized.metadata ?? {},
             rawPayload: normalized.rawPayload ?? rawPayload,
+            providerRawPayload: rawPayload,
             occurredAt: normalized.occurredAt,
             deliveryHandle: normalized.deliveryHandle,
         };

package/dist/src/store.js

@@ -288,8 +288,10 @@ class AgentInboxStore {
         ]);
         this.persist();
     }
-    listSourceHosts() {
-        const rows = this.getAll("select * from source_hosts order by created_at asc");
+    listSourceHosts(limit) {
+        const rows = typeof limit === "number"
+            ? this.getAll("select * from source_hosts order by created_at asc, host_id asc limit ?", [limit])
+            : this.getAll("select * from source_hosts order by created_at asc, host_id asc");
         return rows.map((row) => this.mapSourceHost(row));
     }
     updateSourceHostDefinition(hostId, input) {
@@ -362,8 +364,10 @@ class AgentInboxStore {
         });
         this.persist();
     }
-    listSources() {
-        const rows = this.getAll("select * from sources order by created_at asc");
+    listSources(limit) {
+        const rows = typeof limit === "number"
+            ? this.getAll("select * from sources order by created_at asc, source_id asc limit ?", [limit])
+            : this.getAll("select * from sources order by created_at asc, source_id asc");
         return rows.map((row) => this.mapSource(row));
     }
     getSourceIdleState(sourceId) {
@@ -505,8 +509,10 @@ class AgentInboxStore {
         this.persist();
         return this.getAgent(agentId);
     }
-    listAgents() {
-        const rows = this.getAll("select * from agents order by created_at asc");
+    listAgents(limit) {
+        const rows = typeof limit === "number"
+            ? this.getAll("select * from agents order by created_at asc, agent_id asc limit ?", [limit])
+            : this.getAll("select * from agents order by created_at asc, agent_id asc");
         return rows.map((row) => this.mapAgent(row));
     }
     getInbox(inboxId) {
@@ -556,8 +562,10 @@ class AgentInboxStore {
         this.persist();
         return this.getInbox(inboxId);
     }
-    listInboxes() {
-        const rows = this.getAll("select * from inboxes order by created_at asc");
+    listInboxes(limit) {
+        const rows = typeof limit === "number"
+            ? this.getAll("select * from inboxes order by created_at asc, inbox_id asc limit ?", [limit])
+            : this.getAll("select * from inboxes order by created_at asc, inbox_id asc");
         return rows.map((row) => this.mapInbox(row));
     }
     getSubscription(subscriptionId) {
@@ -583,16 +591,41 @@ class AgentInboxStore {
         ]);
         this.persist();
     }
-    listSubscriptions() {
-        const rows = this.getAll("select * from subscriptions order by created_at asc");
+    listSubscriptions(limit) {
+        const rows = typeof limit === "number"
+            ? this.getAll("select * from subscriptions order by created_at asc, subscription_id asc limit ?", [limit])
+            : this.getAll("select * from subscriptions order by created_at asc, subscription_id asc");
         return rows.map((row) => this.mapSubscription(row));
     }
-    listSubscriptionsForSource(sourceId) {
-        const rows = this.getAll("select * from subscriptions where source_id = ? order by created_at asc", [sourceId]);
+    listSubscriptionsFiltered(filters) {
+        const clauses = [];
+        const params = [];
+        if (filters?.sourceId) {
+            clauses.push("source_id = ?");
+            params.push(filters.sourceId);
+        }
+        if (filters?.agentId) {
+            clauses.push("agent_id = ?");
+            params.push(filters.agentId);
+        }
+        const where = clauses.length > 0 ? ` where ${clauses.join(" and ")}` : "";
+        const limitClause = typeof filters?.limit === "number" ? " limit ?" : "";
+        if (typeof filters?.limit === "number") {
+            params.push(filters.limit);
+        }
+        const rows = this.getAll(`select * from subscriptions${where} order by created_at asc, subscription_id asc${limitClause}`, params);
+        return rows.map((row) => this.mapSubscription(row));
+    }
+    listSubscriptionsForSource(sourceId, limit) {
+        const rows = typeof limit === "number"
+            ? this.getAll("select * from subscriptions where source_id = ? order by created_at asc, subscription_id asc limit ?", [sourceId, limit])
+            : this.getAll("select * from subscriptions where source_id = ? order by created_at asc, subscription_id asc", [sourceId]);
         return rows.map((row) => this.mapSubscription(row));
     }
-    listSubscriptionsForAgent(agentId) {
-        const rows = this.getAll("select * from subscriptions where agent_id = ? order by created_at asc", [agentId]);
+    listSubscriptionsForAgent(agentId, limit) {
+        const rows = typeof limit === "number"
+            ? this.getAll("select * from subscriptions where agent_id = ? order by created_at asc, subscription_id asc limit ?", [agentId, limit])
+            : this.getAll("select * from subscriptions where agent_id = ? order by created_at asc, subscription_id asc", [agentId]);
         return rows.map((row) => this.mapSubscription(row));
     }
     listSubscriptionsForHostTrackedResourceRef(hostId, trackedResourceRef) {
@@ -821,12 +854,16 @@ class AgentInboxStore {
         this.persist();
         return this.getActivationTarget(targetId);
     }
-    listActivationTargets() {
-        const rows = this.getAll("select * from activation_targets order by created_at asc");
+    listActivationTargets(limit) {
+        const rows = typeof limit === "number"
+            ? this.getAll("select * from activation_targets order by created_at asc, target_id asc limit ?", [limit])
+            : this.getAll("select * from activation_targets order by created_at asc, target_id asc");
         return rows.map((row) => this.mapActivationTarget(row));
     }
-    listActivationTargetsForAgent(agentId) {
-        const rows = this.getAll("select * from activation_targets where agent_id = ? order by created_at asc", [agentId]);
+    listActivationTargetsForAgent(agentId, limit) {
+        const rows = typeof limit === "number"
+            ? this.getAll("select * from activation_targets where agent_id = ? order by created_at asc, target_id asc limit ?", [agentId, limit])
+            : this.getAll("select * from activation_targets where agent_id = ? order by created_at asc, target_id asc", [agentId]);
         return rows.map((row) => this.mapActivationTarget(row));
     }
     deleteActivationTarget(agentId, targetId) {
@@ -902,12 +939,16 @@ class AgentInboxStore {
         const row = this.getOne("select * from timers where schedule_id = ?", [scheduleId]);
         return row ? this.mapTimer(row) : null;
     }
-    listTimers() {
-        const rows = this.getAll("select * from timers order by created_at asc");
+    listTimers(limit) {
+        const rows = typeof limit === "number"
+            ? this.getAll("select * from timers order by created_at asc, schedule_id asc limit ?", [limit])
+            : this.getAll("select * from timers order by created_at asc, schedule_id asc");
         return rows.map((row) => this.mapTimer(row));
     }
-    listTimersForAgent(agentId) {
-        const rows = this.getAll("select * from timers where agent_id = ? order by created_at asc", [agentId]);
+    listTimersForAgent(agentId, limit) {
+        const rows = typeof limit === "number"
+            ? this.getAll("select * from timers where agent_id = ? order by created_at asc, schedule_id asc limit ?", [agentId, limit])
+            : this.getAll("select * from timers where agent_id = ? order by created_at asc, schedule_id asc", [agentId]);
         return rows.map((row) => this.mapTimer(row));
     }
     listDueTimers(cutoffIso) {
@@ -1015,8 +1056,8 @@ class AgentInboxStore {
         this.db.run(`
       insert or ignore into inbox_items (
         item_id, source_id, source_native_id, event_variant, inbox_id, occurred_at,
-        metadata_json, raw_payload_json, delivery_handle_json, acked_at
-      ) values (?, ?, ?, ?, ?, ?, ?, ?, ?, ?)
+        metadata_json, raw_payload_json, provider_raw_payload_json, delivery_handle_json, acked_at
+      ) values (?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?)
     `, [
             item.itemId,
             item.sourceId,
@@ -1026,6 +1067,7 @@ class AgentInboxStore {
             item.occurredAt,
             JSON.stringify(item.metadata),
             JSON.stringify(item.rawPayload),
+            item.providerRawPayload ? JSON.stringify(item.providerRawPayload) : null,
             item.deliveryHandle ? JSON.stringify(item.deliveryHandle) : null,
             item.ackedAt ?? null,
         ]);
@@ -1059,6 +1101,7 @@ class AgentInboxStore {
                 occurredAt: item.occurredAt,
                 metadata: item.metadata,
                 rawPayload: item.rawPayload,
+                providerRawPayload: item.providerRawPayload,
                 deliveryHandle: item.deliveryHandle ?? null,
             }),
             count: 1,
@@ -1092,7 +1135,11 @@ class AgentInboxStore {
             filters.push("sequence > ?");
             params.push(Number(anchor.sequence));
         }
-        const rows = this.getAll(`select * from inbox_entries where ${filters.join(" and ")} order by sequence asc`, params);
+        const sql = `select * from inbox_entries where ${filters.join(" and ")} order by sequence asc${typeof options?.limit === "number" ? " limit ?" : ""}`;
+        if (typeof options?.limit === "number") {
+            params.push(options.limit);
+        }
+        const rows = this.getAll(sql, params);
         return this.mapInboxEntries(rows);
     }
     getInboxEntry(entryId) {
@@ -1273,7 +1320,11 @@ class AgentInboxStore {
         if (!includeAcked) {
             filters.push("acked_at is null");
         }
-        const rows = this.getAll(`select * from inbox_items where ${filters.join(" and ")} order by coalesce(inbox_sequence, rowid) asc`, params);
+        const sql = `select * from inbox_items where ${filters.join(" and ")} order by coalesce(inbox_sequence, rowid) asc${typeof options?.limit === "number" ? " limit ?" : ""}`;
+        if (typeof options?.limit === "number") {
+            params.push(options.limit);
+        }
+        const rows = this.getAll(sql, params);
         return rows.map((row) => this.mapInboxItem(row));
     }
     ackItems(inboxId, itemIds, ackedAt) {
@@ -1406,8 +1457,10 @@ class AgentInboxStore {
         const row = this.getOne("select * from streams where stream_id = ?", [streamId]);
         return row ? this.mapStream(row) : null;
     }
-    listStreams() {
-        const rows = this.getAll("select * from streams order by created_at asc");
+    listStreams(limit) {
+        const rows = typeof limit === "number"
+            ? this.getAll("select * from streams order by created_at asc, stream_id asc limit ?", [limit])
+            : this.getAll("select * from streams order by created_at asc, stream_id asc");
         return rows.map((row) => this.mapStream(row));
     }
     getStreamBySourceId(sourceId) {
@@ -1418,14 +1471,15 @@ class AgentInboxStore {
         const occurredAt = event.occurredAt ?? (0, util_1.nowIso)();
         const metadataJson = JSON.stringify(event.metadata ?? {});
         const rawPayloadJson = JSON.stringify(event.rawPayload ?? {});
+        const providerRawPayloadJson = event.providerRawPayload ? JSON.stringify(event.providerRawPayload) : null;
         const deliveryHandleJson = event.deliveryHandle ? JSON.stringify(event.deliveryHandle) : null;
         for (let attempt = 0; attempt < 5; attempt += 1) {
             const before = this.changes();
             this.db.run(`
         insert or ignore into stream_events (
           stream_event_id, stream_id, source_id, source_native_id, event_variant,
-          occurred_at, metadata_json, raw_payload_json, delivery_handle_json, created_at
-        ) values (?, ?, ?, ?, ?, ?, ?, ?, ?, ?)
+          occurred_at, metadata_json, raw_payload_json, provider_raw_payload_json, delivery_handle_json, created_at
+        ) values (?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?)
       `, [
                 (0, util_1.generateCanonicalId)("evt"),
                 streamId,
@@ -1435,6 +1489,7 @@ class AgentInboxStore {
                 occurredAt,
                 metadataJson,
                 rawPayloadJson,
+                providerRawPayloadJson,
                 deliveryHandleJson,
                 (0, util_1.nowIso)(),
             ]);
@@ -1821,6 +1876,9 @@ class AgentInboxStore {
             occurredAt: String(row.occurred_at),
             metadata: parseJson(row.metadata_json),
             rawPayload: parseJson(row.raw_payload_json),
+            providerRawPayload: row.provider_raw_payload_json
+                ? parseJson(row.provider_raw_payload_json)
+                : undefined,
             deliveryHandle: row.delivery_handle_json
                 ? parseJson(row.delivery_handle_json)
                 : null,
@@ -1858,6 +1916,7 @@ class AgentInboxStore {
                 occurredAt: item.occurredAt,
                 metadata: item.metadata,
                 rawPayload: item.rawPayload,
+                providerRawPayload: item.providerRawPayload,
                 item,
             };
         }
@@ -2130,6 +2189,9 @@ class AgentInboxStore {
             occurredAt: String(row.occurred_at),
             metadata: parseJson(row.metadata_json),
             rawPayload: parseJson(row.raw_payload_json),
+            providerRawPayload: row.provider_raw_payload_json
+                ? parseJson(row.provider_raw_payload_json)
+                : undefined,
             deliveryHandle: row.delivery_handle_json
                 ? parseJson(row.delivery_handle_json)
                 : null,

package/drizzle/migrations/0004_provider_raw_payload.sql

@@ -0,0 +1,3 @@
+alter table inbox_items add column provider_raw_payload_json text;
+
+alter table stream_events add column provider_raw_payload_json text;

package/drizzle/schema.ts

@@ -173,6 +173,7 @@ export const inboxItems = sqliteTable("inbox_items", {
   occurredAt: text("occurred_at").notNull(),
   metadataJson: text("metadata_json").notNull(),
   rawPayloadJson: text("raw_payload_json").notNull(),
+  providerRawPayloadJson: text("provider_raw_payload_json"),
   deliveryHandleJson: text("delivery_handle_json"),
   ackedAt: text("acked_at"),
 }, (table) => ({
@@ -302,6 +303,7 @@ export const streamEvents = sqliteTable("stream_events", {
   occurredAt: text("occurred_at").notNull(),
   metadataJson: text("metadata_json").notNull(),
   rawPayloadJson: text("raw_payload_json").notNull(),
+  providerRawPayloadJson: text("provider_raw_payload_json"),
   deliveryHandleJson: text("delivery_handle_json"),
   createdAt: text("created_at").notNull(),
 }, (table) => ({

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@holon-run/agentinbox",
-  "version": "1.0.3",
+  "version": "1.0.5",
   "description": "Local event subscription and delivery service for agents.",
   "license": "Apache-2.0",
   "repository": {
@@ -44,7 +44,8 @@
   },
   "dependencies": {
     "@fastify/swagger": "^9.5.2",
-    "@holon-run/uxc-daemon-client": "^0.15.3",
+    "@holon-run/uxc-daemon-client": "^0.15.4",
+    "commander": "^14.0.3",
     "fastify": "^5.6.1",
     "jexl": "^2.3.0",
     "sql.js": "^1.13.0"

package/skills/README.md

@@ -7,12 +7,12 @@ For `AgentInbox`, the preferred first-run path is skill-first onboarding:
 
 - hand the bundled `AgentInbox` skill to the agent
 - let the agent verify `agentinbox`, `uxc`, and GitHub auth
-- let the agent register the current session and set up standing subscriptions
+- let the agent register the current runtime/session and set up standing subscriptions
 
 <!-- INDEX:START -->
 
 - [agentinbox](./agentinbox/)
-  Use the local AgentInbox service to onboard the current session, connect GitHub through UXC, and operate sources, subscriptions, and the agent inbox.
+  Use the local AgentInbox service to onboard the current runtime/session, manage shared sources and subscriptions, connect external providers such as GitHub through UXC, and operate the agent inbox.
   <!-- mdorigin:index kind=article -->
 
 <!-- INDEX:END -->