@dsh-plugin/dsh-loader 1.3.2 → 1.3.3

package/lib/types/adapters/dsh-1-x.d.ts

@@ -3,6 +3,8 @@ export declare const supports = ">=0.1.0-rc.1 <2.0.0";
 export declare const name = "dsh-1-x";
 export declare const BRIDGE_PREFIX = "/api/dshloader";
 export declare const hostPackageAliases: Record<string, string>;
+export declare const clientModuleAliases: Record<string, string>;
+export declare const clientPackageAliases: Record<string, string>;
 /**
  * Install a Module._resolveFilename hook that maps old package names to
  * new ones for CJS require() calls. Returns a dispose function that

package/lib/types/adapters/index.d.ts

@@ -7,16 +7,6 @@ export declare function registerHostAdapters(registry: AdapterRegistry): Adapter
 export declare const clientAdapters: {
     supports: string;
     name: string;
-    moduleAliases: {
-        '@deepseek-ai/dsh-client-runtime/src/client/sessions/context-provenance.ts': string;
-        'dsh/runtime/context-provenance': string;
-    };
-    packageAliases: {
-        '@dsh-plugin/dsh-loader/ui-primitives': string;
-        '@dsh-plugin/dsh-loader/ui-slots': string;
-        '@dsh-plugin/dsh-loader/web-react': string;
-        '@dsh-plugin/dsh-loader/schema-form': string;
-        '@dsh-plugin/dsh-loader/ui-settings': string;
-        '@dsh-plugin/dsh-loader/runtime': string;
-    };
+    moduleAliases: Record<string, string>;
+    packageAliases: Record<string, string>;
 }[];

package/lib/types/boot-injection.d.ts

@@ -0,0 +1,32 @@
+import type { CordisContext } from './types.js';
+/**
+ * Build the inline boot script registering one module-table alias factory
+ * per `aliases` entry (stable name → real dsh package name).
+ *
+ * The script is realm-safe in both facade states: when `__ModuleLoader__`
+ * already exists it registers immediately; otherwise it installs a
+ * property interceptor that catches the bootstrap queue script's
+ * `window.__ModuleLoader__ = {...}` assignment, registers into the fresh
+ * facade's pending queue, and restores a plain writable data property so
+ * later code (facade `create`, dshloader's apply-time load wrapper) sees a
+ * normal global.
+ *
+ * @param aliases - alias module id → real module id.
+ * @returns JavaScript source for an inline classic script.
+ */
+export declare function buildBootAliasScript(aliases: Record<string, string>): string;
+/**
+ * Contribute the boot-alias script to every rendered index page.
+ *
+ * The listener pushes one `{ kind: 'script', placement: 'head' }` row onto
+ * the injection table the host webserver gathers per index render. On dsh
+ * versions whose webserver never emits `webserver/index-inject` the
+ * listener simply never fires and only the apply-time path registers
+ * aliases — the pre-0.1.2 behaviour that already worked there.
+ *
+ * @param ctx - host plugin context.
+ * @param aliases - alias module id → real module id (both the package and
+ *   the deep-import module alias tables).
+ * @returns Dispose function removing the listener.
+ */
+export declare function installBootAliasInjection(ctx: CordisContext, aliases: Record<string, string>): () => void;

package/lib/types/client-connection-api-compat.d.ts

@@ -0,0 +1,90 @@
+/** The legacy RPC proxy property checked on the connection handle. */
+export declare const CONNECTION_SERVICE = "connection";
+/** The dsh ≥ 0.1.2 Typert application-RPC service. */
+export declare const REMOTE_SERVICE = "remote";
+/** Minimal cordis client context surface this bridge touches. */
+export interface ConnectionApiCompatContext {
+    get?(name: string): unknown;
+    inject?(inject: string[], callback: (ctx: ConnectionApiCompatContext) => unknown): unknown;
+}
+/** Bare RpcResult the 0.1.2 Typert remote resolves to. */
+export interface RpcResultOk<T> {
+    ok: true;
+    value: T;
+}
+export interface RpcResultError {
+    ok: false;
+    error: {
+        code: string;
+        message: string;
+        details?: unknown;
+    };
+}
+export type RpcResult<T> = RpcResultOk<T> | RpcResultError;
+/** The legacy 0.1.1 response envelope consumers unwrap with `valueOf`. */
+export interface RpcResponse<T> {
+    result: RpcResult<T>;
+}
+interface LlmProviderInfoLike {
+    id: string;
+    label?: string;
+}
+interface LlmConfigurableProviderLike {
+    provider: string;
+    displayName: string;
+    settingsNs: string;
+    settingsPath?: readonly string[];
+    declared?: boolean;
+}
+/** The remote namespaces this bridge adapts. */
+interface RemoteLike {
+    llm?: {
+        listProviders?(): Promise<RpcResult<readonly LlmProviderInfoLike[]>>;
+        listConfigurableProviders?(): Promise<RpcResult<readonly LlmConfigurableProviderLike[]>>;
+    };
+    session?: {
+        modelCatalog?(): Promise<RpcResult<unknown>>;
+    };
+    settings?: {
+        describe?(): Promise<RpcResult<SettingsDescribeLike>>;
+        /** 0.1.2: merge a patch into the namespace's stored user section. */
+        update?(ns: string, patch: Record<string, unknown>, expectedRevision?: number): Promise<RpcResult<unknown>>;
+        /** 0.1.2: replace the namespace's stored user section wholesale. */
+        replace?(ns: string, section: Record<string, unknown>, expectedRevision?: number): Promise<RpcResult<unknown>>;
+        mutate?(ns: string, ops: readonly unknown[], expectedRevision?: number): Promise<RpcResult<unknown>>;
+    };
+}
+interface SettingsNamespaceViewLike {
+    ns: string;
+    user?: unknown;
+    revision?: number;
+}
+interface SettingsDescribeLike {
+    namespaces: readonly SettingsNamespaceViewLike[];
+    writable?: boolean;
+}
+/**
+ * Build the legacy `connection.api` proxy over a 0.1.2 `ctx.remote` face.
+ * Namespaces or methods missing from the remote degrade to a `transport`
+ * failure response rather than a synchronous throw, so one absent method does
+ * not take down the whole proxy.
+ */
+export declare function buildLegacyApiProxy(remote: RemoteLike): Record<string, unknown>;
+/**
+ * Install the legacy `connection.api` proxy when the host's connection
+ * handle lacks one.
+ *
+ * The inject list names every nested Remote service the proxy touches:
+ * cordis guards nested service access (`remote.session` etc.) behind the
+ * caller fiber's inject declarations, so the namespaces are resolved through
+ * `scope.get('remote.<name>')` inside the ordered fiber rather than by
+ * walking properties off the `remote` service.
+ *
+ * @param ctx - the client plugin's cordis context.
+ * @param onReady - invoked once the proxy question is settled: synchronously
+ *   when no bridge is needed (legacy host, or a context without inject), or
+ *   from the ordered inject fiber after the proxy was attached.
+ * @returns true when the ready signal was delivered synchronously.
+ */
+export declare function installConnectionApiCompat(ctx: ConnectionApiCompatContext, onReady: () => void): boolean;
+export {};

