@sparkelf/dsh-client-ui-skill-center 0.2.1-rc.2.3 → 0.2.2-alpha.2.2

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

@@ -0,0 +1,37 @@
+/**
+ * The skill center's connector tab: one card per connector, its enable switch,
+ * and — while enabled — the capability rows this account may use.
+ *
+ * @module @sparkelf/dsh-client-ui-skill-center/client/ConnectorsTab
+ */
+import type { ReactNode } from 'react';
+import { type Connector, type ConnectorCapability, type ConnectorCatalogue } from './connectors.ts';
+import type { SkillCenterLocaleKey } from './locales.ts';
+/** What the tab currently knows about the catalogue. */
+export type ConnectorLoadState = {
+    kind: 'loading';
+} | {
+    kind: 'ready';
+    catalogue: ConnectorCatalogue;
+} | {
+    kind: 'failed';
+    message: string;
+};
+/** The tab's render inputs. */
+export interface ConnectorsTabProps {
+    state: ConnectorLoadState;
+    query: string;
+    /** `connectorId` or `connectorId:capabilityId` while a write is in flight. */
+    busyId: string | null;
+    t(key: SkillCenterLocaleKey): string;
+    onRetry(): void;
+    onToggleConnector(connector: Connector, enabled: boolean): void;
+    onToggleCapability(connector: Connector, capability: ConnectorCapability, enabled: boolean): void;
+}
+/**
+ * Render the connector tab body.
+ * @param props - catalogue state, search text, and the two write handlers.
+ * @returns the connector cards, or the loading/failure/empty status.
+ */
+export declare function ConnectorsTab(props: ConnectorsTabProps): ReactNode;
+//# sourceMappingURL=ConnectorsTab.d.ts.map

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

@@ -60,6 +60,21 @@ export interface ListPayload {
     groups: GroupPayload[];
     workspaces?: WorkspaceItem[];
 }
+/** One plaza record returned by the sharing bridge. */
+export interface PlazaSkill {
+    id: number;
+    name: string;
+    reviewStatus?: 'pending' | 'approved' | 'rejected';
+    visibility?: 'global' | 'department' | 'private';
+    departmentCode?: string;
+    departmentName?: string;
+    sharedByMe?: boolean;
+    reviewNote?: string;
+    updatedAt?: string;
+}
+/** The sharing bridge could not answer (503): show local/disabled, never fake a status. */
+export declare class PlazaUnavailableError extends Error {
+}
 /** One thrown API error carrying the host's message. */
 export declare class ApiError extends Error {
 }
@@ -103,6 +118,43 @@ export declare class SkillApi {
      * been told where the translations live (the route then answers `{}`).
      */
     translationProgress(): Promise<TranslationProgress | undefined>;
+    /** The caller's review role and department scope, from the DataOps bridge. */
+    reviewContext(): Promise<{
+        canReview?: boolean;
+        canReviewGlobal?: boolean;
+        departmentCode?: string | null;
+        departmentPath?: {
+            code: string;
+            name: string;
+        }[];
+        roleCodes?: string[];
+        primaryRole?: string;
+    }>;
+    /** The department tree, for administrators publishing to any department. */
+    departments(): Promise<{
+        code: string;
+        name: string;
+        parentCode?: string | null;
+    }[]>;
+    /**
+     * The plaza records this workspace holds (`mine=1`). A 503 means the
+     * sharing service is not active yet; the panel then renders every local
+     * skill as local with 上架 disabled.
+     */
+    plazaMine(): Promise<PlazaSkill[]>;
+    /** Publish one local skill. The name is the DataOps identity; no path/level leaves the workspace. */
+    plazaSubmit(payload: {
+        name: string;
+        description?: string;
+        instruction: string;
+        tags?: string[];
+        visibility?: 'global' | 'department' | 'private';
+        departmentCode?: string;
+    }): Promise<PlazaSkill>;
+    /** Stop sharing one plaza entry owned by this workspace. */
+    plazaUnshare(id: number): Promise<void>;
+    private readBody;
+    private errorOf;
     private request;
 }
 //# sourceMappingURL=api.d.ts.map

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

