@hydraharness/harness-client-ui-agent-preset 0.1.1-rc.6

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

@@ -0,0 +1,165 @@
+/**
+ * Agent-preset default-settings controller.
+ *
+ * Options and the current default both come from one `agentPreset.list` call:
+ * the roster already reports which id a session with no explicit choice gets,
+ * so the row needs no schema introspection. Writes target the settings
+ * namespace's `default` field, which is what the host resolves at creation.
+ */
+import type { IApiClient } from '@hydraharness/harness-api-remotes/client';
+import { type SnapshotStore } from '@hydraharness/harness-client-runtime/client';
+import type { SettingsDescribeFace } from '@hydraharness/harness-client-ui-settings/client';
+/** The agent-preset settings namespace on the host wire. */
+export declare const AGENT_PRESET_SETTINGS_NS = "agent-presets";
+/**
+ * Human text for a rejected wire call. A transport failure rejects with an
+ * Error; a host or a runtime can reject with anything, and the surface still
+ * has to say something.
+ * @param error - the rejection value.
+ * @returns the message to show.
+ */
+export declare function messageOf(error: unknown): string;
+/**
+ * Persist one preset as the default for sessions created later.
+ *
+ * The default is a settings field rather than a preset property, so both the
+ * General row and the management section write it here — one home for which
+ * namespace and field the host resolves at session creation.
+ * @param api - the settings wire face.
+ * @param id - the preset to make default.
+ * @returns the failure message, or undefined once the write landed.
+ */
+export declare function writeDefaultPreset(api: Pick<IApiClient, 'settings'>, id: string): 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 interface RosterPreset {
+    /** Preset id and directory name. */
+    id: string;
+    /** Whether the preset ships with the deployment or was authored locally. */
+    trust: 'system' | 'user';
+    /** Whether a session that names no preset gets this one. */
+    isDefault: boolean;
+    /** Display name the preset published, absent when it published none. */
+    name?: string;
+    /** One sentence on what the preset is for. */
+    description?: string;
+    /** Why the preset cannot compose a session, absent when it can. */
+    broken?: string;
+}
+/** The roster the host answered with. */
+export interface RosterValue {
+    /** Every preset the deployment composes, in the order the host lists them. */
+    presets: readonly RosterPreset[];
+    /** Whether this browser may author presets at all. */
+    authorable: boolean;
+    /** Whether the host can open a preset directory on a native desktop. */
+    hasDocument: boolean;
+}
+/** The roster, or the message to show in its place. */
+export type RosterRead = {
+    ok: true;
+    value: RosterValue;
+} | {
+    ok: false;
+    error: string;
+};
+/**
+ * Read the roster, folding both refusal shapes into one message.
+ *
+ * The wire refuses in two ways — the transport rejects, or it answers an
+ * `ok: false` envelope — and every surface treats them identically. Folding
+ * them here keeps each store's `load` about what it does with a roster rather
+ * than about how the call can fail.
+ * @param api - the agent-preset wire face.
+ * @returns the roster, or the message to show in its place.
+ */
+export declare function readRoster(api: Pick<IApiClient, 'agentPresets'>): Promise<RosterRead>;
+/**
+ * Serialize roster refreshes, coalescing invalidations during a read into a
+ * rerun before publishing. Callers settle after the latest requested refresh.
+ * @param api - the agent-preset wire face.
+ * @param store - the surface's own snapshot store.
+ * @param accept - publish a successful roster into the surface's snapshot.
+ * @returns the refresh callback owned by this controller.
+ */
+export declare function createRosterLoader<S extends {
+    status: string;
+    error: string | null;
+}>(api: Pick<IApiClient, 'agentPresets'>, store: SnapshotStore<S>, accept: (roster: RosterValue) => void | Promise<void>): () => Promise<void>;
+/**
+ * The roster entries as the pickers render them: healthy presets only.
+ *
+ * The chip and the row exist 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 row, 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 settings-row snapshot. */
+export interface AgentPresetSettingsState {
+    status: 'idle' | 'loading' | 'ready' | 'saving' | 'unavailable' | 'error';
+    error: string | null;
+    /**
+     * Whether this browser may persist the choice at all. `settings.describe` is
+     * loopback-only and reports a read-only provider as `writable: false`; the
+     * row then shows the current default and disables the control rather than
+     * offering a write the gateway will refuse.
+     */
+    writable: boolean;
+    currentValue: string;
+    options: readonly AgentPresetOption[];
+}
+/** Reads the roster and persists the chosen default. */
+export declare class AgentPresetSettingsController {
+    private readonly api;
+    private readonly describeFace;
+    /** Row snapshot the renderer subscribes to. */
+    readonly store: SnapshotStore<AgentPresetSettingsState>;
+    private readonly refresh;
+    /**
+     * @param api - the agent-preset and settings wire faces (roster and default write).
+     * @param describeFace - the shared mirror's describe face (writability source).
+     */
+    constructor(api: IApiClient, describeFace: SettingsDescribeFace);
+    private set;
+    /**
+     * Load the roster. An empty roster means the deployment composes no
+     * presets, which is a valid deployment rather than a failure — the row
+     * reports `unavailable` and renders nothing.
+     * @returns once the snapshot reflects the host.
+     */
+    load(): Promise<void>;
+    private acceptRoster;
+    /**
+     * Persist one preset as the default for sessions created later. Running
+     * sessions keep the composition they were created with, so this never
+     * disturbs work in progress.
+     * @param id - the preset to make default.
+     * @returns once the write settled and the roster was re-read.
+     */
+    select(id: string): 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 hydra.client declaration.
+ */
+/** 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 `@hydraharness/harness-client-ui-agent-preset`.
+ * @module @hydraharness/harness-client-ui-agent-preset/invariant
+ */
+import type { Context } from '@hydraharness/cordis';
+/** Cordis companion plugin name. */
+export declare const name = "client-ui-agent-preset-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,84 @@
+{
+  "name": "@hydraharness/harness-client-ui-agent-preset",
+  "description": "Agent-preset surfaces: the default for later sessions, this session's seat, and the composition editor",
+  "version": "0.1.1-rc.6",
+  "publishConfig": {
+    "access": "public"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/MaiHongPhong1902/Hydra-Harness.git",
+    "directory": "packages/client/ui-agent-preset"
+  },
+  "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"
+  },
+  "hydra": {
+    "plugin": {
+      "application": "Select the preset for a session and edit the composition used by future sessions."
+    },
+    "client": {
+      "inject": [
+        "@hydraharness/harness-client-connection",
+        "@hydraharness/harness-client-locale",
+        "@hydraharness/harness-client-runtime",
+        "@hydraharness/harness-client-ui-conversation",
+        "@hydraharness/harness-client-ui-settings",
+        "@hydraharness/harness-api-remotes"
+      ],
+      "platform": "web"
+    }
+  },
+  "license": "MIT",
+  "peerDependencies": {
+    "@hydraharness/cordis": "^4.0.2",
+    "@hydraharness/harness-api-remotes": "^0.1.1-rc.6",
+    "@hydraharness/harness-client-connection": "^0.1.1-rc.6",
+    "@hydraharness/harness-client-runtime": "^0.1.1-rc.6",
+    "@hydraharness/harness-client-ui-settings": "^0.1.1-rc.6",
+    "@hydraharness/harness-client-ui-conversation": "^0.1.1-rc.6",
+    "@hydraharness/harness-client-locale": "^0.1.1-rc.6",
+    "@hydraharness/harness-invariants": "^0.1.1-rc.6"
+  },
+  "devDependencies": {
+    "@types/react": "~18.3.1",
+    "react": "^18.2.0",
+    "@hydraharness/harness-api-remotes": "^0.1.1-rc.6",
+    "@hydraharness/harness-client-locale": "^0.1.1-rc.6",
+    "@hydraharness/harness-client-connection": "^0.1.1-rc.6",
+    "@hydraharness/harness-client-runtime": "^0.1.1-rc.6",
+    "@hydraharness/harness-client-ui-conversation": "^0.1.1-rc.6",
+    "@hydraharness/harness-client-test-runtime": "^0.1.1-rc.6",
+    "@hydraharness/harness-client-ui-settings": "^0.1.1-rc.6",
+    "@hydraharness/harness-client-ui-primitives": "^0.1.1-rc.6",
+    "@hydraharness/harness-invariants": "^0.1.1-rc.6",
+    "@hydraharness/harness-client-ui-slots": "^0.1.1-rc.6",
+    "@hydraharness/cordis": "^4.0.2"
+  },
+  "files": [
+    "lib/index.js",
+    "lib/invariant.js",
+    "lib/client.js",
+    "lib/types/**/*.d.ts"
+  ],
+  "scripts": {
+    "bundle": "tsdown",
+    "watch": "tsdown --watch"
+  }
+}