@parhelia/core 0.1.12907 → 0.1.12909

package/dist/editor/ai/dialogs/captureShared.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"captureShared.js","sourceRoot":"","sources":["../../../../src/editor/ai/dialogs/captureShared.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,iGAAiG;AACjG,MAAM,UAAU,sBAAsB,CAAC,MAAc;IACnD,MAAM,YAAY,GAAG,UAAU,CAAC,MAAM,CAAC;IACvC,IAAI,YAAY,EAAE,UAAU,EAAE,CAAC;QAC7B,OAAO,YAAY,CAAC,UAAU,EAAE,CAAC;IACnC,CAAC;IACD,OAAO,GAAG,MAAM,IAAI,IAAI,CAAC,GAAG,EAAE,CAAC,QAAQ,CAAC,EAAE,CAAC,IAAI,IAAI,CAAC,MAAM,EAAE;SACzD,QAAQ,CAAC,EAAE,CAAC;SACZ,KAAK,CAAC,CAAC,CAAC,EAAE,CAAC;AAChB,CAAC;AAED,qFAAqF;AACrF,MAAM,UAAU,iBAAiB,CAAC,IAAY;IAC5C,IAAI,CAAC;QACH,OAAO,CACL,IAAI,SAAS,EAAE,CAAC,eAAe,CAAC,IAAI,EAAE,WAAW,CAAC,CAAC,KAAK,IAAI,SAAS,CACtE,CAAC;IACJ,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,SAAS,CAAC;IACnB,CAAC;AACH,CAAC;AAED,kGAAkG;AAClG,MAAM,UAAU,yBAAyB,CACvC,KAAa,EACb,MAAc;IAEd,MAAM,MAAM,GAAG,QAAQ,CAAC,aAAa,CAAC,QAAQ,CAAC,CAAC;IAChD,MAAM,CAAC,YAAY,CAAC,aAAa,EAAE,MAAM,CAAC,CAAC;IAC3C,MAAM,CAAC,QAAQ,GAAG,CAAC,CAAC,CAAC;IACrB,MAAM,CAAC,KAAK,CAAC,QAAQ,GAAG,OAAO,CAAC;IAChC,MAAM,CAAC,KAAK,CAAC,IAAI,GAAG,UAAU,CAAC;IAC/B,MAAM,CAAC,KAAK,CAAC,GAAG,GAAG,GAAG,CAAC;IACvB,MAAM,CAAC,KAAK,CAAC,KAAK,GAAG,GAAG,KAAK,IAAI,CAAC;IAClC,MAAM,CAAC,KAAK,CAAC,MAAM,GAAG,GAAG,MAAM,IAAI,CAAC;IACpC,MAAM,CAAC,KAAK,CAAC,MAAM,GAAG,GAAG,CAAC;IAC1B,MAAM,CAAC,KAAK,CAAC,OAAO,GAAG,GAAG,CAAC;IAC3B,MAAM,CAAC,KAAK,CAAC,aAAa,GAAG,MAAM,CAAC;IACpC,OAAO,MAAM,CAAC;AAChB,CAAC"}

package/dist/editor/ai/dialogs/offscreenPageCapture.d.ts

@@ -0,0 +1,44 @@
+import type { ItemDescriptor } from "../../pageModel";
+import type { CapturePageDomResult, CapturePageScreenshotParameters, CapturePageScreenshotResult, CapturePageTargetContext } from "./agentDialogTypes";
+export type OffscreenViewport = {
+    width: number;
+    height: number;
+};
+/**
+ * Resolves the offscreen render viewport from the capture parameters, clamping to a sane range and
+ * falling back to the desktop defaults. Pure and unit-testable.
+ */
+export declare function resolveOffscreenViewport(params?: {
+    viewportWidth?: number;
+    viewportHeight?: number;
+}): OffscreenViewport;
+/**
+ * Decides whether a capture request should render its target page in a hidden iframe. True only for a
+ * background capture whose target page differs from the page this session currently has open (when a
+ * helper session already has the target page open, the cheaper live-page capture is used instead).
+ */
+export declare function shouldRenderTargetOffscreen(params: {
+    backgroundCapture?: boolean;
+    targetItemId?: string;
+    openItemId?: string;
+}): boolean;
+/**
+ * Builds the URL a hidden iframe loads to render the target page in preview mode with the Parhelia
+ * editing bridge enabled. Pure aside from `window.location` host alignment, so it is unit-testable.
+ */
+export declare function buildOffscreenRenderUrl(params: {
+    previewUrl: string;
+    descriptor: ItemDescriptor;
+    site?: string;
+    helperSessionId: string;
+}): string;
+/**
+ * Renders the target page in a hidden iframe and returns its DOM. Used for background/taskboard agents
+ * that have no attached browser and no page open.
+ */
+export declare function capturePageDomOffscreen(target: CapturePageTargetContext, helperSessionId: string, viewport: OffscreenViewport): Promise<CapturePageDomResult>;
+/**
+ * Renders the target page in a hidden iframe and returns a screenshot. Reuses the shared bridge
+ * screenshot pipeline (captureScreenshotFromBridgeSource) against the transient offscreen bridge.
+ */
+export declare function capturePageScreenshotOffscreen(params: CapturePageScreenshotParameters, target: CapturePageTargetContext, helperSessionId: string, viewport: OffscreenViewport): Promise<CapturePageScreenshotResult>;

package/dist/editor/ai/dialogs/offscreenPageCapture.js

