@almadar/core 10.80.0 → 10.81.0

package/dist/patterns/index.js

@@ -3,7 +3,7 @@ import { z } from 'zod';
 // src/patterns/patterns-registry.json
 var patterns_registry_default = {
   version: "1.0.0",
-  exportedAt: "2026-09-02T20:03:03.703Z",
+  exportedAt: "2026-09-03T03:26:05.097Z",
   patterns: {
     "entity-table": {
       type: "entity-table",
@@ -26141,6 +26141,28 @@ var patterns_registry_default = {
           ],
           description: "Accessible label/tooltip for the row hover action."
         },
+        onNodeReorder: {
+          types: [
+            "function"
+          ],
+          description: "Called when a row is dropped onto another, in flat `items` mode; carries the moved node's id, its new parent id (`null` for a root drop), and its index within the new parent's children. Presence-gated: binding this prop is what turns on row dragging.",
+          kind: "callback",
+          callbackArgs: [
+            {
+              name: "id",
+              type: "string"
+            },
+            {
+              name: "newParentId",
+              type: "string"
+            },
+            {
+              name: "index",
+              type: "number"
+            }
+          ],
+          default: ""
+        },
         className: {
           types: [
             "string"
@@ -35160,6 +35182,19 @@ var patterns_registry_default = {
             "string"
           ],
           description: "Class for right/bottom pane"
+        },
+        onRatioChange: {
+          types: [
+            "function"
+          ],
+          description: "Called with the new ratio while dragging. Providing this makes `ratio` controlled \u2014 the rendered split always tracks the prop instead of internal state, mirroring a controlled input. Omit for uncontrolled (self-tracked) behavior.",
+          kind: "callback",
+          callbackArgs: [
+            {
+              name: "ratio",
+              type: "number"
+            }
+          ]
         }
       }
     },
@@ -42186,6 +42221,20 @@ var patterns_registry_default = {
           description: "Draw numeric labels on grid lines (default false).",
           default: false
         },
+        tickLabelFontSize: {
+          types: [
+            "number"
+          ],
+          description: "Font size in px for axis tick labels (default 10).",
+          default: 10
+        },
+        labelFontSize: {
+          types: [
+            "number"
+          ],
+          description: "Base font size in px for all other canvas annotations (points, vectors, guides, curves, regions, angles, hops; default 12).",
+          default: 12
+        },
         showCurveLabels: {
           types: [
             "boolean"
@@ -51566,6 +51615,329 @@ var patterns_registry_default = {
           description: "className prop"
         }
       }
+    },
+    "floating-toolbar": {
+      type: "floating-toolbar",
+      category: "component",
+      tier: "molecules",
+      family: "core",
+      description: "FloatingToolbar component",
+      suggestedFor: [
+        "floating",
+        "toolbar",
+        "floating toolbar"
+      ],
+      typicalSize: "medium",
+      propsSchema: {
+        items: {
+          types: [
+            "array"
+          ],
+          description: "Tool items rendered as icon buttons",
+          required: true,
+          items: {
+            types: [
+              "object"
+            ],
+            properties: {
+              id: {
+                types: [
+                  "string"
+                ]
+              },
+              icon: {
+                types: [
+                  "icon",
+                  "string"
+                ]
+              },
+              label: {
+                types: [
+                  "string"
+                ]
+              },
+              event: {
+                types: [
+                  "string"
+                ]
+              },
+              action: {
+                types: [
+                  "string"
+                ]
+              },
+              actionPayload: {
+                types: [
+                  "object"
+                ],
+                freeform: true,
+                eventPayloadBrand: true
+              },
+              active: {
+                types: [
+                  "boolean"
+                ]
+              },
+              disabled: {
+                types: [
+                  "boolean"
+                ]
+              }
+            },
+            required: [
+              "id",
+              "icon",
+              "label"
+            ]
+          }
+        },
+        position: {
+          types: [
+            "string"
+          ],
+          description: "Strip position within the app frame.",
+          enumValues: [
+            "bottom-center",
+            "bottom-left",
+            "bottom-right"
+          ],
+          default: "bottom-center"
+        },
+        children: {
+          types: [
+            "node"
+          ],
+          description: "Custom cells appended after the items, separated by a divider"
+        },
+        className: {
+          types: [
+            "string"
+          ],
+          description: "Additional CSS classes on the positioned root"
+        }
+      }
+    },
+    "dock-layout": {
+      type: "dock-layout",
+      category: "layout",
+      tier: "organisms",
+      family: "core",
+      description: "DockLayout component",
+      suggestedFor: [
+        "dock",
+        "layout",
+        "dock layout"
+      ],
+      typicalSize: "large",
+      propsSchema: {
+        rail: {
+          types: [
+            "node"
+          ],
+          description: "Fixed-width far-left vertical strip (e.g. an icon nav rail)."
+        },
+        sidebar: {
+          types: [
+            "node"
+          ],
+          description: "Collapsible, resizable left sidebar."
+        },
+        main: {
+          types: [
+            "node"
+          ],
+          description: "Required center region.",
+          required: true
+        },
+        bottomPanel: {
+          types: [
+            "node"
+          ],
+          description: "Collapsible, resizable-height bottom panel."
+        },
+        statusBar: {
+          types: [
+            "node"
+          ],
+          description: "Slim strip pinned to the bottom of the frame, below the bottom panel."
+        },
+        secondarySidebar: {
+          types: [
+            "node"
+          ],
+          description: "Collapsible right sidebar."
+        },
+        railWidth: {
+          types: [
+            "number"
+          ],
+          description: "Width of `rail` in pixels. @default 56",
+          default: 56
+        },
+        secondarySidebarWidth: {
+          types: [
+            "number"
+          ],
+          description: "Width of `secondarySidebar` in pixels (fixed \u2014 not resizable). @default 280",
+          default: 280
+        },
+        sidebarCollapsed: {
+          types: [
+            "boolean"
+          ],
+          description: "Whether `sidebar` is collapsed. @default false",
+          default: false
+        },
+        onSidebarCollapsedChange: {
+          types: [
+            "function"
+          ],
+          description: "onSidebarCollapsedChange prop",
+          kind: "callback",
+          callbackArgs: [
+            {
+              name: "collapsed",
+              type: "boolean"
+            }
+          ]
+        },
+        sidebarWidth: {
+          types: [
+            "number"
+          ],
+          description: "Sidebar size as a SplitPane ratio (0-100, percentage of the sidebar/main split). @default 20",
+          default: 20
+        },
+        onSidebarWidthChange: {
+          types: [
+            "function"
+          ],
+          description: "onSidebarWidthChange prop",
+          kind: "callback",
+          callbackArgs: [
+            {
+              name: "width",
+              type: "number"
+            }
+          ]
+        },
+        sidebarMinSize: {
+          types: [
+            "number"
+          ],
+          description: "Minimum sidebar size in pixels, forwarded to SplitPane's `minSize`. @default 160",
+          default: 160
+        },
+        bottomPanelCollapsed: {
+          types: [
+            "boolean"
+          ],
+          description: "Whether `bottomPanel` is collapsed. @default false",
+          default: false
+        },
+        onBottomPanelCollapsedChange: {
+          types: [
+            "function"
+          ],
+          description: "onBottomPanelCollapsedChange prop",
+          kind: "callback",
+          callbackArgs: [
+            {
+              name: "collapsed",
+              type: "boolean"
+            }
+          ]
+        },
+        bottomPanelHeight: {
+          types: [
+            "number"
+          ],
+          description: "Bottom panel size as a SplitPane ratio (0-100, percentage given to the panel). @default 30",
+          default: 30
+        },
+        onBottomPanelHeightChange: {
+          types: [
+            "function"
+          ],
+          description: "onBottomPanelHeightChange prop",
+          kind: "callback",
+          callbackArgs: [
+            {
+              name: "height",
+              type: "number"
+            }
+          ]
+        },
+        bottomPanelMinSize: {
+          types: [
+            "number"
+          ],
+          description: "Minimum bottom panel size in pixels, forwarded to SplitPane's `minSize`. @default 120",
+          default: 120
+        },
+        secondarySidebarCollapsed: {
+          types: [
+            "boolean"
+          ],
+          description: "Whether `secondarySidebar` is collapsed. @default false",
+          default: false
+        },
+        onSecondarySidebarCollapsedChange: {
+          types: [
+            "function"
+          ],
+          description: "onSecondarySidebarCollapsedChange prop",
+          kind: "callback",
+          callbackArgs: [
+            {
+              name: "collapsed",
+              type: "boolean"
+            }
+          ]
+        },
+        className: {
+          types: [
+            "string"
+          ],
+          description: "Additional CSS classes on the root frame."
+        },
+        railClassName: {
+          types: [
+            "string"
+          ],
+          description: "railClassName prop"
+        },
+        sidebarClassName: {
+          types: [
+            "string"
+          ],
+          description: "sidebarClassName prop"
+        },
+        mainClassName: {
+          types: [
+            "string"
+          ],
+          description: "mainClassName prop"
+        },
+        bottomPanelClassName: {
+          types: [
+            "string"
+          ],
+          description: "bottomPanelClassName prop"
+        },
+        statusBarClassName: {
+          types: [
+            "string"
+          ],
+          description: "statusBarClassName prop"
+        },
+        secondarySidebarClassName: {
+          types: [
+            "string"
+          ],
+          description: "secondarySidebarClassName prop"
+        }
+      }
     }
   },
   categories: [
@@ -51591,7 +51963,7 @@ var patterns_registry_default = {
 // src/patterns/integrators-registry.json
 var integrators_registry_default = {
   version: "1.0.0",
-  exportedAt: "2026-08-29T08:09:09.100Z",
+  exportedAt: "2026-09-03T08:33:38.850Z",
   integrators: {
     github: {
       name: "github",
@@ -51600,25 +51972,25 @@ var integrators_registry_default = {
       actions: [
         {
           name: "cloneRepo",
-          description: "",
+          description: "Clone a repository via the git CLI into a local target directory, using the configured token for auth.",
           params: [
             {
               name: "repoUrl",
               type: "string",
               required: true,
-              description: ""
+              description: "HTTPS clone URL, e.g. https://github.com/owner/repo. Owner/repo are parsed from it when not preconfigured."
             },
             {
               name: "targetDir",
               type: "string",
               required: true,
-              description: ""
+              description: "Local directory to clone into."
             },
             {
               name: "branch",
               type: "string",
               required: false,
-              description: ""
+              description: "Branch to check out after cloning; defaults to the repo's default branch."
             }
           ],
           responseShape: {
@@ -51627,19 +51999,19 @@ var integrators_registry_default = {
         },
         {
           name: "createBranch",
-          description: "",
+          description: "Create a new local branch via the git CLI in the configured working directory.",
           params: [
             {
               name: "branchName",
               type: "string",
               required: true,
-              description: ""
+              description: "Name of the branch to create."
             },
             {
               name: "baseBranch",
               type: "string",
               required: false,
-              description: ""
+              description: "Branch to branch from; defaults to the current branch."
             }
           ],
           responseShape: {
@@ -51648,19 +52020,19 @@ var integrators_registry_default = {
         },
         {
           name: "commit",
-          description: "",
+          description: "Commit staged (or given) changes via the git CLI in the configured working directory.",
           params: [
             {
               name: "message",
               type: "string",
               required: true,
-              description: ""
+              description: "Commit message."
             },
             {
               name: "files",
               type: "string[]",
               required: false,
-              description: ""
+              description: "Specific files to commit; when omitted, all changes are committed."
             }
           ],
           responseShape: {
@@ -51669,19 +52041,19 @@ var integrators_registry_default = {
         },
         {
           name: "push",
-          description: "",
+          description: "Push a local branch to the remote via the git CLI, using the configured token for auth.",
           params: [
             {
               name: "branchName",
               type: "string",
               required: true,
-              description: ""
+              description: "Branch name to push."
             },
             {
               name: "force",
               type: "boolean",
               required: false,
-              description: ""
+              description: "Force-push (overwrites remote history); never set true in an agent context."
             }
           ],
           responseShape: {
@@ -51690,37 +52062,37 @@ var integrators_registry_default = {
         },
         {
           name: "createPR",
-          description: "",
+          description: "Open a pull request via the GitHub REST API.",
           params: [
             {
               name: "title",
               type: "string",
               required: true,
-              description: ""
+              description: "Pull request title."
             },
             {
               name: "body",
               type: "string",
               required: true,
-              description: ""
+              description: "Pull request description body."
             },
             {
               name: "baseBranch",
               type: "string",
               required: true,
-              description: ""
+              description: "Branch the PR merges into, e.g. main."
             },
             {
               name: "headBranch",
               type: "string",
               required: true,
-              description: ""
+              description: "Branch the PR merges from (the feature branch)."
             },
             {
               name: "draft",
               type: "boolean",
               required: false,
-              description: ""
+              description: "Open as a draft PR instead of ready-for-review."
             }
           ],
           responseShape: {
@@ -51731,55 +52103,93 @@ var integrators_registry_default = {
         },
         {
           name: "getPRComments",
-          description: "",
+          description: "List review comments on a pull request via the GitHub REST API.",
           params: [
             {
               name: "prNumber",
               type: "number",
               required: true,
-              description: ""
+              description: "Pull request number."
             }
           ],
           responseShape: {
-            comments: "array"
+            comments: {
+              type: "array",
+              items: {
+                type: "object",
+                properties: {
+                  id: {
+                    type: "number",
+                    required: true
+                  },
+                  body: {
+                    type: "string",
+                    required: true
+                  },
+                  user: {
+                    type: "string",
+                    required: true
+                  }
+                }
+              }
+            }
           }
         },
         {
           name: "listIssues",
-          description: "",
+          description: "List issues on the configured repository via the GitHub REST API.",
           params: [
             {
               name: "state",
               type: "string",
               required: false,
-              description: ""
+              description: "Issue state filter: 'open', 'closed', or 'all'; defaults to open."
             },
             {
               name: "labels",
               type: "string[]",
               required: false,
-              description: ""
+              description: "Only issues carrying all of these labels."
             },
             {
               name: "per_page",
               type: "number",
               required: false,
-              description: ""
+              description: "Page size for the GitHub API request."
             }
           ],
           responseShape: {
-            issues: "array"
+            issues: {
+              type: "array",
+              items: {
+                type: "object",
+                properties: {
+                  number: {
+                    type: "number",
+                    required: true
+                  },
+                  title: {
+                    type: "string",
+                    required: true
+                  },
+                  state: {
+                    type: "string",
+                    required: true
+                  }
+                }
+              }
+            }
           }
         },
         {
           name: "getIssue",
-          description: "",
+          description: "Fetch a single issue's details via the GitHub REST API.",
           params: [
             {
               name: "issueNumber",
               type: "number",
               required: true,
-              description: ""
+              description: "Issue number."
             }
           ],
           responseShape: {
@@ -51791,31 +52201,31 @@ var integrators_registry_default = {
         },
         {
           name: "getFile",
-          description: "",
+          description: "Read a file's content from a repository at a given ref (declared intent \u2014 dispatch is being wired).",
           params: [
             {
               name: "owner",
               type: "string",
               required: true,
-              description: ""
+              description: "Repository owner (user or org)."
             },
             {
               name: "repo",
               type: "string",
               required: true,
-              description: ""
+              description: "Repository name."
             },
             {
               name: "path",
               type: "string",
               required: true,
-              description: ""
+              description: "File path within the repository."
             },
             {
               name: "ref",
               type: "string",
               required: false,
-              description: ""
+              description: "Branch, tag, or commit SHA to read from; defaults to the default branch."
             }
           ],
           responseShape: {
@@ -51827,76 +52237,99 @@ var integrators_registry_default = {
         },
         {
           name: "listCommits",
-          description: "",
+          description: "List commits on a repository, optionally filtered by file path (declared intent \u2014 dispatch is being wired).",
           params: [
             {
               name: "owner",
               type: "string",
               required: true,
-              description: ""
+              description: "Repository owner (user or org)."
             },
             {
               name: "repo",
               type: "string",
               required: true,
-              description: ""
+              description: "Repository name."
             },
             {
               name: "path",
               type: "string",
               required: false,
-              description: ""
+              description: "Only commits touching this file path."
             },
             {
               name: "ref",
               type: "string",
               required: false,
-              description: ""
+              description: "Branch, tag, or commit SHA to start from; defaults to the default branch."
             },
             {
               name: "per_page",
               type: "number",
               required: false,
-              description: ""
+              description: "Page size for the GitHub API request."
             }
           ],
           responseShape: {
-            commits: "array"
+            commits: {
+              type: "array",
+              items: {
+                type: "object",
+                properties: {
+                  sha: {
+                    type: "string",
+                    required: true
+                  },
+                  message: {
+                    type: "string",
+                    required: true
+                  },
+                  author: {
+                    type: "string",
+                    required: true
+                  },
+                  date: {
+                    type: "string",
+                    required: true
+                  }
+                }
+              }
+            }
           }
         },
         {
           name: "createIssue",
-          description: "",
+          description: "Open a new issue on a repository (declared intent \u2014 dispatch is being wired).",
           params: [
             {
               name: "owner",
               type: "string",
               required: true,
-              description: ""
+              description: "Repository owner (user or org)."
             },
             {
               name: "repo",
               type: "string",
               required: true,
-              description: ""
+              description: "Repository name."
             },
             {
               name: "title",
               type: "string",
               required: true,
-              description: ""
+              description: "Issue title."
             },
             {
               name: "body",
               type: "string",
               required: false,
-              description: ""
+              description: "Issue body/description."
             },
             {
               name: "labels",
               type: "string[]",
               required: false,
-              description: ""
+              description: "Labels to apply to the new issue."
             }
           ],
           responseShape: {
@@ -51914,25 +52347,25 @@ var integrators_registry_default = {
       actions: [
         {
           name: "createPaymentIntent",
-          description: "",
+          description: "Create a Stripe PaymentIntent for a one-off charge.",
           params: [
             {
               name: "amount",
               type: "number",
               required: true,
-              description: ""
+              description: "Charge amount in the currency's smallest unit (e.g. cents for USD)."
             },
             {
               name: "currency",
               type: "string",
               required: true,
-              description: ""
+              description: "ISO 4217 currency code, e.g. usd."
             },
             {
               name: "metadata",
               type: "object",
               required: false,
-              description: ""
+              description: "Arbitrary key-value tags attached to the PaymentIntent (string values only)."
             }
           ],
           responseShape: {
@@ -51941,17 +52374,18 @@ var integrators_registry_default = {
             status: "string",
             amount: "number",
             currency: "string"
-          }
+          },
+          synonyms: "charge, pay"
         },
         {
           name: "confirmPayment",
-          description: "",
+          description: "Confirm a previously created PaymentIntent, attempting to complete the charge.",
           params: [
             {
               name: "paymentIntentId",
               type: "string",
               required: true,
-              description: ""
+              description: "The PaymentIntent id returned by createPaymentIntent."
             }
           ],
           responseShape: {
@@ -51961,19 +52395,19 @@ var integrators_registry_default = {
         },
         {
           name: "refund",
-          description: "",
+          description: "Refund a charged PaymentIntent, in full or in part.",
           params: [
             {
               name: "paymentIntentId",
               type: "string",
               required: true,
-              description: ""
+              description: "The PaymentIntent id to refund."
             },
             {
               name: "amount",
               type: "number",
               required: false,
-              description: ""
+              description: "Amount to refund in the currency's smallest unit; omit for a full refund."
             }
           ],
           responseShape: {
@@ -51991,65 +52425,85 @@ var integrators_registry_default = {
       actions: [
         {
           name: "generate",
-          description: "",
+          description: "Generate free-form text from a prompt via the configured LLM provider (default 'You are a helpful assistant.' system prompt).",
           params: [
             {
               name: "userPrompt",
               type: "string",
               required: true,
-              description: ""
+              description: "The user/task prompt sent to the model."
             },
             {
               name: "systemPrompt",
               type: "string",
               required: false,
-              description: ""
+              description: "System prompt steering the model's behavior; defaults to a generic assistant prompt."
             },
             {
               name: "model",
               type: "string",
               required: false,
-              description: ""
+              description: "Model id override; when set, a fresh client is built for this call instead of the shared one."
             },
             {
               name: "temperature",
               type: "number",
               required: false,
-              description: ""
+              description: "Sampling temperature (0-1ish, provider-dependent); higher is more random."
             },
             {
               name: "maxTokens",
               type: "number",
               required: false,
-              description: ""
+              description: "Maximum tokens to generate; defaults to 1024."
             }
           ],
           responseShape: {
             content: "string",
-            usage: "object"
+            usage: {
+              type: "object",
+              properties: {
+                promptTokens: {
+                  type: "number",
+                  required: false
+                },
+                completionTokens: {
+                  type: "number",
+                  required: false
+                },
+                totalTokens: {
+                  type: "number",
+                  required: false
+                },
+                tokens: {
+                  type: "number",
+                  required: false
+                }
+              }
+            }
           }
         },
         {
           name: "classify",
-          description: "",
+          description: "Classify text into exactly one of a caller-supplied category list, with a confidence score and reasoning.",
           params: [
             {
               name: "text",
               type: "string",
               required: true,
-              description: ""
+              description: "Text to classify."
             },
             {
               name: "categories",
               type: "string[]",
               required: true,
-              description: ""
+              description: "Closed set of category labels the model must choose from."
             },
             {
               name: "model",
               type: "string",
               required: false,
-              description: ""
+              description: "Model id override."
             }
           ],
           responseShape: {
@@ -52060,56 +52514,56 @@ var integrators_registry_default = {
         },
         {
           name: "extract",
-          description: "",
+          description: "Extract structured data from text according to a JSON-schema-shaped description; returned data is not validated against the schema.",
           params: [
             {
               name: "text",
               type: "string",
               required: true,
-              description: ""
+              description: "Source text to extract data from."
             },
             {
               name: "schema",
               type: "IntegrationParams",
               required: true,
-              description: ""
+              description: "JSON-schema-like description of the fields to extract; passed to the model as a prompt, not enforced structurally."
             },
             {
               name: "model",
               type: "string",
               required: false,
-              description: ""
+              description: "Model id override."
             }
           ],
           responseShape: {}
         },
         {
           name: "summarize",
-          description: "",
+          description: "Summarize text, optionally constrained by length and style, returning a summary plus key points.",
           params: [
             {
               name: "text",
               type: "string",
               required: true,
-              description: ""
+              description: "Text to summarize."
             },
             {
               name: "maxLength",
               type: "number",
               required: false,
-              description: ""
+              description: "Target maximum summary length in words."
             },
             {
               name: "style",
               type: "string",
               required: false,
-              description: ""
+              description: "Summary style: 'bullet' for bullet points, 'detailed' for thorough, otherwise concise."
             },
             {
               name: "model",
               type: "string",
               required: false,
-              description: ""
+              description: "Model id override."
             }
           ],
           responseShape: {
@@ -52119,19 +52573,19 @@ var integrators_registry_default = {
         },
         {
           name: "embed",
-          description: "",
+          description: "Generate embedding vectors for an array of texts via the configured embedding model (default baai/bge-base-en-v1.5 on OpenRouter, independent of the chat provider).",
           params: [
             {
               name: "texts",
               type: "string[]",
               required: true,
-              description: ""
+              description: "Texts to embed, one vector per entry, in order."
             },
             {
               name: "model",
               type: "string",
               required: false,
-              description: ""
+              description: "Embedding model id override."
             }
           ],
           responseShape: {
@@ -52147,19 +52601,19 @@ var integrators_registry_default = {
       actions: [
         {
           name: "infer",
-          description: "",
+          description: "Run inference against a deployed model-serving orbital by posting an INFER event and reading the prediction back out of the emitted INFERRED result; may cold-start (up to 60s default timeout).",
           params: [
             {
               name: "model",
               type: "string",
               required: true,
-              description: ""
+              description: "Checkpoint or model identifier the serving orbital resolves."
             },
             {
               name: "input",
               type: "ServiceParamsValue",
               required: true,
-              description: ""
+              description: "JSON-safe model input payload."
             }
           ],
           responseShape: {
@@ -52177,38 +52631,38 @@ var integrators_registry_default = {
       actions: [
         {
           name: "search",
-          description: "",
+          description: "Search YouTube via the Data API and return matching video snippets.",
           params: [
             {
               name: "query",
               type: "string",
               required: true,
-              description: ""
+              description: "Search query text."
             },
             {
               name: "maxResults",
               type: "number",
               required: false,
-              description: ""
+              description: "Maximum number of results; defaults to 10."
             },
             {
               name: "type",
               type: "string",
               required: false,
-              description: ""
+              description: "Resource type filter passed to the Data API (e.g. 'video', 'channel', 'playlist')."
             }
           ],
           responseShape: {}
         },
         {
           name: "getVideo",
-          description: "",
+          description: "Fetch a video's snippet and statistics via the YouTube Data API.",
           params: [
             {
               name: "videoId",
               type: "string",
               required: true,
-              description: ""
+              description: "YouTube video id."
             }
           ],
           responseShape: {
@@ -52220,13 +52674,13 @@ var integrators_registry_default = {
         },
         {
           name: "getChannel",
-          description: "",
+          description: "Fetch a channel's snippet and statistics via the YouTube Data API.",
           params: [
             {
               name: "channelId",
               type: "string",
               required: true,
-              description: ""
+              description: "YouTube channel id."
             }
           ],
           responseShape: {
@@ -52244,47 +52698,48 @@ var integrators_registry_default = {
       actions: [
         {
           name: "sendSMS",
-          description: "",
+          description: "Send an SMS message via Twilio.",
           params: [
             {
               name: "to",
               type: "string",
               required: true,
-              description: ""
+              description: "Destination phone number, E.164 format."
             },
             {
               name: "body",
               type: "string",
               required: true,
-              description: ""
+              description: "Message text."
             },
             {
               name: "from",
               type: "string",
               required: false,
-              description: ""
+              description: "Sender phone number; defaults to TWILIO_PHONE_NUMBER."
             }
           ],
           responseShape: {
             sid: "string",
             status: "string"
-          }
+          },
+          synonyms: "text message, text"
         },
         {
           name: "sendWhatsApp",
-          description: "",
+          description: "Send a WhatsApp message via Twilio, using the configured phone number as sender on both ends.",
           params: [
             {
               name: "to",
               type: "string",
               required: true,
-              description: ""
+              description: "Destination phone number, E.164 format (sent as whatsapp:number)."
             },
             {
               name: "body",
               type: "string",
               required: true,
-              description: ""
+              description: "Message text."
             }
           ],
           responseShape: {
@@ -52301,31 +52756,31 @@ var integrators_registry_default = {
       actions: [
         {
           name: "send",
-          description: "",
+          description: "Send a transactional email via the configured provider (SendGrid or Resend).",
           params: [
             {
               name: "to",
               type: "string",
               required: true,
-              description: ""
+              description: "Recipient email address."
             },
             {
               name: "subject",
               type: "string",
               required: true,
-              description: ""
+              description: "Email subject line."
             },
             {
               name: "body",
               type: "string",
               required: true,
-              description: ""
+              description: "Plain-text (or HTML, if `htmlBody` is absent) body content."
             },
             {
               name: "from",
               type: "string",
               required: false,
-              description: ""
+              description: "Sender address; defaults to FROM_EMAIL."
             },
             {
               name: "htmlBody",
@@ -52337,7 +52792,7 @@ var integrators_registry_default = {
               name: "replyTo",
               type: "string",
               required: false,
-              description: ""
+              description: "Reply-To address."
             },
             {
               name: "templateId",
@@ -52360,31 +52815,31 @@ var integrators_registry_default = {
       actions: [
         {
           name: "send",
-          description: "",
+          description: "POST a JSON event notification to an external URL, HMAC-SHA256-signed when a secret is configured; 5xx responses retry, 4xx do not.",
           params: [
             {
               name: "url",
               type: "string",
               required: true,
-              description: ""
+              description: "Destination URL to POST to."
             },
             {
               name: "event",
               type: "string",
               required: true,
-              description: ""
+              description: "Event name, carried in the body and the X-Almadar-Event header."
             },
             {
               name: "payload",
               type: "object",
               required: false,
-              description: ""
+              description: "Event payload; defaults to an empty object."
             },
             {
               name: "secret",
               type: "string",
               required: false,
-              description: ""
+              description: "Per-call HMAC signing secret, overriding WEBHOOK_SIGNING_SECRET."
             }
           ],
           responseShape: {
@@ -52402,37 +52857,57 @@ var integrators_registry_default = {
       actions: [
         {
           name: "send",
-          description: "",
+          description: "Send a VAPID-signed Web Push notification to a browser PushSubscription endpoint.",
           params: [
             {
               name: "subscription",
               type: "object",
               required: true,
-              description: ""
+              description: "Browser PushSubscription: endpoint URL plus the p256dh/auth encryption keys.",
+              properties: {
+                endpoint: {
+                  type: "string",
+                  required: true
+                },
+                keys: {
+                  type: "object",
+                  required: true,
+                  properties: {
+                    p256dh: {
+                      type: "string",
+                      required: true
+                    },
+                    auth: {
+                      type: "string",
+                      required: true
+                    }
+                  }
+                }
+              }
             },
             {
               name: "title",
               type: "string",
               required: true,
-              description: ""
+              description: "Notification title."
             },
             {
               name: "body",
               type: "string",
               required: true,
-              description: ""
+              description: "Notification body text."
             },
             {
               name: "url",
               type: "string",
               required: false,
-              description: ""
+              description: "URL to open when the notification is clicked."
             },
             {
               name: "icon",
               type: "string",
               required: false,
-              description: ""
+              description: "Notification icon URL."
             }
           ],
           responseShape: {
@@ -52450,89 +52925,128 @@ var integrators_registry_default = {
       actions: [
         {
           name: "listEvents",
-          description: "",
+          description: "List events on a Google Calendar; pass `syncToken` for incremental sync instead of a time window (the API rejects combining them).",
           params: [
             {
               name: "calendarId",
               type: "string",
               required: false,
-              description: ""
+              description: "Calendar id; defaults to GOOGLE_CALENDAR_ID (or 'primary')."
             },
             {
               name: "timeMin",
               type: "string",
               required: false,
-              description: ""
+              description: "ISO start of the time window (ignored when `syncToken` is set)."
             },
             {
               name: "timeMax",
               type: "string",
               required: false,
-              description: ""
+              description: "ISO end of the time window (ignored when `syncToken` is set)."
             },
             {
               name: "syncToken",
               type: "string",
               required: false,
-              description: ""
+              description: "Incremental-sync token from a previous call's `nextSyncToken`; supersedes timeMin/timeMax."
             },
             {
               name: "maxResults",
               type: "number",
               required: false,
-              description: ""
+              description: "Maximum events to return; defaults to 250."
             }
           ],
           responseShape: {
-            events: "array",
+            events: {
+              type: "array",
+              items: {
+                type: "object",
+                properties: {
+                  id: {
+                    type: "string",
+                    required: true
+                  },
+                  summary: {
+                    type: "string",
+                    required: true
+                  },
+                  description: {
+                    type: "string",
+                    required: true
+                  },
+                  location: {
+                    type: "string",
+                    required: true
+                  },
+                  start: {
+                    type: "string",
+                    required: true
+                  },
+                  end: {
+                    type: "string",
+                    required: true
+                  },
+                  status: {
+                    type: "string",
+                    required: true
+                  },
+                  updated: {
+                    type: "string",
+                    required: true
+                  }
+                }
+              }
+            },
             nextSyncToken: "string | null"
           }
         },
         {
           name: "createEvent",
-          description: "",
+          description: "Create a calendar event; an all-day event uses a 10-char (YYYY-MM-DD) start with no `end`/`durationMinutes`, defaulting to the next day.",
           params: [
             {
               name: "calendarId",
               type: "string",
               required: false,
-              description: ""
+              description: "Calendar id; defaults to GOOGLE_CALENDAR_ID."
             },
             {
               name: "summary",
               type: "string",
               required: true,
-              description: ""
+              description: "Event title."
             },
             {
               name: "description",
               type: "string",
               required: false,
-              description: ""
+              description: "Event description."
             },
             {
               name: "location",
               type: "string",
               required: false,
-              description: ""
+              description: "Event location text."
             },
             {
               name: "start",
               type: "string",
               required: true,
-              description: ""
+              description: "ISO start (10 chars = all-day date, longer = dateTime)."
             },
             {
               name: "end",
               type: "string",
               required: false,
-              description: ""
+              description: "ISO end; if omitted, derived from `durationMinutes` or the all-day next-day convention."
             },
             {
               name: "durationMinutes",
               type: "number",
               required: false,
-              description: ""
+              description: "Duration in minutes used to derive `end` when `end` is omitted (non-all-day events only)."
             }
           ],
           responseShape: {
@@ -52543,49 +53057,49 @@ var integrators_registry_default = {
         },
         {
           name: "updateEvent",
-          description: "",
+          description: "Patch an existing event's fields; only fields present in params are changed.",
           params: [
             {
               name: "calendarId",
               type: "string",
               required: false,
-              description: ""
+              description: "Calendar id; defaults to GOOGLE_CALENDAR_ID."
             },
             {
               name: "eventId",
               type: "string",
               required: true,
-              description: ""
+              description: "Id of the event to update."
             },
             {
               name: "summary",
               type: "string",
               required: false,
-              description: ""
+              description: "New event title."
             },
             {
               name: "description",
               type: "string",
               required: false,
-              description: ""
+              description: "New event description."
             },
             {
               name: "location",
               type: "string",
               required: false,
-              description: ""
+              description: "New event location text."
             },
             {
               name: "start",
               type: "string",
               required: false,
-              description: ""
+              description: "New ISO start."
             },
             {
               name: "end",
               type: "string",
               required: false,
-              description: ""
+              description: "New ISO end."
             }
           ],
           responseShape: {
@@ -52595,19 +53109,19 @@ var integrators_registry_default = {
         },
         {
           name: "deleteEvent",
-          description: "",
+          description: "Delete a calendar event.",
           params: [
             {
               name: "calendarId",
               type: "string",
               required: false,
-              description: ""
+              description: "Calendar id; defaults to GOOGLE_CALENDAR_ID."
             },
             {
               name: "eventId",
               type: "string",
               required: true,
-              description: ""
+              description: "Id of the event to delete."
             }
           ],
           responseShape: {
@@ -52617,58 +53131,73 @@ var integrators_registry_default = {
         },
         {
           name: "freeBusy",
-          description: "",
+          description: "Query busy time blocks on a calendar within a window.",
           params: [
             {
               name: "calendarId",
               type: "string",
               required: false,
-              description: ""
+              description: "Calendar id; defaults to GOOGLE_CALENDAR_ID."
             },
             {
               name: "timeMin",
               type: "string",
               required: true,
-              description: ""
+              description: "ISO start of the query window."
             },
             {
               name: "timeMax",
               type: "string",
               required: true,
-              description: ""
+              description: "ISO end of the query window."
             }
           ],
           responseShape: {
-            busy: "array"
+            busy: {
+              type: "array",
+              items: {
+                type: "object",
+                properties: {
+                  start: {
+                    type: "string",
+                    required: true
+                  },
+                  end: {
+                    type: "string",
+                    required: true
+                  }
+                }
+              }
+            }
           }
         },
         {
           name: "watch",
-          description: "",
+          description: "Register a push-notification channel for calendar change events (Google Calendar API watch).",
           params: [
             {
               name: "calendarId",
               type: "string",
               required: false,
-              description: ""
+              description: "Calendar id; defaults to GOOGLE_CALENDAR_ID."
             },
             {
               name: "channelId",
               type: "string",
               required: true,
-              description: ""
+              description: "Caller-chosen id identifying this notification channel."
             },
             {
               name: "address",
               type: "string",
               required: true,
-              description: ""
+              description: "HTTPS callback URL Google POSTs change notifications to."
             },
             {
               name: "ttlSeconds",
               type: "number",
               required: false,
-              description: ""
+              description: "Requested channel time-to-live in seconds."
             }
           ],
           responseShape: {
@@ -52679,19 +53208,19 @@ var integrators_registry_default = {
         },
         {
           name: "stopWatch",
-          description: "",
+          description: "Stop an active watch channel, ending calendar change notifications.",
           params: [
             {
               name: "channelId",
               type: "string",
               required: true,
-              description: ""
+              description: "The channel id from the corresponding `watch` call."
             },
             {
               name: "resourceId",
               type: "string",
               required: true,
-              description: ""
+              description: "The resourceId returned by the corresponding `watch` call."
             }
           ],
           responseShape: {
@@ -52707,40 +53236,71 @@ var integrators_registry_default = {
       actions: [
         {
           name: "listFiles",
-          description: "",
+          description: "List non-trashed files in a Google Drive folder, optionally filtered by a Drive API query clause.",
           params: [
             {
               name: "folderId",
               type: "string",
               required: false,
-              description: ""
+              description: "Restrict to files whose parents include this folder id."
             },
             {
               name: "query",
               type: "string",
               required: false,
-              description: ""
+              description: "Extra Drive API query clause, ANDed with the folder/trashed filters."
             },
             {
               name: "maxResults",
               type: "number",
               required: false,
-              description: ""
+              description: "Maximum files to return; defaults to 100."
             }
           ],
           responseShape: {
-            files: "array"
+            files: {
+              type: "array",
+              items: {
+                type: "object",
+                properties: {
+                  id: {
+                    type: "string",
+                    required: true
+                  },
+                  name: {
+                    type: "string",
+                    required: true
+                  },
+                  mimeType: {
+                    type: "string",
+                    required: true
+                  },
+                  size: {
+                    type: "number",
+                    required: true
+                  },
+                  modifiedTime: {
+                    type: "string",
+                    required: true
+                  },
+                  webViewLink: {
+                    type: "string",
+                    required: true
+                  }
+                }
+              }
+            }
           }
         },
         {
           name: "getFile",
-          description: "",
+          description: "Download a file's content, base64-encoded.",
           params: [
             {
               name: "fileId",
               type: "string",
               required: true,
-              description: ""
+              description: "Drive file id."
             }
           ],
           responseShape: {
@@ -52753,54 +53313,55 @@ var integrators_registry_default = {
         },
         {
           name: "uploadFile",
-          description: "",
+          description: "Upload a file to Drive; writes go through the user OAuth client when configured (service-account uploads have no storage quota on personal accounts).",
           params: [
             {
               name: "name",
               type: "string",
               required: true,
-              description: ""
+              description: "File name to create."
             },
             {
               name: "content",
               type: "string",
               required: true,
-              description: ""
+              description: "File content as a base64 data URL (data:mime;base64,...) or raw base64/plain text."
             },
             {
               name: "mimeType",
               type: "string",
               required: false,
-              description: ""
+              description: "MIME type; inferred from a data URL when omitted."
             },
             {
               name: "folderId",
               type: "string",
               required: false,
-              description: ""
+              description: "Parent folder id; defaults to GOOGLE_DRIVE_FOLDER_ID."
             }
           ],
           responseShape: {
             id: "string",
             name: "string",
             webViewLink: "string"
-          }
+          },
+          synonyms: "upload file"
         },
         {
           name: "createFolder",
-          description: "",
+          description: "Create a new Drive folder.",
           params: [
             {
               name: "name",
               type: "string",
               required: true,
-              description: ""
+              description: "Folder name to create."
             },
             {
               name: "parentId",
               type: "string",
               required: false,
-              description: ""
+              description: "Parent folder id; defaults to GOOGLE_DRIVE_FOLDER_ID."
             }
           ],
           responseShape: {
@@ -52810,25 +53371,25 @@ var integrators_registry_default = {
         },
         {
           name: "shareFile",
-          description: "",
+          description: "Grant a user permission on a Drive file.",
           params: [
             {
               name: "fileId",
               type: "string",
               required: true,
-              description: ""
+              description: "Drive file id."
             },
             {
               name: "email",
               type: "string",
               required: true,
-              description: ""
+              description: "Email address of the grantee."
             },
             {
               name: "role",
               type: "'reader' | 'writer' | 'commenter'",
               required: false,
-              description: ""
+              description: "Permission level; defaults to 'reader'."
             }
           ],
           responseShape: {
@@ -52845,31 +53406,25 @@ var integrators_registry_default = {
       actions: [
         {
           name: "getSpend",
-          description: "",
+          description: "Fetch total ad spend, impressions, and clicks for an account over a date range via the Meta Graph API Marketing Insights endpoint (read-only).",
           params: [
             {
               name: "accountId",
               type: "string",
               required: false,
-              description: ""
+              description: "Ad account id (with or without the `act_` prefix); defaults to META_AD_ACCOUNT_ID."
             },
             {
               name: "since",
               type: "string",
               required: true,
-              description: ""
+              description: "Range start date (YYYY-MM-DD)."
             },
             {
               name: "until",
               type: "string",
               required: true,
-              description: ""
-            },
-            {
-              name: "clientTag",
-              type: "string",
-              required: false,
-              description: ""
+              description: "Range end date (YYYY-MM-DD)."
             }
           ],
           responseShape: {
@@ -52881,23 +53436,46 @@ var integrators_registry_default = {
         },
         {
           name: "listCampaigns",
-          description: "",
+          description: "List campaigns on an ad account via the Meta Graph API (read-only); dailyBudget is converted from Meta's minor-unit reporting.",
           params: [
             {
               name: "accountId",
               type: "string",
               required: false,
-              description: ""
+              description: "Ad account id (with or without the `act_` prefix); defaults to META_AD_ACCOUNT_ID."
             },
             {
               name: "status",
               type: "string",
               required: false,
-              description: ""
+              description: "Filter by campaign effective_status (e.g. 'ACTIVE', 'PAUSED')."
             }
           ],
           responseShape: {
-            campaigns: "array"
+            campaigns: {
+              type: "array",
+              items: {
+                type: "object",
+                properties: {
+                  id: {
+                    type: "string",
+                    required: true
+                  },
+                  name: {
+                    type: "string",
+                    required: true
+                  },
+                  status: {
+                    type: "string",
+                    required: true
+                  },
+                  dailyBudget: {
+                    type: "number",
+                    required: true
+                  }
+                }
+              }
+            }
           }
         }
       ]
@@ -52909,19 +53487,64 @@ var integrators_registry_default = {
       actions: [
         {
           name: "exportInvoices",
-          description: "",
+          description: "Shape invoice rows into an import-ready CSV export (no accounting-vendor connection \u2014 generic column set).",
           params: [
             {
               name: "invoices",
               type: "array",
               required: true,
-              description: ""
+              description: "Invoice rows to export, in column order id/number/customer/issuedAt/dueAt/currency/net/tax/gross/status.",
+              items: {
+                type: "object",
+                properties: {
+                  id: {
+                    type: "string",
+                    required: true
+                  },
+                  number: {
+                    type: "string",
+                    required: true
+                  },
+                  customer: {
+                    type: "string",
+                    required: true
+                  },
+                  issuedAt: {
+                    type: "string",
+                    required: true
+                  },
+                  dueAt: {
+                    type: "string",
+                    required: true
+                  },
+                  currency: {
+                    type: "string",
+                    required: true
+                  },
+                  net: {
+                    type: "number",
+                    required: true
+                  },
+                  tax: {
+                    type: "number",
+                    required: true
+                  },
+                  gross: {
+                    type: "number",
+                    required: true
+                  },
+                  status: {
+                    type: "string",
+                    required: true
+                  }
+                }
+              }
             },
             {
               name: "format",
               type: "'csv'",
               required: false,
-              description: ""
+              description: "Export format; only 'csv' is currently supported."
             }
           ],
           responseShape: {
@@ -52932,19 +53555,48 @@ var integrators_registry_default = {
         },
         {
           name: "exportJournal",
-          description: "",
+          description: "Shape journal entry rows into an import-ready CSV export.",
           params: [
             {
               name: "entries",
               type: "array",
               required: true,
-              description: ""
+              description: "Journal entry rows to export, in column order date/account/description/debit/credit/reference.",
+              items: {
+                type: "object",
+                properties: {
+                  date: {
+                    type: "string",
+                    required: true
+                  },
+                  account: {
+                    type: "string",
+                    required: true
+                  },
+                  description: {
+                    type: "string",
+                    required: true
+                  },
+                  debit: {
+                    type: "number",
+                    required: true
+                  },
+                  credit: {
+                    type: "number",
+                    required: true
+                  },
+                  reference: {
+                    type: "string",
+                    required: true
+                  }
+                }
+              }
             },
             {
               name: "format",
               type: "'csv'",
               required: false,
-              description: ""
+              description: "Export format; only 'csv' is currently supported."
             }
           ],
           responseShape: {
@@ -52962,25 +53614,25 @@ var integrators_registry_default = {
       actions: [
         {
           name: "createRequisition",
-          description: "",
+          description: "Start a GoCardless Bank Account Data requisition (bank-connection consent flow); the returned `link` is where the end user authorizes access.",
           params: [
             {
               name: "institutionId",
               type: "string",
               required: true,
-              description: ""
+              description: "GoCardless institution id (the bank to connect)."
             },
             {
               name: "redirectUrl",
               type: "string",
               required: true,
-              description: ""
+              description: "URL GoCardless redirects the user to after consent."
             },
             {
               name: "reference",
               type: "string",
               required: false,
-              description: ""
+              description: "Caller-chosen reference to correlate the requisition."
             }
           ],
           responseShape: {
@@ -52990,13 +53642,13 @@ var integrators_registry_default = {
         },
         {
           name: "listAccounts",
-          description: "",
+          description: "List account ids linked under a completed requisition.",
           params: [
             {
               name: "requisitionId",
               type: "string",
               required: true,
-              description: ""
+              description: "Requisition id from createRequisition."
             }
           ],
           responseShape: {
@@ -53005,29 +53657,60 @@ var integrators_registry_default = {
         },
         {
           name: "listTransactions",
-          description: "",
+          description: "List booked transactions on a linked bank account, optionally filtered by date range.",
           params: [
             {
               name: "accountId",
               type: "string",
               required: true,
-              description: ""
+              description: "GoCardless account id."
             },
             {
               name: "dateFrom",
               type: "string",
               required: false,
-              description: ""
+              description: "Only transactions booked on/after this date (YYYY-MM-DD)."
             },
             {
               name: "dateTo",
               type: "string",
               required: false,
-              description: ""
+              description: "Only transactions booked on/before this date (YYYY-MM-DD)."
             }
           ],
           responseShape: {
-            transactions: "array"
+            transactions: {
+              type: "array",
+              items: {
+                type: "object",
+                properties: {
+                  id: {
+                    type: "string",
+                    required: true
+                  },
+                  amount: {
+                    type: "number",
+                    required: true
+                  },
+                  currency: {
+                    type: "string",
+                    required: true
+                  },
+                  date: {
+                    type: "string",
+                    required: true
+                  },
+                  description: {
+                    type: "string",
+                    required: true
+                  },
+                  counterparty: {
+                    type: "string",
+                    required: true
+                  }
+                }
+              }
+            }
           }
         }
       ]
@@ -53039,37 +53722,37 @@ var integrators_registry_default = {
       actions: [
         {
           name: "sendEnvelope",
-          description: "",
+          description: "Send a document for e-signature via DocuSign; accepts the document content as a data URL or raw base64.",
           params: [
             {
               name: "recipientEmail",
               type: "string",
               required: true,
-              description: ""
+              description: "Signer's email address."
             },
             {
               name: "recipientName",
               type: "string",
               required: true,
-              description: ""
+              description: "Signer's display name."
             },
             {
               name: "documentName",
               type: "string",
               required: true,
-              description: ""
+              description: "Document file name (its extension also picks the DocuSign fileExtension)."
             },
             {
               name: "documentContent",
               type: "string",
               required: true,
-              description: ""
+              description: "Document content as a base64 data URL or raw base64."
             },
             {
               name: "emailSubject",
               type: "string",
               required: false,
-              description: ""
+              description: 'Envelope email subject; defaults to "Please sign: " + documentName.'
             }
           ],
           responseShape: {
@@ -53079,13 +53762,13 @@ var integrators_registry_default = {
         },
         {
           name: "getEnvelopeStatus",
-          description: "",
+          description: "Poll a DocuSign envelope's signing status.",
           params: [
             {
               name: "envelopeId",
               type: "string",
               required: true,
-              description: ""
+              description: "DocuSign envelope id from sendEnvelope."
             }
           ],
           responseShape: {
@@ -53095,13 +53778,13 @@ var integrators_registry_default = {
         },
         {
           name: "downloadDocument",
-          description: "",
+          description: "Download the combined signed document(s) for a completed envelope, base64-encoded PDF.",
           params: [
             {
               name: "envelopeId",
               type: "string",
               required: true,
-              description: ""
+              description: "DocuSign envelope id."
             }
           ],
           responseShape: {
@@ -53118,31 +53801,31 @@ var integrators_registry_default = {
       actions: [
         {
           name: "build",
-          description: "",
+          description: "Simulate building a container image (in-memory backend \u2014 no real Docker daemon/SDK; a real build is not yet implemented).",
           params: [
             {
               name: "tag",
               type: "string",
               required: true,
-              description: ""
+              description: "Image tag to build, e.g. myapp:latest."
             },
             {
               name: "dockerfile",
               type: "string",
               required: false,
-              description: ""
+              description: "Dockerfile path; defaults to 'Dockerfile'."
             },
             {
               name: "context",
               type: "string",
               required: false,
-              description: ""
+              description: "Build context directory; defaults to '.'."
             },
             {
               name: "buildArgs",
               type: "object",
               required: false,
-              description: ""
+              description: "Build-time --build-arg values."
             }
           ],
           responseShape: {
@@ -53154,61 +53837,110 @@ var integrators_registry_default = {
         },
         {
           name: "run",
-          description: "",
+          description: "Simulate starting a container from an image (in-memory backend).",
           params: [
             {
               name: "image",
               type: "string",
               required: true,
-              description: ""
+              description: "Image to run (as built/tagged by the `build` action, or an arbitrary name)."
             },
             {
               name: "name",
               type: "string",
               required: false,
-              description: ""
+              description: "Container name; auto-generated when omitted."
             },
             {
               name: "ports",
               type: "array",
               required: false,
-              description: ""
+              description: "Host/container port mappings.",
+              items: {
+                type: "object",
+                properties: {
+                  host: {
+                    type: "number",
+                    required: true
+                  },
+                  container: {
+                    type: "number",
+                    required: true
+                  },
+                  protocol: {
+                    type: "string",
+                    required: false
+                  }
+                }
+              }
             },
             {
               name: "env",
               type: "object",
               required: false,
-              description: ""
+              description: "Environment variables set inside the container."
             },
             {
               name: "volumes",
               type: "array",
               required: false,
-              description: ""
+              description: "Host/container path mounts.",
+              items: {
+                type: "object",
+                properties: {
+                  host: {
+                    type: "string",
+                    required: true
+                  },
+                  container: {
+                    type: "string",
+                    required: true
+                  }
+                }
+              }
             },
             {
               name: "command",
               type: "string",
               required: false,
-              description: ""
+              description: "Override command run inside the container."
             }
           ],
           responseShape: {
             containerId: "string",
             name: "string",
             status: "string",
-            ports: "array"
+            ports: {
+              type: "array",
+              items: {
+                type: "object",
+                properties: {
+                  host: {
+                    type: "number",
+                    required: true
+                  },
+                  container: {
+                    type: "number",
+                    required: true
+                  },
+                  protocol: {
+                    type: "string",
+                    required: true
+                  }
+                }
+              }
+            }
           }
         },
         {
           name: "stop",
-          description: "",
+          description: "Stop a running (or paused) simulated container.",
           params: [
             {
               name: "containerId",
               type: "string",
               required: true,
-              description: ""
+              description: "Container id, or a unique id prefix."
             }
           ],
           responseShape: {
@@ -53219,19 +53951,19 @@ var integrators_registry_default = {
         },
         {
           name: "remove",
-          description: "",
+          description: "Remove a simulated container; fails if it is running unless `force` is set.",
           params: [
             {
               name: "containerId",
               type: "string",
               required: true,
-              description: ""
+              description: "Container id, or a unique id prefix."
             },
             {
               name: "force",
               type: "boolean",
               required: false,
-              description: ""
+              description: "Remove even if the container is currently running."
             }
           ],
           responseShape: {
@@ -53241,25 +53973,25 @@ var integrators_registry_default = {
         },
         {
           name: "logs",
-          description: "",
+          description: "Fetch generated log lines for a simulated container.",
           params: [
             {
               name: "containerId",
               type: "string",
               required: true,
-              description: ""
+              description: "Container id, or a unique id prefix."
             },
             {
               name: "tail",
               type: "number",
               required: false,
-              description: ""
+              description: "Number of most-recent lines to return; defaults to 100."
             },
             {
               name: "since",
               type: "string",
               required: false,
-              description: ""
+              description: "Only lines timestamped at/after this ISO time."
             }
           ],
           responseShape: {
@@ -53270,13 +54002,13 @@ var integrators_registry_default = {
         },
         {
           name: "status",
-          description: "",
+          description: "Fetch a simulated container's current status and metadata.",
           params: [
             {
               name: "containerId",
               type: "string",
               required: true,
-              description: ""
+              description: "Container id, or a unique id prefix."
             }
           ],
           responseShape: {
@@ -53284,7 +54016,26 @@ var integrators_registry_default = {
             name: "string",
             image: "string",
             status: "string",
-            ports: "array",
+            ports: {
+              type: "array",
+              items: {
+                type: "object",
+                properties: {
+                  host: {
+                    type: "number",
+                    required: true
+                  },
+                  container: {
+                    type: "number",
+                    required: true
+                  },
+                  protocol: {
+                    type: "string",
+                    required: true
+                  }
+                }
+              }
+            },
             createdAt: "number",
             startedAt: "number | null",
             stoppedAt: "number | null"
@@ -53292,23 +54043,71 @@ var integrators_registry_default = {
         },
         {
           name: "list",
-          description: "",
+          description: "List simulated containers; by default only running ones (like `docker ps`).",
           params: [
             {
               name: "all",
               type: "boolean",
               required: false,
-              description: ""
+              description: "Include stopped/exited containers, not just running ones."
             },
             {
               name: "filterByLabel",
               type: "string",
               required: false,
-              description: ""
+              description: "Filter by a `key` or `key=value` label match."
             }
           ],
           responseShape: {
-            containers: "array",
+            containers: {
+              type: "array",
+              items: {
+                type: "object",
+                properties: {
+                  id: {
+                    type: "string",
+                    required: true
+                  },
+                  name: {
+                    type: "string",
+                    required: true
+                  },
+                  image: {
+                    type: "string",
+                    required: true
+                  },
+                  status: {
+                    type: "string",
+                    required: true
+                  },
+                  ports: {
+                    type: "array",
+                    required: true,
+                    items: {
+                      type: "object",
+                      properties: {
+                        host: {
+                          type: "number",
+                          required: true
+                        },
+                        container: {
+                          type: "number",
+                          required: true
+                        },
+                        protocol: {
+                          type: "string",
+                          required: true
+                        }
+                      }
+                    }
+                  },
+                  createdAt: {
+                    type: "number",
+                    required: true
+                  }
+                }
+              }
+            },
             total: "number"
           }
         }
@@ -53321,55 +54120,73 @@ var integrators_registry_default = {
       actions: [
         {
           name: "upload",
-          description: "",
+          description: "Upload an object to an S3-compatible bucket (real S3/R2/MinIO backend when storage credentials are configured, in-memory dev fallback otherwise \u2014 refused in production). Admits either the canonical `key`+`content` pair or the file-form `file` payload (UploadDropZone's `{ name, size, type, content }` shape); when `file` is present its `key`/`content` are derived from it.",
           params: [
             {
               name: "bucket",
               type: "string",
               required: true,
-              description: ""
+              description: "Target bucket; defaults to STORAGE_BUCKET."
             },
             {
               name: "key",
               type: "string",
               required: false,
-              description: ""
+              description: "Object key to store under (canonical shape); ignored when `file` is present."
             },
             {
               name: "content",
               type: "string",
               required: false,
-              description: ""
+              description: "Object content as a base64 data URL, raw base64, or plain text (canonical shape); ignored when `file` is present."
             },
             {
               name: "contentType",
               type: "string",
               required: false,
-              description: ""
+              description: "MIME type override for the canonical shape; inferred from a data URL when omitted."
             },
             {
               name: "file",
               type: "object",
               required: false,
-              description: ""
+              description: "File-form upload payload (as emitted by UploadDropZone); `content` is a base64 data URL.",
+              properties: {
+                name: {
+                  type: "string",
+                  required: true
+                },
+                size: {
+                  type: "number",
+                  required: true
+                },
+                type: {
+                  type: "string",
+                  required: true
+                },
+                content: {
+                  type: "string",
+                  required: false
+                }
+              }
             },
             {
               name: "acl",
               type: "'public' | 'private'",
               required: false,
-              description: ""
+              description: "Object ACL \u2014 'public' produces a public URL, otherwise the URL is signed/private."
             },
             {
               name: "maxSize",
               type: "number",
               required: false,
-              description: ""
+              description: "Reject the upload if the file-form payload's declared size exceeds this many bytes."
             },
             {
               name: "metadata",
               type: "IntegrationParams",
               required: false,
-              description: ""
+              description: "Arbitrary metadata stored alongside the object (in-memory backend only)."
             }
           ],
           responseShape: {
@@ -53379,57 +54196,110 @@ var integrators_registry_default = {
             etag: "string",
             id: "string",
             url: "string"
-          }
+          },
+          synonyms: "upload file, upload object"
         },
         {
           name: "uploadMany",
-          description: "",
+          description: "Upload a whole UploadDropZone batch in one call, one item per file \u2014 the FSM-friendly shape for bulk-persisting uploaded-file rows.",
           params: [
             {
               name: "bucket",
               type: "string",
               required: true,
-              description: ""
+              description: "Target bucket; defaults to STORAGE_BUCKET."
             },
             {
               name: "files",
               type: "array",
               required: true,
-              description: ""
+              description: "Files to upload, in UploadDropZone's `{ name, size, type, content }` shape.",
+              items: {
+                type: "object",
+                properties: {
+                  name: {
+                    type: "string",
+                    required: true
+                  },
+                  size: {
+                    type: "number",
+                    required: true
+                  },
+                  type: {
+                    type: "string",
+                    required: true
+                  },
+                  content: {
+                    type: "string",
+                    required: false
+                  }
+                }
+              }
             },
             {
               name: "acl",
               type: "'public' | 'private'",
               required: false,
-              description: ""
+              description: "Object ACL applied to every file in the batch."
             },
             {
               name: "maxSize",
               type: "number",
               required: false,
-              description: ""
+              description: "Reject any file whose declared size exceeds this many bytes."
             }
           ],
           responseShape: {
-            items: "array",
+            items: {
+              type: "array",
+              items: {
+                type: "object",
+                properties: {
+                  id: {
+                    type: "string",
+                    required: true
+                  },
+                  key: {
+                    type: "string",
+                    required: true
+                  },
+                  url: {
+                    type: "string",
+                    required: true
+                  },
+                  name: {
+                    type: "string",
+                    required: true
+                  },
+                  sizeBytes: {
+                    type: "number",
+                    required: true
+                  },
+                  mimeType: {
+                    type: "string",
+                    required: true
+                  }
+                }
+              }
+            },
             count: "number"
           }
         },
         {
           name: "download",
-          description: "",
+          description: "Download an object's content, base64-encoded.",
           params: [
             {
               name: "bucket",
               type: "string",
               required: true,
-              description: ""
+              description: "Bucket the object lives in; defaults to STORAGE_BUCKET."
             },
             {
               name: "key",
               type: "string",
               required: true,
-              description: ""
+              description: "Object key."
             }
           ],
           responseShape: {
@@ -53441,54 +54311,73 @@ var integrators_registry_default = {
         },
         {
           name: "list",
-          description: "",
+          description: "List object keys in a bucket, optionally prefix-filtered, one page at a time.",
           params: [
             {
               name: "bucket",
               type: "string",
               required: true,
-              description: ""
+              description: "Bucket to list; defaults to STORAGE_BUCKET."
             },
             {
               name: "prefix",
               type: "string",
               required: false,
-              description: ""
+              description: "Only keys starting with this prefix."
             },
             {
               name: "maxKeys",
               type: "number",
               required: false,
-              description: ""
+              description: "Maximum keys per page; defaults to 1000."
             },
             {
               name: "continuationToken",
               type: "string",
               required: false,
-              description: ""
+              description: "Pagination token from a previous call's `nextToken`."
             }
           ],
           responseShape: {
-            keys: "array",
+            keys: {
+              type: "array",
+              items: {
+                type: "object",
+                properties: {
+                  key: {
+                    type: "string",
+                    required: true
+                  },
+                  size: {
+                    type: "number",
+                    required: true
+                  },
+                  lastModified: {
+                    type: "number",
+                    required: true
+                  }
+                }
+              }
+            },
             truncated: "boolean",
             nextToken: "string"
           }
         },
         {
           name: "delete",
-          description: "",
+          description: "Delete an object from a bucket.",
           params: [
             {
               name: "bucket",
               type: "string",
               required: true,
-              description: ""
+              description: "Bucket the object lives in; defaults to STORAGE_BUCKET."
             },
             {
               name: "key",
               type: "string",
               required: true,
-              description: ""
+              description: "Object key to delete."
             }
           ],
           responseShape: {
@@ -53497,31 +54386,31 @@ var integrators_registry_default = {
         },
         {
           name: "getSignedUrl",
-          description: "",
+          description: "Generate a time-limited pre-signed URL for direct GET or PUT access to an object.",
           params: [
             {
               name: "bucket",
               type: "string",
               required: true,
-              description: ""
+              description: "Bucket the object lives in; defaults to STORAGE_BUCKET."
             },
             {
               name: "key",
               type: "string",
               required: true,
-              description: ""
+              description: "Object key."
             },
             {
               name: "expiresIn",
               type: "number",
               required: false,
-              description: ""
+              description: "URL validity window in seconds; defaults to 3600."
             },
             {
               name: "operation",
               type: "'get' | 'put'",
               required: false,
-              description: ""
+              description: "Whether the URL authorizes a read or a write; defaults to 'get'."
             }
           ],
           responseShape: {
@@ -53538,31 +54427,31 @@ var integrators_registry_default = {
       actions: [
         {
           name: "enqueue",
-          description: "",
+          description: "Add a job to an in-memory job queue, ordered by priority (higher first) among ready jobs.",
           params: [
             {
               name: "queue",
               type: "string",
               required: true,
-              description: ""
+              description: "Queue name."
             },
             {
               name: "payload",
               type: "ServiceParams",
               required: true,
-              description: ""
+              description: "Arbitrary job payload."
             },
             {
               name: "delay",
               type: "number",
               required: false,
-              description: ""
+              description: "Delay before the job becomes eligible for dequeue, in milliseconds."
             },
             {
               name: "priority",
               type: "number",
               required: false,
-              description: ""
+              description: "Priority \u2014 higher values are dequeued before lower ones."
             }
           ],
           responseShape: {
@@ -53572,13 +54461,13 @@ var integrators_registry_default = {
         },
         {
           name: "dequeue",
-          description: "",
+          description: "Pop the highest-priority pending job whose delay has elapsed, marking it 'processing'; returns null if none is ready.",
           params: [
             {
               name: "queue",
               type: "string",
               required: true,
-              description: ""
+              description: "Queue name."
             }
           ],
           responseShape: {
@@ -53587,13 +54476,13 @@ var integrators_registry_default = {
         },
         {
           name: "status",
-          description: "",
+          description: "Look up a job's current status by id.",
           params: [
             {
               name: "jobId",
               type: "string",
               required: true,
-              description: ""
+              description: "Job id from enqueue."
             }
           ],
           responseShape: {
@@ -53603,19 +54492,19 @@ var integrators_registry_default = {
         },
         {
           name: "complete",
-          description: "",
+          description: "Mark a 'processing' job completed and store its result; no-op (returns false) if the job isn't in 'processing' state.",
           params: [
             {
               name: "jobId",
               type: "string",
               required: true,
-              description: ""
+              description: "Job id."
             },
             {
               name: "result",
               type: "ServiceParams",
               required: false,
-              description: ""
+              description: "Result payload to attach to the job."
             }
           ],
           responseShape: {
@@ -53624,19 +54513,19 @@ var integrators_registry_default = {
         },
         {
           name: "fail",
-          description: "",
+          description: "Mark a 'processing' job failed; no-op (returns false) if the job isn't in 'processing' state.",
           params: [
             {
               name: "jobId",
               type: "string",
               required: true,
-              description: ""
+              description: "Job id."
             },
             {
               name: "error",
               type: "string",
               required: false,
-              description: ""
+              description: "Failure reason to attach to the job."
             }
           ],
           responseShape: {
@@ -53645,13 +54534,13 @@ var integrators_registry_default = {
         },
         {
           name: "cancel",
-          description: "",
+          description: "Remove a 'pending' job from its queue; no-op (returns false) once it has been dequeued.",
           params: [
             {
               name: "jobId",
               type: "string",
               required: true,
-              description: ""
+              description: "Job id."
             }
           ],
           responseShape: {
@@ -53660,13 +54549,13 @@ var integrators_registry_default = {
         },
         {
           name: "size",
-          description: "",
+          description: "Count pending and processing jobs in a queue.",
           params: [
             {
               name: "queue",
               type: "string",
               required: true,
-              description: ""
+              description: "Queue name."
             }
           ],
           responseShape: {
@@ -53684,13 +54573,13 @@ var integrators_registry_default = {
       actions: [
         {
           name: "get",
-          description: "",
+          description: "Read a key's value from the in-memory cache; returns null (as `value`) if absent or expired.",
           params: [
             {
               name: "key",
               type: "string",
               required: true,
-              description: ""
+              description: "Cache key."
             }
           ],
           responseShape: {
@@ -53699,25 +54588,25 @@ var integrators_registry_default = {
         },
         {
           name: "set",
-          description: "",
+          description: "Write a key's value, optionally with an expiry.",
           params: [
             {
               name: "key",
               type: "string",
               required: true,
-              description: ""
+              description: "Cache key."
             },
             {
               name: "value",
               type: "ServiceParams",
               required: true,
-              description: ""
+              description: "Value to store."
             },
             {
               name: "ttl",
               type: "number",
               required: false,
-              description: ""
+              description: "Time-to-live in seconds; omit for no expiry."
             }
           ],
           responseShape: {
@@ -53726,13 +54615,13 @@ var integrators_registry_default = {
         },
         {
           name: "delete",
-          description: "",
+          description: "Delete a key.",
           params: [
             {
               name: "key",
               type: "string",
               required: true,
-              description: ""
+              description: "Cache key."
             }
           ],
           responseShape: {
@@ -53741,19 +54630,19 @@ var integrators_registry_default = {
         },
         {
           name: "lock",
-          description: "",
+          description: "Acquire a mutex on a key; fails (returns acquired:false) if another lock on the key is still alive.",
           params: [
             {
               name: "key",
               type: "string",
               required: true,
-              description: ""
+              description: "Lock key."
             },
             {
               name: "ttl",
               type: "number",
               required: false,
-              description: ""
+              description: "Lock time-to-live in milliseconds; defaults to 30000 (30s)."
             }
           ],
           responseShape: {
@@ -53763,19 +54652,19 @@ var integrators_registry_default = {
         },
         {
           name: "unlock",
-          description: "",
+          description: "Release a lock; only succeeds when `lockId` matches the current holder.",
           params: [
             {
               name: "key",
               type: "string",
               required: true,
-              description: ""
+              description: "Lock key."
             },
             {
               name: "lockId",
               type: "string",
               required: true,
-              description: ""
+              description: "Lock id returned by the corresponding `lock` call."
             }
           ],
           responseShape: {
@@ -53784,19 +54673,19 @@ var integrators_registry_default = {
         },
         {
           name: "increment",
-          description: "",
+          description: "Atomically add to a numeric key's value (creating it at 0 if absent), preserving any existing TTL.",
           params: [
             {
               name: "key",
               type: "string",
               required: true,
-              description: ""
+              description: "Cache key."
             },
             {
               name: "by",
               type: "number",
               required: false,
-              description: ""
+              description: "Amount to add; defaults to 1 (can be negative to decrement)."
             }
           ],
           responseShape: {
@@ -53805,19 +54694,19 @@ var integrators_registry_default = {
         },
         {
           name: "expire",
-          description: "",
+          description: "Set (or reset) a key's expiry; no-op (returns set:false) if the key doesn't exist or is already expired.",
           params: [
             {
               name: "key",
               type: "string",
               required: true,
-              description: ""
+              description: "Cache key."
             },
             {
               name: "ttl",
               type: "number",
               required: true,
-              description: ""
+              description: "New time-to-live in seconds."
             }
           ],
           responseShape: {
@@ -53826,19 +54715,19 @@ var integrators_registry_default = {
         },
         {
           name: "publish",
-          description: "",
+          description: "Publish a message to a channel; delivered synchronously to in-process subscriber callbacks only.",
           params: [
             {
               name: "channel",
               type: "string",
               required: true,
-              description: ""
+              description: "Channel name."
             },
             {
               name: "message",
               type: "ServiceParams",
               required: true,
-              description: ""
+              description: "Message payload."
             }
           ],
           responseShape: {
@@ -53847,13 +54736,13 @@ var integrators_registry_default = {
         },
         {
           name: "subscribe",
-          description: "",
+          description: "Register interest in a channel; does not itself wire a callback (that happens at a higher-level API).",
           params: [
             {
               name: "channel",
               type: "string",
               required: true,
-              description: ""
+              description: "Channel name."
             }
           ],
           responseShape: {
@@ -53869,25 +54758,25 @@ var integrators_registry_default = {
       actions: [
         {
           name: "authorize",
-          description: "",
+          description: "Build the provider authorization URL (PKCE + state) for an OAuth/OIDC login redirect; real OIDC discovery when OAUTH_CLIENT_ID/SECRET are configured, an in-memory mock otherwise.",
           params: [
             {
               name: "provider",
               type: "'google' | 'github' | 'auth0'",
               required: true,
-              description: ""
+              description: "Identity provider; OIDC issuer defaults to Google unless OIDC_ISSUER_URL overrides it."
             },
             {
               name: "scopes",
               type: "string[]",
               required: true,
-              description: ""
+              description: "OAuth scopes to request."
             },
             {
               name: "redirectUri",
               type: "string",
               required: true,
-              description: ""
+              description: "Callback URL the provider redirects back to after consent."
             }
           ],
           responseShape: {
@@ -53897,19 +54786,19 @@ var integrators_registry_default = {
         },
         {
           name: "token",
-          description: "",
+          description: "Exchange an authorization code for tokens, consuming the one-time-use `state` from the matching `authorize` call.",
           params: [
             {
               name: "code",
               type: "string",
               required: true,
-              description: ""
+              description: "Authorization code from the provider's redirect callback."
             },
             {
               name: "state",
               type: "string",
               required: true,
-              description: ""
+              description: "The `state` value returned by `authorize`."
             }
           ],
           responseShape: {
@@ -53921,13 +54810,13 @@ var integrators_registry_default = {
         },
         {
           name: "refresh",
-          description: "",
+          description: "Exchange a refresh token for a new access token.",
           params: [
             {
               name: "refreshToken",
               type: "string",
               required: true,
-              description: ""
+              description: "Refresh token from a prior `token` call."
             }
           ],
           responseShape: {
@@ -53937,13 +54826,13 @@ var integrators_registry_default = {
         },
         {
           name: "revoke",
-          description: "",
+          description: "Revoke an access or refresh token.",
           params: [
             {
               name: "token",
               type: "string",
               required: true,
-              description: ""
+              description: "The access or refresh token to revoke."
             }
           ],
           responseShape: {
@@ -53952,13 +54841,13 @@ var integrators_registry_default = {
         },
         {
           name: "userinfo",
-          description: "",
+          description: "Fetch the authenticated user's profile claims for an access token.",
           params: [
             {
               name: "accessToken",
               type: "string",
               required: true,
-              description: ""
+              description: "Access token from a prior `token`/`refresh` call."
             }
           ],
           responseShape: {
@@ -53977,41 +54866,76 @@ var integrators_registry_default = {
       actions: [
         {
           name: "list",
-          description: "",
+          description: "List declared credentials and their masked (last-4) configuration status; open to any caller.",
           params: [
             {
               name: "service",
               type: "string",
               required: false,
-              description: ""
+              description: "Restrict the listing to one service's declared credentials; omit for all services."
             }
           ],
           responseShape: {
             enabled: "boolean",
-            entries: "array"
+            entries: {
+              type: "array",
+              items: {
+                type: "object",
+                properties: {
+                  service: {
+                    type: "string",
+                    required: true
+                  },
+                  envVar: {
+                    type: "string",
+                    required: true
+                  },
+                  required: {
+                    type: "boolean",
+                    required: true
+                  },
+                  description: {
+                    type: "string",
+                    required: true
+                  },
+                  configured: {
+                    type: "boolean",
+                    required: true
+                  },
+                  source: {
+                    type: "'store' | 'env' | 'none'",
+                    required: true
+                  },
+                  last4: {
+                    type: "string",
+                    required: true
+                  }
+                }
+              }
+            }
           }
         },
         {
           name: "set",
-          description: "",
+          description: "Save a credential value into the hosted store; the env var must be one declared for the service (or a well-formed connection-ref name for `database`). Admin/owner role required.",
           params: [
             {
               name: "service",
               type: "string",
               required: true,
-              description: ""
+              description: "Integration name the credential belongs to."
             },
             {
               name: "envVar",
               type: "string",
               required: true,
-              description: ""
+              description: "Declared env-var name being set."
             },
             {
               name: "value",
               type: "string",
               required: true,
-              description: ""
+              description: "Secret value to store; never logged."
             }
           ],
           responseShape: {
@@ -54023,19 +54947,19 @@ var integrators_registry_default = {
         },
         {
           name: "remove",
-          description: "",
+          description: "Delete a stored credential from the hosted store. Admin/owner role required.",
           params: [
             {
               name: "service",
               type: "string",
               required: true,
-              description: ""
+              description: "Integration name the credential belongs to."
             },
             {
               name: "envVar",
               type: "string",
               required: true,
-              description: ""
+              description: "Env-var name to remove."
             }
           ],
           responseShape: {
@@ -54044,13 +54968,13 @@ var integrators_registry_default = {
         },
         {
           name: "test",
-          description: "",
+          description: "Check whether a service's required credentials are present and, if a live probe is declared for it, exercise the service to confirm they actually work. Admin/owner role required.",
           params: [
             {
               name: "service",
               type: "string",
               required: true,
-              description: ""
+              description: "Integration name to test."
             }
           ],
           responseShape: {
@@ -54064,7 +54988,7 @@ var integrators_registry_default = {
         },
         {
           name: "rotate",
-          description: "",
+          description: "Re-encrypt all stored credentials under the current master key (ALMADAR_CREDENTIAL_MASTER_KEY), retiring ALMADAR_CREDENTIAL_MASTER_KEY_PREVIOUS. Admin/owner role required.",
           params: [],
           responseShape: {
             rotated: "number",
@@ -54081,25 +55005,25 @@ var integrators_registry_default = {
       actions: [
         {
           name: "startSpan",
-          description: "",
+          description: "Start a trace span (in-memory backend \u2014 no OpenTelemetry SDK/exporter).",
           params: [
             {
               name: "name",
               type: "string",
               required: true,
-              description: ""
+              description: "Span name."
             },
             {
               name: "attributes",
               type: "IntegrationParams",
               required: false,
-              description: ""
+              description: "Key-value attributes attached to the span."
             },
             {
               name: "traceId",
               type: "string",
               required: false,
-              description: ""
+              description: "Existing trace id to attach this span to; a new one is generated when omitted."
             }
           ],
           responseShape: {
@@ -54109,19 +55033,19 @@ var integrators_registry_default = {
         },
         {
           name: "endSpan",
-          description: "",
+          description: "Mark a span ended, optionally recording its final status; no-op (returns ended:false) for an unknown span id.",
           params: [
             {
               name: "spanId",
               type: "string",
               required: true,
-              description: ""
+              description: "Span id from startSpan."
             },
             {
               name: "status",
               type: "'ok' | 'error'",
               required: false,
-              description: ""
+              description: "Final span status."
             }
           ],
           responseShape: {
@@ -54130,25 +55054,25 @@ var integrators_registry_default = {
         },
         {
           name: "addEvent",
-          description: "",
+          description: "Attach a timestamped event to an open span; no-op (returns added:false) for an unknown span id.",
           params: [
             {
               name: "spanId",
               type: "string",
               required: true,
-              description: ""
+              description: "Span id from startSpan."
             },
             {
               name: "name",
               type: "string",
               required: true,
-              description: ""
+              description: "Event name."
             },
             {
               name: "attributes",
               type: "IntegrationParams",
               required: false,
-              description: ""
+              description: "Key-value attributes attached to the event."
             }
           ],
           responseShape: {
@@ -54157,31 +55081,31 @@ var integrators_registry_default = {
         },
         {
           name: "recordMetric",
-          description: "",
+          description: "Record a metric sample: counters accumulate, gauges overwrite, histograms append to the sample list.",
           params: [
             {
               name: "name",
               type: "string",
               required: true,
-              description: ""
+              description: "Metric name."
             },
             {
               name: "value",
               type: "number",
               required: true,
-              description: ""
+              description: "Sample value."
             },
             {
               name: "type",
               type: "'counter' | 'gauge' | 'histogram'",
               required: false,
-              description: ""
+              description: "Aggregation kind; defaults to 'counter'."
             },
             {
               name: "labels",
               type: "IntegrationParams",
               required: false,
-              description: ""
+              description: "Key-value labels attached to the metric (replaces prior labels on the same name)."
             }
           ],
           responseShape: {
@@ -54190,20 +55114,20 @@ var integrators_registry_default = {
         },
         {
           name: "getSpan",
-          description: "",
+          description: "Fetch a stored span's full record by id; null if unknown.",
           params: [
             {
               name: "spanId",
               type: "string",
               required: true,
-              description: ""
+              description: "Span id from startSpan."
             }
           ],
           responseShape: {}
         },
         {
           name: "getMetrics",
-          description: "",
+          description: "Fetch all recorded metrics, keyed by metric name.",
           params: [],
           responseShape: {}
         }
@@ -54216,13 +55140,13 @@ var integrators_registry_default = {
       actions: [
         {
           name: "validate",
-          description: "",
+          description: "Validate an orbital schema by writing it to a temp file and shelling out to `npx",
           params: [
             {
               name: "schema",
               type: "string",
               required: true,
-              description: ""
+              description: "Raw .orb schema content to validate."
             }
           ],
           responseShape: {
@@ -54241,31 +55165,31 @@ var integrators_registry_default = {
       actions: [
         {
           name: "sendMessage",
-          description: "",
+          description: "Send a chat message to the DeepAgent server (POST /api/agent/message), continuing an existing thread or starting one.",
           params: [
             {
               name: "message",
               type: "string",
               required: true,
-              description: ""
+              description: "Message text."
             },
             {
               name: "threadId",
               type: "string",
               required: false,
-              description: ""
+              description: "Existing thread id to continue; a new thread starts when omitted."
             },
             {
               name: "skill",
               type: "string",
               required: false,
-              description: ""
+              description: "Named skill to invoke for this message."
             },
             {
               name: "context",
               type: "IntegrationParams",
               required: false,
-              description: ""
+              description: "Extra context passed through to the agent."
             }
           ],
           responseShape: {
@@ -54275,13 +55199,13 @@ var integrators_registry_default = {
         },
         {
           name: "cancelGeneration",
-          description: "",
+          description: "Cancel an in-flight generation on a DeepAgent thread (POST /api/agent/cancel).",
           params: [
             {
               name: "threadId",
               type: "string",
               required: true,
-              description: ""
+              description: "Thread whose generation to cancel."
             }
           ],
           responseShape: {
@@ -54290,13 +55214,13 @@ var integrators_registry_default = {
         },
         {
           name: "validateSchema",
-          description: "",
+          description: "Validate a schema via the DeepAgent server (POST /api/schema/validate).",
           params: [
             {
               name: "schema",
               type: "string",
               required: true,
-              description: ""
+              description: "Schema content to validate."
             }
           ],
           responseShape: {
@@ -54306,19 +55230,19 @@ var integrators_registry_default = {
         },
         {
           name: "compileSchema",
-          description: "",
+          description: "Compile a schema to a target shell via the DeepAgent server (POST /api/schema/compile).",
           params: [
             {
               name: "schema",
               type: "string",
               required: true,
-              description: ""
+              description: "Schema content to compile."
             },
             {
               name: "shell",
               type: "string",
               required: false,
-              description: ""
+              description: "Target codegen shell (e.g. 'typescript')."
             }
           ],
           responseShape: {
@@ -54328,17 +55252,36 @@ var integrators_registry_default = {
         },
         {
           name: "getThreadHistory",
-          description: "",
+          description: "Fetch a thread's message history via the DeepAgent server (POST /api/agent/history).",
           params: [
             {
               name: "threadId",
               type: "string",
               required: true,
-              description: ""
+              description: "Thread id."
             }
           ],
           responseShape: {
-            messages: "array"
+            messages: {
+              type: "array",
+              items: {
+                type: "object",
+                properties: {
+                  role: {
+                    type: "string",
+                    required: true
+                  },
+                  content: {
+                    type: "string",
+                    required: true
+                  },
+                  timestamp: {
+                    type: "number",
+                    required: true
+                  }
+                }
+              }
+            }
           }
         }
       ]
@@ -54350,25 +55293,25 @@ var integrators_registry_default = {
       actions: [
         {
           name: "query",
-          description: "",
+          description: "Run a single read-only SELECT against a Postgres connection (write statements and multi-statement SQL are rejected before execution).",
           params: [
             {
               name: "connectionRef",
               type: "string",
               required: true,
-              description: ""
+              description: "Env-var NAME whose value is the Postgres connection string \u2014 never the secret itself; resolved from the credential store/environment at run time."
             },
             {
               name: "sql",
               type: "string",
               required: true,
-              description: ""
+              description: "SQL text; must be exactly one SELECT statement."
             },
             {
               name: "params",
               type: "DatabaseQueryParamValue[]",
               required: false,
-              description: ""
+              description: "Positional bind parameters for the query."
             }
           ],
           responseShape: {
@@ -54385,13 +55328,13 @@ var integrators_registry_default = {
       actions: [
         {
           name: "getPage",
-          description: "",
+          description: "Look up a Wikipedia page (redirect-resolved): a one-line description, a Commons thumbnail, and the lead-section extract; empty fields on a miss.",
           params: [
             {
               name: "title",
               type: "string",
               required: true,
-              description: ""
+              description: "Page title to look up."
             }
           ],
           responseShape: {
@@ -54410,13 +55353,13 @@ var integrators_registry_default = {
       actions: [
         {
           name: "svgExists",
-          description: "",
+          description: "Check whether an icon exists at the given Iconify API path (a GET, not a HEAD, despite the name).",
           params: [
             {
               name: "path",
               type: "string",
               required: true,
-              description: ""
+              description: "Iconify API path segment to probe, e.g. 'prefix/name.svg'."
             }
           ],
           responseShape: {
@@ -54425,19 +55368,19 @@ var integrators_registry_default = {
         },
         {
           name: "search",
-          description: "",
+          description: "Search Iconify's icon sets by relevance.",
           params: [
             {
               name: "query",
               type: "string",
               required: true,
-              description: ""
+              description: "Search query text."
             },
             {
               name: "limit",
               type: "number",
               required: false,
-              description: ""
+              description: "Maximum icon ids to return; defaults to 1."
             }
           ],
           responseShape: {
@@ -54446,13 +55389,13 @@ var integrators_registry_default = {
         },
         {
           name: "getIconBody",
-          description: "",
+          description: "Fetch an icon's raw SVG body (for color-tone classification); null if the icon or its collection isn't found.",
           params: [
             {
               name: "iconId",
               type: "string",
               required: true,
-              description: ""
+              description: 'Icon id in "prefix:name" form.'
             }
           ],
           responseShape: {
@@ -54468,23 +55411,54 @@ var integrators_registry_default = {
       actions: [
         {
           name: "search",
-          description: "",
+          description: "Search arXiv's public Atom API by relevance.",
           params: [
             {
               name: "query",
               type: "string",
               required: true,
-              description: ""
+              description: "Search query text (matched across all fields)."
             },
             {
               name: "maxResults",
               type: "number",
               required: false,
-              description: ""
+              description: "Maximum results to return; defaults to 8."
             }
           ],
           responseShape: {
-            results: "array"
+            results: {
+              type: "array",
+              items: {
+                type: "object",
+                properties: {
+                  id: {
+                    type: "string",
+                    required: true
+                  },
+                  title: {
+                    type: "string",
+                    required: true
+                  },
+                  summary: {
+                    type: "string",
+                    required: true
+                  },
+                  authors: {
+                    type: "string[]",
+                    required: true
+                  },
+                  published: {
+                    type: "string",
+                    required: true
+                  },
+                  url: {
+                    type: "string",
+                    required: true
+                  }
+                }
+              }
+            }
           }
         }
       ]
@@ -54507,7 +55481,7 @@ var integrators_registry_default = {
 // src/patterns/component-mapping.json
 var component_mapping_default = {
   version: "1.0.0",
-  exportedAt: "2026-09-02T20:03:03.703Z",
+  exportedAt: "2026-09-03T03:26:05.097Z",
   mappings: {
     "page-header": {
       component: "PageHeader",
@@ -55920,6 +56894,16 @@ var component_mapping_default = {
       component: "DocumentDetails",
       importPath: "@/components/core/molecules/DocumentDetails",
       category: "display"
+    },
+    "floating-toolbar": {
+      component: "FloatingToolbar",
+      importPath: "@/components/core/molecules/FloatingToolbar",
+      category: "component"
+    },
+    "dock-layout": {
+      component: "DockLayout",
+      importPath: "@/components/core/organisms/DockLayout",
+      category: "layout"
     }
   }
 };
@@ -55927,7 +56911,7 @@ var component_mapping_default = {
 // src/patterns/event-contracts.json
 var event_contracts_default = {
   version: "1.0.0",
-  exportedAt: "2026-09-02T20:03:03.703Z",
+  exportedAt: "2026-09-03T03:26:05.097Z",
   contracts: {
     form: {
       emits: [
@@ -57170,6 +58154,7 @@ var PATTERN_TYPES = [
   "doc-search",
   "doc-sidebar",
   "doc-toc",
+  "dock-layout",
   "document-details",
   "document-panel",
   "document-viewer",
@@ -57203,6 +58188,7 @@ var PATTERN_TYPES = [
   "flip-card",
   "flip-container",
   "floating-action-button",
+  "floating-toolbar",
   "form",
   "form-actions",
   "form-field",