dsh-openwrite 0.2.8

package/packages/studio-panel/lib/index.js

@@ -0,0 +1,50 @@
+import { readFile } from "node:fs/promises";
+//#region src/index.ts
+const name = "@dsh-novel/studio-panel";
+const VENDOR_ROUTE = "/studio-panel/vendor/vditor";
+const VENDOR_FILES = {
+	"/LICENSE": "text/plain; charset=utf-8",
+	"/dist/index.css": "text/css; charset=utf-8",
+	"/dist/index.min.js": "text/javascript; charset=utf-8",
+	"/dist/css/content-theme/dark.css": "text/css; charset=utf-8",
+	"/dist/css/content-theme/light.css": "text/css; charset=utf-8",
+	"/dist/js/lute/lute.min.js": "text/javascript; charset=utf-8",
+	"/dist/js/icons/ant.js": "text/javascript; charset=utf-8",
+	"/dist/js/i18n/zh_CN.js": "text/javascript; charset=utf-8"
+};
+/** Browser UI loader plus same-origin static assets for the packaged editor engine. */
+function apply(ctx) {
+	ctx.inject(["webServer"], (webCtx) => {
+		webCtx.effect(() => webCtx.webServer.register({
+			kind: "prefix",
+			path: VENDOR_ROUTE,
+			handler: async (req, res) => {
+				if (req.method !== "GET" && req.method !== "HEAD") {
+					res.writeHead(405);
+					res.end();
+					return;
+				}
+				const suffix = (req.url ?? "").slice(27).split("?")[0] ?? "";
+				const contentType = VENDOR_FILES[suffix];
+				if (contentType === void 0) {
+					res.writeHead(404);
+					res.end();
+					return;
+				}
+				try {
+					const bytes = await readFile(new URL(`../vendor/vditor${suffix}`, import.meta.url));
+					res.writeHead(200, {
+						"content-type": contentType,
+						"cache-control": "public, max-age=31536000, immutable"
+					});
+					res.end(bytes);
+				} catch {
+					res.writeHead(404);
+					res.end();
+				}
+			}
+		}), "studio-panel: packaged Vditor assets");
+	});
+}
+//#endregion
+export { VENDOR_ROUTE, apply, name };

package/packages/studio-panel/lib/types/client/AssetEditor.d.ts

