@yadsh/dsh-draft-sessions 0.2.0

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

@@ -0,0 +1,40 @@
+import { Service, type Context } from "@deepseek-ai/cordis";
+import type { SessionId } from "@deepseek-ai/dsh-client-runtime/client";
+import type { UpdateDraftRequest } from "../shared/types.js";
+import type { DraftSession } from "../shared/types.js";
+type DraftListRemote = {
+    list(request: {
+        workspaceId?: string;
+    }): Promise<{
+        ok: true;
+        value: DraftSession[];
+    } | {
+        ok: false;
+        error: {
+            message: string;
+        };
+    }>;
+};
+/** Observable Host-backed draft list used by the sidebar contribution. */
+export declare class DraftSidebarSource extends Service {
+    private readonly drafts;
+    private snapshot;
+    private shellSnapshot;
+    private readonly listeners;
+    private generation;
+    constructor(ctx: Context, drafts?: DraftListRemote);
+    getSnapshot: () => readonly DraftSession[];
+    /** Stable observable snapshot of blank Session shells owned by drafts. */
+    getShellSnapshot: () => ReadonlySet<SessionId>;
+    subscribe: (listener: () => void) => (() => void);
+    refresh(): Promise<readonly DraftSession[]>;
+    accept(draft: DraftSession): void;
+    remove(draftId: string): void;
+    private publish;
+}
+/** Collect the blank execution Session ids owned by drafts. */
+export declare function draftShellSessionIds(drafts: readonly DraftSession[]): ReadonlySet<SessionId>;
+/** Build a stable, zero-based optimistic reorder update set. */
+export declare function planDraftReorder(drafts: readonly DraftSession[], draftId: string, beforeDraftId?: string): UpdateDraftRequest[];
+export {};
+//# sourceMappingURL=sidebar.d.ts.map

package/lib/types/client/workspace-contribution.d.ts

@@ -0,0 +1,25 @@
+import type { Context } from "@deepseek-ai/cordis";
+import type { SessionListState, WorkspaceListState } from "@deepseek-ai/dsh-client-runtime/client";
+import { type FC } from "react";
+import type { DraftSession } from "../shared/types.js";
+import { type DraftSidebarSource } from "./sidebar.js";
+type SelectorHook<State> = <Selected>(selector: (state: State) => Selected) => Selected;
+interface DraftContributionProps {
+    readonly wide: boolean;
+    readonly surface?: "inline" | "tab" | "popover";
+    readonly useDrafts: SelectorHook<readonly DraftSession[]>;
+    readonly useSessions: SelectorHook<SessionListState>;
+    readonly useWorkspaces: SelectorHook<WorkspaceListState>;
+}
+/** Native sidebar-tab cooperation protocol shared by ecosystem plugins. */
+export declare const NATIVE_TABS_KEY = "__dshNativeTabs";
+/** Build the additive draft rows while leaving the workspace browser intact. */
+export declare function createDraftWorkspaceContribution(ctx: Context, source: DraftSidebarSource): FC<DraftContributionProps>;
+/**
+ * Cooperate with an ecosystem native-tab host when present and otherwise use
+ * the stock additive footer seat. The workspace-browser single slot remains
+ * owned by ui-workspace, Archive Manager, or whichever browser is active.
+ */
+export declare function activateWorkspaceContribution(ctx: Context, source: DraftSidebarSource): "activated";
+export {};
+//# sourceMappingURL=workspace-contribution.d.ts.map

package/lib/types/host/errors.d.ts

@@ -0,0 +1,7 @@
+export type DraftStoreErrorCode = "DRAFT_NOT_FOUND" | "DRAFT_STALE_REVISION" | "DRAFT_LIMIT_REACHED" | "DRAFT_INVALID_INPUT" | "DRAFT_STORAGE_INVALID";
+/** Stable domain failure raised by DraftStore and exposed by the Host service. */
+export declare class DraftStoreError extends Error {
+    readonly code: DraftStoreErrorCode;
+    constructor(message: string, code: DraftStoreErrorCode);
+}
+//# sourceMappingURL=errors.d.ts.map

package/lib/types/host/schema.d.ts

