@ixo/editor 3.8.1 → 4.0.0

package/dist/core/index.d.ts

@@ -1,7 +1,8 @@
-import { x as ActionDefinition, y as ActionServices } from '../decompile-BroSNv1q.mjs';
-export { D as ActionContext, G as ActionResult, I as ActorConstraint, A as AuthorizationResult, B as BaseUcanFlow, K as CompiledBlock, L as CompiledEdge, v as CompiledFlow, P as CompiledFlowNode, C as CompilerRegistry, H as ConditionRef, E as ExecuteNodeParams, f as ExecutionContext, d as ExecutionOutcome, u as FlowCapability, F as FlowRuntimeStateManager, w as FlowStrategy, M as MergeResult, N as NodeActionResult, O as OutputSchemaField, R as ReadFlowOptions, q as ReadFlowResult, J as RuntimeRef, S as SetupFlowOptions, p as SetupFlowResult, T as TTLConstraint, a as buildAuthzFromProps, b as buildFlowNodeFromBlock, z as clearRuntimeForTemplateClone, l as compileBaseUcanFlow, c as createRuntimeStateManager, o as decompileToBaseUcanFlow, e as executeNode, k as getActiveEditor, i as isAuthorized, Q as isRuntimeRef, n as mergeCompiledFlows, m as readCompiledFlowFromYDoc, h as readFlow, r as readFlowAsBaseUcan, g as readFlowFromEditor, j as setActiveEditor, s as setupFlowFromBaseUcan } from '../decompile-BroSNv1q.mjs';
-export { C as ClaimCollectionURI, B as CreateDelegationParams, G as CreateInvocationParams, A as CreateRootDelegationParams, s as DID, D as DelegationChainValidationResult, k as DelegationGrant, E as EvaluationStatus, y as ExecutionWithInvocationResult, z as FindProofsResult, v as FlowNode, F as FlowNodeAuthzExtension, u as FlowNodeBase, t as FlowNodeRuntimeState, w as InvocationRequest, x as InvocationResult, I as InvocationStore, L as LinkedClaim, N as NodeState, S as StoredDelegation, j as StoredInvocation, i as UcanCapability, U as UcanDelegationStore, f as UcanService, g as UcanServiceConfig, h as UcanServiceHandlers, b as createInvocationStore, d as createMemoryInvocationStore, a as createMemoryUcanDelegationStore, c as createUcanDelegationStore, e as createUcanService } from '../index-BEoftwDZ.mjs';
-import 'yjs';
+import { x as ActionDefinition, y as ActionServices } from '../decompile-BNprXLsA.mjs';
+export { D as ActionContext, G as ActionResult, I as ActorConstraint, A as AuthorizationResult, B as BaseUcanFlow, K as CompiledBlock, L as CompiledEdge, v as CompiledFlow, P as CompiledFlowNode, C as CompilerRegistry, H as ConditionRef, E as ExecuteNodeParams, f as ExecutionContext, d as ExecutionOutcome, u as FlowCapability, F as FlowRuntimeStateManager, w as FlowStrategy, M as MergeResult, N as NodeActionResult, O as OutputSchemaField, R as ReadFlowOptions, q as ReadFlowResult, J as RuntimeRef, S as SetupFlowOptions, p as SetupFlowResult, T as TTLConstraint, Q as TriggerSpec, a as buildAuthzFromProps, b as buildFlowNodeFromBlock, z as clearRuntimeForTemplateClone, l as compileBaseUcanFlow, c as createRuntimeStateManager, o as decompileToBaseUcanFlow, e as executeNode, k as getActiveEditor, i as isAuthorized, U as isRuntimeRef, n as mergeCompiledFlows, m as readCompiledFlowFromYDoc, h as readFlow, r as readFlowAsBaseUcan, g as readFlowFromEditor, j as setActiveEditor, s as setupFlowFromBaseUcan } from '../decompile-BNprXLsA.mjs';
+import { s as IxoEditorType } from '../index-CNCZs4wP.mjs';
+export { C as ClaimCollectionURI, G as CreateDelegationParams, H as CreateInvocationParams, B as CreateRootDelegationParams, t as DID, D as DelegationChainValidationResult, k as DelegationGrant, E as EvaluationStatus, z as ExecutionWithInvocationResult, A as FindProofsResult, w as FlowNode, F as FlowNodeAuthzExtension, v as FlowNodeBase, u as FlowNodeRuntimeState, x as InvocationRequest, y as InvocationResult, I as InvocationStore, L as LinkedClaim, N as NodeState, S as StoredDelegation, j as StoredInvocation, i as UcanCapability, U as UcanDelegationStore, f as UcanService, g as UcanServiceConfig, h as UcanServiceHandlers, b as createInvocationStore, d as createMemoryInvocationStore, a as createMemoryUcanDelegationStore, c as createUcanDelegationStore, e as createUcanService } from '../index-CNCZs4wP.mjs';
+import * as Y from 'yjs';
 import 'matrix-js-sdk';
 import '@blocknote/core';
 import 'react';
