@deepseek-ai/dsh-api-settings-controller 0.1.2-alpha.2

package/lib/types/index.d.ts

@@ -0,0 +1,114 @@
+/**
+ * Host Remote owner for the configuration surfaces over the settings-domain
+ * seams. Two namespaces: `settings`, the redacted reads and writes of
+ * `ctx.settings`, owned by the class below; and `credentials`, mounted from
+ * here as its own plugin.
+ *
+ * @module @deepseek-ai/dsh-api-settings-controller
+ */
+import { Context } from '@deepseek-ai/cordis';
+import Schema from '@deepseek-ai/schemastery';
+import type { SettingsDescribeValue, SettingsNamespaceView, SettingsPathOpView } from '@deepseek-ai/dsh-settings/types';
+import { TypertRemoteService } from '@deepseek-ai/dsh-typert-protocol';
+import type { JsonValue } from '@deepseek-ai/dsh-util-values';
+import type { AgentPresetDirectoryOpenValue, SettingsDocumentOpenValue } from './types.ts';
+export { CredentialsController } from './credentials.ts';
+export type * from './types.ts';
+/** Native document-opening policy. */
+export interface Config {
+    /** Override platform desktop-opener detection. */
+    readonly nativeOpen?: boolean;
+}
+/** Host integrations replaceable by direct unit tests. */
+export interface SettingsControllerInternals {
+    readonly openPath?: (path: string, signal: AbortSignal) => Promise<void>;
+    readonly openTextFile?: (path: string, signal: AbortSignal) => Promise<void>;
+    readonly canOpenPath?: () => boolean;
+}
+declare module '@deepseek-ai/cordis' {
+    interface Context {
+        /** Host owner of the `settings` Remote namespace. */
+        settingsController: SettingsController;
+    }
+}
+/**
+ * Host service backing the generated `ctx.remote.settings` namespace. Every
+ * remote read uses `redactSecrets: true`, so a `role('secret')` field cannot
+ * ride a response. Writes expose the settings service's merge, replacement,
+ * and path-addressed operations, and classify every provider refusal as
+ * `settings/conflict` or `settings/rejected` with the service's message.
+ */
+export declare class SettingsController extends TypertRemoteService {
+    static Config: Schema<Config>;
+    private readonly openPath;
+    private readonly openTextFile;
+    private readonly canOpenPath;
+    /**
+     * Register the settings namespace and mount the credentials namespace beside
+     * it. Both namespaces stay registered when a provider is absent so calls can
+     * return the configuration API's actionable missing-provider diagnostic.
+     * @param ctx - Host context where settings and credential providers may be mounted.
+     */
+    constructor(ctx: Context, config?: Config, internals?: SettingsControllerInternals);
+    /**
+     * Describe every registered namespace for a configuration page: redacted
+     * layered values plus the serialized schema the page renders its form from.
+     * @returns provider writability, local-document presence, and one view per namespace.
+     * @throws RemoteError when no settings provider is mounted.
+     */
+    describe(): SettingsDescribeValue;
+    /**
+     * Report whether this deployment can open an authored Agent preset directory natively.
+     * @returns true when the matching open operation is available.
+     */
+    canOpenAgentPresetDirectory(): boolean;
+    /**
+     * Merge a patch into one namespace's stored user section.
+     * @param ns - namespace key to write.
+     * @param patch - fields to merge into the user section.
+     * @param expectedRevision - revision the caller read; `undefined` writes unconditionally.
+     * @returns the namespace's redacted view after the write.
+     * @throws RemoteError when the request is invalid, no provider is mounted, or the provider refuses the write.
+     */
+    update(ns: string, patch: Record<string, JsonValue>, expectedRevision: number | undefined): Promise<SettingsNamespaceView>;
+    /**
+     * Replace one namespace's stored user section wholesale.
+     * @param ns - namespace key to write.
+     * @param section - complete replacement user section.
+     * @param expectedRevision - revision the caller read; `undefined` writes unconditionally.
+     * @returns the namespace's redacted view after the write.
+     * @throws RemoteError when the request is invalid, no provider is mounted, or the provider refuses the write.
+     */
+    replace(ns: string, section: Record<string, JsonValue>, expectedRevision: number | undefined): Promise<SettingsNamespaceView>;
+    /**
+     * Apply path-addressed edits to one namespace's user section, resolved against
+     * the section as stored rather than against whatever the caller last read,
+     * then answer with that namespace's new redacted view.
+     * @param ns - namespace key to write.
+     * @param ops - the edits to apply, in order.
+     * @param expectedRevision - revision the caller read; `undefined` writes unconditionally.
+     * @returns the namespace's redacted view after the write.
+     * @throws RemoteError when the request is invalid, no provider is mounted, or the provider refuses the write.
+     */
+    mutate(ns: string, ops: SettingsPathOpView[], expectedRevision: number | undefined): Promise<SettingsNamespaceView>;
+    /**
+     * Materialize the provider-owned settings document and open it in a native text editor.
+     * @param signal - caller lifetime; abort terminates preparation or the native command.
+     * @returns confirmation after the native opener accepts the document.
+     * @throws RemoteError when no document exists, preparation fails, or opening fails.
+     */
+    openSettingsDocument(signal: AbortSignal): Promise<SettingsDocumentOpenValue>;
+    /**
+     * Open one user-authored Agent preset directory or return its path when no native opener exists.
+     * @param agentPreset - preset id resolved against Host-owned roots.
+     * @param signal - caller lifetime; abort terminates the native command.
+     * @returns an opened confirmation or the resolved directory for text display.
+     * @throws RemoteError when the preset is missing, read-only, invalid, or cannot be opened.
+     */
+    openAgentPresetDirectory(agentPreset: string, signal: AbortSignal): Promise<AgentPresetDirectoryOpenValue>;
+    private write;
+    /** Resolve the optional provider or report how to supply it. */
+    private provider;
+}
+export default SettingsController;
+//# sourceMappingURL=index.d.ts.map

