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

package/lib/index.js

@@ -0,0 +1,13 @@
+//#region lib/types/index.js
+/**
+* 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. */
+function apply() {}
+//#endregion
+export { apply };

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

@@ -0,0 +1,12 @@
+/** The agent loop's configuration page: how many tool calls one step may run at once. */
+import type { InjectFace, PropsLocale, PropsRuntime } from '@qilin-agent/client-ui-slots';
+import type { AgentLoopCardFace } from './agent-loop-card-controller.ts';
+/** Props the renderer binds for the agent-loop page. */
+export type AgentLoopCardProps = PropsRuntime<'plugins.item'> & PropsLocale<'settings.plugins'> & InjectFace<AgentLoopCardFace>;
+/**
+ * Render the agent loop's one-liner or its configuration form, as the Plugins page asks.
+ * @param props - the view asked for, locale copy, the form snapshot, and its actions.
+ * @returns the one-liner, or the form.
+ */
+export declare function AgentLoopCard(props: AgentLoopCardProps): string | import("react").JSX.Element;
+//# sourceMappingURL=AgentLoopCard.d.ts.map

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

@@ -0,0 +1,12 @@
+/** The shell plugin's configuration page: the limits every command the agent runs is bound by. */
+import type { InjectFace, PropsLocale, PropsRuntime } from '@qilin-agent/client-ui-slots';
+import type { BashCardFace } from './bash-card-controller.ts';
+/** Props the renderer binds for the shell page. */
+export type BashCardProps = PropsRuntime<'plugins.item'> & PropsLocale<'settings.plugins'> & InjectFace<BashCardFace>;
+/**
+ * Render the shell plugin's one-liner or its configuration form, as the Plugins page asks.
+ * @param props - the view asked for, locale copy, the form snapshot, and its actions.
+ * @returns the one-liner, or the form.
+ */
+export declare function BashCard(props: BashCardProps): string | import("react").JSX.Element;
+//# sourceMappingURL=BashCard.d.ts.map

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

@@ -0,0 +1,12 @@
+/** The Git plugin's configuration page: the binaries and limits every repository and pull-request call is bound by. */
+import type { InjectFace, PropsLocale, PropsRuntime } from '@qilin-agent/client-ui-slots';
+import type { GitCardFace } from './git-card-controller.ts';
+/** Props the renderer binds for the Git page. */
+export type GitCardProps = PropsRuntime<'plugins.item'> & PropsLocale<'settings.plugins'> & InjectFace<GitCardFace>;
+/**
+ * Render the Git plugin's one-liner or its configuration form, as the Plugins page asks.
+ * @param props - the view asked for, locale copy, the form snapshot, and its actions.
+ * @returns the one-liner, or the form.
+ */
+export declare function GitCard(props: GitCardProps): string | import("react").JSX.Element;
+//# sourceMappingURL=GitCard.d.ts.map

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

@@ -0,0 +1,34 @@
+/**
+ * One plugin's configuration form as its page on the Plugins page shows it:
+ * the read-only notice when the deployment stores settings read-only, the
+ * plugin's controls, and the save that writes every staged edit. The page
+ * draws the plugin's title and one-liner itself.
+ *
+ * Only a save writes. Leaving the page drops every staged edit, so the form
+ * discards on unmount and offers no discard control. A form whose namespace
+ * the Host stopped serving says so in place of its controls rather than
+ * showing fields nothing would accept.
+ */
+import { type ReactNode } from 'react';
+import type { SettingsFormShell } from '@qilin-agent/client-ui-primitives';
+import type { PluginsSettingsLocaleKey } from './locales.ts';
+/** Form chrome shared by every plugin configuration page. */
+export interface PluginConfigFormProps {
+    /** Locale reader for this package's copy. */
+    t: (key: PluginsSettingsLocaleKey) => string;
+    /** The form state: availability, writability, and what a save would do. */
+    state: SettingsFormShell;
+    /** Write every staged edit. */
+    onSave: () => void;
+    /** Drop every staged edit; the form calls it when it leaves the page. */
+    onDiscard: () => void;
+    /** The plugin's controls. */
+    children: ReactNode;
+}
+/**
+ * Render one plugin's configuration form.
+ * @param props - the form state, its controls, and the save and discard actions.
+ * @returns the form, or the unavailable line while the namespace is not served.
+ */
+export declare function PluginConfigForm(props: PluginConfigFormProps): import("react").JSX.Element;
+//# sourceMappingURL=PluginConfigForm.d.ts.map

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

