@wrongstack/plugins 0.284.1 → 0.286.0

package/dist/todo-listener.d.ts

@@ -1,37 +1,2 @@
-import { Plugin } from '@wrongstack/core';
-
-/**
- * todo-listener plugin — PostToolUse hook on the `todo` tool that
- * broadcasts a structured status update to the project mailbox.
- *
- * When the agent (or any plugin) calls the built-in `todo` tool, the
- * full todo list is replaced in `ctx.todos`. The hook fires after the
- * tool completes, reads the new state, and posts a compact summary
- * to the project mailbox so that other agents in the same project
- * (terminals, WebUIs, shadow agents) can see what this agent is
- * working on in real time.
- *
- * Use cases:
- *  - Multi-agent fleets where a coordinator should know which
- *    sub-agent is working on which item
- *  - Long-running sessions where a user opens a second terminal and
- *    wants to see the in-progress plan
- *  - Shadow agents that audit progress across the project
- *
- * Config (`config.extensions['todo-listener']`):
- *
- * ```jsonc
- * {
- *   "enabled": false,
- *   "subjectPrefix": "todo: ",
- *   "broadcastOnChange": true,
- *   "cooldownMs": 30000
- * }
- * ```
- *
- * @public
- */
-
-declare const plugin: Plugin;
-
-export { plugin as default };
+export * from './todo-listener/index.js';
+export { default } from './todo-listener/index.js';

package/dist/todo-listener.js

@@ -212,5 +212,6 @@ var plugin = {
   }
 };
 var todo_listener_default = plugin;
-
-export { todo_listener_default as default };
+export {
+  todo_listener_default as default
+};

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

@@ -0,0 +1,4 @@
+import type { Plugin } from '@wrongstack/core';
+declare const plugin: Plugin;
+export default plugin;
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/todo-tracker/index.ts"],"names":[],"mappings":"AA+BA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,kBAAkB,CAAC;AAmK/C,QAAA,MAAM,MAAM,EAAE,MAsZb,CAAC;eAEa,MAAM"}

package/dist/todo-tracker.d.ts

@@ -1,5 +1,2 @@
-import { Plugin } from '@wrongstack/core';
-
-declare const plugin: Plugin;
-
-export { plugin as default };
+export * from './todo-tracker/index.js';
+export { default } from './todo-tracker/index.js';

package/dist/todo-tracker.js

@@ -1,7 +1,6 @@
-import * as fsp from 'fs/promises';
-import { randomUUID } from 'crypto';
-
 // src/todo-tracker/index.ts
+import * as fsp from "node:fs/promises";
+import { randomUUID } from "node:crypto";
 function deriveFilePath(api) {
   const raw = api.config.extensions?.["todo-tracker"];
   const explicit = typeof raw?.["filePath"] === "string" ? raw["filePath"] : null;
@@ -437,5 +436,6 @@ var plugin = {
   }
 };
 var todo_tracker_default = plugin;
-
-export { todo_tracker_default as default };
+export {
+  todo_tracker_default as default
+};

package/dist/token-budget/index.d.ts

@@ -0,0 +1,38 @@
+/**
+ * token-budget plugin — Enforces a per-session token budget.
+ *
+ * Complements cost-tracker (which tracks but does not enforce).
+ * When token usage crosses the warning threshold, injects a "wrap up"
+ * signal into the LLM's context. When it crosses the hard limit,
+ * triggers a Stop hook to end the agent loop.
+ *
+ * Tools registered:
+ * - token_budget_status : Show budget limit, current usage, percent
+ *                          consumed, and whether the warning/stop
+ *                          threshold has been crossed.
+ *
+ * Hooks registered:
+ * - Stop : checks whether the budget is exhausted; if so, returns
+ *          `decision: 'block'` with a reason so the agent loop does
+ *          not continue.
+ *
+ * Events subscribed:
+ * - provider.response : accumulates prompt + completion tokens.
+ *
+ * Config surface (`config.extensions['token-budget']`):
+ *
+ * ```jsonc
+ * {
+ *   "limit": 500000,       // hard token limit (prompt + completion)
+ *   "warnPercent": 80,     // inject "wrap up" at this % of limit
+ *   "stopPercent": 100,    // trigger Stop at this % of limit
+ *   "model": null          // null = all models; or restrict to one
+ * }
+ * ```
+ *
+ * @public
+ */
+import type { Plugin } from '@wrongstack/core';
+declare const plugin: Plugin;
+export default plugin;
+//# sourceMappingURL=index.d.ts.map

