dsh-agent-plugins-market 0.9.0 → 0.9.2

package/lib/runtime/core/reconciler.js

@@ -1,100 +0,0 @@
-import { CommandMountRegistry } from '../surfaces/commands-mounts.js';
-import { HooksMountRegistry } from '../surfaces/hooks-mounts.js';
-import { LspMountRegistry } from '../lsp/lsp-mounts.js';
-import { McpMountRegistry } from '../mcp/mcp-mounts.js';
-import { bindHostLocale } from '../host/host-locale.js';
-export class RuntimeReconciler {
-    mcp;
-    commands;
-    hooks;
-    lspRegistry;
-    queues = new Map();
-    disposed = false;
-    constructor(ctx, dataRoot, t = bindHostLocale(undefined)) {
-        this.mcp = new McpMountRegistry(ctx, dataRoot);
-        this.commands = new CommandMountRegistry(ctx, t, dataRoot);
-        this.hooks = new HooksMountRegistry(ctx);
-        this.lspRegistry = new LspMountRegistry(ctx);
-        this.lspRegistry.setPluginDataRoot(dataRoot);
-    }
-    /** The LSP mount registry, consumed by the LSP status surface. */
-    get lsp() {
-        return this.lspRegistry;
-    }
-    /** Install the per-suite MCP overrides provider used at mount time. */
-    setMcpOverridesProvider(provider) {
-        this.mcp.setOverridesProvider(provider);
-    }
-    /** Install the live tool-name provider used for foreign-namespace mount guards. */
-    setMcpToolNamesProvider(provider) {
-        this.mcp.setToolNamesProvider(provider);
-    }
-    /** Install the backend provider deciding which MCP client mounts each server. */
-    setMcpBackendProvider(provider) {
-        this.mcp.setBackendProvider(provider);
-    }
-    /** Whether the current MCP snapshot uses one credential reference. */
-    usesCredential(ref) {
-        return this.mcp.usesCredential(ref);
-    }
-    /** Flag one MCP mount for an explicit rebuild on the next reconcile. */
-    forceMcpRemount(suiteId, serverKey) {
-        this.mcp.forceRemount(suiteId, serverKey);
-    }
-    /** Flag every live MCP mount for a rebuild on the next reconcile. */
-    forceMcpRemountAll() {
-        this.mcp.forceRemountAll();
-    }
-    /** The mount key owning one derived serverName; undefined when not mounted here. */
-    mcpServerOwner(serverName) {
-        return this.mcp.serverOwner(serverName);
-    }
-    /** Reconcile all runtime surfaces against one enabled-suite snapshot. */
-    async reconcile(enabledSuites) {
-        const suites = [...enabledSuites];
-        const diagnostics = { mcp: [], commands: [], hooks: [], lsp: [], errors: [] };
-        if (this.disposed)
-            return diagnostics;
-        const reconcileSurface = (surface, reconcile) => {
-            const run = (this.queues.get(surface) ?? Promise.resolve()).then(async () => {
-                if (this.disposed)
-                    return;
-                try {
-                    diagnostics[surface] = await reconcile();
-                }
-                catch (error) {
-                    diagnostics.errors.push({ surface, reason: messageOf(error) });
-                }
-            });
-            this.queues.set(surface, run);
-            return run;
-        };
-        // Network-backed MCP startup must not delay local commands, hooks or LSP.
-        // Each surface retains its own order when catalog mutations overlap.
-        await Promise.all([
-            reconcileSurface('mcp', () => this.mcp.reconcile(suites)),
-            reconcileSurface('commands', () => this.commands.reconcile(suites)),
-            reconcileSurface('hooks', () => this.hooks.reconcile(suites)),
-            reconcileSurface('lsp', () => this.lspRegistry.reconcile(suites))
-        ]);
-        return diagnostics;
-    }
-    /** Dispose all live mounts and registrations. */
-    async dispose() {
-        this.disposed = true;
-        const disposeSurface = async (surface, dispose) => {
-            await this.queues.get(surface);
-            await dispose();
-        };
-        await Promise.all([
-            disposeSurface('mcp', () => this.mcp.disposeAll()),
-            disposeSurface('commands', () => this.commands.disposeAll()),
-            disposeSurface('hooks', () => this.hooks.disposeAll()),
-            disposeSurface('lsp', () => this.lspRegistry.disposeAll())
-        ]);
-        this.queues.clear();
-    }
-}
-function messageOf(error) {
-    return error instanceof Error ? error.message : String(error);
-}

