@preapexis/pi-kit 1.0.0 → 1.0.7

package/extensions/usage-tracker.ts

@@ -1,154 +1,154 @@
-import type { ExtensionAPI } from "@earendil-works/pi-coding-agent";
-
-type EventContext = Parameters<Parameters<ExtensionAPI["on"]>[1]>[1];
-
-type AssistantMessageLike = {
-  role: "assistant";
-  usage?: {
-    input?: number;
-    output?: number;
-    cacheRead?: number;
-    cacheWrite?: number;
-    cost?: {
-      total?: number;
-    };
-  };
-};
-type UsageTotals = {
-  input: number;
-  output: number;
-  cacheRead: number;
-  cacheWrite: number;
-  totalTokens: number;
-  cost: number;
-};
-
-export default function (pi: ExtensionAPI): void {
-  const STATUS_KEY = "usage-tracker";
-  let baseline: UsageTotals = emptyTotals();
-
-  function emptyTotals(): UsageTotals {
-    return {
-      input: 0,
-      output: 0,
-      cacheRead: 0,
-      cacheWrite: 0,
-      totalTokens: 0,
-      cost: 0
-    };
-  }
-
-  function formatNumber(value: number): string {
-    if (value >= 1_000_000) return `${(value / 1_000_000).toFixed(1)}m`;
-    if (value >= 1_000) return `${(value / 1_000).toFixed(1)}k`;
-    return String(value);
-  }
-
-  function formatCost(value: number): string {
-    if (value < 0.001) return "$0.000";
-    return `$${value.toFixed(3)}`;
-  }
-
-  function subtractTotals(
-    current: UsageTotals,
-    base: UsageTotals
-  ): UsageTotals {
-    return {
-      input: Math.max(0, current.input - base.input),
-      output: Math.max(0, current.output - base.output),
-      cacheRead: Math.max(0, current.cacheRead - base.cacheRead),
-      cacheWrite: Math.max(0, current.cacheWrite - base.cacheWrite),
-      totalTokens: Math.max(0, current.totalTokens - base.totalTokens),
-      cost: Math.max(0, current.cost - base.cost)
-    };
-  }
-
-  function getUsageTotals(ctx: EventContext): UsageTotals {
-    const totals = emptyTotals();
-
-    for (const entry of ctx.sessionManager.getBranch()) {
-      if (entry.type !== "message") continue;
-      if (entry.message.role !== "assistant") continue;
-
-      const message = entry.message as AssistantMessageLike;
-      const usage = message.usage;
-
-      if (!usage) continue;
-
-      totals.input += usage.input ?? 0;
-      totals.output += usage.output ?? 0;
-      totals.cacheRead += usage.cacheRead ?? 0;
-      totals.cacheWrite += usage.cacheWrite ?? 0;
-      totals.cost += usage.cost?.total ?? 0;
-    }
-
-    totals.totalTokens =
-      totals.input + totals.output + totals.cacheRead + totals.cacheWrite;
-
-    return totals;
-  }
-
-  function updateStatus(ctx: EventContext): void {
-    if (!ctx.hasUI) return;
-
-    const totals = subtractTotals(getUsageTotals(ctx), baseline);
-
-    ctx.ui.setStatus(
-      STATUS_KEY,
-      `usage: ${formatNumber(totals.totalTokens)} ${formatCost(totals.cost)}`
-    );
-  }
-
-  function buildUsageReport(ctx: EventContext): string {
-    const totals = subtractTotals(getUsageTotals(ctx), baseline);
-
-    return [
-      "Token and price usage",
-      "",
-      `Input tokens: ${totals.input.toLocaleString()}`,
-      `Output tokens: ${totals.output.toLocaleString()}`,
-      `Cache read tokens: ${totals.cacheRead.toLocaleString()}`,
-      `Cache write tokens: ${totals.cacheWrite.toLocaleString()}`,
-      `Total tokens: ${totals.totalTokens.toLocaleString()}`,
-      `Estimated cost: ${formatCost(totals.cost)}`,
-      "",
-      `Model: ${ctx.model?.id ?? "unknown"}`
-    ].join("\n");
-  }
-
-  pi.on("session_start", async (_event, ctx) => {
-    baseline = emptyTotals();
-    updateStatus(ctx);
-  });
-
-  pi.on("message_end", async (event, ctx) => {
-    if (event.message.role === "assistant") {
-      updateStatus(ctx);
-    }
-  });
-
-  pi.on("model_select", async (_event, ctx) => {
-    updateStatus(ctx);
-  });
-
-  pi.registerCommand("usage", {
-    description: "Show token and price usage for this session",
-    handler: async (_args, ctx) => {
-      if (!ctx.hasUI) return;
-      ctx.ui.notify(buildUsageReport(ctx), "info");
-      updateStatus(ctx);
-    }
-  });
-
-  pi.registerCommand("usage-reset", {
-    description: "Reset token and price tracker baseline",
-    handler: async (_args, ctx) => {
-      baseline = getUsageTotals(ctx);
-
-      if (ctx.hasUI) {
-        ctx.ui.notify("Usage tracker reset for this session.", "info");
-        updateStatus(ctx);
-      }
-    }
-  });
-}
+import type { ExtensionAPI } from "@earendil-works/pi-coding-agent";
+
+type EventContext = Parameters<Parameters<ExtensionAPI["on"]>[1]>[1];
+
+type AssistantMessageLike = {
+  role: "assistant";
+  usage?: {
+    input?: number;
+    output?: number;
+    cacheRead?: number;
+    cacheWrite?: number;
+    cost?: {
+      total?: number;
+    };
+  };
+};
+type UsageTotals = {
+  input: number;
+  output: number;
+  cacheRead: number;
+  cacheWrite: number;
+  totalTokens: number;
+  cost: number;
+};
+
+export default function (pi: ExtensionAPI): void {
+  const STATUS_KEY = "usage-tracker";
+  let baseline: UsageTotals = emptyTotals();
+
+  function emptyTotals(): UsageTotals {
+    return {
+      input: 0,
+      output: 0,
+      cacheRead: 0,
+      cacheWrite: 0,
+      totalTokens: 0,
+      cost: 0
+    };
+  }
+
+  function formatNumber(value: number): string {
+    if (value >= 1_000_000) return `${(value / 1_000_000).toFixed(1)}m`;
+    if (value >= 1_000) return `${(value / 1_000).toFixed(1)}k`;
+    return String(value);
+  }
+
+  function formatCost(value: number): string {
+    if (value < 0.001) return "$0.000";
+    return `$${value.toFixed(3)}`;
+  }
+
+  function subtractTotals(
+    current: UsageTotals,
+    base: UsageTotals
+  ): UsageTotals {
+    return {
+      input: Math.max(0, current.input - base.input),
+      output: Math.max(0, current.output - base.output),
+      cacheRead: Math.max(0, current.cacheRead - base.cacheRead),
+      cacheWrite: Math.max(0, current.cacheWrite - base.cacheWrite),
+      totalTokens: Math.max(0, current.totalTokens - base.totalTokens),
+      cost: Math.max(0, current.cost - base.cost)
+    };
+  }
+
+  function getUsageTotals(ctx: EventContext): UsageTotals {
+    const totals = emptyTotals();
+
+    for (const entry of ctx.sessionManager.getBranch()) {
+      if (entry.type !== "message") continue;
+      if (entry.message.role !== "assistant") continue;
+
+      const message = entry.message as AssistantMessageLike;
+      const usage = message.usage;
+
+      if (!usage) continue;
+
+      totals.input += usage.input ?? 0;
+      totals.output += usage.output ?? 0;
+      totals.cacheRead += usage.cacheRead ?? 0;
+      totals.cacheWrite += usage.cacheWrite ?? 0;
+      totals.cost += usage.cost?.total ?? 0;
+    }
+
+    totals.totalTokens =
+      totals.input + totals.output + totals.cacheRead + totals.cacheWrite;
+
+    return totals;
+  }
+
+  function updateStatus(ctx: EventContext): void {
+    if (!ctx.hasUI) return;
+
+    const totals = subtractTotals(getUsageTotals(ctx), baseline);
+
+    ctx.ui.setStatus(
+      STATUS_KEY,
+      `usage: ${formatNumber(totals.totalTokens)} ${formatCost(totals.cost)}`
+    );
+  }
+
+  function buildUsageReport(ctx: EventContext): string {
+    const totals = subtractTotals(getUsageTotals(ctx), baseline);
+
+    return [
+      "Token and price usage",
+      "",
+      `Input tokens: ${totals.input.toLocaleString()}`,
+      `Output tokens: ${totals.output.toLocaleString()}`,
+      `Cache read tokens: ${totals.cacheRead.toLocaleString()}`,
+      `Cache write tokens: ${totals.cacheWrite.toLocaleString()}`,
+      `Total tokens: ${totals.totalTokens.toLocaleString()}`,
+      `Estimated cost: ${formatCost(totals.cost)}`,
+      "",
+      `Model: ${ctx.model?.id ?? "unknown"}`
+    ].join("\n");
+  }
+
+  pi.on("session_start", async (_event, ctx) => {
+    baseline = emptyTotals();
+    updateStatus(ctx);
+  });
+
+  pi.on("message_end", async (event, ctx) => {
+    if (event.message.role === "assistant") {
+      updateStatus(ctx);
+    }
+  });
+
+  pi.on("model_select", async (_event, ctx) => {
+    updateStatus(ctx);
+  });
+
+  pi.registerCommand("usage", {
+    description: "Show token and price usage for this session",
+    handler: async (_args, ctx) => {
+      if (!ctx.hasUI) return;
+      ctx.ui.notify(buildUsageReport(ctx), "info");
+      updateStatus(ctx);
+    }
+  });
+
+  pi.registerCommand("usage-reset", {
+    description: "Reset token and price tracker baseline",
+    handler: async (_args, ctx) => {
+      baseline = getUsageTotals(ctx);
+
+      if (ctx.hasUI) {
+        ctx.ui.notify("Usage tracker reset for this session.", "info");
+        updateStatus(ctx);
+      }
+    }
+  });
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@preapexis/pi-kit",
-  "version": "1.0.0",
+  "version": "1.0.7",
   "description": "Personal Pi coding-agent kit with safety extensions, status UI, prompt workflows, skills, and themes.",
   "keywords": [
     "pi-package",
@@ -32,10 +32,14 @@
   "type": "module",
   "scripts": {
     "test": "vitest run",
-    "test:watch": "vitest"
+    "test:watch": "vitest",
+    "release": "npm version patch && git push --follow-tags"
   },
   "devDependencies": {
     "typescript": "^5.5.0",
     "vitest": "^2.0.0"
+  },
+  "publishConfig": {
+    "access": "public"
   }
 }

package/prompts/init.md

@@ -1,98 +1,98 @@
-# Initialize Repository Understanding
-
-Initialize your understanding of this repository.
-
-Do not edit files.
-
-Your job is to inspect the project and produce a clear onboarding report for future work.
-
-If the repository is large, inspect the most important files first and clearly mention what was not inspected.
-
-## Steps
-
-1. Read the most important project files first:
-   - README.md
-   - AGENTS.md
-   - package.json / pyproject.toml / go.mod / Cargo.toml / pom.xml / build.gradle
-   - CONTRIBUTING.md
-   - docs/
-   - .github/workflows/
-   - docker-compose.yml / Dockerfile
-   - existing test configuration
-
-2. Identify the project structure:
-   - main application entry points
-   - important directories
-   - test locations
-   - config files
-   - generated/build output directories
-   - files that should be treated carefully
-
-3. Detect the development workflow:
-   - install command
-   - dev command
-   - build command
-   - test command
-   - lint command
-   - typecheck command
-   - formatting command
-
-4. Identify safety risks:
-   - secrets or env files
-   - deployment files
-   - database migrations
-   - production config
-   - generated files
-   - lockfiles
-   - destructive scripts
-   - commands that should require confirmation
-
-5. Infer coding conventions:
-   - language/framework
-   - naming style
-   - error handling style
-   - testing style
-   - API conventions
-   - dependency management
-
-## Output
-
-Return a repository onboarding report with these sections:
-
-# Repository Summary
-
-Briefly explain what this project appears to do.
-
-# Tech Stack
-
-List the detected languages, frameworks, libraries, and tools.
-
-# Project Map
-
-Explain the important folders and files.
-
-# Common Commands
-
-List install, dev, build, test, lint, typecheck, and format commands if found.
-
-# Safety Notes
-
-List files, directories, and commands that should be treated carefully.
-
-# Coding Conventions
-
-Summarize the project’s apparent patterns.
-
-# Recommended Agent Rules
-
-Suggest repo-specific rules that should be added to AGENTS.md or team instructions.
-
-# Open Questions
-
-List anything unclear or missing.
-
-# Inspection Notes
-
-Mention important files or areas that were not inspected.
-
-Do not modify the repository unless I explicitly ask.
+# Initialize Repository Understanding
+
+Initialize your understanding of this repository.
+
+Do not edit files.
+
+Your job is to inspect the project and produce a clear onboarding report for future work.
+
+If the repository is large, inspect the most important files first and clearly mention what was not inspected.
+
+## Steps
+
+1. Read the most important project files first:
+   - README.md
+   - AGENTS.md
+   - package.json / pyproject.toml / go.mod / Cargo.toml / pom.xml / build.gradle
+   - CONTRIBUTING.md
+   - docs/
+   - .github/workflows/
+   - docker-compose.yml / Dockerfile
+   - existing test configuration
+
+2. Identify the project structure:
+   - main application entry points
+   - important directories
+   - test locations
+   - config files
+   - generated/build output directories
+   - files that should be treated carefully
+
+3. Detect the development workflow:
+   - install command
+   - dev command
+   - build command
+   - test command
+   - lint command
+   - typecheck command
+   - formatting command
+
+4. Identify safety risks:
+   - secrets or env files
+   - deployment files
+   - database migrations
+   - production config
+   - generated files
+   - lockfiles
+   - destructive scripts
+   - commands that should require confirmation
+
+5. Infer coding conventions:
+   - language/framework
+   - naming style
+   - error handling style
+   - testing style
+   - API conventions
+   - dependency management
+
+## Output
+
+Return a repository onboarding report with these sections:
+
+# Repository Summary
+
+Briefly explain what this project appears to do.
+
+# Tech Stack
+
+List the detected languages, frameworks, libraries, and tools.
+
+# Project Map
+
+Explain the important folders and files.
+
+# Common Commands
+
+List install, dev, build, test, lint, typecheck, and format commands if found.
+
+# Safety Notes
+
+List files, directories, and commands that should be treated carefully.
+
+# Coding Conventions
+
+Summarize the project’s apparent patterns.
+
+# Recommended Agent Rules
+
+Suggest repo-specific rules that should be added to AGENTS.md or team instructions.
+
+# Open Questions
+
+List anything unclear or missing.
+
+# Inspection Notes
+
+Mention important files or areas that were not inspected.
+
+Do not modify the repository unless I explicitly ask.

package/settings.json

@@ -1,4 +1,4 @@
-{
-  "theme": "neon-guardian",
-  "defaultProjectTrust": "ask"
-}
+{
+  "theme": "neon-guardian",
+  "defaultProjectTrust": "ask"
+}