package/dist/token-budget/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/token-budget/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAiCG;AACH,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,kBAAkB,CAAC;AAqF/C,QAAA,MAAM,MAAM,EAAE,MA8Qb,CAAC;eAEa,MAAM"}

package/dist/token-budget.d.ts

@@ -1,40 +1,2 @@
-import { Plugin } from '@wrongstack/core';
-
-/**
- * token-budget plugin — Enforces a per-session token budget.
- *
- * Complements cost-tracker (which tracks but does not enforce).
- * When token usage crosses the warning threshold, injects a "wrap up"
- * signal into the LLM's context. When it crosses the hard limit,
- * triggers a Stop hook to end the agent loop.
- *
- * Tools registered:
- * - token_budget_status : Show budget limit, current usage, percent
- *                          consumed, and whether the warning/stop
- *                          threshold has been crossed.
- *
- * Hooks registered:
- * - Stop : checks whether the budget is exhausted; if so, returns
- *          `decision: 'block'` with a reason so the agent loop does
- *          not continue.
- *
- * Events subscribed:
- * - provider.response : accumulates prompt + completion tokens.
- *
- * Config surface (`config.extensions['token-budget']`):
- *
- * ```jsonc
- * {
- *   "limit": 500000,       // hard token limit (prompt + completion)
- *   "warnPercent": 80,     // inject "wrap up" at this % of limit
- *   "stopPercent": 100,    // trigger Stop at this % of limit
- *   "model": null          // null = all models; or restrict to one
- * }
- * ```
- *
- * @public
- */
-
-declare const plugin: Plugin;
-
-export { plugin as default };
+export * from './token-budget/index.js';
+export { default } from './token-budget/index.js';

package/dist/token-budget.js

@@ -250,5 +250,6 @@ var plugin = {
   }
 };
 var token_budget_default = plugin;
-
-export { token_budget_default as default };
+export {
+  token_budget_default as default
+};

package/dist/token-throttle/index.d.ts

@@ -0,0 +1,52 @@
+/**
+ * token-throttle plugin — enforces a rolling-window token budget on the
+ * provider wire, delaying calls to stay under a rate limit.
+ *
+ * Registers an `AgentExtension.wrapProviderRunner`. Before each provider
+ * call it prunes a 60-second sliding window of recorded spend, estimates
+ * the outgoing request's tokens, and if the window's spend plus the
+ * estimate would exceed `tokensPerMinute`, it sleeps just long enough for
+ * older spend to age out of the window (capped at `maxDelayMs`). After
+ * the call it records the response's actual usage. This smooths bursty
+ * agent loops under a provider's TPM limit instead of hitting 429s.
+ *
+ * Safety posture: opt-in — loads inert until
+ * `config.extensions['token-throttle'].enabled = true`. Delay is bounded
+ * by `maxDelayMs` so a mis-set budget can never hang the agent
+ * indefinitely.
+ *
+ * Config (`config.extensions['token-throttle']`):
+ *
+ * ```jsonc
+ * {
+ *   "enabled": false,
+ *   "tokensPerMinute": 100000,  // rolling-window budget
+ *   "maxDelayMs": 30000,        // hard cap on any single wait
+ *   "charsPerToken": 4          // request-size → token estimate divisor
+ * }
+ * ```
+ *
+ * Tools:
+ *  - `token_throttle_status` — window spend, throttle counters, total delay
+ *
+ * @public
+ */
+import type { Plugin } from '@wrongstack/core';
+export interface SpendEntry {
+    at: number;
+    tokens: number;
+}
+/** Drop entries older than the 60s window relative to `now`. */
+export declare function pruneWindow(entries: SpendEntry[], now: number): SpendEntry[];
+/** Sum tokens currently in the window. */
+export declare function windowSpend(entries: SpendEntry[]): number;
+/**
+ * Delay (ms) needed before a request of `projected` tokens can proceed
+ * without the window exceeding `limit`. 0 when it already fits. Computed
+ * by aging out just enough of the oldest spend: we find the earliest
+ * point at which enough tokens have expired to make room.
+ */
+export declare function computeThrottleDelay(entries: SpendEntry[], now: number, limit: number, projected: number): number;
+declare const plugin: Plugin;
+export default plugin;
+//# sourceMappingURL=index.d.ts.map