@@ -0,0 +1,300 @@
+import { resolvePageAndSite } from "../../services/contentService";
+import { BridgeClient } from "../../bridge/BridgeClient";
+import { alignLoopbackHostToEditor, alignXmCloudManagedEditingHostToEditor, applyParheliaRenderContext, getEditorQueryParam, } from "../../page-viewer/renderUrl";
+import { captureScreenshotFromBridgeSource, } from "./capturePageScreenshot";
+import { createCaptureRequestId, createHiddenCaptureIframe, readTitleFromHtml, } from "./captureShared";
+// Offscreen render defaults to a desktop-width surface so background captures reflect a normal page
+// layout; agents can override via the viewportWidth/viewportHeight tool parameters (e.g. a mobile width).
+const DEFAULT_VIEWPORT_WIDTH = 1280;
+const DEFAULT_VIEWPORT_HEIGHT = 900;
+const MIN_VIEWPORT = 240;
+const MAX_VIEWPORT_WIDTH = 3840;
+const MAX_VIEWPORT_HEIGHT = 4320;
+const BRIDGE_READY_TIMEOUT_MS = 20_000;
+const DOM_SETTLE_TIMEOUT_MS = 6_000;
+function clampViewportValue(value, fallback, max) {
+    if (typeof value !== "number" || !Number.isFinite(value) || value <= 0) {
+        return fallback;
+    }
+    return Math.min(max, Math.max(MIN_VIEWPORT, Math.round(value)));
+}
+/**
+ * Resolves the offscreen render viewport from the capture parameters, clamping to a sane range and
+ * falling back to the desktop defaults. Pure and unit-testable.
+ */
+export function resolveOffscreenViewport(params) {
+    return {
+        width: clampViewportValue(params?.viewportWidth, DEFAULT_VIEWPORT_WIDTH, MAX_VIEWPORT_WIDTH),
+        height: clampViewportValue(params?.viewportHeight, DEFAULT_VIEWPORT_HEIGHT, MAX_VIEWPORT_HEIGHT),
+    };
+}
+function normalizeItemId(value) {
+    return value?.trim().toLowerCase() || "";
+}
+/**
+ * Decides whether a capture request should render its target page in a hidden iframe. True only for a
+ * background capture whose target page differs from the page this session currently has open (when a
+ * helper session already has the target page open, the cheaper live-page capture is used instead).
+ */
+export function shouldRenderTargetOffscreen(params) {
+    const { backgroundCapture, targetItemId, openItemId } = params;
+    if (backgroundCapture !== true || !targetItemId)
+        return false;
+    if (!openItemId)
+        return true;
+    return normalizeItemId(openItemId) !== normalizeItemId(targetItemId);
+}
+/**
+ * Builds the URL a hidden iframe loads to render the target page in preview mode with the Parhelia
+ * editing bridge enabled. Pure aside from `window.location` host alignment, so it is unit-testable.
+ */
+export function buildOffscreenRenderUrl(params) {
+    const { previewUrl, descriptor, site, helperSessionId } = params;
+    const renderUrl = new URL(previewUrl, window.location.origin);
+    alignLoopbackHostToEditor(renderUrl);
+    alignXmCloudManagedEditingHostToEditor(renderUrl);
+    applyParheliaRenderContext(renderUrl, descriptor, site || getEditorQueryParam("site"));
+    // Force the editing bridge to be injected even though this is a preview render, and bind it to the
+    // helper's live session so the host (AddPlaceholderMarker / personalization session check) accepts it.
+    renderUrl.searchParams.set("parhelia", "1");
+    if (helperSessionId) {
+        renderUrl.searchParams.set("parhelia_session", helperSessionId);
+    }
+    renderUrl.searchParams.set("edit_rev", createCaptureRequestId("edit-rev"));
+    return renderUrl.toString();
+}
+async function resolveOffscreenRender(target, helperSessionId) {
+    if (!target?.itemId) {
+        return {
+            error: "The capture request is missing a target item, so the page cannot be rendered offscreen.",
+        };
+    }
+    // Host/base-URL alignment and access checks belong to the editor's request context, so the preview
+    // URL is resolved here (not server-side) via the canonical resolve stack. This also enforces the
+    // helper/owner's read access to the item.
+    const resolved = await resolvePageAndSite(target.itemId, target.language ?? "en", target.version ?? 0);
+    if (!resolved?.previewUrl) {
+        return {
+            error: "Could not resolve a preview URL for the target page (it may not exist or you may not have access).",
+        };
+    }
+    const site = resolved.site?.name ?? target.site;
+    const descriptor = resolved.pageItem;
+    return {
+        url: buildOffscreenRenderUrl({
+            previewUrl: resolved.previewUrl,
+            descriptor,
+            site,
+            helperSessionId,
+        }),
+        site,
+        descriptor,
+    };
+}
+/**
+ * Creates a hidden iframe, drives a transient BridgeClient against it, waits for the page to render
+ * and settle, runs `fn`, then always tears down the bridge + iframe.
+ */
+async function withOffscreenPageBridge(url, helperSessionId, requestedViewport, fn) {
+    if (!document.body) {
+        throw new Error("The Parhelia UI has not finished loading yet.");
+    }
+    const iframe = createHiddenCaptureIframe(requestedViewport.width, requestedViewport.height);
+    let latestGeometry;
+    let latestDom;
+    let viewport = {
+        width: requestedViewport.width,
+        height: requestedViewport.height,
+    };
+    let domSettled = false;
+    let onDomSettled;
+    let readyResolve;
+    let readyReject;
+    const bridge = new BridgeClient({
+        iframe,
+        editorOrigin: window.location.origin,
+        allowedHostOrigins: [safeOrigin(url)],
+        readyTimeoutMs: BRIDGE_READY_TIMEOUT_MS,
+        onReadyChange: (ready) => {
+            if (ready)
+                readyResolve?.();
+        },
+        onError: (error) => {
+            readyReject?.(error);
+        },
+        onEvent: (event) => {
+            if (event.name === "ready") {
+                const payload = event.payload;
+                if (payload.viewport)
+                    viewport = payload.viewport;
+            }
+            else if (event.name === "geometryUpdated") {
+                latestGeometry = event.payload
+                    .geometry;
+            }
+            else if (event.name === "domUpdated") {
+                latestDom = event.payload;
+                if (latestDom.viewport)
+                    viewport = latestDom.viewport;
+                if (!domSettled) {
+                    domSettled = true;
+                    onDomSettled?.();
+                }
+            }
+        },
+    });
+    iframe.src = url;
+    document.body.appendChild(iframe);
+    try {
+        bridge.connect();
+        await new Promise((resolve, reject) => {
+            readyResolve = resolve;
+            readyReject = reject;
+            if (bridge.isReady())
+                resolve();
+        });
+        // Mirror the live editor: send `init` so the host starts emitting structure/geometry/dom
+        // immediately instead of waiting out its init-fallback timer.
+        bridge.sendCommand("init", {
+            editorOrigin: window.location.origin,
+            sessionId: helperSessionId,
+            mode: "preview",
+            selectedComponentIds: [],
+            version: bridge.getDiagnostics().editorVersion,
+            acknowledgedCapabilities: bridge.getAcknowledgedCapabilities(),
+        });
+        // Wait for the first domUpdated so the page has rendered, with a bounded, cancelable fallback.
+        if (!domSettled) {
+            await new Promise((resolve) => {
+                let timer = window.setTimeout(() => {
+                    timer = undefined;
+                    resolve();
+                }, DOM_SETTLE_TIMEOUT_MS);
+                onDomSettled = () => {
+                    if (timer !== undefined) {
+                        window.clearTimeout(timer);
+                        timer = undefined;
+                    }
+                    resolve();
+                };
+            });
+        }
+        return await fn({
+            bridge,
+            iframe,
+            getGeometry: () => latestGeometry,
+            getDom: () => latestDom,
+            getViewport: () => viewport,
+        });
+    }
+    finally {
+        try {
+            bridge.disconnect();
+        }
+        catch {
+            // ignore teardown errors
+        }
+        iframe.remove();
+    }
+}
+function safeOrigin(url) {
+    try {
+        return new URL(url, window.location.origin).origin;
+    }
+    catch {
+        return window.location.origin;
+    }
+}
+async function requestDomFromBridge(state) {
+    const result = await state.bridge.requestCommand("captureDom", { requestId: createCaptureRequestId("capture-dom") }, "captureDomResult", { timeoutMs: 10_000 });
+    if (result.error) {
+        throw new Error(result.error);
+    }
+    const html = result.html ?? state.getDom()?.html ?? "";
+    if (!html.trim()) {
+        throw new Error("The rendered page DOM was empty.");
+    }
+    return html;
+}
+/**
+ * Renders the target page in a hidden iframe and returns its DOM. Used for background/taskboard agents
+ * that have no attached browser and no page open.
+ */
+export async function capturePageDomOffscreen(target, helperSessionId, viewport) {
+    const resolved = await resolveOffscreenRender(target, helperSessionId);
+    if ("error" in resolved) {
+        return { success: false, scope: "page", error: resolved.error };
+    }
+    try {
+        const html = await withOffscreenPageBridge(resolved.url, helperSessionId, viewport, (state) => requestDomFromBridge(state));
+        return {
+            success: true,
+            scope: "page",
+            html,
+            length: html.length,
+            documentTitle: readTitleFromHtml(html),
+        };
+    }
+    catch (error) {
+        return {
+            success: false,
+            scope: "page",
+            error: error instanceof Error
+                ? error.message
+                : "Failed to render the target page offscreen for DOM capture.",
+        };
+    }
+}
+function normalizeBackgroundScreenshotScope(scope) {
+    // editor-ui/viewport/selection are meaningless for an offscreen render (no editor surface, no user
+    // selection), so default those to a full-page shot. Component scopes resolve via bridge geometry.
+    switch (scope) {
+        case "component":
+        case "component-range":
+        case "page":
+            return scope;
+        default:
+            return "page";
+    }
+}
+/**
+ * Renders the target page in a hidden iframe and returns a screenshot. Reuses the shared bridge
+ * screenshot pipeline (captureScreenshotFromBridgeSource) against the transient offscreen bridge.
+ */
+export async function capturePageScreenshotOffscreen(params, target, helperSessionId, viewport) {
+    const scope = normalizeBackgroundScreenshotScope(params?.scope);
+    const resolved = await resolveOffscreenRender(target, helperSessionId);
+    if ("error" in resolved) {
+        return { success: false, scope, error: resolved.error };
+    }
+    try {
+        const result = await withOffscreenPageBridge(resolved.url, helperSessionId, viewport, async (state) => {
+            const source = {
+                bridgeReady: true,
+                bridgeGeometry: state.getGeometry(),
+                bridgeDom: state.getDom(),
+                viewport: state.getViewport(),
+                editorIframe: state.iframe,
+                requestBridgeCaptureDom: (payload) => state.bridge.requestCommand("captureDom", payload, "captureDomResult", {
+                    timeoutMs: 10_000,
+                }),
+            };
+            return captureScreenshotFromBridgeSource(source, { ...params, scope }, [], scope);
+        });
+        return (result ?? {
+            success: false,
+            scope,
+            error: "The offscreen page bridge was not ready to capture a screenshot.",
+        });
+    }
+    catch (error) {
+        return {
+            success: false,
+            scope,
+            error: error instanceof Error
+                ? error.message
+                : "Failed to render the target page offscreen for screenshot capture.",
+        };
+    }
+}
+//# sourceMappingURL=offscreenPageCapture.js.map