package/lib/types/index.js

@@ -0,0 +1,317 @@
+/**
+ * Host Remote owner for the configuration surfaces over the settings-domain
+ * seams. Two namespaces: `settings`, the redacted reads and writes of
+ * `ctx.settings`, owned by the class below; and `credentials`, mounted from
+ * here as its own plugin.
+ *
+ * @module @deepseek-ai/dsh-api-settings-controller
+ */
+var __runInitializers = (this && this.__runInitializers) || function (thisArg, initializers, value) {
+    var useValue = arguments.length > 2;
+    for (var i = 0; i < initializers.length; i++) {
+        value = useValue ? initializers[i].call(thisArg, value) : initializers[i].call(thisArg);
+    }
+    return useValue ? value : void 0;
+};
+var __esDecorate = (this && this.__esDecorate) || function (ctor, descriptorIn, decorators, contextIn, initializers, extraInitializers) {
+    function accept(f) { if (f !== void 0 && typeof f !== "function") throw new TypeError("Function expected"); return f; }
+    var kind = contextIn.kind, key = kind === "getter" ? "get" : kind === "setter" ? "set" : "value";
+    var target = !descriptorIn && ctor ? contextIn["static"] ? ctor : ctor.prototype : null;
+    var descriptor = descriptorIn || (target ? Object.getOwnPropertyDescriptor(target, contextIn.name) : {});
+    var _, done = false;
+    for (var i = decorators.length - 1; i >= 0; i--) {
+        var context = {};
+        for (var p in contextIn) context[p] = p === "access" ? {} : contextIn[p];
+        for (var p in contextIn.access) context.access[p] = contextIn.access[p];
+        context.addInitializer = function (f) { if (done) throw new TypeError("Cannot add initializers after decoration has completed"); extraInitializers.push(accept(f || null)); };
+        var result = (0, decorators[i])(kind === "accessor" ? { get: descriptor.get, set: descriptor.set } : descriptor[key], context);
+        if (kind === "accessor") {
+            if (result === void 0) continue;
+            if (result === null || typeof result !== "object") throw new TypeError("Object expected");
+            if (_ = accept(result.get)) descriptor.get = _;
+            if (_ = accept(result.set)) descriptor.set = _;
+            if (_ = accept(result.init)) initializers.unshift(_);
+        }
+        else if (_ = accept(result)) {
+            if (kind === "field") initializers.unshift(_);
+            else descriptor[key] = _;
+        }
+    }
+    if (target) Object.defineProperty(target, contextIn.name, descriptor);
+    done = true;
+};
+import { dirname } from 'node:path';
+import Schema from '@deepseek-ai/schemastery';
+import { canOpenNativePath, openNativePath, openNativeTextFile, } from '@deepseek-ai/dsh-native-command';
+import { Remote, RemoteError, TypertRemoteService } from '@deepseek-ai/dsh-typert-protocol';
+import { z } from 'zod';
+import { CredentialsController } from "./credentials.js";
+export { CredentialsController } from "./credentials.js";
+const settingsNamespaceRequestSchema = z.object({ ns: z.string().min(1) });
+/** Read abort state afresh after an awaited provider or opener call. */
+function isAborted(signal) {
+    return signal.aborted;
+}
+/**
+ * Project one redacted descriptor onto its wire view, field by field. The
+ * Gateway returns a business result without decoding it, so a provider whose
+ * descriptor carried extra enumerable properties would otherwise serialize them
+ * to the caller.
+ * @param descriptor - one descriptor read under `redactSecrets`.
+ * @returns the same facts with nothing else attached.
+ */
+function namespaceView(descriptor) {
+    return {
+        ns: String(descriptor.ns),
+        schema: descriptor.schema,
+        value: descriptor.value,
+        ...descriptor.base === undefined ? {} : { base: descriptor.base },
+        ...descriptor.user === undefined ? {} : { user: descriptor.user },
+        applies: descriptor.applies,
+        secrets: (descriptor.secrets ?? []).map(secret => ({ path: [...secret.path], set: secret.set })),
+        revision: descriptor.revision,
+    };
+}
+/**
+ * Host service backing the generated `ctx.remote.settings` namespace. Every
+ * remote read uses `redactSecrets: true`, so a `role('secret')` field cannot
+ * ride a response. Writes expose the settings service's merge, replacement,
+ * and path-addressed operations, and classify every provider refusal as
+ * `settings/conflict` or `settings/rejected` with the service's message.
+ */
+let SettingsController = (() => {
+    let _classSuper = TypertRemoteService;
+    let _instanceExtraInitializers = [];
+    let _describe_decorators;
+    let _canOpenAgentPresetDirectory_decorators;
+    let _update_decorators;
+    let _replace_decorators;
+    let _mutate_decorators;
+    let _openSettingsDocument_decorators;
+    let _openAgentPresetDirectory_decorators;
+    return class SettingsController extends _classSuper {
+        static {
+            const _metadata = typeof Symbol === "function" && Symbol.metadata ? Object.create(_classSuper[Symbol.metadata] ?? null) : void 0;
+            _describe_decorators = [Remote];
+            _canOpenAgentPresetDirectory_decorators = [Remote];
+            _update_decorators = [Remote];
+            _replace_decorators = [Remote];
+            _mutate_decorators = [Remote];
+            _openSettingsDocument_decorators = [Remote];
+            _openAgentPresetDirectory_decorators = [Remote];
+            __esDecorate(this, null, _describe_decorators, { kind: "method", name: "describe", static: false, private: false, access: { has: obj => "describe" in obj, get: obj => obj.describe }, metadata: _metadata }, null, _instanceExtraInitializers);
+            __esDecorate(this, null, _canOpenAgentPresetDirectory_decorators, { kind: "method", name: "canOpenAgentPresetDirectory", static: false, private: false, access: { has: obj => "canOpenAgentPresetDirectory" in obj, get: obj => obj.canOpenAgentPresetDirectory }, metadata: _metadata }, null, _instanceExtraInitializers);
+            __esDecorate(this, null, _update_decorators, { kind: "method", name: "update", static: false, private: false, access: { has: obj => "update" in obj, get: obj => obj.update }, metadata: _metadata }, null, _instanceExtraInitializers);
+            __esDecorate(this, null, _replace_decorators, { kind: "method", name: "replace", static: false, private: false, access: { has: obj => "replace" in obj, get: obj => obj.replace }, metadata: _metadata }, null, _instanceExtraInitializers);
+            __esDecorate(this, null, _mutate_decorators, { kind: "method", name: "mutate", static: false, private: false, access: { has: obj => "mutate" in obj, get: obj => obj.mutate }, metadata: _metadata }, null, _instanceExtraInitializers);
+            __esDecorate(this, null, _openSettingsDocument_decorators, { kind: "method", name: "openSettingsDocument", static: false, private: false, access: { has: obj => "openSettingsDocument" in obj, get: obj => obj.openSettingsDocument }, metadata: _metadata }, null, _instanceExtraInitializers);
+            __esDecorate(this, null, _openAgentPresetDirectory_decorators, { kind: "method", name: "openAgentPresetDirectory", static: false, private: false, access: { has: obj => "openAgentPresetDirectory" in obj, get: obj => obj.openAgentPresetDirectory }, metadata: _metadata }, null, _instanceExtraInitializers);
+            if (_metadata) Object.defineProperty(this, Symbol.metadata, { enumerable: true, configurable: true, writable: true, value: _metadata });
+        }
+        static Config = Schema.object({ nativeOpen: Schema.boolean() });
+        openPath = __runInitializers(this, _instanceExtraInitializers);
+        openTextFile;
+        canOpenPath;
+        /**
+         * Register the settings namespace and mount the credentials namespace beside
+         * it. Both namespaces stay registered when a provider is absent so calls can
+         * return the configuration API's actionable missing-provider diagnostic.
+         * @param ctx - Host context where settings and credential providers may be mounted.
+         */
+        constructor(ctx, config = {}, internals = {}) {
+            super(ctx, 'settingsController', { namespace: 'settings' });
+            this.openPath = internals.openPath ?? openNativePath;
+            this.openTextFile = internals.openTextFile ?? openNativeTextFile;
+            this.canOpenPath = internals.canOpenPath
+                ?? (() => config.nativeOpen ?? (internals.openPath !== undefined || canOpenNativePath()));
+            ctx.plugin(CredentialsController);
+        }
+        /**
+         * Describe every registered namespace for a configuration page: redacted
+         * layered values plus the serialized schema the page renders its form from.
+         * @returns provider writability, local-document presence, and one view per namespace.
+         * @throws RemoteError when no settings provider is mounted.
+         */
+        describe() {
+            const settings = this.provider();
+            return {
+                writable: settings.writable,
+                hasDocument: settings.documentPath !== undefined,
+                namespaces: settings.describe({ redactSecrets: true }).map(namespaceView),
+            };
+        }
+        /**
+         * Report whether this deployment can open an authored Agent preset directory natively.
+         * @returns true when the matching open operation is available.
+         */
+        canOpenAgentPresetDirectory() {
+            return this.canOpenPath();
+        }
+        /**
+         * Merge a patch into one namespace's stored user section.
+         * @param ns - namespace key to write.
+         * @param patch - fields to merge into the user section.
+         * @param expectedRevision - revision the caller read; `undefined` writes unconditionally.
+         * @returns the namespace's redacted view after the write.
+         * @throws RemoteError when the request is invalid, no provider is mounted, or the provider refuses the write.
+         */
+        update(ns, patch, expectedRevision) {
+            return this.write(ns, 'update', patch, expectedRevision);
+        }
+        /**
+         * Replace one namespace's stored user section wholesale.
+         * @param ns - namespace key to write.
+         * @param section - complete replacement user section.
+         * @param expectedRevision - revision the caller read; `undefined` writes unconditionally.
+         * @returns the namespace's redacted view after the write.
+         * @throws RemoteError when the request is invalid, no provider is mounted, or the provider refuses the write.
+         */
+        replace(ns, section, expectedRevision) {
+            return this.write(ns, 'replace', section, expectedRevision);
+        }
+        /**
+         * Apply path-addressed edits to one namespace's user section, resolved against
+         * the section as stored rather than against whatever the caller last read,
+         * then answer with that namespace's new redacted view.
+         * @param ns - namespace key to write.
+         * @param ops - the edits to apply, in order.
+         * @param expectedRevision - revision the caller read; `undefined` writes unconditionally.
+         * @returns the namespace's redacted view after the write.
+         * @throws RemoteError when the request is invalid, no provider is mounted, or the provider refuses the write.
+         */
+        async mutate(ns, ops, expectedRevision) {
+            return this.write(ns, 'mutate', ops, expectedRevision);
+        }
+        /**
+         * Materialize the provider-owned settings document and open it in a native text editor.
+         * @param signal - caller lifetime; abort terminates preparation or the native command.
+         * @returns confirmation after the native opener accepts the document.
+         * @throws RemoteError when no document exists, preparation fails, or opening fails.
+         */
+        async openSettingsDocument(signal) {
+            const settings = this.provider();
+            if (isAborted(signal))
+                throw new RemoteError('gateway/cancelled', 'settings document open was aborted', {});
+            let path;
+            try {
+                path = await settings.prepareDocument();
+            }
+            catch (error) {
+                if (isAborted(signal))
+                    throw new RemoteError('gateway/cancelled', 'settings document preparation was aborted', {});
+                throw new RemoteError('gateway/internal', `settings document preparation failed: ${messageOf(error)}`, {}, { cause: error });
+            }
+            if (path === undefined) {
+                throw new RemoteError('gateway/internal', 'settings provider has no local document to open', {});
+            }
+            if (isAborted(signal))
+                throw new RemoteError('gateway/cancelled', 'settings document open was aborted', {});
+            try {
+                await this.openTextFile(path, signal);
+                return { opened: true };
+            }
+            catch (error) {
+                if (isAborted(signal))
+                    throw new RemoteError('gateway/cancelled', 'settings document open was aborted', {});
+                throw new RemoteError('gateway/internal', `path open failed: ${messageOf(error)}`, {}, { cause: error });
+            }
+        }
+        /**
+         * Open one user-authored Agent preset directory or return its path when no native opener exists.
+         * @param agentPreset - preset id resolved against Host-owned roots.
+         * @param signal - caller lifetime; abort terminates the native command.
+         * @returns an opened confirmation or the resolved directory for text display.
+         * @throws RemoteError when the preset is missing, read-only, invalid, or cannot be opened.
+         */
+        async openAgentPresetDirectory(agentPreset, signal) {
+            if (agentPreset.length === 0) {
+                throw new RemoteError('gateway/bad-request', 'agent preset id must not be empty', {});
+            }
+            const presets = this.ctx.get('agentPresets');
+            if (presets === undefined) {
+                throw new RemoteError('agent-preset/not-found', 'this deployment composes no agent presets', { agentPreset, available: [] });
+            }
+            const preset = await presets.resolve(agentPreset);
+            if (preset.trust !== 'user') {
+                throw new RemoteError('agent-preset/read-only', `agent-presets: preset "${preset.id}" cannot be written: it ships with the deployment`, { agentPreset: preset.id, reason: 'it ships with the deployment' });
+            }
+            const directory = dirname(preset.path);
+            if (!this.canOpenPath())
+                return { opened: false, path: directory };
+            try {
+                await this.openPath(directory, signal);
+                return { opened: true };
+            }
+            catch (error) {
+                if (signal.aborted)
+                    throw new RemoteError('gateway/cancelled', 'path open was aborted', {});
+                throw new RemoteError('gateway/internal', `path open failed: ${messageOf(error)}`, {}, { cause: error });
+            }
+        }
+        async write(ns, mode, input, expectedRevision) {
+            const parsed = settingsNamespaceRequestSchema.safeParse({ ns });
+            if (!parsed.success) {
+                throw new RemoteError('gateway/bad-request', `invalid payload for settings.${mode}`, { issues: parsed.error.issues });
+            }
+            const settings = this.provider();
+            const namespace = parsed.data.ns;
+            try {
+                if (mode === 'update')
+                    await settings.update(namespace, input, expectedRevision);
+                else if (mode === 'replace')
+                    await settings.replace(namespace, input, expectedRevision);
+                else
+                    await settings.mutate(namespace, input, expectedRevision);
+            }
+            catch (error) {
+                throw rejected(ns, error);
+            }
+            const descriptor = settings.describe({ redactSecrets: true }).find(candidate => candidate.ns === namespace);
+            if (descriptor === undefined) {
+                // The write committed but the namespace vanished before this read: only a
+                // concurrent registrant disposal can produce it.
+                throw new RemoteError('gateway/internal', `settings namespace "${ns}" was disposed after the ${mode}`, {});
+            }
+            return namespaceView(descriptor);
+        }
+        /** Resolve the optional provider or report how to supply it. */
+        provider() {
+            const settings = this.ctx.get('settings');
+            if (settings === undefined) {
+                throw new RemoteError('gateway/internal', 'settings service is absent: this deployment does not mount a settings provider (e.g. @deepseek-ai/dsh-settings-file) in its composition', {});
+            }
+            return settings;
+        }
+    };
+})();
+export { SettingsController };
+function messageOf(error) {
+    return error instanceof Error ? error.message : String(error);
+}
+function settingsConflictOf(error) {
+    if (typeof error !== 'object' || error === null)
+        return undefined;
+    if (Reflect.get(error, 'code') !== 'SETTINGS_CONFLICT'
+        || typeof Reflect.get(error, 'message') !== 'string'
+        || typeof Reflect.get(error, 'expected') !== 'number'
+        || typeof Reflect.get(error, 'actual') !== 'number')
+        return undefined;
+    return error;
+}
+/**
+ * Classify one seam refusal. A stale writer is its own outcome, not a malformed
+ * request: the client must re-read and re-apply rather than treat the write as
+ * invalid.
+ * @param ns - the namespace the write addressed.
+ * @param error - whatever the seam threw.
+ * @returns the failure to raise for that refusal.
+ */
+function rejected(ns, error) {
+    const conflict = settingsConflictOf(error);
+    if (conflict !== undefined) {
+        return new RemoteError('settings/conflict', conflict.message, { ns, expected: conflict.expected, actual: conflict.actual }, { cause: error });
+    }
+    return new RemoteError('settings/rejected', messageOf(error), { ns }, { cause: error });
+}
+export default SettingsController;
+//# sourceMappingURL=index.js.map

