better-dsh 0.0.0 → 0.2.3

package/lib/py-sdk.d.ts

@@ -0,0 +1,2 @@
+import { a as renderReplBridgeInstructions, i as isFlatBindableName, n as REPL_BRIDGE_CATALOG_MODE, o as renderToolsSdkPy, r as ReplBridgeCatalogMode, t as DASHRSdkSchema } from "./py-sdk-BCaOGYz7.js";
+export { DASHRSdkSchema, REPL_BRIDGE_CATALOG_MODE, ReplBridgeCatalogMode, isFlatBindableName, renderReplBridgeInstructions, renderToolsSdkPy };

package/lib/py-sdk.js

@@ -0,0 +1,3 @@
+import { i as renderToolsSdkPy, n as isFlatBindableName, r as renderReplBridgeInstructions, t as REPL_BRIDGE_CATALOG_MODE } from "./py-sdk-CbgYiX8O.js";
+
+export { REPL_BRIDGE_CATALOG_MODE, isFlatBindableName, renderReplBridgeInstructions, renderToolsSdkPy };

package/package.json

@@ -1,7 +1,328 @@
 {
   "name": "better-dsh",
-  "version": "0.0.0",
-  "description": "Placeholder — this package has moved to @pgmi-builds/better-dsh.",
-  "main": "index.js",
-  "license": "MIT"
+  "version": "0.2.3",
+  "type": "module",
+  "main": "lib/index.js",
+  "types": "lib/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./lib/index.d.ts",
+      "default": "./lib/index.js"
+    },
+    "./py-sdk": {
+      "types": "./lib/py-sdk.d.ts",
+      "default": "./lib/py-sdk.js"
+    },
+    "./cordis.patch.yml": "./cordis.patch.yml",
+    "./package.json": "./package.json",
+    "./client": {
+      "types": "./lib/client/index.d.ts",
+      "default": "./lib/client/index.js"
+    }
+  },
+  "files": [
+    "lib",
+    "docs",
+    "cordis.patch.yml",
+    "control-prompt.md",
+    "scripts/kernel-provision.mjs"
+  ],
+  "scripts": {
+    "prebuild": "node -e \"fs.cpSync('../docs','docs',{recursive:true})\"",
+    "build": "tsdown && npm run build-client",
+    "typecheck": "tsc --noEmit",
+    "test": "vitest --run",
+    "test:watch": "vitest",
+    "kernel:venv": "node scripts/kernel-provision.mjs",
+    "build-client": "tsx scripts/build-client.ts"
+  },
+  "license": "MIT",
+  "dsh": {
+    "bundle": {
+      "patch": "./cordis.patch.yml"
+    },
+    "client": {
+      "inject": [
+        "@deepseek-ai/dsh-client-ui-settings",
+        "@deepseek-ai/dsh-client-locale",
+        "@deepseek-ai/dsh-client-connection",
+        "@deepseek-ai/dsh-api-remotes",
+        "@deepseek-ai/dsh-client-ui-layout"
+      ],
+      "platform": "web"
+    }
+  },
+  "engines": {
+    "node": ">=22.18"
+  },
+  "peerDependencies": {
+    "@deepseek-ai/cordis": "^4.0.1",
+    "@deepseek-ai/cordis-plugin-include": "^1.0.6",
+    "@deepseek-ai/cordis-plugin-loader": "^1.0.2",
+    "@deepseek-ai/dsh": ">=0.1.2-alpha.1 <0.2.0-0",
+    "@deepseek-ai/dsh-agent": ">=0.1.2-alpha.1 <0.2.0-0",
+    "@deepseek-ai/dsh-agent-instructions": ">=0.1.2-alpha.1 <0.2.0-0",
+    "@deepseek-ai/dsh-agent-loop": ">=0.1.2-alpha.1 <0.2.0-0",
+    "@deepseek-ai/dsh-agent-presets": ">=0.1.2-alpha.1 <0.2.0-0",
+    "@deepseek-ai/dsh-agent-tool-presentation": ">=0.1.2-alpha.1 <0.2.0-0",
+    "@deepseek-ai/dsh-code-runtime": ">=0.1.2-alpha.1 <0.2.0-0",
+    "@deepseek-ai/dsh-code-runtime-worker-thread": ">=0.1.2-alpha.1 <0.2.0-0",
+    "@deepseek-ai/dsh-command-compact": ">=0.1.2-alpha.1 <0.2.0-0",
+    "@deepseek-ai/dsh-fs": ">=0.1.2-alpha.1 <0.2.0-0",
+    "@deepseek-ai/dsh-fs-local": ">=0.1.2-alpha.1 <0.2.0-0",
+    "@deepseek-ai/dsh-home-paths": ">=0.1.2-alpha.1 <0.2.0-0",
+    "@deepseek-ai/dsh-invariants": ">=0.1.2-alpha.1 <0.2.0-0",
+    "@deepseek-ai/dsh-llm": ">=0.1.2-alpha.1 <0.2.0-0",
+    "@deepseek-ai/dsh-llm-retry": ">=0.1.2-alpha.1 <0.2.0-0",
+    "@deepseek-ai/dsh-persona": ">=0.1.2-alpha.1 <0.2.0-0",
+    "@deepseek-ai/dsh-plan-mode": ">=0.1.2-alpha.1 <0.2.0-0",
+    "@deepseek-ai/dsh-sandbox": ">=0.1.2-alpha.1 <0.2.0-0",
+    "@deepseek-ai/dsh-scope": ">=0.1.2-alpha.1 <0.2.0-0",
+    "@deepseek-ai/dsh-session": ">=0.1.2-alpha.1 <0.2.0-0",
+    "@deepseek-ai/dsh-settings": ">=0.1.2-alpha.1 <0.2.0-0",
+    "@deepseek-ai/dsh-skill-filesystem": ">=0.1.2-alpha.1 <0.2.0-0",
+    "@deepseek-ai/dsh-system-prompt": ">=0.1.2-alpha.1 <0.2.0-0",
+    "@deepseek-ai/dsh-tool-ask-user": ">=0.1.2-alpha.1 <0.2.0-0",
+    "@deepseek-ai/dsh-tool-bash": ">=0.1.2-alpha.1 <0.2.0-0",
+    "@deepseek-ai/dsh-tool-fs": ">=0.1.2-alpha.1 <0.2.0-0",
+    "@deepseek-ai/dsh-tool-fs-search": ">=0.1.2-alpha.1 <0.2.0-0",
+    "@deepseek-ai/dsh-tool-goal": ">=0.1.2-alpha.1 <0.2.0-0",
+    "@deepseek-ai/dsh-tool-jobs": ">=0.1.2-alpha.1 <0.2.0-0",
+    "@deepseek-ai/dsh-tool-pwsh": ">=0.1.2-alpha.1 <0.2.0-0",
+    "@deepseek-ai/dsh-tool-ralph": ">=0.1.2-alpha.1 <0.2.0-0",
+    "@deepseek-ai/dsh-tool-skill": ">=0.1.2-alpha.1 <0.2.0-0",
+    "@deepseek-ai/dsh-tool-subagent": ">=0.1.2-alpha.1 <0.2.0-0",
+    "@deepseek-ai/dsh-tool-subagent-control": ">=0.1.2-alpha.1 <0.2.0-0",
+    "@deepseek-ai/dsh-tool-todo": ">=0.1.2-alpha.1 <0.2.0-0",
+    "@deepseek-ai/dsh-tool-web": ">=0.1.2-alpha.1 <0.2.0-0",
+    "@deepseek-ai/dsh-tool-workflow": ">=0.1.2-alpha.1 <0.2.0-0",
+    "@deepseek-ai/dsh-tools": ">=0.1.2-alpha.1 <0.2.0-0",
+    "@deepseek-ai/dsh-user-approval": ">=0.1.2-alpha.1 <0.2.0-0",
+    "@deepseek-ai/dsh-workflow-worker-thread": ">=0.1.2-alpha.1 <0.2.0-0",
+    "@deepseek-ai/schemastery": "^3.18.1",
+    "@deepseek-ai/dsh-api-gateway": ">=0.1.2-alpha.1 <0.2.0-0",
+    "@deepseek-ai/dsh-api-remotes": ">=0.1.2-alpha.1 <0.2.0-0",
+    "@deepseek-ai/dsh-client-connection": ">=0.1.2-alpha.1 <0.2.0-0",
+    "@deepseek-ai/dsh-client-locale": ">=0.1.2-alpha.1 <0.2.0-0",
+    "@deepseek-ai/dsh-client-ui-conversation": ">=0.1.2-alpha.1 <0.2.0-0",
+    "@deepseek-ai/dsh-client-ui-primitives": ">=0.1.2-alpha.1 <0.2.0-0",
+    "@deepseek-ai/dsh-client-ui-settings": ">=0.1.2-alpha.1 <0.2.0-0",
+    "@deepseek-ai/dsh-client-ui-settings-plugins": ">=0.1.2-alpha.1 <0.2.0-0",
+    "@deepseek-ai/dsh-client-ui-slots": ">=0.1.2-alpha.1 <0.2.0-0",
+    "@deepseek-ai/dsh-commands": ">=0.1.2-alpha.1 <0.2.0-0",
+    "@deepseek-ai/dsh-typert-protocol": ">=0.1.2-alpha.1 <0.2.0-0",
+    "@deepseek-ai/dsh-typert-registry": ">=0.1.2-alpha.1 <0.2.0-0",
+    "react": "^18.2.0"
+  },
+  "peerDependenciesMeta": {
+    "@deepseek-ai/cordis": {
+      "optional": true
+    },
+    "@deepseek-ai/cordis-plugin-include": {
+      "optional": true
+    },
+    "@deepseek-ai/cordis-plugin-loader": {
+      "optional": true
+    },
+    "@deepseek-ai/dsh": {
+      "optional": true
+    },
+    "@deepseek-ai/dsh-agent": {
+      "optional": true
+    },
+    "@deepseek-ai/dsh-agent-instructions": {
+      "optional": true
+    },
+    "@deepseek-ai/dsh-agent-loop": {
+      "optional": true
+    },
+    "@deepseek-ai/dsh-agent-presets": {
+      "optional": true
+    },
+    "@deepseek-ai/dsh-agent-tool-presentation": {
+      "optional": true
+    },
+    "@deepseek-ai/dsh-code-runtime": {
+      "optional": true
+    },
+    "@deepseek-ai/dsh-code-runtime-worker-thread": {
+      "optional": true
+    },
+    "@deepseek-ai/dsh-command-compact": {
+      "optional": true
+    },
+    "@deepseek-ai/dsh-fs": {
+      "optional": true
+    },
+    "@deepseek-ai/dsh-fs-local": {
+      "optional": true
+    },
+    "@deepseek-ai/dsh-home-paths": {
+      "optional": true
+    },
+    "@deepseek-ai/dsh-invariants": {
+      "optional": true
+    },
+    "@deepseek-ai/dsh-llm": {
+      "optional": true
+    },
+    "@deepseek-ai/dsh-llm-retry": {
+      "optional": true
+    },
+    "@deepseek-ai/dsh-persona": {
+      "optional": true
+    },
+    "@deepseek-ai/dsh-plan-mode": {
+      "optional": true
+    },
+    "@deepseek-ai/dsh-sandbox": {
+      "optional": true
+    },
+    "@deepseek-ai/dsh-scope": {
+      "optional": true
+    },
+    "@deepseek-ai/dsh-session": {
+      "optional": true
+    },
+    "@deepseek-ai/dsh-settings": {
+      "optional": true
+    },
+    "@deepseek-ai/dsh-skill-filesystem": {
+      "optional": true
+    },
+    "@deepseek-ai/dsh-system-prompt": {
+      "optional": true
+    },
+    "@deepseek-ai/dsh-tool-ask-user": {
+      "optional": true
+    },
+    "@deepseek-ai/dsh-tool-bash": {
+      "optional": true
+    },
+    "@deepseek-ai/dsh-tool-fs": {
+      "optional": true
+    },
+    "@deepseek-ai/dsh-tool-fs-search": {
+      "optional": true
+    },
+    "@deepseek-ai/dsh-tool-goal": {
+      "optional": true
+    },
+    "@deepseek-ai/dsh-tool-jobs": {
+      "optional": true
+    },
+    "@deepseek-ai/dsh-tool-pwsh": {
+      "optional": true
+    },
+    "@deepseek-ai/dsh-tool-ralph": {
+      "optional": true
+    },
+    "@deepseek-ai/dsh-tool-skill": {
+      "optional": true
+    },
+    "@deepseek-ai/dsh-tool-subagent": {
+      "optional": true
+    },
+    "@deepseek-ai/dsh-tool-subagent-control": {
+      "optional": true
+    },
+    "@deepseek-ai/dsh-tool-todo": {
+      "optional": true
+    },
+    "@deepseek-ai/dsh-tool-web": {
+      "optional": true
+    },
+    "@deepseek-ai/dsh-tool-workflow": {
+      "optional": true
+    },
+    "@deepseek-ai/dsh-tools": {
+      "optional": true
+    },
+    "@deepseek-ai/dsh-user-approval": {
+      "optional": true
+    },
+    "@deepseek-ai/dsh-workflow-worker-thread": {
+      "optional": true
+    },
+    "@deepseek-ai/schemastery": {
+      "optional": true
+    },
+    "@deepseek-ai/dsh-api-gateway": {
+      "optional": true
+    },
+    "@deepseek-ai/dsh-api-remotes": {
+      "optional": true
+    },
+    "@deepseek-ai/dsh-client-connection": {
+      "optional": true
+    },
+    "@deepseek-ai/dsh-client-locale": {
+      "optional": true
+    },
+    "@deepseek-ai/dsh-client-ui-conversation": {
+      "optional": true
+    },
+    "@deepseek-ai/dsh-client-ui-primitives": {
+      "optional": true
+    },
+    "@deepseek-ai/dsh-client-ui-settings": {
+      "optional": true
+    },
+    "@deepseek-ai/dsh-client-ui-settings-plugins": {
+      "optional": true
+    },
+    "@deepseek-ai/dsh-client-ui-slots": {
+      "optional": true
+    },
+    "@deepseek-ai/dsh-commands": {
+      "optional": true
+    },
+    "@deepseek-ai/dsh-typert-protocol": {
+      "optional": true
+    },
+    "@deepseek-ai/dsh-typert-registry": {
+      "optional": true
+    },
+    "react": {
+      "optional": true
+    }
+  },
+  "dependencies": {
+    "@deepseek-ai/schemastery": "^3.18.1",
+    "diff": "^8.0.2",
+    "file-type": "^21.3.0",
+    "puppeteer-core": "25.3.0",
+    "xxhash-wasm": "^1.1.0",
+    "zeromq": "^6.6.0",
+    "use-sync-external-store": "^1.6.0"
+  },
+  "optionalDependencies": {
+    "@oh-my-pi/pi-natives-linux-x64": "18.0.6",
+    "@oh-my-pi/pi-natives-linux-arm64": "18.0.6",
+    "@oh-my-pi/pi-natives-darwin-x64": "18.0.6",
+    "@oh-my-pi/pi-natives-darwin-arm64": "18.0.6",
+    "@oh-my-pi/pi-natives-win32-x64": "18.0.6"
+  },
+  "devDependencies": {
+    "@types/node": "^22.10.5",
+    "node-addon-require-builtin": "^0.1.5",
+    "tsdown": "^0.15.7",
+    "typescript": "^5.9.3",
+    "vitest": "^4.1.10",
+    "tsx": "^4.22.4"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/pgmi-builds/better-dsh.git"
+  },
+  "keywords": [
+    "dsh",
+    "deepseek-harness",
+    "repl",
+    "eval",
+    "ipython",
+    "kernel",
+    "agent",
+    "plugin"
+  ]
 }