package/dist/editor/ai/dialogs/offscreenPageCapture.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"offscreenPageCapture.js","sourceRoot":"","sources":["../../../../src/editor/ai/dialogs/offscreenPageCapture.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,kBAAkB,EAAE,MAAM,+BAA+B,CAAC;AACnE,OAAO,EAAE,YAAY,EAAE,MAAM,2BAA2B,CAAC;AAQzD,OAAO,EACL,yBAAyB,EACzB,sCAAsC,EACtC,0BAA0B,EAC1B,mBAAmB,GACpB,MAAM,6BAA6B,CAAC;AACrC,OAAO,EACL,iCAAiC,GAElC,MAAM,yBAAyB,CAAC;AACjC,OAAO,EACL,sBAAsB,EACtB,yBAAyB,EACzB,iBAAiB,GAClB,MAAM,iBAAiB,CAAC;AASzB,oGAAoG;AACpG,0GAA0G;AAC1G,MAAM,sBAAsB,GAAG,IAAI,CAAC;AACpC,MAAM,uBAAuB,GAAG,GAAG,CAAC;AACpC,MAAM,YAAY,GAAG,GAAG,CAAC;AACzB,MAAM,kBAAkB,GAAG,IAAI,CAAC;AAChC,MAAM,mBAAmB,GAAG,IAAI,CAAC;AACjC,MAAM,uBAAuB,GAAG,MAAM,CAAC;AACvC,MAAM,qBAAqB,GAAG,KAAK,CAAC;AAIpC,SAAS,kBAAkB,CACzB,KAAyB,EACzB,QAAgB,EAChB,GAAW;IAEX,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,KAAK,CAAC,IAAI,KAAK,IAAI,CAAC,EAAE,CAAC;QACvE,OAAO,QAAQ,CAAC;IAClB,CAAC;IACD,OAAO,IAAI,CAAC,GAAG,CAAC,GAAG,EAAE,IAAI,CAAC,GAAG,CAAC,YAAY,EAAE,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;AAClE,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,wBAAwB,CAAC,MAGxC;IACC,OAAO;QACL,KAAK,EAAE,kBAAkB,CACvB,MAAM,EAAE,aAAa,EACrB,sBAAsB,EACtB,kBAAkB,CACnB;QACD,MAAM,EAAE,kBAAkB,CACxB,MAAM,EAAE,cAAc,EACtB,uBAAuB,EACvB,mBAAmB,CACpB;KACF,CAAC;AACJ,CAAC;AAED,SAAS,eAAe,CAAC,KAAgC;IACvD,OAAO,KAAK,EAAE,IAAI,EAAE,CAAC,WAAW,EAAE,IAAI,EAAE,CAAC;AAC3C,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,2BAA2B,CAAC,MAI3C;IACC,MAAM,EAAE,iBAAiB,EAAE,YAAY,EAAE,UAAU,EAAE,GAAG,MAAM,CAAC;IAC/D,IAAI,iBAAiB,KAAK,IAAI,IAAI,CAAC,YAAY;QAAE,OAAO,KAAK,CAAC;IAC9D,IAAI,CAAC,UAAU;QAAE,OAAO,IAAI,CAAC;IAC7B,OAAO,eAAe,CAAC,UAAU,CAAC,KAAK,eAAe,CAAC,YAAY,CAAC,CAAC;AACvE,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,uBAAuB,CAAC,MAKvC;IACC,MAAM,EAAE,UAAU,EAAE,UAAU,EAAE,IAAI,EAAE,eAAe,EAAE,GAAG,MAAM,CAAC;IACjE,MAAM,SAAS,GAAG,IAAI,GAAG,CAAC,UAAU,EAAE,MAAM,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC;IAC9D,yBAAyB,CAAC,SAAS,CAAC,CAAC;IACrC,sCAAsC,CAAC,SAAS,CAAC,CAAC;IAClD,0BAA0B,CACxB,SAAS,EACT,UAAU,EACV,IAAI,IAAI,mBAAmB,CAAC,MAAM,CAAC,CACpC,CAAC;IACF,mGAAmG;IACnG,uGAAuG;IACvG,SAAS,CAAC,YAAY,CAAC,GAAG,CAAC,UAAU,EAAE,GAAG,CAAC,CAAC;IAC5C,IAAI,eAAe,EAAE,CAAC;QACpB,SAAS,CAAC,YAAY,CAAC,GAAG,CAAC,kBAAkB,EAAE,eAAe,CAAC,CAAC;IAClE,CAAC;IACD,SAAS,CAAC,YAAY,CAAC,GAAG,CAAC,UAAU,EAAE,sBAAsB,CAAC,UAAU,CAAC,CAAC,CAAC;IAC3E,OAAO,SAAS,CAAC,QAAQ,EAAE,CAAC;AAC9B,CAAC;AAQD,KAAK,UAAU,sBAAsB,CACnC,MAAgC,EAChC,eAAuB;IAEvB,IAAI,CAAC,MAAM,EAAE,MAAM,EAAE,CAAC;QACpB,OAAO;YACL,KAAK,EACH,yFAAyF;SAC5F,CAAC;IACJ,CAAC;IAED,mGAAmG;IACnG,iGAAiG;IACjG,0CAA0C;IAC1C,MAAM,QAAQ,GAAG,MAAM,kBAAkB,CACvC,MAAM,CAAC,MAAM,EACb,MAAM,CAAC,QAAQ,IAAI,IAAI,EACvB,MAAM,CAAC,OAAO,IAAI,CAAC,CACpB,CAAC;IACF,IAAI,CAAC,QAAQ,EAAE,UAAU,EAAE,CAAC;QAC1B,OAAO;YACL,KAAK,EACH,oGAAoG;SACvG,CAAC;IACJ,CAAC;IAED,MAAM,IAAI,GAAG,QAAQ,CAAC,IAAI,EAAE,IAAI,IAAI,MAAM,CAAC,IAAI,CAAC;IAChD,MAAM,UAAU,GAAG,QAAQ,CAAC,QAAQ,CAAC;IACrC,OAAO;QACL,GAAG,EAAE,uBAAuB,CAAC;YAC3B,UAAU,EAAE,QAAQ,CAAC,UAAU;YAC/B,UAAU;YACV,IAAI;YACJ,eAAe;SAChB,CAAC;QACF,IAAI;QACJ,UAAU;KACX,CAAC;AACJ,CAAC;AAUD;;;GAGG;AACH,KAAK,UAAU,uBAAuB,CACpC,GAAW,EACX,eAAuB,EACvB,iBAAoC,EACpC,EAA+C;IAE/C,IAAI,CAAC,QAAQ,CAAC,IAAI,EAAE,CAAC;QACnB,MAAM,IAAI,KAAK,CAAC,+CAA+C,CAAC,CAAC;IACnE,CAAC;IAED,MAAM,MAAM,GAAG,yBAAyB,CACtC,iBAAiB,CAAC,KAAK,EACvB,iBAAiB,CAAC,MAAM,CACzB,CAAC;IAEF,IAAI,cAAkD,CAAC;IACvD,IAAI,SAA6C,CAAC;IAClD,IAAI,QAAQ,GAAmB;QAC7B,KAAK,EAAE,iBAAiB,CAAC,KAAK;QAC9B,MAAM,EAAE,iBAAiB,CAAC,MAAM;KACjC,CAAC;IACF,IAAI,UAAU,GAAG,KAAK,CAAC;IACvB,IAAI,YAAsC,CAAC;IAC3C,IAAI,YAAsC,CAAC;IAC3C,IAAI,WAAiD,CAAC;IAEtD,MAAM,MAAM,GAAG,IAAI,YAAY,CAAC;QAC9B,MAAM;QACN,YAAY,EAAE,MAAM,CAAC,QAAQ,CAAC,MAAM;QACpC,kBAAkB,EAAE,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC;QACrC,cAAc,EAAE,uBAAuB;QACvC,aAAa,EAAE,CAAC,KAAK,EAAE,EAAE;YACvB,IAAI,KAAK;gBAAE,YAAY,EAAE,EAAE,CAAC;QAC9B,CAAC;QACD,OAAO,EAAE,CAAC,KAAK,EAAE,EAAE;YACjB,WAAW,EAAE,CAAC,KAAK,CAAC,CAAC;QACvB,CAAC;QACD,OAAO,EAAE,CAAC,KAAkB,EAAE,EAAE;YAC9B,IAAI,KAAK,CAAC,IAAI,KAAK,OAAO,EAAE,CAAC;gBAC3B,MAAM,OAAO,GAAG,KAAK,CAAC,OAAwC,CAAC;gBAC/D,IAAI,OAAO,CAAC,QAAQ;oBAAE,QAAQ,GAAG,OAAO,CAAC,QAAQ,CAAC;YACpD,CAAC;iBAAM,IAAI,KAAK,CAAC,IAAI,KAAK,iBAAiB,EAAE,CAAC;gBAC5C,cAAc,GAAI,KAAK,CAAC,OAAgD;qBACrE,QAAQ,CAAC;YACd,CAAC;iBAAM,IAAI,KAAK,CAAC,IAAI,KAAK,YAAY,EAAE,CAAC;gBACvC,SAAS,GAAG,KAAK,CAAC,OAAiC,CAAC;gBACpD,IAAI,SAAS,CAAC,QAAQ;oBAAE,QAAQ,GAAG,SAAS,CAAC,QAAQ,CAAC;gBACtD,IAAI,CAAC,UAAU,EAAE,CAAC;oBAChB,UAAU,GAAG,IAAI,CAAC;oBAClB,YAAY,EAAE,EAAE,CAAC;gBACnB,CAAC;YACH,CAAC;QACH,CAAC;KACF,CAAC,CAAC;IAEH,MAAM,CAAC,GAAG,GAAG,GAAG,CAAC;IACjB,QAAQ,CAAC,IAAI,CAAC,WAAW,CAAC,MAAM,CAAC,CAAC;IAElC,IAAI,CAAC;QACH,MAAM,CAAC,OAAO,EAAE,CAAC;QAEjB,MAAM,IAAI,OAAO,CAAO,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE;YAC1C,YAAY,GAAG,OAAO,CAAC;YACvB,WAAW,GAAG,MAAM,CAAC;YACrB,IAAI,MAAM,CAAC,OAAO,EAAE;gBAAE,OAAO,EAAE,CAAC;QAClC,CAAC,CAAC,CAAC;QAEH,yFAAyF;QACzF,8DAA8D;QAC9D,MAAM,CAAC,WAAW,CAAC,MAAM,EAAE;YACzB,YAAY,EAAE,MAAM,CAAC,QAAQ,CAAC,MAAM;YACpC,SAAS,EAAE,eAAe;YAC1B,IAAI,EAAE,SAAS;YACf,oBAAoB,EAAE,EAAE;YACxB,OAAO,EAAE,MAAM,CAAC,cAAc,EAAE,CAAC,aAAa;YAC9C,wBAAwB,EAAE,MAAM,CAAC,2BAA2B,EAAE;SAC/D,CAAC,CAAC;QAEH,+FAA+F;QAC/F,IAAI,CAAC,UAAU,EAAE,CAAC;YAChB,MAAM,IAAI,OAAO,CAAO,CAAC,OAAO,EAAE,EAAE;gBAClC,IAAI,KAAK,GAAuB,MAAM,CAAC,UAAU,CAAC,GAAG,EAAE;oBACrD,KAAK,GAAG,SAAS,CAAC;oBAClB,OAAO,EAAE,CAAC;gBACZ,CAAC,EAAE,qBAAqB,CAAC,CAAC;gBAC1B,YAAY,GAAG,GAAG,EAAE;oBAClB,IAAI,KAAK,KAAK,SAAS,EAAE,CAAC;wBACxB,MAAM,CAAC,YAAY,CAAC,KAAK,CAAC,CAAC;wBAC3B,KAAK,GAAG,SAAS,CAAC;oBACpB,CAAC;oBACD,OAAO,EAAE,CAAC;gBACZ,CAAC,CAAC;YACJ,CAAC,CAAC,CAAC;QACL,CAAC;QAED,OAAO,MAAM,EAAE,CAAC;YACd,MAAM;YACN,MAAM;YACN,WAAW,EAAE,GAAG,EAAE,CAAC,cAAc;YACjC,MAAM,EAAE,GAAG,EAAE,CAAC,SAAS;YACvB,WAAW,EAAE,GAAG,EAAE,CAAC,QAAQ;SAC5B,CAAC,CAAC;IACL,CAAC;YAAS,CAAC;QACT,IAAI,CAAC;YACH,MAAM,CAAC,UAAU,EAAE,CAAC;QACtB,CAAC;QAAC,MAAM,CAAC;YACP,yBAAyB;QAC3B,CAAC;QACD,MAAM,CAAC,MAAM,EAAE,CAAC;IAClB,CAAC;AACH,CAAC;AAED,SAAS,UAAU,CAAC,GAAW;IAC7B,IAAI,CAAC;QACH,OAAO,IAAI,GAAG,CAAC,GAAG,EAAE,MAAM,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC,MAAM,CAAC;IACrD,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,MAAM,CAAC,QAAQ,CAAC,MAAM,CAAC;IAChC,CAAC;AACH,CAAC;AAED,KAAK,UAAU,oBAAoB,CACjC,KAA2B;IAE3B,MAAM,MAAM,GAAiC,MAAM,KAAK,CAAC,MAAM,CAAC,cAAc,CAC5E,YAAY,EACZ,EAAE,SAAS,EAAE,sBAAsB,CAAC,aAAa,CAAC,EAAE,EACpD,kBAAkB,EAClB,EAAE,SAAS,EAAE,MAAM,EAAE,CACtB,CAAC;IACF,IAAI,MAAM,CAAC,KAAK,EAAE,CAAC;QACjB,MAAM,IAAI,KAAK,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;IAChC,CAAC;IACD,MAAM,IAAI,GAAG,MAAM,CAAC,IAAI,IAAI,KAAK,CAAC,MAAM,EAAE,EAAE,IAAI,IAAI,EAAE,CAAC;IACvD,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,EAAE,CAAC;QACjB,MAAM,IAAI,KAAK,CAAC,kCAAkC,CAAC,CAAC;IACtD,CAAC;IACD,OAAO,IAAI,CAAC;AACd,CAAC;AAED;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,uBAAuB,CAC3C,MAAgC,EAChC,eAAuB,EACvB,QAA2B;IAE3B,MAAM,QAAQ,GAAG,MAAM,sBAAsB,CAAC,MAAM,EAAE,eAAe,CAAC,CAAC;IACvE,IAAI,OAAO,IAAI,QAAQ,EAAE,CAAC;QACxB,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,QAAQ,CAAC,KAAK,EAAE,CAAC;IAClE,CAAC;IAED,IAAI,CAAC;QACH,MAAM,IAAI,GAAG,MAAM,uBAAuB,CACxC,QAAQ,CAAC,GAAG,EACZ,eAAe,EACf,QAAQ,EACR,CAAC,KAAK,EAAE,EAAE,CAAC,oBAAoB,CAAC,KAAK,CAAC,CACvC,CAAC;QACF,OAAO;YACL,OAAO,EAAE,IAAI;YACb,KAAK,EAAE,MAAM;YACb,IAAI;YACJ,MAAM,EAAE,IAAI,CAAC,MAAM;YACnB,aAAa,EAAE,iBAAiB,CAAC,IAAI,CAAC;SACvC,CAAC;IACJ,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,OAAO;YACL,OAAO,EAAE,KAAK;YACd,KAAK,EAAE,MAAM;YACb,KAAK,EACH,KAAK,YAAY,KAAK;gBACpB,CAAC,CAAC,KAAK,CAAC,OAAO;gBACf,CAAC,CAAC,6DAA6D;SACpE,CAAC;IACJ,CAAC;AACH,CAAC;AAED,SAAS,kCAAkC,CACzC,KAA+C;IAE/C,mGAAmG;IACnG,kGAAkG;IAClG,QAAQ,KAAK,EAAE,CAAC;QACd,KAAK,WAAW,CAAC;QACjB,KAAK,iBAAiB,CAAC;QACvB,KAAK,MAAM;YACT,OAAO,KAAK,CAAC;QACf;YACE,OAAO,MAAM,CAAC;IAClB,CAAC;AACH,CAAC;AAED;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,8BAA8B,CAClD,MAAuC,EACvC,MAAgC,EAChC,eAAuB,EACvB,QAA2B;IAE3B,MAAM,KAAK,GAAG,kCAAkC,CAAC,MAAM,EAAE,KAAK,CAAC,CAAC;IAChE,MAAM,QAAQ,GAAG,MAAM,sBAAsB,CAAC,MAAM,EAAE,eAAe,CAAC,CAAC;IACvE,IAAI,OAAO,IAAI,QAAQ,EAAE,CAAC;QACxB,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,QAAQ,CAAC,KAAK,EAAE,CAAC;IAC1D,CAAC;IAED,IAAI,CAAC;QACH,MAAM,MAAM,GAAG,MAAM,uBAAuB,CAC1C,QAAQ,CAAC,GAAG,EACZ,eAAe,EACf,QAAQ,EACR,KAAK,EAAE,KAAK,EAAE,EAAE;YACd,MAAM,MAAM,GAAwB;gBAClC,WAAW,EAAE,IAAI;gBACjB,cAAc,EAAE,KAAK,CAAC,WAAW,EAAE;gBACnC,SAAS,EAAE,KAAK,CAAC,MAAM,EAAE;gBACzB,QAAQ,EAAE,KAAK,CAAC,WAAW,EAAE;gBAC7B,YAAY,EAAE,KAAK,CAAC,MAAM;gBAC1B,uBAAuB,EAAE,CAAC,OAAO,EAAE,EAAE,CACnC,KAAK,CAAC,MAAM,CAAC,cAAc,CAAC,YAAY,EAAE,OAAO,EAAE,kBAAkB,EAAE;oBACrE,SAAS,EAAE,MAAM;iBAClB,CAAC;aACL,CAAC;YACF,OAAO,iCAAiC,CACtC,MAAM,EACN,EAAE,GAAG,MAAM,EAAE,KAAK,EAAE,EACpB,EAAE,EACF,KAAK,CACN,CAAC;QACJ,CAAC,CACF,CAAC;QAEF,OAAO,CACL,MAAM,IAAI;YACR,OAAO,EAAE,KAAK;YACd,KAAK;YACL,KAAK,EAAE,kEAAkE;SAC1E,CACF,CAAC;IACJ,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,OAAO;YACL,OAAO,EAAE,KAAK;YACd,KAAK;YACL,KAAK,EACH,KAAK,YAAY,KAAK;gBACpB,CAAC,CAAC,KAAK,CAAC,OAAO;gBACf,CAAC,CAAC,oEAAoE;SAC3E,CAAC;IACJ,CAAC;AACH,CAAC"}

