@deepseek-ai/dsh-plugin-recommendations 0.0.0-stage → 0.2.2-alpha.2

package/lib/typert.remote-client.d.ts

@@ -0,0 +1,30 @@
+/* Generated by @deepseek-ai/dsh-typert-generator from the Host FaceModel — do not edit. */
+import type {
+  RemoteResult,
+  TypertRemoteInfo,
+  TypertRemoteMethod,
+} from '@deepseek-ai/dsh-typert-protocol'
+import type { ToolCallId } from '@deepseek-ai/dsh-llm/brand'
+import type { RecommendationDetails } from '@deepseek-ai/dsh-plugin-recommendations/types'
+import type { SessionId } from '@deepseek-ai/dsh-session/types'
+
+declare module '@deepseek-ai/dsh-typert-protocol' {
+  interface TypertRemoteNamespace$706c7567696e5265636f6d6d656e646174696f6e73 {
+    describe: (agentId: SessionId, callId: ToolCallId) => Promise<RemoteResult<RecommendationDetails>>
+  }
+  interface TypertRemoteMap {
+    'pluginRecommendations/describe': (agentId: SessionId, callId: ToolCallId) => Promise<RemoteResult<RecommendationDetails>>
+  }
+  interface TypertRemoteNamespaceMap {
+    'pluginRecommendations': TypertRemoteNamespace$706c7567696e5265636f6d6d656e646174696f6e73
+  }
+  interface TypertRemoteScopeMap {
+    'agent:pluginRecommendations/describe': (callId: ToolCallId) => Promise<RemoteResult<RecommendationDetails>>
+  }
+}
+
+export declare const TYPERT_REMOTE: TypertRemoteInfo<{
+  readonly 'pluginRecommendations/describe': TypertRemoteMethod<{ readonly 'agentId': SessionId; readonly 'callId': ToolCallId }, RecommendationDetails>
+}>
+export default TYPERT_REMOTE
+//# sourceMappingURL=typert.remote-client.d.ts.map

package/lib/typert.remote-client.js

