dsh-agent-plugins-market 0.8.0 → 0.8.2

package/lib/types/{runtime → application/mcp}/mcp-backend.d.ts

@@ -8,37 +8,39 @@
  * namespace (see `contracts/settings.ts`) registered by the plugin's node half:
  * the registration is what makes the host 插件配置 tab serve our card, the
  * client card binds it for state, and the node half watches it to remount
- * servers when the switch flips. `readMcpBackend` remains only as the
- * one-time migration from the earlier data-root `settings.json` choice.
+ * servers when the switch flips.
  *
- * @module runtime/mcp-backend
+ * @module application/mcp-backend
  */
 import z from '@deepseek-ai/schemastery';
-/** The MCP mount backend the market uses for suite servers. */
-export type McpBackend = 'builtin' | 'host';
+import type { McpBackend } from '../../contracts/mcp.js';
+export type { McpBackend };
 /**
  * Schema of the market settings namespace: the switches this plugin's config
  * card serves, with the defaults declared to the host. The values themselves
  * belong to {@link MARKET_SETTINGS_DEFAULTS}; this schema states them, it does
  * not own them.
  */
-export declare const MarketSettingsSchema: z<Schemastery.ObjectS<{
-    mcpEnhanced: z<boolean, boolean>;
-    scanProjectLayouts: z<boolean, boolean>;
-    downloadRegion: z<"auto" | "global" | "china", "auto" | "global" | "china">;
-    feedbackEnabled: z<boolean, boolean>;
-    autoUpdateSources: z<boolean, boolean>;
-}>, Schemastery.ObjectT<{
-    mcpEnhanced: z<boolean, boolean>;
-    scanProjectLayouts: z<boolean, boolean>;
-    downloadRegion: z<"auto" | "global" | "china", "auto" | "global" | "china">;
-    feedbackEnabled: z<boolean, boolean>;
-    autoUpdateSources: z<boolean, boolean>;
-}>>;
-/** Path of the legacy persisted settings file under the plugin data root. */
-export declare function marketSettingsPath(dataRoot: string): string;
-/** Read the legacy persisted backend; absent or invalid values read as the default. */
-export declare function readMcpBackend(dataRoot: string): Promise<McpBackend>;
+export declare const MarketSettingsFields: {
+    readonly mcpEnhanced: z<boolean, boolean, "defined">;
+    readonly scanProjectLayouts: z<boolean, boolean, "defined">;
+    readonly downloadRegion: z<"auto" | "global" | "china", "auto" | "global" | "china", "defined">;
+    readonly feedbackEnabled: z<boolean, boolean, "defined">;
+    readonly autoUpdateSources: z<boolean, boolean, "defined">;
+};
+export declare const MarketSettingsSchema: z<Schemastery.ObjectS<NoInfer<{
+    readonly mcpEnhanced: z<boolean, boolean, "defined">;
+    readonly scanProjectLayouts: z<boolean, boolean, "defined">;
+    readonly downloadRegion: z<"auto" | "global" | "china", "auto" | "global" | "china", "defined">;
+    readonly feedbackEnabled: z<boolean, boolean, "defined">;
+    readonly autoUpdateSources: z<boolean, boolean, "defined">;
+}>>, Schemastery.ObjectT<NoInfer<{
+    readonly mcpEnhanced: z<boolean, boolean, "defined">;
+    readonly scanProjectLayouts: z<boolean, boolean, "defined">;
+    readonly downloadRegion: z<"auto" | "global" | "china", "auto" | "global" | "china", "defined">;
+    readonly feedbackEnabled: z<boolean, boolean, "defined">;
+    readonly autoUpdateSources: z<boolean, boolean, "defined">;
+}>>, "plain">;
 /** What the host client probe reports: resolvability plus its version. */
 export interface HostMcpClientProbe {
     available: boolean;

package/lib/types/{runtime/mcp-client/config.d.ts → application/mcp/mcp-bridge-config.d.ts}

@@ -8,7 +8,17 @@
  *
  * @module runtime/mcp-client/config
  */
-import type { ReconnectConfig } from './connection.js';
+/** Automatic-reconnect tuning the transport configs carry. */
+export interface ReconnectConfig {
+    /** Reconnect automatically after a lost connection (default true). */
+    enabled?: boolean;
+    /** First reconnect delay in milliseconds; doubles per consecutive failed attempt (default 500). */
+    initialDelayMs?: number;
+    /** Backoff ceiling in milliseconds; also the uptime after which the attempt budget resets (default 30000). */
+    maxDelayMs?: number;
+    /** Consecutive failed attempts per outage before giving up for good (default 10). */
+    maxAttempts?: number;
+}
 import type { McpServerPolicy } from '../../model/types.js';
 /** Default timeout for individual MCP tool calls (ms). */
 export declare const DEFAULT_TOOL_CALL_TIMEOUT_MS = 60000;

package/lib/types/{runtime → application/mcp}/mcp-config.d.ts

@@ -1,6 +1,7 @@
-import type { Config } from './mcp-client/config.js';
+import type { Config } from './mcp-bridge-config.js';
 import { type McpServerOverride, type McpSuiteOverrides } from './mcp-overrides.js';
-import type { HarnessMcpPolicy, McpServer, McpServerPolicy, McpServerSse, McpServerStdio, McpServerStreamableHttp, Suite } from '../model/types.js';
+import type { McpStatusCode } from '../../contracts/mcp-status.js';
+import type { HarnessMcpPolicy, McpServer, McpServerPolicy, McpServerSse, McpServerStdio, McpServerStreamableHttp, Suite } from '../../model/types.js';
 export interface McpMountRequest {
     suiteId: string;
     serverKey: string;
@@ -43,15 +44,13 @@ export interface ResolvedMcpPolicy {
     /** Startup timeout. */
     startupTimeout: McpTimeoutResolution;
 }
-export type McpMountFailureCode = 'unsupported-transport' | 'missing-credential' | 'credential-error' | 'unmount-failed' | 'mount-failed'
-/** The derived serverName's namespace is already mounted by another MCP client — informational, not a failure. */
- | 'foreign-mount'
-/** Another source's identical suite/server pair mounted first — this copy is redundant, informational. */
- | 'duplicate-mount';
+export type McpMountFailureCode = Extract<McpStatusCode, 'unsupported-transport' | 'missing-credential' | 'credential-error' | 'unmount-failed' | 'mount-failed' | 'foreign-mount' | 'duplicate-mount'>;
 export interface McpMountFailure {
     serverKey: string;
     reason: string;
     code?: McpMountFailureCode;
+    /** The messages under the failure's `cause` chain, outermost first. */
+    causes?: string[];
     credentialRefs?: string[];
 }
 /** Optional DSH credential resolver used while building an in-memory mount. */

package/lib/types/application/mcp/mcp-direct-config.d.ts

@@ -0,0 +1,17 @@
+import { type McpSuiteConfig, type Suite } from '../../model/types.js';
+export declare const USER_MCP_SOURCE = "@user-mcp";
+export declare const USER_MCP_SUITE = "user-mcp";
+/**
+ * Load the user's own MCP declaration file.
+ *
+ * The suite always carries an `mcp` document — an absent or malformed
+ * `mcp.json` leaves an empty one — so callers read `.mcp.servers` directly
+ * instead of re-checking the optional field.
+ */
+export declare function loadUserMcpSuite(agentsRoot: string): Promise<Suite & {
+    mcp: McpSuiteConfig;
+}>;
+/** Add one service atomically; reject collisions and malformed config before writing. */
+export declare function addUserMcpServer(agentsRoot: string, name: string, server: unknown): Promise<void>;
+/** The user's hand-written MCP declaration file: `<agentsRoot>/mcp.json`. */
+export declare function userMcpPath(agentsRoot: string): string;

package/lib/types/{runtime → application/mcp}/mcp-overrides.d.ts

@@ -1,4 +1,4 @@
-import type { McpServerSse, McpServerStreamableHttp, McpServerStdio } from '../model/types.js';
+import type { McpServerSse, McpServerStreamableHttp, McpServerStdio } from '../../model/types.js';
 /** HTTP-shaped server sources (url + headers carriers) overrides can edit. */
 type McpServerHttp = McpServerStreamableHttp | McpServerSse;
 /** The largest timeout a bridge config and the host timer can hold. */

package/lib/types/{runtime → application/mcp}/mcp-status.d.ts

@@ -1,15 +1,15 @@
 import type { McpSuiteOverrides } from './mcp-overrides.js';
-import type { McpStatusPayload } from '../contracts/mcp-status.js';
-import { inspectToolRegistry, type McpToolSnapshot } from './tool-registry-observer.js';
-import type { Suite } from '../model/types.js';
-export type { McpStatusEntry, McpStatusPayload, McpStatusKind, McpStatusState } from '../contracts/mcp-status.js';
-export { inspectToolRegistry };
-export type { McpToolSnapshot } from './tool-registry-observer.js';
+import type { McpStatusCode, McpStatusPayload } from '../../contracts/mcp-status.js';
+import type { McpToolSnapshot } from '../ports.js';
+import type { Suite } from '../../model/types.js';
+export type { McpStatusEntry, McpStatusPayload, McpStatusKind, McpStatusState } from '../../contracts/mcp-status.js';
+export type { McpToolSnapshot };
 export interface McpDiagnostic {
     suiteId: string;
     serverKey: string;
     reason: string;
-    code?: 'unsupported-transport' | 'missing-credential' | 'credential-error' | 'unmount-failed' | 'mount-failed' | 'foreign-mount' | 'duplicate-mount';
+    code?: McpStatusCode;
+    causes?: string[];
     credentialRefs?: string[];
 }
 /** Build status rows from discovered plugin MCP definitions and observed tool names. */

package/lib/types/application/mcp-service.d.ts

@@ -1,10 +1,9 @@
-import type { McpStatusPayload } from '../contracts/mcp-status.js';
+import type { McpStatusPayload } from './mcp/mcp-status.js';
 import type { ServerConfigPayload } from '../contracts/market.js';
 import type { Suite } from '../model/types.js';
-import { type McpBackend } from '../runtime/mcp-backend.js';
-import { type McpImportResult } from '../runtime/mcp-direct-config.js';
-import type { McpMountDiagnostic } from '../runtime/mcp-mounts.js';
-import { type McpServerOverride, type McpSuiteOverrides } from '../runtime/mcp-overrides.js';
+import type { McpBackend } from '../contracts/mcp.js';
+import type { McpMountDiagnostic } from '../contracts/mcp.js';
+import { type McpServerOverride, type McpSuiteOverrides } from './mcp/mcp-overrides.js';
 import type { CatalogContext } from './catalog-context.js';
 import type { CatalogPorts, McpBackendInfo } from './ports.js';
 import type { SourceStore } from './source-store.js';
@@ -19,12 +18,6 @@ export declare class McpService {
     status(): Promise<McpStatusPayload>;
     /** Persist a user-owned MCP service and reconcile its bridge mount. */
     addServer(name: string, server: unknown): Promise<void>;
-    /**
-     * Import several pasted services in one write. Each entry is checked on its
-     * own and reports back with its own outcome, so a paste of many services
-     * never fails as a block.
-     */
-    importServers(servers: unknown, overwrite: boolean): Promise<McpImportResult>;
     /** Read effective service configuration without exposing credential literals. */
     serverConfig(kind: 'mcp' | 'lsp', id: string): Promise<ServerConfigPayload>;
     /**

package/lib/types/application/panel-resources.d.ts

@@ -1,5 +1,11 @@
 import type { UserPanelEntryWire, UserPanelKind } from '../contracts/market.js';
-import type { UserPanelStore } from '../runtime/user-panels.js';
+/** The user-panel store surface the panel resources drive (structural). */
+interface UserPanelEntries {
+    list(strict?: boolean): Promise<UserPanelEntryWire[]>;
+    create(name: string, text: string): Promise<UserPanelEntryWire>;
+    update(name: string, text: string): Promise<void>;
+    remove(name: string): Promise<void>;
+}
 import type { Catalog } from './catalog.js';
 /** The routes consume this structural surface, also implemented by user-only stores in tests. */
 export interface PanelResourceStore {
@@ -18,4 +24,5 @@ export interface PanelResourceStore {
 export declare function pluginResourceId(sourceId: string, suiteId: string, kind: UserPanelKind, name: string): string;
 /** Whether a panel entry id addresses a file inside an installed suite. */
 export declare function isPluginResourceId(id: string): boolean;
-export declare function createPanelResources(catalog: Catalog, users: Record<UserPanelKind, UserPanelStore>): Record<UserPanelKind, PanelResourceStore>;
+export declare function createPanelResources(catalog: Catalog, users: Record<UserPanelKind, UserPanelEntries>): Record<UserPanelKind, PanelResourceStore>;
+export {};

package/lib/types/{runtime → application/panels}/user-hooks.d.ts

@@ -1,4 +1,4 @@
-import { type Suite } from '../model/types.js';
+import { type Suite } from '../../model/types.js';
 export declare const USER_HOOKS_SOURCE = "@user-hooks";
 export declare const USER_HOOKS_SUITE = "user-hooks";
 /**

package/lib/types/{runtime → application/panels}/user-store.d.ts

@@ -11,7 +11,7 @@
  * to that directory. Skills also accept the cross-tool directory spelling
  * (`<name>/SKILL.md`) that other Agent tools and the harness's own reader of
  * `~/.agents/skills` author, and read it from the top level only.
- * @module runtime/user-store
+ * @module application/user-store
  */
 /** Where user panel entries persist: `<agentsRoot>/<kind>/`. */
 export declare function userEntryDir(agentsRoot: string, kind: 'skills' | 'commands' | 'agents'): string;

package/lib/types/application/ports.d.ts

@@ -12,9 +12,21 @@
 import type { LspServerSpec, SourceKind } from '../model/types.js';
 export type { McpBackendInfo } from '../contracts/market.js';
 import type { DownloadRegionSetting } from '../contracts/settings.js';
-import type { McpBackend } from '../runtime/mcp-backend.js';
-import type { LspMountStatusSource } from '../runtime/lsp-status.js';
-import type { McpToolSnapshot } from '../runtime/mcp-status.js';
+import type { McpBackend } from '../contracts/mcp.js';
+import type { LspMountDiagnostic } from '../contracts/lsp.js';
+/** One MCP tool observed from the host tool registry (structural). */
+export interface McpToolSnapshot {
+    name: string;
+    description?: string;
+    /** The input schema the server advertised, when the host exposes it. */
+    parameters?: unknown;
+}
+/** The LSP mount-registry surface the aggregator consumes (structural, for tests). */
+export interface LspMountStatusSource {
+    diagnosticsSnapshot(): Map<string, LspMountDiagnostic>;
+    hasLiveMounts(): boolean;
+    disabledServers?(): Set<string>;
+}
 /** A new source: its location, optional branch, and acquisition kind. */
 export interface SourceInput {
     url: string;
@@ -60,6 +72,8 @@ export interface CatalogPorts {
     setMcpBackend(backend: McpBackend): Promise<void>;
     /** The persisted download-region setting. */
     downloadRegion(): Promise<DownloadRegionSetting>;
+    /** The host locale preference ('zh' default when unset). */
+    localePreference(): string;
 }
 /** The seams a composition root may wire; the rest fall back to the defaults. */
 export type CatalogPortsOverride = Partial<CatalogPorts>;

package/lib/types/application/project-agent-roles.d.ts

@@ -1,3 +1,3 @@
-import { type AgentRoleEntry } from '../runtime/agent-role-router.js';
+import { type AgentRoleEntry } from './agent-roles.js';
 import type { Catalog } from './catalog.js';
 export declare function projectAgentRoles(catalog: Catalog, parent: unknown): Promise<AgentRoleEntry[]>;

package/lib/types/application/queries.d.ts

@@ -1,11 +1,10 @@
 /** Narrow application interfaces consumed by the HTTP transport adapter. */
-import type { McpStatusPayload } from '../contracts/mcp-status.js';
+import type { McpStatusPayload } from './mcp/mcp-status.js';
 import type { LspLegacySeamMigration, LspStatusPayload } from '../contracts/lsp-status.js';
 import type { OverviewPayload, SkillContent, SourceProgress, SuiteDetail } from '../contracts/market.js';
 import type { SourceRef, SuiteSurfaceKey } from '../model/types.js';
-import type { McpServerOverride, McpSuiteOverrides } from '../runtime/mcp-overrides.js';
-import type { McpBackend } from '../runtime/mcp-backend.js';
-import type { McpImportResult } from '../runtime/mcp-direct-config.js';
+import type { McpServerOverride, McpSuiteOverrides } from './mcp/mcp-overrides.js';
+import type { McpBackend } from '../contracts/mcp.js';
 import type { ServerConfigPayload } from '../contracts/market.js';
 import type { LspServerTable, McpBackendInfo, SourceInput, SourcePatch } from './ports.js';
 /** Read-only market operations required by HTTP routes. */
@@ -25,8 +24,6 @@ export interface MarketQueries {
 export interface MarketMutations {
     saveServerConfig(kind: 'mcp' | 'lsp', id: string, config: unknown, policy?: unknown): Promise<void>;
     addMcpServer(name: string, server: unknown): Promise<void>;
-    /** Import several pasted services in one write; each entry reports its own outcome. */
-    importMcpServers(servers: unknown, overwrite: boolean): Promise<McpImportResult>;
     addLspServer(name: string, config: unknown): Promise<void>;
     addSource(input: SourceInput): Promise<SourceRef>;
     updateSource(sourceId: string, patch: SourcePatch): Promise<void>;

package/lib/types/{runtime → application}/regions.d.ts

@@ -11,7 +11,7 @@
  * can flip at any time; sources already cloned keep their proxied origin and
  * follow it on refresh.
  *
- * @module runtime/regions
+ * @module application/regions
  */
 import type { DownloadRegionSetting } from '../contracts/settings.js';
 /** The route downloads actually take. */

package/lib/types/{runtime → application/state}/state-store.d.ts

@@ -1,6 +1,6 @@
-import { type SuiteState } from '../model/types.js';
+import { type SuiteState } from '../../model/types.js';
 export declare const EMPTY_STATE: SuiteState;
 /** Parse persisted state; unreadable or wrong-version files yield a contained empty state. */
 export declare function loadState(statePath: string): Promise<SuiteState>;
-/** Persist state atomically through the harness's atomic-write helper. */
+/** Persist state atomically through the shared JSON document writer. */
 export declare function saveState(statePath: string, state: SuiteState): Promise<void>;

package/lib/types/catalog/source-catalog.d.ts

@@ -1,6 +1,4 @@
 import type { DiscoveredSuite, SourceRef, SuiteDimension } from '../model/types.js';
-/** Discover suites from the selected configured or project checkouts. */
-export declare function discoverSourceList(sources: SourceRef[], dimension: SuiteDimension, dimensionRoot: string): Promise<DiscoveredSuite[]>;
 /**
  * Discover suites plus per-source scan diagnostics for one dimension.
  * @param scanProjectLayouts - whether the project's own native Agent directories

package/lib/types/contracts/lsp-status.d.ts

@@ -3,6 +3,8 @@
 export type LspStatusKind = 'plugin' | 'direct';
 /** Operational state rendered for an LSP server row. */
 export type LspStatusState = 'mounted' | 'starting' | 'host-missing' | 'failed' | 'conflict' | 'disabled';
+/** Why a row reports a reason; also the key the panel localizes it by. */
+export type LspStatusCode = 'mount-failed' | 'unmount-failed' | 'seam-conflict' | 'host-missing';
 /**
  * One declared language-server row for the status surface.
  *
@@ -34,6 +36,10 @@ export interface LspStatusEntry {
     state: LspStatusState;
     /** Latest diagnostic reason, when the state is not `mounted`/`disabled`. */
     reason?: string;
+    /** Why this row carries a reason; also the key the panel localizes it by. */
+    code?: LspStatusCode;
+    /** The messages under the failure's `cause` chain, outermost first. */
+    causes?: string[];
     /** Whether a failed mount will be retried automatically. */
     retryable?: boolean;
 }

package/lib/types/contracts/lsp.d.ts

@@ -0,0 +1,16 @@
+/**
+ * LSP wire vocabulary shared by the application services and the runtime
+ * mounts: the mount-diagnostic shape the status payload carries. Contracts
+ * import nothing; these are data only.
+ * @module contracts/lsp
+ */
+import type { LspStatusCode } from './lsp-status.js';
+/** One LSP mount failure as the registry records it for the status surface. */
+export interface LspMountDiagnostic {
+    suiteId: string;
+    serverKey: string;
+    reason: string;
+    code?: LspStatusCode;
+    /** The messages under the failure's `cause` chain, outermost first. */
+    causes?: string[];
+}

package/lib/types/contracts/market.d.ts

@@ -6,7 +6,6 @@ export declare const MARKET_ROUTES: {
     readonly overview: "/api/agent-plugins/overview";
     readonly mcpStatus: "/api/agent-plugins/mcp-status";
     readonly addMcpServer: "/api/agent-plugins/mcp-servers/add";
-    readonly importMcpServers: "/api/agent-plugins/mcp-servers/import";
     readonly lspStatus: "/api/agent-plugins/lsp-status";
     readonly lspServers: "/api/agent-plugins/lsp-servers";
     readonly addLspServer: "/api/agent-plugins/lsp-servers/add";
@@ -259,8 +258,6 @@ export interface MarkdownPreview {
     description?: string;
     content: string;
 }
-/** Claude Code command preview alias retained for feature-specific readability. */
-export type CommandPreview = MarkdownPreview;
 /** Claude Code agent preview alias retained for feature-specific readability. */
 export type AgentPreview = MarkdownPreview;
 /** One LSP definition preview in a suite detail response. */
@@ -351,7 +348,7 @@ export interface UserPanelEntryWire {
     name: string;
     description: string;
     disabled: boolean;
-    /** User and managed plugin entries are editable; external source files remain read-only. */
+    /** User entries are editable; suite-owned plugin entries answer only to the enable switch. */
     origin: 'user' | 'plugin';
     id?: string;
     rawText: string;

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

@@ -10,6 +10,18 @@ export interface McpStatusTool {
 export type McpStatusKind = 'plugin' | 'direct';
 /** Operational state rendered for an MCP row. `foreign` = mounted by another MCP client (informational). */
 export type McpStatusState = 'connected' | 'degraded' | 'failed' | 'needs-credentials' | 'orphaned' | 'disabled' | 'foreign';
+/**
+ * Why a row carries a reason. The mount failures explain a failed connection;
+ * the remaining entries are the states that have something to say without
+ * being broken, and each one has its own wording in the panel.
+ */
+export type McpStatusCode = 'unsupported-transport' | 'missing-credential' | 'credential-error' | 'unmount-failed' | 'mount-failed' | 'foreign-mount' | 'duplicate-mount'
+/** Tools are still registered although the surface that declared them is gone. */
+ | 'orphaned-tools'
+/** Switched off through this plugin's own override record. */
+ | 'disabled-override'
+/** A stored override changed the configuration the suite declares. */
+ | 'modified-override';
 /** One MCP service row for the status surface. */
 export interface McpStatusEntry {
     id: string;
@@ -27,9 +39,16 @@ export interface McpStatusEntry {
     endpoint?: string;
     config?: Record<string, unknown>;
     tools: McpStatusTool[];
+    /** The one-line diagnostic this row reports, in the words of the layer that failed. */
     reason?: string;
-    /** Mount-path classification when a diagnostic produced this row. */
-    code?: 'unsupported-transport' | 'missing-credential' | 'credential-error' | 'unmount-failed' | 'mount-failed' | 'foreign-mount' | 'duplicate-mount';
+    /** Why this row carries a reason; also the key the panel localizes it by. */
+    code?: McpStatusCode;
+    /**
+     * The messages under the failure's `cause` chain, outermost first. A wrapper
+     * sentence such as `initial connection … failed` names no cause by itself, so
+     * the detail that points at the real problem travels beside it.
+     */
+    causes?: string[];
     /** Environment-variable credential references required by this server. */
     credentialRefs?: string[];
     /** Whether this server advertised zero tools at observation time. Zero-tool

package/lib/types/contracts/mcp.d.ts

@@ -0,0 +1,20 @@
+/**
+ * MCP wire vocabulary shared by the host surface, the application services and
+ * the runtime mounts: the backend selector and the diagnostic shape the status
+ * payload carries. Contracts import nothing; these are data only. The mount
+ * registries narrow `code` to their own failure-code unions at the source.
+ * @module contracts/mcp
+ */
+import type { McpStatusCode } from './mcp-status.js';
+/** The MCP mount backend the market uses for suite servers. */
+export type McpBackend = 'builtin' | 'host';
+/** One MCP mount failure as the registries record it for the status surface. */
+export interface McpMountDiagnostic {
+    suiteId: string;
+    serverKey: string;
+    reason: string;
+    code?: McpStatusCode;
+    /** The messages under the failure's `cause` chain, outermost first. */
+    causes?: string[];
+    credentialRefs?: string[];
+}

package/lib/types/index.d.ts

@@ -13,11 +13,14 @@
  * self-contained: suites' MCP servers mount through the market's own bridge
  * plugin on the host `tools` registry.
  */
-import type { Context } from '@deepseek-ai/cordis';
+import { type Context, type Volatile } from '@deepseek-ai/cordis';
+import z from '@deepseek-ai/schemastery';
+import type { DownloadRegionSetting } from './contracts/settings.js';
 import type { SourceRef } from './model/types.js';
 export declare const name = "dsh-agent-plugins-market";
 export declare const inject: string[];
 /** Host configuration. */
+/** Host configuration; the five market settings arrive as volatile references the host updates in place. */
 export interface Config {
     /** User-dimension suite root; defaults to `~/.dsh/agent-plugins` (`$DSH_HOME/agent-plugins`). */
     userRoot?: string;
@@ -40,5 +43,88 @@ export interface Config {
         fallbackTarball?: boolean;
         allowHttpArchives?: boolean;
     };
+    /** MCP mount backend switch; updated live through the host settings service. */
+    mcpEnhanced: Volatile<boolean | undefined>;
+    /** Project-layout discovery switch; updated live through the host settings service. */
+    scanProjectLayouts: Volatile<boolean | undefined>;
+    /** Download region choice; updated live through the host settings service. */
+    downloadRegion: Volatile<DownloadRegionSetting | undefined>;
+    /** Experience-feedback tool switch; updated live through the host settings service. */
+    feedbackEnabled: Volatile<boolean | undefined>;
+    /** Background source-update switch; updated live through the host settings service. */
+    autoUpdateSources: Volatile<boolean | undefined>;
 }
+/**
+ * Schemastery projection the host loader reads: the five volatile fields become
+ * the `dsh-agent-plugins-market` settings namespace (the Plugins panel's
+ * configuration page reads it), while the startup fields stay plain.
+ */
+/** The schema's input face: every field optional, exactly what a profile patch may carry. */
+export interface ConfigInput {
+    userRoot?: string | null;
+    dataRoot?: string | null;
+    sources?: unknown;
+    git?: {
+        proxy?: string | null;
+        insteadOf?: Record<string, unknown>;
+        timeoutMs?: number | null;
+        cloneRetry?: boolean | null;
+        fallbackTarball?: boolean | null;
+        allowHttpArchives?: boolean | null;
+    };
+    mcpEnhanced?: boolean | null;
+    scanProjectLayouts?: boolean | null;
+    downloadRegion?: 'auto' | 'global' | 'china' | null;
+    feedbackEnabled?: boolean | null;
+    autoUpdateSources?: boolean | null;
+}
+export declare const Config: z<Schemastery.ObjectS<NoInfer<{
+    userRoot: z<string | undefined, string | undefined, "plain">;
+    dataRoot: z<string | undefined, string | undefined, "plain">;
+    sources: z<any, any, "plain">;
+    git: z<Schemastery.ObjectS<NoInfer<{
+        proxy: z<string, string, "plain">;
+        insteadOf: z<import("@deepseek-ai/cosmokit").Dict<string, any>, import("@deepseek-ai/cosmokit").Dict<string, any>, "plain">;
+        timeoutMs: z<number, number, "plain">;
+        cloneRetry: z<boolean, boolean, "plain">;
+        fallbackTarball: z<boolean, boolean, "plain">;
+        allowHttpArchives: z<boolean, boolean, "plain">;
+    }>>, Schemastery.ObjectT<NoInfer<{
+        proxy: z<string, string, "plain">;
+        insteadOf: z<import("@deepseek-ai/cosmokit").Dict<string, any>, import("@deepseek-ai/cosmokit").Dict<string, any>, "plain">;
+        timeoutMs: z<number, number, "plain">;
+        cloneRetry: z<boolean, boolean, "plain">;
+        fallbackTarball: z<boolean, boolean, "plain">;
+        allowHttpArchives: z<boolean, boolean, "plain">;
+    }>>, "plain">;
+    mcpEnhanced: z<boolean, boolean, "volatile-defined">;
+    scanProjectLayouts: z<boolean, boolean, "volatile-defined">;
+    downloadRegion: z<"auto" | "global" | "china", "auto" | "global" | "china", "volatile-defined">;
+    feedbackEnabled: z<boolean, boolean, "volatile-defined">;
+    autoUpdateSources: z<boolean, boolean, "volatile-defined">;
+}>>, Schemastery.ObjectT<NoInfer<{
+    userRoot: z<string | undefined, string | undefined, "plain">;
+    dataRoot: z<string | undefined, string | undefined, "plain">;
+    sources: z<any, any, "plain">;
+    git: z<Schemastery.ObjectS<NoInfer<{
+        proxy: z<string, string, "plain">;
+        insteadOf: z<import("@deepseek-ai/cosmokit").Dict<string, any>, import("@deepseek-ai/cosmokit").Dict<string, any>, "plain">;
+        timeoutMs: z<number, number, "plain">;
+        cloneRetry: z<boolean, boolean, "plain">;
+        fallbackTarball: z<boolean, boolean, "plain">;
+        allowHttpArchives: z<boolean, boolean, "plain">;
+    }>>, Schemastery.ObjectT<NoInfer<{
+        proxy: z<string, string, "plain">;
+        insteadOf: z<import("@deepseek-ai/cosmokit").Dict<string, any>, import("@deepseek-ai/cosmokit").Dict<string, any>, "plain">;
+        timeoutMs: z<number, number, "plain">;
+        cloneRetry: z<boolean, boolean, "plain">;
+        fallbackTarball: z<boolean, boolean, "plain">;
+        allowHttpArchives: z<boolean, boolean, "plain">;
+    }>>, "plain">;
+    mcpEnhanced: z<boolean, boolean, "volatile-defined">;
+    scanProjectLayouts: z<boolean, boolean, "volatile-defined">;
+    downloadRegion: z<"auto" | "global" | "china", "auto" | "global" | "china", "volatile-defined">;
+    feedbackEnabled: z<boolean, boolean, "volatile-defined">;
+    autoUpdateSources: z<boolean, boolean, "volatile-defined">;
+}>>, "plain">;
 export declare function apply(ctx: Context, config?: Config): Promise<void>;

package/lib/types/model/types.d.ts

@@ -112,20 +112,6 @@ export interface SuiteSurfaceCounts {
     agents: number;
     lsp: number;
 }
-/**
- * Client-specific manifest data under the `com.deepseek.harness` extension
- * namespace (Agent Plugins §8.1), carried by `plugin.json` `extensions`.
- */
-export interface HarnessExtension {
-    /** Namespace contract version this suite was written against. */
-    schemaVersion: string;
-    /**
-     * Client policy for portable `mcp.json` servers, keyed by the server's own
-     * name in `mcp.json`; entries without a matching server are reported and
-     * ignored.
-     */
-    mcpServers?: Record<string, HarnessMcpPolicy>;
-}
 /**
  * dsh-owned per-server policy for a portable MCP server: OAuth 2.1
  * authorization for servers that answer `401` with a challenge, tool

package/lib/types/runtime/{agent-role-router.d.ts → agents/agent-role-router.d.ts}

@@ -1,32 +1,9 @@
 import type { Context } from '@deepseek-ai/cordis';
 import { type SubagentCatalogEntry } from './subagent-catalog.js';
+import { parseAgentRole, type AgentRoleEntry, type AgentRolePolicy } from '../../application/agent-roles.js';
+export { parseAgentRole };
+export type { AgentRoleEntry, AgentRolePolicy };
 export declare const AGENT_ROLE_TOOL_NAME = "subagent_role";
-/** Panel identity is preserved so identically named cards from different suites remain addressable. */
-export interface AgentRoleEntry {
-    name: string;
-    path: string;
-    description: string;
-    disabled: boolean;
-    title?: string;
-    rawText?: string;
-    /** Suite checkout root the card's `${PLUGIN_ROOT}` variables resolve to; absent for project-native files. */
-    suiteRoot?: string;
-    /** The suite's `${PLUGIN_DATA}` directory; absent for project-native files. */
-    suiteData?: string;
-}
-/**
- * The executable part of one card. `tools` / `disallowedTools` stay in the file
- * and are preserved by the editors, but they are not applied.
- */
-export interface AgentRolePolicy {
-    content: string;
-    model?: string;
-    provider?: string;
-    reasoningEffort?: string;
-    title?: string;
-    description?: string;
-    disabled: boolean;
-}
 /** Child LLM options this plugin sends; never carries inherited parent values. */
 export interface AgentRoleOptions {
     provider?: string;
@@ -108,8 +85,6 @@ export interface AgentRoleJobs {
         run(): AgentRoleJob;
     }): string;
 }
-/** Strict YAML parsing prevents malformed routing metadata from silently inheriting wider privileges. */
-export declare function parseAgentRole(text: string): AgentRolePolicy;
 /**
  * Resolve the child LLM options for one role call.
  *