package/dist/editor/ai/inlineAiTextEditLabels.d.ts

@@ -0,0 +1,2 @@
+export declare const INLINE_AI_TEXT_EDIT_LABEL = "AI Text Edit";
+export declare function getInlineAiTextEditShortcutLabel(): string;

package/dist/editor/ai/inlineAiTextEditLabels.js

@@ -0,0 +1,8 @@
+export const INLINE_AI_TEXT_EDIT_LABEL = "AI Text Edit";
+export function getInlineAiTextEditShortcutLabel() {
+    if (typeof navigator === "undefined") {
+        return "Ctrl+.";
+    }
+    return /Mac|iPhone|iPad|iPod/i.test(navigator.userAgent) ? "⌘." : "Ctrl+.";
+}
+//# sourceMappingURL=inlineAiTextEditLabels.js.map

package/dist/editor/ai/inlineAiTextEditLabels.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"inlineAiTextEditLabels.js","sourceRoot":"","sources":["../../../src/editor/ai/inlineAiTextEditLabels.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,MAAM,yBAAyB,GAAG,cAAc,CAAC;AAExD,MAAM,UAAU,gCAAgC;IAC9C,IAAI,OAAO,SAAS,KAAK,WAAW,EAAE,CAAC;QACrC,OAAO,QAAQ,CAAC;IAClB,CAAC;IAED,OAAO,uBAAuB,CAAC,IAAI,CAAC,SAAS,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,QAAQ,CAAC;AAC7E,CAAC"}