@@ -0,0 +1,90 @@
+/* Generated by @deepseek-ai/dsh-typert-generator from the Host FaceModel — do not edit. */
+import { z } from 'zod'
+
+import { createTypertRemoteInfo } from '@deepseek-ai/dsh-typert-protocol/remote-info'
+
+let _deepseek_ai_dsh_plugin_recommendations_pluginRecommendations_describe_parameter_0$schema$value
+const _deepseek_ai_dsh_plugin_recommendations_pluginRecommendations_describe_parameter_0$schema = () => (_deepseek_ai_dsh_plugin_recommendations_pluginRecommendations_describe_parameter_0$schema$value ??= z.string())
+let _deepseek_ai_dsh_plugin_recommendations_pluginRecommendations_describe_parameter_1$schema$value
+const _deepseek_ai_dsh_plugin_recommendations_pluginRecommendations_describe_parameter_1$schema = () => (_deepseek_ai_dsh_plugin_recommendations_pluginRecommendations_describe_parameter_1$schema$value ??= z.string())
+let _deepseek_ai_dsh_plugin_recommendations_pluginRecommendations_describe_result$schema$value
+const _deepseek_ai_dsh_plugin_recommendations_pluginRecommendations_describe_result$schema = () => (_deepseek_ai_dsh_plugin_recommendations_pluginRecommendations_describe_result$schema$value ??= z.union([z.object({
+  'status': z.literal("available").readonly(),
+  'title': z.union([z.string(), z.intersection(z.object({
+  'en': z.string().readonly(),
+}), z.record(z.string(), z.string()).readonly())]).readonly(),
+  'description': z.union([z.string(), z.intersection(z.object({
+  'en': z.string().readonly(),
+}), z.record(z.string(), z.string()).readonly())]).readonly(),
+  'enabled': z.boolean().readonly(),
+}), z.object({
+  'status': z.literal("refused").readonly(),
+  'reason': z.union([z.literal("unknown"), z.literal("unavailable"), z.literal("not-live-root"), z.literal("closing")]).readonly(),
+})]))
+let _deepseek_ai_dsh_plugin_recommendations_pluginRecommendations_describe_parameter_0_strict$schema$value
+const _deepseek_ai_dsh_plugin_recommendations_pluginRecommendations_describe_parameter_0_strict$schema = () => (_deepseek_ai_dsh_plugin_recommendations_pluginRecommendations_describe_parameter_0_strict$schema$value ??= z.string())
+let _deepseek_ai_dsh_plugin_recommendations_pluginRecommendations_describe_parameter_1_strict$schema$value
+const _deepseek_ai_dsh_plugin_recommendations_pluginRecommendations_describe_parameter_1_strict$schema = () => (_deepseek_ai_dsh_plugin_recommendations_pluginRecommendations_describe_parameter_1_strict$schema$value ??= z.string())
+
+export const TYPERT_REMOTE = createTypertRemoteInfo({
+  package: '@deepseek-ai/dsh-plugin-recommendations',
+  methods: {
+    'pluginRecommendations/describe': {
+      service: 'pluginRecommendations',
+      description: 'Read the current catalog text for a logged card.',
+      invocation: { kind: 'direct' },
+      scope: {
+        context: 'agent',
+        wire: 'agentId',
+      },
+      parameters: [
+        {
+          name: 'agent',
+          wire: 'agentId',
+          description: 'Exact live root resolved by the Gateway from the Session id.',
+          source: 'lookup',
+          lookup: 'agent',
+          codec: {
+            mode: 'strict',
+            typeSymbol: '@deepseek-ai/dsh-session/types#SessionId',
+            create: _deepseek_ai_dsh_plugin_recommendations_pluginRecommendations_describe_parameter_0$schema,
+            jsonSchema: {"type":"string"},
+          },
+          strictCodec: {
+            mode: 'strict',
+            typeSymbol: '@deepseek-ai/dsh-session/types#SessionId',
+            create: _deepseek_ai_dsh_plugin_recommendations_pluginRecommendations_describe_parameter_0_strict$schema,
+            jsonSchema: {"type":"string"},
+          },
+        },
+        {
+          name: 'callId',
+          description: 'The card\'s `propose_action` call id, never a package supplied by the browser.',
+          source: 'json',
+          codec: {
+            mode: 'strict',
+            typeSymbol: '@deepseek-ai/dsh-llm/brand#ToolCallId',
+            create: _deepseek_ai_dsh_plugin_recommendations_pluginRecommendations_describe_parameter_1$schema,
+            jsonSchema: {"type":"string"},
+          },
+          strictCodec: {
+            mode: 'strict',
+            typeSymbol: '@deepseek-ai/dsh-llm/brand#ToolCallId',
+            create: _deepseek_ai_dsh_plugin_recommendations_pluginRecommendations_describe_parameter_1_strict$schema,
+            jsonSchema: {"type":"string"},
+          },
+        },
+      ],
+      result: {
+        mode: 'strict',
+        typeSymbol: '@deepseek-ai/dsh-plugin-recommendations/types#RecommendationDetails',
+        create: _deepseek_ai_dsh_plugin_recommendations_pluginRecommendations_describe_result$schema,
+        description: 'the plugin\'s title, description and selection, or a refusal when the card names no available official plugin.',
+        jsonSchemaError: 'typert tool schema: selected dictionaries require string keys and unconstrained JSON values',
+      },
+      sourceLocation: {"file":"packages/experimental/plugin-recommendations/src/index.ts","line":88,"column":9},
+    },
+  },
+}, z)
+
+export default TYPERT_REMOTE

package/lib/types/index.d.ts

