@dsh-plugin/dsh-loader 1.0.0 → 1.1.0-dev.32287576957

package/dist/registry.js

@@ -0,0 +1,229 @@
+/**
+ * Adapter registry + dsh version detection (design.md §3.1 / §3.2).
+ *
+ * Selection rules (mirrors design.md §3.1, five rules):
+ *   1. exact match        — adapter.supports === version
+ *   2. range match        — semver.satisfies(version, supports); when several
+ *                           ranges cover the version, pick the narrowest; ties
+ *                           broken by last-registered-wins.
+ *   3. nearest-low fallback — no exact/range hit, but some adapters only cover
+ *                           versions below the real one: pick the one whose
+ *                           upper bound is closest, mark mode 'fallback', warn.
+ *   4. version too old    — real version is below every adapter's lower bound:
+ *                           throw UnsupportedDshVersionError with a "too old"
+ *                           message and the lowest supported version.
+ *   5. version too new / empty registry — throw UnsupportedDshVersionError with
+ *                           an "upgrade dshloader" message.
+ *
+ * Version detection priority (design.md §3.2):
+ *   1. DSHLOADER_DSH_VERSION env var (highest; for tests/CI override)
+ *   2. node_modules/@deepseek-ai/dsh/package.json#version
+ *   3. ctx.runtime?.version — reserved for the future, NOT consulted in v1.
+ * child_process `dsh --version` is deliberately NOT used (design.md §3.2).
+ */
+import { readFileSync } from 'node:fs';
+import { join, resolve, dirname } from 'node:path';
+import { createRequire } from 'node:module';
+import semver from 'semver';
+import { LOG_PREFIX } from './version.js';
+const require = createRequire(import.meta.url);
+export class UnsupportedDshVersionError extends Error {
+    kind; // 'too-old' | 'too-new'
+    version;
+    minSupported;
+    constructor(message, opts = {}) {
+        super(message);
+        this.name = 'UnsupportedDshVersionError';
+        this.kind = opts.kind;
+        this.version = opts.version;
+        this.minSupported = opts.minSupported;
+    }
+}
+export class InvalidVersionError extends Error {
+    version;
+    constructor(message, opts = {}) {
+        super(message);
+        this.name = 'InvalidVersionError';
+        this.version = opts.version;
+    }
+}
+/**
+ * Resolve the installed dsh version.
+ *
+ * @returns semver version string, or undefined when unreachable
+ */
+export function detectDshVersion(opts = {}) {
+    const env = opts.env ?? process.env;
+    const envVal = env.DSHLOADER_DSH_VERSION;
+    if (typeof envVal === 'string' && envVal.trim() !== '') {
+        return envVal.trim();
+    }
+    const candidates = [];
+    if (opts.dshPkgPath)
+        candidates.push(opts.dshPkgPath);
+    if (opts.profileDir) {
+        candidates.push(join(opts.profileDir, 'node_modules', '@deepseek-ai', 'dsh', 'package.json'));
+    }
+    // Resolve from the loader's own location (profile node_modules sits beside it).
+    try {
+        candidates.push(require.resolve('@deepseek-ai/dsh/package.json'));
+    }
+    catch { /* not installed — skip */ }
+    // Global node_modules — dsh is typically installed globally (the runtime
+    // that loads profiles, not a profile dependency). Derive from the Node.js
+    // executable: /opt/homebrew/bin/node → /opt/homebrew/lib/node_modules.
+    const globalRoot = resolve(dirname(process.execPath), '..', 'lib', 'node_modules');
+    candidates.push(join(globalRoot, '@deepseek-ai', 'dsh', 'package.json'));
+    // Walk up from cwd as a last resort.
+    let dir = process.cwd();
+    for (let i = 0; i < 8; i += 1) {
+        candidates.push(join(dir, 'node_modules', '@deepseek-ai', 'dsh', 'package.json'));
+        const parent = resolve(dir, '..');
+        if (parent === dir)
+            break;
+        dir = parent;
+    }
+    for (const path of candidates) {
+        try {
+            const pkg = JSON.parse(readFileSync(path, 'utf8'));
+            if (typeof pkg.version === 'string' && pkg.version.trim() !== '') {
+                return pkg.version.trim();
+            }
+        }
+        catch { /* try next */ }
+    }
+    return undefined;
+}
+/**
+ * Parse a semver range into { lower, upper } bounds. Each bound is
+ * { v: SemVer, inc: boolean } or null when unbounded on that side.
+ */
+function rangeBounds(range) {
+    const r = new semver.Range(range);
+    let lower = null;
+    let upper = null;
+    for (const group of r.set) {
+        for (const c of group) {
+            const op = c.operator;
+            const v = c.semver; // parsed SemVer (c.value is the raw comparator string)
+            if (op === '' || op === '=') {
+                lower = { v, inc: true };
+                upper = { v, inc: true };
+            }
+            else if (op === '>') {
+                lower = { v, inc: false };
+            }
+            else if (op === '>=') {
+                lower = { v, inc: true };
+            }
+            else if (op === '<') {
+                upper = { v, inc: false };
+            }
+            else if (op === '<=') {
+                upper = { v, inc: true };
+            }
+        }
+    }
+    return { lower, upper };
+}
+/** True when every version the range covers is strictly below `version`. */
+function isLowerCandidate(range, version) {
+    const { upper } = rangeBounds(range);
+    if (!upper)
+        return false; // unbounded above → can cover version, not a lower candidate
+    return upper.inc ? semver.gt(version, upper.v) : semver.gte(version, upper.v);
+}
+/** Lowest version that satisfies the range (semver.minVersion). */
+function rangeMinVersion(range) {
+    const min = semver.minVersion(range);
+    return min ? min.version : null;
+}
+export class AdapterRegistry {
+    adapters;
+    constructor() {
+        this.adapters = [];
+    }
+    register(factory) {
+        if (!factory || typeof factory.supports !== 'string' || typeof factory.create !== 'function') {
+            throw new TypeError('AdapterFactory must expose { supports: string, create: function }');
+        }
+        this.adapters.push(factory);
+        return this;
+    }
+    select(version) {
+        if (!semver.valid(version)) {
+            throw new InvalidVersionError(`${LOG_PREFIX} cannot parse dsh version "${version}" as semver`, { version });
+        }
+        if (this.adapters.length === 0) {
+            throw new UnsupportedDshVersionError(`${LOG_PREFIX} no adapter registered for dsh ${version}; please upgrade @dsh-plugin/dsh-loader`, { kind: 'too-new', version });
+        }
+        // Rule 1 + 2: exact and range matches.
+        const matches = [];
+        for (const factory of this.adapters) {
+            if (factory.supports === version) {
+                matches.push({ factory, mode: 'exact' });
+            }
+            else if (semver.satisfies(version, factory.supports)) {
+                matches.push({ factory, mode: 'range' });
+            }
+        }
+        if (matches.length > 0) {
+            // Narrowest range wins; tie → last registered.
+            let best = matches[matches.length - 1];
+            for (let i = matches.length - 1; i >= 0; i -= 1) {
+                const candidate = matches[i];
+                const narrowest = matches.every((other, j) => {
+                    if (i === j)
+                        return true;
+                    try {
+                        return semver.subset(candidate.factory.supports, other.factory.supports);
+                    }
+                    catch {
+                        return false;
+                    }
+                });
+                if (narrowest) {
+                    best = candidate;
+                    break;
+                }
+            }
+            // Exact match always beats a range match on the same version.
+            const exact = matches.find((m) => m.mode === 'exact');
+            if (exact)
+                best = exact;
+            return { factory: best.factory, mode: best.mode };
+        }
+        // Rule 3: nearest-low fallback.
+        const lowers = this.adapters
+            .filter((f) => isLowerCandidate(f.supports, version))
+            .map((f) => {
+            const { upper } = rangeBounds(f.supports);
+            return { factory: f, upper };
+        });
+        if (lowers.length > 0) {
+            lowers.sort((a, b) => {
+                const cmp = semver.compare(b.upper.v, a.upper.v);
+                if (cmp !== 0)
+                    return cmp;
+                // exclusive upper is "higher" than inclusive at the same version
+                return (b.upper.inc ? 0 : 1) - (a.upper.inc ? 0 : 1);
+            });
+            const chosen = lowers[0];
+            console.warn(`${LOG_PREFIX} no exact adapter for dsh ${version}; falling back to "${chosen.factory.name}" (supports ${chosen.factory.supports})`);
+            return { factory: chosen.factory, mode: 'fallback' };
+        }
+        // Rule 4 vs 5: too old vs too new.
+        const minVersions = this.adapters
+            .map((f) => rangeMinVersion(f.supports))
+            .filter((v) => v !== null)
+            .map((v) => semver.parse(v));
+        if (minVersions.length > 0) {
+            const lowest = minVersions.reduce((acc, v) => (semver.lt(v, acc) ? v : acc));
+            if (semver.lt(version, lowest)) {
+                throw new UnsupportedDshVersionError(`${LOG_PREFIX} current dsh version ${version} is too old; dshloader minimum supported is ${lowest.version}. Please upgrade dsh or use an older dshloader release.`, { kind: 'too-old', version, minSupported: lowest.version });
+            }
+        }
+        throw new UnsupportedDshVersionError(`${LOG_PREFIX} no adapter covers dsh ${version}; please upgrade @dsh-plugin/dsh-loader`, { kind: 'too-new', version });
+    }
+}
+//# sourceMappingURL=registry.js.map

