@ixo/editor 6.6.0 → 6.7.0

package/dist/{chunk-DZMEWZ5Z.js → chunk-RIJGQ4W6.js}

@@ -10,7 +10,7 @@ import {
   replaceBlockInFragment,
   swapBlocksInFragment,
   writeCompiledBlocksToFragment
-} from "./chunk-EULL3QTC.js";
+} from "./chunk-JS7P4DUX.js";
 
 // src/core/lib/flowCompiler/authoring.ts
 import * as Y from "yjs";
@@ -257,4 +257,4 @@ export {
   resetStepRuntime,
   setFormAnswers
 };
-//# sourceMappingURL=chunk-DZMEWZ5Z.js.map
+//# sourceMappingURL=chunk-RIJGQ4W6.js.map

package/dist/core/index.d.ts

@@ -1,7 +1,8 @@
-import { a5 as ActionDefinition, a6 as ActionEventDefinition, a7 as OutputSchemaField, a8 as ActionServices, a9 as ActionProofDeclaration, aa as RunRecordDetails, ab as CompiledBlock, v as CompiledFlow, ac as CompiledEdge, Z as FlowAgentCommand, $ as FlowAgentContext, ad as ActionHandlers, _ as FlowAgentCommandResult, a0 as FlowAgentExecutor, a2 as FlowAgentNodeSnapshot, ae as FlowAgentBlockerCause, a3 as FlowAgentPublicNodeState } from '../store-BS2HJhJR.js';
-export { aP as AcquireFlowAgentLeaseParams, ag as ActionContext, at as ActionResult, b1 as ActorConstraint, A as AuthorizationResult, B as BaseUcanFlow, ak as BidService, X as BuildFlowAgentContextParams, ar as CarbonService, al as ClaimService, am as CollectionService, an as CollectionUsersService, b4 as CompiledFlowNode, C as CompilerRegistry, b0 as ConditionRef, aQ as CreateAgentCommandParams, ai as EmailService, as as EntityService, aR as EvaluateFlowAgentPolicyParams, E as ExecuteNodeParams, f as ExecutionContext, d as ExecutionOutcome, aH as FailedListenerRun, Y as FlowAgentActor, aU as FlowAgentCommandBase, aV as FlowAgentCommandStatus, aW as FlowAgentCommandType, a1 as FlowAgentLease, aX as FlowAgentLedgerEvent, aY as FlowAgentLedgerEventType, aZ as FlowAgentMaps, aS as FlowAgentOrchestratorOptions, a_ as FlowAgentPolicyDecision, a$ as FlowAgentRunPhase, x as FlowAgentService, aT as FlowAgentServiceOptions, a4 as FlowAgentTickResult, u as FlowCapability, F as FlowRuntimeStateManager, w as FlowStrategy, ah as HttpService, ap as IntegrationsService, ao as MatrixCredentialService, M as MergeResult, N as NodeActionResult, aj as NotifyService, aq as OracleService, aG as PendingInvocation, aF as RUN_RECORD_AUDIT_TYPE, R as ReadFlowOptions, q as ReadFlowResult, b3 as RuntimeRef, S as SetupFlowOptions, p as SetupFlowResult, b2 as TTLConstraint, b5 as TriggerSpec, y as acquireFlowAgentLease, z as appendAgentLedgerEvent, au as appendRunRecord, a as buildAuthzFromProps, D as buildFlowAgentContext, b as buildFlowNodeFromBlock, aI as canMatches, G as cleanupExpiredFlowAgentLeases, af as clearRuntimeForTemplateClone, l as compileBaseUcanFlow, aJ as computeAgentCommandId, aE as computePendingInvocationId, H as createAgentCommand, c as createRuntimeStateManager, o as decompileToBaseUcanFlow, I as evaluateFlowAgentPolicy, e as executeNode, J as executeQueuedAgentCommands, aB as findFailedListenersForSourceRun, k as getActiveEditor, K as getFlowAgentMaps, ax as getOrCreateBlockPendingMap, aw as getPendingInvocationsMap, i as isAuthorized, aK as isCapabilityMatch, aL as isExternalMutation, b6 as isRuntimeRef, n as mergeCompiledFlows, L as planRalphLoopCommands, O as queueAgentCommand, az as queuePendingInvocation, P as readAgentLedgerEvents, m as readCompiledFlowFromYDoc, h as readFlow, r as readFlowAsBaseUcan, g as readFlowFromEditor, ay as readPendingInvocations, Q as readQueuedAgentCommands, av as readRunRecords, T as releaseFlowAgentLease, aA as removePendingInvocation, aC as replayFailedListenerRun, aM as requiredCapabilityForCommand, aN as resourceMatches, j as setActiveEditor, s as setupFlowFromBaseUcan, aD as snapshotInputRefs, U as tickFlowAgent, aO as updateAgentCommand, V as validateAgentCommand, W as validateFlowAgentLease } from '../store-BS2HJhJR.js';
-import { a4 as FlowNodeRuntimeState, j as StoredInvocation, a5 as IxoEditorType, f as UcanService, U as UcanDelegationStore, S as StoredDelegation, I as InvocationStore, a6 as FlowMetadata, a7 as FlowNode } from '../index-C70b-Yd0.js';
-export { af as ActionReadBackMetadata, a9 as ClaimCollectionURI, am as CreateDelegationParams, an as CreateInvocationParams, al as CreateRootDelegationParams, a8 as DID, D as DelegationChainValidationResult, k as DelegationGrant, aa as EvaluationStatus, aj as ExecutionWithInvocationResult, ak as FindProofsResult, ac as FlowNodeAuthzExtension, ag as FlowNodeBase, ah as InvocationRequest, ai as InvocationResult, ab as LinkedClaim, ad as NodeState, ae as ReadBackTerminalState, i as UcanCapability, g as UcanServiceConfig, h as UcanServiceHandlers, b as createInvocationStore, d as createMemoryInvocationStore, a as createMemoryUcanDelegationStore, c as createUcanDelegationStore, e as createUcanService } from '../index-C70b-Yd0.js';
+import { a5 as ActionDefinition, a6 as ActionEventDefinition, a7 as OutputSchemaField, a8 as ActionServices, a9 as ActionProofDeclaration, aa as RunRecordDetails, ab as CompiledBlock, v as CompiledFlow, ac as CompiledEdge, Z as FlowAgentCommand, $ as FlowAgentContext, ad as ActionHandlers, _ as FlowAgentCommandResult, a0 as FlowAgentExecutor, a2 as FlowAgentNodeSnapshot, ae as FlowAgentBlockerCause, a3 as FlowAgentPublicNodeState } from '../store-BIt_Vdjw.js';
+export { aP as AcquireFlowAgentLeaseParams, ag as ActionContext, at as ActionResult, b1 as ActorConstraint, A as AuthorizationResult, B as BaseUcanFlow, ak as BidService, X as BuildFlowAgentContextParams, ar as CarbonService, al as ClaimService, am as CollectionService, an as CollectionUsersService, b4 as CompiledFlowNode, C as CompilerRegistry, b0 as ConditionRef, aQ as CreateAgentCommandParams, ai as EmailService, as as EntityService, aR as EvaluateFlowAgentPolicyParams, E as ExecuteNodeParams, f as ExecutionContext, d as ExecutionOutcome, aH as FailedListenerRun, Y as FlowAgentActor, aU as FlowAgentCommandBase, aV as FlowAgentCommandStatus, aW as FlowAgentCommandType, a1 as FlowAgentLease, aX as FlowAgentLedgerEvent, aY as FlowAgentLedgerEventType, aZ as FlowAgentMaps, aS as FlowAgentOrchestratorOptions, a_ as FlowAgentPolicyDecision, a$ as FlowAgentRunPhase, x as FlowAgentService, aT as FlowAgentServiceOptions, a4 as FlowAgentTickResult, u as FlowCapability, F as FlowRuntimeStateManager, w as FlowStrategy, ah as HttpService, ap as IntegrationsService, ao as MatrixCredentialService, M as MergeResult, N as NodeActionResult, aj as NotifyService, aq as OracleService, aG as PendingInvocation, aF as RUN_RECORD_AUDIT_TYPE, R as ReadFlowOptions, q as ReadFlowResult, b3 as RuntimeRef, S as SetupFlowOptions, p as SetupFlowResult, b2 as TTLConstraint, b5 as TriggerSpec, y as acquireFlowAgentLease, z as appendAgentLedgerEvent, au as appendRunRecord, a as buildAuthzFromProps, D as buildFlowAgentContext, b as buildFlowNodeFromBlock, aI as canMatches, G as cleanupExpiredFlowAgentLeases, af as clearRuntimeForTemplateClone, l as compileBaseUcanFlow, aJ as computeAgentCommandId, aE as computePendingInvocationId, H as createAgentCommand, c as createRuntimeStateManager, o as decompileToBaseUcanFlow, I as evaluateFlowAgentPolicy, e as executeNode, J as executeQueuedAgentCommands, aB as findFailedListenersForSourceRun, k as getActiveEditor, K as getFlowAgentMaps, ax as getOrCreateBlockPendingMap, aw as getPendingInvocationsMap, i as isAuthorized, aK as isCapabilityMatch, aL as isExternalMutation, b6 as isRuntimeRef, n as mergeCompiledFlows, L as planRalphLoopCommands, O as queueAgentCommand, az as queuePendingInvocation, P as readAgentLedgerEvents, m as readCompiledFlowFromYDoc, h as readFlow, r as readFlowAsBaseUcan, g as readFlowFromEditor, ay as readPendingInvocations, Q as readQueuedAgentCommands, av as readRunRecords, T as releaseFlowAgentLease, aA as removePendingInvocation, aC as replayFailedListenerRun, aM as requiredCapabilityForCommand, aN as resourceMatches, j as setActiveEditor, s as setupFlowFromBaseUcan, aD as snapshotInputRefs, U as tickFlowAgent, aO as updateAgentCommand, V as validateAgentCommand, W as validateFlowAgentLease } from '../store-BIt_Vdjw.js';
+import { a4 as FlowNodeRuntimeState, j as StoredInvocation, a5 as IxoEditorType, f as UcanService, U as UcanDelegationStore, S as StoredDelegation, I as InvocationStore, a6 as FlowMetadata, a7 as FlowNode } from '../index-D0S6jY7O.js';
+export { ag as ActionReadBackMetadata, a9 as ClaimCollectionURI, an as CreateDelegationParams, ao as CreateInvocationParams, am as CreateRootDelegationParams, a8 as DID, D as DelegationChainValidationResult, k as DelegationGrant, aa as EvaluationStatus, ak as ExecutionWithInvocationResult, al as FindProofsResult, ac as FlowNodeAuthzExtension, ah as FlowNodeBase, ai as InvocationRequest, aj as InvocationResult, ab as LinkedClaim, ad as NodeServiceReport, ae as NodeState, af as ReadBackTerminalState, i as UcanCapability, g as UcanServiceConfig, h as UcanServiceHandlers, b as createInvocationStore, d as createMemoryInvocationStore, a as createMemoryUcanDelegationStore, c as createUcanDelegationStore, e as createUcanService } from '../index-D0S6jY7O.js';
+export { b as NODE_CONTEXT_MAP_NAME, c as NODE_CONTEXT_OVERRIDES_MAP_NAME, a as NodeContextFieldProvenance, N as NodeContextRecord, i as isNodeContextRecord } from '../nodeContext-C-BsYuYi.js';
 import * as Y from 'yjs';
 import { Doc } from 'yjs';
 import 'matrix-js-sdk';
