better-dsh 0.2.4-a → 0.2.4-c

package/lib/url-schemes/index.d.ts

@@ -50,13 +50,13 @@ declare const inject: string[];
  * real patch-line config. Schema-level defaults (both ON — the service is
  * opt-out) survive every overlay layer, per the v0.2.2a ruling.
  */
-declare const Config: z<Schemastery.ObjectS<{
-  urlSchemes: z<boolean, boolean>;
-  hashline: z<boolean, boolean>;
-}>, Schemastery.ObjectT<{
-  urlSchemes: z<boolean, boolean>;
-  hashline: z<boolean, boolean>;
-}>>;
+declare const Config: z<Schemastery.ObjectS<NoInfer<{
+  urlSchemes: z<boolean, boolean, "defined">;
+  hashline: z<boolean, boolean, "defined">;
+}>>, Schemastery.ObjectT<NoInfer<{
+  urlSchemes: z<boolean, boolean, "defined">;
+  hashline: z<boolean, boolean, "defined">;
+}>>, "plain">;
 /** Register the four URL-aware tools on one agent's own scope layer. */
 /**
  * The lsp feedback loop (native-tools Wave3): both hooks route through the
@@ -75,13 +75,13 @@ declare function apply(ctx: Context, config: UrlSchemesConfig | undefined): void
 declare const _default: {
   name: string;
   inject: string[];
-  Config: z<Schemastery.ObjectS<{
-    urlSchemes: z<boolean, boolean>;
-    hashline: z<boolean, boolean>;
-  }>, Schemastery.ObjectT<{
-    urlSchemes: z<boolean, boolean>;
-    hashline: z<boolean, boolean>;
-  }>>;
+  Config: z<Schemastery.ObjectS<NoInfer<{
+    urlSchemes: z<boolean, boolean, "defined">;
+    hashline: z<boolean, boolean, "defined">;
+  }>>, Schemastery.ObjectT<NoInfer<{
+    urlSchemes: z<boolean, boolean, "defined">;
+    hashline: z<boolean, boolean, "defined">;
+  }>>, "plain">;
   apply: typeof apply;
 };
 //#endregion

package/lib/url-schemes/index.js

@@ -8,7 +8,7 @@ import * as path from "node:path";
 import { dirname, isAbsolute, join, relative, resolve, sep } from "node:path";
 import z from "@deepseek-ai/schemastery";
 import { spawn } from "node:child_process";
-import { tmpdir } from "node:os";
+import { homedir, tmpdir } from "node:os";
 import { fileURLToPath, pathToFileURL } from "node:url";
 import { defineTool } from "@deepseek-ai/dsh-tools";
 import { FsError } from "@deepseek-ai/dsh-fs";
@@ -2134,6 +2134,96 @@ function installLspDevices(registry = registerDvcDevice) {
 	registry("lsp", lspDevice);
 }
 
+//#endregion
+//#region src/devices/ast/ast-reminder.ts
+/**
+* AST-capable extension set — empirically probed against the shipped
+* pi-natives binary (2026-09-27): grouped by grammar family. TS family and
+* header files ride the same grammars as their proven siblings.
+*/
+const AST_CODE_EXTENSIONS = new Set([
+	".py",
+	".pyi",
+	".js",
+	".jsx",
+	".mjs",
+	".cjs",
+	".ts",
+	".tsx",
+	".mts",
+	".cts",
+	".rs",
+	".go",
+	".c",
+	".cpp",
+	".h",
+	".hpp",
+	".html",
+	".css",
+	".json",
+	".yaml",
+	".yml",
+	".sh",
+	".rb"
+]);
+/** Reminders per agent session (user ruling 2026-09-27: five is enough). */
+const AST_REMINDER_CAP = 5;
+/** The one-line availability notice (single line, both dvc:// devices). */
+const NOTICE = "ast_edit / ast_grep available — write dvc://ast_edit (structured rewrite) or dvc://ast_grep (pattern search)";
+/** Per-session emitted-reminder counters (disposed with the agent). */
+const counters = /* @__PURE__ */ new Map();
+/** Drop a session's reminder counter (agent dispose). */
+function disposeAstReminders(sessionId) {
+	counters.delete(sessionId);
+}
+/** Lowercased extension of a path ('' when none). */
+function extensionOf(filePath) {
+	return path.extname(filePath).toLowerCase();
+}
+/** True when an include/glob string names a file covered by the AST set. */
+function includeTargetsCode(include) {
+	const flat = include.toLowerCase().replace(/[{},]/g, ".");
+	for (const m of flat.matchAll(/\.([a-z0-9]+)/g)) if (AST_CODE_EXTENSIONS.has(`.${m[1]}`)) return true;
+	return false;
+}
+/** Consume one emission slot for a session; false once the cap is exhausted. */
+function consume(sessionId) {
+	const n = counters.get(sessionId) ?? 0;
+	if (n >= AST_REMINDER_CAP) return false;
+	counters.set(sessionId, n + 1);
+	return true;
+}
+/**
+* Notice for a landed `write`/`edit` on one file: defined iff the target is
+* an AST-capable file and the session still has reminder budget.
+*/
+function astFileNotice(sessionId, filePath) {
+	if (!AST_CODE_EXTENSIONS.has(extensionOf(filePath))) return void 0;
+	return consume(sessionId) ? NOTICE : void 0;
+}
+/**
+* Notice for a landed `grep`: fires for directory/default-path searches, set
+* includes, and code-file targets; silent only for clearly non-code files.
+* Consumes session budget when a notice is emitted.
+*/
+function astGrepNotice(sessionId, args) {
+	const fire = () => consume(sessionId) ? NOTICE : void 0;
+	if (args === void 0) return fire();
+	const { path: searchPath, include } = args;
+	if (typeof include === "string" && include !== "") return includeTargetsCode(include) ? fire() : void 0;
+	if (typeof searchPath !== "string" || searchPath === "") return fire();
+	const ext = extensionOf(searchPath);
+	if (ext === "") return fire();
+	return AST_CODE_EXTENSIONS.has(ext) ? fire() : void 0;
+}
+/** Tool-dispatch shape: route `grep` down the search rule, the rest down the file rule. */
+function astReminderNotice(sessionId, tool, args) {
+	if (tool === "grep") return astGrepNotice(sessionId, args);
+	const filePath = args?.path ?? args?.file_path;
+	if (typeof filePath !== "string" || filePath === "") return void 0;
+	return astFileNotice(sessionId, filePath);
+}
+
 //#endregion
 //#region src/url-schemes/handlers/agent.ts
 /**
@@ -2321,8 +2411,8 @@ function renderTranscript(session) {
 function messageLabel(message) {
 	if (message.role === "assistant") return "assistant";
 	if (message.role === "system") return "system";
-	const first = message.content[0];
-	return first !== void 0 && first.type === "tool-result" ? "tool result" : "user";
+	if (message.role === "tool") return message.isError === true ? "tool result (error)" : "tool result";
+	return "user";
 }
 /** Render typed model content to plain text. */
 function renderBlocks(content) {
@@ -2333,7 +2423,6 @@ function renderBlock(block) {
 		case "text":
 		case "reasoning": return block.text;
 		case "tool-call": return `[tool: ${block.name}] ${block.arguments}`;
-		case "tool-result": return block.isError === true ? `[tool error] ${renderBlocks(block.content)}` : renderBlocks(block.content);
 		case "image": return "[image]";
 		default: return `[${block.type ?? "unknown"}]`;
 	}
@@ -7121,11 +7210,29 @@ async function installAgentTools(rootCtx, agent, resolver, gates$1) {
 			})));
 		}
 		const sessionId = agent.id;
