yandecode 0.1.0 → 0.2.0

package/dist/chunks/runtime-7CRR63B5.js

@@ -0,0 +1,395 @@
+import { createRequire as __yandecodeCreateRequire } from 'node:module';
+const require = __yandecodeCreateRequire(import.meta.url);
+import {
+  digest,
+  execShell
+} from "./chunk-6J5CZVCJ.js";
+import {
+  parseSettings,
+  requireWorkspace
+} from "./chunk-QCQC73WX.js";
+import {
+  contextSettings,
+  fetchInput,
+  getInput,
+  runInput,
+  searchInput2 as searchInput
+} from "./chunk-7L6DD2VD.js";
+import {
+  fitRows
+} from "./chunk-OIAMKDTQ.js";
+import {
+  external_exports,
+  openModuleDb,
+  resolveInsideRoot,
+  toFtsQuery
+} from "./chunk-Y2MIXROU.js";
+
+// packages/cli/src/modules/context/runtime.ts
+import { join } from "node:path";
+
+// packages/cli/src/modules/context/classify.ts
+var VERBOSE_PATTERNS = [
+  /^(npm|pnpm|yarn|bun) (run )?(test|build|lint|typecheck|check)\b/,
+  /^npx (vitest|jest|tsc|eslint|mocha|playwright)\b/,
+  /^(vitest|jest|mocha|pytest|tox|phpunit|rspec)\b/,
+  /^(cargo|go) (test|build|clippy)\b/,
+  /^(mvn|gradle|\.\/gradlew|make|cmake|ctest|dotnet (test|build))\b/,
+  /^(docker|kubectl|podman) logs\b/,
+  /^journalctl\b/,
+  /^find \//
+];
+function stripQuoted(command) {
+  return command.replace(/'[^']*'|"(?:\\.|[^"\\])*"/g, "''");
+}
+function segments(command) {
+  return command.split(/&&|\|\||;|\|/).map((s) => s.trim().replace(/^(sudo\s+|(\w+=\S*\s+)+)/, "")).filter((s) => s.length > 0);
+}
+function isNetworkPrint(segment, redirected) {
+  if (/^curl\b/.test(segment)) {
+    return !redirected && !/\s(-o|--output|-O|--remote-name)\b/.test(segment);
+  }
+  return /^wget\b/.test(segment) && /\s-\w*O\s*-(\s|$)/.test(`${segment} `);
+}
+function isUnboundedGitLog(segment) {
+  return /^git log\b/.test(segment) && !/\s(-n\s*\d+|-\d+|--max-count)/.test(segment);
+}
+function classifyCommand(command) {
+  const bare = stripQuoted(command);
+  const redirected = /[^2&]>\s*[^&\s]/.test(` ${bare}`);
+  const parts = segments(bare);
+  if (parts.some((s) => isNetworkPrint(s, redirected))) return "network";
+  if (parts.some((s) => VERBOSE_PATTERNS.some((p) => p.test(s)) || isUnboundedGitLog(s))) {
+    return "verbose";
+  }
+  return "plain";
+}
+
+// packages/cli/src/modules/context/html.ts
+var ENTITIES = {
+  amp: "&",
+  lt: "<",
+  gt: ">",
+  quot: '"',
+  apos: "'",
+  nbsp: " "
+};
+function decodeEntities(text) {
+  return text.replace(/&(#x[0-9a-f]+|#\d+|[a-z]+);/gi, (match, entity) => {
+    if (entity.startsWith("#x") || entity.startsWith("#X"))
+      return String.fromCodePoint(parseInt(entity.slice(2), 16));
+    if (entity.startsWith("#")) return String.fromCodePoint(Number(entity.slice(1)));
+    return ENTITIES[entity.toLowerCase()] ?? match;
+  });
+}
+var BLOCK = "p|div|ul|ol|table|section|article|header|footer|main|nav|pre|blockquote|figure|dl";
+function htmlToText(html) {
+  const text = html.replace(/<(script|style|noscript|svg|template|head)\b[\s\S]*?<\/\1>/gi, "").replace(/<!--[\s\S]*?-->/g, "").replace(/<h([1-6])\b[^>]*>/gi, (_, level) => `
+
+${"#".repeat(Number(level))} `).replace(/<\/h[1-6]>/gi, "\n\n").replace(/<li\b[^>]*>/gi, "\n- ").replace(new RegExp(`</?(${BLOCK})\\b[^>]*>`, "gi"), "\n\n").replace(/<(br|tr)\b[^>]*>/gi, "\n").replace(/<[^>]+>/g, "");
+  return decodeEntities(text).split("\n").map((line) => line.replace(/[ \t\f\v]+/g, " ").trim()).join("\n").replace(/\n{3,}/g, "\n\n").trim();
+}
+
+// packages/cli/src/modules/context/store.ts
+import { randomBytes } from "node:crypto";
+import { mkdirSync } from "node:fs";
+import { dirname } from "node:path";
+var CHUNK_LINES = 20;
+var MIGRATIONS = [
+  `
+  CREATE TABLE outputs (
+    handle TEXT PRIMARY KEY,
+    source TEXT NOT NULL,
+    label TEXT NOT NULL,
+    exit_code INTEGER,
+    duration_ms INTEGER NOT NULL,
+    created_at TEXT NOT NULL,
+    line_count INTEGER NOT NULL,
+    byte_count INTEGER NOT NULL,
+    body TEXT NOT NULL
+  );
+  CREATE INDEX outputs_created ON outputs (created_at);
+  CREATE VIRTUAL TABLE output_fts USING fts5 (
+    text, handle UNINDEXED, start_line UNINDEXED, end_line UNINDEXED,
+    tokenize = 'porter unicode61'
+  );
+  CREATE TABLE session_hints (session_id TEXT NOT NULL, kind TEXT NOT NULL, PRIMARY KEY (session_id, kind));
+  `
+];
+var OutputStore = class _OutputStore {
+  constructor(db) {
+    this.db = db;
+  }
+  db;
+  static open(file) {
+    mkdirSync(dirname(file), { recursive: true });
+    return new _OutputStore(openModuleDb(file, MIGRATIONS));
+  }
+  close() {
+    this.db.close();
+  }
+  save(input) {
+    const handle = `o${randomBytes(3).toString("hex")}`;
+    const lines = input.text.split("\n");
+    this.db.transaction(() => {
+      this.db.prepare(
+        "INSERT INTO outputs (handle, source, label, exit_code, duration_ms, created_at, line_count, byte_count, body) VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?)"
+      ).run(
+        handle,
+        input.source,
+        input.label,
+        input.exitCode,
+        input.durationMs,
+        (/* @__PURE__ */ new Date()).toISOString(),
+        lines.length,
+        Buffer.byteLength(input.text),
+        input.text
+      );
+      const insert = this.db.prepare(
+        "INSERT INTO output_fts (text, handle, start_line, end_line) VALUES (?, ?, ?, ?)"
+      );
+      for (let start = 0; start < lines.length; start += CHUNK_LINES) {
+        const end = Math.min(start + CHUNK_LINES, lines.length);
+        insert.run(lines.slice(start, end).join("\n"), handle, start + 1, end);
+      }
+    })();
+    return handle;
+  }
+  get(handle) {
+    const row = this.db.prepare(
+      "SELECT handle, source, label, exit_code, duration_ms, created_at, line_count, byte_count FROM outputs WHERE handle = ?"
+    ).get(handle);
+    if (!row) return null;
+    return {
+      handle: row.handle,
+      source: row.source,
+      label: row.label,
+      exitCode: row.exit_code,
+      durationMs: row.duration_ms,
+      createdAt: row.created_at,
+      lineCount: row.line_count,
+      byteCount: row.byte_count
+    };
+  }
+  /** 1-based inclusive line range, verbatim. */
+  lines(handle, from, to) {
+    const row = this.db.prepare("SELECT body FROM outputs WHERE handle = ?").get(handle);
+    if (!row) return [];
+    return row.body.split("\n").slice(Math.max(0, from - 1), Math.max(0, to));
+  }
+  search(query, options = {}) {
+    const fts = toFtsQuery(query);
+    if (!fts) return [];
+    const filter = options.handle ? "AND f.handle = ?" : "";
+    const params = [
+      fts,
+      ...options.handle ? [options.handle] : [],
+      options.limit ?? 8
+    ];
+    return this.db.prepare(
+      `SELECT f.handle, o.label, f.start_line, f.end_line,
+                  snippet(output_fts, 0, '', '', ' \u2026 ', 14) AS snippet
+           FROM output_fts f JOIN outputs o ON o.handle = f.handle
+           WHERE output_fts MATCH ? ${filter} ORDER BY rank LIMIT ?`
+    ).all(...params).map((r) => ({
+      handle: r.handle,
+      label: r.label,
+      startLine: r.start_line,
+      endLine: r.end_line,
+      snippet: r.snippet.replace(/\s+/g, " ").trim()
+    }));
+  }
+  recent(limit) {
+    const handles = this.db.prepare("SELECT handle FROM outputs ORDER BY created_at DESC LIMIT ?").all(limit);
+    return handles.flatMap((h) => this.get(h.handle) ?? []);
+  }
+  purgeOlderThan(cutoff) {
+    const old = this.db.prepare("SELECT handle FROM outputs WHERE created_at < ?").all(cutoff.toISOString());
+    this.db.transaction(() => {
+      for (const { handle } of old) {
+        this.db.prepare("DELETE FROM output_fts WHERE handle = ?").run(handle);
+        this.db.prepare("DELETE FROM outputs WHERE handle = ?").run(handle);
+      }
+    })();
+    return old.length;
+  }
+  /** True the first time `kind` is requested for a session: used for one-time hints. */
+  firstTimeInSession(sessionId, kind) {
+    return this.db.prepare("INSERT OR IGNORE INTO session_hints (session_id, kind) VALUES (?, ?)").run(sessionId, kind).changes === 1;
+  }
+};
+
+// packages/cli/src/modules/context/runtime.ts
+var DAY_MS = 864e5;
+var stores = /* @__PURE__ */ new Map();
+function settingsOf(ctx) {
+  return parseSettings("context", contextSettings, ctx.settings);
+}
+function storeFor(ctx) {
+  let store = stores.get(ctx.root);
+  if (!store) {
+    store = OutputStore.open(join(ctx.paths.yandecodeDir, "context.db"));
+    store.purgeOlderThan(new Date(Date.now() - settingsOf(ctx).retentionDays * DAY_MS));
+    stores.set(ctx.root, store);
+  }
+  return store;
+}
+function formatBytes(bytes) {
+  return bytes < 1024 ? `${bytes} B` : bytes < 1048576 ? `${(bytes / 1024).toFixed(0)} KB` : `${(bytes / 1048576).toFixed(1)} MB`;
+}
+function header(meta, extra = []) {
+  const facts = [
+    meta.exitCode === null ? null : `exit ${meta.exitCode}`,
+    `${meta.lineCount} lines`,
+    formatBytes(meta.byteCount),
+    meta.source === "run" ? `${(meta.durationMs / 1e3).toFixed(1)} s` : null,
+    `handle ${meta.handle}`,
+    ...extra
+  ].filter((f) => f !== null);
+  return `${meta.source === "run" ? "$" : "GET"} ${meta.label}  (${facts.join(" \xB7 ")})`;
+}
+function answer(store, handle, text, intent, maxChars, notes) {
+  const meta = store.get(handle);
+  const focus = intent ? store.search(intent, { handle, limit: 5 }).flatMap(
+    (hit) => Array.from({ length: hit.endLine - hit.startLine + 1 }, (_, i) => hit.startLine - 1 + i)
+  ) : [];
+  const body = digest(text, { maxChars: maxChars - 400, focus });
+  const footer = body.omittedLines > 0 ? `\u2014 ${body.omittedLines} line(s) not shown; full output kept: ctx_search(query, handle="${handle}") or ctx_get(handle="${handle}", from, to)` : "";
+  return { text: [header(meta, notes), body.text, footer].filter(Boolean).join("\n") };
+}
+async function ctxRun(raw, ctx) {
+  const args = external_exports.object(runInput).parse(raw);
+  const settings = settingsOf(ctx);
+  const cwd = args.cwd ? resolveInsideRoot(ctx.root, args.cwd) : ctx.root;
+  const result = await execShell(args.command, {
+    cwd,
+    timeoutMs: (args.timeout_s ?? 120) * 1e3,
+    maxBytes: settings.maxOutputMb * 1048576
+  });
+  const store = storeFor(ctx);
+  const handle = store.save({
+    source: "run",
+    label: args.command,
+    exitCode: result.exitCode,
+    durationMs: result.durationMs,
+    text: result.output
+  });
+  const notes = [
+    result.timedOut ? `killed after ${args.timeout_s ?? 120} s` : null,
+    result.truncatedBytes > 0 ? `${formatBytes(result.truncatedBytes)} beyond the ${settings.maxOutputMb} MB cap discarded` : null
+  ].filter((n) => n !== null);
+  return answer(store, handle, result.output, args.intent, args.max_chars ?? 3e3, notes);
+}
+async function ctxFetch(raw, ctx) {
+  const args = external_exports.object(fetchInput).parse(raw);
+  const started = Date.now();
+  const response = await fetch(args.url, {
+    signal: AbortSignal.timeout(3e4),
+    headers: {
+      "user-agent": "yandecode-ctx-fetch",
+      accept: "text/html,application/json,text/plain,*/*"
+    }
+  });
+  const type = response.headers.get("content-type") ?? "";
+  const raw_ = await response.text();
+  const text = type.includes("html") ? htmlToText(raw_) : type.includes("json") ? JSON.stringify(JSON.parse(raw_), null, 2) : raw_;
+  const store = storeFor(ctx);
+  const handle = store.save({
+    source: "fetch",
+    label: args.url,
+    exitCode: response.ok ? null : response.status,
+    durationMs: Date.now() - started,
+    text
+  });
+  const notes = response.ok ? [] : [`HTTP ${response.status}`];
+  return answer(store, handle, text, args.intent, args.max_chars ?? 3e3, notes);
+}
+function ctxSearch(raw, ctx) {
+  const args = external_exports.object(searchInput).parse(raw);
+  const store = storeFor(ctx);
+  const hits = store.search(args.query, {
+    ...args.handle ? { handle: args.handle } : {},
+    limit: args.limit ?? 8
+  });
+  if (hits.length === 0) {
+    const recent = store.recent(5).map((o) => `  ${o.handle} ${o.label}`);
+    return Promise.resolve({
+      text: [
+        `No stored output matches "${args.query}".`,
+        ...recent.length > 0 ? ["Recent outputs:", ...recent] : []
+      ].join("\n")
+    });
+  }
+  const rows = hits.map(
+    (h) => `${h.handle}:${h.startLine}-${h.endLine} (${h.label.slice(0, 60)}) ${h.snippet}`
+  );
+  return Promise.resolve({ text: fitRows(`ctx_search "${args.query}"`, rows, 3e3) });
+}
+function ctxGet(raw, ctx) {
+  const args = external_exports.object(getInput).parse(raw);
+  const store = storeFor(ctx);
+  const meta = store.get(args.handle);
+  if (!meta)
+    return Promise.resolve({
+      isError: true,
+      text: `Unknown handle "${args.handle}" (outputs expire after a few days; re-run the command).`
+    });
+  const from = args.from ?? 1;
+  const to = Math.min(args.to ?? from + 199, meta.lineCount);
+  const rows = store.lines(args.handle, from, to).map((line, i) => `${from + i}: ${line}`);
+  return Promise.resolve({
+    text: fitRows(header(meta, [`lines ${from}-${to}`]), rows, args.max_chars ?? 8e3)
+  });
+}
+var NETWORK_DENY = "Its response would enter the context unfiltered. Use ctx_fetch(url, intent) for web pages and APIs, or ctx_run(command, intent) to keep the full response searchable. To really print it, write to a file (-o file) and read the part you need.";
+var VERBOSE_HINT = "yandecode: this command can print a lot. Prefer ctx_run(command, intent): it runs to completion, keeps the full output (ctx_search/ctx_get) and returns only the failing or relevant lines.";
+var BACKGROUND_HINT = "yandecode: this test/build is going to the background. If you stop to wait for it, the session can end before you see the result. Run it with ctx_run(command, intent) instead: it waits for completion and returns only what matters.";
+function preToolUse(input, ctx) {
+  const command = input.tool_input?.command;
+  if (typeof command !== "string") return Promise.resolve({ kind: "none" });
+  const settings = settingsOf(ctx);
+  const kind = classifyCommand(command);
+  if (kind === "network" && settings.denyNetworkFetch) {
+    ctx.log("deny", { command });
+    return Promise.resolve({ kind: "deny", reason: NETWORK_DENY });
+  }
+  if (kind !== "verbose" || !settings.hints) return Promise.resolve({ kind: "none" });
+  const background = input.tool_input?.run_in_background === true;
+  const hint = background ? "background" : "verbose";
+  if (storeFor(ctx).firstTimeInSession(input.session_id ?? "unknown", hint)) {
+    return Promise.resolve({ kind: "context", text: background ? BACKGROUND_HINT : VERBOSE_HINT });
+  }
+  return Promise.resolve({ kind: "none" });
+}
+var runtime = {
+  tools: { ctx_run: ctxRun, ctx_fetch: ctxFetch, ctx_search: ctxSearch, ctx_get: ctxGet },
+  hooks: { PreToolUse: preToolUse },
+  doctor: (ctx) => {
+    const recent = storeFor(ctx).recent(1)[0];
+    return Promise.resolve([
+      {
+        name: "output store",
+        status: "ok",
+        detail: recent ? `last output ${recent.createdAt} (${recent.label.slice(0, 40)})` : "empty"
+      }
+    ]);
+  },
+  dispose: () => {
+    for (const store of stores.values()) store.close();
+    stores.clear();
+    return Promise.resolve();
+  }
+};
+function runPurgeCommand(cwd) {
+  const ws = requireWorkspace(cwd);
+  const store = OutputStore.open(join(ws.paths.yandecodeDir, "context.db"));
+  const removed = store.purgeOlderThan(new Date(Date.now() + DAY_MS));
+  store.close();
+  process.stdout.write(`removed ${removed} stored output(s)
+`);
+}
+export {
+  runPurgeCommand,
+  runtime
+};
+//# sourceMappingURL=runtime-7CRR63B5.js.map

