@promptbook/cli 0.114.0-5 → 0.114.0-7

package/umd/src/cli/cli-commands/common/npm/$resolveLatestNpmPackageVersion.test.d.ts

@@ -0,0 +1 @@
+export {};

package/umd/src/cli/cli-commands/common/npm/extractNpmPackageVersionFromOutput.d.ts

@@ -0,0 +1,12 @@
+/**
+ * Extracts an npm package version from raw command output.
+ *
+ * Both npm and CLI commands may emit unrelated warnings before the version. CLI commands use the first matching token;
+ * npm registry commands can opt into the last matching token because npm warnings commonly precede their JSON output.
+ *
+ * @returns The parsed version or `null` when the output contains no version
+ * @private internal utility of `promptbookCli`
+ */
+export declare function extractNpmPackageVersionFromOutput(output: string, { isLastMatchPreferred }?: {
+    readonly isLastMatchPreferred?: boolean;
+}): string | null;

package/umd/src/cli/cli-commands/common/npm/extractNpmPackageVersionFromOutput.test.d.ts

@@ -0,0 +1 @@
+export {};

package/umd/src/cli/cli-commands/common/npm/isNpmPackageVersionOutdated.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Compares an installed npm package version with the newest published version.
+ *
+ * Only the numeric `major.minor.patch` segments are compared and pre-release suffixes are ignored,
+ * so a package installed from a pre-release build of the newest version is not reported as outdated.
+ *
+ * @private internal utility of `promptbookCli`
+ */
+export declare function isNpmPackageVersionOutdated(installedVersion: string, latestVersion: string): boolean;

package/umd/src/cli/cli-commands/common/npm/isNpmPackageVersionOutdated.test.d.ts

@@ -0,0 +1 @@
+export {};

package/umd/src/cli/cli-commands/common/promptbook-cli/$checkPromptbookCliInstallations.d.ts

@@ -0,0 +1,9 @@
+import type { PromptbookCliInstallationStatus } from './PromptbookCliInstallationStatus';
+/**
+ * Checks every local and global Promptbook CLI installation against the newest npm version.
+ *
+ * Note: `$` is used to indicate that this function is not a pure function - it reads installed packages and queries npm
+ *
+ * @private internal utility of `promptbookCli`
+ */
+export declare function $checkPromptbookCliInstallations(): Promise<ReadonlyArray<PromptbookCliInstallationStatus>>;

package/umd/src/cli/cli-commands/common/promptbook-cli/$ensurePromptbookCliInstallations.d.ts

@@ -0,0 +1,14 @@
+/**
+ * Checks local and global Promptbook CLI installations before an interactive coder run and offers to update them.
+ *
+ * Once an update is approved, the caller must stop the current run and let the user start a fresh process. A local
+ * npm update can modify `package.json` and a lockfile, which would make the coder's working-tree preflight fail;
+ * more importantly, this Node.js process has already loaded the old CLI implementation.
+ *
+ * Note: `$` is used to indicate that this function is not a pure function - it reads package manifests, queries npm,
+ * asks the user, and may install npm packages
+ *
+ * @returns `true` when an update was approved and the current coder run should stop
+ * @private internal utility of `promptbookCli`
+ */
+export declare function $ensurePromptbookCliInstallations(): Promise<boolean>;

package/umd/src/cli/cli-commands/common/promptbook-cli/$ensurePromptbookCliInstallations.test.d.ts

@@ -0,0 +1 @@
+export {};

package/umd/src/cli/cli-commands/common/promptbook-cli/$resolvePromptbookCliInstallations.d.ts

@@ -0,0 +1,12 @@
+import { type PromptbookCliInstallation } from './PromptbookCliInstallation';
+/**
+ * Finds every locally or globally installed Promptbook CLI package which can be updated.
+ *
+ * A local package must be declared directly in the current project's `package.json`; transitive packages are not
+ * updated because this command must not change dependencies chosen by another package.
+ *
+ * Note: `$` is used to indicate that this function is not a pure function - it reads package manifests and runs npm
+ *
+ * @private internal utility of `promptbookCli`
+ */
+export declare function $resolvePromptbookCliInstallations(): Promise<ReadonlyArray<PromptbookCliInstallation>>;

