dsh-subscriptions 0.1.4 → 0.2.0

package/lib/client/locales.d.ts

@@ -73,6 +73,7 @@ export declare const en: {
     usageRefresh: string;
     usageLoading: string;
     usageEmpty: string;
+    usageUnsupported: string;
     usageError: string;
     usageSession: string;
     usageWeekly: string;
@@ -199,6 +200,39 @@ export declare const en: {
     speedFastDescription: string;
     commandFast: string;
     commandFastUnavailable: string;
+    ollamaTitle: string;
+    ollamaStatus: string;
+    ollamaStatusNone: string;
+    ollamaWebOn: string;
+    ollamaWebOff: string;
+    ollamaManageTitle: string;
+    ollamaManageHint: string;
+    ollamaFetch: string;
+    ollamaFetching: string;
+    ollamaKeyPlaceholder: string;
+    ollamaKeyHint: string;
+    ollamaFetchFailed: string;
+    ollamaCandidatesCount: string;
+    ollamaCandidatesEmpty: string;
+    ollamaModelsEmpty: string;
+    ollamaModelsLoadFailed: string;
+    ollamaModelsSaveFailed: string;
+    ollamaConfigureHint: string;
+    ollamaDisplayName: string;
+    ollamaRowDetails: string;
+    ollamaEffortsUnknown: string;
+    ollamaMoveUp: string;
+    ollamaMoveDown: string;
+    ollamaBaseURL: string;
+    ollamaApiKeyRef: string;
+    ollamaConnectionHint: string;
+    ollamaWebHint: string;
+    ollamaCatalogOverride: string;
+    ollamaResetDefaults: string;
+    ollamaResetConfirm: string;
+    ollamaCapVision: string;
+    ollamaCapThinking: string;
+    ollamaContext: string;
 };
 /** zh strings, one per {@link en} key. */
 export declare const zh: {
@@ -274,6 +308,7 @@ export declare const zh: {
     usageRefresh: string;
     usageLoading: string;
     usageEmpty: string;
+    usageUnsupported: string;
     usageError: string;
     usageSession: string;
     usageWeekly: string;
@@ -400,6 +435,39 @@ export declare const zh: {
     speedFastDescription: string;
     commandFast: string;
     commandFastUnavailable: string;
+    ollamaTitle: string;
+    ollamaStatus: string;
+    ollamaStatusNone: string;
+    ollamaWebOn: string;
+    ollamaWebOff: string;
+    ollamaManageTitle: string;
+    ollamaManageHint: string;
+    ollamaFetch: string;
+    ollamaFetching: string;
+    ollamaKeyPlaceholder: string;
+    ollamaKeyHint: string;
+    ollamaFetchFailed: string;
+    ollamaCandidatesCount: string;
+    ollamaCandidatesEmpty: string;
+    ollamaModelsEmpty: string;
+    ollamaModelsLoadFailed: string;
+    ollamaModelsSaveFailed: string;
+    ollamaConfigureHint: string;
+    ollamaDisplayName: string;
+    ollamaRowDetails: string;
+    ollamaEffortsUnknown: string;
+    ollamaMoveUp: string;
+    ollamaMoveDown: string;
+    ollamaBaseURL: string;
+    ollamaApiKeyRef: string;
+    ollamaConnectionHint: string;
+    ollamaWebHint: string;
+    ollamaCatalogOverride: string;
+    ollamaResetDefaults: string;
+    ollamaResetConfirm: string;
+    ollamaCapVision: string;
+    ollamaCapThinking: string;
+    ollamaContext: string;
 };
 /** The Subscriptions namespace key union (en is the key-set source of truth). */
 export type SubscriptionsKey = keyof typeof en;

package/lib/client/locales.js

@@ -73,6 +73,7 @@ export const en = {
     usageRefresh: 'Refresh',
     usageLoading: 'Loading usage…',
     usageEmpty: 'No usage windows reported.',
+    usageUnsupported: 'This endpoint has no usage surface.',
     usageError: 'Usage lookup failed: {message}',
     usageSession: '5-hour window',
     usageWeekly: 'Weekly',
@@ -199,6 +200,47 @@ export const en = {
     speedFastDescription: '1.5x speed, more usage',
     commandFast: 'Switch the Codex speed tier (Standard/Fast)',
     commandFastUnavailable: 'The current model has no fast tier; /fast only works on Codex models whose catalog advertises one',
+    ollamaTitle: 'Ollama Cloud',
+    ollamaStatus: '{count} model(s) in the picker',
+    ollamaStatusNone: 'No models configured',
+    ollamaWebOn: 'Web search/fetch enabled',
+    ollamaWebOff: 'Web search/fetch off',
+    ollamaManageTitle: 'Manage Ollama Cloud',
+    ollamaManageHint: 'Fetch the Cloud list, tick the models this route serves, then Save. The picker '
+        + 'shows the ticked models in order; the API key itself stays in DSH credentials.',
+    ollamaFetch: 'Fetch cloud models',
+    ollamaFetching: 'Fetching…',
+    ollamaKeyPlaceholder: 'One-time API key (optional)',
+    ollamaKeyHint: 'A key typed here is used for this fetch only and is never saved. Leave it '
+        + 'blank to use the stored credential.',
+    ollamaFetchFailed: 'Could not fetch cloud models: {message}',
+    ollamaCandidatesCount: '{count} returned',
+    ollamaCandidatesEmpty: 'No cloud models returned.',
+    ollamaModelsEmpty: 'No models configured. Fetch the cloud list and tick the ones to keep.',
+    ollamaModelsLoadFailed: 'Could not load Ollama settings: {message}',
+    ollamaModelsSaveFailed: 'Could not save Ollama settings: {message}',
+    ollamaConfigureHint: 'No API key found at {ref}. Add it to the credentials file '
+        + '(~/.dsh/.credentials.yaml).',
+    ollamaDisplayName: 'Display name',
+    ollamaRowDetails: 'Details',
+    ollamaEffortsUnknown: 'This model reasons; its level set will come from live discovery.',
+    ollamaMoveUp: 'Move up',
+    ollamaMoveDown: 'Move down',
+    ollamaBaseURL: 'Base URL',
+    ollamaApiKeyRef: 'API key reference',
+    ollamaConnectionHint: "The base URL receives this route's requests and the credential lookup; the "
+        + "reference names the DSH credential, not the key itself. Requests send "
+        + "the resolved key to that address, so point it only at a host you trust.",
+    ollamaWebHint: 'Enables the Ollama Cloud web search and fetch providers. The host still '
+        + 'has to select them before the web tools use them.',
+    ollamaCatalogOverride: "A profile pins this route's model list; the picker ignores store models "
+        + "until that override is removed.",
+    ollamaResetDefaults: 'Restore deployment defaults',
+    ollamaResetConfirm: 'Clear every saved Ollama override? The profile values and built-in '
+        + 'defaults apply again.',
+    ollamaCapVision: 'vision',
+    ollamaCapThinking: 'thinking',
+    ollamaContext: 'context {tokens}',
 };
 /** zh strings, one per {@link en} key. */
 export const zh = {
@@ -274,6 +316,7 @@ export const zh = {
     usageRefresh: '刷新',
     usageLoading: '用量加载中…',
     usageEmpty: '服务商未返回任何用量窗口。',
+    usageUnsupported: '该端点不提供用量查询。',
     usageError: '用量查询失败：{message}',
     usageSession: '5 小时窗口',
     usageWeekly: '每周',
@@ -400,4 +443,38 @@ export const zh = {
     speedFastDescription: '约 1.5 倍速度，消耗更多用量',
     commandFast: '切换 Codex 速度档（标准/快速）',
     commandFastUnavailable: '当前模型不支持快速档；/fast 仅对目录声明了 fast tier 的 Codex 模型可用',
+    ollamaTitle: 'Ollama Cloud',
+    ollamaStatus: '选择器中 {count} 个模型',
+    ollamaStatusNone: '尚未配置模型',
+    ollamaWebOn: '网页搜索/抓取已启用',
+    ollamaWebOff: '网页搜索/抓取已关闭',
+    ollamaManageTitle: '管理 Ollama Cloud',
+    ollamaManageHint: '选择此路由提供的云端模型后保存。模型选择器按此顺序显示这份列表；API 密钥本身仍保存在 DSH 凭据中。',
+    ollamaFetch: '拉取云端模型',
+    ollamaFetching: '拉取中…',
+    ollamaKeyPlaceholder: '一次性 API 密钥（可选）',
+    ollamaKeyHint: '在此输入的密钥仅用于本次拉取，不会保存。留空则使用已存凭据。',
+    ollamaFetchFailed: '拉取云端模型失败：{message}',
+    ollamaCandidatesCount: '返回 {count} 个',
+    ollamaCandidatesEmpty: '未返回任何云端模型。',
+    ollamaModelsEmpty: '尚未配置模型。请拉取云端列表并勾选需要保留的模型。',
+    ollamaModelsLoadFailed: 'Ollama 设置加载失败：{message}',
+    ollamaModelsSaveFailed: 'Ollama 设置保存失败：{message}',
+    ollamaConfigureHint: '未在 {ref} 找到 API 密钥。请在凭据文件（~/.dsh/.credentials.yaml）中添加。',
+    ollamaDisplayName: '显示名',
+    ollamaRowDetails: '详情',
+    ollamaEffortsUnknown: '该模型支持思考，推理档位将由实时发现补充。',
+    ollamaMoveUp: '上移',
+    ollamaMoveDown: '下移',
+    ollamaBaseURL: '基础 URL',
+    ollamaApiKeyRef: 'API 密钥引用',
+    ollamaConnectionHint: '基础 URL 用于此路由的请求与凭据查询；引用是 DSH 凭据的名称，不是密钥本身。'
+        + '请求会把解析出的密钥发往该地址，请只填写可信主机。',
+    ollamaWebHint: '启用 Ollama Cloud 的网页搜索与抓取能力。宿主仍需选择它们，网页工具才会使用。',
+    ollamaCatalogOverride: '配置档案固定了此路由的模型列表；在移除该覆盖前，选择器会忽略存储中的模型。',
+    ollamaResetDefaults: '恢复部署默认值',
+    ollamaResetConfirm: '清除全部已保存的 Ollama 覆盖项？将重新使用配置档案值与内置默认值。',
+    ollamaCapVision: '视觉',
+    ollamaCapThinking: '思考',
+    ollamaContext: '上下文 {tokens}',
 };

package/lib/client/ollama-draft.d.ts

@@ -0,0 +1,229 @@
+/**
+ * Draft rules of the Ollama Cloud settings dialog, kept free of React and the
+ * DOM so they can be unit tested. The node half owns the shapes below; the
+ * client restates them locally because the browser bundle does not import
+ * node-side modules.
+ */
+/** One model entry as stored in the route settings. */
+export interface OllamaModelSetting {
+    id: string;
+    name?: string;
+    contextWindow?: number;
+    /** The user's explicit local context window; absent follows the endpoint. */
+    contextOverride?: number;
+    maxTokens?: number;
+    vision?: boolean;
+    thinking?: boolean;
+    efforts?: string[];
+    defaultEffort?: string;
+}
+/** One model row of the editable draft (same fields as the stored entry). */
+export interface OllamaModelDraft {
+    id: string;
+    name?: string;
+    contextWindow?: number;
+    /** The user's explicit local context window; absent follows the endpoint. */
+    contextOverride?: number;
+    maxTokens?: number;
+    vision?: boolean;
+    thinking?: boolean;
+    efforts?: string[];
+    defaultEffort?: string;
+}
+/** The editable settings draft; every field is an override of the deployment value. */
+export interface OllamaSettingsDraft {
+    models?: OllamaModelDraft[];
+    web?: boolean;
+    baseURL?: string;
+    apiKeyRef?: string;
+}
+/** `ollamaSettings` endpoint value. */
+export interface OllamaSettingsView {
+    provider: 'ollama-cloud';
+    settings: {
+        models?: OllamaModelSetting[];
+        web?: boolean;
+        baseURL?: string;
+        apiKeyRef?: string;
+    };
+    effective: {
+        baseURL: string;
+        apiKeyRef: string;
+        web: boolean;
+    };
+    models: {
+        id: string;
+        name: string;
+        vision: boolean;
+        thinking: boolean;
+        contextWindow?: number;
+        /** Advertised reasoning levels and the endpoint default, when the model reasons. */
+        efforts?: {
+            id: string;
+            name: string;
+        }[];
+        defaultEffort?: string;
+    }[];
+    configOverridesModels: boolean;
+}
+/** One cloud catalog entry returned by the `ollamaModels` endpoint. */
+export interface OllamaCloudCandidate {
+    /** Normalized wire id; this is what the store keeps. */
+    id: string;
+    /** Listing id before normalization. */
+    rawId: string;
+    /** Display basename. */
+    name: string;
+    vision: boolean;
+    thinking: boolean;
+    contextWindow?: number;
+    efforts: string[];
+    defaultEffort?: string;
+}
+/**
+ * Append the checked candidates to the draft's model list. Existing rows are
+ * never replaced or reordered, ids already present are skipped, and adopted
+ * rows keep the candidate order. Optional fields are set only when the
+ * candidate advertises a value, because `exactOptionalPropertyTypes` (and the
+ * store) must not see an explicit `undefined`.
+ * @param current - the draft list before adoption.
+ * @param candidates - the cloud list as fetched, in display order.
+ * @param selectedIds - ids the user checked.
+ * @returns a new list; the input array is not mutated.
+ */
+export declare function adoptCandidates(current: readonly OllamaModelDraft[] | undefined, candidates: readonly OllamaCloudCandidate[], selectedIds: readonly string[]): OllamaModelDraft[];
+/**
+ * Swap one model with its neighbour. An id that is absent or a move past
+ * either end returns the same order.
+ * @param models - the current list.
+ * @param id - the row to move.
+ * @param delta - `-1` moves up, `1` moves down.
+ * @returns a new list; the input array is not mutated.
+ */
+export declare function moveModel(models: readonly OllamaModelDraft[], id: string, delta: -1 | 1): OllamaModelDraft[];
+/**
+ * Drop one model from the list.
+ * @param models - the current list.
+ * @param id - the row to drop; an unknown id leaves the list unchanged.
+ * @returns a new list; the input array is not mutated.
+ */
+export declare function removeModel(models: readonly OllamaModelDraft[], id: string): OllamaModelDraft[];
+/**
+ * Short context-window label for a model row.
+ * @param contextWindow - the advertised window in tokens.
+ * @returns `'1M'`, `'262K'`, the bare number below 1000, or `undefined` when unknown.
+ */
+export declare function contextLabel(contextWindow: number | undefined): string | undefined;
+/**
+ * Rename one model row. An empty display name deletes the field so the
+ * validator keeps accepting the draft; a blank id leaves the list unchanged.
+ * @param models - the current list.
+ * @param id - the row to rename; an unknown id leaves the list unchanged.
+ * @param name - the new display name; whitespace trims before storing.
+ * @returns a new list; the input array is not mutated.
+ */
+export declare function renameModel(models: readonly OllamaModelDraft[], id: string, name: string): OllamaModelDraft[];
+/**
+ * Set or clear one model row's default reasoning effort. An empty choice
+ * deletes the field so the resolver falls back to the vendor or family
+ * default.
+ * @param models - the current list.
+ * @param id - the row to edit; an unknown id leaves the list unchanged.
+ * @param effort - the chosen level, or `''` to clear.
+ * @returns a new list; the input array is not mutated.
+ */
+export declare function setModelEffort(models: readonly OllamaModelDraft[], id: string, effort: string): OllamaModelDraft[];
+/**
+ * Set or clear one model row's local context-window override. `undefined`
+ * deletes the field so the model follows the endpoint again; the runtime
+ * caps a stored value at the advertised window.
+ * @param models - the current list.
+ * @param id - the row to edit; an unknown id leaves the list unchanged.
+ * @param tokens - a positive safe integer, or `undefined` to clear.
+ * @returns a new list; the input array is not mutated.
+ */
+export declare function setModelContext(models: readonly OllamaModelDraft[], id: string, tokens: number | undefined): OllamaModelDraft[];
+/**
+ * Parse the context input's text. Only a positive safe integer is a value;
+ * an empty string clears the override.
+ * @param text - what the user typed.
+ * @returns the number, `undefined` for blank, or `null` for text to reject.
+ */
+export declare function parseContextInput(text: string): number | undefined | null;
+/** Models the user unticked in this dialog, kept by id so a re-tick restores them. */
+export type OllamaStash = ReadonlyMap<string, OllamaModelDraft>;
+/**
+ * Untick one model: drop it from the list and keep its full row (display
+ * name, default effort, context, ...) in the stash so ticking it again is
+ * lossless, even when the cloud listing no longer carries the id.
+ * @param models - the current list.
+ * @param stash - the stash before this untick.
+ * @param id - the row to untick; an absent id changes nothing.
+ * @returns the new list and stash; neither input is mutated.
+ */
+export declare function untickModel(models: readonly OllamaModelDraft[], stash: OllamaStash, id: string): {
+    models: OllamaModelDraft[];
+    stash: OllamaStash;
+};
+/**
+ * Tick one model: restore its stashed row when this dialog unticked it,
+ * otherwise adopt it from the fetched candidates (which never copies the
+ * vendor default effort). A model already in the list, or unknown to both
+ * sources, leaves the list unchanged.
+ * @param models - the current list.
+ * @param stash - rows unticked earlier in this dialog.
+ * @param candidates - the cloud list as fetched.
+ * @param id - the row to tick.
+ * @returns a new list and the stash without the restored row.
+ */
+export declare function tickModel(models: readonly OllamaModelDraft[], stash: OllamaStash, candidates: readonly OllamaCloudCandidate[], id: string): {
+    models: OllamaModelDraft[];
+    stash: OllamaStash;
+};
+/**
+ * Tick every listed id in order. Rows already in the list stay where they
+ * are; restored and adopted rows append in the given order.
+ * @param models - the current list.
+ * @param stash - rows unticked earlier in this dialog.
+ * @param candidates - the cloud list as fetched.
+ * @param ids - the ids to tick, typically the filtered view.
+ * @returns the new list and stash; neither input is mutated.
+ */
+export declare function tickModels(models: readonly OllamaModelDraft[], stash: OllamaStash, candidates: readonly OllamaCloudCandidate[], ids: readonly string[]): {
+    models: OllamaModelDraft[];
+    stash: OllamaStash;
+};
+/**
+ * Untick every listed id, stashing each removed row. Ids outside the list,
+ * such as filtered-out rows, are untouched.
+ * @param models - the current list.
+ * @param stash - the stash before this untick.
+ * @param ids - the ids to untick, typically the filtered view.
+ * @returns the new list and stash; neither input is mutated.
+ */
+export declare function untickModels(models: readonly OllamaModelDraft[], stash: OllamaStash, ids: readonly string[]): {
+    models: OllamaModelDraft[];
+    stash: OllamaStash;
+};
+/** One effort choice shown in a row's selector. */
+export interface EffortOption {
+    id: string;
+    name: string;
+    unavailable?: boolean;
+}
+/**
+ * The effort choices for one ticked row. The row's own `efforts` decide the
+ * ids because the store rejects a default outside them, so the selector must
+ * never offer anything else. A snapshot of the endpoint (`labels`) may only
+ * supply friendlier names for the same ids. A saved default the list no
+ * longer contains is kept visible and marked unavailable instead of
+ * silently reading as "follow the provider".
+ * @param row - the draft row.
+ * @param fetched - efforts from this dialog's latest fetch, when it returned the row.
+ * @param labels - the opened dialog's snapshot of named efforts for the id.
+ * @returns the options in picker order.
+ */
+export declare function effortOptions(row: OllamaModelDraft, fetched: readonly string[] | undefined, labels: readonly {
+    id: string;
+    name: string;
+}[] | undefined): EffortOption[];

package/lib/client/ollama-draft.js

@@ -0,0 +1,246 @@
+/**
+ * Draft rules of the Ollama Cloud settings dialog, kept free of React and the
+ * DOM so they can be unit tested. The node half owns the shapes below; the
+ * client restates them locally because the browser bundle does not import
+ * node-side modules.
+ */
+/**
+ * Append the checked candidates to the draft's model list. Existing rows are
+ * never replaced or reordered, ids already present are skipped, and adopted
+ * rows keep the candidate order. Optional fields are set only when the
+ * candidate advertises a value, because `exactOptionalPropertyTypes` (and the
+ * store) must not see an explicit `undefined`.
+ * @param current - the draft list before adoption.
+ * @param candidates - the cloud list as fetched, in display order.
+ * @param selectedIds - ids the user checked.
+ * @returns a new list; the input array is not mutated.
+ */
+export function adoptCandidates(current, candidates, selectedIds) {
+    const models = [...(current ?? [])];
+    const present = new Set(models.map(model => model.id));
+    const selected = new Set(selectedIds);
+    for (const candidate of candidates) {
+        if (!selected.has(candidate.id) || present.has(candidate.id))
+            continue;
+        present.add(candidate.id);
+        models.push({
+            id: candidate.id,
+            name: candidate.name,
+            ...(candidate.contextWindow === undefined ? {} : { contextWindow: candidate.contextWindow }),
+            ...(candidate.vision ? { vision: true } : {}),
+            ...(candidate.thinking ? { thinking: true } : {}),
+            // The vendor's default is not copied: defaultEffort in the store is
+            // the user's explicit choice only, so the resolver's priority
+            // (user, then vendor, then family) keeps the vendor default live
+            // in discovery while the selector stays an override.
+            ...(candidate.efforts.length ? { efforts: [...candidate.efforts] } : {}),
+        });
+    }
+    return models;
+}
+/**
+ * Swap one model with its neighbour. An id that is absent or a move past
+ * either end returns the same order.
+ * @param models - the current list.
+ * @param id - the row to move.
+ * @param delta - `-1` moves up, `1` moves down.
+ * @returns a new list; the input array is not mutated.
+ */
+export function moveModel(models, id, delta) {
+    const next = [...models];
+    const index = next.findIndex(model => model.id === id);
+    const target = index + delta;
+    if (index === -1 || target < 0 || target >= next.length)
+        return next;
+    const moved = next[index];
+    next[index] = next[target];
+    next[target] = moved;
+    return next;
+}
+/**
+ * Drop one model from the list.
+ * @param models - the current list.
+ * @param id - the row to drop; an unknown id leaves the list unchanged.
+ * @returns a new list; the input array is not mutated.
+ */
+export function removeModel(models, id) {
+    return models.filter(model => model.id !== id);
+}
+/**
+ * Short context-window label for a model row.
+ * @param contextWindow - the advertised window in tokens.
+ * @returns `'1M'`, `'262K'`, the bare number below 1000, or `undefined` when unknown.
+ */
+export function contextLabel(contextWindow) {
+    if (contextWindow === undefined)
+        return undefined;
+    if (contextWindow < 1000)
+        return String(contextWindow);
+    if (contextWindow >= 1_000_000) {
+        const millions = contextWindow / 1_000_000;
+        return `${Number.isInteger(millions) ? millions : Number(millions.toFixed(1))}M`;
+    }
+    return `${Math.round(contextWindow / 1000)}K`;
+}
+/**
+ * Rename one model row. An empty display name deletes the field so the
+ * validator keeps accepting the draft; a blank id leaves the list unchanged.
+ * @param models - the current list.
+ * @param id - the row to rename; an unknown id leaves the list unchanged.
+ * @param name - the new display name; whitespace trims before storing.
+ * @returns a new list; the input array is not mutated.
+ */
+export function renameModel(models, id, name) {
+    return models.map(model => {
+        if (model.id !== id)
+            return model;
+        const next = { ...model };
+        if (name === '')
+            delete next.name;
+        else
+            next.name = name;
+        return next;
+    });
+}
+/**
+ * Set or clear one model row's default reasoning effort. An empty choice
+ * deletes the field so the resolver falls back to the vendor or family
+ * default.
+ * @param models - the current list.
+ * @param id - the row to edit; an unknown id leaves the list unchanged.
+ * @param effort - the chosen level, or `''` to clear.
+ * @returns a new list; the input array is not mutated.
+ */
+export function setModelEffort(models, id, effort) {
+    return models.map(model => {
+        if (model.id !== id)
+            return model;
+        if (effort === '') {
+            const next = { ...model };
+            delete next.defaultEffort;
+            return next;
+        }
+        return { ...model, defaultEffort: effort };
+    });
+}
+/**
+ * Set or clear one model row's local context-window override. `undefined`
+ * deletes the field so the model follows the endpoint again; the runtime
+ * caps a stored value at the advertised window.
+ * @param models - the current list.
+ * @param id - the row to edit; an unknown id leaves the list unchanged.
+ * @param tokens - a positive safe integer, or `undefined` to clear.
+ * @returns a new list; the input array is not mutated.
+ */
+export function setModelContext(models, id, tokens) {
+    return models.map(model => {
+        if (model.id !== id)
+            return model;
+        const next = { ...model };
+        if (tokens === undefined)
+            delete next.contextOverride;
+        else
+            next.contextOverride = tokens;
+        return next;
+    });
+}
+/**
+ * Parse the context input's text. Only a positive safe integer is a value;
+ * an empty string clears the override.
+ * @param text - what the user typed.
+ * @returns the number, `undefined` for blank, or `null` for text to reject.
+ */
+export function parseContextInput(text) {
+    const trimmed = text.trim();
+    if (trimmed === '')
+        return undefined;
+    if (!/^\d+$/.test(trimmed))
+        return null;
+    const value = Number(trimmed);
+    return Number.isSafeInteger(value) && value > 0 ? value : null;
+}
+/**
+ * Untick one model: drop it from the list and keep its full row (display
+ * name, default effort, context, ...) in the stash so ticking it again is
+ * lossless, even when the cloud listing no longer carries the id.
+ * @param models - the current list.
+ * @param stash - the stash before this untick.
+ * @param id - the row to untick; an absent id changes nothing.
+ * @returns the new list and stash; neither input is mutated.
+ */
+export function untickModel(models, stash, id) {
+    const row = models.find(model => model.id === id);
+    if (row === undefined)
+        return { models: [...models], stash };
+    return { models: removeModel(models, id), stash: new Map(stash).set(id, row) };
+}
+/**
+ * Tick one model: restore its stashed row when this dialog unticked it,
+ * otherwise adopt it from the fetched candidates (which never copies the
+ * vendor default effort). A model already in the list, or unknown to both
+ * sources, leaves the list unchanged.
+ * @param models - the current list.
+ * @param stash - rows unticked earlier in this dialog.
+ * @param candidates - the cloud list as fetched.
+ * @param id - the row to tick.
+ * @returns a new list and the stash without the restored row.
+ */
+export function tickModel(models, stash, candidates, id) {
+    if (models.some(model => model.id === id))
+        return { models: [...models], stash };
+    const stashed = stash.get(id);
+    if (stashed === undefined)
+        return { models: adoptCandidates(models, candidates, [id]), stash };
+    const next = new Map(stash);
+    next.delete(id);
+    return { models: [...models, stashed], stash: next };
+}
+/**
+ * Tick every listed id in order. Rows already in the list stay where they
+ * are; restored and adopted rows append in the given order.
+ * @param models - the current list.
+ * @param stash - rows unticked earlier in this dialog.
+ * @param candidates - the cloud list as fetched.
+ * @param ids - the ids to tick, typically the filtered view.
+ * @returns the new list and stash; neither input is mutated.
+ */
+export function tickModels(models, stash, candidates, ids) {
+    let state = { models: [...models], stash };
+    for (const id of ids)
+        state = tickModel(state.models, state.stash, candidates, id);
+    return state;
+}
+/**
+ * Untick every listed id, stashing each removed row. Ids outside the list,
+ * such as filtered-out rows, are untouched.
+ * @param models - the current list.
+ * @param stash - the stash before this untick.
+ * @param ids - the ids to untick, typically the filtered view.
+ * @returns the new list and stash; neither input is mutated.
+ */
+export function untickModels(models, stash, ids) {
+    let state = { models: [...models], stash };
+    for (const id of ids)
+        state = untickModel(state.models, state.stash, id);
+    return state;
+}
+/**
+ * The effort choices for one ticked row. The row's own `efforts` decide the
+ * ids because the store rejects a default outside them, so the selector must
+ * never offer anything else. A snapshot of the endpoint (`labels`) may only
+ * supply friendlier names for the same ids. A saved default the list no
+ * longer contains is kept visible and marked unavailable instead of
+ * silently reading as "follow the provider".
+ * @param row - the draft row.
+ * @param fetched - efforts from this dialog's latest fetch, when it returned the row.
+ * @param labels - the opened dialog's snapshot of named efforts for the id.
+ * @returns the options in picker order.
+ */
+export function effortOptions(row, fetched, labels) {
+    const ids = row.efforts ?? fetched ?? labels?.map(entry => entry.id) ?? [];
+    const options = ids.map(id => ({ id, name: labels?.find(entry => entry.id === id)?.name ?? id }));
+    if (row.defaultEffort !== undefined && !ids.includes(row.defaultEffort)) {
+        options.push({ id: row.defaultEffort, name: row.defaultEffort, unavailable: true });
+    }
+    return options;
+}

package/lib/client/usage-pace.d.ts

@@ -40,3 +40,10 @@ export declare function isUsageFresh(window: UsageWindow, observation: UsageObse
 export declare function elapsedPercent(window: UsageWindow, now?: number): number | undefined;
 export declare function usageColorState(used: number, elapsed: number | undefined, preset: UsageColorPreset, fresh: boolean): UsageColorState;
 export declare function usageBarColor(used: number, elapsed?: number, preset?: UsageColorPreset, fresh?: boolean): string;
+/**
+ * Marker position from the window's display-only assumed start
+ * (`displayStartsAt`): the reading and its age are irrelevant, exactly
+ * like the verified marker. Returns undefined when the window carries no
+ * assumed start or its reset has passed.
+ */
+export declare function displayStartPercent(window: UsageWindow, now?: number): number | undefined;