package/lib/types/client-conversation-compat.d.ts

@@ -0,0 +1,19 @@
+/** The legacy service name consumers inject. */
+export declare const CONVERSATION_EVENTS_SERVICE = "conversationEvents";
+/** The dsh ≥ 0.1.2 service owning the definition registry. */
+export declare const UI_CONVERSATION_SERVICE = "uiConversation";
+/** Minimal cordis client context surface this bridge touches. */
+export interface ConversationCompatContext {
+    get?(name: string): unknown;
+    provide?(name: string, value: unknown): unknown;
+    inject?(inject: string[], callback: (ctx: ConversationCompatContext) => unknown): unknown;
+}
+/**
+ * Provide the legacy `conversationEvents` service when the host lacks it.
+ *
+ * @param ctx - the client plugin's cordis context.
+ * @returns true when the bridge was armed (legacy name absent and inject
+ *   available), false when the host already provides the service or the
+ *   context cannot order provision.
+ */
+export declare function installConversationEventsCompat(ctx: ConversationCompatContext): boolean;

package/lib/types/client-ui.d.ts

@@ -1,6 +1,8 @@
 import { type DshLoaderUi } from './ui/index.js';
 export * from './ui/index.js';
 export { createClientAPI, ensureDshModulesGlobal, installClient, installSettingsFetchInterceptor, ModuleNotFoundError, } from './client.js';
+export { installConversationEventsCompat } from './client-conversation-compat.js';
+export { installConnectionApiCompat, buildLegacyApiProxy } from './client-connection-api-compat.js';
 /** cordis plugin name (matches the npm package name and the bundle id). */
 export declare const name = "@dsh-plugin/dsh-loader";
 /** dshloader consumes no cordis service; it only provides. */
@@ -28,6 +30,8 @@ interface ClientContextLike {
     get?: (name: string) => unknown;
     effect?: (fn: () => unknown) => unknown;
     provide?: (name: string, value: unknown) => unknown;
+    /** Ordered dependent-fiber hook used by the conversationEvents bridge. */
+    inject?: (inject: string[], callback: (ctx: ClientContextLike) => unknown) => unknown;
     /**
      * The cordis plugin-loader service. dsh 0.1.0-rc.8+ carries the client
      * module system here (`ctx.loader.internal`) instead of exposing it as the

package/lib/types/client.d.ts

@@ -1,3 +1,4 @@
+import { BOOT_ALIAS_IDS_FLAG } from './version.js';
 /** Browser-only globals dshloader relies on (typed loosely so the module compiles without DOM lib). */
 type FetchImpl = (input: any, init?: any) => Promise<{
     clone(): {
@@ -26,6 +27,8 @@ interface DshLoaderWindowLike {
     };
     __dshNativeRequire__?: (spec: string) => any;
     __dshLoader__?: unknown;
+    /** Alias ids the boot injection (src/boot-injection.ts) already registered. */
+    [BOOT_ALIAS_IDS_FLAG]?: string[];
 }
 declare global {
 }

package/lib/types/types.d.ts

@@ -47,6 +47,8 @@ export interface HostAdapter {
 export interface HostAdapterConfig {
     exposeAllNamespaces?: boolean;
     hostPackageAliases?: Record<string, string>;
+    /** Extra client module-table aliases merged over the adapter's tables. */
+    clientPackageAliases?: Record<string, string>;
 }
 /** Result of AdapterRegistry.select(). */
 export interface AdapterSelection {

package/lib/types/version.d.ts

@@ -1,2 +1,3 @@
-export declare const LOADER_VERSION = "1.3.2";
+export declare const LOADER_VERSION = "1.3.3";
 export declare const LOG_PREFIX = "[dshloader]";
+export declare const BOOT_ALIAS_IDS_FLAG = "__dshLoaderBootAliases__";

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@dsh-plugin/dsh-loader",
-  "version": "1.3.2",
+  "version": "1.3.3",
   "description": "Runtime compatibility shim for dsh (DeepSeek Harness) cordis bundle plugins: decouples third-party plugins from real dsh internal service names, module paths, and RPC details via a version-aware adapter registry.",
   "type": "module",
   "repository": {