@@ -0,0 +1,27 @@
+/** Plugins settings section: localized tabs around feature-owned pages. */
+import type { HostObservable, InjectFace, PropsLocale, PropsRenderSlots, PropsRuntime } from '@qilin-agent/client-ui-slots';
+import type { PluginsSettingsLocaleKey } from './locales.ts';
+/** One tab projected from a `settings.plugins.tab` contribution. */
+export interface PluginsSettingsTabEntry {
+    id: string;
+    order: number;
+    label: string;
+}
+/** Registration-side business face for the section. */
+export interface PluginsSettingsSectionInjected {
+    hooks: {
+        /** Ordered, locale-aware projection of the Plugins tab ledger. */
+        tabs: HostObservable<readonly PluginsSettingsTabEntry[]>;
+    };
+}
+/** Props the renderer binds for the section. */
+export type PluginsSettingsSectionProps = PropsRuntime<'settings.section'> & PropsLocale<'settings.plugins'> & PropsRenderSlots<'settings.plugins.tab'> & InjectFace<PluginsSettingsSectionInjected>;
+/** Render one Plugins page whose contents arrive from feature-owned tabs; one contribution shows as the page itself. */
+export declare function PluginsSettingsSection({ t, renderSlot, useTabs }: PluginsSettingsSectionProps): import("react").JSX.Element;
+declare module '@qilin-agent/client-ui-slots' {
+    interface LocaleNamespaceMap {
+        /** Built-in plugins section and plugin configuration page copy. */
+        'settings.plugins': PluginsSettingsLocaleKey;
+    }
+}
+//# sourceMappingURL=PluginsSettingsSection.d.ts.map

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

@@ -0,0 +1,12 @@
+/** One settings card for Subagent delegation limits and model authorization. */
+import type { InjectFace, PropsLocale, PropsRuntime } from '@qilin-agent/client-ui-slots';
+import { type SubagentCardFace } from './subagent-card-controller.ts';
+/** Framework-derived props for the shared Subagent settings card. */
+export type SubagentCardProps = PropsRuntime<'plugins.item'> & PropsLocale<'settings.plugins'> & InjectFace<SubagentCardFace>;
+/**
+ * Render the available Subagent settings with one configuration page and save footer.
+ * @param props - Locale, both form snapshots, and their shared actions.
+ * @returns The summary or the available settings form.
+ */
+export declare function SubagentCard(props: SubagentCardProps): string | import("react").JSX.Element;
+//# sourceMappingURL=SubagentCard.d.ts.map

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

@@ -0,0 +1,14 @@
+/** Delegation-limit fields inside the shared Subagent settings card. */
+import type { PropsLocale } from '@qilin-agent/client-ui-slots';
+import type { SubagentLimitsCardFace, SubagentLimitsCardState } from './subagent-limits-card-controller.ts';
+/** Plain state and edit callbacks supplied by the owning card. */
+export type SubagentLimitsFieldsProps = PropsLocale<'settings.plugins'> & Pick<SubagentLimitsCardFace, 'edit' | 'resetField'> & {
+    state: SubagentLimitsCardState;
+};
+/**
+ * Render the depth and capacity fields with their original validation and reset behavior.
+ * @param props - Locale, staged fields, and edit callbacks.
+ * @returns Two responsive fields and their application rules.
+ */
+export declare function SubagentLimitsFields(props: SubagentLimitsFieldsProps): import("react").JSX.Element;
+//# sourceMappingURL=SubagentLimitsFields.d.ts.map

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

@@ -0,0 +1,14 @@
+/** User control for model-selectable subagent delegation in new sessions. */
+import type { PropsLocale } from '@qilin-agent/client-ui-slots';
+import type { SubagentModelSelectionCardFace, SubagentModelSelectionCardState } from './subagent-model-selection-card-controller.ts';
+/** Plain model state and callbacks supplied by the owning Subagent card. */
+export type SubagentModelSelectionFieldsProps = PropsLocale<'settings.plugins'> & Pick<SubagentModelSelectionCardFace, 'toggleEnabled' | 'toggleModel' | 'retryCatalog'> & {
+    state: SubagentModelSelectionCardState;
+};
+/**
+ * Render the default-off preference and its exact adapter-route choices.
+ * @param props - locale copy, the card snapshot, and its toggle action.
+ * @returns the model permission and route choices inside the shared card.
+ */
+export declare function SubagentModelSelectionFields(props: SubagentModelSelectionFieldsProps): import("react").JSX.Element;
+//# sourceMappingURL=SubagentModelSelectionFields.d.ts.map

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

