@dsh-plugin/dsh-loader 1.0.0

package/src/setup.mjs

@@ -0,0 +1,125 @@
+// One-shot profile injection script (design.md §3.6 / §6 / M6).
+//
+// `dshloader setup <profile>`:
+//   - adds `@dsh-plugin/dsh-loader` to the profile package.json dependencies
+//     (if missing);
+//   - appends the dshloader `insert` entry to cordis.patch.yml (if missing);
+//   - does NOT reorder the insert list — cordis is reactive DI, so position
+//     does not affect whether service aliases / module redirects take effect
+//     (design.md §1.2 / §6.2).
+//
+// `dshloader dump-config <profile>`: best-effort validation that runs
+// `dsh --profile <name> --dump-config` when the dsh CLI is available.
+//
+// `dshloader info [profile]`: prints dshloader version, detected dsh version,
+// selected adapter, and registered aliases (AC-OB-03, P2 — minimal).
+import { existsSync, readFileSync, writeFileSync } from 'node:fs';
+import { join, resolve } from 'node:path';
+import { spawnSync } from 'node:child_process';
+import { LOADER_VERSION, LOG_PREFIX } from './version.js';
+import { detectDshVersion, AdapterRegistry, UnsupportedDshVersionError } from './registry.js';
+import { registerHostAdapters } from './adapters/index.js';
+
+const LOADER_PKG = '@dsh-plugin/dsh-loader';
+const PATCH_ENTRY = `- id: dsh-loader\n      name: '${LOADER_PKG}'`;
+
+export function dshHome() {
+  const env = process.env.DSH_HOME?.trim();
+  return env ? resolve(env) : join(process.env.HOME ?? '~', '.dsh');
+}
+
+export function profileDir(profileName) {
+  return join(dshHome(), 'profiles', profileName);
+}
+
+function readJson(path) {
+  try {
+    return JSON.parse(readFileSync(path, 'utf8'));
+  } catch {
+    return null;
+  }
+}
+
+function writeJson(path, data) {
+  writeFileSync(path, JSON.stringify(data, undefined, 2) + '\n');
+}
+
+/** Ensure dshloader is listed in the profile package.json dependencies. */
+export function injectDependency(pkgPath) {
+  const manifest = readJson(pkgPath) ?? { name: '', dependencies: {} };
+  manifest.dependencies = manifest.dependencies ?? {};
+  if (manifest.dependencies[LOADER_PKG] === undefined) {
+    manifest.dependencies[LOADER_PKG] = '^' + LOADER_VERSION;
+    writeJson(pkgPath, manifest);
+    return { added: true, manifest };
+  }
+  return { added: false, manifest };
+}
+
+/** Ensure the dshloader insert entry exists in cordis.patch.yml (no reorder). */
+export function injectPatch(patchPath) {
+  let text = '';
+  try {
+    text = readFileSync(patchPath, 'utf8');
+  } catch {
+    text = '';
+  }
+  if (text.includes("id: dsh-loader")) {
+    return { added: false, text };
+  }
+  const insertion = `- insert:\n    ${PATCH_ENTRY}\n`;
+  const next = text.length === 0 ? insertion : text.endsWith('\n') ? text + insertion : text + '\n' + insertion;
+  writeFileSync(patchPath, next);
+  return { added: true, text: next };
+}
+
+/**
+ * Run `dshloader setup <profile>`.
+ * @param {string} profileName
+ * @returns {{ profileDir: string, dependencyAdded: boolean, patchAdded: boolean }}
+ */
+export function setupProfile(profileName) {
+  const dir = profileDir(profileName);
+  if (!existsSync(dir)) {
+    throw new Error(`${LOG_PREFIX} profile directory not found: ${dir}`);
+  }
+  const pkgPath = join(dir, 'package.json');
+  const patchPath = join(dir, 'cordis.patch.yml');
+  const dep = injectDependency(pkgPath);
+  const patch = injectPatch(patchPath);
+  console.log(`${LOG_PREFIX} setup ${profileName}: dependency ${dep.added ? 'added' : 'already present'}, patch ${patch.added ? 'appended' : 'already present'}`);
+  console.log(`${LOG_PREFIX} note: insert position is irrelevant — cordis reactive DI resolves aliases regardless of order (design.md §6.2)`);
+  return { profileDir: dir, dependencyAdded: dep.added, patchAdded: patch.added };
+}
+
+/** Best-effort dump-config validation. Returns { ok, output } (never throws). */
+export function dumpConfig(profileName) {
+  const dir = profileDir(profileName);
+  if (!existsSync(dir)) {
+    return { ok: false, output: `${LOG_PREFIX} profile directory not found: ${dir}` };
+  }
+  const result = spawnSync('dsh', ['--profile', profileName, '--dump-config'], {
+    encoding: 'utf8',
+    timeout: 60_000,
+  });
+  const output = (result.stdout ?? '') + (result.stderr ?? '');
+  return { ok: result.status === 0, output };
+}
+
+/** Print dshloader status for a profile (AC-OB-03, minimal). */
+export function info(profileName) {
+  console.log(`${LOG_PREFIX} version ${LOADER_VERSION}`);
+  const dir = profileName ? profileDir(profileName) : undefined;
+  const dshVersion = detectDshVersion(dir ? { profileDir: dir } : {});
+  console.log(`${LOG_PREFIX} detected dsh version: ${dshVersion ?? '<unknown>'}`);
+  if (dshVersion) {
+    try {
+      const reg = registerHostAdapters(new AdapterRegistry());
+      const { factory, mode } = reg.select(dshVersion);
+      console.log(`${LOG_PREFIX} selected adapter: ${factory.name} (supports ${factory.supports}, mode ${mode})`);
+    } catch (error) {
+      console.log(`${LOG_PREFIX} adapter selection: ${error.message}`);
+    }
+  }
+  return { loaderVersion: LOADER_VERSION, dshVersion };
+}