@@ -0,0 +1,122 @@
+/**
+ * Asset editor + create form for the 资产 tab. The write surface is exactly
+ * the server's contract (verified against OpenWrite tools/structured_assets.py
+ * create/update and tools/studio_application.py create_asset/update_asset):
+ *
+ * - Update: POST /api/assets/update { kind, id, revision, data } — `revision`
+ *   is the optimistic lock (the detail's fingerprint); a stale revision
+ *   answers 409 ASSET_CONFLICT. `data` merges into the front matter, filtered
+ *   server-side to CHARACTER_FIELDS / WORLD_FIELDS (character: name, aliases,
+ *   tier, summary, tags, personality, goal, fear, taboos, appearance, voice,
+ *   current_state, organization, progression_system, progression_stage,
+ *   detail_refs, related; world: name, kind, type, subtype, summary, status,
+ *   tags, detail_refs, related). Relations edit through data.related as
+ *   strings or { target, kind, note } dicts. Progression merges data into the
+ *   YAML document (absent keys, e.g. stages, are preserved).
+ * - Create: POST /api/assets { kind, id, data } — id must match
+ *   [A-Za-z0-9][A-Za-z0-9_.-]{0,79}; progression requires a non-empty stages
+ *   list of { id, name } and kind in ability/rank/cultivation/career/
+ *   reputation/curse/custom.
+ */
+import type { PropsLocale } from '@deepseek-ai/dsh-client-ui-slots';
+/** The summary fields the editor needs from the parsed detail. */
+export interface AssetEditorSource {
+    name: string;
+    summary: string;
+    aliases: string[];
+    tags: string[];
+    scalars: {
+        key: string;
+        value: string;
+    }[];
+    /** List-typed whitelist fields (taboos/detail_refs), edited one entry per line. */
+    lists: {
+        key: string;
+        items: string[];
+    }[];
+    related: RelationDraft[];
+    /** The markdown body (body_markdown), edited with a preview toggle. */
+    body: string;
+    /**
+     * Derived relations (incoming edges and annotation-sourced entries) shown
+     * read-only in the editor. They live in OTHER assets' front matter (or in
+     * body annotations), so they are not editable here — but hiding them made
+     * the editor look broken next to the read view, which shows them.
+     */
+    derivedRelations: DerivedRelation[];
+}
+/** One derived (non-editable) relation row for editor display. */
+export interface DerivedRelation {
+    name: string;
+    note: string;
+    direction: 'outgoing' | 'incoming';
+    origin: string;
+}
+/** One editable frontmatter relation row. */
+export interface RelationDraft {
+    target: string;
+    kind: string;
+    note: string;
+}
+/** A relation-target candidate from the loaded asset list. */
+export interface RelationCandidate {
+    id: string;
+    name: string;
+    kind: string;
+}
+type TFunc = PropsLocale<'studio-panel'>['t'];
+/**
+ * Localized label for any front-matter field key (edit form + read field
+ * table). List-typed keys delegate to the 索引 labels; unmapped keys fall
+ * back to the raw key — unknown fields are never hidden.
+ */
+export declare function fieldLabel(key: string, t: TFunc): string;
+interface AssetEditorProps {
+    kind: string;
+    /** Current values from the freshly loaded detail (remount on epoch change resets the draft). */
+    source: AssetEditorSource;
+    candidates: readonly RelationCandidate[];
+    saving: boolean;
+    saveError: string | null;
+    conflict: boolean;
+    onSave: (data: Record<string, unknown>, bodyMarkdown: string) => void;
+    /** Single-field autosave on blur (Obsidian-style): AssetsView owns the revision chain. */
+    onFieldSave: (field: string, value: unknown) => void;
+    /** The field key whose single-field save is in flight (input stays interactive otherwise). */
+    fieldBusy: string | null;
+    onCancel: () => void;
+    onRefresh: () => void;
+    onDirtyChange?: (dirty: boolean) => void;
+    initialDraft?: AssetEditorDraft | undefined;
+    onDraftChange?: (draft: AssetEditorDraft, dirty: boolean) => void;
+    t: TFunc;
+}
+export interface AssetEditorDraft {
+    name: string;
+    summary: string;
+    aliasesText: string;
+    tagsText: string;
+    scalars: Record<string, string>;
+    related: RelationDraft[];
+    listsText: Record<string, string>;
+    newTarget: string;
+    newNote: string;
+    bodyDraft: string;
+}
+/** Read-write editor over one asset's allowed front-matter fields. */
+export declare function AssetEditor({ kind, source, candidates, saving, saveError, conflict, onSave, onFieldSave, fieldBusy, onCancel, onRefresh, onDirtyChange, initialDraft, onDraftChange, t }: AssetEditorProps): import("react").JSX.Element;
+interface NewAssetFormProps {
+    kind: 'character' | 'world' | 'progression';
+    busy: boolean;
+    error: string | null;
+    onSubmit: (payload: {
+        id: string;
+        data: Record<string, unknown>;
+    }) => void;
+    onCancel: () => void;
+    onDirtyChange?: (dirty: boolean) => void;
+    t: TFunc;
+}
+/** Inline create form for one asset kind (minimal required fields per the server contract). */
+export declare function NewAssetForm({ kind, busy, error, onSubmit, onCancel, onDirtyChange, t }: NewAssetFormProps): import("react").JSX.Element;
+export {};

package/packages/studio-panel/lib/types/client/AssetsView.d.ts