package/lib/types/invariant.d.ts

@@ -0,0 +1,9 @@
+/** Package-owned invariant companion. @module @deepseek-ai/dsh-api-settings-controller/invariant */
+import type { Context } from '@deepseek-ai/cordis';
+/** Cordis companion plugin name. */
+export declare const name = "api-settings-controller-invariant";
+/** Service required before the companion can reserve package ownership. */
+export declare const inject: string[];
+/** Register this package's invariant companion. */
+export declare const apply: (ctx: Context) => Promise<() => void>;
+//# sourceMappingURL=invariant.d.ts.map

package/lib/types/invariant.js

@@ -0,0 +1,15 @@
+/** Package-owned invariant companion. @module @deepseek-ai/dsh-api-settings-controller/invariant */
+const PACKAGE_NAME = '@deepseek-ai/dsh-api-settings-controller';
+/** Cordis companion plugin name. */
+export const name = 'api-settings-controller-invariant';
+/** Service required before the companion can reserve package ownership. */
+export const inject = ['invariants'];
+/**
+ * No runtime invariant: the settings and credential seams own storage and
+ * update events, while this package only projects their methods onto the wire.
+ */
+const install = () => { };
+/** Register this package's invariant companion. */
+export const apply = (ctx) => Promise.resolve(ctx.invariants.register(PACKAGE_NAME, install));
+/* jscpd:ignore-end */
+//# sourceMappingURL=invariant.js.map

