@huanlin/dsh-plugin-interpreters 0.1.0

package/lib/types/tools.js

@@ -0,0 +1,110 @@
+/**
+ * tools.ts — `run_python` and `run_node` model-facing tools.
+ *
+ * Conventions (per plugin-development-guide.md §3):
+ *   C4 — execute returns a canonical JSON value; render is a separate pure projection.
+ *   C5 — timeout and cancellation are non-ideal business outcomes, represented in
+ *        the value (timed_out / cancelled) rather than thrown.
+ *   C6 — exec.signal is forwarded to the subprocess via runCode().
+ *   C10 — no UI-specific formats in the canonical value.
+ *
+ * The tool `description` is computed from the resolved config at registration
+ * time so the model sees the interpreter path. Settings changes dispose the
+ * old registration and re-register with the fresh description (host index.ts).
+ *
+ * @module dsh-interpreters/tools
+ */
+import { defineTool } from '@deepseek-ai/dsh-tools';
+import { runCode } from './runner.js';
+/**
+ * Build the model-visible description for `run_python`, embedding the
+ * configured interpreter path so the model knows exactly which executable
+ * will be invoked.
+ */
+export function buildPythonDescription(cfg) {
+    return 'Execute Python code and return stdout, stderr, and exit code. '
+        + 'Code is passed via stdin (`' + cfg.pythonPath + ' -`), so there is no '
+        + 'command-line length limit. '
+        + 'The Python interpreter is located at: ' + cfg.pythonPath + '\n'
+        + 'Use the optional `cwd` parameter to set the working directory.';
+}
+/**
+ * Build the model-visible description for `run_node`, embedding the
+ * configured interpreter path.
+ */
+export function buildNodeDescription(cfg) {
+    return 'Execute Node.js code and return stdout, stderr, and exit code. '
+        + 'Code is passed via stdin (`' + cfg.nodePath + ' -`), so there is no '
+        + 'command-line length limit. '
+        + 'The Node.js interpreter is located at: ' + cfg.nodePath + '\n'
+        + 'Use the optional `cwd` parameter to set the working directory.';
+}
+function textRender(fn) {
+    return (_args, value) => [{ type: 'text', text: fn(value) }];
+}
+export function renderRunCodeOutput(value) {
+    const lines = [];
+    lines.push(`Exit code: ${value.exit_code} (${value.duration_ms}ms)`);
+    if (value.timed_out)
+        lines.push('Process was killed after exceeding the timeout.');
+    if (value.cancelled)
+        lines.push('Process was cancelled by an abort signal.');
+    if (value.stdout)
+        lines.push(`--- stdout ---\n${value.stdout}`);
+    if (value.stderr)
+        lines.push(`--- stderr ---\n${value.stderr}`);
+    return lines.join('\n');
+}
+const parametersSchema = {
+    code: { type: 'string', required: true, description: 'The code to execute.' },
+    cwd: { type: 'string', description: 'Optional working directory for the process.' },
+};
+const outputSchema = {
+    type: 'object',
+    additionalProperties: false,
+    properties: {
+        ok: { type: 'boolean', required: true, description: 'True if the process exited with code 0.' },
+        exit_code: { type: 'integer', required: true, description: 'Process exit code (-1 if the process failed to start).' },
+        stdout: { type: 'string', required: true, description: 'Captured stdout output.' },
+        stderr: { type: 'string', required: true, description: 'Captured stderr output.' },
+        duration_ms: { type: 'integer', required: true, description: 'Wall-clock execution time in milliseconds.' },
+        timed_out: { type: 'boolean', required: true, description: 'True if the process was killed due to timeout.' },
+        cancelled: { type: 'boolean', required: true, description: 'True if the process was killed due to an abort signal.' },
+    },
+};
+/**
+ * Register `run_python` and `run_node` tools with descriptions that embed
+ * the interpreter paths from `cfg`. Returns a disposer that unregisters
+ * both tools — call it before re-registering with a fresh config.
+ */
+export function registerTools(ctx, cfg) {
+    const disposers = [];
+    disposers.push(ctx.tools.register(defineTool({
+        name: 'run_python',
+        description: buildPythonDescription(cfg),
+        parameters: parametersSchema,
+        output: {
+            schema: outputSchema,
+            render: textRender(renderRunCodeOutput),
+        },
+        execute: async (args, exec) => {
+            const a = args;
+            return runCode(cfg.pythonPath, a.code, a.cwd, cfg.timeoutMs, exec.signal);
+        },
+    })));
+    disposers.push(ctx.tools.register(defineTool({
+        name: 'run_node',
+        description: buildNodeDescription(cfg),
+        parameters: parametersSchema,
+        output: {
+            schema: outputSchema,
+            render: textRender(renderRunCodeOutput),
+        },
+        execute: async (args, exec) => {
+            const a = args;
+            return runCode(cfg.nodePath, a.code, a.cwd, cfg.timeoutMs, exec.signal);
+        },
+    })));
+    return () => { for (const dispose of disposers)
+        dispose(); };
+}

package/package.json