@@ -0,0 +1,43 @@
+/**
+ * Assets view (资产): OpenWrite's structured canon library (Studio's 资料库)
+ * rendered natively as an Obsidian-like master-detail layout — left sidebar
+ * (segment switcher, search, compact asset rows with collapsible 设定
+ * subcategory groups, 新建 button) + main detail pane (header, two-column
+ * fields, 索引, 关系, markdown body) with a read/edit toggle and inline
+ * creation. Only the asset domain is writable; manuscript/outline mutations
+ * stay with the agent tools.
+ *
+ * Wire shapes (verified against OpenWrite tools/studio_http.py do_GET,
+ * tools/structured_assets.py, tools/world_query.py get_asset_relation_view,
+ * tools/studio_application.py workspace/_document_groups/read_document):
+ * - GET /api/assets?kind=X — enveloped { ok, data: { assets: [...] } }.
+ *   Summaries: character/world { kind, id, name, summary, asset_type,
+ *   aliases, tags, path }; progression adds { stage_count }.
+ * - GET /api/assets/{kind}/{id} — enveloped detail { kind, id, name,
+ *   data: <front-matter/YAML dict>, body_markdown, path, revision } +
+ *   character/world only: relation_view { confirmed, registered, suggested,
+ *   incoming, counts } with items { target, name, kind, note, origin,
+ *   direction, resolved }.
+ * - POST /api/assets / POST /api/assets/update — the write contract lives in
+ *   AssetEditor.tsx's header comment.
+ * - GET /api/workspace — NOT enveloped. documents.core[] is the 作品核心
+ *   document list; operations.reference_library is the 参考作品 (reference
+ *   works) list — Studio's data-view="deconstruct" surface, NOT the 资料库
+ *   nav entry (which is this structured asset library).
+ * - GET /api/document?path=<p> — NOT enveloped { path, title, content, ... }.
+ */
+import type { ConvViewProps } from '@deepseek-ai/dsh-client-ui-conversation/client';
+import type { InjectFace, PropsLocale } from '@deepseek-ai/dsh-client-ui-slots';
+import { type StudioApiInjected } from './api.ts';
+import { type AssetDraftContext } from './asset-drafts.ts';
+/** Full assets-view props: conversation-view runtime share & injected fetch & locale seat. */
+export type AssetsViewProps = ConvViewProps & InjectFace<StudioApiInjected> & PropsLocale<'studio-panel'> & {
+    refreshEpoch?: number;
+    draftContext?: AssetDraftContext | undefined;
+    onDraftStateChange?: (state: {
+        dirty: boolean;
+        busy: boolean;
+        discard: () => void;
+    }) => void;
+};
+export declare function AssetsView({ fetchStudioApi, postStudioApi, t, refreshEpoch, draftContext, onDraftStateChange }: AssetsViewProps): import("react").JSX.Element;

package/packages/studio-panel/lib/types/client/BenchmarkView.d.ts

@@ -0,0 +1,9 @@
+import type { ConvViewProps } from '@deepseek-ai/dsh-client-ui-conversation/client';
+import type { InjectFace, PropsLocale } from '@deepseek-ai/dsh-client-ui-slots';
+import type { StudioApiInjected } from './api.ts';
+type BenchmarkViewProps = ConvViewProps & InjectFace<StudioApiInjected> & PropsLocale<'studio-panel'> & {
+    initialRunId?: string;
+    refreshEpoch?: number;
+};
+export declare function BenchmarkView({ fetchStudioApi, postStudioApi, t, initialRunId, refreshEpoch }: BenchmarkViewProps): import("react").JSX.Element;
+export {};

package/packages/studio-panel/lib/types/client/ContinuousReader.d.ts

@@ -0,0 +1,13 @@
+import type { StudioApiInjected } from './api.ts';
+import type { ChapterSummary } from './WorkbenchStore.ts';
+import type { PropsLocale } from '@deepseek-ai/dsh-client-ui-slots';
+export interface ContinuousReaderProps extends PropsLocale<'studio-panel'> {
+    chapters: readonly ChapterSummary[];
+    activePath: string;
+    activeOccurrenceId: string;
+    readingOrderRevision: string;
+    fetchStudioApi: StudioApiInjected['fetchStudioApi'];
+    onOpenChapter: (path: string, occurrenceId: string) => void;
+}
+/** Read-only, revision-labelled manuscript view over immutable reading occurrences. */
+export declare function ContinuousReader({ chapters, activePath, activeOccurrenceId, readingOrderRevision, fetchStudioApi, onOpenChapter, t, }: ContinuousReaderProps): import("react").JSX.Element;

package/packages/studio-panel/lib/types/client/CreationView.d.ts

@@ -0,0 +1,6 @@
+import type { ConvViewProps } from '@deepseek-ai/dsh-client-ui-conversation/client';
+import type { InjectFace, PropsLocale } from '@deepseek-ai/dsh-client-ui-slots';
+import { type StudioApiInjected } from './api.ts';
+export type CreationViewProps = ConvViewProps & InjectFace<StudioApiInjected> & PropsLocale<'studio-panel'>;
+/** Native manuscript workbench: chapter rail, local Vditor editor and inspector. */
+export declare function CreationView(props: CreationViewProps): import("react").JSX.Element;

package/packages/studio-panel/lib/types/client/DagCanvas.d.ts

