@milaboratories/pl-middle-layer 1.75.0 → 1.76.0

package/dist/index.cjs

@@ -83,6 +83,7 @@ exports.canGrantToEveryone = require_sharing_model.canGrantToEveryone;
 exports.canImpersonate = require_sharing_model.canImpersonate;
 exports.checkNetwork = require_network_check.checkNetwork;
 exports.createRenderTemplate = require_render_template.createRenderTemplate;
+exports.createRenderTemplateWithResource = require_render_template.createRenderTemplateWithResource;
 exports.decodeEnvelopeData = require_sharing_model.decodeEnvelopeData;
 exports.deriveGlobalPObjectId = require_data.deriveGlobalPObjectId;
 exports.deriveLocalPObjectId = require_data.deriveLocalPObjectId;

package/dist/index.d.ts

@@ -16,6 +16,7 @@ import { CachedTemplate, ExplicitTemplate, PreparedTemplate, TemplateFromFile, T
 import { BlockPackExplicit, BlockPackSpecAny, BlockPackSpecPrepared, FrontendFromFolder, FrontendFromFolderData, FrontendFromFolderResourceType, FrontendFromLocalTgz, FrontendFromLocalTgzData, FrontendFromLocalTgzResourceType, FrontendFromUrl, FrontendFromUrlData, FrontendFromUrlResourceType, FrontendSpec } from "./model/block_pack_spec.js";
 import { TemplateParseOutcome, parseProjectTemplateV1Yaml } from "./model/template_parser.js";
 import "./model/index.js";
+import { BlockActionContextMode, BlockActionContextNode, BlockActionReading, BlockActionTransition } from "./middle_layer/block_action_context.js";
 import { Project } from "./middle_layer/project.js";
 import { DefaultDriverKitOpsPaths, DefaultDriverKitOpsSettings, DefaultMiddleLayerOpsPaths, DefaultMiddleLayerOpsSettings, DriverKitOps, DriverKitOpsConstructor, DriverKitOpsPaths, DriverKitOpsSettings, MiddleLayerDebugOptions, MiddleLayerOps, MiddleLayerOpsConstructor, MiddleLayerOpsPaths, MiddleLayerOpsSettings, TreeSnapshotOps } from "./middle_layer/ops.js";
 import { MiddleLayerDriverKit, initDriverKit } from "./middle_layer/driver_kit.js";
@@ -26,7 +27,7 @@ import "./middle_layer/index.js";
 import { CheckNetworkOpts, checkNetwork, initNetworkCheck } from "./network_check/network_check.js";
 import { TengoTemplateGet, TengoTemplateGetRegistry, TengoTemplateGetTemplate, TengoTemplateGetTemplateURI, TengoTemplatePack, TengoTemplatePackConvert, TengoTemplatePackConvertTemplate, TengoTemplatePackConvertTemplatePack, loadTemplate, prepareTemplateSpec } from "./mutator/template/template_loading.js";
 import { ACCESS_COUNT_KEY, ACCESS_KEY_PREFIX, GC_ACCESS_THRESHOLD, GC_MAX_ENTRIES, TemplateCacheFieldName, TemplateCacheStat, TemplateCacheType, cacheBlockPackTemplate, dropTemplateCache, flattenTemplateTree, getOrCreateTemplateCache, invalidateTemplateCacheId, loadTemplateCached, runGc } from "./mutator/template/template_cache.js";
-import { createRenderTemplate } from "./mutator/template/render_template.js";
+import { createRenderTemplate, createRenderTemplateWithResource } from "./mutator/template/render_template.js";
 import { duplicateProject } from "./mutator/project.js";
 import { parseFinalPObjectCollection } from "./pool/p_object_collection.js";
 import { deriveGlobalPObjectId, deriveLocalPObjectId } from "./pool/data.js";
@@ -36,4 +37,4 @@ export * from "@platforma-sdk/model";
 export * from "@milaboratories/pl-model-middle-layer";
 export * from "@milaboratories/pl-deployments";
 export * from "@milaboratories/pl-client";
-export { ACCESS_COUNT_KEY, ACCESS_KEY_PREFIX, type AppliedEntry, type AvailableShare, BlockArgsAuthorKeyPrefix, BlockPackExplicit, type BlockPackProvider, BlockPackRegistry, BlockPackSpecAny, BlockPackSpecPrepared, CachedTemplate, CentralBlockRegistry, CheckNetworkOpts, type CreateProjectFromTemplateOutcome, DefaultDriverKitOpsPaths, DefaultDriverKitOpsSettings, DefaultMiddleLayerOpsPaths, DefaultMiddleLayerOpsSettings, DriverKitOps, DriverKitOpsConstructor, DriverKitOpsPaths, DriverKitOpsSettings, EnvelopeData, EnvelopeFolder, EnvelopeFolderId, EnvelopeFolderProject, type EnvelopeFolderSummary, EnvelopeFolderTemplate, EnvelopeMode, EnvelopePayload, EnvelopePayloadKind, EnvelopeProject, EnvelopeSchemaVersion, EnvelopeSchemaVersionCurrent, type ExactResolution, ExplicitTemplate, type FieldType, FoldersField, type FoldersListing, type FoldersProjectEntry, FoldersResourceType, type FoldersTemplateEntry, FrontendFromFolder, FrontendFromFolderData, FrontendFromFolderResourceType, FrontendFromLocalTgz, FrontendFromLocalTgzData, FrontendFromLocalTgzResourceType, FrontendFromUrl, FrontendFromUrlData, FrontendFromUrlResourceType, FrontendSpec, GC_ACCESS_THRESHOLD, GC_MAX_ENTRIES, HiddenFieldPrefix, type InternalLsDriver, KindAwareRegistry, type KindResolution, MiddleLayer, MiddleLayerDebugOptions, MiddleLayerDriverKit, MiddleLayerOps, MiddleLayerOpsConstructor, MiddleLayerOpsPaths, MiddleLayerOpsSettings, type OutgoingShare, PreparedTemplate, Project, ProjectCreatedTimestamp, type ProjectField, ProjectFieldUuid, type ProjectId, ProjectLastModifiedTimestamp, type ProjectListEntry, ProjectMetaKey, ProjectResourceType, ProjectStructureAuthorKey, ProjectStructureKey, type ProjectTemplateExportOutcome, ProjectsField, ProjectsResourceType, type ResolvedEntry, type ResourceType, type SaveProjectAsTemplateOutcome, SchemaVersionCurrent, SchemaVersionKey, ShareAudience, ShareFolderOptions, ShareHidden, ShareId, ShareOptions, ShareOutcome, ShareProjectsOptions, ShareReplaceOption, ShareTemplateOptions, SharedEnvelopeResourceType, SharingOutboxField, SharingOutboxResourceType, SharingStateField, SharingStateResourceType, type StoredTemplateData, type TemplateApplyProblem, type TemplateApplyReport, TemplateCacheFieldName, TemplateCacheStat, TemplateCacheType, TemplateEntryRejected, type TemplateExportProblem, TemplateFromFile, TemplateFromRegistry, type TemplateId, type TemplateListEntry, type TemplateParseOutcome, type TemplateResolveOutcome, TemplateSpecAny, TemplateSpecPrepared, TemplatesField, TengoTemplateGet, TengoTemplateGetRegistry, TengoTemplateGetTemplate, TengoTemplateGetTemplateURI, TengoTemplatePack, TengoTemplatePackConvert, TengoTemplatePackConvertTemplate, TengoTemplatePackConvertTemplatePack, type TreeSnapshotMiss, TreeSnapshotOps, type TreeSnapshotStat, V1CentralDevSnapshotRegistry, V1CentralRegistry, V2RegistryProvider, asShareId, cacheBlockPackTemplate, canGrantToEveryone, canImpersonate, checkNetwork, createRenderTemplate, decodeEnvelopeData, deriveGlobalPObjectId, deriveLocalPObjectId, dropTemplateCache, duplicateProject, envelopeFolderRoot, envelopeProjectMap, flattenTemplateTree, getDevV1PacketMtime, getDevV2PacketMtime, getFromPackV2Mtime, getOrCreateTemplateCache, hiddenField, hiddenFieldShareId, initDriverKit, initNetworkCheck, invalidateTemplateCacheId, isHiddenField, kindCapableRegistryIds, loadTemplate, loadTemplateCached, locationOf, newEnvelopeFolderId, newProjectFieldUuid, newShareId, normalizeEnvelopeData, parseBlockPackName, parseFinalPObjectCollection, parseProjectTemplateV1Yaml, prepareTemplateSpec, resolveTemplateEntries, runGc, stringifyProjectTemplateV1, templateBlockPackProvider };
+export { ACCESS_COUNT_KEY, ACCESS_KEY_PREFIX, type AppliedEntry, type AvailableShare, type BlockActionContextMode, type BlockActionContextNode, type BlockActionReading, type BlockActionTransition, BlockArgsAuthorKeyPrefix, BlockPackExplicit, type BlockPackProvider, BlockPackRegistry, BlockPackSpecAny, BlockPackSpecPrepared, CachedTemplate, CentralBlockRegistry, CheckNetworkOpts, type CreateProjectFromTemplateOutcome, DefaultDriverKitOpsPaths, DefaultDriverKitOpsSettings, DefaultMiddleLayerOpsPaths, DefaultMiddleLayerOpsSettings, DriverKitOps, DriverKitOpsConstructor, DriverKitOpsPaths, DriverKitOpsSettings, EnvelopeData, EnvelopeFolder, EnvelopeFolderId, EnvelopeFolderProject, type EnvelopeFolderSummary, EnvelopeFolderTemplate, EnvelopeMode, EnvelopePayload, EnvelopePayloadKind, EnvelopeProject, EnvelopeSchemaVersion, EnvelopeSchemaVersionCurrent, type ExactResolution, ExplicitTemplate, type FieldType, FoldersField, type FoldersListing, type FoldersProjectEntry, FoldersResourceType, type FoldersTemplateEntry, FrontendFromFolder, FrontendFromFolderData, FrontendFromFolderResourceType, FrontendFromLocalTgz, FrontendFromLocalTgzData, FrontendFromLocalTgzResourceType, FrontendFromUrl, FrontendFromUrlData, FrontendFromUrlResourceType, FrontendSpec, GC_ACCESS_THRESHOLD, GC_MAX_ENTRIES, HiddenFieldPrefix, type InternalLsDriver, KindAwareRegistry, type KindResolution, MiddleLayer, MiddleLayerDebugOptions, MiddleLayerDriverKit, MiddleLayerOps, MiddleLayerOpsConstructor, MiddleLayerOpsPaths, MiddleLayerOpsSettings, type OutgoingShare, PreparedTemplate, Project, ProjectCreatedTimestamp, type ProjectField, ProjectFieldUuid, type ProjectId, ProjectLastModifiedTimestamp, type ProjectListEntry, ProjectMetaKey, ProjectResourceType, ProjectStructureAuthorKey, ProjectStructureKey, type ProjectTemplateExportOutcome, ProjectsField, ProjectsResourceType, type ResolvedEntry, type ResourceType, type SaveProjectAsTemplateOutcome, SchemaVersionCurrent, SchemaVersionKey, ShareAudience, ShareFolderOptions, ShareHidden, ShareId, ShareOptions, ShareOutcome, ShareProjectsOptions, ShareReplaceOption, ShareTemplateOptions, SharedEnvelopeResourceType, SharingOutboxField, SharingOutboxResourceType, SharingStateField, SharingStateResourceType, type StoredTemplateData, type TemplateApplyProblem, type TemplateApplyReport, TemplateCacheFieldName, TemplateCacheStat, TemplateCacheType, TemplateEntryRejected, type TemplateExportProblem, TemplateFromFile, TemplateFromRegistry, type TemplateId, type TemplateListEntry, type TemplateParseOutcome, type TemplateResolveOutcome, TemplateSpecAny, TemplateSpecPrepared, TemplatesField, TengoTemplateGet, TengoTemplateGetRegistry, TengoTemplateGetTemplate, TengoTemplateGetTemplateURI, TengoTemplatePack, TengoTemplatePackConvert, TengoTemplatePackConvertTemplate, TengoTemplatePackConvertTemplatePack, type TreeSnapshotMiss, TreeSnapshotOps, type TreeSnapshotStat, V1CentralDevSnapshotRegistry, V1CentralRegistry, V2RegistryProvider, asShareId, cacheBlockPackTemplate, canGrantToEveryone, canImpersonate, checkNetwork, createRenderTemplate, createRenderTemplateWithResource, decodeEnvelopeData, deriveGlobalPObjectId, deriveLocalPObjectId, dropTemplateCache, duplicateProject, envelopeFolderRoot, envelopeProjectMap, flattenTemplateTree, getDevV1PacketMtime, getDevV2PacketMtime, getFromPackV2Mtime, getOrCreateTemplateCache, hiddenField, hiddenFieldShareId, initDriverKit, initNetworkCheck, invalidateTemplateCacheId, isHiddenField, kindCapableRegistryIds, loadTemplate, loadTemplateCached, locationOf, newEnvelopeFolderId, newProjectFieldUuid, newShareId, normalizeEnvelopeData, parseBlockPackName, parseFinalPObjectCollection, parseProjectTemplateV1Yaml, prepareTemplateSpec, resolveTemplateEntries, runGc, stringifyProjectTemplateV1, templateBlockPackProvider };

package/dist/index.js

@@ -7,7 +7,7 @@ import { BlockArgsAuthorKeyPrefix, ProjectCreatedTimestamp, ProjectLastModifiedT
 import { ProjectsField, ProjectsResourceType } from "./middle_layer/project_list.js";
 import { TemplatesField } from "./middle_layer/template_list.js";
 import { FoldersField, FoldersResourceType } from "./middle_layer/folders.js";
-import { createRenderTemplate } from "./mutator/template/render_template.js";
+import { createRenderTemplate, createRenderTemplateWithResource } from "./mutator/template/render_template.js";
 import { TengoTemplateGet, TengoTemplateGetRegistry, TengoTemplateGetTemplate, TengoTemplateGetTemplateURI, TengoTemplatePack, TengoTemplatePackConvert, TengoTemplatePackConvertTemplate, TengoTemplatePackConvertTemplatePack, loadTemplate, prepareTemplateSpec } from "./mutator/template/template_loading.js";
 import { FrontendFromFolderResourceType, FrontendFromLocalTgzResourceType, FrontendFromUrlResourceType } from "./model/block_pack_spec.js";
 import { EnvelopeSchemaVersionCurrent, HiddenFieldPrefix, SharedEnvelopeResourceType, SharingOutboxField, SharingOutboxResourceType, SharingStateField, SharingStateResourceType, asShareId, canGrantToEveryone, canImpersonate, decodeEnvelopeData, envelopeFolderRoot, envelopeProjectMap, hiddenField, hiddenFieldShareId, isHiddenField, newEnvelopeFolderId, newProjectFieldUuid, newShareId, normalizeEnvelopeData } from "./model/sharing_model.js";
@@ -30,4 +30,4 @@ export * from "@platforma-sdk/model";
 export * from "@milaboratories/pl-model-middle-layer";
 export * from "@milaboratories/pl-deployments";
 export * from "@milaboratories/pl-client";
-export { ACCESS_COUNT_KEY, ACCESS_KEY_PREFIX, BlockArgsAuthorKeyPrefix, BlockPackRegistry, CentralBlockRegistry, DefaultDriverKitOpsPaths, DefaultDriverKitOpsSettings, DefaultMiddleLayerOpsPaths, DefaultMiddleLayerOpsSettings, EnvelopeSchemaVersionCurrent, FoldersField, FoldersResourceType, FrontendFromFolderResourceType, FrontendFromLocalTgzResourceType, FrontendFromUrlResourceType, GC_ACCESS_THRESHOLD, GC_MAX_ENTRIES, HiddenFieldPrefix, MiddleLayer, Project, ProjectCreatedTimestamp, ProjectLastModifiedTimestamp, ProjectMetaKey, ProjectResourceType, ProjectStructureAuthorKey, ProjectStructureKey, ProjectsField, ProjectsResourceType, SchemaVersionCurrent, SchemaVersionKey, SharedEnvelopeResourceType, SharingOutboxField, SharingOutboxResourceType, SharingStateField, SharingStateResourceType, TemplateCacheFieldName, TemplateCacheType, TemplateEntryRejected, TemplatesField, TengoTemplateGet, TengoTemplateGetRegistry, TengoTemplateGetTemplate, TengoTemplateGetTemplateURI, TengoTemplatePack, TengoTemplatePackConvert, TengoTemplatePackConvertTemplate, TengoTemplatePackConvertTemplatePack, V1CentralDevSnapshotRegistry, V1CentralRegistry, V2RegistryProvider, asShareId, cacheBlockPackTemplate, canGrantToEveryone, canImpersonate, checkNetwork, createRenderTemplate, decodeEnvelopeData, deriveGlobalPObjectId, deriveLocalPObjectId, dropTemplateCache, duplicateProject, envelopeFolderRoot, envelopeProjectMap, flattenTemplateTree, getDevV1PacketMtime, getDevV2PacketMtime, getFromPackV2Mtime, getOrCreateTemplateCache, hiddenField, hiddenFieldShareId, initDriverKit, initNetworkCheck, invalidateTemplateCacheId, isHiddenField, kindCapableRegistryIds, loadTemplate, loadTemplateCached, locationOf, newEnvelopeFolderId, newProjectFieldUuid, newShareId, normalizeEnvelopeData, parseBlockPackName, parseFinalPObjectCollection, parseProjectTemplateV1Yaml, prepareTemplateSpec, resolveTemplateEntries, runGc, stringifyProjectTemplateV1, templateBlockPackProvider };
+export { ACCESS_COUNT_KEY, ACCESS_KEY_PREFIX, BlockArgsAuthorKeyPrefix, BlockPackRegistry, CentralBlockRegistry, DefaultDriverKitOpsPaths, DefaultDriverKitOpsSettings, DefaultMiddleLayerOpsPaths, DefaultMiddleLayerOpsSettings, EnvelopeSchemaVersionCurrent, FoldersField, FoldersResourceType, FrontendFromFolderResourceType, FrontendFromLocalTgzResourceType, FrontendFromUrlResourceType, GC_ACCESS_THRESHOLD, GC_MAX_ENTRIES, HiddenFieldPrefix, MiddleLayer, Project, ProjectCreatedTimestamp, ProjectLastModifiedTimestamp, ProjectMetaKey, ProjectResourceType, ProjectStructureAuthorKey, ProjectStructureKey, ProjectsField, ProjectsResourceType, SchemaVersionCurrent, SchemaVersionKey, SharedEnvelopeResourceType, SharingOutboxField, SharingOutboxResourceType, SharingStateField, SharingStateResourceType, TemplateCacheFieldName, TemplateCacheType, TemplateEntryRejected, TemplatesField, TengoTemplateGet, TengoTemplateGetRegistry, TengoTemplateGetTemplate, TengoTemplateGetTemplateURI, TengoTemplatePack, TengoTemplatePackConvert, TengoTemplatePackConvertTemplate, TengoTemplatePackConvertTemplatePack, V1CentralDevSnapshotRegistry, V1CentralRegistry, V2RegistryProvider, asShareId, cacheBlockPackTemplate, canGrantToEveryone, canImpersonate, checkNetwork, createRenderTemplate, createRenderTemplateWithResource, decodeEnvelopeData, deriveGlobalPObjectId, deriveLocalPObjectId, dropTemplateCache, duplicateProject, envelopeFolderRoot, envelopeProjectMap, flattenTemplateTree, getDevV1PacketMtime, getDevV2PacketMtime, getFromPackV2Mtime, getOrCreateTemplateCache, hiddenField, hiddenFieldShareId, initDriverKit, initNetworkCheck, invalidateTemplateCacheId, isHiddenField, kindCapableRegistryIds, loadTemplate, loadTemplateCached, locationOf, newEnvelopeFolderId, newProjectFieldUuid, newShareId, normalizeEnvelopeData, parseBlockPackName, parseFinalPObjectCollection, parseProjectTemplateV1Yaml, prepareTemplateSpec, resolveTemplateEntries, runGc, stringifyProjectTemplateV1, templateBlockPackProvider };

package/dist/middle_layer/block_action_context.cjs

@@ -0,0 +1,57 @@
+const require_project_model = require("../model/project_model.cjs");
+let _milaboratories_pl_client = require("@milaboratories/pl-client");
+// src/middle_layer/block_action_context.ts
+const childFieldPrefix = "child/";
+async function readBlockActionContextTree(pl, projectRid, blockId, mode) {
+	return await pl.withReadTx("readBlockActionContextTree", async (tx) => {
+		const project = await tx.getResourceData(projectRid, true);
+		const fieldName = require_project_model.projectFieldName(blockId, mode === "prod" ? "prodActionContext" : "stagingActionContext");
+		const actionContextField = project.fields.find((f) => f.name === fieldName);
+		if (actionContextField === void 0 || (0, _milaboratories_pl_client.isNullSignedResourceId)(actionContextField.value)) return void 0;
+		return await readActionContextNode(tx, actionContextField.value);
+	});
+}
+async function readActionContextNode(tx, contextRef) {
+	const [context, kvs] = await Promise.all([tx.getResourceData(contextRef, true), tx.listKeyValuesString(contextRef)]);
+	const baggage = context.data === void 0 || context.data.length === 0 ? {} : JSON.parse(Buffer.from(context.data).toString());
+	const transitions = [];
+	const readings = [];
+	for (const { key, value } of kvs) {
+		const parts = key.split("/");
+		if (parts[0] === "transition" && parts.length === 4) {
+			const parsed = JSON.parse(value);
+			transitions.push({
+				namespace: parts[1],
+				resource: parts[2],
+				timestampNs: parts[3],
+				state: parsed.state ?? "",
+				detail: parsed.detail ?? "",
+				reason: parsed.reason ?? ""
+			});
+		} else if (parts[0] === "reading" && parts.length === 4) readings.push({
+			namespace: parts[1],
+			resource: parts[2],
+			key: parts[3],
+			value
+		});
+	}
+	transitions.sort((a, b) => compareDecimal(a.timestampNs, b.timestampNs));
+	const childRefs = [];
+	for (const f of context.fields) if (f.name.startsWith(childFieldPrefix) && !(0, _milaboratories_pl_client.isNullSignedResourceId)(f.value)) childRefs.push(f.value);
+	const children = await Promise.all(childRefs.map((ref) => readActionContextNode(tx, ref)));
+	return {
+		contextId: String((0, _milaboratories_pl_client.parseSignedResourceId)(contextRef).globalId),
+		resource: transitions.find((t) => t.namespace === "render")?.resource,
+		baggage,
+		transitions,
+		readings,
+		children
+	};
+}
+/** Compares non-negative decimal integers given as strings. */
+function compareDecimal(a, b) {
+	return a.length !== b.length ? a.length - b.length : a < b ? -1 : a > b ? 1 : 0;
+}
+exports.readBlockActionContextTree = readBlockActionContextTree;
+
+//# sourceMappingURL=block_action_context.cjs.map

package/dist/middle_layer/block_action_context.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"block_action_context.cjs","names":["projectFieldName","isNullSignedResourceId","parseSignedResourceId"],"sources":["../../src/middle_layer/block_action_context.ts"],"sourcesContent":["import type {\n  KeyValueString,\n  OptionalSignedResourceId,\n  SignedResourceId,\n} from \"@milaboratories/pl-client\";\nimport { isNullSignedResourceId, parseSignedResourceId } from \"@milaboratories/pl-client\";\nimport { projectFieldName } from \"../model/project_model\";\n\n/** Which render of a block the action context tree belongs to. */\nexport type BlockActionContextMode = \"prod\" | \"staging\";\n\n/** An action transition: transition/<namespace>/<resource>/<ns> in an action context. */\nexport type BlockActionTransition = {\n  namespace: string;\n  /** The resource that reported, e.g. the render or a command it created. */\n  resource: string;\n  /** Server clock in nanoseconds when the transition was recorded, as a decimal string. */\n  timestampNs: string;\n  state: string;\n  detail: string;\n  reason: string;\n};\n\n/**\n * A reading: reading/<namespace>/<resource>/<key> in an action context. The backend sets it asynchronously:\n * of two readings of one key, the one from the transaction opened later stays.\n */\nexport type BlockActionReading = {\n  namespace: string;\n  resource: string;\n  key: string;\n  /** Opaque bytes as UTF-8 text; the reporter owns the format. */\n  value: string;\n};\n\n/** One action context: the action context of one render and the renders it created. */\nexport type BlockActionContextNode = {\n  /**\n   * Global resource ID of this ActionContext resource itself, as a decimal string. Not the ID of the\n   * render it describes: that is {@link BlockActionContextNode.resource}. Pass it back to the MCP\n   * tool to fetch this node's subtree.\n   */\n  contextId: string;\n  /**\n   * The render the context belongs to: the resource of its first transition under namespace \"render\",\n   * which the workflow controller records when it evaluates the render.\n   * Undefined until that transition is applied, or on a backend without block action context reports.\n   */\n  resource?: string;\n  /** Context baggage: name, block-pack, block-id, run-id and so on. */\n  baggage: Record<string, string>;\n  /** In time order. */\n  transitions: BlockActionTransition[];\n  readings: BlockActionReading[];\n  children: BlockActionContextNode[];\n};\n\nconst childFieldPrefix = \"child/\";\n\n/**\n * Reads the action context tree of a block render: the root action context the project holds in\n * <blockId>-prodActionContext or <blockId>-stagingActionContext, and every child context under it.\n * Reads the current state in one transaction; it does not watch for changes.\n *\n * @returns undefined when the block has no action context: it was not rendered yet, or the backend\n *          does not support block action context.\n */\n/**\n * The part of a read transaction the reader uses: a {@link PlTransaction} satisfies it, and a test\n * can serve it without a backend.\n */\nexport interface ActionContextReadTx {\n  getResourceData(\n    rId: SignedResourceId,\n    loadFields: true,\n  ): Promise<{\n    readonly data?: Uint8Array;\n    readonly fields: readonly { readonly name: string; readonly value: OptionalSignedResourceId }[];\n  }>;\n  listKeyValuesString(rId: SignedResourceId): Promise<KeyValueString[]>;\n}\n\n/** The part of a client the reader uses: a {@link PlClient} satisfies it. */\nexport interface ActionContextReader {\n  withReadTx<T>(name: string, body: (tx: ActionContextReadTx) => Promise<T>): Promise<T>;\n}\n\nexport async function readBlockActionContextTree(\n  pl: ActionContextReader,\n  projectRid: SignedResourceId,\n  blockId: string,\n  mode: BlockActionContextMode,\n): Promise<BlockActionContextNode | undefined> {\n  return await pl.withReadTx(\"readBlockActionContextTree\", async (tx) => {\n    const project = await tx.getResourceData(projectRid, true);\n    const fieldName = projectFieldName(\n      blockId,\n      mode === \"prod\" ? \"prodActionContext\" : \"stagingActionContext\",\n    );\n    const actionContextField = project.fields.find((f) => f.name === fieldName);\n    if (actionContextField === undefined || isNullSignedResourceId(actionContextField.value))\n      return undefined;\n\n    return await readActionContextNode(tx, actionContextField.value);\n  });\n}\n\nasync function readActionContextNode(\n  tx: ActionContextReadTx,\n  contextRef: SignedResourceId,\n): Promise<BlockActionContextNode> {\n  const [context, kvs] = await Promise.all([\n    tx.getResourceData(contextRef, true),\n    tx.listKeyValuesString(contextRef),\n  ]);\n\n  const baggage =\n    context.data === undefined || context.data.length === 0\n      ? {}\n      : (JSON.parse(Buffer.from(context.data).toString()) as Record<string, string>);\n\n  const transitions: BlockActionTransition[] = [];\n  const readings: BlockActionReading[] = [];\n  for (const { key, value } of kvs) {\n    const parts = key.split(\"/\");\n    if (parts[0] === \"transition\" && parts.length === 4) {\n      const parsed = JSON.parse(value) as { state?: string; detail?: string; reason?: string };\n      transitions.push({\n        namespace: parts[1],\n        resource: parts[2],\n        timestampNs: parts[3],\n        state: parsed.state ?? \"\",\n        detail: parsed.detail ?? \"\",\n        reason: parsed.reason ?? \"\",\n      });\n    } else if (parts[0] === \"reading\" && parts.length === 4) {\n      readings.push({ namespace: parts[1], resource: parts[2], key: parts[3], value });\n    }\n  }\n  transitions.sort((a, b) => compareDecimal(a.timestampNs, b.timestampNs));\n\n  const childRefs: SignedResourceId[] = [];\n  for (const f of context.fields) {\n    if (f.name.startsWith(childFieldPrefix) && !isNullSignedResourceId(f.value))\n      childRefs.push(f.value);\n  }\n  const children = await Promise.all(childRefs.map((ref) => readActionContextNode(tx, ref)));\n\n  return {\n    contextId: String(parseSignedResourceId(contextRef).globalId),\n    resource: transitions.find((t) => t.namespace === \"render\")?.resource,\n    baggage,\n    transitions,\n    readings,\n    children,\n  };\n}\n\n/** Compares non-negative decimal integers given as strings. */\nfunction compareDecimal(a: string, b: string): number {\n  return a.length !== b.length ? a.length - b.length : a < b ? -1 : a > b ? 1 : 0;\n}\n"],"mappings":";;;AAyDA,MAAM,mBAAmB;AA8BzB,eAAsB,2BACpB,IACA,YACA,SACA,MAC6C;CAC7C,OAAO,MAAM,GAAG,WAAW,8BAA8B,OAAO,OAAO;EACrE,MAAM,UAAU,MAAM,GAAG,gBAAgB,YAAY,IAAI;EACzD,MAAM,YAAYA,sBAAAA,iBAChB,SACA,SAAS,SAAS,sBAAsB,sBAC1C;EACA,MAAM,qBAAqB,QAAQ,OAAO,MAAM,MAAM,EAAE,SAAS,SAAS;EAC1E,IAAI,uBAAuB,KAAA,MAAA,GAAaC,0BAAAA,uBAAAA,CAAuB,mBAAmB,KAAK,GACrF,OAAO,KAAA;EAET,OAAO,MAAM,sBAAsB,IAAI,mBAAmB,KAAK;CACjE,CAAC;AACH;AAEA,eAAe,sBACb,IACA,YACiC;CACjC,MAAM,CAAC,SAAS,OAAO,MAAM,QAAQ,IAAI,CACvC,GAAG,gBAAgB,YAAY,IAAI,GACnC,GAAG,oBAAoB,UAAU,CACnC,CAAC;CAED,MAAM,UACJ,QAAQ,SAAS,KAAA,KAAa,QAAQ,KAAK,WAAW,IAClD,CAAC,IACA,KAAK,MAAM,OAAO,KAAK,QAAQ,IAAI,CAAC,CAAC,SAAS,CAAC;CAEtD,MAAM,cAAuC,CAAC;CAC9C,MAAM,WAAiC,CAAC;CACxC,KAAK,MAAM,EAAE,KAAK,WAAW,KAAK;EAChC,MAAM,QAAQ,IAAI,MAAM,GAAG;EAC3B,IAAI,MAAM,OAAO,gBAAgB,MAAM,WAAW,GAAG;GACnD,MAAM,SAAS,KAAK,MAAM,KAAK;GAC/B,YAAY,KAAK;IACf,WAAW,MAAM;IACjB,UAAU,MAAM;IAChB,aAAa,MAAM;IACnB,OAAO,OAAO,SAAS;IACvB,QAAQ,OAAO,UAAU;IACzB,QAAQ,OAAO,UAAU;GAC3B,CAAC;EACH,OAAO,IAAI,MAAM,OAAO,aAAa,MAAM,WAAW,GACpD,SAAS,KAAK;GAAE,WAAW,MAAM;GAAI,UAAU,MAAM;GAAI,KAAK,MAAM;GAAI;EAAM,CAAC;CAEnF;CACA,YAAY,MAAM,GAAG,MAAM,eAAe,EAAE,aAAa,EAAE,WAAW,CAAC;CAEvE,MAAM,YAAgC,CAAC;CACvC,KAAK,MAAM,KAAK,QAAQ,QACtB,IAAI,EAAE,KAAK,WAAW,gBAAgB,KAAK,EAAA,GAACA,0BAAAA,uBAAAA,CAAuB,EAAE,KAAK,GACxE,UAAU,KAAK,EAAE,KAAK;CAE1B,MAAM,WAAW,MAAM,QAAQ,IAAI,UAAU,KAAK,QAAQ,sBAAsB,IAAI,GAAG,CAAC,CAAC;CAEzF,OAAO;EACL,WAAW,QAAA,GAAOC,0BAAAA,sBAAAA,CAAsB,UAAU,CAAC,CAAC,QAAQ;EAC5D,UAAU,YAAY,MAAM,MAAM,EAAE,cAAc,QAAQ,CAAC,EAAE;EAC7D;EACA;EACA;EACA;CACF;AACF;;AAGA,SAAS,eAAe,GAAW,GAAmB;CACpD,OAAO,EAAE,WAAW,EAAE,SAAS,EAAE,SAAS,EAAE,SAAS,IAAI,IAAI,KAAK,IAAI,IAAI,IAAI;AAChF"}

package/dist/middle_layer/block_action_context.d.ts

@@ -0,0 +1,47 @@
+import { SignedResourceId } from "@milaboratories/pl-client";
+/** Which render of a block the action context tree belongs to. */
+export type BlockActionContextMode = "prod" | "staging";
+/** An action transition: transition/<namespace>/<resource>/<ns> in an action context. */
+export type BlockActionTransition = {
+  namespace: string;
+  /** The resource that reported, e.g. the render or a command it created. */
+  resource: string;
+  /** Server clock in nanoseconds when the transition was recorded, as a decimal string. */
+  timestampNs: string;
+  state: string;
+  detail: string;
+  reason: string;
+};
+/**
+ * A reading: reading/<namespace>/<resource>/<key> in an action context. The backend sets it asynchronously:
+ * of two readings of one key, the one from the transaction opened later stays.
+ */
+export type BlockActionReading = {
+  namespace: string;
+  resource: string;
+  key: string;
+  /** Opaque bytes as UTF-8 text; the reporter owns the format. */
+  value: string;
+};
+/** One action context: the action context of one render and the renders it created. */
+export type BlockActionContextNode = {
+  /**
+   * Global resource ID of this ActionContext resource itself, as a decimal string. Not the ID of the
+   * render it describes: that is {@link BlockActionContextNode.resource}. Pass it back to the MCP
+   * tool to fetch this node's subtree.
+   */
+  contextId: string;
+  /**
+   * The render the context belongs to: the resource of its first transition under namespace "render",
+   * which the workflow controller records when it evaluates the render.
+   * Undefined until that transition is applied, or on a backend without block action context reports.
+   */
+  resource?: string;
+  /** Context baggage: name, block-pack, block-id, run-id and so on. */
+  baggage: Record<string, string>;
+  /** In time order. */
+  transitions: BlockActionTransition[];
+  readings: BlockActionReading[];
+  children: BlockActionContextNode[];
+};
+//# sourceMappingURL=block_action_context.d.ts.map

package/dist/middle_layer/block_action_context.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"block_action_context.d.ts","names":[],"sources":["../../src/middle_layer/block_action_context.ts"],"mappings":";;YASY;;YAGA;EACV;;EAEA;;EAEA;EACA;EACA;EACA;;;;;;YAOU;EACV;EACA;EACA;;EAEA;;;YAIU;;;;;;EAMV;;;;;;EAMA;;EAEA,SAAS;;EAET,aAAa;EACb,UAAU;EACV,UAAU"}

