@wrongstack/plugins 0.309.1 → 0.310.0

package/dist/cost-tracker/index.d.ts

@@ -45,6 +45,8 @@ export interface ModelPricing {
     input: number;
     /** Cost per 1M output (completion) tokens in USD. */
     output: number;
+    /** Cost per 1M prompt-cache read tokens; input rate is the safe fallback. */
+    cacheRead?: number | undefined;
 }
 declare const plugin: Plugin;
 export default plugin;

package/dist/cost-tracker.js

@@ -12,13 +12,15 @@ var __copyProps = (to, from, except, desc) => {
 };
 var __reExport = (target, mod, secondTarget) => (__copyProps(target, mod, "default"), secondTarget && __copyProps(secondTarget, mod, "default"));
 
+// src/cost-tracker/index.ts
+import { expectDefined } from "@wrongstack/core/utils";
+
 // src/runtime/index.ts
 var runtime_exports = {};
 __reExport(runtime_exports, runtime_star);
 import * as runtime_star from "@wrongstack/plugin-sdk/runtime";
 
 // src/cost-tracker/index.ts
-import { expectDefined } from "@wrongstack/core/utils";
 var API_VERSION = "^0.1.10";
 var PRICING = {
   "gpt-4o": { input: 5, output: 15 },
@@ -48,14 +50,14 @@ function readCostTrackerConfig(raw) {
   };
 }
 var modelKeyCache = new runtime_exports.BoundedMap({ max: 256 });