package/dist/registry.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"registry.js","sourceRoot":"","sources":["../src/registry.ts"],"names":[],"mappings":"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"}

package/dist/services/services.d.ts

@@ -0,0 +1,4 @@
+import type { CordisContext, ServicesAPI } from '../types.js';
+export declare function createServicesAPI(opts: {
+    ctx: CordisContext;
+}): ServicesAPI;

package/dist/services/services.js

@@ -0,0 +1,28 @@
+// Services stable API (design.md §3.3 / §4.1 `ctx.dshLoader.services`).
+//
+// Thin read/alias helpers over the cordis service registry. `alias()` is a
+// low-level escape hatch for plugin authors who need a one-hop alias beyond
+// what the selected adapter already provides; it never overwrites an existing
+// service (mirrors the adapter safety rule in design.md §5.1).
+import { LOG_PREFIX } from '../version.js';
+export function createServicesAPI(opts) {
+    const { ctx } = opts;
+    return {
+        get(name) {
+            return ctx.get(name);
+        },
+        alias(from, to) {
+            if (ctx.get(from) !== undefined) {
+                console.warn(`${LOG_PREFIX} services.alias: "${from}" already exists, skip alias`);
+                return;
+            }
+            const target = ctx.get(to);
+            if (target === undefined) {
+                console.warn(`${LOG_PREFIX} services.alias: target "${to}" unavailable, cannot alias "${from}"`);
+                return;
+            }
+            ctx.reflect.provide(from, target);
+        },
+    };
+}
+//# sourceMappingURL=services.js.map