package/dist/token-throttle/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/token-throttle/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAgCG;AACH,OAAO,KAAK,EAAE,MAAM,EAAa,MAAM,kBAAkB,CAAC;AA8C1D,MAAM,WAAW,UAAU;IACzB,EAAE,EAAE,MAAM,CAAC;IACX,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,gEAAgE;AAChE,wBAAgB,WAAW,CAAC,OAAO,EAAE,UAAU,EAAE,EAAE,GAAG,EAAE,MAAM,GAAG,UAAU,EAAE,CAE5E;AAED,0CAA0C;AAC1C,wBAAgB,WAAW,CAAC,OAAO,EAAE,UAAU,EAAE,GAAG,MAAM,CAEzD;AAED;;;;;GAKG;AACH,wBAAgB,oBAAoB,CAClC,OAAO,EAAE,UAAU,EAAE,EACrB,GAAG,EAAE,MAAM,EACX,KAAK,EAAE,MAAM,EACb,SAAS,EAAE,MAAM,GAChB,MAAM,CAoBR;AA4CD,QAAA,MAAM,MAAM,EAAE,MAoKb,CAAC;eAEa,MAAM"}

package/dist/token-throttle.d.ts

@@ -1,54 +1,2 @@
-import { Plugin } from '@wrongstack/core';
-
-/**
- * token-throttle plugin — enforces a rolling-window token budget on the
- * provider wire, delaying calls to stay under a rate limit.
- *
- * Registers an `AgentExtension.wrapProviderRunner`. Before each provider
- * call it prunes a 60-second sliding window of recorded spend, estimates
- * the outgoing request's tokens, and if the window's spend plus the
- * estimate would exceed `tokensPerMinute`, it sleeps just long enough for
- * older spend to age out of the window (capped at `maxDelayMs`). After
- * the call it records the response's actual usage. This smooths bursty
- * agent loops under a provider's TPM limit instead of hitting 429s.
- *
- * Safety posture: opt-in — loads inert until
- * `config.extensions['token-throttle'].enabled = true`. Delay is bounded
- * by `maxDelayMs` so a mis-set budget can never hang the agent
- * indefinitely.
- *
- * Config (`config.extensions['token-throttle']`):
- *
- * ```jsonc
- * {
- *   "enabled": false,
- *   "tokensPerMinute": 100000,  // rolling-window budget
- *   "maxDelayMs": 30000,        // hard cap on any single wait
- *   "charsPerToken": 4          // request-size → token estimate divisor
- * }
- * ```
- *
- * Tools:
- *  - `token_throttle_status` — window spend, throttle counters, total delay
- *
- * @public
- */
-
-interface SpendEntry {
-    at: number;
-    tokens: number;
-}
-/** Drop entries older than the 60s window relative to `now`. */
-declare function pruneWindow(entries: SpendEntry[], now: number): SpendEntry[];
-/** Sum tokens currently in the window. */
-declare function windowSpend(entries: SpendEntry[]): number;
-/**
- * Delay (ms) needed before a request of `projected` tokens can proceed
- * without the window exceeding `limit`. 0 when it already fits. Computed
- * by aging out just enough of the oldest spend: we find the earliest
- * point at which enough tokens have expired to make room.
- */
-declare function computeThrottleDelay(entries: SpendEntry[], now: number, limit: number, projected: number): number;
-declare const plugin: Plugin;
-
-export { type SpendEntry, computeThrottleDelay, plugin as default, pruneWindow, windowSpend };
+export * from './token-throttle/index.js';
+export { default } from './token-throttle/index.js';

