@almadar/core 10.39.0 → 10.40.0

package/dist/index.js

@@ -479,6 +479,11 @@ var OrbitalEntitySchema = z.object({
   name: z.string().min(1, "Entity name is required"),
   persistence: EntityPersistenceSchema.default("persistent"),
   shared: z.boolean().optional(),
+  // Must stay in step with the Rust serde field (`EntityDefinition.identity`,
+  // orbital-core/src/schema/types.rs). `z.object()` STRIPS unknown keys rather
+  // than rejecting them, so a Rust-only field works on the compiled path and
+  // silently vanishes on the interpreter path.
+  identity: z.boolean().optional(),
   collection: z.string().optional(),
   fields: z.array(EntityFieldSchema).min(1, "At least one field is required"),
   instances: z.array(z.record(z.unknown())).optional(),
@@ -2107,7 +2112,7 @@ function getInteractionModelForDomain(domain) {
 // src/patterns/patterns-registry.json
 var patterns_registry_default = {
   version: "1.0.0",
-  exportedAt: "2026-07-27T04:55:27.017Z",
+  exportedAt: "2026-07-28T10:40:00.004Z",
   patterns: {
     "entity-table": {
       type: "entity-table",
@@ -11928,6 +11933,21 @@ var patterns_registry_default = {
           ],
           description: "Inline style"
         },
+        format: {
+          types: [
+            "string"
+          ],
+          description: 'Value formatting applied to string/number/Date content \u2014 `none` (the default) renders content as-is. Covers the raw-ISO-date class: a bound datetime renders human-readable via `format="date"|"time"|"datetime"`.',
+          enumValues: [
+            "none",
+            "date",
+            "time",
+            "datetime",
+            "number",
+            "currency",
+            "percent"
+          ]
+        },
         content: {
           types: [
             "node"
@@ -16725,6 +16745,27 @@ var patterns_registry_default = {
                   "number"
                 ]
               },
+              mark: {
+                types: [
+                  "object"
+                ],
+                properties: {
+                  kind: {
+                    types: [
+                      "unknown"
+                    ]
+                  },
+                  suggestionId: {
+                    types: [
+                      "string"
+                    ]
+                  }
+                },
+                required: [
+                  "kind",
+                  "suggestionId"
+                ]
+              },
               x: {
                 types: [
                   "number"
@@ -16783,6 +16824,48 @@ var patterns_registry_default = {
             ]
           }
         },
+        proposedEdges: {
+          types: [
+            "array"
+          ],
+          description: "Uncommitted proposal links \u2014 rendered dashed/faint in a separate pass, never folded into the layout springs.",
+          items: {
+            types: [
+              "object"
+            ],
+            properties: {
+              source: {
+                types: [
+                  "string"
+                ]
+              },
+              target: {
+                types: [
+                  "string"
+                ]
+              },
+              label: {
+                types: [
+                  "string"
+                ]
+              },
+              weight: {
+                types: [
+                  "number"
+                ]
+              },
+              color: {
+                types: [
+                  "string"
+                ]
+              }
+            },
+            required: [
+              "source",
+              "target"
+            ]
+          }
+        },
         similarity: {
           types: [
             "array"
@@ -16930,6 +17013,111 @@ var patterns_registry_default = {
                       "number"
                     ]
                   },
+                  mark: {
+                    types: [
+                      "object"
+                    ],
+                    properties: {
+                      kind: {
+                        types: [
+                          "unknown"
+                        ]
+                      },
+                      suggestionId: {
+                        types: [
+                          "string"
+                        ]
+                      }
+                    },
+                    required: [
+                      "kind",
+                      "suggestionId"
+                    ]
+                  },
+                  x: {
+                    types: [
+                      "number"
+                    ]
+                  },
+                  y: {
+                    types: [
+                      "number"
+                    ]
+                  }
+                },
+                required: [
+                  "id"
+                ]
+              }
+            }
+          ]
+        },
+        onMarkClick: {
+          types: [
+            "function"
+          ],
+          description: "On marked-node click (suggestion/proposal target). Takes priority over onNodeClick.",
+          kind: "callback",
+          callbackArgs: [
+            {
+              name: "node",
+              type: "object",
+              schema: {
+                types: [
+                  "object"
+                ],
+                properties: {
+                  id: {
+                    types: [
+                      "string"
+                    ]
+                  },
+                  label: {
+                    types: [
+                      "string"
+                    ]
+                  },
+                  group: {
+                    types: [
+                      "string"
+                    ]
+                  },
+                  color: {
+                    types: [
+                      "string"
+                    ]
+                  },
+                  size: {
+                    types: [
+                      "number"
+                    ]
+                  },
+                  badge: {
+                    types: [
+                      "number"
+                    ]
+                  },
+                  mark: {
+                    types: [
+                      "object"
+                    ],
+                    properties: {
+                      kind: {
+                        types: [
+                          "unknown"
+                        ]
+                      },
+                      suggestionId: {
+                        types: [
+                          "string"
+                        ]
+                      }
+                    },
+                    required: [
+                      "kind",
+                      "suggestionId"
+                    ]
+                  },
                   x: {
                     types: [
                       "number"
@@ -16993,6 +17181,27 @@ var patterns_registry_default = {
                       "number"
                     ]
                   },
+                  mark: {
+                    types: [
+                      "object"
+                    ],
+                    properties: {
+                      kind: {
+                        types: [
+                          "unknown"
+                        ]
+                      },
+                      suggestionId: {
+                        types: [
+                          "string"
+                        ]
+                      }
+                    },
+                    required: [
+                      "kind",
+                      "suggestionId"
+                    ]
+                  },
                   x: {
                     types: [
                       "number"
@@ -17056,6 +17265,27 @@ var patterns_registry_default = {
                       "number"
                     ]
                   },
+                  mark: {
+                    types: [
+                      "object"
+                    ],
+                    properties: {
+                      kind: {
+                        types: [
+                          "unknown"
+                        ]
+                      },
+                      suggestionId: {
+                        types: [
+                          "string"
+                        ]
+                      }
+                    },
+                    required: [
+                      "kind",
+                      "suggestionId"
+                    ]
+                  },
                   x: {
                     types: [
                       "number"
@@ -19811,12 +20041,24 @@ var patterns_registry_default = {
           ],
           description: 'Field name identifying the sender (used with variant: "message")'
         },
+        senderLabelField: {
+          types: [
+            "string"
+          ],
+          description: 'Field holding the sender\'s human-readable name (used with variant: "message"). Defaults to `senderField`. Set this when `senderField` holds an id \u2014 an id-keyed thread otherwise labels bubbles `staff-1` instead of `Sam Staff`.'
+        },
         currentUser: {
           types: [
             "string"
           ],
           description: 'Current user identifier; messages matching this value align right (used with variant: "message")'
         },
+        emptyMessage: {
+          types: [
+            "string"
+          ],
+          description: 'Message shown when there are no rows. Falls back to the generic "no items" translation. `TableView` already exposes this; an agenda or an inbox wants to say what "empty" means in its own words.'
+        },
         className: {
           types: [
             "string"
@@ -43342,74 +43584,180 @@ var integrators_registry_default = {
           name: "cloneRepo",
           description: "Clone a repository",
           params: [
-            { name: "repo", type: "string", required: true, description: "Repository URL or owner/repo" },
-            { name: "branch", type: "string", required: false, description: "Branch to clone" }
+            {
+              name: "repo",
+              type: "string",
+              required: true,
+              description: "Repository URL or owner/repo"
+            },
+            {
+              name: "branch",
+              type: "string",
+              required: false,
+              description: "Branch to clone"
+            }
           ],
-          responseShape: { path: "string", branch: "string" }
+          responseShape: {
+            path: "string",
+            branch: "string"
+          }
         },
         {
           name: "createBranch",
           description: "Create a new branch",
           params: [
-            { name: "repo", type: "string", required: true, description: "Local repo path" },
-            { name: "branch", type: "string", required: true, description: "Branch name" }
+            {
+              name: "repo",
+              type: "string",
+              required: true,
+              description: "Local repo path"
+            },
+            {
+              name: "branch",
+              type: "string",
+              required: true,
+              description: "Branch name"
+            }
           ],
-          responseShape: { branch: "string" }
+          responseShape: {
+            branch: "string"
+          }
         },
         {
           name: "commit",
           description: "Commit changes",
           params: [
-            { name: "repo", type: "string", required: true, description: "Local repo path" },
-            { name: "message", type: "string", required: true, description: "Commit message" },
-            { name: "files", type: "array", required: false, description: "Files to stage" }
+            {
+              name: "repo",
+              type: "string",
+              required: true,
+              description: "Local repo path"
+            },
+            {
+              name: "message",
+              type: "string",
+              required: true,
+              description: "Commit message"
+            },
+            {
+              name: "files",
+              type: "array",
+              required: false,
+              description: "Files to stage"
+            }
           ],
-          responseShape: { hash: "string", message: "string" }
+          responseShape: {
+            hash: "string",
+            message: "string"
+          }
         },
         {
           name: "push",
           description: "Push commits to remote",
           params: [
-            { name: "repo", type: "string", required: true, description: "Local repo path" },
-            { name: "branch", type: "string", required: false, description: "Branch to push" }
+            {
+              name: "repo",
+              type: "string",
+              required: true,
+              description: "Local repo path"
+            },
+            {
+              name: "branch",
+              type: "string",
+              required: false,
+              description: "Branch to push"
+            }
           ],
-          responseShape: { success: "boolean" }
+          responseShape: {
+            success: "boolean"
+          }
         },
         {
           name: "createPR",
           description: "Create a pull request",
           params: [
-            { name: "title", type: "string", required: true, description: "PR title" },
-            { name: "body", type: "string", required: false, description: "PR description" },
-            { name: "head", type: "string", required: true, description: "Head branch" },
-            { name: "base", type: "string", required: false, description: "Base branch (default: main)" }
+            {
+              name: "title",
+              type: "string",
+              required: true,
+              description: "PR title"
+            },
+            {
+              name: "body",
+              type: "string",
+              required: false,
+              description: "PR description"
+            },
+            {
+              name: "head",
+              type: "string",
+              required: true,
+              description: "Head branch"
+            },
+            {
+              name: "base",
+              type: "string",
+              required: false,
+              description: "Base branch (default: main)"
+            }
           ],
-          responseShape: { number: "number", url: "string" }
+          responseShape: {
+            number: "number",
+            url: "string"
+          }
         },
         {
           name: "getPRComments",
           description: "Fetch pull request comments",
           params: [
-            { name: "prNumber", type: "number", required: true, description: "PR number" }
+            {
+              name: "prNumber",
+              type: "number",
+              required: true,
+              description: "PR number"
+            }
           ],
-          responseShape: { comments: "array" }
+          responseShape: {
+            comments: "array"
+          }
         },
         {
           name: "listIssues",
           description: "List issues with optional filters",
           params: [
-            { name: "state", type: "string", required: false, description: "Issue state: open, closed, all" },
-            { name: "labels", type: "string", required: false, description: "Comma-separated label names" }
+            {
+              name: "state",
+              type: "string",
+              required: false,
+              description: "Issue state: open, closed, all"
+            },
+            {
+              name: "labels",
+              type: "string",
+              required: false,
+              description: "Comma-separated label names"
+            }
           ],
-          responseShape: { issues: "array" }
+          responseShape: {
+            issues: "array"
+          }
         },
         {
           name: "getIssue",
           description: "Get a single issue",
           params: [
-            { name: "issueNumber", type: "number", required: true, description: "Issue number" }
+            {
+              name: "issueNumber",
+              type: "number",
+              required: true,
+              description: "Issue number"
+            }
           ],
-          responseShape: { title: "string", body: "string", state: "string" }
+          responseShape: {
+            title: "string",
+            body: "string",
+            state: "string"
+          }
         }
       ]
     },
@@ -43422,7 +43770,12 @@ var integrators_registry_default = {
           name: "validate",
           description: "Validate an orbital schema",
           params: [
-            { name: "schema", type: "string", required: true, description: "Schema content to validate" }
+            {
+              name: "schema",
+              type: "string",
+              required: true,
+              description: "Schema content to validate"
+            }
           ],
           responseShape: {
             valid: "boolean",
@@ -43442,9 +43795,24 @@ var integrators_registry_default = {
           name: "query",
           description: "Run a single read-only SELECT against a connection referenced by env var name",
           params: [
-            { name: "connectionRef", type: "string", required: true, description: "Name of the environment variable holding the connection string (never the secret itself)" },
-            { name: "sql", type: "string", required: true, description: "Single SELECT statement (read-only enforced)" },
-            { name: "params", type: "array", required: false, description: "Bind parameters for the query" }
+            {
+              name: "connectionRef",
+              type: "string",
+              required: true,
+              description: "Name of the environment variable holding the connection string (never the secret itself)"
+            },
+            {
+              name: "sql",
+              type: "string",
+              required: true,
+              description: "Single SELECT statement (read-only enforced)"
+            },
+            {
+              name: "params",
+              type: "array",
+              required: false,
+              description: "Bind parameters for the query"
+            }
           ],
           responseShape: {
             rows: "array",
@@ -43452,15 +43820,133 @@ var integrators_registry_default = {
           }
         }
       ]
+    },
+    wikimedia: {
+      name: "wikimedia",
+      description: "Wikipedia API \u2014 redirect-resolved page lookup (description, portrait, lead extract)",
+      category: "reference",
+      actions: [
+        {
+          name: "getPage",
+          description: "Look up a title on Wikipedia",
+          params: [
+            {
+              name: "title",
+              type: "string",
+              required: true,
+              description: "Page title (human-readable name)"
+            }
+          ],
+          responseShape: {
+            title: "string",
+            description: "string",
+            portraitUrl: "string",
+            extract: "string"
+          }
+        }
+      ]
+    },
+    iconify: {
+      name: "iconify",
+      description: "Iconify API \u2014 brand-logo / icon resolution, search, and body fetch",
+      category: "reference",
+      actions: [
+        {
+          name: "svgExists",
+          description: "Check whether an SVG path exists",
+          params: [
+            {
+              name: "path",
+              type: "string",
+              required: true,
+              description: "Path under api.iconify.design (e.g. devicon/typescript.svg)"
+            }
+          ],
+          responseShape: {
+            exists: "boolean"
+          }
+        },
+        {
+          name: "search",
+          description: "Relevance search for icons",
+          params: [
+            {
+              name: "query",
+              type: "string",
+              required: true,
+              description: "Search term"
+            },
+            {
+              name: "limit",
+              type: "number",
+              required: false,
+              description: "Max results"
+            }
+          ],
+          responseShape: {
+            icons: "string[]"
+          }
+        },
+        {
+          name: "getIconBody",
+          description: "Fetch an icon SVG body for color-tone classification",
+          params: [
+            {
+              name: "iconId",
+              type: "string",
+              required: true,
+              description: "Icon id (prefix:name)"
+            }
+          ],
+          responseShape: {
+            body: "string"
+          }
+        }
+      ]
+    },
+    arxiv: {
+      name: "arxiv",
+      description: "arXiv API \u2014 frontier academic preprint search (emerging-axis research backend)",
+      category: "reference",
+      actions: [
+        {
+          name: "search",
+          description: "Search arXiv preprints by relevance",
+          params: [
+            {
+              name: "query",
+              type: "string",
+              required: true,
+              description: "Search query"
+            },
+            {
+              name: "maxResults",
+              type: "number",
+              required: false,
+              description: "Max results (default 8)"
+            }
+          ],
+          responseShape: {
+            results: "ArxivResult[]"
+          }
+        }
+      ]
     }
   },
-  categories: ["media", "payment", "messaging", "ai", "devtools", "infrastructure"]
+  categories: [
+    "media",
+    "payment",
+    "messaging",
+    "ai",
+    "devtools",
+    "infrastructure"
+  ]
 };
 
 // src/patterns/component-mapping.json
 var component_mapping_default = {
   version: "1.0.0",
-  exportedAt: "2026-07-27T04:55:27.017Z",
+  exportedAt: "2026-07-28T10:40:00.004Z",
   mappings: {
     "page-header": {
       component: "PageHeader",
@@ -44840,7 +45326,7 @@ var component_mapping_default = {
 // src/patterns/event-contracts.json
 var event_contracts_default = {
   version: "1.0.0",
-  exportedAt: "2026-07-27T04:55:27.017Z",
+  exportedAt: "2026-07-28T10:40:00.004Z",
   contracts: {
     form: {
       emits: [