Merge staging into shared shimmer treatment

Author: Bill Leoutsakos

.agents/skills/add-connector/SKILL.md

@@ -8,7 +8,7 @@ argument-hint: <service-name> [api-docs-url]
 
 ## Choose the connector runtime first
 
-For **Sim Search**, use the live provider workflow in [the federated Search developer guide](../../../apps/sim/lib/sim-search/live/README.md#adding-a-live-search-connector). Its browser-safe provider catalog owns provider IDs, API origins, credential aliases, and account modes; its typed runtime registry requires both search and read handlers. `ConnectorMeta` remains the owner of logos and setup fields. Member mode has no admin resource filters. Service mode requires independent live source verification and shared selectors. Do not implement a Search source by adding a crawler, embeddings, or a scheduled ACL build.
+For **Sim Search**, use the live provider workflow in [the federated Search developer guide](../../../apps/sim/lib/sim-search/live/README.md#adding-a-live-search-connector). Its browser-safe provider catalog owns provider IDs, API origins, credential aliases, and account modes; its typed runtime registry requires both search and read handlers. `ConnectorMeta` remains the owner of logos and setup fields. Member mode has no admin resource filters. Service mode requires independent live source verification; resource pickers use shared selectors with canonical manual-input pairs, and plain inputs are fine where no picker applies. Do not implement a Search source by adding a crawler, embeddings, or a scheduled ACL build.
 
 The ingestion instructions below apply to **ordinary knowledge-base connectors** and the explicit legacy Search backend (`SIM_SEARCH_LIVE=false`). If a provider supports both, implement and test both runtimes; adding `search: true` to metadata alone does not implement federated search. Preserve indexing documentation and behavior for those KB/legacy callers.
 

.claude/rules/sim-settings-pages.md

@@ -252,11 +252,12 @@ and — on activatable rows only — the hover band. Never hand-roll any of it,
 
 
 **One member avatar.** Every member list, owner cell, and ranking renders emcn
-`<Avatar size='xs' name={…} src={…} aria-hidden />` — a 14px photo, or the initial
-on the neutral disc (`aria-hidden` because the name is always beside it). Never
-hand-roll an avatar or give a person a `getUserColor` hash; per-person colors
-belong to live collaboration (presence, cursors), where the color matches that
-person's cursor.
+`<Avatar size='xs' name={…} src={…} />` — a 14px photo, or the initial on the
+neutral disc. Pass `aria-hidden` only when the member's name is visibly rendered
+beside it; an email-only row (`MemberRow`) keeps the avatar labelled because it
+carries the name. Never hand-roll an avatar or give a person a `getUserColor`
+hash; per-person colors belong to live collaboration (presence, cursors), where
+the color matches that person's cursor.
 
 ## Header action order
 

.cursor/rules/sim-settings-pages.mdc

@@ -249,11 +249,12 @@ and — on activatable rows only — the hover band. Never hand-roll any of it,
 
 
 **One member avatar.** Every member list, owner cell, and ranking renders emcn
-`<Avatar size='xs' name={…} src={…} aria-hidden />` — a 14px photo, or the initial
-on the neutral disc (`aria-hidden` because the name is always beside it). Never
-hand-roll an avatar or give a person a `getUserColor` hash; per-person colors
-belong to live collaboration (presence, cursors), where the color matches that
-person's cursor.
+`<Avatar size='xs' name={…} src={…} />` — a 14px photo, or the initial on the
+neutral disc. Pass `aria-hidden` only when the member's name is visibly rendered
+beside it; an email-only row (`MemberRow`) keeps the avatar labelled because it
+carries the name. Never hand-roll an avatar or give a person a `getUserColor`
+hash; per-person colors belong to live collaboration (presence, cursors), where
+the color matches that person's cursor.
 
 ## Header action order
 

apps/desktop/src/main/browser-agent/page-functions.test.ts

@@ -912,6 +912,21 @@ describe('collectSnapshot', () => {
     expect(captured.input.ownerDocument).toBe(document)
   })
 
+  it('climbs out of a shadow root inside a same-origin frame to find the file input', () => {
+    const frame = document.createElement('iframe')
+    document.body.append(frame)
+    const childDocument = frame.contentDocument as Document
+    childDocument.body.innerHTML = '<div id="host"></div><input type="file">'
+    const host = childDocument.getElementById('host') as HTMLElement
+    const button = childDocument.createElement('button')
+    host.attachShadow({ mode: 'open' }).append(button)
+    const input = childDocument.querySelector('input') as HTMLInputElement
+    register(button)
+
+    expect(button.getRootNode()).not.toBeInstanceOf(ShadowRoot)
+    expect(resolveFileInputTarget(0)).toEqual({ input, document: childDocument })
+  })
+
   it('refuses a disconnected or stale upload reference', () => {
     const input = document.createElement('input')
     input.type = 'file'

apps/desktop/src/main/browser-agent/page-functions.ts

@@ -3348,7 +3348,7 @@ export function resolveFileInputTarget(id: number): {
       )
     if (candidates.length === 1) input = candidates[0]
     const root = scope.getRootNode()
-    scope = scope.parentElement ?? (root instanceof ShadowRoot ? root.host : null)
+    scope = scope.parentElement ?? ('host' in root ? (root.host as Element) : null)
   }
   if (!input) throw new Error('The selected element has no nearby file input.')
   if (input.matches(':disabled')) throw new Error('The file input is disabled.')

apps/docs/content/docs/integrations/embeddings.mdx

@@ -51,11 +51,13 @@ Generate embeddings from text using OpenAI's embedding models
 
 | Parameter | Type | Description |
 | --------- | ---- | ----------- |
-| `embeddings` | json | Generated embeddings |
+| `embeddings` | json | Generated embedding vectors, one per input, in input order |
 | `model` | string | Model used |
 | `provider` | string | Provider used |
-| `dimensions` | number | Dimensionality of each vector |
+| `dimensions` | number | Dimensionality of each returned vector |
 | `usage` | json | Token usage |
+|   ↳ `prompt_tokens` | number | Tokens in the input |
+|   ↳ `total_tokens` | number | Total tokens billed |
 
 ### OpenRouter Embeddings
 
@@ -75,11 +77,13 @@ Generate embeddings through OpenRouter
 
 | Parameter | Type | Description |
 | --------- | ---- | ----------- |
-| `embeddings` | json | Generated embeddings |
+| `embeddings` | json | Generated embedding vectors, one per input, in input order |
 | `model` | string | Model used |
 | `provider` | string | Provider used |
-| `dimensions` | number | Dimensionality of each vector |
+| `dimensions` | number | Dimensionality of each returned vector |
 | `usage` | json | Token usage |
+|   ↳ `prompt_tokens` | number | Tokens in the input |
+|   ↳ `total_tokens` | number | Total tokens billed |
 
 ### Gemini Embeddings
 
@@ -99,11 +103,13 @@ Generate embeddings from text using Google's Gemini embedding models
 
 | Parameter | Type | Description |
 | --------- | ---- | ----------- |
-| `embeddings` | json | Generated embeddings |
+| `embeddings` | json | Generated embedding vectors, one per input, in input order |
 | `model` | string | Model used |
 | `provider` | string | Provider used |
-| `dimensions` | number | Dimensionality of each vector |
+| `dimensions` | number | Dimensionality of each returned vector |
 | `usage` | json | Token usage |
+|   ↳ `prompt_tokens` | number | Tokens in the input |
+|   ↳ `total_tokens` | number | Total tokens billed |
 
 ### Cohere Embeddings
 
@@ -123,11 +129,13 @@ Generate embeddings from text using Cohere's embedding models
 
 | Parameter | Type | Description |
 | --------- | ---- | ----------- |
-| `embeddings` | json | Generated embeddings |
+| `embeddings` | json | Generated embedding vectors, one per input, in input order |
 | `model` | string | Model used |
 | `provider` | string | Provider used |
-| `dimensions` | number | Dimensionality of each vector |
+| `dimensions` | number | Dimensionality of each returned vector |
 | `usage` | json | Token usage |
+|   ↳ `prompt_tokens` | number | Tokens in the input |
+|   ↳ `total_tokens` | number | Total tokens billed |
 
 ### Mistral Embeddings
 
@@ -147,11 +155,13 @@ Generate embeddings from text using Mistral's embedding models
 
 | Parameter | Type | Description |
 | --------- | ---- | ----------- |
-| `embeddings` | json | Generated embeddings |
+| `embeddings` | json | Generated embedding vectors, one per input, in input order |
 | `model` | string | Model used |
 | `provider` | string | Provider used |
-| `dimensions` | number | Dimensionality of each vector |
+| `dimensions` | number | Dimensionality of each returned vector |
 | `usage` | json | Token usage |
+|   ↳ `prompt_tokens` | number | Tokens in the input |
+|   ↳ `total_tokens` | number | Total tokens billed |
 
 ### Ollama Embeddings
 
@@ -168,10 +178,12 @@ Generate embeddings on a self-hosted Ollama server
 
 | Parameter | Type | Description |
 | --------- | ---- | ----------- |
-| `embeddings` | json | Generated embeddings |
+| `embeddings` | json | Generated embedding vectors, one per input, in input order |
 | `model` | string | Model used |
 | `provider` | string | Provider used |
-| `dimensions` | number | Dimensionality of each vector |
+| `dimensions` | number | Dimensionality of each returned vector |
 | `usage` | json | Token usage |
+|   ↳ `prompt_tokens` | number | Tokens in the input |
+|   ↳ `total_tokens` | number | Total tokens billed |