package/scripts/kernel-provision.mjs

@@ -0,0 +1,35 @@
+#!/usr/bin/env node
+/**
+ * Best-effort kernel provisioning entry — the single code path behind BOTH
+ * `postinstall` and `npm run kernel:venv`.
+ *
+ * Fail-open by design (2026-09-03 ruling): any failure logs a remedy hint and
+ * exits 0. The installation must NEVER fail because the kernel could not be
+ * provisioned here — the daemon spin-up check (primary path) and first-use
+ * lazy provisioning (final fallback) complete the three-trigger ladder.
+ */
+import { access } from 'node:fs/promises'
+
+const libUrl = new URL('../lib/kernel-env.js', import.meta.url)
+
+try {
+  await access(libUrl)
+} catch {
+  // Dev checkout before the first build, or a pruned install: nothing to call.
+  console.log('[dashr] kernel-env build output not present yet — skipping install-time pre-provision (the daemon spin-up check will provision on start)')
+  process.exit(0)
+}
+
+const { resolveKernelEnv } = await import(libUrl)
+
+try {
+  const env = await resolveKernelEnv({
+    autoInstall: true,
+    log: (level, message) => console[level === 'warn' ? 'warn' : 'log'](`[dashr] ${message}`),
+  })
+  console.log(`[dashr] kernel ready: python ${env.version} at ${env.python}${env.dill ? '' : ' (dill missing — snapshots disabled)'}`)
+} catch (error) {
+  console.warn(`[dashr] kernel pre-provision failed (non-blocking): ${error instanceof Error ? error.message : String(error)}`)
+  console.warn('[dashr] remedies: run "npm run kernel:venv" in the dashr package; or rely on the daemon spin-up check / first-use auto-install; or set python to a prepared interpreter')
+  process.exit(0)
+}

package/index.js

@@ -1,3 +0,0 @@
-throw new Error(
-  "The 'better-dsh' package name has moved. Install the scoped package instead:\n\n  npm install @pgmi-builds/better-dsh",
-);