package/dist/services/services.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"services.js","sourceRoot":"","sources":["../../src/services/services.ts"],"names":[],"mappings":"AAAA,wEAAwE;AACxE,EAAE;AACF,2EAA2E;AAC3E,4EAA4E;AAC5E,8EAA8E;AAC9E,+DAA+D;AAE/D,OAAO,EAAE,UAAU,EAAE,MAAM,eAAe,CAAC;AAG3C,MAAM,UAAU,iBAAiB,CAAC,IAA4B;IAC5D,MAAM,EAAE,GAAG,EAAE,GAAG,IAAI,CAAC;IACrB,OAAO;QACL,GAAG,CAAC,IAAI;YACN,OAAO,GAAG,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;QACvB,CAAC;QACD,KAAK,CAAC,IAAI,EAAE,EAAE;YACZ,IAAI,GAAG,CAAC,GAAG,CAAC,IAAI,CAAC,KAAK,SAAS,EAAE,CAAC;gBAChC,OAAO,CAAC,IAAI,CAAC,GAAG,UAAU,qBAAqB,IAAI,8BAA8B,CAAC,CAAC;gBACnF,OAAO;YACT,CAAC;YACD,MAAM,MAAM,GAAG,GAAG,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;YAC3B,IAAI,MAAM,KAAK,SAAS,EAAE,CAAC;gBACzB,OAAO,CAAC,IAAI,CAAC,GAAG,UAAU,4BAA4B,EAAE,gCAAgC,IAAI,GAAG,CAAC,CAAC;gBACjG,OAAO;YACT,CAAC;YACD,GAAG,CAAC,OAAO,CAAC,OAAO,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC;QACpC,CAAC;KACF,CAAC;AACJ,CAAC"}

