@prettier-ai/dsh-client-ui-settings-plugins 0.1.2-alpha.1

package/lib/types/client/subagent-model-selection-card-controller.d.ts

@@ -0,0 +1,127 @@
+/** Staged editor for the Host-owned subagent model allowlist. */
+import type { ClientRemote, ModelProviderGroup } from '@prettier-ai/dsh-api-remotes/client';
+import { type SnapshotStore } from '@prettier-ai/dsh-client-store';
+import type { SettingsScope } from '@prettier-ai/dsh-client-ui-settings/client';
+import type { CardShell } from './card-form.ts';
+/** Namespace of the Host-owned subagent model-selection preference. */
+export declare const SUBAGENT_MODEL_SELECTION_NS = "subagent-model-selection";
+/** One exact provider/model route stored as user authorization. */
+export interface AllowedSubagentModel {
+    provider: string;
+    model: string;
+}
+/** Settings fields stored for subagent model selection. */
+export interface SubagentModelSelectionSettings {
+    /** Whether model-facing child route selection applies to new Sessions. */
+    enabled: boolean;
+    /** Exact child routes offered to newly composed top-level Sessions. */
+    allowedModels: AllowedSubagentModel[];
+}
+/** One catalog row joined with a stored route that may no longer be advertised. */
+export interface SubagentModelCandidate extends AllowedSubagentModel {
+    /** Stable opaque identity used only for lookup. */
+    key: string;
+    /** Adapter-owned provider display name. */
+    providerName: string;
+    /** Adapter-owned model display name. */
+    modelName: string;
+    /** Whether the current adapter catalog advertises this exact route. */
+    available: boolean;
+    /** Whether the current draft authorizes this route. */
+    selected: boolean;
+}
+/** State rendered by the staged allowlist card. */
+export interface SubagentModelSelectionCardState extends CardShell {
+    /** Whether the draft enables model-facing child route selection. */
+    enabled: boolean;
+    /** Live catalog joined with stored routes. */
+    candidates: readonly SubagentModelCandidate[];
+    /** Adapter-directory request state. */
+    catalogStatus: 'idle' | 'loading' | 'ready' | 'error';
+    /** Whether any provider-local catalog request failed. */
+    catalogPartial: boolean;
+    /** Whether a newer Host revision invalidated the current draft. */
+    conflicted: boolean;
+}
+/** Registration-side face for the subagent model-selection card. */
+export interface SubagentModelSelectionCardFace {
+    hooks: {
+        /** Card snapshot bound by the renderer as useSubagentModelSelectionCard. */
+        subagentModelSelectionCard: SnapshotStore<SubagentModelSelectionCardState>;
+    };
+    /** Stage the enabled state; enabling also loads the adapter directory. */
+    toggleEnabled: () => void;
+    /** Stage one exact route as allowed or denied. */
+    toggleModel: (key: string) => void;
+    /** Retry the adapter directory. */
+    retryCatalog: () => void;
+    /** Persist the switch and exact routes as one revision-fenced mutation. */
+    save: () => void;
+    /** Drop the staged enabled state and route choices. */
+    discard: () => void;
+}
+/**
+ * Stable identity for one exact route; callers resolve it by lookup and never parse it.
+ * @param route - Provider/model route to identify.
+ * @returns Opaque key for lookup within the card.
+ */
+export declare function subagentModelKey(route: AllowedSubagentModel): string;
+/**
+ * Join live adapter metadata with stored routes that remain removable after disappearance.
+ * @param groups - Current model directory grouped by provider.
+ * @param stored - Routes in the effective settings value.
+ * @param selected - Opaque route keys selected in the current draft.
+ * @returns Candidate rows for the card.
+ */
+export declare function subagentModelCandidates(groups: readonly ModelProviderGroup[], stored: readonly AllowedSubagentModel[], selected: ReadonlySet<string>): SubagentModelCandidate[];
+/** Bridges one settings scope and the live adapter directory onto a staged card. */
+export declare class SubagentModelSelectionCardController {
+    private readonly scope;
+    private readonly session;
+    private catalogGroups;
+    private catalogPartial;
+    private catalogStatus;
+    private draftEnabled;
+    private draftRoutes;
+    private draftRevision;
+    private saving;
+    private failed;
+    private conflicted;
+    private disposed;
+    private saveGeneration;
+    private catalogGeneration;
+    private readonly store;
+    private readonly unsubscribe;
+    /**
+     * @param scope - bound `subagent-model-selection` settings scope.
+     * @param session - Host Session model-catalog face.
+     */
+    constructor(scope: SettingsScope<SubagentModelSelectionSettings>, session: Pick<ClientRemote['session'], 'modelCatalog'>);
+    /** Stop observing settings and suppress late directory/write settlements. */
+    dispose(): void;
+    /**
+     * Build the renderer face for this card.
+     * @returns The snapshot and staged card actions injected into the renderer.
+     */
+    inject(): SubagentModelSelectionCardFace;
+    private currentRoutes;
+    private currentEnabled;
+    private selected;
+    private enabled;
+    private beginDraft;
+    private toggleEnabled;
+    private toggleModel;
+    private clearDraft;
+    private discard;
+    private candidates;
+    private desiredRoutes;
+    private save;
+    /** Invalidate and reload model candidates after a Host model input changes. */
+    refreshCatalog(): void;
+    /** Drop Host-specific candidates and drafts, then reload after reconnecting. */
+    resetConnection(): void;
+    private loadCatalog;
+    private projection;
+    private publish;
+}
+//# sourceMappingURL=subagent-model-selection-card-controller.d.ts.map

