@deepseek-ai/dsh-api-workspace-controller 0.1.2-alpha.2

package/lib/types/types.d.ts

@@ -0,0 +1,132 @@
+/**
+ * Browser-safe request, result, and state-stream vocabulary for the Workspace
+ * and directory-picking Remote namespaces this package owns. The picking seam
+ * declares its own listing types, so they are re-exported here rather than
+ * restated: a browser consumer reads the very declaration the backend answers.
+ */
+import type { SessionId } from '@deepseek-ai/dsh-session/types';
+import type { WorkspaceId } from '@deepseek-ai/dsh-workspace/types';
+export type { WorkspaceId } from '@deepseek-ai/dsh-workspace/types';
+export type { DirectoryEntry, DirectoryListing } from '@deepseek-ai/dsh-host-directory-picker/types';
+/** One durable Workspace projected for browser consumers. */
+export interface WorkspaceView {
+    readonly workspaceId: WorkspaceId;
+    /** Canonical host directory path. */
+    readonly path: string;
+    /** User-visible title. */
+    readonly title: string;
+    /** Sessions accounted to this Workspace in manual order. */
+    readonly sessionIds: readonly SessionId[];
+    /** ISO-8601 creation instant. */
+    readonly createdAt: string;
+    /** ISO-8601 last-mutation instant. */
+    readonly updatedAt: string;
+}
+declare module '@deepseek-ai/dsh-typert-protocol' {
+    interface RemoteErrorDetailsMap {
+        /** The requested directory cannot back a Workspace. */
+        'workspace/invalid-path': {
+            readonly path: string;
+        };
+        /** Another Workspace already uses the requested name. */
+        'workspace/name-conflict': {
+            readonly name: string;
+        };
+        /** The Session or its anchor is not in the Workspace's manual order. */
+        'workspace/move-invalid': {
+            readonly workspaceId: WorkspaceId;
+            readonly sessionId: SessionId;
+            readonly beforeSessionId?: SessionId;
+        };
+        /** The verb needs an interaction the composed backend does not serve. */
+        'directory-picker/unavailable': {
+            readonly capability: string;
+        };
+        /** The target is not fully qualified, or the backend cannot list it. */
+        'directory-picker/unreadable': {
+            readonly path: string;
+        };
+        /** A child of that name is already there. */
+        'directory-picker/exists': {
+            readonly path: string;
+        };
+        /** The parent is not fully qualified, the name is not one segment, or creation failed. */
+        'directory-picker/create-failed': {
+            readonly path: string;
+        };
+    }
+}
+/** Existing directory requested for Workspace adoption. */
+export interface WorkspaceCreateRequest {
+    readonly path: string;
+}
+/** Created or previously registered Workspace. */
+export interface WorkspaceCreateValue {
+    readonly workspace: WorkspaceView;
+    readonly created: boolean;
+}
+/** Workspace title mutation. */
+export interface WorkspaceRenameRequest {
+    readonly workspaceId: WorkspaceId;
+    readonly title: string;
+}
+/** Workspace mutation returning the complete changed row. */
+export interface WorkspaceValue {
+    readonly workspace: WorkspaceView;
+}
+/** Workspace registration deletion. */
+export interface WorkspaceDeleteRequest {
+    readonly workspaceId: WorkspaceId;
+}
+/** Receipt after one Workspace registration is deleted. */
+export interface WorkspaceDeleteValue {
+    readonly deleted: true;
+}
+/** DOM-insertBefore-like Workspace order mutation. */
+export interface WorkspaceInsertBeforeRequest {
+    readonly workspaceId: WorkspaceId;
+    readonly beforeWorkspaceId?: WorkspaceId;
+}
+/** Complete Workspace registry order after a mutation. */
+export interface WorkspaceOrderValue {
+    readonly workspaceIds: readonly WorkspaceId[];
+}
+/** DOM-insertBefore-like Session membership order mutation. */
+export interface WorkspaceInsertSessionBeforeRequest {
+    readonly workspaceId: WorkspaceId;
+    readonly sessionId: SessionId;
+    readonly beforeSessionId?: SessionId;
+}
+/** Session requested for archival from Workspace grouping surfaces. */
+export interface WorkspaceArchiveSessionRequest {
+    readonly sessionId: SessionId;
+}
+/** Complete archived Session set after a mutation. */
+export interface WorkspaceArchiveValue {
+    readonly archivedSessionIds: readonly SessionId[];
+}
+/** Complete reconnect baseline for Workspace browser state. */
+export interface WorkspaceBaseline {
+    readonly items: readonly WorkspaceView[];
+    readonly archivedSessionIds: readonly SessionId[];
+}
+/** One ordered Workspace change after a generation's baseline. */
+export type WorkspaceFollowIncrement = {
+    readonly type: 'upsert';
+    readonly workspace: WorkspaceView;
+} | {
+    readonly type: 'remove';
+    readonly workspaceId: WorkspaceId;
+} | {
+    readonly type: 'order';
+    readonly workspaceIds: readonly WorkspaceId[];
+} | {
+    readonly type: 'archived';
+    readonly archivedSessionIds: readonly SessionId[];
+};
+/** Workspace state stream; every generation starts with exactly one baseline. */
+export type WorkspaceFollowFrame = {
+    readonly type: 'baseline';
+    readonly value: WorkspaceBaseline;
+} | WorkspaceFollowIncrement;
+//# sourceMappingURL=types.d.ts.map