package/lib/types/types.d.ts

@@ -0,0 +1,48 @@
+/**
+ * Browser-safe failure vocabulary of the configuration surfaces this package
+ * serves. The redacted views themselves live with their seam in
+ * `@deepseek-ai/dsh-settings/types`, whose Cordis event declarations already
+ * register that file for the Client compilation face.
+ *
+ * @module @deepseek-ai/dsh-api-settings-controller/types
+ */
+declare module '@deepseek-ai/dsh-typert-protocol' {
+    interface RemoteErrorDetailsMap {
+        /**
+         * Every seam refusal that is not a stale write: an unregistered or malformed
+         * namespace, a read-only provider, schema validation, storage.
+         */
+        'settings/rejected': {
+            readonly ns: string;
+        };
+        /**
+         * The stored revision moved after the caller read it. Its own outcome rather
+         * than an invalid request: the caller must re-read and re-apply.
+         */
+        'settings/conflict': {
+            readonly ns: string;
+            readonly expected: number;
+            readonly actual: number;
+        };
+        /**
+         * The provider refused a valid credential write, for example because a
+         * read-only source shadows the reference. The details name only the
+         * reference, never the value.
+         */
+        'credential/rejected': {
+            readonly ref: string;
+        };
+    }
+}
+/** Confirmation that the settings document was handed to the native editor. */
+export interface SettingsDocumentOpenValue {
+    readonly opened: true;
+}
+/** Result of opening or revealing one locally authored Agent preset directory. */
+export type AgentPresetDirectoryOpenValue = {
+    readonly opened: true;
+} | {
+    readonly opened: false;
+    readonly path: string;
+};
+//# sourceMappingURL=types.d.ts.map