@@ -0,0 +1,46 @@
+import { Service, type Context } from '@deepseek-ai/cordis';
+import { TypertRemoteService } from '@deepseek-ai/dsh-typert-protocol';
+import type { ToolCallId } from '@deepseek-ai/dsh-llm';
+import type { Agent } from '@deepseek-ai/dsh-agent';
+import type { RecommendationDetails } from './types.ts';
+export type * from './types.ts';
+export declare const name = "plugin-recommendations";
+/** Services the plugin uses; `actionCards` owns the card tool, card state and user actions. */
+export declare const inject: string[];
+declare module '@deepseek-ai/cordis' {
+    interface Context {
+        pluginRecommendations: PluginRecommendations;
+    }
+}
+/** Catalog lookups for card text and the enabling behind the `enable_official_plugin` card. */
+export declare class PluginRecommendations extends TypertRemoteService {
+    static inject: string[];
+    /** Card reconciliations and enabling in flight; unloading waits for them. */
+    private readonly operations;
+    private readonly stopped;
+    private closing;
+    private readonly owner;
+    constructor(ctx: Context);
+    protected [Service.init](): void;
+    /**
+     * Read the current catalog text for a logged card.
+     * @param agent - Exact live root resolved by the Gateway from the Session id.
+     * @param callId - The card's `propose_action` call id, never a package supplied by the browser.
+     * @returns the plugin's title, description and selection, or a refusal when the card names no available official plugin.
+     */
+    describe(agent: Agent, callId: ToolCallId): Promise<RecommendationDetails>;
+    private isStopping;
+    /** Track an operation until it settles, so unloading waits for it. */
+    private tracked;
+    /** Record `enabled` on an unconfirmed card whose interrupted enable has since turned its plugin on. */
+    private confirm;
+    /** Enable the card's plugin once; an enabled card settles unchanged, and a failed or unconfirmed one can be retried. */
+    private enable;
+}
+/**
+ * Register the official-plugins skill, the `enable_official_plugin` card kind and the catalog-text Remote;
+ * disposing the plugin stops local follow-up of pending enabling and removes all three.
+ * @param ctx - Owning plugin context.
+ */
+export declare function apply(ctx: Context): Promise<void>;
+//# sourceMappingURL=index.d.ts.map

package/lib/types/index.js

