dsh-subscriptions 0.1.5 → 0.2.2

package/lib/client/locales.d.ts

@@ -37,6 +37,11 @@ export declare const en: {
     modelsWebSearch: string;
     modelsSave: string;
     modelsUnavailable: string;
+    claudeCacheTtl: string;
+    claudeCacheTtlFollowConfig: string;
+    claudeCacheTtl5m: string;
+    claudeCacheTtl1h: string;
+    claudeCacheTtlHint: string;
     nav: string;
     intro: string;
     unavailable: string;
@@ -73,6 +78,7 @@ export declare const en: {
     usageRefresh: string;
     usageLoading: string;
     usageEmpty: string;
+    usageUnsupported: string;
     usageError: string;
     usageSession: string;
     usageWeekly: string;
@@ -199,6 +205,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: {
@@ -238,6 +277,11 @@ export declare const zh: {
     modelsWebSearch: string;
     modelsSave: string;
     modelsUnavailable: string;
+    claudeCacheTtl: string;
+    claudeCacheTtlFollowConfig: string;
+    claudeCacheTtl5m: string;
+    claudeCacheTtl1h: string;
+    claudeCacheTtlHint: string;
     nav: string;
     intro: string;
     unavailable: string;
@@ -274,6 +318,7 @@ export declare const zh: {
     usageRefresh: string;
     usageLoading: string;
     usageEmpty: string;
+    usageUnsupported: string;
     usageError: string;
     usageSession: string;
     usageWeekly: string;
@@ -400,6 +445,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

@@ -20,23 +20,28 @@ export const en = {
     accountsNoModels: 'No models reported for this account.',
     accountsCatalogUnavailable: 'Model discovery is currently unavailable. Saved model selections are preserved.',
     modelsPartialSave: 'Some reasoning defaults were saved. Remaining changes are still in the draft; retry to finish.',
-    modelsEdit: "Edit model list",
-    modelsHint: "Configure model visibility, default reasoning effort, context and tools here; Save changes below submits them together with the account settings. Hidden models remain usable by existing sessions; tool changes apply to new sessions.",
-    modelsAutomatic: "Automatically show all models, including new models",
-    modelsSelectAll: "Select all",
-    modelsSelectNone: "Clear selection",
-    modelsContext: "Context (tokens)",
-    modelsContextBounds: "Default {default} · Maximum {max}",
-    modelsContextHint: "Leave blank to follow the provider. The requested window is capped by the account’s advertised maximum; account pools use the smallest member window. This controls local history and compaction, not the API’s capacity.",
-    modelsContextInvalid: "Enter a positive whole number of tokens for {model}.",
-    modelsTools: "Provider tools",
-    modelsToolsHint: "Changes apply only to sessions created after saving. Existing sessions keep their tools. Shared tools remain available if any supporting provider is enabled.",
-    modelsImage: "Image generation",
-    modelsVideo: "Video generation",
-    modelsSearch: "X search",
-    modelsWebSearch: "Web search",
-    modelsSave: "Save changes",
-    modelsUnavailable: "Currently unavailable",
+    modelsEdit: 'Edit model list',
+    modelsHint: 'Configure model visibility, default reasoning effort, context and tools here; Save changes below submits them together with the account settings. Hidden models remain usable by existing sessions; tool changes apply to new sessions.',
+    modelsAutomatic: 'Automatically show all models, including new models',
+    modelsSelectAll: 'Select all',
+    modelsSelectNone: 'Clear selection',
+    modelsContext: 'Context (tokens)',
+    modelsContextBounds: 'Default {default} · Maximum {max}',
+    modelsContextHint: 'Leave blank to follow the provider. The requested window is capped by the account’s advertised maximum; account pools use the smallest member window. This controls local history and compaction, not the API’s capacity.',
+    modelsContextInvalid: 'Enter a positive whole number of tokens for {model}.',
+    modelsTools: 'Provider tools',
+    modelsToolsHint: 'Changes apply only to sessions created after saving. Existing sessions keep their tools. Shared tools remain available if any supporting provider is enabled.',
+    modelsImage: 'Image generation',
+    modelsVideo: 'Video generation',
+    modelsSearch: 'X search',
+    modelsWebSearch: 'Web search',
+    modelsSave: 'Save changes',
+    modelsUnavailable: 'Currently unavailable',
+    claudeCacheTtl: 'Prompt cache lifetime',
+    claudeCacheTtlFollowConfig: 'Follow config',
+    claudeCacheTtl5m: '5 minutes',
+    claudeCacheTtl1h: '1 hour',
+    claudeCacheTtlHint: 'Overrides the claudePromptCacheTtl config for this Claude route; Follow config uses the configured value. Saved changes apply from the next request. One hour keeps cached prefixes longer but writes them at a higher input price; compaction and session-title requests stay at five minutes.',
     nav: 'Subscriptions',
     intro: 'Log a subscription provider in or out. Login opens the provider’s authorization page in a new tab; headless setups can paste the callback URL or code instead.',
     unavailable: 'Connection unavailable; subscription status cannot be loaded.',
@@ -73,6 +78,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 +205,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 = {
@@ -221,23 +268,28 @@ export const zh = {
     accountsNoModels: '此账号暂未返回模型。',
     accountsCatalogUnavailable: '暂时无法获取模型目录，已保存的模型选择会被保留。',
     modelsPartialSave: '部分推理档已保存，其余更改仍保留在草稿中，请重试完成保存。',
-    modelsEdit: "编辑模型列表",
-    modelsHint: "在此配置模型显示、默认推理档、上下文与工具，底部的「保存更改」会连同账号设置一起提交。隐藏模型不影响已有会话；工具开关对新建会话生效。",
-    modelsAutomatic: "自动显示全部模型（包含以后新增的模型）",
-    modelsSelectAll: "全选",
-    modelsSelectNone: "清空选择",
-    modelsContext: "上下文（token）",
-    modelsContextBounds: "默认 {default} · 最大 {max}",
-    modelsContextHint: "留空跟随服务商。配置值按账号返回的最大窗口限制；账号池取各成员的最小窗口。此设置控制本地历史保留和压缩时机，不会扩大 API 本身的容量。",
-    modelsContextInvalid: "请为 {model} 输入正整数 token 数。",
-    modelsTools: "Provider 工具",
-    modelsToolsHint: "仅对保存后新建的会话生效，已有会话保留原工具。任一支持的服务商启用共享工具时，该工具仍会显示。",
-    modelsImage: "图片生成",
-    modelsVideo: "视频生成",
-    modelsSearch: "X 搜索",
-    modelsWebSearch: "网页搜索",
-    modelsSave: "保存更改",
-    modelsUnavailable: "当前不可用",
+    modelsEdit: '编辑模型列表',
+    modelsHint: '在此配置模型显示、默认推理档、上下文与工具，底部的「保存更改」会连同账号设置一起提交。隐藏模型不影响已有会话；工具开关对新建会话生效。',
+    modelsAutomatic: '自动显示全部模型（包含以后新增的模型）',
+    modelsSelectAll: '全选',
+    modelsSelectNone: '清空选择',
+    modelsContext: '上下文（token）',
+    modelsContextBounds: '默认 {default} · 最大 {max}',
+    modelsContextHint: '留空跟随服务商。配置值按账号返回的最大窗口限制；账号池取各成员的最小窗口。此设置控制本地历史保留和压缩时机，不会扩大 API 本身的容量。',
+    modelsContextInvalid: '请为 {model} 输入正整数 token 数。',
+    modelsTools: 'Provider 工具',
+    modelsToolsHint: '仅对保存后新建的会话生效，已有会话保留原工具。任一支持的服务商启用共享工具时，该工具仍会显示。',
+    modelsImage: '图片生成',
+    modelsVideo: '视频生成',
+    modelsSearch: 'X 搜索',
+    modelsWebSearch: '网页搜索',
+    modelsSave: '保存更改',
+    modelsUnavailable: '当前不可用',
+    claudeCacheTtl: '提示词缓存时长',
+    claudeCacheTtlFollowConfig: '跟随配置',
+    claudeCacheTtl5m: '5 分钟',
+    claudeCacheTtl1h: '1 小时',
+    claudeCacheTtlHint: '覆盖此 Claude 路由的 claudePromptCacheTtl 配置；选择「跟随配置」时使用配置值。保存后自下一次请求生效。1 小时可更久保留缓存前缀，但写入按更高的输入价格计费；压缩与会话标题请求仍为 5 分钟。',
     nav: '订阅',
     intro: '在此登录或退出订阅服务商。点击登录会在新标签页打开服务商的授权页面；无浏览器环境可改为粘贴回调 URL 或授权码。',
     unavailable: '连接不可用，无法加载订阅状态。',
@@ -274,6 +326,7 @@ export const zh = {
     usageRefresh: '刷新',
     usageLoading: '用量加载中…',
     usageEmpty: '服务商未返回任何用量窗口。',
+    usageUnsupported: '该端点不提供用量查询。',
     usageError: '用量查询失败：{message}',
     usageSession: '5 小时窗口',
     usageWeekly: '每周',
@@ -400,4 +453,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[];