@chengxianglibra/dsh-data-analysis 0.1.1 → 0.2.0

package/lib/client/right-tabs/live-delivery.js

@@ -0,0 +1,58 @@
+import { presentationDeliveryFromEvent, presentationDeliveryIdentity, } from "../presentation/delivery.js";
+/** Read-only Session window consumer. Initial history and replacement never navigate. */
+export class LiveDeliveryObserver {
+    #revision = -1;
+    #calls = new Map();
+    #seen = new Set();
+    #onDelivery;
+    #sessionId;
+    constructor(sessionId, onDelivery) {
+        this.#sessionId = sessionId;
+        this.#onDelivery = onDelivery;
+    }
+    consume(window, baseline = false) {
+        if (window.revision === this.#revision && !baseline)
+            return;
+        const initial = this.#revision < 0 || baseline;
+        this.#revision = window.revision;
+        const live = !initial && window.change.kind === 'append';
+        const entries = initial || window.change.kind === 'replace' || window.change.kind === 'prepend'
+            ? window.entries
+            : window.change.kind === 'append'
+                ? window.change.entries
+                : [];
+        if (initial || window.change.kind === 'replace' || window.change.kind === 'prepend')
+            this.#calls.clear();
+        for (const entry of entries) {
+            if (entry.type !== 'event')
+                continue;
+            const event = entry.event;
+            const turn = event.data?.turn;
+            if (event.type === 'tool/call' &&
+                Number.isSafeInteger(turn) &&
+                typeof event.data.callId === 'string' &&
+                typeof event.data.name === 'string') {
+                let calls = this.#calls.get(turn);
+                if (!calls) {
+                    calls = new Map();
+                    this.#calls.set(turn, calls);
+                }
+                calls.set(event.data.callId, event.data.name);
+            }
+            // Code dispatch has the canonical Turn in its durable envelope, not necessarily data.turn.
+            for (const [ownerTurn, calls] of this.#calls) {
+                const item = presentationDeliveryFromEvent(event, calls, ownerTurn);
+                if (!item || item.delivery.dshSessionId !== this.#sessionId)
+                    continue;
+                const key = presentationDeliveryIdentity(item.delivery);
+                if (this.#seen.has(key))
+                    continue;
+                this.#seen.add(key);
+                if (live)
+                    this.#onDelivery(item.delivery);
+            }
+            if (event.type === 'turn/end' && Number.isSafeInteger(turn))
+                this.#calls.delete(turn);
+        }
+    }
+}

package/lib/client/right-tabs/navigation.js

@@ -0,0 +1,47 @@
+import { boundedText, parseRef } from "../../semantic-reference/contracts.js";
+export const directoryKind = (page) => `marivo-${page}`;
+export const definitionId = (kind) => `dsh-data-analysis/right-tabs/${kind}`;
+const segment = (value) => encodeURIComponent(boundedText(value, 2048));
+export function resourceAddress(target) {
+    const root = `dsh-resource://marivo-${target.kind}/${segment(target.workspaceId)}/`;
+    return target.kind === 'report'
+        ? `${root}${segment(target.reportId)}/${target.buildId ? `build/${segment(target.buildId)}` : 'current'}`
+        : `${root}${segment(parseRef(target.ref).kind)}/${segment(target.ref.path)}`;
+}
+export function parseResource(address) {
+    const match = /^dsh-resource:\/\/marivo-(report|semantic)\/([^?#]+)$/.exec(address);
+    if (!match)
+        throw new Error('marivo.navigation.unknown-marivo-resource-address');
+    const parts = match[2].split('/').map(decodeURIComponent);
+    const workspaceId = boundedText(parts[0], 256);
+    let result;
+    if (match[1] === 'semantic' && parts.length === 3) {
+        result = {
+            kind: 'semantic',
+            workspaceId,
+            ref: parseRef({ schema: 'marivo.semantic_ref/v1', kind: parts[1], path: parts[2] }),
+        };
+    }
+    else if (match[1] === 'report' &&
+        ((parts.length === 3 && parts[2] === 'current') || (parts.length === 4 && parts[2] === 'build'))) {
+        result = {
+            kind: 'report',
+            workspaceId,
+            reportId: boundedText(parts[1], 256),
+            ...(parts.length === 4 ? { buildId: boundedText(parts[3], 256) } : {}),
+        };
+    }
+    else
+        throw new Error('marivo.navigation.unknown-marivo-resource-address');
+    if (resourceAddress(result) !== address)
+        throw new Error('marivo.navigation.resource-address-is-not-canonically-encoded');
+    return result;
+}
+export function canOpenResource(address, kind) {
+    try {
+        return parseResource(address).kind === kind;
+    }
+    catch {
+        return false;
+    }
+}

package/lib/client/right-tabs/page.js

@@ -0,0 +1,178 @@
+import { parsePresentationReceipt } from "../../presentation/contracts/index.js";
+import { MARIVO_PRESENTATION_RPC_CHANNEL } from "../../presentation/receipt.js";
+import { CredentialClientModel } from "../credentials/model.js";
+import { ReportCatalogModel } from "../presentation/catalog-model.js";
+import { PresentationDeliveryModel } from "../presentation/delivery-model.js";
+import { SemanticBrowserModel } from "../semantic-browser/model.js";
+/** Lifetime belongs to a Host tab occurrence, never to a React body mount. */
+export class TabPage {
+    sessionId;
+    target;
+    reader;
+    catalog;
+    semantic;
+    datasources;
+    viewMemory = new Map();
+    #rpc;
+    #lifetime = new AbortController();
+    #navigation = new AbortController();
+    #revision = -1;
+    #updateRevision = 0;
+    #state = {};
+    #listeners = new Set();
+    #closed = false;
+    constructor(sessionId, target, rpc, occurrenceId) {
+        this.sessionId = sessionId;
+        this.target = target;
+        this.#rpc = {
+            call: async (channel, endpoint, payload, signal) => {
+                const combined = AbortSignal.any([signal, this.#navigation.signal, this.#lifetime.signal]);
+                combined.throwIfAborted();
+                const result = await rpc.call(channel, endpoint, payload, combined);
+                combined.throwIfAborted();
+                return result;
+            },
+        };
+        this.reader = new PresentationDeliveryModel(this.#rpc);
+        this.catalog = new ReportCatalogModel(this.#rpc);
+        this.semantic = new SemanticBrowserModel(this.#rpc);
+        let storage;
+        try {
+            if (occurrenceId) {
+                const saved = window.sessionStorage;
+                const key = `marivo-credential-operation:${JSON.stringify([sessionId, occurrenceId])}`;
+                storage = {
+                    getItem: () => saved.getItem(key),
+                    setItem: (_key, value) => saved.setItem(key, value),
+                    removeItem: () => saved.removeItem(key),
+                };
+            }
+        }
+        catch {
+            // Host query handles remain recoverable in memory when storage is unavailable.
+        }
+        this.datasources = new CredentialClientModel(this.#rpc, storage);
+        if (target.kind === 'datasources')
+            this.datasources.recover();
+    }
+    getSnapshot = () => this.#state;
+    subscribe = (listener) => {
+        this.#listeners.add(listener);
+        return () => {
+            this.#listeners.delete(listener);
+        };
+    };
+    patch(change) {
+        if (this.#closed)
+            return;
+        this.#state = { ...this.#state, ...change };
+        for (const listener of this.#listeners)
+            listener();
+    }
+    async navigate(revision, force = false, history = false) {
+        if (this.#closed || (this.#revision === revision && !force))
+            return;
+        this.#revision = revision;
+        if (this.reader.getSnapshot().editing || this.reader.getSnapshot().saving) {
+            this.patch({ notice: 'marivo.navigation.your-edits-are-retained-save-or-cancel-them-first' });
+            return;
+        }
+        if (this.target.kind !== 'datasources' || this.#navigation.signal.aborted) {
+            this.#navigation.abort();
+            this.#navigation = new AbortController();
+        }
+        this.#updateRevision++;
+        this.patch({ error: undefined, newer: undefined, notice: undefined });
+        const target = this.target;
+        if (target.kind === 'report') {
+            if (target.buildId)
+                await this.reader.showBuild(target.workspaceId, target.reportId, target.buildId);
+            else
+                await this.reader.showReport(target.workspaceId, target.reportId);
+            if (history &&
+                revision === this.#revision &&
+                !this.#closed &&
+                !this.#navigation.signal.aborted)
+                await this.reader.toggleHistory();
+            const displayed = this.reader.getSnapshot().document;
+            if (displayed)
+                for (const key of this.viewMemory.keys())
+                    if (!key.startsWith(`${displayed.workspaceId}/${displayed.reportId}/${displayed.buildId}/`))
+                        this.viewMemory.delete(key);
+        }
+        else if (target.kind === 'reports')
+            this.catalog.show(target.workspaceId);
+        else if (target.kind === 'datasources')
+            await this.datasources.show(target.workspaceId);
+        else if ('ref' in target)
+            this.semantic.showObject(target.workspaceId, target.ref);
+        else
+            this.semantic.show(target.workspaceId);
+    }
+    async refresh(confirmDiscard = () => window.confirm('marivo.navigation.there-are-unsaved-edits-discard-them-and-refresh-the')) {
+        // Incidental refreshes must not undo revocation. Only a checked navigation
+        // can reopen an unavailable occurrence.
+        if (this.#state.error || this.reader.getSnapshot().saving)
+            return;
+        if (this.reader.dirty && !confirmDiscard())
+            return;
+        this.reader.cancelEdit();
+        await this.navigate(this.#revision, true);
+    }
+    async publicationChanged(workspaceId, reportId) {
+        if (this.#closed || this.#state.error || workspaceId !== this.target.workspaceId)
+            return;
+        if (this.target.kind === 'reports') {
+            await this.catalog.refresh();
+            return;
+        }
+        if (this.target.kind !== 'report' ||
+            this.target.buildId ||
+            (reportId && reportId !== this.target.reportId))
+            return;
+        const generation = ++this.#updateRevision;
+        try {
+            const response = (await this.#rpc.call(MARIVO_PRESENTATION_RPC_CHANNEL, 'reports/resolve', { workspaceId, reportId: this.target.reportId }, this.#navigation.signal));
+            if (!response?.ok)
+                throw new Error(response?.error?.message ?? 'marivo.navigation.cannot-verify-the-new-version');
+            const receipt = parsePresentationReceipt(response.value);
+            if (receipt.workspaceId !== workspaceId || receipt.reportId !== this.target.reportId)
+                throw new Error('marivo.navigation.report-identity-changed');
+            if (generation !== this.#updateRevision || this.#closed)
+                return;
+            this.patch({
+                newer: receipt.buildId !== this.reader.getSnapshot().document?.buildId ? receipt : undefined,
+            });
+        }
+        catch (error) {
+            if (generation === this.#updateRevision && !this.#closed && !this.#state.error)
+                this.patch({
+                    notice: error instanceof Error
+                        ? error.message
+                        : 'marivo.navigation.cannot-verify-the-new-version',
+                });
+        }
+    }
+    unavailable(message) {
+        this.#navigation.abort();
+        this.#updateRevision++;
+        this.reader.unavailable(message);
+        this.catalog.reset();
+        this.semantic.unavailable();
+        this.datasources.suspend();
+        this.viewMemory.clear();
+        this.patch({ error: message, newer: undefined });
+    }
+    dispose() {
+        if (this.#closed)
+            return;
+        this.#closed = true;
+        this.#lifetime.abort();
+        this.reader.dispose();
+        this.catalog.dispose();
+        this.semantic.dispose();
+        this.datasources.dispose();
+        this.viewMemory.clear();
+        this.#listeners.clear();
+    }
+}

package/lib/client/right-tabs/styles.js

@@ -0,0 +1,11 @@
+/** Host-only chrome. Portable reports keep their own independent stylesheet. */
+export const rightTabStyles = `
+.rt-page{height:100%;width:100%;min-width:0;overflow:auto;padding:16px;box-sizing:border-box;color:var(--dsw-alias-label-primary,#182a33);background:var(--dsw-alias-bg-base,#fff);container-type:inline-size;font:14px/1.6 system-ui,sans-serif}
+.rt-page *{box-sizing:border-box}.rt-page h2{font-size:18px;overflow-wrap:anywhere}.rt-page .rt-heading{margin:0 0 4px}.rt-heading-row{display:flex;align-items:center;justify-content:space-between;gap:16px;margin-bottom:4px}.rt-page .rt-heading-row .rt-heading{margin:0}.rt-heading-row>button{flex:none}.rt-caption{color:var(--dsw-alias-label-secondary,#627580);font-size:12px;margin:0 0 16px;overflow-wrap:anywhere}
+.rt-toolbar{display:flex;flex-wrap:wrap;align-items:center;gap:8px;padding-bottom:12px;border-bottom:1px solid var(--dsw-alias-border-l2,#dce4e8);margin-bottom:16px}
+.rt-page button,.rt-page select,.rt-page input{font:inherit;color:inherit;max-width:100%}.rt-page button{cursor:pointer;border:1px solid var(--dsw-alias-border-l2,#dce4e8);background:var(--dsw-alias-bg-base,#fff);border-radius:7px;padding:6px 10px}.rt-page button:hover:not(:disabled){background:var(--dsw-alias-interactive-bg-hover,#edf4f3)}.rt-page button:disabled{opacity:.5;cursor:default}.rt-page :focus-visible{outline:2px solid var(--dsw-alias-state-business-primary,#087b70);outline-offset:3px}
+.rt-page select{padding:8px;border:1px solid var(--dsw-alias-border-l2,#dce4e8);border-radius:7px;background:var(--dsw-alias-bg-base,#fff)}.rt-page [role=alert]{color:var(--dsw-alias-state-warn-label,#b14927);overflow-wrap:anywhere}.rt-notice{padding:12px;border:1px solid var(--dsw-alias-border-l2,#dce4e8);border-radius:8px;background:var(--dsw-alias-bg-module-platform,#f5f7f9)}
+.rt-page .pd-catalog{padding:0;overflow:auto}.rt-page .pd-history{position:static;max-height:300px;border:1px solid var(--dsw-alias-border-l2,#dce4e8);border-radius:8px;margin-bottom:16px;width:100%}
+.rt-page .rt-refresh{display:grid;place-items:center;padding:7px;border-color:transparent;background:transparent}
+@container(max-width:650px){.rt-page .pr-reader{padding:24px 4px}.rt-page .pr-reader h1{font-size:25px}.rt-page .pr-block-metric{padding:14px}.rt-page .pr-metric-value{font-size:clamp(18px,7cqi,30px)}}
+`;

package/lib/client/rpc.js

@@ -0,0 +1,5 @@
+export function createPluginRpc(rpc) {
+    return {
+        call: (channel, endpoint, payload, signal) => rpc.call('/api', `${channel.slice(1)}/${endpoint}`, payload, signal),
+    };
+}

package/lib/client/semantic-reference.js

@@ -0,0 +1,10 @@
+import { envelopeJson, refKey, SOURCE } from "../semantic-reference/contracts.js";
+/** Both the @ picker and semantic details insert exactly this Host reference. */
+export function semanticReference(envelope) {
+    return {
+        source: SOURCE,
+        ref: envelopeJson(envelope),
+        label: refKey(envelope.ref),
+        clipboardText: `@${refKey(envelope.ref)}`,
+    };
+}

package/lib/client/workspace-header-action.js

@@ -0,0 +1,24 @@
+import { jsx as _jsx, Fragment as _Fragment, jsxs as _jsxs } from "react/jsx-runtime";
+import { useCopy } from "./i18n/context.js";
+const styles = `
+.marivo-workspace-header-action{display:inline-flex;flex:none;align-items:center;justify-content:center;gap:5px;height:32px;padding:6px 8px;border:0;border-radius:8px;background:transparent;color:inherit;font:inherit;font-size:12px;line-height:20px;white-space:nowrap;cursor:pointer}
+.marivo-workspace-header-action:hover:not(:disabled){background:var(--dsw-alias-interactive-bg-hover,#7b899414)}
+.marivo-workspace-header-action:focus-visible{outline:2px solid var(--dsw-alias-label-primary,#087b70);outline-offset:2px}
+.marivo-workspace-header-action:disabled{opacity:.45;cursor:default}
+/* Public slot anchors keep this layout local to the blank homepage. */
+:has(> [data-slot="conversation.input.dock"] > .marivo-workspace-shortcuts){display:grid;grid-template-columns:auto minmax(0,1fr);align-items:center}
+:has(> [data-slot="conversation.input.dock"] > .marivo-workspace-shortcuts)>*,
+:has(> [data-slot="conversation.input.dock"] > .marivo-workspace-shortcuts)>[data-slot]>*{grid-column:1 / -1;min-width:0}
+:has(> [data-slot="conversation.input.dock"] > .marivo-workspace-shortcuts)>:has(+ [data-slot="conversation.input.dock"]){grid-column:1;padding-inline-end:0}
+:has(> [data-slot="conversation.input.dock"] > .marivo-workspace-shortcuts)>[data-slot]>.marivo-workspace-shortcuts{grid-column:2}
+.marivo-workspace-shortcuts{display:flex;flex-wrap:wrap;align-items:center;justify-content:flex-start;gap:2px;margin:4px 0 0;padding-inline:0 16px}
+.marivo-workspace-shortcuts .marivo-workspace-header-action{width:auto;height:auto;min-height:32px;padding:6px 8px;white-space:normal;text-align:start}
+.marivo-workspace-shortcuts .marivo-workspace-header-action span{display:inline}
+.marivo-workspace-shortcuts-error{flex-basis:100%;margin:0;text-align:start;overflow-wrap:anywhere}
+@media(max-width:640px){.marivo-workspace-header-action{width:32px;padding:8px}.marivo-workspace-header-action span{display:none}}
+@media(max-width:640px){:has(> [data-slot="conversation.input.dock"] > .marivo-workspace-shortcuts){grid-template-columns:minmax(0,1fr)}:has(> [data-slot="conversation.input.dock"] > .marivo-workspace-shortcuts)>[data-slot]>.marivo-workspace-shortcuts{grid-column:1 / -1;padding-inline:16px}}
+`;
+export function WorkspaceHeaderAction({ label, icon, disabled, title, onClick, }) {
+    const t = useCopy();
+    return (_jsxs(_Fragment, { children: [_jsx("style", { children: styles }), _jsxs("button", { className: "marivo-workspace-header-action", type: "button", title: t(title ?? label), "aria-label": t('marivo.navigation.open-value', { p0: label }), disabled: disabled, onClick: onClick, children: [_jsx("svg", { width: "16", height: "16", viewBox: "0 0 24 24", fill: "none", stroke: "currentColor", strokeWidth: "1.6", strokeLinecap: "round", strokeLinejoin: "round", "aria-hidden": "true", children: icon === 'reports' ? (_jsx("path", { d: "M6 3h9l4 4v14H6zM14 3v5h5M9 12h7M9 16h7" })) : icon === 'semantic' ? (_jsx("path", { d: "m12 3 9 5-9 5-9-5 9-5Zm-9 9 9 5 9-5M3 16l9 5 9-5" })) : (_jsxs(_Fragment, { children: [_jsx("rect", { x: "4", y: "10", width: "16", height: "11", rx: "2" }), _jsx("path", { d: "M8 10V7a4 4 0 0 1 8 0v3m-4 5v2" })] })) }), _jsx("span", { children: t(label) })] })] }));
+}

package/lib/client/workspace-shortcuts.js

@@ -0,0 +1,26 @@
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+import { conversationPhase, } from '@deepseek-ai/dsh-client-ui-conversation/client';
+import { useState } from 'react';
+import { useCopy } from "./i18n/context.js";
+import { WorkspaceHeaderAction } from "./workspace-header-action.js";
+export const workspaceDirectories = {
+    datasources: 'marivo.credentials.datasources-and-credentials',
+    semantic: 'marivo.navigation.semantic-layer',
+    reports: 'marivo.presentation.reports',
+};
+/** Only the Host's blank phase exposes preparation actions; drafts are untouched. */
+export function WorkspaceShortcuts({ session, conversation, disabled, open, }) {
+    const t = useCopy();
+    const [error, setError] = useState('');
+    if (!session || !conversation || conversationPhase(session, conversation) !== 'blank')
+        return null;
+    return (_jsxs("div", { className: "marivo-workspace-shortcuts", children: [Object.entries(workspaceDirectories).map(([page, label]) => (_jsx(WorkspaceHeaderAction, { label: t(label), icon: page === 'datasources' ? 'credentials' : page, disabled: disabled, onClick: () => {
+                    setError('');
+                    try {
+                        open(page);
+                    }
+                    catch (cause) {
+                        setError(cause instanceof Error ? cause.message : String(cause));
+                    }
+                } }, page))), error && (_jsx("p", { className: "marivo-workspace-shortcuts-error", role: "alert", children: t(error) }))] }));
+}