@happyvertical/smrt-profiles 0.51.39 → 0.53.1

package/dist/smrt-knowledge.json

@@ -3,13 +3,13 @@
   "sensitiveFieldsExcluded": true,
   "generatedAt": "1970-01-01T00:00:00.000Z",
   "packageName": "@happyvertical/smrt-profiles",
-  "packageVersion": "0.51.39",
+  "packageVersion": "0.53.1",
   "sourceManifestPath": "dist/manifest.json",
   "agentDocPath": "AGENTS.md",
   "sourceHashes": {
-    "manifest": "fa61533fd5cc48ff6950434a8296761ce3e5378d760ebe68901e1ca5137ba672",
-    "packageJson": "48bc684af80aa00634725390571ecb90b593b2483268635f5a242064ff0324ef",
-    "agents": "a6646a088f8c421b5556f945946db6f83d3a23d77b34c40bb02b726af30b4bd2"
+    "manifest": "18ca01e2858e97fb618ab2f8473af87a739f47f0ed898c6495a330643201b526",
+    "packageJson": "04a36ebf5ca140525b4c38fcb01b8e82f276c5dc591d183bb06205cb46428faf",
+    "agents": "abb7a0e87fb7aeac9eda85e40d68e9198fc807aa8338004161dcb62923a1078c"
   },
   "exports": [
     ".",
@@ -2020,6 +2020,78 @@
       "tags": [],
       "risks": []
     },
+    {
+      "name": "ProfileLinkCollection",
+      "qualifiedName": "@happyvertical/smrt-profiles:ProfileLinkCollection",
+      "collection": "profilelinks",
+      "tableName": "profile_links",
+      "packageName": "@happyvertical/smrt-profiles",
+      "extends": "SmrtCollection",
+      "fields": [],
+      "relationships": [],
+      "methods": [
+        "listForProfile",
+        "reorder",
+        "replaceForProfile"
+      ],
+      "methodSignatures": [
+        {
+          "name": "listForProfile",
+          "async": true,
+          "params": [
+            "profileId: string"
+          ],
+          "returns": "Promise<ProfileLink[]>"
+        },
+        {
+          "name": "reorder",
+          "async": true,
+          "params": [
+            "profileId: string",
+            "linkIds: any"
+          ],
+          "returns": "Promise<ProfileLink[]>"
+        },
+        {
+          "name": "replaceForProfile",
+          "async": true,
+          "params": [
+            "profileId: string",
+            "links: any"
+          ],
+          "returns": "Promise<ProfileLink[]>"
+        }
+      ],
+      "surfaces": [],
+      "withheldSurfaces": [
+        {
+          "kind": "api",
+          "operation": "listForProfile",
+          "code": "api-disabled",
+          "reason": "api is disabled",
+          "objectName": "@happyvertical/smrt-profiles:ProfileLinkCollection"
+        },
+        {
+          "kind": "api",
+          "operation": "reorder",
+          "code": "api-disabled",
+          "reason": "api is disabled",
+          "objectName": "@happyvertical/smrt-profiles:ProfileLinkCollection"
+        },
+        {
+          "kind": "api",
+          "operation": "replaceForProfile",
+          "code": "api-disabled",
+          "reason": "api is disabled",
+          "objectName": "@happyvertical/smrt-profiles:ProfileLinkCollection"
+        }
+      ],
+      "relationshipFeatures": [
+        "uuidColumns"
+      ],
+      "tags": [],
+      "risks": []
+    },
     {
       "name": "ProfileMetadataCollection",
       "qualifiedName": "@happyvertical/smrt-profiles:ProfileMetadataCollection",
@@ -4091,6 +4163,13 @@
           "required": false,
           "columnType": "TEXT"
         },
+        {
+          "name": "isPublic",
+          "type": "boolean",
+          "required": false,
+          "columnType": "BOOLEAN",
+          "default": false
+        },
         {
           "name": "metadata",
           "type": "oneToMany",
@@ -4150,6 +4229,7 @@
         "getApiKeys",
         "getAssets",
         "getAuditLogs",
+        "getLinks",
         "getMetadata",
         "getNostrIdentities",
         "getOidcIdentities",
@@ -4165,6 +4245,7 @@
         "removeRelationship",
         "save",
         "searchByEmail",
+        "setLinks",
         "setTypeBySlug",
         "updateMetadata"
       ],
@@ -4266,6 +4347,11 @@
           ],
           "returns": "Promise<AuditLog[]>"
         },
+        {
+          "name": "getLinks",
+          "async": true,
+          "returns": "Promise<ProfileLink[]>"
+        },
         {
           "name": "getMetadata",
           "async": true,
@@ -4374,6 +4460,14 @@
           ],
           "returns": "Promise<Profile | null>"
         },
+        {
+          "name": "setLinks",
+          "async": true,
+          "params": [
+            "links: any"
+          ],
+          "returns": "Promise<ProfileLink[]>"
+        },
         {
           "name": "setTypeBySlug",
           "async": true,
@@ -4510,6 +4604,18 @@
           "operation": "removeMetadata",
           "objectName": "@happyvertical/smrt-profiles:Profile"
         },
+        {
+          "kind": "cli",
+          "name": "profile_getLinks",
+          "operation": "getLinks",
+          "objectName": "@happyvertical/smrt-profiles:Profile"
+        },
+        {
+          "kind": "cli",
+          "name": "profile_setLinks",
+          "operation": "setLinks",
+          "objectName": "@happyvertical/smrt-profiles:Profile"
+        },
         {
           "kind": "cli",
           "name": "profile_getAssets",
@@ -4752,6 +4858,13 @@
           "reason": "not listed in api.include",
           "objectName": "@happyvertical/smrt-profiles:Profile"
         },
+        {
+          "kind": "api",
+          "operation": "getLinks",
+          "code": "not-included",
+          "reason": "not listed in api.include",
+          "objectName": "@happyvertical/smrt-profiles:Profile"
+        },
         {
           "kind": "api",
           "operation": "getMetadata",
@@ -4857,6 +4970,13 @@
           "reason": "not listed in api.include",
           "objectName": "@happyvertical/smrt-profiles:Profile"
         },
