dsh-agent-persona 0.1.0

package/lib/remote.d.ts

@@ -0,0 +1,25 @@
+/**
+ * What the browser half mounts: ctx.remote.$mount(RPC_REMOTE). The field set matches the shape that
+ * worked before this file was generated — an id per descriptor, a strict codec for the input, and an
+ * empty parameter list for the reads that take none.
+ */
+export declare const RPC_REMOTE: {
+    package: string;
+    descriptors: {
+        id: string;
+        service: string;
+        namespace: string;
+        method: any;
+        invocation: {
+            kind: string;
+        };
+        parameters: any;
+        result: {
+            mode: string;
+            typeSymbol: string;
+            schema: {
+                parse: any;
+            };
+        };
+    }[];
+};

package/lib/remote.js

@@ -0,0 +1,49 @@
+// 该文件由 scripts/generate-remote.mjs 生成，请勿手改（改 src/endpoints.ts 后重新生成）。
+const PKG = "dsh-agent-persona";
+const codec = (typeSymbol, parse) => ({
+    mode: "strict",
+    typeSymbol: `${PKG}#${typeSymbol}`,
+    schema: { parse },
+});
+const passthrough = (value) => value;
+const asInput = (value) => {
+    if (value === undefined || value === null)
+        return {};
+    if (typeof value !== "object" || Array.isArray(value))
+        throw new Error("input must be an object");
+    return value;
+};
+const withInput = () => [
+    { name: "input", wire: "input", source: "json", codec: codec("Input", asInput) },
+];
+const method = (name, parameters) => ({
+    id: `${PKG}#agentPersona/${name}`,
+    service: "agentPersona",
+    namespace: "agentPersona",
+    method: name,
+    invocation: { kind: "direct" },
+    parameters,
+    result: codec("View", passthrough),
+});
+/**
+ * What the browser half mounts: ctx.remote.$mount(RPC_REMOTE). The field set matches the shape that
+ * worked before this file was generated — an id per descriptor, a strict codec for the input, and an
+ * empty parameter list for the reads that take none.
+ */
+export const RPC_REMOTE = {
+    package: PKG,
+    descriptors: [
+        method("listPersonas", []),
+        method("savePersona", withInput()),
+        method("deletePersona", withInput()),
+        method("movePersona", withInput()),
+        method("duplicatePersona", withInput()),
+        method("reorderPersona", withInput()),
+        method("listTargets", []),
+        method("sessionHistory", withInput()),
+        method("sessionPrompt", withInput()),
+        method("tunePersona", withInput()),
+        method("listModels", []),
+        method("savePrefs", withInput()),
+    ],
+};

package/lib/typert.d.ts

@@ -0,0 +1,48 @@
+import { z } from "zod";
+export declare const TYPERT: {
+    package: string;
+    face: string;
+    schemas: any[];
+    model: {
+        services: {
+            tags: any[];
+            key: string;
+            exportName: string;
+            description: string;
+            summary: string;
+            jsDoc: string;
+            members: {
+                name: string;
+                kind: string;
+                signature: string;
+            }[];
+            types: any[];
+        }[];
+        events: any[];
+        objects: any[];
+    };
+    invocations: {
+        id: string;
+        service: string;
+        namespace: string;
+        method: string;
+        invocation: {
+            kind: string;
+        };
+        parameters: {
+            name: string;
+            wire: string;
+            source: string;
+            codec: {
+                mode: string;
+                typeSymbol: string;
+                schema: z.ZodUnknown;
+            };
+        }[];
+        result: {
+            mode: string;
+            typeSymbol: string;
+            schema: z.ZodUnknown;
+        };
+    }[];
+};

package/lib/typert.js