package/dist/middle_layer/block_action_context.js

@@ -0,0 +1,57 @@
+import { projectFieldName } from "../model/project_model.js";
+import { isNullSignedResourceId, parseSignedResourceId } from "@milaboratories/pl-client";
+// src/middle_layer/block_action_context.ts
+const childFieldPrefix = "child/";
+async function readBlockActionContextTree(pl, projectRid, blockId, mode) {
+	return await pl.withReadTx("readBlockActionContextTree", async (tx) => {
+		const project = await tx.getResourceData(projectRid, true);
+		const fieldName = projectFieldName(blockId, mode === "prod" ? "prodActionContext" : "stagingActionContext");
+		const actionContextField = project.fields.find((f) => f.name === fieldName);
+		if (actionContextField === void 0 || isNullSignedResourceId(actionContextField.value)) return void 0;
+		return await readActionContextNode(tx, actionContextField.value);
+	});
+}
+async function readActionContextNode(tx, contextRef) {
+	const [context, kvs] = await Promise.all([tx.getResourceData(contextRef, true), tx.listKeyValuesString(contextRef)]);
+	const baggage = context.data === void 0 || context.data.length === 0 ? {} : JSON.parse(Buffer.from(context.data).toString());
+	const transitions = [];
+	const readings = [];
+	for (const { key, value } of kvs) {
+		const parts = key.split("/");
+		if (parts[0] === "transition" && parts.length === 4) {
+			const parsed = JSON.parse(value);
+			transitions.push({
+				namespace: parts[1],
+				resource: parts[2],
+				timestampNs: parts[3],
+				state: parsed.state ?? "",
+				detail: parsed.detail ?? "",
+				reason: parsed.reason ?? ""
+			});
+		} else if (parts[0] === "reading" && parts.length === 4) readings.push({
+			namespace: parts[1],
+			resource: parts[2],
+			key: parts[3],
+			value
+		});
+	}
+	transitions.sort((a, b) => compareDecimal(a.timestampNs, b.timestampNs));
+	const childRefs = [];
+	for (const f of context.fields) if (f.name.startsWith(childFieldPrefix) && !isNullSignedResourceId(f.value)) childRefs.push(f.value);
+	const children = await Promise.all(childRefs.map((ref) => readActionContextNode(tx, ref)));
+	return {
+		contextId: String(parseSignedResourceId(contextRef).globalId),
+		resource: transitions.find((t) => t.namespace === "render")?.resource,
+		baggage,
+		transitions,
+		readings,
+		children
+	};
+}
+/** Compares non-negative decimal integers given as strings. */
+function compareDecimal(a, b) {
+	return a.length !== b.length ? a.length - b.length : a < b ? -1 : a > b ? 1 : 0;
+}
+export { readBlockActionContextTree };
+
+//# sourceMappingURL=block_action_context.js.map

