dsh-hooks 0.2.2 → 0.4.0

package/lib/server.js

@@ -0,0 +1,128 @@
+import { createRequire } from 'node:module';
+import { describeHook, evaluateHooks, mockContext } from './dry-run.js';
+import { createHookRunner } from './runner.js';
+import { fireNotify } from './notify.js';
+/** Plugin version, read from package.json (this package ships its own). */
+export function pluginVersion() {
+    const require = createRequire(import.meta.url);
+    try {
+        const pkg = require('../package.json');
+        return typeof pkg.version === 'string' ? pkg.version : 'unknown';
+    }
+    catch {
+        return 'unknown';
+    }
+}
+const OK = (value) => ({ ok: true, value });
+const FAIL = (code, message) => ({ ok: false, error: { code, message } });
+function json(res, envelope, status = 200) {
+    res.writeHead(status, { 'content-type': 'application/json; charset=utf-8' });
+    res.end(JSON.stringify(envelope));
+}
+/** Loopback fence: never let a LAN client reach /dsh-hooks operations. */
+export function isLoopbackRequest(req) {
+    const address = req.socket.remoteAddress ?? '';
+    return address === '127.0.0.1' || address === '::1' || address === '::ffff:127.0.0.1';
+}
+async function readJsonBody(req) {
+    const chunks = [];
+    let total = 0;
+    for await (const chunk of req) {
+        const buffer = chunk;
+        chunks.push(buffer);
+        total += buffer.length;
+        if (total > 1 << 20)
+            return null;
+    }
+    const text = Buffer.concat(chunks).toString('utf8');
+    if (text === '')
+        return null;
+    try {
+        return JSON.parse(text);
+    }
+    catch {
+        return null;
+    }
+}
+/** Create the /dsh-hooks route handler (exported for tests). */
+export function createHookHandler(options) {
+    const { hooks, history } = options;
+    const version = options.version ?? pluginVersion();
+    return async (req, res) => {
+        if (!isLoopbackRequest(req)) {
+            json(res, FAIL('forbidden', 'loopback-only'), 403);
+            return;
+        }
+        const url = new URL(req.url ?? '/', 'http://x');
+        const pathname = url.pathname;
+        if (req.method === 'GET' && pathname === '/dsh-hooks/status') {
+            json(res, OK({ name: 'dsh-hooks', version, hookCount: hooks.length, historyCount: history.recent().length }));
+            return;
+        }
+        if (req.method === 'GET' && pathname === '/dsh-hooks/history') {
+            const raw = url.searchParams.get('n');
+            const parsed = raw === null ? 50 : Number(raw);
+            const n = Number.isFinite(parsed) && parsed > 0 ? Math.min(500, Math.floor(parsed)) : 50;
+            const records = history.recent();
+            json(res, OK(records.slice(Math.max(0, records.length - n))));
+            return;
+        }
+        if (req.method === 'POST' && pathname === '/dsh-hooks/test') {
+            const contentType = req.headers['content-type'] ?? '';
+            if (!contentType.toLowerCase().startsWith('application/json')) {
+                json(res, FAIL('bad-request', 'POST 需要 application/json'), 415);
+                return;
+            }
+            const payload = await readJsonBody(req);
+            if (typeof payload !== 'object' || payload === null) {
+                json(res, FAIL('bad-request', 'malformed JSON body'), 400);
+                return;
+            }
+            const body = payload;
+            const event = typeof body.event === 'string' && body.event !== '' ? body.event : null;
+            if (event === null) {
+                json(res, FAIL('bad-request', '缺少 event 字段'), 400);
+                return;
+            }
+            const reason = typeof body.reason === 'string' && body.reason !== '' ? body.reason : undefined;
+            const ctx = mockContext(event, {
+                reason,
+                tool: typeof body.tool === 'string' ? body.tool : undefined,
+                sessionName: typeof body.sessionName === 'string' ? body.sessionName : undefined,
+            });
+            const lines = evaluateHooks(hooks, event, ctx, reason);
+            const matchedHooks = lines.filter((line) => line.matched);
+            const execute = body.execute === true;
+            if (execute) {
+                const runner = createHookRunner();
+                for (const line of matchedHooks) {
+                    const hook = hooks[line.index - 1];
+                    if (hook.run)
+                        runner.run(hook, ctx);
+                    else if (hook.notify)
+                        void fireNotify(hook.notify, ctx);
+                }
+            }
+            json(res, OK({
+                event,
+                reason,
+                executed: execute,
+                total: hooks.length,
+                matched: matchedHooks.length,
+                lines: lines.map((line) => ({
+                    index: line.index,
+                    matched: line.matched,
+                    why: line.why,
+                    summary: line.summary,
+                    action: line.matched ? describeHook(hooks[line.index - 1]) : undefined,
+                })),
+            }));
+            return;
+        }
+        json(res, FAIL('not-found', `unknown route ${pathname}`), 404);
+    };
+}
+/** Register the /dsh-hooks prefix route on the shared web server. */
+export function registerHookRoutes(webServer, options) {
+    return webServer.register({ kind: 'prefix', path: '/dsh-hooks', handler: createHookHandler(options) });
+}