@@ -110,6 +111,63 @@ declare function getAllCanMappings(): ReadonlyArray<{
     type: string;
 }>;
 
+/**
+ * Service-verb `can` grammar for contracted helper oracles.
+ *
+ * The `can` vocabulary has two tiers:
+ *
+ * 1. **Action cans** (`<namespace>/<verb>`, e.g. `claim/evaluate`) — the
+ *    identity of an execution contract. They map 1:1 to registry action types
+ *    (see `canMapping.ts`) and name the thing the flow engine actually runs.
+ * 2. **Service cans** (`<action can>/<service verb>`, e.g.
+ *    `claim/evaluate/report`) — the name of a contracted helper service scoped
+ *    to an action. A helper oracle holding a service-can delegation does NOT
+ *    execute the action; it performs a service about it (produce a report,
+ *    format output, advise). The delegation is a **work contract** — inputs
+ *    passed by value, receipt returned by value — not a grant of system
+ *    authority over the action or its resources.
+ *
+ * Attenuation rule: flow-document authority covers `<can>/*` service verbs —
+ * a principal authorized over the flow may contract any service verb under the
+ * cans that flow uses. A narrow execution grant (e.g. `claim/evaluate` alone)
+ * does not expand into service verbs, and a service-verb grant (e.g.
+ * `claim/evaluate/report`) does not expand into execution.
+ *
+ * Generic action-agnostic services (e.g. `flow/diagnose`) are their own tier
+ * with their own vocabulary and are intentionally NOT expressible through this
+ * helper — `diagnose` is not a `ServiceVerb`.
+ */
+/** The closed set of service verbs a helper oracle can be contracted for. */
+declare const SERVICE_VERBS: readonly ["report", "format", "advise"];
+type ServiceVerb = (typeof SERVICE_VERBS)[number];
+/**
+ * Compose a service can from an action can and a service verb.
+ *
+ * `serviceCan('claim/evaluate', 'report')` → `'claim/evaluate/report'`.
+ *
+ * @throws when `can` is not a valid action-can shape (`<namespace>/<verb>`),
+ * when `can` is already a service can (no service-of-service composition), or
+ * when `verb` is not in {@link SERVICE_VERBS} — the vocabulary is closed at
+ * runtime too, not only at the type level, so untyped callers (JS, decoded
+ * config) cannot mint capabilities outside it.
+ */
+declare function serviceCan(can: string, verb: ServiceVerb): string;
+/**
+ * Parse a service can back into its action can and service verb.
+ *
+ * `parseServiceCan('claim/evaluate/report')` →
+ * `{ actionCan: 'claim/evaluate', verb: 'report' }`.
+ *
+ * Returns `null` when the last segment is not a known {@link ServiceVerb} or
+ * the prefix is not a valid action-can shape. Plain action cans
+ * (`claim/evaluate`) and generic-tier cans (`flow/diagnose`) both return
+ * `null` — they are not service cans.
+ */
+declare function parseServiceCan(value: string): {
+    actionCan: string;
+    verb: ServiceVerb;
+} | null;
+
 declare function buildServicesFromHandlers(handlers: any): ActionServices;
 
 /**
@@ -523,17 +581,10 @@ interface ClassifyNodeStateInput {
      * legacy behavior (completed = Done).
      */
     completionVerification?: CompletionVerification;
-    /**
-     * Whether this block's action is a repeatable ('many') capability. A
-     * repeatable block that has fired (`completed`) is classified 'Active', not
-     * 'Done' — it is a standing capability, never a finished task. See
-     * `ActionDefinition.cardinality`.
-     */
-    isRepeatable?: boolean;
 }
 declare function classifyBlockerCause(block: unknown, runtime: FlowNodeRuntimeState): FlowAgentBlockerCause | undefined;