package/dist/editor/ai/prepareInlineAiTextSelection.d.ts

@@ -0,0 +1,5 @@
+import { type EditContextType, type SelectionRange } from "../client/editContext";
+export type PreparedInlineAiSelection = {
+    selectionRange?: SelectionRange;
+};
+export declare function prepareInlineAiTextSelection(editContext: EditContextType | undefined): PreparedInlineAiSelection;

package/dist/editor/ai/prepareInlineAiTextSelection.js

@@ -0,0 +1,86 @@
+import { extractPlainTextContext } from "../utils/selectionContext";
+import { applyExpandedSelectionToContentEditable, applyExpandedSelectionToInput, } from "../utils/expandSelectionAtCaret";
+function findEditableContainer(activeEl) {
+    if (activeEl.getAttribute("contenteditable") === "true" ||
+        activeEl.classList.contains("slate-editable")) {
+        return activeEl;
+    }
+    return (activeEl.closest('[contenteditable="true"]') ??
+        activeEl.closest(".slate-editable"));
+}
+export function prepareInlineAiTextSelection(editContext) {
+    if (!editContext) {
+        return {};
+    }
+    const activeEl = document.activeElement;
+    if (!activeEl) {
+        return {};
+    }
+    const existingRange = editContext.selectedRange;
+    if (existingRange?.text?.trim()) {
+        return { selectionRange: existingRange };
+    }
+    const focusedField = editContext.focusedField;
+    if (!focusedField) {
+        return {};
+    }
+    if (activeEl instanceof HTMLInputElement ||
+        activeEl instanceof HTMLTextAreaElement) {
+        const bounds = applyExpandedSelectionToInput(activeEl);
+        if (!bounds?.text) {
+            return {};
+        }
+        const { contextBefore, contextAfter } = extractPlainTextContext(activeEl.value, bounds.start, bounds.end);
+        const selectionRange = {
+            itemId: focusedField.item.id,
+            fieldId: focusedField.fieldId,
+            language: focusedField.item.language,
+            version: focusedField.item.version,
+            startOffset: bounds.start,
+            endOffset: bounds.end,
+            text: bounds.text,
+            element: activeEl,
+            contextBefore,
+            contextAfter,
+        };
+        editContext.setSelectedRange(selectionRange);
+        return { selectionRange };
+    }
+    const editableContainer = findEditableContainer(activeEl);
+    if (!editableContainer) {
+        return {};
+    }
+    const bounds = applyExpandedSelectionToContentEditable(editableContainer);
+    if (!bounds?.text) {
+        return {};
+    }
+    const selection = window.getSelection();
+    const range = selection && selection.rangeCount > 0 ? selection.getRangeAt(0) : null;
+    const clientRect = range?.getBoundingClientRect();
+    const selectionRange = {
+        itemId: focusedField.item.id,
+        fieldId: focusedField.fieldId,
+        language: focusedField.item.language,
+        version: focusedField.item.version,
+        startOffset: bounds.start,
+        endOffset: bounds.end,
+        text: bounds.text,
+        contextBefore: undefined,
+        contextAfter: undefined,
+        clientRect: clientRect
+            ? {
+                x: clientRect.left,
+                y: clientRect.top,
+                width: clientRect.width,
+                height: clientRect.height,
+                top: clientRect.top,
+                right: clientRect.right,
+                bottom: clientRect.bottom,
+                left: clientRect.left,
+            }
+            : undefined,
+    };
+    editContext.setSelectedRange(selectionRange);
+    return { selectionRange };
+}
+//# sourceMappingURL=prepareInlineAiTextSelection.js.map

