@genesislcap/ai-assistant 15.51.0 → 15.51.1

package/dist/custom-elements.json

@@ -1754,211 +1754,6 @@
         }
       ]
     },
-    {
-      "kind": "javascript-module",
-      "path": "src/config/config.ts",
-      "declarations": [
-        {
-          "kind": "function",
-          "name": "defineAgent",
-          "description": "Identity helper that infers the narrowest possible type for an agent config,\npreserving string literal types (including `name`) without requiring `as const`.\n\nUse this when you need `typeof myAgent` to carry the literal `name` type —\nfor example, when wiring `ChatToolHandlers<typeof myAgent>`.\n\n```ts\nconst myAgent = defineAgent({ name: 'my_agent', ... });\ntype Handlers = ChatToolHandlers<typeof myAgent>;\n// requestSubAgent name param is now typed as 'my_agent'\n```"
-        }
-      ],
-      "exports": [
-        {
-          "kind": "js",
-          "name": "CachePolicy",
-          "declaration": {
-            "name": "CachePolicy",
-            "module": "src/config/config.ts"
-          }
-        },
-        {
-          "kind": "js",
-          "name": "ChatFallback",
-          "declaration": {
-            "name": "ChatFallback",
-            "module": "src/config/config.ts"
-          }
-        },
-        {
-          "kind": "js",
-          "name": "ChatInputDuringExecutionMode",
-          "declaration": {
-            "name": "ChatInputDuringExecutionMode",
-            "module": "src/config/config.ts"
-          }
-        },
-        {
-          "kind": "js",
-          "name": "ChatThinkingPolicy",
-          "declaration": {
-            "name": "ChatThinkingPolicy",
-            "module": "src/config/config.ts"
-          }
-        },
-        {
-          "kind": "js",
-          "name": "ChatToolChoice",
-          "declaration": {
-            "name": "ChatToolChoice",
-            "module": "src/config/config.ts"
-          }
-        },
-        {
-          "kind": "js",
-          "name": "defineAgent",
-          "declaration": {
-            "name": "defineAgent",
-            "module": "src/config/config.ts"
-          }
-        }
-      ]
-    },
-    {
-      "kind": "javascript-module",
-      "path": "src/config/define-stateful-agent.ts",
-      "declarations": [
-        {
-          "kind": "function",
-          "name": "restoreMachine",
-          "return": {
-            "type": {
-              "text": "void"
-            }
-          },
-          "parameters": [
-            {
-              "name": "machine",
-              "type": {
-                "text": "{ stop: () => void; start: (options?: { state?: unknown }) => void }"
-              },
-              "description": "the machine to restore (already constructed/started)."
-            },
-            {
-              "name": "restored",
-              "type": {
-                "text": "unknown"
-              },
-              "description": "the agent's serialized image (`ctx.restored` in `init`)."
-            },
-            {
-              "name": "key",
-              "default": "'machine'",
-              "description": "the property the machine occupies in the snapshot; defaults to\n`'machine'` to match the conventional `{ machine }` state bag."
-            }
-          ],
-          "description": "Restore a foundation-state-machine instance from a snapshot produced by the\ndefault serializer (or `machine.getPersistedSnapshot()`). Call inside a\nstateful agent's `init` to resume the machine in its exact prior place:\n\n```ts\ninit: ({ restored }) => {\n  const machine = new MyMachine();\n  restoreMachine(machine, restored); // resume, or no-op on a fresh start\n  return { machine };\n}\n```\n\nNo-ops when there is nothing to restore (a fresh session), leaving the\nfreshly-constructed machine in its initial state."
-        },
-        {
-          "kind": "function",
-          "name": "defineStatefulAgent",
-          "return": {
-            "type": {
-              "text": "AgentConfig"
-            }
-          },
-          "parameters": [
-            {
-              "name": "opts",
-              "type": {
-                "text": "StatefulAgentInit<S>"
-              }
-            }
-          ],
-          "description": "Build an `AgentConfig` whose `systemPrompt`, `toolDefinitions`, and tool\nhandlers all close over a long-lived state object created on activation.\n\nThe framework wires the lifecycle: `init` on `onActivate`, `dispose` on\n`onDeactivate`. State is held inside the helper's closure — never exposed on\nthe resulting `AgentConfig` — so the redux serializer doesn't see it."
-        }
-      ],
-      "exports": [
-        {
-          "kind": "js",
-          "name": "restoreMachine",
-          "declaration": {
-            "name": "restoreMachine",
-            "module": "src/config/define-stateful-agent.ts"
-          }
-        },
-        {
-          "kind": "js",
-          "name": "defineStatefulAgent",
-          "declaration": {
-            "name": "defineStatefulAgent",
-            "module": "src/config/define-stateful-agent.ts"
-          }
-        }
-      ]
-    },
-    {
-      "kind": "javascript-module",
-      "path": "src/config/fallback-agents.ts",
-      "declarations": [
-        {
-          "kind": "variable",
-          "name": "friendlyFallbackAgent",
-          "type": {
-            "text": "FallbackAgentConfig"
-          },
-          "default": "{\n  name: 'Assistant',\n  fallback: true,\n  systemPrompt: `You are a warm, friendly assistant. For general conversation like \"Hi\" or \"How are you\", you can have a friendly chat. For anything more complex, you cannot directly help, but you can explain what specialists are available. The available specialists are:\\n\\n{{agents}}\\n\\nPolitely let the user know what you can help with and invite them to rephrase their request if it is outside your scope.`,\n}",
-          "description": "A warm, conversational fallback agent. Acknowledges it can't help directly,\nexplains what the available specialists can do, and invites the user to retry.\n\nThe system prompt is generated at runtime by `OrchestratingDriver` from the\nspecialist list — no manual authoring required."
-        },
-        {
-          "kind": "variable",
-          "name": "strictFallbackAgent",
-          "type": {
-            "text": "FallbackAgentConfig"
-          },
-          "default": "{\n  name: 'Assistant',\n  fallback: true,\n  systemPrompt: `You are a concise assistant. The user's request is outside your scope. The available specialists are: {{agents}}.\n\n{{unroutable}}\n\nAnswer in a single short sentence. Do not elaborate.`,\n}",
-          "description": "A brief, professional fallback agent. States what is available without\nelaboration. The `{{agents}}` placeholder is replaced at runtime by\n`OrchestratingDriver` with the generated specialist list.\n\nThe `{{unroutable}}` placeholder positions `UNROUTABLE_INSTRUCTION` — the framework's\ninstruction for a substantive request no specialist covers, which is otherwise APPENDED to a\nstring-form prompt. Positioned rather than appended for one reason: this preset's whole point is\nbrevity, and appended text would be the last thing the model reads. Putting the block above the\nbrevity rule leaves \"a single short sentence\" with the recency, so the two compose instead of\ncompeting. A prompt whose tone rules matter should do the same."
-        }
-      ],
-      "exports": [
-        {
-          "kind": "js",
-          "name": "friendlyFallbackAgent",
-          "declaration": {
-            "name": "friendlyFallbackAgent",
-            "module": "src/config/fallback-agents.ts"
-          }
-        },
-        {
-          "kind": "js",
-          "name": "strictFallbackAgent",
-          "declaration": {
-            "name": "strictFallbackAgent",
-            "module": "src/config/fallback-agents.ts"
-          }
-        }
-      ]
-    },
-    {
-      "kind": "javascript-module",
-      "path": "src/config/index.ts",
-      "declarations": [],
-      "exports": [
-        {
-          "kind": "js",
-          "name": "*",
-          "declaration": {
-            "name": "*",
-            "package": "./config"
-          }
-        },
-        {
-          "kind": "js",
-          "name": "*",
-          "declaration": {
-            "name": "*",
-            "package": "./fallback-agents"
-          }
-        }
-      ]
-    },
-    {
-      "kind": "javascript-module",
-      "path": "src/config/validate-providers.ts",
-      "declarations": [],
-      "exports": []
-    },
     {
       "kind": "javascript-module",
       "path": "src/genesis/calendar.ts",
@@ -3144,52 +2939,257 @@
     },
     {
       "kind": "javascript-module",
-      "path": "src/main/attachment-controller.ts",
-      "declarations": [],
-      "exports": []
-    },
-    {
-      "kind": "javascript-module",
-      "path": "src/main/budget-controller.ts",
-      "declarations": [],
-      "exports": []
-    },
-    {
-      "kind": "javascript-module",
-      "path": "src/main/composer-menu-controller.ts",
-      "declarations": [],
-      "exports": []
-    },
-    {
-      "kind": "javascript-module",
-      "path": "src/main/composer-resize-controller.ts",
-      "declarations": [],
-      "exports": []
-    },
-    {
-      "kind": "javascript-module",
-      "path": "src/main/context-gate-controller.ts",
-      "declarations": [],
-      "exports": []
-    },
-    {
-      "kind": "javascript-module",
-      "path": "src/main/cost-ledger-controller.ts",
-      "declarations": [],
-      "exports": []
-    },
-    {
-      "kind": "javascript-module",
-      "path": "src/main/index.ts",
-      "declarations": [],
+      "path": "src/config/config.ts",
+      "declarations": [
+        {
+          "kind": "function",
+          "name": "defineAgent",
+          "description": "Identity helper that infers the narrowest possible type for an agent config,\npreserving string literal types (including `name`) without requiring `as const`.\n\nUse this when you need `typeof myAgent` to carry the literal `name` type —\nfor example, when wiring `ChatToolHandlers<typeof myAgent>`.\n\n```ts\nconst myAgent = defineAgent({ name: 'my_agent', ... });\ntype Handlers = ChatToolHandlers<typeof myAgent>;\n// requestSubAgent name param is now typed as 'my_agent'\n```"
+        }
+      ],
       "exports": [
         {
           "kind": "js",
-          "name": "*",
+          "name": "CachePolicy",
           "declaration": {
-            "name": "*",
-            "package": "./main.template"
-          }
+            "name": "CachePolicy",
+            "module": "src/config/config.ts"
+          }
+        },
+        {
+          "kind": "js",
+          "name": "ChatFallback",
+          "declaration": {
+            "name": "ChatFallback",
+            "module": "src/config/config.ts"
+          }
+        },
+        {
+          "kind": "js",
+          "name": "ChatInputDuringExecutionMode",
+          "declaration": {
+            "name": "ChatInputDuringExecutionMode",
+            "module": "src/config/config.ts"
+          }
+        },
+        {
+          "kind": "js",
+          "name": "ChatThinkingPolicy",
+          "declaration": {
+            "name": "ChatThinkingPolicy",
+            "module": "src/config/config.ts"
+          }
+        },
+        {
+          "kind": "js",
+          "name": "ChatToolChoice",
+          "declaration": {
+            "name": "ChatToolChoice",
+            "module": "src/config/config.ts"
+          }
+        },
+        {
+          "kind": "js",
+          "name": "defineAgent",
+          "declaration": {
+            "name": "defineAgent",
+            "module": "src/config/config.ts"
+          }
+        }
+      ]
+    },
+    {
+      "kind": "javascript-module",
+      "path": "src/config/define-stateful-agent.ts",
+      "declarations": [
+        {
+          "kind": "function",
+          "name": "restoreMachine",
+          "return": {
+            "type": {
+              "text": "void"
+            }
+          },
+          "parameters": [
+            {
+              "name": "machine",
+              "type": {
+                "text": "{ stop: () => void; start: (options?: { state?: unknown }) => void }"
+              },
+              "description": "the machine to restore (already constructed/started)."
+            },
+            {
+              "name": "restored",
+              "type": {
+                "text": "unknown"
+              },
+              "description": "the agent's serialized image (`ctx.restored` in `init`)."
+            },
+            {
+              "name": "key",
+              "default": "'machine'",
+              "description": "the property the machine occupies in the snapshot; defaults to\n`'machine'` to match the conventional `{ machine }` state bag."
+            }
+          ],
+          "description": "Restore a foundation-state-machine instance from a snapshot produced by the\ndefault serializer (or `machine.getPersistedSnapshot()`). Call inside a\nstateful agent's `init` to resume the machine in its exact prior place:\n\n```ts\ninit: ({ restored }) => {\n  const machine = new MyMachine();\n  restoreMachine(machine, restored); // resume, or no-op on a fresh start\n  return { machine };\n}\n```\n\nNo-ops when there is nothing to restore (a fresh session), leaving the\nfreshly-constructed machine in its initial state."
+        },
+        {
+          "kind": "function",
+          "name": "defineStatefulAgent",
+          "return": {
+            "type": {
+              "text": "AgentConfig"
+            }
+          },
+          "parameters": [
+            {
+              "name": "opts",
+              "type": {
+                "text": "StatefulAgentInit<S>"
+              }
+            }
+          ],
+          "description": "Build an `AgentConfig` whose `systemPrompt`, `toolDefinitions`, and tool\nhandlers all close over a long-lived state object created on activation.\n\nThe framework wires the lifecycle: `init` on `onActivate`, `dispose` on\n`onDeactivate`. State is held inside the helper's closure — never exposed on\nthe resulting `AgentConfig` — so the redux serializer doesn't see it."
+        }
+      ],
+      "exports": [
+        {
+          "kind": "js",
+          "name": "restoreMachine",
+          "declaration": {
+            "name": "restoreMachine",
+            "module": "src/config/define-stateful-agent.ts"
+          }
+        },
+        {
+          "kind": "js",
+          "name": "defineStatefulAgent",
+          "declaration": {
+            "name": "defineStatefulAgent",
+            "module": "src/config/define-stateful-agent.ts"
+          }
+        }
+      ]
+    },
+    {
+      "kind": "javascript-module",
+      "path": "src/config/fallback-agents.ts",
+      "declarations": [
+        {
+          "kind": "variable",
+          "name": "friendlyFallbackAgent",
+          "type": {
+            "text": "FallbackAgentConfig"
+          },
+          "default": "{\n  name: 'Assistant',\n  fallback: true,\n  systemPrompt: `You are a warm, friendly assistant. For general conversation like \"Hi\" or \"How are you\", you can have a friendly chat. For anything more complex, you cannot directly help, but you can explain what specialists are available. The available specialists are:\\n\\n{{agents}}\\n\\nPolitely let the user know what you can help with and invite them to rephrase their request if it is outside your scope.`,\n}",
+          "description": "A warm, conversational fallback agent. Acknowledges it can't help directly,\nexplains what the available specialists can do, and invites the user to retry.\n\nThe system prompt is generated at runtime by `OrchestratingDriver` from the\nspecialist list — no manual authoring required."
+        },
+        {
+          "kind": "variable",
+          "name": "strictFallbackAgent",
+          "type": {
+            "text": "FallbackAgentConfig"
+          },
+          "default": "{\n  name: 'Assistant',\n  fallback: true,\n  systemPrompt: `You are a concise assistant. The user's request is outside your scope. The available specialists are: {{agents}}.\n\n{{unroutable}}\n\nAnswer in a single short sentence. Do not elaborate.`,\n}",
+          "description": "A brief, professional fallback agent. States what is available without\nelaboration. The `{{agents}}` placeholder is replaced at runtime by\n`OrchestratingDriver` with the generated specialist list.\n\nThe `{{unroutable}}` placeholder positions `UNROUTABLE_INSTRUCTION` — the framework's\ninstruction for a substantive request no specialist covers, which is otherwise APPENDED to a\nstring-form prompt. Positioned rather than appended for one reason: this preset's whole point is\nbrevity, and appended text would be the last thing the model reads. Putting the block above the\nbrevity rule leaves \"a single short sentence\" with the recency, so the two compose instead of\ncompeting. A prompt whose tone rules matter should do the same."
+        }
+      ],
+      "exports": [
+        {
+          "kind": "js",
+          "name": "friendlyFallbackAgent",
+          "declaration": {
+            "name": "friendlyFallbackAgent",
+            "module": "src/config/fallback-agents.ts"
+          }
+        },
+        {
+          "kind": "js",
+          "name": "strictFallbackAgent",
+          "declaration": {
+            "name": "strictFallbackAgent",
+            "module": "src/config/fallback-agents.ts"
+          }
+        }
+      ]
+    },
+    {
+      "kind": "javascript-module",
+      "path": "src/config/index.ts",
+      "declarations": [],
+      "exports": [
+        {
+          "kind": "js",
+          "name": "*",
+          "declaration": {
+            "name": "*",
+            "package": "./config"
+          }
+        },
+        {
+          "kind": "js",
+          "name": "*",
+          "declaration": {
+            "name": "*",
+            "package": "./fallback-agents"
+          }
+        }
+      ]
+    },
+    {
+      "kind": "javascript-module",
+      "path": "src/config/validate-providers.ts",
+      "declarations": [],
+      "exports": []
+    },
+    {
+      "kind": "javascript-module",
+      "path": "src/main/attachment-controller.ts",
+      "declarations": [],
+      "exports": []
+    },
+    {
+      "kind": "javascript-module",
+      "path": "src/main/budget-controller.ts",
+      "declarations": [],
+      "exports": []
+    },
+    {
+      "kind": "javascript-module",
+      "path": "src/main/composer-menu-controller.ts",
+      "declarations": [],
+      "exports": []
+    },
+    {
+      "kind": "javascript-module",
+      "path": "src/main/composer-resize-controller.ts",
+      "declarations": [],
+      "exports": []
+    },
+    {
+      "kind": "javascript-module",
+      "path": "src/main/context-gate-controller.ts",
+      "declarations": [],
+      "exports": []
+    },
+    {
+      "kind": "javascript-module",
+      "path": "src/main/cost-ledger-controller.ts",
+      "declarations": [],
+      "exports": []
+    },
+    {
+      "kind": "javascript-module",
+      "path": "src/main/index.ts",
+      "declarations": [],
+      "exports": [
+        {
+          "kind": "js",
+          "name": "*",
+          "declaration": {
+            "name": "*",
+            "package": "./main.template"
+          }
         },
         {
           "kind": "js",
@@ -6975,168 +6975,21 @@
     },
     {
       "kind": "javascript-module",
-      "path": "src/styles/ai-colours.ts",
+      "path": "src/state/ai-assistant-slice.ts",
       "declarations": [
         {
-          "kind": "variable",
-          "name": "AI_COLOUR_AMBER",
-          "type": {
-            "text": "string"
+          "kind": "function",
+          "name": "createDefaultSessionState",
+          "return": {
+            "type": {
+              "text": "AiAssistantSessionState"
+            }
           },
-          "default": "'#feb60a'",
-          "description": "Shared brand colours used across the AI animation effects\n(halo overlay border/glow and loading dot indicators).\nDefined once here so both stay in sync."
+          "description": "Build a fresh default session state. A factory (not just a shared const) so\neach call returns independent collections — `resetSession` can hand back a\nclean slate without aliasing the initial state's arrays."
         },
         {
           "kind": "variable",
-          "name": "AI_COLOUR_PINK",
-          "type": {
-            "text": "string"
-          },
-          "default": "'#ff0062'"
-        },
-        {
-          "kind": "variable",
-          "name": "AI_COLOUR_CYAN",
-          "type": {
-            "text": "string"
-          },
-          "default": "'#00dbf9'"
-        },
-        {
-          "kind": "variable",
-          "name": "AI_COLOUR_VIOLET",
-          "type": {
-            "text": "string"
-          },
-          "default": "'#da00f7'"
-        },
-        {
-          "kind": "variable",
-          "name": "PIN_COLOURS",
-          "type": {
-            "text": "[\n  AI_COLOUR_AMBER,\n  AI_COLOUR_PINK,\n  AI_COLOUR_CYAN,\n  AI_COLOUR_VIOLET,\n]"
-          },
-          "default": "[\n  AI_COLOUR_AMBER,\n  AI_COLOUR_PINK,\n  AI_COLOUR_CYAN,\n  AI_COLOUR_VIOLET,\n]",
-          "description": "Pin tint palette, cycled by an agent's position in the assistant's `agents`\narray. Lives here beside the other brand colours because two components need\nit: the composer's agent button tints its pin with the ACTIVE agent's colour,\nand the picker menu tints every row's dot — and those two have to agree, so\nthey read the same list and index it the same way."
-        },
-        {
-          "kind": "function",
-          "name": "pinColourAt",
-          "return": {
-            "type": {
-              "text": "string | undefined"
-            }
-          },
-          "parameters": [
-            {
-              "name": "index",
-              "type": {
-                "text": "number"
-              }
-            }
-          ],
-          "description": "The tint for the agent at `index` in the full agents array, or `undefined`\nwhen the index is out of range (an unknown or stale agent name)."
-        }
-      ],
-      "exports": [
-        {
-          "kind": "js",
-          "name": "AI_COLOUR_AMBER",
-          "declaration": {
-            "name": "AI_COLOUR_AMBER",
-            "module": "src/styles/ai-colours.ts"
-          }
-        },
-        {
-          "kind": "js",
-          "name": "AI_COLOUR_PINK",
-          "declaration": {
-            "name": "AI_COLOUR_PINK",
-            "module": "src/styles/ai-colours.ts"
-          }
-        },
-        {
-          "kind": "js",
-          "name": "AI_COLOUR_CYAN",
-          "declaration": {
-            "name": "AI_COLOUR_CYAN",
-            "module": "src/styles/ai-colours.ts"
-          }
-        },
-        {
-          "kind": "js",
-          "name": "AI_COLOUR_VIOLET",
-          "declaration": {
-            "name": "AI_COLOUR_VIOLET",
-            "module": "src/styles/ai-colours.ts"
-          }
-        },
-        {
-          "kind": "js",
-          "name": "PIN_COLOURS",
-          "declaration": {
-            "name": "PIN_COLOURS",
-            "module": "src/styles/ai-colours.ts"
-          }
-        },
-        {
-          "kind": "js",
-          "name": "pinColourAt",
-          "declaration": {
-            "name": "pinColourAt",
-            "module": "src/styles/ai-colours.ts"
-          }
-        }
-      ]
-    },
-    {
-      "kind": "javascript-module",
-      "path": "src/styles/menu.ts",
-      "declarations": [],
-      "exports": []
-    },
-    {
-      "kind": "javascript-module",
-      "path": "src/styles/settings-section.ts",
-      "declarations": [
-        {
-          "kind": "variable",
-          "name": "assistantSettingsSectionTitleStyles",
-          "type": {
-            "text": "ElementStyles"
-          },
-          "default": "css`\n  .ai-settings-section-title {\n    display: flex;\n    align-items: center;\n    gap: calc(var(--design-unit) * 2px);\n    font-size: 11px;\n    font-weight: 600;\n    letter-spacing: 0.08em;\n    text-transform: uppercase;\n    color: var(--neutral-foreground-hint);\n  }\n`",
-          "description": "Heading style for a settings-modal section, published so a host can title its own section.\n\nThe assistant renders no heading for the `settings-app` slot — no text and no icon — because\nonly the host knows what that section is. The consequence is that a host supplying one has to\nreproduce the styling of the built-in headings beside it, and a copied rule drifts the moment\neither side changes. So the declarations live here, are applied by the assistant's own\nheadings, and are exported for the host to apply to its.\n\nCompose it into a component's styles and put `ai-settings-section-title` on the heading:\n\n```ts\nimport { assistantSettingsSectionTitleStyles } from '@genesislcap/ai-assistant';\n\nconst styles = css`\n  ${assistantSettingsSectionTitleStyles}\n  :host { display: block; }\n`;\n```\n\nCarries no margin on purpose: spacing belongs to the surrounding layout, which differs\nbetween the assistant's own sections and a slotted one, and is the single declaration hosts\nhad to diverge on when they copied this rule."
-        }
-      ],
-      "exports": [
-        {
-          "kind": "js",
-          "name": "assistantSettingsSectionTitleStyles",
-          "declaration": {
-            "name": "assistantSettingsSectionTitleStyles",
-            "module": "src/styles/settings-section.ts"
-          }
-        }
-      ]
-    },
-    {
-      "kind": "javascript-module",
-      "path": "src/state/ai-assistant-slice.ts",
-      "declarations": [
-        {
-          "kind": "function",
-          "name": "createDefaultSessionState",
-          "return": {
-            "type": {
-              "text": "AiAssistantSessionState"
-            }
-          },
-          "description": "Build a fresh default session state. A factory (not just a shared const) so\neach call returns independent collections — `resetSession` can hand back a\nclean slate without aliasing the initial state's arrays."
-        },
-        {
-          "kind": "variable",
-          "name": "defaultSessionState",
+          "name": "defaultSessionState",
           "type": {
             "text": "AiAssistantSessionState"
           }
@@ -7663,6 +7516,153 @@
         }
       ]
     },
+    {
+      "kind": "javascript-module",
+      "path": "src/styles/ai-colours.ts",
+      "declarations": [
+        {
+          "kind": "variable",
+          "name": "AI_COLOUR_AMBER",
+          "type": {
+            "text": "string"
+          },
+          "default": "'#feb60a'",
+          "description": "Shared brand colours used across the AI animation effects\n(halo overlay border/glow and loading dot indicators).\nDefined once here so both stay in sync."
+        },
+        {
+          "kind": "variable",
+          "name": "AI_COLOUR_PINK",
+          "type": {
+            "text": "string"
+          },
+          "default": "'#ff0062'"
+        },
+        {
+          "kind": "variable",
+          "name": "AI_COLOUR_CYAN",
+          "type": {
+            "text": "string"
+          },
+          "default": "'#00dbf9'"
+        },
+        {
+          "kind": "variable",
+          "name": "AI_COLOUR_VIOLET",
+          "type": {
+            "text": "string"
+          },
+          "default": "'#da00f7'"
+        },
+        {
+          "kind": "variable",
+          "name": "PIN_COLOURS",
+          "type": {
+            "text": "[\n  AI_COLOUR_AMBER,\n  AI_COLOUR_PINK,\n  AI_COLOUR_CYAN,\n  AI_COLOUR_VIOLET,\n]"
+          },
+          "default": "[\n  AI_COLOUR_AMBER,\n  AI_COLOUR_PINK,\n  AI_COLOUR_CYAN,\n  AI_COLOUR_VIOLET,\n]",
+          "description": "Pin tint palette, cycled by an agent's position in the assistant's `agents`\narray. Lives here beside the other brand colours because two components need\nit: the composer's agent button tints its pin with the ACTIVE agent's colour,\nand the picker menu tints every row's dot — and those two have to agree, so\nthey read the same list and index it the same way."
+        },
+        {
+          "kind": "function",
+          "name": "pinColourAt",
+          "return": {
+            "type": {
+              "text": "string | undefined"
+            }
+          },
+          "parameters": [
+            {
+              "name": "index",
+              "type": {
+                "text": "number"
+              }
+            }
+          ],
+          "description": "The tint for the agent at `index` in the full agents array, or `undefined`\nwhen the index is out of range (an unknown or stale agent name)."
+        }
+      ],
+      "exports": [
+        {
+          "kind": "js",
+          "name": "AI_COLOUR_AMBER",
+          "declaration": {
+            "name": "AI_COLOUR_AMBER",
+            "module": "src/styles/ai-colours.ts"
+          }
+        },
+        {
+          "kind": "js",
+          "name": "AI_COLOUR_PINK",
+          "declaration": {
+            "name": "AI_COLOUR_PINK",
+            "module": "src/styles/ai-colours.ts"
+          }
+        },
+        {
+          "kind": "js",
+          "name": "AI_COLOUR_CYAN",
+          "declaration": {
+            "name": "AI_COLOUR_CYAN",
+            "module": "src/styles/ai-colours.ts"
+          }
+        },
+        {
+          "kind": "js",
+          "name": "AI_COLOUR_VIOLET",
+          "declaration": {
+            "name": "AI_COLOUR_VIOLET",
+            "module": "src/styles/ai-colours.ts"
+          }
+        },
+        {
+          "kind": "js",
+          "name": "PIN_COLOURS",
+          "declaration": {
+            "name": "PIN_COLOURS",
+            "module": "src/styles/ai-colours.ts"
+          }
+        },
+        {
+          "kind": "js",
+          "name": "pinColourAt",
+          "declaration": {
+            "name": "pinColourAt",
+            "module": "src/styles/ai-colours.ts"
+          }
+        }
+      ]
+    },
+    {
+      "kind": "javascript-module",
+      "path": "src/styles/menu.ts",
+      "declarations": [],
+      "exports": []
+    },
+    {
+      "kind": "javascript-module",
+      "path": "src/styles/settings-section.ts",
+      "declarations": [
+        {
+          "kind": "variable",
+          "name": "assistantSettingsSectionTitleStyles",
+          "type": {
+            "text": "ElementStyles"
+          },
+          "default": "css`\n  .ai-settings-section-title {\n    display: flex;\n    align-items: center;\n    gap: calc(var(--design-unit) * 2px);\n    font-size: 11px;\n    font-weight: 600;\n    letter-spacing: 0.08em;\n    text-transform: uppercase;\n    color: var(--neutral-foreground-hint);\n  }\n`",
+          "description": "Heading style for a settings-modal section, published so a host can title its own section.\n\nThe assistant renders no heading for the `settings-app` slot — no text and no icon — because\nonly the host knows what that section is. The consequence is that a host supplying one has to\nreproduce the styling of the built-in headings beside it, and a copied rule drifts the moment\neither side changes. So the declarations live here, are applied by the assistant's own\nheadings, and are exported for the host to apply to its.\n\nCompose it into a component's styles and put `ai-settings-section-title` on the heading:\n\n```ts\nimport { assistantSettingsSectionTitleStyles } from '@genesislcap/ai-assistant';\n\nconst styles = css`\n  ${assistantSettingsSectionTitleStyles}\n  :host { display: block; }\n`;\n```\n\nCarries no margin on purpose: spacing belongs to the surrounding layout, which differs\nbetween the assistant's own sections and a slotted one, and is the single declaration hosts\nhad to diverge on when they copied this rule."
+        }
+      ],
+      "exports": [
+        {
+          "kind": "js",
+          "name": "assistantSettingsSectionTitleStyles",
+          "declaration": {
+            "name": "assistantSettingsSectionTitleStyles",
+            "module": "src/styles/settings-section.ts"
+          }
+        }
+      ]
+    },
     {
       "kind": "javascript-module",
       "path": "src/suggestions/chat-suggestions.ts",

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@genesislcap/ai-assistant",
   "description": "Genesis AI Assistant micro-frontend",
-  "version": "15.51.0",
+  "version": "15.51.1",
   "license": "SEE LICENSE IN license.txt",
   "main": "dist/esm/index.js",
   "types": "dist/ai-assistant.d.ts",
@@ -92,31 +92,31 @@
     }
   },
   "devDependencies": {
-    "@genesislcap/foundation-comms": "15.51.0",
-    "@genesislcap/foundation-testing": "15.51.0",
-    "@genesislcap/genx": "15.51.0",
-    "@genesislcap/ts-builder": "15.51.0",
-    "@genesislcap/uvu-playwright-builder": "15.51.0",
-    "@genesislcap/vite-builder": "15.51.0",
-    "@genesislcap/webpack-builder": "15.51.0",
+    "@genesislcap/foundation-comms": "15.51.1",
+    "@genesislcap/foundation-testing": "15.51.1",
+    "@genesislcap/genx": "15.51.1",
+    "@genesislcap/ts-builder": "15.51.1",
+    "@genesislcap/uvu-playwright-builder": "15.51.1",
+    "@genesislcap/vite-builder": "15.51.1",
+    "@genesislcap/webpack-builder": "15.51.1",
     "@types/dompurify": "^3.0.5",
     "@types/marked": "^5.0.2",
     "esbuild": "0.25.12"
   },
   "dependencies": {
-    "@genesislcap/foundation-ai": "15.51.0",
-    "@genesislcap/foundation-logger": "15.51.0",
-    "@genesislcap/foundation-notifications": "15.51.0",
-    "@genesislcap/foundation-redux": "15.51.0",
-    "@genesislcap/foundation-ui": "15.51.0",
-    "@genesislcap/foundation-utils": "15.51.0",
-    "@genesislcap/rapid-design-system": "15.51.0",
-    "@genesislcap/web-core": "15.51.0",
+    "@genesislcap/foundation-ai": "15.51.1",
+    "@genesislcap/foundation-logger": "15.51.1",
+    "@genesislcap/foundation-notifications": "15.51.1",
+    "@genesislcap/foundation-redux": "15.51.1",
+    "@genesislcap/foundation-ui": "15.51.1",
+    "@genesislcap/foundation-utils": "15.51.1",
+    "@genesislcap/rapid-design-system": "15.51.1",
+    "@genesislcap/web-core": "15.51.1",
     "dompurify": "^3.3.1",
     "marked": "^17.0.3"
   },
   "peerDependencies": {
-    "@genesislcap/foundation-comms": "^15.51.0"
+    "@genesislcap/foundation-comms": "^15.51.1"
   },
   "peerDependenciesMeta": {
     "@genesislcap/foundation-comms": {