@blue-labs/document-processor 3.2.0 → 3.3.0

package/dist/index.js

@@ -1,8 +1,8 @@
 import { evaluate as wt } from "@blue-quickjs/quickjs-runtime";
 import { validateDv as kt, DV_LIMIT_DEFAULTS as bt } from "@blue-quickjs/dv";
-import { HOST_V1_MANIFEST as It, HOST_V1_HASH as Tt } from "@blue-quickjs/abi-manifest";
-import { BlueNode as p, withTypeBlueId as g, blueNodeField as b, Properties as Ie, BlueIdCalculator as Rt, Blue as Pt, MergingProcessors as L } from "@blue-labs/language";
-import Te from "picomatch";
+import { HOST_V1_MANIFEST as Tt, HOST_V1_HASH as It } from "@blue-quickjs/abi-manifest";
+import { BlueNode as p, withTypeBlueId as g, blueNodeField as b, Properties as Te, BlueIdCalculator as Pt, Blue as Rt, MergingProcessors as L } from "@blue-labs/language";
+import Ie from "picomatch";
 import { z as l, ZodError as ge } from "zod";
 import { isNullable as he } from "@blue-labs/shared-utils";
 import { repository as Mt } from "@blue-repository/types";
@@ -36,7 +36,7 @@ function eo(i, e) {
 function to(i, e) {
   return i.ok ? e.ok(i.value) : e.err(i.error);
 }
-const v = {
+const S = {
   capabilityFailure(i, e, t) {
     return { kind: "CapabilityFailure", capability: i, reason: e, details: t };
   },
@@ -78,7 +78,7 @@ const Dt = {
       failureReason: e ?? null
     };
   }
-}, Ke = Dt, f = {
+}, Ke = Dt, m = {
   "Core/Channel": "DcoJyCh7XXxy1nR5xjy7qfkUgQ1GiZnKKSxh8DJusBSr",
   "Core/Channel Event Checkpoint": "B7YQeYdQzUNuzaDQ4tNTd2iJqgd4YnVQkgz4QgymDWWU",
   "Core/Contract": "AERp8BWnuUsjoPciAeNXuUWS9fmqPNMdWbxmKn3tcitx",
@@ -101,10 +101,10 @@ const Dt = {
   "terminated",
   "checkpoint"
 ], xt = [
-  f["Core/Document Update Channel"],
-  f["Core/Triggered Event Channel"],
-  f["Core/Lifecycle Event Channel"],
-  f["Core/Embedded Node Channel"]
+  m["Core/Document Update Channel"],
+  m["Core/Triggered Event Channel"],
+  m["Core/Lifecycle Event Channel"],
+  m["Core/Embedded Node Channel"]
 ], We = "embedded", Ge = "initialized", qe = "terminated", A = "checkpoint", Ee = new Set(
   Bt
 ), je = new Set(xt);
@@ -126,14 +126,14 @@ const no = {
   isReservedContractKey: _t,
   isProcessorManagedChannelBlueId: ye
 }, H = "/contracts", de = `${H}/${Ge}`, Je = `${H}/${qe}`, Lt = `${H}/${We}`, Qe = `${H}/${A}`, Xe = "/lastEvents", Ye = "/lastSignatures";
-function ne(i) {
+function re(i) {
   return `${H}/${i}`;
 }
 function Ze(i, e) {
-  return `${ne(i)}${Xe}/${e}`;
+  return `${re(i)}${Xe}/${e}`;
 }
 function et(i, e) {
-  return `${ne(i)}${Ye}/${e}`;
+  return `${re(i)}${Ye}/${e}`;
 }
 const ro = {
   RELATIVE_CONTRACTS: H,
@@ -143,7 +143,7 @@ const ro = {
   RELATIVE_CHECKPOINT: Qe,
   LAST_EVENTS_SUFFIX: Xe,
   LAST_SIGNATURES_SUFFIX: Ye,
-  relativeContractsEntry: ne,
+  relativeContractsEntry: re,
   relativeCheckpointLastEvent: Ze,
   relativeCheckpointLastSignature: et
 };
@@ -153,10 +153,10 @@ function tt(i) {
 function k(i) {
   return tt(i) ? "/" : i.startsWith("/") ? i : `/${i}`;
 }
-function R(i) {
+function P(i) {
   return tt(i) ? "/" : i.startsWith("/") ? i : `/${i}`;
 }
-function Re(i) {
+function Pe(i) {
   if (i == null)
     return "";
   let e = i.trim();
@@ -169,15 +169,15 @@ function Re(i) {
   return e;
 }
 function io(i, e) {
-  const t = Re(i), n = Re(e);
+  const t = Pe(i), n = Pe(e);
   return t.length === 0 && n.length === 0 ? "/" : t.length === 0 ? `/${n}` : n.length === 0 ? `/${t}` : `/${t}/${n}`;
 }
-function T(i, e) {
-  const t = k(i), n = R(e);
+function I(i, e) {
+  const t = k(i), n = P(e);
   return t === "/" ? n : n === "/" || n.length === 1 ? t : `${t}${n}`;
 }
 function Ft(i, e) {
-  const t = k(i), n = R(e);
+  const t = k(i), n = P(e);
   if (t === "/" || !n.startsWith(t))
     return n;
   if (n.length === t.length)
@@ -188,9 +188,9 @@ function Ft(i, e) {
 function Ut(i) {
   return i && i.__esModule && Object.prototype.hasOwnProperty.call(i, "default") ? i.default : i;
 }
-var se, Pe;
+var ae, Re;
 function $t() {
-  return Pe || (Pe = 1, se = function i(e) {
+  return Re || (Re = 1, ae = function i(e) {
     if (typeof e == "number" && isNaN(e))
       throw new Error("NaN is not allowed");
     if (typeof e == "number" && !isFinite(e))
@@ -201,7 +201,7 @@ function $t() {
       const o = n.length === 0 ? "" : ",";
       return `${n}${o}${i(r)}:${i(e[r])}`;
     }, "")}}`;
-  }), se;
+  }), ae;
 }
 var zt = $t();
 const Vt = /* @__PURE__ */ Ut(zt);
@@ -249,7 +249,9 @@ const it = rt(
   "eventCanonical",
   "steps",
   "document",
-  "emit"
+  "emit",
+  "currentContract",
+  "currentContractCanonical"
 ]);
 class Ce {
   // Serialize evaluations to avoid races when updating host handler bindings.
@@ -285,14 +287,14 @@ class Ce {
       code: this.wrapCode(e),
       abiId: "Host.v1",
       abiVersion: 1,
-      abiManifestHash: Tt
+      abiManifestHash: It
     };
     try {
       const c = await wt({
         program: a,
         input: o,
         gasLimit: s,
-        manifest: It,
+        manifest: Tt,
         handlers: this.handlers
       });
       if (n !== void 0 && r && r({
@@ -300,7 +302,7 @@ class Ce {
         remaining: c.gasRemaining
       }), !c.ok)
         throw en(c);
-      return X(c.value);
+      return Y(c.value);
     } catch (c) {
       throw tn(c);
     }
@@ -308,20 +310,30 @@ class Ce {
   prepareBindings(e) {
     const t = e ?? {};
     Yt(t);
-    const n = ae(t.event, null, "event"), r = ae(
+    const n = W(t.event, null, "event"), r = W(
       t.eventCanonical ?? n,
       n,
       "eventCanonical"
-    ), o = ae(t.steps, [], "steps"), s = {
+    ), o = W(t.steps, [], "steps"), s = W(
+      t.currentContract,
+      null,
+      "currentContract"
+    ), a = W(
+      t.currentContractCanonical,
+      s,
+      "currentContractCanonical"
+    ), c = {
       event: n,
       eventCanonical: r,
-      steps: o
-    }, a = this.extractDocumentBinding(t), c = typeof a?.canonical == "function" ? a.canonical : void 0;
-    this.handlerState.documentGet = Ne(a), this.handlerState.documentGetCanonical = Ne(
-      c ?? a
+      steps: o,
+      currentContract: s,
+      currentContractCanonical: a
+    }, u = this.extractDocumentBinding(t), h = typeof u?.canonical == "function" ? u.canonical : void 0;
+    this.handlerState.documentGet = Ne(u), this.handlerState.documentGetCanonical = Ne(
+      h ?? u
     );
-    const u = this.extractEmitBinding(t);
-    return this.handlerState.emit = Zt(u), s;
+    const d = this.extractEmitBinding(t);
+    return this.handlerState.emit = Zt(d), c;
   }
   extractDocumentBinding(e) {
     if (!Object.prototype.hasOwnProperty.call(e, "document"))
@@ -356,7 +368,7 @@ function Yt(i) {
     if (!Xt.has(e))
       throw new TypeError(`Unsupported QuickJS binding: "${e}"`);
 }
-function ae(i, e, t) {
+function W(i, e, t) {
   const n = i === void 0 ? e : i;
   try {
     kt(n, { limits: bt });
@@ -387,7 +399,7 @@ function Ne(i) {
 function Zt(i) {
   return i ? (e) => {
     try {
-      if (i(X(e)) instanceof Promise)
+      if (i(Y(e)) instanceof Promise)
         throw new Error("Async emit handlers are not supported");
       return { ok: null, units: O };
     } catch {
@@ -398,18 +410,18 @@ function Zt(i) {
     }
   } : () => ({ ok: null, units: O });
 }
-function X(i) {
+function Y(i) {
   if (i == null)
     return i;
   if (Array.isArray(i))
-    return i.map((e) => X(e));
+    return i.map((e) => Y(e));
   if (typeof i == "object") {
     const e = Object.getPrototypeOf(i);
     if (e !== Object.prototype && e !== null)
       return i;
     const t = {};
     for (const [n, r] of Object.entries(i))
-      t[n] = X(r);
+      t[n] = Y(r);
     return t;
   }
   return i;
@@ -444,7 +456,7 @@ class ot extends Error {
   }
 }
 const st = /^\$\{([\s\S]*)\}$/, rn = /\$\{([\s\S]+?)\}/, on = /\$\{([\s\S]+?)\}/g;
-function Y(i) {
+function Z(i) {
   if (typeof i != "string" || !st.test(i))
     return !1;
   const e = i.indexOf("${"), t = i.lastIndexOf("${");
@@ -454,7 +466,7 @@ function sn(i) {
   return typeof i != "string" ? !1 : st.test(i) ? !0 : rn.test(i);
 }
 function an(i) {
-  if (!Y(i))
+  if (!Z(i))
     throw new Error(`Invalid expression: ${i}`);
   return i.slice(2, -1);
 }
@@ -493,13 +505,13 @@ function ct({
   options: t
 }) {
   const n = { dot: !0, ...t ?? {} }, r = i.map(
-    (s) => Te(s, n)
+    (s) => Ie(s, n)
   ), o = e.map(
-    (s) => Te(s, n)
+    (s) => Ie(s, n)
   );
   return (s) => r.some((a) => a(s)) && !o.some((a) => a(s));
 }
-async function Z(i) {
+async function ee(i) {
   const {
     evaluator: e,
     node: t,
@@ -518,7 +530,7 @@ async function Z(i) {
   const d = h.getValue();
   if (d !== void 0) {
     if (typeof d == "string" && r(a)) {
-      if (Y(d)) {
+      if (Z(d)) {
         const E = an(d), C = await at(
           e,
           E,
@@ -540,27 +552,27 @@ async function Z(i) {
     }
     return h;
   }
-  const S = h.getItems?.();
-  if (Array.isArray(S)) {
+  const v = h.getItems?.();
+  if (Array.isArray(v)) {
     const E = await Promise.all(
-      S.map(
-        (C, P) => Z({
+      v.map(
+        (C, R) => ee({
           ...i,
           node: C,
-          pointer: `${a}/${P}`
+          pointer: `${a}/${R}`
         })
       )
     );
     return h.setItems(E), h;
   }
-  const m = h.getProperties?.();
-  if (m) {
+  const f = h.getProperties?.();
+  if (f) {
     const E = {};
-    for (const [C, P] of Object.entries(m)) {
+    for (const [C, R] of Object.entries(f)) {
       const D = a === "/" ? `/${C}` : `${a}/${C}`;
-      E[C] = await Z({
+      E[C] = await ee({
         ...i,
-        node: P,
+        node: R,
         pointer: D
       });
     }
@@ -568,11 +580,11 @@ async function Z(i) {
   }
   return h;
 }
-const re = g(f["Core/Contract"])(l.object({
+const ie = g(m["Core/Contract"])(l.object({
   description: l.string().optional(),
   name: l.string().optional(),
   order: l.number().optional()
-})), Se = re, x = g(f["Core/Channel"])(re.extend({
+})), Se = ie, x = g(m["Core/Channel"])(ie.extend({
   description: l.string().optional(),
   event: b().optional(),
   name: l.string().optional()
@@ -581,12 +593,12 @@ const re = g(f["Core/Contract"])(l.object({
 ).extend({
   path: l.string().optional(),
   definition: b().optional()
-}), lt = g(f["Core/Handler"])(re.extend({
+}), lt = g(m["Core/Handler"])(ie.extend({
   channel: l.string().optional(),
   description: l.string().optional(),
   event: b().optional(),
   name: l.string().optional()
-})), ut = lt.merge(Se), K = g(f["Core/Marker"])(re.extend({
+})), ut = lt.merge(Se), K = g(m["Core/Marker"])(ie.extend({
   description: l.string().optional(),
   name: l.string().optional()
 })), N = K.merge(Se), ln = l.object({
@@ -605,24 +617,24 @@ const re = g(f["Core/Contract"])(l.object({
     message: `${i.op} operations must include a value`,
     path: ["val"]
   });
-}), un = g(f["Core/Document Update Channel"])(x.extend({
+}), un = g(m["Core/Document Update Channel"])(x.extend({
   description: l.string().optional(),
   name: l.string().optional(),
   path: l.string().optional()
 })), hn = un.merge(
   _
-), dn = g(f["Core/Embedded Node Channel"])(x.extend({
+), dn = g(m["Core/Embedded Node Channel"])(x.extend({
   childPath: l.string().optional(),
   description: l.string().optional(),
   name: l.string().optional()
 })), pn = dn.merge(
   _
-), mn = g(f["Core/Lifecycle Event Channel"])(x.extend({
+), fn = g(m["Core/Lifecycle Event Channel"])(x.extend({
   description: l.string().optional(),
   name: l.string().optional()
-})), fn = mn.merge(
+})), mn = fn.merge(
   _
-), gn = g(f["Core/Triggered Event Channel"])(x.extend({
+), gn = g(m["Core/Triggered Event Channel"])(x.extend({
   description: l.string().optional(),
   name: l.string().optional()
 })), En = gn.merge(_), w = {
@@ -645,7 +657,7 @@ const re = g(f["Core/Contract"])(l.object({
   timelineId: l.string().optional()
 })), yn = ht.merge(
   _
-), I = {
+), T = {
   "MyOS/Document Anchor": "HS9yo34TGEAM2LGcNbLh7XPN4goPRhqdGZQkiyh473Wb",
   "MyOS/Document Anchors": "7Usvk6dZMVqas3yqs23ZEXn1zu1YDPjgYiZFNYaw3puH",
   "MyOS/Document Links": "4cmrbevB6K23ZenjqwmNxpnaw6RF4VB3wkP7XB59V7W5",
@@ -656,7 +668,7 @@ const re = g(f["Core/Contract"])(l.object({
   "MyOS/MyOS Timeline Channel": "HCF8mXnX3dFjQ8osjxb4Wzm2Nm1DoXnTYuA5sPnV7NTs",
   "MyOS/MyOS Timeline Entry": "Furgmg5xcJVMDmaQXZRfZ1XehSf7PWctrioo8etRYJHQ",
   "MyOS/MyOS Worker Agency": "4Lix4AKXvBDvrwxw2htSdYFKxL4wugEQzqoSEYet5Dh1"
-}, Cn = g(I["MyOS/MyOS Timeline Channel"])(ht.extend({
+}, Cn = g(T["MyOS/MyOS Timeline Channel"])(ht.extend({
   accountId: l.string().optional(),
   description: l.string().optional(),
   email: l.string().optional(),
@@ -665,59 +677,59 @@ const re = g(f["Core/Contract"])(l.object({
   channels: l.array(l.string()).optional(),
   description: l.string().optional(),
   name: l.string().optional()
-})), dt = vn.merge(_), wn = g(f["Core/Channel Event Checkpoint"])(K.extend({
+})), dt = vn.merge(_), wn = g(m["Core/Channel Event Checkpoint"])(K.extend({
   description: l.string().optional(),
   lastEvents: l.record(l.string(), b()).optional(),
   name: l.string().optional()
 })), kn = wn.merge(N).extend({
   lastSignatures: l.record(l.string()).optional()
-}), bn = g(f["Core/Processing Initialized Marker"])(K.extend({
+}), bn = g(m["Core/Processing Initialized Marker"])(K.extend({
   description: l.string().optional(),
   documentId: l.string().optional(),
   name: l.string().optional()
-})), In = bn.merge(N), Tn = g(f["Core/Process Embedded"])(K.extend({
+})), Tn = bn.merge(N), In = g(m["Core/Process Embedded"])(K.extend({
   description: l.string().optional(),
   name: l.string().optional(),
   paths: l.array(l.string()).optional()
-})), Rn = Tn.merge(
+})), Pn = In.merge(
   N
-), Pn = g(f["Core/Processing Terminated Marker"])(K.extend({
+), Rn = g(m["Core/Processing Terminated Marker"])(K.extend({
   cause: l.string().optional(),
   description: l.string().optional(),
   name: l.string().optional(),
   reason: l.string().optional()
-})), Mn = Pn.merge(N), j = g(w["Conversation/Operation"])(K.extend({
+})), Mn = Rn.merge(N), J = g(w["Conversation/Operation"])(K.extend({
   channel: l.string().optional(),
   description: l.string().optional(),
   name: l.string().optional(),
   request: b().optional()
-})), Nn = j.merge(
+})), Nn = J.merge(
   N
-), On = g(I["MyOS/Document Anchor"])(l.object({
+), On = g(T["MyOS/Document Anchor"])(l.object({
   description: l.string().optional(),
   name: l.string().optional(),
   template: b().optional()
-})), An = g(I["MyOS/Document Anchors"])(l.object({}).catchall(On)), Dn = An.merge(N), Bn = g(I["MyOS/Link"])(l.object({
+})), An = g(T["MyOS/Document Anchors"])(l.object({}).catchall(On)), Dn = An.merge(N), Bn = g(T["MyOS/Link"])(l.object({
   anchor: l.string().optional(),
   description: l.string().optional(),
   name: l.string().optional()
-})), xn = g(I["MyOS/Document Links"])(l.object({}).catchall(Bn)), _n = xn.merge(
+})), xn = g(T["MyOS/Document Links"])(l.object({}).catchall(Bn)), _n = xn.merge(
   N
-), Ln = g(I["MyOS/MyOS Participants Orchestration"])(l.object({
+), Ln = g(T["MyOS/MyOS Participants Orchestration"])(l.object({
   name: l.string().optional()
-})), Fn = Ln.merge(N), Un = g(I["MyOS/MyOS Session Interaction"])(l.object({
+})), Fn = Ln.merge(N), Un = g(T["MyOS/MyOS Session Interaction"])(l.object({
   name: l.string().optional()
-})), $n = Un.merge(N), zn = g(I["MyOS/MyOS Worker Agency"])(l.object({
+})), $n = Un.merge(N), zn = g(T["MyOS/MyOS Worker Agency"])(l.object({
   name: l.string().optional()
 })), Vn = zn.merge(
   N
-), ie = g(w["Conversation/Sequential Workflow Step"])(l.object({
+), oe = g(w["Conversation/Sequential Workflow Step"])(l.object({
   description: l.string().optional(),
   name: l.string().optional()
 })), pt = g(w["Conversation/Sequential Workflow"])(lt.extend({
   description: l.string().optional(),
   name: l.string().optional(),
-  steps: l.array(ie).optional()
+  steps: l.array(oe).optional()
 })), so = b(), Hn = pt.merge(ut).extend({
   steps: l.array(b()).optional()
 }), Kn = g(w["Conversation/Sequential Workflow Operation"])(pt.extend({
@@ -736,7 +748,7 @@ function Gn(i) {
     if (typeof e != "string" || e.trim().length === 0)
       throw new Error("Contract processor BlueIds must be non-empty strings");
 }
-function J(i, e) {
+function Q(i, e) {
   Gn(i);
   for (const t of i.blueIds)
     e.set(t, i);
@@ -747,13 +759,13 @@ class qn {
   channelProcessors = /* @__PURE__ */ new Map();
   markerProcessors = /* @__PURE__ */ new Map();
   registerHandler(e) {
-    J(e, this.handlerProcessors), this.registerProcessorMap(e);
+    Q(e, this.handlerProcessors), this.registerProcessorMap(e);
   }
   registerChannel(e) {
-    J(e, this.channelProcessors), this.registerProcessorMap(e);
+    Q(e, this.channelProcessors), this.registerProcessorMap(e);
   }
   registerMarker(e) {
-    J(e, this.markerProcessors), this.registerProcessorMap(e);
+    Q(e, this.markerProcessors), this.registerProcessorMap(e);
   }
   register(e) {
     switch (e.kind) {
@@ -787,7 +799,7 @@ class qn {
     return new Map(this.processorsByBlueId);
   }
   registerProcessorMap(e) {
-    J(e, this.processorsByBlueId);
+    Q(e, this.processorsByBlueId);
   }
 }
 const jn = "compositeSourceChannelKey";
@@ -837,14 +849,14 @@ class Xn {
         throw new Error(
           `No processor registered for child channel '${u}' (${h.blueId})`
         );
-      const S = n.clone(), m = {
+      const v = n.clone(), f = {
         ...t,
-        event: S,
+        event: v,
         bindingKey: u
       }, E = h.contract, C = E.event;
-      if (C && !t.blue.isTypeOfNode(S, C) || !await d.matches(E, m))
+      if (C && !t.blue.isTypeOfNode(v, C) || !await d.matches(E, f))
         continue;
-      const D = d.channelize, ke = (D ? D.call(d, E, m) : void 0) ?? S.clone();
+      const D = d.channelize, ke = (D ? D.call(d, E, f) : void 0) ?? v.clone();
       this.enrichEvent(ke, u);
       const be = Jn(
         t.bindingKey,
@@ -853,7 +865,7 @@ class Xn {
         childProcessor: d,
         childContract: E,
         context: {
-          ...m,
+          ...f,
           event: n.clone()
         },
         checkpointKey: be,
@@ -914,7 +926,7 @@ class Xn {
 const Yn = g(w["Conversation/Actor"])(l.object({
   description: l.string().optional(),
   name: l.string().optional()
-})), mt = g(w["Conversation/Timeline"])(l.object({
+})), ft = g(w["Conversation/Timeline"])(l.object({
   description: l.string().optional(),
   name: l.string().optional(),
   timelineId: l.string().optional()
@@ -924,13 +936,13 @@ const Yn = g(w["Conversation/Actor"])(l.object({
   message: b().optional(),
   name: l.string().optional(),
   prevEntry: b().optional(),
-  timeline: mt.optional(),
+  timeline: ft.optional(),
   timestamp: l.number().optional()
-})), Zn = g(I["MyOS/MyOS Timeline"])(mt.extend({
+})), Zn = g(T["MyOS/MyOS Timeline"])(ft.extend({
   accountId: l.string().optional(),
   description: l.string().optional(),
   name: l.string().optional()
-})), Ae = g(I["MyOS/MyOS Timeline Entry"])(M.extend({
+})), Ae = g(T["MyOS/MyOS Timeline Entry"])(M.extend({
   description: l.string().optional(),
   name: l.string().optional(),
   timeline: Zn.optional()
@@ -938,7 +950,7 @@ const Yn = g(w["Conversation/Actor"])(l.object({
 function De(i, e) {
   return e && i.isTypeOf(e, M, { checkSchemaExtensions: !0 }) ? i.nodeToSchemaOutput(e, M) : null;
 }
-function ft(i, e, t) {
+function mt(i, e, t) {
   const n = De(i, e), r = De(i, t);
   if (!n || !r)
     return !0;
@@ -950,7 +962,7 @@ function Be(i, e) {
 }
 class er {
   kind = "channel";
-  blueIds = [I["MyOS/MyOS Timeline Channel"]];
+  blueIds = [T["MyOS/MyOS Timeline Channel"]];
   schema = Sn;
   matches(e, t) {
     const { event: n, blue: r } = t;
@@ -968,7 +980,7 @@ class er {
   }
   isNewerEvent(e, t, n) {
     const { event: r, blue: o } = t;
-    return r ? ft(o, r, n) : !0;
+    return r ? mt(o, r, n) : !0;
   }
 }
 class tr {
@@ -988,21 +1000,23 @@ class tr {
   }
   isNewerEvent(e, t, n) {
     const { event: r, blue: o } = t;
-    return r ? ft(o, r, n) : !0;
+    return r ? mt(o, r, n) : !0;
   }
 }
-const xe = g(w["Conversation/Trigger Event"])(ie.extend({
+const xe = g(w["Conversation/Trigger Event"])(oe.extend({
   description: l.string().optional(),
   event: b().optional(),
   name: l.string().optional()
 }));
 function ve(i) {
-  const { context: e, eventNode: t, stepResults: n } = i, r = rr(e);
+  const { context: e, eventNode: t, stepResults: n, contractNode: r } = i, o = rr(e), s = r != null ? e.blue.nodeToJson(r, "simple") : null, a = r != null ? e.blue.nodeToJson(r, "official") : s;
   return {
     event: e.blue.nodeToJson(t, "simple"),
     eventCanonical: e.blue.nodeToJson(t, "official"),
     steps: n,
-    document: r
+    document: o,
+    currentContract: s,
+    currentContractCanonical: a
   };
 }
 const nr = /* @__PURE__ */ new Set(["blueId", "name", "description", "value"]);
@@ -1015,7 +1029,7 @@ function rr(i) {
   }, t = (o) => {
     const s = o == null ? "/" : typeof o == "string" ? o : (() => {
       throw new TypeError("document() expects a string pointer");
-    })(), a = s.startsWith("/") ? s : i.resolvePointer(s), c = R(a), u = i.documentAt(c);
+    })(), a = s.startsWith("/") ? s : i.resolvePointer(s), c = P(a), u = i.documentAt(c);
     return i.gasMeter().chargeDocumentSnapshot(c, u), { snapshot: u, normalizedPointer: c };
   }, n = (o, s) => {
     const { snapshot: a, normalizedPointer: c } = t(o);
@@ -1034,7 +1048,7 @@ class ir {
     if (!n.blue.isTypeOf(t, xe))
       return n.throwFatal("Trigger Event step payload is invalid");
     n.gasMeter().chargeTriggerEventBase();
-    const r = await Z({
+    const r = await ee({
       evaluator: this.evaluator,
       node: t,
       bindings: ve(e),
@@ -1061,7 +1075,7 @@ function sr(i) {
   const e = i.getProperties?.();
   return e ? !!e.contracts : !1;
 }
-const _e = g(w["Conversation/JavaScript Code"])(ie.extend({
+const _e = g(w["Conversation/JavaScript Code"])(oe.extend({
   code: l.string().optional(),
   description: l.string().optional(),
   name: l.string().optional()
@@ -1111,13 +1125,13 @@ class ar {
       }
   }
 }
-const cr = g(f["Core/Json Patch Entry"])(l.object({
+const cr = g(m["Core/Json Patch Entry"])(l.object({
   description: l.string().optional(),
   name: l.string().optional(),
   op: l.string().optional(),
   path: l.string().optional(),
   val: b().optional()
-})), Le = g(w["Conversation/Update Document"])(ie.extend({
+})), Le = g(w["Conversation/Update Document"])(oe.extend({
   changeset: l.array(cr).optional(),
   description: l.string().optional(),
   name: l.string().optional()
@@ -1131,7 +1145,7 @@ class lr {
     const { context: t, stepNode: n } = e, { blue: r } = t;
     if (!r.isTypeOf(n, Le))
       return t.throwFatal("Update Document step payload is invalid");
-    const o = await Z({
+    const o = await ee({
       evaluator: this.evaluator,
       node: n,
       bindings: ve(e),
@@ -1184,37 +1198,38 @@ class gt {
     this.executorIndex = t;
   }
   async run(e) {
-    const { workflow: t, eventNode: n, context: r } = e, o = t.steps ?? [];
-    if (o.length === 0)
+    const { workflow: t, eventNode: n, context: r, contractNode: o } = e, s = t.steps ?? [];
+    if (s.length === 0)
       return {};
-    const s = {};
-    for (const [a, c] of o.entries()) {
-      const u = c.getType?.()?.getBlueId();
-      if (he(u))
+    const a = {};
+    for (const [c, u] of s.entries()) {
+      const h = u.getType?.()?.getBlueId();
+      if (he(h))
         return r.throwFatal(
           "Sequential workflow step is missing type metadata"
         );
-      const h = this.executorIndex.get(u);
-      if (he(h)) {
-        const m = c.getType?.()?.getName?.() ?? u;
+      const d = this.executorIndex.get(h);
+      if (he(d)) {
+        const E = u.getType?.()?.getName?.() ?? h;
         return r.throwFatal(
-          `Unsupported workflow step type "${m}"`
+          `Unsupported workflow step type "${E}"`
         );
       }
-      const d = {
+      const v = {
         workflow: t,
-        stepNode: c,
+        stepNode: u,
         eventNode: n,
         context: r,
-        stepResults: s,
-        stepIndex: a
-      }, S = await h.execute(d);
-      if (S !== void 0) {
-        const m = this.stepResultKey(c, a);
-        s[m] = S;
+        stepResults: a,
+        stepIndex: c,
+        contractNode: o
+      }, f = await d.execute(v);
+      if (f !== void 0) {
+        const E = this.stepResultKey(u, c);
+        a[E] = f;
       }
     }
-    return s;
+    return a;
   }
   stepResultKey(e, t) {
     const n = e.getName?.();
@@ -1235,9 +1250,14 @@ class ur {
     const n = t.event();
     return !(!n || e.event && !t.blue.isTypeOfNode(n, e.event));
   }
-  async execute(e, t) {
-    const n = t.event();
-    n && await this.runner.run({ workflow: e, eventNode: n, context: t });
+  async execute(e, t, n) {
+    const r = t.event();
+    r && await this.runner.run({
+      workflow: e,
+      eventNode: r,
+      context: t,
+      contractNode: n?.contractNode ?? null
+    });
   }
 }
 class hr {
@@ -1245,7 +1265,7 @@ class hr {
   blueIds = [w["Conversation/Operation"]];
   schema = Nn;
 }
-const me = g(w["Conversation/Operation Request"])(l.object({
+const fe = g(w["Conversation/Operation Request"])(l.object({
   allowNewerVersion: l.boolean().optional(),
   description: l.string().optional(),
   document: b().optional(),
@@ -1267,7 +1287,7 @@ function dr(i, e) {
   return t instanceof p ? e.blue.calculateBlueIdSync(t) : null;
 }
 function pr(i, e) {
-  if (e.isTypeOf(i, me, {
+  if (e.isTypeOf(i, fe, {
     checkSchemaExtensions: !0
   }))
     return i;
@@ -1275,27 +1295,27 @@ function pr(i, e) {
     checkSchemaExtensions: !0
   })) {
     const n = e.nodeToSchemaOutput(i, M).message;
-    if (n && e.isTypeOf(n, me, {
+    if (n && e.isTypeOf(n, fe, {
       checkSchemaExtensions: !0
     }))
       return n;
   }
   return null;
 }
-function mr(i, e, t, n) {
+function fr(i, e, t, n) {
   const { blue: r } = n, o = i.operation;
   return !(!o || t.operation !== o || i.event && !r.isTypeOfNode(e, i.event));
 }
-function fr(i, e) {
+function mr(i, e) {
   const t = i.operation;
   if (!t)
     return null;
   const n = e.resolvePointer(`/contracts/${t}`), r = e.documentAt(n);
-  if (!r || !e.blue.isTypeOf(r, j))
+  if (!r || !e.blue.isTypeOf(r, J))
     return null;
   const o = e.blue.nodeToSchemaOutput(
     r,
-    j
+    J
   ), s = Et(o);
   return { operationNode: r, operation: o, channelKey: s };
 }
@@ -1341,11 +1361,11 @@ class Cr {
     if (!n)
       return null;
     const r = t.scopeContracts.get(n);
-    if (!r || !t.blue.isTypeOf(r.node, j, {
+    if (!r || !t.blue.isTypeOf(r.node, J, {
       checkSchemaExtensions: !0
     }))
       return null;
-    const o = t.blue.nodeToSchemaOutput(r.node, j);
+    const o = t.blue.nodeToSchemaOutput(r.node, J);
     return o ? Et(o) : null;
   }
   async matches(e, t) {
@@ -1360,11 +1380,11 @@ class Cr {
       return !1;
     const o = t.blue.nodeToSchemaOutput(
       r,
-      me
+      fe
     );
-    if (!o || !mr(e, n, o, t))
+    if (!o || !fr(e, n, o, t))
       return !1;
-    const s = fr(e, t);
+    const s = mr(e, t);
     if (!s)
       return !1;
     const a = typeof e.channel == "string" ? e.channel.trim() : "", c = a.length > 0 ? a : null;
@@ -1374,21 +1394,22 @@ class Cr {
       t.blue
     ) || o?.allowNewerVersion === !1 && !yr(o, r, t));
   }
-  async execute(e, t) {
-    const n = t.event();
-    n && await this.runner.run({
+  async execute(e, t, n) {
+    const r = t.event();
+    r && await this.runner.run({
       workflow: e,
-      eventNode: n,
-      context: t
+      eventNode: r,
+      context: t,
+      contractNode: n?.contractNode ?? null
     });
   }
 }
-class oe {
+class se {
   constructor(e) {
     this.registry = e;
   }
   static create() {
-    return new oe(
+    return new se(
       new qn()
     );
   }
@@ -1402,7 +1423,7 @@ class oe {
     return this.registry;
   }
 }
-const fe = f["Core/Channel Event Checkpoint"];
+const me = m["Core/Channel Event Checkpoint"];
 function yt(i) {
   return typeof i.order == "number" ? i.order : 0;
 }
@@ -1424,8 +1445,8 @@ class Sr {
   }
 }
 class vr {
-  constructor(e, t, n) {
-    this.bindingKey = e, this.bindingContract = t, this.bindingBlueId = n;
+  constructor(e, t, n, r) {
+    this.bindingKey = e, this.bindingContract = t, this.bindingBlueId = n, this.bindingNode = r;
   }
   key() {
     return this.bindingKey;
@@ -1436,6 +1457,9 @@ class vr {
   blueId() {
     return this.bindingBlueId;
   }
+  node() {
+    return this.bindingNode.clone();
+  }
   order() {
     return yt(this.bindingContract);
   }
@@ -1491,13 +1515,18 @@ class V {
     this.markerStore.set(A, {
       key: A,
       contract: e,
-      blueId: fe
+      blueId: me
     }), this.checkpointDeclared = !0;
   }
   handlersFor(e) {
     const t = this.handlersByChannel.get(e);
     return !t || t.length === 0 ? [] : [...t].map(
-      (n) => new vr(n.key, n.contract, n.blueId)
+      (n) => new vr(
+        n.key,
+        n.contract,
+        n.blueId,
+        n.node
+      )
     ).sort((n, r) => {
       const o = n.order() - r.order();
       return o !== 0 ? o : n.key().localeCompare(r.key());
@@ -1527,12 +1556,12 @@ class wr {
   addChannel(e, t, n) {
     return this.channels.set(e, { key: e, contract: t, blueId: n }), this;
   }
-  addHandler(e, t, n) {
-    const r = t.channel;
-    if (!r)
+  addHandler(e, t, n, r) {
+    const o = t.channel;
+    if (!o)
       throw new Error(`Handler ${e} must declare channel`);
-    const o = this.handlersByChannel.get(r) ?? [];
-    return o.push({ key: e, contract: t, blueId: n }), this.handlersByChannel.set(r, o), this;
+    const s = this.handlersByChannel.get(o) ?? [];
+    return s.push({ key: e, contract: t, blueId: n, node: r }), this.handlersByChannel.set(o, s), this;
   }
   setEmbedded(e) {
     if (this.embeddedDeclared)
@@ -1542,11 +1571,11 @@ class wr {
     return this.embeddedDeclared = !0, this.embeddedPaths = e.paths ? [...e.paths] : [], this;
   }
   addMarker(e, t, n) {
-    if (e === A && n !== fe)
+    if (e === A && n !== me)
       throw new Error(
         "Reserved key 'checkpoint' must contain a Channel Event Checkpoint"
       );
-    if (n === fe) {
+    if (n === me) {
       if (e !== A)
         throw new Error(
           `Channel Event Checkpoint must use reserved key 'checkpoint' at key '${e}'`
@@ -1604,7 +1633,7 @@ class kr {
       if (!h)
         throw new y(
           `Handler ${t} references unknown channel '${u}'`,
-          v.invalidContract(
+          S.invalidContract(
             o,
             `Channel '${u}' is not declared in this scope`,
             `/contracts/${u}`
@@ -1613,18 +1642,24 @@ class kr {
       if (!this.isRegisteredChannel(h.nodeTypeBlueId))
         throw new y(
           `Contract '${u}' is not a channel`,
-          v.invalidContract(
+          S.invalidContract(
             h.nodeTypeBlueId,
             `Contract '${u}' is not a channel`,
             `/contracts/${u}`
           )
         );
-      e.addHandler(t, { ...c, channel: u }, o);
+      const d = n.clone();
+      this.setContractChannel(d, u), e.addHandler(
+        t,
+        { ...c, channel: u },
+        o,
+        d
+      );
     } catch (a) {
       if (this.isZodError(a))
         throw new y(
           "Failed to parse handler contract",
-          v.invalidContract(
+          S.invalidContract(
             o,
             "Failed to parse handler contract",
             t,
@@ -1634,7 +1669,7 @@ class kr {
       const c = a?.message ?? "Failed to register handler contract";
       throw new y(
         c,
-        v.illegalState(c)
+        S.illegalState(c)
       );
     }
   }
@@ -1658,7 +1693,7 @@ class kr {
     if (!o)
       throw new y(
         `Handler ${r} must declare channel (missing explicit channel and derivation failed)`,
-        v.illegalState(
+        S.illegalState(
           `Handler ${r} must declare channel (missing explicit channel and derivation failed)`
         )
       );
@@ -1667,6 +1702,14 @@ class kr {
   isRegisteredChannel(e) {
     return this.builtinChannelSchemas.has(e) ? !0 : this.registry.lookupChannel(e) != null;
   }
+  setContractChannel(e, t) {
+    const r = e.getProperties()?.channel;
+    if (r instanceof p) {
+      r.setValue(t);
+      return;
+    }
+    e.addProperty("channel", new p().setValue(t));
+  }
   isZodError(e) {
     return e instanceof ge;
   }
@@ -1686,75 +1729,75 @@ function br(i) {
     compositeChannelBlueId: s
   } = i, a = /* @__PURE__ */ new Set(), c = /* @__PURE__ */ new Set(), u = [], h = /* @__PURE__ */ new Map([
     [e, t]
-  ]), d = (m) => {
-    if (h.has(m))
-      return h.get(m) ?? null;
-    const E = n.get(m);
+  ]), d = (f) => {
+    if (h.has(f))
+      return h.get(f) ?? null;
+    const E = n.get(f);
     if (!E || E.nodeTypeBlueId !== s)
-      return h.set(m, null), null;
+      return h.set(f, null), null;
     try {
       const C = o.nodeToSchemaOutput(
         E.node,
         dt
       );
-      return h.set(m, C), C;
+      return h.set(f, C), C;
     } catch (C) {
-      if (Ir(C))
+      if (Tr(C))
         throw new y(
           "Failed to parse channel contract",
-          v.invalidContract(
+          S.invalidContract(
             E.nodeTypeBlueId,
             "Failed to parse channel contract",
-            `/contracts/${m}`,
+            `/contracts/${f}`,
             C
           )
         );
-      const P = C?.message ?? "Failed to parse channel contract";
+      const R = C?.message ?? "Failed to parse channel contract";
       throw new y(
-        P,
-        v.illegalState(P)
+        R,
+        S.illegalState(R)
       );
     }
-  }, S = (m) => {
-    if (c.has(m)) {
-      const C = u.indexOf(m), D = [...u.slice(C), m].join(" -> ");
+  }, v = (f) => {
+    if (c.has(f)) {
+      const C = u.indexOf(f), D = [...u.slice(C), f].join(" -> ");
       throw new y(
         `Composite channel ${e} has a cyclic reference: ${D}`,
-        v.invalidContract(
+        S.invalidContract(
           r,
           `Composite channel '${e}' has a cyclic reference: ${D}`,
           `/contracts/${e}`
         )
       );
     }
-    if (a.has(m))
+    if (a.has(f))
       return;
-    c.add(m), u.push(m);
-    const E = d(m);
+    c.add(f), u.push(f);
+    const E = d(f);
     if (E)
       for (const C of E.channels ?? []) {
-        const P = n.get(C);
-        P && P.nodeTypeBlueId === s && S(C);
+        const R = n.get(C);
+        R && R.nodeTypeBlueId === s && v(C);
       }
-    u.pop(), c.delete(m), a.add(m);
+    u.pop(), c.delete(f), a.add(f);
   };
-  S(e);
+  v(e);
 }
-function Ir(i) {
+function Tr(i) {
   return i instanceof ge;
 }
-const Tr = f["Core/Document Update Channel"], Rr = f["Core/Embedded Node Channel"], Pr = f["Core/Lifecycle Event Channel"], Mr = f["Core/Triggered Event Channel"], Fe = f["Core/Process Embedded"], Nr = f["Core/Processing Initialized Marker"], Or = f["Core/Processing Terminated Marker"], Ar = f["Core/Channel Event Checkpoint"], Dr = I["MyOS/Document Anchors"], Br = I["MyOS/Document Links"], xr = I["MyOS/MyOS Participants Orchestration"], _r = I["MyOS/MyOS Session Interaction"], Lr = I["MyOS/MyOS Worker Agency"], Ue = w["Conversation/Composite Timeline Channel"], ce = /* @__PURE__ */ new Map([
+const Ir = m["Core/Document Update Channel"], Pr = m["Core/Embedded Node Channel"], Rr = m["Core/Lifecycle Event Channel"], Mr = m["Core/Triggered Event Channel"], Fe = m["Core/Process Embedded"], Nr = m["Core/Processing Initialized Marker"], Or = m["Core/Processing Terminated Marker"], Ar = m["Core/Channel Event Checkpoint"], Dr = T["MyOS/Document Anchors"], Br = T["MyOS/Document Links"], xr = T["MyOS/MyOS Participants Orchestration"], _r = T["MyOS/MyOS Session Interaction"], Lr = T["MyOS/MyOS Worker Agency"], Ue = w["Conversation/Composite Timeline Channel"], ce = /* @__PURE__ */ new Map([
   [
-    Tr,
+    Ir,
     hn
   ],
   [
-    Rr,
+    Pr,
     pn
   ],
   [
-    Pr,
-    fn
+    Rr,
+    mn
   ],
   [
     Mr,
@@ -1763,7 +1806,7 @@ const Tr = f["Core/Document Update Channel"], Rr = f["Core/Embedded Node Channel
 ]), Fr = /* @__PURE__ */ new Map([
   [
     Nr,
-    In
+    Tn
   ],
   [
     Or,
@@ -1818,7 +1861,7 @@ class Ur {
       const r = n?.message ?? "Failed to load contracts";
       throw new y(
         `Failed to load contracts for scope ${t}: ${r}`,
-        v.runtimeFatal(
+        S.runtimeFatal(
           `Failed to load contracts for scope ${t}`,
           n
         )
@@ -1887,7 +1930,7 @@ class Ur {
     }
     throw ye(o) ? new y(
       "Built-in processor-managed channel is missing schema registration",
-      v.invalidContract(
+      S.invalidContract(
         o,
         "Built-in processor-managed channel is missing schema registration",
         t
@@ -1898,13 +1941,13 @@ class Ur {
     try {
       const r = this.blue.nodeToSchemaOutput(
         n,
-        Rn
+        Pn
       );
       e.setEmbedded(r);
     } catch (r) {
       throw le(r) ? new y(
         "Failed to parse ProcessEmbedded marker",
-        v.invalidContract(
+        S.invalidContract(
           Fe,
           "Failed to parse ProcessEmbedded marker",
           t,
@@ -1912,7 +1955,7 @@ class Ur {
         )
       ) : new y(
         r?.message ?? "Failed to register ProcessEmbedded marker",
-        v.illegalState(
+        S.illegalState(
           r?.message ?? "Failed to register ProcessEmbedded marker"
         )
       );
@@ -1936,7 +1979,7 @@ class Ur {
       if (le(a))
         throw new y(
           "Failed to parse channel contract",
-          v.invalidContract(
+          S.invalidContract(
             o,
             "Failed to parse channel contract",
             t,
@@ -1946,7 +1989,7 @@ class Ur {
       const c = a?.message ?? "Failed to register channel contract";
       throw new y(
         c,
-        v.illegalState(c)
+        S.illegalState(c)
       );
     }
   }
@@ -1958,7 +2001,7 @@ class Ur {
         if (!a)
           throw new y(
             `Composite channel ${e} references unknown channel '${s}'`,
-            v.invalidContract(
+            S.invalidContract(
               r,
               `Channel '${s}' is not declared in this scope`,
               `/contracts/${s}`
@@ -1967,7 +2010,7 @@ class Ur {
         if (!this.isRegisteredChannel(a.nodeTypeBlueId))
           throw new y(
             `Contract '${s}' is not a channel`,
-            v.invalidContract(
+            S.invalidContract(
               a.nodeTypeBlueId,
               `Contract '${s}' is not a channel`,
               `/contracts/${s}`
@@ -1998,7 +2041,7 @@ class Ur {
       if (le(s))
         throw new y(
           "Failed to parse marker contract",
-          v.invalidContract(
+          S.invalidContract(
             o,
             "Failed to parse marker contract",
             t,
@@ -2008,7 +2051,7 @@ class Ur {
       const a = s?.message ?? "Failed to register marker contract";
       throw new y(
         a,
-        v.illegalState(a)
+        S.illegalState(a)
       );
     }
   }
@@ -2026,7 +2069,7 @@ class Ur {
 function le(i) {
   return i instanceof ge;
 }
-const $r = f["Core/Channel Event Checkpoint"];
+const $r = m["Core/Channel Event Checkpoint"];
 function zr(i) {
   return i.jsonValueToNode({
     type: { blueId: $r },
@@ -2058,7 +2101,7 @@ class Kr {
     this.runtime = e, this.signatureFn = t;
   }
   ensureCheckpointMarker(e, t) {
-    const n = t.marker(A), r = T(e, Qe);
+    const n = t.marker(A), r = I(e, Qe);
     if (!n) {
       const o = zr(this.runtime.blue());
       this.runtime.directWrite(r, o), t.registerCheckpointMarker(Vr());
@@ -2090,12 +2133,12 @@ class Kr {
   persist(e, t, n, r, o) {
     if (!n)
       return;
-    const s = T(
+    const s = I(
       e,
       Ze(n.markerKey, n.channelKey)
     ), a = o?.clone() ?? null;
     this.runtime.gasMeter().chargeCheckpointUpdate(), this.runtime.directWrite(s, a), n.checkpoint.lastEvents || (n.checkpoint.lastEvents = {}), a ? n.checkpoint.lastEvents[n.channelKey] = a.clone() ?? null : delete n.checkpoint.lastEvents[n.channelKey], n.lastEventNode = a?.clone() ?? null;
-    const c = T(
+    const c = I(
       e,
       et(n.markerKey, n.channelKey)
     ), u = r == null ? null : new p().setValue(r);
@@ -2234,7 +2277,7 @@ function Gr(i, e) {
 }
 class $ extends y {
   constructor(e) {
-    super(e, v.illegalState(e)), this.name = "IllegalStateException";
+    super(e, S.illegalState(e)), this.name = "IllegalStateException";
   }
 }
 class F extends Error {
@@ -2242,7 +2285,7 @@ class F extends Error {
     super(e), this.name = "BoundaryViolationException";
   }
 }
-const qr = f["Core/Document Update Channel"], jr = f["Core/Embedded Node Channel"], Jr = f["Core/Triggered Event Channel"], Qr = f["Core/Lifecycle Event Channel"], ze = f["Core/Processing Initialized Marker"], Xr = f["Core/Document Processing Initiated"];
+const qr = m["Core/Document Update Channel"], jr = m["Core/Embedded Node Channel"], Jr = m["Core/Triggered Event Channel"], Qr = m["Core/Lifecycle Event Channel"], ze = m["Core/Processing Initialized Marker"], Xr = m["Core/Document Processing Initiated"];
 class Yr {
   runtime;
   contractLoader;
@@ -2264,12 +2307,12 @@ class Yr {
       if (!d)
         return;
       s || (s = d.clone()), o = this.loadBundle(d, n), this.bundles.set(n, o);
-      const S = o.embeddedPaths().find((C) => !r.has(C)) ?? null;
-      if (!S)
+      const v = o.embeddedPaths().find((C) => !r.has(C)) ?? null;
+      if (!v)
         break;
-      r.add(S);
-      const m = T(n, S);
-      this.nodeAt(m) && await this.initializeScope(m, !0);
+      r.add(v);
+      const f = I(n, v);
+      this.nodeAt(f) && await this.initializeScope(f, !0);
     }
     if (!o)
       return;
@@ -2297,7 +2340,7 @@ class Yr {
     const n = this.nodeAt(t), r = n ? this.loadBundle(n, t) : V.empty();
     this.bundles.set(t, r);
     for (const o of r.embeddedPaths()) {
-      const s = T(t, o);
+      const s = I(t, o);
       this.loadBundles(s);
     }
   }
@@ -2426,7 +2469,7 @@ class Yr {
       if (!s)
         return o;
       r.add(s);
-      const a = T(n, s);
+      const a = I(n, s);
       if (a === n || this.hooks.isScopeInactive(a)) {
         o = this.refreshBundle(n);
         continue;
@@ -2459,7 +2502,7 @@ class Yr {
       const r = n?.message ?? "Failed to load contracts";
       throw new y(
         r,
-        v.runtimeFatal(
+        S.runtimeFatal(
           `Failed to load contracts for scope ${t}`,
           n
         )
@@ -2485,13 +2528,13 @@ class Yr {
     );
     if (n.length !== 0)
       for (const r of t.embeddedPaths()) {
-        const o = T(e, r), a = this.runtime.scope(o).drainBridgeableEvents();
+        const o = I(e, r), a = this.runtime.scope(o).drainBridgeableEvents();
         if (a.length !== 0)
           for (const c of a) {
             let u = !1;
             for (const h of n) {
-              const S = h.contract().childPath ?? "/";
-              T(e, S) === o && (u || (this.runtime.gasMeter().chargeBridge(), u = !0), await this.channelRunner.runHandlers(
+              const v = h.contract().childPath ?? "/";
+              I(e, v) === o && (u || (this.runtime.gasMeter().chargeBridge(), u = !0), await this.channelRunner.runHandlers(
                 e,
                 t,
                 h.key(),
@@ -2536,7 +2579,7 @@ class Yr {
     }
   }
   validatePatchBoundary(e, t, n) {
-    const r = k(e), o = R(n.path);
+    const r = k(e), o = P(n.path);
     if (o === r)
       throw new F(
         `Self-root mutation is forbidden at scope ${r}`
@@ -2546,7 +2589,7 @@ class Yr {
         `Patch path ${o} is outside scope ${r}`
       );
     for (const s of t.embeddedPaths()) {
-      const a = T(r, s);
+      const a = I(r, s);
       if (o.startsWith(`${a}/`))
         throw new F(
           `Boundary violation: patch ${o} enters embedded scope ${a}`
@@ -2556,11 +2599,11 @@ class Yr {
   enforceReservedKeyWriteProtection(e, t, n) {
     if (n)
       return;
-    const r = k(e), o = R(t.path);
+    const r = k(e), o = P(t.path);
     for (const s of Ee) {
-      const a = T(
+      const a = I(
         r,
-        ne(s)
+        re(s)
       );
       if (o === a || o.startsWith(`${a}/`))
         throw new F(
@@ -2571,14 +2614,14 @@ class Yr {
   async markCutOffChildrenIfNeeded(e, t, n) {
     if (t.embeddedPaths().length === 0)
       return;
-    const r = R(n.path);
+    const r = P(n.path);
     for (const o of t.embeddedPaths()) {
-      const s = T(e, o);
+      const s = I(e, o);
       r === s && (n.op === "remove" || n.op === "replace") && await this.hooks.markCutOff(s);
     }
   }
   hasInitializationMarker(e) {
-    const t = T(e, de), n = this.nodeAt(t);
+    const t = I(e, de), n = this.nodeAt(t);
     if (!n)
       return !1;
     if (!(n instanceof p)) {
@@ -2598,21 +2641,21 @@ class Yr {
     });
   }
 }
-class ee extends Error {
+class te extends Error {
   constructor(e) {
     super(
       e ? "Processing terminated due to fatal error" : "Processing terminated"
     ), this.fatal = e, this.name = "RunTerminationError";
   }
 }
-const Zr = f["Core/Processing Terminated Marker"], ei = f["Core/Document Processing Terminated"];
+const Zr = m["Core/Processing Terminated Marker"], ei = m["Core/Document Processing Terminated"];
 class ti {
   constructor(e) {
     this.runtime = e;
   }
   async terminateScope(e, t, n, r, o) {
     e.recordPendingTermination(t, r, o ?? null);
-    const s = e.normalizeScope(t), a = T(s, Je);
+    const s = e.normalizeScope(t), a = I(s, Je);
     this.runtime.directWrite(
       a,
       ni(this.runtime.blue(), r, o)
@@ -2624,9 +2667,9 @@ class ti {
       u,
       !1
     ), this.runtime.scope(s).finalizeTermination(r, o ?? null), e.clearPendingTermination(t), r === "FATAL" && this.runtime.gasMeter().chargeFatalTerminationOverhead(), r === "FATAL" && s === "/")
-      throw this.runtime.markRunTerminated(), new ee(!0);
+      throw this.runtime.markRunTerminated(), new te(!0);
     if (r === "GRACEFUL" && s === "/")
-      throw this.runtime.markRunTerminated(), new ee(!1);
+      throw this.runtime.markRunTerminated(), new te(!1);
   }
 }
 function ni(i, e, t) {
@@ -2648,13 +2691,13 @@ function ri(i, e) {
 function ii(i, e) {
   return i.jsonValueToNode(e);
 }
-const q = "-";
+const j = "-";
 class oi {
   constructor(e) {
     this.document = e;
   }
   applyPatch(e, t) {
-    const n = k(e), r = R(t.path), o = He(r), s = Ve(this.document, o, "before", r);
+    const n = k(e), r = P(t.path), o = He(r), s = Ve(this.document, o, "before", r);
     switch (t.op) {
       case "ADD":
         this.applyAdd(o, r, t.val ?? null);
@@ -2677,11 +2720,11 @@ class oi {
     };
   }
   directWrite(e, t) {
-    const n = R(e);
+    const n = P(e);
     if (n === "/")
       throw new Error("Direct write cannot target root document");
     const r = He(n), { parent: o, leaf: s } = this.resolveParent(r);
-    if (s === q)
+    if (s === j)
       throw new Error(
         `Direct write does not support append token '-' for path ${n}`
       );
@@ -2714,7 +2757,7 @@ class oi {
     );
   }
   directWriteObject(e, t, n) {
-    const r = Q(e);
+    const r = X(e);
     if (n == null) {
       delete r[t], e.setProperties(
         Object.keys(r).length > 0 ? r : void 0
@@ -2734,25 +2777,25 @@ class oi {
     return { parent: t, leaf: e[e.length - 1] };
   }
   getOrCreateChild(e, t, n, r) {
-    if (t === q)
+    if (t === j)
       throw new Error(
-        `Append token '-' must be final segment: ${W(n, r)}`
+        `Append token '-' must be final segment: ${G(n, r)}`
       );
     const o = e.getItems();
     if (o && U(t)) {
-      const c = B(t, W(n, r));
+      const c = B(t, G(n, r));
       if (c < 0 || c >= o.length)
         throw new Error(
-          `Array index out of bounds: ${W(n, r)}`
+          `Array index out of bounds: ${G(n, r)}`
         );
       const u = o[c];
       if (!u)
         throw new Error(
-          `Path does not exist: ${W(n, r)}`
+          `Path does not exist: ${G(n, r)}`
         );
       return u;
     }
-    const s = Q(e);
+    const s = X(e);
     let a = s[t];
     return a || (a = new p(), s[t] = a, e.setProperties(s)), a;
   }
@@ -2766,23 +2809,23 @@ class oi {
     );
     try {
       if (U(o)) {
-        const u = r.getItems(), h = o === q;
+        const u = r.getItems(), h = o === j;
         if (!u)
           throw new Error(
             h ? `Append token '-' requires array at ${s}` : `Array index segment requires array at ${s}`
           );
         if (h) {
-          ue(r, u).push(G(n));
+          ue(r, u).push(q(n));
           return;
         }
         const d = B(o, t);
         if (d < 0 || d > u.length)
           throw new Error(`Array index out of bounds in path: ${t}`);
-        ue(r, u).splice(d, 0, G(n));
+        ue(r, u).splice(d, 0, q(n));
         return;
       }
-      const c = Q(r);
-      c[o] = G(n), r.setProperties(c);
+      const c = X(r);
+      c[o] = q(n), r.setProperties(c);
     } catch (c) {
       throw this.rollbackCreated(a), c;
     }
@@ -2803,11 +2846,11 @@ class oi {
         const u = B(o, t);
         if (u < 0 || u >= c.length)
           throw new Error(`Array index out of bounds in path: ${t}`);
-        c[u] = G(n), r.setItems(c);
+        c[u] = q(n), r.setItems(c);
         return;
       }
-      const a = Q(r);
-      a[o] = G(n), r.setProperties(a);
+      const a = X(r);
+      a[o] = q(n), r.setProperties(a);
     } catch (a) {
       throw this.rollbackCreated(s), a;
     }
@@ -2842,15 +2885,15 @@ class oi {
     let r = this.document;
     const o = [];
     for (let a = 0; a < e.length - 1; a += 1) {
-      const c = e[a], u = W(e, a + 1);
+      const c = e[a], u = G(e, a + 1);
       if (U(c)) {
-        const S = r.getItems();
-        if (!S)
+        const v = r.getItems();
+        if (!v)
           throw new Error(`Array index segment requires array at ${u}`);
-        const m = B(c, u);
-        if (m < 0 || m >= S.length)
+        const f = B(c, u);
+        if (f < 0 || f >= v.length)
           throw new Error(`Array index out of bounds in path: ${u}`);
-        const E = S[m];
+        const E = v[f];
         if (!(E instanceof p))
           throw new Error(`Array index out of bounds in path: ${u}`);
         r = E;
@@ -2907,7 +2950,7 @@ function ci(i, e, t, n, r) {
     return null;
   const o = i.getItems();
   if (o) {
-    if (e === q) {
+    if (e === j) {
       if (!t)
         throw new Error(`Append token '-' must be final segment: ${r}`);
       return n === "before" || o.length === 0 ? null : o[o.length - 1] ?? null;
@@ -2935,7 +2978,7 @@ function B(i, e) {
     throw new Error(`Negative array index in path: ${e}`);
   return t;
 }
-function W(i, e) {
+function G(i, e) {
   if (e <= 0)
     return "/";
   const t = Math.min(e, i.length);
@@ -2948,7 +2991,7 @@ function ue(i, e) {
   const t = [...e];
   return i.setItems(t), t;
 }
-function Q(i) {
+function X(i) {
   const e = i.getProperties();
   if (!e) {
     const n = {};
@@ -2958,9 +3001,9 @@ function Q(i) {
   return i.setProperties(t), t;
 }
 function U(i) {
-  return i === q || /^\d+$/.test(i);
+  return i === j || /^\d+$/.test(i);
 }
-function G(i) {
+function q(i) {
   return i == null ? new p().setValue(null) : i.clone();
 }
 class li {
@@ -3055,7 +3098,7 @@ function Ct(i) {
   return Math.floor((i + 99) / 100);
 }
 function hi(i) {
-  const e = R(i);
+  const e = P(i);
   return e === "/" ? 0 : e.split("/").length - 1;
 }
 function di(i) {
@@ -3064,14 +3107,14 @@ function di(i) {
 function pi(i, e) {
   return 8 + hi(i) + Ct(e);
 }
-const mi = 1e3, fi = 5, gi = 50, Ei = 2, yi = 10, Ci = 10, Si = 10, vi = 20, wi = 20, ki = 30, bi = 30, Ii = 100;
-function Ti(i) {
+const fi = 1e3, mi = 5, gi = 50, Ei = 2, yi = 10, Ci = 10, Si = 10, vi = 20, wi = 20, ki = 30, bi = 30, Ti = 100;
+function Ii(i) {
   return 50 + 10 * i;
 }
-function Ri(i) {
+function Pi(i) {
   return 20 + i;
 }
-function Pi(i) {
+function Ri(i) {
   return 10 * i;
 }
 function Mi(i) {
@@ -3089,13 +3132,13 @@ class Ni {
     this.total += e;
   }
   chargeScopeEntry(e) {
-    this.add(Ti(this.scopeDepth(e)));
+    this.add(Ii(this.scopeDepth(e)));
   }
   chargeInitialization() {
-    this.add(mi);
+    this.add(fi);
   }
   chargeChannelMatchAttempt() {
-    this.add(fi);
+    this.add(mi);
   }
   chargeHandlerOverhead() {
     this.add(gi);
@@ -3104,13 +3147,13 @@ class Ni {
     this.add(Ei);
   }
   chargePatchAddOrReplace(e) {
-    this.add(Ri(this.payloadSizeCharge(e)));
+    this.add(Pi(this.payloadSizeCharge(e)));
   }
   chargePatchRemove() {
     this.add(yi);
   }
   chargeCascadeRouting(e) {
-    e > 0 && this.add(Pi(e));
+    e > 0 && this.add(Ri(e));
   }
   chargeEmitEvent(e) {
     this.add(Mi(this.payloadSizeCharge(e)));
@@ -3131,7 +3174,7 @@ class Ni {
     this.add(ki);
   }
   chargeFatalTerminationOverhead() {
-    this.add(Ii);
+    this.add(Ti);
   }
   chargeTriggerEventBase() {
     this.add(bi);
@@ -3217,7 +3260,7 @@ class Oi {
     return this.patchEngine.applyPatch(e, t);
   }
 }
-const Ai = f["Core/Processing Initialized Marker"], Di = f["Core/Document Update"];
+const Ai = m["Core/Processing Initialized Marker"], Di = m["Core/Document Update"];
 class Bi {
   constructor(e, t, n, r) {
     this.contractLoader = e, this.registry = t, this.runtimeRef = new Oi(r, n);
@@ -3244,7 +3287,7 @@ class Bi {
             const h = `No processor registered for handler contract ${s.blueId()}`;
             throw new y(
               h,
-              v.illegalState(h)
+              S.illegalState(h)
             );
           }
           const u = c.matches;
@@ -3364,7 +3407,7 @@ class Bi {
     return k(e);
   }
   resolvePointer(e, t) {
-    return T(e, t);
+    return I(e, t);
   }
   async terminate(e, t, n, r) {
     const o = k(e);
@@ -3378,7 +3421,7 @@ class Bi {
   }
   nodeAt(e) {
     const t = k(e);
-    return te.nodeAt(this.runtimeRef.document(), t, {
+    return ne.nodeAt(this.runtimeRef.document(), t, {
       calculateBlueId: (n) => this.runtimeRef.blue().calculateBlueIdSync(n)
     });
   }
@@ -3402,7 +3445,7 @@ class Bi {
       return await d.call(o, c, h);
     if (!await o.matches(c, h))
       return { matches: !1 };
-    const m = o.channelize, E = m ? m.call(o, c, h) : void 0;
+    const f = o.channelize, E = f ? f.call(o, c, h) : void 0;
     return {
       matches: !0,
       eventId: s,
@@ -3415,10 +3458,13 @@ class Bi {
       const r = `No processor registered for handler contract ${e.blueId()}`;
       throw new y(
         r,
-        v.illegalState(r)
+        S.illegalState(r)
       );
     }
-    await n.execute(e.contract(), t);
+    await n.execute(e.contract(), t, {
+      contractKey: e.key(),
+      contractNode: e.node()
+    });
   }
   /**
    * Converts unexpected handler failures into fatal terminations while allowing
@@ -3426,7 +3472,7 @@ class Bi {
    * the outer run logic can react according to spec (§22).
    */
   async handleHandlerError(e, t, n) {
-    if (n instanceof ee || n instanceof z)
+    if (n instanceof te || n instanceof z)
       throw n;
     const r = this.fatalReason(n, "Runtime fatal");
     await this.enterFatalTermination(e, t, r);
@@ -3448,11 +3494,11 @@ class Bi {
   matchesDocumentUpdate(e, t, n) {
     if (!t || t.length === 0)
       return !1;
-    const r = R(T(e, t)), o = R(n);
+    const r = P(I(e, t)), o = P(n);
     return r === "/" || o === r ? !0 : o.startsWith(`${r}/`);
   }
 }
-class te {
+class ne {
   constructor(e, t, n) {
     this.contractLoader = e, this.registry = t, this.blue = n;
   }
@@ -3487,7 +3533,7 @@ class te {
     try {
       await n();
     } catch (r) {
-      if (r instanceof ee)
+      if (r instanceof te)
         return t.result();
       if (r instanceof z) {
         const o = e.clone();
@@ -3501,20 +3547,20 @@ class te {
     return t.result();
   }
   initializationMarker(e) {
-    const n = e.getProperties()?.[Ie.OBJECT_CONTRACTS]?.getProperties()?.initialized ?? null;
+    const n = e.getProperties()?.[Te.OBJECT_CONTRACTS]?.getProperties()?.initialized ?? null;
     if (!n)
       return null;
     if (!(n instanceof p))
       throw new y(
         "Initialization Marker must be a BlueNode",
-        v.illegalState(
+        S.illegalState(
           "Initialization Marker must be a BlueNode"
         )
       );
     if (n.getType()?.getBlueId() !== Ai)
       throw new y(
         "Initialization Marker must declare type 'Processing Initialized Marker'",
-        v.illegalState(
+        S.illegalState(
           "Initialization Marker must declare type 'Processing Initialized Marker'"
         )
       );
@@ -3523,7 +3569,7 @@ class te {
   static nodeAt(e, t, n) {
     if (!(e instanceof p))
       return null;
-    const r = R(t);
+    const r = P(t);
     if (r === "/")
       return e;
     const o = r.slice(1).split("/");
@@ -3574,10 +3620,10 @@ class te {
         return new p().setValue(e.getValue() ?? null);
       case "blue":
         return e.getBlue() ?? null;
-      case Ie.OBJECT_CONTRACTS:
+      case Te.OBJECT_CONTRACTS:
         return new p().setContracts(e.getContracts());
       case "blueId": {
-        const r = e.getBlueId() ?? n?.calculateBlueId?.(e) ?? Rt.calculateBlueIdSync(e);
+        const r = e.getBlueId() ?? n?.calculateBlueId?.(e) ?? Pt.calculateBlueIdSync(e);
         return new p().setValue(r ?? null);
       }
       default:
@@ -3621,7 +3667,7 @@ class xi {
     this.shouldSkipTerminatedWork() || this.execution.runtime().addGas(e);
   }
   throwFatal(e) {
-    throw new y(e, v.runtimeFatal(e));
+    throw new y(e, S.runtimeFatal(e));
   }
   resolvePointer(e) {
     return this.execution.resolvePointer(this.scopePathValue, e);
@@ -3640,7 +3686,7 @@ class xi {
     if (!e)
       return !1;
     try {
-      return te.nodeAt(
+      return ne.nodeAt(
         this.execution.runtime().document(),
         e,
         {
@@ -3652,7 +3698,7 @@ class xi {
     }
   }
   documentNodeAt(e) {
-    const t = te.nodeAt(
+    const t = ne.nodeAt(
       this.execution.runtime().document(),
       e,
       {
@@ -3679,7 +3725,7 @@ class xi {
     return !this.allowTerminatedWork && this.execution.isScopeInactive(this.scopePathValue);
   }
 }
-const _i = new Pt({
+const _i = new Rt({
   repositories: [Mt]
 });
 class Li {
@@ -3688,7 +3734,7 @@ class Li {
   contractLoaderRef;
   engine;
   constructor(e) {
-    this.registryRef = e?.registry ?? oe.create().registerDefaults().build(), this.blue = e?.blue ?? _i, this.contractLoaderRef = new Ur(this.registryRef, this.blue), this.engine = new te(
+    this.registryRef = e?.registry ?? se.create().registerDefaults().build(), this.blue = e?.blue ?? _i, this.contractLoaderRef = new Ur(this.registryRef, this.blue), this.engine = new ne(
       this.contractLoaderRef,
       this.registryRef,
       this.blue
@@ -3728,7 +3774,7 @@ class Fi {
   contractRegistry;
   blueInstance;
   constructor() {
-    this.contractRegistry = oe.create().registerDefaults().build();
+    this.contractRegistry = se.create().registerDefaults().build();
   }
   withRegistry(e) {
     return this.contractRegistry = e, this;
@@ -3749,7 +3795,7 @@ class Fi {
 class St {
   process(e, t) {
     const n = t.getValue();
-    if (Y(n)) {
+    if (Z(n)) {
       const r = t.clone();
       return r.setValue(n), r.setProperties(void 0), r.setItems(void 0), r.setType(void 0), r;
     }
@@ -3760,7 +3806,7 @@ class St {
    */
   postProcess(e, t) {
     const n = t.getValue();
-    if (Y(n) && e.getValue() !== n && n !== void 0) {
+    if (Z(n) && e.getValue() !== n && n !== void 0) {
       const r = e.clone();
       return r.setValue(n), r;
     }
@@ -3791,7 +3837,7 @@ export {
   wr as ContractBundleBuilder,
   Ur as ContractLoader,
   qn as ContractProcessorRegistry,
-  oe as ContractProcessorRegistryBuilder,
+  se as ContractProcessorRegistryBuilder,
   Ke as DocumentProcessingResult,
   Oi as DocumentProcessingRuntime,
   Li as DocumentProcessor,
@@ -3807,8 +3853,8 @@ export {
   je as PROCESSOR_MANAGED_CHANNEL_BLUE_IDS,
   oi as PatchEngine,
   no as ProcessorContractConstants,
-  te as ProcessorEngine,
-  v as ProcessorErrors,
+  ne as ProcessorEngine,
+  S as ProcessorErrors,
   Bi as ProcessorExecution,
   xi as ProcessorExecutionContext,
   y as ProcessorFatalError,
@@ -3820,7 +3866,7 @@ export {
   de as RELATIVE_INITIALIZED,
   Je as RELATIVE_TERMINATED,
   Ee as RESERVED_CONTRACT_KEYS,
-  ee as RunTerminationError,
+  te as RunTerminationError,
   Yr as ScopeExecutor,
   li as ScopeRuntimeContext,
   ti as TerminationService,
@@ -3842,15 +3888,15 @@ export {
   at as evaluateQuickJSExpression,
   an as extractExpressionContent,
   ut as handlerContractBaseSchema,
-  In as initializationMarkerSchema,
+  Tn as initializationMarkerSchema,
   Ji as isErr,
-  Y as isExpression,
+  Z as isExpression,
   ji as isOk,
   ye as isProcessorManagedChannelBlueId,
   _t as isReservedContractKey,
   io as joinRelativePointers,
   oo as jsonPatchSchema,
-  fn as lifecycleChannelSchema,
+  mn as lifecycleChannelSchema,
   Qi as map,
   Xi as mapErr,
   N as markerContractBaseSchema,
@@ -3859,23 +3905,23 @@ export {
   $n as myosSessionInteractionMarkerSchema,
   Sn as myosTimelineChannelSchema,
   Vn as myosWorkerAgencyMarkerSchema,
-  R as normalizePointer,
+  P as normalizePointer,
   k as normalizeScope,
   Nt as ok,
   Nn as operationMarkerSchema,
-  Rn as processEmbeddedMarkerSchema,
+  Pn as processEmbeddedMarkerSchema,
   Mn as processingTerminatedMarkerSchema,
   Ze as relativeCheckpointLastEvent,
   et as relativeCheckpointLastSignature,
-  ne as relativeContractsEntry,
+  re as relativeContractsEntry,
   Ft as relativizePointer,
-  Z as resolveNodeExpressions,
-  T as resolvePointer,
+  ee as resolveNodeExpressions,
+  I as resolvePointer,
   cn as resolveTemplateString,
   Wn as sequentialWorkflowOperationSchema,
   Hn as sequentialWorkflowSchema,
   so as sequentialWorkflowStepSchema,
-  Re as stripSlashes,
+  Pe as stripSlashes,
   yn as timelineChannelSchema,
   En as triggeredEventChannelSchema,
   Zi as unwrapOr,