+        {
+          "kind": "api",
+          "operation": "setLinks",
+          "code": "not-included",
+          "reason": "not listed in api.include",
+          "objectName": "@happyvertical/smrt-profiles:Profile"
+        },
         {
           "kind": "api",
           "operation": "setTypeBySlug",
@@ -4958,6 +5078,125 @@
       "tags": [],
       "risks": []
     },
+    {
+      "name": "ProfileLink",
+      "qualifiedName": "@happyvertical/smrt-profiles:ProfileLink",
+      "collection": "profilelinks",
+      "tableName": "profile_links",
+      "packageName": "@happyvertical/smrt-profiles",
+      "extends": "SmrtObject",
+      "fields": [
+        {
+          "name": "tenantId",
+          "type": "text",
+          "required": false,
+          "columnType": "UUID"
+        },
+        {
+          "name": "profileId",
+          "type": "foreignKey",
+          "required": true,
+          "related": "Profile",
+          "columnType": "UUID"
+        },
+        {
+          "name": "platform",
+          "type": "text",
+          "required": true,
+          "columnType": "TEXT",
+          "default": "website",
+          "constraints": {
+            "maxLength": 32
+          }
+        },
+        {
+          "name": "url",
+          "type": "text",
+          "required": true,
+          "columnType": "TEXT",
+          "constraints": {
+            "maxLength": 2048
+          }
+        },
+        {
+          "name": "label",
+          "type": "text",
+          "required": false,
+          "columnType": "TEXT",
+          "constraints": {
+            "maxLength": 200
+          }
+        },
+        {
+          "name": "sortOrder",
+          "type": "integer",
+          "required": true,
+          "columnType": "INTEGER",
+          "default": 0
+        }
+      ],
+      "relationships": [
+        {
+          "name": "profileId",
+          "type": "foreignKey",
+          "required": true,
+          "related": "Profile",
+          "columnType": "UUID"
+        }
+      ],
+      "methods": [
+        "getSlug",
+        "save"
+      ],
+      "methodSignatures": [
+        {
+          "name": "getSlug",
+          "async": true,
+          "returns": "Promise<string | null | undefined>"
+        },
+        {
+          "name": "save",
+          "async": true,
+          "params": [
+            "...args?: any"
+          ],
+          "returns": "Promise<this>"
+        }
+      ],
+      "tenant": {
+        "scoped": true,
+        "mode": "optional",
+        "field": "tenantId"
+      },
+      "conflictColumns": [
+        "tenant_id",
+        "slug",
+        "context"
+      ],
+      "surfaces": [],
+      "withheldSurfaces": [
+        {
+          "kind": "api",
+          "operation": "getSlug",
+          "code": "api-disabled",
+          "reason": "api is disabled",
+          "objectName": "@happyvertical/smrt-profiles:ProfileLink"
+        },
+        {
+          "kind": "api",
+          "operation": "save",
+          "code": "api-disabled",
+          "reason": "api is disabled",
+          "objectName": "@happyvertical/smrt-profiles:ProfileLink"
+        }
+      ],
+      "relationshipFeatures": [
+        "foreignKey",
+        "uuidColumns"
+      ],
+      "tags": [],
+      "risks": []
+    },
     {
       "name": "ProfileMetadata",
       "qualifiedName": "@happyvertical/smrt-profiles:ProfileMetadata",
@@ -6351,6 +6590,13 @@
           "required": false,
           "columnType": "TEXT"
         },
+        {
+          "name": "isPublic",
+          "type": "boolean",
+          "required": false,
+          "columnType": "BOOLEAN",
+          "default": false
+        },
         {
           "name": "metadata",
           "type": "oneToMany",
@@ -6410,6 +6656,7 @@
         "getApiKeys",
         "getAssets",
         "getAuditLogs",
+        "getLinks",
         "getMetadata",
         "getNostrIdentities",
         "getOidcIdentities",
@@ -6425,6 +6672,7 @@
         "removeRelationship",
         "save",
         "searchByEmail",
+        "setLinks",
         "setTypeBySlug",
         "updateMetadata"
       ],
@@ -6526,6 +6774,11 @@
           ],
           "returns": "Promise<AuditLog[]>"
         },
+        {
+          "name": "getLinks",
+          "async": true,
+          "returns": "Promise<ProfileLink[]>"
+        },
         {
           "name": "getMetadata",
           "async": true,
@@ -6634,6 +6887,14 @@
           ],
           "returns": "Promise<Profile | null>"
         },
+        {
+          "name": "setLinks",
+          "async": true,
+          "params": [
+            "links: any"
+          ],
+          "returns": "Promise<ProfileLink[]>"
+        },
         {
           "name": "setTypeBySlug",
           "async": true,
@@ -6741,6 +7002,14 @@
           "path": "/profiles/[id]/removeMetadata",
           "method": "POST"
         },
+        {
+          "kind": "api",
+          "name": "profiles.getLinks",
+          "operation": "getLinks",
+          "objectName": "@happyvertical/smrt-profiles:Person",
+          "path": "/profiles/[id]/getLinks",
+          "method": "POST"
+        },
         {
           "kind": "api",
           "name": "profiles.getAssets",
@@ -6951,6 +7220,18 @@
           "operation": "removeMetadata",
           "objectName": "@happyvertical/smrt-profiles:Person"
         },
+        {
+          "kind": "cli",
+          "name": "person_getLinks",
+          "operation": "getLinks",
+          "objectName": "@happyvertical/smrt-profiles:Person"
+        },
+        {
+          "kind": "cli",
+          "name": "person_setLinks",
+          "operation": "setLinks",
+          "objectName": "@happyvertical/smrt-profiles:Person"
+        },
         {
           "kind": "cli",
           "name": "person_getAssets",
@@ -7149,6 +7430,18 @@
           "operation": "removeMetadata",
           "objectName": "@happyvertical/smrt-profiles:Person"
         },