package/dist/services/settings.d.ts

@@ -0,0 +1,41 @@
+import type { CordisContext, SettingsAPI, SettingsResult, NamespaceView } from '../types.js';
+/**
+ * Official browser-writable settings namespaces (dsh-host-apiproxy
+ * WEB_SETTINGS_NAMESPACES), as documented in dsh-upstream-fixes/README.md.
+ * Product namespaces and dynamic model-provider namespaces are not enumerable
+ * without dsh internals; callers may extend this set via `extraWhitelist`.
+ */
+export declare const DEFAULT_WEB_SETTINGS_NAMESPACES: Set<string>;
+/** A raw settings descriptor returned by the real settings service. */
+interface SettingsDescriptor {
+    ns: string;
+    schema: any;
+    value: any;
+    base?: any;
+    user?: any;
+    applies?: any;
+    secrets?: {
+        path: string[];
+        set?: any;
+    }[];
+    revision?: any;
+}
+/**
+ * Shape a raw settings descriptor into the official NamespaceView wire shape
+ * (mirrors dsh-upstream-fixes/lib/index.js `namespaceView`).
+ */
+export declare function toNamespaceView(descriptor: SettingsDescriptor): NamespaceView;
+/**
+ * Map a thrown settings error into a SettingsResult, preserving the official
+ * `settings-conflict` / `settings-rejected` classification.
+ */
+export declare function settingsErrorToResult(error: unknown, ns: string, method: string): SettingsResult;
+/**
+ * Build the `ctx.dshLoader.settings` stable API.
+ */
+export declare function createSettingsAPI(opts: {
+    ctx: CordisContext;
+    exposeAllNamespaces: boolean;
+    whitelist?: Set<string>;
+}): SettingsAPI;
+export {};

package/dist/services/settings.js

