jamdesk 1.1.170 → 1.1.172

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "jamdesk",
-  "version": "1.1.170",
+  "version": "1.1.172",
   "description": "CLI for Jamdesk — build, preview, and deploy documentation sites from MDX. Dev server with hot reload, 50+ components, OpenAPI support, AI search, and Mintlify migration",
   "keywords": [
     "jamdesk",
@@ -96,7 +96,7 @@
     "publish:dry": "node scripts/publish.js npm --dry-run",
     "test": "vitest",
     "test:local": "node scripts/test-local.js",
-    "lint": "eslint src/",
+    "lint": "npm --prefix ../build-service exec -- eslint --config ../build-service/eslint.config.mjs src/",
     "dev": "tsc --watch",
     "postinstall": "node scripts/patch-openapi-schemas.js && node scripts/install-banner.js"
   },

package/templates/quickstart.mdx

@@ -73,7 +73,7 @@ Everything is configured in `docs.json`:
 | `name` | Site name shown in the header |
 | `colors` | Primary, light, and dark accent colors |
 | `logo` | Light and dark mode logo images |
-| `theme` | Visual theme (`jam`, `nebula`, or `pulsar`) |
+| `theme` | Visual theme (`jam`, `nebula`, `pulsar`, or `halo`) |
 | `navigation` | Sidebar tabs, groups, and page order |
 | `navbar` | Top navigation links and buttons |
 

package/vendored/components/AIActionsMenu.tsx

@@ -1,8 +1,10 @@
 'use client';
 
 import { useState, useEffect, useRef, useCallback, useMemo } from 'react';
+import { CursorIcon } from '@/components/mdx/ai-action-icons';
 import { useOnClickOutside } from '@/hooks/useOnClickOutside';
 import { usePathname } from 'next/navigation';
+import { AI_CHAT_URLS } from '@/lib/ai-service-urls';
 import { useLinkPrefix } from '@/lib/link-prefix-context';
 import { getIconClass } from '@/lib/icon-utils';
 import type { ContextualOption } from '@/lib/docs-types';
@@ -140,14 +142,6 @@ function GeminiIcon({ className }: { className?: string }) {
   );
 }
 
