@benz-ai-x/dsh-md-preview 0.2.7 → 0.4.0

package/lib/types/index.d.ts

@@ -7,7 +7,7 @@ import type { Context } from '@deepseek-ai/cordis';
 import { type Config as ConfigType } from './config.ts';
 export { Config } from './config.ts';
 export type { Config as ConfigInterface } from './config.ts';
-export { DEFAULT_ALLOWED_EXTENSIONS, DEFAULT_MAX_BYTES } from './constants.ts';
+export { DEFAULT_ALLOWED_EXTENSIONS, DEFAULT_MAX_BYTES, DEFAULT_PREVIEW_EXTENSIONS } from './constants.ts';
 export { isAllowedExtension, MdPreviewService } from './remote.ts';
 export type { MdPreviewFile, MdPreviewFailureCode, MdPreviewReadRequest } from './protocol.ts';
 export { MD_PREVIEW_FAILURE_CODES } from './protocol.ts';

package/lib/types/protocol.d.ts

@@ -16,6 +16,22 @@ export interface MdPreviewWriteResult {
     /** Freshness token of the file after the write; guards the next save. */
     readonly fingerprint: string;
 }
+/** One directory entry of the workspace browser tree. */
+export interface MdPreviewEntry {
+    /** Entry basename as the fs layer reports it. */
+    readonly name: string;
+    /** Regular file, directory, or anything else. */
+    readonly type: 'file' | 'directory' | 'other';
+    /** Workspace-relative path of the entry (the tree's node identity). */
+    readonly path: string;
+}
+/** One workspace directory listing. */
+export interface MdPreviewListResult {
+    /** The requested path as the caller spelled it (blank = workspace root). */
+    readonly path: string;
+    /** Directory entries, folders first then alphabetical. */
+    readonly entries: readonly MdPreviewEntry[];
+}
 /** Stable failure codes carried by `RemoteError` across the wire. */
 export declare const MD_PREVIEW_FAILURE_CODES: readonly ["md-preview/bad-request", "md-preview/unknown-session", "md-preview/no-workspace", "md-preview/unsupported-extension", "md-preview/forbidden", "md-preview/not-found", "md-preview/too-large", "md-preview/conflict", "md-preview/unavailable"];
 /** One stable MdPreview failure code. */

package/lib/types/remote.d.ts

@@ -8,7 +8,7 @@ import type { Context } from '@deepseek-ai/cordis';
 import { TypertRemoteService } from '@deepseek-ai/dsh-typert-protocol';
 import type { SessionId } from '@deepseek-ai/dsh-session/types';
 import type { Config } from './config.ts';
-import type { MdPreviewFile, MdPreviewWriteResult } from './protocol.ts';
+import type { MdPreviewFile, MdPreviewListResult, MdPreviewWriteResult } from './protocol.ts';
 /** Whether a candidate extension passes the configured allowlist. */
 export declare function isAllowedExtension(path: string, allowedExtensions: readonly string[]): boolean;
 /**
@@ -50,6 +50,16 @@ export declare class MdPreviewService extends TypertRemoteService {
      * @throws RemoteError with a stable MdPreview failure code.
      */
     write(sessionId: SessionId, path: string, content: string, fingerprint: string | undefined, force: boolean, signal: AbortSignal): Promise<MdPreviewWriteResult>;
+    /**
+     * List one workspace directory for the browser face; folders sort first,
+     * then entries alphabetize by name. A blank path lists the workspace root.
+     * @param sessionId - owning session; its header cwd roots the listing.
+     * @param path - directory path as the tree spelled it; blank = root.
+     * @param signal - caller cancellation carried through every fs call.
+     * @returns the requested path with its workspace-relative entries.
+     * @throws RemoteError with a stable MdPreview failure code.
+     */
+    list(sessionId: SessionId, path: string, signal: AbortSignal): Promise<MdPreviewListResult>;
     /**
      * The shared authority preamble of the remote methods: resolve a path to a
      * live, contained, regular workspace file, or reject it with the stable
@@ -63,5 +73,17 @@ export declare class MdPreviewService extends TypertRemoteService {
      * @throws RemoteError with a stable MdPreview failure code.
      */
     private resolveWorkspaceTarget;
+    /**
+     * The authority middle shared by every method: session → workspace cwd →
+     * root resolve → target resolve (a blank path means the root itself) →
+     * containment. Extension and type checks belong to the callers.
+     * @param sessionId - owning session; its header cwd roots the resolution.
+     * @param path - requested path; blank spells the workspace root.
+     * @param signal - caller cancellation carried through every fs call.
+     * @param op - calling method name for diagnostic messages.
+     * @returns the resolved root, target, and the workspace cwd.
+     * @throws RemoteError with a stable MdPreview failure code.
+     */
+    private resolveContainedTarget;
 }
 //# sourceMappingURL=remote.d.ts.map

package/lib/types/typert/remote-client.d.ts

@@ -1,6 +1,6 @@
 import type { RemoteResult, TypertRemoteContribution } from '@deepseek-ai/dsh-typert-protocol';
 import type { SessionId } from '@deepseek-ai/dsh-session/types';
-import type { MdPreviewFile, MdPreviewWriteResult } from '../protocol.ts';
+import type { MdPreviewFile, MdPreviewListResult, MdPreviewWriteResult } from '../protocol.ts';
 /** Browser face of the mounted `mdPreview` Remote namespace. */
 export interface MdPreviewRemote {
     /** Read one previewable document of a session's workspace. */
@@ -11,6 +11,8 @@ export interface MdPreviewRemote {
      * overwrite unconditionally (the conflict prompt's override).
      */
     write(sessionId: SessionId, path: string, content: string, fingerprint?: string, force?: boolean, signal?: AbortSignal): Promise<RemoteResult<MdPreviewWriteResult>>;
+    /** List one workspace directory for the browser face (blank path = root). */
+    list(sessionId: SessionId, path: string, signal?: AbortSignal): Promise<RemoteResult<MdPreviewListResult>>;
 }
 declare module '@deepseek-ai/dsh-typert-protocol' {
     interface TypertRemoteNamespaceMap {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@benz-ai-x/dsh-md-preview",
-  "version": "0.2.7",
+  "version": "0.4.0",
   "description": "DSH markdown preview: clicking a markdown document in the conversation opens a rendered preview panel docked to the right of the chat.",
   "license": "MIT",
   "repository": {