package/package.json

@@ -1,8 +1,8 @@
 {
   "name": "dsh-hooks",
-  "version": "0.2.2",
+  "version": "0.4.0",
   "packageManager": "pnpm@11.21.0",
-  "description": "Config-driven lifecycle hooks plugin for DeepSeek Harness: declare event -> command hooks in cordis.patch.yml, no plugin code required.",
+  "description": "Config-driven lifecycle hooks plugin for DeepSeek Harness: declare event -> command hooks in cordis.patch.yml, no plugin code required. Includes a Hooks section in the Web GUI settings (history timeline + manual tester).",
   "author": "PeterBon",
   "license": "MIT",
   "repository": {
@@ -28,7 +28,11 @@
     "dsh-hooks": "./bin/dsh-hooks.mjs"
   },
   "exports": {
-    ".": "./lib/index.js",
+    ".": {
+      "types": "./lib/index.d.ts",
+      "default": "./lib/index.js"
+    },
+    "./client": "./lib/client.js",
     "./package.json": "./package.json"
   },
   "files": [
@@ -41,8 +45,8 @@
     "LICENSE"
   ],
   "scripts": {
-    "build": "tsc -p tsconfig.json",
-    "typecheck": "tsc -p tsconfig.json --noEmit",
+    "build": "tsc -p tsconfig.json && tsdown",
+    "typecheck": "tsc -p tsconfig.json --noEmit && tsc -p tsconfig.client.json --noEmit",
     "typecheck:test": "tsc -p tsconfig.test.json --noEmit",
     "test": "vitest run",
     "check": "pnpm run typecheck && pnpm run typecheck:test && pnpm run test && pnpm run build"
@@ -53,20 +57,36 @@
   "dsh": {
     "bundle": {
       "patch": "./cordis.patch.yml"
+    },
+    "client": {
+      "inject": [
+        "@deepseek-ai/dsh-client-runtime"
+      ],
+      "platform": "web"
     }
   },
   "peerDependencies": {
     "@deepseek-ai/cordis": "^4.0.1",
     "@deepseek-ai/dsh-session": "^0.1.0-rc.6",
-    "@deepseek-ai/schemastery": "^3.18.1"
+    "@deepseek-ai/schemastery": "^3.18.1",
+    "react": "^18.2.0"
   },
   "devDependencies": {
     "@deepseek-ai/cordis": "^4.0.1",
+    "@deepseek-ai/dsh-client-runtime": "^0.1.0-rc.6",
+    "@deepseek-ai/dsh-client-ui-settings": "^0.1.0-rc.6",
+    "@deepseek-ai/dsh-client-ui-slots": "^0.1.0-rc.6",
     "@deepseek-ai/dsh-session": "^0.1.0-rc.6",
     "@deepseek-ai/schemastery": "^3.18.1",
-    "@types/node": "^22.10.0",
-    "typescript": "^5.6.0",
-    "vitest": "^3.0.0"
+    "@tsdown/css": "^0.22.14",
+    "@types/node": "^26.2.0",
+    "@types/react": "~18.3.1",
+    "@types/react-dom": "^18.3.5",
+    "react": "^18.3.1",
+    "react-dom": "^18.3.1",
+    "tsdown": "^0.22.2",
+    "typescript": "^7.0.2",
+    "vitest": "^4.1.10"
   },
   "dependencies": {
     "@larksuiteoapi/node-sdk": "^1.73.0",