@@ -0,0 +1,11 @@
+import 'dsh-react-flow-style';
+import type { PropsLocale } from '@deepseek-ai/dsh-client-ui-slots';
+import type { StudioApiInjected } from './api.ts';
+interface ReviewDagViewProps {
+    fetchStudioApi: StudioApiInjected['fetchStudioApi'];
+    postStudioApi: StudioApiInjected['postStudioApi'];
+    kind: 'review' | 'delivery';
+    t: PropsLocale<'studio-panel'>['t'];
+}
+export declare function ReviewDagView({ fetchStudioApi, postStudioApi, kind, t }: ReviewDagViewProps): import("react").JSX.Element;
+export {};

package/packages/studio-panel/lib/types/client/DiscardDraftDialog.d.ts

@@ -0,0 +1,8 @@
+import type { StudioPanelKey } from './locales.ts';
+export interface DiscardDraftDialogProps {
+    onKeep: () => void;
+    onDiscard: () => void;
+    t: (key: StudioPanelKey) => string;
+}
+/** Mount while a navigation action is waiting for the draft decision. */
+export declare function DiscardDraftDialog({ onKeep, onDiscard, t }: DiscardDraftDialogProps): import("react").JSX.Element;

package/packages/studio-panel/lib/types/client/DomainToolCard.d.ts

@@ -0,0 +1,9 @@
+import type { ToolCallViewProps } from '@deepseek-ai/dsh-client-ui-tool/client';
+import type { PropsLocale } from '@deepseek-ai/dsh-client-ui-slots';
+export type ToolFamily = 'status' | 'context' | 'manuscript' | 'revision' | 'task' | 'search' | 'asset' | 'outline';
+type CardProps = ToolCallViewProps & PropsLocale<'studio-panel'> & {
+    family: ToolFamily;
+};
+export declare function DomainToolCard({ block, callId, toolName, family, openFile, t }: CardProps): import("react").JSX.Element;
+export declare function createDomainToolCard(family: ToolFamily): (props: ToolCallViewProps & PropsLocale<"studio-panel">) => import("react").JSX.Element;
+export {};

package/packages/studio-panel/lib/types/client/GraphView.d.ts

@@ -0,0 +1,46 @@
+/**
+ * Graph view (图谱): OpenWrite continuity data as SVG and React Flow — the
+ * foreshadowing board (layered by 主线/支线/彩蛋, ordered by target chapter)
+ * and the interactive character/world relationship graph (circular seed layout).
+ * Read-only.
+ *
+ * Wire shape (verified against OpenWrite tools/novel_service.py continuity()
+ * + models/foreshadowing.py + tools/world_query.py get_relations_topology):
+ * GET /api/continuity answers WITHOUT an envelope —
+ * {
+ *   truth: {...},
+ *   foreshadowing: {
+ *     // PENDING nodes only (get_pending_nodes: status 埋伏/待收, weight >= 1);
+ *     // the stored DAG's edges are NOT exposed by this endpoint.
+ *     nodes: [{ id, content, weight (1-10), layer (主线/支线/彩蛋),
+ *               status (埋伏/待收), created_at, target_arc, target_section,
+ *               target_chapter, tags }],
+ *     total, by_status, by_layer, by_weight,
+ *   },
+ *   foreshadowing_validation: { valid, errors },
+ *   relationship_graph: {
+ *     nodes: [{ id, label, kind (character/faction/place/concept/.../unknown),
+ *               type, status, description, unresolved }],
+ *     edges: [{ id, source, target, label, kind, origin, confirmed,
+ *               source_label }],
+ *     truncated, ...
+ *   },
+ *   // 事实账本: three markdown DOCUMENTS (truth_manager.py TruthFiles), not
+ *   // structured rows — rendered as-is with MarkdownText.
+ *   truth: { current_state: string, ledger: string, relationships: string },
+ *   // 章节工作流 (workflow_scheduler.py): stages carry
+ *   // status pending/running/completed/failed/skipped.
+ *   workflows: [{ chapter_id, current_stage, error,
+ *                 stages: [{ name, status, message }] }],
+ * }
+ *
+ * Sections (toolbar chips): 伏笔 (board + DAG validation errors), 关系图
+ * (kind-filtered interactive canvas), 事实账本 (the three truth documents), 工作流
+ * (per-chapter pipeline stages). All read-only.
+ */
+import type { ConvViewProps } from '@deepseek-ai/dsh-client-ui-conversation/client';
+import type { InjectFace, PropsLocale } from '@deepseek-ai/dsh-client-ui-slots';
+import type { StudioApiInjected } from './api.ts';
+/** Full graph-view props: conversation-view runtime share & injected fetch & locale seat. */
+export type GraphViewProps = ConvViewProps & InjectFace<StudioApiInjected> & PropsLocale<'studio-panel'>;
+export declare function GraphView({ fetchStudioApi, postStudioApi, t }: GraphViewProps): import("react").JSX.Element;

