@chengxianglibra/dsh-data-analysis 0.3.0 → 0.3.1

package/lib/types/report-publishing/adapters.d.ts

@@ -0,0 +1,6 @@
+import type { Context } from '@deepseek-ai/cordis';
+import type { HostConnectionHandle } from '@deepseek-ai/dsh-client-connection';
+import type { Session } from '@deepseek-ai/dsh-session';
+import type { ReportPublishingService } from './service.ts';
+export declare function registerPublishingRpc(connection: HostConnectionHandle, service: ReportPublishingService | undefined, workspaceExists: (id: string) => boolean): () => Promise<void>;
+export declare function registerReportPublishTool(ctx: Context, service: ReportPublishingService, session: Session): () => Promise<void>;

package/lib/types/report-publishing/config.d.ts

@@ -0,0 +1,23 @@
+import { z } from 'zod';
+declare const enabledPublishing: z.ZodObject<{
+    enabled: z.ZodLiteral<true>;
+    storage: z.ZodObject<{
+        name: z.ZodString;
+        protocol: z.ZodDefault<z.ZodLiteral<"s3">>;
+        endpoint: z.ZodString;
+        region: z.ZodString;
+        bucket: z.ZodString;
+        forcePathStyle: z.ZodDefault<z.ZodBoolean>;
+        accessKeyIdRef: z.ZodString;
+        secretAccessKeyRef: z.ZodString;
+        sessionTokenRef: z.ZodOptional<z.ZodString>;
+    }, z.core.$strict>;
+    pathPrefix: z.ZodDefault<z.ZodString>;
+    publicBaseUrl: z.ZodString;
+}, z.core.$strict>;
+export type ReportPublishingConfig = z.input<typeof enabledPublishing> | {
+    enabled?: false;
+};
+export type EnabledPublishingConfig = z.output<typeof enabledPublishing>;
+export declare function resolvePublishingConfig(value: unknown): EnabledPublishingConfig | undefined;
+export {};

package/lib/types/report-publishing/credential-contract.d.ts

@@ -0,0 +1,61 @@
+import { z } from 'zod';
+export declare const REPORT_PUBLISHING_CHANNEL = "/dsh-report-publishing";
+export declare const publishingFields: readonly ["accessKeyId", "secretAccessKey", "sessionToken"];
+export declare const publishingFieldSchema: z.ZodEnum<{
+    accessKeyId: "accessKeyId";
+    secretAccessKey: "secretAccessKey";
+    sessionToken: "sessionToken";
+}>;
+export type PublishingField = z.infer<typeof publishingFieldSchema>;
+declare const publishingCredentialViewSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
+    enabled: z.ZodLiteral<false>;
+    fields: z.ZodTuple<[], null>;
+}, z.core.$strict>, z.ZodObject<{
+    enabled: z.ZodLiteral<true>;
+    configId: z.ZodString;
+    name: z.ZodString;
+    bucket: z.ZodString;
+    fields: z.ZodArray<z.ZodObject<{
+        field: z.ZodEnum<{
+            accessKeyId: "accessKeyId";
+            secretAccessKey: "secretAccessKey";
+            sessionToken: "sessionToken";
+        }>;
+        reference: z.ZodString;
+        required: z.ZodBoolean;
+        configured: z.ZodBoolean;
+        writable: z.ZodBoolean;
+        source: z.ZodOptional<z.ZodString>;
+    }, z.core.$strict>>;
+}, z.core.$strict>], "enabled">;
+export type PublishingCredentialView = z.infer<typeof publishingCredentialViewSchema>;
+export declare const publishingCredentialResultSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
+    ok: z.ZodLiteral<true>;
+    value: z.ZodDiscriminatedUnion<[z.ZodObject<{
+        enabled: z.ZodLiteral<false>;
+        fields: z.ZodTuple<[], null>;
+    }, z.core.$strict>, z.ZodObject<{
+        enabled: z.ZodLiteral<true>;
+        configId: z.ZodString;
+        name: z.ZodString;
+        bucket: z.ZodString;
+        fields: z.ZodArray<z.ZodObject<{
+            field: z.ZodEnum<{
+                accessKeyId: "accessKeyId";
+                secretAccessKey: "secretAccessKey";
+                sessionToken: "sessionToken";
+            }>;
+            reference: z.ZodString;
+            required: z.ZodBoolean;
+            configured: z.ZodBoolean;
+            writable: z.ZodBoolean;
+            source: z.ZodOptional<z.ZodString>;
+        }, z.core.$strict>>;
+    }, z.core.$strict>], "enabled">;
+}, z.core.$strip>, z.ZodObject<{
+    ok: z.ZodLiteral<false>;
+    error: z.ZodObject<{
+        message: z.ZodString;
+    }, z.core.$strip>;
+}, z.core.$strip>], "ok">;
+export {};

