@kortix/ui 0.14.11 → 0.14.13

package/dist/_vendor/shared/artifact-comments.d.ts

@@ -223,6 +223,333 @@ export declare const artifactCommentAnchorSchema: z.ZodEffects<z.ZodDiscriminate
     type: "none";
     version: string;
 }>;
+export declare const artifactCommentMarkSchema: z.ZodEffects<z.ZodDiscriminatedUnion<"tool", [z.ZodObject<{
+    points: z.ZodArray<z.ZodObject<{
+        x: z.ZodNumber;
+        y: z.ZodNumber;
+    }, "strict", z.ZodTypeAny, {
+        x: number;
+        y: number;
+    }, {
+        x: number;
+        y: number;
+    }>, "many">;
+    color: z.ZodEnum<["black", "red", "blue"]>;
+    width: z.ZodNumber;
+    tool: z.ZodLiteral<"pen">;
+}, "strict", z.ZodTypeAny, {
+    width: number;
+    tool: "pen";
+    points: {
+        x: number;
+        y: number;
+    }[];
+    color: "red" | "blue" | "black";
+}, {
+    width: number;
+    tool: "pen";
+    points: {
+        x: number;
+        y: number;
+    }[];
+    color: "red" | "blue" | "black";
+}>, z.ZodObject<{
+    points: z.ZodArray<z.ZodObject<{
+        x: z.ZodNumber;
+        y: z.ZodNumber;
+    }, "strict", z.ZodTypeAny, {
+        x: number;
+        y: number;
+    }, {
+        x: number;
+        y: number;
+    }>, "many">;
+    color: z.ZodEnum<["black", "red", "blue"]>;
+    width: z.ZodNumber;
+    tool: z.ZodLiteral<"arrow">;
+}, "strict", z.ZodTypeAny, {
+    width: number;
+    tool: "arrow";
+    points: {
+        x: number;
+        y: number;
+    }[];
+    color: "red" | "blue" | "black";
+}, {
+    width: number;
+    tool: "arrow";
+    points: {
+        x: number;
+        y: number;
+    }[];
+    color: "red" | "blue" | "black";
+}>, z.ZodObject<{
+    points: z.ZodArray<z.ZodObject<{
+        x: z.ZodNumber;
+        y: z.ZodNumber;
+    }, "strict", z.ZodTypeAny, {
+        x: number;
+        y: number;
+    }, {
+        x: number;
+        y: number;
+    }>, "many">;
+    color: z.ZodEnum<["black", "red", "blue"]>;
+    width: z.ZodNumber;
+    tool: z.ZodLiteral<"rectangle">;
+}, "strict", z.ZodTypeAny, {
+    width: number;
+    tool: "rectangle";
+    points: {
+        x: number;
+        y: number;
+    }[];
+    color: "red" | "blue" | "black";
+}, {
+    width: number;
+    tool: "rectangle";
+    points: {
+        x: number;
+        y: number;
+    }[];
+    color: "red" | "blue" | "black";
+}>]>, {
+    width: number;
+    tool: "pen";
+    points: {
+        x: number;
+        y: number;
+    }[];
+    color: "red" | "blue" | "black";
+} | {
+    width: number;
+    tool: "arrow";
+    points: {
+        x: number;
+        y: number;
+    }[];
+    color: "red" | "blue" | "black";
+} | {
+    width: number;
+    tool: "rectangle";
+    points: {
+        x: number;
+        y: number;
+    }[];
+    color: "red" | "blue" | "black";
+}, {
+    width: number;
+    tool: "pen";
+    points: {
+        x: number;
+        y: number;
+    }[];
+    color: "red" | "blue" | "black";
+} | {
+    width: number;
+    tool: "arrow";
+    points: {
+        x: number;
+        y: number;
+    }[];
+    color: "red" | "blue" | "black";
+} | {
+    width: number;
+    tool: "rectangle";
+    points: {
+        x: number;
+        y: number;
+    }[];
+    color: "red" | "blue" | "black";
+}>;
+export declare const artifactCommentMarksSchema: z.ZodEffects<z.ZodArray<z.ZodEffects<z.ZodDiscriminatedUnion<"tool", [z.ZodObject<{
+    points: z.ZodArray<z.ZodObject<{
+        x: z.ZodNumber;
+        y: z.ZodNumber;
+    }, "strict", z.ZodTypeAny, {
+        x: number;
+        y: number;
+    }, {
+        x: number;
+        y: number;
+    }>, "many">;
+    color: z.ZodEnum<["black", "red", "blue"]>;
+    width: z.ZodNumber;
+    tool: z.ZodLiteral<"pen">;
+}, "strict", z.ZodTypeAny, {
+    width: number;
+    tool: "pen";
+    points: {
+        x: number;
+        y: number;
+    }[];
+    color: "red" | "blue" | "black";
+}, {
+    width: number;
+    tool: "pen";
+    points: {
+        x: number;
+        y: number;
+    }[];
+    color: "red" | "blue" | "black";
+}>, z.ZodObject<{
+    points: z.ZodArray<z.ZodObject<{
+        x: z.ZodNumber;
+        y: z.ZodNumber;
+    }, "strict", z.ZodTypeAny, {
+        x: number;
+        y: number;
+    }, {
+        x: number;
+        y: number;
+    }>, "many">;
+    color: z.ZodEnum<["black", "red", "blue"]>;
+    width: z.ZodNumber;
+    tool: z.ZodLiteral<"arrow">;
+}, "strict", z.ZodTypeAny, {
+    width: number;
+    tool: "arrow";
+    points: {
+        x: number;
+        y: number;
+    }[];
+    color: "red" | "blue" | "black";
+}, {
+    width: number;
+    tool: "arrow";
+    points: {
+        x: number;
+        y: number;
+    }[];
+    color: "red" | "blue" | "black";
+}>, z.ZodObject<{
+    points: z.ZodArray<z.ZodObject<{
+        x: z.ZodNumber;
+        y: z.ZodNumber;
+    }, "strict", z.ZodTypeAny, {
+        x: number;
+        y: number;
+    }, {
+        x: number;
+        y: number;
+    }>, "many">;
+    color: z.ZodEnum<["black", "red", "blue"]>;
+    width: z.ZodNumber;
+    tool: z.ZodLiteral<"rectangle">;
+}, "strict", z.ZodTypeAny, {
+    width: number;
+    tool: "rectangle";
+    points: {
+        x: number;
+        y: number;
+    }[];
+    color: "red" | "blue" | "black";
+}, {
+    width: number;
+    tool: "rectangle";
+    points: {
+        x: number;
+        y: number;
+    }[];
+    color: "red" | "blue" | "black";
+}>]>, {
+    width: number;
+    tool: "pen";
+    points: {
+        x: number;
+        y: number;
+    }[];
+    color: "red" | "blue" | "black";
+} | {
+    width: number;
+    tool: "arrow";
+    points: {
+        x: number;
+        y: number;
+    }[];
+    color: "red" | "blue" | "black";
+} | {
+    width: number;
+    tool: "rectangle";
+    points: {
+        x: number;
+        y: number;
+    }[];
+    color: "red" | "blue" | "black";
+}, {
+    width: number;
+    tool: "pen";
+    points: {
+        x: number;
+        y: number;
+    }[];
+    color: "red" | "blue" | "black";
+} | {
+    width: number;
+    tool: "arrow";
+    points: {
+        x: number;
+        y: number;
+    }[];
+    color: "red" | "blue" | "black";
+} | {
+    width: number;
+    tool: "rectangle";
+    points: {
+        x: number;
+        y: number;
+    }[];
+    color: "red" | "blue" | "black";
+}>, "many">, ({
+    width: number;
+    tool: "pen";
+    points: {
+        x: number;
+        y: number;
+    }[];
+    color: "red" | "blue" | "black";
+} | {
+    width: number;
+    tool: "arrow";
+    points: {
+        x: number;
+        y: number;
+    }[];
+    color: "red" | "blue" | "black";
+} | {
+    width: number;
+    tool: "rectangle";
+    points: {
+        x: number;
+        y: number;
+    }[];
+    color: "red" | "blue" | "black";
+})[], ({
+    width: number;
+    tool: "pen";
+    points: {
+        x: number;
+        y: number;
+    }[];
+    color: "red" | "blue" | "black";
+} | {
+    width: number;
+    tool: "arrow";
+    points: {
+        x: number;
+        y: number;
+    }[];
+    color: "red" | "blue" | "black";
+} | {
+    width: number;
+    tool: "rectangle";
+    points: {
+        x: number;
+        y: number;
+    }[];
+    color: "red" | "blue" | "black";
+})[]>;
+export type ArtifactCommentMark = z.infer<typeof artifactCommentMarkSchema>;
 export type ArtifactCommentAnchor = z.infer<typeof artifactCommentAnchorSchema>;
 export type ArtifactTextAnchor = Extract<ArtifactCommentAnchor, {
     type: 'text';

package/dist/_vendor/shared/index.d.ts

@@ -10,7 +10,7 @@ export * from "./constants/upload-limits";
 export * from "./constants/auto-topup";
 export * from "./runtime-versions";
 export * from "./project-glyphs";
-export * from "./meta-agent";
+export * from "./my-kortix-agent";
 export * from "./utils/format-relative";
 export * from './prompt-attachments';
 export * from './markdown-math';
@@ -20,6 +20,7 @@ export * from './tag-blocks';
 export * from './trigger-event';
 export * from './reminder-prompt';
 export * from './room-prompt';
+export * from './peer-message-prompt';
 export * from './channel-header';
 export * from './channel-message';
 export * from './slack-text';
@@ -28,3 +29,4 @@ export * from './webhook-signing';
 export * from './pasted-content';
 export * from './space-slug';
 export * from './artifact-comments';
+export * from './artifact-annotations';

package/dist/_vendor/shared/my-kortix-agent.d.ts

@@ -0,0 +1,40 @@
+/** My Kortix, the platform's built-in agent: its slug. Session rows, token
+ *  grants, the sandbox slug, image names and the config-release variant key
+ *  on it. */
+export declare const MY_KORTIX_AGENT_NAME = "mykortix";
+/** The slug My Kortix had until 2026-10-30. Sessions, tokens and boxes made
+ *  before the rename still carry it, so every read accepts it
+ *  ({@link isMyKortixAgentName}); nothing new writes it. Drop it when no
+ *  session or box from before the rename is live. */
+export declare const LEGACY_MY_KORTIX_AGENT_NAME = "meta";
+export declare const MY_KORTIX_SANDBOX_SLUG = "mykortix";
+/** My Kortix — the built-in agent's DISPLAY name, the name every UI renders. */
+export declare const MY_KORTIX_DISPLAY_NAME = "My Kortix";
+/** True for My Kortix under its slug, or the legacy `meta` slug of an older session. */
+/**
+ * How a person reads a session's message handle: My Kortix's own session has
+ * the generated handle `mykortix-<short id>` (or the legacy `meta-…`), shown
+ * as "My Kortix"; a named agent shows as `@name`.
+ */
+export declare function peerHandleLabel(handle: string): string;
+export declare function isMyKortixAgentName(name: string | null | undefined): boolean;
+/** True for My Kortix's sandbox slug, or the legacy `meta` slug of an older box. */
+export declare function isMyKortixSandboxSlug(slug: string | null | undefined): boolean;
+/** The current slug for a name: `meta` becomes `mykortix`, any other name stays. */
+export declare function canonicalAgentName<T extends string | null | undefined>(name: T): T | typeof MY_KORTIX_AGENT_NAME;
+/**
+ * The built-in agents a project can turn on or off in `kortix.yaml`
+ * (`builtin_agents.<key>: true|false`, absent = on). Each key maps once to the
+ * agent slug the platform injects. Add a built-in here, nowhere else.
+ */
+export declare const BUILTIN_AGENTS: {
+    readonly my_kortix: {
+        readonly agent: "mykortix";
+        readonly displayName: "My Kortix";
+        readonly sandbox: "mykortix";
+    };
+};
+export type BuiltinAgentKey = keyof typeof BUILTIN_AGENTS;
+export declare const BUILTIN_AGENT_KEYS: BuiltinAgentKey[];
+/** The `builtin_agents` key of a built-in agent slug (legacy `meta` included), or `null` for a declared agent. */
+export declare function builtinAgentKeyOf(agentName: string | null | undefined): BuiltinAgentKey | null;

package/dist/_vendor/shared/peer-message-prompt.d.ts

@@ -0,0 +1,35 @@
+/**
+ * The text a cross-session message (`send_message`) delivers into the
+ * receiving session:
+ *
+ *   [message from reviewer · session 3f2a1b9c · #m_7Kq2]
+ *
+ *   <message text>
+ *
+ *   ---
+ *   <that it comes from another session, carries no authority, and how to answer>
+ *
+ * The API writes it (`peerMessagePromptText`); web and mobile read it back
+ * (`parsePeerMessagePrompt`) to render a one-line "Message from @reviewer"
+ * row, not a turn the person typed. One module owns both sides so they cannot
+ * drift, as `room-prompt.ts` does for rooms.
+ */
+export type PeerMessageKind = 'message' | 'shutdown_request' | 'shutdown_response' | 'idle_notice';
+export interface PeerMessagePromptInfo {
+    kind: PeerMessageKind;
+    /** The sender's handle, e.g. `reviewer`. */
+    from: string;
+    /** The sender's short session id (8 characters). */
+    fromShortId: string;
+    /** The message id, for a reply that threads. */
+    messageId: string;
+    /** The one-line preview, or null. */
+    summary: string | null;
+    /** The message text, without the header and the footer. */
+    text: string;
+}
+export declare function peerMessagePromptText(input: Omit<PeerMessagePromptInfo, 'text'> & {
+    text: string;
+}): string;
+/** The cross-session message a prompt carries, or undefined for any other text. Linear time. */
+export declare function parsePeerMessagePrompt(rawText: string | null | undefined): PeerMessagePromptInfo | undefined;

package/dist/_vendor/shared/pixel-mark.d.ts

@@ -0,0 +1,11 @@
+/**
+ * The Kortix symbol (`kortix-logo.tsx`, `variant="icon"`) sampled onto a
+ * 12 × 10 grid. `#` is a cell the symbol fully covers; `+` is a cell on a curve
+ * that it only partly covers, drawn as a checker so the curves read as dither.
+ *
+ * One copy for every pixel rendering of the symbol: the web `PixelKortixMark`
+ * (`@kortix/ui/pixel-kortix-mark`, empty states, merch chips, My Kortix's agent
+ * mark) and the TUI splash (`apps/tui/src/ui/splash.tsx`, half blocks). Rows
+ * are plain text, the same width, and symmetric on both axes.
+ */
+export declare const PIXEL_KORTIX_ROWS: readonly ["##   ##   ##", "##   ##   ##", "+#+  ##  +#+", " ##+ ## +## ", "  ########  ", "  ########  ", " ##+ ## +## ", "+#+  ##  +#+", "##   ##   ##", "##   ##   ##"];

package/dist/_vendor/shared/prompt-attachments.d.ts

@@ -1,4 +1,5 @@
 export declare const MAX_PROMPT_UPLOAD_FILENAME_BYTES: number;
+export declare const PROMPT_PARTS_MAX_BYTES: number;
 export declare const MAX_PROMPT_ATTACHMENT_BYTES: number;
 export declare const MAX_PROMPT_ATTACHMENTS_BYTES: number;
 export declare const MAX_PROMPT_ATTACHMENT_FILES = 20;

package/dist/_vendor/shared/reminder-prompt.d.ts

@@ -10,12 +10,18 @@
  * the person typed. One module owns both sides so they cannot drift.
  */
 export interface ReminderPromptInfo {
-    /** `reminder.<12 hex>`. */
+    /** `reminder.<12 hex>` (a loop) or `trigger.<12 hex>` (a runtime trigger). Rows made before the rename carry `automation.<12 hex>`. */
     id: string;
     recurring: boolean;
     /** The reminder text, without the header. */
     prompt: string;
 }
-export declare function reminderPromptText(input: ReminderPromptInfo): string;
+/**
+ * `source` names a non-schedule source that woke the session (`webhook`,
+ * `change request merged`, …). Absent: the schedule header, unchanged.
+ */
+export declare function reminderPromptText(input: ReminderPromptInfo & {
+    source?: string;
+}): string;
 /** The reminder a prompt carries, or undefined for any other text. Linear time. */
 export declare function parseReminderPrompt(rawText: string | null | undefined): ReminderPromptInfo | undefined;

package/dist/_vendor/shared/runtime-versions.d.ts

@@ -19,6 +19,10 @@ export type RuntimeVersions = {
     agentBrowser: string;
     playwright: string;
     anydoc: string;
+    /** The Claude Code program Claude subscription models run (`claude --version`). */
+    claudeCode: string;
+    /** The Claude Agent SDK release that ships that program (its `claudeCodeVersion`); kortixd pins the same SDK. */
+    claudeAgentSdk: string;
     /** tembo/voxl commit the sandbox desktop streamer is built from (apps/sandbox/voxl/release.sh). */
     voxl: string;
     voxlSha256Amd64: string;
@@ -49,6 +53,10 @@ export declare const OPENCODE_USER_AGENT: string;
 export declare const AGENT_BROWSER_VERSION: string;
 export declare const PLAYWRIGHT_VERSION: string;
 export declare const ANYDOC_VERSION: string;
+export declare const CLAUDE_CODE_VERSION: string;
+export declare const CLAUDE_AGENT_SDK_VERSION: string;
+/** Where every image installs the Claude Code program (kortixd's default `KORTIX_CLAUDE_PATH`). */
+export declare const CLAUDE_CODE_PATH = "/opt/kortix/claude/bin/claude";
 export declare const VOXL_VERSION: string;
 export declare const VOXL_SHA256_AMD64: string;
 export declare const VOXL_SHA256_ARM64: string;

package/dist/artifacts/artifact-frame.d.ts

@@ -11,6 +11,7 @@ export declare const ArtifactFrame: import("react").ForwardRefExoticComponent<{
     title: string;
     className?: string;
     preview?: boolean;
+    onFrame?: (frame: HTMLIFrameElement | null) => void;
 } & import("react").RefAttributes<HTMLDivElement>>;
 /** Create (and park) the pooled frame for an artifact page; a no-op when it exists. */
 export declare function ensureArtifactFrame(key: string, src: string, title: string): void;

package/dist/artifacts/artifact-frame.js

@@ -1,6 +1,6 @@
 'use client';
 import { jsx as _jsx } from "react/jsx-runtime";
-import { forwardRef, useLayoutEffect, useState } from 'react';
+import { forwardRef, useLayoutEffect, useRef, useState } from 'react';
 import { claimFrame, ensureFrame } from '../apps/app-preview-pool.js';
 import { ARTIFACT_FRAME_ALLOW, ARTIFACT_IFRAME_SANDBOX } from './frame-policy.js';
 /**
@@ -19,19 +19,32 @@ const PREVIEW_CANVAS = 'bg-background';
  * viewer without reloading. `frameKey` changes after a save, so an edit loads
  * the new page. The ref is the slot (the viewer's full screen target).
  */
-export const ArtifactFrame = forwardRef(function ArtifactFrame({ frameKey, src, title, className, preview }, ref) {
+export const ArtifactFrame = forwardRef(function ArtifactFrame({ frameKey, src, title, className, preview, onFrame }, ref) {
     const [slot, setSlot] = useState(null);
+    const latestOnFrame = useRef(onFrame);
+    useLayoutEffect(() => {
+        latestOnFrame.current = onFrame;
+    });
     const interactive = !preview;
     const frameClass = `${className ?? ''} ${preview ? PREVIEW_CANVAS : ARTIFACT_CANVAS}`;
     useLayoutEffect(() => {
         if (!slot)
             return;
         ensureArtifactFrame(frameKey, src, title);
-        const release = claimFrame(frameKey, slot, { className: frameClass, style: {}, interactive });
+        const release = claimFrame(frameKey, slot, {
+            className: frameClass,
+            style: {},
+            interactive,
+        });
         // The viewer hands the keyboard to the page, so a deck's arrow keys work at once.
+        const claimed = Array.from(slot.querySelectorAll('iframe')).find((candidate) => candidate.dataset.frameKey === frameKey) ?? null;
         if (interactive)
-            slot.querySelector('iframe')?.focus({ preventScroll: true });
-        return release;
+            claimed?.focus({ preventScroll: true });
+        latestOnFrame.current?.(claimed);
+        return () => {
+            latestOnFrame.current?.(null);
+            release();
+        };
         // The URL is read once per key: a refetch must not reload the page.
         // eslint-disable-next-line react-hooks/exhaustive-deps
     }, [frameKey, slot, interactive, frameClass]);

package/dist/artifacts/frame-policy.d.ts

@@ -12,7 +12,7 @@ export declare const ARTIFACT_FRAME_PREFIX = "artifact:";
 export declare function artifactFrameKey(artifact: {
     artifact_id: string;
     updated_at: string;
-}, version?: string | null): string;
+}, version?: string | null, annotate?: boolean): string;
 /**
  * Print a doc to PDF without leaving the page: its print view (`?print=1`)
  * loads in a hidden frame and opens the print dialog for that frame alone. The

package/dist/artifacts/frame-policy.js

@@ -9,8 +9,8 @@ export const ARTIFACT_FRAME_ALLOW = 'fullscreen; clipboard-write; autoplay; encr
 /** Artifact frames share the Apps frame pool (`@kortix/ui/apps`); their keys start with this. */
 export const ARTIFACT_FRAME_PREFIX = 'artifact:';
 /** One pooled frame per artifact state: a save (`updated_at`) or an old version gets its own. */
-export function artifactFrameKey(artifact, version) {
-    return `${ARTIFACT_FRAME_PREFIX}${artifact.artifact_id}:${version ?? artifact.updated_at}`;
+export function artifactFrameKey(artifact, version, annotate = false) {
+    return `${ARTIFACT_FRAME_PREFIX}${artifact.artifact_id}:${version ?? artifact.updated_at}${annotate ? ':annotate' : ''}`;
 }
 /**
  * Print a doc to PDF without leaving the page: its print view (`?print=1`)
@@ -22,13 +22,15 @@ export function printArtifact(viewUrl) {
     frame.setAttribute('sandbox', ARTIFACT_IFRAME_SANDBOX);
     frame.setAttribute('aria-hidden', 'true');
     frame.tabIndex = -1;
-    frame.style.cssText = 'position:fixed;right:0;bottom:0;width:1px;height:1px;border:0;opacity:0;pointer-events:none';
+    frame.style.cssText =
+        'position:fixed;right:0;bottom:0;width:1px;height:1px;border:0;opacity:0;pointer-events:none';
     const cleanup = () => {
         window.removeEventListener('message', onMessage);
         frame.remove();
     };
     const onMessage = (event) => {
-        if (event.source === frame.contentWindow && event.data?.kortix === 'artifact-printed')
+        if (event.source === frame.contentWindow &&
+            event.data?.kortix === 'artifact-printed')
             cleanup();
     };
     window.addEventListener('message', onMessage);
@@ -55,7 +57,10 @@ export function parseArtifactUrl(url) {
     }
     const inProject = IN_PROJECT.exec(path);
     if (inProject)
-        return { projectId: inProject[1].toLowerCase(), artifactId: inProject[2].toLowerCase() };
+        return {
+            projectId: inProject[1].toLowerCase(),
+            artifactId: inProject[2].toLowerCase(),
+        };
     const shared = PUBLIC.exec(path);
     return shared ? { projectId: null, artifactId: shared[1].toLowerCase() } : null;
 }

package/dist/browser/browser-panel.d.ts

@@ -2,6 +2,7 @@ interface PreviewTabContentProps {
     tabId: string;
     projectId?: string;
     projectSessionId?: string;
+    targetUrl?: string;
 }
 /**
  * Preview tab content — renders a proxied sandbox URL in an iframe
@@ -11,5 +12,5 @@ interface PreviewTabContentProps {
  * any localhost:PORT address to navigate within the sandbox. Visited URLs are
  * recorded and offered back as "Recents" on the empty landing state.
  */
-export declare function BrowserPanel({ tabId, projectId, projectSessionId }: PreviewTabContentProps): import("react").JSX.Element;
+export declare function BrowserPanel({ tabId, projectId, projectSessionId, targetUrl }: PreviewTabContentProps): import("react").JSX.Element;
 export {};

package/dist/browser/browser-panel.js

@@ -43,7 +43,7 @@ const subscribeNoop = () => () => { };
  * any localhost:PORT address to navigate within the sandbox. Visited URLs are
  * recorded and offered back as "Recents" on the empty landing state.
  */
-export function BrowserPanel({ tabId, projectId, projectSessionId }) {
+export function BrowserPanel({ tabId, projectId, projectSessionId, targetUrl }) {
     const tHardcodedUi = useTranslations('hardcodedUi');
     const tI18nComplete = useTranslations('hardcodedUi.i18nComplete');
     const appPreviewTitle = tI18nComplete.raw('text6026c1d8c92e');
@@ -69,7 +69,7 @@ export function BrowserPanel({ tabId, projectId, projectSessionId }) {
     // reveal scroll shoves a permanent sideways offset onto the panel's
     // overflow-hidden ancestors. Mount-only on purpose (`autoFocus` semantics —
     // a later navigation clearing the URL must not steal the cursor).
-    const autoFocusAddressRef = useRef(!rawPreviewUrl);
+    const autoFocusAddressRef = useRef(!rawPreviewUrl && !targetUrl);
     useEffect(() => {
         if (autoFocusAddressRef.current)
             focusWithoutScroll(addressInputRef.current);
@@ -200,6 +200,16 @@ export function BrowserPanel({ tabId, projectId, projectSessionId }) {
         pushHistory(newProxyUrl);
         handleRefresh();
     }, [subdomainOpts, rewritePortPath, tabId, appPreviewTitle, updateTabMetadata, pushHistory, handleRefresh]);
+    const appliedTarget = useRef(null);
+    useEffect(() => {
+        if (!targetUrl || (appliedTarget.current?.tabId === tabId && appliedTarget.current.url === targetUrl))
+            return;
+        appliedTarget.current = { tabId, url: targetUrl };
+        // An external quick-view intent synchronizes the Browser tab and its navigation history.
+        // eslint-disable-next-line react-hooks/set-state-in-effect
+        if (targetUrl !== rawPreviewUrl && targetUrl !== originalUrl)
+            navigateTo(targetUrl);
+    }, [tabId, targetUrl, rawPreviewUrl, originalUrl, navigateTo]);
     const canGoBack = historyIndex > 0;
     const canGoForward = historyIndex < history.length - 1;
     /** Walk the history stack in either direction; the two directions were two

package/dist/customize/agents/agent-access-text.d.ts

@@ -0,0 +1,16 @@
+import type { AgentCapabilityGrant, ProjectConfigSummary } from '@kortix/sdk';
+/**
+ * The one way Customize names a grant, on every surface (the Access switcher,
+ * the Overview rows, the Agents index, My Kortix): "All", "None", "N of M"
+ * when the catalog size is known, else "N".
+ */
+export declare function useGrantLabel(): (value: AgentCapabilityGrant | number | undefined, total?: number) => string;
+/**
+ * What an agent's configuration grants (KRTX-3025), in the agent page's words
+ * and glyphs: connectors, secrets and Kortix permissions, each All, None or a
+ * count. Every part shows, in the same order, so rows line up in a list. The
+ * glyph is the Overview row's glyph; its name is the accessible label.
+ */
+export declare function AgentAccessText({ agent }: {
+    agent: ProjectConfigSummary['agents'][number];
+}): import("react").JSX.Element | null;