dsh-web-search-pro 0.2.0 → 0.2.3

package/lib/types/client/form-specs.d.ts

@@ -12,7 +12,7 @@
  */
 export type Json = Record<string, unknown>;
 /** Top-level config fields (one Host write each). */
-export type TopField = 'engines' | 'parallelEngines' | 'searchMaxResults' | 'timeoutMs' | 'fetchDefaultChars' | 'exaContentsPerUrlChars' | 'exaContentsTotalChars' | 'exaApiKeyEnv' | 'jinaApiKeyEnv' | 'githubTokenEnv' | 'bochaApiKeyEnv' | 'bochaBaseUrl' | 'bochaSummary' | 'searxngUrl' | 'openalexMailto' | 'enableCliBackends' | 'opencliEnabled' | 'agentReachEnabled' | 'providerId' | 'registerProvider' | 'toolSurface' | 'playwright' | 'ttlSeconds' | 'memoryCacheEntries' | 'rrfConstant' | 'freshnessBoost' | 'freshnessDays' | 'authorityBoost' | 'authorityDomains' | 'dbPath' | 'allowProxyFakeIp' | 'platformRules' | 'customPlatforms' | 'browserBindings' | 'verbose';
+export type TopField = 'engines' | 'parallelEngines' | 'searchMaxResults' | 'timeoutMs' | 'fetchDefaultChars' | 'exaContentsPerUrlChars' | 'exaContentsTotalChars' | 'exaApiKeyEnv' | 'jinaApiKeyEnv' | 'githubTokenEnv' | 'twitterAuthTokenEnv' | 'twitterCt0Env' | 'bochaApiKeyEnv' | 'bochaBaseUrl' | 'bochaSummary' | 'deepseekFetch' | 'searxngUrl' | 'openalexMailto' | 'enableCliBackends' | 'opencliEnabled' | 'agentReachEnabled' | 'providerId' | 'registerProvider' | 'toolSurface' | 'playwright' | 'ttlSeconds' | 'memoryCacheEntries' | 'rrfConstant' | 'freshnessBoost' | 'freshnessDays' | 'authorityBoost' | 'authorityDomains' | 'dbPath' | 'allowProxyFakeIp' | 'platformRules' | 'customPlatforms' | 'browserBindings' | 'platformBackends' | 'cliAdapters' | 'verbose';
 /** Options inside `evidence` / `provider`, addressed by their dotted config path. */
 export type PathField = 'evidence.autoProviders' | 'evidence.sourcePolicy' | 'evidence.maxRounds' | 'evidence.maxQueries' | 'evidence.judge.mode' | 'evidence.hybridBorderline' | 'evidence.judge.provider' | 'evidence.maxJevQuestions' | 'evidence.judge.allowLlm' | 'evidence.judge.providers' | 'evidence.coverage.mode' | 'evidence.coverage.provider' | 'evidence.coverage.thresholds.weak' | 'evidence.coverage.thresholds.covered' | 'evidence.budget.perSearchInputTokens' | 'evidence.budget.dailyInputTokens' | 'evidence.budget.timezone' | 'evidence.budget.providers' | 'provider.evidence' | 'provider.deadlineMs' | 'sources.priority' | 'sources.disabled';
 /** One rubric override entry (`evidence.rubrics.<id>`) and one keyed-source field. */
@@ -20,7 +20,9 @@ export type RubricField = `evidence.rubrics.${string}`;
 export type KeyedField = `keyedSources.${string}.apiKeyEnv` | `keyedSources.${string}.baseUrl`;
 /** One axis of one source's request budget (`sources.budget.<id>.total|daily`). */
 export type BudgetField = `sources.budget.${string}.${'total' | 'daily'}`;