@@ -0,0 +1,194 @@
+var __runInitializers = (this && this.__runInitializers) || function (thisArg, initializers, value) {
+    var useValue = arguments.length > 2;
+    for (var i = 0; i < initializers.length; i++) {
+        value = useValue ? initializers[i].call(thisArg, value) : initializers[i].call(thisArg);
+    }
+    return useValue ? value : void 0;
+};
+var __esDecorate = (this && this.__esDecorate) || function (ctor, descriptorIn, decorators, contextIn, initializers, extraInitializers) {
+    function accept(f) { if (f !== void 0 && typeof f !== "function") throw new TypeError("Function expected"); return f; }
+    var kind = contextIn.kind, key = kind === "getter" ? "get" : kind === "setter" ? "set" : "value";
+    var target = !descriptorIn && ctor ? contextIn["static"] ? ctor : ctor.prototype : null;
+    var descriptor = descriptorIn || (target ? Object.getOwnPropertyDescriptor(target, contextIn.name) : {});
+    var _, done = false;
+    for (var i = decorators.length - 1; i >= 0; i--) {
+        var context = {};
+        for (var p in contextIn) context[p] = p === "access" ? {} : contextIn[p];
+        for (var p in contextIn.access) context.access[p] = contextIn.access[p];
+        context.addInitializer = function (f) { if (done) throw new TypeError("Cannot add initializers after decoration has completed"); extraInitializers.push(accept(f || null)); };
+        var result = (0, decorators[i])(kind === "accessor" ? { get: descriptor.get, set: descriptor.set } : descriptor[key], context);
+        if (kind === "accessor") {
+            if (result === void 0) continue;
+            if (result === null || typeof result !== "object") throw new TypeError("Object expected");
+            if (_ = accept(result.get)) descriptor.get = _;
+            if (_ = accept(result.set)) descriptor.set = _;
+            if (_ = accept(result.init)) initializers.unshift(_);
+        }
+        else if (_ = accept(result)) {
+            if (kind === "field") initializers.unshift(_);
+            else descriptor[key] = _;
+        }
+    }
+    if (target) Object.defineProperty(target, contextIn.name, descriptor);
+    done = true;
+};
+/** Explicit-need official plugin recommendations: an `enable_official_plugin` card offers one plugin, and only a human click enables it. */
+import { z } from 'zod';
+import { Service } from '@deepseek-ai/cordis';
+import { Remote, TypertRemoteService } from '@deepseek-ai/dsh-typert-protocol';
+import { isPluginStopping } from '@deepseek-ai/dsh-action-cards';
+import { eligible, registerOfficialPluginsSkill } from "./skill.js";
+export const name = 'plugin-recommendations';
+/** Services the plugin uses; `actionCards` owns the card tool, card state and user actions. */
+export const inject = ['pluginManager', 'agents', 'skills', 'actionCards'];
+/** Card action this plugin registers. */
+const ACTION = 'enable_official_plugin';
+const detailsSchema = z.object({ name: z.string().trim().min(1) });
+/** Own entries only: browser-supplied ids such as `toString` never reach inherited object members. */
+function ownEntry(record, key) {
+    return Object.hasOwn(record, key) ? record[key] : undefined;
+}
+function settled(decision) {
+    return { status: 'settled', decision };
+}
+function refused(reason) {
+    return { status: 'refused', reason };
+}
+/** Catalog lookups for card text and the enabling behind the `enable_official_plugin` card. */
+let PluginRecommendations = (() => {
+    let _classSuper = TypertRemoteService;
+    let _instanceExtraInitializers = [];
+    let _describe_decorators;
+    return class PluginRecommendations extends _classSuper {
+        static {
+            const _metadata = typeof Symbol === "function" && Symbol.metadata ? Object.create(_classSuper[Symbol.metadata] ?? null) : void 0;
+            _describe_decorators = [Remote];
+            __esDecorate(this, null, _describe_decorators, { kind: "method", name: "describe", static: false, private: false, access: { has: obj => "describe" in obj, get: obj => obj.describe }, metadata: _metadata }, null, _instanceExtraInitializers);
+            if (_metadata) Object.defineProperty(this, Symbol.metadata, { enumerable: true, configurable: true, writable: true, value: _metadata });
+        }
+        static inject = inject;
+        /** Card reconciliations and enabling in flight; unloading waits for them. */
+        operations = (__runInitializers(this, _instanceExtraInitializers), new Set());
+        stopped = Promise.withResolvers();
+        closing = false;
+        owner;
+        constructor(ctx) {
+            super(ctx, 'pluginRecommendations');
+            this.owner = ctx.fiber;
+        }
+        [Service.init]() {
+            registerOfficialPluginsSkill(this.ctx);
+            this.ctx.actionCards.register({
+                action: ACTION, skill: 'official-plugins', details: detailsSchema,
+                invitation: 'End with at most one short invitation in the user’s language to click Enable below; '
+                    + 'do not say the plugin is already on.',
+                verbs: { enable: { global: true } },
+                openPhases: ['failed', 'unconfirmed'],
+                statusGuidance: 'Plugin cards: enabled means the plugin is on now, or after a DSH restart when application is restart-required; '
+                    + 'already-enabled means it was on before; failed, or unconfirmed when a reload cut enabling off, can be retried from the card; '
+                    + 'dismissed means the user declined it, so do not offer it again in this conversation; enabling authorizes nothing beyond that plugin.',
+                // Every action, including Not now, first learns whether an interrupted enable has since landed.
+                reconcile: (agent, proposal) => this.tracked(this.confirm(agent, proposal)),
+                act: (agent, proposal) => this.tracked(this.enable(agent, proposal)),
+            });
+            this.ctx.effect(() => async () => {
+                this.closing = true;
+                this.stopped.resolve(undefined);
+                await Promise.allSettled([...this.operations]);
+            }, 'plugin-recommendations: drain enabling');
+        }
+        /**
+         * Read the current catalog text for a logged card.
+         * @param agent - Exact live root resolved by the Gateway from the Session id.
+         * @param callId - The card's `propose_action` call id, never a package supplied by the browser.
+         * @returns the plugin's title, description and selection, or a refusal when the card names no available official plugin.
+         */
+        async describe(agent, callId) {
+            if (this.isStopping())
+                return { status: 'refused', reason: 'closing' };
+            if (!this.ctx.agents.roots().includes(agent))
+                return { status: 'refused', reason: 'not-live-root' };
+            const proposal = ownEntry(this.ctx.actionCards.view(agent.session).proposals, callId);
+            const details = proposal?.action === ACTION ? detailsSchema.safeParse(proposal.details) : undefined;
+            if (details?.success !== true)
+                return { status: 'refused', reason: 'unknown' };
+            const bundle = (await this.ctx.pluginManager.listBundles()).find(item => item.name === details.data.name);
+            if (bundle === undefined || !eligible(bundle))
+                return { status: 'refused', reason: 'unavailable' };
+            return { status: 'available', title: bundle.meta?.title ?? bundle.name,
+                description: bundle.meta?.description ?? bundle.description ?? '', enabled: bundle.enabled };
+        }
+        isStopping() {
+            return isPluginStopping(this.owner, this.closing);
+        }
+        /** Track an operation until it settles, so unloading waits for it. */
+        tracked(operation) {
+            this.operations.add(operation);
+            return operation.finally(() => { this.operations.delete(operation); });
+        }
+        /** Record `enabled` on an unconfirmed card whose interrupted enable has since turned its plugin on. */
+        async confirm(agent, proposal) {
+            // Held from the start, like enabling: an unload while the catalog is read still records the outcome.
+            const cards = this.ctx.actionCards;
+            if (ownEntry(cards.view(agent.session).decisions, proposal.callId)?.phase !== 'unconfirmed')
+                return;
+            const bundle = (await this.ctx.pluginManager.listBundles()).find(item => item.name === proposal.details.name);
+            if (bundle?.enabled === true)
+                cards.record(agent, { callId: proposal.callId, action: ACTION, phase: 'enabled' });
+        }
+        /** Enable the card's plugin once; an enabled card settles unchanged, and a failed or unconfirmed one can be retried. */
+        async enable(agent, proposal) {
+            // Held from the start: an unload during the profile change still records where this card stands.
+            const cards = this.ctx.actionCards;
+            const record = (phase, data = {}) => {
+                const fields = Object.fromEntries(Object.entries(data).filter(([, value]) => value !== undefined));
+                const decision = {
+                    callId: proposal.callId, action: ACTION, phase, ...Object.keys(fields).length === 0 ? {} : { data: fields },
+                };
+                cards.record(agent, decision);
+                return settled(decision);
+            };
+            const previous = ownEntry(cards.view(agent.session).decisions, proposal.callId);
+            if (previous !== undefined && previous.phase !== 'failed' && previous.phase !== 'unconfirmed')
+                return settled(previous);
+            const bundle = (await this.ctx.pluginManager.listBundles()).find(item => item.name === proposal.details.name);
+            if (bundle === undefined || !eligible(bundle))
+                return refused('unavailable');
+            if (this.isStopping())
+                return refused('closing');
+            if (!this.ctx.agents.roots().includes(agent))
+                return refused('not-live-root');
+            // An unconfirmed card's plugin that reconciliation still found off and is on now was turned on by its own enable.
+            if (bundle.enabled)
+                return record(previous?.phase === 'unconfirmed' ? 'enabled' : 'already-enabled');
+            let result;
+            try {
+                // PluginManager owns the accepted profile mutation. HMR may unload this
+                // consumer before it finishes, so only our wait for its result is cancelled.
+                result = await Promise.race([this.ctx.pluginManager.setBundleEnabled(bundle.name, true), this.stopped.promise]);
+            }
+            catch (error) {
+                // A rejected change reports no management code; the card offers a retry instead of failing the click.
+                this.ctx.logger.warn('Enabling %s was rejected: %s', bundle.name, String(error));
+                return record('failed', { errorCode: 'operation-error' });
+            }
+            if (result === undefined) {
+                record('unconfirmed');
+                return { status: 'unconfirmed', reason: 'closing' };
+            }
+            return record(result.application === 'failed' ? 'failed' : 'enabled', {
+                application: result.application === 'restart-required' ? 'restart-required' : undefined, errorCode: result.error?.code,
+            });
+        }
+    };
+})();
+export { PluginRecommendations };
+/**
+ * Register the official-plugins skill, the `enable_official_plugin` card kind and the catalog-text Remote;
+ * disposing the plugin stops local follow-up of pending enabling and removes all three.
+ * @param ctx - Owning plugin context.
+ */
+export async function apply(ctx) {
+    await ctx.plugin(PluginRecommendations);
+}
+//# sourceMappingURL=index.js.map