package/packages/studio-panel/lib/types/client/HeaderChrome.d.ts

@@ -0,0 +1,18 @@
+import type { PropsLocale, PropsRuntime } from '@deepseek-ai/dsh-client-ui-slots';
+import type { StudioApiInjected } from './api.ts';
+import { type StudioPanelInjected } from './workspace-context.ts';
+type HeaderProps = PropsRuntime<'conversation.session.header.actions'> & PropsLocale<'studio-panel'>;
+type UtilityProps = PropsRuntime<'conversation.session.header.utilities'> & PropsLocale<'studio-panel'> & Pick<StudioApiInjected, 'postStudioApi'>;
+type ContextChipProps = PropsRuntime<'conversation.input.left'> & PropsLocale<'studio-panel'> & Pick<StudioPanelInjected, 'postStudioApi' | 'workspaces' | 'sessions'>;
+export declare function HeaderProjectStatus({ t }: HeaderProps): import("react").JSX.Element;
+export declare function HeaderUtilities({ postStudioApi, t }: UtilityProps): import("react").JSX.Element;
+/**
+ * Input-bar Workspace chip: reflects the session's dsh Workspace binding and
+ * owns binding it into the WorkbenchStore context barrier. When the binding
+ * needs action it is a button opening a small popover: an unbound session
+ * gets the directory-pick attach flow; a bound-but-uninitialized workspace
+ * gets the inline init form (novel id + title, pinned to the canonical
+ * path). An initialized workspace renders read-only.
+ */
+export declare function WorkspaceContextChip(props: ContextChipProps): import("react").JSX.Element;
+export {};

package/packages/studio-panel/lib/types/client/LaunchOpenWrite.d.ts

@@ -0,0 +1,13 @@
+interface Status {
+    phase: string;
+    message?: string;
+    error?: string;
+    downloadedBytes?: number;
+    totalBytes?: number;
+}
+export declare function runtimeAction(action: string): Promise<Status>;
+export declare function LaunchOpenWrite({ wide, openWorkspace }: {
+    wide: boolean;
+    openWorkspace: (path?: string) => Promise<boolean>;
+}): import("react").JSX.Element;
+export {};

package/packages/studio-panel/lib/types/client/LibraryView.d.ts

@@ -0,0 +1,6 @@
+import type { ConvViewProps } from '@deepseek-ai/dsh-client-ui-conversation/client';
+import type { InjectFace, PropsLocale } from '@deepseek-ai/dsh-client-ui-slots';
+import type { StudioApiInjected } from './api.ts';
+export type LibraryViewProps = ConvViewProps & InjectFace<StudioApiInjected> & PropsLocale<'studio-panel'>;
+/** One native library shell over canon, outline, continuity, research and search. */
+export declare function LibraryView(props: LibraryViewProps): import("react").JSX.Element;

package/packages/studio-panel/lib/types/client/MarkdownText.d.ts

@@ -0,0 +1,3 @@
+import { MarkdownText as HostMarkdown } from '@deepseek-ai/dsh-client-ui-primitives';
+import type { ComponentProps } from 'react';
+export declare function MarkdownText(props: Omit<ComponentProps<typeof HostMarkdown>, 'labels'>): import("react").JSX.Element;

package/packages/studio-panel/lib/types/client/ModelView.d.ts

@@ -0,0 +1,9 @@
+import type { ConvViewProps } from "@deepseek-ai/dsh-client-ui-conversation/client";
+import type { InjectFace, PropsLocale } from "@deepseek-ai/dsh-client-ui-slots";
+import { type StudioApiInjected } from "./api.ts";
+export type ModelNavigationGuard = (navigate: () => void) => void;
+type Props = ConvViewProps & InjectFace<StudioApiInjected> & PropsLocale<"studio-panel"> & {
+    onNavigationGuardChange?: (guard: ModelNavigationGuard | null) => void;
+};
+export declare function ModelView({ fetchStudioApi, postStudioApi, t, onNavigationGuardChange }: Props): import("react").JSX.Element;
+export {};

