@klarlabs-studio/tokenops 0.0.0-stage → 0.101.1

package/README.md

@@ -1,3 +1,24 @@
-# Temporary Holding Version
+# @klarlabs-studio/tokenops
 
-This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.
+What your coding agents cost, where they leak, and every plan's limits —
+read on your machine. Your prompts and your code never leave it.
+
+```bash
+npx @klarlabs-studio/tokenops checkup
+```
+
+reads the last week of Claude Code, Codex, Gemini CLI and opencode work,
+with no setup: tokens and their value at API prices per harness and model,
+how the sessions went, and each leak with the one command that fixes it.
+
+This package is a launcher for the prebuilt `tokenops` binary for your
+platform (macOS and Linux, x64 and arm64), installed as an optional
+dependency. For the daemon, the coach and the menu bar app, install it
+with Homebrew:
+
+```bash
+brew install --cask klarlabs-studio/tap/tokenops
+tokenops init
+```
+
+Docs: https://github.com/klarlabs-studio/tokenops · Apache-2.0

package/bin/tokenops.cjs

@@ -0,0 +1,67 @@
+#!/usr/bin/env node
+// Pure launcher: locate the prebuilt tokenops binary for this platform (shipped
+// as an optionalDependency npm resolved for us) and exec it, forwarding args,
+// stdio, and the exit code. All tokenops logic lives in the Go binary; this file
+// carries none of it.
+"use strict";
+
+const { spawnSync } = require("node:child_process");
+
+function binaryPath() {
+  const pkg = `@klarlabs-studio/tokenops-${process.platform}-${process.arch}`;
+  const exe = process.platform === "win32" ? "tokenops.exe" : "tokenops";
+  try {
+    // npm installed only the platform package matching this os/cpu.
+    return require.resolve(`${pkg}/bin/${exe}`);
+  } catch {
+    return null;
+  }
+}
+
+// Whether tokenops PUBLISHES a binary for this platform, which is a different
+// question from whether one is installed. The wrapper's own
+// optionalDependencies list every platform package built for this release, so
+// it answers the first question without a network call.
+function isPublishedPlatform(pkg) {
+  try {
+    const own = require("../package.json");
+    return Object.prototype.hasOwnProperty.call(own.optionalDependencies || {}, pkg);
+  } catch {
+    // Cannot tell. Say the weaker thing rather than guess.
+    return false;
+  }
+}
+
+const bin = binaryPath();
+if (!bin) {
+  // These two failures look identical here and have opposite fixes, so they
+  // must not share a message. Telling someone their platform is unsupported
+  // when the real problem is a missing install sends them to build from source
+  // to solve something a reinstall fixes.
+  const pkg = `@klarlabs-studio/tokenops-${process.platform}-${process.arch}`;
+  if (isPublishedPlatform(pkg)) {
+    console.error(
+      `tokenops: ${pkg} is published for this release but is not installed here.\n` +
+        `This is an install problem, not an unsupported platform. Common causes:\n` +
+        `  - installed with --no-optional or --omit=optional, which skips it\n` +
+        `  - the release published minutes ago and the registry has not caught up\n` +
+        `  - a partial or interrupted install\n` +
+        `Try: npm install ${pkg}\n` +
+        `Binaries: https://github.com/klarlabs-studio/tokenops/releases`,
+    );
+  } else {
+    console.error(
+      `tokenops: no prebuilt binary for ${process.platform}-${process.arch}.\n` +
+        `Install another way: https://github.com/klarlabs-studio/tokenops/releases ` +
+        `or 'brew install --cask klarlabs-studio/tap/tokenops'.`,
+    );
+  }
+  process.exit(1);
+}
+
+const res = spawnSync(bin, process.argv.slice(2), { stdio: "inherit" });
+if (res.error) {
+  console.error(res.error.message);
+  process.exit(1);
+}
+process.exit(res.status === null ? 1 : res.status);

package/package.json

@@ -1,6 +1,38 @@
 {
   "name": "@klarlabs-studio/tokenops",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
-}
+  "_version_comment": "Set at publish time by npm/scripts/build-packages.mjs from the git tag; the literal below is never published. optionalDependencies are rewritten the same way.",
+  "version": "0.101.1",
+  "description": "What your coding agents cost, where they leak, and every plan's limits — local-first. `npx @klarlabs-studio/tokenops checkup` reads a week of Claude Code, Codex, Gemini CLI and opencode work with no setup.",
+  "bin": {
+    "tokenops": "bin/tokenops.cjs"
+  },
+  "files": [
+    "bin/tokenops.cjs",
+    "README.md"
+  ],
+  "optionalDependencies": {
+    "@klarlabs-studio/tokenops-linux-x64": "0.101.1",
+    "@klarlabs-studio/tokenops-linux-arm64": "0.101.1",
+    "@klarlabs-studio/tokenops-darwin-x64": "0.101.1",
+    "@klarlabs-studio/tokenops-darwin-arm64": "0.101.1"
+  },
+  "keywords": [
+    "claude-code",
+    "codex",
+    "ai",
+    "tokens",
+    "usage",
+    "cost",
+    "rate-limits",
+    "coding-agents"
+  ],
+  "license": "Apache-2.0",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/klarlabs-studio/tokenops.git"
+  },
+  "homepage": "https://github.com/klarlabs-studio/tokenops",
+  "engines": {
+    "node": ">=16"
+  }
+}