package/dist/editor/ai/prepareInlineAiTextSelection.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"prepareInlineAiTextSelection.js","sourceRoot":"","sources":["../../../src/editor/ai/prepareInlineAiTextSelection.ts"],"names":[],"mappings":"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"}

package/dist/editor/ai/terminal/agentContextMerge.d.ts

@@ -0,0 +1,14 @@
+import type { AgentEditorContextSnapshot, AgentMetadata } from "../../services/agentService";
+type ContextItem = NonNullable<AgentMetadata["items"]>[number];
+type ContextComponent = NonNullable<AgentMetadata["components"]>[number];
+export declare function getAgentContextItemKey(item: ContextItem | ContextComponent["pageItem"] | null | undefined): string | null;
+export declare function getAgentContextComponentKey(component: ContextComponent | null | undefined): string | null;
+/**
+ * Whether a built editor-context payload actually references something a user is
+ * viewing. `buildCurrentContext()` always returns an object (it can carry only
+ * workspace/page-loaded/sidebar flags), so gate UI and merges on real content.
+ */
+export declare function hasViewedContent(viewed: AgentMetadata | null | undefined): boolean;
+export declare function mergeViewedContext(storedContext: AgentMetadata | null | undefined, liveContext: AgentMetadata | null | undefined): AgentMetadata | null;
+export declare function toEditorContextSnapshot(context: AgentMetadata | null | undefined): AgentEditorContextSnapshot | undefined;
+export {};