package/packages/studio-panel/lib/types/client/OperationsView.d.ts

@@ -0,0 +1,6 @@
+import type { ConvViewProps } from '@deepseek-ai/dsh-client-ui-conversation/client';
+import type { InjectFace, PropsLocale } from '@deepseek-ai/dsh-client-ui-slots';
+import { type StudioPanelInjected } from './workspace-context.ts';
+export type OperationsViewProps = ConvViewProps & InjectFace<StudioPanelInjected> & PropsLocale<'studio-panel'>;
+/** Background jobs plus the less frequent transfer/maintenance commands. */
+export declare function OperationsView(props: OperationsViewProps): import("react").JSX.Element;

package/packages/studio-panel/lib/types/client/OutlinePlans.d.ts

@@ -0,0 +1,37 @@
+/**
+ * 预演大纲数据面（供 OutlineView 以“树内接续”方式渲染）。
+ *
+ * 每套预演 = 一棵和正式大纲一样语法的迷你树（卷/篇/节/章），并携带“构思”。
+ * OutlineView 把它的顶层节点接到正式大纲当前卷的末尾——除颜色外与正式树完全一致。
+ */
+export interface PlanTreeNode {
+    id: string;
+    kind: 'act' | 'section' | 'chapter';
+    label: string;
+    title: string;
+    summary: string;
+    children: PlanTreeNode[];
+}
+export interface PlanInfo {
+    id: string;
+    kind: 'rolling' | 'branch';
+    label: string;
+    idea: string;
+    meta: string;
+    nodes: PlanTreeNode[];
+    /** rolling 草案专用：正文 / revision / state（供编辑、删除、并入） */
+    proposal?: string;
+    revision?: string;
+    state?: string;
+}
+export declare const PLAN_PALETTES: {
+    accent: string;
+    bar: string;
+    bg: string;
+}[];
+export declare function planColor(index: number): {
+    accent: string;
+    bar: string;
+    bg: string;
+};
+export declare function loadPlans(postStudioApi: (path: string, body: unknown) => Promise<unknown>): Promise<PlanInfo[]>;

package/packages/studio-panel/lib/types/client/OutlineView.d.ts

@@ -0,0 +1,29 @@
+/**
+ * Outline view (大纲): the OpenWrite outline tree rendered natively — AND
+ * editable in place, Obsidian-style: titles and body blocks render as
+ * borderless inputs that look identical to plain text; click into them and
+ * type. Commits ride the revision-guarded atomic tree editor
+ * (POST /api/outline/edit; operations verified against OpenWrite
+ * tools/outline_tree.py mutate_outline_structure):
+ *
+ * - title input  blur/Enter → rename        (chapters must carry a number)
+ * - body textarea blur       → update_summary (updates prose synopsis, preserving metadata)
+ * - hover buttons → add_child / add_after / delete (server renumbers on delete)
+ * - toolbar      → add a top-level volume (add_child with empty node_id)
+ *
+ * Commit semantics: optimistic local patch + silent revision bump on success
+ * (no tree re-render — focus and scroll survive); 409 reloads the tree and
+ * asks for a retry; other failures revert the field and toast the server
+ * message. A chapter rename changes its node id server-side, so a follow-up
+ * op on the same node may 404 — the error path reloads and the user retries.
+ *
+ * Wire shape (verified against OpenWrite tools/outline_tree.py
+ * build_outline_structure): GET /api/outline answers WITHOUT an envelope —
+ * { path, revision, roots, counts, drafted_chapters, recommendation }.
+ */
+import type { ConvViewProps } from '@deepseek-ai/dsh-client-ui-conversation/client';
+import type { InjectFace, PropsLocale } from '@deepseek-ai/dsh-client-ui-slots';
+import { type StudioApiInjected } from './api.ts';
+/** Full outline-view props: conversation-view runtime share & injected fetch & locale seat. */
+export type OutlineViewProps = ConvViewProps & InjectFace<StudioApiInjected> & PropsLocale<'studio-panel'>;
+export declare function OutlineView({ fetchStudioApi, postStudioApi, t }: OutlineViewProps): import("react").JSX.Element;

