@promptbook/cli 0.114.0-21 → 0.114.0-23

package/umd/scripts/run-codex-prompts/prompts/buildPromptStatusDetails.d.ts

@@ -1,6 +1,7 @@
 import { type CodexLoginMethod } from '../../../src/book-3.0/codexLoginMethod';
 import type { ThinkingLevel } from '../../../src/cli/cli-commands/coder/ThinkingLevel';
 import type { CoderRunStep, CoderRunStepKind } from '../common/CoderRunStep';
+import { type PromptRunnerAttribution } from './promptRunnerAttribution';
 /**
  * Everything one prompt status line says after its checklist marker.
  */
@@ -22,12 +23,12 @@ export type BuildPromptStatusDetailsOptions = {
      */
     readonly modelName: string | undefined;
     /**
-     * Harness which left the prompt in the middle of its implementation, when another harness took the work over.
+     * Chronological runner report read from a prompt left in the middle of its implementation.
      *
-     * Present only for a prompt resumed through `--git-changes continue`, so a status line always names both the
-     * harness which started the work and the one which is finishing it.
+     * Present only for a prompt resumed through `--git-changes continue`, so each status rewrite preserves every
+     * preceding harness and appends the harness which is currently continuing the work.
      */
-    readonly startedByRunnerSignature?: string;
+    readonly previousRunnerSignatures?: PromptRunnerAttribution;
     /**
      * How many coding attempts the prompt has taken so far.
      */

package/umd/scripts/run-codex-prompts/prompts/markPromptFailed.d.ts

@@ -1,4 +1,5 @@
 import moment from 'moment';
+import { type PromptRunnerAttribution } from './promptRunnerAttribution';
 import type { PromptFile } from './types/PromptFile';
 import type { PromptSection } from './types/PromptSection';
 /**
@@ -22,9 +23,9 @@ export type MarkPromptFailedOptions = {
      */
     readonly modelName: string | undefined;
     /**
-     * Harness which left the prompt in the middle of its implementation, when another harness took the work over.
+     * Chronological runner report read from a prompt left in the middle of its implementation.
      */
-    readonly startedByRunnerSignature?: string;
+    readonly previousRunnerSignatures?: PromptRunnerAttribution;
     /**
      * Moment the failed prompt round started, used to report how long the attempt took.
      */

package/umd/scripts/run-codex-prompts/prompts/promptRunnerAttribution.d.ts

@@ -1,9 +1,15 @@
+/**
+ * Ordered runner signatures recorded in a prompt status line.
+ *
+ * The first signature started the work and every following signature continued an interrupted run.
+ */
+export type PromptRunnerAttribution = ReadonlyArray<string>;
 /**
  * Formats who worked on one prompt for its status line.
  *
  * Produces `` by Claude Code `claude-opus-5` `` for a prompt implemented by a single harness and
- * `` by Claude Code `claude-opus-5`, started by OpenAI Codex `gpt-5.6-luna` `` for a prompt which one
- * harness started and another one continued through `--git-changes continue`.
+ * `` by OpenAI Codex `gpt-5.6-luna`, interrupted, continued by Claude Code `claude-opus-5` `` for a
+ * prompt which one harness started and another one continued through `--git-changes continue`.
  */
 export declare function formatPromptRunnerAttribution(options: {
     /**
@@ -11,14 +17,14 @@ export declare function formatPromptRunnerAttribution(options: {
      */
     readonly currentRunnerSignature: string;
     /**
-     * Harness which left the prompt in the middle of its implementation, when the work was taken over.
+     * Chronological runner report read from the interrupted prompt before its status line is rewritten.
      */
-    readonly startedByRunnerSignature?: string;
+    readonly previousRunnerSignatures?: PromptRunnerAttribution;
 }): string;
 /**
- * Reads which harness started the work recorded on one prompt status line.
+ * Reads the chronological harness report recorded on one prompt status line.
  *
- * A line written by a single harness names that harness, and a line of a prompt which was already taken
- * over keeps naming the harness which started it, so the original author survives any number of takeovers.
+ * A line written by a single harness produces one signature. A line which has already been continued produces
+ * every signature in the order in which it worked on the prompt, so another continuation can append to it.
  */
-export declare function parsePromptStartedByRunnerSignature(statusLine: string): string | undefined;
+export declare function parsePromptRunnerAttribution(statusLine: string): PromptRunnerAttribution | undefined;

package/umd/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/umd/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/umd/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/umd/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/umd/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/umd/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/umd/scripts/run-codex-prompts/ui/CoderRunUiState.d.ts

@@ -5,6 +5,7 @@ import { type CoderRunProgressSnapshot } from '../common/buildCoderRunProgressSn
 import type { CoderRunControlFeedback, CoderRunControlFeedbackNotice } from '../common/CoderRunControlFeedback';
 import type { PriorityFilter } from '../prompts/priorityFilter';
 import type { PromptStats } from '../prompts/types/PromptStats';
+import type { HarnessSubscriptionUsage } from '../runners/types/HarnessSubscriptionUsage';
 import type { CoderRunAgentVisual } from './buildCoderRunAgentVisual';
 import type { AgentRunMessagePreviewSection, AgentRunStatusTableRow } from './buildCoderRunUiFrame';
 /**
@@ -55,6 +56,7 @@ export declare class CoderRunUiState extends EventEmitter {
     messagePreviewSections: AgentRunMessagePreviewSection[];
     agentStatusLines: string[];
     agentStatusTableRows: AgentRunStatusTableRow[];
+    subscriptionUsage: HarnessSubscriptionUsage | undefined;
     pendingEnterLabel: string | undefined;
     agentOutputLines: string[];
     phase: CoderRunPhase;
@@ -144,6 +146,10 @@ export declare class CoderRunUiState extends EventEmitter {
      * Replaces structured agent status rows shown by agent-specific terminal frames.
      */
     setAgentStatusTableRows(agentStatusTableRows: AgentRunStatusTableRow[]): void;
+    /**
+     * Replaces the optional harness subscription usage shown in the Session box.
+     */
+    setSubscriptionUsage(subscriptionUsage: HarnessSubscriptionUsage): void;
     /**
      * Sets or clears the Enter-key action label shown in the controls panel.
      */

package/umd/scripts/run-codex-prompts/ui/buildCoderRunUiFrame.d.ts

@@ -1,5 +1,6 @@
 import type { CoderRunControlFeedbackNotice } from '../common/CoderRunControlFeedback';
 import type { CoderRunPauseState } from '../common/waitForPause';
+import type { HarnessSubscriptionUsage } from '../runners/types/HarnessSubscriptionUsage';
 import type { CoderRunConfig, CoderRunPhase, CoderRunProgressSnapshot } from './CoderRunUiState';
 import type { CoderRunAgentVisual } from './buildCoderRunAgentVisual';
 /**
@@ -26,6 +27,7 @@ export type BuildCoderRunUiFrameOptions = {
     readonly pauseTargetLabel: string;
     readonly isEndAfterCurrentPromptRequested: boolean;
     readonly config: CoderRunConfig;
+    readonly subscriptionUsage?: HarnessSubscriptionUsage;
     readonly phase: CoderRunPhase;
     readonly currentPromptLabel: string;
     readonly currentScriptPaths?: readonly string[];

package/umd/scripts/run-codex-prompts/ui/buildSubscriptionUsageSessionRows.d.ts

@@ -0,0 +1,11 @@
+import type { HarnessSubscriptionUsage } from '../runners/types/HarnessSubscriptionUsage';
+import type { SessionRow } from './buildRunUiFrameShared';
+/**
+ * Builds every available subscription-limit row for the terminal Session box.
+ *
+ * The first row carries the `Usage` label and subsequent rows stay aligned beneath it, allowing a harness to report
+ * any number of windows instead of making the dashboard assume a fixed 5-hour/weekly pair.
+ *
+ * @private internal utility of coder run UI
+ */
+export declare function buildSubscriptionUsageSessionRows(subscriptionUsage: HarnessSubscriptionUsage | undefined, currentTimeMs?: number): readonly SessionRow[];

package/umd/scripts/run-codex-prompts/ui/refreshCoderRunUiSubscriptionUsage.d.ts

@@ -0,0 +1,14 @@
+import type { PromptRunner } from '../runners/types/PromptRunner';
+import type { CoderRunUiState } from './CoderRunUiState';
+/**
+ * Refreshes optional harness subscription usage in the shared coder-run UI state.
+ *
+ * Subscription visibility is an enhancement, not a prerequisite for running prompts. A harness which cannot expose a
+ * snapshot, or whose account endpoint is temporarily unavailable, therefore leaves the existing dashboard unchanged.
+ *
+ * @private internal utility of coder run UI
+ */
+export declare function refreshCoderRunUiSubscriptionUsage(options: {
+    readonly runner: PromptRunner;
+    readonly uiState: CoderRunUiState | undefined;
+}): Promise<void>;

package/umd/scripts/utils/emojiTags/validSinglePictogramEmojis.d.ts

@@ -0,0 +1,17 @@
+import type { string_char_emoji } from '../../../src/types/typeAliasEmoji';
+/**
+ * Valid single-pictogram emojis that `ptbk` can use in generated tags.
+ *
+ * The shared emoji catalogue also contains legacy symbols for other presentation
+ * purposes. Restricting generated tags to Unicode emoji-presentation pictograms
+ * prevents those symbols from being emitted as prompt identifiers.
+ *
+ * @private internal utility of generated `ptbk` emoji tags
+ */
+export declare const VALID_SINGLE_PICTOGRAM_EMOJIS: ReadonlySet<string_char_emoji>;
+/**
+ * Determines whether one catalogue entry is a valid single-pictogram emoji for a generated tag.
+ *
+ * @private internal utility of generated `ptbk` emoji tags
+ */
+export declare function isValidSinglePictogramEmoji(emoji: string_char_emoji): boolean;

package/umd/src/utils/misc/emojis.d.ts

@@ -10,9 +10,10 @@ import type { string_char_emoji } from '../../types/typeAliasEmoji';
  */
 export declare const EMOJIS_IN_CATEGORIES: Record<string, ReadonlyArray<string_char_emoji>>;
 /**
- * All possible emoji chars like "🍆", "🍡", "🍤"...
+ * Curated repository catalogue of emoji and legacy pictographic symbols.
  *
- * @deprecated Use /\p{Extended_Pictographic}/ instead
+ * Code that needs to generate a valid Unicode emoji should apply its own validation
+ * to this catalogue rather than assume every entry is an emoji.
  *
  * @private within the repository
  */

package/umd/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-22`).
  *
  * @generated
  */

package/esm/scripts/find-fresh-emoji-tags/utils/emojis.d.ts

@@ -1,16 +0,0 @@
-import type { string_char_emoji } from '../../../src/types/typeAliasEmoji';
-/**
- * All possible emoji chars like "🍆", "🍡", "🍤"...
- * Note: this will be needed to update annually - now updated at 2022-01-19
- *
- * @see https://getemoji.com/
- */
-export declare const EMOJIS_IN_CATEGORIES: Record<string, ReadonlyArray<string_char_emoji>>;
-/**
- * All possible emoji chars like "🍆", "🍡", "🍤", "🇨🇼", "🧑🏿‍❤️‍💋‍🧑🏻"...
- */
-export declare const EMOJIS: Set<string_char_emoji>;
-/**
- * Emojis which are single pictograms like "🍆", "🍡", "🍤"...
- */
-export declare const EMOJIS_OF_SINGLE_PICTOGRAM: Set<string_char_emoji>;

package/umd/scripts/find-fresh-emoji-tags/utils/emojis.d.ts

@@ -1,16 +0,0 @@
-import type { string_char_emoji } from '../../../src/types/typeAliasEmoji';
-/**
- * All possible emoji chars like "🍆", "🍡", "🍤"...
- * Note: this will be needed to update annually - now updated at 2022-01-19
- *
- * @see https://getemoji.com/
- */
-export declare const EMOJIS_IN_CATEGORIES: Record<string, ReadonlyArray<string_char_emoji>>;
-/**
- * All possible emoji chars like "🍆", "🍡", "🍤", "🇨🇼", "🧑🏿‍❤️‍💋‍🧑🏻"...
- */
-export declare const EMOJIS: Set<string_char_emoji>;
-/**
- * Emojis which are single pictograms like "🍆", "🍡", "🍤"...
- */
-export declare const EMOJIS_OF_SINGLE_PICTOGRAM: Set<string_char_emoji>;