@qilin-agent/client-ui-agent-preset 0.0.0-stage → 3.1.3

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

@@ -0,0 +1,119 @@
+/**
+ * Agent-preset roster store shared by the display surfaces.
+ *
+ * Options come from one `agentPresets.list` call. Writes target the settings
+ * namespace fields the host resolves at creation; the management section is
+ * the surface that writes them.
+ */
+import type { Context as ClientContext } from '@qilin-agent/kylin';
+import { type SnapshotStore } from '@qilin-agent/client-store';
+import type { AgentPresetRoster } from '@qilin-agent/agent-presets/types';
+/** The agent-preset settings namespace on the host wire. */
+export declare const AGENT_PRESET_SETTINGS_NS = "agent-presets";
+/**
+ * Persist one preset as the default for sessions created later.
+ *
+ * The default is a settings field rather than a preset property; the
+ * management section writes it here — one home for which namespace and field
+ * the host resolves at session creation.
+ * @param ctx - the browser plugin context carrying the Remote namespaces.
+ * @param id - the preset to make default.
+ * @returns the failure message, or undefined once the write landed.
+ */
+export declare function writeDefaultPreset(ctx: ClientContext, id: string): Promise<string | undefined>;
+/**
+ * Persist whether new-session surfaces expose preset selection.
+ * @param ctx - the browser plugin context carrying the Remote namespaces.
+ * @param enabled - whether the picker should be exposed.
+ * @returns the failure message, or undefined once the write landed.
+ */
+export declare function writeModeSelectionEnabled(ctx: ClientContext, enabled: boolean): Promise<string | undefined>;
+/** One selectable preset. */
+export interface AgentPresetOption {
+    /** Preset id, written to Settings and the label's fallback. */
+    id: string;
+    /** Whether the preset ships with the deployment or was authored locally. */
+    trust: 'system' | 'user';
+    /** Display name the preset published, absent when it published none. */
+    name?: string;
+    /** One sentence on what the preset is for. */
+    description?: string;
+}
+/** One roster entry exactly as the host reports it. */
+export type RosterPreset = AgentPresetRoster['presets'][number];
+/** The roster, or the message to show in its place. */
+export type RosterRead = {
+    ok: true;
+    value: AgentPresetRoster;
+} | {
+    ok: false;
+    error: string;
+};
+/**
+ * Read the roster, turning a refusal into the message every surface shows.
+ * @param ctx - the browser plugin context carrying the Remote namespaces.
+ * @returns the roster, or the message to show in its place.
+ */
+export declare function readRoster(ctx: ClientContext): Promise<RosterRead>;
+/**
+ * The opening move every roster-backed surface makes: refuse a read that is
+ * already in flight, mark the store loading, then read.
+ *
+ * A surface that gets `undefined` returns without touching its snapshot
+ * further — either another read owns it, or this one already wrote the
+ * failure. What differs between surfaces starts after this.
+ * @param ctx - the browser plugin context carrying the Remote namespaces.
+ * @param store - the surface's own snapshot store.
+ * @returns the roster, or undefined when the caller should return.
+ */
+export declare function beginRosterRead<S extends {
+    status: string;
+    error: string | null;
+}>(ctx: ClientContext, store: SnapshotStore<S>): Promise<AgentPresetRoster | undefined>;
+/**
+ * The roster entries as the pickers render them: healthy presets only.
+ *
+ * The chip exists to choose the NEXT session's composition, and a broken
+ * preset cannot compose one — offering it would defer the discovery of that
+ * fact to a failed session start. The management section renders the full
+ * roster (broken rows included) from its own store instead.
+ *
+ * The chip, the header label, and the management section all show the same
+ * facts, and `exactOptionalPropertyTypes` makes "absent" and "present as
+ * undefined" different shapes — so the spread dance belongs in one place rather than
+ * once per store.
+ * @param presets - the roster the host answered with.
+ * @returns one option per selectable preset, in roster order.
+ */
+export declare function presetOptions(presets: readonly {
+    id: string;
+    trust: 'system' | 'user';
+    name?: string;
+    description?: string;
+    broken?: string;
+}[]): AgentPresetOption[];
+/** Agent-preset roster snapshot for the display surfaces. */
+export interface AgentPresetSettingsState {
+    status: 'idle' | 'loading' | 'ready' | 'unavailable' | 'error';
+    error: string | null;
+    options: readonly AgentPresetOption[];
+}
+/** Reads the roster for the surfaces that only display it. */
+export declare class AgentPresetSettingsController {
+    private readonly ctx;
+    /** Roster snapshot the renderer subscribes to. */
+    readonly store: SnapshotStore<AgentPresetSettingsState>;
+    /**
+     * @param ctx - the browser plugin context (the roster read).
+     */
+    constructor(ctx: ClientContext);
+    private set;
+    /**
+     * Load the roster. An empty roster means the deployment composes no
+     * presets, which is a valid deployment rather than a failure — the
+     * surfaces report `unavailable` and render nothing.
+     * @returns once the snapshot reflects the host.
+     */
+    load(): Promise<void>;
+}
+//# sourceMappingURL=settings-store.d.ts.map