@@ -0,0 +1,40 @@
+import { z } from "zod";
+export declare const draftStateSchema: z.ZodUnion<readonly [z.ZodLiteral<"draft">, z.ZodLiteral<"materializing">, z.ZodLiteral<"ready">, z.ZodLiteral<"converting">, z.ZodLiteral<"error">]>;
+export declare const draftSessionSchema: z.ZodObject<{
+    version: z.ZodLiteral<1>;
+    id: z.ZodString;
+    sessionId: z.ZodNullable<z.ZodString>;
+    workspaceId: z.ZodString;
+    workspacePath: z.ZodOptional<z.ZodString>;
+    text: z.ZodString;
+    title: z.ZodOptional<z.ZodString>;
+    createdAt: z.ZodNumber;
+    updatedAt: z.ZodNumber;
+    order: z.ZodNumber;
+    pinned: z.ZodOptional<z.ZodBoolean>;
+    agentPresetId: z.ZodOptional<z.ZodString>;
+    state: z.ZodUnion<readonly [z.ZodLiteral<"draft">, z.ZodLiteral<"materializing">, z.ZodLiteral<"ready">, z.ZodLiteral<"converting">, z.ZodLiteral<"error">]>;
+    lastError: z.ZodOptional<z.ZodString>;
+    revision: z.ZodNumber;
+}, z.core.$strict>;
+export declare const draftFileSchema: z.ZodObject<{
+    version: z.ZodLiteral<1>;
+    drafts: z.ZodArray<z.ZodObject<{
+        version: z.ZodLiteral<1>;
+        id: z.ZodString;
+        sessionId: z.ZodNullable<z.ZodString>;
+        workspaceId: z.ZodString;
+        workspacePath: z.ZodOptional<z.ZodString>;
+        text: z.ZodString;
+        title: z.ZodOptional<z.ZodString>;
+        createdAt: z.ZodNumber;
+        updatedAt: z.ZodNumber;
+        order: z.ZodNumber;
+        pinned: z.ZodOptional<z.ZodBoolean>;
+        agentPresetId: z.ZodOptional<z.ZodString>;
+        state: z.ZodUnion<readonly [z.ZodLiteral<"draft">, z.ZodLiteral<"materializing">, z.ZodLiteral<"ready">, z.ZodLiteral<"converting">, z.ZodLiteral<"error">]>;
+        lastError: z.ZodOptional<z.ZodString>;
+        revision: z.ZodNumber;
+    }, z.core.$strict>>;
+}, z.core.$strict>;
+//# sourceMappingURL=schema.d.ts.map

package/lib/types/host/store.d.ts

@@ -0,0 +1,28 @@
+import type { CreateDraftRequest, DeleteDraftRequest, DraftSession, ListDraftsRequest, RebindDraftRequest, UpdateDraftRequest } from "../shared/types.js";
+export interface DraftStoreOptions {
+    readonly storagePath?: string;
+    readonly maxDraftsPerWorkspace?: number;
+    readonly now?: () => number;
+    readonly id?: () => string;
+}
+/** Serialized, atomically persisted authority for unsent draft sessions. */
+export declare class DraftStore {
+    readonly path: string;
+    readonly maxDraftsPerWorkspace: number;
+    private readonly now;
+    private readonly id;
+    private drafts;
+    private queue;
+    constructor(options?: DraftStoreOptions);
+    list(request?: ListDraftsRequest): Promise<DraftSession[]>;
+    create(request: CreateDraftRequest): Promise<DraftSession>;
+    update(request: UpdateDraftRequest): Promise<DraftSession>;
+    delete(request: DeleteDraftRequest): Promise<boolean>;
+    rebind(request: RebindDraftRequest): Promise<DraftSession>;
+    private enqueue;
+    private loaded;
+    private find;
+    private expectRevision;
+    private commit;
+}
+//# sourceMappingURL=store.d.ts.map

package/lib/types/index.d.ts

