@huaweidevtools/aishell-dsh-e2b 0.0.0-stage → 0.0.1-beta.3

package/lib/types/tools.d.ts

@@ -0,0 +1,46 @@
+/**
+ * The model-facing tools.
+ *
+ * Each one is a thin projection of an E2B SDK call: the tool's parameters are
+ * the SDK's own options, and its result is the SDK's own return value in a
+ * shape that survives JSON. That correspondence is the point — an operator who
+ * reads the E2B documentation should find nothing surprising here, and the
+ * next plugin in this family can keep the same contract.
+ *
+ * Three conventions are load-bearing and are repeated in the descriptions the
+ * model reads:
+ *
+ *   - **One conversation, one sandbox.** No tool but `aishell__sandbox_create` takes a
+ *     `sandboxId`. There is nothing to choose between, so there is no parameter
+ *     to get wrong, and no way for a call to land in a different sandbox than
+ *     the model meant.
+ *   - **`timeoutMs` is milliseconds.** The TypeScript SDK counts milliseconds
+ *     where the Python one counts seconds; a model that learned the Python
+ *     spelling would ask for a five-second sandbox and get five thousand.
+ *   - **A non-zero exit is a result, not a failure.** `aishell__sandbox_commands_run`
+ *     reports the code and both streams, so a failing command reads as an
+ *     outcome to reason about rather than a broken tool.
+ *
+ * @module @huaweidevtools/aishell-dsh-e2b/tools
+ */
+import type { Context } from '@deepseek-ai/cordis';
+import type { SandboxClient } from './client.ts';
+import { type SandboxRegistry } from './sandbox-registry.ts';
+/** What every tool needs to act. */
+export interface ToolDeps {
+    /** The sandbox gateway connection. */
+    readonly client: SandboxClient;
+    /** The sandbox this conversation is bound to. */
+    readonly registry: SandboxRegistry;
+    /** The filesystem the local workspace is reached through, when one is mounted. */
+    readonly resolveFs: () => Context['fs'] | undefined;
+}
+/**
+ * Register every sandbox tool.
+ *
+ * @param ctx - the plugin context, providing the tool registry.
+ * @param deps - the shared dependencies.
+ * @returns disposers for the registrations.
+ */
+export declare function registerSandboxTools(ctx: Context, deps: ToolDeps): Array<() => void>;
+//# sourceMappingURL=tools.d.ts.map

package/package.json

@@ -1,6 +1,56 @@
 {
   "name": "@huaweidevtools/aishell-dsh-e2b",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
+  "description": "Runs throwaway and preview deployments in E2B sandboxes on DSH — sandbox lifecycle, commands, and files as tools",
+  "version": "0.0.1-beta.3",
+  "publishConfig": {
+    "access": "public"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/yusheng-g/aishell-dsh-plugins.git",
+    "directory": "packages/aishell-e2b"
+  },
+  "type": "module",
+  "main": "lib/index.js",
+  "types": "lib/types/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./lib/types/index.d.ts",
+      "default": "./lib/index.js"
+    }
+  },
+  "files": [
+    "lib/index.js",
+    "lib/types/**/*.d.ts",
+    "cordis.patch.yml"
+  ],
+  "license": "Apache-2.0",
+  "dependencies": {
+    "e2b": "2.59.0",
+    "@huaweidevtools/aishell-dsh-credentials-store": "0.0.1-beta.3"
+  },
+  "peerDependencies": {
+    "@deepseek-ai/cordis": "^4.0.4",
+    "@deepseek-ai/dsh-fs": "0.2.0-rc.1 || 0.2.1-rc.1 || 0.2.1-rc.2 || 0.2.1",
+    "@deepseek-ai/dsh-system-prompt": "0.2.0-rc.1 || 0.2.1-rc.1 || 0.2.1-rc.2 || 0.2.1",
+    "@deepseek-ai/dsh-tools": "0.2.0-rc.1 || 0.2.1-rc.1 || 0.2.1-rc.2 || 0.2.1"
+  },
+  "devDependencies": {
+    "@deepseek-ai/cordis": "^4.0.4",
+    "@deepseek-ai/cordis-plugin-loader": "^1.0.5",
+    "@deepseek-ai/dsh-fs": "0.2.0-rc.1 || 0.2.1-rc.1 || 0.2.1-rc.2 || 0.2.1",
+    "@deepseek-ai/dsh-system-prompt": "0.2.0-rc.1 || 0.2.1-rc.1 || 0.2.1-rc.2 || 0.2.1",
+    "@deepseek-ai/dsh-tools": "0.2.0-rc.1 || 0.2.1-rc.1 || 0.2.1-rc.2 || 0.2.1",
+    "@deepseek-ai/schemastery": "3.18.4",
+    "tsdown": "^0.10.0",
+    "typescript": "^5.7.0"
+  },
+  "dsh": {
+    "bundle": {
+      "patch": "./cordis.patch.yml"
+    }
+  },
+  "scripts": {
+    "build:bundle": "tsdown"
+  }
 }