@ixo/editor 6.32.1 → 6.34.0

package/dist/{connections-1NtNQrsY.d.ts → connections-CEcurtWI.d.ts}

@@ -1,11 +1,8 @@
-import { a6 as FlowNodeAuthzExtension, a7 as FlowNode, a8 as EvaluationStatus, F as FlowRuntimeStateManager, G as UcanService, g as InvocationStore, a9 as IxoEditorType, aa as PendingInvocation, ab as ActionServices, ac as ActionHandlers, ad as RunEventAppender, ae as TopicExecutionContext, af as TopicActionBridge, ag as ActionResult, ah as TopicActionWriteBackResult, U as UcanCapability, ai as FlowNodeRuntimeState, z as UcanDelegationStore, v as StoredDelegation, aj as ActionDefinition } from './runtime-BFwvCQDF.js';
+import { a6 as FlowNodeAuthzExtension, a7 as FlowNode, a8 as EvaluationStatus, F as FlowRuntimeStateManager, G as UcanService, g as InvocationStore, U as UcanCapability, a9 as IxoEditorType, aa as PendingInvocation, ab as ActionServices, ac as ActionHandlers, ad as RunEventAppender, ae as TopicExecutionContext, af as TopicActionBridge, ag as DesignPodRuntimeAuthorityV1, ah as ActionResult, ai as TopicActionWriteBackResult, aj as FlowNodeRuntimeState, z as UcanDelegationStore, v as StoredDelegation, ak as ActionDefinition, al as DesignPodMethodId } from './types-Dqk5MTfW.js';
 import * as Y from 'yjs';
 import { Doc, Map } from 'yjs';
 import { MatrixClient } from 'matrix-js-sdk';
 
-declare const buildAuthzFromProps: (props: Record<string, any>) => FlowNodeAuthzExtension;
-declare const buildFlowNodeFromBlock: (block: any) => FlowNode;
-
 /** Condition that gates when a capability activates. */
 interface ConditionRef {
     /** ID of the upstream capability whose output is checked. */
@@ -224,6 +221,9 @@ interface CompiledFlow {
 /** Strategy for how a compiled flow is applied to an existing document. */
 type FlowStrategy = 'full' | 'merge' | 'patch';
 
+declare const buildAuthzFromProps: (props: Record<string, any>) => FlowNodeAuthzExtension;
+declare const buildFlowNodeFromBlock: (block: any) => FlowNode;
+
 /**
  * Context passed to resolveRuntimeRefs when resolving inputs for a triggered
  * listener block. The runtime constructs this from a PendingInvocation when
@@ -300,7 +300,18 @@ interface ExecuteNodeParams {
     actorType: 'entity' | 'user';
     entityRoomId?: string;
     context: ExecutionContext;
-    action: () => Promise<NodeActionResult>;
+    action: (proof: {
+        invocationCid?: string;
+        /** Signed UCAN CAR for authority checks that must complete before the invocation audit record can be finalized. */
+        invocation?: string;
+        capabilityId?: string;
+        proofCids: string[];
+        capability: UcanCapability;
+        facts: Record<string, unknown>;
+    }) => Promise<NodeActionResult>;
+    invocationFacts?: Record<string, unknown>;
+    /** Require a persisted UCAN invocation regardless of the temporary global policy bypass. */
+    requireSignedInvocation?: boolean;
     pin: string;
 }
 /**
@@ -314,7 +325,7 @@ interface ExecuteNodeParams {
  * **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>;
+declare const executeNode: ({ node, actorDid, actorType, entityRoomId, context, action, invocationFacts, requireSignedInvocation, pin, }: ExecuteNodeParams) => Promise<ExecutionOutcome>;
 
 type ActionBlockLike = {
     id?: string;
@@ -373,6 +384,8 @@ interface ExecuteActionBlockParams extends BuildActionRunInputsParams {
     executorDid?: string;
     /** Pinned Flow revision or digest used by Topic bindings and receipts. */
     flowRevision?: string;
