@mdbase-dev/pickle 0.1.0-beta.94 → 0.1.0-beta.96

package/README.md

@@ -13,3 +13,13 @@ await pickle.respond(requests[0], {
 
 The adapter uses ordinary mdbase operations. Request state is derived from
 linked response records, and no record payload is stored outside the collection.
+
+For an inbox, use `pickle.list({ includeBody: false })`. It still waits for all
+response links before deriving pending, answered, and conflict states, but does
+not transfer every request's Markdown context. Fetch an opened request's context
+with `await pickle.readBody(request, { signal, timeoutMs: 10_000 })`. Response
+bodies are never needed for lifecycle calculation and are omitted from queries.
+
+Pickle requests 256 records per page from the first query. Cursor authorities
+pin that initial size; continuation requests reuse the cursor rather than asking
+for an ineffective larger limit.

package/dist/index.d.ts

@@ -76,6 +76,8 @@ export interface PickleRequest {
     responseType: string;
     responseTypeDefinition?: CollectionTypeDescriptor;
     createdAt?: string;
+    /** Stable file modification time for invalidating an opened context. */
+    modifiedAt?: string;
     dueAt?: string;
     tags: string[];
     links: PickleLink[];
@@ -118,7 +120,11 @@ export declare class PickleCollection {
         collection: CollectionDescription;
         contract: PickleContract;
     }>;
-    list(options?: ConnectRequestOptions): Promise<PickleRequest[]>;
+    /** Omit Markdown bodies for an inbox; load individual context with readBody. */
+    list({ includeBody, ...options }?: ConnectRequestOptions & {
+        includeBody?: boolean;
+    }): Promise<PickleRequest[]>;
+    readBody(request: Pick<PickleRequest, "path">, options?: ConnectRequestOptions): Promise<string>;
     respond(request: PickleRequest, payload: JsonObject, options?: RespondOptions): Promise<PickleResponseSubmission>;
     readAttachment(attachment: PickleAttachment, options?: ConnectRequestOptions): Promise<PickleAttachmentContent | null>;
     pendingResponses(): readonly PicklePendingResponse[];

package/dist/index.js

@@ -51,13 +51,14 @@ export class PickleCollection {
         this.contract ??= resolvePickleContract(this.description);
         return { collection: this.description, contract: this.contract };
     }
-    async list(options = {}) {
+    /** Omit Markdown bodies for an inbox; load individual context with readBody. */
+    async list({ includeBody = true, ...options } = {}) {
         const { collection, contract } = await this.describe(options);
         const requestQuery = requireOutcome(await this.connect.queryAll({
             types: contract.implementations.map(({ typeName }) => typeName),
-            includeBody: true,
+            includeBody,
             frontmatterMode: "effective"
-        }, options));
+        }, { ...options, pageSize: 256 }));
         const requests = requestQuery.results.map(requireEffectiveFrontmatter);
         const responseTypes = [
             ...new Set(requests
@@ -70,14 +71,18 @@ export class PickleCollection {
         const responses = responseTypes.length
             ? (requireOutcome(await this.connect.queryAll({
                 types: responseTypes,
-                includeBody: true,
+                includeBody: false,
                 frontmatterMode: "effective"
-            }, options))).results.map(requireEffectiveFrontmatter)
+            }, { ...options, pageSize: 256 }))).results.map(requireEffectiveFrontmatter)
             : [];
         return requests
             .map((record) => normalizeRequest(record, responses, collection, contract))
             .sort((left, right) => (right.createdAt ?? "").localeCompare(left.createdAt ?? ""));
     }
+    async readBody(request, options = {}) {
+        const record = requireOutcome(await this.connect.read({ path: request.path }, options));
+        return record.body ?? "";
+    }
     async respond(request, payload, options = {}) {
         if (request.state !== "pending") {
             throw new PickleContractError(request.state === "conflict"
@@ -200,6 +205,7 @@ function normalizeRequest(record, responseRecords, description, contract) {
             "agent",
         message: stringField(record.effectiveFrontmatter, role(implementation, "message", "message")),
         body: record.body ?? "",
+        modifiedAt: record.file?.mtime,
         kind: stringField(record.effectiveFrontmatter, role(implementation, "kind", "kind")) ||
             "approval",
         priority: stringField(record.effectiveFrontmatter, role(implementation, "priority", "priority")) || "normal",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@mdbase-dev/pickle",
-  "version": "0.1.0-beta.94",
+  "version": "0.1.0-beta.96",
   "private": false,
   "type": "module",
   "license": "MIT",
@@ -22,13 +22,13 @@
     "README.md"
   ],
   "dependencies": {
-    "@mdbase-dev/connect": "0.1.0-beta.94"
+    "@mdbase-dev/connect": "0.1.0-beta.96"
   },
   "devDependencies": {
     "typescript": "^7.0.2",
     "vitest": "^4.1.10",
-    "@mdbase-dev/connect-dev": "0.1.0-beta.94",
-    "@mdbase-dev/connect-testing": "0.1.0-beta.94"
+    "@mdbase-dev/connect-dev": "0.1.0-beta.96",
+    "@mdbase-dev/connect-testing": "0.1.0-beta.96"
   },
   "scripts": {
     "build": "node -e \"require('node:fs').rmSync('dist',{recursive:true,force:true})\" && tsc -p tsconfig.json",