@@ -0,0 +1,161 @@
+// Settings stable API (design.md §3.3.1 / §4.1 / §4.2).
+//
+// Two concerns are deliberately separated:
+//   1. naming/shape differences — handled by proxying to ctx.get('settings').
+//   2. access scope (security)  — `exposeAllNamespaces` controls whether
+//      `describe` returns only the official browser whitelist namespaces
+//      (default, matches official behavior) or every registered namespace.
+//
+// Host-side writes always proxy through to the real settings service: host
+// plugin code is already trusted (it runs in the dsh Node process and could
+// call ctx.get('settings').update directly). The whitelist is a browser-side
+// default-deny boundary owned by dsh-host-apiproxy; the browser path is
+// covered separately by the client fetch interceptor (src/client.ts).
+import { LOG_PREFIX } from '../version.js';
+/**
+ * Official browser-writable settings namespaces (dsh-host-apiproxy
+ * WEB_SETTINGS_NAMESPACES), as documented in dsh-upstream-fixes/README.md.
+ * Product namespaces and dynamic model-provider namespaces are not enumerable
+ * without dsh internals; callers may extend this set via `extraWhitelist`.
+ */
+export const DEFAULT_WEB_SETTINGS_NAMESPACES = new Set([
+    'agent-loop',
+    'shell',
+    'locale',
+    'permission',
+    'ui-conversation',
+    'ui-theme',
+    'web-search-deepseek',
+]);
+/**
+ * Shape a raw settings descriptor into the official NamespaceView wire shape
+ * (mirrors dsh-upstream-fixes/lib/index.js `namespaceView`).
+ */
+export function toNamespaceView(descriptor) {
+    const view = {
+        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((s) => ({ path: [...s.path], set: s.set })),
+        revision: descriptor.revision,
+    };
+    return view;
+}
+/**
+ * Map a thrown settings error into a SettingsResult, preserving the official
+ * `settings-conflict` / `settings-rejected` classification.
+ */
+export function settingsErrorToResult(error, ns, method) {
+    const isObject = error !== null && typeof error === 'object';
+    const isConflict = isObject && ('expected' in error || 'actual' in error);
+    if (isConflict) {
+        const err = error;
+        return {
+            ok: false,
+            code: 'settings-conflict',
+            message: err.message ?? String(error),
+            details: {
+                ns,
+                ...(err.expected === undefined ? {} : { expected: err.expected }),
+                ...(err.actual === undefined ? {} : { actual: err.actual }),
+            },
+        };
+    }
+    return {
+        ok: false,
+        code: 'settings-rejected',
+        message: error instanceof Error ? error.message : String(error),
+        details: { ns, method },
+    };
+}
+/**
+ * Build the `ctx.dshLoader.settings` stable API.
+ */
+export function createSettingsAPI(opts) {
+    const { ctx, exposeAllNamespaces, whitelist } = opts;
+    const allowed = whitelist ?? DEFAULT_WEB_SETTINGS_NAMESPACES;
+    function getSettings() {
+        return ctx.get('settings');
+    }
+    function filterNamespaces(views) {
+        if (exposeAllNamespaces)
+            return views;
+        return views.filter((v) => allowed.has(String(v.ns)));
+    }
+    const api = {
+        exposeAllNamespaces: Boolean(exposeAllNamespaces),
+        /**
+         * Register a settings namespace. Proxies to the real settings service's
+         * `register(ns, schema, options)` and returns the owner scope
+         * ({ get, watch }) — the same shape the official service returns.
+         *
+         * Unlike describe/update/replace/mutate, register is NOT filtered by the
+         * whitelist: host plugin code is trusted and registering a namespace is
+         * a composition-time act, not a browser-facing read/write.
+         */
+        register(ns, schema, options) {
+            const settings = getSettings();
+            if (settings === undefined || typeof settings.register !== 'function') {
+                console.warn(`${LOG_PREFIX}:settings.register settings service unavailable`);
+                return undefined;
+            }
+            return settings.register(ns, schema, options);
+        },
+        describe(options = {}) {
+            const settings = getSettings();
+            if (settings === undefined || typeof settings.describe !== 'function') {
+                return [];
+            }
+            const redactSecrets = options.redactSecrets !== false;
+            const descriptors = settings.describe({ redactSecrets });
+            const views = (descriptors ?? []).map(toNamespaceView);
+            return filterNamespaces(views);
+        },
+        async _write(method, ns, section, expectedRevision) {
+            const settings = getSettings();
+            if (settings === undefined) {
+                return {
+                    ok: false,
+                    code: 'internal',
+                    message: `${LOG_PREFIX}:settings.${method} settings service unavailable`,
+                    details: { ns },
+                };
+            }
+            try {
+                if (method === 'update')
+                    await settings.update(ns, section, expectedRevision);
+                else if (method === 'replace')
+                    await settings.replace(ns, section, expectedRevision);
+                else
+                    await settings.mutate(ns, section, expectedRevision);
+            }
+            catch (error) {
+                return settingsErrorToResult(error, ns, method);
+            }
+            const descriptor = settings.describe({ redactSecrets: true }).find((d) => String(d.ns) === String(ns));
+            if (descriptor === undefined) {
+                return {
+                    ok: false,
+                    code: 'internal',
+                    message: `${LOG_PREFIX}:settings.${method} namespace disposed after write`,
+                    details: { ns },
+                };
+            }
+            return { ok: true, value: toNamespaceView(descriptor) };
+        },
+        update(ns, section, expectedRevision) {
+            return api._write('update', ns, section, expectedRevision);
+        },
+        replace(ns, section, expectedRevision) {
+            return api._write('replace', ns, section, expectedRevision);
+        },
+        mutate(ns, ops, expectedRevision) {
+            return api._write('mutate', ns, ops, expectedRevision);
+        },
+    };
+    return api;
+}
+//# sourceMappingURL=settings.js.map

package/dist/services/settings.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"settings.js","sourceRoot":"","sources":["../../src/services/settings.ts"],"names":[],"mappings":"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"}

package/dist/services/web.d.ts