package/lib/types/skill.d.ts

@@ -0,0 +1,12 @@
+import type { Context } from '@deepseek-ai/cordis';
+import type { BundleInfo } from '@deepseek-ai/dsh-plugin-manager/types';
+/** Shipped optional plugins only; no arbitrary install target is accepted.
+ * @param bundle - a profile bundle as the plugin manager reports it.
+ * @returns whether a card may offer and enable it.
+ */
+export declare function eligible(bundle: BundleInfo): boolean;
+/** Register the experiment's skill without adding a model tool or a system-prompt section.
+ * @param ctx - Owning plugin context with skill and plugin registries.
+ */
+export declare function registerOfficialPluginsSkill(ctx: Context): void;
+//# sourceMappingURL=skill.d.ts.map

package/lib/types/skill.js

@@ -0,0 +1,41 @@
+/** On-demand official-plugin catalog for explicit product-use needs. */
+import { readFile } from 'node:fs/promises';
+import { BUNDLED_SKILL_RANK } from '@deepseek-ai/dsh-skill';
+/** Shipped optional plugins only; no arbitrary install target is accepted.
+ * @param bundle - a profile bundle as the plugin manager reports it.
+ * @returns whether a card may offer and enable it.
+ */
+export function eligible(bundle) {
+    return bundle.official && bundle.optional && bundle.availability !== 'missing'
+        && bundle.readOnlyReason === undefined && bundle.error === undefined;
+}
+/** The eligible plugins as the skill lists them: name, title, description and selection. */
+function catalogOf(bundles) {
+    return JSON.stringify(bundles.filter(eligible).map(bundle => ({
+        name: bundle.name, title: bundle.meta?.title ?? bundle.name,
+        description: bundle.meta?.description ?? bundle.description ?? '', enabled: bundle.enabled,
+    })));
+}
+/** Register the experiment's skill without adding a model tool or a system-prompt section.
+ * @param ctx - Owning plugin context with skill and plugin registries.
+ */
+export function registerOfficialPluginsSkill(ctx) {
+    const candidate = {
+        name: 'official-plugins',
+        description: 'Check DSH’s optional plugins when the user asks how to do or use something in this app, whether it can, or says a capability is missing or should change: tools, input, thinking or title display, session search, terminals, worktrees, agent teams, desktop control, automation, access, approvals, badges or signatures, plugins or plugin sources. Not a request to develop DSH, even in its own repository: load before reading files or source. Not for ordinary tasks, quoted wishes or declined offers.',
+        invocation: { modelInvocable: true, userInvocable: false },
+        provider: 'dsh-official-plugins', source: 'bundled', rank: BUNDLED_SKILL_RANK, locator: null,
+    };
+    ctx.skills.registerProvider(() => ({
+        name: candidate.provider,
+        list: () => Promise.resolve([candidate]),
+        async get(_candidate, { signal }) {
+            const policy = await readFile(new URL('../skills/official-plugins.md', import.meta.url), { encoding: 'utf8', signal });
+            const catalog = catalogOf(await ctx.pluginManager.listBundles());
+            signal?.throwIfAborted();
+            const { rank: _rank, locator: _locator, ...entry } = candidate;
+            return { ...entry, content: `${policy}\n## Official plugins\n\n${catalog}` };
+        },
+    }));
+}
+//# sourceMappingURL=skill.js.map

