tokensniff 0.1.0

package/bin/tokensniff-status.js

@@ -0,0 +1,8 @@
+#!/usr/bin/env node
+import { main } from '../dist/status.js';
+
+Promise.resolve(main()).catch((error) => {
+  const message = error instanceof Error ? error.message : String(error);
+  console.error(`[tokensniff-status] ${message}`);
+  process.exit(1);
+});

package/bin/tokensniff.js

@@ -0,0 +1,8 @@
+#!/usr/bin/env node
+import { main } from '../dist/cli.js';
+
+Promise.resolve(main()).catch((error) => {
+  const message = error instanceof Error ? error.message : String(error);
+  console.error(`[tokensniff] ${message}`);
+  process.exit(1);
+});

package/dist/cli/run.d.ts

@@ -0,0 +1,64 @@
+/**
+ * tokensniff — Master CLI Orchestrator (v1 Production)
+ *
+ * Automates the entire telemetry pipeline with multi-terminal reference-counted session lifecycle management:
+ * 1. Checks if proxy is already active on port 4000 (multi-terminal smart attach).
+ * 2. Checks if upstream is already running on upstreamPort before spawning upstreamCommand.
+ * 3. Registers process ID in ~/.tokensniff/sessions/ for active session reference counting.
+ * 4. On Ctrl+C or exit, decrements active session count:
+ *    - If other terminal sessions are alive: terminates only the local harness, leaving the proxy and upstream alive.
+ *    - If this was the last session: cleans up the proxy server and upstream process.
+ */
+import { type TokenSniffConfig } from '../collector/config.js';
+import { start as startCollector } from '../collector/index.js';
+export interface RunDependencies {
+    readonly config?: TokenSniffConfig;
+    readonly startProxy?: typeof startCollector;
+    readonly waitMs?: number;
+}
+/**
+ * Validates TCP availability across host candidates with timeout.
+ */
+export declare function waitForTcp(host: string, port: number, timeoutMs?: number): Promise<void>;
+/**
+ * Checks if a TCP port is currently open and actively accepting connections.
+ */
+export declare function isPortActive(host: string, port: number): Promise<boolean>;
+/**
+ * Generates the global ~/.tokensniff/config.json configuration template.
+ */
+export declare function writeInitFile(): string;
+/**
+ * Prints the configuration blocks for ~/.claude/settings.json.
+ */
+export declare function printClaudeInstructions(): void;
+/**
+ * Cross-platform process tree termination.
+ */
+export declare function terminateProcessTree(pid: number | undefined): void;
+/**
+ * Kills any detached process listening on a specific TCP port.
+ */
+export declare function killProcessOnPort(port: number): void;
+/**
+ * Checks if a process identifier is currently running on the host OS.
+ */
+export declare function isProcessAlive(pid: number): boolean;
+/**
+ * Resolves the persistent active sessions tracking directory: ~/.tokensniff/sessions.
+ */
+export declare function getSessionsDir(): string;
+/**
+ * Registers the current CLI terminal process into the shared active sessions pool.
+ * Returns an idempotent unregister function to remove the session lock on exit.
+ */
+export declare function registerSession(pid?: number): () => void;
+/**
+ * Counts how many other terminal sessions are still alive, auto-pruning stale dead PID files.
+ */
+export declare function countActiveSessions(excludePid?: number): number;
+/**
+ * Main command-line orchestrator.
+ */
+export declare function main(argv?: readonly string[], deps?: RunDependencies): Promise<void>;
+//# sourceMappingURL=run.d.ts.map

package/dist/cli/run.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"run.d.ts","sourceRoot":"","sources":["../../src/cli/run.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAMH,OAAO,EAIL,KAAK,gBAAgB,EACtB,MAAM,wBAAwB,CAAC;AAChC,OAAO,EAAE,KAAK,IAAI,cAAc,EAAE,MAAM,uBAAuB,CAAC;AAGhE,MAAM,WAAW,eAAe;IAC9B,QAAQ,CAAC,MAAM,CAAC,EAAE,gBAAgB,CAAC;IACnC,QAAQ,CAAC,UAAU,CAAC,EAAE,OAAO,cAAc,CAAC;IAC5C,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC;CAC1B;AAED;;GAEG;AACH,wBAAgB,UAAU,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,SAAS,SAAQ,GAAG,OAAO,CAAC,IAAI,CAAC,CA+BvF;AAED;;GAEG;AACH,wBAAgB,YAAY,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAWzE;AAED;;GAEG;AACH,wBAAgB,aAAa,IAAI,MAAM,CAoBtC;AAED;;GAEG;AACH,wBAAgB,uBAAuB,IAAI,IAAI,CAa9C;AAED;;GAEG;AACH,wBAAgB,oBAAoB,CAAC,GAAG,EAAE,MAAM,GAAG,SAAS,GAAG,IAAI,CAmBlE;AAED;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CAsCpD;AAED;;GAEG;AACH,wBAAgB,cAAc,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CASnD;AAED;;GAEG;AACH,wBAAgB,cAAc,IAAI,MAAM,CAEvC;AAED;;;GAGG;AACH,wBAAgB,eAAe,CAAC,GAAG,GAAE,MAAoB,GAAG,MAAM,IAAI,CAuBrE;AAED;;GAEG;AACH,wBAAgB,mBAAmB,CAAC,UAAU,GAAE,MAAoB,GAAG,MAAM,CAyC5E;AAED;;GAEG;AACH,wBAAsB,IAAI,CACxB,IAAI,GAAE,SAAS,MAAM,EAA0B,EAC/C,IAAI,GAAE,eAAoB,GACzB,OAAO,CAAC,IAAI,CAAC,CA+Nf"}