@@ -0,0 +1,10 @@
+import type { CordisContext, WebAPI } from '../types.js';
+export declare class DshLoaderWebError extends Error {
+    constructor(message: string);
+}
+/**
+ * Build the `ctx.dshLoader.web` stable API.
+ */
+export declare function createWebAPI(opts: {
+    ctx: CordisContext;
+}): WebAPI;

package/dist/services/web.js

@@ -0,0 +1,63 @@
+// Web server stable API (design.md §3.3.2 / §4.1).
+//
+// Routes every registration through the real `webServer` (or `httpServer`
+// alias) `register({ kind, ... })` call shape used by dsh 1.x, mirroring
+// dsh-upstream-fixes/lib/index.js `registerRoutes`. Each method returns a
+// dispose function that removes the registration when the underlying
+// service supports it.
+import { LOG_PREFIX } from '../version.js';
+export class DshLoaderWebError extends Error {
+    constructor(message) {
+        super(message);
+        this.name = 'DshLoaderWebError';
+    }
+}
+/** Resolve the active web server service (webServer preferred, httpServer alias next). */
+function resolveWebServer(ctx) {
+    return ctx.get('webServer') ?? ctx.get('httpServer');
+}
+/**
+ * Build the `ctx.dshLoader.web` stable API.
+ */
+export function createWebAPI(opts) {
+    const { ctx } = opts;
+    function server() {
+        const web = resolveWebServer(ctx);
+        if (web === undefined || typeof web.register !== 'function') {
+            throw new DshLoaderWebError(`${LOG_PREFIX}:web webServer service unavailable`);
+        }
+        return web;
+    }
+    return {
+        register(prefix, handler) {
+            const web = server();
+            return web.register({ kind: 'prefix', path: prefix, handler }) ?? (() => { });
+        },
+        get(path, handler) {
+            const web = server();
+            return web.register({ kind: 'route', method: 'GET', path, handler }) ?? (() => { });
+        },
+        post(path, handler) {
+            const web = server();
+            return web.register({ kind: 'route', method: 'POST', path, handler }) ?? (() => { });
+        },
+        use(middleware) {
+            const web = server();
+            return web.register({ kind: 'middleware', handler: middleware }) ?? (() => { });
+        },
+        /**
+         * Register a WebSocket upgrade route for an exact pathname.
+         * Proxies to `webServer.registerUpgrade({ path, handler })`.
+         *
+         * @returns dispose function that removes the upgrade route
+         */
+        registerUpgrade(route) {
+            const web = server();
+            if (typeof web.registerUpgrade !== 'function') {
+                throw new DshLoaderWebError(`${LOG_PREFIX}:web.registerUpgrade webServer does not support upgrade routes (registerUpgrade missing)`);
+            }
+            return web.registerUpgrade(route) ?? (() => { });
+        },
+    };
+}
+//# sourceMappingURL=web.js.map