package/lib/types/types.d.ts

@@ -0,0 +1,32 @@
+/** Fields, recorded data and catalog text of `enable_official_plugin` cards. */
+import type { ManagementError } from '@deepseek-ai/dsh-plugin-manager/types';
+import type { LocalizedText } from '@deepseek-ai/dsh-package-manifest';
+/** Card fields the skill asks the model to write in `details`. */
+export interface PluginDetails {
+    /** Package name as written in the catalog; enabling checks it against the current catalog. */
+    readonly name: string;
+}
+/**
+ * Phases a plugin card records besides the shared `dismissed`. `unconfirmed` marks an enable whose outcome an unload
+ * cut off; the next action that finds the plugin enabled, Not now included, records `enabled`, since this card's own
+ * change landed.
+ */
+export type PluginPhase = 'enabled' | 'already-enabled' | 'failed' | 'unconfirmed';
+/** Data each plugin decision records; profile files own the actual configuration. */
+export interface PluginData {
+    /** `restart-required` when the saved selection applies only after DSH restarts. */
+    readonly application?: 'restart-required' | undefined;
+    /** Plugin manager error code of a failed change, or `operation-error` when the change was rejected; no diagnostic text is recorded. */
+    readonly errorCode?: ManagementError['code'] | undefined;
+}
+/** Catalog text for a card, read when it is displayed; a name outside the eligible catalog gets no card text. */
+export type RecommendationDetails = {
+    readonly status: 'available';
+    readonly title: LocalizedText;
+    readonly description: LocalizedText;
+    readonly enabled: boolean;
+} | {
+    readonly status: 'refused';
+    readonly reason: 'unknown' | 'unavailable' | 'not-live-root' | 'closing';
+};
+//# sourceMappingURL=types.d.ts.map

package/lib/types/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/locale/de.json