-declare function classifyNodeState({ block, runtime, now, pendingInvocationCount, completionVerification, isRepeatable, }: ClassifyNodeStateInput): FlowAgentPublicNodeState;
-declare function snapshotNode(block: unknown, runtime: FlowNodeRuntimeState, now: number, pendingInvocationCount?: number, completionVerification?: CompletionVerification, isRepeatable?: boolean): FlowAgentNodeSnapshot;
+declare function classifyNodeState({ block, runtime, now, pendingInvocationCount, completionVerification }: ClassifyNodeStateInput): FlowAgentPublicNodeState;
+declare function snapshotNode(block: unknown, runtime: FlowNodeRuntimeState, now: number, pendingInvocationCount?: number, completionVerification?: CompletionVerification): FlowAgentNodeSnapshot;
 
 /**
  * Compute an IPFS-compatible CID for arbitrary content.
@@ -662,4 +713,4 @@ declare function createOracleInitFlowTemplate(): {
     nodes: FlowNode[];
 };
 
-export { ActionDefinition, ActionHandlers, type ActionManifest, type ActionManifestEntry, ActionServices, type AddFlowNodeOptions, type BlockConditionInput, type ClassifyNodeStateInput, CompiledBlock, CompiledEdge, CompiledFlow, type CompletionVerification, type CompletionVerificationStatus, type EvaluatorOperator, type ExecuteFlowAgentCoreCommandOptions, type ExecuteQueuedFlowAgentCoreCommandsOptions, FlowAgentBlockerCause, FlowAgentCommand, FlowAgentCommandResult, FlowAgentContext, FlowAgentExecutor, FlowAgentNodeSnapshot, FlowAgentPublicNodeState, type FlowDocumentNode, type FlowDocumentRead, FlowNode, FlowNodeRuntimeState, type FlowVersionString, InvocationStore, LATEST_VERSION, type ManifestProofDeclaration, OutputSchemaField, PROOF_MISSING_CODE, type ProofValidationResult, RunRecordDetails, STEP_COMPLETED_EVENT, STEP_COMPLETED_EVENT_NAME, StoredDelegation, StoredInvocation, type TriggerResolutionContext, UcanDelegationStore, UcanService, VERSION_MANIFEST, type VersionPolicy, addFlowNode, buildBlockConditionsProp, buildServicesFromHandlers, canToType, classifyBlockerCause, classifyNodeState, computeCID, computeJsonCID, createOracleInitFlowTemplate, executeFlowAgentCoreCommand, executeQueuedFlowAgentCoreCommands, generateActionManifest, getAction, getActionByCan, getActionForBlock, getAliasEntries, getAllActions, getAllCanMappings, getEventsForBlock, getOutputSchemaForBlock, getVersionPolicy, hasAction, isTempUcanEnforcementDisabled, isVerifiedCompletion, isVersionAtLeast, oracleInitSurveySchema, readBlocksFromFragment, readFlowDocument, reconcilePendingInvocations, registerAction, removeBlockFromFragment, removeFlowNode, reorderFlowNodes, replaceBlockInFragment, resetStepRuntime, resolveRuntimeRefs, setBlockProps, setFormAnswers, setTempUcanEnforcementDisabled, snapshotNode, swapFlowBlocks, toEvaluatorOperator, typeToCan, updateNodeRuntime, validateActionProof, verifyCompletion, writeCompiledBlocksToFragment, writeRunRecordAndReconcile };
+export { ActionDefinition, ActionHandlers, type ActionManifest, type ActionManifestEntry, ActionServices, type AddFlowNodeOptions, type BlockConditionInput, type ClassifyNodeStateInput, CompiledBlock, CompiledEdge, CompiledFlow, type CompletionVerification, type CompletionVerificationStatus, type EvaluatorOperator, type ExecuteFlowAgentCoreCommandOptions, type ExecuteQueuedFlowAgentCoreCommandsOptions, FlowAgentBlockerCause, FlowAgentCommand, FlowAgentCommandResult, FlowAgentContext, FlowAgentExecutor, FlowAgentNodeSnapshot, FlowAgentPublicNodeState, type FlowDocumentNode, type FlowDocumentRead, FlowNode, FlowNodeRuntimeState, type FlowVersionString, InvocationStore, LATEST_VERSION, type ManifestProofDeclaration, OutputSchemaField, PROOF_MISSING_CODE, type ProofValidationResult, RunRecordDetails, SERVICE_VERBS, STEP_COMPLETED_EVENT, STEP_COMPLETED_EVENT_NAME, type ServiceVerb, StoredDelegation, StoredInvocation, type TriggerResolutionContext, UcanDelegationStore, UcanService, VERSION_MANIFEST, type VersionPolicy, addFlowNode, buildBlockConditionsProp, buildServicesFromHandlers, canToType, classifyBlockerCause, classifyNodeState, computeCID, computeJsonCID, createOracleInitFlowTemplate, executeFlowAgentCoreCommand, executeQueuedFlowAgentCoreCommands, generateActionManifest, getAction, getActionByCan, getActionForBlock, getAliasEntries, getAllActions, getAllCanMappings, getEventsForBlock, getOutputSchemaForBlock, getVersionPolicy, hasAction, isTempUcanEnforcementDisabled, isVerifiedCompletion, isVersionAtLeast, oracleInitSurveySchema, parseServiceCan, readBlocksFromFragment, readFlowDocument, reconcilePendingInvocations, registerAction, removeBlockFromFragment, removeFlowNode, reorderFlowNodes, replaceBlockInFragment, resetStepRuntime, resolveRuntimeRefs, serviceCan, setBlockProps, setFormAnswers, setTempUcanEnforcementDisabled, snapshotNode, swapFlowBlocks, toEvaluatorOperator, typeToCan, updateNodeRuntime, validateActionProof, verifyCompletion, writeCompiledBlocksToFragment, writeRunRecordAndReconcile };

package/dist/core/index.js

@@ -8,12 +8,15 @@ import {
   setFormAnswers,
   swapFlowBlocks,
   updateNodeRuntime
-} from "../chunk-DZMEWZ5Z.js";
+} from "../chunk-RIJGQ4W6.js";
 import {
   FlowAgentService,
   LATEST_VERSION,
+  NODE_CONTEXT_MAP_NAME,
+  NODE_CONTEXT_OVERRIDES_MAP_NAME,
   PROOF_MISSING_CODE,
   RUN_RECORD_AUDIT_TYPE,
+  SERVICE_VERBS,
   STEP_COMPLETED_EVENT,
   STEP_COMPLETED_EVENT_NAME,
   VERSION_MANIFEST,
@@ -66,11 +69,13 @@ import {
   isAuthorized,
   isCapabilityMatch,
   isExternalMutation,
+  isNodeContextRecord,
   isRuntimeRef,
   isTempUcanEnforcementDisabled,
   isVerifiedCompletion,
   isVersionAtLeast,
   mergeCompiledFlows,
+  parseServiceCan,
   planRalphLoopCommands,
   queueAgentCommand,
   queuePendingInvocation,
@@ -93,6 +98,7 @@ import {
   requiredCapabilityForCommand,
   resolveRuntimeRefs,
   resourceMatches,
+  serviceCan,
   setActiveEditor,
   setTempUcanEnforcementDisabled,
   setupFlowFromBaseUcan,
@@ -108,7 +114,7 @@ import {
   verifyCompletion,
   writeCompiledBlocksToFragment,
   writeRunRecordAndReconcile
-} from "../chunk-EULL3QTC.js";
+} from "../chunk-JS7P4DUX.js";
 import {
   computeCID,
   computeJsonCID
@@ -496,8 +502,11 @@ function createOracleInitFlowTemplate() {
 export {
   FlowAgentService,
   LATEST_VERSION,
+  NODE_CONTEXT_MAP_NAME,
+  NODE_CONTEXT_OVERRIDES_MAP_NAME,
   PROOF_MISSING_CODE,
   RUN_RECORD_AUDIT_TYPE,
+  SERVICE_VERBS,
   STEP_COMPLETED_EVENT,
   STEP_COMPLETED_EVENT_NAME,
   VERSION_MANIFEST,
@@ -554,12 +563,14 @@ export {
   isAuthorized,
   isCapabilityMatch,
   isExternalMutation,
+  isNodeContextRecord,
   isRuntimeRef,
   isTempUcanEnforcementDisabled,
   isVerifiedCompletion,
   isVersionAtLeast,
   mergeCompiledFlows,
   oracleInitSurveySchema,
+  parseServiceCan,
   planRalphLoopCommands,
   queueAgentCommand,
   queuePendingInvocation,
@@ -586,6 +597,7 @@ export {
   resetStepRuntime,
   resolveRuntimeRefs,
   resourceMatches,
+  serviceCan,
   setActiveEditor,
   setBlockProps,
   setFormAnswers,

package/dist/core/index.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/core/templates/oracleInitFlow.ts"],"sourcesContent":["import type { FlowMetadata } from '../types/editor';\nimport type { FlowNode } from '../types/authorization';\n\n// ---------------------------------------------------------------------------\n// SurveyJS schema for the oracle configuration form\n// ---------------------------------------------------------------------------\n\nexport const oracleInitSurveySchema = {\n  title: 'Oracle Configuration',\n  description: 'Provide the details needed to initialise a new oracle on the IXO network.',\n  logoPosition: 'right',\n  pages: [\n    {\n      name: 'basicInfo',\n      title: 'Basic Information',\n      elements: [\n        {\n          type: 'text',\n          name: 'projectName',\n          title: 'Project Name',\n          description: 'Used as the folder name — no spaces or special characters.',\n          isRequired: true,\n          validators: [\n            {\n              type: 'regex',\n              text: 'Only lowercase letters, numbers, and hyphens are allowed (no spaces or special characters).',\n              regex: '^[a-z0-9]+(-[a-z0-9]+)*$',\n            },\n          ],\n        },\n        {\n          type: 'text',\n          name: 'pin',\n          title: 'PIN',\n          description: 'A 6-digit PIN used to secure wallet operations.',\n          isRequired: true,\n          inputType: 'password',\n          maxLength: 6,\n          validators: [\n            {\n              type: 'regex',\n              text: 'PIN must be exactly 6 digits.',\n              regex: '^\\\\d{6}$',\n            },\n          ],\n        },\n      ],\n    },\n    {\n      name: 'oracleDetails',\n      title: 'Oracle Details',\n      elements: [\n        {\n          type: 'text',\n          name: 'oracleName',\n          title: 'Oracle Name',\n          isRequired: true,\n        },\n        {\n          type: 'text',\n          name: 'orgName',\n          title: 'Organisation Name',\n          isRequired: true,\n        },\n        {\n          type: 'comment',\n          name: 'description',\n          title: 'Description',\n          isRequired: true,\n        },\n        {\n          type: 'text',\n          name: 'location',\n          title: 'Location',\n          isRequired: true,\n        },\n        {\n          type: 'text',\n          name: 'logoUrl',\n          title: 'Logo URL',\n          isRequired: true,\n          inputType: 'url',\n          validators: [{ type: 'url' }],\n        },\n        {\n          type: 'text',\n          name: 'coverImageUrl',\n          title: 'Cover Image URL',\n          isRequired: true,\n          inputType: 'url',\n          validators: [{ type: 'url' }],\n        },\n      ],\n    },\n    {\n      name: 'serviceConfig',\n      title: 'Service Configuration',\n      elements: [\n        {\n          type: 'text',\n          name: 'apiUrl',\n          title: 'API URL',\n          isRequired: true,\n          inputType: 'url',\n          defaultValue: 'http://localhost:4000',\n          validators: [{ type: 'url' }],\n        },\n        {\n          type: 'text',\n          name: 'price',\n          title: 'Price',\n          description: 'Service price in IXO tokens (minimum 1).',\n          isRequired: true,\n          inputType: 'number',\n          defaultValue: 100,\n          validators: [\n            {\n              type: 'numeric',\n              text: 'Price must be at least 1.',\n              minValue: 1,\n            },\n          ],\n        },\n        {\n          type: 'dropdown',\n          name: 'llmModel',\n          title: 'LLM Model',\n          isRequired: true,\n          choices: [\n            { value: 'kimi-k2.5', text: 'Kimi K2.5' },\n            { value: 'claude-sonnet', text: 'Claude Sonnet' },\n            { value: 'gpt-4o', text: 'GPT-4o' },\n            { value: 'gemini-2.5', text: 'Gemini 2.5' },\n            { value: 'llama-4', text: 'Llama 4' },\n            { value: 'custom', text: 'Custom' },\n          ],\n        },\n        {\n          type: 'comment',\n          name: 'opening',\n          title: 'Opening Message',\n          description: 'The greeting or introduction the agent uses when starting a conversation.',\n          isRequired: false,\n        },\n        {\n          type: 'comment',\n          name: 'communicationStyle',\n          title: 'Communication Style',\n          description: 'How the agent should communicate (e.g. formal, friendly, concise).',\n          isRequired: false,\n        },\n        {\n          type: 'comment',\n          name: 'capabilities',\n          title: 'What can the agent do?',\n          description: 'Describe what this agent is capable of doing for users.',\n          isRequired: false,\n        },\n      ],\n    },\n  ],\n};\n\n// ---------------------------------------------------------------------------\n// Template generator\n// ---------------------------------------------------------------------------\n\nexport function createOracleInitFlowTemplate(): {\n  metadata: FlowMetadata;\n  nodes: FlowNode[];\n} {\n  const metadata: FlowMetadata = {\n    '@context': 'https://schema.ixo.world/flow/v1',\n    _type: 'flow/oracle-init',\n    schema_version: '1.0.0',\n    doc_id: '',\n    title: 'Oracle Init Flow',\n    createdAt: new Date().toISOString(),\n    createdBy: '',\n    flowOwnerDid: '',\n  };\n\n  const nodes: FlowNode[] = [\n    // ------------------------------------------------------------------\n    // [1] Form — collects all oracle configuration\n    // ------------------------------------------------------------------\n    {\n      id: 'oracle-form',\n      type: 'form',\n      props: {\n        title: 'Oracle Configuration',\n        description: 'Enter the details for your new oracle.',\n        icon: 'checklist',\n        surveySchema: JSON.stringify(oracleInitSurveySchema),\n      },\n    },\n\n    // ------------------------------------------------------------------\n    // [2] Skills — skill/MCP configuration\n    // ------------------------------------------------------------------\n    {\n      id: 'oracle-skills',\n      type: 'skills',\n      props: {\n        title: 'Oracle Skills & MCP Servers',\n        description: 'Configure skills and MCP servers for the oracle.',\n        icon: 'tools',\n        skills: '[]',\n        entityDid: '',\n        mcpServers: '[]',\n        status: 'pending',\n      },\n      activationCondition: {\n        upstreamNodeId: 'oracle-form',\n        requiredStatus: 'approved',\n      },\n    },\n\n    // ------------------------------------------------------------------\n    // [3] Action — Generate & Fund Wallet\n    //     Generates a new wallet and funds it in one step.\n    // ------------------------------------------------------------------\n    {\n      id: 'oracle-wallet',\n      type: 'action',\n      props: {\n        title: 'Generate & Fund Wallet',\n        description: 'Generate a new IXO wallet and fund it with tokens.',\n        icon: 'bolt',\n        actionType: 'qi/wallet.generateAndFund',\n        inputs: JSON.stringify({}),\n        requiresConfirmation: '',\n      },\n      activationCondition: {\n        upstreamNodeId: 'oracle-skills',\n        requiredStatus: 'approved',\n      },\n    },\n\n    // ------------------------------------------------------------------\n    // [4] Action — Create Identity (IID + Matrix)\n    //     Creates the on-chain IID document, then registers the Matrix account.\n    // ------------------------------------------------------------------\n    {\n      id: 'oracle-identity',\n      type: 'action',\n      props: {\n        title: 'Create Identity',\n        description: 'Create on-chain DID document and register Matrix account.',\n        icon: 'bolt',\n        actionType: 'qi/identity.create',\n        inputs: JSON.stringify({\n          mnemonic: '{{oracle-wallet.output.mnemonic}}',\n          did: '{{oracle-wallet.output.did}}',\n          address: '{{oracle-wallet.output.address}}',\n          pubKey: '{{oracle-wallet.output.pubKey}}',\n          formAnswers: '{{oracle-form.output.form.answers}}',\n        }),\n        requiresConfirmation: '',\n      },\n      activationCondition: {\n        upstreamNodeId: 'oracle-wallet',\n        requiredStatus: 'approved',\n      },\n    },\n\n    // ------------------------------------------------------------------\n    // [5] Action — Create Oracle Entity\n    //     On-chain entity creation with P-256 encryption key.\n    // ------------------------------------------------------------------\n    {\n      id: 'oracle-entity-create',\n      type: 'action',\n      props: {\n        title: 'Create Oracle Entity',\n        description: 'Create the oracle entity on the IXO network.',\n        icon: 'bolt',\n        actionType: 'qi/entity.createOracle',\n        inputs: JSON.stringify({\n          // Wallet outputs\n          mnemonic: '{{oracle-wallet.output.mnemonic}}',\n          address: '{{oracle-wallet.output.address}}',\n          did: '{{oracle-wallet.output.did}}',\n          pubKey: '{{oracle-wallet.output.pubKey}}',\n          // Matrix outputs (from identity block)\n          matrixAccessToken: '{{oracle-identity.output.matrixAccessToken}}',\n          matrixRoomId: '{{oracle-identity.output.matrixRoomId}}',\n          // Form outputs — whole blob, action parses & destructures\n          formAnswers: '{{oracle-form.output.form.answers}}',\n        }),\n        requiresConfirmation: '',\n      },\n      activationCondition: {\n        upstreamNodeId: 'oracle-identity',\n        requiredStatus: 'approved',\n      },\n    },\n\n    // ------------------------------------------------------------------\n    // [6] Action — Configure Oracle (contract + secrets + config)\n    //     Creates the user↔oracle DM room, encrypts secrets, stores config.\n    // ------------------------------------------------------------------\n    {\n      id: 'oracle-configure',\n      type: 'action',\n      props: {\n        title: 'Configure Oracle',\n        description: 'Contract oracle, encrypt secrets, and store configuration.',\n        icon: 'bolt',\n        actionType: 'qi/oracle.configureOracle',\n        inputs: JSON.stringify({\n          // Contract input\n          oracleEntityDid: '{{oracle-entity-create.output.entityDid}}',\n          // Secrets routing (matrixRoomId comes from contract phase, not inputs)\n          publicKeyMultibase: '{{oracle-entity-create.output.encryptionPublicKeyMultibase}}',\n          verificationMethodId: '{{oracle-entity-create.output.encryptionVerificationMethodId}}',\n          // Fresh mxLogin params\n          matrixHomeServerUrl: '{{oracle-identity.output.matrixHomeServerUrl}}',\n          matrixUsername: '{{oracle-identity.output.matrixUserId}}',\n          // Sensitive plaintext values\n          mnemonic: '{{oracle-wallet.output.mnemonic}}',\n          matrixPassword: '{{oracle-identity.output.matrixPassword}}',\n          matrixRecoveryPhrase: '{{oracle-identity.output.matrixRecoveryPhrase}}',\n          // MCP auth secrets (already JWE-encrypted by skills block FlowDetail)\n          mcpAuthSecrets: '{{oracle-skills.output.mcpAuthSecrets}}',\n          // Skills outputs\n          skills: '{{oracle-skills.output.skills}}',\n          mcpServers: '{{oracle-skills.output.mcpServers}}',\n          // Identifiers\n          matrixUserId: '{{oracle-identity.output.matrixUserId}}',\n          matrixAccountRoomId: '{{oracle-identity.output.matrixRoomId}}',\n          entityDid: '{{oracle-entity-create.output.entityDid}}',\n          oracleAddress: '{{oracle-wallet.output.address}}',\n          oracleDid: '{{oracle-wallet.output.did}}',\n          // Form outputs — whole blob, action parses & destructures\n          formAnswers: '{{oracle-form.output.form.answers}}',\n        }),\n        requiresConfirmation: '',\n      },\n      activationCondition: {\n        upstreamNodeId: 'oracle-entity-create',\n        requiredStatus: 'approved',\n      },\n    },\n\n    // ------------------------------------------------------------------\n    // [7] Action — Deploy Oracle (setup + start)\n    //     Clones repo, writes config, builds, then starts the process.\n    // ------------------------------------------------------------------\n    {\n      id: 'oracle-deploy',\n      type: 'action',\n      props: {\n        title: 'Deploy Oracle',\n        description: 'Set up environment and start the oracle process.',\n        icon: 'bolt',\n        actionType: 'qi/oracle.deploy',\n        inputs: JSON.stringify({\n          entityDid: '{{oracle-entity-create.output.entityDid}}',\n          roomId: '{{oracle-configure.output.userOracleRoomId}}',\n          skills: '{{oracle-skills.output.skills}}',\n          mcpServers: '{{oracle-skills.output.mcpServers}}',\n          mnemonic: '{{oracle-wallet.output.mnemonic}}',\n          matrixPassword: '{{oracle-identity.output.matrixPassword}}',\n          matrixRecoveryPhrase: '{{oracle-identity.output.matrixRecoveryPhrase}}',\n          matrixUsername: '{{oracle-identity.output.matrixUserId}}',\n          matrixAccountRoomId: '{{oracle-identity.output.matrixRoomId}}',\n          freshAccessToken: '{{oracle-configure.output.freshAccessToken}}',\n          openRouterApiKey: '{{oracle-configure.output.openRouterApiKeyPlaintext}}',\n          // Form outputs — whole blob, action parses & destructures\n          formAnswers: '{{oracle-form.output.form.answers}}',\n        }),\n        requiresConfirmation: '',\n      },\n      activationCondition: {\n        upstreamNodeId: 'oracle-configure',\n        requiredStatus: 'approved',\n      },\n    },\n\n    // ------------------------------------------------------------------\n    // [8] Secrets — display credentials and download\n    // ------------------------------------------------------------------\n    {\n      id: 'oracle-secrets',\n      type: 'secrets',\n      props: {\n        title: 'Oracle Credentials',\n        description: 'Download your oracle credentials after setup is complete.',\n        icon: 'key',\n        downloadEndpoint: '',\n        entityDid: '{{oracle-entity-create.output.entityDid}}',\n      },\n      activationCondition: {\n        upstreamNodeId: 'oracle-deploy',\n        requiredStatus: 'approved',\n      },\n    },\n  ];\n\n  return { metadata, nodes };\n}\n"],"mappings":"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","names":[]}
+{"version":3,"sources":["../../src/core/templates/oracleInitFlow.ts"],"sourcesContent":["import type { FlowMetadata } from '../types/editor';\nimport type { FlowNode } from '../types/authorization';\n\n// ---------------------------------------------------------------------------\n// SurveyJS schema for the oracle configuration form\n// ---------------------------------------------------------------------------\n\nexport const oracleInitSurveySchema = {\n  title: 'Oracle Configuration',\n  description: 'Provide the details needed to initialise a new oracle on the IXO network.',\n  logoPosition: 'right',\n  pages: [\n    {\n      name: 'basicInfo',\n      title: 'Basic Information',\n      elements: [\n        {\n          type: 'text',\n          name: 'projectName',\n          title: 'Project Name',\n          description: 'Used as the folder name — no spaces or special characters.',\n          isRequired: true,\n          validators: [\n            {\n              type: 'regex',\n              text: 'Only lowercase letters, numbers, and hyphens are allowed (no spaces or special characters).',\n              regex: '^[a-z0-9]+(-[a-z0-9]+)*$',\n            },\n          ],\n        },\n        {\n          type: 'text',\n          name: 'pin',\n          title: 'PIN',\n          description: 'A 6-digit PIN used to secure wallet operations.',\n          isRequired: true,\n          inputType: 'password',\n          maxLength: 6,\n          validators: [\n            {\n              type: 'regex',\n              text: 'PIN must be exactly 6 digits.',\n              regex: '^\\\\d{6}$',\n            },\n          ],\n        },\n      ],\n    },\n    {\n      name: 'oracleDetails',\n      title: 'Oracle Details',\n      elements: [\n        {\n          type: 'text',\n          name: 'oracleName',\n          title: 'Oracle Name',\n          isRequired: true,\n        },\n        {\n          type: 'text',\n          name: 'orgName',\n          title: 'Organisation Name',\n          isRequired: true,\n        },\n        {\n          type: 'comment',\n          name: 'description',\n          title: 'Description',\n          isRequired: true,\n        },\n        {\n          type: 'text',\n          name: 'location',\n          title: 'Location',\n          isRequired: true,\n        },\n        {\n          type: 'text',\n          name: 'logoUrl',\n          title: 'Logo URL',\n          isRequired: true,\n          inputType: 'url',\n          validators: [{ type: 'url' }],\n        },\n        {\n          type: 'text',\n          name: 'coverImageUrl',\n          title: 'Cover Image URL',\n          isRequired: true,\n          inputType: 'url',\n          validators: [{ type: 'url' }],\n        },\n      ],\n    },\n    {\n      name: 'serviceConfig',\n      title: 'Service Configuration',\n      elements: [\n        {\n          type: 'text',\n          name: 'apiUrl',\n          title: 'API URL',\n          isRequired: true,\n          inputType: 'url',\n          defaultValue: 'http://localhost:4000',\n          validators: [{ type: 'url' }],\n        },\n        {\n          type: 'text',\n          name: 'price',\n          title: 'Price',\n          description: 'Service price in IXO tokens (minimum 1).',\n          isRequired: true,\n          inputType: 'number',\n          defaultValue: 100,\n          validators: [\n            {\n              type: 'numeric',\n              text: 'Price must be at least 1.',\n              minValue: 1,\n            },\n          ],\n        },\n        {\n          type: 'dropdown',\n          name: 'llmModel',\n          title: 'LLM Model',\n          isRequired: true,\n          choices: [\n            { value: 'kimi-k2.5', text: 'Kimi K2.5' },\n            { value: 'claude-sonnet', text: 'Claude Sonnet' },\n            { value: 'gpt-4o', text: 'GPT-4o' },\n            { value: 'gemini-2.5', text: 'Gemini 2.5' },\n            { value: 'llama-4', text: 'Llama 4' },\n            { value: 'custom', text: 'Custom' },\n          ],\n        },\n        {\n          type: 'comment',\n          name: 'opening',\n          title: 'Opening Message',\n          description: 'The greeting or introduction the agent uses when starting a conversation.',\n          isRequired: false,\n        },\n        {\n          type: 'comment',\n          name: 'communicationStyle',\n          title: 'Communication Style',\n          description: 'How the agent should communicate (e.g. formal, friendly, concise).',\n          isRequired: false,\n        },\n        {\n          type: 'comment',\n          name: 'capabilities',\n          title: 'What can the agent do?',\n          description: 'Describe what this agent is capable of doing for users.',\n          isRequired: false,\n        },\n      ],\n    },\n  ],\n};\n\n// ---------------------------------------------------------------------------\n// Template generator\n// ---------------------------------------------------------------------------\n\nexport function createOracleInitFlowTemplate(): {\n  metadata: FlowMetadata;\n  nodes: FlowNode[];\n} {\n  const metadata: FlowMetadata = {\n    '@context': 'https://schema.ixo.world/flow/v1',\n    _type: 'flow/oracle-init',\n    schema_version: '1.0.0',\n    doc_id: '',\n    title: 'Oracle Init Flow',\n    createdAt: new Date().toISOString(),\n    createdBy: '',\n    flowOwnerDid: '',\n  };\n\n  const nodes: FlowNode[] = [\n    // ------------------------------------------------------------------\n    // [1] Form — collects all oracle configuration\n    // ------------------------------------------------------------------\n    {\n      id: 'oracle-form',\n      type: 'form',\n      props: {\n        title: 'Oracle Configuration',\n        description: 'Enter the details for your new oracle.',\n        icon: 'checklist',\n        surveySchema: JSON.stringify(oracleInitSurveySchema),\n      },\n    },\n\n    // ------------------------------------------------------------------\n    // [2] Skills — skill/MCP configuration\n    // ------------------------------------------------------------------\n    {\n      id: 'oracle-skills',\n      type: 'skills',\n      props: {\n        title: 'Oracle Skills & MCP Servers',\n        description: 'Configure skills and MCP servers for the oracle.',\n        icon: 'tools',\n        skills: '[]',\n        entityDid: '',\n        mcpServers: '[]',\n        status: 'pending',\n      },\n      activationCondition: {\n        upstreamNodeId: 'oracle-form',\n        requiredStatus: 'approved',\n      },\n    },\n\n    // ------------------------------------------------------------------\n    // [3] Action — Generate & Fund Wallet\n    //     Generates a new wallet and funds it in one step.\n    // ------------------------------------------------------------------\n    {\n      id: 'oracle-wallet',\n      type: 'action',\n      props: {\n        title: 'Generate & Fund Wallet',\n        description: 'Generate a new IXO wallet and fund it with tokens.',\n        icon: 'bolt',\n        actionType: 'qi/wallet.generateAndFund',\n        inputs: JSON.stringify({}),\n        requiresConfirmation: '',\n      },\n      activationCondition: {\n        upstreamNodeId: 'oracle-skills',\n        requiredStatus: 'approved',\n      },\n    },\n\n    // ------------------------------------------------------------------\n    // [4] Action — Create Identity (IID + Matrix)\n    //     Creates the on-chain IID document, then registers the Matrix account.\n    // ------------------------------------------------------------------\n    {\n      id: 'oracle-identity',\n      type: 'action',\n      props: {\n        title: 'Create Identity',\n        description: 'Create on-chain DID document and register Matrix account.',\n        icon: 'bolt',\n        actionType: 'qi/identity.create',\n        inputs: JSON.stringify({\n          mnemonic: '{{oracle-wallet.output.mnemonic}}',\n          did: '{{oracle-wallet.output.did}}',\n          address: '{{oracle-wallet.output.address}}',\n          pubKey: '{{oracle-wallet.output.pubKey}}',\n          formAnswers: '{{oracle-form.output.form.answers}}',\n        }),\n        requiresConfirmation: '',\n      },\n      activationCondition: {\n        upstreamNodeId: 'oracle-wallet',\n        requiredStatus: 'approved',\n      },\n    },\n\n    // ------------------------------------------------------------------\n    // [5] Action — Create Oracle Entity\n    //     On-chain entity creation with P-256 encryption key.\n    // ------------------------------------------------------------------\n    {\n      id: 'oracle-entity-create',\n      type: 'action',\n      props: {\n        title: 'Create Oracle Entity',\n        description: 'Create the oracle entity on the IXO network.',\n        icon: 'bolt',\n        actionType: 'qi/entity.createOracle',\n        inputs: JSON.stringify({\n          // Wallet outputs\n          mnemonic: '{{oracle-wallet.output.mnemonic}}',\n          address: '{{oracle-wallet.output.address}}',\n          did: '{{oracle-wallet.output.did}}',\n          pubKey: '{{oracle-wallet.output.pubKey}}',\n          // Matrix outputs (from identity block)\n          matrixAccessToken: '{{oracle-identity.output.matrixAccessToken}}',\n          matrixRoomId: '{{oracle-identity.output.matrixRoomId}}',\n          // Form outputs — whole blob, action parses & destructures\n          formAnswers: '{{oracle-form.output.form.answers}}',\n        }),\n        requiresConfirmation: '',\n      },\n      activationCondition: {\n        upstreamNodeId: 'oracle-identity',\n        requiredStatus: 'approved',\n      },\n    },\n\n    // ------------------------------------------------------------------\n    // [6] Action — Configure Oracle (contract + secrets + config)\n    //     Creates the user↔oracle DM room, encrypts secrets, stores config.\n    // ------------------------------------------------------------------\n    {\n      id: 'oracle-configure',\n      type: 'action',\n      props: {\n        title: 'Configure Oracle',\n        description: 'Contract oracle, encrypt secrets, and store configuration.',\n        icon: 'bolt',\n        actionType: 'qi/oracle.configureOracle',\n        inputs: JSON.stringify({\n          // Contract input\n          oracleEntityDid: '{{oracle-entity-create.output.entityDid}}',\n          // Secrets routing (matrixRoomId comes from contract phase, not inputs)\n          publicKeyMultibase: '{{oracle-entity-create.output.encryptionPublicKeyMultibase}}',\n          verificationMethodId: '{{oracle-entity-create.output.encryptionVerificationMethodId}}',\n          // Fresh mxLogin params\n          matrixHomeServerUrl: '{{oracle-identity.output.matrixHomeServerUrl}}',\n          matrixUsername: '{{oracle-identity.output.matrixUserId}}',\n          // Sensitive plaintext values\n          mnemonic: '{{oracle-wallet.output.mnemonic}}',\n          matrixPassword: '{{oracle-identity.output.matrixPassword}}',\n          matrixRecoveryPhrase: '{{oracle-identity.output.matrixRecoveryPhrase}}',\n          // MCP auth secrets (already JWE-encrypted by skills block FlowDetail)\n          mcpAuthSecrets: '{{oracle-skills.output.mcpAuthSecrets}}',\n          // Skills outputs\n          skills: '{{oracle-skills.output.skills}}',\n          mcpServers: '{{oracle-skills.output.mcpServers}}',\n          // Identifiers\n          matrixUserId: '{{oracle-identity.output.matrixUserId}}',\n          matrixAccountRoomId: '{{oracle-identity.output.matrixRoomId}}',\n          entityDid: '{{oracle-entity-create.output.entityDid}}',\n          oracleAddress: '{{oracle-wallet.output.address}}',\n          oracleDid: '{{oracle-wallet.output.did}}',\n          // Form outputs — whole blob, action parses & destructures\n          formAnswers: '{{oracle-form.output.form.answers}}',\n        }),\n        requiresConfirmation: '',\n      },\n      activationCondition: {\n        upstreamNodeId: 'oracle-entity-create',\n        requiredStatus: 'approved',\n      },\n    },\n\n    // ------------------------------------------------------------------\n    // [7] Action — Deploy Oracle (setup + start)\n    //     Clones repo, writes config, builds, then starts the process.\n    // ------------------------------------------------------------------\n    {\n      id: 'oracle-deploy',\n      type: 'action',\n      props: {\n        title: 'Deploy Oracle',\n        description: 'Set up environment and start the oracle process.',\n        icon: 'bolt',\n        actionType: 'qi/oracle.deploy',\n        inputs: JSON.stringify({\n          entityDid: '{{oracle-entity-create.output.entityDid}}',\n          roomId: '{{oracle-configure.output.userOracleRoomId}}',\n          skills: '{{oracle-skills.output.skills}}',\n          mcpServers: '{{oracle-skills.output.mcpServers}}',\n          mnemonic: '{{oracle-wallet.output.mnemonic}}',\n          matrixPassword: '{{oracle-identity.output.matrixPassword}}',\n          matrixRecoveryPhrase: '{{oracle-identity.output.matrixRecoveryPhrase}}',\n          matrixUsername: '{{oracle-identity.output.matrixUserId}}',\n          matrixAccountRoomId: '{{oracle-identity.output.matrixRoomId}}',\n          freshAccessToken: '{{oracle-configure.output.freshAccessToken}}',\n          openRouterApiKey: '{{oracle-configure.output.openRouterApiKeyPlaintext}}',\n          // Form outputs — whole blob, action parses & destructures\n          formAnswers: '{{oracle-form.output.form.answers}}',\n        }),\n        requiresConfirmation: '',\n      },\n      activationCondition: {\n        upstreamNodeId: 'oracle-configure',\n        requiredStatus: 'approved',\n      },\n    },\n\n    // ------------------------------------------------------------------\n    // [8] Secrets — display credentials and download\n    // ------------------------------------------------------------------\n    {\n      id: 'oracle-secrets',\n      type: 'secrets',\n      props: {\n        title: 'Oracle Credentials',\n        description: 'Download your oracle credentials after setup is complete.',\n        icon: 'key',\n        downloadEndpoint: '',\n        entityDid: '{{oracle-entity-create.output.entityDid}}',\n      },\n      activationCondition: {\n        upstreamNodeId: 'oracle-deploy',\n        requiredStatus: 'approved',\n      },\n    },\n  ];\n\n  return { metadata, nodes };\n}\n"],"mappings":"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","names":[]}

package/dist/{graphql-client-D9Xzs0mM.d.ts → graphql-client-TT4tb5P6.d.ts}

@@ -1,5 +1,5 @@
 import * as _blocknote_core from '@blocknote/core';
-import { ao as IxoBlockProps, l as IxoEditorOptions, a5 as IxoEditorType, p as IxoCollaborativeEditorOptions, w as BlocknoteHandlers, y as BlockRequirements, av as UnlMapConfig, ar as DynamicListDataProvider, as as DynamicListPanelRenderer, at as DomainCardRenderer, a3 as Translate, k as DelegationGrant } from './index-C70b-Yd0.js';
+import { ap as IxoBlockProps, l as IxoEditorOptions, a5 as IxoEditorType, p as IxoCollaborativeEditorOptions, w as BlocknoteHandlers, y as BlockRequirements, aw as UnlMapConfig, as as DynamicListDataProvider, at as DynamicListPanelRenderer, au as DomainCardRenderer, a3 as Translate, k as DelegationGrant } from './index-D0S6jY7O.js';
 import { Text, Doc, Map, Array as Array$1 } from 'yjs';
 import React__default from 'react';
 import * as _tiptap_core from '@tiptap/core';

package/dist/{index-C70b-Yd0.d.ts → index-D0S6jY7O.d.ts}

@@ -4910,6 +4910,16 @@ interface ActionReadBackMetadata {
     };
     [key: string]: any;
 }
+/**
+ * One advisory report from a contracted helper oracle, landed by the flow
+ * manager under `runtime[blockId].serviceReports[serviceRole]`.
+ */
+interface NodeServiceReport {
+    output: Record<string, unknown>;
+    oracleDid: string;
+    invocationId: string;
+    receivedAt: number;
+}
 interface FlowNodeRuntimeState {
     state?: NodeState;
     output?: Record<string, any>;
@@ -4968,6 +4978,13 @@ interface FlowNodeRuntimeState {
     /** Per-instance user-typed values that need to survive reload (e.g. encrypted API keys
      *  the user entered into a form-style action block). Action blocks own the shape. */
     userInputs?: Record<string, any>;
+    /**
+     * Advisory oracle reports written by the flow manager, keyed by service
+     * role (e.g. 'evaluation-report'). Service receipts are NOT execution
+     * results: they never touch the node's own state/output and are optional
+     * input to the human decision, not a blocker.
+     */
+    serviceReports?: Record<string, NodeServiceReport>;
     claimId?: string;
     submittedByDid?: DID;
     evaluationStatus?: EvaluationStatus;
@@ -5492,6 +5509,18 @@ interface IxoEditorType<BSchema extends IxoBlockSchema = IxoBlockSchema, ISchema
      * @internal
      */
     _yRuntime?: Map<any>;
+    /**
+     * Y.Map for per-node semantic context records written by the flow manager
+     * (keyed by block/node id, see NodeContextRecord)
+     * @internal
+     */
+    _yNodeContext?: Map<any>;
+    /**
+     * Y.Map for per-field human overrides on node context records, keyed
+     * `${nodeId}:${field}` (see NODE_CONTEXT_OVERRIDES_MAP_NAME)
+     * @internal
+     */
+    _yNodeContextOverrides?: Map<any>;
     /**
      * Y.Map for storing capability delegations
      * @internal
@@ -5856,4 +5885,4 @@ interface IxoEditorConfig {
     tableHandles: boolean;
 }
 
-export { type MatrixRoom as $, AuthzExecActionTypes as A, BlocknoteProvider as B, type VoteResponse as C, type DelegationChainValidationResult as D, type VoteInfo as E, type Vote as F, type User as G, type Addr as H, type InvocationStore as I, type Uint128 as J, type Expiration as K, type Status as L, type Threshold as M, type Votes as N, type CosmosMsgForEmpty as O, type ProposalResponse as P, type ProposalAction as Q, type ListProtocolDeedsWithTemplatesParams as R, type StoredDelegation as S, type Timestamp as T, type UcanDelegationStore as U, ValidatorActionType as V, type ProtocolDeedWithTemplates as W, type ProtocolTemplateSummary as X, type ImportProtocolTemplatesToSpaceParams as Y, type ImportProtocolTemplateResult as Z, type MatrixPrivacySettings as _, createMemoryUcanDelegationStore as a, type MatrixSpace as a0, type MatrixSubspace as a1, type MatrixSpaceStructure as a2, type Translate as a3, type FlowNodeRuntimeState as a4, type IxoEditorType as a5, type FlowMetadata as a6, type FlowNode as a7, type DID as a8, type ClaimCollectionURI as a9, type EvaluationStatus as aa, type LinkedClaim as ab, type FlowNodeAuthzExtension as ac, type NodeState as ad, type ReadBackTerminalState as ae, type ActionReadBackMetadata as af, type FlowNodeBase as ag, type InvocationRequest as ah, type InvocationResult as ai, type ExecutionWithInvocationResult as aj, type FindProofsResult as ak, type CreateRootDelegationParams as al, type CreateDelegationParams as am, type CreateInvocationParams as an, type IxoBlockProps as ao, type VisualizationRenderer as ap, type DynamicListData as aq, type DynamicListDataProvider as ar, type DynamicListPanelRenderer as as, type DomainCardRenderer as at, type DomainCardData as au, type UnlMapConfig as av, createInvocationStore as b, createUcanDelegationStore as c, createMemoryInvocationStore as d, createUcanService as e, type UcanService as f, type UcanServiceConfig as g, type UcanServiceHandlers as h, type UcanCapability as i, type StoredInvocation as j, type DelegationGrant as k, type IxoEditorOptions as l, type IxoEditorTheme as m, type IxoEditorConfig as n, type IxoCollaborativeUser as o, type IxoCollaborativeEditorOptions as p, blockSpecs as q, getExtraSlashMenuItems as r, useBlocknoteHandlers as s, useTranslate as t, useBlocknoteContext as u, StakeType as v, type BlocknoteHandlers as w, type BlocknoteContextValue as x, type BlockRequirements as y, type SingleChoiceProposal as z };
+export { type MatrixRoom as $, AuthzExecActionTypes as A, BlocknoteProvider as B, type VoteResponse as C, type DelegationChainValidationResult as D, type VoteInfo as E, type Vote as F, type User as G, type Addr as H, type InvocationStore as I, type Uint128 as J, type Expiration as K, type Status as L, type Threshold as M, type Votes as N, type CosmosMsgForEmpty as O, type ProposalResponse as P, type ProposalAction as Q, type ListProtocolDeedsWithTemplatesParams as R, type StoredDelegation as S, type Timestamp as T, type UcanDelegationStore as U, ValidatorActionType as V, type ProtocolDeedWithTemplates as W, type ProtocolTemplateSummary as X, type ImportProtocolTemplatesToSpaceParams as Y, type ImportProtocolTemplateResult as Z, type MatrixPrivacySettings as _, createMemoryUcanDelegationStore as a, type MatrixSpace as a0, type MatrixSubspace as a1, type MatrixSpaceStructure as a2, type Translate as a3, type FlowNodeRuntimeState as a4, type IxoEditorType as a5, type FlowMetadata as a6, type FlowNode as a7, type DID as a8, type ClaimCollectionURI as a9, type EvaluationStatus as aa, type LinkedClaim as ab, type FlowNodeAuthzExtension as ac, type NodeServiceReport as ad, type NodeState as ae, type ReadBackTerminalState as af, type ActionReadBackMetadata as ag, type FlowNodeBase as ah, type InvocationRequest as ai, type InvocationResult as aj, type ExecutionWithInvocationResult as ak, type FindProofsResult as al, type CreateRootDelegationParams as am, type CreateDelegationParams as an, type CreateInvocationParams as ao, type IxoBlockProps as ap, type VisualizationRenderer as aq, type DynamicListData as ar, type DynamicListDataProvider as as, type DynamicListPanelRenderer as at, type DomainCardRenderer as au, type DomainCardData as av, type UnlMapConfig as aw, createInvocationStore as b, createUcanDelegationStore as c, createMemoryInvocationStore as d, createUcanService as e, type UcanService as f, type UcanServiceConfig as g, type UcanServiceHandlers as h, type UcanCapability as i, type StoredInvocation as j, type DelegationGrant as k, type IxoEditorOptions as l, type IxoEditorTheme as m, type IxoEditorConfig as n, type IxoCollaborativeUser as o, type IxoCollaborativeEditorOptions as p, blockSpecs as q, getExtraSlashMenuItems as r, useBlocknoteHandlers as s, useTranslate as t, useBlocknoteContext as u, StakeType as v, type BlocknoteHandlers as w, type BlocknoteContextValue as x, type BlockRequirements as y, type SingleChoiceProposal as z };

package/dist/index.d.ts

@@ -1,7 +1,7 @@
-export { q as ApiRequestBlockProps, h as ApiRequestBlockSpec, A as AuthorizationTab, d as AuthorizationTabState, B as BlockPresenceUser, i as CheckboxBlockProps, g as CheckboxBlockSpec, C as CoverImage, c as CoverImageProps, D as DevUcanGrantButton, v as Entity, w as EntityResponse, f as EntitySigningSetup, x as EntityVariables, E as EvaluationTab, e as EvaluationTabState, F as FlowPermissionsPanel, n as FlowStepRefProps, l as FlowStepRefSpec, G as GrantPermissionModal, y as GraphQLClient, M as GraphQLRequest, J as GraphQLResponse, H as HttpMethod, I as IxoEditor, b as IxoEditorProps, K as KeyValuePair, k as ListBlockProps, j as ListBlockSettings, L as ListBlockSpec, O as OverviewBlock, o as OverviewBlockProps, p as ProposalBlockProps, P as ProposalBlockSpec, t as getEntity, m as inlineContentSpecs, z as ixoGraphQLClient, r as useBlockPresence, a as useCreateCollaborativeIxoEditor, u as useCreateIxoEditor, s as useTrackBlockFocus } from './graphql-client-D9Xzs0mM.js';
-export { A as AuthorizationResult, B as BaseUcanFlow, X as BuildFlowAgentContextParams, v as CompiledFlow, C as CompilerRegistry, E as ExecuteNodeParams, f as ExecutionContext, d as ExecutionOutcome, Y as FlowAgentActor, Z as FlowAgentCommand, _ as FlowAgentCommandResult, $ as FlowAgentContext, a0 as FlowAgentExecutor, a1 as FlowAgentLease, a2 as FlowAgentNodeSnapshot, a3 as FlowAgentPublicNodeState, x as FlowAgentService, a4 as FlowAgentTickResult, u as FlowCapability, F as FlowRuntimeStateManager, w as FlowStrategy, M as MergeResult, N as NodeActionResult, R as ReadFlowOptions, q as ReadFlowResult, t as ReadableEditor, S as SetupFlowOptions, p as SetupFlowResult, y as acquireFlowAgentLease, z as appendAgentLedgerEvent, a as buildAuthzFromProps, D as buildFlowAgentContext, b as buildFlowNodeFromBlock, G as cleanupExpiredFlowAgentLeases, l as compileBaseUcanFlow, H as createAgentCommand, c as createRuntimeStateManager, o as decompileToBaseUcanFlow, I as evaluateFlowAgentPolicy, e as executeNode, J as executeQueuedAgentCommands, k as getActiveEditor, K as getFlowAgentMaps, i as isAuthorized, n as mergeCompiledFlows, L as planRalphLoopCommands, O as queueAgentCommand, P as readAgentLedgerEvents, m as readCompiledFlowFromYDoc, h as readFlow, r as readFlowAsBaseUcan, g as readFlowFromEditor, Q as readQueuedAgentCommands, T as releaseFlowAgentLease, j as setActiveEditor, s as setupFlowFromBaseUcan, U as tickFlowAgent, V as validateAgentCommand, W as validateFlowAgentLease } from './store-BS2HJhJR.js';
+export { q as ApiRequestBlockProps, h as ApiRequestBlockSpec, A as AuthorizationTab, d as AuthorizationTabState, B as BlockPresenceUser, i as CheckboxBlockProps, g as CheckboxBlockSpec, C as CoverImage, c as CoverImageProps, D as DevUcanGrantButton, v as Entity, w as EntityResponse, f as EntitySigningSetup, x as EntityVariables, E as EvaluationTab, e as EvaluationTabState, F as FlowPermissionsPanel, n as FlowStepRefProps, l as FlowStepRefSpec, G as GrantPermissionModal, y as GraphQLClient, M as GraphQLRequest, J as GraphQLResponse, H as HttpMethod, I as IxoEditor, b as IxoEditorProps, K as KeyValuePair, k as ListBlockProps, j as ListBlockSettings, L as ListBlockSpec, O as OverviewBlock, o as OverviewBlockProps, p as ProposalBlockProps, P as ProposalBlockSpec, t as getEntity, m as inlineContentSpecs, z as ixoGraphQLClient, r as useBlockPresence, a as useCreateCollaborativeIxoEditor, u as useCreateIxoEditor, s as useTrackBlockFocus } from './graphql-client-TT4tb5P6.js';
+export { A as AuthorizationResult, B as BaseUcanFlow, X as BuildFlowAgentContextParams, v as CompiledFlow, C as CompilerRegistry, E as ExecuteNodeParams, f as ExecutionContext, d as ExecutionOutcome, Y as FlowAgentActor, Z as FlowAgentCommand, _ as FlowAgentCommandResult, $ as FlowAgentContext, a0 as FlowAgentExecutor, a1 as FlowAgentLease, a2 as FlowAgentNodeSnapshot, a3 as FlowAgentPublicNodeState, x as FlowAgentService, a4 as FlowAgentTickResult, u as FlowCapability, F as FlowRuntimeStateManager, w as FlowStrategy, M as MergeResult, N as NodeActionResult, R as ReadFlowOptions, q as ReadFlowResult, t as ReadableEditor, S as SetupFlowOptions, p as SetupFlowResult, y as acquireFlowAgentLease, z as appendAgentLedgerEvent, a as buildAuthzFromProps, D as buildFlowAgentContext, b as buildFlowNodeFromBlock, G as cleanupExpiredFlowAgentLeases, l as compileBaseUcanFlow, H as createAgentCommand, c as createRuntimeStateManager, o as decompileToBaseUcanFlow, I as evaluateFlowAgentPolicy, e as executeNode, J as executeQueuedAgentCommands, k as getActiveEditor, K as getFlowAgentMaps, i as isAuthorized, n as mergeCompiledFlows, L as planRalphLoopCommands, O as queueAgentCommand, P as readAgentLedgerEvents, m as readCompiledFlowFromYDoc, h as readFlow, r as readFlowAsBaseUcan, g as readFlowFromEditor, Q as readQueuedAgentCommands, T as releaseFlowAgentLease, j as setActiveEditor, s as setupFlowFromBaseUcan, U as tickFlowAgent, V as validateAgentCommand, W as validateFlowAgentLease } from './store-BIt_Vdjw.js';
 export { Block, BlockNoteEditor, BlockNoteSchema, DefaultBlockSchema, DefaultInlineContentSchema, DefaultStyleSchema, PartialBlock } from '@blocknote/core';
-export { H as Addr, A as AuthzExecActionTypes, y as BlockRequirements, x as BlocknoteContextValue, w as BlocknoteHandlers, B as BlocknoteProvider, O as CosmosMsgForEmpty, D as DelegationChainValidationResult, k as DelegationGrant, K as Expiration, Z as ImportProtocolTemplateResult, Y as ImportProtocolTemplatesToSpaceParams, I as InvocationStore, p as IxoCollaborativeEditorOptions, o as IxoCollaborativeUser, n as IxoEditorConfig, l as IxoEditorOptions, m as IxoEditorTheme, R as ListProtocolDeedsWithTemplatesParams, _ as MatrixPrivacySettings, $ as MatrixRoom, a0 as MatrixSpace, a2 as MatrixSpaceStructure, a1 as MatrixSubspace, Q as ProposalAction, P as ProposalResponse, W as ProtocolDeedWithTemplates, X as ProtocolTemplateSummary, z as SingleChoiceProposal, v as StakeType, v as StakeTypeValue, L as Status, S as StoredDelegation, j as StoredInvocation, M as Threshold, T as Timestamp, a3 as Translate, i as UcanCapability, U as UcanDelegationStore, f as UcanService, g as UcanServiceConfig, h as UcanServiceHandlers, J as Uint128, G as User, V as ValidatorActionType, F as Vote, E as VoteInfo, C as VoteResponse, N as Votes, q as blockSpecs, b as createInvocationStore, d as createMemoryInvocationStore, a as createMemoryUcanDelegationStore, c as createUcanDelegationStore, e as createUcanService, r as getExtraSlashMenuItems, u as useBlocknoteContext, s as useBlocknoteHandlers, t as useTranslate } from './index-C70b-Yd0.js';
+export { H as Addr, A as AuthzExecActionTypes, y as BlockRequirements, x as BlocknoteContextValue, w as BlocknoteHandlers, B as BlocknoteProvider, O as CosmosMsgForEmpty, D as DelegationChainValidationResult, k as DelegationGrant, K as Expiration, Z as ImportProtocolTemplateResult, Y as ImportProtocolTemplatesToSpaceParams, I as InvocationStore, p as IxoCollaborativeEditorOptions, o as IxoCollaborativeUser, n as IxoEditorConfig, l as IxoEditorOptions, m as IxoEditorTheme, R as ListProtocolDeedsWithTemplatesParams, _ as MatrixPrivacySettings, $ as MatrixRoom, a0 as MatrixSpace, a2 as MatrixSpaceStructure, a1 as MatrixSubspace, Q as ProposalAction, P as ProposalResponse, W as ProtocolDeedWithTemplates, X as ProtocolTemplateSummary, z as SingleChoiceProposal, v as StakeType, v as StakeTypeValue, L as Status, S as StoredDelegation, j as StoredInvocation, M as Threshold, T as Timestamp, a3 as Translate, i as UcanCapability, U as UcanDelegationStore, f as UcanService, g as UcanServiceConfig, h as UcanServiceHandlers, J as Uint128, G as User, V as ValidatorActionType, F as Vote, E as VoteInfo, C as VoteResponse, N as Votes, q as blockSpecs, b as createInvocationStore, d as createMemoryInvocationStore, a as createMemoryUcanDelegationStore, c as createUcanDelegationStore, e as createUcanService, r as getExtraSlashMenuItems, u as useBlocknoteContext, s as useBlocknoteHandlers, t as useTranslate } from './index-D0S6jY7O.js';
 export { CloneDocumentResult, cloneDocument } from '@ixo/matrix-crdt';
 import 'yjs';
 import 'react';

package/dist/index.js

@@ -30,8 +30,8 @@ import {
   useCreateIxoEditor,
   useTrackBlockFocus,
   useTranslate
-} from "./chunk-QXSJ2QRD.js";
-import "./chunk-DZMEWZ5Z.js";
+} from "./chunk-ETSJMVZ7.js";
+import "./chunk-RIJGQ4W6.js";
 import {
   FlowAgentService,
   acquireFlowAgentLease,
@@ -70,7 +70,7 @@ import {
   tickFlowAgent,
   validateAgentCommand,
   validateFlowAgentLease
-} from "./chunk-EULL3QTC.js";
+} from "./chunk-JS7P4DUX.js";
 
 // src/index.ts
 import { cloneDocument } from "@ixo/matrix-crdt";

package/dist/mantine/index.d.ts

@@ -1,9 +1,10 @@
-export { q as ApiRequestBlockProps, h as ApiRequestBlockSpec, A as AuthorizationTab, d as AuthorizationTabState, B as BlockPresenceUser, i as CheckboxBlockProps, g as CheckboxBlockSpec, C as CoverImage, c as CoverImageProps, D as DevUcanGrantButton, Q as DropPosition, v as Entity, w as EntityResponse, f as EntitySigningSetup, x as EntityVariables, E as EvaluationTab, e as EvaluationTabState, N as ExternalDropZone, F as FlowPermissionsPanel, n as FlowStepRefProps, l as FlowStepRefSpec, G as GrantPermissionModal, y as GraphQLClient, M as GraphQLRequest, J as GraphQLResponse, H as HttpMethod, I as IxoEditor, b as IxoEditorProps, K as KeyValuePair, k as ListBlockProps, j as ListBlockSettings, L as ListBlockSpec, O as OverviewBlock, o as OverviewBlockProps, p as ProposalBlockProps, P as ProposalBlockSpec, t as getEntity, m as inlineContentSpecs, z as ixoGraphQLClient, r as useBlockPresence, a as useCreateCollaborativeIxoEditor, u as useCreateIxoEditor, s as useTrackBlockFocus } from '../graphql-client-D9Xzs0mM.js';
+export { q as ApiRequestBlockProps, h as ApiRequestBlockSpec, A as AuthorizationTab, d as AuthorizationTabState, B as BlockPresenceUser, i as CheckboxBlockProps, g as CheckboxBlockSpec, C as CoverImage, c as CoverImageProps, D as DevUcanGrantButton, Q as DropPosition, v as Entity, w as EntityResponse, f as EntitySigningSetup, x as EntityVariables, E as EvaluationTab, e as EvaluationTabState, N as ExternalDropZone, F as FlowPermissionsPanel, n as FlowStepRefProps, l as FlowStepRefSpec, G as GrantPermissionModal, y as GraphQLClient, M as GraphQLRequest, J as GraphQLResponse, H as HttpMethod, I as IxoEditor, b as IxoEditorProps, K as KeyValuePair, k as ListBlockProps, j as ListBlockSettings, L as ListBlockSpec, O as OverviewBlock, o as OverviewBlockProps, p as ProposalBlockProps, P as ProposalBlockSpec, t as getEntity, m as inlineContentSpecs, z as ixoGraphQLClient, r as useBlockPresence, a as useCreateCollaborativeIxoEditor, u as useCreateIxoEditor, s as useTrackBlockFocus } from '../graphql-client-TT4tb5P6.js';
 import React__default, { PropsWithChildren } from 'react';
-import { ao as IxoBlockProps, a5 as IxoEditorType, w as BlocknoteHandlers, a4 as FlowNodeRuntimeState } from '../index-C70b-Yd0.js';
-export { H as Addr, A as AuthzExecActionTypes, y as BlockRequirements, x as BlocknoteContextValue, B as BlocknoteProvider, O as CosmosMsgForEmpty, au as DomainCardData, at as DomainCardRenderer, aq as DynamicListData, ar as DynamicListDataProvider, as as DynamicListPanelRenderer, K as Expiration, Z as ImportProtocolTemplateResult, Y as ImportProtocolTemplatesToSpaceParams, p as IxoCollaborativeEditorOptions, o as IxoCollaborativeUser, n as IxoEditorConfig, l as IxoEditorOptions, m as IxoEditorTheme, R as ListProtocolDeedsWithTemplatesParams, _ as MatrixPrivacySettings, $ as MatrixRoom, a0 as MatrixSpace, a2 as MatrixSpaceStructure, a1 as MatrixSubspace, Q as ProposalAction, P as ProposalResponse, W as ProtocolDeedWithTemplates, X as ProtocolTemplateSummary, z as SingleChoiceProposal, v as StakeType, v as StakeTypeValue, L as Status, M as Threshold, T as Timestamp, J as Uint128, G as User, V as ValidatorActionType, ap as VisualizationRenderer, F as Vote, E as VoteInfo, C as VoteResponse, N as Votes, q as blockSpecs, r as getExtraSlashMenuItems, u as useBlocknoteContext, s as useBlocknoteHandlers } from '../index-C70b-Yd0.js';
+import { ap as IxoBlockProps, a5 as IxoEditorType, w as BlocknoteHandlers, a4 as FlowNodeRuntimeState } from '../index-D0S6jY7O.js';
+export { H as Addr, A as AuthzExecActionTypes, y as BlockRequirements, x as BlocknoteContextValue, B as BlocknoteProvider, O as CosmosMsgForEmpty, av as DomainCardData, au as DomainCardRenderer, ar as DynamicListData, as as DynamicListDataProvider, at as DynamicListPanelRenderer, K as Expiration, Z as ImportProtocolTemplateResult, Y as ImportProtocolTemplatesToSpaceParams, p as IxoCollaborativeEditorOptions, o as IxoCollaborativeUser, n as IxoEditorConfig, l as IxoEditorOptions, m as IxoEditorTheme, R as ListProtocolDeedsWithTemplatesParams, _ as MatrixPrivacySettings, $ as MatrixRoom, a0 as MatrixSpace, a2 as MatrixSpaceStructure, a1 as MatrixSubspace, Q as ProposalAction, P as ProposalResponse, W as ProtocolDeedWithTemplates, X as ProtocolTemplateSummary, z as SingleChoiceProposal, v as StakeType, v as StakeTypeValue, L as Status, M as Threshold, T as Timestamp, J as Uint128, G as User, V as ValidatorActionType, aq as VisualizationRenderer, F as Vote, E as VoteInfo, C as VoteResponse, N as Votes, q as blockSpecs, r as getExtraSlashMenuItems, u as useBlocknoteContext, s as useBlocknoteHandlers } from '../index-D0S6jY7O.js';
 import * as zustand from 'zustand';
 import { SurveyModel } from '@ixo/surveys';
+import { N as NodeContextRecord } from '../nodeContext-C-BsYuYi.js';
 import * as _blocknote_core from '@blocknote/core';
 export { Block, BlockNoteEditor, BlockNoteSchema, DefaultBlockSchema, DefaultInlineContentSchema, DefaultStyleSchema, PartialBlock } from '@blocknote/core';
 import { MatrixClient } from 'matrix-js-sdk';
@@ -381,6 +382,29 @@ declare function useRegisterOpenSurvey({ id, title, source, schema, context, mod
  */
 declare function useNodeRuntime(editor: IxoEditorType, nodeId: string): [FlowNodeRuntimeState, (updates: Partial<FlowNodeRuntimeState>) => void];
 
+/**
+ * Reactive hook that subscribes to a single node's flow-manager context
+ * record in the top-level `nodeContext` Y.Map (keyed by block/node id),
+ * overlaid with per-field human overrides from the top-level
+ * `nodeContextOverrides` Y.Map (keyed `${nodeId}:${field}`).
+ *
+ * Usage:
+ *   const [record, setHumanOverride] = useNodeContext(editor, block.id);
+ *   // record?.values.theme, record?.fieldProvenance.theme, ...
+ *   // setHumanOverride('theme', 'Reforestation');
+ *
+ * Malformed or missing entries read back as `undefined` — both maps are
+ * written across process boundaries, so shape is never assumed.
+ *
+ * `setHumanOverride(field, value)` writes ONLY the `${nodeId}:${field}` key
+ * into `nodeContextOverrides` — it never touches the `nodeContext` record, so
+ * a concurrent whole-record write by the flow manager can never erase the
+ * override. It works even when no record exists yet; the override becomes
+ * visible once a base record appears (overrides overlay an existing record
+ * only).
+ */
+declare function useNodeContext(editor: IxoEditorType, nodeId: string): [NodeContextRecord | undefined, (field: string, value: unknown) => void];
+
 type CollapseEvent = 'collapse' | 'expand' | 'toggle';
 type Listener = (event: CollapseEvent) => void;
 interface ListBlocksUIContextValue {
@@ -618,4 +642,4 @@ declare function setDMNotificationRecord(runtimeMap: Map$1<any>, blockId: string
  */
 declare function shouldNotify(state: DMNotificationState, blockId: string, currentAssignedDid: string): boolean;
 
-export { BaseIconPicker, type BlockActionDefinition, BlocknoteHandlers, type CollapseEvent, type ColumnPosition, type DMNotificationRecord, type DMNotificationState, type DataSource, DebugButton, type DynamicListAction, type DynamicListBlockProps, DynamicListBlockSpec, type DynamicListColumn, type DynamicListPanelConfig, type FillOpenSurveyResult, FlowNodeConfigPanel, type FlowNodeConfigPanelProps, FlowNodePanel, type FlowNodePanelProps, type HookedActionInstanceConfig, type HookedActionType, type HookedActionsConfig, HookedActionsTab, IxoEditorType, type ListBlocksUIContextValue, type Listener, type OpenSurveyContext, type OpenSurveyEntry, type OpenSurveyQuestionSummary, type OpenSurveySnapshot, PageHeader, type PageHeaderMenuItem, type PageHeaderProps, PageTitle, type PageTitleProps, type PayloadField, didToMatrixUserId, fillOpenSurvey, findOrCreateDMRoom, getAllHookedActionTypes, getBlockActions, getDMNotificationState, getHomeserver, getHookedActionType, initializeHookedActions, registerBlockActions, registerBuiltInActionTypes, registerHookedActionType, sendDirectMessage, setDMNotificationRecord, shouldNotify, snapshotOpenSurvey, useHookedActions, useListBlocksUI, useListBlocksUIStore, useNodeRuntime, useOpenSurveyStore, usePanel, usePanelStore, useRegisterOpenSurvey };
+export { BaseIconPicker, type BlockActionDefinition, BlocknoteHandlers, type CollapseEvent, type ColumnPosition, type DMNotificationRecord, type DMNotificationState, type DataSource, DebugButton, type DynamicListAction, type DynamicListBlockProps, DynamicListBlockSpec, type DynamicListColumn, type DynamicListPanelConfig, type FillOpenSurveyResult, FlowNodeConfigPanel, type FlowNodeConfigPanelProps, FlowNodePanel, type FlowNodePanelProps, type HookedActionInstanceConfig, type HookedActionType, type HookedActionsConfig, HookedActionsTab, IxoEditorType, type ListBlocksUIContextValue, type Listener, type OpenSurveyContext, type OpenSurveyEntry, type OpenSurveyQuestionSummary, type OpenSurveySnapshot, PageHeader, type PageHeaderMenuItem, type PageHeaderProps, PageTitle, type PageTitleProps, type PayloadField, didToMatrixUserId, fillOpenSurvey, findOrCreateDMRoom, getAllHookedActionTypes, getBlockActions, getDMNotificationState, getHomeserver, getHookedActionType, initializeHookedActions, registerBlockActions, registerBuiltInActionTypes, registerHookedActionType, sendDirectMessage, setDMNotificationRecord, shouldNotify, snapshotOpenSurvey, useHookedActions, useListBlocksUI, useListBlocksUIStore, useNodeContext, useNodeRuntime, useOpenSurveyStore, usePanel, usePanelStore, useRegisterOpenSurvey };

package/dist/mantine/index.js

@@ -77,19 +77,20 @@ import {
   useHookedActions,
   useListBlocksUI,
   useListBlocksUIStore,
+  useNodeContext,
   useNodeRuntime,
   useOpenSurveyStore,
   usePanel,
   usePanelStore,
   useRegisterOpenSurvey,
   useTrackBlockFocus
-} from "../chunk-QXSJ2QRD.js";
+} from "../chunk-ETSJMVZ7.js";
 import {
   didToMatrixUserId,
   findOrCreateDMRoom,
   getHomeserver,
   sendDirectMessage
-} from "../chunk-EULL3QTC.js";
+} from "../chunk-JS7P4DUX.js";
 
 // src/mantine/components/DebugButton.tsx
 import React from "react";
@@ -531,6 +532,7 @@ export {
   useHookedActions,
   useListBlocksUI,
   useListBlocksUIStore,
+  useNodeContext,
   useNodeRuntime,
   useOpenSurveyStore,
   usePanel,