@keemakr/agent-sdk 0.13.0 → 0.13.1-dev-20260829024924

package/dist/client.d.ts

@@ -157,6 +157,17 @@ export interface KeeRecords {
      * record (idempotent). Pass `id` to address a specific record (PUT), and
      * `ifVersion` (from a prior get/list) for compare-and-swap: throws
      * RecordConflictError when another agent wrote it in between.
+     *
+     * APPEND-ONLY COLLECTIONS. A collection declared `appendOnly: true` is
+     * insert-only: a write whose record id already exists is REFUSED (409
+     * `append_only`) rather than replacing the row, and an `ifVersion` write is
+     * refused too, since a compare-and-swap is a replacement by definition. This
+     * is what makes an audit-log collection immutable in storage rather than by
+     * convention — records are tenant-shared, so without it any installed agent
+     * holding the write scope could overwrite another's stored event.
+     *
+     * Do NOT retry an `append_only` refusal: unlike a version conflict there is no
+     * state to re-read that would make the same write succeed. Write a new event.
      */
     upsert(collection: string, data: Record<string, unknown>, opts?: {
         id?: string;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@keemakr/agent-sdk",
-  "version": "0.13.0",
+  "version": "0.13.1-dev-20260829024924",
   "description": "The floor for keemakr marketplace agents: verify the capability grant and reach tenant connections, memory, and shared platform tools through keemakr-core — without holding raw secrets or resolving the tenant yourself.",
   "license": "MIT",
   "type": "module",