@@ -0,0 +1,33 @@
+import type { Context } from "@deepseek-ai/cordis";
+import z from "@deepseek-ai/schemastery";
+import { TypertRemoteService } from "@deepseek-ai/dsh-typert-protocol";
+import type { CreateDraftRequest, DeleteDraftRequest, DeleteDraftResult, DraftSession, ListDraftsRequest, RebindDraftRequest, UpdateDraftRequest } from "./shared/types.js";
+import { DraftStore } from "./host/store.js";
+export interface Config {
+    /** Absolute or cwd-relative JSON storage path; blank uses $DSH_HOME. */
+    readonly storagePath?: string;
+    /** Per-workspace safety limit. */
+    readonly maxDraftsPerWorkspace?: number;
+}
+declare module "@deepseek-ai/cordis" {
+    interface Context {
+        draftSessions: DraftSessionsService;
+    }
+}
+/** Host service and Typert Remote boundary for persistent draft records. */
+export declare class DraftSessionsService extends TypertRemoteService {
+    static Config: z<Config>;
+    readonly store: DraftStore;
+    constructor(ctx: Context, config?: Config);
+    list(request: ListDraftsRequest): Promise<DraftSession[]>;
+    create(request: CreateDraftRequest): Promise<DraftSession>;
+    update(request: UpdateDraftRequest): Promise<DraftSession>;
+    delete(request: DeleteDraftRequest): Promise<DeleteDraftResult>;
+    rebind(request: RebindDraftRequest): Promise<DraftSession>;
+}
+export { DraftStoreError } from "./host/errors.js";
+export { DraftStore } from "./host/store.js";
+export * from "./shared/constants.js";
+export * from "./shared/types.js";
+export default DraftSessionsService;
+//# sourceMappingURL=index.d.ts.map

package/lib/types/remote.d.ts

@@ -0,0 +1,20 @@
+import type { InvocationDescriptor, RemoteResult, TypertRemoteNamespace } from "@deepseek-ai/dsh-typert-protocol";
+import type { CreateDraftRequest, DeleteDraftRequest, DeleteDraftResult, DraftSession, ListDraftsRequest, RebindDraftRequest, UpdateDraftRequest } from "./shared/types.js";
+declare module "@deepseek-ai/dsh-typert-protocol" {
+    interface TypertRemoteMap {
+        "draftSessions/list": (request: ListDraftsRequest) => Promise<RemoteResult<DraftSession[]>>;
+        "draftSessions/create": (request: CreateDraftRequest) => Promise<RemoteResult<DraftSession>>;
+        "draftSessions/update": (request: UpdateDraftRequest) => Promise<RemoteResult<DraftSession>>;
+        "draftSessions/delete": (request: DeleteDraftRequest) => Promise<RemoteResult<DeleteDraftResult>>;
+        "draftSessions/rebind": (request: RebindDraftRequest) => Promise<RemoteResult<DraftSession>>;
+    }
+    interface TypertRemoteNamespaceMap {
+        draftSessions: TypertRemoteNamespace<"draftSessions">;
+    }
+}
+declare const draftSessionsRemote: {
+    package: string;
+    descriptors: InvocationDescriptor[];
+};
+export default draftSessionsRemote;
+//# sourceMappingURL=remote.d.ts.map

package/lib/types/shared/constants.d.ts

@@ -0,0 +1,9 @@
+/** On-disk format version. Bump only with an explicit migration. */
+export declare const DRAFT_FILE_VERSION: 1;
+/** Current draft record format. */
+export declare const DRAFT_SESSION_VERSION: 1;
+/** Default maximum number of drafts in a workspace. */
+export declare const DEFAULT_MAX_DRAFTS_PER_WORKSPACE = 50;
+/** Default maximum length of a title derived by consumers. */
+export declare const DEFAULT_TITLE_MAX_LENGTH = 80;
+//# sourceMappingURL=constants.d.ts.map

package/lib/types/shared/types.d.ts

