@promptbook/cli 0.113.0-8 → 0.114.0-0

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

@@ -39,7 +39,7 @@ export type ResolveAgentAvatarOptions = {
  */
 export type ResolveAgentAvatarImageUrlOptions = ResolveAgentAvatarOptions;
 /**
- * Default built-in avatar visual used when an agent does not define `META IMAGE`.
+ * Default built-in avatar visual used when an agent does not define `META IMAGE`, `META AVATAR`, or `META VISUAL`.
  *
  * @private shared avatar contract
  */
@@ -76,7 +76,7 @@ export declare function resolveAgentAvatarVisualId(agent: ResolveAgentAvatarOpti
 export declare function resolveAgentAvatarFallbackUrl(options: ResolveAgentAvatarOptions): string_url_image | null;
 /**
  * Resolve the best avatar representation for an agent, preferring explicit `META IMAGE`
- * and otherwise returning the default deterministic canvas visual.
+ * and otherwise returning the selected deterministic canvas visual.
  *
  * @private utility of `<Chat/>`
  */

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

@@ -0,0 +1,104 @@
+import type { CreateCanvasForAsciiArt } from '../../avatars/renderAvatarVisualAsciiArt';
+import type { AvatarVisualId } from '../../avatars/types/AvatarVisualDefinition';
+import type { string_book } from '../../book-2.0/agent-source/string_book';
+import type { AsciiArtColorDepth } from '../ascii-art/convertImageDataToAsciiArt';
+/**
+ * Output width of the terminal agent avatar visual in character cells.
+ *
+ * @private shared helper for terminal avatar rendering
+ */
+export declare const TERMINAL_AGENT_AVATAR_VISUAL_COLUMNS = 48;
+/**
+ * Output height of the terminal agent avatar visual in character cells.
+ *
+ * @private shared helper for terminal avatar rendering
+ */
+export declare const TERMINAL_AGENT_AVATAR_VISUAL_ROWS = 12;
+/**
+ * Refresh cadence used while a terminal agent avatar visual is animated.
+ *
+ * @private shared helper for terminal avatar rendering
+ */
+export declare const TERMINAL_AGENT_AVATAR_VISUAL_REFRESH_INTERVAL_MS = 300;
+/**
+ * Centers ANSI-colored terminal avatar lines within one terminal frame.
+ *
+ * @param lines ANSI-colored avatar lines.
+ * @param frameColumns Available frame width in terminal character cells.
+ * @returns Avatar lines with leading terminal spaces added.
+ *
+ * @private shared helper for terminal avatar rendering
+ */
+export declare function centerTerminalAgentAvatarVisualLines(lines: ReadonlyArray<string>, frameColumns: number): ReadonlyArray<string>;
+/**
+ * Options passed when rendering one animated terminal avatar frame.
+ *
+ * @private shared helper for terminal avatar rendering
+ */
+export type TerminalAgentAvatarVisualFrameOptions = {
+    /**
+     * Current animation time forwarded to the shared avatar renderer.
+     */
+    readonly animationTimeMs: number;
+};
+/**
+ * Runtime renderer for an agent avatar visual shown in a terminal.
+ *
+ * @private shared helper for terminal avatar rendering
+ */
+export type TerminalAgentAvatarVisual = {
+    /**
+     * Whether the selected built-in visual changes over time.
+     */
+    readonly isAnimated: boolean;
+    /**
+     * Renders one ANSI ASCII-art frame for the current terminal timestamp.
+     */
+    readonly renderFrame: (options: TerminalAgentAvatarVisualFrameOptions) => ReadonlyArray<string>;
+};
+/**
+ * Options for creating a terminal avatar visual renderer from an agent book source.
+ *
+ * @private shared helper for terminal avatar rendering
+ */
+export type CreateTerminalAgentAvatarVisualOptions = {
+    /**
+     * Source of the agent book whose metadata controls avatar identity.
+     */
+    readonly agentSource: string_book;
+    /**
+     * Built-in avatar visual used when the agent does not declare `META AVATAR` or `META VISUAL`.
+     */
+    readonly defaultAvatarVisualId?: AvatarVisualId;
+    /**
+     * Color depth of the emitted ANSI escape codes.
+     */
+    readonly colorDepth?: AsciiArtColorDepth;
+    /**
+     * Platform-specific canvas factory used to rasterize the visual.
+     */
+    readonly createCanvas: CreateCanvasForAsciiArt;
+};
+/**
+ * Resolves the built-in avatar visual selected for terminal rendering of one agent source.
+ *
+ * @param agentSource Source of the agent book.
+ * @param defaultAvatarVisualId Built-in fallback used when the source does not declare an avatar visual.
+ * @returns Supported built-in avatar visual id.
+ *
+ * @private shared helper for terminal avatar rendering
+ */
+export declare function resolveTerminalAgentAvatarVisualId(agentSource: string_book, defaultAvatarVisualId?: AvatarVisualId): AvatarVisualId;
+/**
+ * Creates an ANSI ASCII-art avatar renderer for terminal UIs.
+ *
+ * The agent's avatar visual is resolved the same way as on the website: `META AVATAR`
+ * / `META VISUAL` wins, then the provided fallback visual, then the shared default visual.
+ * The terminal variant uses a transparent horizontal canvas instead of the website's framed square surface.
+ *
+ * @param options Agent source, canvas factory, and optional terminal color settings.
+ * @returns Runtime terminal avatar visual renderer.
+ *
+ * @private shared helper for terminal avatar rendering
+ */
+export declare function createTerminalAgentAvatarVisual(options: CreateTerminalAgentAvatarVisualOptions): TerminalAgentAvatarVisual;

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

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

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/utils/html/escapeHtml.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Escapes text so it can be safely inserted into HTML markup or an HTML attribute.
+ *
+ * @param value - Plain text value.
+ * @returns HTML-safe text.
+ *
+ * @private internal utility for building standalone HTML documents
+ */
+export declare function escapeHtml(value: string): string;

package/umd/src/utils/markdown/shiftMarkdownHeadingLevels.d.ts

@@ -0,0 +1,15 @@
+import type { string_markdown } from '../../types/string_markdown';
+/**
+ * Moves every heading of a markdown document deeper into the hierarchy.
+ *
+ * This is needed when an independent markdown document is embedded under an
+ * existing heading, so that the merged document keeps one consistent outline.
+ * Headings inside fenced code blocks are left untouched.
+ *
+ * @param markdown - Markdown document to shift.
+ * @param headingLevelShift - How many levels the headings should move down.
+ * @returns Markdown with shifted headings.
+ *
+ * @private internal utility for composing markdown documents
+ */
+export declare function shiftMarkdownHeadingLevels(markdown: string_markdown, headingLevelShift: number): string_markdown;

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

package/apps/agents-server/scripts/createCloudflareDnsRecordSyncPlan/createCloudflareDnsRecord.ts

@@ -1,34 +0,0 @@
-import type { CloudflareApiConfiguration, DesiredCloudflareDnsRecord } from './CloudflareDnsRecordSyncPlan';
-import { requestCloudflare } from './requestCloudflare';
-
-/**
- * Creates one Cloudflare DNS record.
- *
- * @param configuration - Cloudflare API configuration.
- * @param desiredRecord - Desired DNS record.
- *
- * @private function of `syncCloudflareDnsRecords`
- */
-export async function createCloudflareDnsRecord(
-    configuration: CloudflareApiConfiguration,
-    desiredRecord: DesiredCloudflareDnsRecord,
-): Promise<void> {
-    const body: Record<string, unknown> = {
-        type: desiredRecord.type,
-        name: desiredRecord.name,
-        content: desiredRecord.content,
-        proxied: desiredRecord.proxied,
-        ttl: desiredRecord.ttl,
-        comment: desiredRecord.comment,
-    };
-    if (desiredRecord.tags.length > 0) {
-        body.tags = desiredRecord.tags;
-    }
-
-    await requestCloudflare({
-        configuration,
-        method: 'POST',
-        pathname: `/zones/${encodeURIComponent(desiredRecord.zoneId)}/dns_records`,
-        body,
-    });
-}

package/apps/agents-server/scripts/createCloudflareDnsRecordSyncPlan/updateCloudflareDnsRecord.ts

@@ -1,41 +0,0 @@
-import {
-    createCloudflareManagedRecordComment,
-    mergeCloudflareDnsRecordTags,
-} from './CLOUDFLARE_DNS_RECORD_COMMENT_MARKER';
-import type { CloudflareApiConfiguration, CloudflareDnsRecordUpdate } from './CloudflareDnsRecordSyncPlan';
-import { requestCloudflare } from './requestCloudflare';
-
-/**
- * Updates one Cloudflare DNS record while preserving existing non-automation comments and tags.
- *
- * @param configuration - Cloudflare API configuration.
- * @param update - Existing and desired record pair.
- *
- * @private function of `syncCloudflareDnsRecords`
- */
-export async function updateCloudflareDnsRecord(
-    configuration: CloudflareApiConfiguration,
-    update: CloudflareDnsRecordUpdate,
-): Promise<void> {
-    const body: Record<string, unknown> = {
-        type: update.desiredRecord.type,
-        name: update.desiredRecord.name,
-        content: update.desiredRecord.content,
-        proxied: update.desiredRecord.proxied,
-        ttl: update.desiredRecord.ttl,
-        comment: createCloudflareManagedRecordComment(update.currentRecord.comment),
-    };
-    const mergedTags = mergeCloudflareDnsRecordTags(update.currentRecord.tags);
-    if (mergedTags.length > 0) {
-        body.tags = mergedTags;
-    }
-
-    await requestCloudflare({
-        configuration,
-        method: 'PATCH',
-        pathname: `/zones/${encodeURIComponent(update.desiredRecord.zoneId)}/dns_records/${encodeURIComponent(
-            update.currentRecord.id,
-        )}`,
-        body,
-    });
-}

package/apps/agents-server/src/app/admin/environment/EnvironmentVariablesClient.tsx

@@ -1,259 +0,0 @@
-'use client';
-
-import { EyeOff, Loader2, Save, ServerCog } from 'lucide-react';
-import { useEffect, useMemo, useState } from 'react';
-import { Card } from '../../../components/Homepage/Card';
-
-/**
- * One environment variable returned by the admin API.
- */
-type EnvironmentVariableRecord = {
-    readonly key: string;
-    readonly value: string;
-    readonly isSensitive: boolean;
-    readonly isDefined: boolean;
-};
-
-/**
- * Environment API response consumed by the client page.
- */
-type EnvironmentVariablesResponse = {
-    readonly envFilePath: string;
-    readonly variables: ReadonlyArray<EnvironmentVariableRecord>;
-    readonly canEdit: boolean;
-    readonly error?: string;
-    readonly applyResult?: {
-        readonly isAvailable: boolean;
-        readonly output: string;
-    } | null;
-};
-
-/**
- * Shared input styling for environment rows.
- */
-const INPUT_CLASS_NAME =
-    'w-full rounded-md border border-gray-300 px-3 py-2 text-sm font-mono text-gray-900 shadow-sm focus:border-blue-500 focus:outline-none focus:ring-2 focus:ring-blue-200 disabled:bg-gray-50 disabled:text-gray-500';
-
-/**
- * Placeholder shown instead of sensitive environment values.
- */
-const HIDDEN_ENVIRONMENT_VALUE = '********';
-
-/**
- * Browser UI for standalone VPS environment variables.
- */
-export function EnvironmentVariablesClient() {
-    const [envFilePath, setEnvFilePath] = useState('');
-    const [variables, setVariables] = useState<EnvironmentVariableRecord[]>([]);
-    const [draftValues, setDraftValues] = useState<Record<string, string>>({});
-    const [canEdit, setCanEdit] = useState(false);
-    const [isLoading, setIsLoading] = useState(true);
-    const [isSaving, setIsSaving] = useState(false);
-    const [errorMessage, setErrorMessage] = useState<string | null>(null);
-    const [successMessage, setSuccessMessage] = useState<string | null>(null);
-    const [applyOutput, setApplyOutput] = useState<string | null>(null);
-
-    const hasChanges = useMemo(
-        () => variables.some((variable) => draftValues[variable.key] !== variable.value),
-        [draftValues, variables],
-    );
-
-    useEffect(() => {
-        void loadVariables();
-    }, []);
-
-    /**
-     * Loads environment variables from the admin API.
-     */
-    async function loadVariables(): Promise<void> {
-        try {
-            setIsLoading(true);
-            setErrorMessage(null);
-            const response = await fetch('/api/admin/environment', { cache: 'no-store' });
-            const payload = (await response.json()) as EnvironmentVariablesResponse;
-
-            if (!response.ok) {
-                throw new Error(payload.error || 'Failed to load environment variables.');
-            }
-
-            setEnvFilePath(payload.envFilePath);
-            setVariables([...payload.variables]);
-            setDraftValues(Object.fromEntries(payload.variables.map((variable) => [variable.key, variable.value])));
-            setCanEdit(payload.canEdit);
-        } catch (error) {
-            setErrorMessage(error instanceof Error ? error.message : 'Failed to load environment variables.');
-        } finally {
-            setIsLoading(false);
-        }
-    }
-
-    /**
-     * Persists current environment drafts.
-     *
-     * @param applyRuntimeConfiguration - Whether to run the VPS apply step after saving.
-     */
-    async function saveVariables(applyRuntimeConfiguration: boolean): Promise<void> {
-        try {
-            setIsSaving(true);
-            setErrorMessage(null);
-            setSuccessMessage(null);
-            setApplyOutput(null);
-
-            const response = await fetch('/api/admin/environment', {
-                method: 'PATCH',
-                headers: {
-                    'Content-Type': 'application/json',
-                },
-                body: JSON.stringify({
-                    variables: draftValues,
-                    applyRuntimeConfiguration,
-                }),
-            });
-            const payload = (await response.json()) as EnvironmentVariablesResponse;
-
-            if (!response.ok) {
-                throw new Error(payload.error || 'Failed to save environment variables.');
-            }
-
-            setEnvFilePath(payload.envFilePath);
-            setVariables([...payload.variables]);
-            setDraftValues(Object.fromEntries(payload.variables.map((variable) => [variable.key, variable.value])));
-            setCanEdit(payload.canEdit);
-            setSuccessMessage('Environment variables were saved.');
-            setApplyOutput(payload.applyResult?.output || null);
-        } catch (error) {
-            setErrorMessage(error instanceof Error ? error.message : 'Failed to save environment variables.');
-        } finally {
-            setIsSaving(false);
-        }
-    }
-
-    return (
-        <div className="space-y-6">
-            <Card className="hover:border-gray-200 hover:shadow-md">
-                <div className="space-y-2 text-sm text-slate-600">
-                    <p>
-                        These values are stored in the VPS-wide <span className="font-mono">.env</span> file and affect
-                        the whole installed Agents Server process.
-                    </p>
-                    <p>
-                        Sensitive values are always masked. To change a secret, type a new value; leaving the stars in
-                        place keeps the current secret.
-                    </p>
-                    {envFilePath ? <p className="font-mono text-xs text-slate-500">{envFilePath}</p> : null}
-                </div>
-            </Card>
-
-            {!canEdit && (
-                <div className="rounded-xl border border-amber-200 bg-amber-50 px-4 py-3 text-sm text-amber-800">
-                    You can view environment variables as an administrator. Editing is restricted to the super admin
-                    authenticated with <span className="font-mono">ADMIN_PASSWORD</span>.
-                </div>
-            )}
-
-            {errorMessage && (
-                <div className="rounded-xl border border-rose-200 bg-rose-50 px-4 py-3 text-sm text-rose-700">
-                    {errorMessage}
-                </div>
-            )}
-            {successMessage && (
-                <div className="rounded-xl border border-emerald-200 bg-emerald-50 px-4 py-3 text-sm text-emerald-700">
-                    {successMessage}
-                </div>
-            )}
-            {applyOutput && (
-                <pre className="max-h-72 overflow-auto rounded-xl border border-slate-200 bg-slate-950 p-4 text-xs text-slate-100">
-                    {applyOutput}
-                </pre>
-            )}
-
-            <Card className="hover:border-gray-200 hover:shadow-md">
-                {isLoading ? (
-                    <div className="py-10 text-center text-sm text-gray-500">Loading environment variables...</div>
-                ) : (
-                    <div className="overflow-x-auto rounded-xl border border-gray-200">
-                        <table className="min-w-full table-fixed divide-y divide-gray-200 text-sm">
-                            <colgroup>
-                                <col className="w-[18rem]" />
-                                <col />
-                                <col className="w-[10rem]" />
-                            </colgroup>
-                            <thead className="bg-gray-50 text-xs uppercase tracking-wide text-gray-500">
-                                <tr>
-                                    <th className="px-4 py-3 text-left font-semibold">Variable</th>
-                                    <th className="px-4 py-3 text-left font-semibold">Value</th>
-                                    <th className="px-4 py-3 text-left font-semibold">Status</th>
-                                </tr>
-                            </thead>
-                            <tbody className="divide-y divide-gray-200 bg-white">
-                                {variables.map((variable) => (
-                                    <tr key={variable.key}>
-                                        <td className="px-4 py-3 align-top font-mono text-sm font-semibold text-slate-800">
-                                            {variable.key}
-                                        </td>
-                                        <td className="px-4 py-3 align-top">
-                                            <div className="relative">
-                                                <input
-                                                    type={variable.isSensitive ? 'password' : 'text'}
-                                                    value={draftValues[variable.key] ?? ''}
-                                                    onChange={(event) =>
-                                                        setDraftValues((currentDraftValues) => ({
-                                                            ...currentDraftValues,
-                                                            [variable.key]: event.target.value,
-                                                        }))
-                                                    }
-                                                    disabled={!canEdit || isSaving}
-                                                    className={`${INPUT_CLASS_NAME} ${
-                                                        variable.isSensitive ? 'pr-10 tracking-wider' : ''
-                                                    }`}
-                                                    placeholder={variable.isSensitive ? HIDDEN_ENVIRONMENT_VALUE : ''}
-                                                />
-                                                {variable.isSensitive && (
-                                                    <EyeOff className="pointer-events-none absolute right-3 top-2.5 h-4 w-4 text-slate-400" />
-                                                )}
-                                            </div>
-                                        </td>
-                                        <td className="px-4 py-3 align-top">
-                                            <span
-                                                className={`rounded-full border px-2.5 py-1 text-xs font-semibold ${
-                                                    variable.isDefined
-                                                        ? 'border-emerald-200 bg-emerald-50 text-emerald-700'
-                                                        : 'border-slate-200 bg-slate-50 text-slate-500'
-                                                }`}
-                                            >
-                                                {variable.isDefined ? 'Configured' : 'Empty'}
-                                            </span>
-                                        </td>
-                                    </tr>
-                                ))}
-                            </tbody>
-                        </table>
-                    </div>
-                )}
-            </Card>
-
-            {canEdit && (
-                <div className="flex flex-wrap items-center gap-3">
-                    <button
-                        type="button"
-                        onClick={() => void saveVariables(false)}
-                        disabled={isSaving || !hasChanges}
-                        className="inline-flex items-center gap-2 rounded-md bg-blue-600 px-4 py-2 text-sm font-semibold text-white hover:bg-blue-700 disabled:cursor-not-allowed disabled:opacity-60"
-                    >
-                        {isSaving ? <Loader2 className="h-4 w-4 animate-spin" /> : <Save className="h-4 w-4" />}
-                        Save .env
-                    </button>
-                    <button
-                        type="button"
-                        onClick={() => void saveVariables(true)}
-                        disabled={isSaving}
-                        className="inline-flex items-center gap-2 rounded-md border border-slate-300 bg-white px-4 py-2 text-sm font-semibold text-slate-700 hover:bg-slate-50 disabled:cursor-not-allowed disabled:opacity-60"
-                    >
-                        {isSaving ? <Loader2 className="h-4 w-4 animate-spin" /> : <ServerCog className="h-4 w-4" />}
-                        Save and apply VPS configuration
-                    </button>
-                </div>
-            )}
-        </div>
-    );
-}

package/apps/agents-server/src/app/pixel-agents-assets/[...assetPath]/route.ts

@@ -1,148 +0,0 @@
-import { existsSync } from 'fs';
-import { readFile } from 'fs/promises';
-import path from 'path';
-import { NextResponse } from 'next/server';
-
-/**
- * Ensures this route runs in the Node.js runtime where filesystem access is available.
- */
-export const runtime = 'nodejs';
-
-/**
- * Relative path from package root to the bundled webview assets directory.
- */
-const PIXEL_AGENTS_ASSETS_SUBPATH = path.join(
-    'dist',
-    'webview',
-    'assets',
-);
-
-/**
- * Candidate installation roots where `pixel-agents` can be located in this monorepo setup.
- */
-const PIXEL_AGENTS_PACKAGE_ROOT_CANDIDATES = [
-    path.resolve(process.cwd(), 'node_modules', 'pixel-agents'),
-    path.resolve(process.cwd(), '..', '..', 'node_modules', 'pixel-agents'),
-];
-
-/**
- * MIME types used by the lightweight asset proxy.
- */
-const CONTENT_TYPE_BY_EXTENSION: Record<string, string> = {
-    '.png': 'image/png',
-    '.jpg': 'image/jpeg',
-    '.jpeg': 'image/jpeg',
-    '.json': 'application/json; charset=utf-8',
-    '.css': 'text/css; charset=utf-8',
-    '.js': 'text/javascript; charset=utf-8',
-    '.ttf': 'font/ttf',
-};
-
-/**
- * Typed route params for catch-all asset path segments.
- */
-type PixelAgentsAssetRouteParams = {
-    assetPath: string[];
-};
-
-/**
- * Locates the absolute root directory that contains Pixel Agents assets.
- *
- * @returns Absolute assets root path or null when package is not installed.
- */
-function resolvePixelAgentsAssetsRoot(): string | null {
-    for (const packageRootCandidate of PIXEL_AGENTS_PACKAGE_ROOT_CANDIDATES) {
-        const assetsRootCandidate = path.join(packageRootCandidate, PIXEL_AGENTS_ASSETS_SUBPATH);
-        if (existsSync(assetsRootCandidate)) {
-            return assetsRootCandidate;
-        }
-    }
-
-    return null;
-}
-
-/**
- * Normalizes one catch-all route path into a safe relative file path.
- *
- * @param pathSegments - Catch-all path segments.
- * @returns Safe normalized relative path or null when invalid.
- */
-function normalizeSafeRelativePath(pathSegments: ReadonlyArray<string>): string | null {
-    if (pathSegments.length === 0) {
-        return null;
-    }
-
-    const normalizedPath = path.posix.normalize(pathSegments.join('/'));
-    if (normalizedPath.startsWith('../') || normalizedPath === '..' || normalizedPath.includes('/../')) {
-        return null;
-    }
-
-    return normalizedPath;
-}
-
-/**
- * Resolves a file content-type from its extension.
- *
- * @param filePath - Absolute file path to serve.
- * @returns MIME type header value.
- */
-function resolveContentType(filePath: string): string {
-    const extension = path.extname(filePath).toLowerCase();
-    return CONTENT_TYPE_BY_EXTENSION[extension] || 'application/octet-stream';
-}
-
-/**
- * Loads one asset file from Pixel Agents package data.
- *
- * @param relativePath - Normalized relative asset path under the package assets root.
- * @returns Binary payload and content type.
- */
-async function loadPixelAgentsAsset(relativePath: string): Promise<{ data: Buffer; contentType: string } | null> {
-    const assetsRoot = resolvePixelAgentsAssetsRoot();
-    if (!assetsRoot) {
-        return null;
-    }
-
-    const absolutePath = path.resolve(assetsRoot, relativePath);
-    const normalizedRoot = `${assetsRoot}${path.sep}`;
-    if (!absolutePath.startsWith(normalizedRoot)) {
-        return null;
-    }
-
-    try {
-        const data = await readFile(absolutePath);
-        return {
-            data,
-            contentType: resolveContentType(absolutePath),
-        };
-    } catch {
-        return null;
-    }
-}
-
-/**
- * Proxies selected Pixel Agents assets so the homepage pixel-office view can reuse package sprites.
- */
-export async function GET(
-    _request: Request,
-    { params }: { params: Promise<PixelAgentsAssetRouteParams> },
-): Promise<NextResponse> {
-    const { assetPath } = await params;
-    const relativePath = normalizeSafeRelativePath(assetPath);
-    if (!relativePath) {
-        return NextResponse.json({ error: 'Asset not found' }, { status: 404 });
-    }
-
-    const asset = await loadPixelAgentsAsset(relativePath);
-    if (!asset) {
-        return NextResponse.json({ error: 'Asset not found' }, { status: 404 });
-    }
-
-    return new NextResponse(asset.data, {
-        status: 200,
-        headers: {
-            'Content-Type': asset.contentType,
-            'Cache-Control': 'public, max-age=3600',
-        },
-    });
-}