+    /** Portal-owned entity/room/session authority for Design POD actions. */
+    designPodAuthority?: DesignPodRuntimeAuthorityV1;
 }
 interface ExecuteActionBlockResult {
     success: boolean;
@@ -419,6 +432,10 @@ interface AuthorizationResult {
     capabilityId?: string;
     proofCids?: string[];
 }
+interface AuthorizationOptions {
+    /** Ignore the temporary version-policy bypass and require a real proof chain. */
+    requireSignedInvocation?: boolean;
+}
 /**
  * Check if an actor is authorized to execute a block.
  *
@@ -427,11 +444,11 @@ interface AuthorizationResult {
  *   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>;
+declare const isAuthorized: (blockId: string, actorDid: string, ucanService: UcanService | undefined, flowUri: string, schemaVersion?: string, options?: AuthorizationOptions) => Promise<AuthorizationResult>;
 
 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' | 'unverified_completion' | 'awaiting_verification' | 'unknown';
+type FlowAgentBlockerCause = 'missing_input' | 'failed_upstream' | 'missing_ucan' | 'stale_config' | 'service_error' | 'external_confirmation_pending' | 'validation_mismatch' | 'awaiting_verification' | 'unknown';
 type FlowAgentCommandType = 'diagnose_blocker' | 'assign_actor' | 'notify_actor' | 'execute_action' | 'validate_external_state' | 'archive_flow' | 'propose_config_change';
 type FlowAgentCommandStatus = 'queued' | 'leased' | 'running' | 'confirmed' | 'awaiting_readback' | 'failed' | 'skipped';
 type FlowAgentLedgerEventType = 'agent.decision' | 'agent.command' | 'agent.validation' | 'agent.escalation' | 'agent.memory';
@@ -852,6 +869,20 @@ declare function readFlow(): ReadFlowResult | null;
  * - `patch`: replaces matching nodes and adds new ones.
  */
 declare function setupFlowFromBaseUcan(options: SetupFlowOptions): Promise<SetupFlowResult>;
+interface SeedDesignPodTemplateOptions {
+    methodId: DesignPodMethodId;
+    roomId: string;
+    matrixClient: MatrixClient;
+    creatorDid: string;
+}
+/**
+ * Turn an empty room into a ready Design POD template in one connection: the
+ * journey plan compiled into blocks AND the method manifest pinned. The
+ * headless replacement for the seed panel, which did these as two steps
+ * against an open editor — creation-time seeding has no editor to lean on,
+ * and two connections would race their own flushes.
+ */
+declare function seedDesignPodTemplateFlow(options: SeedDesignPodTemplateOptions): Promise<SetupFlowResult>;
 
 /**
  * Read the current compiled flow state from a live Y.Doc.
@@ -908,6 +939,13 @@ type FlowParticipant = {
      * Absent when the participant needs none.
      */
     requires?: string[];
+    /**
+     * Block ids of the steps this participant may carry out. Absent when none
+     * were chosen — being on the roster is not the same as being allowed to
+     * execute: plenty of actors are only there to watch. A step id that no longer
+     * exists in the document is ignored.
+     */
+    steps?: string[];
     /** Epoch ms. Supplied by the caller — this module never calls `Date.now()`. */
     addedAt?: number;
 };