package/dist/token-throttle.js

@@ -204,5 +204,9 @@ var plugin = {
   }
 };
 var token_throttle_default = plugin;
-
-export { computeThrottleDelay, token_throttle_default as default, pruneWindow, windowSpend };
+export {
+  computeThrottleDelay,
+  token_throttle_default as default,
+  pruneWindow,
+  windowSpend
+};

package/dist/type-gate/index.d.ts

@@ -0,0 +1,35 @@
+/**
+ * type-gate plugin — PostToolUse hook that runs TypeScript type-checking
+ * after every `write` or `edit` to a source file.
+ *
+ * `lint-gate` validates style; this plugin validates types. It runs
+ * `tsc --noEmit` (or a user-supplied command) and injects the first few
+ * errors as `additionalContext` so the model can fix type regressions in
+ * the same turn.
+ *
+ * Tools registered:
+ * - type_gate_status : Show config + per-session counters.
+ *
+ * Hooks registered:
+ * - PostToolUse with matcher `write|edit`.
+ *
+ * Config (`config.extensions['type-gate']`):
+ *
+ * ```jsonc
+ * {
+ *   "enabled": true,
+ *   "command": "npx tsc --noEmit",  // base type-check command
+ *   "tsConfigPath": "tsconfig.json",
+ *   "timeoutMs": 60000,
+ *   "failSeverity": "warn",         // "warn" | "block"
+ *   "maxErrors": 5,                 // errors shown in context
+ *   "runOnChange": [".ts", ".tsx", ".js", ".jsx", ".mts", ".cts"]
+ * }
+ * ```
+ *
+ * @public
+ */
+import type { Plugin } from '@wrongstack/core';
+declare const plugin: Plugin;
+export default plugin;
+//# sourceMappingURL=index.d.ts.map

package/dist/type-gate/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/type-gate/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA8BG;AAKH,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,kBAAkB,CAAC;AA6M/C,QAAA,MAAM,MAAM,EAAE,MAiOb,CAAC;eAEa,MAAM"}

package/dist/type-gate.d.ts

@@ -1,37 +1,2 @@
-import { Plugin } from '@wrongstack/core';
-
-/**
- * type-gate plugin — PostToolUse hook that runs TypeScript type-checking
- * after every `write` or `edit` to a source file.
- *
- * `lint-gate` validates style; this plugin validates types. It runs
- * `tsc --noEmit` (or a user-supplied command) and injects the first few
- * errors as `additionalContext` so the model can fix type regressions in
- * the same turn.
- *
- * Tools registered:
- * - type_gate_status : Show config + per-session counters.
- *
- * Hooks registered:
- * - PostToolUse with matcher `write|edit`.
- *
- * Config (`config.extensions['type-gate']`):
- *
- * ```jsonc
- * {
- *   "enabled": true,
- *   "command": "npx tsc --noEmit",  // base type-check command
- *   "tsConfigPath": "tsconfig.json",
- *   "timeoutMs": 60000,
- *   "failSeverity": "warn",         // "warn" | "block"
- *   "maxErrors": 5,                 // errors shown in context
- *   "runOnChange": [".ts", ".tsx", ".js", ".jsx", ".mts", ".cts"]
- * }
- * ```
- *
- * @public
- */
-
-declare const plugin: Plugin;
-
-export { plugin as default };
+export * from './type-gate/index.js';
+export { default } from './type-gate/index.js';