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

package/lib/index.js

@@ -0,0 +1,6 @@
+//#region lib/types/index.js
+/** Browser registration is discovered through the package client declaration. */
+/** Register the browser-only contribution without Host state. */
+function apply() {}
+//#endregion
+export { apply };

package/lib/types/client/Card.d.ts

@@ -0,0 +1,37 @@
+import type { SnapshotStore } from '@deepseek-ai/dsh-client-store';
+import type { LocalizedText } from '@deepseek-ai/dsh-package-manifest';
+import type { SessionId } from '@deepseek-ai/dsh-session/types';
+import type { ToolCallId } from '@deepseek-ai/dsh-llm/brand';
+import type { ActionCardBodyProps } from '@deepseek-ai/dsh-client-ui-action-cards/client';
+import type { RecommendationDetails } from '@deepseek-ai/dsh-plugin-recommendations/types';
+/** Catalog text the Host returned for an available plugin. */
+export type CatalogDetails = Extract<RecommendationDetails, {
+    readonly status: 'available';
+}>;
+/** Plugin-lifetime services the body uses besides the frame's props. */
+export interface PluginCardServices {
+    /** Catalog text by plugin name, kept for this plugin's lifetime so later cards of the same plugin render it at once. */
+    readonly catalog: SnapshotStore<Readonly<Record<string, CatalogDetails>>>;
+    /**
+     * Read the current catalog text of a card's plugin.
+     * @param sessionId - the displayed Session.
+     * @param callId - the card's call id.
+     * @returns the Host's answer, or undefined when the reply was lost.
+     */
+    readonly describe: (sessionId: SessionId, callId: ToolCallId) => Promise<RecommendationDetails | undefined>;
+    /** Open the plugin's details page without enabling it. */
+    readonly openDetails: (packageName: string) => void;
+    /** Pick the interface language's text. */
+    readonly resolveText: (text: LocalizedText) => string;
+}
+/** Body props: the frame's card props plus the plugin-lifetime services. */
+export type PluginCardProps = ActionCardBodyProps<'pluginRecommendations'> & PluginCardServices;
+/**
+ * Display one plugin card: its current catalog title and description, the user's choice and its outcome.
+ * Until the plugin's first catalog lookup returns, a placeholder line and the disabled actions hold the final layout.
+ * A refused or lost lookup leaves Not now and a retry of the lookup, but not Enable.
+ * @param props - card, state, actions and plugin-lifetime services.
+ * @returns the card body.
+ */
+export declare function PluginCardBody({ proposal, decision, sessionId, summary, act, catalog, describe, openDetails, resolveText, t, }: PluginCardProps): import("react").JSX.Element;
+//# sourceMappingURL=Card.d.ts.map

package/lib/types/client/index.d.ts

@@ -0,0 +1,9 @@
+/** Bind the generated Remote contribution to the source-tested browser lifecycle. */
+import type { Context } from '@deepseek-ai/cordis';
+export { inject } from './mount.ts';
+/** Mount recommendation UI and its optional Remote.
+ * @param ctx - Client plugin context.
+ * @returns disposer for both contributions.
+ */
+export declare function apply(ctx: Context): Promise<() => Promise<void>>;
+//# sourceMappingURL=index.d.ts.map

package/lib/types/client/locales.d.ts

