@ixo/editor 5.18.0 → 5.20.0-experimental.1

package/dist/mantine/index.d.ts

@@ -1,8 +1,9 @@
-export { n 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, J as DropPosition, r as Entity, s as EntityResponse, f as EntitySigningSetup, t as EntityVariables, E as EvaluationTab, e as EvaluationTabState, z as ExternalDropZone, F as FlowPermissionsPanel, G as GrantPermissionModal, v as GraphQLClient, y as GraphQLRequest, x 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, l as OverviewBlockProps, m as ProposalBlockProps, P as ProposalBlockSpec, q as getEntity, w as ixoGraphQLClient, o as useBlockPresence, a as useCreateCollaborativeIxoEditor, u as useCreateIxoEditor, p as useTrackBlockFocus } from '../graphql-client-xxQMIQzo.mjs';
+export { n 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, J as DropPosition, r as Entity, s as EntityResponse, f as EntitySigningSetup, t as EntityVariables, E as EvaluationTab, e as EvaluationTabState, z as ExternalDropZone, F as FlowPermissionsPanel, G as GrantPermissionModal, v as GraphQLClient, y as GraphQLRequest, x 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, l as OverviewBlockProps, m as ProposalBlockProps, P as ProposalBlockSpec, q as getEntity, w as ixoGraphQLClient, o as useBlockPresence, a as useCreateCollaborativeIxoEditor, u as useCreateIxoEditor, p as useTrackBlockFocus } from '../graphql-client-Dhxgv06u.mjs';
 import React__default, { PropsWithChildren } from 'react';