@@ -0,0 +1,217 @@
+// 该文件由 scripts/generate-remote.mjs 生成，请勿手改（改 src/endpoints.ts 后重新生成）。
+import { z } from "zod";
+const PKG = "dsh-agent-persona";
+const direct = { kind: "direct" };
+const jsonCodec = (typeSymbol) => ({
+    mode: "strict",
+    typeSymbol: `${PKG}#${typeSymbol}`,
+    schema: z.unknown(),
+});
+const result = (typeSymbol) => jsonCodec(typeSymbol);
+export const TYPERT = {
+    package: PKG,
+    face: "host",
+    schemas: [],
+    model: {
+        services: [
+            {
+                tags: [],
+                key: "agentPersona",
+                exportName: "agentPersona",
+                description: "Workspace-scoped agent personas exposed through the host RPC service.",
+                summary: "Agent persona management service",
+                jsDoc: "The host service for listing, editing, matching, and tuning agent personas.",
+                members: [
+                    { name: "listPersonas", kind: "method", signature: "(): Promise<unknown>" },
+                    { name: "savePersona", kind: "method", signature: "(input: unknown): Promise<unknown>" },
+                    { name: "deletePersona", kind: "method", signature: "(input: unknown): Promise<unknown>" },
+                    { name: "movePersona", kind: "method", signature: "(input: unknown): Promise<unknown>" },
+                    { name: "duplicatePersona", kind: "method", signature: "(input: unknown): Promise<unknown>" },
+                    { name: "reorderPersona", kind: "method", signature: "(input: unknown): Promise<unknown>" },
+                    { name: "listTargets", kind: "method", signature: "(): Promise<unknown>" },
+                    { name: "sessionHistory", kind: "method", signature: "(input: unknown): Promise<unknown>" },
+                    { name: "sessionPrompt", kind: "method", signature: "(input: unknown): Promise<unknown>" },
+                    { name: "tunePersona", kind: "method", signature: "(input: unknown): Promise<unknown>" },
+                    { name: "listModels", kind: "method", signature: "(): Promise<unknown>" },
+                    { name: "savePrefs", kind: "method", signature: "(input: unknown): Promise<unknown>" },
+                ],
+                types: [],
+            },
+        ],
+        events: [],
+        objects: [],
+    },
+    invocations: [
+        {
+            id: `dsh-agent-persona#agentPersona/listPersonas`,
+            service: "agentPersona",
+            namespace: "agentPersona",
+            method: "listPersonas",
+            invocation: direct,
+            parameters: [],
+            result: result("Json"),
+        },
+        {
+            id: `dsh-agent-persona#agentPersona/savePersona`,
+            service: "agentPersona",
+            namespace: "agentPersona",
+            method: "savePersona",
+            invocation: direct,
+            parameters: [
+                {
+                    name: "input",
+                    wire: "input",
+                    source: "json",
+                    codec: jsonCodec("Json"),
+                },
+            ],
+            result: result("Json"),
+        },
+        {
+            id: `dsh-agent-persona#agentPersona/deletePersona`,
+            service: "agentPersona",
+            namespace: "agentPersona",
+            method: "deletePersona",
+            invocation: direct,
+            parameters: [
+                {
+                    name: "input",
+                    wire: "input",
+                    source: "json",
+                    codec: jsonCodec("Json"),
+                },
+            ],
+            result: result("Json"),
+        },
+        {
+            id: `dsh-agent-persona#agentPersona/movePersona`,
+            service: "agentPersona",
+            namespace: "agentPersona",
+            method: "movePersona",
+            invocation: direct,
+            parameters: [
+                {
+                    name: "input",
+                    wire: "input",
+                    source: "json",
+                    codec: jsonCodec("Json"),
+                },
+            ],
+            result: result("Json"),
+        },
+        {
+            id: `dsh-agent-persona#agentPersona/duplicatePersona`,
+            service: "agentPersona",
+            namespace: "agentPersona",
+            method: "duplicatePersona",
+            invocation: direct,
+            parameters: [
+                {
+                    name: "input",
+                    wire: "input",
+                    source: "json",
+                    codec: jsonCodec("Json"),
+                },
+            ],
+            result: result("Json"),
+        },
+        {
+            id: `dsh-agent-persona#agentPersona/reorderPersona`,
+            service: "agentPersona",
+            namespace: "agentPersona",
+            method: "reorderPersona",
+            invocation: direct,
+            parameters: [
+                {
+                    name: "input",
+                    wire: "input",
+                    source: "json",
+                    codec: jsonCodec("Json"),
+                },
+            ],
+            result: result("Json"),
+        },
+        {
+            id: `dsh-agent-persona#agentPersona/listTargets`,
+            service: "agentPersona",
+            namespace: "agentPersona",
+            method: "listTargets",
+            invocation: direct,
+            parameters: [],
+            result: result("Json"),
+        },
+        {
+            id: `dsh-agent-persona#agentPersona/sessionHistory`,
+            service: "agentPersona",
+            namespace: "agentPersona",
+            method: "sessionHistory",
+            invocation: direct,
+            parameters: [
+                {
+                    name: "input",
+                    wire: "input",
+                    source: "json",
+                    codec: jsonCodec("Json"),
+                },
+            ],
+            result: result("Json"),
+        },
+        {
+            id: `dsh-agent-persona#agentPersona/sessionPrompt`,
+            service: "agentPersona",
+            namespace: "agentPersona",
+            method: "sessionPrompt",
+            invocation: direct,
+            parameters: [
+                {
+                    name: "input",
+                    wire: "input",
+                    source: "json",
+                    codec: jsonCodec("Json"),
+                },
+            ],
+            result: result("Json"),
+        },
+        {
+            id: `dsh-agent-persona#agentPersona/tunePersona`,
+            service: "agentPersona",
+            namespace: "agentPersona",
+            method: "tunePersona",
+            invocation: direct,
+            parameters: [
+                {
+                    name: "input",
+                    wire: "input",
+                    source: "json",
+                    codec: jsonCodec("Json"),
+                },
+            ],
+            result: result("Json"),
+        },
+        {
+            id: `dsh-agent-persona#agentPersona/listModels`,
+            service: "agentPersona",
+            namespace: "agentPersona",
+            method: "listModels",
+            invocation: direct,
+            parameters: [],
+            result: result("Json"),
+        },
+        {
+            id: `dsh-agent-persona#agentPersona/savePrefs`,
+            service: "agentPersona",
+            namespace: "agentPersona",
+            method: "savePrefs",
+            invocation: direct,
+            parameters: [
+                {
+                    name: "input",
+                    wire: "input",
+                    source: "json",
+                    codec: jsonCodec("Json"),
+                },
+            ],
+            result: result("Json"),
+        },
+    ],
+};