-export type SettingField = TopField | PathField | RubricField | KeyedField | BudgetField;
+/** The confidence of one source or platform backend (`sources.confidence.<id>`): the ids are open, so these fields are made on demand. */
+export type ConfidenceField = `sources.confidence.${string}`;
+export type SettingField = TopField | PathField | RubricField | KeyedField | BudgetField | ConfidenceField;
 export type RootKey = 'evidence' | 'provider' | 'keyedSources' | 'sources';
 export type FieldWrite = {
     kind: 'set';
@@ -89,8 +91,11 @@ export declare const DEFAULTS: {
     };
     readonly toolSurface: "indexed";
     readonly bochaApiKeyEnv: "BOCHA_SEARCH_API_KEY";
+    readonly twitterAuthTokenEnv: "TWITTER_AUTH_TOKEN";
+    readonly twitterCt0Env: "TWITTER_CT0";
     readonly bochaBaseUrl: "https://api.bocha.cn";
     readonly bochaSummary: true;
+    readonly deepseekFetch: false;
 };
 /** Top-level fields, in display order. */
 export declare const FIELD_SPECS: readonly FieldSpec[];
@@ -105,11 +110,15 @@ export declare const KEYED_SPECS: readonly PathSpec[];
 /** The sources the card has a request budget for: Bocha and the keyed sources (any registered id works in settings.yaml). */
 export declare const BUDGETED_SOURCES: readonly string[];
 export declare const BUDGET_SPECS: readonly PathSpec[];
+/** `sources.confidence.<id>`: a number 0..1; empty = the default (1 for a built-in source, the spec's own for a custom CLI). */
+export declare const confidenceSpec: (id: string) => PathSpec;
+export declare const confidenceField: (id: string) => ConfidenceField;
+export declare const CONFIDENCE_PREFIX = "sources.confidence.";
 /** The spec of a rubric override entry: the whole object as one JSON draft, which the rubric editor builds field by field. */
 export declare const rubricSpec: (id: string) => PathSpec;
 export declare const rubricField: (id: string) => RubricField;
 /** Fields that a Host write can never take as text (credentials go through the credentials remote). */
