@econ-v1/rpc 7.0.76 → 7.1.0

package/dist/index.d.ts

@@ -109,6 +109,20 @@ export type L402Enforcement = import("./l402-enforcement-contract.js").L402Enfor
 export type L402EnforcementRow = import("./l402-enforcement-contract.js").L402EnforcementRow;
 export type L402EnforcementSource = import("./l402-enforcement-contract.js").L402EnforcementSource;
 export type L402EnforcementSetPayload = import("./l402-enforcement-contract.js").L402EnforcementSetPayload;
+export type ModelPick = import("./model-picker-contract.js").ModelPick;
+export type ModelPickRequest = import("./model-picker-contract.js").ModelPickRequest;
+export type ModelPickerCatalog = import("./model-picker-contract.js").ModelPickerCatalog;
+export type ModelPickerCatalogRow = import("./model-picker-contract.js").ModelPickerCatalogRow;
+export type ModelPickerCenter = import("./model-picker-contract.js").ModelPickerCenter;
+export type ModelRef = import("./model-picker-contract.js").ModelRef;
+export type PickerModel = import("./model-picker-contract.js").PickerModel;
+export type PickerNotice = import("./model-picker-contract.js").PickerNotice;
+export type PickerProvider = import("./model-picker-contract.js").PickerProvider;
+export type PickerRecent = import("./model-picker-contract.js").PickerRecent;
+export type PickerSearchOption = import("./model-picker-contract.js").PickerSearchOption;
+export type PickerStore = import("./model-picker-contract.js").PickerStore;
+export type RouteMode = import("./model-picker-contract.js").RouteMode;
+export type WebSearchChoice = import("./model-picker-contract.js").WebSearchChoice;
 export type ClientServicesRetryResult = import("./client-services-contract.js").ClientServicesRetryResult;
 export type FactoryResetPending = import("./factory-reset-contract.js").FactoryResetPending;
 export type FactoryResetStatus = import("./factory-reset-contract.js").FactoryResetStatus;