package/packages/studio-panel/lib/types/client/ResearchView.d.ts

@@ -0,0 +1,7 @@
+import type { ConvViewProps } from '@deepseek-ai/dsh-client-ui-conversation/client';
+import type { InjectFace, PropsLocale } from '@deepseek-ai/dsh-client-ui-slots';
+import type { StudioApiInjected } from './api.ts';
+export type ResearchViewProps = ConvViewProps & InjectFace<StudioApiInjected> & PropsLocale<'studio-panel'> & {
+    initialReportId?: string;
+};
+export declare function ResearchView({ fetchStudioApi, postStudioApi, t, initialReportId }: ResearchViewProps): import("react").JSX.Element;

package/packages/studio-panel/lib/types/client/ReviewCard.d.ts

@@ -0,0 +1,28 @@
+/**
+ * novel_review_chapter toolview: the OpenWrite multi-dimensional chapter
+ * review as a readable report card. Registrant posture over the keyed
+ * tool.call.toolview hole — imports the slot contract only, never the chat
+ * domain (the bash-sample.tsx pattern).
+ *
+ * Wire shape (verified against OpenWrite tools/chapter_pipeline.py review
+ * stage + tools/review_store.py normalize_review_issues): the tool value is
+ * { result: { ok, chapter_id, passed, score, review_v2, issues: <count int>,
+ * summary, issue_details: [...], strict, dimensions, ... }, workspace: {...} }.
+ * Review v2 is authoritative for quality score, coverage, gate, and delivery.
+ * Issue review severity (critical/warning/info) is independent from revision
+ * priority (blocker/high/medium/low).
+ *
+ * Anything unexpected (running call, non-JSON output, missing fields) falls
+ * back to the raw pretty-JSON card — the review text is never swallowed.
+ */
+import type { ToolCallViewProps } from '@deepseek-ai/dsh-client-ui-tool/client';
+import type { PropsLocale } from '@deepseek-ai/dsh-client-ui-slots';
+/** Review card props: the toolview runtime share plus the standard locale seat. */
+type ReviewCardProps = ToolCallViewProps & PropsLocale<'studio-panel'>;
+/**
+ * The review card: collapsed summary row (tool · chapter · score · verdict)
+ * toggling the expanded report — verdict banner, summary, then issue groups
+ * with severity badges, quotes, and suggestions.
+ */
+export declare function NovelReviewCard({ block, t }: ReviewCardProps): import("react").JSX.Element;
+export {};

package/packages/studio-panel/lib/types/client/SceneWorkbench.d.ts

@@ -0,0 +1,55 @@
+import { type StudioApiInjected } from './api.ts';
+type StructureStatus = 'absent' | 'current' | 'stale' | 'ambiguous';
+interface SceneIssue {
+    key: string;
+    message: string;
+    code: string;
+    sceneId: string;
+    chapterId: string;
+}
+interface SceneRecord {
+    id: string;
+    chapterId: string;
+    chapterTitle: string;
+    title: string;
+    storyTimeSortKey: string;
+    storyTimeLabel: string;
+    characters: string[];
+    locations: string[];
+    events: string[];
+    revision: string;
+    chapterRevision: string;
+    readingIndex: number;
+    storyTimeIndex: number;
+    chapterIndex: number;
+}
+interface SceneChapter {
+    id: string;
+    title: string;
+    revision: string;
+    sceneCount: number;
+}
+interface SceneStructure {
+    schemaVersion: string;
+    status: StructureStatus;
+    revision: string;
+    scenes: SceneRecord[];
+    chapters: SceneChapter[];
+    issues: SceneIssue[];
+    plannedMissingChapters: number;
+    mutationAllowed: boolean;
+}
+interface MigrationPreview {
+    schemaVersion: string;
+    revision: string;
+    rows: string[];
+    issues: SceneIssue[];
+    canApply: boolean;
+}
+export type SceneWorkbenchProps = Pick<StudioApiInjected, 'fetchStudioApi' | 'postStudioApi'>;
+/** Normalize the scene envelope without turning planned-missing chapters into scenes. */
+export declare function parseSceneStructure(value: unknown): SceneStructure;
+export declare function parseMigrationPreview(value: unknown): MigrationPreview | null;
+/** Native scene-structure editor. All mutations are guarded by envelope and chapter revisions. */
+export declare function SceneWorkbench({ fetchStudioApi, postStudioApi }: SceneWorkbenchProps): import("react").JSX.Element;
+export {};