+        {
+          "kind": "mcp",
+          "name": "person_getlinks",
+          "operation": "getLinks",
+          "objectName": "@happyvertical/smrt-profiles:Person"
+        },
+        {
+          "kind": "mcp",
+          "name": "person_setlinks",
+          "operation": "setLinks",
+          "objectName": "@happyvertical/smrt-profiles:Person"
+        },
         {
           "kind": "mcp",
           "name": "person_getassets",
@@ -7317,6 +7610,13 @@
           "code": "lifecycle-method",
           "reason": "`save` is a framework lifecycle method, not a distinct operation",
           "objectName": "@happyvertical/smrt-profiles:Person"
+        },
+        {
+          "kind": "api",
+          "operation": "setLinks",
+          "code": "not-wireable",
+          "reason": "not routed: the declared type of `links` could not be resolved by the scanner",
+          "objectName": "@happyvertical/smrt-profiles:Person"
         }
       ],
       "relationshipFeatures": [
@@ -7386,6 +7686,13 @@
           "required": false,
           "columnType": "TEXT"
         },
+        {
+          "name": "isPublic",
+          "type": "boolean",
+          "required": false,
+          "columnType": "BOOLEAN",
+          "default": false
+        },
         {
           "name": "metadata",
           "type": "oneToMany",
@@ -7445,6 +7752,7 @@
         "getApiKeys",
         "getAssets",
         "getAuditLogs",
+        "getLinks",
         "getMetadata",
         "getNostrIdentities",
         "getOidcIdentities",
@@ -7460,6 +7768,7 @@
         "removeRelationship",
         "save",
         "searchByEmail",
+        "setLinks",
         "setTypeBySlug",
         "updateMetadata"
       ],
@@ -7561,6 +7870,11 @@
           ],
           "returns": "Promise<AuditLog[]>"
         },
+        {
+          "name": "getLinks",
+          "async": true,
+          "returns": "Promise<ProfileLink[]>"
+        },
         {
           "name": "getMetadata",
           "async": true,
@@ -7669,6 +7983,14 @@
           ],
           "returns": "Promise<Profile | null>"
         },
+        {
+          "name": "setLinks",
+          "async": true,
+          "params": [
+            "links: any"
+          ],
+          "returns": "Promise<ProfileLink[]>"
+        },
         {
           "name": "setTypeBySlug",
           "async": true,
@@ -7776,6 +8098,14 @@
           "path": "/profiles/[id]/removeMetadata",
           "method": "POST"
         },
+        {
+          "kind": "api",
+          "name": "profiles.getLinks",
+          "operation": "getLinks",
+          "objectName": "@happyvertical/smrt-profiles:Organization",
+          "path": "/profiles/[id]/getLinks",
+          "method": "POST"
+        },
         {
           "kind": "api",
           "name": "profiles.getAssets",
@@ -7986,6 +8316,18 @@
           "operation": "removeMetadata",
           "objectName": "@happyvertical/smrt-profiles:Organization"
         },
+        {
+          "kind": "cli",
+          "name": "organization_getLinks",
+          "operation": "getLinks",
+          "objectName": "@happyvertical/smrt-profiles:Organization"
+        },
+        {
+          "kind": "cli",
+          "name": "organization_setLinks",
+          "operation": "setLinks",
+          "objectName": "@happyvertical/smrt-profiles:Organization"
+        },
         {
           "kind": "cli",
           "name": "organization_getAssets",
@@ -8184,6 +8526,18 @@
           "operation": "removeMetadata",
           "objectName": "@happyvertical/smrt-profiles:Organization"
         },
+        {
+          "kind": "mcp",
+          "name": "organization_getlinks",
+          "operation": "getLinks",
+          "objectName": "@happyvertical/smrt-profiles:Organization"
+        },
+        {
+          "kind": "mcp",
+          "name": "organization_setlinks",
+          "operation": "setLinks",
+          "objectName": "@happyvertical/smrt-profiles:Organization"
+        },
         {
           "kind": "mcp",
           "name": "organization_getassets",
@@ -8352,6 +8706,13 @@
           "code": "lifecycle-method",
           "reason": "`save` is a framework lifecycle method, not a distinct operation",
           "objectName": "@happyvertical/smrt-profiles:Organization"
+        },
+        {
+          "kind": "api",
+          "operation": "setLinks",
+          "code": "not-wireable",
+          "reason": "not routed: the declared type of `links` could not be resolved by the scanner",
+          "objectName": "@happyvertical/smrt-profiles:Organization"
         }
       ],
       "relationshipFeatures": [
@@ -8421,6 +8782,13 @@
           "required": false,
           "columnType": "TEXT"
         },
+        {
+          "name": "isPublic",
+          "type": "boolean",
+          "required": false,
+          "columnType": "BOOLEAN",
+          "default": false
+        },
         {
           "name": "metadata",
           "type": "oneToMany",
@@ -8480,6 +8848,7 @@
         "getApiKeys",
         "getAssets",
         "getAuditLogs",
+        "getLinks",
         "getMetadata",
         "getNostrIdentities",
         "getOidcIdentities",
@@ -8495,6 +8864,7 @@
         "removeRelationship",
         "save",
         "searchByEmail",
+        "setLinks",
         "setTypeBySlug",
         "updateMetadata"
       ],
@@ -8596,6 +8966,11 @@
           ],
           "returns": "Promise<AuditLog[]>"
         },
+        {
+          "name": "getLinks",
+          "async": true,
+          "returns": "Promise<ProfileLink[]>"
+        },
         {
           "name": "getMetadata",
           "async": true,
@@ -8704,6 +9079,14 @@
           ],
           "returns": "Promise<Profile | null>"
         },
+        {
+          "name": "setLinks",
+          "async": true,
+          "params": [
+            "links: any"
+          ],
+          "returns": "Promise<ProfileLink[]>"
+        },
         {
           "name": "setTypeBySlug",
           "async": true,
@@ -8811,6 +9194,14 @@
           "path": "/profiles/[id]/removeMetadata",
           "method": "POST"
         },
+        {
+          "kind": "api",
+          "name": "profiles.getLinks",
+          "operation": "getLinks",
+          "objectName": "@happyvertical/smrt-profiles:Bot",
+          "path": "/profiles/[id]/getLinks",
+          "method": "POST"
+        },
         {
           "kind": "api",
           "name": "profiles.getAssets",
@@ -9021,6 +9412,18 @@
           "operation": "removeMetadata",
           "objectName": "@happyvertical/smrt-profiles:Bot"
         },
