sandoichi 0.1.3 → 0.1.5

package/README.md

@@ -1,6 +1,6 @@
 # sandoichi
 
-Sando's local JavaScript library for reducing repeated tool-output context.
+`sandoichi` is Sando's optional JavaScript library. The full Sando plugin is the main product. Install it through the Claude Code or Codex marketplace.
 
 ```bash
 npm install sandoichi
@@ -10,12 +10,10 @@ npm install sandoichi
 import { optimizeToolOutput, createProviderProxy } from 'sandoichi';
 ```
 
-Telemetry is off by default. The npm install asks once for consent.
+The library requires Node.js `>=22.22.0 <23` and has no runtime dependencies. Installing it does not install or enable the plugin.
 
-The Claude Code and Codex plugins are installed from the Yuzushi marketplace:
+For plugin installation, see the [main project README](https://github.com/yuzushi-dev/Sando#readme).
 
-```text
-/plugin install sando@yuzushi
-```
+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.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "sandoichi",
-  "version": "0.1.3",
+  "version": "0.1.5",
   "description": "Reduce repeated tool-output context in Claude Code and Codex.",
   "license": "MIT",
   "author": "yuzushi",

package/src/core.mjs

@@ -192,7 +192,7 @@ export function optimizeToolOutput({
       sourceBytes,
       truncated: false,
     };
-    const header = `artifact ${artifact.ref} ${artifact.bytes}B\n`;
+    const header = `[sando] artifact ${artifact.ref} ${artifact.bytes}B\n`;
     const viewBudget = Math.max(1, routePolicy.maxInlineBytes - Buffer.byteLength(header));
     inline = `${truncateUtf8(header, routePolicy.maxInlineBytes)}${inlineView(
       modelText,

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

@@ -1,6 +1,6 @@
 import path from 'node:path';
 
-import { defaultTelemetryConfigPath, readTelemetryConfig } from './telemetry.mjs';
+import { defaultTelemetryConfigPath, readTelemetryConfig, TELEMETRY_DETAILS_URL } from './telemetry.mjs';
 
 export function runSessionStart({
   env = process.env,
@@ -19,7 +19,7 @@ export function runSessionStart({
       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.md`,
+          + `Run \`node "${cli}" enable\` to turn it on. Details: ${TELEMETRY_DETAILS_URL}`,
       },
     })}\n`);
   } catch {

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).