@milaboratories/pl-middle-layer 1.75.0 → 1.76.1

package/dist/mutator/template/render_block.cjs

@@ -12,8 +12,39 @@ const BContext = {
 };
 const BContextMultiParentPrefix = "parent/";
 const HeavyBlockOutputNames = ["context", "result"];
-function createRenderHeavyBlock(tx, tpl, inputs) {
-	return require_render_template.createRenderTemplate(tx, tpl, true, inputs, HeavyBlockOutputNames);
+/** Resource type of a block action context. See ActionContextV1Type in the backend. */
+const ActionContextType = {
+	name: "ActionContext",
+	version: "1"
+};
+/** The capability under which the backend accepts the "actionContext" link on a render. */
+const ActionContextLinkCapability = "optionalFieldsInSchemas:v1";
+/**
+* Creates the root action context of a block render: an ActionContext resource carrying the
+* baggage, with a new random `run-id`, since each render is one run of the block and the contexts
+* the templates create copy it. Undefined without baggage, or on a backend that cannot take the link.
+*/
+function createBlockActionContext(tx, baggage) {
+	if (baggage === void 0 || !tx.hasCapability("optionalFieldsInSchemas:v1")) return void 0;
+	return tx.createEphemeral(ActionContextType, JSON.stringify({
+		name: baggage.name,
+		"block-pack": baggage.blockPack,
+		"block-id": baggage.blockId,
+		"run-id": (0, node_crypto.randomUUID)()
+	}));
+}
+/**
+* Creates the heavy block render, and with `baggage` its root action context in the same
+* transaction. Returns `actionContext`: the render is garbage collected after its outputs resolve,
+* so the caller must hold the context to keep it.
+*/
+function createRenderHeavyBlock(tx, tpl, inputs, baggage) {
+	const actionContext = createBlockActionContext(tx, baggage);
+	const { outputs } = require_render_template.createRenderTemplateWithResource(tx, tpl, true, inputs, HeavyBlockOutputNames, actionContext);
+	return actionContext === void 0 ? outputs : {
+		...outputs,
+		actionContext
+	};
 }
 function createBContextEnd(tx) {
 	const ctx = tx.createEphemeral(BContextEnd);
@@ -29,6 +60,8 @@ function createBContextFromUpstreams(tx, upstreamCtxs) {
 	tx.lock(ctx);
 	return ctx;
 }
+exports.ActionContextLinkCapability = ActionContextLinkCapability;
+exports.ActionContextType = ActionContextType;
 exports.BContext = BContext;
 exports.BContextEnd = BContextEnd;
 exports.BContextMultiParentPrefix = BContextMultiParentPrefix;

package/dist/mutator/template/render_block.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"render_block.cjs","names":["createRenderTemplate","field","Pl","randomUUID"],"sources":["../../../src/mutator/template/render_block.ts"],"sourcesContent":["import type { AnyRef, PlTransaction, ResourceRef, ResourceType } from \"@milaboratories/pl-client\";\nimport { field, Pl } from \"@milaboratories/pl-client\";\nimport { randomUUID } from \"node:crypto\";\nimport { createRenderTemplate } from \"./render_template\";\n\nexport const BContextEnd: ResourceType = { name: \"BContextEnd\", version: \"1\" };\nexport const BContext: ResourceType = { name: \"BContext\", version: \"1\" };\nexport const BContextId = \"id\";\nexport const BContextParent = \"parent\";\nexport const BContextMultiParentPrefix = \"parent/\";\n\n// TODO: add implementation for dual context heavy block.\n// export type BlockType =\n//   | 'LightBlock'\n//   | 'HeavyBlock'\n//   | 'DualContextHeavyBlock';\n// moved to project model ==>>>\n\nexport type HeavyBlockInputs = {\n  args: AnyRef;\n  blockId: AnyRef;\n  isProduction: AnyRef;\n  context: AnyRef;\n};\n\nexport type HeavyBlockOutputs = {\n  context: AnyRef;\n  result: AnyRef;\n};\n\nexport const HeavyBlockOutputNames: (keyof HeavyBlockOutputs)[] = [\"context\", \"result\"];\n\nexport function createRenderHeavyBlock(\n  tx: PlTransaction,\n  tpl: AnyRef,\n  inputs: HeavyBlockInputs,\n): HeavyBlockOutputs {\n  return createRenderTemplate(tx, tpl, true, inputs, HeavyBlockOutputNames);\n}\n\nexport type LightBlockInputs = {\n  args: AnyRef;\n  blockId: AnyRef;\n  stagingContext: AnyRef;\n  productionContext: AnyRef;\n};\n\nexport type LightBlockOutput = {\n  result: AnyRef;\n};\n\nexport const LightBlockOutputNames: (keyof LightBlockOutput)[] = [\"result\"];\n\nexport function createRenderLightBlock(\n  tx: PlTransaction,\n  tpl: ResourceRef,\n  inputs: LightBlockInputs,\n): LightBlockOutput {\n  return createRenderTemplate(tx, tpl, true, inputs, LightBlockOutputNames);\n}\n\nexport function createBContextEnd(tx: PlTransaction): ResourceRef {\n  const ctx = tx.createEphemeral(BContextEnd);\n  tx.lock(ctx);\n  return ctx;\n}\n\nexport function createBContextFromUpstreams(tx: PlTransaction, upstreamCtxs: AnyRef[]): AnyRef {\n  if (upstreamCtxs.length === 0) return createBContextEnd(tx);\n\n  if (upstreamCtxs.length === 1) return upstreamCtxs[0];\n\n  const ctx = tx.createEphemeral(BContext);\n\n  // setting id\n  tx.createField(field(ctx, BContextId), \"Input\", Pl.createPlString(tx, randomUUID()));\n\n  // setting parents\n  for (let i = 0; i < upstreamCtxs.length; i++)\n    tx.createField(field(ctx, `${BContextMultiParentPrefix}${i}`), \"Input\", upstreamCtxs[i]);\n\n  tx.lock(ctx);\n\n  return ctx;\n}\n"],"mappings":";;;;AAKA,MAAa,cAA4B;CAAE,MAAM;CAAe,SAAS;AAAI;AAC7E,MAAa,WAAyB;CAAE,MAAM;CAAY,SAAS;AAAI;AAGvE,MAAa,4BAA4B;AAqBzC,MAAa,wBAAqD,CAAC,WAAW,QAAQ;AAEtF,SAAgB,uBACd,IACA,KACA,QACmB;CACnB,OAAOA,wBAAAA,qBAAqB,IAAI,KAAK,MAAM,QAAQ,qBAAqB;AAC1E;AAuBA,SAAgB,kBAAkB,IAAgC;CAChE,MAAM,MAAM,GAAG,gBAAgB,WAAW;CAC1C,GAAG,KAAK,GAAG;CACX,OAAO;AACT;AAEA,SAAgB,4BAA4B,IAAmB,cAAgC;CAC7F,IAAI,aAAa,WAAW,GAAG,OAAO,kBAAkB,EAAE;CAE1D,IAAI,aAAa,WAAW,GAAG,OAAO,aAAa;CAEnD,MAAM,MAAM,GAAG,gBAAgB,QAAQ;CAGvC,GAAG,aAAA,GAAYC,0BAAAA,MAAAA,CAAM,KAAA,IAAe,GAAG,SAASC,0BAAAA,GAAG,eAAe,KAAA,GAAIC,YAAAA,WAAAA,CAAW,CAAC,CAAC;CAGnF,KAAK,IAAI,IAAI,GAAG,IAAI,aAAa,QAAQ,KACvC,GAAG,aAAA,GAAYF,0BAAAA,MAAAA,CAAM,KAAK,GAAG,4BAA4B,GAAG,GAAG,SAAS,aAAa,EAAE;CAEzF,GAAG,KAAK,GAAG;CAEX,OAAO;AACT"}
+{"version":3,"file":"render_block.cjs","names":["randomUUID","createRenderTemplateWithResource","field","Pl"],"sources":["../../../src/mutator/template/render_block.ts"],"sourcesContent":["import type { AnyRef, PlTransaction, ResourceRef, ResourceType } from \"@milaboratories/pl-client\";\nimport { field, Pl } from \"@milaboratories/pl-client\";\nimport { randomUUID } from \"node:crypto\";\nimport { createRenderTemplateWithResource } from \"./render_template\";\n\nexport const BContextEnd: ResourceType = { name: \"BContextEnd\", version: \"1\" };\nexport const BContext: ResourceType = { name: \"BContext\", version: \"1\" };\nexport const BContextId = \"id\";\nexport const BContextParent = \"parent\";\nexport const BContextMultiParentPrefix = \"parent/\";\n\n// TODO: add implementation for dual context heavy block.\n// export type BlockType =\n//   | 'LightBlock'\n//   | 'HeavyBlock'\n//   | 'DualContextHeavyBlock';\n// moved to project model ==>>>\n\nexport type HeavyBlockInputs = {\n  args: AnyRef;\n  blockId: AnyRef;\n  isProduction: AnyRef;\n  context: AnyRef;\n};\n\nexport type HeavyBlockOutputs = {\n  context: AnyRef;\n  result: AnyRef;\n};\n\nexport const HeavyBlockOutputNames: (keyof HeavyBlockOutputs)[] = [\"context\", \"result\"];\n\n/** Baggage of the root action context of a block render. See the block action context spec. */\nexport type BlockActionContextBaggage = {\n  /** Display name of the block. */\n  name: string;\n  /** JSON of the block pack spec. */\n  blockPack: string;\n  blockId: string;\n};\n\n/** Resource type of a block action context. See ActionContextV1Type in the backend. */\nexport const ActionContextType: ResourceType = { name: \"ActionContext\", version: \"1\" };\n\n/** The capability under which the backend accepts the \"actionContext\" link on a render. */\nexport const ActionContextLinkCapability = \"optionalFieldsInSchemas:v1\";\n\n/**\n * Creates the root action context of a block render: an ActionContext resource carrying the\n * baggage, with a new random `run-id`, since each render is one run of the block and the contexts\n * the templates create copy it. Undefined without baggage, or on a backend that cannot take the link.\n */\nfunction createBlockActionContext(\n  tx: PlTransaction,\n  baggage: BlockActionContextBaggage | undefined,\n): ResourceRef | undefined {\n  if (baggage === undefined || !tx.hasCapability(ActionContextLinkCapability)) return undefined;\n  return tx.createEphemeral(\n    ActionContextType,\n    JSON.stringify({\n      name: baggage.name,\n      \"block-pack\": baggage.blockPack,\n      \"block-id\": baggage.blockId,\n      \"run-id\": randomUUID(),\n    }),\n  );\n}\n\n/**\n * Creates the heavy block render, and with `baggage` its root action context in the same\n * transaction. Returns `actionContext`: the render is garbage collected after its outputs resolve,\n * so the caller must hold the context to keep it.\n */\nexport function createRenderHeavyBlock(\n  tx: PlTransaction,\n  tpl: AnyRef,\n  inputs: HeavyBlockInputs,\n  baggage?: BlockActionContextBaggage,\n): HeavyBlockOutputs & { actionContext?: ResourceRef } {\n  const actionContext = createBlockActionContext(tx, baggage);\n  const { outputs } = createRenderTemplateWithResource(\n    tx,\n    tpl,\n    true,\n    inputs,\n    HeavyBlockOutputNames,\n    actionContext,\n  );\n  return actionContext === undefined ? outputs : { ...outputs, actionContext };\n}\n\nexport type LightBlockInputs = {\n  args: AnyRef;\n  blockId: AnyRef;\n  stagingContext: AnyRef;\n  productionContext: AnyRef;\n};\n\nexport type LightBlockOutput = {\n  result: AnyRef;\n};\n\nexport const LightBlockOutputNames: (keyof LightBlockOutput)[] = [\"result\"];\n\n/**\n * Creates the light block render, with the same action context as a heavy one, so template code\n * of either kind knows its block and run.\n */\nexport function createRenderLightBlock(\n  tx: PlTransaction,\n  tpl: ResourceRef,\n  inputs: LightBlockInputs,\n  baggage?: BlockActionContextBaggage,\n): LightBlockOutput & { actionContext?: ResourceRef } {\n  const actionContext = createBlockActionContext(tx, baggage);\n  const { outputs } = createRenderTemplateWithResource(\n    tx,\n    tpl,\n    true,\n    inputs,\n    LightBlockOutputNames,\n    actionContext,\n  );\n  return actionContext === undefined ? outputs : { ...outputs, actionContext };\n}\n\nexport function createBContextEnd(tx: PlTransaction): ResourceRef {\n  const ctx = tx.createEphemeral(BContextEnd);\n  tx.lock(ctx);\n  return ctx;\n}\n\nexport function createBContextFromUpstreams(tx: PlTransaction, upstreamCtxs: AnyRef[]): AnyRef {\n  if (upstreamCtxs.length === 0) return createBContextEnd(tx);\n\n  if (upstreamCtxs.length === 1) return upstreamCtxs[0];\n\n  const ctx = tx.createEphemeral(BContext);\n\n  // setting id\n  tx.createField(field(ctx, BContextId), \"Input\", Pl.createPlString(tx, randomUUID()));\n\n  // setting parents\n  for (let i = 0; i < upstreamCtxs.length; i++)\n    tx.createField(field(ctx, `${BContextMultiParentPrefix}${i}`), \"Input\", upstreamCtxs[i]);\n\n  tx.lock(ctx);\n\n  return ctx;\n}\n"],"mappings":";;;;AAKA,MAAa,cAA4B;CAAE,MAAM;CAAe,SAAS;AAAI;AAC7E,MAAa,WAAyB;CAAE,MAAM;CAAY,SAAS;AAAI;AAGvE,MAAa,4BAA4B;AAqBzC,MAAa,wBAAqD,CAAC,WAAW,QAAQ;;AAYtF,MAAa,oBAAkC;CAAE,MAAM;CAAiB,SAAS;AAAI;;AAGrF,MAAa,8BAA8B;;;;;;AAO3C,SAAS,yBACP,IACA,SACyB;CACzB,IAAI,YAAY,KAAA,KAAa,CAAC,GAAG,cAAA,4BAAyC,GAAG,OAAO,KAAA;CACpF,OAAO,GAAG,gBACR,mBACA,KAAK,UAAU;EACb,MAAM,QAAQ;EACd,cAAc,QAAQ;EACtB,YAAY,QAAQ;EACpB,WAAA,GAAUA,YAAAA,WAAAA,CAAW;CACvB,CAAC,CACH;AACF;;;;;;AAOA,SAAgB,uBACd,IACA,KACA,QACA,SACqD;CACrD,MAAM,gBAAgB,yBAAyB,IAAI,OAAO;CAC1D,MAAM,EAAE,YAAYC,wBAAAA,iCAClB,IACA,KACA,MACA,QACA,uBACA,aACF;CACA,OAAO,kBAAkB,KAAA,IAAY,UAAU;EAAE,GAAG;EAAS;CAAc;AAC7E;AAqCA,SAAgB,kBAAkB,IAAgC;CAChE,MAAM,MAAM,GAAG,gBAAgB,WAAW;CAC1C,GAAG,KAAK,GAAG;CACX,OAAO;AACT;AAEA,SAAgB,4BAA4B,IAAmB,cAAgC;CAC7F,IAAI,aAAa,WAAW,GAAG,OAAO,kBAAkB,EAAE;CAE1D,IAAI,aAAa,WAAW,GAAG,OAAO,aAAa;CAEnD,MAAM,MAAM,GAAG,gBAAgB,QAAQ;CAGvC,GAAG,aAAA,GAAYC,0BAAAA,MAAAA,CAAM,KAAA,IAAe,GAAG,SAASC,0BAAAA,GAAG,eAAe,KAAA,GAAIH,YAAAA,WAAAA,CAAW,CAAC,CAAC;CAGnF,KAAK,IAAI,IAAI,GAAG,IAAI,aAAa,QAAQ,KACvC,GAAG,aAAA,GAAYE,0BAAAA,MAAAA,CAAM,KAAK,GAAG,4BAA4B,GAAG,GAAG,SAAS,aAAa,EAAE;CAEzF,GAAG,KAAK,GAAG;CAEX,OAAO;AACT"}

package/dist/mutator/template/render_block.js

@@ -1,4 +1,4 @@
-import { createRenderTemplate } from "./render_template.js";
+import { createRenderTemplateWithResource } from "./render_template.js";
 import { Pl, field } from "@milaboratories/pl-client";
 import { randomUUID } from "node:crypto";
 // src/mutator/template/render_block.ts
@@ -12,8 +12,39 @@ const BContext = {
 };
 const BContextMultiParentPrefix = "parent/";
 const HeavyBlockOutputNames = ["context", "result"];
-function createRenderHeavyBlock(tx, tpl, inputs) {
-	return createRenderTemplate(tx, tpl, true, inputs, HeavyBlockOutputNames);
+/** Resource type of a block action context. See ActionContextV1Type in the backend. */
+const ActionContextType = {
+	name: "ActionContext",
+	version: "1"
+};
+/** The capability under which the backend accepts the "actionContext" link on a render. */
+const ActionContextLinkCapability = "optionalFieldsInSchemas:v1";
+/**
+* Creates the root action context of a block render: an ActionContext resource carrying the
+* baggage, with a new random `run-id`, since each render is one run of the block and the contexts
+* the templates create copy it. Undefined without baggage, or on a backend that cannot take the link.
+*/
+function createBlockActionContext(tx, baggage) {
+	if (baggage === void 0 || !tx.hasCapability("optionalFieldsInSchemas:v1")) return void 0;
+	return tx.createEphemeral(ActionContextType, JSON.stringify({
+		name: baggage.name,
+		"block-pack": baggage.blockPack,
+		"block-id": baggage.blockId,
+		"run-id": randomUUID()
+	}));
+}
+/**
+* Creates the heavy block render, and with `baggage` its root action context in the same
+* transaction. Returns `actionContext`: the render is garbage collected after its outputs resolve,
+* so the caller must hold the context to keep it.
+*/
+function createRenderHeavyBlock(tx, tpl, inputs, baggage) {
+	const actionContext = createBlockActionContext(tx, baggage);
+	const { outputs } = createRenderTemplateWithResource(tx, tpl, true, inputs, HeavyBlockOutputNames, actionContext);
+	return actionContext === void 0 ? outputs : {
+		...outputs,
+		actionContext
+	};
 }
 function createBContextEnd(tx) {
 	const ctx = tx.createEphemeral(BContextEnd);
@@ -29,6 +60,6 @@ function createBContextFromUpstreams(tx, upstreamCtxs) {
 	tx.lock(ctx);
 	return ctx;
 }
-export { BContext, BContextEnd, BContextMultiParentPrefix, HeavyBlockOutputNames, createBContextEnd, createBContextFromUpstreams, createRenderHeavyBlock };
+export { ActionContextLinkCapability, ActionContextType, BContext, BContextEnd, BContextMultiParentPrefix, HeavyBlockOutputNames, createBContextEnd, createBContextFromUpstreams, createRenderHeavyBlock };
 
 //# sourceMappingURL=render_block.js.map

package/dist/mutator/template/render_block.js.map

@@ -1 +1 @@
-{"version":3,"file":"render_block.js","names":[],"sources":["../../../src/mutator/template/render_block.ts"],"sourcesContent":["import type { AnyRef, PlTransaction, ResourceRef, ResourceType } from \"@milaboratories/pl-client\";\nimport { field, Pl } from \"@milaboratories/pl-client\";\nimport { randomUUID } from \"node:crypto\";\nimport { createRenderTemplate } from \"./render_template\";\n\nexport const BContextEnd: ResourceType = { name: \"BContextEnd\", version: \"1\" };\nexport const BContext: ResourceType = { name: \"BContext\", version: \"1\" };\nexport const BContextId = \"id\";\nexport const BContextParent = \"parent\";\nexport const BContextMultiParentPrefix = \"parent/\";\n\n// TODO: add implementation for dual context heavy block.\n// export type BlockType =\n//   | 'LightBlock'\n//   | 'HeavyBlock'\n//   | 'DualContextHeavyBlock';\n// moved to project model ==>>>\n\nexport type HeavyBlockInputs = {\n  args: AnyRef;\n  blockId: AnyRef;\n  isProduction: AnyRef;\n  context: AnyRef;\n};\n\nexport type HeavyBlockOutputs = {\n  context: AnyRef;\n  result: AnyRef;\n};\n\nexport const HeavyBlockOutputNames: (keyof HeavyBlockOutputs)[] = [\"context\", \"result\"];\n\nexport function createRenderHeavyBlock(\n  tx: PlTransaction,\n  tpl: AnyRef,\n  inputs: HeavyBlockInputs,\n): HeavyBlockOutputs {\n  return createRenderTemplate(tx, tpl, true, inputs, HeavyBlockOutputNames);\n}\n\nexport type LightBlockInputs = {\n  args: AnyRef;\n  blockId: AnyRef;\n  stagingContext: AnyRef;\n  productionContext: AnyRef;\n};\n\nexport type LightBlockOutput = {\n  result: AnyRef;\n};\n\nexport const LightBlockOutputNames: (keyof LightBlockOutput)[] = [\"result\"];\n\nexport function createRenderLightBlock(\n  tx: PlTransaction,\n  tpl: ResourceRef,\n  inputs: LightBlockInputs,\n): LightBlockOutput {\n  return createRenderTemplate(tx, tpl, true, inputs, LightBlockOutputNames);\n}\n\nexport function createBContextEnd(tx: PlTransaction): ResourceRef {\n  const ctx = tx.createEphemeral(BContextEnd);\n  tx.lock(ctx);\n  return ctx;\n}\n\nexport function createBContextFromUpstreams(tx: PlTransaction, upstreamCtxs: AnyRef[]): AnyRef {\n  if (upstreamCtxs.length === 0) return createBContextEnd(tx);\n\n  if (upstreamCtxs.length === 1) return upstreamCtxs[0];\n\n  const ctx = tx.createEphemeral(BContext);\n\n  // setting id\n  tx.createField(field(ctx, BContextId), \"Input\", Pl.createPlString(tx, randomUUID()));\n\n  // setting parents\n  for (let i = 0; i < upstreamCtxs.length; i++)\n    tx.createField(field(ctx, `${BContextMultiParentPrefix}${i}`), \"Input\", upstreamCtxs[i]);\n\n  tx.lock(ctx);\n\n  return ctx;\n}\n"],"mappings":";;;;AAKA,MAAa,cAA4B;CAAE,MAAM;CAAe,SAAS;AAAI;AAC7E,MAAa,WAAyB;CAAE,MAAM;CAAY,SAAS;AAAI;AAGvE,MAAa,4BAA4B;AAqBzC,MAAa,wBAAqD,CAAC,WAAW,QAAQ;AAEtF,SAAgB,uBACd,IACA,KACA,QACmB;CACnB,OAAO,qBAAqB,IAAI,KAAK,MAAM,QAAQ,qBAAqB;AAC1E;AAuBA,SAAgB,kBAAkB,IAAgC;CAChE,MAAM,MAAM,GAAG,gBAAgB,WAAW;CAC1C,GAAG,KAAK,GAAG;CACX,OAAO;AACT;AAEA,SAAgB,4BAA4B,IAAmB,cAAgC;CAC7F,IAAI,aAAa,WAAW,GAAG,OAAO,kBAAkB,EAAE;CAE1D,IAAI,aAAa,WAAW,GAAG,OAAO,aAAa;CAEnD,MAAM,MAAM,GAAG,gBAAgB,QAAQ;CAGvC,GAAG,YAAY,MAAM,KAAA,IAAe,GAAG,SAAS,GAAG,eAAe,IAAI,WAAW,CAAC,CAAC;CAGnF,KAAK,IAAI,IAAI,GAAG,IAAI,aAAa,QAAQ,KACvC,GAAG,YAAY,MAAM,KAAK,GAAG,4BAA4B,GAAG,GAAG,SAAS,aAAa,EAAE;CAEzF,GAAG,KAAK,GAAG;CAEX,OAAO;AACT"}
+{"version":3,"file":"render_block.js","names":[],"sources":["../../../src/mutator/template/render_block.ts"],"sourcesContent":["import type { AnyRef, PlTransaction, ResourceRef, ResourceType } from \"@milaboratories/pl-client\";\nimport { field, Pl } from \"@milaboratories/pl-client\";\nimport { randomUUID } from \"node:crypto\";\nimport { createRenderTemplateWithResource } from \"./render_template\";\n\nexport const BContextEnd: ResourceType = { name: \"BContextEnd\", version: \"1\" };\nexport const BContext: ResourceType = { name: \"BContext\", version: \"1\" };\nexport const BContextId = \"id\";\nexport const BContextParent = \"parent\";\nexport const BContextMultiParentPrefix = \"parent/\";\n\n// TODO: add implementation for dual context heavy block.\n// export type BlockType =\n//   | 'LightBlock'\n//   | 'HeavyBlock'\n//   | 'DualContextHeavyBlock';\n// moved to project model ==>>>\n\nexport type HeavyBlockInputs = {\n  args: AnyRef;\n  blockId: AnyRef;\n  isProduction: AnyRef;\n  context: AnyRef;\n};\n\nexport type HeavyBlockOutputs = {\n  context: AnyRef;\n  result: AnyRef;\n};\n\nexport const HeavyBlockOutputNames: (keyof HeavyBlockOutputs)[] = [\"context\", \"result\"];\n\n/** Baggage of the root action context of a block render. See the block action context spec. */\nexport type BlockActionContextBaggage = {\n  /** Display name of the block. */\n  name: string;\n  /** JSON of the block pack spec. */\n  blockPack: string;\n  blockId: string;\n};\n\n/** Resource type of a block action context. See ActionContextV1Type in the backend. */\nexport const ActionContextType: ResourceType = { name: \"ActionContext\", version: \"1\" };\n\n/** The capability under which the backend accepts the \"actionContext\" link on a render. */\nexport const ActionContextLinkCapability = \"optionalFieldsInSchemas:v1\";\n\n/**\n * Creates the root action context of a block render: an ActionContext resource carrying the\n * baggage, with a new random `run-id`, since each render is one run of the block and the contexts\n * the templates create copy it. Undefined without baggage, or on a backend that cannot take the link.\n */\nfunction createBlockActionContext(\n  tx: PlTransaction,\n  baggage: BlockActionContextBaggage | undefined,\n): ResourceRef | undefined {\n  if (baggage === undefined || !tx.hasCapability(ActionContextLinkCapability)) return undefined;\n  return tx.createEphemeral(\n    ActionContextType,\n    JSON.stringify({\n      name: baggage.name,\n      \"block-pack\": baggage.blockPack,\n      \"block-id\": baggage.blockId,\n      \"run-id\": randomUUID(),\n    }),\n  );\n}\n\n/**\n * Creates the heavy block render, and with `baggage` its root action context in the same\n * transaction. Returns `actionContext`: the render is garbage collected after its outputs resolve,\n * so the caller must hold the context to keep it.\n */\nexport function createRenderHeavyBlock(\n  tx: PlTransaction,\n  tpl: AnyRef,\n  inputs: HeavyBlockInputs,\n  baggage?: BlockActionContextBaggage,\n): HeavyBlockOutputs & { actionContext?: ResourceRef } {\n  const actionContext = createBlockActionContext(tx, baggage);\n  const { outputs } = createRenderTemplateWithResource(\n    tx,\n    tpl,\n    true,\n    inputs,\n    HeavyBlockOutputNames,\n    actionContext,\n  );\n  return actionContext === undefined ? outputs : { ...outputs, actionContext };\n}\n\nexport type LightBlockInputs = {\n  args: AnyRef;\n  blockId: AnyRef;\n  stagingContext: AnyRef;\n  productionContext: AnyRef;\n};\n\nexport type LightBlockOutput = {\n  result: AnyRef;\n};\n\nexport const LightBlockOutputNames: (keyof LightBlockOutput)[] = [\"result\"];\n\n/**\n * Creates the light block render, with the same action context as a heavy one, so template code\n * of either kind knows its block and run.\n */\nexport function createRenderLightBlock(\n  tx: PlTransaction,\n  tpl: ResourceRef,\n  inputs: LightBlockInputs,\n  baggage?: BlockActionContextBaggage,\n): LightBlockOutput & { actionContext?: ResourceRef } {\n  const actionContext = createBlockActionContext(tx, baggage);\n  const { outputs } = createRenderTemplateWithResource(\n    tx,\n    tpl,\n    true,\n    inputs,\n    LightBlockOutputNames,\n    actionContext,\n  );\n  return actionContext === undefined ? outputs : { ...outputs, actionContext };\n}\n\nexport function createBContextEnd(tx: PlTransaction): ResourceRef {\n  const ctx = tx.createEphemeral(BContextEnd);\n  tx.lock(ctx);\n  return ctx;\n}\n\nexport function createBContextFromUpstreams(tx: PlTransaction, upstreamCtxs: AnyRef[]): AnyRef {\n  if (upstreamCtxs.length === 0) return createBContextEnd(tx);\n\n  if (upstreamCtxs.length === 1) return upstreamCtxs[0];\n\n  const ctx = tx.createEphemeral(BContext);\n\n  // setting id\n  tx.createField(field(ctx, BContextId), \"Input\", Pl.createPlString(tx, randomUUID()));\n\n  // setting parents\n  for (let i = 0; i < upstreamCtxs.length; i++)\n    tx.createField(field(ctx, `${BContextMultiParentPrefix}${i}`), \"Input\", upstreamCtxs[i]);\n\n  tx.lock(ctx);\n\n  return ctx;\n}\n"],"mappings":";;;;AAKA,MAAa,cAA4B;CAAE,MAAM;CAAe,SAAS;AAAI;AAC7E,MAAa,WAAyB;CAAE,MAAM;CAAY,SAAS;AAAI;AAGvE,MAAa,4BAA4B;AAqBzC,MAAa,wBAAqD,CAAC,WAAW,QAAQ;;AAYtF,MAAa,oBAAkC;CAAE,MAAM;CAAiB,SAAS;AAAI;;AAGrF,MAAa,8BAA8B;;;;;;AAO3C,SAAS,yBACP,IACA,SACyB;CACzB,IAAI,YAAY,KAAA,KAAa,CAAC,GAAG,cAAA,4BAAyC,GAAG,OAAO,KAAA;CACpF,OAAO,GAAG,gBACR,mBACA,KAAK,UAAU;EACb,MAAM,QAAQ;EACd,cAAc,QAAQ;EACtB,YAAY,QAAQ;EACpB,UAAU,WAAW;CACvB,CAAC,CACH;AACF;;;;;;AAOA,SAAgB,uBACd,IACA,KACA,QACA,SACqD;CACrD,MAAM,gBAAgB,yBAAyB,IAAI,OAAO;CAC1D,MAAM,EAAE,YAAY,iCAClB,IACA,KACA,MACA,QACA,uBACA,aACF;CACA,OAAO,kBAAkB,KAAA,IAAY,UAAU;EAAE,GAAG;EAAS;CAAc;AAC7E;AAqCA,SAAgB,kBAAkB,IAAgC;CAChE,MAAM,MAAM,GAAG,gBAAgB,WAAW;CAC1C,GAAG,KAAK,GAAG;CACX,OAAO;AACT;AAEA,SAAgB,4BAA4B,IAAmB,cAAgC;CAC7F,IAAI,aAAa,WAAW,GAAG,OAAO,kBAAkB,EAAE;CAE1D,IAAI,aAAa,WAAW,GAAG,OAAO,aAAa;CAEnD,MAAM,MAAM,GAAG,gBAAgB,QAAQ;CAGvC,GAAG,YAAY,MAAM,KAAA,IAAe,GAAG,SAAS,GAAG,eAAe,IAAI,WAAW,CAAC,CAAC;CAGnF,KAAK,IAAI,IAAI,GAAG,IAAI,aAAa,QAAQ,KACvC,GAAG,YAAY,MAAM,KAAK,GAAG,4BAA4B,GAAG,GAAG,SAAS,aAAa,EAAE;CAEzF,GAAG,KAAK,GAAG;CAEX,OAAO;AACT"}

package/dist/mutator/template/render_template.cjs

@@ -18,15 +18,30 @@ const RenderTemplate = {
 * @param outputNames names of the outputs to collect and return from this method
 */
 function createRenderTemplate(tx, tpl, ephemeral, inputs, outputNames) {
+	return createRenderTemplateWithResource(tx, tpl, ephemeral, inputs, outputNames).outputs;
+}
+/**
+* Same as {@link createRenderTemplate}, and also returns the render resource itself.
+*
+* With `actionContext`, the render's "actionContext" service field points to it. The link is created
+* before the inputs are locked: the backend accepts it only in the creating transaction, ahead of
+* any explicit input lock.
+*/
+function createRenderTemplateWithResource(tx, tpl, ephemeral, inputs, outputNames, actionContext) {
 	if (outputNames.length === 0) throw new Error("Zero output names provided");
 	const rId = ephemeral ? tx.createEphemeral(EphRenderTemplate) : tx.createStruct(RenderTemplate);
 	const tplField = (0, _milaboratories_pl_client.field)(rId, "template");
 	const inputsField = (0, _milaboratories_pl_client.field)(rId, "inputs");
 	tx.createField(tplField, "Input", tpl);
 	tx.createField(inputsField, "Input", _milaboratories_pl_client.Pl.createPlMap(tx, inputs, ephemeral));
+	if (actionContext !== void 0) tx.createField((0, _milaboratories_pl_client.field)(rId, "actionContext"), "Service", actionContext);
 	tx.lockInputs(rId);
-	return _milaboratories_pl_client.Pl.futureRecord(tx, rId, outputNames, "Output", "outputs/");
+	return {
+		render: rId,
+		outputs: _milaboratories_pl_client.Pl.futureRecord(tx, rId, outputNames, "Output", "outputs/")
+	};
 }
 exports.createRenderTemplate = createRenderTemplate;
+exports.createRenderTemplateWithResource = createRenderTemplateWithResource;
 
 //# sourceMappingURL=render_template.cjs.map

package/dist/mutator/template/render_template.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"render_template.cjs","names":["field","Pl"],"sources":["../../../src/mutator/template/render_template.ts"],"sourcesContent":["import type { AnyRef, FieldRef, PlTransaction } from \"@milaboratories/pl-client\";\nimport { field, Pl } from \"@milaboratories/pl-client\";\nimport type { ResourceType } from \"@platforma-sdk/model\";\n\nconst EphRenderTemplate: ResourceType = {\n  name: \"EphRenderTemplate\",\n  version: \"1\",\n};\nconst RenderTemplate: ResourceType = {\n  name: \"RenderTemplate\",\n  version: \"1\",\n};\n\n/**\n * Creates render template operation, for a given remplate and inputs.\n *\n * @param tx transaction to use during rendering creation\n * @param tpl reference to the template resource (see {@link loadTemplate})\n * @param ephemeral true for ephemeral templates, false for pure templates\n * @param inputs map of inputs pointing to other resources or fields\n * @param outputNames names of the outputs to collect and return from this method\n */\nexport function createRenderTemplate<O extends string>(\n  tx: PlTransaction,\n  tpl: AnyRef,\n  ephemeral: boolean,\n  inputs: Pl.PlRecord,\n  outputNames: O[],\n): Record<O, FieldRef> {\n  if (outputNames.length === 0) throw new Error(\"Zero output names provided\");\n  const rId = ephemeral ? tx.createEphemeral(EphRenderTemplate) : tx.createStruct(RenderTemplate);\n\n  const tplField = field(rId, \"template\");\n  const inputsField = field(rId, \"inputs\");\n\n  tx.createField(tplField, \"Input\", tpl);\n  tx.createField(inputsField, \"Input\", Pl.createPlMap(tx, inputs, ephemeral));\n  tx.lockInputs(rId);\n\n  return Pl.futureRecord(tx, rId, outputNames, \"Output\", \"outputs/\");\n}\n"],"mappings":";;AAIA,MAAM,oBAAkC;CACtC,MAAM;CACN,SAAS;AACX;AACA,MAAM,iBAA+B;CACnC,MAAM;CACN,SAAS;AACX;;;;;;;;;;AAWA,SAAgB,qBACd,IACA,KACA,WACA,QACA,aACqB;CACrB,IAAI,YAAY,WAAW,GAAG,MAAM,IAAI,MAAM,4BAA4B;CAC1E,MAAM,MAAM,YAAY,GAAG,gBAAgB,iBAAiB,IAAI,GAAG,aAAa,cAAc;CAE9F,MAAM,YAAA,GAAWA,0BAAAA,MAAAA,CAAM,KAAK,UAAU;CACtC,MAAM,eAAA,GAAcA,0BAAAA,MAAAA,CAAM,KAAK,QAAQ;CAEvC,GAAG,YAAY,UAAU,SAAS,GAAG;CACrC,GAAG,YAAY,aAAa,SAASC,0BAAAA,GAAG,YAAY,IAAI,QAAQ,SAAS,CAAC;CAC1E,GAAG,WAAW,GAAG;CAEjB,OAAOA,0BAAAA,GAAG,aAAa,IAAI,KAAK,aAAa,UAAU,UAAU;AACnE"}
+{"version":3,"file":"render_template.cjs","names":["field","Pl"],"sources":["../../../src/mutator/template/render_template.ts"],"sourcesContent":["import type { AnyRef, FieldRef, PlTransaction, ResourceRef } from \"@milaboratories/pl-client\";\nimport { field, Pl } from \"@milaboratories/pl-client\";\nimport type { ResourceType } from \"@platforma-sdk/model\";\n\nconst EphRenderTemplate: ResourceType = {\n  name: \"EphRenderTemplate\",\n  version: \"1\",\n};\nconst RenderTemplate: ResourceType = {\n  name: \"RenderTemplate\",\n  version: \"1\",\n};\n\n/**\n * Creates render template operation, for a given remplate and inputs.\n *\n * @param tx transaction to use during rendering creation\n * @param tpl reference to the template resource (see {@link loadTemplate})\n * @param ephemeral true for ephemeral templates, false for pure templates\n * @param inputs map of inputs pointing to other resources or fields\n * @param outputNames names of the outputs to collect and return from this method\n */\nexport function createRenderTemplate<O extends string>(\n  tx: PlTransaction,\n  tpl: AnyRef,\n  ephemeral: boolean,\n  inputs: Pl.PlRecord,\n  outputNames: O[],\n): Record<O, FieldRef> {\n  return createRenderTemplateWithResource(tx, tpl, ephemeral, inputs, outputNames).outputs;\n}\n\n/**\n * Same as {@link createRenderTemplate}, and also returns the render resource itself.\n *\n * With `actionContext`, the render's \"actionContext\" service field points to it. The link is created\n * before the inputs are locked: the backend accepts it only in the creating transaction, ahead of\n * any explicit input lock.\n */\nexport function createRenderTemplateWithResource<O extends string>(\n  tx: PlTransaction,\n  tpl: AnyRef,\n  ephemeral: boolean,\n  inputs: Pl.PlRecord,\n  outputNames: O[],\n  actionContext?: AnyRef,\n): { render: ResourceRef; outputs: Record<O, FieldRef> } {\n  if (outputNames.length === 0) throw new Error(\"Zero output names provided\");\n  const rId = ephemeral ? tx.createEphemeral(EphRenderTemplate) : tx.createStruct(RenderTemplate);\n\n  const tplField = field(rId, \"template\");\n  const inputsField = field(rId, \"inputs\");\n\n  tx.createField(tplField, \"Input\", tpl);\n  tx.createField(inputsField, \"Input\", Pl.createPlMap(tx, inputs, ephemeral));\n  if (actionContext !== undefined)\n    tx.createField(field(rId, \"actionContext\"), \"Service\", actionContext);\n  tx.lockInputs(rId);\n\n  return { render: rId, outputs: Pl.futureRecord(tx, rId, outputNames, \"Output\", \"outputs/\") };\n}\n"],"mappings":";;AAIA,MAAM,oBAAkC;CACtC,MAAM;CACN,SAAS;AACX;AACA,MAAM,iBAA+B;CACnC,MAAM;CACN,SAAS;AACX;;;;;;;;;;AAWA,SAAgB,qBACd,IACA,KACA,WACA,QACA,aACqB;CACrB,OAAO,iCAAiC,IAAI,KAAK,WAAW,QAAQ,WAAW,CAAC,CAAC;AACnF;;;;;;;;AASA,SAAgB,iCACd,IACA,KACA,WACA,QACA,aACA,eACuD;CACvD,IAAI,YAAY,WAAW,GAAG,MAAM,IAAI,MAAM,4BAA4B;CAC1E,MAAM,MAAM,YAAY,GAAG,gBAAgB,iBAAiB,IAAI,GAAG,aAAa,cAAc;CAE9F,MAAM,YAAA,GAAWA,0BAAAA,MAAAA,CAAM,KAAK,UAAU;CACtC,MAAM,eAAA,GAAcA,0BAAAA,MAAAA,CAAM,KAAK,QAAQ;CAEvC,GAAG,YAAY,UAAU,SAAS,GAAG;CACrC,GAAG,YAAY,aAAa,SAASC,0BAAAA,GAAG,YAAY,IAAI,QAAQ,SAAS,CAAC;CAC1E,IAAI,kBAAkB,KAAA,GACpB,GAAG,aAAA,GAAYD,0BAAAA,MAAAA,CAAM,KAAK,eAAe,GAAG,WAAW,aAAa;CACtE,GAAG,WAAW,GAAG;CAEjB,OAAO;EAAE,QAAQ;EAAK,SAASC,0BAAAA,GAAG,aAAa,IAAI,KAAK,aAAa,UAAU,UAAU;CAAE;AAC7F"}

package/dist/mutator/template/render_template.d.ts

@@ -1,4 +1,4 @@
-import { AnyRef, FieldRef, Pl, PlTransaction } from "@milaboratories/pl-client";
+import { AnyRef, FieldRef, Pl, PlTransaction, ResourceRef } from "@milaboratories/pl-client";
 /**
  * Creates render template operation, for a given remplate and inputs.
  *
@@ -9,4 +9,15 @@ import { AnyRef, FieldRef, Pl, PlTransaction } from "@milaboratories/pl-client";
  * @param outputNames names of the outputs to collect and return from this method
  */
 export declare function createRenderTemplate<O extends string>(tx: PlTransaction, tpl: AnyRef, ephemeral: boolean, inputs: Pl.PlRecord, outputNames: O[]): Record<O, FieldRef>;
+/**
+ * Same as {@link createRenderTemplate}, and also returns the render resource itself.
+ *
+ * With `actionContext`, the render's "actionContext" service field points to it. The link is created
+ * before the inputs are locked: the backend accepts it only in the creating transaction, ahead of
+ * any explicit input lock.
+ */
+export declare function createRenderTemplateWithResource<O extends string>(tx: PlTransaction, tpl: AnyRef, ephemeral: boolean, inputs: Pl.PlRecord, outputNames: O[], actionContext?: AnyRef): {
+  render: ResourceRef;
+  outputs: Record<O, FieldRef>;
+};
 //# sourceMappingURL=render_template.d.ts.map

package/dist/mutator/template/render_template.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"render_template.d.ts","names":[],"sources":["../../../src/mutator/template/render_template.ts"],"mappings":";;;;;;;;;;wBAsBgB,qBAAqB,kBACnC,IAAI,eACJ,KAAK,QACL,oBACA,QAAQ,GAAG,UACX,aAAa,MACZ,OAAO,GAAG"}
+{"version":3,"file":"render_template.d.ts","names":[],"sources":["../../../src/mutator/template/render_template.ts"],"mappings":";;;;;;;;;;wBAsBgB,qBAAqB,kBACnC,IAAI,eACJ,KAAK,QACL,oBACA,QAAQ,GAAG,UACX,aAAa,MACZ,OAAO,GAAG;;;;;;;;wBAWG,iCAAiC,kBAC/C,IAAI,eACJ,KAAK,QACL,oBACA,QAAQ,GAAG,UACX,aAAa,KACb,gBAAgB;EACb,QAAQ;EAAa,SAAS,OAAO,GAAG"}

package/dist/mutator/template/render_template.js

@@ -18,15 +18,29 @@ const RenderTemplate = {
 * @param outputNames names of the outputs to collect and return from this method
 */
 function createRenderTemplate(tx, tpl, ephemeral, inputs, outputNames) {
+	return createRenderTemplateWithResource(tx, tpl, ephemeral, inputs, outputNames).outputs;
+}
+/**
+* Same as {@link createRenderTemplate}, and also returns the render resource itself.
+*
+* With `actionContext`, the render's "actionContext" service field points to it. The link is created
+* before the inputs are locked: the backend accepts it only in the creating transaction, ahead of
+* any explicit input lock.
+*/
+function createRenderTemplateWithResource(tx, tpl, ephemeral, inputs, outputNames, actionContext) {
 	if (outputNames.length === 0) throw new Error("Zero output names provided");
 	const rId = ephemeral ? tx.createEphemeral(EphRenderTemplate) : tx.createStruct(RenderTemplate);
 	const tplField = field(rId, "template");
 	const inputsField = field(rId, "inputs");
 	tx.createField(tplField, "Input", tpl);
 	tx.createField(inputsField, "Input", Pl.createPlMap(tx, inputs, ephemeral));
+	if (actionContext !== void 0) tx.createField(field(rId, "actionContext"), "Service", actionContext);
 	tx.lockInputs(rId);
-	return Pl.futureRecord(tx, rId, outputNames, "Output", "outputs/");
+	return {
+		render: rId,
+		outputs: Pl.futureRecord(tx, rId, outputNames, "Output", "outputs/")
+	};
 }
-export { createRenderTemplate };
+export { createRenderTemplate, createRenderTemplateWithResource };
 
 //# sourceMappingURL=render_template.js.map

package/dist/mutator/template/render_template.js.map

@@ -1 +1 @@
-{"version":3,"file":"render_template.js","names":[],"sources":["../../../src/mutator/template/render_template.ts"],"sourcesContent":["import type { AnyRef, FieldRef, PlTransaction } from \"@milaboratories/pl-client\";\nimport { field, Pl } from \"@milaboratories/pl-client\";\nimport type { ResourceType } from \"@platforma-sdk/model\";\n\nconst EphRenderTemplate: ResourceType = {\n  name: \"EphRenderTemplate\",\n  version: \"1\",\n};\nconst RenderTemplate: ResourceType = {\n  name: \"RenderTemplate\",\n  version: \"1\",\n};\n\n/**\n * Creates render template operation, for a given remplate and inputs.\n *\n * @param tx transaction to use during rendering creation\n * @param tpl reference to the template resource (see {@link loadTemplate})\n * @param ephemeral true for ephemeral templates, false for pure templates\n * @param inputs map of inputs pointing to other resources or fields\n * @param outputNames names of the outputs to collect and return from this method\n */\nexport function createRenderTemplate<O extends string>(\n  tx: PlTransaction,\n  tpl: AnyRef,\n  ephemeral: boolean,\n  inputs: Pl.PlRecord,\n  outputNames: O[],\n): Record<O, FieldRef> {\n  if (outputNames.length === 0) throw new Error(\"Zero output names provided\");\n  const rId = ephemeral ? tx.createEphemeral(EphRenderTemplate) : tx.createStruct(RenderTemplate);\n\n  const tplField = field(rId, \"template\");\n  const inputsField = field(rId, \"inputs\");\n\n  tx.createField(tplField, \"Input\", tpl);\n  tx.createField(inputsField, \"Input\", Pl.createPlMap(tx, inputs, ephemeral));\n  tx.lockInputs(rId);\n\n  return Pl.futureRecord(tx, rId, outputNames, \"Output\", \"outputs/\");\n}\n"],"mappings":";;AAIA,MAAM,oBAAkC;CACtC,MAAM;CACN,SAAS;AACX;AACA,MAAM,iBAA+B;CACnC,MAAM;CACN,SAAS;AACX;;;;;;;;;;AAWA,SAAgB,qBACd,IACA,KACA,WACA,QACA,aACqB;CACrB,IAAI,YAAY,WAAW,GAAG,MAAM,IAAI,MAAM,4BAA4B;CAC1E,MAAM,MAAM,YAAY,GAAG,gBAAgB,iBAAiB,IAAI,GAAG,aAAa,cAAc;CAE9F,MAAM,WAAW,MAAM,KAAK,UAAU;CACtC,MAAM,cAAc,MAAM,KAAK,QAAQ;CAEvC,GAAG,YAAY,UAAU,SAAS,GAAG;CACrC,GAAG,YAAY,aAAa,SAAS,GAAG,YAAY,IAAI,QAAQ,SAAS,CAAC;CAC1E,GAAG,WAAW,GAAG;CAEjB,OAAO,GAAG,aAAa,IAAI,KAAK,aAAa,UAAU,UAAU;AACnE"}
+{"version":3,"file":"render_template.js","names":[],"sources":["../../../src/mutator/template/render_template.ts"],"sourcesContent":["import type { AnyRef, FieldRef, PlTransaction, ResourceRef } from \"@milaboratories/pl-client\";\nimport { field, Pl } from \"@milaboratories/pl-client\";\nimport type { ResourceType } from \"@platforma-sdk/model\";\n\nconst EphRenderTemplate: ResourceType = {\n  name: \"EphRenderTemplate\",\n  version: \"1\",\n};\nconst RenderTemplate: ResourceType = {\n  name: \"RenderTemplate\",\n  version: \"1\",\n};\n\n/**\n * Creates render template operation, for a given remplate and inputs.\n *\n * @param tx transaction to use during rendering creation\n * @param tpl reference to the template resource (see {@link loadTemplate})\n * @param ephemeral true for ephemeral templates, false for pure templates\n * @param inputs map of inputs pointing to other resources or fields\n * @param outputNames names of the outputs to collect and return from this method\n */\nexport function createRenderTemplate<O extends string>(\n  tx: PlTransaction,\n  tpl: AnyRef,\n  ephemeral: boolean,\n  inputs: Pl.PlRecord,\n  outputNames: O[],\n): Record<O, FieldRef> {\n  return createRenderTemplateWithResource(tx, tpl, ephemeral, inputs, outputNames).outputs;\n}\n\n/**\n * Same as {@link createRenderTemplate}, and also returns the render resource itself.\n *\n * With `actionContext`, the render's \"actionContext\" service field points to it. The link is created\n * before the inputs are locked: the backend accepts it only in the creating transaction, ahead of\n * any explicit input lock.\n */\nexport function createRenderTemplateWithResource<O extends string>(\n  tx: PlTransaction,\n  tpl: AnyRef,\n  ephemeral: boolean,\n  inputs: Pl.PlRecord,\n  outputNames: O[],\n  actionContext?: AnyRef,\n): { render: ResourceRef; outputs: Record<O, FieldRef> } {\n  if (outputNames.length === 0) throw new Error(\"Zero output names provided\");\n  const rId = ephemeral ? tx.createEphemeral(EphRenderTemplate) : tx.createStruct(RenderTemplate);\n\n  const tplField = field(rId, \"template\");\n  const inputsField = field(rId, \"inputs\");\n\n  tx.createField(tplField, \"Input\", tpl);\n  tx.createField(inputsField, \"Input\", Pl.createPlMap(tx, inputs, ephemeral));\n  if (actionContext !== undefined)\n    tx.createField(field(rId, \"actionContext\"), \"Service\", actionContext);\n  tx.lockInputs(rId);\n\n  return { render: rId, outputs: Pl.futureRecord(tx, rId, outputNames, \"Output\", \"outputs/\") };\n}\n"],"mappings":";;AAIA,MAAM,oBAAkC;CACtC,MAAM;CACN,SAAS;AACX;AACA,MAAM,iBAA+B;CACnC,MAAM;CACN,SAAS;AACX;;;;;;;;;;AAWA,SAAgB,qBACd,IACA,KACA,WACA,QACA,aACqB;CACrB,OAAO,iCAAiC,IAAI,KAAK,WAAW,QAAQ,WAAW,CAAC,CAAC;AACnF;;;;;;;;AASA,SAAgB,iCACd,IACA,KACA,WACA,QACA,aACA,eACuD;CACvD,IAAI,YAAY,WAAW,GAAG,MAAM,IAAI,MAAM,4BAA4B;CAC1E,MAAM,MAAM,YAAY,GAAG,gBAAgB,iBAAiB,IAAI,GAAG,aAAa,cAAc;CAE9F,MAAM,WAAW,MAAM,KAAK,UAAU;CACtC,MAAM,cAAc,MAAM,KAAK,QAAQ;CAEvC,GAAG,YAAY,UAAU,SAAS,GAAG;CACrC,GAAG,YAAY,aAAa,SAAS,GAAG,YAAY,IAAI,QAAQ,SAAS,CAAC;CAC1E,IAAI,kBAAkB,KAAA,GACpB,GAAG,YAAY,MAAM,KAAK,eAAe,GAAG,WAAW,aAAa;CACtE,GAAG,WAAW,GAAG;CAEjB,OAAO;EAAE,QAAQ;EAAK,SAAS,GAAG,aAAa,IAAI,KAAK,aAAa,UAAU,UAAU;CAAE;AAC7F"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@milaboratories/pl-middle-layer",
-  "version": "1.75.0",
+  "version": "1.76.1",
   "description": "Pl Middle Layer",
   "keywords": [],
   "license": "UNLICENSED",
@@ -25,19 +25,19 @@
     "@milaboratories/pf-driver": "1.9.13",
     "@milaboratories/pf-spec-driver": "1.5.13",
     "@milaboratories/pframes-rs-node": "1.2.0",
-    "@milaboratories/pl-client": "3.19.4",
+    "@milaboratories/pl-client": "3.20.0",
     "@milaboratories/pl-crash-recorder": "0.3.9",
     "@milaboratories/pl-deployments": "3.0.25",
-    "@milaboratories/pl-drivers": "1.16.39",
-    "@milaboratories/pl-errors": "1.4.56",
+    "@milaboratories/pl-drivers": "1.16.40",
+    "@milaboratories/pl-errors": "1.4.57",
     "@milaboratories/pl-http": "1.2.5",
-    "@milaboratories/pl-model-backend": "1.4.41",
+    "@milaboratories/pl-model-backend": "1.4.42",
     "@milaboratories/pl-model-common": "1.55.0",
     "@milaboratories/pl-model-middle-layer": "1.35.0",
-    "@milaboratories/pl-tree": "1.16.8",
+    "@milaboratories/pl-tree": "1.16.9",
     "@milaboratories/resolve-helper": "1.1.3",
     "@milaboratories/ts-helpers": "1.9.0",
-    "@platforma-sdk/block-tools": "2.17.3",
+    "@platforma-sdk/block-tools": "2.17.5",
     "@platforma-sdk/model": "1.88.0",
     "@platforma-sdk/workflow-tengo": "6.20.0",
     "canonicalize": "~2.1.0",

package/src/middle_layer/block_action_context.test.ts

@@ -0,0 +1,148 @@
+import type { SignedResourceId } from "@milaboratories/pl-client";
+import { createSignedResourceId, parseSignedResourceId } from "@milaboratories/pl-client";
+import { describe, expect, test } from "vitest";
+import { projectFieldName } from "../model/project_model";
+import type { ActionContextReader, ActionContextReadTx } from "./block_action_context";
+import { readBlockActionContextTree } from "./block_action_context";
+
+type FakeResource = {
+  data?: Record<string, string>;
+  fields: { name: string; value: SignedResourceId }[];
+  kvs: { key: string; value: string }[];
+};
+
+function signedId(globalId: number): SignedResourceId {
+  return createSignedResourceId(BigInt(globalId));
+}
+
+/** A client whose read transaction serves the given resources by global ID. */
+function fakeClient(resources: Map<string, FakeResource>): ActionContextReader {
+  const lookup = (ref: SignedResourceId) => {
+    const resource = resources.get(String(parseSignedResourceId(ref).globalId));
+    if (resource === undefined) throw new Error(`no resource ${ref}`);
+    return resource;
+  };
+  const tx: ActionContextReadTx = {
+    getResourceData: async (ref: SignedResourceId) => {
+      const resource = lookup(ref);
+      return {
+        data: resource.data === undefined ? undefined : Buffer.from(JSON.stringify(resource.data)),
+        fields: resource.fields,
+      };
+    },
+    listKeyValuesString: async (ref: SignedResourceId) => lookup(ref).kvs,
+  };
+
+  return {
+    withReadTx: async <T>(_name: string, body: (tx: ActionContextReadTx) => Promise<T>) =>
+      await body(tx),
+  };
+}
+
+const project = signedId(1);
+const prodRoot = signedId(10);
+const stagingRoot = signedId(11);
+const child = signedId(20);
+const grandchild = signedId(30);
+
+function resources(): Map<string, FakeResource> {
+  return new Map<string, FakeResource>([
+    [
+      "1",
+      {
+        fields: [
+          { name: projectFieldName("block1", "prodActionContext"), value: prodRoot },
+          { name: projectFieldName("block1", "stagingActionContext"), value: stagingRoot },
+        ],
+        kvs: [],
+      },
+    ],
+    [
+      "10",
+      {
+        data: { name: "prod render" },
+        fields: [
+          { name: "child/32", value: child },
+          { name: "other", value: signedId(99) },
+        ],
+        kvs: [
+          // timestamps of different lengths: string order differs from time order
+          { key: "transition/render/16/1000", value: '{"state":"Running"}' },
+          { key: "transition/render/16/999", value: '{"state":"WaitingForInputs"}' },
+          { key: "reading/exec/16/progress", value: "40" },
+          { key: "reading/exec/16/stage", value: "align" },
+          { key: "unrelated", value: "x" },
+        ],
+      },
+    ],
+    ["11", { data: { name: "staging render" }, fields: [], kvs: [] }],
+    [
+      "20",
+      {
+        data: { name: "child render" },
+        fields: [{ name: "child/48", value: grandchild }],
+        kvs: [{ key: "transition/render/32/5", value: '{"state":"Completed","detail":"ok"}' }],
+      },
+    ],
+    ["30", { data: { name: "grandchild render" }, fields: [], kvs: [] }],
+  ]);
+}
+
+describe("readBlockActionContextTree", () => {
+  test("reads the prod tree with children, ordered transitions and readings", async () => {
+    const tree = (await readBlockActionContextTree(
+      fakeClient(resources()),
+      project,
+      "block1",
+      "prod",
+    ))!;
+
+    expect(tree.contextId).toEqual("10");
+    expect(tree.resource).toEqual("16");
+    expect(tree.baggage).toEqual({ name: "prod render" });
+    expect(tree.transitions.map((t) => [t.timestampNs, t.state])).toEqual([
+      ["999", "WaitingForInputs"],
+      ["1000", "Running"],
+    ]);
+    expect(tree.readings).toEqual([
+      { namespace: "exec", resource: "16", key: "progress", value: "40" },
+      { namespace: "exec", resource: "16", key: "stage", value: "align" },
+    ]);
+
+    expect(tree.children.map((c) => c.baggage["name"])).toEqual(["child render"]);
+    const childNode = tree.children[0];
+    expect(childNode.transitions).toEqual([
+      {
+        namespace: "render",
+        resource: "32",
+        timestampNs: "5",
+        state: "Completed",
+        detail: "ok",
+        reason: "",
+      },
+    ]);
+    expect(childNode.resource).toEqual("32");
+    expect(childNode.children.map((c) => c.contextId)).toEqual(["30"]);
+    expect(childNode.children[0].resource).toBeUndefined();
+    expect(childNode.children[0].children).toEqual([]);
+  });
+
+  test("reads the staging tree for staging mode", async () => {
+    const tree = (await readBlockActionContextTree(
+      fakeClient(resources()),
+      project,
+      "block1",
+      "staging",
+    ))!;
+
+    expect(tree.contextId).toEqual("11");
+    expect(tree.baggage).toEqual({ name: "staging render" });
+    expect(tree.children).toEqual([]);
+  });
+
+  test("returns undefined for a block without an action context field", async () => {
+    expect(
+      await readBlockActionContextTree(fakeClient(resources()), project, "block2", "prod"),
+    ).toBeUndefined();
+  });
+});

package/src/middle_layer/block_action_context.ts

@@ -0,0 +1,162 @@
+import type {
+  KeyValueString,
+  OptionalSignedResourceId,
+  SignedResourceId,
+} from "@milaboratories/pl-client";
+import { isNullSignedResourceId, parseSignedResourceId } from "@milaboratories/pl-client";
+import { projectFieldName } from "../model/project_model";
+
+/** 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[];
+};
+
+const childFieldPrefix = "child/";
+
+/**
+ * Reads the action context tree of a block render: the root action context the project holds in
+ * <blockId>-prodActionContext or <blockId>-stagingActionContext, and every child context under it.
+ * Reads the current state in one transaction; it does not watch for changes.
+ *
+ * @returns undefined when the block has no action context: it was not rendered yet, or the backend
+ *          does not support block action context.
+ */
+/**
+ * The part of a read transaction the reader uses: a {@link PlTransaction} satisfies it, and a test
+ * can serve it without a backend.
+ */
+export interface ActionContextReadTx {
+  getResourceData(
+    rId: SignedResourceId,
+    loadFields: true,
+  ): Promise<{
+    readonly data?: Uint8Array;
+    readonly fields: readonly { readonly name: string; readonly value: OptionalSignedResourceId }[];
+  }>;
+  listKeyValuesString(rId: SignedResourceId): Promise<KeyValueString[]>;
+}
+
+/** The part of a client the reader uses: a {@link PlClient} satisfies it. */
+export interface ActionContextReader {
+  withReadTx<T>(name: string, body: (tx: ActionContextReadTx) => Promise<T>): Promise<T>;
+}
+
+export async function readBlockActionContextTree(
+  pl: ActionContextReader,
+  projectRid: SignedResourceId,
+  blockId: string,
+  mode: BlockActionContextMode,
+): Promise<BlockActionContextNode | undefined> {
+  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 === undefined || isNullSignedResourceId(actionContextField.value))
+      return undefined;
+
+    return await readActionContextNode(tx, actionContextField.value);
+  });
+}
+
+async function readActionContextNode(
+  tx: ActionContextReadTx,
+  contextRef: SignedResourceId,
+): Promise<BlockActionContextNode> {
+  const [context, kvs] = await Promise.all([
+    tx.getResourceData(contextRef, true),
+    tx.listKeyValuesString(contextRef),
+  ]);
+
+  const baggage =
+    context.data === undefined || context.data.length === 0
+      ? {}
+      : (JSON.parse(Buffer.from(context.data).toString()) as Record<string, string>);
+
+  const transitions: BlockActionTransition[] = [];
+  const readings: BlockActionReading[] = [];
+  for (const { key, value } of kvs) {
+    const parts = key.split("/");
+    if (parts[0] === "transition" && parts.length === 4) {
+      const parsed = JSON.parse(value) as { state?: string; detail?: string; reason?: string };
+      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: SignedResourceId[] = [];
+  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: string, b: string): number {
+  return a.length !== b.length ? a.length - b.length : a < b ? -1 : a > b ? 1 : 0;
+}

package/src/middle_layer/index.ts

@@ -15,3 +15,9 @@ export type {
   TemplateId,
   TemplateListEntry,
 } from "./template_list";
+export type {
+  BlockActionReading,
+  BlockActionContextMode,
+  BlockActionContextNode,
+  BlockActionTransition,
+} from "./block_action_context";