package/lib/types/types.js

@@ -0,0 +1,8 @@
+/**
+ * Browser-safe request, result, and state-stream vocabulary for the Workspace
+ * and directory-picking Remote namespaces this package owns. The picking seam
+ * declares its own listing types, so they are re-exported here rather than
+ * restated: a browser consumer reads the very declaration the backend answers.
+ */
+export {};
+//# sourceMappingURL=types.js.map

package/package.json

@@ -0,0 +1,99 @@
+{
+  "name": "@deepseek-ai/dsh-api-workspace-controller",
+  "description": "Workspace Remote commands and reconnect-safe state transport",
+  "version": "0.1.2-alpha.2",
+  "publishConfig": {
+    "access": "public"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/deepseek-ai/deepseek-harness.git",
+    "directory": "packages/api/workspace-controller"
+  },
+  "type": "module",
+  "main": "lib/index.js",
+  "types": "lib/types/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./lib/types/index.d.ts",
+      "default": "./lib/index.js"
+    },
+    "./invariant": {
+      "types": "./lib/types/invariant.d.ts",
+      "default": "./lib/invariant.js"
+    },
+    "./types": {
+      "types": "./lib/types/types.d.ts",
+      "default": "./lib/types/types.js"
+    },
+    "./client": {
+      "types": "./lib/types/client/index.d.ts",
+      "default": "./lib/client.js"
+    },
+    "./typert": {
+      "types": "./lib/typert.host.d.ts",
+      "default": "./lib/typert.host.js"
+    },
+    "./remote": {
+      "types": "./lib/typert.remote-client.d.ts",
+      "default": "./lib/typert.remote-client.js"
+    },
+    "./src/*": "./src/*",
+    "./package.json": "./package.json"
+  },
+  "dsh": {
+    "client": {
+      "external": [
+        "@deepseek-ai/dsh-api-gateway/client"
+      ],
+      "inject": [
+        "@deepseek-ai/dsh-api-gateway",
+        "@deepseek-ai/dsh-client-connection"
+      ],
+      "platform": "web"
+    }
+  },
+  "files": [
+    "lib/index.js",
+    "lib/invariant.js",
+    "lib/client.js",
+    "lib/types/**/*.js",
+    "lib/types/**/*.d.ts",
+    "lib/typert.host.js",
+    "lib/typert.host.d.ts",
+    "lib/typert.remote-client.js",
+    "lib/typert.remote-client.d.ts"
+  ],
+  "license": "MIT",
+  "dependencies": {
+    "zod": "^4.4.3",
+    "@deepseek-ai/dsh-deque": "^0.1.2-alpha.2"
+  },
+  "peerDependencies": {
+    "@deepseek-ai/cordis": "^4.0.2",
+    "@deepseek-ai/dsh-api-gateway": "^0.1.2-alpha.2",
+    "@deepseek-ai/dsh-client-connection": "^0.1.2-alpha.2",
+    "@deepseek-ai/dsh-invariants": "^0.1.2-alpha.2",
+    "@deepseek-ai/dsh-session": "^0.1.2-alpha.2",
+    "@deepseek-ai/dsh-host-directory-picker": "^0.1.2-alpha.2",
+    "@deepseek-ai/dsh-storage-domain": "^0.1.2-alpha.2",
+    "@deepseek-ai/dsh-typert-protocol": "^0.1.2-alpha.2",
+    "@deepseek-ai/dsh-workspace": "^0.1.2-alpha.2"
+  },
+  "devDependencies": {
+    "@deepseek-ai/cordis": "^4.0.2",
+    "@deepseek-ai/dsh-client-connection": "^0.1.2-alpha.2",
+    "@deepseek-ai/dsh-client-store": "^0.1.2-alpha.2",
+    "@deepseek-ai/dsh-host-directory-picker": "^0.1.2-alpha.2",
+    "@deepseek-ai/dsh-api-gateway": "^0.1.2-alpha.2",
+    "@deepseek-ai/dsh-invariants": "^0.1.2-alpha.2",
+    "@deepseek-ai/dsh-session": "^0.1.2-alpha.2",
+    "@deepseek-ai/dsh-storage-domain": "^0.1.2-alpha.2",
+    "@deepseek-ai/dsh-workspace": "^0.1.2-alpha.2",
+    "@deepseek-ai/dsh-typert-protocol": "^0.1.2-alpha.2"
+  },
+  "scripts": {
+    "bundle": "tsdown",
+    "watch": "tsdown --watch"
+  }
+}