@@ -0,0 +1,118 @@
+/**
+ * Connector catalogue for the skill center's fourth tab.
+ *
+ * A connector is a client-side description of one external system the profile
+ * can talk to: whether it is enabled, and which capabilities that account may
+ * use. The backend owns the authoritative list; this module only parses it and
+ * keeps a demo catalogue for profiles whose bridge has not shipped the route
+ * yet. Capability rows the account may not use are absent from the answer, so
+ * the UI never renders a disabled placeholder for a permission it lacks.
+ *
+ * @module @sparkelf/dsh-client-ui-skill-center/client/connectors
+ */
+/** Same-origin route the host/DataOps bridge may serve the catalogue from. */
+export declare const CONNECTORS_ROUTE = "/api/dsh-skill-center/connectors";
+/** One capability a connector exposes to this account. */
+export interface ConnectorCapability {
+    /** Stable id the backend uses, e.g. `approval.read`. */
+    id: string;
+    /** Name shown on the capability row. */
+    name: string;
+    /** One line explaining what the capability does. */
+    description?: string;
+    /** Whether the capability is currently on for this connector. */
+    enabled: boolean;
+    /**
+     * Whether this account may use the capability at all. A row with `false`
+     * is not rendered: hiding it is the product rule, not a disabled placeholder.
+     */
+    permitted: boolean;
+    /** Why the capability cannot be used right now (missing credential, no route). */
+    unavailableReason?: string;
+}
+/** One connector as the catalogue serves it. */
+export interface Connector {
+    id: string;
+    name: string;
+    /** Vendor or system the connector talks to. */
+    vendor?: string;
+    description?: string;
+    enabled: boolean;
+    /** Whether the last connection attempt succeeded; absent means unknown. */
+    connected?: boolean;
+    /** Failure detail when the connector is enabled but not connected. */
+    error?: string;
+    capabilities: readonly ConnectorCapability[];
+}
+/** The catalogue plus whether it came from the demo fallback. */
+export interface ConnectorCatalogue {
+    connectors: readonly Connector[];
+    demo: boolean;
+}
+/** The bridge does not serve the connector route (404/405/501/503). */
+export declare class ConnectorUnavailableError extends Error {
+}
+/** The bridge answered but the request failed for another reason. */
+export declare class ConnectorRequestError extends Error {
+}
+/** Write operations the tab performs. */
+export interface ConnectorSource {
+    /** Read the whole catalogue. */
+    list(): Promise<readonly Connector[]>;
+    /** Enable or disable one connector, returning the refreshed catalogue. */
+    setEnabled(connectorId: string, enabled: boolean): Promise<readonly Connector[]>;
+    /** Toggle one capability, returning the refreshed catalogue. */
+    setCapability(connectorId: string, capabilityId: string, enabled: boolean): Promise<readonly Connector[]>;
+}
+/** Same-origin HTTP source for a backend that supplies the catalogue. */
+export declare class HttpConnectorSource implements ConnectorSource {
+    private readonly route;
+    /**
+     * @param route - same-origin connector route; overridable for tests.
+     */
+    constructor(route?: string);
+    /** Read the catalogue. */
+    list(): Promise<readonly Connector[]>;
+    /** Enable or disable one connector. */
+    setEnabled(connectorId: string, enabled: boolean): Promise<readonly Connector[]>;
+    /** Toggle one capability. */
+    setCapability(connectorId: string, capabilityId: string, enabled: boolean): Promise<readonly Connector[]>;
+    private request;
+    private read;
+}
+/**
+ * Parse a catalogue answer. Both a bare array and `{ connectors: [...] }` are
+ * accepted, because a bridge may grow the wrapper for counts without breaking
+ * the older shape.
+ * @param value - decoded JSON body.
+ * @returns the connectors the body carries; empty when it carries none.
+ */
+export declare function parseConnectorList(value: unknown): Connector[];
+/** Capabilities this account may see; a `permitted: false` row never renders. */
+export declare function visibleCapabilities(connector: Connector): readonly ConnectorCapability[];
+/** How a connector card labels its current state. */
+export type ConnectorState = 'disabled' | 'connected' | 'error';
+/**
+ * Derive the card state from the catalogue row.
+ * @param connector - one catalogue row.
+ * @returns `disabled`, `connected`, or `error`.
+ */
+export declare function connectorState(connector: Connector): ConnectorState;
+/**
+ * The demo catalogue used when no bridge serves the route.
+ *
+ * It describes the connector this profile ships and one generic third-party
+ * connector, so the tab still demonstrates enable/disable, per-capability
+ * switches, a hidden no-permission capability, and an unavailable reason.
+ * @returns a fresh mutable copy on every call.
+ */
+export declare function demoConnectors(): Connector[];
+/**
+ * Read the catalogue, falling back to the demo rows when the bridge has no
+ * route. Any other failure propagates: a broken bridge is not "no connectors".
+ * @param source - the deployed source.
+ * @param demo - demo factory (tests pass a fixed list).
+ * @returns the catalogue and whether it is the demo fallback.
+ */
+export declare function readConnectorCatalogue(source: ConnectorSource, demo?: () => Connector[]): Promise<ConnectorCatalogue>;
+//# sourceMappingURL=connectors.d.ts.map

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