package/lib/types/client/tab-store.d.ts

@@ -0,0 +1,65 @@
+/**
+ * The configurable-plugins tab's card list.
+ *
+ * The tab dispatches its slot by settings namespace, so what it renders is
+ * the intersection of two ledgers: the namespaces the Host serves and the
+ * cards registered into `settings.plugin.item`. A served namespace no card
+ * claims renders nothing — another surface owns it, or this deployment ships
+ * no browser half for it — and a card whose namespace the Host does not serve
+ * is never dispatched, so a plugin this deployment did not compose leaves no
+ * trace and does not count toward the empty line.
+ */
+import type { SettingsDescribeFace } from '@prettier-ai/dsh-client-ui-settings/client';
+import type { StoredEntry } from '@prettier-ai/dsh-client-ui-slots';
+import { type SnapshotStore } from '@prettier-ai/dsh-client-store';
+/** What the section renders. */
+export interface ConfigurablePluginsTabState {
+    /**
+     * Whether the Host has answered once. The empty line waits for it: an
+     * unanswered read is not the same statement as "this deployment configures
+     * no plugin", and saying the second while the first is true would flash a
+     * wrong answer on every open.
+     */
+    loaded: boolean;
+    /**
+     * Namespaces to dispatch, in the order their cards registered, narrowed to
+     * those the Host serves. Card registration order rather than the Host's
+     * description order: the latter follows plugin activation, which async
+     * settings injection can reorder between boots, and a settings page whose
+     * cards move between visits is worse than one whose order a registrant
+     * chose.
+     */
+    namespaces: string[];
+}
+/** The registration-side face the tab's slot entry injects. */
+export interface ConfigurablePluginsTabFace {
+    hooks: {
+        /** Section snapshot bound by the renderer as usePluginConfigSection. */
+        configurablePlugins: SnapshotStore<ConfigurablePluginsTabState>;
+    };
+}
+/** Derives the served namespaces from the shared describe mirror and pairs them with the cards that claim them. */
+export declare class ConfigurablePluginsTabController {
+    private readonly describeFace;
+    private readonly entries;
+    private readonly store;
+    private disposed;
+    private readonly unsubscribe;
+    /**
+     * @param describeFace - the shared mirror's describe face; its refreshes
+     * (document commits, reconnects) are what keep the served set current.
+     * @param entries - reads the cards currently registered into the section's slot.
+     */
+    constructor(describeFace: SettingsDescribeFace, entries: () => readonly StoredEntry[]);
+    /** Republish after the slot ledger changed; a card registered late joins here. */
+    refresh(): void;
+    /** Stop publishing and stop following the mirror. */
+    dispose(): void;
+    /**
+     * Build the face the tab's slot registration injects.
+     * @returns the tab's snapshot source.
+     */
+    inject(): ConfigurablePluginsTabFace;
+    private publish;
+}
+//# sourceMappingURL=tab-store.d.ts.map

package/lib/types/client/web-search-card-controller.d.ts

