dsh-agent-plugins-market 0.9.0 → 0.9.2

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

@@ -1,86 +0,0 @@
-/**
- * The host seams a catalog consumes, in one declared place.
- *
- * Every seam is read at call time rather than captured at construction: the
- * credentials, tools and settings services resolve *after* `apply()` returns,
- * so a value snapshotted when the catalog is built would stay undefined for
- * the rest of the process. A composition root wires the seams it has;
- * {@link resolveCatalogPorts} fills in the rest from
- * {@link defaultCatalogPorts}, which keeps a bare `new Catalog({...})` — the
- * shape the tests build — fully functional.
- */
-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 '../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;
-    branch?: string;
-    local?: boolean;
-    kind?: SourceKind;
-    sha256?: string;
-}
-/** A partial source update; omitted fields keep their persisted value. */
-export interface SourcePatch {
-    url?: string;
-    branch?: string;
-    local?: boolean;
-    kind?: SourceKind;
-    sha256?: string;
-}
-/** The user's direct LSP server table, keyed by server name. */
-export type LspServerTable = Record<string, LspServerSpec>;
-/** Credential-store seam backing the MCP re-authorize action. */
-export interface CredentialGrantStore {
-    deleteGrantRecord(serverName: string): Promise<void>;
-}
-/** The complete set of host seams a catalog needs; every member is resolved. */
-export interface CatalogPorts {
-    /** Live host MCP tool registry snapshot for the status surface. */
-    mcpToolSnapshot(): readonly McpToolSnapshot[];
-    /** Absent when the credentials service is not mounted in this composition. */
-    credentialsStore: CredentialGrantStore | undefined;
-    /** Flags one mount key for an explicit rebuild on the next reconcile. */
-    mcpRemount(suiteId: string, serverKey: string): void;
-    /** Flags every live mount for an explicit rebuild on the next reconcile. */
-    mcpRemountAll(): void;
-    /** Resolves the mount key owning one derived serverName; undefined when not mounted. */
-    mcpServerOwner(serverName: string): {
-        suiteId: string;
-        serverKey: string;
-    } | undefined;
-    /** Latest LSP mount diagnostics. */
-    lspStatusSource: LspMountStatusSource;
-    /** The persisted MCP mount backend choice. */
-    mcpBackend(): Promise<McpBackend>;
-    /** Persists an MCP mount backend choice. */
-    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>;
-/**
- * The seams a catalog runs on when nothing is wired. The MCP backend writer
- * rejects rather than silently accepting a choice nothing can persist.
- */
-export declare const defaultCatalogPorts: CatalogPorts;
-/** Fill in every seam the composition root left unwired. */
-export declare function resolveCatalogPorts(overrides?: CatalogPortsOverride): CatalogPorts;

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

@@ -1,3 +0,0 @@
-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/contracts/settings.d.ts

@@ -1,59 +0,0 @@
-/**
- * Browser-safe settings contract of the market's host settings namespace: the
- * namespace key, the fields with their defaults, and the one reader that turns
- * a stored section into resolved values.
- *
- * The defaults live here and nowhere else. The namespace schema declares them
- * to the host, the node half reads them back through {@link resolveMarketSettings},
- * and the browser half — which cannot import `src/runtime` — reads the same
- * resolved values off the settings snapshot it is handed. Changing a default is
- * therefore a one-line edit in this module.
- *
- * @module contracts/settings
- */
-/** Settings namespace this plugin registers; the key the plugin-config tab pairs our card by. */
-export declare const MARKET_SETTINGS_NAMESPACE = "dsh-agent-plugins-market";
-/** The persisted download-region setting: `auto` follows the interface language. */
-export type DownloadRegionSetting = 'auto' | 'global' | 'china';
-/** Every market setting with the value it resolves to when the document says nothing. */
-export interface MarketSettings {
-    /** ON = the built-in MCP bridge with OAuth and SSE; OFF = host client compat mode. */
-    mcpEnhanced: boolean;
-    /** ON = native project Agent layouts (`.claude/`, `.agents/`) take part in discovery. */
-    scanProjectLayouts: boolean;
-    /** Download region for GitHub acquisition. */
-    downloadRegion: DownloadRegionSetting;
-    /** ON = the `report_market_issue` model tool is registered. */
-    feedbackEnabled: boolean;
-    /** ON = every configured source refreshes in the background. */
-    autoUpdateSources: boolean;
-}
-/**
- * The default of every market setting — the single place one is written.
- *
- * These are user-visible behavior: a flip here is a behavior change that ships
- * with its documentation, not a private implementation detail.
- */
-export declare const MARKET_SETTINGS_DEFAULTS: MarketSettings;
-/** Every field name the market's settings section carries. */
-export type MarketSettingKey = keyof MarketSettings;
-/**
- * Narrow an untrusted stored region to a setting; anything else reads as the
- * declared default.
- * @param value - the stored `downloadRegion` value.
- * @param fallback - the value an unrecognized input reads as.
- */
-export declare function narrowDownloadRegion(value: unknown, fallback?: DownloadRegionSetting): DownloadRegionSetting;
-/**
- * Resolve a stored settings section the way the host resolves it: each field
- * takes its stored value when it is one this field accepts, and its declared
- * default otherwise.
- *
- * The host hands the resolved section back on its own, but not every caller has
- * one — the plugin's own halves read a section they may not have received yet,
- * and a test hands in a bare literal. Funnelling all of them through this
- * function is what keeps a second reading of "what does missing mean" from
- * growing somewhere else.
- * @param section - the stored (or absent) namespace section, untrusted.
- */
-export declare function resolveMarketSettings(section: unknown): MarketSettings;

package/lib/types/routes.d.ts

@@ -1,16 +0,0 @@
-import type { IncomingMessage, ServerResponse } from 'node:http';
-import type { MarketService } from './application/queries.js';
-import type { PanelResourceStore } from './application/panel-resources.js';
-export interface WebServerService {
-    register(route: {
-        kind: 'exact' | 'prefix';
-        path: string;
-        handler: (request: IncomingMessage, response: ServerResponse) => void | Promise<void>;
-    }): () => void;
-}
-/** Mount every route; returns the disposer releasing them all. */
-export declare function mountSuiteRoutes(hostCtx: unknown, manager: MarketService, panels?: {
-    skills: PanelResourceStore;
-    commands: PanelResourceStore;
-    agents: PanelResourceStore;
-}): () => void;

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

@@ -1,58 +0,0 @@
-/**
- * Runtime reconciliation for enabled suites.
- *
- * One catalog snapshot is fanned out to the existing MCP, command, hook, and
- * LSP mount adapters. The adapters remain separate because their host surfaces
- * and failure semantics differ; this module owns ordering, containment, and
- * disposal only.
- */
-import type { Context } from '@deepseek-ai/cordis';
-import { type CommandMountDiagnostic } from '../surfaces/commands-mounts.js';
-import { type HooksMountDiagnostic } from '../surfaces/hooks-mounts.js';
-import { LspMountRegistry, type LspMountDiagnostic } from '../lsp/lsp-mounts.js';
-import { type McpMountDiagnostic } from '../mcp/mcp-mounts.js';
-import type { Suite } from '../../model/types.js';
-import { type HostTranslate } from '../host/host-locale.js';
-/** Diagnostics returned by one runtime reconciliation pass. */
-export interface RuntimeDiagnostics {
-    mcp: McpMountDiagnostic[];
-    commands: CommandMountDiagnostic[];
-    hooks: HooksMountDiagnostic[];
-    lsp: LspMountDiagnostic[];
-    errors: Array<{
-        surface: 'mcp' | 'commands' | 'hooks' | 'lsp';
-        reason: string;
-    }>;
-}
-export declare class RuntimeReconciler {
-    private readonly mcp;
-    private readonly commands;
-    private readonly hooks;
-    private readonly lspRegistry;
-    private readonly queues;
-    private disposed;
-    constructor(ctx: Context, dataRoot: string, t?: HostTranslate);
-    /** The LSP mount registry, consumed by the LSP status surface. */
-    get lsp(): LspMountRegistry;
-    /** Install the per-suite MCP overrides provider used at mount time. */
-    setMcpOverridesProvider(provider: () => Promise<Map<string, import('../../application/mcp/mcp-overrides.js').McpSuiteOverrides>>): void;
-    /** Install the live tool-name provider used for foreign-namespace mount guards. */
-    setMcpToolNamesProvider(provider: () => string[]): void;
-    /** Install the backend provider deciding which MCP client mounts each server. */
-    setMcpBackendProvider(provider: () => Promise<import('../../application/mcp/mcp-backend.js').McpBackend>): void;
-    /** Whether the current MCP snapshot uses one credential reference. */
-    usesCredential(ref: string): boolean;
-    /** Flag one MCP mount for an explicit rebuild on the next reconcile. */
-    forceMcpRemount(suiteId: string, serverKey: string): void;
-    /** Flag every live MCP mount for a rebuild on the next reconcile. */
-    forceMcpRemountAll(): void;
-    /** The mount key owning one derived serverName; undefined when not mounted here. */
-    mcpServerOwner(serverName: string): {
-        suiteId: string;
-        serverKey: string;
-    } | undefined;
-    /** Reconcile all runtime surfaces against one enabled-suite snapshot. */
-    reconcile(enabledSuites: readonly Suite[]): Promise<RuntimeDiagnostics>;
-    /** Dispose all live mounts and registrations. */
-    dispose(): Promise<void>;
-}

package/lib/types/runtime/panels/user-commands.d.ts

@@ -1,27 +0,0 @@
-/**
- * User command mounting: every enabled entry of the user commands panel
- * registers as a dsh slash command, so user-authored quick replies behave
- * exactly like suite commands — the body with `$ARGUMENTS` substituted rides
- * one follow-up message on the receiving agent. A nested entry registers
- * under its flattened call name (`git/commit` → `git-commit`) while the panel
- * keeps addressing it by path; when two entries flatten to one call name the
- * first registers and the other is reported. Reconciled on every catalog
- * change, keyed by the call name.
- * @module runtime/user-commands
- */
-import type { Context } from '@deepseek-ai/cordis';
-import type { HostTranslate } from '../host/host-locale.js';
-import type { UserPanelStore } from './user-panels.js';
-/** Register/unregister user-panel commands to match the panel's enabled entries. */
-export declare class UserCommandMountRegistry {
-    private readonly ctx;
-    private readonly store;
-    private readonly t;
-    private readonly fingerprints;
-    private readonly live;
-    constructor(ctx: Context, store: UserPanelStore, t: HostTranslate);
-    /** Sync the live registrations with the panel's enabled entries. */
-    reconcile(): Promise<string[]>;
-    /** Dispose every registration (plugin teardown). */
-    disposeAll(): void;
-}

package/lib/types/runtime/surfaces/commands-mounts.d.ts

@@ -1,48 +0,0 @@
-/**
- * Claude Code command compatibility: `commands/*.md` of enabled suites
- * register as dsh slash commands.
- *
- * A CC command is a prompt template the model executes (its body carries
- * `$ARGUMENTS`, path variables and `` !`cmd` `` dynamic-context placeholders),
- * so the handler maps it onto the harness's follow-up mechanism: the template
- * with those placeholders resolved becomes one durable user-role follow-up
- * message on the receiving agent. Registrations reconcile on every
- * enable/disable/install/uninstall; a broken command file, a failed injected
- * command, or an unavailable `ctx.commands` is contained per command and
- * reported as a diagnostic.
- */
-import type { Context } from '@deepseek-ai/cordis';
-import type { Suite, SuiteMarkdownResource } from '../../model/types.js';
-import { type HostTranslate } from '../host/host-locale.js';
-export interface CommandMountDiagnostic {
-    suiteId: string;
-    command: string;
-    reason: string;
-}
-interface CommandSpec {
-    name: string;
-    description: string;
-    body: string;
-    hint?: string;
-    /** Set when the command file belongs to a suite with a plugin root; absent for project-native files. */
-    suiteRoot?: string;
-    /** The suite's `${PLUGIN_DATA}` directory; absent for project-native files. */
-    suiteData?: string;
-}
-export declare class CommandMountRegistry {
-    private readonly ctx;
-    private readonly t;
-    private readonly dataRoot?;
-    private readonly fingerprints;
-    private readonly live;
-    constructor(ctx: Context, t?: HostTranslate, dataRoot?: string | undefined);
-    /** The live shell seam, when the profile has one; dynamic context stays literal without it. */
-    private shell;
-    /** Register/unregister suite commands to match the enabled suites exactly. */
-    reconcile(enabledSuites: Suite[]): Promise<CommandMountDiagnostic[]>;
-    /** Dispose every registered command; used at plugin teardown. */
-    disposeAll(): void;
-}
-/** Parse `commands/*.md` of one suite root (Claude Code format). */
-export declare function readCommands(root: string, resources?: SuiteMarkdownResource[]): Promise<CommandSpec[]>;
-export {};

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

@@ -1,23 +0,0 @@
-import type { SkillCandidate, SkillDefinition, SkillLookupOptions, SkillProvider } from '@deepseek-ai/dsh-skill';
-import type { Catalog } from '../../application/catalog.js';
-import { type ShellSeam } from './dynamic-context.js';
-export declare const SUITE_PROJECT_SOURCE = "agent-plugin-project";
-export declare const SUITE_USER_SOURCE = "agent-plugin-user";
-/** Runtime inputs the provider cannot read off one suite. */
-export interface SuiteSkillProviderOptions {
-    /** Plugin storage root holding each suite's data directory. */
-    dataRoot?: string;
-    /** Resolves the live shell seam; absent keeps dynamic-context placeholders literal. */
-    shell?: () => ShellSeam | undefined;
-}
-export declare class SuiteSkillProvider implements SkillProvider {
-    private readonly manager;
-    private readonly options;
-    readonly name = "agent-plugin";
-    constructor(manager: Catalog, options?: SuiteSkillProviderOptions);
-    list(options: SkillLookupOptions): Promise<SkillCandidate[]>;
-    get(candidate: SkillCandidate, options: SkillLookupOptions): Promise<SkillDefinition | undefined>;
-    private candidateFor;
-    private locate;
-    private locateProject;
-}