@promptbook/node 0.114.0-21 → 0.114.0-22

package/esm/scripts/run-codex-prompts/runners/claude-code/ClaudeCodeRunner.d.ts

@@ -1,6 +1,7 @@
 import type { PromptRunOptions } from '../types/PromptRunOptions';
 import type { PromptRunResult } from '../types/PromptRunResult';
 import type { PromptRunner } from '../types/PromptRunner';
+import { type HarnessSubscriptionUsage } from '../types/HarnessSubscriptionUsage';
 import type { ClaudeCodeRunnerOptions } from './ClaudeCodeRunnerOptions';
 /**
  * Runs prompts via the Claude Code CLI.
@@ -8,10 +9,17 @@ import type { ClaudeCodeRunnerOptions } from './ClaudeCodeRunnerOptions';
 export declare class ClaudeCodeRunner implements PromptRunner {
     private readonly options;
     readonly name = "claude-code";
+    private subscriptionUsage;
     /**
      * Creates a new Claude Code runner.
      */
     constructor(options?: ClaudeCodeRunnerOptions);
+    /**
+     * Returns the latest subscription-limit snapshot emitted by this Claude Code session.
+     *
+     * Claude exposes these values in the normal stream after a response, so no separate quota-only model call is made.
+     */
+    getSubscriptionUsage(): Promise<HarnessSubscriptionUsage | undefined>;
     /**
      * Runs the prompt using Claude Code and parses usage output.
      */
@@ -20,4 +28,11 @@ export declare class ClaudeCodeRunner implements PromptRunner {
      * Runs one Claude Code CLI process and returns its raw output.
      */
     private runClaudeCodeOnce;
+    /**
+     * Keeps the newest usable Claude subscription-limit values reported by the stream.
+     *
+     * A stream can omit these values for API-key users or unsupported plan types; retaining the prior snapshot avoids
+     * a temporary omission erasing a still-valid dashboard value while a long queue is running.
+     */
+    private updateSubscriptionUsage;
 }

package/esm/scripts/run-codex-prompts/runners/claude-code/parseClaudeCodeOutputEvents.d.ts