package/umd/src/cli/cli-commands/common/promptbook-cli/$resolvePromptbookCliInstallations.test.d.ts

@@ -0,0 +1 @@
+export {};

package/umd/src/cli/cli-commands/common/promptbook-cli/$updatePromptbookCliInstallation.d.ts

@@ -0,0 +1,10 @@
+import type { PromptbookCliInstallationStatus } from './PromptbookCliInstallationStatus';
+/**
+ * Updates one Promptbook CLI package in its existing local or global location.
+ *
+ * Note: `$` is used to indicate that this function is not a pure function - it installs an npm package
+ *
+ * @returns `true` when the package update succeeds, `false` when it fails
+ * @private internal utility of `promptbookCli`
+ */
+export declare function $updatePromptbookCliInstallation(status: PromptbookCliInstallationStatus): Promise<boolean>;

package/umd/src/cli/cli-commands/common/promptbook-cli/PromptbookCliInstallation.d.ts

@@ -0,0 +1,39 @@
+/**
+ * Npm packages which provide an executable Promptbook CLI.
+ *
+ * `ptbk` is the preferred package and forwards to `@promptbook/cli`; the latter can also be installed directly.
+ *
+ * @private internal utility of `promptbookCli`
+ */
+export declare const PROMPTBOOK_CLI_NPM_PACKAGE_NAMES: readonly ["ptbk", "@promptbook/cli"];
+/**
+ * Npm package which provides an executable Promptbook CLI.
+ *
+ * @private internal utility of `promptbookCli`
+ */
+export type PromptbookCliNpmPackageName = (typeof PROMPTBOOK_CLI_NPM_PACKAGE_NAMES)[number];
+/**
+ * Place where one Promptbook CLI package is installed.
+ *
+ * @private internal utility of `promptbookCli`
+ */
+export type PromptbookCliInstallationLocation = 'local-dependency' | 'local-development-dependency' | 'global';
+/**
+ * One installed Promptbook CLI package that can be updated.
+ *
+ * @private internal utility of `promptbookCli`
+ */
+export type PromptbookCliInstallation = {
+    /**
+     * Npm package that provides the CLI.
+     */
+    readonly npmPackageName: PromptbookCliNpmPackageName;
+    /**
+     * Version from the package's installed `package.json`.
+     */
+    readonly installedVersion: string;
+    /**
+     * Local manifest section or global npm installation containing the package.
+     */
+    readonly installationLocation: PromptbookCliInstallationLocation;
+};

package/umd/src/cli/cli-commands/common/promptbook-cli/PromptbookCliInstallationStatus.d.ts

@@ -0,0 +1,26 @@
+import type { PromptbookCliInstallation } from './PromptbookCliInstallation';
+/**
+ * Result of comparing one installed Promptbook CLI package with the newest published version.
+ *
+ * @private internal utility of `promptbookCli`
+ */
+export type PromptbookCliInstallationState = 'up-to-date' | 'outdated' | 'unknown';
+/**
+ * Version status of one Promptbook CLI installation.
+ *
+ * @private internal utility of `promptbookCli`
+ */
+export type PromptbookCliInstallationStatus = {
+    /**
+     * Installed CLI package being checked.
+     */
+    readonly installation: PromptbookCliInstallation;
+    /**
+     * Result of comparing the installed version with the newest published version.
+     */
+    readonly installationState: PromptbookCliInstallationState;
+    /**
+     * Newest published package version, or `null` when npm could not be reached.
+     */
+    readonly latestVersion: string | null;
+};

package/umd/src/cli/cli-commands/common/promptbook-cli/buildPromptbookCliInstallCommand.d.ts