@@ -0,0 +1,16 @@
+/**
+ * The web-search provider's configuration page: its endpoint, its per-request
+ * search budget, and the key — which is written through the credentials
+ * domain, never into the settings section, so the literal never rides a response.
+ */
+import type { InjectFace, PropsLocale, PropsRuntime } from '@qilin-agent/client-ui-slots';
+import type { WebSearchCardFace } from './web-search-card-controller.ts';
+/** Props the renderer binds for the web-search page. */
+export type WebSearchCardProps = PropsRuntime<'plugins.item'> & PropsLocale<'settings.plugins'> & InjectFace<WebSearchCardFace>;
+/**
+ * Render the web-search provider's one-liner or its configuration form, as the Plugins page asks.
+ * @param props - the view asked for, locale copy, the form snapshot, and its actions.
+ * @returns the one-liner, or the form.
+ */
+export declare function WebSearchCard(props: WebSearchCardProps): string | import("react").JSX.Element;
+//# sourceMappingURL=WebSearchCard.d.ts.map

package/lib/types/client/agent-loop-card-controller.d.ts

@@ -0,0 +1,43 @@
+/** The agent-loop card's staged form over the `agent-loop` settings namespace. */
+import type { SnapshotStore } from '@qilin-agent/client-store';
+import type { ConfigForm } from '@qilin-agent/client-ui-settings/client';
+import { type SettingsFormActions, type SettingsFieldState, type SettingsFormShell } from '@qilin-agent/client-ui-primitives';
+/**
+ * Namespace of the agent loop's user-owned settings. Spelled here rather than
+ * imported: a client package must not depend on a Host package.
+ */
+export declare const AGENT_LOOP_NS = "agent-loop";
+/**
+ * The agent-loop fields this card edits. The Host section carries only this
+ * field — the composed `agents` array is deliberately not part of it.
+ */
+export interface AgentLoopSettings {
+    /** Upper bound on parallel-safe tool calls in flight per step. */
+    maxParallelToolCalls?: number;
+}
+/** What the agent-loop card renders. */
+export interface AgentLoopCardState extends SettingsFormShell {
+    /** Parallel tool-call cap. */
+    maxParallelToolCalls: SettingsFieldState;
+}
+/** The registration-side face the agent-loop card's slot entry injects. */
+export interface AgentLoopCardFace extends SettingsFormActions {
+    hooks: {
+        /** Card snapshot bound by the renderer as useAgentLoopCard. */
+        agentLoopCard: SnapshotStore<AgentLoopCardState>;
+    };
+}
+/** Bridges the `agent-loop` scope onto the card's staged form. */
+export declare class AgentLoopCardController {
+    private readonly form;
+    private readonly store;
+    /** @param scope - the bound settings scope for the `agent-loop` namespace. */
+    constructor(scope: ConfigForm<AgentLoopSettings>);
+    private projection;
+    /**
+     * Build the face the card's slot registration injects.
+     * @returns the card's snapshot and its form actions.
+     */
+    inject(): AgentLoopCardFace;
+}
+//# sourceMappingURL=agent-loop-card-controller.d.ts.map

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

@@ -0,0 +1,45 @@
+/** The shell card's staged form over the `bash` settings namespace. */
+import type { SnapshotStore } from '@qilin-agent/client-store';
+import type { ConfigForm } from '@qilin-agent/client-ui-settings/client';
+import { type SettingsFormActions, type SettingsFieldState, type SettingsFormShell } from '@qilin-agent/client-ui-primitives';
+/**
+ * Namespace of the shell capability. Spelled here rather than imported: a
+ * client package must not depend on a Host package, and the executor families
+ * that own it spell the same value.
+ */
+export declare const SHELL_NS = "shell";
+/** The shell fields this card edits — a subset of the served schema by design. */
+export interface BashSettings {
+    /** Foreground command timeout in milliseconds. */
+    timeoutMs?: number;
+    /** Per-stream in-memory output cap in bytes. */
+    maxOutputBytes?: number;
+}
+/** What the shell card renders. */
+export interface BashCardState extends SettingsFormShell {
+    /** Command timeout in milliseconds. */
+    timeoutMs: SettingsFieldState;
+    /** Per-stream output cap in bytes. */
+    maxOutputBytes: SettingsFieldState;
+}
+/** The registration-side face the shell card's slot entry injects. */
+export interface BashCardFace extends SettingsFormActions {
+    hooks: {
+        /** Card snapshot bound by the renderer as useBashCard. */
+        bashCard: SnapshotStore<BashCardState>;
+    };
+}
+/** Bridges the `bash` scope onto the shell card's staged form. */
+export declare class BashCardController {
+    private readonly form;
+    private readonly store;
+    /** @param scope - the bound settings scope for the `bash` namespace. */
+    constructor(scope: ConfigForm<BashSettings>);
+    private projection;
+    /**
+     * Build the face the card's slot registration injects.
+     * @returns the card's snapshot and its form actions.
+     */
+    inject(): BashCardFace;
+}
+//# sourceMappingURL=bash-card-controller.d.ts.map

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

