@promptbook/cli 0.114.0-3 → 0.114.0-30

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

@@ -0,0 +1,76 @@
+/**
+ * One file an answered agent message created, edited or deleted inside one project.
+ *
+ * Note: [🚉] This is fully serializable as JSON
+ *
+ * @private internal type of the agent-message runtime
+ */
+export type AgentMessageProjectChangedFile = {
+    /**
+     * Path of the file relative to the project root, using `/` separators.
+     */
+    readonly path: string;
+    /**
+     * Count of lines added to the file.
+     */
+    readonly insertionCount: number;
+    /**
+     * Count of lines removed from the file.
+     */
+    readonly deletionCount: number;
+};
+/**
+ * Everything answering one single message changed inside one agent project.
+ *
+ * Each agent project is a git repository and every answer which modifies it is committed there
+ * automatically, so this describes exactly one such commit — the trace of what one message really
+ * did to one project, which a chat can show below the answer that did it.
+ *
+ * Note: [🚉] This is fully serializable as JSON
+ *
+ * @private internal type of the agent-message runtime
+ */
+export type AgentMessageProjectChange = {
+    /**
+     * Directory name of the changed project inside the agent `projects/` folder.
+     */
+    readonly projectName: string;
+    /**
+     * Full hash of the commit holding the changes of this message.
+     */
+    readonly commitHash: string;
+    /**
+     * ISO 8601 timestamp when the changes were committed.
+     */
+    readonly committedAt: string;
+    /**
+     * Files the message changed, ordered as git reports them.
+     */
+    readonly changedFiles: ReadonlyArray<AgentMessageProjectChangedFile>;
+    /**
+     * Count of lines added across all changed files.
+     */
+    readonly insertionCount: number;
+    /**
+     * Count of lines removed across all changed files.
+     */
+    readonly deletionCount: number;
+    /**
+     * Unified diff of the commit, shortened when the change is too large to carry into a chat.
+     */
+    readonly diff: string;
+    /**
+     * Whether `diff` holds only the beginning of the real diff.
+     */
+    readonly isDiffTruncated: boolean;
+};
+/**
+ * Validates one already-parsed JSON value as a project change.
+ *
+ * @param value - Raw serialized project change.
+ * @returns The typed project change, or `null` when the value does not match the expected shape,
+ * so consumers can silently skip foreign or malformed entries.
+ *
+ * @private internal utility of the agent-message runtime
+ */
+export declare function normalizeAgentMessageProjectChange(value: unknown): AgentMessageProjectChange | null;

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

@@ -0,0 +1,45 @@
+/**
+ * Category of one external source an answered agent message touched.
+ *
+ * -   `integration` is a third-party service reached through an integration, for example Gmail.
+ * -   `website` is a concrete web address the agent fetched or browsed.
+ * -   `search` is a lookup the agent ran against a web search engine.
+ *
+ * @private internal type of the agent-message runtime
+ */
+export type AgentMessageTouchedExternalSourceKind = 'integration' | 'website' | 'search';
+/**
+ * One source outside the agent itself which answering a single message viewed or edited.
+ *
+ * Everything the agent does inside its own folder stays internal and is never described here;
+ * this records only the reach beyond it, so a chat can tell which outside services and websites
+ * one answer really involved.
+ *
+ * Note: [🚉] This is fully serializable as JSON
+ *
+ * @private internal type of the agent-message runtime
+ */
+export type AgentMessageTouchedExternalSource = {
+    /**
+     * Category of the touched source.
+     */
+    readonly kind: AgentMessageTouchedExternalSourceKind;
+    /**
+     * User-facing name of the source, for example `Gmail`, `example.com` or the search query.
+     */
+    readonly name: string;
+    /**
+     * Address of the source, when the touch names a concrete one.
+     */
+    readonly url?: string;
+};
+/**
+ * Validates one already-parsed JSON value as a touched external source.
+ *
+ * @param value - Raw serialized source.
+ * @returns The typed source, or `null` when the value does not match the expected shape, so
+ * consumers can silently skip foreign or malformed entries.
+ *
+ * @private internal utility of the agent-message runtime
+ */
+export declare function normalizeAgentMessageTouchedExternalSource(value: unknown): AgentMessageTouchedExternalSource | null;

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

@@ -0,0 +1,62 @@
+/**
+ * One string-keyed payload of a coding-harness tool invocation.
+ *
+ * @private internal type of agent-message runtime logs
+ */
+type RuntimeLogToolInput = Record<string, unknown>;
+/**
+ * One content block of a Claude Code `stream-json` assistant event.
+ *
+ * @private internal type of agent-message runtime logs
+ */
+export type AgentMessageRuntimeLogContentBlock = {
+    readonly type?: string;
+    readonly text?: string;
+    readonly name?: string;
+    readonly input?: RuntimeLogToolInput;
+};
+/**
+ * One file path touched by a Codex `file_change` item.
+ *
+ * @private internal type of agent-message runtime logs
+ */
+export type AgentMessageRuntimeLogFileChange = {
+    readonly path?: string;
+};
+/**
+ * Minimal shape of one coding-harness runtime log event.
+ *
+ * The runtime log mixes two harness formats — Claude Code `stream-json` (`type`/`message`) and
+ * Codex JSONL (`type`/`item`) — so both are described by one permissive structure and every
+ * consumer reads only the fields it understands.
+ *
+ * @private internal type of agent-message runtime logs
+ */
+export type AgentMessageRuntimeLogEvent = {
+    readonly type?: string;
+    readonly message?: {
+        readonly content?: ReadonlyArray<AgentMessageRuntimeLogContentBlock>;
+    };
+    readonly item?: {
+        readonly type?: string;
+        readonly command?: string;
+        readonly exit_code?: number | null;
+        readonly changes?: ReadonlyArray<AgentMessageRuntimeLogFileChange>;
+        readonly server?: string;
+        readonly tool?: string;
+        readonly query?: string;
+    };
+};
+/**
+ * Parses every structured event out of one coding-harness runtime log.
+ *
+ * The local agent runner streams the answering harness output into a live runtime log file, one
+ * JSON event per line, optionally prefixed by shell noise. Lines without a usable JSON object are
+ * skipped so a partially written or interleaved log never breaks its consumers.
+ *
+ * @param logText - Raw runtime log content.
+ * @returns Structured events in the order they were streamed.
+ * @private internal utility of the agent-message runtime
+ */
+export declare function parseAgentMessageRuntimeLogEvents(logText: string | null | undefined): ReadonlyArray<AgentMessageRuntimeLogEvent>;
+export {};

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/agent-message-runtime/resolveAgentMessageTouchedExternalSources.d.ts

