@promptbook/cli 0.113.0-1 → 0.113.0-11

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

@@ -0,0 +1,80 @@
+/**
+ * Color depth of the ANSI escape codes emitted by the ASCII-art conversion.
+ *
+ * - `TRUE_COLOR` emits 24-bit `38;2;r;g;b` / `48;2;r;g;b` sequences
+ * - `ANSI_256` approximates colors on the 256-color ANSI cube for older terminals
+ *
+ * @private within the repository
+ */
+export type AsciiArtColorDepth = 'TRUE_COLOR' | 'ANSI_256';
+/**
+ * Minimal structural subset of the DOM `ImageData` accepted by the ASCII-art conversion.
+ *
+ * Works with browser canvas `ImageData`, `@napi-rs/canvas` image data, or any raw RGBA buffer.
+ *
+ * @private within the repository
+ */
+export type AsciiArtImageData = {
+    /**
+     * Source image width in pixels.
+     */
+    readonly width: number;
+    /**
+     * Source image height in pixels.
+     */
+    readonly height: number;
+    /**
+     * Flat RGBA pixel buffer with 4 bytes per pixel.
+     */
+    readonly data: ArrayLike<number>;
+};
+/**
+ * Options for `convertImageDataToAsciiArt`.
+ *
+ * @private within the repository
+ */
+export type ConvertImageDataToAsciiArtOptions = {
+    /**
+     * Source pixels to convert.
+     */
+    readonly imageData: AsciiArtImageData;
+    /**
+     * Output width in terminal character cells.
+     */
+    readonly columns: number;
+    /**
+     * Output height in terminal character cells.
+     *
+     * Each character cell renders two vertically stacked pixels, so `rows = columns / 2`
+     * keeps a square image visually square in a common terminal font.
+     */
+    readonly rows: number;
+    /**
+     * Color depth of the emitted ANSI escape codes.
+     *
+     * @default 'TRUE_COLOR'
+     */
+    readonly colorDepth?: AsciiArtColorDepth;
+    /**
+     * Alpha channel value (0-255) below which an averaged half-cell is treated as fully transparent.
+     *
+     * @default 32
+     */
+    readonly alphaThreshold?: number;
+};
+/**
+ * Converts raw RGBA image pixels into colored ASCII art for ANSI terminals.
+ *
+ * This is the universal image-to-terminal technique used across the repository:
+ * every output character cell covers a rectangular region of source pixels which is
+ * split into a top and bottom half; each half is area-averaged and rendered with
+ * half-block characters (`▀` / `▄`) so one character shows two "pixels" vertically.
+ * Transparent halves keep the terminal background so non-rectangular images
+ * (for example rounded avatar cards) compose naturally into any terminal UI.
+ *
+ * @param options Source pixels, output grid size, and ANSI color depth.
+ * @returns One ANSI-colored string per output row, each ending with a color reset.
+ *
+ * @private within the repository
+ */
+export declare function convertImageDataToAsciiArt(options: ConvertImageDataToAsciiArtOptions): ReadonlyArray<string>;

package/umd/src/utils/color/Color.d.ts

@@ -1,8 +1,8 @@
 import type { string_color } from '../../types/string_person_fullname';
 import type { string_url_image } from '../../types/string_url_image';
 import type { WithTake } from '../take/interfaces/ITakeChain';
-import { CSS_COLORS } from './css-colors';
 import { ColorValue } from './ColorValue';
+import { CSS_COLORS } from './css-colors';
 /**
  * Color object represents an RGB color with alpha channel
  *

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.113.0-0`).
+ * It follows semantic versioning (e.g., `0.113.0-10`).
  *
  * @generated
  */

package/apps/agents-server/src/app/api/page-preview/interact/route.ts

