dsh-folder-sidebar 0.0.0-stage → 0.17.0

package/cordis.patch.yml

@@ -0,0 +1,4 @@
+- insert:
+    - id: folder-sidebar
+      name: dsh-folder-sidebar
+      config: {}

package/icon.svg

@@ -0,0 +1,6 @@
+<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 64 64" role="img" aria-label="Folder Sidebar">
+  <rect x="4" y="4" width="56" height="56" rx="14" fill="#3f6be0"/>
+  <path d="M14 22h13l4 5h19a3 3 0 0 1 3 3v14a3 3 0 0 1-3 3H14a3 3 0 0 1-3-3V25a3 3 0 0 1 3-3Z"
+        fill="none" stroke="#ffffff" stroke-width="4" stroke-linejoin="round"/>
+  <path d="M24 36h16" stroke="#ffffff" stroke-width="3" stroke-linecap="round" opacity="0.85"/>
+</svg>

package/index.js

@@ -0,0 +1,93 @@
+/**
+ * Host half of dsh-folder-sidebar.
+ *
+ * The sidebar replacement is Client-only except for one fact the Client cannot
+ * derive: whether a Session's most recent turn failed or was interrupted. A
+ * Session summary carries no failure field, so this projection folds
+ * `turn/start` and `turn/end` into a small client-visible state per Session.
+ *
+ * The Client reads it from the sessions list snapshot
+ * (`projectionsBySession[id].values['folder-sidebar/turn']`) — the value is
+ * computed here and streamed, never folded in the browser.
+ */
+
+import { z } from 'zod'
+
+export const name = 'folder-sidebar'
+export const inject = ['sessionProjections']
+
+/** Must match the key the Client reads. */
+const KEY = 'folder-sidebar/turn'
+
+/** Bump when the folded state or its meaning changes; stale checkpoints drop. */
+const STATE_VERSION = 3
+
+const STATES = ['idle', 'running', 'completed', 'failed', 'interrupted', 'stopped']
+
+const StateSchema = z.object({
+  state: z.enum(STATES),
+  turn: z.number(),
+  /** When the current state began (epoch ms); the folder status picks the oldest. */
+  since: z.number(),
+  reason: z.string().optional(),
+})
+
+const ViewSchema = StateSchema
+
+const IDLE = { state: 'idle', turn: 0, since: 0 }
+
+/** Map one turn end onto the colour-relevant state. */
+function endedState(reason, turn, since) {
+  if (reason === null || typeof reason !== 'object') return { state: 'idle', turn, since }
+  switch (reason.kind) {
+    case 'completed':
+      return { state: 'completed', turn, since }
+    case 'forked':
+      return { state: 'idle', turn, since }
+    case 'error':
+      return { state: 'failed', turn, since, reason: reason.error?.code ?? 'error' }
+    case 'blocked':
+      return { state: 'failed', turn, since, reason: 'blocked' }
+    case 'max-tokens':
+      return { state: 'failed', turn, since, reason: 'max-tokens' }
+    case 'interrupted':
+      return { state: 'interrupted', turn, since }
+    case 'aborted': {
+      // A user stop is not a failure: the sidebar shows it in the neutral tone.
+      const kind = reason.reason?.kind
+      if (kind === 'user') return { state: 'stopped', turn, since }
+      return { state: 'interrupted', turn, since, reason: kind ?? 'aborted' }
+    }
+    default:
+      return { state: 'idle', turn, since }
+  }
+}
+
+export function apply(ctx) {
+  ctx.effect(() => ctx.sessionProjections.register({
+    key: KEY,
+    stateSchema: StateSchema,
+    stateVersion: STATE_VERSION,
+    init: () => IDLE,
+    apply(state, event) {
+      const time = typeof event.time === 'number' ? event.time : Date.now()
+      if (event.type === 'turn/start') {
+        const turn = event.data?.turn ?? state.turn
+        return { state: 'running', turn, since: time }
+      }
+      if (event.type !== 'turn/end') return state
+      return endedState(event.data?.reason, event.data?.turn ?? state.turn, time)
+    },
+    wire: {
+      viewSchema: ViewSchema,
+      view(state) {
+        return {
+          state: state.state,
+          turn: state.turn,
+          since: state.since,
+          ...(typeof state.reason === 'string' && state.reason !== '' ? { reason: state.reason } : {}),
+        }
+      },
+    },
+  }))
+}

package/locale/en.json

@@ -0,0 +1,6 @@
+{
+  "meta": {
+    "title": "Folder Sidebar",
+    "description": "Workspaces read as folders: click one to enter its session list instead of scrolling every workspace's sessions at once."
+  }
+}

package/locale/zh.json

@@ -0,0 +1,6 @@
+{
+  "meta": {
+    "title": "文件夹侧栏",
+    "description": "把工作区变成文件夹：侧栏只列工作区，点进去才显示该工作区的会话列表。"
+  }
+}

package/package.json

@@ -1,6 +1,69 @@
 {
   "name": "dsh-folder-sidebar",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
+  "version": "0.17.0",
+  "type": "module",
+  "description": "Folder-style sidebar for DeepSeek Harness: workspaces read as folders, and clicking one enters its session list instead of scrolling every workspace at once. · DSH 文件夹侧栏：工作区即文件夹，点进去只看该工作区的会话。",
+  "license": "MIT",
+  "author": "Aliboder",
+  "homepage": "https://github.com/Aliboder/dsh-folder-sidebar#readme",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/Aliboder/dsh-folder-sidebar.git"
+  },
+  "bugs": {
+    "url": "https://github.com/Aliboder/dsh-folder-sidebar/issues"
+  },
+  "keywords": [
+    "dsh",
+    "deepseek-harness",
+    "dsh-plugin",
+    "cordis",
+    "sidebar",
+    "workspace",
+    "sessions"
+  ],
+  "engines": {
+    "node": ">=20",
+    "dsh": ">=0.2.0-rc.2 <0.2.1-0 || >=0.2.1-0 <0.3.0-0"
+  },
+  "dependencies": {
+    "zod": "^4.6.5"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "exports": {
+    ".": "./index.js",
+    "./client": "./client.js",
+    "./locale/*.json": "./locale/*.json",
+    "./icon": "./icon.svg",
+    "./package.json": "./package.json"
+  },
+  "files": [
+    "index.js",
+    "client.js",
+    "cordis.patch.yml",
+    "locale/*.json",
+    "icon.svg",
+    "README.md",
+    "LICENSE",
+    "CHANGELOG.md"
+  ],
+  "dsh": {
+    "bundle": {
+      "patch": "./cordis.patch.yml"
+    },
+    "client": {
+      "platform": "web",
+      "immediately": true,
+      "inject": [
+        "@deepseek-ai/dsh-client-ui-conversation"
+      ]
+    }
+  },
+  "scripts": {
+    "test": "node test/smoke.test.mjs && node test/projection.test.mjs && node test/logic.test.mjs",
+    "check": "node --check index.js && node --check client.js",
+    "pack:check": "npm pack --dry-run"
+  }
 }