@byokit/ui 0.7.0 → 0.9.0

package/CHANGELOG.md

@@ -2,6 +2,28 @@
 
 ## Unreleased
 
+- Dependency update: pins @byokit/accounts 0.24.3.
+
+## 0.9.0 (2026-10-17)
+
+- Dependency update: pins @byokit/accounts 0.24.2.
+
+- FEAT: The key card has a `workspace` state (`result: 'workspace'`, words "This key works for more than one
+  workspace. Pick the one to use."), so an app shows the workspace pick for a plan key that acts for several
+  workspaces (OpenCode Go) and submits again with the one picked.
+
+- Dependency update: pins @byokit/accounts 0.24.1.
+
+## 0.8.0 (2026-10-16)
+
+- Dependency update: pins @byokit/accounts 0.24.0.
+
+- FEAT: `accountRows(accounts, room, now, windows?)` and `AccountsSource.windows` take an account's `windowsView` from `@byokit/usage/view`: a ready row gains `windows` (each usage window, tightest first, with its line, its reset line and its millisecond reset) and `asOf` (`Read 2 minutes ago`, `Read 2 days ago (stale)` past a day). A window whose reset is already past reads `Session: reset since this reading` (no percent, no countdown), and so does the row's room line (`Plus · Reset since this reading`). A stale row is never `low`, and a reading without its own time (an openclaw room) shows its resets and no age. New types `UsageWindow`, `UsageWindows` and `AsOf`. The PWA example's account card draws both windows with their resets and age, keeps the last reading when a refresh fails so it shows as stale instead of unknown, and fits the longest address at 320px with larger text.
+- FEAT: `runStore` tolerates an account run's first frame: the run stream may open with an `account` event (O14m) naming the account the reply bills to, which the run view ignores while the reply, tools and end behave as before.
+- FIX: a subscription row whose route name already says plan ("Qwen Token Plan", "Qwen Token Plan CN", "Qwen Token Plan Individual") no longer reads "Uses your ... plan" with the word twice: `connectView` leaves the template's trailing plan out when the name already carries the word (any case). Names without it ("Qwen") still read "Uses your Qwen plan".
+
+- Dependency update: pins @byokit/accounts 0.23.0.
+
 ## 0.7.0 (2026-10-12)
 
 - Dependency update: pins @byokit/accounts 0.22.0.

package/README.md

@@ -123,9 +123,9 @@ export function useChatGptSheet() {
 | `useRun`, `useApprovals`, `useHerdrTree`, `useBlocked` | React hooks over those stores |
 | `connectView(routes, step?)`, `connectStep(step, action)` | Every account route the kits list, grouped by how the person pays, with the picked row and its key card |
 | `signInFor(view, { read, start?, cancel })`, `useConnect({ routes, read, start?, cancel })` | `useSignIn`'s options for the picked sign-in row; the hook holds the step |
-| `accountRows(accounts, room, now)`, `rowsOf(source, now)`, `nameSuggestions(email, taken, provider?)` | One plain-words row per account (`ChatGPT · Work` / `Plus · 72% left this week`), the honest words for every sign-in state, and untaken account-name suggestions |
+| `accountRows(accounts, room, now, windows?)`, `rowsOf(source, now)`, `nameSuggestions(email, taken, provider?)` | One plain-words row per account (`ChatGPT · Work` / `Plus · 72% left this week`), the honest words for every sign-in state, and untaken account-name suggestions |
 | `useAccounts(source)`, `useModelPicker(source, initial?)` | React hooks: the rows live with `refresh()` and `remove()` (a failing room leaves only its row unknown; a mid-refresh remove still drops it), and the run picker with `select()` keeping the caller's selection across refreshes; `accountsSource(accounts, member, room?)` and `cliSource(cli, room?)` fill the source with one line per member (the openclaw adapter stays pending O14) |
-| Types | `Phase`, `SignInView`, `AccountView`, `UseSignIn`, `Route`, `RouteChoice`, `RouteCode`, `PairPhase`, `Role`, `DeviceKind`, `LinkStatus`; `RouteKind` from `@byokit/ui/route`; `Account`, `AccountRow`, `AccountAction`, `AccountsSource`, `Billing`, `Room`, `RoomSpan`, `SignInState` from `@byokit/ui/accounts` |
+| Types | `Phase`, `SignInView`, `AccountView`, `UseSignIn`, `Route`, `RouteChoice`, `RouteCode`, `PairPhase`, `Role`, `DeviceKind`, `LinkStatus`; `RouteKind` from `@byokit/ui/route`; `Account`, `AccountRow`, `AccountAction`, `AccountsSource`, `AsOf`, `Billing`, `Room`, `RoomSpan`, `SignInState`, `UsageWindow`, `UsageWindows` from `@byokit/ui/accounts` |
 
 Entry points: `@byokit/ui` (everything, including the React hooks), `@byokit/ui/phase`,
 `@byokit/ui/route`, `@byokit/ui/link`, `@byokit/ui/kits`, `@byokit/ui/steps`,
@@ -208,13 +208,15 @@ const options = signInFor(view, { read: (row) => api.account(row.id), start: (ro
 ```
 
 A key route's `chosen.key` is the existing `keyView` card, labelled for its billing ("Key from your plan" or "Key
-(charged per use)"); submit the input straight to the kit and dispatch only `{ type: 'result', result }`.
+(charged per use)"); submit the input straight to the kit and dispatch only `{ type: 'result', result }`. A key
+that acts for several workspaces (`@byokit/accounts` `add` answers `workspaces`) dispatches `result: 'workspace'`:
+list those workspaces, then `submit` again with the one picked.
 `useConnect({ routes, read, start?, cancel })` holds the step in React and returns the view with `pick`, `back`,
 `act` and `signIn`, the options to pass to `useSignIn` in a sheet keyed by `chosen.row.key`.
 
 ## Account rows
 
-`accountRows(accounts, room, now)` (also `@byokit/ui/accounts`, no React) turns a list of accounts and a room reading
+`accountRows(accounts, room, now, windows?)` (also `@byokit/ui/accounts`, no React) turns a list of accounts and a room reading
 into one plain row each: the provider and the person's own name for the account (`ChatGPT · Work`), then the plan and
 the room left (`Plus · 72% left this week`). A row also carries `state`, `billing`, `low` (room left at or below 20%,
 exactly 20 included, never true for an unknown room) and, when it helps, an `action`: `sign_in` for a signed-out or
@@ -222,8 +224,14 @@ lapsed account, `wait` plus the `until` refill time for a resting one. `accountR
 so a credential on an account never reaches a row. A row that is not ready shows its own honest words ("Checking…",
 "Cooling down", "Not signed in", "Sign in again", "Not in your plan") instead of the room.
 
-`AccountsSource` is the shape an app fills from its own back end — `accounts()` and `room(account)` — and `rowsOf(source, now)`
-awaits both and builds the same rows; `@byokit/accounts` `list()` and a room reading fit it with one line per member.
+Pass `windows`, the account's `windowsView(reading, now)` from `@byokit/usage/view`, as a fourth argument and a ready
+row also carries `windows` (each usage window, tightest first: `Week: 72% left` with `resets in 4d`) and `asOf`
+(`Read 2 minutes ago`, or `Read 2 days ago (stale)` past a day). A window whose reset is already past reads
+`Session: reset since this reading`, with no percent or countdown, and the room line `Reset since this reading`. A stale row is never `low`; a reading without its own
+time, such as an openclaw room, shows its resets and no `asOf`, never a made-up age.
+
+`AccountsSource` is the shape an app fills from its own back end — `accounts()`, `room(account)` and optionally
+`windows(account)` — and `rowsOf(source, now)` awaits them and builds the same rows; `@byokit/accounts` `list()` and a room reading fit it with one line per member.
 `nameSuggestions(email, taken, provider?)` offers up to three untaken account names from an email's local part
 (deduped case-insensitively against `taken`), falling back to the provider's name; the email itself is never offered.
 
@@ -326,7 +334,7 @@ Runtime kits' state, from `@byokit/ui/kits` (no React), typed to fit `@byokit/op
 
 - Runs: `runStore(oc)` with `send(message)` and `stop()`; `runView(state, { words, name })` gives the reply so far, the
   tool at work and, for a failed run, the kit's sentence (`words` from `@byokit/openclaw/device`, `name` "ChatGPT").
-  OpenClaw's `started` and `thinking` frames are accepted without changing the reply, tools or rendered state;
+  OpenClaw's `started`, `thinking` and `account` frames are accepted without changing the reply, tools or rendered state;
   the running phase begins at `send`, not Gateway acceptance.
 - Approvals: `approvalsStore(oc)` keeps the waiting list live (each leaves when answered anywhere or when it expires);
   `approvalWords(approval, words, 'Your helper')` asks the question.
@@ -357,7 +365,7 @@ with the device client made once (`useMemo(() => herdrDevice(link), [link])`).
 Apache-2.0. See [LICENSE](LICENSE) and [NOTICE](../../NOTICE).
 
 `@byokit/ui/kits` also exports `keyStep(state, action)` and `keyView(state, words)` for an explicit
-**API key (billed per use)** entry card. States are `entry`, `checking`, `ok`, `invalid`, `not_included`;
+**API key (billed per use)** entry card. States are `entry`, `checking`, `workspace`, `ok`, `invalid`, `not_included`;
 actions are `submit`, `edit`, and `result` with the kit's add-key outcome. Supply the OpenClaw kit's `words`
 function for the label and sentences. These views never contain the entered key; submit it directly to the host
 and clear the input afterwards.

package/dist/accounts.d.ts

@@ -27,6 +27,33 @@ export type Account = {
 export type AccountsSource = {
     accounts: () => Promise<readonly Account[]> | readonly Account[];
     room: (account: Account) => Promise<Room> | Room;
+    /** The account's `windowsView`, when the app keeps its usage reading. */
+    windows?: (account: Account) => Promise<UsageWindows | undefined> | UsageWindows | undefined;
+};
+/** One usage window, restated structurally from `@byokit/usage/view` `windowsView`: its line (`Week: 58% left`), its
+ *  reset line (`resets in 4h 40m`) and the unchanged millisecond reset. */
+export type UsageWindow = {
+    kind: 'session' | 'weekly' | 'monthly' | 'rolling' | 'custom';
+    text: string;
+    resetText: string;
+    resetsAt?: number;
+    usedPercent?: number;
+    limited?: boolean;
+};
+/** An account's `windowsView(reading, now)`, restated structurally; only these fields are read. */
+export type UsageWindows = {
+    windows: readonly UsageWindow[];
+    at?: number;
+    ageMs?: number;
+    ageText?: string;
+    stale: boolean;
+};
+/** How old a row's windows are, taken only from the reading's own time: `Read 2 minutes ago`, with `(stale)` past a day. */
+export type AsOf = {
+    at: number;
+    ageMs: number;
+    text: string;
+    stale: boolean;
 };
 export type AccountAction = 'sign_in' | 'wait';
 export type AccountRow = {
@@ -35,16 +62,24 @@ export type AccountRow = {
     detail: string;
     state: SignInState;
     billing: Billing;
-    /** Room left is at or below 20%: true at exactly 20, false above it or when the room is unknown. */
+    /** Room left is at or below 20%: true at exactly 20, false above it, when the room is unknown or the windows are stale. */
     low: boolean;
+    /** A ready account's usage windows, tightest first, each with its reset; one that reset since the reading reads
+     *  `Session: reset since this reading`, with an empty `resetText` and no `usedPercent`. Present when the app passed them. */
+    windows?: UsageWindow[];
+    /** The windows' age; absent when the reading carries no time of its own (never a made-up one) or a future one. */
+    asOf?: AsOf;
     /** What the person can do: sign in again, or wait for a resting account to refill. Absent when nothing helps. */
     action?: AccountAction;
     /** A resting account's next refill, epoch milliseconds. */
     until?: number;
 };
-/** One row per account, reading one room per account; a missing or throwing reading is 'Room left unknown'. */
-export declare function accountRows(accounts: readonly Account[], room: (account: Account) => Room, now: number): AccountRow[];
-/** `accountRows` over an `AccountsSource`: the app's own `accounts()` and `room()`, awaited; a failing room reads unknown. */
+/** One row per account, reading one room per account; a missing or throwing reading is 'Room left unknown'. `windows`
+ *  is the account's `windowsView` from `@byokit/usage/view`, when the app keeps the reading; a missing or throwing one
+ *  leaves the row without windows. */
+export declare function accountRows(accounts: readonly Account[], room: (account: Account) => Room, now: number, windows?: (account: Account) => UsageWindows | undefined): AccountRow[];
+/** `accountRows` over an `AccountsSource`: the app's own `accounts()`, `room()` and `windows()`, awaited; a failing room
+ *  reads unknown and failing windows leave the row without them. */
 export declare function rowsOf(source: AccountsSource, now: number): Promise<AccountRow[]>;
 /** Untaken names an app can offer for a new account, from the email's local part (never the email itself), else the
  *  provider's name. Dedupes case-insensitively against `taken`; up to three. */

package/dist/accounts.js

@@ -15,13 +15,30 @@ function titleOf(a) {
 }
 /** A resting account whose refill time has passed reads as ready again, exactly as the Auto chooser treats it. */
 const refilled = (a, now) => a.state === 'resting' && typeof a.until === 'number' && a.until <= now;
-function rowOf(a, room, now) {
+/** A reset at or before now happened after the reading, so its numbers no longer hold. */
+const resetSince = (resetsAt, now) => typeof resetsAt === 'number' && resetsAt <= now;
+/** Only the named fields, so nothing else on the app's view (a scope, a provider) reaches a row. A window that reset
+ *  since the reading says so, with no percent and no countdown. */
+const windowOf = (x, now) => resetSince(x.resetsAt, now)
+    ? { kind: x.kind, text: WORDS['account.window.resetSince'].replace('{label}', WORDS[`account.window.${x.kind}`]), resetText: '', resetsAt: x.resetsAt }
+    : { kind: x.kind, text: x.text, resetText: x.resetText, ...(typeof x.resetsAt === 'number' ? { resetsAt: x.resetsAt } : {}),
+        ...(typeof x.usedPercent === 'number' ? { usedPercent: x.usedPercent } : {}), ...(x.limited ? { limited: true } : {}) };
+function asOfOf(w) {
+    if (typeof w.at !== 'number' || typeof w.ageMs !== 'number' || !w.ageText)
+        return undefined;
+    return { at: w.at, ageMs: w.ageMs, text: w.stale ? WORDS['account.stale'].replace('{age}', w.ageText) : w.ageText, stale: w.stale };
+}
+function rowOf(a, room, now, w) {
     const state = refilled(a, now) ? 'ready' : a.state;
     const title = titleOf(a);
     if (state === 'ready') {
-        const words = roomWords(room);
+        // A room whose window reset since the reading no longer holds its number: say so, and it is not low.
+        const reset = room.left !== 'unknown' && resetSince(room.resetsAt, now);
+        const words = reset ? WORDS['account.room.resetSince'] : roomWords(room);
+        const asOf = w && asOfOf(w);
         return { id: a.id, title, detail: a.plan && room.left !== 'unknown' ? `${planLabel(a.plan)} · ${words}` : words, state, billing: a.billing,
-            low: room.left !== 'unknown' && room.left <= LOW_AT };
+            low: room.left !== 'unknown' && room.left <= LOW_AT && !w?.stale && !reset,
+            ...(w ? { windows: w.windows.map((x) => windowOf(x, now)) } : {}), ...(asOf ? { asOf } : {}) };
     }
     if (state === 'resting') {
         return { id: a.id, title, detail: WORDS['account.resting'], state, billing: a.billing, low: false, action: 'wait',
@@ -30,8 +47,10 @@ function rowOf(a, room, now) {
     const action = state === 'signed_out' || state === 'needs_again' ? 'sign_in' : undefined;
     return { id: a.id, title, detail: WORDS[`account.${state}`], state, billing: a.billing, low: false, ...(action ? { action } : {}) };
 }
-/** One row per account, reading one room per account; a missing or throwing reading is 'Room left unknown'. */
-export function accountRows(accounts, room, now) {
+/** One row per account, reading one room per account; a missing or throwing reading is 'Room left unknown'. `windows`
+ *  is the account's `windowsView` from `@byokit/usage/view`, when the app keeps the reading; a missing or throwing one
+ *  leaves the row without windows. */
+export function accountRows(accounts, room, now, windows) {
     return accounts.map((a) => {
         let r = UNKNOWN;
         try {
@@ -40,13 +59,22 @@ export function accountRows(accounts, room, now) {
         catch {
             r = UNKNOWN;
         }
-        return rowOf(a, r, now);
+        let w;
+        try {
+            w = windows?.(a);
+        }
+        catch {
+            w = undefined;
+        }
+        return rowOf(a, r, now, w);
     });
 }
-/** `accountRows` over an `AccountsSource`: the app's own `accounts()` and `room()`, awaited; a failing room reads unknown. */
+/** `accountRows` over an `AccountsSource`: the app's own `accounts()`, `room()` and `windows()`, awaited; a failing room
+ *  reads unknown and failing windows leave the row without them. */
 export async function rowsOf(source, now) {
     const accounts = await source.accounts();
     const rooms = new Map();
+    const windows = new Map();
     for (const a of accounts) {
         try {
             rooms.set(a.id, (await source.room(a)) ?? UNKNOWN);
@@ -54,8 +82,14 @@ export async function rowsOf(source, now) {
         catch {
             rooms.set(a.id, UNKNOWN);
         }
+        try {
+            windows.set(a.id, await source.windows?.(a));
+        }
+        catch {
+            windows.set(a.id, undefined);
+        }
     }
-    return accountRows(accounts, (a) => rooms.get(a.id) ?? UNKNOWN, now);
+    return accountRows(accounts, (a) => rooms.get(a.id) ?? UNKNOWN, now, (a) => windows.get(a.id));
 }
 /** Untaken names an app can offer for a new account, from the email's local part (never the email itself), else the
  *  provider's name. Dedupes case-insensitively against `taken`; up to three. */

package/dist/approvals.d.ts

@@ -27,7 +27,7 @@ export type ApprovalsAction = ApprovalFrame | {
 };
 export declare function approvalsStep(list: Approval[], a: ApprovalsAction): Approval[];
 /** The question for one approval, in the kit's own sentence (`@byokit/openclaw/device`'s `words` fits). */
-export declare const approvalWords: (a: Approval, words: (key: "approval.ask", vars: {
+export declare const approvalWords: (a: Approval, words: (key: 'approval.ask', vars: {
     helper: string;
     summary: string;
 }) => string, helper: string) => string;

package/dist/approvals.js

@@ -1,6 +1,6 @@
 // What is waiting for a person's yes: the approvals list kept current from the kit's event stream, each dropped when
 // it is answered anywhere or runs out of time. Framework-free; typed structurally against `@byokit/openclaw/device`.
-import { retrying, store } from "./follow.js";
+import { retrying, store } from './follow.js';
 export function approvalsStep(list, a) {
     if ('type' in a) {
         if (a.type === 'set')

package/dist/browser.js

@@ -2,7 +2,7 @@
 // the chip under the chat. Framework-free; typed structurally against `@byokit/openclaw`'s `NeedSignIn` and
 // `LiveViewState` (spec 5.17), so nothing here imports a kit. Sentences are the kit's word keys plus their values,
 // for the kit's own `words` to say. Nothing here ever holds what the person types.
-import { retrying, store } from "./follow.js";
+import { retrying, store } from './follow.js';
 const settledLine = (s) => {
     switch (s.state) {
         case 'verified':

package/dist/connect.js

@@ -3,7 +3,7 @@
 // offered by default; every other row is listed and used only when the person picks it. Nothing here names a
 // provider: groups and words come from each row's billing, method and readiness alone. Framework-free.
 import WORDS from './words.json' with { type: 'json' };
-import { keyStep, keyView } from "./key.js";
+import { keyStep, keyView } from './key.js';
 const ORDER = ['plans', 'perUse', 'local', 'server', 'cloud', 'other', 'services'];
 const SIGNIN = ['browser', 'code', 'paste', 'session', 'cli'];
 const KEY = ['key', 'plan_key', 'setup_token'];
@@ -34,13 +34,16 @@ function rowOf(r, w) {
     const group = groupOf(r);
     const ready = r.readiness === 'ready';
     const billing = r.via === 'endpoint' ? w['billing.server'] : r.via === 'local' ? w['billing.local'] : w[`billing.${r.billing}`];
+    // A route name can already carry the word the subscription line adds ("Qwen Token Plan CN"):
+    // then leave it out, so the row never reads "... Plan ... plan".
+    const line = r.billing === 'subscription' && /\bplan\b/i.test(name) ? billing.replace(/(\{name\})\s+plan\b/i, '$1') : billing;
     return {
         key: `${r.upstream?.surface ?? ''}/${id}`, id, provider: r.provider,
         ...(r.upstream ? { surface: r.upstream.surface } : {}),
         name, company, via: r.via, billing: r.billing, group,
         offered: group === 'plans' && ready, ready, readiness: r.readiness,
         does: !ready ? 'unavailable' : SIGNIN.includes(r.via) ? 'signin' : KEY.includes(r.via) ? 'key' : 'setup',
-        billingWords: fill(billing, { name, company }), method: w[`via.${r.via}`], status: w[`ready.${r.readiness}`],
+        billingWords: fill(line, { name, company }), method: w[`via.${r.via}`], status: w[`ready.${r.readiness}`],
     };
 }
 export function connectStep(step, action) {

package/dist/herdr.d.ts

@@ -1,5 +1,5 @@
 import { type Store } from './follow.ts';
-export type AgentStatus = 'idle' | 'working' | 'blocked' | 'done' | 'unknown';
+export type AgentStatus = 'idle' | 'working' | 'blocked' | 'done' | 'failed' | 'unknown';
 export type HerdrAgent = {
     kind?: string;
     name?: string;
@@ -79,7 +79,6 @@ export declare function herdrTreeView(tree: HerdrTree | null): {
 export declare function agentIn(tree: HerdrTree | null, paneId: string | undefined): AgentRow | undefined;
 /** The waiting agents, each with the name to show for it. */
 export declare const blockedView: (s: HerdrState) => {
-    name: string;
     paneId: string;
     workspaceId: string;
     tabId: string;
@@ -87,6 +86,7 @@ export declare const blockedView: (s: HerdrState) => {
     revision: number;
     prompt: string;
     since: number;
+    name: string;
 }[];
 /** What `herdrStore` needs from a device client: `herdrDevice(link)` fits. */
 export type HerdrSource = {

package/dist/herdr.js

@@ -1,7 +1,7 @@
 // Herdr's agents as a person sees them: the tree (where each agent is, and how it is doing) and the agents waiting
 // for an answer, kept current from one `hd.events` stream. Framework-free; typed structurally against
 // `@byokit/herdr/device`, so nothing here imports the kit.
-import { retrying, store } from "./follow.js";
+import { retrying, store } from './follow.js';
 export const HERDR_EMPTY = { tree: null, blocked: [] };
 export function herdrStep(s, a) {
     if (a.type === 'snapshot') {

package/dist/index.d.ts

@@ -7,5 +7,5 @@ export * from './kits.ts';
 export { useApprovals, useBlocked, useHerdrTree, useRun } from './useKits.ts';
 export { connectStep, connectView, signInFor, type ConnectAction, type ConnectDoes, type ConnectGroup, type ConnectGroupId, type ConnectRoute, type ConnectRow, type ConnectStep, type ConnectView, type ConnectWords, type UseConnectSignIn } from './connect.ts';
 export { useConnect, type UseConnect } from './useConnect.ts';
-export { accountRows, nameSuggestions, rowsOf, type Account, type AccountAction, type AccountRow, type AccountsSource, type Billing, type Room, type RoomSpan, type SignInState } from './accounts.ts';
+export { accountRows, nameSuggestions, rowsOf, type Account, type AccountAction, type AccountRow, type AccountsSource, type AsOf, type Billing, type Room, type RoomSpan, type SignInState, type UsageWindow, type UsageWindows } from './accounts.ts';
 export { accountsSource, cliSource, useAccounts, useModelPicker, type AccountHooksSource, type CliAccounts, type MemberAccounts, type ModelPickerSource, type UseAccounts, type UseModelPicker } from './useAccounts.ts';

package/dist/index.js

@@ -1,11 +1,11 @@
-export { phaseOf, stepOf } from "./phase.js";
-export { connectedWords, describeRoute, routeChoices, routeShort } from "./route.js";
-export { useSignIn } from "./useSignIn.js";
-export { stepsText, stepsView } from "./steps.js";
-export { consentWords, linkWords, pairErrorWords, pairingView, qrMatrix, qrText } from "./link.js";
-export * from "./kits.js";
-export { useApprovals, useBlocked, useHerdrTree, useRun } from "./useKits.js";
-export { connectStep, connectView, signInFor } from "./connect.js";
-export { useConnect } from "./useConnect.js";
-export { accountRows, nameSuggestions, rowsOf } from "./accounts.js";
-export { accountsSource, cliSource, useAccounts, useModelPicker } from "./useAccounts.js";
+export { phaseOf, stepOf } from './phase.js';
+export { connectedWords, describeRoute, routeChoices, routeShort } from './route.js';
+export { useSignIn } from './useSignIn.js';
+export { stepsText, stepsView } from './steps.js';
+export { consentWords, linkWords, pairErrorWords, pairingView, qrMatrix, qrText } from './link.js';
+export * from './kits.js';
+export { useApprovals, useBlocked, useHerdrTree, useRun } from './useKits.js';
+export { connectStep, connectView, signInFor } from './connect.js';
+export { useConnect } from './useConnect.js';
+export { accountRows, nameSuggestions, rowsOf } from './accounts.js';
+export { accountsSource, cliSource, useAccounts, useModelPicker } from './useAccounts.js';

package/dist/key.d.ts

@@ -1,14 +1,16 @@
-/** A key-entry card never holds a credential: the host submits the input directly to kit.addKey. */
-export type KeyState = 'entry' | 'checking' | 'ok' | 'invalid' | 'not_included';
+/** A key-entry card never holds a credential: the host submits the input directly to kit.addKey.
+ *  `workspace`: the key acts for several workspaces and nothing is saved yet; the host lists the kit's workspaces
+ *  and submits again with the one picked. */
+export type KeyState = 'entry' | 'checking' | 'workspace' | 'ok' | 'invalid' | 'not_included';
 export type KeyAction = {
     type: 'submit';
 } | {
     type: 'edit';
 } | {
     type: 'result';
-    result: 'ok' | 'invalid' | 'not_included';
+    result: 'workspace' | 'ok' | 'invalid' | 'not_included';
 };
-export type KeyWords = (key: 'key.label' | 'key.entry' | 'key.checking' | 'key.ok' | 'key.invalid' | 'key.notIncluded') => string;
+export type KeyWords = (key: 'key.label' | 'key.entry' | 'key.checking' | 'key.workspace' | 'key.ok' | 'key.invalid' | 'key.notIncluded') => string;
 export declare function keyStep(state: KeyState, action: KeyAction): KeyState;
 export declare function keyView(state: KeyState, words: KeyWords): {
     state: KeyState;

package/dist/key.js

@@ -6,7 +6,7 @@ export function keyStep(state, action) {
     return state === 'checking' ? action.result : state;
 }
 export function keyView(state, words) {
-    const keys = { entry: 'key.entry', checking: 'key.checking', ok: 'key.ok', invalid: 'key.invalid', not_included: 'key.notIncluded' };
+    const keys = { entry: 'key.entry', checking: 'key.checking', workspace: 'key.workspace', ok: 'key.ok', invalid: 'key.invalid', not_included: 'key.notIncluded' };
     return { state, label: words('key.label'), message: words(keys[state]), busy: state === 'checking',
         editable: state === 'entry' || state === 'invalid' };
 }

package/dist/kits.js

@@ -1,7 +1,7 @@
 // View state for the runtime kits, with no React: reducers, views and live stores any UI can draw from (plain DOM,
 // React, React Native). The hooks in `@byokit/ui` read the same stores.
-export { RUN_IDLE, runStep, runStore, runView } from "./run.js";
-export { approvalsStep, approvalsStore, approvalWords } from "./approvals.js";
-export { HERDR_EMPTY, agentIn, blockedView, herdrStep, herdrStore, herdrTreeView } from "./herdr.js";
-export { keyStep, keyView } from "./key.js";
-export { livePanelView, signInSheetView, signInsStore } from "./browser.js";
+export { RUN_IDLE, runStep, runStore, runView } from './run.js';
+export { approvalsStep, approvalsStore, approvalWords } from './approvals.js';
+export { HERDR_EMPTY, agentIn, blockedView, herdrStep, herdrStore, herdrTreeView } from './herdr.js';
+export { keyStep, keyView } from './key.js';
+export { livePanelView, signInSheetView, signInsStore } from './browser.js';

package/dist/phase.d.ts

@@ -15,9 +15,9 @@ export type AccountView = {
     signIn?: SignInView | null;
 };
 export declare function phaseOf(a: AccountView | null, { offline, cancelled, keepWork }?: {
-    offline?: boolean | undefined;
     cancelled?: boolean | undefined;
     keepWork?: boolean | undefined;
+    offline?: boolean | undefined;
 }): Phase;
 /** Where the three-step progress bar ("Open", "Say yes", "Done") stands. */
 export declare const stepOf: (p: Phase) => 0 | 1 | 3;

package/dist/run.d.ts

@@ -11,6 +11,8 @@ export type RunEvent = {
     type: 'tool';
     name: string;
     phase: 'start' | 'end';
+} | {
+    type: 'account';
 };
 export type RunEnd = {
     ok: true;

package/dist/run.js

@@ -3,7 +3,7 @@
 //   idle      nothing sent yet          running   the reply is streaming in
 //   done      the reply is complete     stopped   stopped before the end (here, or aborted on the computer)
 //   failed    it ended with a problem: `words` says which, in the kit's own sentence
-import { store } from "./follow.js";
+import { store } from './follow.js';
 export const RUN_IDLE = { phase: 'idle', text: '', tools: [] };
 export function runStep(s, a) {
     if (a.type === 'start')
@@ -12,7 +12,8 @@ export function runStep(s, a) {
         return s; // a finished run hears nothing more
     switch (a.type) {
         case 'started':
-        case 'thinking': return s;
+        case 'thinking':
+        case 'account': return s;
         case 'text': return { ...s, text: a.text };
         case 'tool': {
             if (a.phase === 'start')

package/dist/useAccounts.js

@@ -3,7 +3,7 @@
 // way. A failing room leaves only its row unknown; a mid-refresh `remove()` still drops the row. No openclaw
 // adapter yet (pending O14).
 import { useCallback, useEffect, useRef, useState } from 'react';
-import { accountRows, modelPicker, rowsOf } from "./accounts.js";
+import { accountRows, modelPicker, rowsOf } from './accounts.js';
 const UNKNOWN_ROOM = { left: 'unknown' };
 const CLI_LABEL = { claude: 'Claude', codex: 'Codex', pi: 'Pi' };
 /** One line per member: the rows' source (with the picker's models and Auto pick) over a live `Accounts`. */

package/dist/useConnect.d.ts

@@ -4,15 +4,15 @@ export type UseConnect = UseConnectSignIn & {
     words?: ConnectWords;
 };
 export declare function useConnect({ routes, words, ...o }: UseConnect): {
+    groups: import("./connect.ts").ConnectGroup[];
+    chosen?: {
+        row: import("./connect.ts").ConnectRow;
+        key?: ReturnType<typeof import("./key.ts").keyView>;
+    };
     step: ConnectStep;
     act: (a: ConnectAction) => void;
     pick: (key: string) => void;
     back: () => void;
     /** Pass to `useSignIn` in a sheet keyed by `chosen.row.key`; undefined unless a ready sign-in row is chosen. */
     signIn: import("./useSignIn.ts").UseSignIn | undefined;
-    groups: import("./connect.ts").ConnectGroup[];
-    chosen?: {
-        row: import("./connect.ts").ConnectRow;
-        key?: ReturnType<typeof import("./key.ts").keyView>;
-    };
 };

package/dist/useConnect.js

@@ -2,7 +2,7 @@
 // the chosen sign-in row's options to `useSignIn`. Keys never enter it: the app sends the input to its kit and
 // reports only the result.
 import { useState } from 'react';
-import { connectStep, connectView, signInFor } from "./connect.js";
+import { connectStep, connectView, signInFor } from './connect.js';
 export function useConnect({ routes, words, ...o }) {
     const [step, setStep] = useState({ at: 'list' });
     const view = connectView(routes, step, words);

package/dist/useKits.d.ts

@@ -3,10 +3,6 @@ import { type HerdrSource } from './herdr.ts';
 import { type RunSource, type RunWordsOptions } from './run.ts';
 /** One run at a time: `send(message)` streams the reply in; `words` says how a failed run ended. */
 export declare function useRun(source: RunSource, o: RunWordsOptions): {
-    send: (message: string, o?: {
-        sessionKey?: string;
-    }) => void;
-    stop: () => void;
     phase: import("./run.ts").RunPhase;
     text: string;
     tools: {
@@ -15,6 +11,10 @@ export declare function useRun(source: RunSource, o: RunWordsOptions): {
     }[];
     tool: string | undefined;
     words: string;
+    send: (message: string, o?: {
+        sessionKey?: string;
+    }) => void;
+    stop: () => void;
 };
 /** The approvals waiting for a yes, live; `decide` answers one (it leaves the list when the computer says so). */
 export declare function useApprovals(source: ApprovalsSource & {
@@ -49,7 +49,6 @@ export declare function useBlocked(source: HerdrSource & {
     answer(paneId: string, keys: string[], revision: number): Promise<void>;
 }): {
     blocked: {
-        name: string;
         paneId: string;
         workspaceId: string;
         tabId: string;
@@ -57,6 +56,7 @@ export declare function useBlocked(source: HerdrSource & {
         revision: number;
         prompt: string;
         since: number;
+        name: string;
     }[];
     answer: (paneId: string, keys: string[], revision: number) => Promise<void>;
 };

package/dist/useKits.js

@@ -2,9 +2,9 @@
 // framework-free stores from `@byokit/ui/kits`; pass the same device client each render (e.g. from useMemo),
 // since a new one starts following afresh.
 import { useEffect, useMemo, useSyncExternalStore } from 'react';
-import { approvalsStore } from "./approvals.js";
-import { agentIn, blockedView, herdrStore, herdrTreeView } from "./herdr.js";
-import { runStore, runView } from "./run.js";
+import { approvalsStore } from './approvals.js';
+import { agentIn, blockedView, herdrStore, herdrTreeView } from './herdr.js';
+import { runStore, runView } from './run.js';
 const useStore = (s) => useSyncExternalStore(s.subscribe, s.get, s.get);
 /** One run at a time: `send(message)` streams the reply in; `words` says how a failed run ended. */
 export function useRun(source, o) {

package/dist/useSignIn.d.ts

@@ -21,7 +21,7 @@ export declare function useSignIn({ read, start, cancel, offline: isOffline, ms,
     url: string | undefined;
     /** Start again: `{ via: 'code' }` for "Having trouble?", `{ fresh: true }` to pick the account again. */
     start: (body?: {
-        via?: "code";
+        via?: 'code';
         fresh?: boolean;
     }) => void;
     cancel: () => void;

package/dist/useSignIn.js

@@ -2,7 +2,7 @@
 // reports the phase to draw. The app keeps its own look (and its own tab for the provider's page); this is the
 // behaviour every sign-in sheet shares.
 import { useEffect, useState } from 'react';
-import { phaseOf } from "./phase.js";
+import { phaseOf } from './phase.js';
 export function useSignIn({ read, start, cancel, offline: isOffline = () => true, ms = 1500, pinned }) {
     const [value, setValue] = useState(null);
     const [offline, setOffline] = useState(false);

package/dist/words.json

@@ -42,6 +42,7 @@
     "key.label.other": "Key",
     "key.entry": "Paste your key. It stays on this device.",
     "key.checking": "Checking your key…",
+    "key.workspace": "This key works for more than one workspace. Pick the one to use.",
     "key.ok": "Your key is ready. It is used only when you choose this option.",
     "key.invalid": "This key could not be saved. Check it and try again.",
     "key.notIncluded": "This option is not available here.",
@@ -55,6 +56,14 @@
     "account.room.week": "{left} left this week",
     "account.room.month": "{left} left this month",
     "account.room.tightest": "{left} left for now",
+    "account.stale": "{age} (stale)",
+    "account.room.resetSince": "Reset since this reading",
+    "account.window.resetSince": "{label}: reset since this reading",
+    "account.window.session": "Session",
+    "account.window.weekly": "Week",
+    "account.window.monthly": "Month",
+    "account.window.rolling": "Rolling window",
+    "account.window.custom": "Limit",
     "picker.auto": "Auto — most room left",
     "picker.out.state": "Sign in first",
     "picker.out.resting": "Taking a break",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@byokit/ui",
-  "version": "0.7.0",
+  "version": "0.9.0",
   "description": "Headless sign-in, pairing and runtime-kit view state for any UI, plus plain-words copy.",
   "license": "Apache-2.0",
   "type": "module",
@@ -62,7 +62,7 @@
     }
   },
   "devDependencies": {
-    "@byokit/accounts": "0.22.0",
+    "@byokit/accounts": "0.24.3",
     "@types/react": "^19.3.0",
     "@types/react-test-renderer": "^19.3.0",
     "react": "^19.3.0",