-export declare const CREDENTIAL_IDS: readonly ["exa", "jina", "github", "bocha", ...`keyed:${string}`[]];
+export declare const CREDENTIAL_IDS: readonly ["exa", "jina", "github", "bocha", "twitter-auth-token", "twitter-ct0", ...`keyed:${string}`[]];
 export type CredentialId = typeof CREDENTIAL_IDS[number];
 /** The settings field holding the credentials ref / environment variable name of each credential, and its default name. */
 export declare function credentialRef(id: CredentialId): {

package/lib/types/client/form.d.ts

@@ -2,7 +2,8 @@ import type { SnapshotStore } from '@deepseek-ai/dsh-client-store';
 import type { ConfigForm } from '@deepseek-ai/dsh-client-ui-settings/client';
 import { type RubricKind } from '../pipeline/rubrics-spec.ts';
 import type { Context } from './context-types.ts';
-import { BUDGET_SPECS, CREDENTIAL_IDS, FIELD_SPECS, KEYED_SPECS, PATH_SPECS, type CredentialId, type SettingField } from './form-specs.ts';
+import { BUDGET_SPECS, CREDENTIAL_IDS, FIELD_SPECS, KEYED_SPECS, PATH_SPECS, type CredentialId, type FieldSpec, type SettingField } from './form-specs.ts';
+import { type OverlayView, type StatusView, type TrialRequest, type TrialResult } from '../rpc-types.ts';
 export { BUDGET_SPECS, CREDENTIAL_IDS, FIELD_SPECS, KEYED_SPECS, PATH_SPECS };
 export type { CredentialId, SettingField };
 export interface CardFieldState {
@@ -45,10 +46,42 @@ export interface RubricCardState {
     invalid: boolean;
     problems: string[];
 }
+/** What the card knows of the agent overlay (the settings an agent changed with `config.*`), read over the RPC channel. */
+export interface OverlayCardState {
+    loading: boolean;
+    /** The channel answered with an error, or there is none. */
+    failed: boolean;
+    /** An adopt or revoke is running: the buttons wait. */
+    busy: boolean;
+    /** The last adopt / revoke that did not go through, as a dictionary key with its `{why}`. */
+    error?: {
+        key: 'agentAdoptFailed' | 'agentAdoptHalf' | 'agentRevokeFailed';
+        why?: string;
+    };
+    view?: OverlayView;
+}
+/** What the card knows from the running plugin over its private RPC channel (rpc-types.ts); empty where the Host has no transport. */
+export interface ServerState {
+    /** The Host has the transport: live readiness and "Try it" are possible. */
+    available: boolean;
+    loading: boolean;
+    failed: boolean;
+    status?: StatusView;
+    /** The trial run of a custom CLI draft: idle, running, or the last outcome. */
+    trial: {
+        state: 'idle' | 'running' | 'done' | 'failed';
+        id?: string;
+        result?: TrialResult;
+        error?: string;
+    };
+    overlay: OverlayCardState;
+}
 export interface WebSearchCardState {
     available: boolean;
     writable: boolean;
     dirty: boolean;
+    /** How many staged edits a save would write: fields whose draft differs from what is stored, plus pending secrets. */
+    changes: number;
     invalid: boolean;
     saving: boolean;
     failed: boolean;
@@ -57,9 +90,16 @@ export interface WebSearchCardState {
     /** Ids the judge / coverage provider controls offer: the presets plus the valid custom entries of the draft. */
     providerChoices: string[];
     rubrics: RubricCardState[];
+    /** Settings read only when the plugin starts (restart.ts) that have an edit waiting to be saved: a save would not take effect until a restart. */
+    restartTouched: string[];
     /** Overrides in settings that name no built-in rubric. */
     unknownRubrics: string[];
+    server: ServerState;
 }
+/** Every field spec of the form model, in display order. */
+export declare const ALL_SPECS: readonly FieldSpec[];
+/** The specs of the dynamic fields among `fields` (the text view prints them next to the fixed ones). */
+export declare function dynamicSpecsOf(fields: Readonly<Record<string, unknown>>): FieldSpec[];
 export declare class WebSearchSettingsController {
     private readonly scope;
     private readonly ctx;
@@ -75,7 +115,26 @@ export declare class WebSearchSettingsController {
     private credentialGeneration;
     private credentialRefSignature;
     private credentialStates;
+    private server;
+    private trialGeneration;
     constructor(scope: ConfigForm<Record<string, unknown>>, ctx: Context);
+    /** The Host's RPC client, read when it is used (the service may arrive after the card was registered); undefined where there is none. */
+    private rpc;
+    /** Ask the plugin what is ready now (the same local probes as `sources.status`). Silent when the Host has no transport. */
+    refreshStatus(): Promise<void>;
+    private setOverlay;
+    /** Read what the agent overlay holds (once when the panel opens, and on the refresh button). Silent where the Host has no transport. */
+    refreshOverlay(): Promise<void>;
+    /** Drop overlay entries (keys, or `'all'`) as the user. The plugin audits it; the card shows the overlay as it is afterwards. */
+    revokeOverlay(keys: readonly string[] | 'all', adopted?: boolean): Promise<boolean>;
+    /**
+     * "Adopt into configuration": write the overlay item's value into the profile with the Host's atomic `mutate` (the same call the save bar
+     * makes, at the leaf the item is about), and only when that landed ask the plugin to drop the entry. A failed write leaves both as they were.
+     */
+    adoptOverlay(key: string): Promise<boolean>;
+    /** Run one search of a custom CLI draft (rpc-types.ts `trial`). The outcome lands in `server.trial`. */
+    runTrial(request: TrialRequest): Promise<void>;
+    clearTrial(): void;
     inject(): {
         hooks: {
             webSearchPro: SnapshotStore<WebSearchCardState>;
@@ -89,6 +148,12 @@ export declare class WebSearchSettingsController {
         save: () => void;
         discard: () => void;
         refreshCredentials: () => void;
+        refreshStatus: () => void;
+        refreshOverlay: () => void;
+        revokeOverlay: (keys: readonly string[] | "all") => void;
+        adoptOverlay: (key: string) => void;
+        runTrial: (request: TrialRequest) => void;
+        clearTrial: () => void;
     };
     snapshot(): WebSearchCardState;
     edit(field: SettingField, text: string): void;
@@ -107,6 +172,12 @@ export declare class WebSearchSettingsController {
     refreshCredentials(): Promise<void>;
     dispose(): void;
     private project;
+    /** The start-up-only settings (restart.ts) whose staged edit differs from what is stored. */
+    private restartTouched;
+    /** `playwright` is one JSON field; only its `snapshotDir` is a start-up setting (`enabled` is live). */
+    private snapshotDirTouched;
+    /** Staged fields that differ from what is stored (a pending reset counts only when something is stored). */
+    private changedFields;
     private decorate;
     private projectRubrics;
     /** The state of one control from the staged draft, else from the Host section. */
@@ -117,11 +188,18 @@ export declare class WebSearchSettingsController {
      * evidence settings the draft would produce are then checked with the server's own validators.
      */
     private analyze;
+    /**
+     * The Host ops of a top-level field. A container the schema does not declare volatile as a whole (`playwright`: its keys are)
+     * is written key by key; every other field is one `set` or one `unset`.
+     */
+    private topOps;
     private opsOf;
     private credentialPlan;
     private writeCredential;
     /** The credentials ref / environment variable name each key is read from, from the saved settings (else the default). */
     private credentialRefs;
+    /** The `sources.confidence.<id>` fields that hold a value now or in the draft: the card shows these ids with their values. */
+    private dynamicFields;
     private spec;
     private resolvedRoot;
     private sectionValue;

package/lib/types/client/group-advanced.d.ts

@@ -0,0 +1,9 @@
+/**
+ * "Advanced: text mode": the settings as one commented YAML text, to read or copy. It is a view of the controls (it prints
+ * the staged state, secrets excluded), not a second place the settings live. Every key has a comment in front of it.
+ * @module web-search-pro/client/group-advanced
+ */
+import { type Card } from './field-rows.tsx';
+export declare function AdvancedGroup({ card }: {
+    card: Card;
+}): import("react").JSX.Element;

package/lib/types/client/group-agent.d.ts

@@ -0,0 +1,20 @@
+/**
+ * "Agent changes": what an agent changed with the `config.*` actions, kept apart from the user's configuration. The plugin keeps those
+ * changes in a managed overlay file that takes effect at once and never edits the profile; this group lists every entry with the reason
+ * and time the agent gave, the newest audit records, and for each entry two buttons: "Adopt into configuration" (write the value into
+ * the profile with the card's atomic write, then drop the overlay entry) and "Revoke" (drop it). "Revoke all" empties the overlay, which
+ * also repairs a file the plugin had to ignore. The card reads the overlay once when it opens and on the refresh button.
+ * @module web-search-pro/client/group-agent
+ */
+import type { OverlayItem } from '../overlay-types.ts';
+import { type Card } from './field-rows.tsx';
+/** One overlay entry: what it is, the value the agent set against the one in the configuration, why and when, and the two buttons. */
+export declare function AgentItem({ card, item, busy, items }: {
+    card: Card;
+    item: OverlayItem;
+    busy: boolean;
+    items: readonly OverlayItem[];
+}): import("react").JSX.Element;
+export declare function AgentGroup({ card }: {
+    card: Card;
+}): import("react").JSX.Element;

package/lib/types/client/group-cli.d.ts

@@ -0,0 +1,52 @@
+/**
+ * "Custom CLI": the command-line tools the user adds, as a list (id, command, purpose, confidence, whether the spec is valid) and one
+ * edit dialog per tool. The dialog is a form over the same spec the JSON box holds ("View JSON" at the bottom): editing either side
+ * rewrites the other, every problem is the server's own message shown by the control it is about, "Done" puts the spec into the
+ * draft (only when it is valid), and "Try it" runs the draft once through the plugin. The entries live inside `cliAdapters`.
+ * @module web-search-pro/client/group-cli
+ */
+import { type CliCheck, type CliForm } from './cli-form.ts';
+import { type Card } from './field-rows.tsx';
+type Json = Record<string, unknown>;
+/** What the dialog holds: the spec (the source of truth), the form fields read from it, the JSON box text, and the trial's sample query. */
+export interface CliDraft {
+    mode: 'new' | 'edit';
+    id: string;
+    spec: Json;
+    form: CliForm;
+    jsonText: string;
+    jsonError?: string;
+    query: string;
+}
+export declare function draftOf(mode: 'new' | 'edit', id: string, spec: Json): CliDraft;
+/** The draft after a form edit: the spec is rebuilt from the fields on top of the spec as it was, the JSON text follows. */
+export declare function editForm(draft: CliDraft, patch: Partial<CliForm>): CliDraft;
+/** A new entry's id; an existing one cannot be renamed (copy it instead). */
+export declare function editId(draft: CliDraft, id: string): CliDraft;
+/** The draft after the JSON box changed: a text that parses becomes the spec and the form is read from it; one that does not leaves both alone. */
+export declare function editJson(draft: CliDraft, text: string): CliDraft;
+/** What the form of one custom CLI shows and edits; presentational (the dialog and the render test both mount it). */
+export declare function CliBody({ card, draft, check, disabled, onForm, onId, onJson, onQuery, onTrial }: {
+    card: Card;
+    draft: CliDraft;
+    check: CliCheck;
+    disabled: boolean;
+    onForm: (patch: Partial<CliForm>) => void;
+    onId: (id: string) => void;
+    onJson: (text: string) => void;
+    onQuery: (text: string) => void;
+    onTrial: () => void;
+}): import("react").JSX.Element;
+export declare function CliDialog({ card, initial, taken, onClose }: {
+    card: Card;
+    initial: CliDraft;
+    taken: readonly string[];
+    onClose: () => void;
+}): import("react").JSX.Element;
+export declare function CliList({ card }: {
+    card: Card;
+}): import("react").JSX.Element;
+export declare function CliGroup({ card }: {
+    card: Card;
+}): import("react").JSX.Element;
+export {};

package/lib/types/client/group-common.d.ts

@@ -0,0 +1,12 @@
+/**
+ * "Common": what nearly everyone touches, open by default (every other group starts closed): the default engine chain with the
+ * order a search would really try, the result count, parallel fusion, the tool surface, the proxy fake-IP switch, and the
+ * DeepSeek Search source (常用) with its page-reading switch.
+ * @module web-search-pro/client/group-common
+ */
+import { type Card } from './field-rows.tsx';
+/** The names of the common group's fields, in order. */
+export declare const COMMON_FIELDS: readonly ["searchMaxResults", "parallelEngines", "toolSurface", "allowProxyFakeIp", "deepseekFetch"];
+export declare function CommonGroup({ card }: {
+    card: Card;
+}): import("react").JSX.Element;

package/lib/types/client/group-judge.d.ts

@@ -0,0 +1,17 @@
+/**
+ * "Scoring model": the optional model judge (mode, provider, coverage judge, usage caps), its custom providers as a JSON list,
+ * and the judge prompts (rubrics) as a list: a row each (name, active version, default or overridden) and an edit dialog that
+ * puts the built-in text beside your override. The dialog edits the same staged entry the rest of the card writes on save.
+ * @module web-search-pro/client/group-judge
+ */
+import { BUILTIN_RUBRIC_IDS } from '../pipeline/rubrics-spec.ts';
+import { type Card } from './field-rows.tsx';
+/** The controls of one rubric override: each is a view of the one staged entry; the built-in text sits beside it. */
+export declare function RubricForm({ card, id }: {
+    card: Card;
+    id: string;
+}): import("react").JSX.Element;
+export { BUILTIN_RUBRIC_IDS };
+export declare function JudgeGroup({ card }: {
+    card: Card;
+}): import("react").JSX.Element;

package/lib/types/client/group-order.d.ts

@@ -0,0 +1,26 @@
+/**
+ * "Search order": the order a plain search tries its engines, and the order each platform tries its backends, as lists one
+ * moves, adds to and removes from (not as a comma text). Below the engine list sits the order a search would really use, with a
+ * sentence on why it differs from the list; the platforms are rows with a dialog. Everything stages into the same draft the sticky
+ * save bar writes: `engines` and `platformBackends` as they are, `sources.confidence.<id>` for the confidence box of a row.
+ * @module web-search-pro/client/group-order
+ */
+import { type Card } from './field-rows.tsx';
+/** The chain a plain search would try, from the draft, and one sentence on why it is not the list as written. */
+export declare function EffectiveChain({ card }: {
+    card: Card;
+}): import("react").JSX.Element;
+export declare function EngineOrder({ card }: {
+    card: Card;
+}): import("react").JSX.Element;
+/** The body of the platform dialog: the chain as a list with its buttons, the backends that can still be added, and "Restore default". */
+export declare function PlatformForm({ card, platform }: {
+    card: Card;
+    platform: string;
+}): import("react").JSX.Element;
+export declare function PlatformList({ card }: {
+    card: Card;
+}): import("react").JSX.Element;
+export declare function OrderGroup({ card }: {
+    card: Card;
+}): import("react").JSX.Element;

package/lib/types/client/group-runtime.d.ts

@@ -0,0 +1,15 @@
+/**
+ * "Runtime and backends": the CLI / OpenCLI / Agent Reach switches, the Twitter / X login values (a dialog), the JSON objects
+ * that shape backends (Playwright, platform backend chains, CLI adapters) and the platform settings (custom platforms,
+ * selectors, browser bindings), each as a list with its own dialog. The backend order of the platforms and the custom CLIs have their own
+ * groups ("Search order", "Custom CLI"); their raw JSON is under "Advanced".
+ * @module web-search-pro/client/group-runtime
+ */
+import { type Card } from './field-rows.tsx';
+/** The two values twitter-cli needs: the controls of the dialog. */
+export declare function TwitterForm({ card }: {
+    card: Card;
+}): import("react").JSX.Element;
+export declare function RuntimeGroup({ card }: {
+    card: Card;
+}): import("react").JSX.Element;

package/lib/types/client/group-sources.d.ts

@@ -0,0 +1,46 @@
+/**
+ * "Sources": how sources are ranked (policy, priority, disabled) and a list of the sources that need a key or an address: a
+ * row per source (name, tier, whether its key is set, and the "常用" mark), and one edit dialog per source holding its key
+ * reference, write-only key, endpoint and request budget. The anonymous sources are a folded reference table. Edits stage into
+ * the same draft the sticky save bar writes; a dialog has no save button of its own.
+ * @module web-search-pro/client/group-sources
+ */
+import { type Card } from './field-rows.tsx';
+import { type SourceDef } from './field-keys.ts';
+import type { CredentialId } from './form.ts';
+/** The write-only key of a source. It shows whether a key is stored, never the key. */
+export declare function SecretRow({ card, id, label }: {
+    card: Card;
+    id: CredentialId;
+    label: string;
+}): import("react").JSX.Element;
+/** Whether a source is usable as far as the card can tell: its key is stored, or (SearXNG) its address is set. */
+export declare function useSourceReady(card: Card, def: SourceDef): {
+    ready: boolean;
+    loading: boolean;
+};
+/** The controls of one source: reference name, write-only key, endpoint, extras and request budget. */
+export declare function SourceForm({ card, def }: {
+    card: Card;
+    def: SourceDef;
+}): import("react").JSX.Element;
+/** One source's edit dialog. */
+export declare function SourceDialog({ card, def, onClose }: {
+    card: Card;
+    def: SourceDef;
+    onClose: () => void;
+}): import("react").JSX.Element;
+/** One row of the sources list. */
+export declare function SourceItem({ card, def, onEdit }: {
+    card: Card;
+    def: SourceDef;
+    onEdit: () => void;
+}): import("react").JSX.Element;
+/** Open dialog state shared by the Common and Sources groups: one source at a time. */
+export declare function SourceList({ card, only }: {
+    card: Card;
+    only?: readonly string[];
+}): import("react").JSX.Element;
+export declare function SourcesGroup({ card }: {
+    card: Card;
+}): import("react").JSX.Element;

package/lib/types/client/groups-basic.d.ts

@@ -0,0 +1,18 @@
+/**
+ * The small groups: "Reading and evidence", "Network and cache", "Ranking weights" (advanced) and the built-in web tool
+ * "Route". Each is a handful of rows built from the same controls; the long explanations sit behind the `?`.
+ * @module web-search-pro/client/groups-basic
+ */
+import { type Card } from './field-rows.tsx';
+export declare function ReadingGroup({ card }: {
+    card: Card;
+}): import("react").JSX.Element;
+export declare function NetworkGroup({ card }: {
+    card: Card;
+}): import("react").JSX.Element;
+export declare function RankingGroup({ card }: {
+    card: Card;
+}): import("react").JSX.Element;
+export declare function RouteGroup({ card }: {
+    card: Card;
+}): import("react").JSX.Element;

package/lib/types/client/index.d.ts

@@ -1,6 +1,7 @@
 import type { PropsLocale } from '@deepseek-ai/dsh-client-ui-slots';
 import type { Context } from './context-types.ts';
 import { type CredentialId, type RubricTextKey, type SettingField, type WebSearchCardState } from './form.ts';
+import type { TrialRequest } from '../rpc-types.ts';
 export declare const name = "web-search-pro-client";
 export declare const inject: string[];
 export declare const NS = "web-search-pro.card";
@@ -16,5 +17,12 @@ export type SettingsCardProps = PropsLocale<typeof NS> & {
     save: () => void;
     discard: () => void;
     refreshCredentials: () => void;
+    refreshStatus: () => void;
+    /** The agent overlay: read it again, drop entries (keys, or `'all'`), write one into the configuration and drop it. */
+    refreshOverlay: () => void;
+    revokeOverlay: (keys: readonly string[] | 'all') => void;
+    adoptOverlay: (key: string) => void;
+    runTrial: (request: TrialRequest) => void;
+    clearTrial: () => void;
 };
 export declare function apply(ctx: Context): void;

package/lib/types/client/json-list.d.ts

@@ -0,0 +1,21 @@
+/**
+ * The settings that are whole JSON objects (custom providers, platform backend chains, CLI adapters, custom platforms, ...) as a
+ * list: a row each (name, how many entries it holds, "default" while it is empty) and one dialog with a code box and the
+ * server's own validation message. Nothing here is a second place the data lives: the box edits the same staged field.
+ * @module web-search-pro/client/json-list
+ */
+import { type Card } from './field-rows.tsx';
+/** How many entries a JSON object text holds; undefined when it is not an object. */
+export declare function entryCount(text: string): number | undefined;
+/** The code box of one JSON field. */
+export declare function JsonForm({ card, field }: {
+    card: Card;
+    field: string;
+}): import("react").JSX.Element;
+/** A list of JSON-object settings with its dialog. `fields` names which ones (see JSON_FIELDS). */
+export declare function JsonList({ card, fields }: {
+    card: Card;
+    fields: readonly string[];
+}): import("react").JSX.Element;
+/** The fields of one group of JSON settings. */
+export declare const jsonFieldsOf: (group: "judge" | "runtime" | "platform" | "advanced") => string[];