package/dist/chunks/runtime-7CRR63B5.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../src/modules/context/runtime.ts", "../../src/modules/context/classify.ts", "../../src/modules/context/html.ts", "../../src/modules/context/store.ts"],
+  "sourcesContent": ["import { join } from 'node:path';\nimport { resolveInsideRoot } from '@yandecode/core';\nimport { z } from 'zod';\nimport { fitRows } from '@cli/shared/budget';\nimport type { HookResult, ModuleContext, ModuleRuntime, ToolResult } from '@cli/modules/contract';\nimport { parseSettings, requireWorkspace } from '@cli/modules/host';\nimport { classifyCommand } from './classify';\nimport { contextSettings, fetchInput, getInput, runInput, searchInput } from './definition';\nimport { digest } from '@cli/shared/digest';\nimport { execShell } from '@cli/shared/exec';\nimport { htmlToText } from './html';\nimport { OutputStore, type StoredOutput } from './store';\n\nconst DAY_MS = 86_400_000;\nconst stores = new Map<string, OutputStore>();\n\nfunction settingsOf(ctx: ModuleContext): z.infer<typeof contextSettings> {\n  return parseSettings('context', contextSettings, ctx.settings);\n}\n\n/** One store per workspace per process; expired outputs are purged when it opens. */\nfunction storeFor(ctx: ModuleContext): OutputStore {\n  let store = stores.get(ctx.root);\n  if (!store) {\n    store = OutputStore.open(join(ctx.paths.yandecodeDir, 'context.db'));\n    store.purgeOlderThan(new Date(Date.now() - settingsOf(ctx).retentionDays * DAY_MS));\n    stores.set(ctx.root, store);\n  }\n  return store;\n}\n\nfunction formatBytes(bytes: number): string {\n  return bytes < 1024\n    ? `${bytes} B`\n    : bytes < 1_048_576\n      ? `${(bytes / 1024).toFixed(0)} KB`\n      : `${(bytes / 1_048_576).toFixed(1)} MB`;\n}\n\nfunction header(meta: StoredOutput, extra: string[] = []): string {\n  const facts = [\n    meta.exitCode === null ? null : `exit ${meta.exitCode}`,\n    `${meta.lineCount} lines`,\n    formatBytes(meta.byteCount),\n    meta.source === 'run' ? `${(meta.durationMs / 1000).toFixed(1)} s` : null,\n    `handle ${meta.handle}`,\n    ...extra,\n  ].filter((f): f is string => f !== null);\n  return `${meta.source === 'run' ? '$' : 'GET'} ${meta.label}  (${facts.join(' \u00B7 ')})`;\n}\n\n/** Stores the full text and answers with a digest focused on `intent` when given. */\nfunction answer(\n  store: OutputStore,\n  handle: string,\n  text: string,\n  intent: string | undefined,\n  maxChars: number,\n  notes: string[],\n): ToolResult {\n  const meta = store.get(handle)!;\n  const focus = intent\n    ? store\n        .search(intent, { handle, limit: 5 })\n        .flatMap((hit) =>\n          Array.from({ length: hit.endLine - hit.startLine + 1 }, (_, i) => hit.startLine - 1 + i),\n        )\n    : [];\n  const body = digest(text, { maxChars: maxChars - 400, focus });\n  const footer =\n    body.omittedLines > 0\n      ? `\u2014 ${body.omittedLines} line(s) not shown; full output kept: ctx_search(query, handle=\"${handle}\") or ctx_get(handle=\"${handle}\", from, to)`\n      : '';\n  return { text: [header(meta, notes), body.text, footer].filter(Boolean).join('\\n') };\n}\n\nasync function ctxRun(raw: Record<string, unknown>, ctx: ModuleContext): Promise<ToolResult> {\n  const args = z.object(runInput).parse(raw);\n  const settings = settingsOf(ctx);\n  const cwd = args.cwd ? resolveInsideRoot(ctx.root, args.cwd) : ctx.root;\n  const result = await execShell(args.command, {\n    cwd,\n    timeoutMs: (args.timeout_s ?? 120) * 1000,\n    maxBytes: settings.maxOutputMb * 1_048_576,\n  });\n  const store = storeFor(ctx);\n  const handle = store.save({\n    source: 'run',\n    label: args.command,\n    exitCode: result.exitCode,\n    durationMs: result.durationMs,\n    text: result.output,\n  });\n  const notes = [\n    result.timedOut ? `killed after ${args.timeout_s ?? 120} s` : null,\n    result.truncatedBytes > 0\n      ? `${formatBytes(result.truncatedBytes)} beyond the ${settings.maxOutputMb} MB cap discarded`\n      : null,\n  ].filter((n): n is string => n !== null);\n  return answer(store, handle, result.output, args.intent, args.max_chars ?? 3_000, notes);\n}\n\nasync function ctxFetch(raw: Record<string, unknown>, ctx: ModuleContext): Promise<ToolResult> {\n  const args = z.object(fetchInput).parse(raw);\n  const started = Date.now();\n  const response = await fetch(args.url, {\n    signal: AbortSignal.timeout(30_000),\n    headers: {\n      'user-agent': 'yandecode-ctx-fetch',\n      accept: 'text/html,application/json,text/plain,*/*',\n    },\n  });\n  const type = response.headers.get('content-type') ?? '';\n  const raw_ = await response.text();\n  const text = type.includes('html')\n    ? htmlToText(raw_)\n    : type.includes('json')\n      ? JSON.stringify(JSON.parse(raw_) as unknown, null, 2)\n      : raw_;\n  const store = storeFor(ctx);\n  const handle = store.save({\n    source: 'fetch',\n    label: args.url,\n    exitCode: response.ok ? null : response.status,\n    durationMs: Date.now() - started,\n    text,\n  });\n  const notes = response.ok ? [] : [`HTTP ${response.status}`];\n  return answer(store, handle, text, args.intent, args.max_chars ?? 3_000, notes);\n}\n\nfunction ctxSearch(raw: Record<string, unknown>, ctx: ModuleContext): Promise<ToolResult> {\n  const args = z.object(searchInput).parse(raw);\n  const store = storeFor(ctx);\n  const hits = store.search(args.query, {\n    ...(args.handle ? { handle: args.handle } : {}),\n    limit: args.limit ?? 8,\n  });\n  if (hits.length === 0) {\n    const recent = store.recent(5).map((o) => `  ${o.handle} ${o.label}`);\n    return Promise.resolve({\n      text: [\n        `No stored output matches \"${args.query}\".`,\n        ...(recent.length > 0 ? ['Recent outputs:', ...recent] : []),\n      ].join('\\n'),\n    });\n  }\n  const rows = hits.map(\n    (h) => `${h.handle}:${h.startLine}-${h.endLine} (${h.label.slice(0, 60)}) ${h.snippet}`,\n  );\n  return Promise.resolve({ text: fitRows(`ctx_search \"${args.query}\"`, rows, 3_000) });\n}\n\nfunction ctxGet(raw: Record<string, unknown>, ctx: ModuleContext): Promise<ToolResult> {\n  const args = z.object(getInput).parse(raw);\n  const store = storeFor(ctx);\n  const meta = store.get(args.handle);\n  if (!meta)\n    return Promise.resolve({\n      isError: true,\n      text: `Unknown handle \"${args.handle}\" (outputs expire after a few days; re-run the command).`,\n    });\n  const from = args.from ?? 1;\n  const to = Math.min(args.to ?? from + 199, meta.lineCount);\n  const rows = store.lines(args.handle, from, to).map((line, i) => `${from + i}: ${line}`);\n  return Promise.resolve({\n    text: fitRows(header(meta, [`lines ${from}-${to}`]), rows, args.max_chars ?? 8_000),\n  });\n}\n\nconst NETWORK_DENY =\n  'Its response would enter the context unfiltered. Use ctx_fetch(url, intent) for web pages and APIs, or ctx_run(command, intent) to keep the full response searchable. To really print it, write to a file (-o file) and read the part you need.';\nconst VERBOSE_HINT =\n  'yandecode: this command can print a lot. Prefer ctx_run(command, intent): it runs to completion, keeps the full output (ctx_search/ctx_get) and returns only the failing or relevant lines.';\nconst BACKGROUND_HINT =\n  'yandecode: this test/build is going to the background. If you stop to wait for it, the session can end before you see the result. Run it with ctx_run(command, intent) instead: it waits for completion and returns only what matters.';\n\nfunction preToolUse(\n  input: { session_id?: string; tool_input?: Record<string, unknown> },\n  ctx: ModuleContext,\n): Promise<HookResult> {\n  const command = input.tool_input?.command;\n  if (typeof command !== 'string') return Promise.resolve({ kind: 'none' });\n  const settings = settingsOf(ctx);\n  const kind = classifyCommand(command);\n  if (kind === 'network' && settings.denyNetworkFetch) {\n    ctx.log('deny', { command });\n    return Promise.resolve({ kind: 'deny', reason: NETWORK_DENY });\n  }\n  if (kind !== 'verbose' || !settings.hints) return Promise.resolve({ kind: 'none' });\n  // A background test run is the costlier habit (sessions ended before seeing results in the\n  // pacolang A/B), so it gets its own hint even after the generic one was shown.\n  const background = input.tool_input?.run_in_background === true;\n  const hint = background ? 'background' : 'verbose';\n  if (storeFor(ctx).firstTimeInSession(input.session_id ?? 'unknown', hint)) {\n    return Promise.resolve({ kind: 'context', text: background ? BACKGROUND_HINT : VERBOSE_HINT });\n  }\n  return Promise.resolve({ kind: 'none' });\n}\n\nexport const runtime: ModuleRuntime = {\n  tools: { ctx_run: ctxRun, ctx_fetch: ctxFetch, ctx_search: ctxSearch, ctx_get: ctxGet },\n  hooks: { PreToolUse: preToolUse },\n  doctor: (ctx) => {\n    const recent = storeFor(ctx).recent(1)[0];\n    return Promise.resolve([\n      {\n        name: 'output store',\n        status: 'ok',\n        detail: recent ? `last output ${recent.createdAt} (${recent.label.slice(0, 40)})` : 'empty',\n      },\n    ]);\n  },\n  dispose: () => {\n    for (const store of stores.values()) store.close();\n    stores.clear();\n    return Promise.resolve();\n  },\n};\n\nexport function runPurgeCommand(cwd: string): void {\n  const ws = requireWorkspace(cwd);\n  const store = OutputStore.open(join(ws.paths.yandecodeDir, 'context.db'));\n  const removed = store.purgeOlderThan(new Date(Date.now() + DAY_MS));\n  store.close();\n  process.stdout.write(`removed ${removed} stored output(s)\\n`);\n}\n", "/**\n * Coarse classification of a shell command for the PreToolUse hook (ADR-019):\n * - `network`: prints a remote resource to stdout (curl/wget without an output file);\n * - `verbose`: commands whose output is routinely long (tests, builds, logs, history);\n * - `plain`: everything else.\n * Quoted text is ignored so `echo \"curl \u2026\"` or `--body \"run npm test\"` never match.\n */\nexport type CommandKind = 'network' | 'verbose' | 'plain';\n\nconst VERBOSE_PATTERNS: readonly RegExp[] = [\n  /^(npm|pnpm|yarn|bun) (run )?(test|build|lint|typecheck|check)\\b/,\n  /^npx (vitest|jest|tsc|eslint|mocha|playwright)\\b/,\n  /^(vitest|jest|mocha|pytest|tox|phpunit|rspec)\\b/,\n  /^(cargo|go) (test|build|clippy)\\b/,\n  /^(mvn|gradle|\\.\\/gradlew|make|cmake|ctest|dotnet (test|build))\\b/,\n  /^(docker|kubectl|podman) logs\\b/,\n  /^journalctl\\b/,\n  /^find \\//,\n];\n\nfunction stripQuoted(command: string): string {\n  return command.replace(/'[^']*'|\"(?:\\\\.|[^\"\\\\])*\"/g, \"''\");\n}\n\nfunction segments(command: string): string[] {\n  return command\n    .split(/&&|\\|\\||;|\\|/)\n    .map((s) => s.trim().replace(/^(sudo\\s+|(\\w+=\\S*\\s+)+)/, ''))\n    .filter((s) => s.length > 0);\n}\n\nfunction isNetworkPrint(segment: string, redirected: boolean): boolean {\n  if (/^curl\\b/.test(segment)) {\n    return !redirected && !/\\s(-o|--output|-O|--remote-name)\\b/.test(segment);\n  }\n  // Plain `wget URL` saves to a file; only `-O -` / `-qO-` prints to stdout.\n  return /^wget\\b/.test(segment) && /\\s-\\w*O\\s*-(\\s|$)/.test(`${segment} `);\n}\n\nfunction isUnboundedGitLog(segment: string): boolean {\n  return /^git log\\b/.test(segment) && !/\\s(-n\\s*\\d+|-\\d+|--max-count)/.test(segment);\n}\n\nexport function classifyCommand(command: string): CommandKind {\n  const bare = stripQuoted(command);\n  const redirected = /[^2&]>\\s*[^&\\s]/.test(` ${bare}`);\n  const parts = segments(bare);\n  if (parts.some((s) => isNetworkPrint(s, redirected))) return 'network';\n  if (parts.some((s) => VERBOSE_PATTERNS.some((p) => p.test(s)) || isUnboundedGitLog(s))) {\n    return 'verbose';\n  }\n  return 'plain';\n}\n", "const ENTITIES: Readonly<Record<string, string>> = {\n  amp: '&',\n  lt: '<',\n  gt: '>',\n  quot: '\"',\n  apos: \"'\",\n  nbsp: ' ',\n};\n\nfunction decodeEntities(text: string): string {\n  return text.replace(/&(#x[0-9a-f]+|#\\d+|[a-z]+);/gi, (match, entity: string) => {\n    if (entity.startsWith('#x') || entity.startsWith('#X'))\n      return String.fromCodePoint(parseInt(entity.slice(2), 16));\n    if (entity.startsWith('#')) return String.fromCodePoint(Number(entity.slice(1)));\n    return ENTITIES[entity.toLowerCase()] ?? match;\n  });\n}\n\nconst BLOCK = 'p|div|ul|ol|table|section|article|header|footer|main|nav|pre|blockquote|figure|dl';\n\n/** Readable text from HTML without a DOM: headings become `#`, list items `- `, blocks paragraphs. */\nexport function htmlToText(html: string): string {\n  const text = html\n    .replace(/<(script|style|noscript|svg|template|head)\\b[\\s\\S]*?<\\/\\1>/gi, '')\n    .replace(/<!--[\\s\\S]*?-->/g, '')\n    .replace(/<h([1-6])\\b[^>]*>/gi, (_, level: string) => `\\n\\n${'#'.repeat(Number(level))} `)\n    .replace(/<\\/h[1-6]>/gi, '\\n\\n')\n    .replace(/<li\\b[^>]*>/gi, '\\n- ')\n    .replace(new RegExp(`</?(${BLOCK})\\\\b[^>]*>`, 'gi'), '\\n\\n')\n    .replace(/<(br|tr)\\b[^>]*>/gi, '\\n')\n    .replace(/<[^>]+>/g, '');\n  return decodeEntities(text)\n    .split('\\n')\n    .map((line) => line.replace(/[ \\t\\f\\v]+/g, ' ').trim())\n    .join('\\n')\n    .replace(/\\n{3,}/g, '\\n\\n')\n    .trim();\n}\n", "import { randomBytes } from 'node:crypto';\nimport { mkdirSync } from 'node:fs';\nimport { dirname } from 'node:path';\nimport { openModuleDb, toFtsQuery, type Database } from '@yandecode/core';\n\nconst CHUNK_LINES = 20;\n\nconst MIGRATIONS: readonly string[] = [\n  `\n  CREATE TABLE outputs (\n    handle TEXT PRIMARY KEY,\n    source TEXT NOT NULL,\n    label TEXT NOT NULL,\n    exit_code INTEGER,\n    duration_ms INTEGER NOT NULL,\n    created_at TEXT NOT NULL,\n    line_count INTEGER NOT NULL,\n    byte_count INTEGER NOT NULL,\n    body TEXT NOT NULL\n  );\n  CREATE INDEX outputs_created ON outputs (created_at);\n  CREATE VIRTUAL TABLE output_fts USING fts5 (\n    text, handle UNINDEXED, start_line UNINDEXED, end_line UNINDEXED,\n    tokenize = 'porter unicode61'\n  );\n  CREATE TABLE session_hints (session_id TEXT NOT NULL, kind TEXT NOT NULL, PRIMARY KEY (session_id, kind));\n  `,\n];\n\nexport interface SaveInput {\n  source: 'run' | 'fetch';\n  label: string;\n  exitCode: number | null;\n  durationMs: number;\n  text: string;\n}\n\nexport interface StoredOutput {\n  handle: string;\n  source: string;\n  label: string;\n  exitCode: number | null;\n  durationMs: number;\n  createdAt: string;\n  lineCount: number;\n  byteCount: number;\n}\n\nexport interface OutputHit {\n  handle: string;\n  label: string;\n  startLine: number;\n  endLine: number;\n  snippet: string;\n}\n\ninterface OutputRow {\n  handle: string;\n  source: string;\n  label: string;\n  exit_code: number | null;\n  duration_ms: number;\n  created_at: string;\n  line_count: number;\n  byte_count: number;\n}\n\n/**\n * Full command/web output kept out of the context window (ADR-019). Every line stays retrievable\n * verbatim by handle and range; FTS5 over 20-line chunks finds the relevant part later.\n */\nexport class OutputStore {\n  private constructor(private readonly db: Database) {}\n\n  static open(file: string): OutputStore {\n    mkdirSync(dirname(file), { recursive: true });\n    return new OutputStore(openModuleDb(file, MIGRATIONS));\n  }\n\n  close(): void {\n    this.db.close();\n  }\n\n  save(input: SaveInput): string {\n    const handle = `o${randomBytes(3).toString('hex')}`;\n    const lines = input.text.split('\\n');\n    this.db.transaction(() => {\n      this.db\n        .prepare(\n          'INSERT INTO outputs (handle, source, label, exit_code, duration_ms, created_at, line_count, byte_count, body) VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?)',\n        )\n        .run(\n          handle,\n          input.source,\n          input.label,\n          input.exitCode,\n          input.durationMs,\n          new Date().toISOString(),\n          lines.length,\n          Buffer.byteLength(input.text),\n          input.text,\n        );\n      const insert = this.db.prepare(\n        'INSERT INTO output_fts (text, handle, start_line, end_line) VALUES (?, ?, ?, ?)',\n      );\n      for (let start = 0; start < lines.length; start += CHUNK_LINES) {\n        const end = Math.min(start + CHUNK_LINES, lines.length);\n        insert.run(lines.slice(start, end).join('\\n'), handle, start + 1, end);\n      }\n    })();\n    return handle;\n  }\n\n  get(handle: string): StoredOutput | null {\n    const row = this.db\n      .prepare(\n        'SELECT handle, source, label, exit_code, duration_ms, created_at, line_count, byte_count FROM outputs WHERE handle = ?',\n      )\n      .get(handle) as OutputRow | undefined;\n    if (!row) return null;\n    return {\n      handle: row.handle,\n      source: row.source,\n      label: row.label,\n      exitCode: row.exit_code,\n      durationMs: row.duration_ms,\n      createdAt: row.created_at,\n      lineCount: row.line_count,\n      byteCount: row.byte_count,\n    };\n  }\n\n  /** 1-based inclusive line range, verbatim. */\n  lines(handle: string, from: number, to: number): string[] {\n    const row = this.db.prepare('SELECT body FROM outputs WHERE handle = ?').get(handle) as\n      { body: string } | undefined;\n    if (!row) return [];\n    return row.body.split('\\n').slice(Math.max(0, from - 1), Math.max(0, to));\n  }\n\n  search(query: string, options: { handle?: string; limit?: number } = {}): OutputHit[] {\n    const fts = toFtsQuery(query);\n    if (!fts) return [];\n    const filter = options.handle ? 'AND f.handle = ?' : '';\n    const params: unknown[] = [\n      fts,\n      ...(options.handle ? [options.handle] : []),\n      options.limit ?? 8,\n    ];\n    return (\n      this.db\n        .prepare(\n          `SELECT f.handle, o.label, f.start_line, f.end_line,\n                  snippet(output_fts, 0, '', '', ' \u2026 ', 14) AS snippet\n           FROM output_fts f JOIN outputs o ON o.handle = f.handle\n           WHERE output_fts MATCH ? ${filter} ORDER BY rank LIMIT ?`,\n        )\n        .all(...params) as {\n        handle: string;\n        label: string;\n        start_line: number;\n        end_line: number;\n        snippet: string;\n      }[]\n    ).map((r) => ({\n      handle: r.handle,\n      label: r.label,\n      startLine: r.start_line,\n      endLine: r.end_line,\n      snippet: r.snippet.replace(/\\s+/g, ' ').trim(),\n    }));\n  }\n\n  recent(limit: number): StoredOutput[] {\n    const handles = this.db\n      .prepare('SELECT handle FROM outputs ORDER BY created_at DESC LIMIT ?')\n      .all(limit) as { handle: string }[];\n    return handles.flatMap((h) => this.get(h.handle) ?? []);\n  }\n\n  purgeOlderThan(cutoff: Date): number {\n    const old = this.db\n      .prepare('SELECT handle FROM outputs WHERE created_at < ?')\n      .all(cutoff.toISOString()) as { handle: string }[];\n    this.db.transaction(() => {\n      for (const { handle } of old) {\n        this.db.prepare('DELETE FROM output_fts WHERE handle = ?').run(handle);\n        this.db.prepare('DELETE FROM outputs WHERE handle = ?').run(handle);\n      }\n    })();\n    return old.length;\n  }\n\n  /** True the first time `kind` is requested for a session: used for one-time hints. */\n  firstTimeInSession(sessionId: string, kind: string): boolean {\n    return (\n      this.db\n        .prepare('INSERT OR IGNORE INTO session_hints (session_id, kind) VALUES (?, ?)')\n        .run(sessionId, kind).changes === 1\n    );\n  }\n}\n"],
+  "mappings": "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",
+  "names": []
+}

