@platforma-sdk/block-tools 2.7.25 → 2.8.1

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@platforma-sdk/block-tools",
-  "version": "2.7.25",
+  "version": "2.8.1",
   "description": "Utility to manipulate Platforma Blocks and Block Registry",
   "license": "UNLICENSED",
   "bin": {
@@ -32,13 +32,14 @@
     "undici": "~7.16.0",
     "yaml": "^2.8.0",
     "zod": "~3.25.76",
-    "@milaboratories/pl-model-common": "1.42.0",
-    "@milaboratories/pl-http": "1.2.4",
-    "@milaboratories/pl-model-middle-layer": "1.19.4",
     "@milaboratories/resolve-helper": "1.1.3",
-    "@milaboratories/ts-helpers-oclif": "1.1.41",
+    "@milaboratories/pl-http": "1.2.4",
+    "@milaboratories/pl-model-backend": "1.3.1",
+    "@milaboratories/pl-model-common": "1.42.0",
+    "@milaboratories/pl-model-middle-layer": "1.20.0",
     "@milaboratories/ts-helpers": "1.8.2",
-    "@platforma-sdk/blocks-deps-updater": "2.2.0"
+    "@platforma-sdk/blocks-deps-updater": "2.2.0",
+    "@milaboratories/ts-helpers-oclif": "1.1.41"
   },
   "devDependencies": {
     "@rollup/plugin-node-resolve": "^16.0.1",
@@ -54,8 +55,8 @@
     "vite-plugin-dts": "^4.5.3",
     "vitest": "^4.1.3",
     "@milaboratories/build-configs": "2.0.0",
-    "@milaboratories/ts-builder": "1.4.0",
     "@milaboratories/oclif-index": "1.1.1",
+    "@milaboratories/ts-builder": "1.5.0",
     "@milaboratories/ts-configs": "1.2.3"
   },
   "oclif": {

package/src/v2/build_dist.ts

@@ -3,12 +3,44 @@ import type {
   ManifestFileInfo,
 } from "@milaboratories/pl-model-middle-layer";
 import { BlockPackManifest, BlockPackManifestFile } from "@milaboratories/pl-model-middle-layer";
+import type { CompiledTemplateV3 } from "@milaboratories/pl-model-backend";
 import type { BlockPackDescriptionAbsolute } from "./model";
 import { BlockPackDescriptionConsolidateToFolder } from "./model";
 import fsp from "node:fs/promises";
 import path from "node:path";
+import { gunzipSync } from "node:zlib";
 import { calculateSha256 } from "../util";
 
+/**
+ * Returns the capability tokens the workflow's compiled template declares
+ * it needs (via `TemplateDataV3.requiredCapabilities`, populated by
+ * tengo-builder at compile time). Returns `undefined` for v2 packs, for
+ * malformed packs, or when the template carries no requirements — fail-
+ * safe so the worst case is "block installs anywhere", the pre-WASM
+ * status quo.
+ */
+async function workflowRequiredCapabilities(
+  descriptionRelative: BlockPackDescriptionManifest,
+  dst: string,
+): Promise<string[] | undefined> {
+  // After BlockPackDescriptionConsolidateToFolder runs, components.workflow.main
+  // is always a {type: "relative", path: ...} reference into dst.
+  const main = descriptionRelative.components.workflow.main;
+  const bytes = await fsp.readFile(path.resolve(dst, main.path));
+
+  let parsed: unknown;
+  try {
+    const json = gunzipSync(bytes).toString("utf-8");
+    parsed = JSON.parse(json);
+  } catch {
+    return undefined;
+  }
+
+  const pack = parsed as Partial<CompiledTemplateV3>;
+  if (pack.type !== "pl.tengo-template.v3" || !pack.template) return undefined;
+  return pack.template.requiredCapabilities;
+}
+
 export async function buildBlockPackDist(
   description: BlockPackDescriptionAbsolute,
   dst: string,
@@ -17,6 +49,25 @@ export async function buildBlockPackDist(
   const files: string[] = [];
   const descriptionRelative: BlockPackDescriptionManifest =
     await BlockPackDescriptionConsolidateToFolder(dst, files).parseAsync(description);
+
+  // Per-block capability detection: mirror the workflow's
+  // compile-time-computed `requiredCapabilities` onto the published
+  // manifest meta, so only blocks that actually need a feature force the
+  // customer to run a backend advertising it. Tengo-builder is the
+  // source of truth here — it populates the field when it embeds wasm
+  // bytes (or any future feature artifact); block-tools just propagates
+  // upward.
+  //
+  // See docs/text/work/projects/webassembly-libraries-tengo/README.md,
+  // "Capability declaration: detected from main.plj.gz, not the SDK release".
+  const workflowCapabilities = await workflowRequiredCapabilities(descriptionRelative, dst);
+  if (workflowCapabilities && workflowCapabilities.length > 0) {
+    descriptionRelative.meta = {
+      ...descriptionRelative.meta,
+      requiredCapabilities: workflowCapabilities,
+    };
+  }
+
   const filesForManifest = await Promise.all(
     files.map(async (f): Promise<ManifestFileInfo> => {
       const bytes = await fsp.readFile(path.resolve(dst, f));