package/lib/runtime/panels/user-commands.js

@@ -1,105 +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 { createUserMessage } from '@deepseek-ai/dsh-llm';
-import { commandCallName } from '../../model/command-names.js';
-import { USER_ENTRY_PATH } from '../../application/panels/user-store.js';
-import { pluginMarketSource } from '../host/plugin-message-source.js';
-/** Register/unregister user-panel commands to match the panel's enabled entries. */
-export class UserCommandMountRegistry {
-    ctx;
-    store;
-    t;
-    fingerprints = new Map();
-    live = new Map();
-    constructor(ctx, store, t) {
-        this.ctx = ctx;
-        this.store = store;
-        this.t = t;
-    }
-    /** Sync the live registrations with the panel's enabled entries. */
-    async reconcile() {
-        const diagnostics = [];
-        const entries = await this.store.list();
-        const wanted = new Map();
-        // Registration is keyed by call name, so two entries that flatten to the
-        // same one cannot silently shadow each other.
-        const owners = new Map();
-        for (const entry of entries) {
-            if (entry.disabled)
-                continue;
-            if (!USER_ENTRY_PATH.test(entry.name))
-                continue;
-            const callName = commandCallName(entry.name);
-            const owner = owners.get(callName);
-            if (owner !== undefined) {
-                diagnostics.push(`command "${callName}": "${entry.name}" is shadowed by "${owner}" — both flatten to the same call name`);
-                continue;
-            }
-            owners.set(callName, entry.name);
-            wanted.set(callName, {
-                name: callName,
-                description: entry.description === '' ? `[${this.t('userCommandSourceLabel')}] ${callName}` : `[${this.t('userCommandSourceLabel')}] ${entry.description}`,
-                ...(typeof entry.metadata['argument-hint'] === 'string' && entry.metadata['argument-hint'] !== '' ? { hint: entry.metadata['argument-hint'] } : {}),
-                body: entry.content
-            });
-        }
-        for (const [key, disposer] of [...this.live]) {
-            if (!wanted.has(key)) {
-                disposer();
-                this.live.delete(key);
-            }
-        }
-        const host = this.ctx;
-        if (typeof host.commands?.register !== 'function') {
-            if (wanted.size > 0)
-                diagnostics.push('ctx.commands is not available in this profile; user commands stay unregistered');
-            return diagnostics;
-        }
-        for (const [key, spec] of wanted) {
-            const fingerprint = JSON.stringify(spec);
-            if (this.live.has(key) && this.fingerprints.get(key) === fingerprint)
-                continue;
-            this.live.get(key)?.();
-            this.live.delete(key);
-            this.fingerprints.delete(key);
-            try {
-                const disposer = host.commands.register({
-                    name: spec.name,
-                    description: spec.description,
-                    ...(spec.hint === undefined ? {} : { input: { hint: spec.hint } }),
-                    handler: invocation => {
-                        const agent = invocation.agent;
-                        const text = spec.body.replaceAll('$ARGUMENTS', invocation.rawInput.trim());
-                        agent.followup(createUserMessage({
-                            content: [{ type: 'text', text }],
-                            source: pluginMarketSource()
-                        }));
-                        return { kind: 'success', text: this.t('commandAcknowledged', { command: spec.name }) };
-                    }
-                });
-                this.live.set(key, disposer);
-                this.fingerprints.set(key, fingerprint);
-            }
-            catch (error) {
-                diagnostics.push(`command "${spec.name}": ${error instanceof Error ? error.message : String(error)}`);
-            }
-        }
-        return diagnostics;
-    }
-    /** Dispose every registration (plugin teardown). */
-    disposeAll() {
-        for (const disposer of [...this.live.values()])
-            disposer();
-        this.live.clear();
-        this.fingerprints.clear();
-    }
-}

package/lib/runtime/surfaces/commands-mounts.js