package/dist/services/web.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"web.js","sourceRoot":"","sources":["../../src/services/web.ts"],"names":[],"mappings":"AAAA,mDAAmD;AACnD,EAAE;AACF,0EAA0E;AAC1E,yEAAyE;AACzE,0EAA0E;AAC1E,qEAAqE;AACrE,uBAAuB;AACvB,OAAO,EAAE,UAAU,EAAE,MAAM,eAAe,CAAC;AAG3C,MAAM,OAAO,iBAAkB,SAAQ,KAAK;IAC1C,YAAY,OAAe;QACzB,KAAK,CAAC,OAAO,CAAC,CAAC;QACf,IAAI,CAAC,IAAI,GAAG,mBAAmB,CAAC;IAClC,CAAC;CACF;AAED,0FAA0F;AAC1F,SAAS,gBAAgB,CAAC,GAAkB;IAC1C,OAAO,GAAG,CAAC,GAAG,CAAC,WAAW,CAAC,IAAI,GAAG,CAAC,GAAG,CAAC,YAAY,CAAC,CAAC;AACvD,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,YAAY,CAAC,IAA4B;IACvD,MAAM,EAAE,GAAG,EAAE,GAAG,IAAI,CAAC;IAErB,SAAS,MAAM;QACb,MAAM,GAAG,GAAG,gBAAgB,CAAC,GAAG,CAAC,CAAC;QAClC,IAAI,GAAG,KAAK,SAAS,IAAI,OAAO,GAAG,CAAC,QAAQ,KAAK,UAAU,EAAE,CAAC;YAC5D,MAAM,IAAI,iBAAiB,CAAC,GAAG,UAAU,oCAAoC,CAAC,CAAC;QACjF,CAAC;QACD,OAAO,GAAG,CAAC;IACb,CAAC;IAED,OAAO;QACL,QAAQ,CAAC,MAAM,EAAE,OAAO;YACtB,MAAM,GAAG,GAAG,MAAM,EAAE,CAAC;YACrB,OAAO,GAAG,CAAC,QAAQ,CAAC,EAAE,IAAI,EAAE,QAAQ,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,CAAC,IAAI,CAAC,GAAG,EAAE,GAAE,CAAC,CAAC,CAAC;QAC/E,CAAC;QACD,GAAG,CAAC,IAAI,EAAE,OAAO;YACf,MAAM,GAAG,GAAG,MAAM,EAAE,CAAC;YACrB,OAAO,GAAG,CAAC,QAAQ,CAAC,EAAE,IAAI,EAAE,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,IAAI,EAAE,OAAO,EAAE,CAAC,IAAI,CAAC,GAAG,EAAE,GAAE,CAAC,CAAC,CAAC;QACrF,CAAC;QACD,IAAI,CAAC,IAAI,EAAE,OAAO;YAChB,MAAM,GAAG,GAAG,MAAM,EAAE,CAAC;YACrB,OAAO,GAAG,CAAC,QAAQ,CAAC,EAAE,IAAI,EAAE,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,OAAO,EAAE,CAAC,IAAI,CAAC,GAAG,EAAE,GAAE,CAAC,CAAC,CAAC;QACtF,CAAC;QACD,GAAG,CAAC,UAAU;YACZ,MAAM,GAAG,GAAG,MAAM,EAAE,CAAC;YACrB,OAAO,GAAG,CAAC,QAAQ,CAAC,EAAE,IAAI,EAAE,YAAY,EAAE,OAAO,EAAE,UAAU,EAAE,CAAC,IAAI,CAAC,GAAG,EAAE,GAAE,CAAC,CAAC,CAAC;QACjF,CAAC;QACD;;;;;WAKG;QACH,eAAe,CAAC,KAAK;YACnB,MAAM,GAAG,GAAG,MAAM,EAAE,CAAC;YACrB,IAAI,OAAO,GAAG,CAAC,eAAe,KAAK,UAAU,EAAE,CAAC;gBAC9C,MAAM,IAAI,iBAAiB,CACzB,GAAG,UAAU,0FAA0F,CACxG,CAAC;YACJ,CAAC;YACD,OAAO,GAAG,CAAC,eAAe,CAAC,KAAK,CAAC,IAAI,CAAC,GAAG,EAAE,GAAE,CAAC,CAAC,CAAC;QAClD,CAAC;KACF,CAAC;AACJ,CAAC"}

package/dist/setup.d.ts

@@ -0,0 +1,32 @@
+export declare function dshHome(): string;
+export declare function profileDir(profileName: string): string;
+/** Ensure dshloader is listed in the profile package.json dependencies. */
+export declare function injectDependency(pkgPath: string): {
+    added: boolean;
+    manifest: any;
+};
+/** Ensure the dshloader insert entry exists in cordis.patch.yml (no reorder). */
+export declare function injectPatch(patchPath: string): {
+    added: boolean;
+    text: string;
+};
+/**
+ * Run `dshloader setup <profile>`.
+ * @param profileName
+ * @returns
+ */
+export declare function setupProfile(profileName: string): {
+    profileDir: string;
+    dependencyAdded: boolean;
+    patchAdded: boolean;
+};
+/** Best-effort dump-config validation. Returns { ok, output } (never throws). */
+export declare function dumpConfig(profileName: string): {
+    ok: boolean;
+    output: string;
+};
+/** Print dshloader status for a profile (AC-OB-03, minimal). */
+export declare function info(profileName?: string): {
+    loaderVersion: string;
+    dshVersion?: string;
+};