@@ -175,6 +189,7 @@ export { DEFAULT_REQUEST_TIMEOUT_MS, KernelRpcTimeoutError, MessagePortKernelRpc
 export { NODE_APP_LIFECYCLE_COMMAND, NODE_APP_MEMORY_CAPTURE_COMMAND, NODE_APP_MEMORY_DETAIL_QUERY, NODE_APP_MEMORY_DOWNLOAD_COMMAND, NODE_APP_MEMORY_LIST_QUERY, NODE_APP_MEMORY_OVERVIEW_QUERY, NODE_APP_MEMORY_STATUS_COMMAND } from "./node-app-memory-contract.js";
 export { APPS_LIFECYCLE_PIN_COMMAND, APPS_LIFECYCLE_QUERY } from "./apps-lifecycle-contract.js";
 export { L402_ENFORCEMENT_QUERY, L402_ENFORCEMENT_ROW_ID, L402_ENFORCEMENT_SET_COMMAND } from "./l402-enforcement-contract.js";
+export { isRouteMode, MODEL_PICKER_CATALOG_QUERY, MODEL_PICKER_CATALOG_ROW_ID, MODEL_PICKER_RECENTS_LIMIT, MODEL_PICKER_RECENTS_SETTING, MODEL_PICKER_STAGE_ID, ROUTE_MODES, WEB_SEARCH_AUTO } from "./model-picker-contract.js";
 export { FACTORY_RESET_ARM_COMMAND, FACTORY_RESET_CANCEL_COMMAND, FACTORY_RESET_CHALLENGE_COMMAND, FACTORY_RESET_ROW_ID, FACTORY_RESET_STATUS_QUERY } from "./factory-reset-contract.js";
 export { CLIENT_DEVICE_PAIRING_STATUS_QUERY, CLIENT_DEVICE_WIRE_ERROR_DEVICE_LIMIT_EXCEEDED, CLIENT_DEVICE_WIRE_ERROR_DEVICE_NOT_REGISTERED, CLIENT_DEVICE_WIRE_ERROR_LAST_DEVICE, CLIENT_DEVICE_WIRE_ERROR_LAST_DEVICE_PROTECTED, CLIENT_DEVICE_WIRE_ERROR_NAME_TAKEN } from "./pairing-status-contract.js";
 export { DEVICE_CLEANUP_CANCEL_COMMAND, DEVICE_CLEANUP_QUERY, DEVICE_CLEANUP_REQUEST_COMMAND, DEVICE_CLEANUP_STATUS_COMMAND } from "./device-cleanup-contract.js";

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.js"],"names":[],"mappings":";;;;;8BAEc,OAAO,aAAa,EAAE,eAAe;mCACrC,OAAO,4BAA4B,EAAE,oBAAoB;4BACzD,OAAO,wBAAwB,EAAE,aAAa;kCAC9C,OAAO,0BAA0B,EAAE,mBAAmB;oCACtD,OAAO,0BAA0B,EAAE,qBAAqB;4BACxD,OAAO,aAAa,EAAE,aAAa;8BACnC,OAAO,aAAa,EAAE,eAAe;0BACrC,OAAO,aAAa,EAAE,WAAW;0BACjC,OAAO,iBAAiB,EAAE,WAAW;0BACrC,OAAO,iBAAiB,EAAE,WAAW;8BACrC,OAAO,iBAAiB,EAAE,eAAe;8BACvB,CAAC,SAAlB,eAAgB,IAAa,OAAO,iBAAiB,EAAE,iBAAiB,CAAC,CAAC,CAAC;+BAC1D,CAAC,SAAlB,eAAgB,IAAa,OAAO,iBAAiB,EAAE,kBAAkB,CAAC,CAAC,CAAC;8BAC7E,OAAO,iBAAiB,EAAE,eAAe;2BACzC,OAAO,iBAAiB,EAAE,YAAY;sBACtC,CAAC,IAAW,OAAO,iBAAiB,EAAE,SAAS,CAAC,CAAC,CAAC;wBAClD,OAAO,iBAAiB,EAAE,SAAS;sCACnC,OAAO,iBAAiB,EAAE,uBAAuB;4BACjD,OAAO,iBAAiB,EAAE,aAAa;6BACvC,OAAO,iBAAiB,EAAE,cAAc;qCACxC,OAAO,iBAAiB,EAAE,sBAAsB;iCAChD,OAAO,iBAAiB,EAAE,kBAAkB;+BAC5C,OAAO,yBAAyB,EAAE,gBAAgB;yCAClD,OAAO,gBAAgB,EAAE,0BAA0B;8BACnD,OAAO,gBAAgB,EAAE,eAAe;mCACxC,OAAO,gBAAgB,EAAE,oBAAoB;sCAC7C,OAAO,gBAAgB,EAAE,uBAAuB;+BAChD,OAAO,gBAAgB,EAAE,gBAAgB;uCACzC,OAAO,gBAAgB,EAAE,wBAAwB;gCACjD,OAAO,gBAAgB,EAAE,iBAAiB;8BAC1C,OAAO,gBAAgB,EAAE,eAAe;gCACxC,OAAO,gBAAgB,EAAE,iBAAiB;6BAC1C,OAAO,gBAAgB,EAAE,cAAc;qCACvC,OAAO,gBAAgB,EAAE,sBAAsB;4BAC/C,OAAO,gBAAgB,EAAE,aAAa;kDACtC,OAAO,gBAAgB,EAAE,mCAAmC;0CAC5D,OAAO,gBAAgB,EAAE,2BAA2B;uCACpD,OAAO,gBAAgB,EAAE,wBAAwB;0CACjD,OAAO,gBAAgB,EAAE,2BAA2B;oCACpD,OAAO,gBAAgB,EAAE,qBAAqB;wCAC9C,OAAO,gBAAgB,EAAE,yBAAyB;qCAClD,OAAO,gBAAgB,EAAE,sBAAsB;+BAC/C,OAAO,gBAAgB,EAAE,gBAAgB;mCACzC,OAAO,gBAAgB,EAAE,oBAAoB;mCAC7C,OAAO,gBAAgB,EAAE,oBAAoB;kCAC7C,OAAO,gBAAgB,EAAE,mBAAmB;iCAC5C,OAAO,gBAAgB,EAAE,kBAAkB;kCAC3C,OAAO,gBAAgB,EAAE,mBAAmB;8BAC5C,OAAO,gBAAgB,EAAE,eAAe;oCACxC,OAAO,gBAAgB,EAAE,qBAAqB;uCAC9C,OAAO,gBAAgB,EAAE,wBAAwB;sCACjD,OAAO,gBAAgB,EAAE,uBAAuB;gCAChD,OAAO,gBAAgB,EAAE,iBAAiB;+BAC1C,OAAO,gBAAgB,EAAE,gBAAgB;sCACzC,OAAO,gBAAgB,EAAE,uBAAuB;kCAChD,OAAO,gBAAgB,EAAE,mBAAmB;iCAC5C,OAAO,gBAAgB,EAAE,kBAAkB;iCAC3C,OAAO,gBAAgB,EAAE,kBAAkB;4BAC3C,OAAO,gBAAgB,EAAE,aAAa;wCACtC,OAAO,gBAAgB,EAAE,yBAAyB;kCAClD,OAAO,gBAAgB,EAAE,mBAAmB;iCAC5C,OAAO,gBAAgB,EAAE,kBAAkB;sCAC3C,OAAO,gBAAgB,EAAE,uBAAuB;kCAChD,OAAO,gBAAgB,EAAE,mBAAmB;gCAC5C,OAAO,gBAAgB,EAAE,iBAAiB;qCAC1C,OAAO,gBAAgB,EAAE,sBAAsB;+BAC/C,OAAO,gBAAgB,EAAE,gBAAgB;iCACzC,OAAO,gBAAgB,EAAE,kBAAkB;qCAC3C,OAAO,gBAAgB,EAAE,sBAAsB;qCAC/C,OAAO,gBAAgB,EAAE,sBAAsB;mCAC/C,OAAO,gBAAgB,EAAE,oBAAoB;gCAC7C,OAAO,gBAAgB,EAAE,iBAAiB;gCAC1C,OAAO,gBAAgB,EAAE,iBAAiB;qCAC1C,OAAO,gBAAgB,EAAE,sBAAsB;4CAC/C,OAAO,gBAAgB,EAAE,6BAA6B;wCACtD,OAAO,gBAAgB,EAAE,yBAAyB;kCAClD,OAAO,gBAAgB,EAAE,mBAAmB;kCAC5C,OAAO,gBAAgB,EAAE,mBAAmB;mCAC5C,OAAO,gBAAgB,EAAE,oBAAoB;mCAC7C,OAAO,gBAAgB,EAAE,oBAAoB;8BAC7C,OAAO,gBAAgB,EAAE,eAAe;gDACxC,OAAO,0BAA0B,EAAE,iCAAiC;uCACpE,OAAO,oCAAoC,EAAE,wBAAwB;qCACrE,OAAO,oCAAoC,EAAE,sBAAsB;iCACnE,OAAO,oCAAoC,EAAE,kBAAkB;kCAC/D,OAAO,oCAAoC,EAAE,mBAAmB;qCAChE,OAAO,oCAAoC,EAAE,sBAAsB;kCACnE,OAAO,oCAAoC,EAAE,mBAAmB;qCAChE,OAAO,oCAAoC,EAAE,sBAAsB;sCACnE,OAAO,oCAAoC,EAAE,uBAAuB;sCACpE,OAAO,qCAAqC,EAAE,uBAAuB;gCACrE,OAAO,qCAAqC,EAAE,iBAAiB;2CAC/D,OAAO,qCAAqC,EAAE,4BAA4B;8BAC1E,OAAO,qCAAqC,EAAE,eAAe;uCAC7D,OAAO,qCAAqC,EAAE,wBAAwB;wCACtE,OAAO,qCAAqC,EAAE,yBAAyB;8BACvE,OAAO,qCAAqC,EAAE,eAAe;iCAC7D,OAAO,qCAAqC,EAAE,kBAAkB;+BAChE,OAAO,qCAAqC,EAAE,gBAAgB;6BAC9D,OAAO,qCAAqC,EAAE,cAAc;6CAC5D,OAAO,+BAA+B,EAAE,8BAA8B;6CACtE,OAAO,8BAA8B,EAAE,8BAA8B;8BACrE,OAAO,gCAAgC,EAAE,eAAe;iCACxD,OAAO,gCAAgC,EAAE,kBAAkB;oCAC3D,OAAO,gCAAgC,EAAE,qBAAqB;wCAC9D,OAAO,gCAAgC,EAAE,yBAAyB;wCAClE,OAAO,+BAA+B,EAAE,yBAAyB;kCACjE,OAAO,6BAA6B,EAAE,mBAAmB;iCACzD,OAAO,6BAA6B,EAAE,kBAAkB;oCACxD,OAAO,6BAA6B,EAAE,qBAAqB;2BAC3D,OAAO,sBAAsB,EAAE,YAAY;2BAC3C,OAAO,sBAAsB,EAAE,YAAY;2BAC3C,OAAO,sBAAsB,EAAE,YAAY;4BAC3C,OAAO,sBAAsB,EAAE,aAAa;qCAC5C,OAAO,qCAAqC,EAAE,sBAAsB;2CACpE,OAAO,8BAA8B,EAAE,4BAA4B;iCACnE,OAAO,2BAA2B,EAAE,kBAAkB;2BACtD,OAAO,8BAA8B,EAAE,YAAY;yCACnD,OAAO,8BAA8B,EAAE,0BAA0B;+BACjE,OAAO,8BAA8B,EAAE,gBAAgB;wCACvD,OAAO,8BAA8B,EAAE,yBAAyB;6BAChE,OAAO,4BAA4B,EAAE,cAAc;iCACnD,OAAO,qCAAqC,EAAE,kBAAkB;iCAChE,OAAO,qCAAqC,EAAE,kBAAkB;sCAChE,OAAO,qCAAqC,EAAE,uBAAuB;oCACrE,OAAO,qCAAqC,EAAE,qBAAqB;uCACnE,OAAO,qCAAqC,EAAE,wBAAwB;sCACtE,OAAO,qCAAqC,EAAE,uBAAuB;sCACrE,OAAO,qCAAqC,EAAE,uBAAuB;6CACrE,OAAO,qCAAqC,EAAE,8BAA8B;gCAC5E,OAAO,qCAAqC,EAAE,iBAAiB;mCAC/D,OAAO,qCAAqC,EAAE,oBAAoB;+BAClE,OAAO,qCAAqC,EAAE,gBAAgB;qCAC9D,OAAO,qCAAqC,EAAE,sBAAsB;wCACpE,OAAO,sCAAsC,EAAE,yBAAyB;wCACxE,OAAO,sCAAsC,EAAE,yBAAyB;uCACxE,OAAO,sCAAsC,EAAE,wBAAwB;sCACvE,OAAO,sCAAsC,EAAE,uBAAuB;8BACtE,OAAO,qBAAqB,EAAE,eAAe;6BAC7C,OAAO,oBAAoB,EAAE,cAAc;6BAC3C,OAAO,oBAAoB,EAAE,cAAc;2BAC3C,OAAO,6BAA6B,EAAE,YAAY;iCAClD,OAAO,6BAA6B,EAAE,kBAAkB;qCACxD,OAAO,6BAA6B,EAAE,sBAAsB;qCAC5D,OAAO,6BAA6B,EAAE,sBAAsB;+BAC5D,OAAO,6BAA6B,EAAE,gBAAgB;iCACtD,OAAO,6BAA6B,EAAE,kBAAkB;kCACxD,OAAO,6BAA6B,EAAE,mBAAmB;iCACzD,OAAO,6BAA6B,EAAE,kBAAkB;4CACxD,OAAO,6BAA6B,EAAE,6BAA6B;qCACnE,OAAO,6BAA6B,EAAE,sBAAsB;iCAC5D,OAAO,6BAA6B,EAAE,kBAAkB;gCACxD,OAAO,6BAA6B,EAAE,iBAAiB;mCACvD,OAAO,6BAA6B,EAAE,oBAAoB;gCAC1D,OAAO,6BAA6B,EAAE,iBAAiB;mCACvD,OAAO,6BAA6B,EAAE,oBAAoB;gCAC1D,OAAO,6BAA6B,EAAE,iBAAiB;+BACvD,OAAO,6BAA6B,EAAE,gBAAgB;uBACtD,OAAO,eAAe,EAAE,QAAQ;yBAChC,OAAO,eAAe,EAAE,UAAU;0BAClC,OAAO,eAAe,EAAE,WAAW;2BACnC,OAAO,oBAAoB,EAAE,YAAY;2BACzC,OAAO,oBAAoB,EAAE,YAAY;0BACzC,OAAO,oBAAoB,EAAE,WAAW;2BACxC,OAAO,gBAAgB,EAAE,YAAY;gCACrC,OAAO,gBAAgB,EAAE,iBAAiB"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.js"],"names":[],"mappings":"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"}