@@ -1,186 +0,0 @@
-import { createUserMessage } from '@deepseek-ai/dsh-llm';
-import { parse as parseYaml } from 'yaml';
-import { stripFrontmatter } from '../../catalog/skills-parse.js';
-import { parseFrontmatterRecord } from '../../application/panels/user-store.js';
-import { qualifiedSuiteId, suiteDataDir } from '../../catalog/paths.js';
-import { expandPluginPaths, pluginRootOf } from '../../catalog/plugin-variables.js';
-import { defaultMarkdownResources, resourceText, resourceCommandName } from '../../catalog/component-files.js';
-import { bindHostLocale } from '../host/host-locale.js';
-import { injectDynamicContext, shellSeamOf } from './dynamic-context.js';
-import { pluginMarketSource } from '../host/plugin-message-source.js';
-const COMMAND_NAME = /^[a-z][a-z0-9_-]*$/;
-export class CommandMountRegistry {
-    ctx;
-    t;
-    dataRoot;
-    fingerprints = new Map();
-    live = new Map();
-    constructor(ctx, t = bindHostLocale(undefined), dataRoot) {
-        this.ctx = ctx;
-        this.t = t;
-        this.dataRoot = dataRoot;
-    }
-    /** The live shell seam, when the profile has one; dynamic context stays literal without it. */
-    shell() {
-        return shellSeamOf(this.ctx);
-    }
-    /** Register/unregister suite commands to match the enabled suites exactly. */
-    async reconcile(enabledSuites) {
-        const diagnostics = [];
-        const wanted = new Map();
-        for (const suite of enabledSuites) {
-            const specs = suite.activeSurfaces.commands === false ? [] : await readCommands(suite.root, suite.resources?.commands);
-            const suiteRoot = pluginRootOf(suite);
-            const suiteData = suiteRoot === undefined || this.dataRoot === undefined ? undefined : suiteDataDir(this.dataRoot, suite.sourceId, suite.id);
-            for (const spec of specs) {
-                // The registry key is source-qualified: bare suite ids are unique per
-                // source only, so two sources' same-named suites would collide.
-                const suiteKey = qualifiedSuiteId(suite.sourceId, suite.id);
-                const key = `${suiteKey}/${spec.name}`;
-                if (wanted.has(key)) {
-                    diagnostics.push({ suiteId: suiteKey, command: spec.name, reason: 'duplicate normalized command name' });
-                    continue;
-                }
-                wanted.set(key, {
-                    ...spec,
-                    suiteId: suiteKey,
-                    suiteName: suite.manifest.name,
-                    ...(suiteRoot === undefined ? {} : { suiteRoot }),
-                    ...(suiteData === undefined ? {} : { suiteData })
-                });
-            }
-        }
-        for (const [key, disposer] of [...this.live]) {
-            if (!wanted.has(key)) {
-                disposer();
-                this.live.delete(key);
-            }
-        }
-        const host = this.ctx;
-        if (typeof host.commands?.register !== 'function') {
-            if (wanted.size > 0)
-                diagnostics.push({ suiteId: '', command: '', reason: 'ctx.commands is not available in this profile' });
-            return diagnostics;
-        }
-        for (const [key, spec] of wanted) {
-            const fingerprint = JSON.stringify(spec);
-            if (this.live.has(key) && this.fingerprints.get(key) === fingerprint)
-                continue;
-            this.live.get(key)?.();
-            this.live.delete(key);
-            this.fingerprints.delete(key);
-            try {
-                const disposer = host.commands.register({
-                    name: spec.name,
-                    description: `[${spec.suiteName}] ${spec.description}`,
-                    ...(spec.hint === undefined ? {} : { input: { hint: spec.hint } }),
-                    handler: async (invocation) => {
-                        const agent = invocation.agent;
-                        const workdir = agent.session?.header?.cwd;
-                        // The template rides the agent verbatim apart from the placeholders
-                        // its author wrote: a decorator line naming this plugin or the
-                        // suite would be text the command author never wrote, and the
-                        // follow-up's `source` already records provenance.
-                        const body = expandPluginPaths(spec.body, {
-                            ...(spec.suiteRoot === undefined ? {} : { root: spec.suiteRoot }),
-                            ...(spec.suiteData === undefined ? {} : { data: spec.suiteData }),
-                            ...(workdir === undefined ? {} : { projectDir: workdir })
-                        }).replaceAll('$ARGUMENTS', invocation.rawInput.trim());
-                        const shell = this.shell();
-                        if (shell === undefined) {
-                            agent.followup(createUserMessage({
-                                content: [{ type: 'text', text: body }],
-                                source: pluginMarketSource()
-                            }));
-                            return { kind: 'success', text: this.t('commandAcknowledged', { command: spec.name }) };
-                        }
-                        let text;
-                        try {
-                            text = await injectDynamicContext(body, { shell, ...(workdir === undefined ? {} : { workdir }) });
-                        }
-                        catch (error) {
-                            return { kind: 'error', text: error instanceof Error ? error.message : String(error) };
-                        }
-                        agent.followup(createUserMessage({
-                            content: [{ type: 'text', text }],
-                            source: pluginMarketSource()
-                        }));
-                        return { kind: 'success', text: this.t('commandAcknowledged', { command: spec.name }) };
-                    }
-                });
-                this.live.set(key, disposer);
-                this.fingerprints.set(key, fingerprint);
-            }
-            catch (error) {
-                diagnostics.push({ suiteId: spec.suiteId, command: spec.name, reason: error instanceof Error ? error.message : String(error) });
-            }
-        }
-        return diagnostics;
-    }
-    /** Dispose every registered command; used at plugin teardown. */
-    disposeAll() {
-        for (const disposer of [...this.live.values()])
-            disposer();
-        this.live.clear();
-        this.fingerprints.clear();
-    }
-}
-/** Parse `commands/*.md` of one suite root (Claude Code format). */
-export async function readCommands(root, resources) {
-    const entries = resources ?? (await defaultMarkdownResources(root, 'commands'));
-    const specs = [];
-    for (const entry of entries) {
-        const name = resourceCommandName(entry.name);
-        if (!COMMAND_NAME.test(name))
-            continue;
-        let text;
-        try {
-            text = await resourceText(entry);
-        }
-        catch {
-            continue;
-        }
-        try {
-            if (parseFrontmatterRecord(text).disabled === true)
-                continue;
-        }
-        catch {
-            continue;
-        }
-        const meta = commandMeta(text);
-        const description = meta?.description ?? firstLine(text);
-        if (description === undefined)
-            continue;
-        specs.push({ name, description, hint: meta?.hint, body: stripFrontmatter(text) });
-    }
-    return specs;
-}
-function commandMeta(text) {
-    const frontmatter = /^---\r?\n([\s\S]*?)\r?\n---(?:\r?\n|$)/.exec(text)?.[1];
-    if (frontmatter === undefined)
-        return undefined;
-    try {
-        const raw = parseYaml(frontmatter);
-        if (typeof raw !== 'object' || raw === null)
-            return undefined;
-        const record = raw;
-        const meta = {};
-        const description = record['description'];
-        if (typeof description === 'string' && description.trim() !== '')
-            meta.description = description.trim();
-        const hint = record['argument-hint'] ?? record['argumentHint'];
-        if (typeof hint === 'string' && hint.trim() !== '')
-            meta.hint = hint.trim();
-        return meta;
-    }
-    catch {
-        return undefined;
-    }
-}
-function firstLine(text) {
-    const line = text
-        .split('\n')
-        .map(line => line.trim())
-        .find(line => line !== '');
-    return line;
-}