package/dist/editor/ai/terminal/agentContextMerge.js

@@ -0,0 +1,111 @@
+export function getAgentContextItemKey(item) {
+    if (!item?.id)
+        return null;
+    return [
+        String(item.id).toLowerCase(),
+        String(item.language ?? "").toLowerCase(),
+        String(item.version ?? ""),
+    ].join("|");
+}
+export function getAgentContextComponentKey(component) {
+    if (!component?.componentId)
+        return null;
+    const pageKey = getAgentContextItemKey(component.pageItem);
+    return `${String(component.componentId).toLowerCase()}|${pageKey ?? ""}`;
+}
+function mergeByKey(preferred, fallback, getKey) {
+    const merged = [];
+    const seen = new Set();
+    for (const value of [...(preferred ?? []), ...(fallback ?? [])]) {
+        const key = getKey(value);
+        if (!key || seen.has(key))
+            continue;
+        seen.add(key);
+        merged.push(value);
+    }
+    return merged;
+}
+/**
+ * Whether a built editor-context payload actually references something a user is
+ * viewing. `buildCurrentContext()` always returns an object (it can carry only
+ * workspace/page-loaded/sidebar flags), so gate UI and merges on real content.
+ */
+export function hasViewedContent(viewed) {
+    return !!(viewed?.items?.length || viewed?.components?.length || viewed?.field);
+}
+export function mergeViewedContext(storedContext, liveContext) {
+    if (!storedContext && !liveContext) {
+        return null;
+    }
+    if (!liveContext) {
+        return storedContext ? { ...storedContext } : null;
+    }
+    const merged = {
+        ...(storedContext || {}),
+    };
+    const items = mergeByKey(liveContext.items, storedContext?.items, getAgentContextItemKey);
+    if (items.length > 0) {
+        merged.items = items;
+    }
+    else {
+        delete merged.items;
+    }
+    const components = mergeByKey(liveContext.components, storedContext?.components, getAgentContextComponentKey);
+    if (components.length > 0) {
+        merged.components = components;
+    }
+    else {
+        delete merged.components;
+    }
+    merged.currentItemId =
+        liveContext.currentItemId ?? storedContext?.currentItemId;
+    if (liveContext.field) {
+        merged.field = {
+            ...(storedContext?.field || {}),
+            ...liveContext.field,
+            fieldName: liveContext.field.fieldName ?? storedContext?.field?.fieldName,
+            fieldType: liveContext.field.fieldType ?? storedContext?.field?.fieldType,
+            item: liveContext.field.item ?? storedContext?.field?.item,
+        };
+    }
+    else if (!storedContext?.field) {
+        delete merged.field;
+    }
+    if (liveContext.activeWorkspace !== undefined) {
+        merged.activeWorkspace = liveContext.activeWorkspace;
+    }
+    if (liveContext.hasPageLoaded !== undefined) {
+        merged.hasPageLoaded = liveContext.hasPageLoaded;
+    }
+    if (liveContext.openSidebars !== undefined) {
+        merged.openSidebars = liveContext.openSidebars;
+    }
+    return merged;
+}
+export function toEditorContextSnapshot(context) {
+    if (!hasViewedContent(context)) {
+        return undefined;
+    }
+    const snapshot = {};
+    if (context?.selectedText !== undefined)
+        snapshot.selectedText = context.selectedText;
+    if (context?.items !== undefined)
+        snapshot.items = context.items;
+    if (context?.currentItemId !== undefined) {
+        snapshot.currentItemId = context.currentItemId;
+    }
+    if (context?.components !== undefined)
+        snapshot.components = context.components;
+    if (context?.field !== undefined)
+        snapshot.field = context.field;
+    if (context?.activeWorkspace !== undefined) {
+        snapshot.activeWorkspace = context.activeWorkspace;
+    }
+    if (context?.hasPageLoaded !== undefined) {
+        snapshot.hasPageLoaded = context.hasPageLoaded;
+    }
+    if (context?.openSidebars !== undefined)
+        snapshot.openSidebars = context.openSidebars;
+    return snapshot;
+}
+//# sourceMappingURL=agentContextMerge.js.map