@@ -37,6 +38,263 @@ declare function getAllCanMappings(): ReadonlyArray<{
  */
 declare function buildServicesFromHandlers(handlers: any): ActionServices;
 
+/**
+ * Run record stored in the audit trail as `type: 'block.run'`.
+ *
+ * Per Phase 0 #2 (eng review pass 2), run records are NOT a parallel
+ * `_yRunHistory` structure — they ride on the existing `auditTrail` Y.Map
+ * via `useAuditTrail.addEvent`. The shape below is what goes into the
+ * audit trail event's `details` field.
+ *
+ * See `docs/events-and-triggers-plan.md` §3.4, §18, §19.
+ */
+interface RunRecordDetails {
+    /** Stable identifier for this run, deterministic from invocation context. */
+    runId: string;
+    /** Action's output. */
+    output: Record<string, unknown>;
+    /**
+     * Events the action emitted on this run. Persisted as part of the run
+     * record so the reconciliation loop can process them idempotently — even
+     * across page refreshes and across multiple clients.
+     */
+    events: Array<{
+        name: string;
+        payload: Record<string, unknown>;
+    }>;
+    /** ISO timestamp when the action started. */
+    startedAt: string;
+    /** ISO timestamp when the action completed (success or failure). */
+    completedAt: string;
+    /** DID of the actor who signed the invocation that produced this run. */
+    actorDid: string;
+    /** Optional error if the run failed. */
+    error?: {
+        message: string;
+        code?: string;
+    };
+    /**
+     * If this run was triggered by a pending invocation (i.e. it's a listener
+     * run), the id of that pending invocation. Used to dedup replays and trace
+     * causality back through `triggeredBy`.
+     */
+    fromPendingInvocationId?: string;
+    /**
+     * If this run is a listener run, the (sourceBlockId, eventName) that
+     * caused it. Used by the failure visibility surface to attribute failures
+     * back to the source block (CP-1).
+     */
+    triggeredBy?: {
+        sourceBlockId: string;
+        eventName: string;
+    };
+}
+declare const RUN_RECORD_AUDIT_TYPE = "block.run";
+/**
+ * Pending invocation queued on a listener block.
+ *
+ * Stored in `_yPendingInvocations: Y.Map<blockId, Y.Map<id, PendingInvocation>>`.
+ *
+ * The id is deterministic — derived from
+ * `(sourceBlockId, sourceRunId, listenerBlockId, eventName, eventIndex)` —
+ * so the reconciliation loop can run idempotently from multiple clients
+ * without producing duplicates.
+ *
+ * See `docs/events-and-triggers-plan.md` §3.4, §3.5.1, §18.
+ */
+interface PendingInvocation {
+    /** Deterministic id, see `computePendingInvocationId`. */
+    id: string;
+    /** Block that emitted the event. */
+    triggeringBlockId: string;
+    /** Run id of the triggering source run, used for the deterministic id. */
+    sourceRunId: string;
+    /** Event name from the source action's vocabulary. */
+    eventName: string;
+    /** Event index within the source run's `events` array (a single run can emit multiple). */
+    eventIndex: number;
+    /**
+     * The frozen event payload, captured by value at emission time. The
+     * assignee invokes the listener against this payload, not against the
+     * source block's current state. This is the property that makes the
+     * Sally → Mike scenario produce 10 distinct emails even when Mike acts
+     * on them all hours later.
+     */
+    payload: Record<string, unknown>;
+    /**
+     * Snapshots of `nodeId.output.*` ref values that the listener's inputs
+     * reference, captured at queue time. Keyed by the full ref string.
+     *
+     * §3.5.1: ref snapshots are the load-bearing fix for the lag-time
+     * overwrite scenario. If a listener references a non-trigger block's
+     * output (e.g. `evaluateBlock.output.claimId`), that value is captured
+     * here at queue time. Resolution at invocation time prefers the snapshot
+     * over current state, so multiple queued invocations don't drift when
+     * the source re-runs.
+     */
+    refSnapshots: Record<string, unknown>;
+    /** DID of the assigned actor who must invoke this listener. Resolved from `props.assignment.assignedActor.did`. */
+    assigneeDid: string;
+    /** ISO timestamp when the source emission happened. */
+    emittedAt: string;
+    /** ISO timestamp after which this pending invocation is considered expired. Resolved from `FlowCapability.ttl` at queue time. */
+    expiresAt: string;
+}
+/**
+ * Compute a deterministic id for a pending invocation from its content.
+ *
+ * The same (sourceBlockId, sourceRunId, listenerBlockId, eventName,
+ * eventIndex) tuple always produces the same id. This is the property that
+ * makes the reconciliation loop idempotent — re-running it from a different
+ * client, or after a page refresh, produces the same `Y.Map.set` operation
+ * with the same key, which Yjs converges to a single entry.
+ *
+ * Implementation: simple deterministic string concatenation, hashed via a
+ * 32-bit FNV-1a. The id is short and stable; collision risk within a single
+ * flow is negligible because the inputs are scoped (block ids are unique
+ * within a flow, run ids are unique within a block).
+ */
+declare function computePendingInvocationId(args: {
+    sourceBlockId: string;
+    sourceRunId: string;
+    listenerBlockId: string;
+    eventName: string;
+    eventIndex: number;
+}): string;
+/**
+ * Walk an inputs object and collect every RuntimeRef of the form
+ * `nodeId.output.fieldPath`. Returns a map of `{refString: resolvedValue}`
+ * suitable for storing as `PendingInvocation.refSnapshots`.
+ *
+ * The walker mirrors `resolveRuntimeRefs` in `flowCompiler/resolveRefs.ts`
+ * but reads instead of resolving — it captures the current value of each
+ * ref so the listener can later resolve against the snapshot rather than
+ * against current state.
+ *
+ * See `docs/events-and-triggers-plan.md` §3.5.1.
+ */
+declare function snapshotInputRefs(inputs: unknown, getNodeOutput: (nodeId: string) => Record<string, unknown> | undefined): Record<string, unknown>;
+/**
+ * Get the top-level pending invocations Y.Map from the editor's yDoc.
+ * Lazily creates it if missing.
+ *
+ * Shape: `Y.Map<blockId, Y.Map<pendingInvocationId, PendingInvocation>>`.
+ * The outer map is keyed by listener block id; the inner map is keyed by
+ * deterministic pending invocation id (see `computePendingInvocationId`).
+ */
+declare function getPendingInvocationsMap(yDoc: Y.Doc): Y.Map<Y.Map<unknown>>;
+/**
+ * Get the inner pending-invocations map for a specific listener block.
+ * Lazily creates it if missing. Caller is responsible for being inside a
+ * Yjs transaction if atomic creation matters.
+ */
+declare function getOrCreateBlockPendingMap(yDoc: Y.Doc, blockId: string): Y.Map<unknown>;
+/**
+ * Read all pending invocations for a block as plain JS objects.
+ * Returns an array sorted by `emittedAt` ascending (oldest first).
+ */
+declare function readPendingInvocations(yDoc: Y.Doc, blockId: string): PendingInvocation[];
+/**
+ * Idempotently write a pending invocation under its deterministic id.
+ *
+ * Returns true if a new entry was created, false if the id already
+ * existed (meaning another client or a previous reconciliation pass
+ * already queued this invocation). This is the property that makes
+ * `reconcilePendingInvocations` safe to run from multiple clients
+ * simultaneously and across page refreshes — see plan §18.
+ *
+ * Wraps the write in a Yjs transaction so the existence check and the
+ * subsequent set are atomic from the local client's perspective. Concurrent
+ * clients each computing the same id will all converge to a single entry
+ * because Y.Map.set with the same key is last-writer-wins on identical
+ * content.
+ */
+declare function queuePendingInvocation(yDoc: Y.Doc, listenerBlockId: string, invocation: PendingInvocation): boolean;
+/**
+ * Remove a pending invocation by id. Used when the assignee completes the
+ * invocation (transitioning to a `block.run` audit trail entry) or when
+ * the expiration sweep marks it as expired.
+ */
+declare function removePendingInvocation(yDoc: Y.Doc, listenerBlockId: string, pendingInvocationId: string): boolean;
+/**
+ * Append a run record to the audit trail for a block. Run records are
+ * stored as audit trail events with `type: 'block.run'` and the structured
+ * data in `details`. Per Phase 0 #2 of eng review pass 2, this avoids
+ * inventing a parallel `_yRunHistory` storage system.
+ *
+ * Y.Array.push from concurrent clients merges correctly — verified by the
+ * existing `useAuditTrail` shipping in production.
+ */
+declare function appendRunRecord(yDoc: Y.Doc, blockId: string, details: RunRecordDetails, userId: string): void;
+/**
+ * Read all run records for a block from the audit trail. Filters audit
+ * trail entries to only those with `type: 'block.run'`.
+ */
+declare function readRunRecords(yDoc: Y.Doc, blockId: string): RunRecordDetails[];
+/**
+ * A failed listener run, attributed to the source block emission that
+ * triggered it. Used by the failure visibility surface (CP-1) on source
+ * blocks: the source block can show "N listeners failed for your last run".
+ */
+interface FailedListenerRun {
+    /** Block id of the listener whose run failed. */
+    listenerBlockId: string;
+    /** The full RunRecordDetails of the failed listener invocation. */
+    record: RunRecordDetails;
+}
+/**
+ * Find all failed listener runs that were triggered by a specific source
+ * block run. Walks every block's audit trail, filters to listener runs
+ * triggered by (sourceBlockId, sourceRunId), and returns the ones with an
+ * error set.
+ *
+ * Used by the source block UI to show a failure badge linked to a specific
+ * run — if Sally evaluates 10 claims and 2 of Mike's emails fail, Sally
+ * sees "2 failed listeners on claim-G" rather than discovering it days
+ * later in the email service logs.
+ */
+declare function findFailedListenersForSourceRun(yDoc: Y.Doc, sourceBlockId: string, sourceRunId: string, listenerBlockIds: string[]): FailedListenerRun[];
+/**
+ * Replay a previously failed listener run by re-queueing a pending
+ * invocation with the same content. Reuses the original frozen payload
+ * and ref snapshots from the failed run record's audit trail entry, so the
+ * replay sees exactly the same data the original invocation saw.
+ *
+ * CP-2 from the plan. Used by the replay button in the failure visibility
+ * surface. Returns true if a new pending invocation was queued.
+ *
+ * Note: replay does NOT re-derive the deterministic id from the original
+ * source emission, because the original pending invocation's id is already
+ * present (or removed) in the pendingInvocations Y.Map. Instead, replay
+ * generates a fresh id by appending a `:replay-N` suffix to the original.
+ * This means the replay creates a NEW pending invocation that the assignee
+ * can act on, separate from any history of the original.
+ */
+declare function replayFailedListenerRun(yDoc: Y.Doc, failedRecord: RunRecordDetails, listenerBlockId: string, originalPayload: Record<string, unknown>, originalRefSnapshots: Record<string, unknown>, assigneeDid: string): boolean;
+
+/**
+ * Reconciliation loop — turns persisted run records into pending invocations
+ * idempotently, so the trigger system survives page refreshes and works
+ * across multiple connected clients.
+ *
+ * See `docs/events-and-triggers-plan.md` §18 for the full design rationale.
+ *
+ * Called from:
+ *   - The editor lifecycle on open (alongside performDMNotificationScan)
+ *   - The yDoc observer when remote run records arrive
+ *   - Immediately after a local action completes
+ *
+ * Idempotency comes from `computePendingInvocationId` producing the same id
+ * for the same (sourceBlockId, sourceRunId, listenerBlockId, eventName,
+ * eventIndex) tuple. Both ends of a sync compute the same id, both call
+ * `Y.Map.set` on the same key, Yjs converges to one entry.
+ *
+ * The loop is intentionally write-only-on-new — it never deletes pending
+ * invocations. Removal happens elsewhere (assignee invokes, expiration sweep).
+ */
+declare function reconcilePendingInvocations(editor: IxoEditorType): void;
+declare function getActionForBlock(block: any): ReturnType<typeof getAction>;
+
 /**
  * Context passed to resolveRuntimeRefs when resolving inputs for a triggered
  * listener block. The runtime constructs this from a PendingInvocation when
@@ -91,4 +349,4 @@ declare function computeCID(content: Uint8Array): Promise<string>;
  */
 declare function computeJsonCID(obj: Record<string, any>): Promise<string>;
 
-export { ActionDefinition, ActionServices, buildServicesFromHandlers, canToType, computeCID, computeJsonCID, getAction, getActionByCan, getAllActions, getAllCanMappings, hasAction, registerAction, resolveRuntimeRefs, typeToCan };
+export { ActionDefinition, ActionServices, type FailedListenerRun, type PendingInvocation, RUN_RECORD_AUDIT_TYPE, type RunRecordDetails, type TriggerResolutionContext, appendRunRecord, buildServicesFromHandlers, canToType, computeCID, computeJsonCID, computePendingInvocationId, findFailedListenersForSourceRun, getAction, getActionByCan, getActionForBlock, getAllActions, getAllCanMappings, getOrCreateBlockPendingMap, getPendingInvocationsMap, hasAction, queuePendingInvocation, readPendingInvocations, readRunRecords, reconcilePendingInvocations, registerAction, removePendingInvocation, replayFailedListenerRun, resolveRuntimeRefs, snapshotInputRefs, typeToCan };

package/dist/core/index.mjs

@@ -1,13 +1,16 @@
 import {
   resolveRuntimeRefs
-} from "../chunk-FXFKKA6L.mjs";
+} from "../chunk-VE3WI2J2.mjs";
 import {
+  RUN_RECORD_AUDIT_TYPE,
+  appendRunRecord,
   buildAuthzFromProps,
   buildFlowNodeFromBlock,
   buildServicesFromHandlers,
   canToType,
   clearRuntimeForTemplateClone,
   compileBaseUcanFlow,
+  computePendingInvocationId,
   createInvocationStore,
   createMemoryInvocationStore,
   createMemoryUcanDelegationStore,
@@ -16,29 +19,42 @@ import {
   createUcanService,
   decompileToBaseUcanFlow,
   executeNode,
+  findFailedListenersForSourceRun,
   getAction,
   getActionByCan,
+  getActionForBlock,
   getActiveEditor,
   getAllActions,
   getAllCanMappings,
+  getOrCreateBlockPendingMap,
+  getPendingInvocationsMap,
   hasAction,
   isAuthorized,
   isRuntimeRef,
   mergeCompiledFlows,
+  queuePendingInvocation,
   readCompiledFlowFromYDoc,
   readFlow,
   readFlowAsBaseUcan,
   readFlowFromEditor,
+  readPendingInvocations,
+  readRunRecords,
+  reconcilePendingInvocations,
   registerAction,
+  removePendingInvocation,
+  replayFailedListenerRun,
   setActiveEditor,
   setupFlowFromBaseUcan,
+  snapshotInputRefs,
   typeToCan
-} from "../chunk-QIJA3CMG.mjs";
+} from "../chunk-4ETFMWQR.mjs";
 import {
   computeCID,
   computeJsonCID
 } from "../chunk-VU34HOXM.mjs";
 export {
+  RUN_RECORD_AUDIT_TYPE,
+  appendRunRecord,
   buildAuthzFromProps,
   buildFlowNodeFromBlock,
   buildServicesFromHandlers,
@@ -47,6 +63,7 @@ export {
   compileBaseUcanFlow,
   computeCID,
   computeJsonCID,
+  computePendingInvocationId,
   createInvocationStore,
   createMemoryInvocationStore,
   createMemoryUcanDelegationStore,
@@ -55,23 +72,34 @@ export {
   createUcanService,
   decompileToBaseUcanFlow,
   executeNode,
+  findFailedListenersForSourceRun,
   getAction,
   getActionByCan,
+  getActionForBlock,
   getActiveEditor,
   getAllActions,
   getAllCanMappings,
+  getOrCreateBlockPendingMap,
+  getPendingInvocationsMap,
   hasAction,
   isAuthorized,
   isRuntimeRef,
   mergeCompiledFlows,
+  queuePendingInvocation,
   readCompiledFlowFromYDoc,
   readFlow,
   readFlowAsBaseUcan,
   readFlowFromEditor,
+  readPendingInvocations,
+  readRunRecords,
+  reconcilePendingInvocations,
   registerAction,
+  removePendingInvocation,
+  replayFailedListenerRun,
   resolveRuntimeRefs,
   setActiveEditor,
   setupFlowFromBaseUcan,
+  snapshotInputRefs,
   typeToCan
 };
 //# sourceMappingURL=index.mjs.map

package/dist/{decompile-BroSNv1q.d.ts → decompile-BNprXLsA.d.ts}

@@ -1,4 +1,4 @@
-import { v as FlowNode, F as FlowNodeAuthzExtension, t as FlowNodeRuntimeState, H as IxoEditorType, f as UcanService, I as InvocationStore, E as EvaluationStatus } from './index-BEoftwDZ.mjs';
+import { w as FlowNode, F as FlowNodeAuthzExtension, u as FlowNodeRuntimeState, s as IxoEditorType, f as UcanService, I as InvocationStore, E as EvaluationStatus } from './index-CNCZs4wP.mjs';
 import * as Y from 'yjs';
 import { Doc } from 'yjs';
 import { MatrixClient } from 'matrix-js-sdk';
@@ -685,4 +685,4 @@ declare function readCompiledFlowFromYDoc(yDoc: Doc): CompiledFlow | null;
  */
 declare function decompileToBaseUcanFlow(compiled: CompiledFlow): BaseUcanFlow;
 
-export { type AuthorizationResult as A, type BaseUcanFlow as B, type CompilerRegistry as C, type ActionContext as D, type ExecuteNodeParams as E, type FlowRuntimeStateManager as F, type ActionResult as G, type ConditionRef as H, type ActorConstraint as I, type RuntimeRef as J, type CompiledBlock as K, type CompiledEdge as L, type MergeResult as M, type NodeActionResult as N, type OutputSchemaField as O, type CompiledFlowNode as P, isRuntimeRef as Q, type ReadFlowOptions as R, type SetupFlowOptions as S, type TTLConstraint as T, buildAuthzFromProps as a, buildFlowNodeFromBlock as b, createRuntimeStateManager as c, type ExecutionOutcome as d, executeNode as e, type ExecutionContext as f, readFlowFromEditor as g, readFlow as h, isAuthorized as i, setActiveEditor as j, getActiveEditor as k, compileBaseUcanFlow as l, readCompiledFlowFromYDoc as m, mergeCompiledFlows as n, decompileToBaseUcanFlow as o, type SetupFlowResult as p, type ReadFlowResult as q, readFlowAsBaseUcan as r, setupFlowFromBaseUcan as s, type ReadableEditor as t, type FlowCapability as u, type CompiledFlow as v, type FlowStrategy as w, type ActionDefinition as x, type ActionServices as y, clearRuntimeForTemplateClone as z };
+export { type AuthorizationResult as A, type BaseUcanFlow as B, type CompilerRegistry as C, type ActionContext as D, type ExecuteNodeParams as E, type FlowRuntimeStateManager as F, type ActionResult as G, type ConditionRef as H, type ActorConstraint as I, type RuntimeRef as J, type CompiledBlock as K, type CompiledEdge as L, type MergeResult as M, type NodeActionResult as N, type OutputSchemaField as O, type CompiledFlowNode as P, type TriggerSpec as Q, type ReadFlowOptions as R, type SetupFlowOptions as S, type TTLConstraint as T, isRuntimeRef as U, buildAuthzFromProps as a, buildFlowNodeFromBlock as b, createRuntimeStateManager as c, type ExecutionOutcome as d, executeNode as e, type ExecutionContext as f, readFlowFromEditor as g, readFlow as h, isAuthorized as i, setActiveEditor as j, getActiveEditor as k, compileBaseUcanFlow as l, readCompiledFlowFromYDoc as m, mergeCompiledFlows as n, decompileToBaseUcanFlow as o, type SetupFlowResult as p, type ReadFlowResult as q, readFlowAsBaseUcan as r, setupFlowFromBaseUcan as s, type ReadableEditor as t, type FlowCapability as u, type CompiledFlow as v, type FlowStrategy as w, type ActionDefinition as x, type ActionServices as y, clearRuntimeForTemplateClone as z };

package/dist/{graphql-client-DGl50_zh.d.ts → graphql-client-l6N8ekd1.d.ts}

@@ -1,5 +1,5 @@
 import * as _blocknote_core from '@blocknote/core';
-import { J as IxoBlockProps, H as IxoEditorType, l as IxoEditorOptions, p as IxoCollaborativeEditorOptions, k as DelegationGrant } from './index-BEoftwDZ.mjs';
+import { J as IxoBlockProps, s as IxoEditorType, l as IxoEditorOptions, p as IxoCollaborativeEditorOptions, k as DelegationGrant } from './index-CNCZs4wP.mjs';
 import { Text, Doc, Map, Array as Array$1 } from 'yjs';
 import React__default from 'react';
 import { MatrixClient } from 'matrix-js-sdk';
@@ -2044,6 +2044,65 @@ interface BlocknoteHandlers {
         /** Transaction hash */
         transactionHash: string;
     }>;
+    /**
+     * List entities where a given DID holds a specified role (e.g. 'controller').
+     * Used by the POD setup flow to list parent organisations the user can nest under.
+     */
+    getEntitiesByRole?: (params: {
+        /** DID of the actor */
+        did: string;
+        /** Role to filter by (e.g. 'controller', 'admin') */
+        role: string;
+    }) => Promise<Array<{
+        did: string;
+        name?: string;
+        /** IXO entity type string, e.g. 'dao/dao', 'dao/pod', 'protocol/deed' */
+        type?: string;
+        icon?: string;
+        description?: string;
+    }>>;
+    /**
+     * List flow templates available for a given blueprint entity.
+     * Used by the POD setup flow to let the user select startup flows.
+     */
+    getFlowTemplates?: (params: {
+        /** Entity DID of the blueprint/protocol */
+        entityDid: string;
+    }) => Promise<Array<{
+        did: string;
+        name?: string;
+        description?: string;
+    }>>;
+    /**
+     * Create a Cosmos governance group from explicit members and decision policy.
+     * Used by the POD setup flow after domain entity creation.
+     */
+    createGroup?: (params: {
+        /** The entity DID of the newly created domain (to associate the group) */
+        entityDid: string;
+        /** Members with roles and voting power */
+        members: Array<{
+            did: string;
+            role: string;
+            votingPower: number;
+        }>;
+        /** Decision policy parameters */
+        decisionPolicy: {
+            votingPeriod: string;
+            quorum: string;
+            threshold: string;
+            vetoThreshold: string;
+            minExecutionDelay: string;
+            executor: string;
+        };
+        /** Optional group name (defaults to entity name) */
+        name?: string;
+    }) => Promise<{
+        /** The group/DAO core contract address */
+        groupAddress: string;
+        /** Transaction hash */
+        transactionHash: string;
+    }>;
     /**
      * Navigate to a flow link URL
      * @param url - HTTP URL of the target flow or page
@@ -2185,6 +2244,10 @@ interface BlocknoteHandlers {
             hasMore: boolean;
         };
     }>;
+    /**
+     * Invoke a named skill with the given payload and return the result.
+     */
+    invokeSkill?: (skillName: string, payload: Record<string, unknown>) => Promise<unknown>;
 }
 type DocType = 'template' | 'flow';
 /**
@@ -2235,7 +2298,7 @@ interface DomainCardData {
     [key: string]: unknown;
 }
 /**
- * Renderer for domain card previews in the domainCardViewer block.
+ * Renderer for domain card previews in the qi/domain.card-preview action.
  * The web app provides this renderer to display domain card data with proper styling.
  */
 type DomainCardRenderer = (domainCardData: DomainCardData) => React__default.ReactNode;