package/lib/types/types.js

@@ -0,0 +1,10 @@
+/**
+ * Browser-safe failure vocabulary of the configuration surfaces this package
+ * serves. The redacted views themselves live with their seam in
+ * `@deepseek-ai/dsh-settings/types`, whose Cordis event declarations already
+ * register that file for the Client compilation face.
+ *
+ * @module @deepseek-ai/dsh-api-settings-controller/types
+ */
+export {};
+//# sourceMappingURL=types.js.map

package/package.json

@@ -0,0 +1,75 @@
+{
+  "name": "@deepseek-ai/dsh-api-settings-controller",
+  "description": "Remote owner for the configuration surfaces over the settings-domain seams",
+  "version": "0.1.2-alpha.2",
+  "publishConfig": {
+    "access": "public"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/deepseek-ai/deepseek-harness.git",
+    "directory": "packages/api/settings-controller"
+  },
+  "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"
+    },
+    "./types": {
+      "types": "./lib/types/types.d.ts",
+      "default": "./lib/types/types.js"
+    },
+    "./typert": {
+      "types": "./lib/typert.host.d.ts",
+      "default": "./lib/typert.host.js"
+    },
+    "./remote": {
+      "types": "./lib/typert.remote-client.d.ts",
+      "default": "./lib/typert.remote-client.js"
+    },
+    "./src/*": "./src/*",
+    "./package.json": "./package.json"
+  },
+  "files": [
+    "lib/index.js",
+    "lib/invariant.js",
+    "lib/types/**/*.js",
+    "lib/types/**/*.d.ts",
+    "lib/typert.host.js",
+    "lib/typert.host.d.ts",
+    "lib/typert.remote-client.js",
+    "lib/typert.remote-client.d.ts"
+  ],
+  "license": "MIT",
+  "dependencies": {
+    "zod": "^4.4.3",
+    "@deepseek-ai/schemastery": "^3.18.2"
+  },
+  "peerDependencies": {
+    "@deepseek-ai/cordis": "^4.0.2",
+    "@deepseek-ai/dsh-credentials": "^0.1.2-alpha.2",
+    "@deepseek-ai/dsh-invariants": "^0.1.2-alpha.2",
+    "@deepseek-ai/dsh-native-command": "^0.1.2-alpha.2",
+    "@deepseek-ai/dsh-session": "^0.1.2-alpha.2",
+    "@deepseek-ai/dsh-settings": "^0.1.2-alpha.2",
+    "@deepseek-ai/dsh-typert-protocol": "^0.1.2-alpha.2",
+    "@deepseek-ai/dsh-agent-presets": "^0.1.2-alpha.2"
+  },
+  "devDependencies": {
+    "@deepseek-ai/cordis": "^4.0.2",
+    "@deepseek-ai/dsh-agent-presets": "^0.1.2-alpha.2",
+    "@deepseek-ai/dsh-credentials": "^0.1.2-alpha.2",
+    "@deepseek-ai/dsh-invariants": "^0.1.2-alpha.2",
+    "@deepseek-ai/dsh-native-command": "^0.1.2-alpha.2",
+    "@deepseek-ai/dsh-settings": "^0.1.2-alpha.2",
+    "@deepseek-ai/dsh-typert-protocol": "^0.1.2-alpha.2",
+    "@deepseek-ai/dsh-session": "^0.1.2-alpha.2"
+  }
+}