package/dist/model-picker-contract.d.ts

@@ -0,0 +1,244 @@
+/** The kernel row: the catalog without the owner's recents (those live in
+ * `client-settings`, per device) and without `state` (a row that exists IS ready;
+ * the shell composes `loading`/`error` itself). */
+/** @typedef {Omit<ModelPickerCatalog, "state" | "error" | "recents"> & { readonly id: string }} ModelPickerCatalogRow */
+/** @param {unknown} value @returns {value is RouteMode} */
+export function isRouteMode(value: unknown): value is RouteMode;
+/**
+ * The shared model picker — ONE overlay every stage opens through the host.
+ *
+ * Two stages used to draw their own model dropdown (the room chat's, and a
+ * 1:1 port of it inside Agent Builder). This contract replaces both with a
+ * door on the stage context, `ctx.host.modelPicker`, beside `host.dialogs`:
+ * the stage asks, the shell opens the design drop's "Switch model" overlay
+ * (`stages/model-selector/`, fed through `NodeOS.feedView`), and hands back
+ * the pick. A stage never sees the catalog and never draws a model list.
+ *
+ * Plan: `docs/superpowers/specs/2026-09-18-shared-model-selector-plan.md`.
+ * Design side: `docs/design/DESIGN_HANDOFF_CONTRACT.md` Ask 16.
+ */
+/** The kernel's one-row live query the shell draws the overlay from. */
+export const MODEL_PICKER_CATALOG_QUERY: "model-picker.catalog.v1";
+/** The single row's id — the catalog is one screen's worth of data, not a row set. */
+export const MODEL_PICKER_CATALOG_ROW_ID: "catalog";
+/** The `client-settings` key the shell keeps the owner's usage counts under. */
+export const MODEL_PICKER_RECENTS_SETTING: "model-picker.recents";
+/** The design drop's stage id: the `NodeOS.feedView` / launcher target. */
+export const MODEL_PICKER_STAGE_ID: "model-selector";
+/** How many distinct models the recents ledger remembers. */
+export const MODEL_PICKER_RECENTS_LIMIT: 24;
+/** Same three words the room chat's route pills already send (`route_mode`). */
+export const ROUTE_MODES: readonly ["auto", "public", "private"];
+/** @typedef {(typeof ROUTE_MODES)[number]} RouteMode */
+/** `"auto"` (the node routes — Exa over Brave, or an explicit `provider`), or a
+ * web-search option id from the catalog (`"brave"`, `"exa"`, …) to force one. An
+ * open string because the option list is data, not a closed enum. An "off" choice
+ * is deliberately NOT part of this contract yet (decided 2026-09-19). */
+/** @typedef {string} WebSearchChoice */
+/** The model the stage puts on the wire — exactly the pick shape the room chat
+ * already sends (`{ model, peerNodeId }` on `room.send.v1`; `model`/`peer_node_id`
+ * on `agent.prompt`). `name` is the vendor id the execution path calls;
+ * `peerNodeId` present means the model is bought from that peer (its store),
+ * absent means this node runs it on its own key ("My Store"). */
+/** @typedef {{ readonly name: string, readonly peerNodeId?: string }} ModelRef */
+/** What the stage already knows, so the overlay opens on it instead of a default. */
+/** @typedef {{ readonly current?: ModelRef, readonly routeMode?: RouteMode, readonly webSearch?: WebSearchChoice }} ModelPickRequest */
+/** `model` is present only when the owner pressed Select on a row; absent means
+ * "keep whatever model the stage already had" — the owner changed only the
+ * web-search chip (or nothing but still closed with a chip change). `label` is
+ * the catalog's `picker_label ?? name`, so a pill or chip shows the same words
+ * the overlay did. */
+/** @typedef {{ readonly model?: ModelRef, readonly label?: string, readonly routeMode: RouteMode, readonly webSearch: WebSearchChoice }} ModelPick */
+/** Resolves `undefined` when the owner closes without choosing. Rejects with a
+ * `DomainError` `conflict` while another `open()` is still pending — the overlay
+ * is one surface — and `capability_unavailable` when this host has no design
+ * drop to draw it with. */
+/** @typedef {{ open(request: ModelPickRequest): Promise<ModelPick | undefined> }} ModelPickerCenter */
+/** @typedef {{ readonly city?: string, readonly lat: number, readonly lon: number }} PickerGeo */
+/** A peer node that sells models. `fee` stays `null` until offerings carry a
+ * markup (today every node charges the same one and advertises the base price). */
+/** @typedef {{ readonly id: string, readonly name: string, readonly tag: string | null, readonly fee: number | null, readonly reliability: number | null, readonly geo: PickerGeo | null }} PickerStore */
+/** @typedef {{ readonly id: string, readonly name: string, readonly brand_hex: string | null, readonly popularity: number, readonly featured: boolean, readonly store_ids: readonly string[], readonly status: string, readonly local: boolean }} PickerProvider */
+/** @typedef {{ readonly peer_node_id: string, readonly cost_in: number | null, readonly cost_out: number | null }} PickerOffer */
+/** A vendor's notice the overlay repeats verbatim under "About" (a data-retention
+ *  clause, a preview caveat). Nothing serves one yet. */
+/** @typedef {{ readonly text: string, readonly url: string | null }} PickerNotice */
+/**
+ * A model row. Every field the overlay draws is here, and the overlay draws a
+ * field ONLY when it is non-null — a missing value hides its cell, it never
+ * shows as a zero, a guess or a demo constant. The `details` block names what
+ * no source serves today; when one does, the overlay lights up without a change.
+ *
+ * Data gaps (2026-09-21) — who would fill each, and what the overlay does meanwhile:
+ *   ttft_ms          api-store: measured from llm_call_log (not backfilled yet) → speed cell hidden, sorts last
+ *   ctx_k            api-store: context_window from discovery when a provider reports it → Context stat hidden
+ *   cost_in/out      api-store list_available (unpriced peer offers) → "—", sorts last, no graph dot
+ *   cache_read_cost  no source (vendor price sheets) → "More pricing" hidden
+ *   cache_write_cost no source → "More pricing" hidden
+ *   modalities_in/out, max_output_k, reasoning, tool_calling, supported_params
+ *                    no source (vendor model cards) → those "Model details" rows hidden
+ *   notice           no source → no notice block
+ *   provider.popularity  api-store llm_platforms.popularity, DEFAULT 0 = unknown → "daily users" hidden, "popular" filter disabled
+ *   store.fee        by design null (every node charges the same markup) → fee row/toggle hidden
+ *   store.geo, mine.geo  no source → no globe marker
+ *   store.reliability    api-store peer_metrics.list (served) → drawn on the store card
+ */
+/** @typedef {{
+ *   readonly id: string,
+ *   readonly provider_id: string,
+ *   readonly vendor_id: string,
+ *   readonly name: string,
+ *   readonly picker_label: string | null,
+ *   readonly tier: string | null,
+ *   readonly specialty: string | null,
+ *   readonly latest: boolean,
+ *   readonly intel: number,
+ *   readonly cost_in: number | null,
+ *   readonly cost_out: number | null,
+ *   readonly ttft_ms: number | null,
+ *   readonly ctx_k: number | null,
+ *   readonly description: string | null,
+ *   readonly released: string | null,
+ *   readonly released_day: string | null,
+ *   readonly local: boolean,
+ *   readonly store_ids: readonly string[],
+ *   readonly offers: readonly PickerOffer[],
+ *   readonly cache_read_cost: number | null,
+ *   readonly cache_write_cost: number | null,
+ *   readonly modalities_in: readonly string[] | null,
+ *   readonly modalities_out: readonly string[] | null,
+ *   readonly max_output_k: number | null,
+ *   readonly reasoning: boolean | null,
+ *   readonly tool_calling: boolean | null,
+ *   readonly supported_params: readonly string[] | null,
+ *   readonly notice: PickerNotice | null
+ * }} PickerModel */
+/** @typedef {{ readonly id: string, readonly name: string, readonly subtitle: string | null, readonly icon: string | null, readonly color: string | null, readonly auto: boolean }} PickerSearchOption */
+/** @typedef {{ readonly id: string, readonly count: number }} PickerRecent */
+/** `state` is the host's word for the whole payload — the same vocabulary the
+ * app-lifecycle view uses — so the overlay can say "still asking" or "the API
+ * Store did not answer" instead of drawing an empty table. */
+/** @typedef {{
+ *   readonly state: "ready" | "loading" | "error",
+ *   readonly error: string | null,
+ *   readonly mine: { readonly name: string, readonly geo: PickerGeo | null },
+ *   readonly stores: readonly PickerStore[],
+ *   readonly providers: readonly PickerProvider[],
+ *   readonly models: readonly PickerModel[],
+ *   readonly web_search_options: readonly PickerSearchOption[],
+ *   readonly recents: readonly PickerRecent[]
+ * }} ModelPickerCatalog */
+/** The web-search chip the node routes with. Not a vendor, so api-store has no row
+ * for it unless an owner curated one; the catalog adapter guarantees it is present. */
+export const WEB_SEARCH_AUTO: "auto";
+export type ModelPickerCatalogRow = Omit<ModelPickerCatalog, "state" | "error" | "recents"> & {
+    readonly id: string;
+};
+export type RouteMode = (typeof ROUTE_MODES)[number];
+export type WebSearchChoice = string;
+export type ModelRef = {
+    readonly name: string;
+    readonly peerNodeId?: string;
+};
+export type ModelPickRequest = {
+    readonly current?: ModelRef;
+    readonly routeMode?: RouteMode;
+    readonly webSearch?: WebSearchChoice;
+};
+export type ModelPick = {
+    readonly model?: ModelRef;
+    readonly label?: string;
+    readonly routeMode: RouteMode;
+    readonly webSearch: WebSearchChoice;
+};
+export type ModelPickerCenter = {
+    open(request: ModelPickRequest): Promise<ModelPick | undefined>;
+};
+export type PickerGeo = {
+    readonly city?: string;
+    readonly lat: number;
+    readonly lon: number;
+};
+export type PickerStore = {
+    readonly id: string;
+    readonly name: string;
+    readonly tag: string | null;
+    readonly fee: number | null;
+    readonly reliability: number | null;
+    readonly geo: PickerGeo | null;
+};
+export type PickerProvider = {
+    readonly id: string;
+    readonly name: string;
+    readonly brand_hex: string | null;
+    readonly popularity: number;
+    readonly featured: boolean;
+    readonly store_ids: readonly string[];
+    readonly status: string;
+    readonly local: boolean;
+};
+export type PickerOffer = {
+    readonly peer_node_id: string;
+    readonly cost_in: number | null;
+    readonly cost_out: number | null;
+};
+export type PickerNotice = {
+    readonly text: string;
+    readonly url: string | null;
+};
+export type PickerModel = {
+    readonly id: string;
+    readonly provider_id: string;
+    readonly vendor_id: string;
+    readonly name: string;
+    readonly picker_label: string | null;
+    readonly tier: string | null;
+    readonly specialty: string | null;
+    readonly latest: boolean;
+    readonly intel: number;
+    readonly cost_in: number | null;
+    readonly cost_out: number | null;
+    readonly ttft_ms: number | null;
+    readonly ctx_k: number | null;
+    readonly description: string | null;
+    readonly released: string | null;
+    readonly released_day: string | null;
+    readonly local: boolean;
+    readonly store_ids: readonly string[];
+    readonly offers: readonly PickerOffer[];
+    readonly cache_read_cost: number | null;
+    readonly cache_write_cost: number | null;
+    readonly modalities_in: readonly string[] | null;
+    readonly modalities_out: readonly string[] | null;
+    readonly max_output_k: number | null;
+    readonly reasoning: boolean | null;
+    readonly tool_calling: boolean | null;
+    readonly supported_params: readonly string[] | null;
+    readonly notice: PickerNotice | null;
+};
+export type PickerSearchOption = {
+    readonly id: string;
+    readonly name: string;
+    readonly subtitle: string | null;
+    readonly icon: string | null;
+    readonly color: string | null;
+    readonly auto: boolean;
+};
+export type PickerRecent = {
+    readonly id: string;
+    readonly count: number;
+};
+export type ModelPickerCatalog = {
+    readonly state: "ready" | "loading" | "error";
+    readonly error: string | null;
+    readonly mine: {
+        readonly name: string;
+        readonly geo: PickerGeo | null;
+    };
+    readonly stores: readonly PickerStore[];
+    readonly providers: readonly PickerProvider[];
+    readonly models: readonly PickerModel[];
+    readonly web_search_options: readonly PickerSearchOption[];
+    readonly recents: readonly PickerRecent[];
+};
+//# sourceMappingURL=model-picker-contract.d.ts.map