@@ -0,0 +1,102 @@
+{
+  "name": "@huanlin/dsh-plugin-interpreters",
+  "version": "0.1.0",
+  "publishConfig": {
+    "access": "public"
+  },
+  "keywords": ["dsh-plugin"],
+  "description": "Exposes run_python and run_node tools with configurable interpreter paths; settings card (via /interpreters/api HTTP route) lets users set the executable locations.",
+  "type": "module",
+  "license": "AGPL-3.0",
+  "main": "./lib/index.js",
+  "types": "./lib/types/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./lib/types/index.d.ts",
+      "import": "./lib/index.js"
+    },
+    "./client": {
+      "types": "./lib/types/client/index.d.ts",
+      "default": "./lib/client.js"
+    },
+    "./package.json": "./package.json"
+  },
+  "files": [
+    "lib/",
+    "cordis.patch.yml"
+  ],
+  "dsh": {
+    "bundle": {
+      "patch": "./cordis.patch.yml"
+    },
+    "client": {
+      "inject": [
+        "@deepseek-ai/dsh-client-runtime",
+        "@deepseek-ai/dsh-client-locale",
+        "@deepseek-ai/dsh-client-connection",
+        "@deepseek-ai/dsh-client-ui-settings-plugins",
+        "@deepseek-ai/dsh-client-ui-slots"
+      ],
+      "platform": "web"
+    }
+  },
+  "scripts": {
+    "typecheck": "tsc --noEmit -p tsconfig.json",
+    "test": "vitest run",
+    "test:watch": "vitest",
+    "build": "tsc -p tsconfig.build.json && node scripts/build-client.mjs && tsc -p tsconfig.json"
+  },
+  "peerDependencies": {
+    "@deepseek-ai/cordis": "^4.0.1-rc.1",
+    "@deepseek-ai/dsh-client-connection": "^0.0.1-rc.1",
+    "@deepseek-ai/dsh-client-locale": "^0.0.1-rc.1",
+    "@deepseek-ai/dsh-client-runtime": "^0.0.1-rc.1",
+    "@deepseek-ai/dsh-client-ui-settings-plugins": "^0.0.1-rc.1",
+    "@deepseek-ai/dsh-client-ui-primitives": "^0.0.1-rc.1",
+    "@deepseek-ai/dsh-client-ui-slots": "^0.0.1-rc.1",
+    "@deepseek-ai/dsh-client-web-react": "^0.0.1-rc.1",
+    "@deepseek-ai/dsh-host-webserver": "^0.0.1-rc.1",
+    "@deepseek-ai/dsh-settings": "^0.0.1-rc.1",
+    "@deepseek-ai/dsh-tools": "^0.0.1-rc.1",
+    "react": "^18.2.0",
+    "schemastery": "^3.18.0"
+  },
+  "peerDependenciesMeta": {
+    "@deepseek-ai/cordis": { "optional": true },
+    "@deepseek-ai/dsh-client-connection": { "optional": true },
+    "@deepseek-ai/dsh-client-locale": { "optional": true },
+    "@deepseek-ai/dsh-client-runtime": { "optional": true },
+    "@deepseek-ai/dsh-client-ui-settings-plugins": { "optional": true },
+    "@deepseek-ai/dsh-client-ui-primitives": { "optional": true },
+    "@deepseek-ai/dsh-client-ui-slots": { "optional": true },
+    "@deepseek-ai/dsh-client-web-react": { "optional": true },
+    "@deepseek-ai/dsh-host-webserver": { "optional": true },
+    "@deepseek-ai/dsh-settings": { "optional": true },
+    "@deepseek-ai/dsh-tools": { "optional": true },
+    "react": { "optional": true },
+    "schemastery": { "optional": true }
+  },
+  "devDependencies": {
+    "@deepseek-ai/cordis": "^4.0.1-rc.1",
+    "@deepseek-ai/dsh-client-connection": "^0.0.1-rc.1",
+    "@deepseek-ai/dsh-client-locale": "^0.0.1-rc.1",
+    "@deepseek-ai/dsh-client-runtime": "^0.0.1-rc.1",
+    "@deepseek-ai/dsh-client-ui-settings-plugins": "^0.0.1-rc.1",
+    "@deepseek-ai/dsh-client-ui-primitives": "^0.0.1-rc.1",
+    "@deepseek-ai/dsh-client-ui-slots": "^0.0.1-rc.1",
+    "@deepseek-ai/dsh-client-web-react": "^0.0.1-rc.1",
+    "@deepseek-ai/dsh-host-webserver": "^0.0.1-rc.1",
+    "@deepseek-ai/dsh-settings": "^0.0.1-rc.1",
+    "@deepseek-ai/dsh-tools": "^0.0.1-rc.1",
+    "@types/node": "^22.20.0",
+    "@types/react": "~18.3.1",
+    "esbuild": "^0.28.2",
+    "lightningcss": "^1.29.2",
+    "tsdown": "^0.22.2",
+    "typescript": "^5.9.0",
+    "vitest": "^3.2.0"
+  },
+  "engines": {
+    "node": ">=18.0.0"
+  }
+}