@isaacthoman/pulpo 0.131.3 → 0.132.1

package/README.md

@@ -106,6 +106,37 @@ errors remain on stderr, and noninteractive destructive commands require
 `--yes`. Add `--verbose` to print method, path, status, and timing diagnostics
 without printing authorization headers or request bodies.
 
+### Detailed payloads
+
+```sh
+pulpo usage requests --range 7d --model model-id --limit 20 --json
+pulpo usage requests --range 7d --limit 20 --cursor '2026-09-09T12:00:00.000Z' --json
+pulpo usage payloads MODEL_CALL_ID
+pulpo usage payloads REQUEST_LOG_ID --json
+pulpo settings get instance.logging
+pulpo settings set instance.logging.payloadRetention 24h --yes
+pulpo settings set instance.logging.logDetailedPayloads true --yes
+```
+
+`usage requests` returns model-call IDs, parent request-log IDs, and `nextCursor`.
+Keep the same filters on subsequent pages. Ranges are `24h` (default), `7d`,
+`30d`, `90d`, and `all`; additional filters include `--status`, `--origin`, and
+`--identity` (user or API key ID).
+
+`usage payloads` prints untruncated, indented JSON in both human and machine modes.
+It includes the parent request/response bodies, agent turn arrays when captured,
+and OCR attempts. Bodies cover the parent request, potentially including multiple
+model calls or retries. `available`, `captureActive`, `payloadExpiresAt`, and
+`unavailableReason` distinguish retained data, expiry, capture disabled/cleared,
+and bodies not yet captured. Expired bodies return null, even before cleanup runs.
+`usage request ID` remains the metadata view.
+
+Viewing payloads requires a current administrator with `usage:read` and a server
+advertising `detailedPayloads`. Logging settings require `instance:read` and
+`instance:write`. Capture defaults to off; enable it before the request you want to
+inspect. Retention choices are `1h`, `24h`, `7d`, `30d`, `90d`, and `indefinite`.
+Bodies may contain sensitive prompts, outputs, tool data, and OCR images.
+
 Configuration precedence is command-line options, then `PULPO_CONTEXT` /
 `PULPO_URL` / `PULPO_TOKEN`, then the current stored context. Context metadata
 lives in the platform config directory. Session tokens use Keychain on macOS or

package/dist/index.js

@@ -20730,7 +20730,7 @@ async function runModelTest(input) {
 }
 
 // src/index.ts
-var CLI_VERSION = true ? "0.131.3" : "0.1.0";
+var CLI_VERSION = true ? "0.132.1" : "0.1.0";
 var CLI_BUNDLED = true;
 var commandIo = /* @__PURE__ */ new WeakMap();
 var commandClientFactory = /* @__PURE__ */ new WeakMap();
@@ -21396,9 +21396,23 @@ function createProgram(io = processIo, dependencies = {}) {
     const { client } = await clientFor(command);
     emit(io, command, await client.request("/api/management/v1/usage/summary"));
   });
-  usage.command("requests").action(async (_options, command) => {
+  usage.command("requests").description("List model calls with request-log IDs and a pagination cursor").addOption(new Option("--range <range>", "time range").choices(["24h", "7d", "30d", "90d", "all"]).default("24h")).option("--limit <count>", "page size (1-100)", "50").option("--cursor <timestamp>", "nextCursor from the previous page").option("--status <statuses>", "comma-separated model-call statuses").option("--origin <origin>", "call source").option("--model <id>", "catalog or upstream model ID").option("--identity <id>", "user or API key ID").action(async (options2, command) => {
+    const limit = external_exports.coerce.number().int().min(1).max(100).parse(options2.limit);
+    if (options2.cursor) external_exports.iso.datetime({ offset: true }).parse(options2.cursor);
+    const query = new URLSearchParams({ range: options2.range, limit: String(limit) });
+    for (const key of ["cursor", "status", "origin", "model", "identity"]) {
+      if (options2[key]) query.set(key, options2[key]);
+    }
     const { client } = await clientFor(command);
-    emit(io, command, await client.request("/api/management/v1/usage/requests"));
+    emit(io, command, await client.request(`/api/management/v1/usage/requests?${query}`));
+  });
+  usage.command("payloads <id>").description("View retained request, response, and OCR bodies by model-call or request-log ID").action(async (id, _options, command) => {
+    const { client, info } = await clientFor(command);
+    if (!info.capabilities.includes("detailedPayloads")) {
+      throw new Error("The selected Pulpo instance does not advertise the detailedPayloads capability; update the server to view payloads");
+    }
+    const payloads = await client.request(`/api/management/v1/usage/requests/${encodeURIComponent(id)}/payloads`);
+    writeOutput(io, payloads, true);
   });
   usage.command("request <id>").action(async (id, _options, command) => {
     const { client } = await clientFor(command);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@isaacthoman/pulpo",
-  "version": "0.131.3",
+  "version": "0.132.1",
   "description": "Operator-first command-line client for Pulpo",
   "type": "module",
   "bin": {