package/dist/chunks/runtime-CKMVHAU4.js

@@ -0,0 +1,64 @@
+import { createRequire as __yandecodeCreateRequire } from 'node:module';
+const require = __yandecodeCreateRequire(import.meta.url);
+import {
+  decideChoice,
+  jevKey
+} from "./chunk-TYLH4NIC.js";
+import {
+  parseSettings,
+  resolveEnabled
+} from "./chunk-QCQC73WX.js";
+import {
+  MODULES,
+  routerSettings
+} from "./chunk-7L6DD2VD.js";
+import "./chunk-Y2MIXROU.js";
+
+// packages/cli/src/modules/router/runtime.ts
+function routableOptions(ctx) {
+  const enabled = new Set(resolveEnabled(MODULES, ctx.config.modules));
+  return MODULES.filter((m) => m.id !== "router" && enabled.has(m.id)).flatMap(
+    (m) => (m.routing ?? []).map((r) => ({ intent: r.intent, use: r.use }))
+  );
+}
+function buildCriteria(options) {
+  const criteria = {};
+  options.forEach((option, i) => {
+    criteria[`o${i}`] = option.intent;
+  });
+  criteria.none = "None of the tools fit: a plain edit, chit-chat, or an unclear ask.";
+  return criteria;
+}
+async function onUserPromptSubmit(input, ctx) {
+  const settings = parseSettings("router", routerSettings, ctx.settings);
+  const apiKey = jevKey();
+  const prompt = typeof input.prompt === "string" ? input.prompt.trim() : "";
+  if (!apiKey || prompt.length < settings.minPromptChars) return { kind: "none" };
+  const options = routableOptions(ctx);
+  if (options.length === 0) return { kind: "none" };
+  const answer = await decideChoice(
+    settings,
+    prompt,
+    "Which tool best fits the user's current request?",
+    buildCriteria(options),
+    apiKey
+  );
+  if (!answer || answer.choice === "none" || answer.confidence < settings.minConfidence)
+    return { kind: "none" };
+  const option = options[Number(answer.choice.slice(1))];
+  if (!option) return { kind: "none" };
+  ctx.log("routed", { use: option.use, confidence: answer.confidence });
+  return {
+    kind: "context",
+    text: `yandecode: this turn looks like \xAB${option.intent}\xBB \u2014 prefer \`${option.use}\`. If its schema is not loaded, ToolSearch(select) it instead of falling back to Bash.`
+  };
+}
+var runtime = {
+  hooks: { UserPromptSubmit: onUserPromptSubmit }
+};
+export {
+  buildCriteria,
+  routableOptions,
+  runtime
+};
+//# sourceMappingURL=runtime-CKMVHAU4.js.map

