@qilin-agent/client-ui-settings-plugins 0.0.0-stage → 3.1.3

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

@@ -0,0 +1,32 @@
+/** Shared presentation and actions for the two Host-owned Subagent settings sections. */
+import type { CardShell } from './card-form.ts';
+import type { SubagentLimitsCardFace, SubagentLimitsCardState } from './subagent-limits-card-controller.ts';
+import type { SubagentModelSelectionCardFace, SubagentModelSelectionCardState } from './subagent-model-selection-card-controller.ts';
+/** Both existing form sources and the actions exposed by one Subagent card. */
+export interface SubagentCardFace {
+    hooks: SubagentLimitsCardFace['hooks'] & SubagentModelSelectionCardFace['hooks'];
+    editLimit: SubagentLimitsCardFace['edit'];
+    resetLimit: SubagentLimitsCardFace['resetField'];
+    toggleEnabled: SubagentModelSelectionCardFace['toggleEnabled'];
+    toggleModel: SubagentModelSelectionCardFace['toggleModel'];
+    retryCatalog: SubagentModelSelectionCardFace['retryCatalog'];
+    /** Save valid drafts through their owning namespace controllers. */
+    save: () => void;
+    /** Discard both drafts without changing persisted settings. */
+    discard: () => void;
+}
+/**
+ * Derive the shared card state without duplicating either form's subscriptions.
+ * @param limits - Current delegation-limit form.
+ * @param models - Current model-authorization form.
+ * @returns Availability and settlement across the sections this Host serves.
+ */
+export declare function subagentCardShell(limits: SubagentLimitsCardState, models: SubagentModelSelectionCardState): CardShell;
+/**
+ * Compose one card from the existing forms; each write retains its namespace revision fence.
+ * @param limits - Limit form source and actions.
+ * @param models - Model form source and actions.
+ * @returns Framework-bound sources and shared save/discard actions.
+ */
+export declare function subagentCardFace(limits: SubagentLimitsCardFace, models: SubagentModelSelectionCardFace): SubagentCardFace;
+//# sourceMappingURL=subagent-card-controller.d.ts.map

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

@@ -0,0 +1,33 @@
+/** Staged delegation limits backed by the Host's subagent settings section. */
+import type { SnapshotStore } from '@qilin-agent/client-store';
+import type { ConfigForm } from '@qilin-agent/client-ui-settings/client';
+import { type CardActions, type CardFieldState, type CardShell } from './card-form.ts';
+/** Host-owned delegation defaults and live capacity. */
+export interface SubagentLimitsSettings {
+    maxDepth: number;
+    maxActiveSubagents: number;
+}
+/** Effective values and drafts presented by the limits card. */
+export interface SubagentLimitsCardState extends CardShell {
+    maxDepth: CardFieldState;
+    maxActiveSubagents: CardFieldState;
+}
+/** Actions and observable state bound by the slot renderer. */
+export interface SubagentLimitsCardFace extends CardActions {
+    hooks: {
+        subagentLimitsCard: SnapshotStore<SubagentLimitsCardState>;
+    };
+}
+/** Bind two independently resettable limits to one staged settings form. */
+export declare class SubagentLimitsCardController {
+    private readonly form;
+    private readonly store;
+    /** @param scope - The Host's `subagent` settings section. */
+    constructor(scope: ConfigForm<SubagentLimitsSettings>);
+    /**
+     * Bind the limits editor to the slot renderer.
+     * @returns The limits snapshot and staged write actions.
+     */
+    inject(): SubagentLimitsCardFace;
+}
+//# sourceMappingURL=subagent-limits-card-controller.d.ts.map

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

@@ -0,0 +1,129 @@
+/** Staged editor for the Host-owned subagent model allowlist. */
+import type { Context as ClientContext } from '@qilin-agent/kylin';
+import type { ModelProviderGroup } from '@qilin-agent/api-remotes/client';
+import { type SnapshotStore } from '@qilin-agent/client-store';
+import type { ConfigForm } from '@qilin-agent/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 ctx;
+    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 ctx - the card plugin's context, whose `remote.session` namespace
+     * answers the Host model catalog.
+     */
+    constructor(scope: ConfigForm<SubagentModelSelectionSettings>, ctx: ClientContext);
+    /** 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/web-search-card-controller.d.ts

@@ -0,0 +1,93 @@
+/**
+ * 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 { Context as ClientContext } from '@qilin-agent/kylin';
+import type { SnapshotStore } from '@qilin-agent/client-store';
+import type { ConfigForm } from '@qilin-agent/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;
+}
+/** 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 ctx;
+    private readonly form;
+    private readonly store;
+    private credential;
+    /**
+     * @param scope - the bound settings scope for the `web-search-deepseek` namespace.
+     * @param ctx - the card plugin's context, whose `remote.credentials` namespace
+     * answers for the credential the section references.
+     */
+    constructor(scope: ConfigForm<WebSearchSettings>, ctx: ClientContext);
+    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 qilin.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/package.json

@@ -1,6 +1,69 @@
 {
   "name": "@qilin-agent/client-ui-settings-plugins",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
+  "description": "Plugins settings section with feature-owned tabs and configurable host-plane plugin cards",
+  "version": "3.1.3",
+  "publishConfig": {
+    "access": "public"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/kkutysllb/QiLin.git",
+    "directory": "packages/client/ui-settings-plugins"
+  },
+  "engines": {
+    "node": "^22.19.0 || >=24.0.0"
+  },
+  "type": "module",
+  "main": "lib/index.js",
+  "types": "lib/types/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./lib/types/index.d.ts",
+      "default": "./lib/index.js"
+    },
+    "./client": {
+      "types": "./lib/types/client/index.d.ts",
+      "default": "./lib/client.js"
+    },
+    "./src/*": "./src/*",
+    "./package.json": "./package.json"
+  },
+  "qilin": {
+    "client": {
+      "inject": [
+        "@qilin-agent/client-locale",
+        "@qilin-agent/client-ui-settings",
+        "@qilin-agent/api-remotes"
+      ],
+      "platform": "web"
+    }
+  },
+  "license": "MIT",
+  "peerDependencies": {
+    "@qilin-agent/kylin": "~4.0.3"
+  },
+  "devDependencies": {
+    "@types/react": "~18.3.1",
+    "clsx": "^2.0.0",
+    "react": "^18.2.0",
+    "@qilin-agent/kylin": "~4.0.3",
+    "@qilin-agent/api-remotes": "3.1.3",
+    "@qilin-agent/client-locale": "3.1.3",
+    "@qilin-agent/client-store": "3.1.3",
+    "@qilin-agent/client-ui-plugin-manager": "3.1.3",
+    "@qilin-agent/client-test-runtime": "3.1.3",
+    "@qilin-agent/client-ui-primitives": "3.1.3",
+    "@qilin-agent/client-ui-renderer": "3.1.3",
+    "@qilin-agent/client-ui-slots": "3.1.3",
+    "@qilin-agent/client-ui-settings": "3.1.3"
+  },
+  "files": [
+    "lib/index.js",
+    "lib/client.js",
+    "lib/types/**/*.d.ts"
+  ],
+  "scripts": {
+    "bundle": "tsdown",
+    "watch": "tsdown --watch"
+  }
 }