@abide/abide 0.115.0 → 0.116.1

package/CHANGELOG.md

@@ -1,5 +1,24 @@
 # @abide/abide
 
+## 0.116.1
+
+### Patch Changes
+
+- 7dedb9a: the offline worker keeps an answer marked `cache-control: public` — a public file, a font a stylesheet draws with — through a sign-in, a sign-out and a form submitted, which drop only what was saved for the caller
+- 6a69393: a copy the offline worker kept stands in for a year where the network fails, rather than a week — a page, a GET's answer and a public file carry `stale-if-error=31536000`
+
+## 0.116.0
+
+### Minor Changes
+
+- c1c3924: `bind:files` — a file input's files as an array, one or many: a pick writes them, and an array written to it (one dropped, or `[]` to clear) is what the input holds. A `bind:` an element has no property for, such as `bind:file` or `bind:vlaue`, is now a build error where it compiled to an attribute that bound nothing. RULEBOOK 32.73, 32.74
+- 48cfc3e: tools answer images — a handler whose answer is a png, jpeg, gif or webp body reaches a model as the image: `/__abide/mcp` carries it as an `image` content item (so Claude Code, through a bridge, sees it), and a `Toolbox` call answers a `ToolAnswer` of `content` — the same pieces, text or image — which `claudeApi` shows the model as the call's result. Any other image type, an svg, is answered as its text. Breaking for a hand-written `Provider`: a `ToolAnswer` is `{ content, failed }` where it was `{ text, failed }`. RULEBOOK 20.21, 44.35
+- 48cfc3e: multimodal transcripts — an `AssistantMessage`'s `content` is its words or its pieces in order, each `AssistantContent` text or an image as base64 with its type. `assistant` refuses an image a model can't take or one outside a user turn, and hands a `Provider` every turn as its pieces, words alone as one text piece. `claudeApi` shows each image to the model as an image block in its place, and `claudeCode` sends the one message Claude Code is sent as Messages API blocks, each image in its place. RULEBOOK 44.5, 44.36, 44.37, 44.38, 44.39
+
+### Patch Changes
+
+- 0a78343: a page reached inside the app reloads offline — the router tells the offline worker each address a navigation reaches, and the worker keeps its page where no saved copy would stand in ([`a3975be`](https://github.com/briancray/abide/commit/a3975be224584df096fe799c6291c0dfcd80cf84))
+
 ## 0.115.0
 
 ### Minor Changes

package/docs/REGISTRY.md

@@ -291,8 +291,8 @@ type Gated<Gate, Accepted> = [Schema<Accepted>] extends [Gate] ? never : Failed<
 | `cache-control: no-store` | `/__abide/openapi.json`, `/__abide/mcp` | Refuses caching for an answer about the app's surfaces. | 21.4 |
 | `cache-control: public, max-age=31536000, immutable` | the built bundle | A chunk addressed by its own content hash. | 21.5 |
 | `cache-control: public, max-age=0, must-revalidate` | a file under a `public` directory | A file at an address the build never chose. | 21.12 |
-| `cache-control: private, stale-while-revalidate=604800, stale-if-error=604800` | a page, a `GET`'s answer, where `ABIDE_OFFLINE` registers its worker | The default that lets a copy kept on the device stand in for the network. | 21.22, 21.11, 21.17 |
-| `cache-control: public, max-age=0, stale-while-revalidate=604800, stale-if-error=604800` | a file under a `public` directory, where `ABIDE_OFFLINE` registers its worker | The same, for a file at an address the build never chose. | 21.23 |
+| `cache-control: private, stale-while-revalidate=604800, stale-if-error=31536000` | a page, a `GET`'s answer, where `ABIDE_OFFLINE` registers its worker | The default that lets a copy kept on the device stand in for the network. | 21.22, 21.11, 21.17 |
+| `cache-control: public, max-age=0, stale-while-revalidate=604800, stale-if-error=31536000` | a file under a `public` directory, where `ABIDE_OFFLINE` registers its worker | The same, for a file at an address the build never chose. | 21.23 |
 | `clear-site-data: "cache"` | an answer carrying `abide-principal`, where pages are kept offline | Drops what the browser's own cache kept for the caller signed in before. | 21.24 |
 | `etag` | a file under a `public` directory | The answered bytes, addressed by their content. | 21.13, 21.14 |
 | `referrer-policy: strict-origin-when-cross-origin` | a page | The browsers' own default, written down. | 21.6 |
@@ -321,25 +321,27 @@ type Gated<Gate, Accepted> = [Schema<Accepted>] extends [Gate] ? never : Failed<
 
 | Name | Signature | Meaning | Rules |
 | --- | --- | --- | --- |
-| `/__abide/mcp` | `POST` | The streamable-http MCP endpoint. | 19.21, 19.22, 20.5, 20.7, 20.8, 20.9, 20.10, 20.12, 20.13, 20.14, 20.16, 20.17, 20.19, 20.20, 36.7, 16.78 |
+| `/__abide/mcp` | `POST` | The streamable-http MCP endpoint. | 19.21, 19.22, 20.5, 20.7, 20.8, 20.9, 20.10, 20.12, 20.13, 20.14, 20.16, 20.17, 20.19, 20.20, 20.21, 20.22, 36.7, 16.78 |
 
 # Assistant
 
 | Name | Signature | Meaning | Rules |
 | --- | --- | --- | --- |
-| `assistant` | `(messages: AssistantMessage[], provider: Provider, options?: AssistantOptions) => AsyncGenerator<AssistantEvent>` | A conversation with a model, as the events it produces. | 44.1, 44.2, 44.3, 44.4, 44.21 |
-| `AssistantMessage` | `{ role: 'user' \| 'assistant'; content: string }` | One turn of the transcript a caller sends. | 44.3, 44.4 |
+| `assistant` | `(messages: AssistantMessage[], provider: Provider, options?: AssistantOptions) => AsyncGenerator<AssistantEvent>` | A conversation with a model, as the events it produces. | 44.1, 44.2, 44.3, 44.4, 44.21, 44.36, 44.37, 44.39 |
+| `AssistantMessage` | `{ role: 'user' \| 'assistant'; content: string \| AssistantContent[] }` | One turn of the transcript a caller sends: its words, or its pieces in order. | 44.3, 44.4 |
+| `AssistantContent` | `{ type: 'text'; text: string } \| { type: 'image'; data: string; mimeType: string }` | A piece of a turn: words, or an image as base64 with its type. | 44.5, 44.35, 44.36, 44.37, 44.38, 44.39 |
 | `AssistantEvent` | `{ type: 'text'; text: string } \| { type: 'tool'; id: string; name: string } \| { type: 'input'; id: string; input: unknown } \| { type: 'result'; id: string; text: string; failed: boolean } \| { type: 'done'; stop: string; usage: { input: number; output: number } }` | What a conversation produces: text, a tool call as it starts, its input once written, its result, and the end. | 44.2, 44.11, 44.28 |
 | `AssistantOptions` | `{ mcp?: boolean; maxTurns?: number }` | What `assistant` takes beside a provider. | 44.6, 44.8, 44.11 |
-| `Provider` | `{ run(messages: AssistantMessage[], tools: Toolbox, limits: { maxTurns: number; signal: AbortSignal }): AsyncGenerator<AssistantEvent> }` | What runs a conversation. | 44.2, 44.28 |
-| `Toolbox` | `{ list: ToolDefinition[]; call(name: string, input: unknown): Promise<{ text: string; failed: boolean }> }` | The app's MCP tools, called as the asker. | 44.6, 44.7 |
+| `Provider` | `{ run(messages: (AssistantMessage & { content: AssistantContent[] })[], tools: Toolbox, limits: { maxTurns: number; signal: AbortSignal }): AsyncGenerator<AssistantEvent> }` | What runs a conversation. | 44.2, 44.28, 44.39 |
+| `Toolbox` | `{ list: ToolDefinition[]; call(name: string, input: unknown): Promise<ToolAnswer> }` | The app's MCP tools, called as the asker. | 44.6, 44.7, 44.35 |
+| `ToolAnswer` | `{ content: AssistantContent[]; failed: boolean }` | What a tool call answered: its pieces, and whether it failed. | 20.21, 20.22, 44.35 |
 | `ToolDefinition` | `{ name: string; description: string; inputSchema: unknown; annotations: { readOnlyHint: boolean; destructiveHint: boolean; idempotentHint: boolean }; outputSchema: unknown }` | A tool as the app's MCP surface lists it. | 20.14, 20.16, 20.19, 44.6 |
 
 ## `claudeApi`
 
 | Name | Signature | Meaning | Rules |
 | --- | --- | --- | --- |
-| `claudeApi` | `(config: ClaudeApiConfig) => Provider` | The Claude Messages API as a provider. | 44.9, 44.10, 44.12, 44.21 |
+| `claudeApi` | `(config: ClaudeApiConfig) => Provider` | The Claude Messages API as a provider. | 44.9, 44.10, 44.12, 44.21, 44.35, 44.38 |
 | `ClaudeApiConfig` | `{ apiKey: string; baseURL?: string; model: string; max_tokens: number; system?: string \| unknown[]; tools?: unknown[]; [field: string]: unknown }` | A Messages API request body, less `messages` and `stream`, with the client's key and origin. | 44.9, 44.10 |
 
 ## `claudeCode`
@@ -519,7 +521,7 @@ type Gated<Gate, Accepted> = [Schema<Accepted>] extends [Gate] ? never : Failed<
 
 | Name | Signature | Meaning | Rules |
 | --- | --- | --- | --- |
-| `navigate` | `(url?: URL \| string, options?: { replace?: boolean, keepScroll?: boolean }) => Promise<void>` | Navigates. | 30.7, 30.9, 30.10, 30.11, 30.12, 30.13, 30.14, 30.15, 30.16, 30.17, 30.18, 30.20, 30.21, 30.22, 30.23, 30.24, 30.25, 30.27, 30.29, 30.30, 30.31, 30.32, 45.12 |
+| `navigate` | `(url?: URL \| string, options?: { replace?: boolean, keepScroll?: boolean }) => Promise<void>` | Navigates. | 30.7, 30.9, 30.10, 30.11, 30.12, 30.13, 30.14, 30.15, 30.16, 30.17, 30.18, 30.20, 30.21, 30.22, 30.23, 30.24, 30.25, 30.27, 30.29, 30.30, 30.31, 30.32, 45.12, 45.24 |
 
 # `.abide` files
 
@@ -551,11 +553,12 @@ type Gated<Gate, Accepted> = [Schema<Accepted>] extends [Gate] ? never : Failed<
 | `name={expr}` | A reactive attribute or property. | 32.3, 32.20, 32.23, 32.37, 32.70, 32.71 |
 | `on<event>={fn}` | A native listener on an element, and an ordinary prop on a component. | 32.4 |
 | `name="…{expr}…"` | An interpolated quoted value. | 32.3, 32.71 |
-| `bind:value` | Two-way bind on an element. | 5.16, 32.5, 32.58, 32.59, 32.60, 32.61, 32.62, 32.72 |
+| `bind:value` | Two-way bind on an element. | 5.16, 32.5, 32.58, 32.59, 32.60, 32.61, 32.62, 32.72, 32.74 |
 | `bind:prop={state}` | Hands a component prop the caller's `Reactive`, or a `{get, set}` pair, to write through. | 32.6, 33.6, 33.8, 14.18 |
-| `bind:checked` | A boolean bind on an input. | 32.7, 32.72 |
-| `bind:open` | The same, on a `<details>`. | 32.7, 32.72 |
-| `bind:group` | Radio or checkbox membership. | 32.8, 32.72 |
+| `bind:checked` | A boolean bind on an input. | 32.7, 32.72, 32.74 |
+| `bind:open` | The same, on a `<details>`. | 32.7, 32.72, 32.74 |
+| `bind:group` | Radio or checkbox membership. | 32.8, 32.72, 32.74 |
+| `bind:files` | A file input's files, as a list. | 32.73, 32.72, 32.74 |
 | `bind:value={{get, set}}` | Two-way bind over an explicit accessor pair, on an element or a component. | 32.5, 32.6 |
 | `bind:element={Reactive<Element> \| ((element: Element) => void \| Disposer)}` | A node reference. | 32.9, 32.38, 32.66, 32.68, 32.69 |
 | `class:name={cond}` | Toggles a class. | 32.10, 32.71 |
@@ -656,7 +659,7 @@ type Gated<Gate, Accepted> = [Schema<Accepted>] extends [Gate] ? never : Failed<
 | `ABIDE_MAX_REQUEST_BODY_SIZE` | `number` | The default ceiling on a mutation's body. | 16.13, 16.54, 16.55, 16.78 |
 | `ABIDE_MAX_SOCKET_MESSAGE_SIZE` | `number` | The ceiling on a frame received over the socket mux, in bytes. | 18.28 |
 | `ABIDE_MAX_SOCKET_SUBSCRIPTIONS` | `number` | How many values one connection to the socket mux may follow. | 18.31, 18.32 |
-| `ABIDE_OFFLINE` | `boolean` | Whether the app keeps its pages and its bundle on the device, for when the network is gone. | 45.1, 45.2, 45.3, 45.4, 45.5, 45.6, 45.7, 45.8, 45.9, 45.10, 45.11, 45.12, 45.13, 45.14, 45.15, 45.16, 45.17, 45.18, 45.19, 45.20, 45.21, 45.22, 45.23 |
+| `ABIDE_OFFLINE` | `boolean` | Whether the app keeps its pages and its bundle on the device, for when the network is gone. | 45.1, 45.2, 45.3, 45.4, 45.5, 45.6, 45.7, 45.8, 45.9, 45.10, 45.11, 45.12, 45.13, 45.14, 45.15, 45.16, 45.17, 45.18, 45.19, 45.20, 45.21, 45.22, 45.23, 45.24 |
 | `ABIDE_STOP_TIMEOUT` | `number` | How long `App.stop` drains, in ms. | 42.17, 42.18 |
 | `ABIDE_MAX_STREAM_BUFFER_SIZE` | `number` | The cap on a stream transcript held in memory. | 36.18 |
 | `ABIDE_MAX_LOG_BUFFER_COUNT` | `number` | How many lines `log.records` is trimmed back to. | 28.1 |

package/docs/RULEBOOK.md

@@ -1385,6 +1385,13 @@ whatever its handler's args schema declares there.
 20.20 A handler `/__abide/mcp` would list whose args schema can never be an object MUST refuse the
 app at boot, naming the handler.
 
+20.21 A `tools/call` that `/__abide/mcp` answers for a call answered with an image body of a type
+44.36 names MUST carry that body as one `image` content item, base64 with its type, in place of its
+text, and MUST carry no `structuredContent`.
+
+20.22 A call to a tool declaring an `outputSchema` that is answered with an `image/*` body MUST be
+refused, its text naming the tool and the image's type, and MUST be logged per 20.18 as a 500.
+
 # 21. Generated headers
 
 21.1 Every response MUST carry `x-content-type-options: nosniff`.
@@ -1441,11 +1448,11 @@ time those rungs took apart from what they wrapped.
 
 21.22 Where 45.1 has a page register the worker `ABIDE_OFFLINE` turns on, a page, and the answer of
 a `GET` of the app's own that is neither a refusal nor a stream 16.32 frames, MUST default to `cache-control: private,
-stale-while-revalidate=604800, stale-if-error=604800`.
+stale-while-revalidate=604800, stale-if-error=31536000`.
 
 21.23 Where 45.1 has a page register the worker `ABIDE_OFFLINE` turns on, a file under a `public`
 directory MUST answer `cache-control: public, max-age=0, stale-while-revalidate=604800,
-stale-if-error=604800`.
+stale-if-error=31536000`.
 
 21.24 Where 45.1 has a page register the worker `ABIDE_OFFLINE` turns on, an answer carrying the
 `abide-principal` header 26.24 has it carry MUST carry `clear-site-data: "cache"`.
@@ -2072,6 +2079,13 @@ declarations first, then each directive's in the tag's order.
 attribute a `bind:name` names, `checked` beside `bind:group`, an `<option selected>` inside a
 `<select bind:value>`, or text inside a `<textarea bind:value>`.
 
+32.73 `bind:files` MUST hold a list of the input's files, with or without `multiple`, MUST write the
+files picked back on change, and MUST hand the input a list written to it; the server MUST write
+nothing for it.
+
+32.74 A `bind:` on an element naming none of `value`, `checked`, `open`, `group`, `files` and
+`element` MUST be a build error.
+
 # 33. Props
 
 33.1 `props` MUST be callable from a `<script>` block only, and calling it from a `<script module>`
@@ -3160,7 +3174,7 @@ of its own.
 each one.
 
 44.5 `claudeCode` MUST send a transcript to Claude Code as one message, its earlier turns folded
-above the last.
+above the last and each `AssistantContent` image in its place.
 
 44.6 With `mcp`, the `Toolbox` `assistant` hands a `Provider` MUST list the tools `/__abide/mcp`
 lists, and MUST call each as a request through the app answering the request.
@@ -3251,6 +3265,23 @@ that browser carrying any other.
 `principal.clear` made at its browser since it opened signs in, at the caller 26.9 rotates it to,
 and the command it yields MUST pair that one.
 
+44.35 A `Toolbox` call MUST hand as its `ToolAnswer`'s `content` the pieces `/__abide/mcp` carries
+for the same call, `claudeApi` MUST show the model those pieces as the call's result, and the
+`result` `AssistantEvent` MUST carry their words and none of their images.
+
+44.36 `assistant` MUST refuse 400, before any `Provider` is reached, a transcript holding an
+`AssistantContent` image whose `mimeType` is none of `image/png`, `image/jpeg`, `image/gif` and
+`image/webp`.
+
+44.37 `assistant` MUST refuse 400, before any `Provider` is reached, a transcript holding an
+`AssistantContent` image in a turn that is not the user's.
+
+44.38 `claudeApi` MUST send each `AssistantContent` image to the model as an image block, base64 with
+its type, in its place in its turn.
+
+44.39 `assistant` MUST hand a `Provider` each turn as its `AssistantContent` pieces, a turn's string
+as one text piece.
+
 # 45. Offline
 
 45.1 Where `ABIDE_OFFLINE` is on, a page `abide build` built MUST register the worker
@@ -3270,8 +3301,9 @@ rather than one a redirect led to, that is neither a stream 16.32 frames nor a b
 45.6 The worker `ABIDE_OFFLINE` turns on MUST answer a file of the build's bundle from what it
 saved.
 
-45.7 The worker `ABIDE_OFFLINE` turns on MUST drop everything it saved where an answer it is handed
-carries `abide-principal`, where `principal` changes in any tab, and where a form is submitted.
+45.7 The worker `ABIDE_OFFLINE` turns on MUST drop everything it saved, save an answer whose
+`cache-control` is `public`, where an answer it is handed carries `abide-principal`, where
+`principal` changes in any tab, and where a form is submitted.
 
 45.8 The worker `ABIDE_OFFLINE` turns on, of a new build, MUST drop everything the one before it
 saved, and every file of the bundle the new build does not name.
@@ -3322,6 +3354,10 @@ and that copy is stale by no more than its `stale-if-error`.
 45.23 The worker `ABIDE_OFFLINE` turns on MUST ask for a page it saves with an `abide-keep` header,
 naming `open` where its answer is the one a navigation opens.
 
+45.24 The worker `ABIDE_OFFLINE` turns on MUST save the page of an address a `navigate` reached,
+where it saved no copy of that address 45.19 would answer with, and MUST NOT save one of another
+origin.
+
 # 46. Outbox
 
 46.1 `outbox` MUST answer, oldest first, every call queued in it that was neither delivered nor

package/docs/abide.md

@@ -72,10 +72,12 @@ at its address with `.md` on the end, and the links below point at those files.
 - Generated surfaces — `reference/generated-surfaces.md`
 - `assistant` — `reference/assistant.md`
 - `AssistantMessage` — `reference/types/AssistantMessage.md`
+- `AssistantContent` — `reference/types/AssistantContent.md`
 - `AssistantEvent` — `reference/types/AssistantEvent.md`
 - `AssistantOptions` — `reference/types/AssistantOptions.md`
 - `Provider` — `reference/types/Provider.md`
 - `Toolbox` — `reference/types/Toolbox.md`
+- `ToolAnswer` — `reference/types/ToolAnswer.md`
 - `ToolDefinition` — `reference/types/ToolDefinition.md`
 - `claudeApi` — `reference/claudeApi.md`
 - `ClaudeApiConfig` — `reference/types/ClaudeApiConfig.md`
@@ -594,6 +596,7 @@ test('typing writes the value, and the value fills the field', async () => {
 | `bind:checked` | a checkbox, to a boolean |
 | `bind:open` | a `<details>`, to whether it is open |
 | `bind:group` | radios to one value, or checkboxes to an array of their `value`s |
+| `bind:files` | a file input, to an array of the files picked |
 | `bind:value={{get, set}}` | a field to a pair you write, where the value is computed |
 | `bind:prop={state}` | a component's prop, so the child's write reaches your value |
 
@@ -5404,8 +5407,11 @@ const recorded: Provider = {
         const input = { name: 'Ada' }
         yield { type: 'tool', id: 'toolu_1', name }
         yield { type: 'input', id: 'toolu_1', input }
-        const answered = await tools.call(name, input)
-        yield { type: 'result', id: 'toolu_1', ...answered }
+        const { content, failed } = await tools.call(name, input)
+        // A search answers words, so its one piece is text.
+        const [words] = content
+        const text = words?.type === 'text' ? words.text : ''
+        yield { type: 'result', id: 'toolu_1', text, failed }
         yield { type: 'text', text: 'Ada Lovelace is at Analytical Engines.' }
         yield { type: 'done', stop: 'end_turn', usage: { input: 0, output: 0 } }
     },
@@ -5458,11 +5464,13 @@ test('the model calls the CRM search, through the app', async () => {
 
 | Name | What it does for the CRM |
 | --- | --- |
-| `AssistantMessage` | One turn of the transcript, `{ role, content }`. The last is the user's. |
+| `AssistantMessage` | One turn of the transcript, `{ role, content }`. The last is the user's. Its `content` is its words, or its pieces in order. |
+| `AssistantContent` | One piece of a turn: `text`, or an `image` as base64 with its type, so a rep can show the assistant a photo of a business card. PNG, JPEG, GIF and WebP, in the rep's own turns. |
 | `AssistantOptions` | `mcp` to offer the tools, and `maxTurns`, 10 by default, to cap the model's turns in one call. |
 | `AssistantEvent` | What the page reads: `text`, `tool` as a call starts, `input` once it is written, `result`, then `done` with the stop reason and token usage. The same events from every provider. |
-| `Provider` | What runs the conversation: one method, `run`. Write one for another model, or a recording for a test. |
+| `Provider` | What runs the conversation: one method, `run`, handed every turn as its pieces. Write one for another model, or a recording for a test. |
 | `Toolbox` | What a provider is handed: `list` of the tools, and `call` to run one as the asker. |
+| `ToolAnswer` | What `call` answers: its `content`, the same pieces as a turn — the tool's text, or the image a handler drew, which the model is shown as a picture — and whether it failed. |
 | `ToolDefinition` | One tool in `list`: its name, description and input schema. |
 | `abide:assistant` | The log namespace that writes one `debug` line per conversation once it ends: the stop reason, the transcript's length, the tool calls, the tokens and the time. |
 
@@ -5595,7 +5603,12 @@ test('the body is sent as written, with the transcript', async () => {
         max_tokens: 1024,
         system: 'Answer questions about contacts.',
         stream: true,
-        messages: [{ role: 'user', content: 'Which company is Ada at?' }],
+        messages: [
+            {
+                role: 'user',
+                content: [{ type: 'text', text: 'Which company is Ada at?' }],
+            },
+        ],
     })
 })
 ```
@@ -6528,12 +6541,12 @@ abide start
 ABIDE_OFFLINE=0 abide start
 ```
 
-Each page the CRM opens is kept on the device, with the answers its handlers gave, the public files it loaded and the bundle it runs, until `ABIDE_OFFLINE=0` turns that off where the CRM is served. A kept page opens at once, however weak the signal, and the network is asked for the next copy behind it. With the network gone, a page opened in the last week loads again with its data and works. One never opened says the device is offline, and a link to it leaves the page you are on standing.
+Each page the CRM opens is kept on the device, with the answers its handlers gave, the public files it loaded and the bundle it runs, until `ABIDE_OFFLINE=0` turns that off where the CRM is served. A kept page opens at once, however weak the signal, and the network is asked for the next copy behind it. With the network gone, a page opened in the last year loads again with its data and works. One never opened says the device is offline, and a link to it leaves the page you are on standing.
 
 | Name | What it does for the CRM |
 | --- | --- |
-| `cache-control: private, stale-while-revalidate=604800, stale-if-error=604800` | what a page and a handler's answer carry, so the device shows what it kept while it asks again |
-| `cache-control: public, max-age=0, stale-while-revalidate=604800, stale-if-error=604800` | the same, for a public file |
+| `cache-control: private, stale-while-revalidate=604800, stale-if-error=31536000` | what a page and a handler's answer carry, so the device shows what it kept while it asks again |
+| `cache-control: public, max-age=0, stale-while-revalidate=604800, stale-if-error=31536000` | the same, for a public file |
 | `clear-site-data: "cache"` | what a sign-in or a sign-out answers, so the browser forgets what it kept for the last person |
 
 What is kept is what those headers allow, and nothing else decides it. A handler that writes `cache-control: no-store` through `response` is never kept, and an answer with a `ttl` is shown from the device until its `max-age` runs out. A refresh always asks the network.
@@ -6627,10 +6640,12 @@ Arrive here knowing which name you want. Each page is read off the registry: the
 | --- | --- |
 | [`assistant`](/reference/assistant.md) | `@abide/abide/server` |
 | [`AssistantMessage`](/reference/types/AssistantMessage.md) | `@abide/abide/server` |
+| [`AssistantContent`](/reference/types/AssistantContent.md) | `@abide/abide/server` |
 | [`AssistantEvent`](/reference/types/AssistantEvent.md) | `@abide/abide/server` |
 | [`AssistantOptions`](/reference/types/AssistantOptions.md) | `@abide/abide/server` |
 | [`Provider`](/reference/types/Provider.md) | `@abide/abide/server` |
 | [`Toolbox`](/reference/types/Toolbox.md) | `@abide/abide/server` |
+| [`ToolAnswer`](/reference/types/ToolAnswer.md) | `@abide/abide/server` |
 | [`ToolDefinition`](/reference/types/ToolDefinition.md) | `@abide/abide/server` |
 | [`claudeApi`](/reference/claudeApi.md) | `@abide/abide/server` |
 | [`ClaudeApiConfig`](/reference/types/ClaudeApiConfig.md) | `@abide/abide/server` |
@@ -7666,8 +7681,8 @@ Transports: what is written in place rather than imported.
 | `cache-control: no-store` | `/__abide/openapi.json`, `/__abide/mcp` | Refuses caching for an answer about the app's surfaces. | [21.4](/rulebook#21.4) |
 | `cache-control: public, max-age=31536000, immutable` | the built bundle | A chunk addressed by its own content hash. | [21.5](/rulebook#21.5) |
 | `cache-control: public, max-age=0, must-revalidate` | a file under a `public` directory | A file at an address the build never chose. | [21.12](/rulebook#21.12) |
-| `cache-control: private, stale-while-revalidate=604800, stale-if-error=604800` | a page, a `GET`'s answer, where `ABIDE_OFFLINE` registers its worker | The default that lets a copy kept on the device stand in for the network. | [21.22](/rulebook#21.22), [21.11](/rulebook#21.11), [21.17](/rulebook#21.17) |
-| `cache-control: public, max-age=0, stale-while-revalidate=604800, stale-if-error=604800` | a file under a `public` directory, where `ABIDE_OFFLINE` registers its worker | The same, for a file at an address the build never chose. | [21.23](/rulebook#21.23) |
+| `cache-control: private, stale-while-revalidate=604800, stale-if-error=31536000` | a page, a `GET`'s answer, where `ABIDE_OFFLINE` registers its worker | The default that lets a copy kept on the device stand in for the network. | [21.22](/rulebook#21.22), [21.11](/rulebook#21.11), [21.17](/rulebook#21.17) |
+| `cache-control: public, max-age=0, stale-while-revalidate=604800, stale-if-error=31536000` | a file under a `public` directory, where `ABIDE_OFFLINE` registers its worker | The same, for a file at an address the build never chose. | [21.23](/rulebook#21.23) |
 | `clear-site-data: "cache"` | an answer carrying `abide-principal`, where pages are kept offline | Drops what the browser's own cache kept for the caller signed in before. | [21.24](/rulebook#21.24) |
 | `etag` | a file under a `public` directory | The answered bytes, addressed by their content. | [21.13](/rulebook#21.13), [21.14](/rulebook#21.14) |
 | `referrer-policy: strict-origin-when-cross-origin` | a page | The browsers' own default, written down. | [21.6](/rulebook#21.6) |
@@ -7833,7 +7848,7 @@ Generated surfaces: what is written in place rather than imported.
 
 | Name | Signature | Meaning | Rules |
 | --- | --- | --- | --- |
-| `/__abide/mcp` | `POST` | The streamable-http MCP endpoint. | [19.21](/rulebook#19.21), [19.22](/rulebook#19.22), [20.5](/rulebook#20.5), [20.7](/rulebook#20.7), [20.8](/rulebook#20.8), [20.9](/rulebook#20.9), [20.10](/rulebook#20.10), [20.12](/rulebook#20.12), [20.13](/rulebook#20.13), [20.14](/rulebook#20.14), [20.16](/rulebook#20.16), [20.17](/rulebook#20.17), [20.19](/rulebook#20.19), [20.20](/rulebook#20.20), [36.7](/rulebook#36.7), [16.78](/rulebook#16.78) |
+| `/__abide/mcp` | `POST` | The streamable-http MCP endpoint. | [19.21](/rulebook#19.21), [19.22](/rulebook#19.22), [20.5](/rulebook#20.5), [20.7](/rulebook#20.7), [20.8](/rulebook#20.8), [20.9](/rulebook#20.9), [20.10](/rulebook#20.10), [20.12](/rulebook#20.12), [20.13](/rulebook#20.13), [20.14](/rulebook#20.14), [20.16](/rulebook#20.16), [20.17](/rulebook#20.17), [20.19](/rulebook#20.19), [20.20](/rulebook#20.20), [20.21](/rulebook#20.21), [20.22](/rulebook#20.22), [36.7](/rulebook#36.7), [16.78](/rulebook#16.78) |
 
 ## Taught in
 
@@ -7851,7 +7866,7 @@ Generated surfaces: what is written in place rather than imported.
 
 | Name | Signature | Meaning | Rules |
 | --- | --- | --- | --- |
-| `assistant` | `(messages: AssistantMessage[], provider: Provider, options?: AssistantOptions) => AsyncGenerator<AssistantEvent>` | A conversation with a model, as the events it produces. | [44.1](/rulebook#44.1), [44.2](/rulebook#44.2), [44.3](/rulebook#44.3), [44.4](/rulebook#44.4), [44.21](/rulebook#44.21) |
+| `assistant` | `(messages: AssistantMessage[], provider: Provider, options?: AssistantOptions) => AsyncGenerator<AssistantEvent>` | A conversation with a model, as the events it produces. | [44.1](/rulebook#44.1), [44.2](/rulebook#44.2), [44.3](/rulebook#44.3), [44.4](/rulebook#44.4), [44.21](/rulebook#44.21), [44.36](/rulebook#44.36), [44.37](/rulebook#44.37), [44.39](/rulebook#44.39) |
 
 ## Taught in
 
@@ -7869,7 +7884,25 @@ Generated surfaces: what is written in place rather than imported.
 
 | Name | Signature | Meaning | Rules |
 | --- | --- | --- | --- |
-| `AssistantMessage` | `{ role: 'user' \| 'assistant'; content: string }` | One turn of the transcript a caller sends. | [44.3](/rulebook#44.3), [44.4](/rulebook#44.4) |
+| `AssistantMessage` | `{ role: 'user' \| 'assistant'; content: string \| AssistantContent[] }` | One turn of the transcript a caller sends: its words, or its pieces in order. | [44.3](/rulebook#44.3), [44.4](/rulebook#44.4) |
+
+## Taught in
+
+- [Open it to machines](/guide/open-it-to-machines.md)
+
+---
+
+<!-- reference/types/AssistantContent.md -->
+
+# `AssistantContent`
+
+`import type { AssistantContent } from '@abide/abide/server'`
+
+## Assistant
+
+| Name | Signature | Meaning | Rules |
+| --- | --- | --- | --- |
+| `AssistantContent` | `{ type: 'text'; text: string } \| { type: 'image'; data: string; mimeType: string }` | A piece of a turn: words, or an image as base64 with its type. | [44.5](/rulebook#44.5), [44.35](/rulebook#44.35), [44.36](/rulebook#44.36), [44.37](/rulebook#44.37), [44.38](/rulebook#44.38), [44.39](/rulebook#44.39) |
 
 ## Taught in
 
@@ -7923,7 +7956,7 @@ Generated surfaces: what is written in place rather than imported.
 
 | Name | Signature | Meaning | Rules |
 | --- | --- | --- | --- |
-| `Provider` | `{ run(messages: AssistantMessage[], tools: Toolbox, limits: { maxTurns: number; signal: AbortSignal }): AsyncGenerator<AssistantEvent> }` | What runs a conversation. | [44.2](/rulebook#44.2), [44.28](/rulebook#44.28) |
+| `Provider` | `{ run(messages: (AssistantMessage & { content: AssistantContent[] })[], tools: Toolbox, limits: { maxTurns: number; signal: AbortSignal }): AsyncGenerator<AssistantEvent> }` | What runs a conversation. | [44.2](/rulebook#44.2), [44.28](/rulebook#44.28), [44.39](/rulebook#44.39) |
 
 ## Taught in
 
@@ -7941,7 +7974,25 @@ Generated surfaces: what is written in place rather than imported.
 
 | Name | Signature | Meaning | Rules |
 | --- | --- | --- | --- |
-| `Toolbox` | `{ list: ToolDefinition[]; call(name: string, input: unknown): Promise<{ text: string; failed: boolean }> }` | The app's MCP tools, called as the asker. | [44.6](/rulebook#44.6), [44.7](/rulebook#44.7) |
+| `Toolbox` | `{ list: ToolDefinition[]; call(name: string, input: unknown): Promise<ToolAnswer> }` | The app's MCP tools, called as the asker. | [44.6](/rulebook#44.6), [44.7](/rulebook#44.7), [44.35](/rulebook#44.35) |
+
+## Taught in
+
+- [Open it to machines](/guide/open-it-to-machines.md)
+
+---
+
+<!-- reference/types/ToolAnswer.md -->
+
+# `ToolAnswer`
+
+`import type { ToolAnswer } from '@abide/abide/server'`
+
+## Assistant
+
+| Name | Signature | Meaning | Rules |
+| --- | --- | --- | --- |
+| `ToolAnswer` | `{ content: AssistantContent[]; failed: boolean }` | What a tool call answered: its pieces, and whether it failed. | [20.21](/rulebook#20.21), [20.22](/rulebook#20.22), [44.35](/rulebook#44.35) |
 
 ## Taught in
 
@@ -7977,7 +8028,7 @@ Generated surfaces: what is written in place rather than imported.
 
 | Name | Signature | Meaning | Rules |
 | --- | --- | --- | --- |
-| `claudeApi` | `(config: ClaudeApiConfig) => Provider` | The Claude Messages API as a provider. | [44.9](/rulebook#44.9), [44.10](/rulebook#44.10), [44.12](/rulebook#44.12), [44.21](/rulebook#44.21) |
+| `claudeApi` | `(config: ClaudeApiConfig) => Provider` | The Claude Messages API as a provider. | [44.9](/rulebook#44.9), [44.10](/rulebook#44.10), [44.12](/rulebook#44.12), [44.21](/rulebook#44.21), [44.35](/rulebook#44.35), [44.38](/rulebook#44.38) |
 
 ## Taught in
 
@@ -8789,7 +8840,7 @@ Generated surfaces: what is written in place rather than imported.
 
 | Name | Signature | Meaning | Rules |
 | --- | --- | --- | --- |
-| `navigate` | `(url?: URL \| string, options?: { replace?: boolean, keepScroll?: boolean }) => Promise<void>` | Navigates. | [30.7](/rulebook#30.7), [30.9](/rulebook#30.9), [30.10](/rulebook#30.10), [30.11](/rulebook#30.11), [30.12](/rulebook#30.12), [30.13](/rulebook#30.13), [30.14](/rulebook#30.14), [30.15](/rulebook#30.15), [30.16](/rulebook#30.16), [30.17](/rulebook#30.17), [30.18](/rulebook#30.18), [30.20](/rulebook#30.20), [30.21](/rulebook#30.21), [30.22](/rulebook#30.22), [30.23](/rulebook#30.23), [30.24](/rulebook#30.24), [30.25](/rulebook#30.25), [30.27](/rulebook#30.27), [30.29](/rulebook#30.29), [30.30](/rulebook#30.30), [30.31](/rulebook#30.31), [30.32](/rulebook#30.32), [45.12](/rulebook#45.12) |
+| `navigate` | `(url?: URL \| string, options?: { replace?: boolean, keepScroll?: boolean }) => Promise<void>` | Navigates. | [30.7](/rulebook#30.7), [30.9](/rulebook#30.9), [30.10](/rulebook#30.10), [30.11](/rulebook#30.11), [30.12](/rulebook#30.12), [30.13](/rulebook#30.13), [30.14](/rulebook#30.14), [30.15](/rulebook#30.15), [30.16](/rulebook#30.16), [30.17](/rulebook#30.17), [30.18](/rulebook#30.18), [30.20](/rulebook#30.20), [30.21](/rulebook#30.21), [30.22](/rulebook#30.22), [30.23](/rulebook#30.23), [30.24](/rulebook#30.24), [30.25](/rulebook#30.25), [30.27](/rulebook#30.27), [30.29](/rulebook#30.29), [30.30](/rulebook#30.30), [30.31](/rulebook#30.31), [30.32](/rulebook#30.32), [45.12](/rulebook#45.12), [45.24](/rulebook#45.24) |
 
 ## Taught in
 
@@ -8829,11 +8880,12 @@ Generated surfaces: what is written in place rather than imported.
 | `name={expr}` | A reactive attribute or property. | [32.3](/rulebook#32.3), [32.20](/rulebook#32.20), [32.23](/rulebook#32.23), [32.37](/rulebook#32.37), [32.70](/rulebook#32.70), [32.71](/rulebook#32.71) |
 | `on<event>={fn}` | A native listener on an element, and an ordinary prop on a component. | [32.4](/rulebook#32.4) |
 | `name="…{expr}…"` | An interpolated quoted value. | [32.3](/rulebook#32.3), [32.71](/rulebook#32.71) |
-| `bind:value` | Two-way bind on an element. | [5.16](/rulebook#5.16), [32.5](/rulebook#32.5), [32.58](/rulebook#32.58), [32.59](/rulebook#32.59), [32.60](/rulebook#32.60), [32.61](/rulebook#32.61), [32.62](/rulebook#32.62), [32.72](/rulebook#32.72) |
+| `bind:value` | Two-way bind on an element. | [5.16](/rulebook#5.16), [32.5](/rulebook#32.5), [32.58](/rulebook#32.58), [32.59](/rulebook#32.59), [32.60](/rulebook#32.60), [32.61](/rulebook#32.61), [32.62](/rulebook#32.62), [32.72](/rulebook#32.72), [32.74](/rulebook#32.74) |
 | `bind:prop={state}` | Hands a component prop the caller's `Reactive`, or a `{get, set}` pair, to write through. | [32.6](/rulebook#32.6), [33.6](/rulebook#33.6), [33.8](/rulebook#33.8), [14.18](/rulebook#14.18) |
-| `bind:checked` | A boolean bind on an input. | [32.7](/rulebook#32.7), [32.72](/rulebook#32.72) |
-| `bind:open` | The same, on a `<details>`. | [32.7](/rulebook#32.7), [32.72](/rulebook#32.72) |
-| `bind:group` | Radio or checkbox membership. | [32.8](/rulebook#32.8), [32.72](/rulebook#32.72) |
+| `bind:checked` | A boolean bind on an input. | [32.7](/rulebook#32.7), [32.72](/rulebook#32.72), [32.74](/rulebook#32.74) |
+| `bind:open` | The same, on a `<details>`. | [32.7](/rulebook#32.7), [32.72](/rulebook#32.72), [32.74](/rulebook#32.74) |
+| `bind:group` | Radio or checkbox membership. | [32.8](/rulebook#32.8), [32.72](/rulebook#32.72), [32.74](/rulebook#32.74) |
+| `bind:files` | A file input's files, as a list. | [32.73](/rulebook#32.73), [32.72](/rulebook#32.72), [32.74](/rulebook#32.74) |
 | `bind:value={{get, set}}` | Two-way bind over an explicit accessor pair, on an element or a component. | [32.5](/rulebook#32.5), [32.6](/rulebook#32.6) |
 | `bind:element={Reactive<Element> \| ((element: Element) => void \| Disposer)}` | A node reference. | [32.9](/rulebook#32.9), [32.38](/rulebook#32.38), [32.66](/rulebook#32.66), [32.68](/rulebook#32.68), [32.69](/rulebook#32.69) |
 | `class:name={cond}` | Toggles a class. | [32.10](/rulebook#32.10), [32.71](/rulebook#32.71) |
@@ -9043,7 +9095,7 @@ Configuration: what is written in place rather than imported.
 | `ABIDE_MAX_REQUEST_BODY_SIZE` | `number` | The default ceiling on a mutation's body. | [16.13](/rulebook#16.13), [16.54](/rulebook#16.54), [16.55](/rulebook#16.55), [16.78](/rulebook#16.78) |
 | `ABIDE_MAX_SOCKET_MESSAGE_SIZE` | `number` | The ceiling on a frame received over the socket mux, in bytes. | [18.28](/rulebook#18.28) |
 | `ABIDE_MAX_SOCKET_SUBSCRIPTIONS` | `number` | How many values one connection to the socket mux may follow. | [18.31](/rulebook#18.31), [18.32](/rulebook#18.32) |
-| `ABIDE_OFFLINE` | `boolean` | Whether the app keeps its pages and its bundle on the device, for when the network is gone. | [45.1](/rulebook#45.1), [45.2](/rulebook#45.2), [45.3](/rulebook#45.3), [45.4](/rulebook#45.4), [45.5](/rulebook#45.5), [45.6](/rulebook#45.6), [45.7](/rulebook#45.7), [45.8](/rulebook#45.8), [45.9](/rulebook#45.9), [45.10](/rulebook#45.10), [45.11](/rulebook#45.11), [45.12](/rulebook#45.12), [45.13](/rulebook#45.13), [45.14](/rulebook#45.14), [45.15](/rulebook#45.15), [45.16](/rulebook#45.16), [45.17](/rulebook#45.17), [45.18](/rulebook#45.18), [45.19](/rulebook#45.19), [45.20](/rulebook#45.20), [45.21](/rulebook#45.21), [45.22](/rulebook#45.22), [45.23](/rulebook#45.23) |
+| `ABIDE_OFFLINE` | `boolean` | Whether the app keeps its pages and its bundle on the device, for when the network is gone. | [45.1](/rulebook#45.1), [45.2](/rulebook#45.2), [45.3](/rulebook#45.3), [45.4](/rulebook#45.4), [45.5](/rulebook#45.5), [45.6](/rulebook#45.6), [45.7](/rulebook#45.7), [45.8](/rulebook#45.8), [45.9](/rulebook#45.9), [45.10](/rulebook#45.10), [45.11](/rulebook#45.11), [45.12](/rulebook#45.12), [45.13](/rulebook#45.13), [45.14](/rulebook#45.14), [45.15](/rulebook#45.15), [45.16](/rulebook#45.16), [45.17](/rulebook#45.17), [45.18](/rulebook#45.18), [45.19](/rulebook#45.19), [45.20](/rulebook#45.20), [45.21](/rulebook#45.21), [45.22](/rulebook#45.22), [45.23](/rulebook#45.23), [45.24](/rulebook#45.24) |
 | `ABIDE_STOP_TIMEOUT` | `number` | How long `App.stop` drains, in ms. | [42.17](/rulebook#42.17), [42.18](/rulebook#42.18) |
 | `ABIDE_MAX_STREAM_BUFFER_SIZE` | `number` | The cap on a stream transcript held in memory. | [36.18](/rulebook#36.18) |
 | `ABIDE_MAX_LOG_BUFFER_COUNT` | `number` | How many lines `log.records` is trimmed back to. | [28.1](/rulebook#28.1) |

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@abide/abide",
-    "version": "0.115.0",
+    "version": "0.116.1",
     "type": "module",
     "description": "Isomorphic type-safe framework for reactive async interfaces for humans and machines",
     "license": "MIT",

package/src/compiler/classifyTemplate.ts

@@ -84,10 +84,10 @@ export type ClassifiedAttribute = {
     // 32.11 — a spread's attributes, less the ones the element names itself, kept written by a
     // binding of its own.
     | { kind: 'spread'; explicit: string[] }
-    // 32.5, 32.7, 32.8 — the property and the value, kept in step both ways. `reflects` is the
-    // attribute the property's value stands at in the tag, and `undefined` where it is not an
+    // 32.5, 32.7, 32.8, 32.73 — the property and the value, kept in step both ways. `reflects` is
+    // the attribute the property's value stands at in the tag, and `undefined` where it is not an
     // attribute: a `<textarea>`'s value is its text and a `<select>`'s is its options' `selected`,
-    // which the markup writes inside the tag (32.61).
+    // which the markup writes inside the tag (32.61), and a file input's files are no markup at all.
     | {
           kind: 'bound'
           bind: ValueBind
@@ -135,7 +135,7 @@ export function classifyAttributes(
         readsAnItem(holder: object): boolean
     },
 ): ClassifiedAttribute[] {
-    refuseTwoOwners(node)
+    refuseBinds(node)
     const groups = mergeGroupsOf(node)
     const sharing: ReturnType<typeof sharingOf>[] = []
     for (const group of groups) sharing.push(sharingOf(group, lowering))
@@ -210,7 +210,8 @@ export function classifyAttributes(
                 kind: 'bound',
                 bind,
                 reflects:
-                    bind === 'value' && node.lowerTag !== 'input'
+                    bind === 'files' ||
+                    (bind === 'value' && node.lowerTag !== 'input')
                         ? undefined
                         : bind === 'group'
                           ? 'checked'
@@ -354,15 +355,22 @@ function heldClasses(groups: MergeGroup[]): string[] {
 }
 
 /**
+ * 32.74 — A `bind:` AN ELEMENT HAS NO PROPERTY FOR IS REFUSED: `bind:vlaue` would otherwise be an
+ * attribute of that name, binding nothing and saying nothing.
+ *
  * 32.72 — WHAT A `bind:` WRITES IS THE BIND'S ALONE: `checked` beside `bind:checked` or
  * `bind:group`, `value` beside `bind:value`, any `bind:name` beside `name` — and an
  * `<option selected>` inside a `<select bind:value>`, and a `<textarea bind:value>`'s text. Two
  * owners of one value render whichever the browser keeps and move with whichever wrote last.
  */
-function refuseTwoOwners(node: ElementNode): void {
+function refuseBinds(node: ElementNode): void {
     for (const attribute of node.attributes) {
         const lower = attribute.lowerName
         if (!lower.startsWith('bind:') || lower === 'bind:element') continue
+        if (valueBindOf(lower) === undefined)
+            throw new Error(
+                `abide: <${node.tag}> has ${attribute.name}, which binds nothing — an element binds ${VALUE_BINDS.join(', ')} or element. RULEBOOK 32.74.`,
+            )
         const owned =
             lower === 'bind:group' ? 'checked' : lower.slice('bind:'.length)
         const beside = attributeOf(node, owned)
@@ -468,18 +476,17 @@ function isElementBind(lowerName: string): boolean {
 /**
  * The binds that keep a property and a value in step.
  *
- * 32.5, 32.7, 32.8 — both emitters ask: the server writes the value into the tag and the client
- * binds the property.
+ * 32.5, 32.7, 32.8, 32.73 — both emitters ask: the server writes the value into the tag, where it
+ * has one, and the client binds the property.
  */
-type ValueBind = 'value' | 'checked' | 'open' | 'group'
+const VALUE_BINDS = ['value', 'checked', 'open', 'group', 'files'] as const
+type ValueBind = (typeof VALUE_BINDS)[number]
 
 /** The value bind a folded attribute name is, or `undefined` for any other attribute. */
 function valueBindOf(lowerName: string): ValueBind | undefined {
-    if (lowerName === 'bind:value') return 'value'
-    if (lowerName === 'bind:checked') return 'checked'
-    if (lowerName === 'bind:open') return 'open'
-    if (lowerName === 'bind:group') return 'group'
-    return undefined
+    if (!lowerName.startsWith('bind:')) return undefined
+    const bind = lowerName.slice('bind:'.length) as ValueBind
+    return VALUE_BINDS.includes(bind) ? bind : undefined
 }
 
 /**

package/src/compiler/emitClient.ts

@@ -769,7 +769,7 @@ function elementUnits(
             handlers.push(
                 `${element}.addEventListener(${JSON.stringify(one.event)}, ${lowering.listener(one.attribute)})`,
             )
-        // 32.5, 32.7, 32.8 — THE PROPERTY AND THE VALUE, IN STEP BOTH WAYS: a watch on this
+        // 32.5, 32.7, 32.8, 32.73 — THE PROPERTY AND THE VALUE, IN STEP BOTH WAYS: a watch on this
         // region's scope writes the property, and a listener writes it back.
         // 32.8 — a group compares against the input's own value, read where the value is.
         else if (one.kind === 'bound' && one.bind === 'group')
@@ -782,6 +782,10 @@ function elementUnits(
                           : JSON.stringify(one.own.value)
                 }), ${SCOPE})`,
             )
+        else if (one.kind === 'bound' && one.bind === 'files')
+            binds.push(
+                `${lowering.use('bindFiles')}(${element}, ${lowering.reference(one.attribute)}, ${SCOPE})`,
+            )
         else if (one.kind === 'bound')
             binds.push(
                 `${lowering.use('bindProperty')}(${element}, ${JSON.stringify(one.bind)}, ${lowering.reference(one.attribute)}, ${SCOPE})`,

package/src/server/BRIDGE_VERSION.ts

@@ -1,3 +1,3 @@
 // The `abide-bridge` release a pairing command names, so a visitor's `bunx` runs the relay this
 // server speaks. `packages/abide/tests/claudeCode.test.ts` holds it to the bridge package's own.
-export const BRIDGE_VERSION = '0.3.3'
+export const BRIDGE_VERSION = '0.3.4'

package/src/server/IMAGE_TYPES.ts

@@ -0,0 +1,10 @@
+/**
+ * The image types a model is shown (44.36). A leaf, because `assistant` refuses a transcript image of
+ * any other and `/__abide/mcp` answers one of any other as its text (20.21).
+ */
+export const IMAGE_TYPES = new Set([
+    'image/png',
+    'image/jpeg',
+    'image/gif',
+    'image/webp',
+])

package/src/server/OFFLINE_STALE.ts

@@ -1,10 +1,11 @@
 // 21.22, 21.23 — HOW LONG A COPY KEPT ON THE DEVICE STAYS SERVABLE once stale, where `ABIDE_OFFLINE`
-// registers its worker: a week, while the network answers or fails to — as long as Safari keeps an
-// unvisited site's storage.
+// registers its worker: a week while the network answers and the copy is asked for again behind it,
+// and a year where the network fails — a copy of any age beats the page saying nothing was saved, and
+// what may evict it sooner (Safari's week for a site not visited) is the browser's, not this header's.
 //
 // NO `max-age` BESIDE IT on a page or a `GET`: a copy reads `max-age` as its own life (18.14), and
 // a followed copy stale from the moment it landed would reload on every read. With no lifetime and
 // no `Last-Modified`, a cache holds the answer stale at once, which is all the two windows need.
 
 export const OFFLINE_STALE =
-    'stale-while-revalidate=604800, stale-if-error=604800'
+    'stale-while-revalidate=604800, stale-if-error=31536000'