package/packages/studio-panel/lib/types/client/SearchView.d.ts

@@ -0,0 +1,33 @@
+/**
+ * Search view (搜索): native project search over the OpenWrite library —
+ * debounced query input + scope selector, results with the query highlighted
+ * in the snippet. Click-to-read: any result opens an inline preview pane
+ * (document via GET /api/document?path=…, hit line highlighted). GET-only;
+ * this is the panel's one interactive (non-mutating) view.
+ *
+ * Wire shape (verified against OpenWrite tools/studio_http.py do_GET +
+ * tools/studio_application.py search_project + tools/project_search.py
+ * ProjectSearchIndex.search + tools/library_catalog.py scopes):
+ * GET /api/search?q=<query>&scope=<scope>&limit=<n> answers WITHOUT an
+ * envelope —
+ * {
+ *   query, scope, scope_label,
+ *   results: [{ path, title, line, heading, snippet, scope, scope_label,
+ *               category, category_label, score, retrieval: [...], excerpt }],
+ *   indexed, engine (lightrag/literal-fallback/none),
+ *   warning, warning_code, retrieval_stats, index_updates, embedding,
+ * }
+ * GET /api/document?path=<p> answers WITHOUT an envelope —
+ * { path, title, content, version, revision, ... } (any project document:
+ * outline / manuscript chapters / character & world sources).
+ * Canonical scopes (library_catalog.py CANONICAL_SEARCH_SCOPES): all /
+ * outline / core / characters / settings / continuity / chapters / sources.
+ * The payload carries no match offsets, so highlighting re-matches the
+ * (server-normalized) query inside the snippet client-side.
+ */
+import type { ConvViewProps } from '@deepseek-ai/dsh-client-ui-conversation/client';
+import type { InjectFace, PropsLocale } from '@deepseek-ai/dsh-client-ui-slots';
+import { type StudioApiInjected } from './api.ts';
+/** Full search-view props: conversation-view runtime share & injected fetch & locale seat. */
+export type SearchViewProps = ConvViewProps & InjectFace<StudioApiInjected> & PropsLocale<'studio-panel'>;
+export declare function SearchView({ fetchStudioApi, postStudioApi, t }: SearchViewProps): import("react").JSX.Element;

package/packages/studio-panel/lib/types/client/TasksView.d.ts

@@ -0,0 +1,11 @@
+import type { ConvViewProps } from '@deepseek-ai/dsh-client-ui-conversation/client';
+import type { InjectFace, PropsLocale } from '@deepseek-ai/dsh-client-ui-slots';
+import type { StudioApiInjected } from './api.ts';
+export interface NavigationRequest {
+    view: 'benchmark' | 'research';
+    id: string;
+}
+export type TasksViewProps = ConvViewProps & InjectFace<StudioApiInjected> & PropsLocale<'studio-panel'> & {
+    onNavigate?: (target: NavigationRequest) => void;
+};
+export declare function TasksView({ fetchStudioApi, postStudioApi, t, onNavigate }: TasksViewProps): import("react").JSX.Element;

package/packages/studio-panel/lib/types/client/TransferWorkspaces.d.ts

@@ -0,0 +1,19 @@
+import { type Dispatch, type SetStateAction } from 'react';
+import type { OperationsViewProps } from './OperationsView.tsx';
+import type { StudioPanelInjected } from './workspace-context.ts';
+type TransferT = OperationsViewProps['t'];
+type Note = (message: string, bad?: boolean) => void;
+interface WorkspaceProps extends Pick<StudioPanelInjected, 'fetchStudioApi' | 'postStudioApi'> {
+    t: TransferT;
+    busy: string;
+    setBusy: Dispatch<SetStateAction<string>>;
+    say: Note;
+    workspaceReady: boolean;
+    tasksEpoch: number;
+    workspaceEpoch: number;
+}
+interface ArchiveWorkspaceProps extends WorkspaceProps, Pick<StudioPanelInjected, 'workspaces'> {
+}
+export declare function ManuscriptImportWorkspace(props: WorkspaceProps): import("react").JSX.Element;
+export declare function ProjectArchiveWorkspace(props: ArchiveWorkspaceProps): import("react").JSX.Element;
+export {};