@@ -1,179 +0,0 @@
-import { serializeError } from '@promptbook-local/utils';
-import type { NextRequest } from 'next/server';
-import { NextResponse } from 'next/server';
-import { assertsError } from '../../../../../../../src/errors/assertsError';
-import { getCurrentUser } from '../../../../utils/getCurrentUser';
-import {
-    applyLivePagePreviewInteraction,
-    isLivePagePreviewSessionId,
-    type LivePagePreviewInteraction,
-} from '../../../../utils/pagePreview/livePagePreviewSessions';
-
-/**
- * Maximum wheel delta accepted from one live-preview UI event.
- */
-const MAX_LIVE_PAGE_PREVIEW_WHEEL_DELTA = 4_000;
-
-/**
- * Maximum keyboard key name length accepted from one live-preview UI event.
- */
-const MAX_LIVE_PAGE_PREVIEW_KEY_LENGTH = 40;
-
-/**
- * Parsed live-preview interaction request body.
- */
-type ParsedLivePagePreviewInteractionRequest = {
-    readonly sessionId: string;
-    readonly interaction: LivePagePreviewInteraction;
-};
-
-/**
- * Constant for dynamic route rendering.
- */
-export const dynamic = 'force-dynamic';
-
-/**
- * Applies one UI interaction to an active live browser preview.
- *
- * Requires authentication because interaction targets are opened by the authenticated preview route.
- */
-export async function POST(request: NextRequest): Promise<NextResponse> {
-    const currentUser = await getCurrentUser();
-    if (!currentUser) {
-        return NextResponse.json({ error: 'Unauthorized' }, { status: 401 });
-    }
-
-    const parsedRequest = await parseLivePagePreviewInteractionRequest(request);
-    if (!parsedRequest) {
-        return NextResponse.json({ error: 'Invalid live preview interaction request.' }, { status: 400 });
-    }
-
-    try {
-        const isApplied = await applyLivePagePreviewInteraction(parsedRequest);
-        if (!isApplied) {
-            return NextResponse.json({ error: 'Live preview session not found.' }, { status: 404 });
-        }
-
-        return NextResponse.json({ ok: true });
-    } catch (error) {
-        assertsError(error);
-        console.error('Error applying live page preview interaction:', error);
-        return NextResponse.json({ error: serializeError(error) }, { status: 500 });
-    }
-}
-
-/**
- * Parses and validates a live-preview interaction request.
- *
- * @param request - Incoming interaction request.
- * @returns Parsed request or null when the payload is invalid.
- */
-async function parseLivePagePreviewInteractionRequest(
-    request: NextRequest,
-): Promise<ParsedLivePagePreviewInteractionRequest | null> {
-    let body: unknown;
-
-    try {
-        body = await request.json();
-    } catch {
-        return null;
-    }
-
-    if (!isRecord(body)) {
-        return null;
-    }
-
-    const sessionId = typeof body.sessionId === 'string' ? body.sessionId : null;
-    if (!sessionId || !isLivePagePreviewSessionId(sessionId)) {
-        return null;
-    }
-
-    const interaction = parseLivePagePreviewInteraction(body);
-    if (!interaction) {
-        return null;
-    }
-
-    return {
-        sessionId,
-        interaction,
-    };
-}
-
-/**
- * Parses one normalized live-preview interaction from an object payload.
- *
- * @param body - Request body record.
- * @returns Interaction payload or null when invalid.
- */
-function parseLivePagePreviewInteraction(body: Record<string, unknown>): LivePagePreviewInteraction | null {
-    if (body.type === 'click') {
-        const x = readFiniteNumber(body.x);
-        const y = readFiniteNumber(body.y);
-
-        if (x === null || y === null) {
-            return null;
-        }
-
-        return { type: 'click', x, y };
-    }
-
-    if (body.type === 'wheel') {
-        const deltaX = readFiniteNumber(body.deltaX);
-        const deltaY = readFiniteNumber(body.deltaY);
-
-        if (deltaX === null || deltaY === null) {
-            return null;
-        }
-
-        return {
-            type: 'wheel',
-            deltaX: clampWheelDelta(deltaX),
-            deltaY: clampWheelDelta(deltaY),
-        };
-    }
-
-    if (body.type === 'keyDown') {
-        const key = typeof body.key === 'string' ? body.key : null;
-        if (!key || key.length > MAX_LIVE_PAGE_PREVIEW_KEY_LENGTH) {
-            return null;
-        }
-
-        return { type: 'keyDown', key };
-    }
-
-    return null;
-}
-
-/**
- * Checks whether a value is a plain object record.
- *
- * @param value - Candidate value.
- * @returns True when the value can be read as a JSON object.
- */
-function isRecord(value: unknown): value is Record<string, unknown> {
-    return typeof value === 'object' && value !== null && !Array.isArray(value);
-}
-
-/**
- * Reads one finite number from a JSON value.
- *
- * @param value - Candidate JSON value.
- * @returns Number or null when invalid.
- */
-function readFiniteNumber(value: unknown): number | null {
-    if (typeof value !== 'number' || !Number.isFinite(value)) {
-        return null;
-    }
-
-    return value;
-}
-
-/**
- * Clamps one wheel delta to a bounded value.
- *
- * @param value - Raw wheel delta.
- * @returns Delta safe to forward to Playwright.
- */
-function clampWheelDelta(value: number): number {
-    return Math.min(Math.max(value, -MAX_LIVE_PAGE_PREVIEW_WHEEL_DELTA), MAX_LIVE_PAGE_PREVIEW_WHEEL_DELTA);
-}