@@ -0,0 +1,7 @@
+import type { PromptbookCliInstallation } from './PromptbookCliInstallation';
+/**
+ * Builds the npm command that updates one existing Promptbook CLI installation.
+ *
+ * @private internal utility of `promptbookCli`
+ */
+export declare function buildPromptbookCliInstallCommand(installation: PromptbookCliInstallation): string;

package/umd/src/cli/cli-commands/common/promptbook-cli/buildPromptbookCliInstallCommand.test.d.ts

@@ -0,0 +1 @@
+export {};

package/umd/src/cli/cli-commands/common/promptbook-cli/formatPromptbookCliInstallationWarning.d.ts

@@ -0,0 +1,7 @@
+import type { PromptbookCliInstallationStatus } from './PromptbookCliInstallationStatus';
+/**
+ * Formats the warning shown when one or more Promptbook CLI installations are outdated.
+ *
+ * @private internal utility of `promptbookCli`
+ */
+export declare function formatPromptbookCliInstallationWarning(statuses: ReadonlyArray<PromptbookCliInstallationStatus>): string;

package/umd/src/utils/agent-message-runtime/resolveAgentMessageRuntimeActivity.d.ts

@@ -5,9 +5,9 @@
  * Claude Code `--output-format stream-json`) into a live runtime log file next to the queued
  * message. This helper extracts the most recent natural-language assistant narration so the
  * durable chat can show what the agent is doing right now instead of a generic thinking
- * placeholder. Only plain assistant text is surfaced; raw tool payloads, JSON envelopes and
- * other technical details are intentionally ignored, and harnesses that do not stream
- * structured text simply resolve to `null` so the caller keeps its existing behavior.
+ * placeholder. Only concrete, safe activity is surfaced; raw tool payloads, JSON envelopes,
+ * and private reasoning are intentionally ignored. When no concrete activity is known, this
+ * resolves to `null` so the caller keeps the browser's rotating generic thinking state.
  *
  * @param logText - Raw runtime log content.
  * @returns Latest human-readable activity snippet, or `null` when none can be resolved.

package/umd/src/utils/agents/terminalAgentAvatarVisual.d.ts

@@ -75,9 +75,12 @@ export type CreateTerminalAgentAvatarVisualOptions = {
      */
     readonly colorDepth?: AsciiArtColorDepth;
     /**
-     * Platform-specific canvas factory used to rasterize the visual.
+     * Platform-specific canvas factory used to rasterize pixel-based visuals.
+     *
+     * Character-based visuals such as `AsciiOctopus` paint the terminal grid directly, so they
+     * render without any canvas; a pixel-based visual renders an empty frame when it is missing.
      */
-    readonly createCanvas: CreateCanvasForAsciiArt;
+    readonly createCanvas?: CreateCanvasForAsciiArt;
 };
 /**
  * Resolves the built-in avatar visual selected for terminal rendering of one agent source.

package/umd/src/utils/ascii-art/convertImageDataToAsciiArt.d.ts

@@ -62,6 +62,12 @@ export type ConvertImageDataToAsciiArtOptions = {
      */
     readonly alphaThreshold?: number;
 };