@@ -0,0 +1,227 @@
+/** Typed product copy for recommendation cards. */
+export declare const zh: {
+    heading: string;
+    official: string;
+    detailsFor: string;
+    'version-error': string;
+    'management-error': string;
+    enable: string;
+    dismiss: string;
+    working: string;
+    scope: string;
+    enabled: string;
+    'already-enabled': string;
+    dismissed: string;
+    replaced: string;
+    'restart-required': string;
+    failed: string;
+    retry: string;
+    unconfirmed: string;
+    'lookup-failed': string;
+    retryLookup: string;
+    unavailable: string;
+    unknown: string;
+    'access-denied': string;
+    'not-live-root': string;
+    closing: string;
+    transport: string;
+};
+/** Keys shared by every card dictionary. */
+export type RecommendationKey = keyof typeof zh;
+/** English card copy. */
+export declare const en: {
+    heading: string;
+    official: string;
+    detailsFor: string;
+    'version-error': string;
+    'management-error': string;
+    enable: string;
+    dismiss: string;
+    working: string;
+    scope: string;
+    enabled: string;
+    'already-enabled': string;
+    dismissed: string;
+    replaced: string;
+    'restart-required': string;
+    failed: string;
+    retry: string;
+    unconfirmed: string;
+    'lookup-failed': string;
+    retryLookup: string;
+    unavailable: string;
+    unknown: string;
+    'access-denied': string;
+    'not-live-root': string;
+    closing: string;
+    transport: string;
+};
+/** Japanese card copy. */
+export declare const ja: {
+    heading: string;
+    official: string;
+    detailsFor: string;
+    'version-error': string;
+    'management-error': string;
+    enable: string;
+    dismiss: string;
+    working: string;
+    scope: string;
+    enabled: string;
+    'already-enabled': string;
+    dismissed: string;
+    replaced: string;
+    'restart-required': string;
+    failed: string;
+    retry: string;
+    unconfirmed: string;
+    'lookup-failed': string;
+    retryLookup: string;
+    unavailable: string;
+    unknown: string;
+    'access-denied': string;
+    'not-live-root': string;
+    closing: string;
+    transport: string;
+};
+/** Spanish card copy. */
+export declare const es: {
+    heading: string;
+    official: string;
+    detailsFor: string;
+    'version-error': string;
+    'management-error': string;
+    enable: string;
+    dismiss: string;
+    working: string;
+    scope: string;
+    enabled: string;
+    'already-enabled': string;
+    dismissed: string;
+    replaced: string;
+    'restart-required': string;
+    failed: string;
+    retry: string;
+    unconfirmed: string;
+    'lookup-failed': string;
+    retryLookup: string;
+    unavailable: string;
+    unknown: string;
+    'access-denied': string;
+    'not-live-root': string;
+    closing: string;
+    transport: string;
+};
+/** French card copy. */
+export declare const fr: {
+    heading: string;
+    official: string;
+    detailsFor: string;
+    'version-error': string;
+    'management-error': string;
+    enable: string;
+    dismiss: string;
+    working: string;
+    scope: string;
+    enabled: string;
+    'already-enabled': string;
+    dismissed: string;
+    replaced: string;
+    'restart-required': string;
+    failed: string;
+    retry: string;
+    unconfirmed: string;
+    'lookup-failed': string;
+    retryLookup: string;
+    unavailable: string;
+    unknown: string;
+    'access-denied': string;
+    'not-live-root': string;
+    closing: string;
+    transport: string;
+};
+/** German card copy. */
+export declare const de: {
+    heading: string;
+    official: string;
+    detailsFor: string;
+    'version-error': string;
+    'management-error': string;
+    enable: string;
+    dismiss: string;
+    working: string;
+    scope: string;
+    enabled: string;
+    'already-enabled': string;
+    dismissed: string;
+    replaced: string;
+    'restart-required': string;
+    failed: string;
+    retry: string;
+    unconfirmed: string;
+    'lookup-failed': string;
+    retryLookup: string;
+    unavailable: string;
+    unknown: string;
+    'access-denied': string;
+    'not-live-root': string;
+    closing: string;
+    transport: string;
+};
+/** Russian card copy. */
+export declare const ru: {
+    heading: string;
+    official: string;
+    detailsFor: string;
+    'version-error': string;
+    'management-error': string;
+    enable: string;
+    dismiss: string;
+    working: string;
+    scope: string;
+    enabled: string;
+    'already-enabled': string;
+    dismissed: string;
+    replaced: string;
+    'restart-required': string;
+    failed: string;
+    retry: string;
+    unconfirmed: string;
+    'lookup-failed': string;
+    retryLookup: string;
+    unavailable: string;
+    unknown: string;
+    'access-denied': string;
+    'not-live-root': string;
+    closing: string;
+    transport: string;
+};
+/** Portuguese card copy. */
+export declare const pt: {
+    heading: string;
+    official: string;
+    detailsFor: string;
+    'version-error': string;
+    'management-error': string;
+    enable: string;
+    dismiss: string;
+    working: string;
+    scope: string;
+    enabled: string;
+    'already-enabled': string;
+    dismissed: string;
+    replaced: string;
+    'restart-required': string;
+    failed: string;
+    retry: string;
+    unconfirmed: string;
+    'lookup-failed': string;
+    retryLookup: string;
+    unavailable: string;
+    unknown: string;
+    'access-denied': string;
+    'not-live-root': string;
+    closing: string;
+    transport: string;
+};
+//# sourceMappingURL=locales.d.ts.map

package/lib/types/client/mount.d.ts

@@ -0,0 +1,17 @@
+import type { Context } from '@deepseek-ai/cordis';
+import type { TypertRemoteContribution } from '@deepseek-ai/dsh-typert-protocol';
+import { type RecommendationKey } from './locales.ts';
+declare module '@deepseek-ai/dsh-client-ui-slots' {
+    interface LocaleNamespaceMap {
+        pluginRecommendations: RecommendationKey;
+    }
+}
+/** Services the body needs; the shared card plugin provides `actionCards`. */
+export declare const inject: string[];
+/** Mount the catalog-text Remote, then register the body for the same plugin lifetime.
+ * @param ctx - Client plugin context.
+ * @param contribution - Generated Remote descriptors supplied by the built entry.
+ * @returns disposer removing the body before the Remote contribution.
+ */
+export declare function mountRecommendations(ctx: Context, contribution: TypertRemoteContribution): Promise<() => Promise<void>>;
+//# sourceMappingURL=mount.d.ts.map

package/lib/types/index.d.ts

