@sprigr/apps-app-sdk 0.8.7 → 0.8.8

package/dist/index.d.ts

@@ -902,6 +902,15 @@ interface AppApprovalEnvelope {
      * retry silently discards the tap. See `approvalHash`.
      */
     hash?: string;
+    /**
+     * How many records this ONE call touches, as you count them. Required for a
+     * workflow step's standing approval to cover the call on an unattended run
+     * (sprigr-team decision 0039): the platform cannot see inside your write,
+     * so an envelope with no count gets a person or nothing. The wrappers set
+     * it to 1 for a single-target spec; a batch action supplies
+     * `ApprovalSpec.count`.
+     */
+    count?: number;
 }
 /**
  * Platform-stamped marker telling an app that a human approved this call. The
@@ -1105,6 +1114,14 @@ interface ApprovalSpec<P = unknown> {
      * Use `set()` / `seq()` from `approval-hash`. Never include `confirm`.
      */
     hash?: (args: ToolArgs) => Array<string | number | undefined | null>;
+    /**
+     * How many records this call touches, for `_approval.count`. Omit for a
+     * single-target tool (the wrapper reports 1 when a `keys` id resolved, and
+     * nothing when none did). A batch action (delete these ids, tag these
+     * products) MUST supply it, or it reports nothing and no standing approval
+     * can ever cover it, which is the safe side but not the useful one.
+     */
+    count?: (args: ToolArgs) => number;
     /** Present only for tools whose write can be (partly) reversed. */
     undo?: UndoCaptureSpec<P>;
 }

package/dist/index.js

@@ -614,6 +614,17 @@ function rawIdOf(args, keys) {
   }
   return "";
 }
+function countOf(spec, params, rawId) {
+  if (spec.count) {
+    try {
+      const n = spec.count(params);
+      return Number.isFinite(n) && n >= 0 ? Math.floor(n) : void 0;
+    } catch {
+      return void 0;
+    }
+  }
+  return rawId ? 1 : void 0;
+}
 function isOk(result) {
   return !!result && typeof result === "object" && result.ok !== false;
 }
@@ -635,11 +646,13 @@ async function askPass(name, spec, params, env, opts, hashPrefix) {
   const pinned = await pin(opts, env, connection);
   const target = rawId && opts.describeTarget ? await safeLabel(opts.describeTarget, pinned, rawId, name) : rawId || "(unknown id)";
   const extra = spec.hash ? spec.hash(params) : [];
+  const count = countOf(spec, params, rawId);
   return {
     ok: false,
     _approval: {
       ...spec.describe(target, params, connection),
-      hash: approvalHash(...hashPrefix, rawId, connection, ...extra)
+      hash: approvalHash(...hashPrefix, rawId, connection, ...extra),
+      ...count !== void 0 ? { count } : {}
     }
   };
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@sprigr/apps-app-sdk",
-  "version": "0.8.7",
+  "version": "0.8.8",
   "type": "module",
   "main": "./dist/index.js",
   "types": "./dist/index.d.ts",