@@ -0,0 +1,18 @@
+import type { AgentMessageTouchedExternalSource } from './AgentMessageTouchedExternalSource';
+/**
+ * Resolves which sources outside the agent one coding harness touched while answering a single message.
+ *
+ * The runtime log streams what the harness really did, so a source counts as touched when the
+ * harness reached it in a tool invocation — calling an integration, fetching a web address,
+ * searching the web, or running a network client in the shell. Only tool payloads are inspected:
+ * tool results and assistant narration are ignored so a service merely mentioned in the
+ * conversation is never reported, and addresses of the machine the agent runs on are dropped
+ * because they are internal.
+ *
+ * @param options - Raw runtime log content of one answered message.
+ * @returns Touched external sources without duplicates, ordered by first appearance.
+ * @private internal utility of the agent-message runtime
+ */
+export declare function resolveAgentMessageTouchedExternalSources(options: {
+    readonly logText: string | null | undefined;
+}): ReadonlyArray<AgentMessageTouchedExternalSource>;

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

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

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

@@ -0,0 +1,19 @@
+/**
+ * Resolves which projects one coding harness touched while answering a single message.
+ *
+ * The runtime log streams what the harness really did, so a project counts as touched when the
+ * harness named it in a tool invocation — reading, searching, running, or editing files inside
+ * `projects/<project-name>/`. Only tool payloads are inspected: tool results and assistant
+ * narration are ignored so a project merely mentioned in the conversation is never reported.
+ *
+ * Every candidate is matched against the projects that really exist, which both filters prompt
+ * placeholders such as `projects/<project-name>/` and keeps the reported names canonical.
+ *
+ * @param options - Raw runtime log content and the project directory names of the agent.
+ * @returns Touched project names in the canonical spelling, ordered by first appearance.
+ * @private internal utility of the agent-message runtime
+ */
+export declare function resolveAgentMessageTouchedProjectNames(options: {
+    readonly logText: string | null | undefined;
+    readonly knownProjectNames: ReadonlyArray<string>;
+}): ReadonlyArray<string>;

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

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

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/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/utils/random/$generateBookBoilerplate.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-2`).
+ * It follows semantic versioning (e.g., `0.114.0-29`).
  *
  * @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/admin/task-manager/TaskManagerScopeTabs.tsx

@@ -1,74 +0,0 @@
-'use client';
-
-import { AdminRouteTabs, type AdminRouteTabItem } from '../_components/AdminRouteTabs';
-
-/**
- * Task-manager scope: one server, or the whole VPS.
- *
- * @private function of TaskManagerClient
- */
-export type TaskManagerScope = 'server' | 'vps';
-
-/**
- * Route of the per-server task manager.
- *
- * @private function of TaskManagerScopeTabs
- */
-export const SERVER_TASK_MANAGER_PATH = '/admin/task-manager';
-
-/**
- * Route of the VPS-wide (superadmin) task manager.
- *
- * @private function of TaskManagerScopeTabs
- */
-export const VPS_TASK_MANAGER_PATH = '/superadmin/task-manager';
-
-/**
- * Route-backed task-manager scope navigation.
- *
- * @private function of TaskManagerScopeTabs
- */
-const TASK_MANAGER_SCOPE_NAVIGATION_ITEMS: ReadonlyArray<AdminRouteTabItem<TaskManagerScope>> = [
-    {
-        id: 'server',
-        href: SERVER_TASK_MANAGER_PATH,
-        label: 'This server',
-    },
-    {
-        id: 'vps',
-        href: VPS_TASK_MANAGER_PATH,
-        label: 'All servers (VPS)',
-    },
-];
-
-/**
- * Props for the task-manager scope tabs.
- *
- * @private function of TaskManagerClient
- */
-type TaskManagerScopeTabsProps = {
-    /**
-     * Currently active scope.
-     */
-    activeScope: TaskManagerScope;
-    /**
-     * Whether the VPS-wide tab is available to the current user (superadmin only).
-     */
-    isSuperAdmin: boolean;
-};
-
-/**
- * Renders the tabs interlinking the per-server and VPS-wide task managers.
- *
- * The VPS-wide tab is superadmin-only, so ordinary admins keep the single per-server view with
- * no tab bar at all.
- *
- * @private function of TaskManagerClient
- */
-export function TaskManagerScopeTabs({ activeScope, isSuperAdmin }: TaskManagerScopeTabsProps) {
-    if (!isSuperAdmin) {
-        return null;
-    }
-
-    return <AdminRouteTabs activeTabId={activeScope} items={TASK_MANAGER_SCOPE_NAVIGATION_ITEMS} />;
-}

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>
-    );
-}