package/dist/model-picker-contract.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"model-picker-contract.d.ts","sourceRoot":"","sources":["../src/model-picker-contract.js"],"names":[],"mappings":"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"}

package/dist/stage-context.d.ts

@@ -2,6 +2,7 @@ export type KernelEventType = import("@econ-v1/domain").KernelEventType;
 export type QueryName = import("@econ-v1/domain").QueryName;
 export type Unsubscribe = import("./client.js").Unsubscribe;
 export type DialogCenter = import("./dialog-contract.js").DialogCenter;
+export type ModelPickerCenter = import("./model-picker-contract.js").ModelPickerCenter;
 export type SystemNoticeCenter = import("./system-notice-contract.js").SystemNoticeCenter;
 export type MountedStage = {
     unmount(): Promise<void>;
@@ -35,6 +36,7 @@ export type StageContextV1 = StageContextShared & {
 export type StageContextV2 = StageContextShared & {
     readonly host: StageHostShared & {
         readonly dialogs: DialogCenter;
+        readonly modelPicker: ModelPickerCenter;
         readonly systemNotices: SystemNoticeCenter;
         readonly uiApi: 2;
     };

package/dist/stage-context.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"stage-context.d.ts","sourceRoot":"","sources":["../src/stage-context.js"],"names":[],"mappings":"8BAEc,OAAO,iBAAiB,EAAE,eAAe;wBACzC,OAAO,iBAAiB,EAAE,SAAS;0BACnC,OAAO,aAAa,EAAE,WAAW;2BACjC,OAAO,sBAAsB,EAAE,YAAY;iCAC3C,OAAO,6BAA6B,EAAE,kBAAkB;2BACxD;IAAE,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC,CAAA;CAAE;+BAC5B,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,OAAO,KAAK,OAAO,CAAC,YAAY,CAAC;iCACzD;IACb,QAAY,CAAC,GAAG,EAAE;QAAE,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAA;KAAE,CAAC;IACtE,QAAY,CAAC,MAAM,EAAE;QACf,OAAO,CAAC,CAAC,SAAS,eAAe,EAAE,IAAI,EAAE,CAAC,EAAE,OAAO,EAAE,OAAO,iBAAiB,EAAE,kBAAkB,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;QACrH,SAAS,CAAC,CAAC,SAAS,eAAe,EAAE,IAAI,EAAE,CAAC,EAAE,QAAQ,EAAE,CAAC,KAAK,EAAE,OAAO,iBAAiB,EAAE,iBAAiB,CAAC,CAAC,CAAC,KAAK,IAAI,GAAG,WAAW,CAAA;KACtI,CAAC;IACF,gBAAgB,CAAC,CAAC,EAAE,UAAU,EAAE,MAAM,EAAE,OAAO,EAAE,OAAO,GAAG,OAAO,CAAC,CAAC,CAAC,CAAC;IACtE,SAAS,CAAC,CAAC,EAAE,IAAI,EAAE,SAAS,EAAE,MAAM,EAAE,OAAO,EAAE,QAAQ,EAAE,CAAC,IAAI,EAAE,OAAO,iBAAiB,EAAE,SAAS,CAAC,CAAC,CAAC,KAAK,IAAI,GAAG,WAAW,CAAC;IAC9H,KAAK,CAAC,CAAC,EAAE,IAAI,EAAE,SAAS,EAAE,MAAM,EAAE,OAAO,GAAG,OAAO,CAAC,CAAC,CAAC,CAAC;IAC3D,QAAY,CAAC,KAAK,EAAE;QAAE,IAAI,EAAE,gBAAgB,CAAA;KAAE,CAAA;CAC3C;8BACU;IAAE,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;IAAC,QAAQ,CAAC,IAAI,EAAE,OAAO,CAAA;CAAE;6BACxD,kBAAkB,GAAG;IAAE,QAAQ,CAAC,IAAI,EAAE,eAAe,GAAG;QAAE,QAAQ,CAAC,KAAK,EAAE,CAAC,CAAA;KAAE,CAAA;CAAE;6BAC/E,kBAAkB,GAAG;IAAE,QAAQ,CAAC,IAAI,EAAE,eAAe,GAAG;QAAE,QAAQ,CAAC,OAAO,EAAE,YAAY,CAAC;QAAC,QAAQ,CAAC,aAAa,EAAE,kBAAkB,CAAC;QAAC,QAAQ,CAAC,KAAK,EAAE,CAAC,CAAA;KAAE,CAAA;CAAE;2BAC3J,cAAc,GAAG,cAAc;0BAC/B;IAAE,KAAK,CAAC,GAAG,EAAE,YAAY,GAAG,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAAC,OAAO,IAAI,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAA;CAAE"}
+{"version":3,"file":"stage-context.d.ts","sourceRoot":"","sources":["../src/stage-context.js"],"names":[],"mappings":"8BAEc,OAAO,iBAAiB,EAAE,eAAe;wBACzC,OAAO,iBAAiB,EAAE,SAAS;0BACnC,OAAO,aAAa,EAAE,WAAW;2BACjC,OAAO,sBAAsB,EAAE,YAAY;gCAC3C,OAAO,4BAA4B,EAAE,iBAAiB;iCACtD,OAAO,6BAA6B,EAAE,kBAAkB;2BACxD;IAAE,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC,CAAA;CAAE;+BAC5B,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,OAAO,KAAK,OAAO,CAAC,YAAY,CAAC;iCACzD;IACb,QAAY,CAAC,GAAG,EAAE;QAAE,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAA;KAAE,CAAC;IACtE,QAAY,CAAC,MAAM,EAAE;QACf,OAAO,CAAC,CAAC,SAAS,eAAe,EAAE,IAAI,EAAE,CAAC,EAAE,OAAO,EAAE,OAAO,iBAAiB,EAAE,kBAAkB,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;QACrH,SAAS,CAAC,CAAC,SAAS,eAAe,EAAE,IAAI,EAAE,CAAC,EAAE,QAAQ,EAAE,CAAC,KAAK,EAAE,OAAO,iBAAiB,EAAE,iBAAiB,CAAC,CAAC,CAAC,KAAK,IAAI,GAAG,WAAW,CAAA;KACtI,CAAC;IACF,gBAAgB,CAAC,CAAC,EAAE,UAAU,EAAE,MAAM,EAAE,OAAO,EAAE,OAAO,GAAG,OAAO,CAAC,CAAC,CAAC,CAAC;IACtE,SAAS,CAAC,CAAC,EAAE,IAAI,EAAE,SAAS,EAAE,MAAM,EAAE,OAAO,EAAE,QAAQ,EAAE,CAAC,IAAI,EAAE,OAAO,iBAAiB,EAAE,SAAS,CAAC,CAAC,CAAC,KAAK,IAAI,GAAG,WAAW,CAAC;IAC9H,KAAK,CAAC,CAAC,EAAE,IAAI,EAAE,SAAS,EAAE,MAAM,EAAE,OAAO,GAAG,OAAO,CAAC,CAAC,CAAC,CAAC;IAC3D,QAAY,CAAC,KAAK,EAAE;QAAE,IAAI,EAAE,gBAAgB,CAAA;KAAE,CAAA;CAC3C;8BACU;IAAE,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;IAAC,QAAQ,CAAC,IAAI,EAAE,OAAO,CAAA;CAAE;6BACxD,kBAAkB,GAAG;IAAE,QAAQ,CAAC,IAAI,EAAE,eAAe,GAAG;QAAE,QAAQ,CAAC,KAAK,EAAE,CAAC,CAAA;KAAE,CAAA;CAAE;6BAC/E,kBAAkB,GAAG;IAAE,QAAQ,CAAC,IAAI,EAAE,eAAe,GAAG;QAAE,QAAQ,CAAC,OAAO,EAAE,YAAY,CAAC;QAAC,QAAQ,CAAC,WAAW,EAAE,iBAAiB,CAAC;QAAC,QAAQ,CAAC,aAAa,EAAE,kBAAkB,CAAC;QAAC,QAAQ,CAAC,KAAK,EAAE,CAAC,CAAA;KAAE,CAAA;CAAE;2BACpM,cAAc,GAAG,cAAc;0BAC/B;IAAE,KAAK,CAAC,GAAG,EAAE,YAAY,GAAG,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAAC,OAAO,IAAI,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAA;CAAE"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@econ-v1/rpc",
-  "version": "7.0.76",
+  "version": "7.1.0",
   "description": "Typed runtime and contracts for Node client stage-to-kernel RPC",
   "license": "MIT OR Apache-2.0",
   "author": "Node contributors",
@@ -56,7 +56,7 @@
     "access": "public"
   },
   "dependencies": {
-    "@econ-v1/domain": "7.0.76",
-    "@econ-v1/ports": "7.0.76"
+    "@econ-v1/domain": "7.1.0",
+    "@econ-v1/ports": "7.1.0"
   }
 }

package/src/index.js

@@ -106,6 +106,20 @@
 /** @typedef {import("./l402-enforcement-contract.js").L402EnforcementRow} L402EnforcementRow */
 /** @typedef {import("./l402-enforcement-contract.js").L402EnforcementSource} L402EnforcementSource */
 /** @typedef {import("./l402-enforcement-contract.js").L402EnforcementSetPayload} L402EnforcementSetPayload */
+/** @typedef {import("./model-picker-contract.js").ModelPick} ModelPick */
+/** @typedef {import("./model-picker-contract.js").ModelPickRequest} ModelPickRequest */
+/** @typedef {import("./model-picker-contract.js").ModelPickerCatalog} ModelPickerCatalog */
+/** @typedef {import("./model-picker-contract.js").ModelPickerCatalogRow} ModelPickerCatalogRow */
+/** @typedef {import("./model-picker-contract.js").ModelPickerCenter} ModelPickerCenter */
+/** @typedef {import("./model-picker-contract.js").ModelRef} ModelRef */
+/** @typedef {import("./model-picker-contract.js").PickerModel} PickerModel */
+/** @typedef {import("./model-picker-contract.js").PickerNotice} PickerNotice */
+/** @typedef {import("./model-picker-contract.js").PickerProvider} PickerProvider */
+/** @typedef {import("./model-picker-contract.js").PickerRecent} PickerRecent */
+/** @typedef {import("./model-picker-contract.js").PickerSearchOption} PickerSearchOption */
+/** @typedef {import("./model-picker-contract.js").PickerStore} PickerStore */
+/** @typedef {import("./model-picker-contract.js").RouteMode} RouteMode */
+/** @typedef {import("./model-picker-contract.js").WebSearchChoice} WebSearchChoice */
 /** @typedef {import("./client-services-contract.js").ClientServicesRetryResult} ClientServicesRetryResult */
 /** @typedef {import("./factory-reset-contract.js").FactoryResetPending} FactoryResetPending */
 /** @typedef {import("./factory-reset-contract.js").FactoryResetStatus} FactoryResetStatus */
@@ -186,6 +200,7 @@ export { NODE_APP_LIFECYCLE_COMMAND, NODE_APP_MEMORY_CAPTURE_COMMAND, NODE_APP_M
 export { APPS_LIFECYCLE_PIN_COMMAND, APPS_LIFECYCLE_QUERY } from "./apps-lifecycle-contract.js";
 export { CLIENT_SERVICES_RETRY_COMMAND } from "./client-services-contract.js";
 export { L402_ENFORCEMENT_QUERY, L402_ENFORCEMENT_ROW_ID, L402_ENFORCEMENT_SET_COMMAND } from "./l402-enforcement-contract.js";
+export { isRouteMode, MODEL_PICKER_CATALOG_QUERY, MODEL_PICKER_CATALOG_ROW_ID, MODEL_PICKER_RECENTS_LIMIT, MODEL_PICKER_RECENTS_SETTING, MODEL_PICKER_STAGE_ID, ROUTE_MODES, WEB_SEARCH_AUTO } from "./model-picker-contract.js";
 export {
   FACTORY_RESET_ARM_COMMAND,
   FACTORY_RESET_CANCEL_COMMAND,

package/src/model-picker-contract.js

@@ -0,0 +1,170 @@
+// @ts-check
+
+/**
+ * The shared model picker — ONE overlay every stage opens through the host.
+ *
+ * Two stages used to draw their own model dropdown (the room chat's, and a
+ * 1:1 port of it inside Agent Builder). This contract replaces both with a
+ * door on the stage context, `ctx.host.modelPicker`, beside `host.dialogs`:
+ * the stage asks, the shell opens the design drop's "Switch model" overlay
+ * (`stages/model-selector/`, fed through `NodeOS.feedView`), and hands back
+ * the pick. A stage never sees the catalog and never draws a model list.
+ *
+ * Plan: `docs/superpowers/specs/2026-09-18-shared-model-selector-plan.md`.
+ * Design side: `docs/design/DESIGN_HANDOFF_CONTRACT.md` Ask 16.
+ */
+
+/** The kernel's one-row live query the shell draws the overlay from. */
+export const MODEL_PICKER_CATALOG_QUERY = "model-picker.catalog.v1";
+
+/** The single row's id — the catalog is one screen's worth of data, not a row set. */
+export const MODEL_PICKER_CATALOG_ROW_ID = "catalog";
+
+/** The `client-settings` key the shell keeps the owner's usage counts under. */
+export const MODEL_PICKER_RECENTS_SETTING = "model-picker.recents";
+
+/** The design drop's stage id: the `NodeOS.feedView` / launcher target. */
+export const MODEL_PICKER_STAGE_ID = "model-selector";
+
+/** How many distinct models the recents ledger remembers. */
+export const MODEL_PICKER_RECENTS_LIMIT = 24;
+
+// ── The pick ─────────────────────────────────────────────────────────────────
+
+/** Same three words the room chat's route pills already send (`route_mode`). */
+export const ROUTE_MODES = /** @type {const} */ (["auto", "public", "private"]);
+/** @typedef {(typeof ROUTE_MODES)[number]} RouteMode */
+
+/** `"auto"` (the node routes — Exa over Brave, or an explicit `provider`), or a
+ * web-search option id from the catalog (`"brave"`, `"exa"`, …) to force one. An
+ * open string because the option list is data, not a closed enum. An "off" choice
+ * is deliberately NOT part of this contract yet (decided 2026-09-19). */
+/** @typedef {string} WebSearchChoice */
+
+/** The model the stage puts on the wire — exactly the pick shape the room chat
+ * already sends (`{ model, peerNodeId }` on `room.send.v1`; `model`/`peer_node_id`
+ * on `agent.prompt`). `name` is the vendor id the execution path calls;
+ * `peerNodeId` present means the model is bought from that peer (its store),
+ * absent means this node runs it on its own key ("My Store"). */
+/** @typedef {{ readonly name: string, readonly peerNodeId?: string }} ModelRef */
+
+/** What the stage already knows, so the overlay opens on it instead of a default. */
+/** @typedef {{ readonly current?: ModelRef, readonly routeMode?: RouteMode, readonly webSearch?: WebSearchChoice }} ModelPickRequest */
+
+/** `model` is present only when the owner pressed Select on a row; absent means
+ * "keep whatever model the stage already had" — the owner changed only the
+ * web-search chip (or nothing but still closed with a chip change). `label` is
+ * the catalog's `picker_label ?? name`, so a pill or chip shows the same words
+ * the overlay did. */
+/** @typedef {{ readonly model?: ModelRef, readonly label?: string, readonly routeMode: RouteMode, readonly webSearch: WebSearchChoice }} ModelPick */
+
+/** Resolves `undefined` when the owner closes without choosing. Rejects with a
+ * `DomainError` `conflict` while another `open()` is still pending — the overlay
+ * is one surface — and `capability_unavailable` when this host has no design
+ * drop to draw it with. */
+/** @typedef {{ open(request: ModelPickRequest): Promise<ModelPick | undefined> }} ModelPickerCenter */
+
+// ── The catalog (the shell's read model; stages never see it) ───────────────
+//
+// Field names are api-store's `core.api_store.selector.catalog` (ADR-001) kept
+// verbatim, plus what the host adds: stores are PEER NODES selling models
+// (`mine` is this node), and each model says whether this node runs it
+// (`local`) and which peers offer it (`store_ids`, `offers`). Blended price and
+// age in days are derived by the drawing side, never served.
+
+/** @typedef {{ readonly city?: string, readonly lat: number, readonly lon: number }} PickerGeo */
+
+/** A peer node that sells models. `fee` stays `null` until offerings carry a
+ * markup (today every node charges the same one and advertises the base price). */
+/** @typedef {{ readonly id: string, readonly name: string, readonly tag: string | null, readonly fee: number | null, readonly reliability: number | null, readonly geo: PickerGeo | null }} PickerStore */
+
+/** @typedef {{ readonly id: string, readonly name: string, readonly brand_hex: string | null, readonly popularity: number, readonly featured: boolean, readonly store_ids: readonly string[], readonly status: string, readonly local: boolean }} PickerProvider */
+
+/** @typedef {{ readonly peer_node_id: string, readonly cost_in: number | null, readonly cost_out: number | null }} PickerOffer */
+
+/** A vendor's notice the overlay repeats verbatim under "About" (a data-retention
+ *  clause, a preview caveat). Nothing serves one yet. */
+/** @typedef {{ readonly text: string, readonly url: string | null }} PickerNotice */
+
+/**
+ * A model row. Every field the overlay draws is here, and the overlay draws a
+ * field ONLY when it is non-null — a missing value hides its cell, it never
+ * shows as a zero, a guess or a demo constant. The `details` block names what
+ * no source serves today; when one does, the overlay lights up without a change.
+ *
+ * Data gaps (2026-09-21) — who would fill each, and what the overlay does meanwhile:
+ *   ttft_ms          api-store: measured from llm_call_log (not backfilled yet) → speed cell hidden, sorts last
+ *   ctx_k            api-store: context_window from discovery when a provider reports it → Context stat hidden
+ *   cost_in/out      api-store list_available (unpriced peer offers) → "—", sorts last, no graph dot
+ *   cache_read_cost  no source (vendor price sheets) → "More pricing" hidden
+ *   cache_write_cost no source → "More pricing" hidden
+ *   modalities_in/out, max_output_k, reasoning, tool_calling, supported_params
+ *                    no source (vendor model cards) → those "Model details" rows hidden
+ *   notice           no source → no notice block
+ *   provider.popularity  api-store llm_platforms.popularity, DEFAULT 0 = unknown → "daily users" hidden, "popular" filter disabled
+ *   store.fee        by design null (every node charges the same markup) → fee row/toggle hidden
+ *   store.geo, mine.geo  no source → no globe marker
+ *   store.reliability    api-store peer_metrics.list (served) → drawn on the store card
+ */
+/** @typedef {{
+ *   readonly id: string,
+ *   readonly provider_id: string,
+ *   readonly vendor_id: string,
+ *   readonly name: string,
+ *   readonly picker_label: string | null,
+ *   readonly tier: string | null,
+ *   readonly specialty: string | null,
+ *   readonly latest: boolean,
+ *   readonly intel: number,
+ *   readonly cost_in: number | null,
+ *   readonly cost_out: number | null,
+ *   readonly ttft_ms: number | null,
+ *   readonly ctx_k: number | null,
+ *   readonly description: string | null,
+ *   readonly released: string | null,
+ *   readonly released_day: string | null,
+ *   readonly local: boolean,
+ *   readonly store_ids: readonly string[],
+ *   readonly offers: readonly PickerOffer[],
+ *   readonly cache_read_cost: number | null,
+ *   readonly cache_write_cost: number | null,
+ *   readonly modalities_in: readonly string[] | null,
+ *   readonly modalities_out: readonly string[] | null,
+ *   readonly max_output_k: number | null,
+ *   readonly reasoning: boolean | null,
+ *   readonly tool_calling: boolean | null,
+ *   readonly supported_params: readonly string[] | null,
+ *   readonly notice: PickerNotice | null
+ * }} PickerModel */
+
+/** @typedef {{ readonly id: string, readonly name: string, readonly subtitle: string | null, readonly icon: string | null, readonly color: string | null, readonly auto: boolean }} PickerSearchOption */
+
+/** @typedef {{ readonly id: string, readonly count: number }} PickerRecent */
+
+/** `state` is the host's word for the whole payload — the same vocabulary the
+ * app-lifecycle view uses — so the overlay can say "still asking" or "the API
+ * Store did not answer" instead of drawing an empty table. */
+/** @typedef {{
+ *   readonly state: "ready" | "loading" | "error",
+ *   readonly error: string | null,
+ *   readonly mine: { readonly name: string, readonly geo: PickerGeo | null },
+ *   readonly stores: readonly PickerStore[],
+ *   readonly providers: readonly PickerProvider[],
+ *   readonly models: readonly PickerModel[],
+ *   readonly web_search_options: readonly PickerSearchOption[],
+ *   readonly recents: readonly PickerRecent[]
+ * }} ModelPickerCatalog */
+
+/** The web-search chip the node routes with. Not a vendor, so api-store has no row
+ * for it unless an owner curated one; the catalog adapter guarantees it is present. */
+export const WEB_SEARCH_AUTO = "auto";
+
+/** The kernel row: the catalog without the owner's recents (those live in
+ * `client-settings`, per device) and without `state` (a row that exists IS ready;
+ * the shell composes `loading`/`error` itself). */
+/** @typedef {Omit<ModelPickerCatalog, "state" | "error" | "recents"> & { readonly id: string }} ModelPickerCatalogRow */
+
+/** @param {unknown} value @returns {value is RouteMode} */
+export function isRouteMode(value) {
+  return typeof value === "string" && (/** @type {readonly string[]} */ (ROUTE_MODES)).includes(value);
+}

package/src/stage-context.js

@@ -4,6 +4,7 @@
 /** @typedef {import("@econ-v1/domain").QueryName} QueryName */
 /** @typedef {import("./client.js").Unsubscribe} Unsubscribe */
 /** @typedef {import("./dialog-contract.js").DialogCenter} DialogCenter */
+/** @typedef {import("./model-picker-contract.js").ModelPickerCenter} ModelPickerCenter */
 /** @typedef {import("./system-notice-contract.js").SystemNoticeCenter} SystemNoticeCenter */
 /** @typedef {{ unmount(): Promise<void> }} MountedStage */
 /** @typedef {(appName: string, slot: Element) => Promise<MountedStage>} StageLoadHandler */
@@ -20,7 +21,7 @@
  * }} StageContextShared */
 /** @typedef {{ navigate(path: string): void, readonly root: Element }} StageHostShared */
 /** @typedef {StageContextShared & { readonly host: StageHostShared & { readonly uiApi: 1 } }} StageContextV1 */
-/** @typedef {StageContextShared & { readonly host: StageHostShared & { readonly dialogs: DialogCenter, readonly systemNotices: SystemNoticeCenter, readonly uiApi: 2 } }} StageContextV2 */
+/** @typedef {StageContextShared & { readonly host: StageHostShared & { readonly dialogs: DialogCenter, readonly modelPicker: ModelPickerCenter, readonly systemNotices: SystemNoticeCenter, readonly uiApi: 2 } }} StageContextV2 */
 /** @typedef {StageContextV1 | StageContextV2} StageContext */
 /** @typedef {{ mount(ctx: StageContext): void | Promise<void>, unmount(): void | Promise<void> }} StageModule */