@@ -0,0 +1,69 @@
+/** The Git card's staged form over the `workspace-git` settings namespace. */
+import type { SnapshotStore } from '@qilin-agent/client-store';
+import type { ConfigForm } from '@qilin-agent/client-ui-settings/client';
+import { type SettingsFormActions, type SettingsFieldState, type SettingsFormShell } from '@qilin-agent/client-ui-primitives';
+/**
+ * Namespace of the workspace Git service. Spelled here rather than imported:
+ * a client package must not depend on a Host package, and the service plugin
+ * that owns it spells the same value.
+ */
+export declare const GIT_NS = "workspace-git";
+/** The Git fields this card edits — the whole served schema. */
+export interface GitSettings {
+    /** Git executable spawned for every repository call. */
+    gitBin?: string;
+    /** gh executable spawned for every pull-request call. */
+    ghBin?: string;
+    /** Timeout on one content or mutation command, in milliseconds. */
+    timeoutMs?: number;
+    /** Timeout on one repository-discovery command, in milliseconds. */
+    discoveryTimeoutMs?: number;
+    /** Timeout on one `gh` call, in milliseconds. */
+    ghTimeoutMs?: number;
+    /** Inclusive byte cap on one diff answer. */
+    maxDiffBytes?: number;
+    /** Character cap on the stderr carried by one error answer. */
+    maxStderrChars?: number;
+    /** Entry cap on one branch or pull-request list answer. */
+    maxListEntries?: number;
+}
+/** What the Git card renders. */
+export interface GitCardState extends SettingsFormShell {
+    /** Git executable path. */
+    gitBin: SettingsFieldState;
+    /** gh executable path. */
+    ghBin: SettingsFieldState;
+    /** Content or mutation command timeout. */
+    timeoutMs: SettingsFieldState;
+    /** Repository-discovery command timeout. */
+    discoveryTimeoutMs: SettingsFieldState;
+    /** gh command timeout. */
+    ghTimeoutMs: SettingsFieldState;
+    /** Diff answer cap. */
+    maxDiffBytes: SettingsFieldState;
+    /** stderr answer cap. */
+    maxStderrChars: SettingsFieldState;
+    /** List entry cap. */
+    maxListEntries: SettingsFieldState;
+}
+/** The registration-side face the Git card's slot entry injects. */
+export interface GitCardFace extends SettingsFormActions {
+    hooks: {
+        /** Card snapshot bound by the renderer as useGitCard. */
+        gitCard: SnapshotStore<GitCardState>;
+    };
+}
+/** Bridges the `workspace-git` scope onto the Git card's staged form. */
+export declare class GitCardController {
+    private readonly form;
+    private readonly store;
+    /** @param scope - the bound settings scope for the `workspace-git` namespace. */
+    constructor(scope: ConfigForm<GitSettings>);
+    private projection;
+    /**
+     * Build the face the card's slot registration injects.
+     * @returns the card's snapshot and its form actions.
+     */
+    inject(): GitCardFace;
+}
+//# sourceMappingURL=git-card-controller.d.ts.map

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

