@astudioplus/compressor 0.1.0

package/dist/paths.js

@@ -0,0 +1,87 @@
+import { existsSync, readFileSync } from 'node:fs';
+import path from 'node:path';
+import { fileURLToPath } from 'node:url';
+function isCompressorRoot(dir) {
+    const pkgPath = path.join(dir, 'package.json');
+    if (!existsSync(pkgPath)) {
+        return false;
+    }
+    try {
+        const parsed = JSON.parse(readFileSync(pkgPath, 'utf8'));
+        return (typeof parsed === 'object' &&
+            parsed !== null &&
+            parsed['name'] === 'compressor');
+    }
+    catch {
+        return false;
+    }
+}
+export function packageRoot() {
+    let dir = path.dirname(fileURLToPath(import.meta.url));
+    while (true) {
+        if (isCompressorRoot(dir)) {
+            return dir;
+        }
+        const parent = path.dirname(dir);
+        if (parent === dir) {
+            throw new Error('could not locate the compressor package root from ' + import.meta.url);
+        }
+        dir = parent;
+    }
+}
+function hookCommandFor(mode, root) {
+    // quoted so the command survives package roots containing spaces
+    return `node "${path.join(root, 'dist', 'hook.js')}" --mode ${mode}`;
+}
+/**
+ * Hook command for ownership matching in status/uninstall — must work even
+ * when the bundle is missing (e.g. uninstalling a broken install).
+ */
+export function describeHookCommand(mode, root = packageRoot()) {
+    return hookCommandFor(mode, root);
+}
+/**
+ * Command line installed for the PostToolUse hook. Refuses to install a
+ * command that would fail on every tool call (fail-open hook = silent no-op).
+ */
+export function resolveHookCommand(mode, root = packageRoot()) {
+    const hookPath = path.join(root, 'dist', 'hook.js');
+    if (!existsSync(hookPath)) {
+        throw new Error(`hook bundle missing at ${hookPath} — run 'npm run build' in the compressor package, then re-run`);
+    }
+    return hookCommandFor(mode, root);
+}
+function copilotHookCommandFor(mode, root) {
+    // quoted so the command survives package roots containing spaces
+    return `node "${path.join(root, 'dist', 'copilot-hook.js')}" --mode ${mode}`;
+}
+/** Copilot hook command for display/matching — works without the bundle. */
+export function describeCopilotHookCommand(mode, root = packageRoot()) {
+    return copilotHookCommandFor(mode, root);
+}
+/**
+ * Command line installed for the Copilot postToolUse hook. Like
+ * resolveHookCommand, refuses to install a command that would fail on every
+ * tool call (Copilot postToolUse is fail-open: a dead command = silent no-op).
+ */
+export function resolveCopilotHookCommand(mode, root = packageRoot()) {
+    const hookPath = path.join(root, 'dist', 'copilot-hook.js');
+    if (!existsSync(hookPath)) {
+        throw new Error(`copilot hook bundle missing at ${hookPath} — run 'npm run build' in the compressor package, then re-run`);
+    }
+    return copilotHookCommandFor(mode, root);
+}
+/**
+ * Copilot hook command derived from the Claude Code hook command carried in
+ * AdapterContext (the only resolved-path carrier adapters receive; the
+ * adapters/types.ts contract is frozen). Both commands are generated in this
+ * module from the same root, so swapping the sibling bundle name and --mode
+ * flag reproduces copilotHookCommandFor exactly. Mode omitted → base form
+ * for ownership matching (mode-agnostic, like claude-code's predicate).
+ */
+export function copilotHookCommandFrom(hookCommand, mode) {
+    const base = hookCommand
+        .replace(/ --mode \S+$/, '')
+        .replace(/(?<![\w-])hook\.js("?)$/, 'copilot-hook.js$1');
+    return mode === undefined ? base : `${base} --mode ${mode}`;
+}

package/dist/tokens/estimate.d.ts

@@ -0,0 +1,12 @@
+import type { Estimator } from '../engine/types.ts';
+/** Zero-cost estimator for the hook hot path. */
+export declare const cheapEstimator: Estimator;
+/**
+ * NOTE: cl100k_base undercounts Claude tokens by ~15-20%. Estimates are for
+ * thresholds/UX only, NEVER reported as savings.
+ *
+ * js-tiktoken (~5.6MB of inlined ranks) is loaded lazily via createRequire so
+ * that importing `cheapEstimator` from the bundled hook never pulls it in.
+ */
+export declare function tiktokenEstimator(): Estimator;
+export declare function estimateTokens(text: string): number;

package/dist/tokens/estimate.js

@@ -0,0 +1,23 @@
+import { createRequire } from 'node:module';
+/** Zero-cost estimator for the hook hot path. */
+export const cheapEstimator = (text) => Math.ceil(text.length / 3.5);
+let encoder;
+/**
+ * NOTE: cl100k_base undercounts Claude tokens by ~15-20%. Estimates are for
+ * thresholds/UX only, NEVER reported as savings.
+ *
+ * js-tiktoken (~5.6MB of inlined ranks) is loaded lazily via createRequire so
+ * that importing `cheapEstimator` from the bundled hook never pulls it in.
+ */
+export function tiktokenEstimator() {
+    if (encoder === undefined) {
+        const nodeRequire = createRequire(import.meta.url);
+        const mod = nodeRequire('js-tiktoken');
+        encoder = mod.getEncoding('cl100k_base');
+    }
+    const enc = encoder;
+    return (text) => enc.encode(text).length;
+}
+export function estimateTokens(text) {
+    return tiktokenEstimator()(text);
+}

package/dist/tokens/exact.d.ts

@@ -0,0 +1,5 @@
+/**
+ * Exact token count via the Anthropic count_tokens endpoint. The SDK is
+ * imported lazily so it never loads unless --exact is actually used.
+ */
+export declare function countTokensExact(text: string, model?: string): Promise<number>;

package/dist/tokens/exact.js

@@ -0,0 +1,16 @@
+/**
+ * Exact token count via the Anthropic count_tokens endpoint. The SDK is
+ * imported lazily so it never loads unless --exact is actually used.
+ */
+export async function countTokensExact(text, model = 'claude-sonnet-4-6') {
+    if (!process.env.ANTHROPIC_API_KEY) {
+        throw new Error('ANTHROPIC_API_KEY required for --exact counts; estimated counts work without it');
+    }
+    const { default: Anthropic } = await import('@anthropic-ai/sdk');
+    const client = new Anthropic();
+    const result = await client.messages.countTokens({
+        model,
+        messages: [{ role: 'user', content: text }],
+    });
+    return result.input_tokens;
+}

package/dist/tokens/index.d.ts

@@ -0,0 +1,2 @@
+export { cheapEstimator, tiktokenEstimator, estimateTokens } from './estimate.ts';
+export { countTokensExact } from './exact.ts';

package/dist/tokens/index.js

@@ -0,0 +1,2 @@
+export { cheapEstimator, tiktokenEstimator, estimateTokens } from "./estimate.js";
+export { countTokensExact } from "./exact.js";

package/package.json

@@ -0,0 +1,77 @@
+{
+  "name": "@astudioplus/compressor",
+  "version": "0.1.0",
+  "description": "Reduce token usage in AI coding agents (Claude Code, Copilot, Cursor) with instruction packs and tool-output compression hooks — savings you can measure.",
+  "type": "module",
+  "author": "Andrey Vasilevsky <anvanster@gmail.com>",
+  "license": "MIT",
+  "homepage": "https://github.com/anvanster/compressor#readme",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/anvanster/compressor.git"
+  },
+  "bugs": {
+    "url": "https://github.com/anvanster/compressor/issues"
+  },
+  "keywords": [
+    "token-optimization",
+    "prompt-compression",
+    "context-compression",
+    "ai-coding-agents",
+    "claude-code",
+    "github-copilot",
+    "cursor",
+    "agents-md",
+    "llm",
+    "anthropic",
+    "developer-tools",
+    "cli"
+  ],
+  "engines": {
+    "node": ">=20.0.0"
+  },
+  "os": [
+    "darwin",
+    "linux",
+    "win32"
+  ],
+  "cpu": [
+    "x64",
+    "arm64"
+  ],
+  "bin": {
+    "compressor": "dist/cli/index.js"
+  },
+  "exports": {
+    ".": "./dist/index.js",
+    "./engine": "./dist/engine/index.js",
+    "./tokens": "./dist/tokens/index.js"
+  },
+  "files": [
+    "dist",
+    "README.md",
+    "LICENSE",
+    "CHANGELOG.md"
+  ],
+  "publishConfig": {
+    "access": "public"
+  },
+  "scripts": {
+    "build": "tsc -p tsconfig.build.json && npm run bundle:hook && npm run bundle:copilot-hook",
+    "bundle:hook": "esbuild src/hook-entry.ts --bundle --platform=node --format=esm --outfile=dist/hook.js",
+    "bundle:copilot-hook": "esbuild src/copilot-hook-entry.ts --bundle --platform=node --format=esm --outfile=dist/copilot-hook.js",
+    "prepublishOnly": "npm run build",
+    "typecheck": "tsc -p tsconfig.json --noEmit",
+    "test": "node --test \"test/**/*.test.ts\""
+  },
+  "dependencies": {
+    "@anthropic-ai/sdk": "^0.104.1",
+    "commander": "^15.0.0",
+    "js-tiktoken": "^1.0.21"
+  },
+  "devDependencies": {
+    "@types/node": "^25.9.2",
+    "esbuild": "^0.28.0",
+    "typescript": "^6.0.3"
+  }
+}