@ixo/editor 5.33.0 → 5.34.0

package/dist/{chunk-NAR2R3YM.mjs → chunk-TK2RJ4KB.mjs}

@@ -357,6 +357,14 @@ registerAction({
   can: "pod/domain-indexer-lookup",
   sideEffect: false,
   defaultRequiresConfirmation: false,
+  inputSchema: {
+    type: "object",
+    required: [],
+    properties: {
+      userMessage: { type: "string", description: "The user-provided purpose text used to query the Domain Indexer." },
+      purposeDescription: { type: "string", description: "Fallback purpose text used when userMessage is absent." }
+    }
+  },
   outputSchema: [
     { path: "purposeDescription", displayName: "Purpose Description", type: "string", description: "The user-provided purpose text" },
     { path: "blueprintCandidates", displayName: "Blueprint Candidates", type: "array", description: "Ranked array of matching blueprint DIDs and metadata" }
@@ -388,6 +396,15 @@ registerAction({
   can: "pod/domain-single-selection",
   sideEffect: false,
   defaultRequiresConfirmation: false,
+  inputSchema: {
+    type: "object",
+    required: ["selectedBlueprintDid"],
+    properties: {
+      selectedBlueprintDid: { type: "string", description: "DID of the blueprint to select." },
+      selectedBlueprintName: { type: "string", description: "Display name of the selected blueprint." },
+      selectedBlueprintDescription: { type: "string", description: "Description of the selected blueprint." }
+    }
+  },
   outputSchema: [
     { path: "selectedBlueprintDid", displayName: "Selected Blueprint DID", type: "string", description: "DID of the selected blueprint" },
     { path: "selectedBlueprintName", displayName: "Selected Blueprint Name", type: "string", description: "Display name of the selected blueprint" },
@@ -433,6 +450,16 @@ registerAction({
   can: "pod/entity-single-selection",
   sideEffect: false,
   defaultRequiresConfirmation: false,
+  inputSchema: {
+    type: "object",
+    required: [],
+    properties: {
+      skipped: { type: "boolean", description: "True to skip selecting a parent entity, leaving parentDID null." },
+      selectedEntityDid: { type: "string", description: "DID of the selected parent entity; required when not skipping." },
+      selectedEntityName: { type: "string", description: "Display name of the selected parent entity." },
+      selectedEntityType: { type: "string", description: "Entity type of the selected parent entity." }
+    }
+  },
   outputSchema: [
     { path: "selectedEntityDid", displayName: "Selected Entity DID", type: "string", description: "DID of the selected parent entity, or null if skipped" },
     { path: "selectedEntityName", displayName: "Selected Entity Name", type: "string", description: "Display name of the selected parent entity" },
@@ -481,6 +508,17 @@ registerAction({
   can: "pod/member-multi-select",
   sideEffect: false,
   defaultRequiresConfirmation: false,
+  inputSchema: {
+    type: "object",
+    required: [],
+    properties: {
+      groupType: { type: "string", description: "Governance group type that determines which member fields apply; defaults to categorical." },
+      members: { type: "array", description: "Array of { did, role, votingPower } members; required for categorical and multisig groups." },
+      multisigThreshold: { type: "number", description: "Minimum number of signers required; used for multisig groups." },
+      nftContractAddress: { type: "string", description: "NFT staking contract address; required for nftStaking groups." },
+      tokenConfig: { type: "object", description: "Token configuration; required for tokenStaking groups." }
+    }
+  },
   outputSchema: [
     { path: "members", displayName: "Members", type: "array", description: "Array of { did, role, votingPower } \u2014 categorical/multisig only" },
     { path: "multisigThreshold", displayName: "Multisig Threshold", type: "number", description: "Minimum signers required \u2014 multisig only" },
@@ -563,6 +601,15 @@ registerAction({
   can: "pod/governance-config",
   sideEffect: false,
   defaultRequiresConfirmation: false,
+  inputSchema: {
+    type: "object",
+    required: ["groupName", "groupType", "governance"],
+    properties: {
+      groupName: { type: "string", description: "Human-readable name for the governance group." },
+      groupType: { type: "string", description: "Governance group type: categorical, multisig, nftStaking, or tokenStaking." },
+      governance: { type: "object", description: "Cosmos group decision policy parameters; must include votingPeriod." }
+    }
+  },
   outputSchema: [
     { path: "groupName", displayName: "Group Name", type: "string", description: "Human-readable name for the governance group" },
     { path: "groupType", displayName: "Group Type", type: "string", description: "Governance group type (categorical | multisig | nftStaking | tokenStaking)" },
@@ -638,6 +685,14 @@ registerAction({
   can: "pod/list-domain-flows",
   sideEffect: false,
   defaultRequiresConfirmation: false,
+  inputSchema: {
+    type: "object",
+    required: [],
+    properties: {
+      selectedProtocolTemplates: { type: "array", description: "Selected protocol templates, each with protocolDid and sourceRoomId; empty selection is valid." },
+      selectedFlowDids: { type: "array", description: "Source Matrix room IDs for selected templates; used as a fallback when no templates are selected." }
+    }
+  },
   outputSchema: [
     {
       path: "selectedProtocolTemplates",
@@ -939,6 +994,17 @@ registerAction({
   // to invoke it when the upstream event fires. See §3.6 of the
   // events-and-triggers plan.
   eligibleForEventTrigger: true,
+  inputSchema: {
+    type: "object",
+    required: ["endpoint"],
+    properties: {
+      endpoint: { type: "string", description: "The request URL. Either endpoint or its alias url must be provided." },
+      url: { type: "string", description: "Alias for endpoint; the request URL. Either url or endpoint satisfies the URL requirement." },
+      method: { type: "string", description: "HTTP method (GET, POST, etc.). Defaults to GET." },
+      headers: { type: "object", description: "Request headers as a key/value map." },
+      body: { type: "string", description: "Request body; sent for non-GET methods. Accepts a string or an object (serialized to JSON)." }
+    }
+  },
   run: async (inputs, ctx) => {
     const endpoint = inputs.endpoint ?? inputs.url;
     const url = typeof endpoint === "string" ? endpoint : "";
@@ -989,6 +1055,21 @@ registerAction({
   // When wired as a listener, the assignee on the email block is DM'd to
   // invoke it for each pending event. See docs/events-and-triggers-plan.md §3.6.
   eligibleForEventTrigger: true,
+  inputSchema: {
+    type: "object",
+    required: ["to", "templateName"],
+    properties: {
+      to: { type: "string", description: "Recipient email address." },
+      templateName: { type: "string", description: "The email template to send. A template is required \u2014 either templateName or its alias template must be provided." },
+      template: { type: "string", description: "Alias for templateName; the template id to send. Either template or templateName satisfies the template requirement." },
+      subject: { type: "string", description: "Email subject line." },
+      templateVersion: { type: "string", description: "Optional specific version of the template to render." },
+      variables: { type: "object", description: "Template variables to interpolate; may be passed as an object or a JSON string." },
+      cc: { type: "string", description: "Carbon-copy recipient address." },
+      bcc: { type: "string", description: "Blind-carbon-copy recipient address." },
+      replyTo: { type: "string", description: "Reply-to address for the email." }
+    }
+  },
   outputSchema: [
     { path: "messageId", displayName: "Message ID", type: "string", description: "The unique ID of the sent email" },
     { path: "sentAt", displayName: "Sent At", type: "string", description: "Timestamp when the email was sent" }
@@ -1035,6 +1116,13 @@ registerAction({
   sideEffect: true,
   defaultRequiresConfirmation: false,
   requiredCapability: "flow/execute",
+  inputSchema: {
+    type: "object",
+    required: [],
+    properties: {
+      checked: { type: "boolean", description: "Whether the checkbox should be checked (defaults to true)." }
+    }
+  },
   run: async (inputs) => {
     const checked = inputs.checked !== void 0 ? !!inputs.checked : true;
     return { output: { checked } };
@@ -1069,6 +1157,13 @@ function registerFormSubmitAction(type, can) {
     sideEffect: true,
     defaultRequiresConfirmation: false,
     requiredCapability: "flow/execute",
+    inputSchema: {
+      type: "object",
+      required: [],
+      properties: {
+        answers: { type: "object", description: "Form answers as an object or JSON-string object; also read from form.answers." }
+      }
+    },
     outputSchema: [
       { path: "form.answers", displayName: "Form Answers JSON", type: "string", description: "JSON stringified form answers, matching form block runtime output." },
       { path: "answers", displayName: "Form Answers", type: "object", description: "Parsed form answers object for convenience." }
@@ -1097,6 +1192,21 @@ registerAction({
   sideEffect: true,
   defaultRequiresConfirmation: true,
   requiredCapability: "notify/send",
+  inputSchema: {
+    type: "object",
+    required: ["to"],
+    properties: {
+      channel: { type: "string", description: "Delivery channel for the notification." },
+      to: { type: "array", description: "Recipient(s); a single value or array, at least one required." },
+      cc: { type: "array", description: "CC recipients." },
+      bcc: { type: "array", description: "BCC recipients." },
+      subject: { type: "string", description: "Notification subject." },
+      body: { type: "string", description: "Notification body content." },
+      bodyType: { type: "string", description: "Body format: 'text' or 'html'." },
+      from: { type: "string", description: "Sender address." },
+      replyTo: { type: "string", description: "Reply-to address." }
+    }
+  },
   run: async (inputs, ctx) => {
     if (!ctx.services.notify) {
       throw new Error("Notification service not configured");
@@ -1138,6 +1248,16 @@ registerAction({
   sideEffect: true,
   defaultRequiresConfirmation: true,
   requiredCapability: "flow/block/execute",
+  inputSchema: {
+    type: "object",
+    required: ["collectionId", "role", "surveyAnswers"],
+    properties: {
+      collectionId: { type: "string", description: "Claim collection identifier the bid is submitted against." },
+      role: { type: "string", description: "Bid role: service_agent or evaluation_agent." },
+      surveyAnswers: { type: "object", description: "Survey answers object (or a JSON string parsed to an object) attached to the bid." },
+      deedDid: { type: "string", description: "Optional deed/entity DID associated with the bid." }
+    }
+  },
   outputSchema: [
     { path: "bidId", displayName: "Bid ID", type: "string", description: "The submitted bid identifier" },
     { path: "collectionId", displayName: "Collection ID", type: "string", description: "Claim collection identifier" },
@@ -1224,6 +1344,22 @@ registerAction({
     { path: "applicantDid", displayName: "Applicant DID", type: "string", description: "Applicant DID" },
     { path: "applicantAddress", displayName: "Applicant Address", type: "string", description: "Applicant wallet address" }
   ],
+  inputSchema: {
+    type: "object",
+    required: ["decision", "bidId", "collectionId", "deedDid", "role", "applicantDid", "applicantAddress"],
+    properties: {
+      decision: { type: "string", description: "Evaluation decision: approve or reject." },
+      bidId: { type: "string", description: "Identifier of the bid being evaluated." },
+      collectionId: { type: "string", description: "Claim collection identifier." },
+      deedDid: { type: "string", description: "Deed (entity) DID." },
+      role: { type: "string", description: "Applicant role: service_agent (sa) or evaluation_agent (ea)." },
+      applicantDid: { type: "string", description: "Applicant DID." },
+      applicantAddress: { type: "string", description: "Applicant wallet address." },
+      adminAddress: { type: "string", description: "Entity admin account address; required when decision is approve." },
+      maxAmounts: { type: "string", description: "JSON-encoded per-claim max amounts for the evaluation_agent approval." },
+      reason: { type: "string", description: "Rejection reason; required when decision is reject." }
+    }
+  },
   run: async (inputs, ctx) => {
     const service = ctx.services.bid;
     if (!service) {
@@ -1424,6 +1560,17 @@ registerAction({
   defaultRequiresConfirmation: true,
   requiredCapability: "flow/block/execute",
   eligibleForEventTrigger: true,
+  inputSchema: {
+    type: "object",
+    required: ["deedDid", "collectionId", "adminAddress", "surveyAnswers"],
+    properties: {
+      deedDid: { type: "string", description: "The entity/deed DID that owns the claim collection." },
+      collectionId: { type: "string", description: "The claim collection to submit into." },
+      adminAddress: { type: "string", description: "The claim collection admin's chain address." },
+      surveyAnswers: { type: "object", description: "The claim's answer data (the submitted form); may be passed as an object or a JSON string." },
+      pin: { type: "string", description: "Verification PIN; requested at runtime if omitted." }
+    }
+  },
   // Static fallback — used until a collection is picked and the survey
   // schema is materialised. `getDynamicOutputSchema` takes over after that.
   outputSchema: BASELINE_OUTPUT,
@@ -2132,6 +2279,30 @@ registerAction({
       }
     ];
   },
+  inputSchema: {
+    type: "object",
+    required: ["decision", "claimId", "collectionId", "deedDid", "adminAddress"],
+    properties: {
+      decision: { type: "string", description: "Evaluation decision: approve or reject." },
+      claimId: { type: "string", description: "Identifier of the claim being evaluated." },
+      collectionId: { type: "string", description: "Claim collection identifier." },
+      deedDid: { type: "string", description: "Deed (entity) DID." },
+      adminAddress: { type: "string", description: "Entity admin account address for the on-chain evaluation." },
+      amount: { type: "object", description: "Payout coin (denom + amount); accepts a JSON string, object, or array." },
+      createUdid: { type: "boolean", description: "Whether to generate and sign a verification UDID proof." },
+      capabilityCid: { type: "string", description: "Capability CID used when creating the UDID; defaults to deedDid." },
+      rubricAuthority: { type: "string", description: "Rubric authority used when creating the UDID; defaults to deedDid." },
+      rubricId: { type: "string", description: "Rubric identifier used when creating the UDID; defaults to deedDid." },
+      granteeAddress: { type: "string", description: "Evaluator address; resolves to the current user when omitted." },
+      verificationProof: { type: "string", description: "Pre-existing verification proof URL; skips UDID creation when set." },
+      traceCid: { type: "string", description: "Trace CID passed through to the UDID." },
+      items: { type: "array", description: "Evaluation items passed through to the UDID." },
+      patch: { type: "object", description: "Patch object passed through to the UDID." },
+      xeroInvoiceBlockId: { type: "string", description: "Bound Xero invoice block id to queue invoice work on approval." },
+      xeroPaymentBlockId: { type: "string", description: "Bound Xero payment block id used when resolving Xero bindings." },
+      claimSnapshot: { type: "object", description: "Claim snapshot used to build the Xero invoice scope." }
+    }
+  },
   run: async (inputs, ctx) => {
     const service = ctx.services.claim;
     if (!service) {
@@ -2345,6 +2516,16 @@ registerAction({
   sideEffect: true,
   defaultRequiresConfirmation: true,
   requiredCapability: "flow/block/execute",
+  inputSchema: {
+    type: "object",
+    required: ["coreAddress", "title", "description"],
+    properties: {
+      coreAddress: { type: "string", description: "The DAO core contract address." },
+      title: { type: "string", description: "The proposal title." },
+      description: { type: "string", description: "The proposal description." },
+      actions: { type: "array", description: "Optional proposal actions (array or JSON string array)." }
+    }
+  },
   outputSchema: [
     { path: "proposalId", displayName: "Proposal ID", type: "string", description: "The on-chain proposal identifier" },
     { path: "status", displayName: "Proposal Status", type: "string", description: "Current proposal status (open, passed, rejected, executed, etc.)" },
@@ -2412,6 +2593,16 @@ registerAction({
   sideEffect: true,
   defaultRequiresConfirmation: true,
   requiredCapability: "flow/block/execute",
+  inputSchema: {
+    type: "object",
+    required: ["proposalId", "vote", "proposalContractAddress"],
+    properties: {
+      proposalId: { type: "number", description: "The proposal number to vote on." },
+      vote: { type: "string", description: "The vote to cast: yes, no, no_with_veto, or abstain." },
+      proposalContractAddress: { type: "string", description: "The proposal module contract address." },
+      rationale: { type: "string", description: "Optional rationale provided with the vote." }
+    }
+  },
   outputSchema: [
     { path: "vote", displayName: "Vote", type: "string", description: "The vote cast (yes, no, no_with_veto, abstain)" },
     { path: "rationale", displayName: "Rationale", type: "string", description: "Optional rationale provided with the vote" },
@@ -2457,6 +2648,15 @@ registerAction({
   can: "protocol/select",
   sideEffect: false,
   defaultRequiresConfirmation: false,
+  inputSchema: {
+    type: "object",
+    required: ["selectedProtocolDid"],
+    properties: {
+      selectedProtocolDid: { type: "string", description: "DID of the protocol to select." },
+      selectedProtocolName: { type: "string", description: "Display name of the selected protocol." },
+      selectedProtocolType: { type: "string", description: "Type of the selected protocol." }
+    }
+  },
   outputSchema: [
     { path: "selectedProtocolDid", displayName: "Selected Protocol DID", type: "string", description: "DID of the selected protocol" },
     { path: "selectedProtocolName", displayName: "Selected Protocol Name", type: "string", description: "Display name of the selected protocol" },
@@ -3724,6 +3924,28 @@ registerAction({
   defaultRequiresConfirmation: true,
   requiredCapability: "flow/block/execute",
   eligibleForEventTrigger: true,
+  inputSchema: {
+    type: "object",
+    required: ["domainCardData"],
+    properties: {
+      domainCardData: {
+        type: "object",
+        description: "Domain card envelope (object or JSON string) with credentialSubject.name; signed and used to create the domain."
+      },
+      entityType: { type: "string", description: "Optional on-chain entity type; defaults from the credential type or dao/pod." },
+      governanceConfig: { type: "object", description: "Optional governance group config (object or JSON string) used to create a governance group." },
+      memberConfig: { type: "object", description: "Optional member config (object or JSON string) for the governance group." },
+      flowTemplateConfig: { type: "object", description: "Optional flow template config (object or JSON string) with selected protocol templates." },
+      context: { type: "array", description: "Optional context entries (array of { key, val } or JSON string) attached to the domain." },
+      selectedEntityDid: { type: "string", description: "Optional parent entity DID to link the new POD to." },
+      parentDid: { type: "string", description: "Optional parent entity DID (alternate field)." },
+      parentDID: { type: "string", description: "Optional parent entity DID (alternate field)." },
+      skipped: { type: "boolean", description: "Optional flag that skips parent entity linking." },
+      parentSkipped: { type: "boolean", description: "Optional flag that skips parent entity linking." },
+      pendingInvocationId: { type: "string", description: "Optional invocation ID used as the checkpoint key for resumable runs." },
+      invocationId: { type: "string", description: "Optional invocation ID used as the checkpoint key for resumable runs." }
+    }
+  },
   outputSchema: [
     { path: "entityDid", displayName: "Entity DID", type: "string", description: "The DID of the newly created domain entity" },
     {
@@ -4103,6 +4325,20 @@ registerAction({
   can: "domain/card-preview",
   sideEffect: false,
   defaultRequiresConfirmation: false,
+  inputSchema: {
+    type: "object",
+    required: ["domainCardData"],
+    properties: {
+      domainCardData: {
+        type: "object",
+        description: "Domain card envelope (object or JSON string) with credentialSubject.name; echoed forward for signing."
+      },
+      domainPreviewData: {
+        type: "object",
+        description: "Oracle-enriched human-facing preview of the domain card (object or JSON string)."
+      }
+    }
+  },
   outputSchema: [
     {
       path: "domainCardData",
@@ -4168,6 +4404,13 @@ registerAction({
   can: "oracle/query",
   sideEffect: false,
   defaultRequiresConfirmation: false,
+  inputSchema: {
+    type: "object",
+    required: ["prompt"],
+    properties: {
+      prompt: { type: "string", description: "The prompt text sent to the companion." }
+    }
+  },
   outputSchema: [{ path: "prompt", displayName: "Prompt", type: "string", description: "The prompt sent to the companion" }],
   run: async (inputs, ctx) => {
     const prompt = String(inputs.prompt || "").trim();
@@ -4189,6 +4432,15 @@ registerAction({
   sideEffect: true,
   defaultRequiresConfirmation: true,
   requiredCapability: "flow/execute",
+  inputSchema: {
+    type: "object",
+    required: ["credentialKey", "credential"],
+    properties: {
+      credentialKey: { type: "string", description: "Key under which to store the credential (e.g. kycamllevel1)." },
+      credential: { type: "object", description: "The credential to store as a JSON object (also accepts a JSON string)." },
+      roomId: { type: "string", description: "Matrix room ID to store the credential in; defaults to empty." }
+    }
+  },
   outputSchema: [
     { path: "credentialKey", displayName: "Credential Key", type: "string", description: "Key under which credential was stored (e.g. kycamllevel1)" },
     { path: "cid", displayName: "Content ID", type: "string", description: "IPFS-compatible CID of the credential (used for deduplication)" },
@@ -4241,6 +4493,17 @@ registerAction({
   sideEffect: true,
   defaultRequiresConfirmation: true,
   requiredCapability: "flow/block/execute",
+  inputSchema: {
+    type: "object",
+    required: ["rowIds", "verb", "paymentBlockId"],
+    properties: {
+      rowIds: { type: "array", description: "IDs of the rows in the payment block to operate on (at least one)." },
+      verb: { type: "string", description: 'Which worker route to hit: "propose", "execute", or "check".' },
+      paymentBlockId: { type: "string", description: "The payment block ID so the oracle can edit_block back into the right place." },
+      delegationCid: { type: "string", description: "Optional user's UCAN delegation CID to the oracle." },
+      skill: { type: "object", description: "Optional skill context with cid and name." }
+    }
+  },
   outputSchema: [
     { path: "verb", displayName: "Action verb", type: "string" },
     { path: "rowCount", displayName: "Rows targeted", type: "number" },
@@ -4313,6 +4576,14 @@ registerAction({
   can: "matrix/dm",
   sideEffect: true,
   defaultRequiresConfirmation: false,
+  inputSchema: {
+    type: "object",
+    required: ["targetDid", "message"],
+    properties: {
+      targetDid: { type: "string", description: "The recipient DID to direct-message." },
+      message: { type: "string", description: "The message text to send." }
+    }
+  },
   outputSchema: [
     { path: "roomId", displayName: "Room ID", type: "string", description: "The Matrix room ID used for the DM" },
     { path: "sentAt", displayName: "Sent At", type: "string", description: "Timestamp when the message was sent" }
@@ -4342,6 +4613,11 @@ registerAction({
   can: "wallet/generate",
   sideEffect: false,
   defaultRequiresConfirmation: false,
+  inputSchema: {
+    type: "object",
+    properties: {},
+    required: []
+  },
   outputSchema: [
     { path: "address", displayName: "Wallet Address", type: "string", description: "The generated IXO wallet address" },
     { path: "did", displayName: "DID", type: "string", description: "The DID derived from the wallet address" },
@@ -4363,6 +4639,14 @@ registerAction({
   can: "wallet/fund",
   sideEffect: true,
   defaultRequiresConfirmation: true,
+  inputSchema: {
+    type: "object",
+    required: ["address"],
+    properties: {
+      address: { type: "string", description: "The IXO wallet address to fund." },
+      amount: { type: "number", description: "Funding amount in base units (defaults to 250000)." }
+    }
+  },
   outputSchema: [{ path: "transactionHash", displayName: "Transaction Hash", type: "string", description: "The funding transaction hash" }],
   run: async (inputs, ctx) => {
     if (!ctx.services.oracle?.fundWallet) {
@@ -4383,6 +4667,13 @@ registerAction({
   can: "wallet/generateAndFund",
   sideEffect: true,
   defaultRequiresConfirmation: false,
+  inputSchema: {
+    type: "object",
+    required: [],
+    properties: {
+      amount: { type: "number", description: "Funding amount in base units for the generated wallet (defaults to 250000)." }
+    }
+  },
   outputSchema: [
     { path: "address", displayName: "Wallet Address", type: "string", description: "The generated IXO wallet address" },
     { path: "did", displayName: "DID", type: "string", description: "The DID derived from the wallet address" },
@@ -4426,6 +4717,16 @@ registerAction({
   can: "iid/create",
   sideEffect: true,
   defaultRequiresConfirmation: false,
+  inputSchema: {
+    type: "object",
+    required: ["mnemonic", "did", "address", "pubKey"],
+    properties: {
+      mnemonic: { type: "string", description: "Wallet mnemonic used to create the IID document." },
+      did: { type: "string", description: "The DID for the IID document." },
+      address: { type: "string", description: "The blockchain address." },
+      pubKey: { type: "string", description: "The public key for the IID document." }
+    }
+  },
   outputSchema: [
     { path: "did", displayName: "DID", type: "string", description: "The IID document DID" },
     { path: "transactionHash", displayName: "Transaction Hash", type: "string", description: "The IID creation transaction hash" }
@@ -4454,6 +4755,18 @@ registerAction({
   can: "matrix/register",
   sideEffect: true,
   defaultRequiresConfirmation: false,
+  inputSchema: {
+    type: "object",
+    required: ["mnemonic", "address", "did", "pin", "oracleName"],
+    properties: {
+      mnemonic: { type: "string", description: "Wallet mnemonic used to register the Matrix account." },
+      address: { type: "string", description: "The blockchain address." },
+      did: { type: "string", description: "The DID associated with the Matrix account." },
+      pin: { type: "string", description: "PIN used to register the Matrix account." },
+      oracleName: { type: "string", description: "Oracle name for the Matrix account." },
+      avatarUrl: { type: "string", description: "Avatar URL for the Matrix account." }
+    }
+  },
   outputSchema: [
     { path: "matrixUserId", displayName: "Matrix User ID", type: "string", description: "The Matrix user ID" },
     { path: "matrixAccessToken", displayName: "Matrix Access Token", type: "string", description: "The Matrix access token" },
@@ -4491,6 +4804,20 @@ registerAction({
   can: "identity/create",
   sideEffect: true,
   defaultRequiresConfirmation: false,
+  inputSchema: {
+    type: "object",
+    required: ["mnemonic", "did", "address", "pubKey", "pin", "oracleName"],
+    properties: {
+      mnemonic: { type: "string", description: "Wallet mnemonic used to create the IID document and Matrix account." },
+      did: { type: "string", description: "The DID for the IID document." },
+      address: { type: "string", description: "The blockchain address." },
+      pubKey: { type: "string", description: "The public key for the IID document." },
+      pin: { type: "string", description: "PIN used to register the Matrix account." },
+      oracleName: { type: "string", description: "Oracle name for the Matrix account." },
+      avatarUrl: { type: "string", description: "Avatar URL for the Matrix account (mapped from form logoUrl)." },
+      formAnswers: { type: "string", description: "JSON string of runtime form answers merged into inputs." }
+    }
+  },
   outputSchema: [
     { path: "did", displayName: "DID", type: "string", description: "The IID document DID" },
     { path: "transactionHash", displayName: "Transaction Hash", type: "string", description: "The IID creation transaction hash" },
@@ -4577,6 +4904,34 @@ registerAction({
   can: "entity/createOracle",
   sideEffect: true,
   defaultRequiresConfirmation: false,
+  inputSchema: {
+    type: "object",
+    required: ["mnemonic", "address", "did", "pubKey", "pin", "matrixAccessToken", "matrixRoomId", "oracleName", "apiUrl", "price"],
+    properties: {
+      mnemonic: { type: "string", description: "BIP39 mnemonic for the oracle wallet." },
+      address: { type: "string", description: "The oracle wallet address." },
+      did: { type: "string", description: "The oracle DID." },
+      pubKey: { type: "string", description: "The oracle wallet public key." },
+      pin: { type: "string", description: "PIN used to sign the oracle entity creation." },
+      matrixAccessToken: { type: "string", description: "Matrix access token for the oracle." },
+      matrixRoomId: { type: "string", description: "Matrix room ID for the oracle." },
+      oracleName: { type: "string", description: "Display name of the oracle." },
+      apiUrl: { type: "string", description: "The oracle API URL." },
+      price: { type: "string", description: "The oracle subscription price." },
+      orgName: { type: "string", description: "Optional organization name." },
+      description: { type: "string", description: "Optional oracle description." },
+      location: { type: "string", description: "Optional oracle location." },
+      logoUrl: { type: "string", description: "Optional oracle logo URL." },
+      coverImageUrl: { type: "string", description: "Optional oracle cover image URL." },
+      llmModel: { type: "string", description: "Optional LLM model identifier." },
+      opening: { type: "string", description: "Optional oracle opening message." },
+      communicationStyle: { type: "string", description: "Optional oracle communication style." },
+      capabilities: { type: "array", description: "Optional oracle capabilities." },
+      mcpConfig: { type: "object", description: "Optional MCP configuration." },
+      parentProtocol: { type: "string", description: "Optional parent protocol DID." },
+      formAnswers: { type: "string", description: "Optional JSON string of form answers merged into inputs." }
+    }
+  },
   outputSchema: [
     { path: "entityDid", displayName: "Entity DID", type: "string", description: "The oracle entity DID" },
     { path: "transactionHash", displayName: "Transaction Hash", type: "string", description: "The entity creation transaction hash" },
@@ -4651,6 +5006,14 @@ registerAction({
   can: "sandbox/provision",
   sideEffect: true,
   defaultRequiresConfirmation: false,
+  inputSchema: {
+    type: "object",
+    required: ["entityDid", "matrixRoomId"],
+    properties: {
+      entityDid: { type: "string", description: "Oracle entity DID to provision a sandbox for." },
+      matrixRoomId: { type: "string", description: "Matrix room id associated with the oracle." }
+    }
+  },
   outputSchema: [
     { path: "sandboxUrl", displayName: "Sandbox URL", type: "string", description: "The provisioned sandbox URL" },
     { path: "status", displayName: "Status", type: "string", description: "Provisioning status" }
@@ -4675,6 +5038,13 @@ registerAction({
   can: "oracle/contract",
   sideEffect: true,
   defaultRequiresConfirmation: false,
+  inputSchema: {
+    type: "object",
+    required: ["oracleEntityDid"],
+    properties: {
+      oracleEntityDid: { type: "string", description: "Oracle entity DID from the entity.createOracle output." }
+    }
+  },
   outputSchema: [
     { path: "userOracleRoomId", displayName: "User\u2194Oracle Room ID", type: "string", description: "Matrix room id of the user\u2194oracle DM room" },
     { path: "userOracleRoomAlias", displayName: "User\u2194Oracle Room Alias", type: "string", description: "Matrix alias of the user\u2194oracle DM room" }
@@ -4698,6 +5068,34 @@ registerAction({
   can: "oracle/storeSecrets",
   sideEffect: true,
   defaultRequiresConfirmation: false,
+  inputSchema: {
+    type: "object",
+    required: [
+      "matrixRoomId",
+      "publicKeyMultibase",
+      "verificationMethodId",
+      "matrixHomeServerUrl",
+      "matrixUsername",
+      "matrixPassword",
+      "mnemonic",
+      "matrixRecoveryPhrase",
+      "pin",
+      "openRouterApiKeyJwe"
+    ],
+    properties: {
+      matrixRoomId: { type: "string", description: "Matrix room id from the oracle.contract output." },
+      publicKeyMultibase: { type: "string", description: "Oracle public key (multibase) from the entity.createOracle output." },
+      verificationMethodId: { type: "string", description: "Verification method id from the entity.createOracle output." },
+      matrixHomeServerUrl: { type: "string", description: "Matrix homeserver URL from the matrix.register output." },
+      matrixUsername: { type: "string", description: "Matrix username from the matrix.register output." },
+      matrixPassword: { type: "string", description: "Matrix password from the matrix.register output." },
+      mnemonic: { type: "string", description: "Wallet mnemonic from the wallet.generate output." },
+      matrixRecoveryPhrase: { type: "string", description: "Matrix recovery phrase from the matrix.register output." },
+      pin: { type: "string", description: "PIN from the form output." },
+      openRouterApiKeyJwe: { type: "string", description: "JWE-encrypted OpenRouter API key from the form." },
+      mcpAuthSecrets: { type: "object", description: "Optional pre-encrypted MCP auth secrets (object or JSON string)." }
+    }
+  },
   outputSchema: [
     { path: "storedSecrets", displayName: "Stored Secrets", type: "array", description: "List of secret names stored" },
     { path: "roomId", displayName: "Room ID", type: "string", description: "Matrix room where secrets are stored" }
@@ -4760,6 +5158,31 @@ registerAction({
   can: "oracle/storeConfig",
   sideEffect: true,
   defaultRequiresConfirmation: false,
+  inputSchema: {
+    type: "object",
+    required: ["matrixRoomId", "oracleName", "entityDid"],
+    properties: {
+      matrixRoomId: { type: "string", description: "Matrix room id from the oracle.contract output." },
+      oracleName: { type: "string", description: "Oracle name." },
+      entityDid: { type: "string", description: "Oracle entity DID." },
+      orgName: { type: "string", description: "Organisation name." },
+      description: { type: "string", description: "Oracle description." },
+      location: { type: "string", description: "Oracle location." },
+      price: { type: "number", description: "Oracle price; defaults to 0." },
+      apiUrl: { type: "string", description: "Oracle API URL." },
+      logoUrl: { type: "string", description: "Oracle logo URL." },
+      llmModel: { type: "string", description: "LLM model identifier." },
+      opening: { type: "string", description: "Oracle opening message." },
+      communicationStyle: { type: "string", description: "Oracle communication style." },
+      capabilities: { type: "string", description: "Oracle capabilities description." },
+      skills: { type: "array", description: "List of oracle skills." },
+      mcpServers: { type: "array", description: "List of configured MCP servers." },
+      matrixUserId: { type: "string", description: "Oracle Matrix user id." },
+      matrixAccountRoomId: { type: "string", description: "Oracle Matrix account room id." },
+      oracleAddress: { type: "string", description: "Oracle wallet address." },
+      oracleDid: { type: "string", description: "Oracle DID." }
+    }
+  },
   outputSchema: [
     { path: "configStored", displayName: "Config Stored", type: "boolean", description: "Whether the oracle config was stored successfully" },
     { path: "roomId", displayName: "Room ID", type: "string", description: "The Matrix room ID where config was stored" }
@@ -4805,6 +5228,54 @@ registerAction({
   can: "oracle/storeSecretsAndConfig",
   sideEffect: true,
   defaultRequiresConfirmation: false,
+  inputSchema: {
+    type: "object",
+    required: [
+      "matrixRoomId",
+      "publicKeyMultibase",
+      "verificationMethodId",
+      "matrixHomeServerUrl",
+      "matrixUsername",
+      "matrixPassword",
+      "mnemonic",
+      "matrixRecoveryPhrase",
+      "pin",
+      "openRouterApiKeyJwe",
+      "oracleName",
+      "entityDid"
+    ],
+    properties: {
+      matrixRoomId: { type: "string", description: "Matrix room id from the oracle.contract output." },
+      publicKeyMultibase: { type: "string", description: "Oracle public key (multibase) from the entity.createOracle output." },
+      verificationMethodId: { type: "string", description: "Verification method id from the entity.createOracle output." },
+      matrixHomeServerUrl: { type: "string", description: "Matrix homeserver URL from the matrix.register output." },
+      matrixUsername: { type: "string", description: "Matrix username from the matrix.register output." },
+      matrixPassword: { type: "string", description: "Matrix password from the matrix.register output." },
+      mnemonic: { type: "string", description: "Wallet mnemonic from the wallet.generate output." },
+      matrixRecoveryPhrase: { type: "string", description: "Matrix recovery phrase from the matrix.register output." },
+      pin: { type: "string", description: "PIN from the form output." },
+      openRouterApiKeyJwe: { type: "string", description: "JWE-encrypted OpenRouter API key from the form." },
+      mcpAuthSecrets: { type: "object", description: "Optional pre-encrypted MCP auth secrets (object or JSON string)." },
+      oracleName: { type: "string", description: "Oracle name." },
+      entityDid: { type: "string", description: "Oracle entity DID." },
+      orgName: { type: "string", description: "Organisation name." },
+      description: { type: "string", description: "Oracle description." },
+      location: { type: "string", description: "Oracle location." },
+      price: { type: "number", description: "Oracle price; defaults to 0." },
+      apiUrl: { type: "string", description: "Oracle API URL." },
+      logoUrl: { type: "string", description: "Oracle logo URL." },
+      llmModel: { type: "string", description: "LLM model identifier." },
+      opening: { type: "string", description: "Oracle opening message." },
+      communicationStyle: { type: "string", description: "Oracle communication style." },
+      capabilities: { type: "string", description: "Oracle capabilities description." },
+      skills: { type: "array", description: "List of oracle skills." },
+      mcpServers: { type: "array", description: "List of configured MCP servers." },
+      matrixUserId: { type: "string", description: "Oracle Matrix user id." },
+      matrixAccountRoomId: { type: "string", description: "Oracle Matrix account room id." },
+      oracleAddress: { type: "string", description: "Oracle wallet address." },
+      oracleDid: { type: "string", description: "Oracle DID." }
+    }
+  },
   outputSchema: [
     { path: "storedSecrets", displayName: "Stored Secrets", type: "array", description: "List of secret names stored" },
     { path: "roomId", displayName: "Room ID", type: "string", description: "Matrix room where data is stored" },
@@ -4908,6 +5379,56 @@ registerAction({
   can: "oracle/configureOracle",
   sideEffect: true,
   defaultRequiresConfirmation: false,
+  inputSchema: {
+    type: "object",
+    required: [
+      "oracleEntityDid",
+      "publicKeyMultibase",
+      "verificationMethodId",
+      "matrixHomeServerUrl",
+      "matrixUsername",
+      "matrixPassword",
+      "mnemonic",
+      "matrixRecoveryPhrase",
+      "pin",
+      "openRouterApiKeyJwe",
+      "oracleName",
+      "entityDid"
+    ],
+    properties: {
+      formAnswers: { type: "string", description: "Optional JSON string of form answers merged into the inputs." },
+      oracleEntityDid: { type: "string", description: "Oracle entity DID from the entity.createOracle output." },
+      publicKeyMultibase: { type: "string", description: "Oracle public key (multibase) from the entity.createOracle output." },
+      verificationMethodId: { type: "string", description: "Verification method id from the entity.createOracle output." },
+      matrixHomeServerUrl: { type: "string", description: "Matrix homeserver URL from the matrix.register output." },
+      matrixUsername: { type: "string", description: "Matrix username from the matrix.register output." },
+      matrixPassword: { type: "string", description: "Matrix password from the matrix.register output." },
+      mnemonic: { type: "string", description: "Wallet mnemonic from the wallet.generate output." },
+      matrixRecoveryPhrase: { type: "string", description: "Matrix recovery phrase from the matrix.register output." },
+      pin: { type: "string", description: "PIN from the form output." },
+      openRouterApiKeyJwe: { type: "string", description: "JWE-encrypted OpenRouter API key from the form." },
+      openRouterApiKeyPlaintext: { type: "string", description: "Optional plaintext OpenRouter API key passed through to the deploy output." },
+      mcpAuthSecrets: { type: "object", description: "Optional pre-encrypted MCP auth secrets (object or JSON string)." },
+      oracleName: { type: "string", description: "Oracle name." },
+      entityDid: { type: "string", description: "Oracle entity DID." },
+      orgName: { type: "string", description: "Organisation name." },
+      description: { type: "string", description: "Oracle description." },
+      location: { type: "string", description: "Oracle location." },
+      price: { type: "number", description: "Oracle price; defaults to 0." },
+      apiUrl: { type: "string", description: "Oracle API URL." },
+      logoUrl: { type: "string", description: "Oracle logo URL." },
+      llmModel: { type: "string", description: "LLM model identifier." },
+      opening: { type: "string", description: "Oracle opening message." },
+      communicationStyle: { type: "string", description: "Oracle communication style." },
+      capabilities: { type: "string", description: "Oracle capabilities description." },
+      skills: { type: "array", description: "List of oracle skills." },
+      mcpServers: { type: "array", description: "List of configured MCP servers." },
+      matrixUserId: { type: "string", description: "Oracle Matrix user id." },
+      matrixAccountRoomId: { type: "string", description: "Oracle Matrix account room id." },
+      oracleAddress: { type: "string", description: "Oracle wallet address." },
+      oracleDid: { type: "string", description: "Oracle DID." }
+    }
+  },
   outputSchema: [
     { path: "userOracleRoomId", displayName: "User-Oracle Room ID", type: "string", description: "Matrix room id from contract phase" },
     { path: "userOracleRoomAlias", displayName: "User-Oracle Room Alias", type: "string", description: "Matrix alias from contract phase" },
@@ -5038,6 +5559,16 @@ registerAction({
   can: "oracle/deploySetup",
   sideEffect: true,
   defaultRequiresConfirmation: false,
+  inputSchema: {
+    type: "object",
+    required: ["name", "config", "roomId"],
+    properties: {
+      name: { type: "string", description: "Project name from the form." },
+      config: { type: "object", description: "Oracle config object (or its JSON string)." },
+      roomId: { type: "string", description: "Matrix room id from the oracle contract/configure output." },
+      secrets: { type: "object", description: "Optional map of secret name to value passed to deploy setup." }
+    }
+  },
   outputSchema: [
     { path: "setupComplete", displayName: "Setup Complete", type: "boolean", description: "Whether the oracle setup completed successfully" },
     { path: "stdout", displayName: "Build Output", type: "string", description: "Build stdout output" }
@@ -5062,6 +5593,16 @@ registerAction({
   can: "oracle/deployStart",
   sideEffect: true,
   defaultRequiresConfirmation: false,
+  inputSchema: {
+    type: "object",
+    required: ["name", "entityDid", "roomId"],
+    properties: {
+      name: { type: "string", description: "Project name from the form." },
+      entityDid: { type: "string", description: "Oracle entity DID from the entity.createOracle output." },
+      roomId: { type: "string", description: "Matrix room id from the oracle contract/configure output." },
+      secrets: { type: "object", description: "Optional map of secret name to value passed to deploy start." }
+    }
+  },
   outputSchema: [
     { path: "processId", displayName: "Process ID", type: "string", description: "Running process identifier" },
     { path: "status", displayName: "Status", type: "string", description: "Oracle process status" }
@@ -5085,6 +5626,17 @@ registerAction({
   can: "oracle/deploy",
   sideEffect: true,
   defaultRequiresConfirmation: false,
+  inputSchema: {
+    type: "object",
+    required: ["name", "entityDid", "roomId", "config"],
+    properties: {
+      name: { type: "string", description: "Project name from the form." },
+      entityDid: { type: "string", description: "Oracle entity DID from the entity.createOracle output." },
+      roomId: { type: "string", description: "Matrix room id from the oracle.configureOracle output." },
+      config: { type: "object", description: "Oracle config object (or its JSON string)." },
+      secrets: { type: "object", description: "Optional map of secret name to value passed to deploy." }
+    }
+  },
   outputSchema: [
     { path: "setupComplete", displayName: "Setup Complete", type: "boolean", description: "Whether the oracle setup completed successfully" },
     { path: "processId", displayName: "Process ID", type: "string", description: "Running process identifier" },
@@ -5218,6 +5770,22 @@ registerAction({
   // manage-mode block bound to an existing collection is hidden from the
   // trigger picker as a source (IXO-2595).
   getDynamicEvents: (inputs) => String(inputs?.collectionId || "").trim() ? [] : [COLLECTION_CREATED_EVENT],
+  inputSchema: {
+    type: "object",
+    required: ["operation"],
+    properties: {
+      operation: { type: "string", description: "Lifecycle op to dispatch: create | updateState | updateDates | updateQuota | updatePayments | updateIntents | refresh." },
+      collectionId: { type: "string", description: "Target collection id; required for every op except create." },
+      entity: { type: "string", description: "create \u2014 entity (deed) DID the collection belongs to." },
+      protocol: { type: "string", description: "create \u2014 protocol DID the collection follows (must be a bare did:)." },
+      state: { type: "number", description: "create/updateState \u2014 lifecycle state (0=OPEN, 1=PAUSED, 2=CLOSED)." },
+      startDate: { type: "string", description: "create/updateDates \u2014 ISO-8601 start date." },
+      endDate: { type: "string", description: "create/updateDates \u2014 ISO-8601 end date." },
+      quota: { type: "string", description: 'create/updateQuota \u2014 max claims; "0" = unlimited.' },
+      payments: { type: "object", description: "create/updatePayments \u2014 payment legs." },
+      intents: { type: "object", description: "create/updateIntents \u2014 intent configuration." }
+    }
+  },
   run: async (inputs, ctx) => {
     const service = ctx.services.collection;
     if (!service) {
@@ -5399,6 +5967,24 @@ registerAction({
   // resolves the entity admin account from the payload `entity` and passes it
   // as `adminAddress`.
   eligibleForEventTrigger: true,
+  inputSchema: {
+    type: "object",
+    required: ["operation", "collectionId", "adminAddress"],
+    properties: {
+      operation: { type: "string", description: "Which user-management operation to run: add | revoke | list." },
+      collectionId: { type: "string", description: "Target claim collection identifier." },
+      adminAddress: { type: "string", description: "Granter entity admin account address (the authz granter)." },
+      role: { type: "string", description: "Which authorization to act on for add/revoke: submit or evaluate." },
+      deedDid: { type: "string", description: "Entity (deed) DID forwarded to the handler." },
+      granteeAddress: { type: "string", description: "The single grantee bech32 address for add/revoke." },
+      granteeDid: { type: "string", description: "Optional resolved grantee DID for display or audit." },
+      granteeKind: { type: "string", description: "How to treat the add grantee: user, group-account, or group-members." },
+      agentQuota: { type: "string", description: "Remaining agent quota for add; 0 means unlimited." },
+      maxAmount: { type: "array", description: "Per-claim max amount cap for the add evaluate role." },
+      intentDurationNs: { type: "string", description: "Intent duration in nanoseconds for add, carried as a string." },
+      members: { type: "array", description: "Resolved members to fan the grant out to when granteeKind is group-members." }
+    }
+  },
   run: async (inputs, ctx) => {
     const service = ctx.services.collectionUsers;
     if (!service) {
@@ -5534,6 +6120,13 @@ registerAction({
   can: "carbon/load",
   sideEffect: false,
   defaultRequiresConfirmation: false,
+  inputSchema: {
+    type: "object",
+    required: ["ownerAddress"],
+    properties: {
+      ownerAddress: { type: "string", description: "Wallet address whose owner-side and entity-admin-side CARBON batches are reconciled." }
+    }
+  },
   outputSchema: CARBON_LOAD_OUTPUT,
   run: async (inputs, ctx) => {
     if (!ctx.services.carbon?.loadBatches) {
@@ -5553,6 +6146,14 @@ registerAction({
   can: "carbon/harvest",
   sideEffect: true,
   defaultRequiresConfirmation: true,
+  inputSchema: {
+    type: "object",
+    required: ["ownerAddress", "tokens"],
+    properties: {
+      ownerAddress: { type: "string", description: "Wallet address owning the entity admin accounts to harvest from." },
+      tokens: { type: "array", description: "Batches to harvest; each requires id, entityDid, adminAddress and a claimable amount > 0." }
+    }
+  },
   outputSchema: CARBON_HARVEST_OUTPUT,
   run: async (inputs, ctx) => {
     if (!ctx.services.carbon?.harvest) {
@@ -5584,6 +6185,16 @@ registerAction({
   can: "carbon/retire",
   sideEffect: true,
   defaultRequiresConfirmation: true,
+  inputSchema: {
+    type: "object",
+    required: ["owner", "tokens"],
+    properties: {
+      owner: { type: "string", description: "Wallet address holding the credits to retire." },
+      tokens: { type: "array", description: "Batches to retire; each requires an id and an amount > 0." },
+      reason: { type: "string", description: 'Retirement reason (defaults to "offset").' },
+      jurisdiction: { type: "string", description: 'Retirement jurisdiction (defaults to "Global").' }
+    }
+  },
   outputSchema: CARBON_RETIRE_OUTPUT,
   run: async (inputs, ctx) => {
     if (!ctx.services.carbon?.retire) {
@@ -5636,6 +6247,16 @@ registerAction({
   sideEffect: true,
   defaultRequiresConfirmation: true,
   outputSchema: ENTITY_TRANSFER_OUTPUT,
+  inputSchema: {
+    type: "object",
+    required: ["entityDid", "recipientDid"],
+    properties: {
+      entityDid: { type: "string", description: "Entity DID being transferred (did:ixo:entity:\u2026)." },
+      recipientDid: { type: "string", description: "New owner DID (user or did:ixo:wasm: controller)." },
+      ownerDid: { type: "string", description: "Current owner DID; host defaults to the connected user when omitted." },
+      ownerAddress: { type: "string", description: "Current owner address; host defaults to the connected user when omitted." }
+    }
+  },
   run: async (inputs, ctx) => {
     if (!ctx.services.entity?.transfer) {
       throw new Error("entity.transfer handler not available");
@@ -5714,6 +6335,22 @@ registerAction({
   defaultRequiresConfirmation: true,
   requiredCapability: "flow/block/execute",
   eligibleForEventTrigger: true,
+  inputSchema: {
+    type: "object",
+    required: ["connection", "start_datetime"],
+    properties: {
+      connection: { type: "object", description: "Pinned Calendar connection with a connectedAccountId." },
+      start_datetime: { type: "string", description: "Event start time (ISO 8601)." },
+      end_datetime: { type: "string", description: "Optional event end time (ISO 8601)." },
+      calendar_id: { type: "string", description: 'Calendar to write to; defaults to "primary".' },
+      summary: { type: "string", description: "Optional event title." },
+      description: { type: "string", description: "Optional event description." },
+      location: { type: "string", description: "Optional event location." },
+      timezone: { type: "string", description: "Optional timezone for the event." },
+      send_updates: { type: "string", description: "Optional attendee-notification mode passed through to Calendar." },
+      attendees: { type: "string", description: "Optional attendees as a JSON array, newline-, or comma-separated emails." }
+    }
+  },
   outputSchema: [
     { path: "eventId", displayName: "Event ID", type: "string", description: "Opaque identifier of the created event" },
     { path: "htmlLink", displayName: "Event link", type: "string", description: "Web UI link to the created event" },
@@ -5805,6 +6442,23 @@ registerAction({
   defaultRequiresConfirmation: true,
   requiredCapability: "flow/block/execute",
   eligibleForEventTrigger: true,
+  inputSchema: {
+    type: "object",
+    required: ["connection", "event_id", "start_datetime"],
+    properties: {
+      connection: { type: "object", description: "Pinned Calendar connection with a connectedAccountId." },
+      event_id: { type: "string", description: "Identifier of the existing event to update." },
+      start_datetime: { type: "string", description: "Event start time (ISO 8601)." },
+      end_datetime: { type: "string", description: "Optional event end time (ISO 8601)." },
+      calendar_id: { type: "string", description: 'Calendar containing the event; defaults to "primary".' },
+      summary: { type: "string", description: "Optional event title." },
+      description: { type: "string", description: "Optional event description." },
+      location: { type: "string", description: "Optional event location." },
+      timezone: { type: "string", description: "Optional timezone for the event." },
+      send_updates: { type: "string", description: "Optional attendee-notification mode passed through to Calendar." },
+      attendees: { type: "string", description: "Optional attendees as a JSON array, newline-, or comma-separated emails." }
+    }
+  },
   outputSchema: [
     { path: "eventId", displayName: "Event ID", type: "string" },
     { path: "htmlLink", displayName: "Event link", type: "string" },
@@ -5897,6 +6551,21 @@ registerAction({
   defaultRequiresConfirmation: false,
   requiredCapability: "flow/block/execute",
   eligibleForEventTrigger: false,
+  inputSchema: {
+    type: "object",
+    required: ["connection"],
+    properties: {
+      connection: { type: "object", description: "Pinned Calendar connection with a connectedAccountId." },
+      calendarId: { type: "string", description: 'Calendar to list from; defaults to "primary".' },
+      q: { type: "string", description: "Optional free-text search query for events." },
+      timeMin: { type: "string", description: "Optional lower bound for event start time (ISO 8601)." },
+      timeMax: { type: "string", description: "Optional upper bound for event start time (ISO 8601)." },
+      timeZone: { type: "string", description: "Optional timezone for the returned times." },
+      orderBy: { type: "string", description: "Optional ordering of results (e.g. startTime)." },
+      singleEvents: { type: "boolean", description: "Optional flag to expand recurring events into single instances." },
+      maxResults: { type: "string", description: "Optional maximum number of events to return (parsed as an integer)." }
+    }
+  },
   outputSchema: [
     { path: "items", displayName: "Events", type: "array", description: "Raw event objects as returned by Calendar" },
     { path: "count", displayName: "Count", type: "number" },
@@ -5963,6 +6632,27 @@ registerAction({
   defaultRequiresConfirmation: true,
   requiredCapability: "flow/block/execute",
   eligibleForEventTrigger: true,
+  inputSchema: {
+    type: "object",
+    required: ["connection", "Name"],
+    properties: {
+      connection: { type: "object", description: "Pinned Xero connection with connectedAccountId and entityDid." },
+      tenant_id: { type: "string", description: "Xero org identifier; empty uses the connection default." },
+      Name: { type: "string", description: "Contact display name." },
+      FirstName: { type: "string", description: "Contact first name." },
+      LastName: { type: "string", description: "Contact last name." },
+      EmailAddress: { type: "string", description: "Contact email address." },
+      phone_number: { type: "string", description: "Contact phone number." },
+      mobile_number: { type: "string", description: "Contact mobile number." },
+      Website: { type: "string", description: "Contact website URL." },
+      TaxNumber: { type: "string", description: "Contact tax number." },
+      AccountNumber: { type: "string", description: "Contact account number." },
+      DefaultCurrency: { type: "string", description: "Default currency code for the contact." },
+      BankAccountDetails: { type: "string", description: "Contact bank account details." },
+      IsCustomer: { type: "boolean", description: "Whether the contact is a customer." },
+      IsSupplier: { type: "boolean", description: "Whether the contact is a supplier." }
+    }
+  },
   outputSchema: [
     { path: "contactId", displayName: "Contact ID", type: "string" },
     { path: "name", displayName: "Name", type: "string" },
@@ -6040,6 +6730,24 @@ registerAction({
   defaultRequiresConfirmation: true,
   requiredCapability: "flow/block/execute",
   eligibleForEventTrigger: true,
+  inputSchema: {
+    type: "object",
+    required: ["connection", "LineItems"],
+    properties: {
+      connection: { type: "object", description: "Pinned Xero connection with connectedAccountId and entityDid." },
+      tenant_id: { type: "string", description: "Xero org identifier; empty uses the connection default." },
+      Type: { type: "string", description: "Invoice type: 'ACCREC' (sale) or 'ACCPAY' (bill); defaults to ACCREC." },
+      Status: { type: "string", description: "Invoice status (e.g. DRAFT, AUTHORISED)." },
+      Date: { type: "string", description: "Invoice date." },
+      DueDate: { type: "string", description: "Invoice due date." },
+      ContactID: { type: "string", description: "Xero contact UUID; preferred over ContactName." },
+      ContactName: { type: "string", description: "Contact name fallback when ContactID is absent." },
+      Reference: { type: "string", description: "Invoice reference text." },
+      InvoiceNumber: { type: "string", description: "Invoice number." },
+      CurrencyCode: { type: "string", description: "Invoice currency code." },
+      LineItems: { type: "array", description: "Finalised array of invoice line-item objects." }
+    }
+  },
   outputSchema: [
     { path: "invoiceId", displayName: "Invoice ID", type: "string" },
     { path: "invoiceNumber", displayName: "Invoice number", type: "string" },
@@ -6127,6 +6835,22 @@ registerAction({
   defaultRequiresConfirmation: false,
   requiredCapability: "flow/block/execute",
   eligibleForEventTrigger: false,
+  inputSchema: {
+    type: "object",
+    required: ["connection"],
+    properties: {
+      connection: { type: "object", description: "Pinned Xero connection with connectedAccountId and entityDid." },
+      tenantId: { type: "string", description: "Xero org identifier (camelCase for the list tool)." },
+      page: { type: "string", description: "Page number; parsed to an integer >= 1." },
+      order: { type: "string", description: "Sort order expression." },
+      Statuses: { type: "string", description: "Filter by invoice statuses." },
+      ContactIDs: { type: "string", description: "Filter by contact IDs." },
+      InvoiceIDs: { type: "string", description: "Filter by invoice IDs." },
+      where: { type: "string", description: "Xero where-clause filter." },
+      createdByMyApp: { type: "boolean", description: "Limit to invoices created by this app." },
+      includeArchived: { type: "boolean", description: "Include archived invoices." }
+    }
+  },
   outputSchema: [
     { path: "items", displayName: "Invoices", type: "array" },
     { path: "count", displayName: "Count", type: "number" },
@@ -6191,6 +6915,20 @@ registerAction({
   defaultRequiresConfirmation: true,
   requiredCapability: "flow/block/execute",
   eligibleForEventTrigger: true,
+  inputSchema: {
+    type: "object",
+    required: ["connection", "InvoiceID", "AccountID", "Amount"],
+    properties: {
+      connection: { type: "object", description: "Pinned Xero connection with connectedAccountId and entityDid." },
+      tenant_id: { type: "string", description: "Xero org identifier; empty uses the connection default." },
+      InvoiceID: { type: "string", description: "UUID of the invoice being paid." },
+      AccountID: { type: "string", description: "UUID of the Xero bank/treasury account the payment debits." },
+      Date: { type: "string", description: "Payment date (YYYY-MM-DD); defaults to today if blank." },
+      Amount: { type: "number", description: "Payment amount; must be a positive number." },
+      Reference: { type: "string", description: "Free-text reference, typically the on-chain tx hash." },
+      CurrencyRate: { type: "number", description: "Optional currency rate for multicurrency payments." }
+    }
+  },
   outputSchema: [
     { path: "paymentId", displayName: "Payment ID", type: "string" },
     { path: "invoiceId", displayName: "Invoice ID", type: "string" },
@@ -9754,6 +10492,55 @@ var migration_0_3_to_1_0_0 = {
 };
 registerMigration(migration_0_3_to_1_0_0);
 
+// src/core/lib/flowCompiler/conditions.ts
+var OPERATOR_MAP = {
+  // BaseUcan ConditionRef vocabulary
+  eq: "equals",
+  neq: "not_equals",
+  gt: "greater_than",
+  lt: "less_than",
+  in: "contains",
+  exists: "is_not_empty",
+  // Friendly camelCase (plugin FlowSpec `is`)
+  equals: "equals",
+  notEquals: "not_equals",
+  greaterThan: "greater_than",
+  lessThan: "less_than",
+  isEmpty: "is_empty",
+  isNotEmpty: "is_not_empty",
+  // Evaluator vocabulary passthrough
+  not_equals: "not_equals",
+  greater_than: "greater_than",
+  less_than: "less_than",
+  contains: "contains",
+  not_contains: "not_contains",
+  notContains: "not_contains",
+  is_empty: "is_empty",
+  is_not_empty: "is_not_empty"
+};
+function toEvaluatorOperator(operator) {
+  return OPERATOR_MAP[operator] ?? "equals";
+}
+function buildBlockConditionsProp(conditions, opts) {
+  return JSON.stringify({
+    enabled: opts?.enabled ?? true,
+    mode: opts?.mode ?? "all_must_pass",
+    conditions: conditions.map((c, i) => ({
+      id: `cond_${c.sourceBlockId}_${c.property}_${i}`,
+      name: c.name ?? `Condition from ${c.sourceBlockId}`,
+      sourceBlockId: c.sourceBlockId,
+      sourceBlockType: c.sourceBlockType ?? "action",
+      rule: {
+        type: "property_value",
+        property: c.property,
+        operator: toEvaluatorOperator(c.operator),
+        value: c.value
+      },
+      effect: c.effect ?? { action: "enable" }
+    }))
+  });
+}
+
 // src/core/lib/flowCompiler/blockMapping.ts
 var ICON_DEFAULTS = {
   "bid/submit": "gavel",
@@ -9980,7 +10767,10 @@ function compileCondition(condition, blockIndex) {
         rule: {
           type: "property_value",
           property: condition.field,
-          operator: condition.operator,
+          // Map the BaseUcan ConditionRef operator (eq/neq/…) onto the FE evaluator's
+          // vocabulary (equals/not_equals/…). Writing it verbatim is the historical bug
+          // that made compiler-authored conditions silently never evaluate.
+          operator: toEvaluatorOperator(condition.operator),
           value: condition.value
         },
         effect: condition.effect || { action: "enable" }
@@ -10053,14 +10843,143 @@ function detectTriggerCycles(triggerEdges) {
   }
 }
 
-// src/core/lib/flowCompiler/readFlow.ts
+// src/core/lib/flowCompiler/documentFragment.ts
 import * as Y4 from "yjs";
+function writeCompiledBlocksToFragment(fragment, blocks) {
+  const documentBlockGroup = getOrCreateDocumentBlockGroup(fragment);
+  for (const block of blocks) {
+    appendBlockToGroup(documentBlockGroup, block);
+  }
+}
+function removeAllFlowBlocks(fragment) {
+  const blockGroup = getExistingBlockGroup(fragment);
+  if (!blockGroup) return;
+  while (blockGroup.length > 0) {
+    blockGroup.delete(0, 1);
+  }
+}
+function removeBlockFromFragment(fragment, blockId) {
+  const blockGroup = getExistingBlockGroup(fragment);
+  if (!blockGroup) return false;
+  for (let i = 0; i < blockGroup.length; i++) {
+    const container = blockGroup.get(i);
+    if (container instanceof Y4.XmlElement && container.getAttribute("id") === blockId) {
+      blockGroup.delete(i, 1);
+      return true;
+    }
+  }
+  return false;
+}
+function replaceBlockInFragment(fragment, block) {
+  const blockGroup = getExistingBlockGroup(fragment);
+  if (!blockGroup) return false;
+  for (let i = 0; i < blockGroup.length; i++) {
+    const container = blockGroup.get(i);
+    if (container instanceof Y4.XmlElement && container.getAttribute("id") === block.id) {
+      blockGroup.delete(i, 1);
+      const newContainer = createBlockContainer(block);
+      blockGroup.insert(i, [newContainer]);
+      return true;
+    }
+  }
+  return false;
+}
+function applyMergeResultToFragment(fragment, mergeResult) {
+  const documentBlockGroup = getOrCreateDocumentBlockGroup(fragment);
+  const blockByNodeId = /* @__PURE__ */ new Map();
+  for (const block of mergeResult.merged.blocks) {
+    for (const [nodeId, blockId] of Object.entries(mergeResult.merged.blockIndex)) {
+      if (blockId === block.id) {
+        blockByNodeId.set(nodeId, block);
+        break;
+      }
+    }
+  }
+  for (const nodeId of mergeResult.replaced) {
+    const block = blockByNodeId.get(nodeId);
+    if (block) {
+      replaceBlockInFragment(fragment, block);
+    }
+  }
+  for (const nodeId of mergeResult.added) {
+    const block = blockByNodeId.get(nodeId);
+    if (block) {
+      appendBlockToGroup(documentBlockGroup, block);
+    }
+  }
+}
+function readBlocksFromFragment(fragment) {
+  const blockGroup = getExistingBlockGroup(fragment);
+  if (!blockGroup) return [];
+  const blocks = [];
+  for (let i = 0; i < blockGroup.length; i++) {
+    const container = blockGroup.get(i);
+    if (!(container instanceof Y4.XmlElement) || container.nodeName !== "blockContainer") continue;
+    const id = container.getAttribute("id");
+    if (typeof id !== "string" || id.length === 0) continue;
+    const content = container.get(0);
+    if (!(content instanceof Y4.XmlElement)) continue;
+    const props = { ...content.getAttributes() };
+    const textColor = container.getAttribute("textColor");
+    if (typeof textColor === "string" && textColor !== "default") props.textColor = textColor;
+    const backgroundColor = container.getAttribute("backgroundColor");
+    if (typeof backgroundColor === "string" && backgroundColor !== "default") props.backgroundColor = backgroundColor;
+    blocks.push({ id, type: content.nodeName, props });
+  }
+  return blocks;
+}
+function createBlockContainer(block) {
+  const blockContainer = new Y4.XmlElement("blockContainer");
+  const { backgroundColor: rawBackgroundColor, textColor: rawTextColor, ...contentProps } = block.props;
+  blockContainer.setAttribute("id", block.id);
+  blockContainer.setAttribute("textColor", rawTextColor || "default");
+  blockContainer.setAttribute("backgroundColor", rawBackgroundColor || "default");
+  const blockContent = new Y4.XmlElement(block.type);
+  for (const [key, value] of Object.entries(contentProps)) {
+    if (value !== "") {
+      blockContent.setAttribute(key, value);
+    }
+  }
+  blockContainer.insert(0, [blockContent]);
+  return blockContainer;
+}
+function appendBlockToGroup(blockGroup, block) {
+  const container = createBlockContainer(block);
+  blockGroup.insert(blockGroup.length, [container]);
+}
+function getOrCreateDocumentBlockGroup(fragment) {
+  if (fragment.length === 0) {
+    const blockGroup = new Y4.XmlElement("blockGroup");
+    fragment.insert(0, [blockGroup]);
+    return blockGroup;
+  }
+  if (fragment.length === 1) {
+    const rootNode = fragment.get(0);
+    if (rootNode instanceof Y4.XmlElement && rootNode.nodeName === "blockGroup") {
+      return rootNode;
+    }
+  }
+  throw new Error("Unexpected BlockNote document shape in XmlFragment. Expected a single top-level blockGroup node.");
+}
+function getExistingBlockGroup(fragment) {
+  if (fragment.length === 0) return null;
+  if (fragment.length === 1) {
+    const rootNode = fragment.get(0);
+    if (rootNode instanceof Y4.XmlElement && rootNode.nodeName === "blockGroup") {
+      return rootNode;
+    }
+  }
+  return null;
+}
+
+// src/core/lib/flowCompiler/readFlow.ts
+import * as Y5 from "yjs";
 function readCompiledFlowFromYDoc(yDoc) {
   const flowMeta = yDoc.getMap("qi.flow.meta");
   const flowNodes = yDoc.getMap("qi.flow.nodes");
   const nodes = {};
   flowNodes.forEach((value, nodeId) => {
-    if (value instanceof Y4.Map) {
+    if (value instanceof Y5.Map) {
       nodes[nodeId] = yMapToFlowNode(value);
     }
   });
@@ -10080,7 +10999,7 @@ function readCompiledFlowFromYDoc(yDoc) {
   const flowEdges = yDoc.getMap("qi.flow.edges");
   const edges = [];
   flowEdges.forEach((value) => {
-    if (value instanceof Y4.Map) {
+    if (value instanceof Y5.Map) {
       edges.push(yMapToEdge(value));
     }
   });
@@ -10265,7 +11184,7 @@ import * as Y7 from "yjs";
 import { MatrixProvider } from "@ixo/matrix-crdt";
 
 // src/core/lib/flowCompiler/hydrate.ts
-import * as Y5 from "yjs";
+import * as Y6 from "yjs";
 function hydrateYDocFromCompiledFlow(yDoc, compiled) {
   yDoc.transact(() => {
     const flowMeta = yDoc.getMap("qi.flow.meta");
@@ -10280,7 +11199,7 @@ function hydrateYDocFromCompiledFlow(yDoc, compiled) {
     }
     const flowEdges = yDoc.getMap("qi.flow.edges");
     for (const edge of compiled.edges) {
-      const yEdge = new Y5.Map();
+      const yEdge = new Y6.Map();
       yEdge.set("id", edge.id);
       yEdge.set("source", edge.source);
       yEdge.set("target", edge.target);
@@ -10334,7 +11253,7 @@ function hydrateYDocFromMergeResult(yDoc, mergeResult) {
     const flowEdges = yDoc.getMap("qi.flow.edges");
     flowEdges.forEach((_, key) => flowEdges.delete(key));
     for (const edge of merged.edges) {
-      const yEdge = new Y5.Map();
+      const yEdge = new Y6.Map();
       yEdge.set("id", edge.id);
       yEdge.set("source", edge.source);
       yEdge.set("target", edge.target);
@@ -10369,7 +11288,7 @@ function initializeRuntimeForNodes(runtimeMap, compiled, nodeIds) {
   }
 }
 function createYMapFromNode(node) {
-  const yNode = new Y5.Map();
+  const yNode = new Y6.Map();
   yNode.set("id", node.id);
   yNode.set("blockId", node.blockId);
   yNode.set("can", node.can);
@@ -10383,103 +11302,6 @@ function createYMapFromNode(node) {
   return yNode;
 }
 
-// src/core/lib/flowCompiler/documentFragment.ts
-import * as Y6 from "yjs";
-function writeCompiledBlocksToFragment(fragment, blocks) {
-  const documentBlockGroup = getOrCreateDocumentBlockGroup(fragment);
-  for (const block of blocks) {
-    appendBlockToGroup(documentBlockGroup, block);
-  }
-}
-function removeAllFlowBlocks(fragment) {
-  const blockGroup = getExistingBlockGroup(fragment);
-  if (!blockGroup) return;
-  while (blockGroup.length > 0) {
-    blockGroup.delete(0, 1);
-  }
-}
-function replaceBlockInFragment(fragment, block) {
-  const blockGroup = getExistingBlockGroup(fragment);
-  if (!blockGroup) return false;
-  for (let i = 0; i < blockGroup.length; i++) {
-    const container = blockGroup.get(i);
-    if (container instanceof Y6.XmlElement && container.getAttribute("id") === block.id) {
-      blockGroup.delete(i, 1);
-      const newContainer = createBlockContainer(block);
-      blockGroup.insert(i, [newContainer]);
-      return true;
-    }
-  }
-  return false;
-}
-function applyMergeResultToFragment(fragment, mergeResult) {
-  const documentBlockGroup = getOrCreateDocumentBlockGroup(fragment);
-  const blockByNodeId = /* @__PURE__ */ new Map();
-  for (const block of mergeResult.merged.blocks) {
-    for (const [nodeId, blockId] of Object.entries(mergeResult.merged.blockIndex)) {
-      if (blockId === block.id) {
-        blockByNodeId.set(nodeId, block);
-        break;
-      }
-    }
-  }
-  for (const nodeId of mergeResult.replaced) {
-    const block = blockByNodeId.get(nodeId);
-    if (block) {
-      replaceBlockInFragment(fragment, block);
-    }
-  }
-  for (const nodeId of mergeResult.added) {
-    const block = blockByNodeId.get(nodeId);
-    if (block) {
-      appendBlockToGroup(documentBlockGroup, block);
-    }
-  }
-}
-function createBlockContainer(block) {
-  const blockContainer = new Y6.XmlElement("blockContainer");
-  const { backgroundColor: rawBackgroundColor, textColor: rawTextColor, ...contentProps } = block.props;
-  blockContainer.setAttribute("id", block.id);
-  blockContainer.setAttribute("textColor", rawTextColor || "default");
-  blockContainer.setAttribute("backgroundColor", rawBackgroundColor || "default");
-  const blockContent = new Y6.XmlElement(block.type);
-  for (const [key, value] of Object.entries(contentProps)) {
-    if (value !== "") {
-      blockContent.setAttribute(key, value);
-    }
-  }
-  blockContainer.insert(0, [blockContent]);
-  return blockContainer;
-}
-function appendBlockToGroup(blockGroup, block) {
-  const container = createBlockContainer(block);
-  blockGroup.insert(blockGroup.length, [container]);
-}
-function getOrCreateDocumentBlockGroup(fragment) {
-  if (fragment.length === 0) {
-    const blockGroup = new Y6.XmlElement("blockGroup");
-    fragment.insert(0, [blockGroup]);
-    return blockGroup;
-  }
-  if (fragment.length === 1) {
-    const rootNode = fragment.get(0);
-    if (rootNode instanceof Y6.XmlElement && rootNode.nodeName === "blockGroup") {
-      return rootNode;
-    }
-  }
-  throw new Error("Unexpected BlockNote document shape in XmlFragment. Expected a single top-level blockGroup node.");
-}
-function getExistingBlockGroup(fragment) {
-  if (fragment.length === 0) return null;
-  if (fragment.length === 1) {
-    const rootNode = fragment.get(0);
-    if (rootNode instanceof Y6.XmlElement && rootNode.nodeName === "blockGroup") {
-      return rootNode;
-    }
-  }
-  return null;
-}
-
 // src/core/lib/flowCompiler/setup.ts
 async function readFlowAsBaseUcan(options) {
   const { roomId, matrixClient } = options;
@@ -12029,7 +12851,14 @@ export {
   createInvocationStore,
   createMemoryInvocationStore,
   writeRunRecordAndReconcile,
+  toEvaluatorOperator,
+  buildBlockConditionsProp,
   compileBaseUcanFlow,
+  writeCompiledBlocksToFragment,
+  removeAllFlowBlocks,
+  removeBlockFromFragment,
+  replaceBlockInFragment,
+  readBlocksFromFragment,
   readCompiledFlowFromYDoc,
   mergeCompiledFlows,
   decompileToBaseUcanFlow,
@@ -12069,4 +12898,4 @@ export {
   executeQueuedFlowAgentCoreCommands,
   FlowAgentService
 };
-//# sourceMappingURL=chunk-NAR2R3YM.mjs.map
+//# sourceMappingURL=chunk-TK2RJ4KB.mjs.map