@@ -0,0 +1,26 @@
+/**
+ * Built-in plugins settings surface and the official plugin configuration
+ * pages, browser half. The Settings section is the shell around the
+ * feature-owned tabs registered into `settings.plugins.tab` (the read-only
+ * inventory ships one); the configuration pages this package ships register
+ * into the Plugins page's `plugins.item` slot, for the host-plane namespaces
+ * the deployment exposes, and appear in the page's Official group. Each form
+ * binds its namespace through the client settings scope, which keeps the
+ * pages unaware of one another and of the section.
+ */
+import type { Context as ClientContext } from '@qilin-agent/kylin';
+export type { PluginsSettingsSectionInjected, PluginsSettingsSectionProps } from './PluginsSettingsSection.tsx';
+export type { PluginConfigFormProps } from './PluginConfigForm.tsx';
+export type { SettingsFieldProps } from '@qilin-agent/client-ui-primitives';
+export type { SettingsFormActions, SettingsFieldSpec, SettingsFieldState, SettingsSecretSpec, SettingsFormShell, } from '@qilin-agent/client-ui-primitives';
+export type { AgentLoopCardFace, AgentLoopCardState } from './agent-loop-card-controller.ts';
+export type { BashCardFace, BashCardState } from './bash-card-controller.ts';
+export type { WebSearchCardFace, WebSearchCardState } from './web-search-card-controller.ts';
+/** Required services (cordis fiber inject). */
+export declare const inject: string[];
+/**
+ * Mount the built-in plugins section and the configuration pages this package ships.
+ * @param ctx - the browser plugin context.
+ */
+export declare function apply(ctx: ClientContext): void;
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1,8 @@
+/** Locale bundles for the built-in plugins settings section and the plugin configuration pages. */
+/** Locale keys these surfaces render. */
+export type PluginsSettingsLocaleKey = 'nav' | 'title' | 'intro' | 'tabs' | 'empty' | 'overridden' | 'reset' | 'readOnly' | 'unavailable' | 'save' | 'saving' | 'saveFailed' | 'invalidNumber' | 'bashTitle' | 'bashDescription' | 'bashTimeoutMs' | 'bashTimeoutMsHint' | 'bashMaxOutputBytes' | 'bashMaxOutputBytesHint' | 'agentLoopTitle' | 'agentLoopDescription' | 'agentLoopMaxParallel' | 'agentLoopMaxParallelHint' | 'webSearchTitle' | 'webSearchDescription' | 'webSearchApiKey' | 'webSearchApiKeyHint' | 'webSearchApiKeySet' | 'webSearchApiKeyUnset' | 'webSearchBaseUrl' | 'webSearchBaseUrlHint' | 'webSearchMaxUses' | 'webSearchMaxUsesHint' | 'gitTitle' | 'gitDescription' | 'gitBin' | 'gitBinHint' | 'ghBin' | 'ghBinHint' | 'gitTimeoutMs' | 'gitTimeoutMsHint' | 'gitDiscoveryTimeoutMs' | 'gitDiscoveryTimeoutMsHint' | 'ghTimeoutMs' | 'ghTimeoutMsHint' | 'gitMaxDiffBytes' | 'gitMaxDiffBytesHint' | 'gitMaxStderrChars' | 'gitMaxStderrCharsHint' | 'gitMaxListEntries' | 'gitMaxListEntriesHint' | 'subagentTitle' | 'subagentDescription' | 'subagentLimitsTitle' | 'subagentMaxDepth' | 'subagentDepthHelpLabel' | 'subagentDepthHelp' | 'subagentDepthZero' | 'subagentDepthOne' | 'subagentDepthOverride' | 'subagentMaxActive' | 'subagentCapacityHelpLabel' | 'subagentCapacityHelp' | 'subagentDepthInvalid' | 'subagentCapacityInvalid' | 'subagentModelSelectionTitle' | 'subagentModelSelectionToggle' | 'subagentModelSelectionChoose' | 'subagentModelSelectionAllowed' | 'subagentModelSelectionLoading' | 'subagentModelSelectionLoadFailed' | 'subagentModelSelectionRetry' | 'subagentModelSelectionPartial' | 'subagentModelSelectionUnavailable' | 'subagentModelSelectionUnavailableGroup' | 'subagentModelSelectionEmpty' | 'subagentModelSelectionRequired' | 'subagentModelSelectionConflict' | 'subagentModelSelectionOff';
+/** English copy. */
+export declare const en: Record<PluginsSettingsLocaleKey, string>;
+/** Simplified Chinese copy. */
+export declare const zh: Record<PluginsSettingsLocaleKey, string>;
+//# sourceMappingURL=locales.d.ts.map

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 { SettingsFormShell } from '@qilin-agent/client-ui-primitives';
+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): SettingsFormShell;
+/**
+ * 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 SettingsFormActions, type SettingsFieldState, type SettingsFormShell } from '@qilin-agent/client-ui-primitives';
+/** 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 SettingsFormShell {
+    maxDepth: SettingsFieldState;
+    maxActiveSubagents: SettingsFieldState;
+}
+/** Actions and observable state bound by the slot renderer. */
+export interface SubagentLimitsCardFace extends SettingsFormActions {
+    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 { SettingsFormShell } from '@qilin-agent/client-ui-primitives';
+/** 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 SettingsFormShell {
+    /** 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