dsh-agent-plugins-market 0.5.0 → 0.5.2

package/lib/types/runtime/mcp-config.d.ts

@@ -1,4 +1,5 @@
 import type { StdioConfig, StreamableHttpConfig } from '@deepseek-ai/dsh-mcp-client';
+import { type McpSuiteOverrides } from './mcp-overrides.js';
 import type { Suite } from '../model/types.js';
 export interface McpMountRequest {
     suiteId: string;
@@ -11,11 +12,14 @@ export interface McpMountFailure {
 }
 /**
  * Build one mount request per supported mcp.json server.
+ * @param overrides user-owned per-server overrides (url/headers/env/args
+ *   replacement plus enable/disable); applied after source expansion, before
+ *   mount. Disabled servers are omitted from the result entirely.
  * @returns mount requests plus per-server failures (unsupported transport,
  *   invalid server key, or derived serverName collision candidates are
  *   checked by the mount registry, not here).
  */
-export declare function toMcpMounts(suite: Suite, pluginDataRoot: string): {
+export declare function toMcpMounts(suite: Suite, pluginDataRoot: string, overrides?: McpSuiteOverrides): {
     mounts: McpMountRequest[];
     failures: McpMountFailure[];
 };

package/lib/types/runtime/mcp-mounts.d.ts

@@ -10,6 +10,7 @@
  * diagnostic list.
  */
 import type { Context } from '@deepseek-ai/cordis';
+import type { McpSuiteOverrides } from './mcp-overrides.js';
 import type { Suite } from '../model/types.js';
 export interface McpMountDiagnostic {
     suiteId: string;
@@ -21,11 +22,19 @@ export declare class McpMountRegistry {
     private readonly pluginDataRoot;
     private readonly live;
     private readonly names;
+    private overridesProvider;
+    /** Serialize mount and unmount passes so a disable cannot race an in-flight spawn. */
+    private reconcileQueue;
     constructor(ctx: Context, pluginDataRoot: string);
-    /** Mount/unmount MCP servers to match the enabled suites exactly. */
+    /** Install the per-suite overrides provider (suiteId -> overrides). */
+    setOverridesProvider(provider: () => Promise<Map<string, McpSuiteOverrides>>): void;
+    /** Queue one reconciliation behind any in-flight mount/unmount pass. */
     reconcile(enabledSuites: Suite[]): Promise<McpMountDiagnostic[]>;
-    /** Dispose every live mount; used at plugin teardown. */
+    /** Mount/unmount MCP servers to match the enabled suites exactly. */
+    private reconcileNow;
+    /** Dispose every live mount after queued reconciliation passes settle. */
     disposeAll(): Promise<void>;
-    private mount;
+    /** Mount one precomputed request (source config merged with overrides). */
+    private mountWith;
     private unmount;
 }

package/lib/types/runtime/mcp-overrides.d.ts

@@ -0,0 +1,37 @@
+import type { McpServerStreamableHttp, McpServerStdio } from '../model/types.js';
+/** Per-server override record; absent fields pass through from the source. */
+export type McpServerOverride = {
+    /** Disabled servers are not mounted at all (default enabled). */
+    enabled?: boolean;
+    /** Replaces the source URL (streamable-http only). */
+    url?: string;
+    /** Replaces the whole header map (streamable-http only). */
+    headers?: Record<string, string>;
+    /** Replaces the whole env map (stdio). */
+    env?: Record<string, string>;
+    /** Replaces the whole args list (stdio). */
+    args?: string[];
+};
+/** Overrides for one suite, keyed by mcp.json server key. */
+export type McpSuiteOverrides = Record<string, McpServerOverride>;
+/** The overrides directory under the plugin data root. */
+export declare function overridesDir(dataRoot: string): string;
+/** One suite's override file path. */
+export declare function suiteOverridePath(dataRoot: string, suiteId: string): string;
+/** Load one suite's persisted overrides; unreadable files yield none. */
+export declare function loadSuiteOverrides(dataRoot: string, suiteId: string): Promise<McpSuiteOverrides>;
+/** Persist one suite's overrides atomically-ish (single writer, small file). */
+export declare function saveSuiteOverrides(dataRoot: string, suiteId: string, overrides: McpSuiteOverrides): Promise<void>;
+/** Keep only recognized fields with correct shapes; drop everything else. */
+export declare function sanitizeOverrides(raw: unknown): McpSuiteOverrides;
+/** Validate a client-supplied patch for one server into an override value. */
+export declare function sanitizeOverridePatch(patch: unknown): McpServerOverride | undefined;
+/**
+ * Apply one server's overrides onto its source shape. Field replacement is
+ * whole-map (headers/env/args), never per-key merge, so removing a key in the
+ * UI actually removes it at mount time. Values pass through the ordinary
+ * mount-time placeholder pipeline afterwards, so override authors may
+ * reference secrets as `${NAME}` or `${NAME:-fallback}` (resolved from the
+ * process environment in memory) instead of persisting them here.
+ */
+export declare function applyOverride(server: McpServerStdio | McpServerStreamableHttp, override: McpServerOverride | undefined): McpServerStdio | McpServerStreamableHttp;

package/lib/types/runtime/mcp-status.d.ts

@@ -1,5 +1,6 @@
 import type { McpStatusPayload } from '../contracts/mcp-status.js';
 import { inspectToolRegistry, type McpToolSnapshot } from './tool-registry-observer.js';
+import type { McpSuiteOverrides } from './mcp-overrides.js';
 import type { Suite } from '../model/types.js';
 export type { McpStatusEntry, McpStatusPayload, McpStatusKind, McpStatusState } from '../contracts/mcp-status.js';
 export { inspectToolRegistry };
@@ -10,4 +11,4 @@ interface McpDiagnostic {
     reason: string;
 }
 /** Build status rows from discovered plugin MCP definitions and observed tool names. */
-export declare function buildMcpStatus(suites: Suite[], diagnostics: McpDiagnostic[], observed: readonly McpToolSnapshot[]): McpStatusPayload;
+export declare function buildMcpStatus(suites: Suite[], diagnostics: McpDiagnostic[], observed: readonly McpToolSnapshot[], overrides?: Map<string, McpSuiteOverrides>): McpStatusPayload;

package/lib/types/runtime/reconciler.d.ts

@@ -11,6 +11,7 @@ import { type CommandMountDiagnostic } from './commands-mounts.js';
 import { type HooksMountDiagnostic } from './hooks-mounts.js';
 import { type McpMountDiagnostic } from './mcp-mounts.js';
 import type { Suite } from '../model/types.js';
+import { type HostTranslate } from './host-locale.js';
 /** Diagnostics returned by one runtime reconciliation pass. */
 export interface RuntimeDiagnostics {
     mcp: McpMountDiagnostic[];
@@ -25,7 +26,9 @@ export declare class RuntimeReconciler {
     private readonly mcp;
     private readonly commands;
     private readonly hooks;
-    constructor(ctx: Context, dataRoot: string);
+    constructor(ctx: Context, dataRoot: string, t?: HostTranslate);
+    /** Install the per-suite MCP overrides provider used at mount time. */
+    setMcpOverridesProvider(provider: () => Promise<Map<string, import('./mcp-overrides.js').McpSuiteOverrides>>): void;
     /** Reconcile all runtime surfaces against one enabled-suite snapshot. */
     reconcile(enabledSuites: readonly Suite[]): Promise<RuntimeDiagnostics>;
     /** Dispose all live mounts and registrations. */

package/lib/types/runtime/skills-provider.d.ts

@@ -1,11 +1,13 @@
 import type { SkillCandidate, SkillDefinition, SkillLookupOptions, SkillProvider } from '@deepseek-ai/dsh-skill';
 import type { Catalog } from '../application/catalog.js';
+import { type HostTranslate } from './host-locale.js';
 export declare const SUITE_PROJECT_SOURCE = "agent-plugin-project";
 export declare const SUITE_USER_SOURCE = "agent-plugin-user";
 export declare class SuiteSkillProvider implements SkillProvider {
     private readonly manager;
+    private readonly t;
     readonly name = "agent-plugin";
-    constructor(manager: Catalog);
+    constructor(manager: Catalog, t?: HostTranslate);
     list(options: SkillLookupOptions): Promise<SkillCandidate[]>;
     /** Parse `agents/*.md` of one suite into agent-definition candidates. */
     private agentsOf;

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "dsh-agent-plugins-market",
   "description": "The standard way to install Claude Code / Codex / Cursor / Kimi plugin marketplace suites in DeepSeek Harness (DSH) — zero conversion, zero file copying. Skills, MCP servers, hooks and slash commands are injected into your dsh sessions at runtime.",
-  "version": "0.5.0",
+  "version": "0.5.2",
   "type": "module",
   "main": "lib/index.js",
   "types": "lib/types/index.d.ts",

package/lib/context.js

@@ -1,78 +0,0 @@
-import { deriveServerName } from './runtime/mcp-config.js';
-/** Mount the agent_plugins query tool. */
-export function mountSuiteContext(ctx, manager) {
-    const disposers = [];
-    ctx.inject(['tools'], toolsCtx => {
-        const tools = toolsCtx;
-        if (typeof tools.tools?.register !== 'function')
-            return;
-        const parameters = {
-            type: 'object',
-            properties: {
-                action: { type: 'string', enum: ['list', 'info'], description: 'list: 列出全部 Agent Plugins；info: 查看单个 Agent Plugins 详情' },
-                suiteId: { type: 'string', description: 'info 动作时必填：Agent Plugins id' },
-                sourceId: { type: 'string', description: 'info 动作时可选：Agent Plugins 所属仓库源 id' }
-            },
-            required: ['action'],
-            additionalProperties: false
-        };
-        const outputSchema = {
-            type: 'object',
-            properties: {
-                suites: { type: 'array', items: { type: 'object' } },
-                skills: { type: 'array', items: { type: 'object' } },
-                mcpServers: { type: 'array', items: { type: 'object' } },
-                note: { type: 'string' }
-            }
-        };
-        const dispose = tools.tools.register({
-            name: 'agent_plugins',
-            description: '查询当前会话启用的 Agent Plugins：列出插件清单、技能与 MCP 工具前缀；技能正文通过 skill 工具加载。',
-            parameters,
-            renderIntent: 'generic',
-            output: {
-                schema: outputSchema,
-                render: (_args, value) => {
-                    const text = typeof value === 'string' ? value : JSON.stringify(value, null, 2);
-                    return [{ type: 'text', text }];
-                }
-            },
-            execute: async (args) => {
-                const record = args;
-                const action = record['action'];
-                if (action === 'list')
-                    return listPayload(await manager.enabledUserSuites());
-                if (action === 'info')
-                    return infoPayload(await manager.enabledUserSuites(), record);
-                return { suites: [], skills: [], mcpServers: [], note: `unknown action ${JSON.stringify(action)}` };
-            }
-        });
-        disposers.push(dispose);
-    });
-    return () => {
-        for (const dispose of disposers)
-            dispose();
-    };
-}
-function listPayload(suites) {
-    return {
-        suites: suites.map(suite => ({
-            id: suite.id,
-            sourceId: suite.sourceId,
-            name: suite.manifest.name,
-            version: suite.manifest.version ?? null,
-            description: suite.manifest.description ?? null,
-            layout: suite.manifest.layout
-        })),
-        skills: suites.flatMap(suite => suite.skills.map(skill => ({ suiteId: suite.id, name: skill.name, description: `[${suite.manifest.name}] ${skill.description}` }))),
-        mcpServers: suites.flatMap(suite => suite.mcp === undefined ? [] : Object.keys(suite.mcp.servers).map(key => ({ suiteId: suite.id, server: key, tools: `mcp__${deriveServerName(suite.id, key)}__*` }))),
-        note: '技能正文通过 skill 工具按 name 加载；MCP 工具名形如 mcp__<plugin>__<server>__<tool>。'
-    };
-}
-function infoPayload(suites, record) {
-    const suiteId = record['suiteId'];
-    const suite = suites.find(entry => entry.id === suiteId);
-    if (suite === undefined)
-        return { suites: [], skills: [], mcpServers: [], note: `未找到 Agent Plugins "${String(suiteId)}"（仅列出用户级已启用 Agent Plugins）` };
-    return listPayload([suite]);
-}

package/lib/types/context.d.ts

@@ -1,13 +0,0 @@
-/**
- * Runtime suite context: the `agent_plugins` query tool.
- *
- * Skills are injected by the native skill catalog (`dsh-tool-skill` renders
- * `ctx.skills` providers into the model's `<available_skills>` catalog), so
- * this module does not inject a duplicate session-start message. The tool
- * exists for facts the catalog does not carry: enabled plugins per
- * dimension, skill names per plugin, and MCP server prefixes.
- */
-import type { Context } from '@deepseek-ai/cordis';
-import type { Catalog } from './application/catalog.js';
-/** Mount the agent_plugins query tool. */
-export declare function mountSuiteContext(ctx: Context, manager: Catalog): () => void;