-function CursorIcon({ className }: { className?: string }) {
-  return (
-    <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24" fill="currentColor" className={className}>
-      <path d="M11.503.131 1.891 5.678a.84.84 0 0 0-.42.726v11.188c0 .3.162.575.42.724l9.609 5.55a1 1 0 0 0 .998 0l9.61-5.55a.84.84 0 0 0 .42-.724V6.404a.84.84 0 0 0-.42-.726L12.497.131a1.01 1.01 0 0 0-.996 0M2.657 6.338h18.55c.263 0 .43.287.297.515L12.23 22.918c-.062.107-.229.064-.229-.06V12.335a.59.59 0 0 0-.295-.51l-9.11-5.257c-.109-.063-.064-.23.061-.23" />
-    </svg>
-  );
-}
-
 function VSCodeIcon({ className }: { className?: string }) {
   return (
     <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 100 100" fill="currentColor" className={className}>
@@ -284,14 +278,6 @@ function buildMcpConfig(projectName: string, mcpUrl: string) {
   };
 }
 
-/** Base URLs for AI chat services that support prompt pre-filling. */
-const AI_CHAT_URLS: Record<string, string> = {
-  chatgpt: 'https://chatgpt.com/?hints=search&q=',
-  claude: 'https://claude.ai/new?q=',
-  gemini: 'https://gemini.google.com/app?q=',
-  perplexity: 'https://www.perplexity.ai/?q=',
-};
-
 /** Hook that resets a feedback state to 'idle' after 2 seconds. */
 function useFeedbackTimer(state: FeedbackState, setState: (s: FeedbackState) => void) {
   useEffect(() => {
@@ -469,7 +455,9 @@ export function AIActionsMenu({ options, projectName }: AIActionsMenuProps) {
       case 'claude':
       case 'gemini':
       case 'perplexity': {
-        const baseUrl = AI_CHAT_URLS[option];
+        const baseUrl = option === 'chatgpt'
+          ? AI_CHAT_URLS.chatgptSearch
+          : AI_CHAT_URLS[option];
         window.open(
           `${baseUrl}${encodeURIComponent(`Read this page and answer my questions about it: ${mdAbsoluteUrl}`)}`,
           '_blank', 'noopener,noreferrer'

package/vendored/components/mdx/Card.tsx

@@ -28,6 +28,7 @@ export const Card = memo(function Card({ title, icon, img, href, children, horiz
       className="group"
       style={{
         position: 'relative',
+        backgroundColor: 'var(--card-bg, transparent)',
         borderRadius: 'var(--radius-lg)',
         border: 'var(--border-width, 1px) solid var(--color-border)',
         overflow: 'hidden',

package/vendored/components/mdx/MDXComponents.tsx

@@ -19,6 +19,7 @@ import { ParamField } from './ParamField';
 import { ResponseField } from './ResponseField';
 import { RequestExample } from './RequestExample';
 import { ResponseExample } from './ResponseExample';
+import { Prompt } from './Prompt';
 import { ApiEndpoint, HttpMethodBadge } from './ApiEndpoint';
 import { ApiCodePanel, ApiPageLayout } from './ApiCodePanel';
 import { OpenApiEndpoint } from './OpenApiEndpoint';
@@ -198,6 +199,7 @@ export const MDXComponents = {
   ResponseField,
   RequestExample,
   ResponseExample,
+  Prompt,
   ApiEndpoint,
   HttpMethodBadge,
   ApiCodePanel,

package/vendored/components/mdx/Prompt.tsx

@@ -0,0 +1,381 @@
+'use client';
+
+import {
+  useCallback,
+  useEffect,
+  useId,
+  useMemo,
+  useRef,
+  useState,
+  type KeyboardEvent as ReactKeyboardEvent,
+  type ReactElement,
+  type ReactNode,
+} from 'react';
+
+import { useOnClickOutside } from '@/hooks/useOnClickOutside';
+import { renderInlineMarkdown } from '@/lib/inline-markdown';
+import { decodePromptSource } from '@/lib/prompt-source-codec';
+
+import { CursorIcon } from './ai-action-icons';
+import { Icon } from './Icon';
+import {
+  resolvePromptActions,
+  type PromptAction,
+  type ResolvedPromptAction,
+} from './prompt-actions';
+
+type IconType = 'regular' | 'solid' | 'light' | 'thin' | 'sharp-solid' | 'duotone' | 'brands';
+type CopyState = 'idle' | 'copied' | 'error';
+
+const EMPTY_ACTIONS: PromptAction[] = [];
+
+export interface PromptProps {
+  children?: ReactNode;
+  title?: string;
+  description?: string;
+  icon?: string | ReactElement;
+  iconType?: IconType;
+  actions?: PromptAction[];
+  singleLine?: boolean | string;
+  hidePrompt?: boolean | string;
+  className?: string;
+  /** UTF-8/base64, injected by injectPromptSources; not author-facing. */
+  __promptSource?: string;
+}
+
+function isImageIcon(icon: string): boolean {
+  return /^(?:https?:\/\/|\/|\.\/)/i.test(icon);
+}
+
+function resolveAuthorIcon(icon: string | ReactElement, iconType?: IconType): string | ReactElement {
+  if (typeof icon !== 'string' || !iconType || isImageIcon(icon) || icon.includes('/')) {
+    return icon;
+  }
+  return `${iconType}/${icon}`;
+}
+
+function ActionIcon({ action }: { action: ResolvedPromptAction['action'] }): ReactElement | null {
+  if (action === 'cursor') {
+    return <CursorIcon className="h-4 w-4 shrink-0" />;
+  }
+  if (action === 'claude') {
+    return <Icon icon="brain" size={16} className="shrink-0" />;
+  }
+  if (action === 'chatgpt') {
+    return <Icon icon="brands/openai" size={16} className="shrink-0" />;
+  }
+  if (typeof action !== 'string' && action.icon) {
+    return <Icon icon={action.icon} size={16} className="shrink-0" />;
+  }
+  return null;
+}
+
+export function Prompt({
+  children,
+  title,
+  description,
+  icon = 'sparkles',
+  iconType,
+  actions = EMPTY_ACTIONS,
+  singleLine = false,
+  hidePrompt = false,
+  className,
+  __promptSource = '',
+}: PromptProps): ReactElement {
+  const [copyState, setCopyState] = useState<CopyState>('idle');
+  const [menuOpen, setMenuOpen] = useState(false);
+  const timerRef = useRef<ReturnType<typeof setTimeout> | null>(null);
+  const copyAttemptRef = useRef(0);
+  const mountedRef = useRef(false);
+  const menuBoundaryRef = useRef<HTMLDivElement>(null);
+  const triggerRef = useRef<HTMLButtonElement>(null);
+  const itemRefs = useRef<Array<HTMLAnchorElement | null>>([]);
+  const generatedMenuId = useId();
+  const menuId = `prompt-actions-${generatedMenuId}`;
+
+  const prompt = useMemo(() => decodePromptSource(__promptSource), [__promptSource]);
+  const hasPrompt = prompt.length > 0;
+  const resolvedActions = useMemo(
+    () => hasPrompt ? resolvePromptActions(actions, prompt) : [],
+    [actions, hasPrompt, prompt],
+  );
+  const [primary, ...secondary] = resolvedActions;
+
+  const isSingleLine = singleLine === true || singleLine === 'true';
+  const hasTitle = Boolean(title?.trim());
+  const shouldHidePrompt = hasTitle && (hidePrompt === true || hidePrompt === 'true');
+  const authorIcon = resolveAuthorIcon(icon, iconType);
+
+  const closeMenu = useCallback(() => {
+    setMenuOpen(false);
+  }, []);
+
+  const closeMenuAndFocusTrigger = useCallback(() => {
+    setMenuOpen(false);
+    triggerRef.current?.focus();
+  }, []);
+
+  useOnClickOutside(menuBoundaryRef, closeMenu, menuOpen);
+
+  useEffect(() => {
+    mountedRef.current = true;
+    return () => {
+      mountedRef.current = false;
+      copyAttemptRef.current += 1;
+      if (timerRef.current) clearTimeout(timerRef.current);
+    };
+  }, []);
+
+  useEffect(() => {
+    if (menuOpen) itemRefs.current[0]?.focus();
+  }, [menuOpen]);
+
+  const copyPrompt = useCallback(async () => {
+    if (!hasPrompt) return;
+
+    const attempt = ++copyAttemptRef.current;
+    if (timerRef.current) {
+      clearTimeout(timerRef.current);
+      timerRef.current = null;
+    }
+
+    let nextState: Exclude<CopyState, 'idle'>;
+    try {
+      if (!navigator.clipboard?.writeText) {
+        throw new Error('Clipboard unavailable');
+      }
+      await navigator.clipboard.writeText(prompt);
+      nextState = 'copied';
+    } catch {
+      nextState = 'error';
+    }
+
+    if (!mountedRef.current || attempt !== copyAttemptRef.current) return;
+    setCopyState(nextState);
+    timerRef.current = setTimeout(() => {
+      if (mountedRef.current && attempt === copyAttemptRef.current) {
+        setCopyState('idle');
+      }
+    }, 2000);
+  }, [hasPrompt, prompt]);
+
+  const handleMenuKeyDown = useCallback((event: ReactKeyboardEvent<HTMLDivElement>) => {
+    if (event.key === 'Escape') {
+      event.preventDefault();
+      closeMenuAndFocusTrigger();
+      return;
+    }
+    if (
+      (event.key === ' ' || event.key === 'Spacebar') &&
+      event.target instanceof HTMLAnchorElement &&
+      event.target.getAttribute('role') === 'menuitem'
+    ) {
+      event.preventDefault();
+      event.target.click();
+      return;
+    }
+
+    const itemCount = secondary.length;
+    if (itemCount === 0) return;
+    if (event.key === 'Home' || event.key === 'End') {
+      event.preventDefault();
+      const targetIndex = event.key === 'Home' ? 0 : itemCount - 1;
+      itemRefs.current[targetIndex]?.focus();
+      return;
+    }
+    if (event.key !== 'ArrowDown' && event.key !== 'ArrowUp') return;
+
+    event.preventDefault();
+    const activeIndex = itemRefs.current.findIndex((item) => item === document.activeElement);
+    const direction = event.key === 'ArrowDown' ? 1 : -1;
+    const nextIndex = (Math.max(activeIndex, 0) + direction + itemCount) % itemCount;
+    itemRefs.current[nextIndex]?.focus();
+  }, [closeMenuAndFocusTrigger, secondary.length]);
+
+  const rootClassName = [
+    'not-prose my-4 min-w-0 max-w-full overflow-visible',
+    'rounded-[var(--radius-lg)] border border-[var(--color-border)]',
+    'bg-[var(--color-bg-secondary)] text-[var(--color-text-primary)]',
+    'shadow-[var(--shadow-sm)]',
+    className,
+  ].filter(Boolean).join(' ');
+
+  const actionClassName = [
+    'inline-flex min-w-0 max-w-full items-center gap-2 rounded-[var(--radius-lg)]',
+    'border border-[var(--color-border)] px-3 py-2 text-sm font-medium',
+    'text-[var(--color-text-primary)] transition-colors cursor-pointer',
+    'hover:border-[var(--color-primary)] hover:text-[var(--color-primary)]',
+    'focus-visible:outline-none focus-visible:ring-2 focus-visible:ring-[var(--color-primary)]',
+    'disabled:cursor-not-allowed disabled:opacity-50',
+  ].join(' ');
+
+  return (
+    <section data-testid="prompt-card" className={rootClassName}>
+      <div
+        data-testid={!hasTitle ? 'prompt-body-row' : undefined}
+        className={hasTitle
+          ? 'contents'
+          : 'flex min-w-0 max-w-full flex-wrap items-start gap-3 px-4 py-4'}
+      >
+        <div
+          data-testid={hasTitle ? 'prompt-header' : undefined}
+          className={hasTitle
+            ? 'flex min-w-0 max-w-full items-center gap-3 px-4 pt-4'
+            : 'contents'}
+        >
+          <span
+            data-testid="prompt-icon"
+            className="shrink-0 text-[var(--color-primary)]"
+            aria-hidden="true"
+          >
+            <Icon icon={authorIcon} size={18} />
+          </span>
+          {hasTitle ? (
+            <h3 className="m-0 min-w-0 max-w-full break-words [overflow-wrap:anywhere] text-base font-semibold text-[var(--color-text-primary)]">
+              {title}
+            </h3>
+          ) : null}
+        </div>
+
+        {!shouldHidePrompt ? (
+          <div
+            data-testid="prompt-preview"
+            className={`prompt-preview min-w-0 max-w-full text-sm leading-6 text-[var(--color-text-tertiary)]${hasTitle ? ' mx-4 mt-3' : ' flex-1'}${isSingleLine ? ' prompt-preview-single-line' : ''}`}
+          >
+            {description !== undefined ? renderInlineMarkdown(description) : children}
+          </div>
+        ) : null}
+
+        <div
+          data-testid="prompt-actions"
+          className={`flex min-w-0 max-w-full flex-wrap items-center gap-2${hasTitle ? ' px-4 pb-4 pt-3' : ' basis-full sm:ml-auto sm:basis-auto'}`}
+        >
+          <button
+            type="button"
+            aria-label="Copy prompt"
+            className={actionClassName}
+            data-copy-state={copyState}
+            disabled={!hasPrompt}
+            onClick={copyPrompt}
+          >
+            <i className="fa-regular fa-copy shrink-0" aria-hidden="true" />
+            <span>{copyState === 'copied' ? 'Copied' : copyState === 'error' ? 'Copy failed' : 'Copy'}</span>
+          </button>
+
+          <span role="status" aria-live="polite" className="sr-only">
+            {copyState === 'copied' ? 'Copied' : copyState === 'error' ? 'Copy failed' : ''}
+          </span>
+
+          {primary ? (
+            <a
+              href={primary.href}
+              target="_blank"
+              rel="noopener noreferrer"
+              className={actionClassName}
+              aria-label={primary.label}
+            >
+              <span aria-hidden="true"><ActionIcon action={primary.action} /></span>
+              <span className="min-w-0 truncate">{primary.label}</span>
+            </a>
+          ) : null}
+
+          {secondary.length > 0 ? (
+            <div
+              ref={menuBoundaryRef}
+              className="relative flex min-w-0 max-w-full basis-full w-full shrink-0 justify-end sm:ml-auto sm:basis-auto sm:w-auto sm:shrink"
+            >
+              <button
+                ref={triggerRef}
+                type="button"
+                aria-label="More prompt actions"
+                aria-haspopup="menu"
+                aria-expanded={menuOpen}
+                aria-controls={menuId}
+                className={actionClassName}
+                onMouseDown={(event) => {
+                  if (menuOpen) event.preventDefault();
+                }}
+                onClick={() => {
+                  setMenuOpen((open) => !open);
+                  if (menuOpen) triggerRef.current?.focus();
+                }}
+              >
+                <span>More</span>
+                <i className="fa-solid fa-chevron-down text-xs" aria-hidden="true" />
+              </button>
+
+              {menuOpen ? (
+                <div
+                  id={menuId}
+                  role="menu"
+                  aria-label="More prompt actions"
+                  className="absolute top-full right-0 z-20 mt-2 w-max max-w-[min(20rem,calc(100vw-2rem))] rounded-[var(--radius-lg)] border border-[var(--color-border)] bg-[var(--color-bg-secondary)] p-1 shadow-[var(--shadow-sm)]"
+                  onKeyDown={handleMenuKeyDown}
+                  onBlur={(event) => {
+                    if (!event.currentTarget.contains(event.relatedTarget)) {
+                      closeMenu();
+                    }
+                  }}
+                >
+                  {secondary.map((action, index) => (
+                    <a
+                      key={`${action.label}-${action.href}-${index}`}
+                      ref={(node) => { itemRefs.current[index] = node; }}
+                      role="menuitem"
+                      tabIndex={-1}
+                      href={action.href}
+                      target="_blank"
+                      rel="noopener noreferrer"
+                      aria-label={action.label}
+                      className="flex min-w-0 max-w-full cursor-pointer items-center gap-2 rounded-[var(--radius-lg)] px-3 py-2 text-sm text-[var(--color-text-primary)] hover:bg-[var(--color-border)] focus-visible:outline-none focus-visible:ring-2 focus-visible:ring-[var(--color-primary)]"
+                      onClick={closeMenuAndFocusTrigger}
+                    >
+                      <span aria-hidden="true"><ActionIcon action={action.action} /></span>
+                      <span className="min-w-0 truncate">{action.label}</span>
+                    </a>
+                  ))}
+                </div>
+              ) : null}
+            </div>
+          ) : null}
+        </div>
+      </div>
+
+      <style jsx>{`
+        .prompt-preview {
+          max-height: 7.5rem;
+          overflow-y: auto;
+          overflow-wrap: anywhere;
+        }
+        .prompt-preview :global(p) {
+          margin: 0 0 0.75rem;
+        }
+        .prompt-preview :global(p:last-child) {
+          margin-bottom: 0;
+        }
+        .prompt-preview :global(ul),
+        .prompt-preview :global(ol) {
+          margin: 0.5rem 0;
+          padding-left: 1.5rem;
+        }
+        .prompt-preview.prompt-preview-single-line {
+          max-height: 1.5rem;
+          overflow: hidden;
+          white-space: nowrap;
+          text-overflow: ellipsis;
+        }
+        .prompt-preview.prompt-preview-single-line > :global(*),
+        .prompt-preview.prompt-preview-single-line > :global(ul) > :global(li),
+        .prompt-preview.prompt-preview-single-line > :global(ol) > :global(li) {
+          max-width: 100%;
+          max-height: 1.5rem;
+          margin-top: 0;
+          margin-bottom: 0;
+          overflow: hidden;
+          white-space: nowrap;
+          text-overflow: ellipsis;
+        }
+      `}</style>
+    </section>
+  );
+}

package/vendored/components/mdx/ai-action-icons.tsx

@@ -0,0 +1,7 @@
+export function CursorIcon({ className }: { className?: string }) {
+  return (
+    <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24" fill="currentColor" className={className}>
+      <path d="M11.503.131 1.891 5.678a.84.84 0 0 0-.42.726v11.188c0 .3.162.575.42.724l9.609 5.55a1 1 0 0 0 .998 0l9.61-5.55a.84.84 0 0 0 .42-.724V6.404a.84.84 0 0 0-.42-.726L12.497.131a1.01 1.01 0 0 0-.996 0M2.657 6.338h18.55c.263 0 .43.287.297.515L12.23 22.918c-.062.107-.229.064-.229-.06V12.335a.59.59 0 0 0-.295-.51l-9.11-5.257c-.109-.063-.064-.23.061-.23" />
+    </svg>
+  );
+}

package/vendored/components/mdx/prompt-actions.ts

@@ -0,0 +1,137 @@
+import { AI_CHAT_URLS } from '@/lib/ai-service-urls';
+
+export type PromptBuiltinAction = 'copy' | 'cursor' | 'claude' | 'chatgpt';
+
+export interface PromptCustomAction {
+  label: string;
+  url: string;
+  icon?: string;
+}
+
+export type PromptAction = PromptBuiltinAction | PromptCustomAction;
+export type PromptOpenAction = Exclude<PromptAction, 'copy'>;
+
+export const MAX_PROMPT_ACTION_URL_LENGTH = 8_000;
+
+const BASES: Record<Exclude<PromptBuiltinAction, 'copy'>, string> = {
+  cursor: AI_CHAT_URLS.cursor,
+  claude: AI_CHAT_URLS.claude,
+  chatgpt: AI_CHAT_URLS.chatgpt,
+};
+
+export function normalizePromptActions(actions: unknown): PromptOpenAction[] {
+  try {
+    return normalizePromptActionsUnsafe(actions);
+  } catch {
+    // Array checks and iteration can themselves trap on hostile proxies.
+    return [];
+  }
+}
+
+function normalizePromptActionsUnsafe(actions: unknown): PromptOpenAction[] {
+  if (!Array.isArray(actions)) return [];
+
+  const seen = new Set<string>();
+  const normalized: PromptOpenAction[] = [];
+
+  for (const action of actions) {
+    if (action === 'copy') continue;
+
+    if (typeof action === 'string') {
+      if (!['cursor', 'claude', 'chatgpt'].includes(action) || seen.has(action)) continue;
+      seen.add(action);
+      normalized.push(action as Exclude<PromptBuiltinAction, 'copy'>);
+      continue;
+    }
+
+    if (typeof action !== 'object' || action === null) continue;
+
+    // MDX expressions are runtime input, so accept only own data properties
+    // on plain records and contain proxy/accessor traps per item.
+    try {
+      if (Array.isArray(action)) continue;
+      const prototype = Object.getPrototypeOf(action);
+      if (prototype !== Object.prototype && prototype !== null) continue;
+
+      const descriptors = Object.getOwnPropertyDescriptors(action);
+      const labelValue = descriptors.label?.value;
+      const urlValue = descriptors.url?.value;
+      const iconValue = descriptors.icon?.value;
+      if (typeof labelValue !== 'string' || typeof urlValue !== 'string') continue;
+      if (descriptors.icon && typeof iconValue !== 'string') continue;
+
+      const label = labelValue.trim();
+      const url = urlValue.trim();
+      if (!label || !url) continue;
+
+      const normalizedAction: PromptCustomAction = {
+        label,
+        url,
+        ...(iconValue === undefined ? {} : { icon: iconValue }),
+      };
+      const key = `${label}\u0000${url}`;
+      if (seen.has(key)) continue;
+      seen.add(key);
+      normalized.push(normalizedAction);
+    } catch {
+      continue;
+    }
+  }
+
+  return normalized;
+}
+
+export function buildPromptActionUrl(action: PromptOpenAction, prompt: string): string | null {
+  if (typeof action === 'string') {
+    const href = `${BASES[action]}${encodeURIComponent(prompt)}`;
+    return href.length <= MAX_PROMPT_ACTION_URL_LENGTH ? href : null;
+  }
+
+  try {
+    const placeholder = '__jamdesk_prompt__';
+    if (action.url.includes(placeholder)) return null;
+
+    const hasPlaceholder = action.url.includes('{prompt}');
+    const url = new URL(action.url.replaceAll('{prompt}', placeholder));
+    if (!['http:', 'https:'].includes(url.protocol) || url.username || url.password) return null;
+    if (url.origin.includes(placeholder)) return null;
+    if ([...url.searchParams.keys()].some((key) => key.includes(placeholder))) return null;
+
+    let href: string;
+    if (hasPlaceholder) {
+      href = url.toString().replaceAll(placeholder, encodeURIComponent(prompt));
+    } else {
+      url.searchParams.set('prompt', prompt);
+      href = url.toString();
+    }
+
+    return href.length <= MAX_PROMPT_ACTION_URL_LENGTH ? href : null;
+  } catch {
+    return null;
+  }
+}
+
+export interface ResolvedPromptAction {
+  action: PromptOpenAction;
+  href: string;
+  label: string;
+}
+
+const BUILTIN_META = {
+  cursor: { label: 'Open in Cursor' },
+  claude: { label: 'Open in Claude' },
+  chatgpt: { label: 'Open in ChatGPT' },
+} as const;
+
+export function resolvePromptActions(actions: unknown, prompt: string): ResolvedPromptAction[] {
+  return normalizePromptActions(actions).flatMap((action) => {
+    const href = buildPromptActionUrl(action, prompt);
+    if (!href) return [];
+
+    return [{
+      action,
+      href,
+      label: typeof action === 'string' ? BUILTIN_META[action].label : action.label,
+    }];
+  });
+}