@@ -946,6 +984,12 @@ declare function setFlowParticipantPowerLevel(yDoc: Doc, userId: string, powerLe
  * reason as {@link setFlowParticipantPowerLevel}.
  */
 declare function setFlowParticipantRequirements(yDoc: Doc, userId: string, requires: string[]): void;
+/**
+ * Replace the steps an existing participant may carry out. Pass `[]` to take
+ * every step away and leave them watching. No-op when the participant is not on
+ * the roster, for the same reason as {@link setFlowParticipantPowerLevel}.
+ */
+declare function setFlowParticipantSteps(yDoc: Doc, userId: string, steps: string[]): void;
 
 /**
  * Top-level Y.Doc map holding the integrations a flow needs, keyed by toolkit
@@ -974,6 +1018,17 @@ type FlowConnection = {
     label?: string;
     /** Absent/false = required. True = the flow may start without it. */
     optional?: boolean;
+    /**
+     * Whether the flow's automated agent acts through this connection, decided by
+     * the template author. Deliberately tri-state: `true` and `false` are both an
+     * answer, and absent means nobody has answered yet, so a reader falls back to
+     * inferring it from the agent-owned steps. A template written before this
+     * field existed carries no answer and must keep behaving as it did.
+     *
+     * It governs what the flow ASKS FOR, never what an actor may be given: a
+     * person can grant the agent any connection at flow time regardless.
+     */
+    agent?: boolean;
     requires: FlowConnectionRequirementKey[];
     /** Epoch ms. Supplied by the caller — this module never calls `Date.now()`. */
     addedAt?: number;
@@ -1022,6 +1077,16 @@ declare function removeFlowConnection(yDoc: Doc, toolkit: string): void;
  * from one would invent a requirement nobody declared.
  */
 declare function setFlowConnectionOptional(yDoc: Doc, toolkit: string, optional: boolean): void;
+/**
+ * Record whether the flow's automated agent acts through this connection. No-op
+ * when the flow has no entry for `toolkit`, for the same reason as
+ * {@link setFlowConnectionOptional}.
+ *
+ * `false` is written, not erased: "the agent does not use this" is an answer
+ * the author gave, and erasing it would hand the question back to the
+ * step-based inference the author was overriding.
+ */
+declare function setFlowConnectionAgent(yDoc: Doc, toolkit: string, agent: boolean): void;
 /**
  * Replace an existing connection's sub-selection requirements. No-op when the
  * flow has no entry for `toolkit`, for the same reason as
@@ -1053,4 +1118,4 @@ declare function upsertFlowConnectionBinding(yDoc: Doc, binding: FlowConnectionB
 /** Remove a binding. No-op when the flow has no binding for `toolkit`. */
 declare function removeFlowConnectionBinding(yDoc: Doc, toolkit: string): void;
 
-export { readCompiledFlowFromYDoc as $, type AuthorizationResult as A, type BaseUcanFlow as B, type CompiledFlow as C, appendAgentLedgerEvent as D, type ExecuteNodeParams as E, FLOW_CONNECTIONS_MAP_KEY as F, buildAuthzFromProps as G, buildFlowAgentContext as H, buildFlowNodeFromBlock as I, cleanupExpiredFlowAgentLeases as J, compileBaseUcanFlow as K, createAgentCommand as L, type MergeResult as M, type NodeActionResult as N, decompileToBaseUcanFlow as O, evaluateFlowAgentPolicy as P, executeNode as Q, type ReadFlowOptions as R, type SetupFlowOptions as S, executeQueuedAgentCommands as T, getActiveEditor as U, getFlowAgentMaps as V, isAuthorized as W, mergeCompiledFlows as X, planRalphLoopCommands as Y, queueAgentCommand as Z, readAgentLedgerEvents as _, type BuildFlowAgentContextParams as a, resourceMatches as a$, readFlow as a0, readFlowAsBaseUcan as a1, readFlowConnectionBindings as a2, readFlowConnections as a3, readFlowFromEditor as a4, readFlowParticipants as a5, readQueuedAgentCommands as a6, releaseFlowAgentLease as a7, removeFlowConnection as a8, removeFlowConnectionBinding as a9, type ExecuteActionBlockParams as aA, type ExecuteActionBlockResult as aB, type FlowAgentCommandBase as aC, type FlowAgentCommandStatus as aD, type FlowAgentCommandType as aE, type FlowAgentLedgerEvent as aF, type FlowAgentLedgerEventType as aG, type FlowAgentMaps as aH, type FlowAgentOrchestratorOptions as aI, type FlowAgentPolicyDecision as aJ, type FlowAgentRunPhase as aK, type FlowAgentServiceOptions as aL, type RuntimeRef as aM, type TTLConstraint as aN, type TriggerResolutionContext as aO, type TriggerSpec as aP, buildActionRunInputs as aQ, canMatches as aR, computeAgentCommandId as aS, executeActionBlock as aT, isCapabilityMatch as aU, isExternalMutation as aV, isRuntimeRef as aW, readAgentCommands as aX, readFlowAgentLeases as aY, requiredCapabilityForCommand as aZ, resolveRuntimeRefs as a_, removeFlowParticipant as aa, setActiveEditor as ab, setFlowConnectionOptional as ac, setFlowConnectionRequires as ad, setFlowParticipantPowerLevel as ae, setFlowParticipantRequirements as af, setupFlowFromBaseUcan as ag, tickFlowAgent as ah, upsertFlowConnection as ai, upsertFlowConnectionBinding as aj, upsertFlowParticipant as ak, validateAgentCommand as al, validateFlowAgentLease as am, type FlowAgentBlockerCause as an, type CompiledBlock as ao, type CompiledEdge as ap, type AcquireFlowAgentLeaseParams as aq, type ActionBlockLike as ar, type ActionExecutionCompletionState as as, type ActorConstraint as at, type BuildActionRunInputsParams as au, type BuildActionRunInputsResult as av, type CompiledFlowNode as aw, type ConditionRef as ax, type CreateAgentCommandParams as ay, type EvaluateFlowAgentPolicyParams as az, type CompilerRegistry as b, updateAgentCommand as b0, type ExecutionContext as c, type ExecutionOutcome as d, FLOW_CONNECTION_BINDINGS_MAP_KEY as e, FLOW_PARTICIPANTS_MAP_KEY as f, type FlowAgentActor as g, type FlowAgentCommand as h, type FlowAgentCommandResult as i, type FlowAgentContext as j, type FlowAgentExecutor as k, type FlowAgentLease as l, type FlowAgentNodeSnapshot as m, type FlowAgentPublicNodeState as n, FlowAgentService as o, type FlowAgentTickResult as p, type FlowCapability as q, type FlowConnection as r, type FlowConnectionBinding as s, type FlowConnectionRequirementKey as t, type FlowParticipant as u, type FlowStrategy as v, type ReadFlowResult as w, type ReadableEditor as x, type SetupFlowResult as y, acquireFlowAgentLease as z };
+export { readCompiledFlowFromYDoc as $, type AuthorizationResult as A, type BaseUcanFlow as B, type CompiledFlow as C, appendAgentLedgerEvent as D, type ExecuteNodeParams as E, FLOW_CONNECTIONS_MAP_KEY as F, buildAuthzFromProps as G, buildFlowAgentContext as H, buildFlowNodeFromBlock as I, cleanupExpiredFlowAgentLeases as J, compileBaseUcanFlow as K, createAgentCommand as L, type MergeResult as M, type NodeActionResult as N, decompileToBaseUcanFlow as O, evaluateFlowAgentPolicy as P, executeNode as Q, type ReadFlowOptions as R, type SetupFlowOptions as S, executeQueuedAgentCommands as T, getActiveEditor as U, getFlowAgentMaps as V, isAuthorized as W, mergeCompiledFlows as X, planRalphLoopCommands as Y, queueAgentCommand as Z, readAgentLedgerEvents as _, type BuildFlowAgentContextParams as a, requiredCapabilityForCommand as a$, readFlow as a0, readFlowAsBaseUcan as a1, readFlowConnectionBindings as a2, readFlowConnections as a3, readFlowFromEditor as a4, readFlowParticipants as a5, readQueuedAgentCommands as a6, releaseFlowAgentLease as a7, removeFlowConnection as a8, removeFlowConnectionBinding as a9, type EvaluateFlowAgentPolicyParams as aA, type ExecuteActionBlockParams as aB, type ExecuteActionBlockResult as aC, type FlowAgentCommandBase as aD, type FlowAgentCommandStatus as aE, type FlowAgentCommandType as aF, type FlowAgentLedgerEvent as aG, type FlowAgentLedgerEventType as aH, type FlowAgentMaps as aI, type FlowAgentOrchestratorOptions as aJ, type FlowAgentPolicyDecision as aK, type FlowAgentRunPhase as aL, type FlowAgentServiceOptions as aM, type RuntimeRef as aN, type SeedDesignPodTemplateOptions as aO, type TTLConstraint as aP, type TriggerResolutionContext as aQ, type TriggerSpec as aR, buildActionRunInputs as aS, canMatches as aT, computeAgentCommandId as aU, executeActionBlock as aV, isCapabilityMatch as aW, isExternalMutation as aX, isRuntimeRef as aY, readAgentCommands as aZ, readFlowAgentLeases as a_, removeFlowParticipant as aa, setActiveEditor as ab, setFlowConnectionAgent as ac, setFlowConnectionOptional as ad, setFlowConnectionRequires as ae, setFlowParticipantPowerLevel as af, setFlowParticipantRequirements as ag, setupFlowFromBaseUcan as ah, tickFlowAgent as ai, upsertFlowConnection as aj, upsertFlowConnectionBinding as ak, upsertFlowParticipant as al, validateAgentCommand as am, validateFlowAgentLease as an, type FlowAgentBlockerCause as ao, type CompiledBlock as ap, type CompiledEdge as aq, type AcquireFlowAgentLeaseParams as ar, type ActionBlockLike as as, type ActionExecutionCompletionState as at, type ActorConstraint as au, type BuildActionRunInputsParams as av, type BuildActionRunInputsResult as aw, type CompiledFlowNode as ax, type ConditionRef as ay, type CreateAgentCommandParams as az, type CompilerRegistry as b, resolveRuntimeRefs as b0, resourceMatches as b1, seedDesignPodTemplateFlow as b2, setFlowParticipantSteps as b3, updateAgentCommand as b4, type ExecutionContext as c, type ExecutionOutcome as d, FLOW_CONNECTION_BINDINGS_MAP_KEY as e, FLOW_PARTICIPANTS_MAP_KEY as f, type FlowAgentActor as g, type FlowAgentCommand as h, type FlowAgentCommandResult as i, type FlowAgentContext as j, type FlowAgentExecutor as k, type FlowAgentLease as l, type FlowAgentNodeSnapshot as m, type FlowAgentPublicNodeState as n, FlowAgentService as o, type FlowAgentTickResult as p, type FlowCapability as q, type FlowConnection as r, type FlowConnectionBinding as s, type FlowConnectionRequirementKey as t, type FlowParticipant as u, type FlowStrategy as v, type ReadFlowResult as w, type ReadableEditor as x, type SetupFlowResult as y, acquireFlowAgentLease as z };