@ixo/editor 3.0.0-beta.28 → 3.0.0-beta.29

package/dist/setup-C5MpJdyr.d.ts

@@ -1,780 +0,0 @@
-import { r as FlowNode, F as FlowNodeAuthzExtension, p as FlowNodeRuntimeState, J as IxoEditorType, S as SignedCapability, B as CreateRootDelegationParams, t as StoredDelegation, G as CreateDelegationParams, H as CreateInvocationParams, w as InvocationResult, x as ExecutionWithInvocationResult, s as UcanCapability, y as DelegationChainValidationResult, z as FindProofsResult, M as MigrationReport, U as UcanDelegationStore, l as InvocationStore, E as EvaluationStatus, C as Capability, a as CapabilityValidationResult } from './index-BmOZ-1iJ.mjs';
-import { Delegation } from '@ixo/ucan';
-import { Doc, Map } from 'yjs';
-import { MatrixClient } from 'matrix-js-sdk';
-
-/** Condition that gates when a capability activates. */
-interface ConditionRef {
-    /** ID of the upstream capability whose output is checked. */
-    sourceId: string;
-    /** Output field path to inspect, e.g., "decision". */
-    field: string;
-    /** Comparison operator. */
-    operator: 'eq' | 'neq' | 'gt' | 'lt' | 'in' | 'exists';
-    /** Value to compare against (omit for 'exists'). */
-    value?: unknown;
-    /** What happens when the condition is (not) met. */
-    effect?: {
-        action: 'enable' | 'disable' | 'hide' | 'show';
-        message?: string;
-    };
-}
-/** Authorization constraint for a capability. */
-interface ActorConstraint {
-    /** Whitelisted actor DIDs. */
-    authorisedActors?: string[];
-    /** Parent capability URI for delegation chain. */
-    parentCapability?: string;
-}
-/** Time-to-live constraint for a capability. */
-interface TTLConstraint {
-    /** Hard deadline (ISO 8601 date string). */
-    absoluteDueDate?: string;
-    /** Duration from when the block becomes enabled (ISO 8601 duration, e.g., "P7D"). */
-    fromEnablement?: string;
-    /** Duration from when an actor commits (ISO 8601 duration, e.g., "PT2H"). */
-    fromCommitment?: string;
-}
-/**
- * A single capability in a Base UCAN flow plan.
- *
- * UCAN semantics:
- *   can  = the action
- *   with = the resource or scope
- *   nb   = typed caveats, inputs, parameters
- *
- * Workflow semantics (kept separate from nb):
- *   dependsOn, condition, parallelGroup, phase
- */
-interface FlowCapability {
-    /** Stable node identifier for this step. */
-    id: string;
-    /** UCAN-style ability string, e.g., "bid/submit", "email/send". */
-    can: string;
-    /** Resource URI, e.g., "ixo:flow:{flowId}" or "ixo:flow:{flowId}:{nodeId}". */
-    with: string;
-    /** Typed caveats / input parameters. Shape is dictated by the action registry. */
-    nb?: Record<string, unknown>;
-    /** IDs of upstream capabilities this depends on. */
-    dependsOn?: string[];
-    /** Condition that must be met for this capability to activate. */
-    condition?: ConditionRef;
-    /** Capabilities sharing a parallelGroup run concurrently. */
-    parallelGroup?: string;
-    /** Semantic grouping for layout lanes. */
-    phase?: string;
-    /** Who can execute this step. */
-    actor?: ActorConstraint;
-    /** Time-to-live constraints. */
-    ttl?: TTLConstraint;
-    /** Display title (falls back to can statement). */
-    title?: string;
-    /** Description of what this step does. */
-    description?: string;
-    /** Icon identifier. */
-    icon?: string;
-}
-/**
- * The Base UCAN flow plan — the intermediate representation between
- * user intent and the compiled flow graph.
- *
- * capabilities is an ordered list. Each capability carries its own stable `id`.
- */
-interface BaseUcanFlow {
-    kind: 'qi.flow.base-ucan';
-    version: '1.0';
-    flowId: string;
-    title: string;
-    goal?: string;
-    meta?: {
-        entityDid?: string;
-        flowUri?: string;
-        rootIssuer?: string;
-    };
-    /** Ordered capabilities, each with its own stable node ID. */
-    capabilities: FlowCapability[];
-}
-/** A reference to an upstream node's output field. Format: "nodeId.output.fieldPath" */
-interface RuntimeRef {
-    $ref: string;
-}
-declare function isRuntimeRef(value: unknown): value is RuntimeRef;
-/** A single block ready for insertion into BlockNote. */
-interface CompiledBlock {
-    /** Pre-generated stable block ID. */
-    id: string;
-    /** BlockNote block type (e.g., "action"). */
-    type: string;
-    /** Block props — all values are strings per BlockNote convention. */
-    props: Record<string, string>;
-}
-/** A dependency edge in the flow graph. */
-interface CompiledEdge {
-    id: string;
-    source: string;
-    target: string;
-    kind: 'dependency';
-    condition?: ConditionRef;
-}
-/** A compiled flow node stored in qi.flow.nodes. */
-interface CompiledFlowNode {
-    id: string;
-    blockId: string;
-    can: string;
-    with: string;
-    registryType: string;
-    title: string;
-    description: string;
-    props: Record<string, string>;
-    dependsOn: string[];
-    phase?: string;
-    parallelGroup?: string;
-    actor?: ActorConstraint;
-}
-/** The complete compiled output from the Base UCAN compiler. */
-interface CompiledFlow {
-    /** Flow metadata for qi.flow.meta and Y.Map('root'). */
-    meta: {
-        flowId: string;
-        title: string;
-        goal?: string;
-        version: string;
-        flowOwnerDid: string;
-        flowUri?: string;
-        compiledAt: string;
-        compiledFrom: 'BaseUcanFlow';
-    };
-    /** Blocks to insert into BlockNote, in topological order. */
-    blocks: CompiledBlock[];
-    /** Flow graph nodes, keyed by node ID. */
-    nodes: Record<string, CompiledFlowNode>;
-    /** Dependency edges. */
-    edges: CompiledEdge[];
-    /** Topological order of node IDs. */
-    order: string[];
-    /** nodeId → blockId mapping. */
-    blockIndex: Record<string, string>;
-}
-
-declare const buildAuthzFromProps: (props: Record<string, any>) => FlowNodeAuthzExtension;
-declare const buildFlowNodeFromBlock: (block: any) => FlowNode;
-
-interface FlowRuntimeStateManager {
-    get: (nodeId: string) => FlowNodeRuntimeState;
-    update: (nodeId: string, updates: Partial<FlowNodeRuntimeState>) => void;
-}
-declare const createRuntimeStateManager: (editor?: IxoEditorType | null) => FlowRuntimeStateManager;
-/**
- * Clears runtime and invocations from a Y.Doc.
- * Used when cloning a flow as a template — the new document should
- * carry only configuration (intent), not execution history.
- */
-declare function clearRuntimeForTemplateClone(yDoc: Doc): void;
-
-interface DelegationStore {
-    get: (capabilityId: string) => SignedCapability | null;
-    set: (capability: SignedCapability) => void;
-    remove: (capabilityId: string) => void;
-    getRoot: () => SignedCapability | null;
-    setRootId: (capabilityId: string) => void;
-    getAll: () => SignedCapability[];
-    has: (capabilityId: string) => boolean;
-}
-/**
- * Create a delegation store backed by Y.Map
- */
-declare const createDelegationStore: (yMap: Map<any>) => DelegationStore;
-/**
- * Create an in-memory delegation store (for testing or when Y.Map unavailable)
- */
-declare const createMemoryDelegationStore: () => DelegationStore;
-
-interface CapabilityGrant {
-    raw: string;
-    with?: string;
-    audience?: string;
-    expiresAt?: number;
-    action?: string;
-}
-type DerivedCapability = CapabilityGrant;
-interface UCANManager {
-    loadParentCapability: (capability: string) => Promise<CapabilityGrant>;
-    deriveNodeCapability: (parent: CapabilityGrant, nodeId: string, actorDid: string) => Promise<DerivedCapability>;
-    validateDerivedCapability: (derived: DerivedCapability, nodeId: string, actorDid: string) => Promise<void>;
-}
-declare class SimpleUCANManager implements UCANManager {
-    loadParentCapability(capability: string): Promise<CapabilityGrant>;
-    deriveNodeCapability(parent: CapabilityGrant, nodeId: string, actorDid: string): Promise<DerivedCapability>;
-    validateDerivedCapability(derived: DerivedCapability): Promise<void>;
-}
-
-/**
- * UCAN Service using @ixo/ucan directly
- *
- * This service provides a high-level API for:
- * - Creating and managing delegations (CAR format)
- * - Creating and validating invocations
- * - Executing actions with invocation-based authorization
- * - Migrating legacy delegations
- *
- * The host app only needs to provide the signer (private key) after PIN decryption.
- * All UCAN operations are performed using @ixo/ucan directly.
- */
-
-/**
- * Signer session scope type
- */
-type SignerSessionScope = 'session' | 'operation';
-/**
- * Signer session returned by createSignerSession
- */
-interface SignerSessionInfo {
-    sessionId: string;
-    did: string;
-    publicKey: string;
-    keyId: string;
-    expiresAt: number;
-    scope: SignerSessionScope;
-}
-/**
- * Handler functions for getting signers from the host application
- * The host app handles PIN decryption and key management
- */
-interface UcanServiceHandlers {
-    /**
-     * Get a signer for the given DID after PIN verification
-     * The host app decrypts the private key using the PIN
-     *
-     * @returns The private key in multibase format (for parseSigner)
-     * @deprecated Prefer createSignerSession for better security
-     */
-    getPrivateKey?: (params: {
-        did: string;
-        didType: 'entity' | 'user';
-        entityRoomId?: string;
-        pin: string;
-    }) => Promise<string>;
-    /**
-     * Get a signer from mnemonic (alternative to getPrivateKey)
-     * The host app retrieves and decrypts the mnemonic using the PIN
-     *
-     * @returns The mnemonic phrase
-     * @deprecated Prefer createSignerSession for better security
-     */
-    getMnemonic?: (params: {
-        did: string;
-        didType: 'entity' | 'user';
-        entityRoomId?: string;
-        pin: string;
-    }) => Promise<string>;
-    /**
-     * Create a signer session that can be used for multiple sign operations.
-     * The host app keeps the key material secure; the editor only receives an opaque handle.
-     *
-     * @param params.scope - 'session' for multiple operations, 'operation' for one-time use
-     * @param params.ttlSeconds - Time-to-live for session scope (default: 300, max: 3600)
-     */
-    createSignerSession?: (params: {
-        did: string;
-        didType: 'entity' | 'user';
-        entityRoomId?: string;
-        pin: string;
-        scope: SignerSessionScope;
-        ttlSeconds?: number;
-    }) => Promise<SignerSessionInfo>;
-    /**
-     * Sign data using an existing session.
-     * For 'operation' scope, the session is automatically invalidated after this call.
-     */
-    signWithSession?: (params: {
-        sessionId: string;
-        data: string;
-        algorithm?: 'Ed25519';
-    }) => Promise<{
-        signature: string;
-        algorithm: 'Ed25519';
-        keyId: string;
-    }>;
-    /**
-     * Release a session before it expires.
-     * Safe to call on already-released or expired sessions.
-     */
-    releaseSignerSession?: (params: {
-        sessionId: string;
-    }) => Promise<{
-        released: boolean;
-        reason?: string;
-    }>;
-    /**
-     * Create a delegation directly in the host app.
-     * The host handles all signing internally using session-based signing.
-     * This is the preferred approach for security.
-     */
-    createDelegationWithSession?: (params: {
-        sessionId: string;
-        audience: string;
-        capabilities: Array<{
-            can: string;
-            with: string;
-            nb?: Record<string, unknown>;
-        }>;
-        proofs?: string[];
-        expiration?: number;
-    }) => Promise<{
-        cid: string;
-        delegation: string;
-    }>;
-    /**
-     * Create an invocation directly in the host app.
-     * The host handles all signing internally using session-based signing.
-     * This is the preferred approach for security.
-     */
-    createInvocationWithSession?: (params: {
-        sessionId: string;
-        audience: string;
-        capability: {
-            can: string;
-            with: string;
-            nb?: Record<string, unknown>;
-        };
-        proofs: string[];
-    }) => Promise<{
-        cid: string;
-        invocation: string;
-    }>;
-}
-/**
- * Configuration for UcanService
- */
-interface UcanServiceConfig {
-    delegationStore: UcanDelegationStore;
-    invocationStore: InvocationStore;
-    handlers: UcanServiceHandlers;
-    flowOwnerDid: string;
-    flowUri: string;
-}
-/**
- * UCAN Service interface
- */
-interface UcanService {
-    createRootDelegation: (params: CreateRootDelegationParams) => Promise<StoredDelegation>;
-    createDelegation: (params: CreateDelegationParams) => Promise<StoredDelegation>;
-    revokeDelegation: (cid: string) => void;
-    getDelegation: (cid: string) => StoredDelegation | null;
-    getAllDelegations: () => StoredDelegation[];
-    getRootDelegation: () => StoredDelegation | null;
-    createAndValidateInvocation: (params: CreateInvocationParams, flowId: string, blockId?: string) => Promise<InvocationResult>;
-    executeWithInvocation: <T>(params: CreateInvocationParams, action: () => Promise<T>, flowId: string, blockId?: string) => Promise<ExecutionWithInvocationResult & {
-        actionResult?: T;
-    }>;
-    validateDelegationChain: (audienceDid: string, capability: UcanCapability) => Promise<DelegationChainValidationResult>;
-    findValidProofs: (audienceDid: string, capability: UcanCapability) => Promise<FindProofsResult>;
-    parseDelegationFromStore: (cid: string) => Promise<Delegation | null>;
-    migrateLegacyDelegation: (legacyId: string, pin: string) => Promise<StoredDelegation | null>;
-    migrateAllLegacy: (pin: string) => Promise<MigrationReport>;
-    getLegacyCount: () => number;
-    isConfigured: () => boolean;
-}
-/**
- * Create a UCAN service instance
- */
-declare const createUcanService: (config: UcanServiceConfig) => UcanService;
-
-interface NodeActionResult {
-    claimId?: string;
-    evaluationStatus?: EvaluationStatus;
-    submittedByDid?: string;
-    payload?: any;
-}
-interface ExecutionContext {
-    runtime: FlowRuntimeStateManager;
-    /** @deprecated Use delegationStore instead */
-    ucanManager?: UCANManager;
-    delegationStore?: DelegationStore;
-    verifySignature?: (capabilityRaw: string, issuerDid: string) => Promise<{
-        valid: boolean;
-        error?: string;
-    }>;
-    rootIssuer?: string;
-    flowUri?: string;
-    now?: () => number;
-}
-interface ExecutionOutcome {
-    success: boolean;
-    stage: 'activation' | 'authorization' | 'claim' | 'action' | 'complete';
-    error?: string;
-    result?: NodeActionResult;
-    capabilityId?: string;
-    /** Invocation CID (new @ixo/ucan) */
-    invocationCid?: string;
-}
-/**
- * V2 Execution context for @ixo/ucan integration
- */
-interface ExecutionContextV2 {
-    runtime: FlowRuntimeStateManager;
-    /** UCAN service for invocation-based execution */
-    ucanService?: UcanService;
-    /** Invocation store for audit trail */
-    invocationStore?: InvocationStore;
-    /** Flow URI */
-    flowUri: string;
-    /** Flow ID for invocation storage */
-    flowId: string;
-    /** Flow owner DID */
-    flowOwnerDid: string;
-    /** Current time function */
-    now?: () => number;
-    /** @deprecated Use ucanService instead */
-    ucanManager?: UCANManager;
-    /** @deprecated Use ucanService instead */
-    delegationStore?: DelegationStore;
-    /** @deprecated Use ucanService instead */
-    verifySignature?: (capabilityRaw: string, issuerDid: string) => Promise<{
-        valid: boolean;
-        error?: string;
-    }>;
-    /** @deprecated Use flowOwnerDid instead */
-    rootIssuer?: string;
-}
-/**
- * V2 Execute node params with PIN for invocation signing
- */
-interface ExecuteNodeParamsV2 {
-    node: FlowNode;
-    actorDid: string;
-    actorType: 'entity' | 'user';
-    entityRoomId?: string;
-    context: ExecutionContextV2;
-    action: () => Promise<NodeActionResult>;
-    /** PIN for signing invocation (required for @ixo/ucan) */
-    pin: string;
-}
-interface ExecuteNodeParams {
-    node: FlowNode;
-    actorDid: string;
-    context: ExecutionContext;
-    action: () => Promise<NodeActionResult>;
-}
-declare const executeNode: ({ node, actorDid, context, action }: ExecuteNodeParams) => Promise<ExecutionOutcome>;
-/**
- * V2 Execute node with invocation-based authorization
- * Creates an invocation before execution and stores it for audit trail
- */
-declare const executeNodeWithInvocation: ({ node, actorDid, actorType, entityRoomId, context, action, pin }: ExecuteNodeParamsV2) => Promise<ExecutionOutcome>;
-
-interface AuthorizationResult {
-    authorized: boolean;
-    reason?: string;
-    capabilityId?: string;
-    /** Proof chain CIDs for creating invocations (new @ixo/ucan) */
-    proofCids?: string[];
-    /** @deprecated */
-    derived?: DerivedCapability;
-}
-interface AuthorizationContext {
-    /** @deprecated Use delegationStore instead */
-    ucanManager?: UCANManager;
-    delegationStore?: DelegationStore;
-    verifySignature?: (capabilityRaw: string, issuerDid: string) => Promise<{
-        valid: boolean;
-        error?: string;
-    }>;
-    rootIssuer?: string;
-    flowUri?: string;
-}
-/**
- * Authorization context V2 for @ixo/ucan integration
- */
-interface AuthorizationContextV2 {
-    /** UCAN service for validation (new @ixo/ucan) */
-    ucanService?: UcanService;
-    /** Flow URI for resource matching */
-    flowUri?: string;
-    /** Flow owner DID (root issuer) */
-    flowOwnerDid?: string;
-    /** @deprecated Use ucanService instead */
-    ucanManager?: UCANManager;
-    /** @deprecated Use ucanService instead */
-    delegationStore?: DelegationStore;
-    /** @deprecated Use ucanService instead */
-    verifySignature?: (capabilityRaw: string, issuerDid: string) => Promise<{
-        valid: boolean;
-        error?: string;
-    }>;
-    /** @deprecated Use flowOwnerDid instead */
-    rootIssuer?: string;
-}
-declare const isActorAuthorized: (node: FlowNode, actorDid: string, context?: AuthorizationContext) => Promise<AuthorizationResult>;
-/**
- * V2 Authorization check using @ixo/ucan service
- * Returns proof chain for invocation creation
- */
-declare const isActorAuthorizedV2: (node: FlowNode, actorDid: string, context?: AuthorizationContextV2) => Promise<AuthorizationResult>;
-
-interface ActivationResult {
-    active: boolean;
-    reason?: string;
-}
-declare const isNodeActive: (node: FlowNode, runtime: FlowRuntimeStateManager) => ActivationResult;
-
-interface ValidateChainParams {
-    /** The capability to validate */
-    capability: SignedCapability;
-    /** The actor DID trying to use the capability */
-    actorDid: string;
-    /** Required capability (what the actor wants to do) */
-    requiredCapability: Capability;
-    /** The delegation store */
-    delegationStore: DelegationStore;
-    /** Handler to verify signatures */
-    verifySignature: (capabilityRaw: string, issuerDid: string) => Promise<{
-        valid: boolean;
-        error?: string;
-    }>;
-    /** Expected root issuer (entity DID) */
-    rootIssuer: string;
-}
-/**
- * Validate a capability chain back to the root
- */
-declare const validateCapabilityChain: (params: ValidateChainParams) => Promise<CapabilityValidationResult>;
-/**
- * Find a valid capability for an actor to perform an action
- */
-declare const findValidCapability: (params: {
-    actorDid: string;
-    requiredCapability: Capability;
-    delegationStore: DelegationStore;
-    verifySignature: (capabilityRaw: string, issuerDid: string) => Promise<{
-        valid: boolean;
-        error?: string;
-    }>;
-    rootIssuer: string;
-}) => Promise<{
-    found: boolean;
-    capabilityId?: string;
-    error?: string;
-}>;
-
-interface ActionContext {
-    actorDid: string;
-    flowId: string;
-    nodeId: string;
-    services: ActionServices;
-    flowNode?: any;
-    runtime?: any;
-    delegationStore?: any;
-    verifySignature?: (capabilityRaw: string, issuerDid: string) => Promise<{
-        valid: boolean;
-        error?: string;
-    }>;
-    rootIssuer?: string;
-    flowUri?: string;
-    handlers?: any;
-    editor?: any;
-}
-interface ActionServices {
-    http?: {
-        request: (params: {
-            url: string;
-            method: string;
-            headers?: Record<string, string>;
-            body?: any;
-        }) => Promise<{
-            status: number;
-            headers: Record<string, string>;
-            data: any;
-        }>;
-    };
-    email?: {
-        send: (params: {
-            to: string;
-            subject: string;
-            template: string;
-            templateVersion?: string;
-            variables?: Record<string, any>;
-            cc?: string;
-            bcc?: string;
-            replyTo?: string;
-        }) => Promise<{
-            messageId: string;
-            sentAt: string;
-        }>;
-    };
-    notify?: {
-        send: (params: {
-            channel: string;
-            to: string[];
-            cc?: string[];
-            bcc?: string[];
-            subject?: string;
-            body?: string;
-            bodyType?: 'text' | 'html';
-            from?: string;
-            replyTo?: string;
-        }) => Promise<{
-            messageId: string;
-            sentAt: string;
-        }>;
-    };
-    bid?: {
-        submitBid: (params: {
-            collectionId: string;
-            role: string;
-            surveyAnswers: Record<string, any>;
-        }) => Promise<any>;
-        approveBid: (params: {
-            bidId: string;
-            collectionId: string;
-            did: string;
-        }) => Promise<any>;
-        rejectBid: (params: {
-            bidId: string;
-            collectionId: string;
-            did: string;
-            reason: string;
-        }) => Promise<any>;
-        approveServiceAgentApplication: (params: {
-            adminAddress: string;
-            collectionId: string;
-            agentQuota: number;
-            deedDid: string;
-            currentUserAddress: string;
-        }) => Promise<void>;
-        approveEvaluatorApplication: (params: {
-            adminAddress: string;
-            collectionId: string;
-            deedDid: string;
-            evaluatorAddress: string;
-            agentQuota?: number;
-            claimIds?: string[];
-            maxAmounts?: Array<{
-                denom: string;
-                amount: string;
-            }>;
-        }) => Promise<void>;
-    };
-    claim?: {
-        requestPin: (config?: {
-            title?: string;
-            description?: string;
-            submitText?: string;
-        }) => Promise<string>;
-        submitClaim: (params: {
-            surveyData: any;
-            deedDid: string;
-            collectionId: string;
-            adminAddress: string;
-            pin: string;
-        }) => Promise<{
-            transactionHash: string;
-            claimId: string;
-        }>;
-        evaluateClaim: (granteeAddress: string, did: string, payload: {
-            claimId: string;
-            collectionId: string;
-            adminAddress: string;
-            status?: number;
-            verificationProof: string;
-            amount?: {
-                denom: string;
-                amount: string;
-            } | Array<{
-                denom: string;
-                amount: string;
-            }>;
-        }) => Promise<void>;
-        getCurrentUser: () => {
-            address: string;
-        };
-        createUdid?: (params: any) => Promise<any>;
-    };
-    matrix?: {
-        storeCredential: (params: {
-            roomId: string;
-            credentialKey: string;
-            credential: Record<string, any>;
-            cid: string;
-        }) => Promise<{
-            storedAt: string;
-            duplicate: boolean;
-        }>;
-    };
-}
-interface OutputSchemaField {
-    path: string;
-    displayName: string;
-    type: 'string' | 'number' | 'boolean' | 'object' | 'array';
-    description?: string;
-}
-interface ActionDefinition {
-    type: string;
-    /** UCAN-style ability string used by the flow compiler, e.g., "bid/submit". */
-    can?: string;
-    sideEffect: boolean;
-    defaultRequiresConfirmation: boolean;
-    requiredCapability?: string;
-    inputSchema?: object;
-    /** Static output schema for action types with predictable output (e.g. email.send).
-     *  For action types with dynamic output (e.g. http.request), the schema is user-defined in inputs. */
-    outputSchema?: OutputSchemaField[];
-    run: (inputs: Record<string, any>, ctx: ActionContext) => Promise<ActionResult>;
-}
-interface ActionResult {
-    output: Record<string, any>;
-}
-
-/** Registry interface expected by the compiler (keeps it pure / testable). */
-interface CompilerRegistry {
-    getActionByCan(can: string): ActionDefinition | undefined;
-}
-/**
- * Compile a Base UCAN flow plan into blocks, graph state, and metadata.
- *
- * This is a **pure function** — no React, no Yjs, no side effects.
- * The output is consumed by `hydrateFlowFromPlan()`.
- */
-declare function compileBaseUcanFlow(plan: BaseUcanFlow, registry: CompilerRegistry): CompiledFlow;
-
-interface SetupFlowOptions {
-    /** The Base UCAN flow plan to compile. */
-    plan: BaseUcanFlow;
-    /** Matrix room ID to hydrate the flow into. */
-    roomId: string;
-    /** Authenticated Matrix client. */
-    matrixClient: MatrixClient;
-    /** DID of the user setting up the flow. */
-    creatorDid: string;
-    /** Optional doc ID override (defaults to plan.flowId). */
-    docId?: string;
-}
-interface SetupFlowResult {
-    /** The compiled flow artifacts. */
-    compiled: CompiledFlow;
-    /** The room ID (same as input, for convenience). */
-    roomId: string;
-    /** The flow ID from the plan. */
-    flowId: string;
-}
-/**
- * One-shot function that compiles a Base UCAN flow plan and writes it
- * into a Matrix room's Y.Doc. After this completes, the room is a
- * normal flow that anyone can open via `useCreateCollaborativeIxoEditor`.
- *
- * Usage:
- * ```ts
- * const result = await setupFlowFromBaseUcan({
- *   plan: myBaseUcanFlow,
- *   roomId: '!abc:matrix.org',
- *   matrixClient,
- *   creatorDid: 'did:ixo:abc123',
- * });
- *
- * // Now open the flow through normal channels:
- * // useCreateCollaborativeIxoEditor({ roomId: result.roomId, ... })
- * ```
- */
-declare function setupFlowFromBaseUcan(options: SetupFlowOptions): Promise<SetupFlowResult>;
-
-export { isRuntimeRef as $, type AuthorizationResult as A, type BaseUcanFlow as B, type CompilerRegistry as C, type DelegationStore as D, type ExecuteNodeParams as E, type FlowRuntimeStateManager as F, type AuthorizationContextV2 as G, createUcanService as H, type UcanServiceConfig as I, type UcanServiceHandlers as J, SimpleUCANManager as K, type UCANManager as L, type CapabilityGrant as M, type NodeActionResult as N, type DerivedCapability as O, type ActionContext as P, type ActionResult as Q, type OutputSchemaField as R, type SetupFlowOptions as S, type ConditionRef as T, type UcanService as U, type ActorConstraint as V, type TTLConstraint as W, type RuntimeRef as X, type CompiledBlock as Y, type CompiledEdge as Z, type CompiledFlowNode as _, isNodeActive as a, createMemoryDelegationStore as b, createDelegationStore as c, createRuntimeStateManager as d, executeNode as e, findValidCapability as f, buildFlowNodeFromBlock as g, buildAuthzFromProps as h, isActorAuthorized as i, type ExecutionOutcome as j, type ExecutionContext as k, type AuthorizationContext as l, type ActivationResult as m, compileBaseUcanFlow as n, type SetupFlowResult as o, type FlowCapability as p, type CompiledFlow as q, type ActionDefinition as r, setupFlowFromBaseUcan as s, type ActionServices as t, clearRuntimeForTemplateClone as u, validateCapabilityChain as v, executeNodeWithInvocation as w, type ExecuteNodeParamsV2 as x, type ExecutionContextV2 as y, isActorAuthorizedV2 as z };