@@ -0,0 +1,6 @@
+{
+  "meta": {
+    "title": "Plugin-Empfehlungen",
+    "description": "Wenn Sie fragen, wie etwas in dieser App geht, oder sagen, dass eine Funktion fehlt, empfiehlt es unter der Antwort das integrierte Plugin, das sie bereitstellt; Aktivieren schaltet es für alle Gespräche ein, und Sie können es auf der Seite „Plugins“ wieder ausschalten."
+  }
+}

package/locale/en.json

@@ -0,0 +1,6 @@
+{
+  "meta": {
+    "title": "Plugin recommendations",
+    "description": "When you ask how to do something in this app or say a capability is missing, recommends the built-in plugin that provides it below the answer; Enable turns it on for every conversation, and you can turn it off on the Plugins page."
+  }
+}

package/locale/es.json

@@ -0,0 +1,6 @@
+{
+  "meta": {
+    "title": "Recomendaciones de complementos",
+    "description": "Cuando preguntas cómo hacer algo en esta aplicación o dices que falta una función, recomienda debajo de la respuesta el complemento integrado que la ofrece; Habilitar lo activa en todas las conversaciones y puedes desactivarlo en la página Complementos."
+  }
+}

package/locale/fr.json

@@ -0,0 +1,6 @@
+{
+  "meta": {
+    "title": "Recommandations de plugins",
+    "description": "Lorsque vous demandez comment faire quelque chose dans cette application ou signalez qu’une fonctionnalité manque, recommande sous la réponse le plugin intégré qui la fournit ; Activer l’active pour toutes les conversations, et vous pouvez le désactiver dans la page Plugins."
+  }
+}

package/locale/ja.json

@@ -0,0 +1,6 @@
+{
+  "meta": {
+    "title": "プラグイン推薦",
+    "description": "このアプリで何かをする方法を尋ねたときや機能が足りないと言ったときに、それを提供する内蔵プラグインを回答の下で推薦します。「有効にする」をクリックするとすべての会話で有効になり、プラグイン画面でオフにできます。"
+  }
+}

package/locale/pt.json

@@ -0,0 +1,6 @@
+{
+  "meta": {
+    "title": "Recomendações de plug-ins",
+    "description": "Quando você pergunta como fazer algo neste aplicativo ou diz que falta um recurso, recomenda abaixo da resposta o plug-in integrado que o oferece; Ativar o liga em todas as conversas, e você pode desligá-lo na página Plug-ins."
+  }
+}

package/locale/ru.json

@@ -0,0 +1,6 @@
+{
+  "meta": {
+    "title": "Рекомендации плагинов",
+    "description": "Когда вы спрашиваете, как что-то сделать в этом приложении, или говорите, что не хватает какой-то возможности, рекомендует под ответом встроенный плагин, который ее предоставляет; «Включить» включает его для всех разговоров, а выключить его можно на странице «Плагины»."
+  }
+}

package/locale/zh.json

@@ -0,0 +1,6 @@
+{
+  "meta": {
+    "title": "插件推荐",
+    "description": "问到本应用怎么做某件事或缺少某项能力时，在回答下方推荐对应的内置插件；点击启用后对所有会话生效，可在插件页关闭。"
+  }
+}

package/package.json