package/dist/middle_layer/block_action_context.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"block_action_context.js","names":[],"sources":["../../src/middle_layer/block_action_context.ts"],"sourcesContent":["import type {\n  KeyValueString,\n  OptionalSignedResourceId,\n  SignedResourceId,\n} from \"@milaboratories/pl-client\";\nimport { isNullSignedResourceId, parseSignedResourceId } from \"@milaboratories/pl-client\";\nimport { projectFieldName } from \"../model/project_model\";\n\n/** Which render of a block the action context tree belongs to. */\nexport type BlockActionContextMode = \"prod\" | \"staging\";\n\n/** An action transition: transition/<namespace>/<resource>/<ns> in an action context. */\nexport type BlockActionTransition = {\n  namespace: string;\n  /** The resource that reported, e.g. the render or a command it created. */\n  resource: string;\n  /** Server clock in nanoseconds when the transition was recorded, as a decimal string. */\n  timestampNs: string;\n  state: string;\n  detail: string;\n  reason: string;\n};\n\n/**\n * A reading: reading/<namespace>/<resource>/<key> in an action context. The backend sets it asynchronously:\n * of two readings of one key, the one from the transaction opened later stays.\n */\nexport type BlockActionReading = {\n  namespace: string;\n  resource: string;\n  key: string;\n  /** Opaque bytes as UTF-8 text; the reporter owns the format. */\n  value: string;\n};\n\n/** One action context: the action context of one render and the renders it created. */\nexport type BlockActionContextNode = {\n  /**\n   * Global resource ID of this ActionContext resource itself, as a decimal string. Not the ID of the\n   * render it describes: that is {@link BlockActionContextNode.resource}. Pass it back to the MCP\n   * tool to fetch this node's subtree.\n   */\n  contextId: string;\n  /**\n   * The render the context belongs to: the resource of its first transition under namespace \"render\",\n   * which the workflow controller records when it evaluates the render.\n   * Undefined until that transition is applied, or on a backend without block action context reports.\n   */\n  resource?: string;\n  /** Context baggage: name, block-pack, block-id, run-id and so on. */\n  baggage: Record<string, string>;\n  /** In time order. */\n  transitions: BlockActionTransition[];\n  readings: BlockActionReading[];\n  children: BlockActionContextNode[];\n};\n\nconst childFieldPrefix = \"child/\";\n\n/**\n * Reads the action context tree of a block render: the root action context the project holds in\n * <blockId>-prodActionContext or <blockId>-stagingActionContext, and every child context under it.\n * Reads the current state in one transaction; it does not watch for changes.\n *\n * @returns undefined when the block has no action context: it was not rendered yet, or the backend\n *          does not support block action context.\n */\n/**\n * The part of a read transaction the reader uses: a {@link PlTransaction} satisfies it, and a test\n * can serve it without a backend.\n */\nexport interface ActionContextReadTx {\n  getResourceData(\n    rId: SignedResourceId,\n    loadFields: true,\n  ): Promise<{\n    readonly data?: Uint8Array;\n    readonly fields: readonly { readonly name: string; readonly value: OptionalSignedResourceId }[];\n  }>;\n  listKeyValuesString(rId: SignedResourceId): Promise<KeyValueString[]>;\n}\n\n/** The part of a client the reader uses: a {@link PlClient} satisfies it. */\nexport interface ActionContextReader {\n  withReadTx<T>(name: string, body: (tx: ActionContextReadTx) => Promise<T>): Promise<T>;\n}\n\nexport async function readBlockActionContextTree(\n  pl: ActionContextReader,\n  projectRid: SignedResourceId,\n  blockId: string,\n  mode: BlockActionContextMode,\n): Promise<BlockActionContextNode | undefined> {\n  return await pl.withReadTx(\"readBlockActionContextTree\", async (tx) => {\n    const project = await tx.getResourceData(projectRid, true);\n    const fieldName = projectFieldName(\n      blockId,\n      mode === \"prod\" ? \"prodActionContext\" : \"stagingActionContext\",\n    );\n    const actionContextField = project.fields.find((f) => f.name === fieldName);\n    if (actionContextField === undefined || isNullSignedResourceId(actionContextField.value))\n      return undefined;\n\n    return await readActionContextNode(tx, actionContextField.value);\n  });\n}\n\nasync function readActionContextNode(\n  tx: ActionContextReadTx,\n  contextRef: SignedResourceId,\n): Promise<BlockActionContextNode> {\n  const [context, kvs] = await Promise.all([\n    tx.getResourceData(contextRef, true),\n    tx.listKeyValuesString(contextRef),\n  ]);\n\n  const baggage =\n    context.data === undefined || context.data.length === 0\n      ? {}\n      : (JSON.parse(Buffer.from(context.data).toString()) as Record<string, string>);\n\n  const transitions: BlockActionTransition[] = [];\n  const readings: BlockActionReading[] = [];\n  for (const { key, value } of kvs) {\n    const parts = key.split(\"/\");\n    if (parts[0] === \"transition\" && parts.length === 4) {\n      const parsed = JSON.parse(value) as { state?: string; detail?: string; reason?: string };\n      transitions.push({\n        namespace: parts[1],\n        resource: parts[2],\n        timestampNs: parts[3],\n        state: parsed.state ?? \"\",\n        detail: parsed.detail ?? \"\",\n        reason: parsed.reason ?? \"\",\n      });\n    } else if (parts[0] === \"reading\" && parts.length === 4) {\n      readings.push({ namespace: parts[1], resource: parts[2], key: parts[3], value });\n    }\n  }\n  transitions.sort((a, b) => compareDecimal(a.timestampNs, b.timestampNs));\n\n  const childRefs: SignedResourceId[] = [];\n  for (const f of context.fields) {\n    if (f.name.startsWith(childFieldPrefix) && !isNullSignedResourceId(f.value))\n      childRefs.push(f.value);\n  }\n  const children = await Promise.all(childRefs.map((ref) => readActionContextNode(tx, ref)));\n\n  return {\n    contextId: String(parseSignedResourceId(contextRef).globalId),\n    resource: transitions.find((t) => t.namespace === \"render\")?.resource,\n    baggage,\n    transitions,\n    readings,\n    children,\n  };\n}\n\n/** Compares non-negative decimal integers given as strings. */\nfunction compareDecimal(a: string, b: string): number {\n  return a.length !== b.length ? a.length - b.length : a < b ? -1 : a > b ? 1 : 0;\n}\n"],"mappings":";;;AAyDA,MAAM,mBAAmB;AA8BzB,eAAsB,2BACpB,IACA,YACA,SACA,MAC6C;CAC7C,OAAO,MAAM,GAAG,WAAW,8BAA8B,OAAO,OAAO;EACrE,MAAM,UAAU,MAAM,GAAG,gBAAgB,YAAY,IAAI;EACzD,MAAM,YAAY,iBAChB,SACA,SAAS,SAAS,sBAAsB,sBAC1C;EACA,MAAM,qBAAqB,QAAQ,OAAO,MAAM,MAAM,EAAE,SAAS,SAAS;EAC1E,IAAI,uBAAuB,KAAA,KAAa,uBAAuB,mBAAmB,KAAK,GACrF,OAAO,KAAA;EAET,OAAO,MAAM,sBAAsB,IAAI,mBAAmB,KAAK;CACjE,CAAC;AACH;AAEA,eAAe,sBACb,IACA,YACiC;CACjC,MAAM,CAAC,SAAS,OAAO,MAAM,QAAQ,IAAI,CACvC,GAAG,gBAAgB,YAAY,IAAI,GACnC,GAAG,oBAAoB,UAAU,CACnC,CAAC;CAED,MAAM,UACJ,QAAQ,SAAS,KAAA,KAAa,QAAQ,KAAK,WAAW,IAClD,CAAC,IACA,KAAK,MAAM,OAAO,KAAK,QAAQ,IAAI,CAAC,CAAC,SAAS,CAAC;CAEtD,MAAM,cAAuC,CAAC;CAC9C,MAAM,WAAiC,CAAC;CACxC,KAAK,MAAM,EAAE,KAAK,WAAW,KAAK;EAChC,MAAM,QAAQ,IAAI,MAAM,GAAG;EAC3B,IAAI,MAAM,OAAO,gBAAgB,MAAM,WAAW,GAAG;GACnD,MAAM,SAAS,KAAK,MAAM,KAAK;GAC/B,YAAY,KAAK;IACf,WAAW,MAAM;IACjB,UAAU,MAAM;IAChB,aAAa,MAAM;IACnB,OAAO,OAAO,SAAS;IACvB,QAAQ,OAAO,UAAU;IACzB,QAAQ,OAAO,UAAU;GAC3B,CAAC;EACH,OAAO,IAAI,MAAM,OAAO,aAAa,MAAM,WAAW,GACpD,SAAS,KAAK;GAAE,WAAW,MAAM;GAAI,UAAU,MAAM;GAAI,KAAK,MAAM;GAAI;EAAM,CAAC;CAEnF;CACA,YAAY,MAAM,GAAG,MAAM,eAAe,EAAE,aAAa,EAAE,WAAW,CAAC;CAEvE,MAAM,YAAgC,CAAC;CACvC,KAAK,MAAM,KAAK,QAAQ,QACtB,IAAI,EAAE,KAAK,WAAW,gBAAgB,KAAK,CAAC,uBAAuB,EAAE,KAAK,GACxE,UAAU,KAAK,EAAE,KAAK;CAE1B,MAAM,WAAW,MAAM,QAAQ,IAAI,UAAU,KAAK,QAAQ,sBAAsB,IAAI,GAAG,CAAC,CAAC;CAEzF,OAAO;EACL,WAAW,OAAO,sBAAsB,UAAU,CAAC,CAAC,QAAQ;EAC5D,UAAU,YAAY,MAAM,MAAM,EAAE,cAAc,QAAQ,CAAC,EAAE;EAC7D;EACA;EACA;EACA;CACF;AACF;;AAGA,SAAS,eAAe,GAAW,GAAmB;CACpD,OAAO,EAAE,WAAW,EAAE,SAAS,EAAE,SAAS,EAAE,SAAS,IAAI,IAAI,KAAK,IAAI,IAAI,IAAI;AAChF"}

