portable-agent-layer 0.33.0 → 0.34.0

package/README.md

@@ -82,6 +82,7 @@ pal cli status        # check your setup
 | `pal cli import` | Import user state from a zip |
 | `pal cli status` | Show current PAL configuration |
 | `pal cli doctor` | Check prerequisites and system health |
+| `pal cli usage` | Summarize token usage and estimated cost |
 
 ### Target flags
 

package/assets/templates/PAL/README.md

@@ -82,7 +82,7 @@ Persistent storage across sessions:
 - **state/** — Session registry, counts cache, debug logs
 
 ### Tools (`src/tools/`)
-CLI utilities: `tool:opinion` (manage opinions), `tool:reflect` (relationship reflection), `tool:analyze` (learning analysis), `tool:tokens` (usage tracking), `tool:export` / `tool:import` (state portability).
+CLI utilities: `tool:opinion` (manage opinions), `tool:reflect` (relationship reflection), `tool:analyze` (learning analysis), `pal cli usage` (token usage tracking), `tool:export` / `tool:import` (state portability).
 
 ### TELOS (`telos/`)
 Personal context system — mission, goals, projects, beliefs, challenges, strategies, ideas, learnings, mental models, narratives. Managed via the telos skill.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "portable-agent-layer",
-  "version": "0.33.0",
+  "version": "0.34.0",
   "description": "PAL — Portable Agent Layer: persistent personal context for AI coding assistants",
   "type": "module",
   "bin": {
@@ -51,8 +51,7 @@
     "tool:wisdom-frame": "bun run src/tools/agent/wisdom-frame.ts",
     "tool:reflect": "bun run src/tools/relationship-reflect.ts",
     "tool:export": "bun run src/tools/export.ts",
-    "tool:import": "bun run src/tools/import.ts",
-    "tool:tokens": "bun run src/tools/token-cost.ts"
+    "tool:import": "bun run src/tools/import.ts"
   },
   "lint-staged": {
     "*.ts": [

package/src/cli/index.ts

@@ -15,6 +15,7 @@
  *   import [path] [--dry-run]         Import user state from zip
  *   status                            Show current PAL configuration
  *   doctor                            Check prerequisites and system health
+ *   usage                             Summarize token usage and cost
  */
 
 import { spawnSync } from "node:child_process";
@@ -168,6 +169,11 @@ async function runCli(command: string | undefined, args: string[]) {
     case "doctor":
       doctor();
       break;
+    case "usage": {
+      const { usage } = await import("../tools/token-cost");
+      usage();
+      break;
+    }
     case "--help":
     case "-h":
     case "help":
@@ -206,6 +212,7 @@ function showHelp() {
     pal cli import [path] [--dry-run]       Import state from zip
     pal cli status                          Show PAL configuration
     pal cli doctor                          Check prerequisites and health
+    pal cli usage                           Summarize token usage and cost
 
   Environment:
     PAL_HOME              Override user state directory (default: ~/.pal or repo root)

package/src/tools/token-cost.ts

@@ -1,11 +1,11 @@
 /**
- * CLI tool: summarize token usage and estimated cost.
+ * Summarize token usage and estimated cost.
  *
  * Reads from two sources:
  * 1. Claude Code session transcripts (~/.claude/projects/)
  * 2. PAL Haiku inference logs (memory/signals/token-usage.jsonl)
  *
- * Usage: bun run tool:tokens [--today|--week|--month|--all] [--project <name>]
+ * Invoked via `pal cli usage [--today|--week|--month|--all] [--project <name>]`.
  */
 
 import { existsSync, readdirSync, readFileSync } from "node:fs";
@@ -372,7 +372,7 @@ export function readPalInference(): {
 
 // ── CLI ──
 
-function run() {
+export function usage() {
   parseArgs({
     options: {
       today: { type: "boolean", default: false },
@@ -441,4 +441,4 @@ function run() {
   console.log(`\n  Grand Total: ${fmtCost(grand.cost)}\n`);
 }
 
-if (import.meta.main) run();
+if (import.meta.main) usage();