@@ -0,0 +1,94 @@
+/**
+ * The web-search card's staged form over the `web-search-deepseek` settings
+ * namespace.
+ *
+ * The key is the one control that does not live in the section: its literal
+ * never rides a response, so the card learns only whether one is configured
+ * and writes it through the credentials domain, addressed by the reference the
+ * section names. It is still staged with the rest of the form, so one save
+ * covers everything the card shows.
+ */
+import type { ClientRemote } from '@prettier-ai/dsh-api-remotes/client';
+import type { SnapshotStore } from '@prettier-ai/dsh-client-store';
+import type { SettingsScope } from '@prettier-ai/dsh-client-ui-settings/client';
+import { type CardActions, type CardFieldState, type CardShell } from './card-form.ts';
+/**
+ * Namespace of the DeepSeek search provider. Spelled here rather than
+ * imported: a client package must not depend on a Host package.
+ */
+export declare const WEB_SEARCH_NS = "web-search-deepseek";
+/** The search-provider fields this card edits. */
+export interface WebSearchSettings {
+    /** Credential reference naming the environment key. */
+    apiKeyEnv?: string;
+    /** Provider endpoint; blank inherits the provider default. */
+    baseURL?: string;
+    /** Maximum searches served within one request. */
+    maxUses?: number;
+}
+/** The credentials Remote methods this card reads and writes through. */
+export type WebSearchCredentials = Pick<ClientRemote['credentials'], 'describe' | 'set'>;
+/** What the web-search card renders. */
+export interface WebSearchCardState extends CardShell {
+    /** Provider endpoint. */
+    baseURL: CardFieldState;
+    /** Searches allowed per request. */
+    maxUses: CardFieldState;
+    /** The staged credential, which starts blank on every load. */
+    apiKey: CardFieldState;
+    /** Whether the Host reports a credential configured for the referenced key. */
+    apiKeyConfigured: boolean;
+    /** Whether the credentials domain accepts a write for it; false disables the control. */
+    apiKeyWritable: boolean;
+}
+/** The registration-side face the web-search card's slot entry injects. */
+export interface WebSearchCardFace extends CardActions {
+    hooks: {
+        /** Card snapshot bound by the renderer as useWebSearchCard. */
+        webSearchCard: SnapshotStore<WebSearchCardState>;
+    };
+}
+/** Bridges the `web-search-deepseek` scope and the credentials domain onto the card. */
+export declare class WebSearchCardController {
+    private readonly scope;
+    private readonly credentials;
+    private readonly form;
+    private readonly store;
+    private credential;
+    /**
+     * @param scope - the bound settings scope for the `web-search-deepseek` namespace.
+     * @param credentials - Remote face used for the credential the section references.
+     */
+    constructor(scope: SettingsScope<WebSearchSettings>, credentials: WebSearchCredentials);
+    private projection;
+    /**
+     * Ask the credentials domain about the reference the section currently names.
+     *
+     * The answer is stored with the reference it describes: `apiKeyEnv` can
+     * change between the request and its response, and two reads can settle out
+     * of order, so a response is published only while it still answers for the
+     * reference in force.
+     */
+    private readCredential;
+    /**
+     * Re-read after the Host reports a change to the reference this card watches.
+     *
+     * A key can be written from somewhere else — the Models page addresses the
+     * same reference — and the settings section does not change when it is, so
+     * without this the badge keeps reporting a state the Host already replaced.
+     * @param ref - the reference the Host reports as changed.
+     */
+    refreshCredential(ref: string): void;
+    /**
+     * Build the face the card's slot registration injects.
+     * @returns the card's snapshot and its form actions.
+     */
+    inject(): WebSearchCardFace;
+    /**
+     * Write the staged key, then re-read whether the Host now holds one.
+     * @param value - the staged credential literal.
+     * @returns whether the Host reports a configured credential afterwards.
+     */
+    private writeKey;
+}
+//# sourceMappingURL=web-search-card-controller.d.ts.map

package/lib/types/index.d.ts

@@ -0,0 +1,11 @@
+/**
+ * Plugins settings surface, node half. The empty apply exists so the plugin
+ * appears in the host cordis.yml / Loader; the browser half owns the section
+ * and its configurable tab through exports["./client"], discovered from the
+ * package.json dsh.client declaration. Every section this page edits is owned
+ * by the Host plugin that registered it, so this package registers no
+ * namespace of its own.
+ */
+/** Host plugin body — no host-side behavior for this surface plugin. */
+export declare function apply(): void;
+//# sourceMappingURL=index.d.ts.map