@@ -0,0 +1,70 @@
+import { DRAFT_FILE_VERSION, DRAFT_SESSION_VERSION } from "./constants.js";
+export type DraftSessionState = "draft" | "materializing" | "ready" | "converting" | "error";
+/** Host-backed authority for one unsent future conversation. */
+export interface DraftSession {
+    readonly version: typeof DRAFT_SESSION_VERSION;
+    readonly id: string;
+    readonly sessionId: string | null;
+    readonly workspaceId: string;
+    readonly workspacePath?: string;
+    readonly text: string;
+    /** Explicit user title. Consumers derive a title from text when absent. */
+    readonly title?: string;
+    readonly createdAt: number;
+    readonly updatedAt: number;
+    readonly order: number;
+    readonly pinned?: boolean;
+    readonly agentPresetId?: string;
+    readonly state: DraftSessionState;
+    readonly lastError?: string;
+    /** Optimistic concurrency token, incremented after every mutation. */
+    readonly revision: number;
+}
+export interface DraftFile {
+    readonly version: typeof DRAFT_FILE_VERSION;
+    readonly drafts: readonly DraftSession[];
+}
+export interface ListDraftsRequest {
+    readonly workspaceId?: string;
+}
+export interface CreateDraftRequest {
+    readonly workspaceId: string;
+    readonly sessionId?: string | null;
+    readonly workspacePath?: string;
+    readonly text?: string;
+    readonly title?: string;
+    readonly order?: number;
+    readonly pinned?: boolean;
+    readonly agentPresetId?: string;
+}
+export interface UpdateDraftRequest {
+    readonly id: string;
+    readonly expectedRevision: number;
+    readonly text?: string;
+    /** `null` removes an explicit title and returns to first-line derivation. */
+    readonly title?: string | null;
+    readonly order?: number;
+    readonly pinned?: boolean;
+    /** `null` clears the preset binding. */
+    readonly agentPresetId?: string | null;
+    readonly state?: DraftSessionState;
+    /** `null` clears the last materialization error. */
+    readonly lastError?: string | null;
+}
+export interface DeleteDraftRequest {
+    readonly id: string;
+    readonly expectedRevision?: number;
+}
+export interface DeleteDraftResult {
+    readonly deleted: boolean;
+}
+export interface RebindDraftRequest {
+    readonly id: string;
+    readonly expectedRevision: number;
+    readonly sessionId: string | null;
+}
+/** First non-empty line, compacted for a session-like sidebar row. */
+export declare function deriveDraftTitle(text: string, maxLength?: number): string;
+/** Explicit title when present, otherwise a stable first-line projection. */
+export declare function displayDraftTitle(draft: Pick<DraftSession, "text" | "title">, maxLength?: number): string;
+//# sourceMappingURL=types.d.ts.map

package/package.json