package/package.json

@@ -0,0 +1,104 @@
+{
+  "name": "dsh-agent-persona",
+  "version": "0.1.0",
+  "description": "Workspace personas for DeepSeek Harness (DSH): create many system-prompt personas and scope each one by workspace path or session id (exact / prefix / regex / contains), managed from a Web settings page with Markdown editing and AI tuning.",
+  "type": "module",
+  "main": "lib/index.js",
+  "exports": {
+    ".": {
+      "types": "./lib/index.d.ts",
+      "default": "./lib/index.js"
+    },
+    "./client": {
+      "default": "./lib/client.js"
+    },
+    "./cordis.patch.yml": "./cordis.patch.yml",
+    "./package.json": "./package.json",
+    "./remote": {
+      "types": "./lib/remote.d.ts",
+      "default": "./lib/remote.js"
+    },
+    "./typert": {
+      "types": "./lib/typert.d.ts",
+      "default": "./lib/typert.js"
+    }
+  },
+  "files": [
+    "lib",
+    "cordis.patch.yml",
+    "scripts/install.sh",
+    "scripts/install.ps1",
+    "README.md",
+    "README_EN.md",
+    "CHANGELOG.md",
+    "LICENSE"
+  ],
+  "keywords": [
+    "dsh",
+    "deepseek-harness",
+    "plugin",
+    "persona",
+    "system-prompt",
+    "workspace",
+    "settings-panel"
+  ],
+  "author": "awoodwhale <woodwhale@qq.com>",
+  "license": "Apache-2.0",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/awoodwhale/dsh-agent-persona.git"
+  },
+  "homepage": "https://github.com/awoodwhale/dsh-agent-persona#readme",
+  "bugs": {
+    "url": "https://github.com/awoodwhale/dsh-agent-persona/issues"
+  },
+  "engines": {
+    "node": "^22.19.0 || >=24.0.0"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "scripts": {
+    "build": "npm run generate:remote && tsc -p tsconfig.json && esbuild src/client.ts --bundle --format=iife --platform=browser --target=es2020 --outfile=lib/client.js --log-level=warning",
+    "typecheck": "tsc -p tsconfig.json --noEmit && tsc -p tsconfig.client.json",
+    "test": "node test/personas.test.mjs && node test/client-helpers.test.mjs && node scripts/generate-remote.mjs --check",
+    "prepare": "npm run build",
+    "generate:remote": "node scripts/generate-remote.mjs"
+  },
+  "dsh": {
+    "bundle": {
+      "patch": "./cordis.patch.yml"
+    },
+    "client": {
+      "platform": "web",
+      "inject": [
+        "@deepseek-ai/dsh-api-remotes",
+        "@deepseek-ai/dsh-client-connection",
+        "@deepseek-ai/dsh-client-ui-settings",
+        "@deepseek-ai/dsh-client-ui-slots"
+      ]
+    },
+    "compatibility": {
+      "dshReleases": {
+        "0.1.5-rc.1": "compatible",
+        "0.1.5-rc.2": "compatible"
+      }
+    }
+  },
+  "peerDependencies": {
+    "@deepseek-ai/cordis": "^4.0.2",
+    "@deepseek-ai/dsh-api-remotes": ">=0.1.5-rc.1",
+    "@deepseek-ai/dsh-client-connection": ">=0.1.5-rc.1",
+    "@deepseek-ai/dsh-client-ui-primitives": ">=0.1.5-rc.1",
+    "@deepseek-ai/dsh-client-ui-settings": ">=0.1.5-rc.1",
+    "@deepseek-ai/dsh-client-ui-slots": ">=0.1.5-rc.1",
+    "@deepseek-ai/dsh-typert-protocol": ">=0.1.5-rc.1",
+    "react": "^18.3.1",
+    "zod": "^4.0.0"
+  },
+  "devDependencies": {
+    "esbuild": "^0.28.2",
+    "typescript": "^7.0.2"
+  },
+  "types": "lib/index.d.ts"
+}