package/dist/middle_layer/build_stamp.cjs

@@ -1,7 +1,7 @@
 // src/middle_layer/build_stamp.ts
 function injectedStamp() {
 	try {
-		return "b9a3db4cb3c2-dirty-1793804477626";
+		return "082d6d37cf86-dirty-1793815175256";
 	} catch {
 		return;
 	}

package/dist/middle_layer/build_stamp.js

@@ -1,7 +1,7 @@
 // src/middle_layer/build_stamp.ts
 function injectedStamp() {
 	try {
-		return "b9a3db4cb3c2-dirty-1793804477603";
+		return "082d6d37cf86-dirty-1793815175234";
 	} catch {
 		return;
 	}

package/dist/middle_layer/index.d.ts

@@ -1,10 +1,11 @@
 import { CreateProjectFromTemplateOutcome, SaveProjectAsTemplateOutcome, StoredTemplateData, TemplateId, TemplateListEntry, TemplatesField } from "./template_list.js";
 import { FoldersField, FoldersListing, FoldersProjectEntry, FoldersResourceType, FoldersTemplateEntry } from "./folders.js";
 import { AvailableShare, EnvelopeFolderSummary, OutgoingShare } from "./sharing_list.js";
+import { BlockActionContextMode, BlockActionContextNode, BlockActionReading, BlockActionTransition } from "./block_action_context.js";
 import { Project } from "./project.js";
 import { DefaultDriverKitOpsPaths, DefaultDriverKitOpsSettings, DefaultMiddleLayerOpsPaths, DefaultMiddleLayerOpsSettings, DriverKitOps, DriverKitOpsConstructor, DriverKitOpsPaths, DriverKitOpsSettings, MiddleLayerDebugOptions, MiddleLayerOps, MiddleLayerOpsConstructor, MiddleLayerOpsPaths, MiddleLayerOpsSettings, TreeSnapshotOps } from "./ops.js";
 import { MiddleLayerDriverKit, initDriverKit } from "./driver_kit.js";
 import { TreeSnapshotMiss, TreeSnapshotStat } from "./tree_snapshot_store.js";
 import { MiddleLayer } from "./middle_layer.js";
 import { ProjectsField, ProjectsResourceType } from "./project_list.js";
-export { type AvailableShare, type CreateProjectFromTemplateOutcome, DefaultDriverKitOpsPaths, DefaultDriverKitOpsSettings, DefaultMiddleLayerOpsPaths, DefaultMiddleLayerOpsSettings, DriverKitOps, DriverKitOpsConstructor, DriverKitOpsPaths, DriverKitOpsSettings, type EnvelopeFolderSummary, FoldersField, type FoldersListing, type FoldersProjectEntry, FoldersResourceType, type FoldersTemplateEntry, MiddleLayer, MiddleLayerDebugOptions, MiddleLayerDriverKit, MiddleLayerOps, MiddleLayerOpsConstructor, MiddleLayerOpsPaths, MiddleLayerOpsSettings, type OutgoingShare, Project, ProjectsField, ProjectsResourceType, type SaveProjectAsTemplateOutcome, type StoredTemplateData, type TemplateId, type TemplateListEntry, TemplatesField, type TreeSnapshotMiss, TreeSnapshotOps, type TreeSnapshotStat, initDriverKit };
+export { type AvailableShare, type BlockActionContextMode, type BlockActionContextNode, type BlockActionReading, type BlockActionTransition, type CreateProjectFromTemplateOutcome, DefaultDriverKitOpsPaths, DefaultDriverKitOpsSettings, DefaultMiddleLayerOpsPaths, DefaultMiddleLayerOpsSettings, DriverKitOps, DriverKitOpsConstructor, DriverKitOpsPaths, DriverKitOpsSettings, type EnvelopeFolderSummary, FoldersField, type FoldersListing, type FoldersProjectEntry, FoldersResourceType, type FoldersTemplateEntry, MiddleLayer, MiddleLayerDebugOptions, MiddleLayerDriverKit, MiddleLayerOps, MiddleLayerOpsConstructor, MiddleLayerOpsPaths, MiddleLayerOpsSettings, type OutgoingShare, Project, ProjectsField, ProjectsResourceType, type SaveProjectAsTemplateOutcome, type StoredTemplateData, type TemplateId, type TemplateListEntry, TemplatesField, type TreeSnapshotMiss, TreeSnapshotOps, type TreeSnapshotStat, initDriverKit };

package/dist/middle_layer/project.cjs

@@ -7,6 +7,7 @@ const require_project_overview = require("./project_overview.cjs");
 const require_column_links = require("./column_links.cjs");
 const require_frontend_path = require("./frontend_path.cjs");
 const require_block = require("./block.cjs");
+const require_block_action_context = require("./block_action_context.cjs");
 const require_active_cfg = require("./active_cfg.cjs");
 const require_navigation_states = require("./navigation_states.cjs");
 const require_project_overview_light = require("./project_overview_light.cjs");
@@ -538,6 +539,13 @@ var Project = class Project {
 	* Returns a computable, that can be used to retrieve and watch full block state,
 	* including outputs, arguments, ui state.
 	* */
+	/**
+	* Reads the block action context tree of a block render (see readBlockActionContextTree): current state, not
+	* watched. Undefined when the block has no action context.
+	*/
+	async getBlockActionContext(blockId, mode = "prod") {
+		return await require_block_action_context.readBlockActionContextTree(this.env.pl, this.rid, blockId, mode);
+	}
 	getBlockState(blockId) {
 		return this.getBlockComputables(blockId).fullState;
 	}