package/src/stable/agent.d.ts

@@ -0,0 +1 @@
+export * from '@deepseek-ai/dsh-agent';

package/src/stable/agent.js

@@ -0,0 +1,2 @@
+// Stable re-export: @dsh-plugin/dsh-loader/agent
+export * from '@deepseek-ai/dsh-agent';

package/src/stable/llm.d.ts

@@ -0,0 +1 @@
+export * from '@deepseek-ai/dsh-llm';

package/src/stable/llm.js

@@ -0,0 +1,2 @@
+// Stable re-export: @dsh-plugin/dsh-loader/llm
+export * from '@deepseek-ai/dsh-llm';

package/src/stable/runtime.d.ts

@@ -0,0 +1 @@
+export * from '@deepseek-ai/dsh-client-runtime/client';

package/src/stable/runtime.js

@@ -0,0 +1,5 @@
+// Stable re-export: @dsh-plugin/dsh-loader/runtime
+//
+// Maps to @deepseek-ai/dsh-client-runtime/client — the public client
+// entry point of the dsh client runtime.
+export * from '@deepseek-ai/dsh-client-runtime/client';

package/src/stable/schema-form.d.ts

@@ -0,0 +1 @@
+export * from '@deepseek-ai/dsh-client-schema-form';

package/src/stable/schema-form.js

@@ -0,0 +1,2 @@
+// Stable re-export: @dsh-plugin/dsh-loader/schema-form
+export * from '@deepseek-ai/dsh-client-schema-form';

package/src/stable/settings.d.ts

@@ -0,0 +1 @@
+export * from '@deepseek-ai/dsh-settings';

package/src/stable/settings.js

@@ -0,0 +1,2 @@
+// Stable re-export: @dsh-plugin/dsh-loader/settings
+export * from '@deepseek-ai/dsh-settings';

package/src/stable/tools.d.ts

@@ -0,0 +1 @@
+export * from '@deepseek-ai/dsh-tools';

package/src/stable/tools.js

@@ -0,0 +1,5 @@
+// Stable re-export: @dsh-plugin/dsh-loader/tools
+//
+// Host-side tools API. Plugins import from this subpath instead of
+// directly from @deepseek-ai/dsh-tools.
+export * from '@deepseek-ai/dsh-tools';

package/src/stable/ui-primitives.d.ts

@@ -0,0 +1,4 @@
+// Stable subpath types: @dsh-plugin/dsh-loader/ui-primitives
+// Re-export the real package's types so TS consumers (and this plugin's
+// client bundle) stay typed without importing @deepseek-ai/* directly.
+export * from '@deepseek-ai/dsh-client-ui-primitives';

package/src/stable/ui-primitives.js

@@ -0,0 +1,6 @@
+// Stable re-export: @dsh-plugin/dsh-loader/ui-primitives
+//
+// Plugins import UI primitives from this subpath instead of directly
+// from @deepseek-ai/dsh-client-ui-primitives. When dsh renames the
+// package, only this file (and the adapter's packageAliases) change.
+export * from '@deepseek-ai/dsh-client-ui-primitives';

package/src/stable/ui-settings.d.ts

@@ -0,0 +1,6 @@
+// Stable subpath types: @dsh-plugin/dsh-loader/ui-settings
+// Side-effect import triggers the dsh-client-ui-settings/client SlotMap
+// merge (adds 'settings.section') so PropsRuntime<'settings.section'>
+// stays typed. Re-export keeps values/types reachable.
+import '@deepseek-ai/dsh-client-ui-settings/client';
+export * from '@deepseek-ai/dsh-client-ui-settings/client';

package/src/stable/ui-settings.js

@@ -0,0 +1,4 @@
+// Stable re-export: @dsh-plugin/dsh-loader/ui-settings
+// Maps to dsh-client-ui-settings/client — the browser entry that owns the
+// settings.section SlotMap contract (see ui-settings.d.ts).
+export * from '@deepseek-ai/dsh-client-ui-settings/client';

package/src/stable/ui-slots.d.ts

@@ -0,0 +1 @@
+export * from '@deepseek-ai/dsh-client-ui-slots';

package/src/stable/ui-slots.js

@@ -0,0 +1,2 @@
+// Stable re-export: @dsh-plugin/dsh-loader/ui-slots
+export * from '@deepseek-ai/dsh-client-ui-slots';

package/src/stable/web-react.d.ts

@@ -0,0 +1 @@
+export * from '@deepseek-ai/dsh-client-web-react';

package/src/stable/web-react.js

@@ -0,0 +1,2 @@
+// Stable re-export: @dsh-plugin/dsh-loader/web-react
+export * from '@deepseek-ai/dsh-client-web-react';

package/src/version.js

@@ -0,0 +1,5 @@
+// dshloader version — keep in sync with package.json.
+export const LOADER_VERSION = '1.0.0';
+
+// Prefix used in every console log / error so users can grep dshloader output.
+export const LOG_PREFIX = '[dshloader]';