package/lib/runtime/surfaces/skills-provider.js

@@ -1,160 +0,0 @@
-/**
- * Skill provider feeding installed suites into `ctx.skills`.
- *
- * One provider serves both dimensions. Ranks sit between the shipped
- * filesystem roots so each dimension's own skills still win:
- * project suites (250) lose to the project's `.dsh/skills` (100) and
- * `.agents/skills` (200) but beat custom (300); user suites (450) lose to
- * the user's own `~/.dsh/skills` (400) and beat `~/.agents/skills` (500).
- *
- * Bodies are rewritten on load: the path variables Claude Code authors write
- * into skill prose (`${CLAUDE_PLUGIN_ROOT}`, `${CLAUDE_PLUGIN_DATA}`,
- * `${CLAUDE_PROJECT_DIR}`, `${CLAUDE_SKILL_DIR}`) are substituted, `` !`cmd` ``
- * dynamic-context placeholders run, and the resource base points at the skill
- * directory, so CC-authored skills work verbatim under the harness.
- */
-import { readFile } from 'node:fs/promises';
-import { parseSkillFrontmatter, stripFrontmatter } from '../../catalog/skills-parse.js';
-import { parseFrontmatterRecord } from '../../application/panels/user-store.js';
-import { expandPluginPaths, pluginRootOf } from '../../catalog/plugin-variables.js';
-import { suiteDataDir } from '../../catalog/paths.js';
-import { injectDynamicContext } from './dynamic-context.js';
-export const SUITE_PROJECT_SOURCE = 'agent-plugin-project';
-export const SUITE_USER_SOURCE = 'agent-plugin-user';
-const PROJECT_RANK = 250;
-const USER_RANK = 450;
-export class SuiteSkillProvider {
-    manager;
-    options;
-    name = 'agent-plugin';
-    constructor(manager, options = {}) {
-        this.manager = manager;
-        this.options = options;
-    }
-    async list(options) {
-        const located = await this.locate(options.cwd);
-        located.sort((a, b) => a.rank - b.rank || a.suite.id.localeCompare(b.suite.id) || a.skill.name.localeCompare(b.skill.name));
-        // Dedupe by skill name across dimensions: the sort above puts project
-        // suites (250) ahead of user suites (450), so a project's own skill
-        // always wins over an installed suite shipping a skill of the same name.
-        const seen = new Set();
-        const unique = [];
-        for (const entry of located) {
-            if (seen.has(entry.skill.name))
-                continue;
-            seen.add(entry.skill.name);
-            unique.push(entry);
-        }
-        return unique.map(entry => this.candidateFor(entry));
-    }
-    async get(candidate, options) {
-        const locator = candidate.locator;
-        let text;
-        try {
-            text = locator.content ?? (await readFile(locator.file, 'utf8'));
-        }
-        catch {
-            return undefined;
-        }
-        try {
-            if (parseFrontmatterRecord(text).disabled === true)
-                return undefined;
-        }
-        catch {
-            return undefined;
-        }
-        const parsed = parseSkillFrontmatter(text, candidate.name);
-        if (typeof parsed === 'string')
-            return undefined;
-        const authored = [stripFrontmatter(text), ...(locator.skillInstructions === undefined ? [] : [locator.skillInstructions])].join('\n\n');
-        const withPaths = expandPluginPaths(authored, {
-            ...(locator.suiteRoot === undefined ? {} : { root: locator.suiteRoot }),
-            ...(locator.data === undefined ? {} : { data: locator.data }),
-            skillDir: locator.directory,
-            ...(options.cwd === undefined ? {} : { projectDir: options.cwd })
-        });
-        const shell = this.options.shell?.();
-        const content = shell === undefined
-            ? withPaths
-            : await injectDynamicContext(withPaths, {
-                shell,
-                ...(options.cwd === undefined ? {} : { workdir: options.cwd }),
-                ...(options.signal === undefined ? {} : { signal: options.signal })
-            });
-        return {
-            name: parsed.name,
-            description: candidate.description,
-            ...(parsed.whenToUse === undefined ? {} : { whenToUse: parsed.whenToUse }),
-            invocation: parsed.invocation,
-            source: candidate.source,
-            provider: this.name,
-            resourceBase: { kind: 'directory', path: locator.directory },
-            path: locator.file,
-            content
-        };
-    }
-    candidateFor(entry) {
-        return {
-            name: entry.skill.name,
-            // The author's description verbatim — the harness renders it into the
-            // model's skill catalog, where a suite-name prefix is our packaging.
-            description: entry.skill.description,
-            ...(entry.skill.whenToUse === undefined ? {} : { whenToUse: entry.skill.whenToUse }),
-            invocation: entry.skill.invocation,
-            source: entry.source,
-            provider: this.name,
-            rank: entry.rank,
-            locator: {
-                ...(entry.content === undefined ? {} : { content: entry.content }),
-                ...(entry.suite.manifest.skillInstructions === undefined ? {} : { skillInstructions: entry.suite.manifest.skillInstructions }),
-                file: entry.skill.file,
-                directory: entry.skill.directory,
-                ...(pluginRootOf(entry.suite) === undefined
-                    ? {}
-                    : {
-                        suiteRoot: entry.suite.root,
-                        ...(this.options.dataRoot === undefined ? {} : { data: suiteDataDir(this.options.dataRoot, entry.suite.sourceId, entry.suite.id) })
-                    })
-            },
-            path: entry.skill.file,
-            resourceBase: { kind: 'directory', path: entry.skill.directory }
-        };
-    }
-    async locate(cwd) {
-        const located = [];
-        const userSuites = await this.manager.enabledUserSuites();
-        for (const suite of userSuites) {
-            for (const skill of suite.activeSurfaces.skills === false ? [] : suite.skills) {
-                try {
-                    if (parseFrontmatterRecord(await readFile(skill.file, 'utf8')).disabled === true)
-                        continue;
-                }
-                catch {
-                    continue;
-                }
-                located.push({ rank: USER_RANK, source: SUITE_USER_SOURCE, suite, skill });
-            }
-        }
-        if (cwd !== undefined) {
-            located.push(...(await this.locateProject(cwd)));
-        }
-        return located;
-    }
-    async locateProject(cwd) {
-        const snapshot = await this.manager.readProjectCatalog(cwd);
-        const located = [];
-        for (const suite of snapshot.enabledSuites) {
-            for (const skill of suite.activeSurfaces.skills === false ? [] : suite.skills) {
-                try {
-                    if (parseFrontmatterRecord(await readFile(skill.file, 'utf8')).disabled === true)
-                        continue;
-                }
-                catch {
-                    continue;
-                }
-                located.push({ rank: PROJECT_RANK, source: SUITE_PROJECT_SOURCE, suite, skill });
-            }
-        }
-        return located;
-    }
-}

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