package/lib/types/index.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Agent-preset surface plugin, node half. The empty apply exists so the plugin
+ * appears in the host cordis.yml / Loader; the browser half ships the
+ * General-settings row through exports["./client"], discovered from the
+ * package.json qilin.client declaration.
+ */
+/** 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,81 @@
 {
   "name": "@qilin-agent/client-ui-agent-preset",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
+  "description": "Agent-preset surfaces: the default for later sessions, this session's seat, and the composition editor",
+  "version": "3.1.3",
+  "publishConfig": {
+    "access": "public"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/kkutysllb/QiLin.git",
+    "directory": "packages/client/ui-agent-preset"
+  },
+  "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/api-session-controller",
+        "@qilin-agent/client-connection",
+        "@qilin-agent/client-locale",
+        "@qilin-agent/client-ui-conversation",
+        "@qilin-agent/client-ui-session",
+        "@qilin-agent/client-ui-settings",
+        "@qilin-agent/client-ui-workspace",
+        "@qilin-agent/api-remotes"
+      ],
+      "platform": "web"
+    }
+  },
+  "license": "MIT",
+  "peerDependencies": {
+    "@qilin-agent/kylin": "~4.0.3"
+  },
+  "devDependencies": {
+    "@types/react": "~18.3.1",
+    "react": "^18.2.0",
+    "@qilin-agent/api-remotes": "3.1.3",
+    "@qilin-agent/api-session-controller": "3.1.3",
+    "@qilin-agent/agent-presets": "3.1.3",
+    "@qilin-agent/client-connection": "3.1.3",
+    "@qilin-agent/client-locale": "3.1.3",
+    "@qilin-agent/client-store": "3.1.3",
+    "@qilin-agent/client-test-runtime": "3.1.3",
+    "@qilin-agent/client-ui-conversation": "3.1.3",
+    "@qilin-agent/client-ui-plugin-manager": "3.1.3",
+    "@qilin-agent/client-ui-primitives": "3.1.3",
+    "@qilin-agent/client-ui-slots": "3.1.3",
+    "@qilin-agent/client-ui-settings": "3.1.3",
+    "@qilin-agent/util-values": "3.1.3",
+    "@qilin-agent/kylin": "~4.0.3",
+    "@qilin-agent/session": "3.1.3",
+    "@qilin-agent/client-ui-renderer": "3.1.3",
+    "@qilin-agent/client-ui-session": "3.1.3",
+    "@qilin-agent/client-ui-workspace": "3.1.3"
+  },
+  "files": [
+    "lib/index.js",
+    "lib/client.js",
+    "lib/types/**/*.d.ts"
+  ],
+  "scripts": {
+    "bundle": "tsdown",
+    "watch": "tsdown --watch"
+  }
 }