@@ -12,7 +12,10 @@ export type ClaudeCodeOutputEvent = {
     readonly rate_limit_info?: {
         readonly status?: string;
         readonly resetsAt?: number;
+        readonly resets_at?: number;
         readonly rateLimitType?: string;
+        readonly rate_limit_type?: string;
+        readonly utilization?: number;
     };
     readonly usage?: {
         readonly input_tokens?: number;

package/esm/scripts/run-codex-prompts/runners/claude-code/parseClaudeCodeSubscriptionUsage.d.ts

@@ -0,0 +1,11 @@
+import type { HarnessSubscriptionUsage } from '../types/HarnessSubscriptionUsage';
+/**
+ * Converts Claude Code stream-json rate-limit events into the shared subscription-usage snapshot.
+ *
+ * Claude Code can emit one event for each applicable limit, so the parser preserves every distinct window instead of
+ * assuming the familiar 5-hour and seven-day pair. This lets a new vendor-side limit appear in the dashboard without
+ * changing its renderer.
+ *
+ * @private internal utility of the Claude Code runner
+ */
+export declare function parseClaudeCodeSubscriptionUsage(output: string): HarnessSubscriptionUsage | undefined;

package/esm/scripts/run-codex-prompts/runners/openai-codex/OpenAiCodexRunner.d.ts

@@ -1,6 +1,7 @@
 import type { PromptRunOptions } from '../types/PromptRunOptions';
 import type { PromptRunResult } from '../types/PromptRunResult';
 import type { PromptRunner } from '../types/PromptRunner';
+import type { HarnessSubscriptionUsage } from '../types/HarnessSubscriptionUsage';
 import type { OpenAiCodexRunnerOptions } from './OpenAiCodexRunnerOptions';
 /**
  * Runs prompts via the OpenAI Codex CLI.
@@ -13,6 +14,13 @@ export declare class OpenAiCodexRunner implements PromptRunner {
      * Creates a new Codex runner.
      */
     constructor(options: OpenAiCodexRunnerOptions);
+    /**
+     * Reads the current ChatGPT subscription quota snapshot through Codex's local app server.
+     *
+     * API-key sessions and unsupported Codex versions simply return no snapshot, which keeps this optional dashboard
+     * information from affecting the actual prompt execution.
+     */
+    getSubscriptionUsage(): Promise<HarnessSubscriptionUsage | undefined>;
     /**
      * Runs the Codex prompt in a temporary script and waits for completion output.
      */

package/esm/scripts/run-codex-prompts/runners/openai-codex/getCodexSubscriptionUsage.d.ts

@@ -0,0 +1,19 @@
+import type { HarnessSubscriptionUsage } from '../types/HarnessSubscriptionUsage';
+/**
+ * Reads the current Codex subscription limit windows through its local app-server protocol.
+ *
+ * Codex versions without this optional protocol, API-key sessions, and transient account failures simply provide no
+ * snapshot. Subscription usage is contextual UI information, so it must never make a coding prompt fail.
+ *
+ * @private internal utility of the OpenAI Codex runner
+ */
+export declare function getCodexSubscriptionUsage(codexCommand: string): Promise<HarnessSubscriptionUsage | undefined>;
+/**
+ * Converts the raw Codex app-server rate-limit response into Promptbook's harness-neutral subscription snapshot.
+ *
+ * Modern Codex versions can report several metered buckets, while older versions expose a single compatibility
+ * bucket. In both cases every primary and secondary rolling window is preserved for the terminal dashboard.
+ *
+ * @private internal utility of the OpenAI Codex runner
+ */
+export declare function buildCodexSubscriptionUsage(response: unknown): HarnessSubscriptionUsage | undefined;

package/esm/scripts/run-codex-prompts/runners/types/HarnessSubscriptionUsage.d.ts

@@ -0,0 +1,43 @@
+/**
+ * One rolling subscription limit reported by a coding harness.
+ *
+ * @private internal type of `ptbk coder`
+ */
+export type HarnessSubscriptionUsageLimit = {
+    /**
+     * Short, user-facing name of the limit window, for example `5h` or `7d`.
+     */
+    readonly label: string;
+    /**
+     * Percentage of this limit which has already been consumed, from 0 through 100.
+     */
+    readonly usedPercentage: number;
+    /**
+     * Unix timestamp in seconds at which this limit window resets, when reported by the harness.
+     */
+    readonly resetsAt?: number;
+};
+/**
+ * Subscription usage snapshot which a coding harness can optionally report.
+ *
+ * The runner contract deliberately keeps this independent from per-prompt token usage: subscription limits can be
+ * shared with other tools and can contain several rolling windows.
+ *
+ * @private internal type of `ptbk coder`
+ */
+export type HarnessSubscriptionUsage = {
+    /**
+     * Every subscription limit currently reported by the harness, in display order.
+     */
+    readonly limits: ReadonlyArray<HarnessSubscriptionUsageLimit>;
+};
+/**
+ * Merges a newly reported subset of subscription windows into the latest complete snapshot.
+ *
+ * Some harnesses emit an update only for the limit whose state changed. Keeping the previous windows means a
+ * five-hour update cannot make a still-valid weekly limit disappear from the dashboard. Existing order is preserved
+ * and newly discovered windows are appended, which keeps the terminal presentation stable between refreshes.
+ *
+ * @private internal utility of `ptbk coder`
+ */
+export declare function mergeHarnessSubscriptionUsage(previousSubscriptionUsage: HarnessSubscriptionUsage | undefined, latestSubscriptionUsage: HarnessSubscriptionUsage): HarnessSubscriptionUsage;

package/esm/src/version.d.ts

@@ -15,7 +15,7 @@ export declare const BOOK_LANGUAGE_VERSION: string_semantic_version;
 export declare const PROMPTBOOK_ENGINE_VERSION: string_promptbook_version;
 /**
  * Represents the version string of the Promptbook engine.
- * It follows semantic versioning (e.g., `0.114.0-20`).
+ * It follows semantic versioning (e.g., `0.114.0-21`).
  *
  * @generated
  */

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@promptbook/node",
-    "version": "0.114.0-21",
+    "version": "0.114.0-22",
     "description": "Promptbook: Create persistent AI agents that turn your company's scattered knowledge into action",
     "private": false,
     "sideEffects": false,
@@ -97,7 +97,7 @@
     "types": "./esm/src/_packages/node.index.d.ts",
     "typings": "./esm/src/_packages/node.index.d.ts",
     "peerDependencies": {
-        "@promptbook/core": "0.114.0-21"
+        "@promptbook/core": "0.114.0-22"
     },
     "dependencies": {
         "@openai/agents": "0.4.15",