@@ -0,0 +1,140 @@
+{
+  "name": "@yadsh/dsh-draft-sessions",
+  "version": "0.2.0",
+  "description": "Persistent unsent draft sessions for DeepSeek Harness",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/xarleyn/dsh-plugins.git",
+    "directory": "plugins/dsh-draft-sessions"
+  },
+  "homepage": "https://github.com/xarleyn/dsh-plugins/tree/main/plugins/dsh-draft-sessions#readme",
+  "bugs": {
+    "url": "https://github.com/xarleyn/dsh-plugins/issues"
+  },
+  "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"
+    },
+    "./remote": {
+      "types": "./lib/types/remote.d.ts",
+      "default": "./lib/remote.js"
+    },
+    "./types": {
+      "types": "./lib/types/shared/types.d.ts",
+      "default": "./lib/shared/types.js"
+    },
+    "./package.json": "./package.json"
+  },
+  "dsh": {
+    "bundle": {
+      "patch": "./cordis.patch.yml"
+    },
+    "client": {
+      "inject": [
+        "@deepseek-ai/dsh-api-gateway",
+        "@deepseek-ai/dsh-client-locale",
+        "@deepseek-ai/dsh-client-ui-conversation",
+        "@deepseek-ai/dsh-client-ui-sidebar"
+      ],
+      "platform": "web"
+    }
+  },
+  "files": [
+    "lib/**/*.js",
+    "lib/types/**/*.d.ts",
+    "cordis.patch.yml",
+    "compatibility.json",
+    "README.md",
+    "README.ru.md",
+    "README.zh-CN.md",
+    "docs/images/*.png",
+    "docs/images/*.jpg",
+    "SPEC.md",
+    "LICENSE"
+  ],
+  "scripts": {
+    "clean": "node -e \"require('node:fs').rmSync('lib', { recursive: true, force: true })\"",
+    "lint": "eslint src tests scripts",
+    "format": "prettier --check . --end-of-line auto",
+    "format:write": "prettier --write . --end-of-line auto",
+    "typecheck": "tsc --noEmit",
+    "test": "vitest run",
+    "test:coverage": "vitest run --coverage",
+    "smoke:packed": "node scripts/smoke-packed-dsh.mjs",
+    "e2e:browser": "node scripts/smoke-packed-dsh.mjs --browser",
+    "test:package": "node scripts/verify-package.mjs && node scripts/verify-client-bundle.mjs && node scripts/verify-compatibility.mjs",
+    "verify": "pnpm run test:package",
+    "build": "pnpm run clean && tsdown && tsc -p tsconfig.build.json",
+    "check": "pnpm run format && pnpm run typecheck && pnpm run test && pnpm run build && pnpm run test:package",
+    "prepare": "tsdown && tsc -p tsconfig.build.json",
+    "prepublishOnly": "pnpm run check"
+  },
+  "keywords": [
+    "deepseek",
+    "deepseek-harness",
+    "dsh",
+    "dsh-plugin",
+    "draft",
+    "sessions",
+    "web-ui"
+  ],
+  "license": "MIT",
+  "engines": {
+    "node": "^22.19.0 || >=24.0.0"
+  },
+  "peerDependencies": {
+    "@deepseek-ai/cordis": "catalog:dsh",
+    "@deepseek-ai/schemastery": "catalog:dsh",
+    "@deepseek-ai/dsh-api-gateway": "catalog:dsh",
+    "@deepseek-ai/dsh-client-connection": "catalog:dsh",
+    "@deepseek-ai/dsh-client-runtime": "catalog:dsh",
+    "@deepseek-ai/dsh-client-locale": "catalog:dsh",
+    "@deepseek-ai/dsh-client-ui-conversation": "catalog:dsh",
+    "@deepseek-ai/dsh-client-ui-sidebar": "catalog:dsh",
+    "@deepseek-ai/dsh-typert-protocol": "catalog:dsh",
+    "react": "^18.2.0",
+    "react-dom": "^18.2.0"
+  },
+  "dependencies": {
+    "zod": "^4.4.3"
+  },
+  "devDependencies": {
+    "@deepseek-ai/cordis": "catalog:dsh-dev",
+    "@deepseek-ai/schemastery": "catalog:dsh-dev",
+    "@deepseek-ai/dsh-api-gateway": "catalog:dsh-dev",
+    "@deepseek-ai/dsh-client-connection": "catalog:dsh-dev",
+    "@deepseek-ai/dsh-client-runtime": "catalog:dsh-dev",
+    "@deepseek-ai/dsh-client-locale": "catalog:dsh-dev",
+    "@deepseek-ai/dsh-client-ui-conversation": "catalog:dsh-dev",
+    "@deepseek-ai/dsh-client-ui-sidebar": "catalog:dsh-dev",
+    "@deepseek-ai/dsh-typert-protocol": "catalog:dsh-dev",
+    "@deepseek-ai/dsh-typert-registry": "catalog:dsh-dev",
+    "@testing-library/dom": "^10.4.1",
+    "@testing-library/react": "^16.3.0",
+    "@types/node": "catalog:tooling",
+    "@types/react": "catalog:frontend-dev",
+    "@types/react-dom": "catalog:frontend-dev",
+    "@vitest/coverage-v8": "^4.1.8",
+    "jsdom": "^26.1.0",
+    "playwright": "1.62.1",
+    "eslint": "catalog:tooling",
+    "prettier": "catalog:tooling",
+    "react": "catalog:frontend-dev",
+    "react-dom": "catalog:frontend-dev",
+    "tsdown": "catalog:tooling",
+    "typescript": "catalog:plugin-tooling",
+    "vitest": "catalog:tooling"
+  },
+  "publishConfig": {
+    "access": "public",
+    "registry": "https://registry.npmjs.org/"
+  }
+}