@@ -1,7 +0,0 @@
-import type { SkillContent, SuiteDetail } from '../contracts/market.js';
-import { type InstalledEntry, type Suite } from '../model/types.js';
-import type { McpMountDiagnostic as McpDiagnostic } from '../contracts/mcp.js';
-/** Build the detail response for one normalized suite. */
-export declare function buildSuiteDetail(suite: Suite, installed: InstalledEntry | undefined, diagnostics: readonly McpDiagnostic[], mcpOverrides?: Record<string, Record<string, unknown>>): Promise<SuiteDetail>;
-/** Read one skill body from a normalized suite. */
-export declare function readSkillContent(suite: Suite, skillName: string): Promise<SkillContent>;

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

@@ -1,24 +0,0 @@
-import type { McpSuiteOverrides } from './mcp-overrides.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?: McpStatusCode;
-    causes?: string[];
-    credentialRefs?: string[];
-}
-/**
- * Whether one effective configuration supplies its own Authorization header.
- *
- * Such a server authenticates with that header: the browser authorization a
- * re-authorize would restart is not the path it uses, so the action is not
- * offered for it.
- */
-export declare function declaresAuthHeader(config: Record<string, unknown> | undefined): boolean;
-/** Build status rows from discovered plugin MCP definitions and observed tool names. */
-export declare function buildMcpStatus(suites: Suite[], diagnostics: McpDiagnostic[], observed: readonly McpToolSnapshot[], overrides?: Map<string, McpSuiteOverrides>): McpStatusPayload;

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

@@ -1,28 +0,0 @@
-import type { UserPanelEntryWire, UserPanelKind } from '../contracts/market.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 {
-    /** Strict runtime reads propagate I/O failures so catalogs cannot publish partial replacements. */
-    list(strict?: boolean): Promise<UserPanelEntryWire[]>;
-    get(id: string): Promise<UserPanelEntryWire | undefined>;
-    create(name: string, text: string): Promise<UserPanelEntryWire>;
-    update(id: string, text: string): Promise<void>;
-    remove(id: string): Promise<void>;
-}
-/**
- * Id of one panel entry backed by a file inside an installed suite's checkout.
- * The leading `[` is what distinguishes a plugin entry from a user-authored
- * one; `update`/`remove` use {@link isPluginResourceId} to tell them apart.
- */
-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, UserPanelEntries>): Record<UserPanelKind, PanelResourceStore>;
-export {};