@holon-run/agentinbox 1.0.3 → 1.0.4

package/dist/src/cli.js

@@ -57,7 +57,7 @@ async function main() {
         printHelp([command]);
         return;
     }
-    const client = await createClient(normalized);
+    const client = await createClient(clientArgsForCommand(normalized));
     if (command === "host" && normalized[1] === "add") {
         const [hostType, hostKey] = normalized.slice(2, 4);
         if (!hostType || !hostKey) {
@@ -72,7 +72,10 @@ async function main() {
         return;
     }
     if (command === "host" && normalized[1] === "list") {
-        await printRemote(client, "/hosts", undefined, "GET");
+        const query = buildQuery({
+            limit: parseOptionalLimitArg(normalized),
+        });
+        await printRemote(client, `/hosts${query}`, undefined, "GET");
         return;
     }
     if (command === "host" && normalized[1] === "show") {
@@ -106,7 +109,10 @@ async function main() {
         return;
     }
     if (command === "stream" && normalized[1] === "list") {
-        await printRemote(client, "/streams", undefined, "GET");
+        const query = buildQuery({
+            limit: parseOptionalLimitArg(normalized),
+        });
+        await printRemote(client, `/streams${query}`, undefined, "GET");
         return;
     }
     if (command === "stream" && normalized[1] === "show") {
@@ -266,7 +272,10 @@ async function main() {
         return;
     }
     if (command === "source" && normalized[1] === "list") {
-        await printRemote(client, "/sources", undefined, "GET");
+        const query = buildQuery({
+            limit: parseOptionalLimitArg(normalized),
+        });
+        await printRemote(client, `/sources${query}`, undefined, "GET");
         return;
     }
     if (command === "source" && normalized[1] === "show") {
@@ -363,15 +372,18 @@ async function main() {
         const notifyLeaseMs = parseOptionalNumber(takeFlagValue(normalized, "--notify-lease-ms")) ?? undefined;
         const minUnackedItems = parseOptionalNumber(takeFlagValue(normalized, "--min-unacked-items")) ?? undefined;
         const webhookUrl = takeFlagValue(normalized, "--webhook-url");
+        const holonContext = (0, current_agent_1.detectHolonRuntimeContext)(process.env);
         if (webhookUrl) {
-            if (!agentId) {
-                throw new Error("usage: agentinbox agent register --agent-id ID --webhook-url URL [--webhook-activation-mode MODE] [--webhook-notify-lease-ms N] [--webhook-min-unacked-items N]");
+            const resolvedAgentId = agentId ?? holonContext?.agentId;
+            if (!resolvedAgentId) {
+                throw new Error("usage: agentinbox agent register --agent-id ID --webhook-url URL [--webhook-activation-mode MODE] [--webhook-notify-lease-ms N] [--webhook-min-unacked-items N] (or set HOLON_AGENT_ID in Holon)");
             }
             const webhookNotifyLeaseMs = parseOptionalNumber(takeFlagValue(normalized, "--webhook-notify-lease-ms")) ?? notifyLeaseMs;
             const webhookMinUnackedItems = parseOptionalNumber(takeFlagValue(normalized, "--webhook-min-unacked-items")) ?? minUnackedItems;
             await printRemote(client, "/agents", {
-                agentId,
+                agentId: resolvedAgentId,
                 forceRebind: normalized.includes("--force-rebind"),
+                ...(holonContext ? { runtimeKind: holonContext.runtimeKind } : {}),
                 webhook: {
                     url: webhookUrl,
                     activationMode: takeFlagValue(normalized, "--webhook-activation-mode") ?? undefined,
@@ -381,6 +393,28 @@ async function main() {
             });
             return;
         }
+        if ((0, current_agent_1.isHolonRuntimeEnv)(process.env)) {
+            if (!holonContext) {
+                throw new Error("agent register in Holon requires HOLON_AGENT_ID");
+            }
+            if (!holonContext.externalTriggerUrl) {
+                throw new Error("agent register in Holon requires --webhook-url or HOLON_EXTERNAL_TRIGGER_URL");
+            }
+            const webhookNotifyLeaseMs = parseOptionalNumber(takeFlagValue(normalized, "--webhook-notify-lease-ms")) ?? notifyLeaseMs;
+            const webhookMinUnackedItems = parseOptionalNumber(takeFlagValue(normalized, "--webhook-min-unacked-items")) ?? minUnackedItems;
+            await printRemote(client, "/agents", {
+                agentId: agentId ?? holonContext.agentId,
+                forceRebind: normalized.includes("--force-rebind"),
+                runtimeKind: holonContext.runtimeKind,
+                webhook: {
+                    url: holonContext.externalTriggerUrl,
+                    activationMode: takeFlagValue(normalized, "--webhook-activation-mode") ?? undefined,
+                    notifyLeaseMs: webhookNotifyLeaseMs,
+                    minUnackedItems: webhookMinUnackedItems,
+                },
+            });
+            return;
+        }
         const detected = (0, terminal_1.detectTerminalContext)(process.env);
         await printRemote(client, "/agents", {
             agentId,
@@ -399,7 +433,7 @@ async function main() {
         return;
     }
     if (command === "agent" && normalized[1] === "list") {
-        await printAgentList(client);
+        await printAgentList(client, parseOptionalLimitArg(normalized));
         return;
     }
     if (command === "agent" && normalized[1] === "current") {
@@ -448,9 +482,12 @@ async function main() {
     if (command === "agent" && normalized[1] === "target" && normalized[2] === "list") {
         const agentId = normalized[3];
         if (!agentId) {
-            throw new Error("usage: agentinbox agent target list <agentId>");
+            throw new Error("usage: agentinbox agent target list <agentId> [--limit N]");
         }
-        await printRemote(client, `/agents/${encodeURIComponent(agentId)}/targets`, undefined, "GET");
+        const query = buildQuery({
+            limit: parseOptionalLimitArg(normalized),
+        });
+        await printRemote(client, `/agents/${encodeURIComponent(agentId)}/targets${query}`, undefined, "GET");
         return;
     }
     if (command === "agent" && normalized[1] === "target" && normalized[2] === "remove") {
@@ -522,6 +559,7 @@ async function main() {
         const query = buildQuery({
             source_id: takeFlagValue(normalized, "--source-id"),
             agent_id: takeFlagValue(normalized, "--agent-id"),
+            limit: parseOptionalLimitArg(normalized),
         });
         await printRemote(client, `/subscriptions${query}`, undefined, "GET");
         return;
@@ -599,6 +637,7 @@ async function main() {
     if (command === "timer" && normalized[1] === "list") {
         const query = buildQuery({
             agent_id: takeFlagValue(normalized, "--agent-id"),
+            limit: parseOptionalLimitArg(normalized),
         });
         await printRemote(client, `/timers${query}`, undefined, "GET");
         return;
@@ -628,7 +667,10 @@ async function main() {
         return;
     }
     if (command === "inbox" && normalized[1] === "list") {
-        await printRemote(client, "/agents", undefined, "GET");
+        const query = buildQuery({
+            limit: parseOptionalLimitArg(normalized),
+        });
+        await printRemote(client, `/agents${query}`, undefined, "GET");
         return;
     }
     if (command === "inbox" && normalized[1] === "show") {
@@ -641,9 +683,9 @@ async function main() {
     }
     if (command === "inbox" && normalized[1] === "read") {
         const args = normalized.slice(2);
-        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 allowedFlags = ["--agent-id", "--after-entry", "--include-acked", "--limit"];
+        if (positionalArgs(args, ["--agent-id", "--after-entry", "--limit"]).length > 0 || unexpectedFlags(args, allowedFlags).length > 0) {
+            throw new Error("usage: agentinbox inbox read [--agent-id ID] [--after-entry ID] [--include-acked] [--limit N]");
         }
         const selection = await selectAgentForCommand(client, {
             explicitAgentId: takeFlagValue(normalized, "--agent-id"),
@@ -652,6 +694,7 @@ async function main() {
         const query = buildQuery({
             after_entry_id: takeFlagValue(normalized, "--after-entry"),
             include_acked: hasFlag(normalized, "--include-acked") ? "true" : undefined,
+            limit: parseOptionalLimitArg(normalized),
         });
         const response = await requestRemote(client, `/agents/${encodeURIComponent(selection.agentId)}/inbox/entries${query}`, undefined, "GET");
         console.log((0, util_1.jsonResponse)(withCommandMetadata(response.data, selection)));
@@ -925,12 +968,12 @@ async function createClient(args) {
     });
     return new client_1.AgentInboxClient(transport);
 }
-async function printAgentList(client) {
-    const records = await listAgentsWithTargets(client);
-    console.log((0, util_1.jsonResponse)((0, current_agent_1.annotateAgents)(records, tryDetectTerminalContext())));
+async function printAgentList(client, limit) {
+    const records = await listAgentsWithTargets(client, limit);
+    console.log((0, util_1.jsonResponse)((0, current_agent_1.annotateAgents)(records, tryDetectCurrentAgentContext())));
 }
 async function printCurrentAgent(client) {
-    const context = getRequiredTerminalContext();
+    const context = getRequiredCurrentAgentContext();
     const records = await listAgentsWithTargets(client);
     const current = (0, current_agent_1.resolveCurrentAgent)(records, context);
     if (!current) {
@@ -940,7 +983,7 @@ async function printCurrentAgent(client) {
 }
 async function selectAgentForCommand(client, options) {
     const records = await listAgentsWithTargets(client);
-    const context = tryDetectTerminalContext();
+    const context = tryDetectCurrentAgentContext();
     if (options.explicitAgentId) {
         const current = context ? (0, current_agent_1.resolveCurrentAgent)(records, context) : null;
         const requested = records.find((entry) => entry.agent.agentId === options.explicitAgentId);
@@ -960,7 +1003,7 @@ async function selectAgentForCommand(client, options) {
             warnings,
         };
     }
-    const contextForCurrent = getRequiredTerminalContext();
+    const contextForCurrent = getRequiredCurrentAgentContext();
     const current = (0, current_agent_1.resolveCurrentAgent)(records, contextForCurrent);
     if (current) {
         return {
@@ -972,17 +1015,7 @@ async function selectAgentForCommand(client, options) {
     if (!options.autoRegister) {
         throw new Error(noCurrentAgentMessage());
     }
-    await requestRemote(client, "/agents", {
-        backend: contextForCurrent.backend,
-        runtimeKind: contextForCurrent.runtimeKind,
-        runtimeSessionId: contextForCurrent.runtimeSessionId ?? undefined,
-        runtimePid: contextForCurrent.runtimePid ?? undefined,
-        tmuxPaneId: contextForCurrent.tmuxPaneId ?? undefined,
-        tty: contextForCurrent.tty ?? undefined,
-        termProgram: contextForCurrent.termProgram ?? undefined,
-        itermSessionId: contextForCurrent.itermSessionId ?? undefined,
-        notifyLeaseMs: undefined,
-    });
+    await requestRemote(client, "/agents", registrationInputForCurrentContext(contextForCurrent));
     const refreshed = await listAgentsWithTargets(client);
     const registered = (0, current_agent_1.resolveCurrentAgent)(refreshed, contextForCurrent);
     if (!registered) {
@@ -994,8 +1027,38 @@ async function selectAgentForCommand(client, options) {
         warnings: [],
     };
 }
-async function listAgentsWithTargets(client) {
-    const response = await requestRemote(client, "/agents?include_targets=true", undefined, "GET");
+function registrationInputForCurrentContext(context) {
+    if ((0, current_agent_1.isHolonRuntimeContext)(context)) {
+        if (!context.externalTriggerUrl) {
+            throw new Error("unable to auto-register current Holon agent: HOLON_EXTERNAL_TRIGGER_URL is not set");
+        }
+        return {
+            agentId: context.agentId,
+            runtimeKind: context.runtimeKind,
+            webhook: {
+                url: context.externalTriggerUrl,
+                notifyLeaseMs: undefined,
+            },
+        };
+    }
+    return {
+        backend: context.backend,
+        runtimeKind: context.runtimeKind,
+        runtimeSessionId: context.runtimeSessionId ?? undefined,
+        runtimePid: context.runtimePid ?? undefined,
+        tmuxPaneId: context.tmuxPaneId ?? undefined,
+        tty: context.tty ?? undefined,
+        termProgram: context.termProgram ?? undefined,
+        itermSessionId: context.itermSessionId ?? undefined,
+        notifyLeaseMs: undefined,
+    };
+}
+async function listAgentsWithTargets(client, limit) {
+    const query = buildQuery({
+        include_targets: "true",
+        limit,
+    });
+    const response = await requestRemote(client, `/agents${query}`, undefined, "GET");
     return response.data.agents;
 }
 async function printRemote(client, endpoint, body, method = "POST") {
@@ -1005,13 +1068,38 @@ async function printRemote(client, endpoint, body, method = "POST") {
 async function requestRemote(client, endpoint, body, method = "POST") {
     const response = await client.request(endpoint, body, method);
     if (response.statusCode < 200 || response.statusCode >= 300) {
-        throw new Error((0, util_1.jsonResponse)(response.data));
+        const bodyText = (0, util_1.jsonResponse)(response.data);
+        throw new Error(`request ${method} ${endpoint} failed with HTTP ${response.statusCode}: ${bodyText}`);
     }
     return { data: response.data };
 }
 function noCurrentAgentMessage() {
     return "no current agent is registered for this terminal/runtime context; run `agentinbox agent list` to inspect offline agents, then `agentinbox agent register` or `agentinbox agent register --force-rebind --agent-id <agentId>` to rebind one";
 }
+function clientArgsForCommand(args) {
+    if (isAgentTargetAddWebhookCommand(args)) {
+        return withoutFlagValues(args, "--url");
+    }
+    return args;
+}
+function isAgentTargetAddWebhookCommand(args) {
+    return args[0] === "agent" && args[1] === "target" && args[2] === "add" && args[3] === "webhook";
+}
+function withoutFlagValues(args, flag) {
+    const filtered = [];
+    for (let index = 0; index < args.length; index += 1) {
+        const value = args[index];
+        if (value !== flag) {
+            filtered.push(value);
+            continue;
+        }
+        const nextIndex = index + 1;
+        if (nextIndex < args.length && !args[nextIndex].startsWith("--")) {
+            index = nextIndex;
+        }
+    }
+    return filtered;
+}
 function takeFlagValue(args, flag) {
     const index = args.indexOf(flag);
     if (index === -1) {
@@ -1102,6 +1190,17 @@ function buildQuery(params) {
     const query = search.toString();
     return query ? `?${query}` : "";
 }
+function parseOptionalLimitArg(args) {
+    const raw = takeFlagValue(args, "--limit");
+    if (raw === undefined) {
+        return undefined;
+    }
+    const parsed = Number.parseInt(raw, 10);
+    if (!Number.isFinite(parsed) || parsed < 1 || String(parsed) !== raw) {
+        throw new Error("`--limit` must be a positive integer");
+    }
+    return String(parsed);
+}
 function readSubscriptionFilter(args) {
     const filterJson = takeFlagValue(args, "--filter-json");
     const filterFile = takeFlagValue(args, "--filter-file");
@@ -1193,7 +1292,14 @@ function normalizeSubscriptionAddOutput(data, shortcutUsed) {
     }
     return data;
 }
-function getRequiredTerminalContext() {
+function getRequiredCurrentAgentContext() {
+    const holonContext = (0, current_agent_1.detectHolonRuntimeContext)(process.env);
+    if (holonContext) {
+        return holonContext;
+    }
+    if ((0, current_agent_1.isHolonRuntimeEnv)(process.env)) {
+        throw new Error("unable to detect current Holon agent: HOLON_AGENT_ID is not set");
+    }
     try {
         return (0, terminal_1.detectTerminalContext)(process.env);
     }
@@ -1202,7 +1308,11 @@ function getRequiredTerminalContext() {
         throw new Error(`unable to resolve current agent: ${message}`);
     }
 }
-function tryDetectTerminalContext() {
+function tryDetectCurrentAgentContext() {
+    const holonContext = (0, current_agent_1.detectHolonRuntimeContext)(process.env);
+    if (holonContext || (0, current_agent_1.isHolonRuntimeEnv)(process.env)) {
+        return holonContext;
+    }
     try {
         return (0, terminal_1.detectTerminalContext)(process.env);
     }
@@ -1277,7 +1387,7 @@ Usage:
 
 Usage:
   agentinbox host add <hostType> <hostKey> [--config-json JSON] [--config-ref REF]
-  agentinbox host list
+  agentinbox host list [--limit N]
   agentinbox host show <hostId>
   agentinbox host schema <hostId>
 `,
@@ -1285,7 +1395,7 @@ Usage:
 
 Usage:
   agentinbox stream add <hostId> <streamKind> <streamKey> [--config-json JSON] [--config-ref REF]
-  agentinbox stream list
+  agentinbox stream list [--limit N]
   agentinbox stream show <streamId>
   agentinbox stream update <streamId> [--config-json JSON] [--config-ref REF | --clear-config-ref]
   agentinbox stream remove <streamId> [--with-subscriptions]
@@ -1310,7 +1420,7 @@ Examples:
 
 Usage:
   agentinbox source add <hostId> <streamKind> <streamKey> [--config-json JSON] [--config-ref REF]
-  agentinbox source list
+  agentinbox source list [--limit N]
   agentinbox source show <sourceId>
   agentinbox source update <sourceId> [--config-json JSON] [--config-ref REF | --clear-config-ref]
   agentinbox source remove <sourceId> [--with-subscriptions]
@@ -1325,13 +1435,13 @@ Usage:
 Usage:
   agentinbox agent register [--agent-id ID] [--force-rebind] [--notify-lease-ms N] [--min-unacked-items N]
   agentinbox agent register --agent-id ID --webhook-url URL [--webhook-activation-mode MODE] [--webhook-notify-lease-ms N] [--webhook-min-unacked-items N]
-  agentinbox agent list
+  agentinbox agent list [--limit N]
   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] [--min-unacked-items N]
-  agentinbox agent target list <agentId>
+  agentinbox agent target list <agentId> [--limit N]
   agentinbox agent target remove <agentId> <targetId>
   agentinbox agent target resume <agentId> <targetId>
 `,
@@ -1339,7 +1449,7 @@ Usage:
 
 Usage:
   agentinbox timer add --agent-id ID (--at ISO8601 | --every DURATION | --cron EXPR) --message TEXT [--timezone TZ] [--sender SENDER]
-  agentinbox timer list [--agent-id ID]
+  agentinbox timer list [--agent-id ID] [--limit N]
   agentinbox timer pause <scheduleId>
   agentinbox timer resume <scheduleId>
   agentinbox timer remove <scheduleId>
@@ -1348,7 +1458,7 @@ Usage:
 
 Usage:
   agentinbox subscription add <sourceId> [--agent-id ID] [--shortcut NAME --shortcut-args-json JSON] [--filter-json JSON | --filter-file PATH | --filter-stdin] [--tracked-resource-ref REF] [--cleanup-policy-json JSON] [--start-policy POLICY] [--start-offset N] [--start-time ISO8601]
-  agentinbox subscription list [--source-id ID] [--agent-id ID]
+  agentinbox subscription list [--source-id ID] [--agent-id ID] [--limit N]
   agentinbox subscription show <subscriptionId>
   agentinbox subscription remove <subscriptionId>
   agentinbox subscription poll <subscriptionId>
@@ -1358,9 +1468,9 @@ Usage:
         inbox: `agentinbox inbox
 
 Usage:
-  agentinbox inbox list
+  agentinbox inbox list [--limit N]
   agentinbox inbox show <agentId>
-  agentinbox inbox read [--agent-id ID] [--after-entry ID] [--include-acked]
+  agentinbox inbox read [--agent-id ID] [--after-entry ID] [--include-acked] [--limit N]
   agentinbox inbox send --agent-id ID --message TEXT [--sender SENDER]
   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)

package/dist/src/current_agent.js

@@ -1,8 +1,11 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.summarizeActivationTarget = summarizeActivationTarget;
+exports.isHolonRuntimeEnv = isHolonRuntimeEnv;
+exports.detectHolonRuntimeContext = detectHolonRuntimeContext;
 exports.resolveCurrentAgent = resolveCurrentAgent;
 exports.annotateAgents = annotateAgents;
+exports.isHolonRuntimeContext = isHolonRuntimeContext;
 function summarizeActivationTarget(target) {
     if (target.kind === "terminal") {
         return {
@@ -25,6 +28,19 @@ function summarizeActivationTarget(target) {
         status: target.status,
     };
 }
+function isHolonRuntimeEnv(env = process.env) {
+    return normalizeOptionalString(env.HOLON_RUNTIME) === "1";
+}
+function detectHolonRuntimeContext(env = process.env) {
+    if (!isHolonRuntimeEnv(env)) {
+        return null;
+    }
+    const agentId = normalizeOptionalString(env.HOLON_AGENT_ID);
+    if (!agentId) {
+        return null;
+    }
+    return { runtimeKind: "holon", agentId, externalTriggerUrl: normalizeOptionalString(env.HOLON_EXTERNAL_TRIGGER_URL) };
+}
 function resolveCurrentAgent(agents, context) {
     if (!context) {
         return null;
@@ -62,6 +78,9 @@ function annotateAgents(agents, context) {
     };
 }
 function resolveAgentRecord(agents, context) {
+    if (isHolonRuntimeContext(context)) {
+        return agents.find((agent) => agent.agent.status === "active" && agent.agent.agentId === context.agentId) ?? null;
+    }
     if (context.tmuxPaneId) {
         const match = agents.find((agent) => terminalTargetsForCurrentMatch(agent).some((target) => target.backend === "tmux" && target.tmuxPaneId === context.tmuxPaneId));
         if (match) {
@@ -129,6 +148,9 @@ function terminalIdentityForAgent(agent) {
     return null;
 }
 function matchesCurrentTerminal(agent, context) {
+    if (isHolonRuntimeContext(context)) {
+        return false;
+    }
     return terminalTargetsForCurrentMatch(agent).some((target) => (context.tmuxPaneId != null && target.tmuxPaneId === context.tmuxPaneId)
         || (context.itermSessionId != null && target.itermSessionId === context.itermSessionId)
         || (context.tty != null && target.tty === context.tty));
@@ -137,9 +159,18 @@ function matchesCurrentRuntime(agent, context) {
     if (agent.agent.status !== "active") {
         return false;
     }
+    if (isHolonRuntimeContext(context)) {
+        return agent.agent.agentId === context.agentId;
+    }
     if (!context.runtimeSessionId) {
         return false;
     }
     return activeTerminalTargets(agent).some((target) => target.runtimeKind === context.runtimeKind && target.runtimeSessionId === context.runtimeSessionId) || (agent.agent.runtimeKind === context.runtimeKind
         && agent.agent.runtimeSessionId === context.runtimeSessionId);
 }
+function isHolonRuntimeContext(context) {
+    return context.runtimeKind === "holon" && "agentId" in context;
+}
+function normalizeOptionalString(value) {
+    return value?.trim() || null;
+}

package/dist/src/http.js

@@ -133,6 +133,13 @@ function buildFastifyServer(service) {
     app.get("/hosts", {
         schema: {
             tags: ["sources"],
+            querystring: {
+                type: "object",
+                additionalProperties: false,
+                properties: {
+                    limit: { type: "string", pattern: "^[1-9][0-9]*$" },
+                },
+            },
             response: {
                 200: {
                     type: "object",
@@ -143,7 +150,10 @@ function buildFastifyServer(service) {
                 },
             },
         },
-    }, async () => ({ hosts: service.listHosts() }));
+    }, async (request) => {
+        const query = request.query;
+        return { hosts: service.listHosts(parseOptionalPositiveInteger(query.limit)) };
+    });
     app.post("/hosts", {
         schema: {
             tags: ["sources"],
@@ -206,6 +216,13 @@ function buildFastifyServer(service) {
     app.get("/streams", {
         schema: {
             tags: ["sources"],
+            querystring: {
+                type: "object",
+                additionalProperties: false,
+                properties: {
+                    limit: { type: "string", pattern: "^[1-9][0-9]*$" },
+                },
+            },
             response: {
                 200: {
                     type: "object",
@@ -216,7 +233,10 @@ function buildFastifyServer(service) {
                 },
             },
         },
-    }, async () => ({ streams: service.listStreams() }));
+    }, async (request) => {
+        const query = request.query;
+        return { streams: service.listStreams(parseOptionalPositiveInteger(query.limit)) };
+    });
     app.post("/streams", {
         schema: {
             tags: ["sources"],
@@ -280,6 +300,13 @@ function buildFastifyServer(service) {
     app.get("/sources", {
         schema: {
             tags: ["sources"],
+            querystring: {
+                type: "object",
+                additionalProperties: false,
+                properties: {
+                    limit: { type: "string", pattern: "^[1-9][0-9]*$" },
+                },
+            },
             response: {
                 200: {
                     type: "object",
@@ -290,7 +317,10 @@ function buildFastifyServer(service) {
                 },
             },
         },
-    }, async () => ({ sources: await service.listSourceViews() }));
+    }, async (request) => {
+        const query = request.query;
+        return { sources: await service.listSourceViews(parseOptionalPositiveInteger(query.limit)) };
+    });
     app.post("/sources", {
         schema: {
             tags: ["sources"],
@@ -548,6 +578,7 @@ function buildFastifyServer(service) {
                     occurredAt: { type: "string", minLength: 1 },
                     metadata: jsonObjectSchema,
                     rawPayload: jsonObjectSchema,
+                    providerRawPayload: jsonObjectSchema,
                 },
             },
             response: {
@@ -564,6 +595,7 @@ function buildFastifyServer(service) {
             occurredAt: body.occurredAt,
             metadata: body.metadata ?? {},
             rawPayload: body.rawPayload ?? {},
+            providerRawPayload: body.providerRawPayload,
         });
     });
     app.delete("/sources/:sourceId", {
@@ -702,6 +734,7 @@ function buildFastifyServer(service) {
                     occurredAt: { type: "string", minLength: 1 },
                     metadata: jsonObjectSchema,
                     rawPayload: jsonObjectSchema,
+                    providerRawPayload: jsonObjectSchema,
                     deliveryHandle: deliveryHandleSchema,
                 },
             },
@@ -719,6 +752,7 @@ function buildFastifyServer(service) {
             occurredAt: optionalString(body.occurredAt),
             metadata: body.metadata ?? {},
             rawPayload: body.rawPayload ?? {},
+            providerRawPayload: body.providerRawPayload,
             deliveryHandle: body.deliveryHandle ?? null,
         });
     });
@@ -730,6 +764,7 @@ function buildFastifyServer(service) {
                 additionalProperties: false,
                 properties: {
                     include_targets: { type: "string", enum: ["true", "false"] },
+                    limit: { type: "string", pattern: "^[1-9][0-9]*$" },
                 },
             },
             response: {
@@ -744,17 +779,10 @@ function buildFastifyServer(service) {
         },
     }, async (request) => {
         const query = request.query;
-        const agents = service.listAgents();
+        const agents = service.listAgents(parseOptionalPositiveInteger(query.limit));
         if (query.include_targets === "true") {
-            const activationTargetsByAgentId = service.listActivationTargets().reduce((grouped, target) => {
-                const targets = grouped.get(target.agentId);
-                const summarized = (0, current_agent_1.summarizeActivationTarget)(target);
-                if (targets) {
-                    targets.push(summarized);
-                }
-                else {
-                    grouped.set(target.agentId, [summarized]);
-                }
+            const activationTargetsByAgentId = agents.reduce((grouped, agent) => {
+                grouped.set(agent.agentId, service.listActivationTargets(agent.agentId).map((target) => (0, current_agent_1.summarizeActivationTarget)(target)));
                 return grouped;
             }, new Map());
             return {
@@ -920,6 +948,13 @@ function buildFastifyServer(service) {
                     agentId: { type: "string", minLength: 1 },
                 },
             },
+            querystring: {
+                type: "object",
+                additionalProperties: false,
+                properties: {
+                    limit: { type: "string", pattern: "^[1-9][0-9]*$" },
+                },
+            },
             response: {
                 200: {
                     type: "object",
@@ -932,7 +967,8 @@ function buildFastifyServer(service) {
         },
     }, async (request) => {
         const params = request.params;
-        return { targets: service.listActivationTargets(decodeURIComponent(params.agentId)) };
+        const query = request.query;
+        return { targets: service.listActivationTargets(decodeURIComponent(params.agentId), parseOptionalPositiveInteger(query.limit)) };
     });
     app.post("/agents/:agentId/targets", {
         schema: {
@@ -1017,6 +1053,7 @@ function buildFastifyServer(service) {
                 additionalProperties: false,
                 properties: {
                     agent_id: { type: "string" },
+                    limit: { type: "string", pattern: "^[1-9][0-9]*$" },
                 },
             },
             response: {
@@ -1031,7 +1068,7 @@ function buildFastifyServer(service) {
         },
     }, async (request) => {
         const query = request.query;
-        return { timers: service.listTimers(query.agent_id) };
+        return { timers: service.listTimers(query.agent_id, parseOptionalPositiveInteger(query.limit)) };
     });
     app.post("/timers", {
         schema: {
@@ -1135,6 +1172,7 @@ function buildFastifyServer(service) {
                 properties: {
                     source_id: { type: "string" },
                     agent_id: { type: "string" },
+                    limit: { type: "string", pattern: "^[1-9][0-9]*$" },
                 },
             },
             response: {
@@ -1147,6 +1185,7 @@ function buildFastifyServer(service) {
             subscriptions: service.listSubscriptions({
                 sourceId: query.source_id,
                 agentId: query.agent_id,
+                limit: parseOptionalPositiveInteger(query.limit),
             }),
         };
     });
@@ -1348,6 +1387,7 @@ function buildFastifyServer(service) {
                 properties: {
                     after_entry_id: { type: "string" },
                     include_acked: { type: "string", enum: ["true", "false"] },
+                    limit: { type: "string", pattern: "^[1-9][0-9]*$" },
                 },
             },
             response: {
@@ -1367,6 +1407,7 @@ function buildFastifyServer(service) {
             entries: service.listInboxItems(decodeURIComponent(params.agentId), {
                 afterEntryId: query.after_entry_id,
                 includeAcked: query.include_acked ? query.include_acked === "true" : undefined,
+                limit: parseOptionalPositiveInteger(query.limit),
             }),
         };
     });
@@ -1738,6 +1779,19 @@ function optionalString(value) {
     const trimmed = value.trim();
     return trimmed.length > 0 ? trimmed : undefined;
 }
+function parseOptionalPositiveInteger(value) {
+    if (value === undefined) {
+        return undefined;
+    }
+    if (!/^[1-9]\d*$/.test(value)) {
+        throw new Error("expected positive integer");
+    }
+    const parsed = Number.parseInt(value, 10);
+    if (!Number.isSafeInteger(parsed)) {
+        throw new Error("expected positive integer within safe range");
+    }
+    return parsed;
+}
 function normalizeValidationMessage(message) {
     if (message.includes("must be boolean")) {
         return "expected boolean";

package/dist/src/service.js

@@ -144,14 +144,14 @@ class AgentInboxService {
         await this.adapters.sourceAdapterFor(source.sourceType).ensureSource(source);
         return source;
     }
-    listSources() {
-        return this.store.listSources();
+    listSources(limit) {
+        return this.store.listSources(limit);
     }
-    async listSourceViews() {
-        return this.attachSourceRuntimes(this.store.listSources());
+    async listSourceViews(limit) {
+        return this.attachSourceRuntimes(this.store.listSources(limit));
     }
-    listHosts() {
-        return this.store.listSourceHosts();
+    listHosts(limit) {
+        return this.store.listSourceHosts(limit);
     }
     getHost(hostId) {
         const host = this.store.getSourceHost(hostId);
@@ -269,8 +269,8 @@ class AgentInboxService {
             return this.getStream(stream.sourceId);
         });
     }
-    listStreams() {
-        return this.listSources();
+    listStreams(limit) {
+        return this.listSources(limit);
     }
     getStream(streamId) {
         return this.getSource(streamId);
@@ -590,8 +590,8 @@ class AgentInboxService {
             notifyLeaseMs: notifyLeaseMs ?? null,
         });
     }
-    listAgents() {
-        return this.store.listAgents();
+    listAgents(limit) {
+        return this.store.listAgents(limit);
     }
     getAgent(agentId) {
         const agent = this.store.getAgent(agentId);
@@ -666,12 +666,12 @@ class AgentInboxService {
         this.rescheduleTimerSync();
         return timer;
     }
-    listTimers(agentId) {
+    listTimers(agentId, limit) {
         if (agentId) {
             this.getAgent(agentId);
-            return this.store.listTimersForAgent(agentId);
+            return this.store.listTimersForAgent(agentId, limit);
         }
-        return this.store.listTimers();
+        return this.store.listTimers(limit);
     }
     getTimer(scheduleId) {
         const timer = this.store.getTimer(scheduleId);
@@ -758,12 +758,12 @@ class AgentInboxService {
         this.markAgentActive(agentId);
         return target;
     }
-    listActivationTargets(agentId) {
+    listActivationTargets(agentId, limit) {
         if (agentId) {
             this.getAgent(agentId);
-            return this.store.listActivationTargetsForAgent(agentId);
+            return this.store.listActivationTargetsForAgent(agentId, limit);
         }
-        return this.store.listActivationTargets();
+        return this.store.listActivationTargets(limit);
     }
     getActivationTarget(targetId) {
         const target = this.store.getActivationTarget(targetId);
@@ -1024,15 +1024,7 @@ class AgentInboxService {
         return { removed: true, subscriptionId };
     }
     listSubscriptions(filters) {
-        return this.store.listSubscriptions().filter((subscription) => {
-            if (filters?.sourceId && subscription.sourceId !== filters.sourceId) {
-                return false;
-            }
-            if (filters?.agentId && subscription.agentId !== filters.agentId) {
-                return false;
-            }
-            return true;
-        });
+        return this.store.listSubscriptionsFiltered(filters);
     }
     getSubscription(subscriptionId) {
         const subscription = this.store.getSubscription(subscriptionId);
@@ -1098,8 +1090,8 @@ class AgentInboxService {
         }
         return this.appendSourceEvent({ ...input, sourceId });
     }
-    listInboxAgentIds() {
-        return this.store.listInboxes().map((inbox) => inbox.ownerAgentId);
+    listInboxAgentIds(limit) {
+        return this.store.listInboxes(limit).map((inbox) => inbox.ownerAgentId);
     }
     getInboxDetailsByAgent(agentId) {
         const inbox = this.ensureInboxForAgent(agentId);
@@ -1193,6 +1185,7 @@ class AgentInboxService {
             occurredAt,
             metadata: {},
             rawPayload: input.rawPayload,
+            providerRawPayload: undefined,
             deliveryHandle: null,
             ackedAt: null,
         };
@@ -1516,6 +1509,7 @@ class AgentInboxService {
                             subscriptionId: subscription.subscriptionId,
                         },
                         rawPayload: event.rawPayload,
+                        providerRawPayload: event.providerRawPayload,
                         deliveryHandle: event.deliveryHandle,
                         ackedAt: null,
                     };
@@ -3406,6 +3400,7 @@ function activationItemFromInboxItem(item) {
         occurredAt: item.occurredAt,
         metadata: item.metadata,
         rawPayload: item.rawPayload,
+        providerRawPayload: item.providerRawPayload,
         deliveryHandle: item.deliveryHandle,
     };
 }

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

@@ -391,6 +391,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

@@ -297,7 +297,10 @@ function createGithubRepoRemoteModule(options) {
                         seen_window: 1024,
                     },
                 },
-                options: { auth: config.uxcAuth },
+                options: {
+                    auth: config.uxcAuth,
+                    artifact_compaction: false,
+                },
             };
         },
         async mapRawEvent(rawPayload, source) {
@@ -312,6 +315,7 @@ function createGithubRepoRemoteModule(options) {
                 eventVariant: normalized.eventVariant,
                 metadata: normalized.metadata ?? {},
                 rawPayload: normalized.rawPayload ?? hydratedPayload,
+                providerRawPayload: hydratedPayload,
                 occurredAt: normalized.occurredAt,
                 deliveryHandle: normalized.deliveryHandle,
             };
@@ -434,7 +438,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 +455,7 @@ const GITHUB_REPO_CI_MODULE = {
             eventVariant: normalized.eventVariant,
             metadata: normalized.metadata ?? {},
             rawPayload: normalized.rawPayload ?? rawPayload,
+            providerRawPayload: rawPayload,
             occurredAt: normalized.occurredAt,
             deliveryHandle: normalized.deliveryHandle,
         };
@@ -500,7 +508,10 @@ const FEISHU_BOT_MODULE = {
             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 +525,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.4",
   "description": "Local event subscription and delivery service for agents.",
   "license": "Apache-2.0",
   "repository": {
@@ -44,7 +44,7 @@
   },
   "dependencies": {
     "@fastify/swagger": "^9.5.2",
-    "@holon-run/uxc-daemon-client": "^0.15.3",
+    "@holon-run/uxc-daemon-client": "^0.15.4",
     "fastify": "^5.6.1",
     "jexl": "^2.3.0",
     "sql.js": "^1.13.0"