package/lib/types/report-publishing/service.d.ts

@@ -0,0 +1,31 @@
+import { type CredentialProvider } from '@deepseek-ai/dsh-credentials';
+import type { SavedReportRef } from '../presentation/contracts/report-ref.ts';
+import type { MarivoPresentationFileService } from '../presentation/rpc.ts';
+import type { EnabledPublishingConfig } from './config.ts';
+import { type PublishingCredentialView, type PublishingField } from './credential-contract.ts';
+type Store = Pick<CredentialProvider, 'describe' | 'set' | 'unset' | 'resolve'>;
+export declare class ReportPublishingService {
+    #private;
+    readonly configId: `${string}-${string}-${string}-${string}-${string}`;
+    constructor(config: EnabledPublishingConfig, store: Store, files: Pick<MarivoPresentationFileService, 'readSavedReport'>, workspaceName: (id: string) => string);
+    assertConfig(configId: string): void;
+    describe(): Promise<PublishingCredentialView>;
+    change(field: PublishingField, value: string | undefined, signal: AbortSignal): Promise<void>;
+    publish(scope: {
+        sessionId: string;
+    } | {
+        workspaceId: string;
+    }, ref: SavedReportRef, caller: AbortSignal): Promise<{
+        storage: string;
+        bucket: string;
+        key: string;
+        url: string;
+        workspaceId: string;
+        reportId: string;
+        buildId: string;
+        sha256: string;
+        bytes: number;
+        publishedAt: string;
+    }>;
+}
+export {};

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@chengxianglibra/dsh-data-analysis",
   "description": "Marivo runtime, live Help, secure datasource execution and presentation delivery for DeepSeek Harness",
-  "version": "0.3.0",
+  "version": "0.3.1",
   "repository": {
     "type": "git",
     "url": "git+https://github.com/chengxianglibra/dsh-data-analysis.git",
@@ -46,6 +46,8 @@
     "./package.json": "./package.json"
   },
   "files": [
+    "assets/logo-mark.svg",
+    "assets/logo-horizontal.svg",
     "lib/**/*.js",
     "lib/types/**/*.d.ts",
     "skills/dsh-data-analysis-presentation/**",
@@ -107,6 +109,7 @@
     }
   },
   "dependencies": {
+    "@aws-sdk/client-s3": "^3.1167.0",
     "@deepseek-ai/schemastery": "^3.18.1",
     "@noble/hashes": "2.4.0",
     "@openuidev/lang-core": "1.0.1",

package/skills/dsh-data-analysis-files/references/delivery.md

@@ -6,7 +6,9 @@
 
 只交付用户要求的最终文件。分析 UI 的保存记录、快照和 receipt 不作为默认附件；用户另行要求时，先确认实际文件已经存在且当前 Session 可访问。
 
-用户需要分析报告的离线 HTML 时，可在报告标签页导出当前显示的已保存版本。文件包含已保存快照，可能包括当前未显示的数据，分享前应确认内容；截断的快照不会因导出而变完整。下载由浏览器处理，不自动成为 Session 文件，也不代表已通过 `present` 交付；不以手写 HTML 冒充报告导出。对象存储发布不受支持。
+报告三点菜单默认提供本地 HTML 导出；开启 `reportPublishing.enabled` 后替换为「发布到对象存储」。缺凭据时，点击「前往凭证管理」跳到「数据源与凭证」页面中与「数据源」同级的「凭证管理」tab，补齐后重试发布。
+
+导出或发布均使用当前显示的已保存版本。HTML 包含已保存快照，可能包括当前未显示的数据，分享前应确认内容；截断的快照不会因此变完整。本地下载由浏览器处理，发布成功返回链接，均不自动成为 Session 文件，也不代表已通过 `present` 交付；不以手写 HTML 冒充报告导出。
 
 Session 文件生成成功，或用户要求预览且已有文件确认可访问后，调用 `present`，分别核对生成与声明结果。CSV、TSV、XLSX 由 Harness 原生表格预览读取文件，契约见 `dsh-v0.1.7-rc.1/packages/client/ui-sidebar-documentpreview/README.zh.md`；这是只读文件视图，不是 Marivo Report/Build，也不代表插件支持写入 XLSX 或分析旧 `.xls`。当前缺少 `present` 时，说明文件实际状态和原生交付能力不可用，并提供准确路径；不虚构卡片，不安装工具或改写 profile。