+/**
+ * Default alpha channel value below which a cell is rendered as terminal background.
+ *
+ * @private within the repository
+ */
+export declare const DEFAULT_ALPHA_THRESHOLD = 32;
 /**
  * Converts raw RGBA image pixels into colored ASCII art for ANSI terminals.
  *

package/umd/src/utils/ascii-art/createAnsiColorCode.d.ts

@@ -0,0 +1,46 @@
+import type { AsciiArtColorDepth } from './convertImageDataToAsciiArt';
+/**
+ * ANSI escape sequence that resets all colors and attributes.
+ *
+ * @private within the repository
+ */
+export declare const ANSI_RESET = "\u001B[0m";
+/**
+ * One opaque 24-bit color which should be written into an ANSI escape sequence.
+ *
+ * @private within the repository
+ */
+export type AnsiRgbColor = {
+    /**
+     * Red channel in the range `[0, 255]`.
+     */
+    readonly red: number;
+    /**
+     * Green channel in the range `[0, 255]`.
+     */
+    readonly green: number;
+    /**
+     * Blue channel in the range `[0, 255]`.
+     */
+    readonly blue: number;
+};
+/**
+ * Creates the ANSI escape code that sets the foreground color of following characters.
+ *
+ * @param color Color painted onto the characters.
+ * @param colorDepth Color depth supported by the target terminal.
+ * @returns ANSI escape sequence.
+ *
+ * @private within the repository
+ */
+export declare function createAnsiForegroundColorCode(color: AnsiRgbColor, colorDepth: AsciiArtColorDepth): string;
+/**
+ * Creates the ANSI escape code that sets the background color of following characters.
+ *
+ * @param color Color painted behind the characters.
+ * @param colorDepth Color depth supported by the target terminal.
+ * @returns ANSI escape sequence.
+ *
+ * @private within the repository
+ */
+export declare function createAnsiBackgroundColorCode(color: AnsiRgbColor, colorDepth: AsciiArtColorDepth): string;

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

@@ -1,7 +1,9 @@
 import type { TODO_any } from '../organization/TODO_any';
 /**
- * Handles debounce.
+ * Creates a debounced function that runs after calls have been quiet for the given delay.
  *
  * @public exported from `@promptbook/utils`
  */
-export declare function debounce<T extends (...args: TODO_any[]) => void>(fn: T, delay: number): (...args: Parameters<T>) => void;
+export declare function debounce<T extends (...args: TODO_any[]) => void>(fn: T, delay: number): ((...args: Parameters<T>) => void) & {
+    cancel: () => void;
+};

package/umd/src/utils/misc/debounce.test.d.ts