-function estimateCost(model, promptTokens, completionTokens) {
+function estimateCost(model, freshTokens, completionTokens, cachedTokens = 0) {
   let key = modelKeyCache.get(model);
   if (!key) {
     key = model.toLowerCase();
     modelKeyCache.set(model, key);
   }
   const pricing = pricingOverrides[key] ?? bundledFromRegistry[key] ?? PRICING[key] ?? DEFAULT_PRICING;
-  const inputCost = promptTokens / 1e6 * pricing.input;
+  const inputCost = freshTokens / 1e6 * pricing.input + cachedTokens / 1e6 * (pricing.cacheRead ?? pricing.input);
   const outputCost = completionTokens / 1e6 * pricing.output;
   return inputCost + outputCost;
 }
@@ -89,12 +91,17 @@ var plugin = {
       },
       pricingOverrides: {
         type: "object",
-        description: "Per-model pricing overrides in USD per 1M tokens. Keys are lowercased model names; values are { input, output }. Takes precedence over the bundled PRICING table.",
+        description: "Per-model pricing overrides in USD per 1M tokens. Values are { input, output, cacheRead? }.",
         additionalProperties: {
           type: "object",
           properties: {
             input: { type: "number", minimum: 0, description: "Cost per 1M input tokens in USD" },
-            output: { type: "number", minimum: 0, description: "Cost per 1M output tokens in USD" }
+            output: { type: "number", minimum: 0, description: "Cost per 1M output tokens in USD" },
+            cacheRead: {
+              type: "number",
+              minimum: 0,
+              description: "Cost per 1M prompt-cache read tokens in USD"
+            }
           },
           required: ["input", "output"],
           additionalProperties: false
@@ -127,7 +134,12 @@ var plugin = {
         const input = v["input"];
         const output = v["output"];
         if (typeof input !== "number" || typeof output !== "number") continue;
-        pricingOverrides[model.toLowerCase()] = { input, output };
+        const cacheRead = v["cacheRead"];
+        pricingOverrides[model.toLowerCase()] = {
+          input,
+          output,
+          ...typeof cacheRead === "number" ? { cacheRead } : {}
+        };
       }
     }
     if (api.modelsRegistry) {
@@ -142,7 +154,8 @@ var plugin = {
             if (cost && typeof cost.input === "number" && typeof cost.output === "number") {
               bundledFromRegistry[modelId.toLowerCase()] = {
                 input: cost.input,
-                output: cost.output
+                output: cost.output,
+                ...typeof cost.cache_read === "number" ? { cacheRead: cost.cache_read } : {}
               };
               hydrated += 1;
             }
@@ -169,10 +182,12 @@ var plugin = {
     api.onEvent("provider.response", async (payload) => {
       const usage = payload.usage;
       const model = payload.ctx?.model ?? "unknown";
-      const promptTokens = usage.input ?? 0;
+      const cachedTokens = usage.cacheRead ?? 0;
+      const freshTokens = (usage.input ?? 0) + (usage.cacheWrite ?? 0);
+      const promptTokens = freshTokens + cachedTokens;
       const completionTokens = usage.output ?? 0;
       const totalTokens = promptTokens + completionTokens;
-      const costUsd = estimateCost(model, promptTokens, completionTokens);
+      const costUsd = estimateCost(model, freshTokens, completionTokens, cachedTokens);
       const record = {
         promptTokens,
         completionTokens,

package/dist/index.js

@@ -4370,14 +4370,14 @@ function readCostTrackerConfig(raw) {
   };
 }
 var modelKeyCache = new runtime_exports.BoundedMap({ max: 256 });
-function estimateCost(model, promptTokens, completionTokens) {
+function estimateCost(model, freshTokens, completionTokens, cachedTokens = 0) {
   let key = modelKeyCache.get(model);
   if (!key) {
     key = model.toLowerCase();
     modelKeyCache.set(model, key);
   }
   const pricing = pricingOverrides[key] ?? bundledFromRegistry[key] ?? PRICING[key] ?? DEFAULT_PRICING;
-  const inputCost = promptTokens / 1e6 * pricing.input;
+  const inputCost = freshTokens / 1e6 * pricing.input + cachedTokens / 1e6 * (pricing.cacheRead ?? pricing.input);
   const outputCost = completionTokens / 1e6 * pricing.output;
   return inputCost + outputCost;
 }
@@ -4411,12 +4411,17 @@ var plugin14 = {
       },
       pricingOverrides: {
         type: "object",
-        description: "Per-model pricing overrides in USD per 1M tokens. Keys are lowercased model names; values are { input, output }. Takes precedence over the bundled PRICING table.",
+        description: "Per-model pricing overrides in USD per 1M tokens. Values are { input, output, cacheRead? }.",
         additionalProperties: {
           type: "object",
           properties: {
             input: { type: "number", minimum: 0, description: "Cost per 1M input tokens in USD" },
-            output: { type: "number", minimum: 0, description: "Cost per 1M output tokens in USD" }
+            output: { type: "number", minimum: 0, description: "Cost per 1M output tokens in USD" },
+            cacheRead: {
+              type: "number",
+              minimum: 0,
+              description: "Cost per 1M prompt-cache read tokens in USD"
+            }
           },
           required: ["input", "output"],
           additionalProperties: false
@@ -4449,7 +4454,12 @@ var plugin14 = {
         const input = v["input"];
         const output = v["output"];
         if (typeof input !== "number" || typeof output !== "number") continue;
-        pricingOverrides[model.toLowerCase()] = { input, output };
+        const cacheRead = v["cacheRead"];
+        pricingOverrides[model.toLowerCase()] = {
+          input,
+          output,
+          ...typeof cacheRead === "number" ? { cacheRead } : {}
+        };
       }
     }
     if (api.modelsRegistry) {
@@ -4464,7 +4474,8 @@ var plugin14 = {
             if (cost && typeof cost.input === "number" && typeof cost.output === "number") {
               bundledFromRegistry[modelId.toLowerCase()] = {
                 input: cost.input,
-                output: cost.output
+                output: cost.output,
+                ...typeof cost.cache_read === "number" ? { cacheRead: cost.cache_read } : {}
               };
               hydrated += 1;
             }
@@ -4491,10 +4502,12 @@ var plugin14 = {
     api.onEvent("provider.response", async (payload) => {
       const usage = payload.usage;
       const model = payload.ctx?.model ?? "unknown";
-      const promptTokens = usage.input ?? 0;
+      const cachedTokens = usage.cacheRead ?? 0;
+      const freshTokens = (usage.input ?? 0) + (usage.cacheWrite ?? 0);
+      const promptTokens = freshTokens + cachedTokens;
       const completionTokens = usage.output ?? 0;
       const totalTokens = promptTokens + completionTokens;
-      const costUsd = estimateCost(model, promptTokens, completionTokens);
+      const costUsd = estimateCost(model, freshTokens, completionTokens, cachedTokens);
       const record = {
         promptTokens,
         completionTokens,
@@ -22673,9 +22686,10 @@ var plugin60 = {
 var todo_listener_default = plugin60;
 
 // src/todo-tracker/index.ts
-import * as fsp from "node:fs/promises";
 import { randomUUID } from "node:crypto";
+import * as fsp from "node:fs/promises";
 import { atomicWrite as atomicWrite3, ensureDir as ensureDir3 } from "@wrongstack/core/utils";
+import { nowIso } from "@wrongstack/primitives";
 function deriveFilePath(api) {
   const raw = api.config.extensions?.["todo-tracker"];
   const explicit = typeof raw?.["filePath"] === "string" ? raw["filePath"] : null;
@@ -22720,9 +22734,6 @@ var state56 = {
   /** Most recent mutation for /diag plugins visibility. */
   lastMutation: null
 };
-function nowIso() {
-  return (/* @__PURE__ */ new Date()).toISOString();
-}
 function ensureFile() {
   if (!state56.file) {
     state56.file = {

package/dist/todo-tracker/index.d.ts

@@ -1,3 +1,32 @@
+/**
+ * todo-tracker plugin — Persistent, project-scoped todo backlog that
+ * survives across sessions.
+ *
+ * Why a separate plugin from the built-in `todo` tool?
+ *   - The built-in `todo` tool mutates `ctx.todos`, which is
+ *     session-scoped and auto-clears when all items complete.
+ *   - todo-tracker writes to disk (`~/.wrongstack/projects/<slug>/todo-tracker.json`)
+ *     and survives across sessions. Items are explicit add/complete;
+ *     no auto-clear.
+ *
+ * Use cases:
+ *   - Backlog of work the user wants to track over days/weeks
+ *   - Items the LLM noticed but didn't finish — pull them into a fresh
+ *     session via `todo_tracker_pull` (the LLM then registers them with
+ *     the session's `ctx.todos` via the built-in `todo` tool)
+ *   - Per-project scratchpad that survives `wstack resume <id>`
+ *
+ * Tools registered:
+ *   - todo_tracker_list     : List items, filterable by status/tag/priority
+ *   - todo_tracker_add      : Append a new item
+ *   - todo_tracker_complete : Mark an item completed (idempotent)
+ *   - todo_tracker_drop     : Mark an item dropped (idempotent)
+ *   - todo_tracker_remove   : Permanently delete by id
+ *   - todo_tracker_pull     : Return pending items for LLM to promote
+ *                             into the session's ctx.todos via the
+ *                             built-in `todo` tool
+ *   - todo_tracker_status   : Counters + last update timestamp
+ */
 import type { Plugin } from '@wrongstack/core/types';
 declare const plugin: Plugin;
 export default plugin;

package/dist/todo-tracker.js

@@ -1,7 +1,8 @@
 // src/todo-tracker/index.ts
-import * as fsp from "node:fs/promises";
 import { randomUUID } from "node:crypto";
+import * as fsp from "node:fs/promises";
 import { atomicWrite, ensureDir } from "@wrongstack/core/utils";
+import { nowIso } from "@wrongstack/primitives";
 function deriveFilePath(api) {
   const raw = api.config.extensions?.["todo-tracker"];
   const explicit = typeof raw?.["filePath"] === "string" ? raw["filePath"] : null;
@@ -46,9 +47,6 @@ var state = {
   /** Most recent mutation for /diag plugins visibility. */
   lastMutation: null
 };
-function nowIso() {
-  return (/* @__PURE__ */ new Date()).toISOString();
-}
 function ensureFile() {
   if (!state.file) {
     state.file = {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@wrongstack/plugins",
-  "version": "0.309.1",
+  "version": "0.310.0",
   "description": "Official WrongStack collection of focused plugins for code quality, security, observability, planning, and agent coordination",
   "license": "MIT",
   "author": "ECOSTACK TECHNOLOGY OÜ",
@@ -303,9 +303,10 @@
     "vitest": "^4.1.11"
   },
   "dependencies": {
-    "@wrongstack/plugin-sdk": "0.309.1",
-    "@wrongstack/core": "0.309.1",
-    "@wrongstack/tools": "0.309.1"
+    "@wrongstack/core": "0.310.0",
+    "@wrongstack/tools": "0.310.0",
+    "@wrongstack/primitives": "0.310.0",
+    "@wrongstack/plugin-sdk": "0.310.0"
   },
   "scripts": {
     "build": "node ../../scripts/build-package.mjs",