+		const appendSuffixes = (decision, result, suffixes) => {
+			if (suffixes.length === 0) return decision;
+			const record = decision;
+			if (record?.kind !== "accept") return decision;
+			record.content = [...record.content ?? result.content ?? [], ...suffixes.map((text) => ({
+				type: "text",
+				text: `\n${text}`
+			}))];
+			return decision;
+		};
 		disposers.push(agent.ctx.on("tools/post-execute", async (exec, result, next) => {
 			const decision = await next();
 			const name$1 = exec.name;
-			if (name$1 !== "read" && name$1 !== "edit" && name$1 !== "write") return decision;
+			if (name$1 !== "read" && name$1 !== "edit" && name$1 !== "write" && name$1 !== "grep") return decision;
 			const args = exec.arguments;
+			const suffixes = [];
+			if (name$1 === "grep") {
+				if (!result.isError) {
+					const ast$1 = astReminderNotice(sessionId, "grep", args);
+					if (ast$1 !== void 0) suffixes.push(ast$1);
+				}
+				return appendSuffixes(decision, result, suffixes);
+			}
 			const filePath = args?.path ?? args?.file_path;
 			if (typeof filePath !== "string" || filePath === "") return decision;
 			if (name$1 === "read") {
@@ -7135,15 +7242,12 @@ async function installAgentTools(rootCtx, agent, resolver, gates$1) {
 			lspGateSyncOnLand(sessionId, name$1, filePath);
 			if (result.isError) return decision;
 			const notice = lspGateNotice(sessionId, filePath);
-			if (notice === void 0) return decision;
-			const record = decision;
-			if (record.kind !== "accept") return decision;
-			record.content = [...record.content ?? result.content ?? [], {
-				type: "text",
-				text: `\n${notice}`
-			}];
-			return decision;
+			if (notice !== void 0) suffixes.push(notice);
+			const ast = astReminderNotice(sessionId, name$1, args);
+			if (ast !== void 0) suffixes.push(ast);
+			return appendSuffixes(decision, result, suffixes);
 		}));
+		disposers.push(() => disposeAstReminders(sessionId));
 		disposers.push(() => disposeLspGate(sessionId));
 		return () => {
 			for (const dispose of disposers) dispose();
@@ -7181,8 +7285,8 @@ function apply(ctx, config) {
 	const httpHandler = createHttpHandler();
 	for (const scheme of HTTP_SCHEMES) resolver.register(scheme, httpHandler);
 	const registered = /* @__PURE__ */ new WeakSet();
-	ctx.on("agent/session-start", ({ agent }) => {
-		if (registered.has(agent)) return;
+	ctx.on("agent/created", ({ agent }) => {
+		if (registered.has(agent)) return void 0;
 		registered.add(agent);
 		installAgentTools(ctx, agent, resolver, resolveGates(config)).catch((error) => {
 			ctx.logger("dsh-url-schemes").warn(`failed to install URL-aware tools for agent ${agent.id}: ${error instanceof Error ? error.message : String(error)}`);

package/lib/{web-trust-CgpBoFv3.d.ts → web-trust-BihHCelF.d.ts}

@@ -73,11 +73,11 @@ interface TrustConfig {
   trustedPageAuthorities?: readonly string[];
 }
 /** Row config schema (schema-level default derives from `DSH_TRUSTED_HOSTS`). */
-declare const Config: z<Schemastery.ObjectS<{
-  trustedPageAuthorities: z<string[], string[]>;
-}>, Schemastery.ObjectT<{
-  trustedPageAuthorities: z<string[], string[]>;
-}>>;
+declare const Config: z<Schemastery.ObjectS<NoInfer<{
+  trustedPageAuthorities: z<string[], string[], "defined">;
+}>>, Schemastery.ObjectT<NoInfer<{
+  trustedPageAuthorities: z<string[], string[], "defined">;
+}>>, "plain">;
 /** Cordis plugin name. */
 declare const name = "dashr-web-trust";
 /**
@@ -95,11 +95,11 @@ declare function apply(ctx: Context, config: TrustConfig | undefined): void;
 declare const _default: {
   name: string;
   inject: string[];
-  Config: z<Schemastery.ObjectS<{
-    trustedPageAuthorities: z<string[], string[]>;
-  }>, Schemastery.ObjectT<{
-    trustedPageAuthorities: z<string[], string[]>;
-  }>>;
+  Config: z<Schemastery.ObjectS<NoInfer<{
+    trustedPageAuthorities: z<string[], string[], "defined">;
+  }>>, Schemastery.ObjectT<NoInfer<{
+    trustedPageAuthorities: z<string[], string[], "defined">;
+  }>>, "plain">;
   apply: typeof apply;
 };
 //#endregion

package/lib/web-trust.d.ts

@@ -1,2 +1,2 @@
-import { a as _default, c as buildTrustScript, d as name, i as TrustConfig, l as deriveDefaultPageAuthorities, n as Config, o as apply, r as MobileConfig, s as buildMobileScript, t as BootScriptRow, u as inject } from "./web-trust-CgpBoFv3.js";
+import { a as _default, c as buildTrustScript, d as name, i as TrustConfig, l as deriveDefaultPageAuthorities, n as Config, o as apply, r as MobileConfig, s as buildMobileScript, t as BootScriptRow, u as inject } from "./web-trust-BihHCelF.js";
 export { BootScriptRow, Config, MobileConfig, TrustConfig, apply, buildMobileScript, buildTrustScript, _default as default, deriveDefaultPageAuthorities, inject, name };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "better-dsh",
-  "version": "0.2.4-a",
+  "version": "0.2.4-c",
   "description": "Make your dsh ready for serious coding tasks. (Tools x Schemas)^REPL. `skill://`, `ctx://`, `agent://`, `dvc://`, `dsh://`, IPython REPL, Context as Variables, cross compactions recallable, full context revive. `hash-edit`, `dvc://browser`, subagent as function, workflow as function.",
   "type": "module",
   "main": "lib/index.js",
@@ -34,6 +34,10 @@
       "types": "./lib/mobile/plugin.d.ts",
       "default": "./lib/mobile/plugin.js"
     },
+    "./remote": {
+      "types": "./lib/remote/plugin.d.ts",
+      "default": "./lib/remote/plugin.js"
+    },
     "./fs-aware-sandbox": {
       "types": "./lib/fs-aware/sandbox-plugin.d.ts",
       "default": "./lib/fs-aware/sandbox-plugin.js"
@@ -57,7 +61,9 @@
   "scripts": {
     "prebuild": "node scripts/copy-docs.mjs",
     "build": "tsdown && npm run build-client",
-    "typecheck": "tsc --noEmit",
+    "typecheck": "npm run typecheck:host && npm run typecheck:client",
+    "typecheck:host": "tsc --noEmit",
+    "typecheck:client": "tsc -p tsconfig.client.json",
     "test": "vitest --run",
     "test:watch": "vitest",
     "kernel:venv": "node scripts/kernel-provision.mjs",
@@ -332,11 +338,13 @@
   },
   "devDependencies": {
     "@types/node": "^22.10.5",
+    "@types/react": "~18.3.31",
     "node-addon-require-builtin": "^0.1.5",
+    "react": "^18.3.1",
     "tsdown": "^0.15.7",
+    "tsx": "^4.22.4",
     "typescript": "^5.9.3",
-    "vitest": "^4.1.10",
-    "tsx": "^4.22.4"
+    "vitest": "^4.1.10"
   },
   "repository": {
     "type": "git",