@@ -0,0 +1,4 @@
+/** Browser registration is discovered through the package client declaration. */
+/** Register the browser-only contribution without Host state. */
+export declare function apply(): void;
+//# sourceMappingURL=index.d.ts.map

package/locale/de.json

@@ -0,0 +1,6 @@
+{
+  "meta": {
+    "title": "Karten für Plugin-Empfehlungen",
+    "description": "Zeigt nach einer Antwort die Karte zum Aktivieren eines empfohlenen offiziellen Plugins mit seinen Details und Ihrer Auswahl an."
+  }
+}

package/locale/en.json

@@ -0,0 +1,6 @@
+{
+  "meta": {
+    "title": "Plugin recommendation cards",
+    "description": "Show the Enable card for a recommended official plugin after an answer, with its details and your choice."
+  }
+}

package/locale/es.json

@@ -0,0 +1,6 @@
+{
+  "meta": {
+    "title": "Tarjetas de recomendación de complementos",
+    "description": "Muestra después de una respuesta la tarjeta Habilitar de un complemento oficial recomendado, con sus detalles y tu elección."
+  }
+}

package/locale/fr.json

@@ -0,0 +1,6 @@
+{
+  "meta": {
+    "title": "Cartes de recommandation de plugins",
+    "description": "Affiche après une réponse la carte Activer d’un plugin officiel recommandé, avec ses détails et votre choix."
+  }
+}

package/locale/ja.json

@@ -0,0 +1,6 @@
+{
+  "meta": {
+    "title": "プラグイン推薦カード",
+    "description": "回答の末尾に推薦された公式プラグインの有効化カードを表示し、詳細とあなたの選択を扱います。"
+  }
+}

package/locale/pt.json

@@ -0,0 +1,6 @@
+{
+  "meta": {
+    "title": "Cartões de recomendação de plug-ins",
+    "description": "Mostra após uma resposta o cartão Ativar de um plug-in oficial recomendado, com seus detalhes e sua escolha."
+  }
+}

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,69 @@
 {
+  "version": "0.2.2-alpha.2",
+  "publishConfig": {
+    "access": "public"
+  },
+  "type": "module",
+  "main": "lib/index.js",
+  "types": "lib/types/index.d.ts",
+  "license": "MIT",
   "name": "@deepseek-ai/dsh-client-ui-plugin-recommendations",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
+  "description": "Official plugin card body with catalog text and enabling",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/deepseek-ai/deepseek-harness.git",
+    "directory": "packages/experimental/client-ui-plugin-recommendations"
+  },
+  "exports": {
+    ".": {
+      "types": "./lib/types/index.d.ts",
+      "default": "./lib/index.js"
+    },
+    "./src/*": "./src/*",
+    "./package.json": "./package.json",
+    "./client": {
+      "types": "./lib/types/client/index.d.ts",
+      "default": "./lib/client.js"
+    },
+    "./locale/*.json": "./locale/*.json"
+  },
+  "dsh": {
+    "client": {
+      "platform": "web",
+      "inject": [
+        "@deepseek-ai/dsh-api-remotes",
+        "@deepseek-ai/dsh-client-locale",
+        "@deepseek-ai/dsh-client-ui-plugin-manager",
+        "@deepseek-ai/dsh-client-ui-action-cards"
+      ]
+    }
+  },
+  "peerDependencies": {
+    "@deepseek-ai/cordis": "~4.0.6-alpha.1"
+  },
+  "devDependencies": {
+    "@deepseek-ai/cordis": "~4.0.6-alpha.1",
+    "@deepseek-ai/dsh-llm": "0.2.2-alpha.2",
+    "@deepseek-ai/dsh-session": "0.2.2-alpha.2",
+    "@deepseek-ai/dsh-api-remotes": "0.2.2-alpha.2",
+    "@deepseek-ai/dsh-client-locale": "0.2.2-alpha.2",
+    "@deepseek-ai/dsh-client-ui-slots": "0.2.2-alpha.2",
+    "@deepseek-ai/dsh-client-ui-primitives": "0.2.2-alpha.2",
+    "react": "^18.2.0",
+    "@deepseek-ai/dsh-plugin-recommendations": "0.2.2-alpha.2",
+    "@deepseek-ai/dsh-client-store": "0.2.2-alpha.2",
+    "@deepseek-ai/dsh-client-ui-plugin-manager": "0.2.2-alpha.2",
+    "@deepseek-ai/dsh-typert-protocol": "0.2.2-alpha.2",
+    "@deepseek-ai/dsh-package-manifest": "0.2.2-alpha.2",
+    "@deepseek-ai/dsh-client-ui-action-cards": "0.2.2-alpha.2",
+    "@deepseek-ai/dsh-action-cards": "0.2.2-alpha.2",
+    "zod": "4.4.3",
+    "@deepseek-ai/dsh-client-test-runtime": "0.2.2-alpha.2"
+  },
+  "files": [
+    "locale/*.json",
+    "lib/index.js",
+    "lib/client.js",
+    "lib/types/**/*.d.ts"
+  ]
 }