@@ -0,0 +1 @@
+export {};

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-4`).
+ * It follows semantic versioning (e.g., `0.114.0-6`).
  *
  * @generated
  */

package/apps/agents-server/scripts/ignore-kill-eperm.js

@@ -1,31 +0,0 @@
-'use strict';
-
-/**
- * Best-effort Windows guard for child-process shutdown races during `next build`.
- *
- * Next.js and `jest-worker` can attempt to kill helper processes that are already
- * exiting, which intermittently throws `EPERM` on Windows. Treat those cleanup-only
- * failures as non-fatal so the build can finish normally.
- */
-const { ChildProcess } = require('node:child_process');
-
-/**
- * Original `ChildProcess.kill` implementation restored only when the process exits.
- */
-const originalKill = ChildProcess.prototype.kill;
-
-ChildProcess.prototype.kill = function patchedKill(signal) {
-    try {
-        return originalKill.call(this, signal);
-    } catch (error) {
-        if (
-            error instanceof Error &&
-            'code' in error &&
-            (error.code === 'EPERM' || error.code === 'ESRCH')
-        ) {
-            return false;
-        }
-
-        throw error;
-    }
-};

package/apps/agents-server/src/app/agents/[agentName]/api/timeouts/actions/route.ts

@@ -1,103 +0,0 @@
-import { NextResponse } from 'next/server';
-import { isPrivateModeEnabledFromRequest } from '@/src/utils/privateMode';
-import {
-    cancelAllActiveAgentScopedUserChatTimeouts,
-    pauseAllActiveAgentScopedUserChatTimeouts,
-    resumeAllPausedAgentScopedUserChatTimeouts,
-} from '@/src/utils/userChatTimeout';
-import { resolveUserChatScope } from '../../user-chats/resolveUserChatScope';
-
-/**
- * Supported bulk actions for one agent-scoped timeout manager request.
- */
-type AgentTimeoutBulkAction = 'cancel_all_active' | 'pause_all_active' | 'resume_all_paused';
-
-/**
- * Request payload accepted by timeout bulk-actions endpoint.
- */
-type AgentTimeoutBulkActionPayload = {
-    action?: unknown;
-};
-
-/**
- * Parses and validates one timeout bulk action payload.
- */
-function parseTimeoutBulkActionPayload(payload: AgentTimeoutBulkActionPayload): AgentTimeoutBulkAction | null {
-    if (payload.action === 'cancel_all_active') {
-        return payload.action;
-    }
-
-    if (payload.action === 'pause_all_active') {
-        return payload.action;
-    }
-
-    if (payload.action === 'resume_all_paused') {
-        return payload.action;
-    }
-
-    return null;
-}
-
-/**
- * Executes one bulk timeout action for current user+agent scope.
- */
-export async function POST(request: Request, { params }: { params: Promise<{ agentName: string }> }) {
-    if (isPrivateModeEnabledFromRequest(request)) {
-        return NextResponse.json({ error: 'Private mode is enabled.' }, { status: 403 });
-    }
-
-    const { agentName: rawAgentName } = await params;
-    const agentName = decodeURIComponent(rawAgentName);
-    const scopeResult = await resolveUserChatScope(agentName);
-
-    if (!scopeResult.ok) {
-        if (scopeResult.error === 'UNAUTHORIZED') {
-            return NextResponse.json({ error: 'Unauthorized' }, { status: 401 });
-        }
-
-        if (scopeResult.error === 'FORBIDDEN') {
-            return NextResponse.json({ error: 'Forbidden' }, { status: 403 });
-        }
-
-        return NextResponse.json({ error: 'Agent not found.' }, { status: 404 });
-    }
-
-    try {
-        const payload = (await request.json().catch(() => ({}))) as AgentTimeoutBulkActionPayload;
-        const action = parseTimeoutBulkActionPayload(payload);
-        if (!action) {
-            return NextResponse.json({ error: 'Invalid timeout bulk action.' }, { status: 400 });
-        }
-        const scope = scopeResult.scope;
-
-        const summary =
-            action === 'cancel_all_active'
-                ? await cancelAllActiveAgentScopedUserChatTimeouts({
-                      userId: scope.userId,
-                      agentPermanentId: scope.agentPermanentId,
-                  })
-                : action === 'pause_all_active'
-                ? await pauseAllActiveAgentScopedUserChatTimeouts({
-                      userId: scope.userId,
-                      agentPermanentId: scope.agentPermanentId,
-                  })
-                : await resumeAllPausedAgentScopedUserChatTimeouts({
-                      userId: scope.userId,
-                      agentPermanentId: scope.agentPermanentId,
-                  });
-
-        return NextResponse.json({
-            action,
-            matchedCount: summary.matchedCount,
-            updatedCount: summary.updatedCount,
-            timeoutIds: summary.timeoutIds,
-            hasMore: summary.hasMore,
-            generatedAt: new Date().toISOString(),
-        });
-    } catch (error) {
-        return NextResponse.json(
-            { error: error instanceof Error ? error.message : 'Failed to execute timeout bulk action.' },
-            { status: 400 },
-        );
-    }
-}

package/apps/agents-server/src/app/agents/[agentName]/timeouts/AgentTimeoutsClient.tsx

@@ -1,43 +0,0 @@
-'use client';
-
-import { useServerLanguage } from '@/src/components/ServerLanguage/ServerLanguageProvider';
-import { AgentTimeoutsEditDialog } from './AgentTimeoutsEditDialog';
-import { AgentTimeoutsFiltersCard } from './AgentTimeoutsFiltersCard';
-import { AgentTimeoutsHeader } from './AgentTimeoutsHeader';
-import { AgentTimeoutsSummaryMetrics } from './AgentTimeoutsSummaryMetrics';
-import { AgentTimeoutsTableCard } from './AgentTimeoutsTableCard';
-import { useAgentTimeoutsClientState } from './useAgentTimeoutsClientState';
-
-/**
- * Props for the agent timeout manager page.
- */
-type AgentTimeoutsClientProps = {
-    agentName: string;
-};
-
-/**
- * Displays all timeouts for one user+agent across chats and supports timeout edits.
- *
- * @private route component of AgentTimeoutsPage
- */
-export function AgentTimeoutsClient({ agentName }: AgentTimeoutsClientProps) {
-    const { language } = useServerLanguage();
-    const state = useAgentTimeoutsClientState({ agentName });
-
-    return (
-        <div className="container mx-auto mt-20 space-y-6 px-4 py-8">
-            <AgentTimeoutsHeader state={state} />
-            <AgentTimeoutsSummaryMetrics state={state} />
-            <AgentTimeoutsFiltersCard language={language} state={state} />
-
-            {state.errorMessage ? (
-                <div className="rounded-2xl border border-red-200 bg-red-50 p-4 text-sm text-red-700">
-                    {state.errorMessage}
-                </div>
-            ) : null}
-
-            <AgentTimeoutsTableCard agentName={agentName} language={language} state={state} />
-            <AgentTimeoutsEditDialog state={state} />
-        </div>
-    );
-}

package/apps/agents-server/src/app/agents/[agentName]/timeouts/AgentTimeoutsEditDialog.tsx

@@ -1,98 +0,0 @@
-import { Dialog } from '@/src/components/Portal/Dialog';
-import type { useAgentTimeoutsClientState } from './useAgentTimeoutsClientState';
-
-/**
- * Props for the timeout edit dialog.
- *
- * @private function of AgentTimeoutsClient
- */
-type AgentTimeoutsEditDialogProps = {
-    state: ReturnType<typeof useAgentTimeoutsClientState>;
-};
-
-/**
- * Renders the advanced timeout edit dialog.
- *
- * @private function of AgentTimeoutsClient
- */
-export function AgentTimeoutsEditDialog({ state }: AgentTimeoutsEditDialogProps) {
-    const editingTimeout = state.editingTimeout;
-
-    if (!editingTimeout) {
-        return null;
-    }
-
-    const isSaving = state.busyTimeoutId === editingTimeout.timeoutId && state.busyAction === 'save';
-
-    return (
-        <Dialog onClose={state.requestCloseEditDialog} className="w-full max-w-2xl p-5 sm:p-6">
-            <div className="space-y-4">
-                <div>
-                    <h2 className="text-lg font-semibold text-slate-900">Edit timeout</h2>
-                    <p className="text-sm text-slate-500">{editingTimeout.timeoutId}</p>
-                </div>
-
-                <label className="flex flex-col gap-1 text-sm">
-                    <span className="font-medium text-slate-700">Next run</span>
-                    <input
-                        type="datetime-local"
-                        value={state.editDraft.dueAtLocalValue}
-                        onChange={(event) => state.updateEditDueAtLocalValue(event.target.value)}
-                        className="rounded-md border border-gray-300 px-3 py-2"
-                    />
-                </label>
-
-                <label className="flex flex-col gap-1 text-sm">
-                    <span className="font-medium text-slate-700">Recurrence (minutes, leave empty for one-shot)</span>
-                    <input
-                        type="number"
-                        min="0"
-                        step="1"
-                        value={state.editDraft.recurrenceMinutesValue}
-                        onChange={(event) => state.updateEditRecurrenceMinutesValue(event.target.value)}
-                        className="rounded-md border border-gray-300 px-3 py-2"
-                    />
-                </label>
-
-                <label className="flex flex-col gap-1 text-sm">
-                    <span className="font-medium text-slate-700">Wake-up message</span>
-                    <input
-                        type="text"
-                        value={state.editDraft.messageValue}
-                        onChange={(event) => state.updateEditMessageValue(event.target.value)}
-                        className="rounded-md border border-gray-300 px-3 py-2"
-                    />
-                </label>
-
-                <label className="flex flex-col gap-1 text-sm">
-                    <span className="font-medium text-slate-700">Payload parameters (JSON object)</span>
-                    <textarea
-                        value={state.editDraft.parametersValue}
-                        onChange={(event) => state.updateEditParametersValue(event.target.value)}
-                        className="min-h-40 rounded-md border border-gray-300 px-3 py-2 font-mono text-xs"
-                    />
-                </label>
-
-                <div className="flex justify-end gap-2">
-                    <button
-                        type="button"
-                        onClick={state.requestCloseEditDialog}
-                        className="rounded-md border border-gray-300 px-3 py-2 text-sm font-semibold text-gray-700"
-                    >
-                        Close
-                    </button>
-                    <button
-                        type="button"
-                        onClick={() => {
-                            void state.saveEdits();
-                        }}
-                        disabled={isSaving}
-                        className="rounded-md border border-blue-200 bg-blue-50 px-3 py-2 text-sm font-semibold text-blue-700 disabled:opacity-60"
-                    >
-                        {isSaving ? 'Saving...' : 'Save'}
-                    </button>
-                </div>
-            </div>
-        </Dialog>
-    );
-}

package/apps/agents-server/src/app/agents/[agentName]/timeouts/AgentTimeoutsFiltersCard.tsx

@@ -1,75 +0,0 @@
-import type { ServerLanguageCode } from '@/src/languages/ServerLanguageRegistry';
-import { formatServerLanguageHumanReadableDate } from '@/src/utils/localization/formatServerLanguageHumanReadableDate';
-import type { useAgentTimeoutsClientState } from './useAgentTimeoutsClientState';
-
-/**
- * Props for the timeout filter card.
- *
- * @private function of AgentTimeoutsClient
- */
-type AgentTimeoutsFiltersCardProps = {
-    language: ServerLanguageCode;
-    state: ReturnType<typeof useAgentTimeoutsClientState>;
-};
-
-/**
- * One filter tab shown in the timeout-manager view switcher.
- *
- * @private function of AgentTimeoutsFiltersCard
- */
-type TimeoutManagerFilterOption = {
-    id: ReturnType<typeof useAgentTimeoutsClientState>['filter'];
-    label: string;
-};
-
-/**
- * Available timeout-manager filter tabs.
- *
- * @private function of AgentTimeoutsFiltersCard
- */
-const TIMEOUT_MANAGER_FILTER_OPTIONS: ReadonlyArray<TimeoutManagerFilterOption> = [
-    { id: 'active', label: 'Active' },
-    { id: 'paused', label: 'Paused' },
-    { id: 'history', label: 'History' },
-    { id: 'all', label: 'All' },
-];
-
-/**
- * Formats the refresh metadata shown below the filter tabs.
- *
- * @private function of AgentTimeoutsFiltersCard
- */
-function resolveLastRefreshedLabel(generatedAt: string | null, language: ServerLanguageCode): string {
-    return generatedAt
-        ? `Last refreshed ${formatServerLanguageHumanReadableDate(generatedAt, language)}`
-        : 'Waiting for first refresh...';
-}
-
-/**
- * Renders the timeout-manager filter tabs and refresh metadata.
- *
- * @private function of AgentTimeoutsClient
- */
-export function AgentTimeoutsFiltersCard({ language, state }: AgentTimeoutsFiltersCardProps) {
-    return (
-        <div className="rounded-2xl border border-gray-200 bg-white p-4 shadow-sm">
-            <div className="flex flex-wrap gap-2">
-                {TIMEOUT_MANAGER_FILTER_OPTIONS.map((filterOption) => (
-                    <button
-                        key={filterOption.id}
-                        type="button"
-                        onClick={() => state.selectFilter(filterOption.id)}
-                        className={`rounded-xl border px-3 py-1.5 text-sm font-semibold ${
-                            state.filter === filterOption.id
-                                ? 'border-blue-500 bg-blue-50 text-blue-700'
-                                : 'border-gray-200 bg-white text-gray-700 hover:border-gray-300 hover:bg-gray-50'
-                        }`}
-                    >
-                        {filterOption.label}
-                    </button>
-                ))}
-            </div>
-            <div className="mt-3 text-xs text-gray-500">{resolveLastRefreshedLabel(state.generatedAt, language)}</div>
-        </div>
-    );
-}