sandoichi 0.1.2 → 0.1.4

package/README.md

@@ -1,25 +1,19 @@
 # sandoichi
 
-Cuts what Claude Code and Codex charge you to re-read their own output. Redacts secrets, caps oversized tool results, and, if you turn it on, trims request history before it's sent — all without calling an LLM itself.
+`sandoichi` is Sando's optional JavaScript library. The full Sando plugin is the main product. Install it through the Claude Code or Codex marketplace.
 
-This is the core library (`@sando/core` renamed `sandoichi` for npm). For the Claude Code plugin, Codex plugin, and provider proxy, see the [main repo](https://github.com/yuzushi-dev/Sando).
-
-## Install
-
-```sh
+```bash
 npm install sandoichi
 ```
 
-Requires Node.js `22.22.x`.
-
-## Usage
-
 ```js
 import { optimizeToolOutput, createProviderProxy } from 'sandoichi';
 ```
 
-See [index.mjs](./index.mjs) for the full list of exports (tool-output optimization, provider request transforms, semantic compaction, metrics, status line rendering).
+The library requires Node.js `>=22.22.0 <23` and has no runtime dependencies. Installing it does not install or enable the plugin.
+
+For plugin installation, see the [main project README](https://github.com/yuzushi-dev/Sando#readme).
 
-## License
+Telemetry is off by default. An interactive npm install asks once for consent; see the [full disclosure](https://github.com/yuzushi-dev/Sando/blob/main/TELEMETRY.md).
 
-MIT
+MIT.

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "sandoichi",
-  "version": "0.1.2",
-  "description": "Cuts what Claude Code and Codex charge you to re-read their own output.",
+  "version": "0.1.4",
+  "description": "Reduce repeated tool-output context in Claude Code and Codex.",
   "license": "MIT",
   "author": "yuzushi",
   "repository": {

package/src/postinstall.mjs

@@ -7,9 +7,11 @@ import path from 'node:path';
 import readline from 'node:readline/promises';
 import { pathToFileURL } from 'node:url';
 
-import { CONSENT_VERSION, defaultTelemetryConfigPath, enableTelemetry, readTelemetryConfig } from './telemetry.mjs';
+import {
+  CONSENT_VERSION, defaultTelemetryConfigPath, enableTelemetry, readTelemetryConfig, TELEMETRY_DETAILS_URL,
+} from './telemetry.mjs';
 
-const CONSENT_PROMPT = 'Enable anonymous telemetry? Full details at: TELEMETRY.md [y/N] ';
+const CONSENT_PROMPT = `Enable anonymous telemetry? Full details at: ${TELEMETRY_DETAILS_URL} [y/N] `;
 
 export async function runPostinstall({
   env = process.env, stdin = process.stdin, stdout = process.stdout,

package/src/session-start.mjs

@@ -0,0 +1,28 @@
+import path from 'node:path';
+
+import { defaultTelemetryConfigPath, readTelemetryConfig, TELEMETRY_DETAILS_URL } from './telemetry.mjs';
+
+export function runSessionStart({
+  env = process.env,
+  stdout = process.stdout,
+  rootEnv = 'PLUGIN_ROOT',
+} = {}) {
+  try {
+    const config = readTelemetryConfig(defaultTelemetryConfigPath(env));
+    if (config.prompted_consent_version > 0) {
+      stdout.write('{}\n');
+      return;
+    }
+    const pluginRoot = env[rootEnv] || path.resolve(import.meta.dirname, '..');
+    const cli = path.join(pluginRoot, 'lib', 'telemetry-cli.mjs');
+    stdout.write(`${JSON.stringify({
+      hookSpecificOutput: {
+        hookEventName: 'SessionStart',
+        systemMessage: 'Sando can send anonymous aggregate telemetry (opt-in, off by default). '
+          + `Run \`node "${cli}" enable\` to turn it on. Details: ${TELEMETRY_DETAILS_URL}`,
+      },
+    })}\n`);
+  } catch {
+    stdout.write('{}\n');
+  }
+}

package/src/statusline.mjs

@@ -95,6 +95,6 @@ export function renderStatusLine({ metrics, providerUsage, totalCostUsd } = {},
   const effectiveRate = Number.isFinite(totalCostUsd) && totalCostUsd > 0
     && Number.isSafeInteger(providerUsage?.totalTokens) && providerUsage.totalTokens > 0
     ? totalCostUsd / providerUsage.totalTokens : undefined;
-  const cost = effectiveRate === undefined ? undefined : compactCost(metrics.savedTokens, effectiveRate);
-  return `🥪 ${[savings, cost && `(-${cost})`].filter(Boolean).join(' ')}`;
+  void effectiveRate; // computed for downstream cost tracking, intentionally not shown in the status bar
+  return `🥪 ${savings}`;
 }

package/src/telemetry-cli.mjs

@@ -6,11 +6,11 @@ import { pathToFileURL } from 'node:url';
 
 import {
   defaultTelemetryConfigPath, defaultTelemetryStatePaths,
-  disableTelemetry, enableTelemetry, flushQueue, previewNextUpload, statusTelemetry,
+  disableTelemetry, enableTelemetry, flushQueue, previewNextUpload, statusTelemetry, TELEMETRY_DETAILS_URL,
 } from './telemetry.mjs';
 
 const USAGE = 'Usage: sando telemetry <status|enable|disable [--purge]|preview|flush>\n';
-const CONSENT_PROMPT = 'Enable anonymous telemetry? Full details at: TELEMETRY.md [y/N] ';
+const CONSENT_PROMPT = `Enable anonymous telemetry? Full details at: ${TELEMETRY_DETAILS_URL} [y/N] `;
 
 async function defaultPrompt(message) {
   const rl = readline.createInterface({ input: process.stdin, output: process.stdout });

package/src/telemetry.mjs

@@ -84,6 +84,7 @@ export function serializeEvent(payload) {
 
 export const TELEMETRY_CONFIG_VERSION = 1;
 export const CONSENT_VERSION = 1;
+export const TELEMETRY_DETAILS_URL = 'https://github.com/yuzushi-dev/Sando/blob/main/TELEMETRY.md';
 // Canary phase: shared backend, fronted by a Cloudflare Tunnel so it's
 // reachable from any of the owner's machines (see
 // session-handoff/deploy/telemetry/). Rate-limited at nginx (30 req/min/IP).