@genesislcap/ai-assistant 15.62.0 → 15.63.0

package/dist/custom-elements.json

@@ -4076,6 +4076,237 @@
         }
       ]
     },
+    {
+      "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."
+        },
+        {
+          "kind": "function",
+          "name": "defineAutopilot",
+          "return": {
+            "type": {
+              "text": "AutopilotConfig<S>"
+            }
+          },
+          "parameters": [
+            {
+              "name": "config",
+              "type": {
+                "text": "AutopilotConfig<S>"
+              }
+            }
+          ],
+          "description": "Define an autopilot for a stateful agent whose state is `S` (GENC-1660). An identity function\nthat exists for its type: the resolvers get `S`, and the result goes on `defineStatefulAgent`'s\n`autopilot` option."
+        }
+      ],
+      "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": "js",
+          "name": "defineAutopilot",
+          "declaration": {
+            "name": "defineAutopilot",
+            "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/components/flowing-waves-indicator.ts",
@@ -4602,254 +4833,23 @@
     },
     {
       "kind": "javascript-module",
-      "path": "src/config/config.ts",
+      "path": "src/genesis/calendar.ts",
+      "declarations": [],
+      "exports": []
+    },
+    {
+      "kind": "javascript-module",
+      "path": "src/genesis/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."
-        },
-        {
-          "kind": "function",
-          "name": "defineAutopilot",
-          "return": {
-            "type": {
-              "text": "AutopilotConfig<S>"
-            }
-          },
-          "parameters": [
-            {
-              "name": "config",
-              "type": {
-                "text": "AutopilotConfig<S>"
-              }
-            }
-          ],
-          "description": "Define an autopilot for a stateful agent whose state is `S` (GENC-1660). An identity function\nthat exists for its type: the resolvers get `S`, and the result goes on `defineStatefulAgent`'s\n`autopilot` option."
-        }
-      ],
-      "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": "js",
-          "name": "defineAutopilot",
-          "declaration": {
-            "name": "defineAutopilot",
-            "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",
-      "declarations": [],
-      "exports": []
-    },
-    {
-      "kind": "javascript-module",
-      "path": "src/genesis/config.ts",
-      "declarations": [
-        {
-          "kind": "variable",
-          "name": "DEFAULT_MAX_ROWS",
-          "type": {
-            "text": "number"
-          },
-          "default": "50",
-          "description": "The default read cap, and the ceiling the config may raise it to."
-        },
+          "kind": "variable",
+          "name": "DEFAULT_MAX_ROWS",
+          "type": {
+            "text": "number"
+          },
+          "default": "50",
+          "description": "The default read cap, and the ceiling the config may raise it to."
+        },
         {
           "kind": "variable",
           "name": "MAX_ROWS_CEILING",
@@ -6014,270 +6014,6 @@
       "declarations": [],
       "exports": []
     },
-    {
-      "kind": "javascript-module",
-      "path": "src/provider/ai-provider-switcher.ts",
-      "declarations": [
-        {
-          "kind": "variable",
-          "name": "AIProviderSwitcher",
-          "description": "The DI token for the (AIProviderSwitcher:interface). Resolves a noop until the app\nregisters one."
-        }
-      ],
-      "exports": [
-        {
-          "kind": "js",
-          "name": "AIProviderSwitcher",
-          "declaration": {
-            "name": "AIProviderSwitcher",
-            "module": "src/provider/ai-provider-switcher.ts"
-          }
-        }
-      ]
-    },
-    {
-      "kind": "javascript-module",
-      "path": "src/provider/assistant-app-settings.ts",
-      "declarations": [
-        {
-          "kind": "variable",
-          "name": "AssistantAppSettingsProvider",
-          "description": "The DI token for the (AssistantAppSettingsProvider:interface). Resolves a noop\nuntil the host registers one."
-        }
-      ],
-      "exports": [
-        {
-          "kind": "js",
-          "name": "AssistantAppSettingsProvider",
-          "declaration": {
-            "name": "AssistantAppSettingsProvider",
-            "module": "src/provider/assistant-app-settings.ts"
-          }
-        }
-      ]
-    },
-    {
-      "kind": "javascript-module",
-      "path": "src/provider/tiered-provider-switcher.ts",
-      "declarations": [
-        {
-          "kind": "class",
-          "description": "Which cloud vendor backs the tier-shaped provider registry, plus the means to move it at\nruntime (GENC-1610).",
-          "name": "TieredAIProviderSwitcher",
-          "members": [
-            {
-              "kind": "field",
-              "name": "vendors",
-              "type": {
-                "text": "readonly AITierVendor[]"
-              },
-              "readonly": true
-            },
-            {
-              "kind": "field",
-              "name": "options",
-              "type": {
-                "text": "TieredAIProviderSwitcherOptions"
-              },
-              "privacy": "private",
-              "readonly": true,
-              "default": "options"
-            },
-            {
-              "kind": "field",
-              "name": "defaultTier",
-              "type": {
-                "text": "AITierId"
-              },
-              "privacy": "private",
-              "readonly": true
-            },
-            {
-              "kind": "field",
-              "name": "registry",
-              "type": {
-                "text": "MutableAIProviderRegistry"
-              },
-              "privacy": "private",
-              "readonly": true
-            },
-            {
-              "kind": "field",
-              "name": "listeners",
-              "privacy": "private",
-              "readonly": true,
-              "default": "new Set<(vendor: AITierVendor) => void>()"
-            },
-            {
-              "kind": "field",
-              "name": "_vendor",
-              "type": {
-                "text": "AITierVendor"
-              },
-              "privacy": "private"
-            },
-            {
-              "kind": "field",
-              "name": "vendor",
-              "type": {
-                "text": "AITierVendor"
-              },
-              "readonly": true
-            },
-            {
-              "kind": "method",
-              "name": "switchTo",
-              "return": {
-                "type": {
-                  "text": "void"
-                }
-              },
-              "parameters": [
-                {
-                  "name": "vendor",
-                  "type": {
-                    "text": "string"
-                  }
-                }
-              ],
-              "description": "A user-driven switch: move the registry, then tell the app so it can persist the choice.\nAn unknown vendor is ignored."
-            },
-            {
-              "kind": "method",
-              "name": "adoptPersistedVendor",
-              "return": {
-                "type": {
-                  "text": "void"
-                }
-              },
-              "parameters": [
-                {
-                  "name": "vendor",
-                  "type": {
-                    "text": "string"
-                  }
-                }
-              ],
-              "description": "Adopt a vendor the app read back from its own store — the same registry move as\nTieredAIProviderSwitcher.switchTo, without the `onSwitch` callback, because this\nvalue came FROM the store and writing it back would be a pointless round-trip on load.\n\nExists because registration has to stay synchronous: an element that connects before the\ntoken is registered caches the platform's no-op fallback, so an app cannot await its\nstored preference before constructing this. It boots on `initialVendor` and adopts the\nstored one a moment later, through a registry that is mutable and held by reference."
-            },
-            {
-              "kind": "method",
-              "name": "subscribe",
-              "return": {
-                "type": {
-                  "text": "() => void"
-                }
-              },
-              "parameters": [
-                {
-                  "name": "listener",
-                  "type": {
-                    "text": "(vendor: string) => void"
-                  }
-                }
-              ]
-            },
-            {
-              "kind": "method",
-              "name": "apply",
-              "privacy": "private",
-              "return": {
-                "type": {
-                  "text": "void"
-                }
-              },
-              "parameters": [
-                {
-                  "name": "vendor",
-                  "type": {
-                    "text": "AITierVendor"
-                  }
-                }
-              ],
-              "description": "The registry move both entry points share, and nothing else."
-            },
-            {
-              "kind": "method",
-              "name": "build",
-              "privacy": "private",
-              "return": {
-                "type": {
-                  "text": "Record<string, AIProvider>"
-                }
-              },
-              "parameters": [
-                {
-                  "name": "vendor",
-                  "type": {
-                    "text": "AITierVendor"
-                  }
-                }
-              ]
-            },
-            {
-              "kind": "method",
-              "name": "isKnownVendor",
-              "privacy": "private",
-              "return": {
-                "type": {
-                  "text": "vendor is AITierVendor"
-                }
-              },
-              "parameters": [
-                {
-                  "name": "vendor",
-                  "type": {
-                    "text": "string"
-                  }
-                }
-              ]
-            }
-          ]
-        },
-        {
-          "kind": "function",
-          "name": "registerTieredAIProviders",
-          "return": {
-            "type": {
-              "text": "TieredAIProviderSwitcher"
-            }
-          },
-          "parameters": [
-            {
-              "name": "container",
-              "type": {
-                "text": "Container"
-              }
-            },
-            {
-              "name": "options",
-              "type": {
-                "text": "Omit<TieredAIProviderSwitcherOptions, 'container'>"
-              }
-            }
-          ],
-          "description": "Build a TieredAIProviderSwitcher — which registers the tier-shaped provider\nregistry — and put it on the (AIProviderSwitcher:variable) token. Call once at app\nbootstrap."
-        }
-      ],
-      "exports": [
-        {
-          "kind": "js",
-          "name": "TieredAIProviderSwitcher",
-          "declaration": {
-            "name": "TieredAIProviderSwitcher",
-            "module": "src/provider/tiered-provider-switcher.ts"
-          }
-        },
-        {
-          "kind": "js",
-          "name": "registerTieredAIProviders",
-          "declaration": {
-            "name": "registerTieredAIProviders",
-            "module": "src/provider/tiered-provider-switcher.ts"
-          }
-        }
-      ]
-    },
     {
       "kind": "javascript-module",
       "path": "src/main/attachment-controller.ts",
@@ -10298,6 +10034,270 @@
       "declarations": [],
       "exports": []
     },
+    {
+      "kind": "javascript-module",
+      "path": "src/provider/ai-provider-switcher.ts",
+      "declarations": [
+        {
+          "kind": "variable",
+          "name": "AIProviderSwitcher",
+          "description": "The DI token for the (AIProviderSwitcher:interface). Resolves a noop until the app\nregisters one."
+        }
+      ],
+      "exports": [
+        {
+          "kind": "js",
+          "name": "AIProviderSwitcher",
+          "declaration": {
+            "name": "AIProviderSwitcher",
+            "module": "src/provider/ai-provider-switcher.ts"
+          }
+        }
+      ]
+    },
+    {
+      "kind": "javascript-module",
+      "path": "src/provider/assistant-app-settings.ts",
+      "declarations": [
+        {
+          "kind": "variable",
+          "name": "AssistantAppSettingsProvider",
+          "description": "The DI token for the (AssistantAppSettingsProvider:interface). Resolves a noop\nuntil the host registers one."
+        }
+      ],
+      "exports": [
+        {
+          "kind": "js",
+          "name": "AssistantAppSettingsProvider",
+          "declaration": {
+            "name": "AssistantAppSettingsProvider",
+            "module": "src/provider/assistant-app-settings.ts"
+          }
+        }
+      ]
+    },
+    {
+      "kind": "javascript-module",
+      "path": "src/provider/tiered-provider-switcher.ts",
+      "declarations": [
+        {
+          "kind": "class",
+          "description": "Which cloud vendor backs the tier-shaped provider registry, plus the means to move it at\nruntime (GENC-1610).",
+          "name": "TieredAIProviderSwitcher",
+          "members": [
+            {
+              "kind": "field",
+              "name": "vendors",
+              "type": {
+                "text": "readonly AITierVendor[]"
+              },
+              "readonly": true
+            },
+            {
+              "kind": "field",
+              "name": "options",
+              "type": {
+                "text": "TieredAIProviderSwitcherOptions"
+              },
+              "privacy": "private",
+              "readonly": true,
+              "default": "options"
+            },
+            {
+              "kind": "field",
+              "name": "defaultTier",
+              "type": {
+                "text": "AITierId"
+              },
+              "privacy": "private",
+              "readonly": true
+            },
+            {
+              "kind": "field",
+              "name": "registry",
+              "type": {
+                "text": "MutableAIProviderRegistry"
+              },
+              "privacy": "private",
+              "readonly": true
+            },
+            {
+              "kind": "field",
+              "name": "listeners",
+              "privacy": "private",
+              "readonly": true,
+              "default": "new Set<(vendor: AITierVendor) => void>()"
+            },
+            {
+              "kind": "field",
+              "name": "_vendor",
+              "type": {
+                "text": "AITierVendor"
+              },
+              "privacy": "private"
+            },
+            {
+              "kind": "field",
+              "name": "vendor",
+              "type": {
+                "text": "AITierVendor"
+              },
+              "readonly": true
+            },
+            {
+              "kind": "method",
+              "name": "switchTo",
+              "return": {
+                "type": {
+                  "text": "void"
+                }
+              },
+              "parameters": [
+                {
+                  "name": "vendor",
+                  "type": {
+                    "text": "string"
+                  }
+                }
+              ],
+              "description": "A user-driven switch: move the registry, then tell the app so it can persist the choice.\nAn unknown vendor is ignored."
+            },
+            {
+              "kind": "method",
+              "name": "adoptPersistedVendor",
+              "return": {
+                "type": {
+                  "text": "void"
+                }
+              },
+              "parameters": [
+                {
+                  "name": "vendor",
+                  "type": {
+                    "text": "string"
+                  }
+                }
+              ],
+              "description": "Adopt a vendor the app read back from its own store — the same registry move as\nTieredAIProviderSwitcher.switchTo, without the `onSwitch` callback, because this\nvalue came FROM the store and writing it back would be a pointless round-trip on load.\n\nExists because registration has to stay synchronous: an element that connects before the\ntoken is registered caches the platform's no-op fallback, so an app cannot await its\nstored preference before constructing this. It boots on `initialVendor` and adopts the\nstored one a moment later, through a registry that is mutable and held by reference."
+            },
+            {
+              "kind": "method",
+              "name": "subscribe",
+              "return": {
+                "type": {
+                  "text": "() => void"
+                }
+              },
+              "parameters": [
+                {
+                  "name": "listener",
+                  "type": {
+                    "text": "(vendor: string) => void"
+                  }
+                }
+              ]
+            },
+            {
+              "kind": "method",
+              "name": "apply",
+              "privacy": "private",
+              "return": {
+                "type": {
+                  "text": "void"
+                }
+              },
+              "parameters": [
+                {
+                  "name": "vendor",
+                  "type": {
+                    "text": "AITierVendor"
+                  }
+                }
+              ],
+              "description": "The registry move both entry points share, and nothing else."
+            },
+            {
+              "kind": "method",
+              "name": "build",
+              "privacy": "private",
+              "return": {
+                "type": {
+                  "text": "Record<string, AIProvider>"
+                }
+              },
+              "parameters": [
+                {
+                  "name": "vendor",
+                  "type": {
+                    "text": "AITierVendor"
+                  }
+                }
+              ]
+            },
+            {
+              "kind": "method",
+              "name": "isKnownVendor",
+              "privacy": "private",
+              "return": {
+                "type": {
+                  "text": "vendor is AITierVendor"
+                }
+              },
+              "parameters": [
+                {
+                  "name": "vendor",
+                  "type": {
+                    "text": "string"
+                  }
+                }
+              ]
+            }
+          ]
+        },
+        {
+          "kind": "function",
+          "name": "registerTieredAIProviders",
+          "return": {
+            "type": {
+              "text": "TieredAIProviderSwitcher"
+            }
+          },
+          "parameters": [
+            {
+              "name": "container",
+              "type": {
+                "text": "Container"
+              }
+            },
+            {
+              "name": "options",
+              "type": {
+                "text": "Omit<TieredAIProviderSwitcherOptions, 'container'>"
+              }
+            }
+          ],
+          "description": "Build a TieredAIProviderSwitcher — which registers the tier-shaped provider\nregistry — and put it on the (AIProviderSwitcher:variable) token. Call once at app\nbootstrap."
+        }
+      ],
+      "exports": [
+        {
+          "kind": "js",
+          "name": "TieredAIProviderSwitcher",
+          "declaration": {
+            "name": "TieredAIProviderSwitcher",
+            "module": "src/provider/tiered-provider-switcher.ts"
+          }
+        },
+        {
+          "kind": "js",
+          "name": "registerTieredAIProviders",
+          "declaration": {
+            "name": "registerTieredAIProviders",
+            "module": "src/provider/tiered-provider-switcher.ts"
+          }
+        }
+      ]
+    },
     {
       "kind": "javascript-module",
       "path": "src/state/ai-assistant-slice.ts",

package/dist/dts/genesis/write-commit.d.ts

@@ -10,13 +10,23 @@ import { type GenesisWriteOutcome } from './write-outcome';
  * reopen the gap the review exists to close: the user approves what they read, and anything
  * re-derived afterwards is something they did not.
  *
- * There is **no pre-write validation pass**. `VALIDATE: true` is accepted and ignored by a
- * Create-generated handler — it declares `onCommit` only, so the platform runs it as a plain
- * event handler and the row is COMMITTED. Asking for a dry run there would write every row the
- * user was still deciding about, then report it as merely checked. What the dry run was buying
- * is already done client-side, before anything is sent: required fields, types, enums, dates
- * and read-only fields are all checked against the same metadata the server's schema validation
- * reads.
+ * There is **no pre-write validation pass** — not because one would write, but because it would
+ * check nothing new. `VALIDATE: true` runs a handler's `onValidate` and stops there: `onCommit`
+ * runs only on a message that is not a validate, after `onValidate` acked (genesis-server
+ * 8.15.29, `TransactionalEventHandlerContainer`; the same from 7.2.28 to 10.0.0-beta4). A
+ * Create-generated handler declares `onCommit` alone, so its `onValidate` is the platform's
+ * default, which acks; on 10.0 a Spring `@EventCommit`-only handler acks a validate without
+ * running at all. Recorded on the showcase: `EVENT_COUNTERPARTY_INSERT`, which has no
+ * `onValidate`, ACKed a `VALIDATE` and wrote nothing.
+ *
+ * So on such a handler a dry run checks the payload's schema and nothing more, and that is
+ * already done client-side, before anything is sent: required fields, types, enums, dates and
+ * read-only fields are all checked against the same metadata the server's schema validation
+ * reads. Where a handler does declare an `onValidate`, the commit runs it first, and its refusal
+ * comes back as that row's answer; a dry run would only hear it before the user approves rather
+ * than after. A dry run is unsafe only on hand-written code that is handed the flag and ignores
+ * it — a class implementing a plain, non-validating `AsyncEventHandler` or `SyncEventHandler`, or
+ * a Spring method taking `@IsValidateOnly` — which nothing on the wire tells apart from the rest.
  */
 export interface GenesisWriteRow {
     /** Position in the model's original list, so an outcome can be matched back to its row. */

package/dist/dts/genesis/write-commit.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"write-commit.d.ts","sourceRoot":"","sources":["../../../src/genesis/write-commit.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,+BAA+B,CAAC;AAG7D,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAC7C,OAAO,EAIL,KAAK,mBAAmB,EACzB,MAAM,iBAAiB,CAAC;AAEzB;;;;;;;;;;;;;;;;GAgBG;AACH,MAAM,WAAW,eAAe;IAC9B,2FAA2F;IAC3F,KAAK,EAAE,MAAM,CAAC;IACd,6EAA6E;IAC7E,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CAClC;AAED,gBAAgB;AAChB,MAAM,WAAW,aAAa;IAC5B,OAAO,EAAE,OAAO,CAAC;IACjB,SAAS,EAAE,MAAM,CAAC;IAClB,wFAAwF;IACxF,EAAE,EAAE,UAAU,CAAC;IACf,yFAAyF;IACzF,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAKD,gBAAgB;AAChB,MAAM,WAAW,gBAAiB,SAAQ,mBAAmB;IAC3D,KAAK,EAAE,MAAM,CAAC;CACf;AAmBD;;;;;;;;;;GAUG;AACH,wBAAsB,UAAU,CAC9B,IAAI,EAAE,SAAS,eAAe,EAAE,EAChC,EAAE,OAAO,EAAE,SAAS,EAAE,EAAE,EAAE,MAAM,EAAE,SAA6B,EAAE,EAAE,aAAa,GAC/E,OAAO,CAAC,gBAAgB,EAAE,CAAC,CAyD7B"}
+{"version":3,"file":"write-commit.d.ts","sourceRoot":"","sources":["../../../src/genesis/write-commit.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,+BAA+B,CAAC;AAG7D,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAC7C,OAAO,EAIL,KAAK,mBAAmB,EACzB,MAAM,iBAAiB,CAAC;AAEzB;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AACH,MAAM,WAAW,eAAe;IAC9B,2FAA2F;IAC3F,KAAK,EAAE,MAAM,CAAC;IACd,6EAA6E;IAC7E,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CAClC;AAED,gBAAgB;AAChB,MAAM,WAAW,aAAa;IAC5B,OAAO,EAAE,OAAO,CAAC;IACjB,SAAS,EAAE,MAAM,CAAC;IAClB,wFAAwF;IACxF,EAAE,EAAE,UAAU,CAAC;IACf,yFAAyF;IACzF,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAKD,gBAAgB;AAChB,MAAM,WAAW,gBAAiB,SAAQ,mBAAmB;IAC3D,KAAK,EAAE,MAAM,CAAC;CACf;AAmBD;;;;;;;;;;GAUG;AACH,wBAAsB,UAAU,CAC9B,IAAI,EAAE,SAAS,eAAe,EAAE,EAChC,EAAE,OAAO,EAAE,SAAS,EAAE,EAAE,EAAE,MAAM,EAAE,SAA6B,EAAE,EAAE,aAAa,GAC/E,OAAO,CAAC,gBAAgB,EAAE,CAAC,CAyD7B"}

package/dist/esm/genesis/write-outcome.js

@@ -145,8 +145,8 @@ export function mapWriteReply(reply, { mode, op }) {
     const warnings = warningsOf(message);
     if (type === 'EVENT_ACK') {
         // The mode is the whole difference. A dry run ACKs without writing anything, and on a
-        // generated app it ACKs whatever it is given, so calling that "written" would be the lie
-        // the review table is built to avoid.
+        // generated app it ACKs any payload that passes the schema, so calling that "written" would
+        // be the lie the review table is built to avoid.
         if (mode === 'validate') {
             return Object.assign({ status: 'checked', committed: false, message: 'Checked.' }, (warnings ? { warnings } : {}));
         }

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@genesislcap/ai-assistant",
   "description": "Genesis AI Assistant micro-frontend",
-  "version": "15.62.0",
+  "version": "15.63.0",
   "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.62.0",
-    "@genesislcap/foundation-testing": "15.62.0",
-    "@genesislcap/genx": "15.62.0",
-    "@genesislcap/ts-builder": "15.62.0",
-    "@genesislcap/uvu-playwright-builder": "15.62.0",
-    "@genesislcap/vite-builder": "15.62.0",
-    "@genesislcap/webpack-builder": "15.62.0",
+    "@genesislcap/foundation-comms": "15.63.0",
+    "@genesislcap/foundation-testing": "15.63.0",
+    "@genesislcap/genx": "15.63.0",
+    "@genesislcap/ts-builder": "15.63.0",
+    "@genesislcap/uvu-playwright-builder": "15.63.0",
+    "@genesislcap/vite-builder": "15.63.0",
+    "@genesislcap/webpack-builder": "15.63.0",
     "@types/dompurify": "^3.0.5",
     "@types/marked": "^5.0.2",
     "esbuild": "0.25.12"
   },
   "dependencies": {
-    "@genesislcap/foundation-ai": "15.62.0",
-    "@genesislcap/foundation-logger": "15.62.0",
-    "@genesislcap/foundation-notifications": "15.62.0",
-    "@genesislcap/foundation-redux": "15.62.0",
-    "@genesislcap/foundation-ui": "15.62.0",
-    "@genesislcap/foundation-utils": "15.62.0",
-    "@genesislcap/rapid-design-system": "15.62.0",
-    "@genesislcap/web-core": "15.62.0",
+    "@genesislcap/foundation-ai": "15.63.0",
+    "@genesislcap/foundation-logger": "15.63.0",
+    "@genesislcap/foundation-notifications": "15.63.0",
+    "@genesislcap/foundation-redux": "15.63.0",
+    "@genesislcap/foundation-ui": "15.63.0",
+    "@genesislcap/foundation-utils": "15.63.0",
+    "@genesislcap/rapid-design-system": "15.63.0",
+    "@genesislcap/web-core": "15.63.0",
     "dompurify": "^3.3.1",
     "marked": "^17.0.3"
   },
   "peerDependencies": {
-    "@genesislcap/foundation-comms": "^15.62.0"
+    "@genesislcap/foundation-comms": "^15.63.0"
   },
   "peerDependenciesMeta": {
     "@genesislcap/foundation-comms": {