@@ -1,6 +1,75 @@
 {
   "name": "@deepseek-ai/dsh-plugin-recommendations",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
+  "description": "Official plugin suggestions with explicit user activation and persistent conversation decisions",
+  "version": "0.2.2-alpha.2",
+  "publishConfig": {
+    "access": "public"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/deepseek-ai/deepseek-harness.git",
+    "directory": "packages/experimental/plugin-recommendations"
+  },
+  "type": "module",
+  "main": "lib/index.js",
+  "types": "lib/types/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./lib/types/index.d.ts",
+      "default": "./lib/index.js"
+    },
+    "./src/*": "./src/*",
+    "./package.json": "./package.json",
+    "./locale/*.json": "./locale/*.json",
+    "./types": {
+      "types": "./lib/types/types.d.ts",
+      "default": "./lib/types/types.js"
+    },
+    "./typert": {
+      "types": "./lib/typert.host.d.ts",
+      "default": "./lib/typert.host.js"
+    },
+    "./remote": {
+      "types": "./lib/typert.remote-client.d.ts",
+      "default": "./lib/typert.remote-client.js"
+    },
+    "./skills/*.md": "./skills/*.md"
+  },
+  "license": "MIT",
+  "peerDependencies": {
+    "@deepseek-ai/cordis": "~4.0.6-alpha.1",
+    "@deepseek-ai/dsh-typert-protocol": "0.2.2-alpha.2",
+    "@deepseek-ai/dsh-llm": "0.2.2-alpha.2",
+    "@deepseek-ai/dsh-skill": "0.2.2-alpha.2"
+  },
+  "devDependencies": {
+    "@deepseek-ai/cordis": "~4.0.6-alpha.1",
+    "@deepseek-ai/dsh-typert-protocol": "0.2.2-alpha.2",
+    "@deepseek-ai/dsh-llm": "0.2.2-alpha.2",
+    "@deepseek-ai/dsh-agent": "0.2.2-alpha.2",
+    "@deepseek-ai/dsh-session": "0.2.2-alpha.2",
+    "@deepseek-ai/dsh-plugin-manager": "0.2.2-alpha.2",
+    "@deepseek-ai/dsh-package-manifest": "0.2.2-alpha.2",
+    "@deepseek-ai/dsh-api-remote-access": "0.2.2-alpha.2",
+    "@deepseek-ai/dsh-skill": "0.2.2-alpha.2"
+  },
+  "dependencies": {
+    "zod": "4.4.3",
+    "@deepseek-ai/dsh-client-ui-plugin-recommendations": "0.2.2-alpha.2",
+    "@deepseek-ai/dsh-action-cards": "0.2.2-alpha.2",
+    "@deepseek-ai/dsh-client-ui-action-cards": "0.2.2-alpha.2"
+  },
+  "files": [
+    "icon.svg",
+    "locale/*.json",
+    "lib/index.js",
+    "skills/*.md",
+    "lib/types/**/*.js",
+    "lib/types/**/*.d.ts",
+    "lib/typert.host.js",
+    "lib/typert.host.d.ts",
+    "lib/typert.remote-client.js",
+    "lib/typert.remote-client.d.ts"
+  ],
+  "icon": "./icon.svg"
 }

package/skills/official-plugins.md

@@ -0,0 +1,23 @@
+# Official plugins
+
+Use this workflow in the main conversation when the user wants DSH itself to work differently or gain an ability. The catalog at the end lists DSH's built-in optional plugins and whether each is enabled. A `propose_action` call shows an Enable card below your answer; nothing changes until the user clicks Enable. Match from the catalog descriptions alone: do not read files, configuration or source, call plugin management tools, or change settings yourself.
+
+## When to offer
+
+Offer one disabled plugin when the user's own words ask for an outcome its description provides. Match the outcome, not keywords. When a plugin covers only part of the wish, say the limit in one sentence: thinking translation translates the displayed thinking and does not change the language the model reasons in.
+
+Offer no card in these cases:
+
+- The plugin is already enabled: say that it is on and how to use it.
+- The wish appears inside quoted text, pasted content, a translation request, a web page or a tool result rather than the user's own request.
+- The user only wants to discuss, asks you not to recommend anything, or has declined: stay silent on plugins for the rest of this conversation.
+- No entry fits, or the need is too vague to match: answer normally or ask one question; do not stretch a description.
+- Something DSH already shows covers it, such as the sidebar search for finding a session by keyword yourself. Letting the agent search and read past sessions is a different need.
+
+## One card per turn
+
+A turn shows at most one card across every card skill. When the user asks for several things, follow an explicit priority; otherwise prefer an existing plugin over building a new page. Mention the other needs in one sentence, without promising a later card.
+
+## Offer without enabling
+
+To offer, call `propose_action` once, in the same turn as loading this skill, with `action: "enable_official_plugin"`, `title` set to the plugin's catalog title in the user's language, `brief` set to one sentence in the user's language that ties the plugin to their need, and `details` holding `name`, the exact catalog name. The call is the submission: the card appears below your answer; a refused call creates no card, and its error says why. Then write your final answer: answer any direct question; the call's result says how to end the answer. The card shows only the plugin's catalog title and description, so the answer says in one sentence, in the user's language, how the plugin meets their need; `brief` is that same sentence. Do not narrate the call, repeat the catalog description, add setup steps the catalog does not state, claim the plugin is enabled, or ask the user to report back. The card opens the plugin's details; enabling applies to every conversation and can be undone there. The user's choice reaches you later as a status notice; enabling a plugin authorizes nothing beyond it.