+        {
+          "kind": "cli",
+          "name": "bot_getLinks",
+          "operation": "getLinks",
+          "objectName": "@happyvertical/smrt-profiles:Bot"
+        },
+        {
+          "kind": "cli",
+          "name": "bot_setLinks",
+          "operation": "setLinks",
+          "objectName": "@happyvertical/smrt-profiles:Bot"
+        },
         {
           "kind": "cli",
           "name": "bot_getAssets",
@@ -9219,6 +9622,18 @@
           "operation": "removeMetadata",
           "objectName": "@happyvertical/smrt-profiles:Bot"
         },
+        {
+          "kind": "mcp",
+          "name": "bot_getlinks",
+          "operation": "getLinks",
+          "objectName": "@happyvertical/smrt-profiles:Bot"
+        },
+        {
+          "kind": "mcp",
+          "name": "bot_setlinks",
+          "operation": "setLinks",
+          "objectName": "@happyvertical/smrt-profiles:Bot"
+        },
         {
           "kind": "mcp",
           "name": "bot_getassets",
@@ -9387,6 +9802,13 @@
           "code": "lifecycle-method",
           "reason": "`save` is a framework lifecycle method, not a distinct operation",
           "objectName": "@happyvertical/smrt-profiles:Bot"
+        },
+        {
+          "kind": "api",
+          "operation": "setLinks",
+          "code": "not-wireable",
+          "reason": "not routed: the declared type of `links` could not be resolved by the scanner",
+          "objectName": "@happyvertical/smrt-profiles:Bot"
         }
       ],
       "relationshipFeatures": [
@@ -11317,6 +11739,18 @@
       "operation": "removeMetadata",
       "objectName": "@happyvertical/smrt-profiles:Profile"
     },
+    {
+      "kind": "cli",
+      "name": "profile_getLinks",
+      "operation": "getLinks",
+      "objectName": "@happyvertical/smrt-profiles:Profile"
+    },
+    {
+      "kind": "cli",
+      "name": "profile_setLinks",
+      "operation": "setLinks",
+      "objectName": "@happyvertical/smrt-profiles:Profile"
+    },
     {
       "kind": "cli",
       "name": "profile_getAssets",
@@ -12135,6 +12569,14 @@
       "path": "/profiles/[id]/removeMetadata",
       "method": "POST"
     },
+    {
+      "kind": "api",
+      "name": "profiles.getLinks",
+      "operation": "getLinks",
+      "objectName": "@happyvertical/smrt-profiles:Person",
+      "path": "/profiles/[id]/getLinks",
+      "method": "POST"
+    },
     {
       "kind": "api",
       "name": "profiles.getAssets",
@@ -12345,6 +12787,18 @@
       "operation": "removeMetadata",
       "objectName": "@happyvertical/smrt-profiles:Person"
     },
+    {
+      "kind": "cli",
+      "name": "person_getLinks",
+      "operation": "getLinks",
+      "objectName": "@happyvertical/smrt-profiles:Person"
+    },
+    {
+      "kind": "cli",
+      "name": "person_setLinks",
+      "operation": "setLinks",
+      "objectName": "@happyvertical/smrt-profiles:Person"
+    },
     {
       "kind": "cli",
       "name": "person_getAssets",
@@ -12543,6 +12997,18 @@
       "operation": "removeMetadata",
       "objectName": "@happyvertical/smrt-profiles:Person"
     },
+    {
+      "kind": "mcp",
+      "name": "person_getlinks",
+      "operation": "getLinks",
+      "objectName": "@happyvertical/smrt-profiles:Person"
+    },
+    {
+      "kind": "mcp",
+      "name": "person_setlinks",
+      "operation": "setLinks",
+      "objectName": "@happyvertical/smrt-profiles:Person"
+    },
     {
       "kind": "mcp",
       "name": "person_getassets",
@@ -12763,6 +13229,14 @@
       "path": "/profiles/[id]/removeMetadata",
       "method": "POST"
     },
+    {
+      "kind": "api",
+      "name": "profiles.getLinks",
+      "operation": "getLinks",
+      "objectName": "@happyvertical/smrt-profiles:Organization",
+      "path": "/profiles/[id]/getLinks",
+      "method": "POST"
+    },
     {
       "kind": "api",
       "name": "profiles.getAssets",
@@ -12973,6 +13447,18 @@
       "operation": "removeMetadata",
       "objectName": "@happyvertical/smrt-profiles:Organization"
     },
+    {
+      "kind": "cli",
+      "name": "organization_getLinks",
+      "operation": "getLinks",
+      "objectName": "@happyvertical/smrt-profiles:Organization"
+    },
+    {
+      "kind": "cli",
+      "name": "organization_setLinks",
+      "operation": "setLinks",
+      "objectName": "@happyvertical/smrt-profiles:Organization"
+    },
     {
       "kind": "cli",
       "name": "organization_getAssets",
@@ -13171,6 +13657,18 @@
       "operation": "removeMetadata",
       "objectName": "@happyvertical/smrt-profiles:Organization"
     },
+    {
+      "kind": "mcp",
+      "name": "organization_getlinks",
+      "operation": "getLinks",
+      "objectName": "@happyvertical/smrt-profiles:Organization"
+    },
+    {
+      "kind": "mcp",
+      "name": "organization_setlinks",
+      "operation": "setLinks",
+      "objectName": "@happyvertical/smrt-profiles:Organization"
+    },
     {
       "kind": "mcp",
       "name": "organization_getassets",
@@ -13391,6 +13889,14 @@
       "path": "/profiles/[id]/removeMetadata",
       "method": "POST"
     },
+    {
+      "kind": "api",
+      "name": "profiles.getLinks",
+      "operation": "getLinks",
+      "objectName": "@happyvertical/smrt-profiles:Bot",
+      "path": "/profiles/[id]/getLinks",
+      "method": "POST"
+    },
     {
       "kind": "api",
       "name": "profiles.getAssets",
@@ -13601,6 +14107,18 @@
       "operation": "removeMetadata",
       "objectName": "@happyvertical/smrt-profiles:Bot"
     },
+    {
+      "kind": "cli",
+      "name": "bot_getLinks",
+      "operation": "getLinks",
+      "objectName": "@happyvertical/smrt-profiles:Bot"
+    },
+    {
+      "kind": "cli",
+      "name": "bot_setLinks",
+      "operation": "setLinks",
+      "objectName": "@happyvertical/smrt-profiles:Bot"
+    },
     {
       "kind": "cli",
       "name": "bot_getAssets",
@@ -13799,6 +14317,18 @@
       "operation": "removeMetadata",
       "objectName": "@happyvertical/smrt-profiles:Bot"
     },