package/apps/agents-server/src/app/api/page-preview/live/route.ts

@@ -1,67 +0,0 @@
-import { serializeError } from '@promptbook-local/utils';
-import type { NextRequest } from 'next/server';
-import { NextResponse } from 'next/server';
-import { assertsError } from '../../../../../../../src/errors/assertsError';
-import {
-    createLivePagePreviewStream,
-    getOrCreateLivePagePreviewSession,
-    isLivePagePreviewSessionId,
-    LIVE_PAGE_PREVIEW_STREAM_CONTENT_TYPE,
-} from '../../../../utils/pagePreview/livePagePreviewSessions';
-import { resolvePagePreviewRequestUrl } from '../../../../utils/pagePreview/resolvePagePreviewRequestUrl';
-
-/**
- * Query parameter containing the browser-side live preview session id.
- */
-const LIVE_PAGE_PREVIEW_SESSION_ID_QUERY_PARAMETER = 'sessionId';
-
-/**
- * Constant for dynamic route rendering.
- */
-export const dynamic = 'force-dynamic';
-
-/**
- * Streams a live browser preview for a knowledge source URL.
- *
- * Query parameters:
- * - `url` — fully-qualified HTTP(S) URL to preview
- * - `sessionId` — client-generated id used for forwarding interactions
- *
- * Requires authentication to prevent unauthenticated SSRF abuse.
- */
-export async function GET(request: NextRequest): Promise<NextResponse> {
-    const requestUrlResolution = await resolvePagePreviewRequestUrl(request);
-    if (requestUrlResolution.errorResponse !== null) {
-        return requestUrlResolution.errorResponse;
-    }
-
-    const sessionId = request.nextUrl.searchParams.get(LIVE_PAGE_PREVIEW_SESSION_ID_QUERY_PARAMETER);
-    if (!sessionId || !isLivePagePreviewSessionId(sessionId)) {
-        return NextResponse.json({ error: 'Missing or invalid live preview session id.' }, { status: 400 });
-    }
-
-    try {
-        const page = await getOrCreateLivePagePreviewSession({
-            sessionId,
-            url: requestUrlResolution.url,
-            signal: request.signal,
-        });
-        const stream = createLivePagePreviewStream({
-            sessionId,
-            page,
-            signal: request.signal,
-        });
-
-        return new NextResponse(stream, {
-            headers: {
-                'Content-Type': LIVE_PAGE_PREVIEW_STREAM_CONTENT_TYPE,
-                'Cache-Control': 'no-cache, no-store, max-age=0',
-                Connection: 'keep-alive',
-            },
-        });
-    } catch (error) {
-        assertsError(error);
-        console.error('Error streaming live page preview:', error);
-        return NextResponse.json({ error: serializeError(error) }, { status: 500 });
-    }
-}