package/dist/chunks/runtime-CKMVHAU4.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../src/modules/router/runtime.ts"],
+  "sourcesContent": ["import type { HookResult, ModuleContext, ModuleRuntime } from '@cli/modules/contract';\nimport { parseSettings } from '@cli/modules/host';\nimport { MODULES } from '@cli/modules/registry';\nimport { resolveEnabled } from '@cli/modules/resolve';\nimport { decideChoice, jevKey } from '@cli/shared/jev';\nimport { routerSettings } from './definition';\n\ninterface Option {\n  intent: string;\n  use: string;\n}\n\n/** The routing rules of every enabled module (except this one) become Jev's choices. */\nexport function routableOptions(ctx: Pick<ModuleContext, 'config'>): Option[] {\n  const enabled = new Set(resolveEnabled(MODULES, ctx.config.modules));\n  return MODULES.filter((m) => m.id !== 'router' && enabled.has(m.id)).flatMap((m) =>\n    (m.routing ?? []).map((r) => ({ intent: r.intent, use: r.use })),\n  );\n}\n\n/** Choice keys `o0..oN` mapped to the intent that describes each tool, plus a `none` escape. */\nexport function buildCriteria(options: Option[]): Record<string, string> {\n  const criteria: Record<string, string> = {};\n  options.forEach((option, i) => {\n    criteria[`o${i}`] = option.intent;\n  });\n  criteria.none = 'None of the tools fit: a plain edit, chit-chat, or an unclear ask.';\n  return criteria;\n}\n\nasync function onUserPromptSubmit(\n  input: { prompt?: string },\n  ctx: ModuleContext,\n): Promise<HookResult> {\n  const settings = parseSettings('router', routerSettings, ctx.settings);\n  const apiKey = jevKey();\n  const prompt = typeof input.prompt === 'string' ? input.prompt.trim() : '';\n  if (!apiKey || prompt.length < settings.minPromptChars) return { kind: 'none' };\n  const options = routableOptions(ctx);\n  if (options.length === 0) return { kind: 'none' };\n\n  const answer = await decideChoice(\n    settings,\n    prompt,\n    \"Which tool best fits the user's current request?\",\n    buildCriteria(options),\n    apiKey,\n  );\n  // Fail-open: a missing key, timeout, malformed answer, `none` or low confidence adds no hint.\n  if (!answer || answer.choice === 'none' || answer.confidence < settings.minConfidence)\n    return { kind: 'none' };\n  const option = options[Number(answer.choice.slice(1))];\n  if (!option) return { kind: 'none' };\n  ctx.log('routed', { use: option.use, confidence: answer.confidence });\n  return {\n    kind: 'context',\n    text: `yandecode: this turn looks like \u00AB${option.intent}\u00BB \u2014 prefer \\`${option.use}\\`. If its schema is not loaded, ToolSearch(select) it instead of falling back to Bash.`,\n  };\n}\n\nexport const runtime: ModuleRuntime = {\n  hooks: { UserPromptSubmit: onUserPromptSubmit },\n};\n"],
+  "mappings": ";;;;;;;;;;;;;;;;;AAaO,SAAS,gBAAgB,KAA8C;AAC5E,QAAM,UAAU,IAAI,IAAI,eAAe,SAAS,IAAI,OAAO,OAAO,CAAC;AACnE,SAAO,QAAQ,OAAO,CAAC,MAAM,EAAE,OAAO,YAAY,QAAQ,IAAI,EAAE,EAAE,CAAC,EAAE;AAAA,IAAQ,CAAC,OAC3E,EAAE,WAAW,CAAC,GAAG,IAAI,CAAC,OAAO,EAAE,QAAQ,EAAE,QAAQ,KAAK,EAAE,IAAI,EAAE;AAAA,EACjE;AACF;AAGO,SAAS,cAAc,SAA2C;AACvE,QAAM,WAAmC,CAAC;AAC1C,UAAQ,QAAQ,CAAC,QAAQ,MAAM;AAC7B,aAAS,IAAI,CAAC,EAAE,IAAI,OAAO;AAAA,EAC7B,CAAC;AACD,WAAS,OAAO;AAChB,SAAO;AACT;AAEA,eAAe,mBACb,OACA,KACqB;AACrB,QAAM,WAAW,cAAc,UAAU,gBAAgB,IAAI,QAAQ;AACrE,QAAM,SAAS,OAAO;AACtB,QAAM,SAAS,OAAO,MAAM,WAAW,WAAW,MAAM,OAAO,KAAK,IAAI;AACxE,MAAI,CAAC,UAAU,OAAO,SAAS,SAAS,eAAgB,QAAO,EAAE,MAAM,OAAO;AAC9E,QAAM,UAAU,gBAAgB,GAAG;AACnC,MAAI,QAAQ,WAAW,EAAG,QAAO,EAAE,MAAM,OAAO;AAEhD,QAAM,SAAS,MAAM;AAAA,IACnB;AAAA,IACA;AAAA,IACA;AAAA,IACA,cAAc,OAAO;AAAA,IACrB;AAAA,EACF;AAEA,MAAI,CAAC,UAAU,OAAO,WAAW,UAAU,OAAO,aAAa,SAAS;AACtE,WAAO,EAAE,MAAM,OAAO;AACxB,QAAM,SAAS,QAAQ,OAAO,OAAO,OAAO,MAAM,CAAC,CAAC,CAAC;AACrD,MAAI,CAAC,OAAQ,QAAO,EAAE,MAAM,OAAO;AACnC,MAAI,IAAI,UAAU,EAAE,KAAK,OAAO,KAAK,YAAY,OAAO,WAAW,CAAC;AACpE,SAAO;AAAA,IACL,MAAM;AAAA,IACN,MAAM,uCAAoC,OAAO,MAAM,wBAAgB,OAAO,GAAG;AAAA,EACnF;AACF;AAEO,IAAM,UAAyB;AAAA,EACpC,OAAO,EAAE,kBAAkB,mBAAmB;AAChD;",
+  "names": []
+}