package/dist/editor/ai/terminal/agentContextMerge.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"agentContextMerge.js","sourceRoot":"","sources":["../../../../src/editor/ai/terminal/agentContextMerge.ts"],"names":[],"mappings":"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"}

package/dist/editor/ai/terminal/agentOptimisticMessage.d.ts

@@ -0,0 +1 @@
+export declare function createTempAgentMessageId(): string;

package/dist/editor/ai/terminal/agentOptimisticMessage.js

@@ -0,0 +1,4 @@
+export function createTempAgentMessageId() {
+    return `temp-${Date.now()}-${Math.random().toString(36).slice(2, 9)}`;
+}
+//# sourceMappingURL=agentOptimisticMessage.js.map

package/dist/editor/ai/terminal/agentOptimisticMessage.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"agentOptimisticMessage.js","sourceRoot":"","sources":["../../../../src/editor/ai/terminal/agentOptimisticMessage.ts"],"names":[],"mappings":"AAAA,MAAM,UAAU,wBAAwB;IACtC,OAAO,QAAQ,IAAI,CAAC,GAAG,EAAE,IAAI,IAAI,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,CAAC;AACxE,CAAC"}

package/dist/editor/ai/terminal/agentPromptPlaceholders.d.ts

@@ -0,0 +1,5 @@
+export declare function hasPromptPlaceholders(prompt: string | null | undefined): boolean;
+export declare function isPromptInPlaceholderMode(input: {
+    prompt: string;
+    hasActivePlaceholderInput: boolean;
+}): boolean;

package/dist/editor/ai/terminal/agentPromptPlaceholders.js

@@ -0,0 +1,8 @@
+const PLACEHOLDER_PATTERN = /\{\{[^{}]+\}\}|<<[^<>]+>>/;
+export function hasPromptPlaceholders(prompt) {
+    return !!prompt && PLACEHOLDER_PATTERN.test(prompt);
+}
+export function isPromptInPlaceholderMode(input) {
+    return input.hasActivePlaceholderInput || hasPromptPlaceholders(input.prompt);
+}
+//# sourceMappingURL=agentPromptPlaceholders.js.map

package/dist/editor/ai/terminal/agentPromptPlaceholders.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"agentPromptPlaceholders.js","sourceRoot":"","sources":["../../../../src/editor/ai/terminal/agentPromptPlaceholders.ts"],"names":[],"mappings":"AAAA,MAAM,mBAAmB,GAAG,2BAA2B,CAAC;AAExD,MAAM,UAAU,qBAAqB,CACnC,MAAiC;IAEjC,OAAO,CAAC,CAAC,MAAM,IAAI,mBAAmB,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;AACtD,CAAC;AAED,MAAM,UAAU,yBAAyB,CAAC,KAGzC;IACC,OAAO,KAAK,CAAC,yBAAyB,IAAI,qBAAqB,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC;AAChF,CAAC"}