-import { ac as IxoBlockProps, W as IxoEditorType, w as BlocknoteHandlers, X as FlowNodeRuntimeState } from '../index-BoRWeiDg.mjs';
-export { H as Addr, A as AuthzExecActionTypes, y as BlockRequirements, x as BlocknoteContextValue, B as BlocknoteProvider, O as CosmosMsgForEmpty, ai as DomainCardData, ah as DomainCardRenderer, ae as DynamicListData, af as DynamicListDataProvider, ag as DynamicListPanelRenderer, K as Expiration, p as IxoCollaborativeEditorOptions, o as IxoCollaborativeUser, n as IxoEditorConfig, l as IxoEditorOptions, m as IxoEditorTheme, Q as ProposalAction, P as ProposalResponse, 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, ad 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-BoRWeiDg.mjs';
+import { ao as IxoBlockProps, a4 as IxoEditorType, w as BlocknoteHandlers, a5 as FlowNodeRuntimeState } from '../index-DMNPdv6v.mjs';
+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-DMNPdv6v.mjs';
 import * as zustand from 'zustand';
+import { SurveyModel } from '@ixo/surveys';
 import * as _blocknote_core from '@blocknote/core';
 export { Block, BlockNoteEditor, BlockNoteSchema, DefaultBlockSchema, DefaultInlineContentSchema, DefaultStyleSchema, PartialBlock } from '@blocknote/core';
 import { MatrixClient } from 'matrix-js-sdk';
@@ -202,6 +203,132 @@ declare const usePanel: (panelId: string, content: React.ReactNode) => {
     close: () => void;
 };
 
+/**
+ * Registry for ephemeral SurveyJS forms — the right-side panels (claim
+ * submission, bid submission) whose schema and answers do NOT live in
+ * BlockNote state. The oracle reaches these via the `list_open_surveys` /
+ * `fill_open_survey` browser tools. Forms whose answers are persisted to
+ * `block.props.answers` are NOT registered here; the oracle updates those
+ * directly through the Matrix CRDT via the existing block tools.
+ */
+interface OpenSurveyContext {
+    deedId?: string;
+    deedTitle?: string;
+    collectionId?: string;
+    blockId?: string;
+    blockTitle?: string;
+    blockType?: string;
+    pageRoomId?: string;
+    flowType?: string;
+    [key: string]: unknown;
+}
+interface OpenSurveyEntry {
+    /** Stable id the LLM uses to address this survey. */
+    id: string;
+    /** Human-readable label for disambiguation when multiple are open. */
+    title: string;
+    /** Where the survey lives in the UI. */
+    source: 'panel' | 'block-config';
+    /** Original survey schema (the JSON passed into `new SurveyModel(...)`). */
+    schema: unknown;
+    /** Context the LLM may need to fill correctly (deed/collection/page ids). */
+    context: OpenSurveyContext;
+    /** Read-only view (e.g. evaluator viewing a submitted claim). */
+    readonly: boolean;
+    /** Live SurveyJS model. Not serialized over the wire. */
+    model: SurveyModel;
+}
+interface OpenSurveyStore {
+    surveys: Map<string, OpenSurveyEntry>;
+    register: (entry: OpenSurveyEntry) => void;
+    unregister: (id: string) => void;
+}
+declare const useOpenSurveyStore: zustand.UseBoundStore<zustand.StoreApi<OpenSurveyStore>>;
+/** Snapshot of a question's contract, sent to the oracle so it can fill correctly. */
+interface OpenSurveyQuestionSummary {
+    name: string;
+    type: string;
+    title?: string;
+    description?: string;
+    isRequired: boolean;
+    visible: boolean;
+    readOnly: boolean;
+    inputType?: string;
+    /** Resolved choices the dropdown will accept. For `choicesByUrl`-driven
+     *  questions this is `visibleChoices` from the live SurveyJS model — it
+     *  reflects already-loaded async options. May be empty if those options
+     *  haven't loaded yet. */
+    choices?: Array<{
+        value: unknown;
+        text: string;
+    }>;
+    /** Present when the question pulls choices from a URL. `loaded: true`
+     *  means async choices have arrived; `false` means the consumer should
+     *  expect choices to be populated shortly. */
+    choicesByUrl?: {
+        url: string;
+        valueName?: string;
+        titleName?: string;
+        loaded: boolean;
+    };
+}
+/** Wire-safe view of a registered survey returned by `list_open_surveys`. */
+interface OpenSurveySnapshot {
+    id: string;
+    title: string;
+    source: 'panel' | 'block-config';
+    context: OpenSurveyContext;
+    readonly: boolean;
+    questions: OpenSurveyQuestionSummary[];
+    currentAnswers: Record<string, unknown>;
+    /** Full schema, only included when `includeSchema: true`. */
+    schema?: unknown;
+}
+interface FillOpenSurveyResult {
+    applied: Record<string, unknown>;
+    rejected: Array<{
+        field: string;
+        reason: string;
+    }>;
+    validation: Array<{
+        field: string;
+        message: string;
+    }>;
+}
+/**
+ * Build the wire-safe snapshot for a registered survey. Pulls the live
+ * answers from the SurveyJS model at call-time, so the oracle always sees
+ * what the user currently has typed.
+ */
+declare function snapshotOpenSurvey(entry: OpenSurveyEntry, opts?: {
+    includeSchema?: boolean;
+}): OpenSurveySnapshot;
+/**
+ * Apply an answer patch to a registered survey. Per-field via `setValue` so
+ * SurveyJS's conditional visibility / dependent rules fire correctly. Does
+ * NOT submit — the user reviews and submits manually.
+ */
+declare function fillOpenSurvey(entry: OpenSurveyEntry, patch: Record<string, unknown>, opts?: {
+    merge?: boolean;
+}): FillOpenSurveyResult;
+interface UseRegisterOpenSurveyParams {
+    id: string;
+    title: string;
+    source: 'panel' | 'block-config';
+    schema: unknown;
+    context: OpenSurveyContext;
+    model: SurveyModel | null | undefined;
+    readonly?: boolean;
+    /** Set to false to temporarily skip registration without unmounting. */
+    enabled?: boolean;
+}
+/**
+ * Registers a SurveyJS form with the open-survey registry while mounted.
+ * Re-registers if the model identity changes (e.g. schema reload).
+ * Auto-cleans on unmount.
+ */
+declare function useRegisterOpenSurvey({ id, title, source, schema, context, model, readonly, enabled, }: UseRegisterOpenSurveyParams): void;
+
 /**
  * Reactive hook that subscribes to a single node's runtime state in yDoc.runtime.
  *
@@ -449,4 +576,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 HookedActionInstanceConfig, type HookedActionType, type HookedActionsConfig, HookedActionsTab, IxoEditorType, type ListBlocksUIContextValue, type Listener, PageHeader, type PageHeaderMenuItem, type PageHeaderProps, PageTitle, type PageTitleProps, type PayloadField, didToMatrixUserId, findOrCreateDMRoom, getAllHookedActionTypes, getBlockActions, getDMNotificationState, getHomeserver, getHookedActionType, initializeHookedActions, registerBlockActions, registerBuiltInActionTypes, registerHookedActionType, sendDirectMessage, setDMNotificationRecord, shouldNotify, useHookedActions, useListBlocksUI, useListBlocksUIStore, useNodeRuntime, usePanel, usePanelStore };
+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, 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 };

package/dist/mantine/index.mjs

@@ -25,6 +25,7 @@ import {
   StakeType,
   ValidatorActionType,
   blockSpecs,
+  fillOpenSurvey,
   getAllHookedActionTypes,
   getBlockActions,
   getDMNotificationState,
@@ -38,6 +39,7 @@ import {
   registerHookedActionType,
   setDMNotificationRecord,
   shouldNotify,
+  snapshotOpenSurvey,
   useBlockPresence,
   useBlocknoteContext,
   useBlocknoteHandlers,
@@ -47,16 +49,18 @@ import {
   useListBlocksUI,
   useListBlocksUIStore,
   useNodeRuntime,
+  useOpenSurveyStore,
   usePanel,
   usePanelStore,
+  useRegisterOpenSurvey,
   useTrackBlockFocus
-} from "../chunk-7OOTFDLP.mjs";
+} from "../chunk-IALS3KWH.mjs";
 import {
   didToMatrixUserId,
   findOrCreateDMRoom,
   getHomeserver,
   sendDirectMessage
-} from "../chunk-67477PYU.mjs";
+} from "../chunk-XGQRYGA3.mjs";
 export {
   ApiRequestBlockSpec,
   AuthorizationTab,
@@ -85,6 +89,7 @@ export {
   ValidatorActionType,
   blockSpecs,
   didToMatrixUserId,
+  fillOpenSurvey,
   findOrCreateDMRoom,
   getAllHookedActionTypes,
   getBlockActions,
@@ -101,6 +106,7 @@ export {
   sendDirectMessage,
   setDMNotificationRecord,
   shouldNotify,
+  snapshotOpenSurvey,
   useBlockPresence,
   useBlocknoteContext,
   useBlocknoteHandlers,
@@ -110,8 +116,10 @@ export {
   useListBlocksUI,
   useListBlocksUIStore,
   useNodeRuntime,
+  useOpenSurveyStore,
   usePanel,
   usePanelStore,
+  useRegisterOpenSurvey,
   useTrackBlockFocus
 };
 //# sourceMappingURL=index.mjs.map

package/dist/{store-DZobLMG3.d.ts → store-Bx5ezUFS.d.ts}

@@ -1,4 +1,4 @@
-import { Z as FlowNode, a2 as FlowNodeAuthzExtension, X as FlowNodeRuntimeState, W as IxoEditorType, f as UcanService, I as InvocationStore, a0 as EvaluationStatus, i as UcanCapability, U as UcanDelegationStore, S as StoredDelegation } from './index-BoRWeiDg.mjs';
+import { a7 as FlowNode, ac as FlowNodeAuthzExtension, a5 as FlowNodeRuntimeState, a4 as IxoEditorType, f as UcanService, I as InvocationStore, aa as EvaluationStatus, i as UcanCapability, U as UcanDelegationStore, S as StoredDelegation } from './index-DMNPdv6v.mjs';
 import * as Y from 'yjs';
 import { Doc, Map } from 'yjs';
 import { MatrixClient } from 'matrix-js-sdk';
@@ -219,71 +219,6 @@ declare const createRuntimeStateManager: (editor?: IxoEditorType | null) => Flow
  */
 declare function clearRuntimeForTemplateClone(yDoc: Doc): void;
 
-interface NodeActionResult {
-    claimId?: string;
-    evaluationStatus?: EvaluationStatus;
-    submittedByDid?: string;
-    payload?: any;
-}
-interface ExecutionContext {
-    runtime: FlowRuntimeStateManager;
-    /** UCAN service — optional for v0.x flows, required for v1.0.0+ */
-    ucanService?: UcanService;
-    /** Invocation store — optional for v0.x flows */
-    invocationStore?: InvocationStore;
-    flowUri: string;
-    flowId: string;
-    flowOwnerDid: string;
-    /** Flow schema version. When set, controls whether UCAN is enforced. */
-    schemaVersion?: string;
-    now?: () => number;
-}
-interface ExecutionOutcome {
-    success: boolean;
-    stage: 'authorization' | 'claim' | 'action' | 'complete';
-    error?: string;
-    result?: NodeActionResult;
-    capabilityId?: string;
-    invocationCid?: string;
-}
-interface ExecuteNodeParams {
-    node: FlowNode;
-    actorDid: string;
-    actorType: 'entity' | 'user';
-    entityRoomId?: string;
-    context: ExecutionContext;
-    action: () => Promise<NodeActionResult>;
-    pin: string;
-}
-/**
- * Execute a node.
- *
- * The pipeline adapts based on the flow's schema version (via context.schemaVersion):
- *
- * **v0.x (legacy):** activation → action → runtime update.
- * UCAN authorization and invocations are skipped when ucanService is not available.
- *
- * **v1.0.0+:** activation → UCAN authorization → invocation → action → runtime update.
- * Requires a configured ucanService with valid delegation chains.
- */
-declare const executeNode: ({ node, actorDid, actorType, entityRoomId, context, action, pin }: ExecuteNodeParams) => Promise<ExecutionOutcome>;
-
-interface AuthorizationResult {
-    authorized: boolean;
-    reason?: string;
-    capabilityId?: string;
-    proofCids?: string[];
-}
-/**
- * Check if an actor is authorized to execute a block.
- *
- * Behaviour depends on the flow's schema version:
- * - v0.x (or no version): UCAN is optional. If ucanService is unavailable,
- *   execution is allowed without a delegation chain.
- * - v1.0.0+: UCAN is required. A valid delegation chain must exist.
- */
-declare const isAuthorized: (blockId: string, actorDid: string, ucanService: UcanService | undefined, flowUri: string, schemaVersion?: string) => Promise<AuthorizationResult>;
-
 interface ActionContext {
     actorDid: string;
     flowId: string;
@@ -294,6 +229,7 @@ interface ActionContext {
     flowUri?: string;
     handlers?: any;
     editor?: any;
+    pendingInvocation?: any;
 }
 interface ActionServices {
     http?: {
@@ -755,8 +691,79 @@ interface ActionResult {
         name: string;
         payload: Record<string, any>;
     }>;
+    completion?: {
+        state?: 'completed' | 'awaiting_readback';
+        readBack?: Record<string, any>;
+    };
 }
 
+interface NodeActionResult {
+    claimId?: string;
+    evaluationStatus?: EvaluationStatus;
+    submittedByDid?: string;
+    payload?: any;
+}
+interface ExecutionContext {
+    runtime: FlowRuntimeStateManager;
+    /** UCAN service — optional for v0.x flows, required for v1.0.0+ */
+    ucanService?: UcanService;
+    /** Invocation store — optional for v0.x flows */
+    invocationStore?: InvocationStore;
+    flowUri: string;
+    flowId: string;
+    flowOwnerDid: string;
+    /** Flow schema version. When set, controls whether UCAN is enforced. */
+    schemaVersion?: string;
+    now?: () => number;
+}
+interface ExecutionOutcome {
+    success: boolean;
+    stage: 'authorization' | 'claim' | 'action' | 'complete';
+    error?: string;
+    result?: NodeActionResult;
+    capabilityId?: string;
+    invocationCid?: string;
+}
+interface ExecuteNodeParams {
+    node: FlowNode;
+    actorDid: string;
+    actorType: 'entity' | 'user';
+    entityRoomId?: string;
+    context: ExecutionContext;
+    action: () => Promise<NodeActionResult>;
+    pin: string;
+}
+/**
+ * Execute a node.
+ *
+ * The pipeline adapts based on the flow's schema version (via context.schemaVersion):
+ *
+ * **v0.x (legacy):** activation → action → runtime update.
+ * UCAN authorization and invocations are skipped when ucanService is not available.
+ *
+ * **v1.0.0+:** activation → UCAN authorization → invocation → action → runtime update.
+ * Requires a configured ucanService with valid delegation chains.
+ */
+declare const executeNode: ({ node, actorDid, actorType, entityRoomId, context, action, pin }: ExecuteNodeParams) => Promise<ExecutionOutcome>;
+
+type ActionExecutionCompletionState = 'completed' | 'failed' | 'awaiting_readback';
+
+interface AuthorizationResult {
+    authorized: boolean;
+    reason?: string;
+    capabilityId?: string;
+    proofCids?: string[];
+}
+/**
+ * Check if an actor is authorized to execute a block.
+ *
+ * Behaviour depends on the flow's schema version:
+ * - v0.x (or no version): UCAN is optional. If ucanService is unavailable,
+ *   execution is allowed without a delegation chain.
+ * - v1.0.0+: UCAN is required. A valid delegation chain must exist.
+ */
+declare const isAuthorized: (blockId: string, actorDid: string, ucanService: UcanService | undefined, flowUri: string, schemaVersion?: string) => Promise<AuthorizationResult>;
+
 /** Registry interface expected by the compiler (keeps it pure / testable). */
 interface CompilerRegistry {
     getActionByCan(can: string): ActionDefinition | undefined;
@@ -959,7 +966,7 @@ type FlowAgentPublicNodeState = 'Pending' | 'Blocked' | 'Overdue' | 'Done';
 type FlowAgentRunPhase = 'Running' | 'Validating' | 'Failed' | 'Archived';
 type FlowAgentBlockerCause = 'missing_input' | 'failed_upstream' | 'missing_ucan' | 'stale_config' | 'service_error' | 'external_confirmation_pending' | 'validation_mismatch' | 'unknown';
 type FlowAgentCommandType = 'diagnose_blocker' | 'assign_actor' | 'notify_actor' | 'execute_action' | 'validate_external_state' | 'submit_claim' | 'watch_udid' | 'archive_flow' | 'propose_config_change';
-type FlowAgentCommandStatus = 'queued' | 'leased' | 'running' | 'confirmed' | 'failed' | 'skipped';
+type FlowAgentCommandStatus = 'queued' | 'leased' | 'running' | 'confirmed' | 'awaiting_readback' | 'failed' | 'skipped';
 type FlowAgentLedgerEventType = 'agent.decision' | 'agent.command' | 'agent.validation' | 'agent.escalation' | 'agent.memory';
 interface FlowAgentActor {
     did: string;
@@ -1040,6 +1047,8 @@ interface FlowAgentCommandResult {
     success: boolean;
     output?: Record<string, unknown>;
     confirmed?: boolean;
+    completionState?: ActionExecutionCompletionState;
+    status?: FlowAgentCommandStatus;
     error?: string;
 }
 interface FlowAgentExecutor {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ixo/editor",
-  "version": "5.18.0",
+  "version": "5.20.0-experimental.1",
   "description": "A custom BlockNote editor wrapper for IXO team",
   "main": "dist/index.mjs",
   "types": "dist/index.d.ts",