package/lib/types/invariant.d.ts

@@ -0,0 +1,16 @@
+/**
+ * Package-owned invariant companion for `@prettier-ai/dsh-client-ui-settings-plugins`.
+ * @module @prettier-ai/dsh-client-ui-settings-plugins/invariant
+ */
+import type { Context } from '@prettier-ai/cordis';
+/** Cordis companion plugin name. */
+export declare const name = "client-ui-settings-plugins-invariant";
+/** Service required before the companion can reserve package ownership. */
+export declare const inject: string[];
+/**
+ * Register this package's invariant companion.
+ * @param ctx - Cordis context carrying the invariant service.
+ * @returns the installed registration's disposer after setup succeeds.
+ */
+export declare const apply: (ctx: Context) => Promise<() => void>;
+//# sourceMappingURL=invariant.d.ts.map

package/package.json

@@ -0,0 +1,81 @@
+{
+  "name": "@prettier-ai/dsh-client-ui-settings-plugins",
+  "description": "Plugins settings section with feature-owned tabs and configurable host-plane plugin cards",
+  "version": "0.1.2-alpha.1",
+  "publishConfig": {
+    "access": "public"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/deepseek-ai/deepseek-harness.git",
+    "directory": "packages/client/ui-settings-plugins"
+  },
+  "type": "module",
+  "main": "lib/index.js",
+  "types": "lib/types/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./lib/types/index.d.ts",
+      "default": "./lib/index.js"
+    },
+    "./invariant": {
+      "types": "./lib/types/invariant.d.ts",
+      "default": "./lib/invariant.js"
+    },
+    "./client": {
+      "types": "./lib/types/client/index.d.ts",
+      "default": "./lib/client.js"
+    },
+    "./src/*": "./src/*",
+    "./package.json": "./package.json"
+  },
+  "dsh": {
+    "client": {
+      "inject": [
+        "@prettier-ai/dsh-client-connection",
+        "@prettier-ai/dsh-client-locale",
+        "@prettier-ai/dsh-client-ui-settings",
+        "@prettier-ai/dsh-api-remotes"
+      ],
+      "platform": "web"
+    }
+  },
+  "license": "MIT",
+  "peerDependencies": {
+    "@prettier-ai/cordis": "^4.0.1",
+    "@prettier-ai/dsh-api-remotes": "^0.1.2-alpha.1",
+    "@prettier-ai/dsh-client-connection": "^0.1.2-alpha.1",
+    "@prettier-ai/dsh-client-locale": "^0.1.2-alpha.1",
+    "@prettier-ai/dsh-invariants": "^0.1.2-alpha.1",
+    "@prettier-ai/dsh-client-ui-settings": "^0.1.2-alpha.1",
+    "@prettier-ai/dsh-client-ui-renderer": "^0.1.2-alpha.1"
+  },
+  "devDependencies": {
+    "@types/react": "~18.3.1",
+    "react": "^18.2.0",
+    "@prettier-ai/cordis": "^4.0.1",
+    "@prettier-ai/dsh-client-connection": "^0.1.2-alpha.1",
+    "@prettier-ai/dsh-api-remotes": "^0.1.2-alpha.1",
+    "@prettier-ai/dsh-client-locale": "^0.1.2-alpha.1",
+    "@prettier-ai/dsh-client-store": "^0.1.2-alpha.1",
+    "@prettier-ai/dsh-client-test-runtime": "^0.1.2-alpha.1",
+    "@prettier-ai/dsh-client-ui-primitives": "^0.1.2-alpha.1",
+    "@prettier-ai/dsh-client-ui-settings": "^0.1.2-alpha.1",
+    "@prettier-ai/dsh-invariants": "^0.1.2-alpha.1",
+    "@prettier-ai/dsh-client-ui-renderer": "^0.1.2-alpha.1",
+    "@prettier-ai/dsh-client-ui-slots": "^0.1.2-alpha.1"
+  },
+  "files": [
+    "lib/index.js",
+    "lib/invariant.js",
+    "lib/client.js",
+    "lib/types/**/*.d.ts"
+  ],
+  "dependencies": {
+    "clsx": "^2.0.0"
+  },
+  "scripts": {
+    "bundle": "tsdown",
+    "watch": "tsdown --watch"
+  }
+}