@@ -7,8 +7,15 @@
 /** Every string this plugin renders. */
 export interface SkillCenterLocale {
     'panel': string;
+    'tab.label': string;
+    'tab.builtin': string;
+    'tab.personal': string;
+    'tab.plaza': string;
+    'tab.connectors': string;
     'search.placeholder': string;
+    'search.connectorPlaceholder': string;
     'search.noMatches': string;
+    'search.clear': string;
     'action.refresh': string;
     'action.create': string;
     'action.delete': string;
@@ -41,6 +48,50 @@ export interface SkillCenterLocale {
     'create.rootUser': string;
     'create.rootProject': string;
     'delete.confirm': string;
+    'plaza.statusLocal': string;
+    'plaza.statusPending': string;
+    'plaza.statusApproved': string;
+    'plaza.statusRejected': string;
+    'plaza.sharedTag': string;
+    'plaza.share': string;
+    'plaza.resubmit': string;
+    'plaza.unshare': string;
+    'plaza.unavailable': string;
+    'plaza.failed': string;
+    'plaza.dialogTitle': string;
+    'plaza.tags': string;
+    'plaza.tagsPlaceholder': string;
+    'plaza.instruction': string;
+    'plaza.submit': string;
+    'plaza.unshareConfirm': string;
+    'plaza.reason': string;
+    'plaza.contentLoading': string;
+    'plaza.visibility': string;
+    'plaza.visibilityGlobal': string;
+    'plaza.visibilityDepartment': string;
+    'plaza.visibilityPrivate': string;
+    'plaza.department': string;
+    'plaza.scopeForbidden': string;
+    'plaza.scopeHintAdmin': string;
+    'plaza.scopeHintUser': string;
+    'plaza.sectionFallback': string;
+    'connector.loading': string;
+    'connector.failed': string;
+    'connector.retry': string;
+    'connector.demo': string;
+    'connector.demoTag': string;
+    'connector.enabled': string;
+    'connector.disabled': string;
+    'connector.connected': string;
+    'connector.error': string;
+    'connector.enable': string;
+    'connector.disable': string;
+    'connector.capabilities': string;
+    'connector.noCapabilities': string;
+    'connector.empty': string;
+    'connector.noMatches': string;
+    'connector.unavailable': string;
+    'connector.busy': string;
 }
 /** Locale keys, for callers that resolve them dynamically. */
 export type SkillCenterLocaleKey = keyof SkillCenterLocale;

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

@@ -0,0 +1,37 @@
+/**
+ * Skill-plaza sharing state shown on a local skill card.
+ *
+ * Sharing is owned by DataOps: the same-origin `dataops-managed` bridge talks
+ * to the backend with the workspace credential, and the backend enforces
+ * ownership/review. This module only maps a local skill name to the record the
+ * bridge reports, so the card can show 未共享 / 待审核 / 已上架 / 已驳回.
+ *
+ * @module @sparkelf/dsh-client-ui-skill-center/client/plaza
+ */
+/** Review/publish state of one local skill in the plaza. */
+export type PlazaStatus = 'local' | 'pending' | 'approved' | 'rejected';
+/** One plaza record, as `GET /integrations/dataops/skill-plaza?mine=1` reports it. */
+export interface PlazaSkill {
+    id: number;
+    name: string;
+    reviewStatus?: 'pending' | 'approved' | 'rejected';
+    visibility?: 'global' | 'department' | 'private';
+    departmentCode?: string;
+    departmentName?: string;
+    sharedByMe?: boolean;
+    reviewNote?: string;
+    updatedAt?: string;
+}
+/** The share state one local card should render. */
+export interface PlazaShare {
+    status: PlazaStatus;
+    /** The plaza row, when one exists (needed for unshare and the review note). */
+    record?: PlazaSkill;
+    /** True when the record is shared by this workspace (shows 取消共享). */
+    sharedByMe: boolean;
+}
+/** Map one local skill name to its share state. */
+export declare function shareOf(name: string, records: ReadonlyMap<string, PlazaSkill>): PlazaShare;
+/** Whether a share state offers the 上架 / 重新提交 action. */
+export declare function canSubmit(status: PlazaStatus): boolean;
+//# sourceMappingURL=plaza.d.ts.map

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

@@ -0,0 +1,36 @@
+/**
+ * Review-filter and DataOps-identity helpers for the skill center.
+ *
+ * The host owns the persisted status; this module only decides how the panel
+ * shows it. Keeping the rules pure makes the default filter, the counts and
+ * the administrator gate unit-testable without React.
+ *
+ * @module @sparkelf/dsh-client-ui-skill-center/client/review
+ */
+import type { SkillEntry, SkillReviewView } from './api.ts';
+/** The three list filters. */
+export type ReviewFilter = 'approved' | 'pending' | 'all';
+/** Presentation-only identity the DataOps portal posts into the DSH iframe. */
+export interface DataOpsIdentity {
+    username?: string;
+    displayName?: string;
+}
+/** Whether this identity may review skills (administrator / super administrator). */
+export declare function isReviewAdmin(identity: DataOpsIdentity | undefined): boolean;
+/**
+ * Read the identity the DataOps account plugin publishes.
+ *
+ * The plugin's documented diagnostic surface is `window.__DATAOPS_USER__`
+ * plus the `data-dataops-account-*` dataset attributes; the dataset is the
+ * fallback for the moment before the store's first paint.
+ */
+export declare function readDataOpsIdentity(): DataOpsIdentity | undefined;
+/** A row's review status, with the pre-review `pending` fallback. */
+export declare function reviewStatusOf(skill: SkillEntry): NonNullable<SkillReviewView['status']>;
+/** Whether one row belongs in a filter. */
+export declare function matchesReviewFilter(skill: SkillEntry, filter: ReviewFilter): boolean;
+/** Count rows per filter, for the tab labels. */
+export declare function reviewCounts(groups: readonly {
+    skills: readonly SkillEntry[];
+}[]): Record<ReviewFilter, number>;
+//# sourceMappingURL=review.d.ts.map

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

@@ -0,0 +1,69 @@
+/**
+ * Visibility choices for publishing a skill to the plaza.
+ *
+ * DataOps owns roles and department membership; this module only maps the
+ * review-context answer to the options a given account may pick, and remembers
+ * the last choice per user. The backend still enforces every rule.
+ *
+ * @module @sparkelf/dsh-client-ui-skill-center/client/scope
+ */
+/** Plaza visibility. */
+export type PlazaVisibility = 'global' | 'department' | 'private';
+/** Presentation-only DataOps identity used for the per-user memory key. */
+export interface AccountIdentity {
+    id?: string;
+    username?: string;
+    displayName?: string;
+}
+/** Read the identity the dataops-account plugin publishes. */
+export declare function readAccountIdentity(): AccountIdentity | undefined;
+/** One department node. */
+export interface Department {
+    code: string;
+    name: string;
+    parentCode?: string | null;
+}
+/** The subset of `/api/ai/review/context` this panel reads. */
+export interface ReviewScope {
+    canReview?: boolean;
+    canReviewGlobal?: boolean;
+    departmentCode?: string | null;
+    departmentPath?: readonly Department[];
+    roleCodes?: readonly string[];
+    primaryRole?: string;
+}
+/** Who is publishing, from the backend's point of view. */
+export type ScopeRole = 'admin' | 'dept-admin' | 'user';
+/** The remembered visibility choice. */
+export interface SavedScope {
+    visibility: PlazaVisibility;
+    departmentCode?: string;
+}
+/** Classify the caller: global review means super admin/admin; review means department admin. */
+export declare function scopeRole(scope: ReviewScope | undefined): ScopeRole;
+/** Visibilities this caller may select. */
+export declare function allowedVisibilities(scope: ReviewScope | undefined): PlazaVisibility[];
+/** Whether the caller belongs to a department (needed for department visibility). */
+export declare function hasDepartment(scope: ReviewScope | undefined): boolean;
+/** First-run default: admins publish globally, everyone else to their department, else private. */
+export declare function defaultVisibility(scope: ReviewScope | undefined): PlazaVisibility;
+/** The caller's own department code. */
+export declare function ownDepartment(scope: ReviewScope | undefined): string | undefined;
+/**
+ * Coerce a remembered choice into one this caller may still make.
+ *
+ * A saved global choice is dropped for a non-admin; a saved department code is
+ * kept only when it is the caller's own department (department admins/users)
+ * or still present in the admin's fetched department list.
+ */
+export declare function sanitizeChoice(saved: SavedScope | undefined, scope: ReviewScope | undefined, departments?: readonly Department[]): SavedScope;
+/** localStorage key, per DataOps user. */
+export declare function scopeStorageKey(identity: {
+    id?: string;
+    username?: string;
+} | undefined): string;
+/** Read a remembered choice (invalid JSON is treated as no choice). */
+export declare function readSavedScope(storage: Pick<Storage, 'getItem'>, key: string): SavedScope | undefined;
+/** Persist one choice. */
+export declare function writeSavedScope(storage: Pick<Storage, 'setItem'>, key: string, choice: SavedScope): void;
+//# sourceMappingURL=scope.d.ts.map

package/package.json

@@ -1,20 +1,28 @@
 {
+  "name": "@sparkelf/dsh-client-ui-skill-center",
+  "version": "0.2.2-alpha.2.2",
   "description": "Skill center for the dsh web client: browses loaded skills grouped by source, enables or disables model invocation, creates skills, and deletes them into a recoverable trash",
-  "devDependencies": {
-    "@deepseek-ai/cordis": "^4.0.2",
-    "@deepseek-ai/dsh-client-locale": "^0.1.6-alpha.1",
-    "@deepseek-ai/dsh-client-ui-layout": "^0.1.6-alpha.1",
-    "@deepseek-ai/dsh-client-ui-primitives": "^0.1.6-alpha.1",
-    "@deepseek-ai/dsh-client-ui-renderer": "^0.1.6-alpha.1",
-    "@deepseek-ai/dsh-client-ui-sidebar": "^0.1.6-alpha.1",
-    "@deepseek-ai/dsh-client-ui-slots": "^0.1.6-alpha.1",
-    "@deepseek-ai/dsh-host-webserver": "^0.1.6-alpha.1",
-    "@deepseek-ai/dsh-session": "^0.1.6-alpha.1",
-    "@deepseek-ai/dsh-skill": "^0.1.6-alpha.1",
-    "@types/react": "~18.3.1",
-    "@types/react-dom": "~18.3.0",
-    "react": "^18.2.0",
-    "react-dom": "^18.2.0"
+  "publishConfig": {
+    "access": "public"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/deepseek-ai/deepseek-harness.git",
+    "directory": "packages/plus/ui-skill-center"
+  },
+  "type": "module",
+  "main": "lib/index.js",
+  "types": "lib/types/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./lib/types/index.d.ts",
+      "default": "./lib/index.js"
+    },
+    "./client": {
+      "types": "./lib/types/client/index.d.ts",
+      "default": "./lib/client.js"
+    },
+    "./package.json": "./package.json"
   },
   "dsh": {
     "client": {
@@ -25,16 +33,9 @@
       "platform": "web"
     }
   },
-  "exports": {
-    ".": {
-      "default": "./lib/index.js",
-      "types": "./lib/types/index.d.ts"
-    },
-    "./client": {
-      "default": "./lib/client.js",
-      "types": "./lib/types/client/index.d.ts"
-    },
-    "./package.json": "./package.json"
+  "scripts": {
+    "bundle": "tsdown",
+    "watch": "tsdown --watch"
   },
   "files": [
     "lib/index.js",
@@ -42,24 +43,23 @@
     "lib/types/**/*.d.ts"
   ],
   "license": "MIT",
-  "main": "lib/index.js",
-  "name": "@sparkelf/dsh-client-ui-skill-center",
   "peerDependencies": {
     "@deepseek-ai/cordis": ">=4.0.1"
   },
-  "publishConfig": {
-    "access": "public"
-  },
-  "repository": {
-    "directory": "packages/plus/ui-skill-center",
-    "type": "git",
-    "url": "git+https://github.com/deepseek-ai/deepseek-harness.git"
-  },
-  "scripts": {
-    "bundle": "tsdown",
-    "watch": "tsdown --watch"
-  },
-  "type": "module",
-  "types": "lib/types/index.d.ts",
-  "version": "0.2.1-rc.2.3"
+  "devDependencies": {
+    "@deepseek-ai/cordis": "workspace:^",
+    "@deepseek-ai/dsh-client-locale": "workspace:^",
+    "@deepseek-ai/dsh-client-ui-layout": "workspace:^",
+    "@deepseek-ai/dsh-client-ui-primitives": "workspace:^",
+    "@deepseek-ai/dsh-client-ui-renderer": "workspace:^",
+    "@deepseek-ai/dsh-client-ui-sidebar": "workspace:^",
+    "@deepseek-ai/dsh-client-ui-slots": "workspace:^",
+    "@deepseek-ai/dsh-host-webserver": "workspace:^",
+    "@deepseek-ai/dsh-session": "workspace:^",
+    "@deepseek-ai/dsh-skill": "workspace:^",
+    "@types/react": "~18.3.1",
+    "@types/react-dom": "~18.3.0",
+    "react": "^18.2.0",
+    "react-dom": "^18.2.0"
+  }
 }

package/LICENSE

@@ -1,21 +0,0 @@
-MIT License
-
-Copyright (c) 2026 DeepSeek
-
-Permission is hereby granted, free of charge, to any person obtaining a copy
-of this software and associated documentation files (the "Software"), to deal
-in the Software without restriction, including without limitation the rights
-to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
-copies of the Software, and to permit persons to whom the Software is
-furnished to do so, subject to the following conditions:
-
-The above copyright notice and this permission notice shall be included in all
-copies or substantial portions of the Software.
-
-THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
-IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
-FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
-AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
-LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
-OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
-SOFTWARE.