package/scripts/install.ps1

@@ -0,0 +1,30 @@
+# Install dsh-workspace-persona into a DSH profile (Windows).
+#
+#   pwsh -File scripts/install.ps1
+#   pwsh -File scripts/install.ps1 -Profile my-profile
+#   pwsh -File scripts/install.ps1 -Profile web -Target .
+param(
+  [string]$Profile = "web",
+  [string]$Target  = "dsh-workspace-persona"
+)
+
+$ErrorActionPreference = "Stop"
+
+if (-not (Get-Command dsh -ErrorAction SilentlyContinue)) {
+  Write-Error "dsh not found on PATH — install DeepSeek Harness first."
+}
+
+Write-Host "==> dsh plugin --profile $Profile add $Target"
+& dsh plugin --profile $Profile add $Target
+if ($LASTEXITCODE -ne 0) { exit $LASTEXITCODE }
+
+Write-Host @"
+
+Installed. ``dsh.profile.bundles`` is read at STARTUP, so restart the host now:
+
+    dsh web
+
+Then verify:
+    Get-Content "`$env:DSH_HOME\workspace-persona.state.json"
+    # Web -> 设置 -> 工作区人设
+"@

package/scripts/install.sh

@@ -0,0 +1,29 @@
+#!/usr/bin/env bash
+# Install dsh-workspace-persona into a DSH profile.
+#
+#   bash scripts/install.sh                 # default profile: web
+#   bash scripts/install.sh my-profile      # explicit profile
+#   bash scripts/install.sh web .           # install this checkout (dev mode)
+set -euo pipefail
+
+PROFILE="${1:-web}"
+TARGET="${2:-dsh-workspace-persona}"
+
+if ! command -v dsh >/dev/null 2>&1; then
+  echo "dsh not found on PATH — install DeepSeek Harness first." >&2
+  exit 1
+fi
+
+echo "==> dsh plugin --profile ${PROFILE} add ${TARGET}"
+dsh plugin --profile "${PROFILE}" add "${TARGET}"
+
+cat <<'TIP'
+
+Installed. `dsh.profile.bundles` is read at STARTUP, so restart the host now:
+
+    dsh web            # or stop the running one and start it again
+
+Then verify:
+    cat "$DSH_HOME/workspace-persona.state.json"     # load heartbeat of the host half
+    # Web → 设置 → 工作区人设
+TIP