+    {
+      "kind": "mcp",
+      "name": "bot_getlinks",
+      "operation": "getLinks",
+      "objectName": "@happyvertical/smrt-profiles:Bot"
+    },
+    {
+      "kind": "mcp",
+      "name": "bot_setlinks",
+      "operation": "setLinks",
+      "objectName": "@happyvertical/smrt-profiles:Bot"
+    },
     {
       "kind": "mcp",
       "name": "bot_getassets",
@@ -13938,12 +14468,12 @@
     }
   ],
   "relationshipsV2": {
-    "foreignKeyFields": 19,
+    "foreignKeyFields": 20,
     "crossPackageRefFields": 1,
     "junctionCollections": 1,
     "hierarchicalObjects": 0,
     "polymorphicAssociations": 0,
-    "uuidColumns": 85
+    "uuidColumns": 91
   },
-  "agentDoc": "# @happyvertical/smrt-profiles\n\nCentral identity system with multi-auth, relationships, controlled metadata, and audit logging.\n\n## Models\n\n- **Profile** (STI base → Bot, Organization, Person): email (optional; identity uniqueness is arbitrated by `oidc_profile_email_reservations.email_key`, not a DB constraint — legacy duplicates are tolerated and fail closed, #2359), readonly indexed `emailKey` derived with `normalizeIdentityEmail()` for adapter-independent identity lookup, `typeId` FK to ProfileType, plus a `metadata` `@oneToMany('ProfileMetadata')` relationship for controlled per-profile values.\n- **ProfileAsset**: dedicated owned-asset join in `profile_assets` with `relationship` and `sortOrder`.\n- **ProfileRelationship**: bidirectional — creating one auto-creates reciprocal inverse. `contextProfileId` for tertiary relationships. `ProfileRelationshipTerm` tracks start/end dates.\n- **ProfileMetafield**: controlled vocabulary with `validationSchema`. **ProfileMetadata**: per-profile values linked to metafields.\n- **AuditLog**: action, resourceType/Id, `source` (web/cli/ci/webhook/mcp), `onBehalfOfId` for CI pass-through identity. `allowSuperAdminBypass: true`.\n\n## Auth Methods\n\n| Model | Pattern |\n|-------|---------|\n| NostrIdentity | Encrypted keypair (AES-256-GCM). Requires `SERVER_MASTER_SECRET` env var for decryption. NIP-05 address generation. |\n| OidcIdentity | Multiple issuers (Keycloak/Google/GitHub). Lookup by `issuer + subject` pair. Transactional provisioning derives the readonly nullable unique `identityKey` and backfills legacy rows. |\n| ApiKey | SHA-256 hashed. **Plaintext returned once only** on `generate()`. `keyPrefix` for identification. Scope-based with expiry. |\n| MagicLinkToken | One-time token with expiry for passwordless auth. |\n\n## Identity Resolution\n\nAuth helpers in `src/auth/` build profiles from external identity claims:\n\n- `resolveIdentity()` — top-level dispatcher that returns/creates a Profile from Nostr signatures, OIDC claims, magic link tokens, or API keys.\n- `createProfileFromOidc(claims, provider, options)` — creates `Profile` + `OidcIdentity` for first-time OIDC sign-in using a transaction-capable root database in `options.db`.\n- `ProfileCollection.findUniqueGlobalPersonByEmail(email)` — supported\n  verified-identity lookup; fails closed on tenant-scoped, non-Person, or\n  duplicate case-insensitive matches.\n- `ProfileCollection.requireCanonicalGlobalPerson(profileId, email?)` —\n  validates an application-selected Profile against the same canonical global\n  Person invariant.\n- `ProfileCollection.reserveCanonicalIdentityEmail(profileId, email?)` —\n  validates and synchronizes the private unique\n  `oidc_profile_email_reservations.email_key` used as the database arbiter for\n  concurrent external-identity provisioning. Omitting `email` uses the\n  Profile's stored address, moving or removing an existing reservation as the\n  canonical Profile changes.\n- `createProfileFromNostr(email, nostrData)` — creates `Profile` + `NostrIdentity` for Nostr-authenticated users.\n\n## Agent (bot) profiles (#2995)\n\nAn automated agent is an author, and every authoring seam in the framework\n(`ChatMessage.senderProfileId`, `ChatParticipant.profileId`, a persona's\n`actsAsProfileId`) is a `crossPackageRef` to `Profile` — a native uuid column on\nPostgreSQL/DuckDB. A slug-style agent id is therefore not a representable author\n(`22P02`). `src/agent-profile.ts` is the owning-package API that turns one into\na real Profile so no consumer mints bot profiles itself and no uuid column is\nweakened to text:\n\n- `resolveAgentProfile(profiles, { agentId, tenantId, name? })` /\n  `resolveAgentProfileId(...)` — resolve, creating on first use, the `bot`\n  Profile an agent authors as. Idempotent and tenant-bound: identity is keyed on\n  `(tenantId, slug = agentId, context = AGENT_PROFILE_CONTEXT)`, matching the\n  model's `(tenant_id, slug, context, _meta_type)` unique key, so an agent id\n  resolves to a distinct profile per tenant and never collides with a\n  person/organization sharing the slug. Classification is the `bot` ProfileType\n  (`AGENT_PROFILE_TYPE_SLUG`), created on demand. Parallel first use converges\n  on the natural key rather than on whoever's INSERT won (each attempt re-reads\n  before and after writing), which matters because NULLs are distinct in the\n  `(tenant_id, slug, context)` unique index, so an untenanted agent is not\n  arbitrated by the database (smrt#2360). Pinned against real PostgreSQL by\n  `src/__tests__/agent-profile-postgres.test.ts`\n  (`pnpm --filter @happyvertical/smrt-profiles test:postgres`).\n\nFirst consumer: `@happyvertical/smrt-chat`'s `ChatService`.\n\n## Key Methods\n\n- `Profile.getAssets()` / `addAsset()` / `removeAsset()` and the matching `ProfileCollection` wrappers — canonical owned asset helpers backed by `profile_assets`.\n- `Profile.addMetadata(metafieldSlug, value)` / `Profile.getMetadata()` — validates against metafield schema. `ProfileCollection.batchGetMetadata()` / `batchUpdateMetadata()` for bulk reads/writes.\n- `Profile.getRelationships({ direction: 'from'|'to'|'all' })` — direction matters.\n- `Profile.getRelationshipsFrom()` / `getRelationshipsTo()` — R10-generated `@oneToMany` accessors. ProfileRelationship has two FKs back to Profile, so each `@oneToMany` annotates its inverse explicitly (`{ foreignKey: 'fromProfileId' }` / `'toProfileId'`). Return raw `ProfileRelationship[]`; use `getRelationships()` for slug/direction filtering.\n- AI: `generateBio()` (uses `smrtProfiles.profile.generateBio` prompt via `@happyvertical/smrt-prompts`), `matches(criteria)` (delegates to `is()`).\n\n## Prompt Registry\n\n`generateBio()` is registered with `@happyvertical/smrt-prompts` so tenants can override template/model/params at runtime:\n\n```typescript\nimport { smrtProfilesGenerateBioPrompt } from '@happyvertical/smrt-profiles';\n// key: 'smrtProfiles.profile.generateBio'\n```\n\n## Gotchas\n\n- **SERVER_MASTER_SECRET required** for Nostr private key decryption — centralized key management\n- **API key never returned again**: `ApiKey.generate()` returns plaintext once; only `keyPrefix` visible later\n- **OIDC unique per issuer+subject**: same subject from different issuers =\n  different identities. Both claims are opaque and case-sensitive; preserve\n  exact whitespace after using trim only to reject blank values.\n- **OIDC identity mutations are trusted-only**: generated REST, MCP, and CLI\n  surfaces are read-only. Link or update identities through transactional\n  provisioning APIs so callers cannot rebind issuer/subject authority to an\n  arbitrary Profile. Deprecated `OidcIdentity.findOrCreate()` preserves only\n  transaction-safe exact-link reuse and refuses to create new links;\n  `OidcIdentityCollection.linkToProfile()` and `Profile.linkOidcIdentity()`\n  delegate to that same non-creating compatibility path.\n- **Apply schema migrations for identity race keys**: run `smrt db:status`,\n  `smrt db:migrate`, then `smrt db:status` before deploying. Transactional OIDC\n  provisioning populates `OidcIdentity.identityKey` and\n  `oidc_profile_email_reservations`; legacy rows reserve an address only after\n  safe validation. Stop/upgrade old Profile writers, then run the public,\n  transactional and idempotent `backfillProfileEmailKeys(db)` from one deploy\n  process. Verified-email provisioning and public email-key lookup require the\n  standard `_smrt_backfills` readiness marker and fail closed immediately when\n  it is absent. This keeps table scans in the explicit deploy step; runtime\n  reads use the indexed key and validate only returned candidates.\n- **Public OIDC provisioning requires transactions**:\n  `createProfileFromOidc()` owns a root transaction or uses a savepoint on an\n  already-bound handle. Root adapters must expose `beginTransaction`;\n  transaction-only handles are ambiguous and fail closed. Pass the root\n  database for adapters without nested savepoints, including DuckDB;\n  provisioning fails before durable writes if neither path is safe. Trusted\n  framework packages use the private\n  `@happyvertical/smrt-profiles/internal/oidc-provisioning` subpath instead of\n  duplicating adapter probing, locking, or retry policy, and supply both exact\n  issuer/subject and normalized-email lock keys in deterministic order. The\n  coordinator additionally serializes every root-handle statement it owns per\n  database URL on SQLite/DuckDB — shared `_smrt_backfills` initialization, the\n  provisioning transaction, and the post-commit rebind — because those adapters\n  multiplex one native connection and cannot overlap unrelated root\n  transactions safely. **Never overlap two statements on one such handle,\n  transaction-bound or not** — no `Promise.all` over reads, not even\n  primary-key rebinds — because DuckDB fails the losing prepared statement or\n  aborts the process outright. It retries\n  bounded PostgreSQL deadlock/serialization failures. New OIDC Profiles use per-profile,\n  non-semantic slugs so duplicate display names never invoke natural-key upsert.\n  Caller-owned transactions never execute `_smrt_backfills` DDL; paths that\n  perform canonical email lookup or reservation require the table to already\n  exist or the caller must retry with the root database. Exact issuer/subject\n  reuse skips the email-key readiness-marker lookup, but root coordination still\n  initializes the shared tracker table. Caller-owned exact reuse does not\n  consult the tracker and therefore does not require that table.\n- **Profile-only OIDC linking fails closed on existing email matches**:\n  the typed canonical scenario contract is\n  `src/testing/oidcProvisioningDecisionMatrix.ts`, executed by both Profiles\n  and Users tests; keep public docs pointed at it instead of adding a second\n  behavioral table.\n  `createProfileFromOidc()` preserves exact issuer/subject reuse, including\n  legacy tenant-scoped and non-Person links, but profiles cannot prove whether a\n  User owns a same-email Profile. New identities therefore never attach to an\n  existing email match through this helper; User/session provisioning still\n  rejects unsafe linked Profiles before creating authentication state. Use\n  `UserCollection.getOrCreateFromOidc()` for owner-aware verified-email reuse and\n  its supported transaction-bound hooks. A pre-provisioned owned Person remains\n  fail-closed unless the application explicitly uses `authorizeProfileOwner`\n  to select both the canonical Profile and its existing approved sole owner;\n  the users package revalidates those IDs, emails, and identity authority in\n  the provisioning transaction.\n- **Email storage and identity matching differ**: `Profile.email` has an\n  exact-value DB constraint. Identity boundaries query readonly indexed\n  `Profile.emailKey`, derived by the shared TypeScript\n  `normalizeIdentityEmail()` helper rather than adapter-specific SQL casing or\n  trimming, and deliberately fail closed on duplicate normalized keys.\n- **Manifest objects must remain root-importable**: the non-API\n  `OidcProfileEmailReservation` model and collection are public root exports\n  because generated consumer registration imports every advertised manifest\n  symbol from `@happyvertical/smrt-profiles`. Release-pack validation imports\n  the actual generated register file from the packed tarball.\n- **Optional tenancy** on Profile; AuditLog allows super-admin bypass\n"
+  "agentDoc": "# @happyvertical/smrt-profiles\n\nCentral identity system with multi-auth, relationships, controlled metadata, and audit logging.\n\n## Models\n\n- **Profile** (STI base → Bot, Organization, Person): email (optional; identity uniqueness is arbitrated by `oidc_profile_email_reservations.email_key`, not a DB constraint — legacy duplicates are tolerated and fail closed, #2359), readonly indexed `emailKey` derived with `normalizeIdentityEmail()` for adapter-independent identity lookup, `typeId` FK to ProfileType, plus a `metadata` `@oneToMany('ProfileMetadata')` relationship for controlled per-profile values.\n- **ProfileAsset**: dedicated owned-asset join in `profile_assets` with `relationship` and `sortOrder`.\n- **ProfileLink**: ordered web links in `profile_links` (`platform` from `PROFILE_LINK_PLATFORMS`, validated http(s) `url`, optional `label`, `sortOrder`). `profileId` FK is `onDelete: 'CASCADE'`. Slug is the id (never url/label, so a new link cannot adopt another row through the natural key). Write through `ProfileLinkCollection.replaceForProfile()` / `reorder()` (one transaction each; resolve the profile in the current tenant context and stamp its tenant) or `Profile.setLinks()` / `getLinks()`.\n- **Profile.isPublic**: optional public-figure flag (boolean, default false). Records the fact only; consumers decide visibility.\n- **ProfileRelationship**: bidirectional — creating one auto-creates reciprocal inverse. `contextProfileId` for tertiary relationships. `ProfileRelationshipTerm` tracks start/end dates.\n- **ProfileMetafield**: controlled vocabulary with `validationSchema`. **ProfileMetadata**: per-profile values linked to metafields. `addMetadata()` stamps new rows with the profile's `tenantId` (never rely on auto-population, which super-admin/system context skips, #3235) and resolves the metafield as profile-tenant first, then global, never another tenant's.\n- **AuditLog**: action, resourceType/Id, `source` (web/cli/ci/webhook/mcp), `onBehalfOfId` for CI pass-through identity. `allowSuperAdminBypass: true`.\n\n## Auth Methods\n\n| Model | Pattern |\n|-------|---------|\n| NostrIdentity | Encrypted keypair (AES-256-GCM). Requires `SERVER_MASTER_SECRET` env var for decryption. NIP-05 address generation. |\n| OidcIdentity | Multiple issuers (Keycloak/Google/GitHub). Lookup by `issuer + subject` pair. Transactional provisioning derives the readonly nullable unique `identityKey` and backfills legacy rows. |\n| ApiKey | SHA-256 hashed. **Plaintext returned once only** on `generate()`. `keyPrefix` for identification. Scope-based with expiry. |\n| MagicLinkToken | One-time token with expiry for passwordless auth. |\n\n## Identity Resolution\n\nAuth helpers in `src/auth/` build profiles from external identity claims:\n\n- `resolveIdentity()` — top-level dispatcher that returns/creates a Profile from Nostr signatures, OIDC claims, magic link tokens, or API keys.\n- `createProfileFromOidc(claims, provider, options)` — creates `Profile` + `OidcIdentity` for first-time OIDC sign-in using a transaction-capable root database in `options.db`.\n- `ProfileCollection.findUniqueGlobalPersonByEmail(email)` — supported\n  verified-identity lookup; fails closed on tenant-scoped, non-Person, or\n  duplicate case-insensitive matches.\n- `ProfileCollection.requireCanonicalGlobalPerson(profileId, email?)` —\n  validates an application-selected Profile against the same canonical global\n  Person invariant.\n- `ProfileCollection.reserveCanonicalIdentityEmail(profileId, email?)` —\n  validates and synchronizes the private unique\n  `oidc_profile_email_reservations.email_key` used as the database arbiter for\n  concurrent external-identity provisioning. Omitting `email` uses the\n  Profile's stored address, moving or removing an existing reservation as the\n  canonical Profile changes.\n- `createProfileFromNostr(email, nostrData)` — creates `Profile` + `NostrIdentity` for Nostr-authenticated users.\n\n## Agent (bot) profiles (#2995)\n\nAn automated agent is an author, and every authoring seam in the framework\n(`ChatMessage.senderProfileId`, `ChatParticipant.profileId`, a persona's\n`actsAsProfileId`) is a `crossPackageRef` to `Profile` — a native uuid column on\nPostgreSQL/DuckDB. A slug-style agent id is therefore not a representable author\n(`22P02`). `src/agent-profile.ts` is the owning-package API that turns one into\na real Profile so no consumer mints bot profiles itself and no uuid column is\nweakened to text:\n\n- `resolveAgentProfile(profiles, { agentId, tenantId, name? })` /\n  `resolveAgentProfileId(...)` — resolve, creating on first use, the `bot`\n  Profile an agent authors as. Idempotent and tenant-bound: identity is keyed on\n  `(tenantId, slug = agentId, context = AGENT_PROFILE_CONTEXT)`, matching the\n  model's `(tenant_id, slug, context, _meta_type)` unique key, so an agent id\n  resolves to a distinct profile per tenant and never collides with a\n  person/organization sharing the slug. Classification is the `bot` ProfileType\n  (`AGENT_PROFILE_TYPE_SLUG`), created on demand. Parallel first use converges\n  on the natural key rather than on whoever's INSERT won (each attempt re-reads\n  before and after writing), which matters because NULLs are distinct in the\n  `(tenant_id, slug, context)` unique index, so an untenanted agent is not\n  arbitrated by the database (smrt#2360). Pinned against real PostgreSQL by\n  `src/__tests__/agent-profile-postgres.test.ts`\n  (`pnpm --filter @happyvertical/smrt-profiles test:postgres`).\n\nFirst consumer: `@happyvertical/smrt-chat`'s `ChatService`.\n\n## Key Methods\n\n- `Profile.getAssets()` / `addAsset()` / `removeAsset()` and the matching `ProfileCollection` wrappers — canonical owned asset helpers backed by `profile_assets`.\n- `Profile.addMetadata(metafieldSlug, value)` / `Profile.getMetadata()` — validates against metafield schema. `ProfileCollection.batchGetMetadata()` / `batchUpdateMetadata()` for bulk reads/writes.\n- `Profile.getRelationships({ direction: 'from'|'to'|'all' })` — direction matters.\n- `Profile.getRelationshipsFrom()` / `getRelationshipsTo()` — R10-generated `@oneToMany` accessors. ProfileRelationship has two FKs back to Profile, so each `@oneToMany` annotates its inverse explicitly (`{ foreignKey: 'fromProfileId' }` / `'toProfileId'`). Return raw `ProfileRelationship[]`; use `getRelationships()` for slug/direction filtering.\n- AI: `generateBio()` (uses `smrtProfiles.profile.generateBio` prompt via `@happyvertical/smrt-prompts`), `matches(criteria)` (delegates to `is()`).\n\n## Prompt Registry\n\n`generateBio()` is registered with `@happyvertical/smrt-prompts` so tenants can override template/model/params at runtime:\n\n```typescript\nimport { smrtProfilesGenerateBioPrompt } from '@happyvertical/smrt-profiles';\n// key: 'smrtProfiles.profile.generateBio'\n```\n\n## Gotchas\n\n- **SERVER_MASTER_SECRET required** for Nostr private key decryption — centralized key management\n- **API key never returned again**: `ApiKey.generate()` returns plaintext once; only `keyPrefix` visible later\n- **OIDC unique per issuer+subject**: same subject from different issuers =\n  different identities. Both claims are opaque and case-sensitive; preserve\n  exact whitespace after using trim only to reject blank values.\n- **OIDC identity mutations are trusted-only**: generated REST, MCP, and CLI\n  surfaces are read-only. Link or update identities through transactional\n  provisioning APIs so callers cannot rebind issuer/subject authority to an\n  arbitrary Profile. Deprecated `OidcIdentity.findOrCreate()` preserves only\n  transaction-safe exact-link reuse and refuses to create new links;\n  `OidcIdentityCollection.linkToProfile()` and `Profile.linkOidcIdentity()`\n  delegate to that same non-creating compatibility path.\n- **Apply schema migrations for identity race keys**: run `smrt db:status`,\n  `smrt db:migrate`, then `smrt db:status` before deploying. Transactional OIDC\n  provisioning populates `OidcIdentity.identityKey` and\n  `oidc_profile_email_reservations`; legacy rows reserve an address only after\n  safe validation. Stop/upgrade old Profile writers, then run the public,\n  transactional and idempotent `backfillProfileEmailKeys(db)` from one deploy\n  process. Verified-email provisioning and public email-key lookup require the\n  standard `_smrt_backfills` readiness marker and fail closed immediately when\n  it is absent. This keeps table scans in the explicit deploy step; runtime\n  reads use the indexed key and validate only returned candidates.\n- **Public OIDC provisioning requires transactions**:\n  `createProfileFromOidc()` owns a root transaction or uses a savepoint on an\n  already-bound handle. Root adapters must expose `beginTransaction`;\n  transaction-only handles are ambiguous and fail closed. Pass the root\n  database for adapters without nested savepoints, including DuckDB;\n  provisioning fails before durable writes if neither path is safe. Trusted\n  framework packages use the private\n  `@happyvertical/smrt-profiles/internal/oidc-provisioning` subpath instead of\n  duplicating adapter probing, locking, or retry policy, and supply both exact\n  issuer/subject and normalized-email lock keys in deterministic order. The\n  coordinator additionally serializes every root-handle statement it owns per\n  database URL on SQLite/DuckDB — shared `_smrt_backfills` initialization, the\n  provisioning transaction, and the post-commit rebind — because those adapters\n  multiplex one native connection and cannot overlap unrelated root\n  transactions safely. **Never overlap two statements on one such handle,\n  transaction-bound or not** — no `Promise.all` over reads, not even\n  primary-key rebinds — because DuckDB fails the losing prepared statement or\n  aborts the process outright. It retries\n  bounded PostgreSQL deadlock/serialization failures. New OIDC Profiles use per-profile,\n  non-semantic slugs so duplicate display names never invoke natural-key upsert.\n  Caller-owned transactions never execute `_smrt_backfills` DDL; paths that\n  perform canonical email lookup or reservation require the table to already\n  exist or the caller must retry with the root database. Exact issuer/subject\n  reuse skips the email-key readiness-marker lookup, but root coordination still\n  initializes the shared tracker table. Caller-owned exact reuse does not\n  consult the tracker and therefore does not require that table.\n- **Profile-only OIDC linking fails closed on existing email matches**:\n  the typed canonical scenario contract is\n  `src/testing/oidcProvisioningDecisionMatrix.ts`, executed by both Profiles\n  and Users tests; keep public docs pointed at it instead of adding a second\n  behavioral table.\n  `createProfileFromOidc()` preserves exact issuer/subject reuse, including\n  legacy tenant-scoped and non-Person links, but profiles cannot prove whether a\n  User owns a same-email Profile. New identities therefore never attach to an\n  existing email match through this helper; User/session provisioning still\n  rejects unsafe linked Profiles before creating authentication state. Use\n  `UserCollection.getOrCreateFromOidc()` for owner-aware verified-email reuse and\n  its supported transaction-bound hooks. A pre-provisioned owned Person remains\n  fail-closed unless the application explicitly uses `authorizeProfileOwner`\n  to select both the canonical Profile and its existing approved sole owner;\n  the users package revalidates those IDs, emails, and identity authority in\n  the provisioning transaction.\n- **Email storage and identity matching differ**: `Profile.email` has an\n  exact-value DB constraint. Identity boundaries query readonly indexed\n  `Profile.emailKey`, derived by the shared TypeScript\n  `normalizeIdentityEmail()` helper rather than adapter-specific SQL casing or\n  trimming, and deliberately fail closed on duplicate normalized keys.\n- **Manifest objects must remain root-importable**: the non-API\n  `OidcProfileEmailReservation` model and collection are public root exports\n  because generated consumer registration imports every advertised manifest\n  symbol from `@happyvertical/smrt-profiles`. Release-pack validation imports\n  the actual generated register file from the packed tarball.\n- **Optional tenancy** on Profile; AuditLog allows super-admin bypass\n"
 }