@sns-myagent/cli 0.2.0 → 0.3.1

package/CHANGELOG.md

@@ -10,10 +10,21 @@ Versioning: [Semantic Versioning](https://semver.org/spec/v2.0.0.html)
 ## [Unreleased]
 
 ### Added
+- **TBM (Token Budget Manager) fully implemented** — 7 core modules:
+  - Context Delta Cache: static/dynamic message splitting, ~40% token savings
+  - Context Pyramid: 5 compression levels (L0–L4), auto-demotion based on budget pressure
+  - Lazy Skill Loading: index-on-demand instead of bulk inject, ~85% savings
+  - Tool Output Compression: per-tool budgets, auto-truncation, JSON/HTML/markdown reducers
+  - Conversation Tombstoning: old messages → 10-line summaries, ~85% reduction
+  - Response Cache: exact + semantic (Jaccard bigram) match, configurable TTL
+  - Communication Modes: caveman/normal/verbose/auto with system prompt directives
+- `/tokens` command: full TBM dashboard (session stats, cache hits, compression, pyramid level, cost estimate)
+- `/mode` command: set caveman/normal/verbose/auto communication mode
+- `TbmManager` singleton class coordinating all subsystems
 - Phase 1 scaffold complete: forked from Pi Agent, rebranded as `@sns-myagent/cli` with `snscoder` binary (commit `d1480eb`)
 - GitHub Actions CI/CD pipeline (`.github/workflows/ci.yml`) with staged verify → install → typecheck → lint → build → diagnose jobs
 - BYOK provider config system with `.sns-myagent/config.yaml` + env overrides
-- Real source-derived inventory of 58 built-in slash commands and 70+ tools documented in README
+- Real source-derived inventory of 58 built-in slash commands and 30 built-in tools documented in README
 - `docs/memory.md` covering mnemopi / mnemosyne / mem0 / lcm backends
 - `docs/tbm.md` Token Budget Manager reference
 - `SECURITY.md` vulnerability reporting + security model

package/README.md

@@ -18,12 +18,12 @@
 </p>
 
 <p align="center">
-  <strong>BYOK coding agent CLI — 30 built-in tools, 58 slash commands, multi-provider LLM, memory, MCP, Telegram.</strong>
+  <strong>BYOK coding agent CLI — 30 built-in tools, 61 slash commands, multi-provider LLM, memory, MCP, Telegram.</strong>
 </p>
 
 <p align="center">
   <a href="./LICENSE"><img src="https://img.shields.io/badge/license-MIT-blue?style=flat-square" alt="License: MIT"></a>
-  <img src="https://img.shields.io/badge/version-0.1.0-yellow?style=flat-square" alt="Version 0.1.0">
+  <img src="https://img.shields.io/badge/version-0.2.0-yellow?style=flat-square" alt="Version 0.2.0">
   <img src="https://img.shields.io/badge/bun-%3E%3D1.3.14-efbbf4?style=flat-square&logo=bun&logoColor=black" alt="Bun >= 1.3.14">
   <img src="https://img.shields.io/badge/typescript-5.x-3178C6?style=flat-square&logo=typescript&logoColor=white" alt="TypeScript 5.x">
 </p>
@@ -60,9 +60,9 @@
 | Feature | Source |
 |---------|--------|
 | **30 built-in tools** | `src/tools/builtin-names.ts` |
-| **58 slash commands** | `src/slash-commands/builtin-registry.ts` |
+| **61 slash commands** | `src/slash-commands/builtin-registry.ts` |
 | **Multi-provider LLM** | OpenAI, Anthropic, Ollama, custom endpoints via `@oh-my-pi/pi-ai` |
-| **4 memory backends** | mnemopi (default), hindsight, local, off — `src/memory-backend/resolve.ts` |
+| **7 memory backends** | mnemopi (default), hindsight, mnemosyne, mem0, lcm, local, off — `src/memory-backend/resolve.ts` |
 | **MCP integration** | 22 source files in `src/mcp/` |
 | **Plan mode** | `src/plan-mode/` — agent plans before executing |
 | **Goal mode** | Autonomous objective with token budget and lifecycle |
@@ -117,11 +117,10 @@ All tool names come from `src/tools/builtin-names.ts`.
 | `debug` | Debugging assistance |
 
 ### Web & Browser
-
+### Web & Browser
 | Tool | Description |
 |------|-------------|
 | `web_search` | Web search via configured provider |
-| `search` | File/content search |
 | `search_tool_bm25` | BM25-based search tool |
 | `browser` | Headless browser automation (Puppeteer) |
 | `inspect_image` | Image analysis |
@@ -159,7 +158,7 @@ All tool names come from `src/tools/builtin-names.ts`.
 
 ## Slash Commands
 
-58 built-in commands from `src/slash-commands/builtin-registry.ts`. Most useful:
+61 built-in commands from `src/slash-commands/builtin-registry.ts`. Most useful:
 
 ### Session & Navigation
 
@@ -401,7 +400,7 @@ Settings use dot-separated paths. Full schema in `src/config/settings-schema.ts`
   "eval.jl": true,
 
   // Memory
-  "memory.backend": "mnemopi",  // "mnemopi" | "hindsight" | "local" | "off"
+  "memory.backend": "mnemopi",  // "mnemopi" | "hindsight" | "mnemosyne" | "mem0" | "lcm" | "local" | "off"
   "hindsight.scoping": "...",
 
   // MCP

package/bin/snscoder.js

@@ -1,98 +1,9 @@
 #!/usr/bin/env node
-// bin/snscoder.js — npm-installed shim that locates and spawns the
-// platform-specific prebuilt binary downloaded by scripts/fetch-binary.mjs
-// (or built locally via `bun scripts/build-binary.ts`).
-//
-// Runs on plain Node 18+. Uses spawnSync so npm postinstall script chaining
-// behaves predictably and exit codes propagate correctly.
-
-import { existsSync, statSync } from "node:fs";
-import { spawnSync } from "node:child_process";
-import { dirname, join, resolve } from "node:path";
+// Auto-generated by fetch-binary.mjs — execs the platform binary.
+import { spawn } from "node:child_process";
 import { fileURLToPath } from "node:url";
-
-const __filename = fileURLToPath(import.meta.url);
-const __dirname = dirname(__filename);
-const REPO_ROOT = resolve(__dirname, "..");
-
-const platform = process.platform;
-const arch = process.arch;
-const isWin = platform === "win32";
-
-const binaryName = isWin ? "snscoder.exe" : "snscoder";
-const binaryPath = join(REPO_ROOT, "bin", binaryName);
-const altBinaryPath = join(REPO_ROOT, "bin", `${binaryName}-${platform}-${arch}${isWin ? ".exe" : ""}`);
-
-// Local dev fallback: if a sibling dist/omp or dist/cli.js exists (source build),
-// prefer invoking the Node entry so contributors without a fetched binary still work.
-const devEntryCandidates = [
-	join(REPO_ROOT, "dist", "omp"), // compiled Bun binary from `bun scripts/build-binary.ts`
-	join(REPO_ROOT, "dist", "cli.js"), // legacy Node entry
-];
-
-function missingHelp() {
-	const lines = [
-		"",
-		`\u001b[31m✗ snscoder binary not found at ${binaryPath}\u001b[0m`,
-		"",
-		"  SNS-MyAgent ships a platform-specific prebuilt binary that is downloaded",
-		"  on `npm install` (or fetched explicitly via `npm run fetch-binary`). The",
-		"  binary appears to be missing from this install.",
-		"",
-		"  \u001b[1mFix — pick one:\u001b[0m",
-		"    1. Re-run the npm postinstall step:",
-		"         npm rebuild              # re-runs postinstall for current pkg",
-		"         npm install -g @sns-myagent/cli --force   # full reinstall",
-		"    2. Use the recommended installer (handles Bun + binary end-to-end):",
-		"         curl -fsSL https://sns.myagent.id/install.sh | bash",
-		"    3. Windows PowerShell:",
-		"         irm raw.githubusercontent.com/Reihantt6/sns-myagent/main/install.ps1 | iex",
-		"    4. Build from source (requires Bun >= 1.3.14):",
-		"         git clone https://github.com/Reihantt6/sns-myagent",
-		"         cd sns-myagent && bun install && bun run build",
-		"",
-		"  If a release hasn't been published yet, you will see a warning from",
-		"  scripts/fetch-binary.mjs during install — that's expected and not a bug.",
-		"",
-	];
-	process.stderr.write(lines.join("\n"));
-}
-
-function pickExecutable() {
-	if (existsSync(binaryPath) && statSync(binaryPath).isFile()) {
-		return { path: binaryPath, args: [] };
-	}
-	if (existsSync(altBinaryPath) && statSync(altBinaryPath).isFile()) {
-		return { path: altBinaryPath, args: [] };
-	}
-	// Local dev fallback: bun build artifact or legacy Node entry.
-	for (const candidate of devEntryCandidates) {
-		if (existsSync(candidate) && statSync(candidate).isFile()) {
-			const isNodeEntry = candidate.endsWith(".js");
-			return {
-				path: isNodeEntry ? process.execPath : candidate,
-				args: isNodeEntry ? [candidate] : [],
-			};
-		}
-	}
-	return null;
-}
-
-const exe = pickExecutable();
-if (!exe) {
-	missingHelp();
-	process.exit(1);
-}
-
-const result = spawnSync(exe.path, [...exe.args, ...process.argv.slice(2)], {
-	stdio: "inherit",
-	// Forward env so callers can still pass API keys etc. through npm-global env.
-	env: process.env,
-});
-
-// Propagate signal-based termination (e.g. SIGINT from Ctrl-C) rather than
-// reporting exit code 1.
-if (result.signal) {
-	process.exit(1);
-}
-process.exit(result.status ?? 1);
+import { dirname, join } from "node:path";
+const here = dirname(fileURLToPath(import.meta.url));
+const bin = join(here, "snscoder-linux-x64");
+const r = spawn(bin, process.argv.slice(2), { stdio: "inherit" });
+r.on("exit", (c) => process.exit(c ?? 0));