@cueframe/kernel 0.0.1 → 0.1.0

package/dist/_members/cloud-import/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/ImportProvider.tsx","../src/CloudImportService.ts","../src/MediaItemPreprocessor.ts","../src/cloudConfig.ts","../src/index.ts"],"sourcesContent":["/**\n * ImportProvider — single mount at app root.\n *\n * Initializes the CloudImportService, wires auth callbacks, and provides\n * the useImport() hook to child components. Wraps children in Uppy's\n * UppyContextProvider so headless hooks (useDropzone, useUppyState, etc.)\n * work anywhere in the tree.\n *\n * The import dialog UI is injected via `dialogSlot` to avoid circular\n * dependency between @cueframe/cloud-import and @cueframe/pro.\n */\nimport { createContext, useContext, useState, useEffect, useCallback, useRef, type ReactNode } from 'react';\nimport { UppyContextProvider } from '@uppy/react';\nimport type Uppy from '@uppy/core';\nimport { cloudImportService } from './CloudImportService';\nimport type { CloudUploadResult } from './CloudImportService';\n\ninterface ImportContextValue {\n  openModal: () => void;\n  closeModal: () => void;\n  isOpen: boolean;\n  uppy: Uppy;\n  /**\n   * Can this lane actually take an upload right now?\n   *\n   * A cloud import needs an identity: `getUploadMeta` mints an org-scoped\n   * upload token, so with none the modal opens onto a request that can only\n   * fail. This is DATA because the provider is now a fixture of the tree — it\n   * mounts for the life of the desktop process, signed in or not, so its\n   * PRESENCE stopped being the answer to this question (it was, back when the\n   * whole cloud stack mounted only inside a confirmed auth handshake).\n   */\n  available: boolean;\n}\n\nconst ImportContext = createContext<ImportContextValue | null>(null);\n\nexport interface ImportProviderProps {\n  children: ReactNode;\n  /** Whether this lane can take an upload — see `ImportContextValue.available`.\n   *  Required, with no default: the one thing a caller must not forget is the\n   *  fact that decides whether a control is offered at all. */\n  available: boolean;\n  /** React element to render the import dialog (e.g. <ImportDialog />) */\n  dialogSlot?: ReactNode;\n  uploadSigningUrl: string;\n  /** Called before opening the modal — returns upload metadata (token, userId, etc). */\n  getUploadMeta?: () => Promise<Record<string, string>>;\n  /** Pre-create a mediaItem — called by the preprocessor plugin before upload starts. */\n  createMediaItem?: (file: { name: string; size: number; mimeType: string }) => Promise<string>;\n  onUploadComplete?: (results: CloudUploadResult[]) => void;\n  onError?: (error: Error) => void;\n}\n\nexport function ImportProvider({\n  children,\n  available,\n  dialogSlot,\n  uploadSigningUrl,\n  getUploadMeta,\n  createMediaItem,\n  onUploadComplete,\n  onError,\n}: ImportProviderProps) {\n  const [isOpen, setIsOpen] = useState(false);\n\n  // Stable refs for callbacks — avoids re-subscribing Uppy events\n  const onCompleteRef = useRef(onUploadComplete);\n  const onErrorRef = useRef(onError);\n  onCompleteRef.current = onUploadComplete;\n  onErrorRef.current = onError;\n\n  // Initialize service once\n  const [uppy] = useState(() => cloudImportService.init({ uploadSigningUrl }));\n\n  useEffect(() => {\n    const handleComplete = (result: { successful?: any[] }) => {\n      const successful = result?.successful ?? [];\n      if (successful.length > 0 && onCompleteRef.current) {\n        onCompleteRef.current(\n          successful.map((file: any) => ({\n            uploadURL: file.response?.uploadURL ?? '',\n            fileName: file.name ?? 'unknown',\n            fileSize: file.size ?? 0,\n          })),\n        );\n      }\n    };\n\n    const handleError = (error: unknown) => {\n      onErrorRef.current?.(error instanceof Error ? error : new Error(String(error)));\n    };\n\n    uppy.on('complete', handleComplete);\n    uppy.on('error', handleError);\n\n    return () => {\n      uppy.off('complete', handleComplete);\n      uppy.off('error', handleError);\n    };\n  }, [uppy]);\n\n  // Sync createMediaItem into the preprocessor plugin\n  useEffect(() => {\n    try {\n      const preprocessor = cloudImportService.getPreprocessor();\n      preprocessor.setCreateFn(createMediaItem ?? null);\n    } catch {\n      // Service not initialized yet — will be set on next render\n    }\n  }, [createMediaItem]);\n\n  const openModal = useCallback(async () => {\n    if (getUploadMeta) {\n      try {\n        const meta = await getUploadMeta();\n        cloudImportService.setMeta(meta);\n      } catch (err) {\n        console.error('[Import] Failed to get upload metadata:', err);\n        return;\n      }\n    }\n    setIsOpen(true);\n  }, [getUploadMeta]);\n\n  const closeModal = useCallback(() => {\n    setIsOpen(false);\n  }, []);\n\n  return (\n    <ImportContext value={{ openModal, closeModal, isOpen, uppy, available }}>\n      <UppyContextProvider uppy={uppy}>\n        {children}\n        {dialogSlot}\n      </UppyContextProvider>\n    </ImportContext>\n  );\n}\n\n/** Hook to access the import modal and Uppy instance. Must be used inside <ImportProvider>. */\nexport function useImport(): ImportContextValue {\n  const ctx = useContext(ImportContext);\n  if (!ctx) throw new Error('useImport must be used within <ImportProvider>');\n  return ctx;\n}\n\n/**\n * The context WHEN THE LANE CAN BE USED, and `null` otherwise — for surfaces\n * that offer the cloud modal only where it works and fall back where it does\n * not (the pro ImportButton, which drops to the local file picker).\n *\n * It used to answer presence alone, and presence used to be the same fact:\n * the provider mounted only inside a confirmed auth handshake. It mounts for\n * the life of the desktop process now (Task 11 — a provider that appears and\n * disappears re-parents the app), so presence would offer a cloud modal to a\n * signed-out user whose upload-token request can only fail: a control that\n * looks alive and silently does nothing.\n *\n * Still ONE fact, read from the tree rather than mirrored: the alternative —\n * a caller re-deriving `isDesktop && cloudEnabled && signedIn` — is the drift\n * class that crashed the desktop (\"useImport must be used within\n * <ImportProvider>\") whenever the two copies disagreed.\n */\nexport function useImportIfAvailable(): ImportContextValue | null {\n  const ctx = useContext(ImportContext);\n  return ctx?.available ? ctx : null;\n}\n","/**\n * Singleton Uppy service for imports (local + cloud).\n *\n * Uses @uppy/aws-s3 for multipart uploads directly to R2 via the\n * upload-signing CF Worker. Replaces the old TUS-based upload path.\n *\n * Owns the Uppy instance lifecycle (headless — no Dashboard plugin).\n * React integration is handled by ImportProvider (single mount at app root).\n * MediaItem pre-creation is handled by MediaItemPreprocessor (Uppy plugin).\n */\nimport Uppy from '@uppy/core';\nimport AwsS3 from '@uppy/aws-s3';\nimport { MediaItemPreprocessor } from './MediaItemPreprocessor';\ninterface CloudImportConfig {\n  uploadSigningUrl: string;\n}\n\nexport interface CloudUploadResult {\n  uploadURL: string;\n  fileName: string;\n  fileSize: number;\n}\n\nclass CloudImportService {\n  private uppy: Uppy | null = null;\n  private config: CloudImportConfig | null = null;\n\n  /** Lazy-init: create Uppy + plugins on first use. */\n  init(config: CloudImportConfig): Uppy {\n    if (this.uppy) return this.uppy;\n\n    this.config = config;\n\n    const signingUrl = this.config.uploadSigningUrl.replace(/\\/$/, '');\n\n    // @ts-expect-error — Uppy v5 Body generic makes restrictions type collapse to never\n    this.uppy = new Uppy({\n      id: 'cloud-import',\n      restrictions: {\n        allowedFileTypes: ['video/*', 'audio/*'],\n      },\n    })\n      .use(AwsS3, {\n        // Upload-signing Worker implements the S3 multipart endpoints at /s3/multipart/*\n        endpoint: signingUrl,\n        shouldUseMultipart: true,\n        // Cap concurrent multipart part uploads. Unbounded concurrency\n        // saturates the browser network stack and the signing Worker on\n        // large files; 3 keeps throughput high without melting either.\n        limit: 3,\n        // Exponential-ish backoff for failed part/signing requests. Uppy\n        // retries the same operation on each delay — keeps transient\n        // network blips from failing an entire upload.\n        retryDelays: [1000, 3000, 5000, 10000],\n      })\n      .use(MediaItemPreprocessor as any);\n\n    return this.uppy;\n  }\n\n  /** Get the Uppy instance (must call init() first). */\n  getUppy(): Uppy {\n    if (!this.uppy) throw new Error('CloudImportService not initialized — call init() first');\n    return this.uppy;\n  }\n\n  /** Get the MediaItemPreprocessor plugin. */\n  getPreprocessor(): MediaItemPreprocessor {\n    return this.getUppy().getPlugin(MediaItemPreprocessor.pluginId) as unknown as MediaItemPreprocessor;\n  }\n\n  /** Update upload metadata (uploadToken, userId, projectId). */\n  setMeta(meta: Record<string, string>): void {\n    this.uppy?.setMeta(meta);\n\n    // Update AwsS3 plugin headers with the auth token.\n    // headers must be a static Record — functions are not supported in @uppy/aws-s3 v5.\n    if (meta.uploadToken) {\n      const plugin = this.uppy?.getPlugin('AwsS3Multipart');\n      if (plugin) {\n        plugin.setOptions({ headers: { 'uppy-auth-token': meta.uploadToken } });\n      }\n    }\n  }\n}\n\n/** Module-level singleton. */\nexport const cloudImportService = new CloudImportService();\n","/**\n * Uppy preprocessor plugin that pre-creates a mediaItem in the backend\n * before the upload starts. This guarantees convexMediaItemId is in the\n * upload metadata before the first byte goes out — no race condition.\n *\n * The actual creation function is injected via setCreateFn() so the plugin\n * stays decoupled from Convex/auth concerns.\n */\nimport { BasePlugin } from '@uppy/core';\nimport type { Uppy, Meta } from '@uppy/core';\n\ntype CreateMediaItemFn = (file: {\n  name: string;\n  size: number;\n  mimeType: string;\n}) => Promise<string>;\n\nexport class MediaItemPreprocessor extends BasePlugin<Record<string, never>, Meta, Record<string, never>> {\n  static pluginId = 'MediaItemPreprocessor';\n\n  private createFn: CreateMediaItemFn | null = null;\n  private preprocessBound: (fileIDs: string[], uploadID: string) => Promise<void>;\n\n  constructor(uppy: Uppy, opts?: Record<string, never>) {\n    super(uppy, opts ?? {});\n    this.id = MediaItemPreprocessor.pluginId;\n    this.type = 'preprocessor';\n    this.preprocessBound = this.preprocess.bind(this);\n  }\n\n  /** Inject the creation function (called from ImportProvider). */\n  setCreateFn(fn: CreateMediaItemFn | null): void {\n    this.createFn = fn;\n  }\n\n  install(): void {\n    this.uppy.addPreProcessor(this.preprocessBound);\n  }\n\n  uninstall(): void {\n    this.uppy.removePreProcessor(this.preprocessBound);\n  }\n\n  private async preprocess(fileIDs: string[]): Promise<void> {\n    if (!this.createFn) return;\n\n    for (const fileID of fileIDs) {\n      const file = this.uppy.getFile(fileID);\n      if (!file) continue;\n\n      // Skip if already has a mediaItemId (e.g. retry)\n      if ((file.meta as Record<string, unknown>).convexMediaItemId) continue;\n\n      this.uppy.emit('preprocess-progress', file, {\n        mode: 'indeterminate' as const,\n        message: 'Preparing upload…',\n      });\n\n      try {\n        const mediaItemId = await this.createFn({\n          name: file.name ?? 'unknown',\n          size: file.size ?? 0,\n          mimeType: file.type ?? 'video/mp4',\n        });\n        this.uppy.setFileMeta(fileID, { convexMediaItemId: mediaItemId });\n      } catch (err) {\n        this.uppy.log(`[MediaItemPreprocessor] Failed for ${fileID}: ${err}`, 'error');\n      }\n\n      this.uppy.emit('preprocess-complete', file);\n    }\n  }\n}\n","/**\n * Single source of truth for cloud endpoint resolution.\n *\n * One input (convexUrl) → deterministic output (all cloud endpoints).\n * No fallback chains, no env var reading, no defaults.\n */\n\nexport type CloudEnvironment = 'dev' | 'staging' | 'production';\n\nexport interface CloudEndpoints {\n  convexUrl: string;\n  uploadSigningUrl: string;\n}\n\nexport const ENVIRONMENTS: Record<CloudEnvironment, CloudEndpoints> = {\n  dev: {\n    convexUrl: 'https://api-dev.cueframe.ai',\n    uploadSigningUrl: 'http://localhost:8787',\n  },\n  staging: {\n    convexUrl: 'https://api-dev.cueframe.ai',\n    uploadSigningUrl: 'https://upload-signing.cueframelabs.workers.dev',\n  },\n  production: {\n    convexUrl: 'https://api.cueframe.ai',\n    uploadSigningUrl: 'https://upload.cueframe.ai',\n  },\n};\n\n/** Detect environment from a Convex deployment URL.\n *\n * Convex exposes two domains per deployment: queries (`data*`) and HTTP\n * actions (`api*`). Callers pass either form depending on which client\n * they own, so detection has to recognize both:\n *   prod    → api.cueframe.ai     | data.cueframe.ai\n *   staging → api-dev.cueframe.ai | data-dev.cueframe.ai\n */\nexport function detectEnvironment(convexUrl?: string): CloudEnvironment {\n  if (!convexUrl) return 'dev';\n  // staging first — its hostnames are substrings of prod's, so checking\n  // prod first would mis-classify (e.g. data-dev.cueframe.ai contains\n  // data.cueframe.ai).\n  if (/\\b(api-dev|data-dev)\\.cueframe\\.ai/.test(convexUrl)) return 'staging';\n  if (/\\b(api|data)\\.cueframe\\.ai/.test(convexUrl)) return 'production';\n  // RAW deployment hostnames — env files frequently carry the\n  // *.convex.cloud/site form instead of the custom domains, and falling\n  // through to 'dev' silently pointed real deployments at the localhost\n  // signing worker (found by the desktop-lane staging test: enhance uploads\n  // died on http://localhost:8787 while Convex itself was on staging).\n  if (/\\boceanic-dogfish-357\\.convex\\.(cloud|site)/.test(convexUrl)) return 'staging';\n  if (/\\bpolished-hawk-150\\.convex\\.(cloud|site)/.test(convexUrl)) return 'production';\n  return 'dev';\n}\n\n/** Resolve all cloud endpoints from a Convex URL. */\nexport function getEndpoints(convexUrl: string): CloudEndpoints {\n  const env = detectEnvironment(convexUrl);\n  return ENVIRONMENTS[env];\n}\n\n// NO `getEnvironmentEndpoints` AND NO `ENV_STORAGE_KEY`.\n//\n// They served a desktop Settings control that let a user pick dev / staging /\n// production at runtime. Nothing downstream could honour it: the Convex socket\n// is built from `VITE_CONVEX_URL` and its bearer is minted by that same\n// deployment (`desktopAuthClient`), so a switched environment would present a\n// credential the deployment never issued. The one entry that read the key fed\n// the result to a shell composed with `authGate={false}`, which dropped it\n// before it reached anything at all.\n//\n// The environment is a BUILD fact, and `getEndpoints(convexUrl)` above is the\n// one way to ask what it implies. `CloudEnhancementSettings` displays it.\n","export { ImportProvider, useImport, useImportIfAvailable } from './ImportProvider';\nexport type { ImportProviderProps } from './ImportProvider';\n\nexport { cloudImportService } from './CloudImportService';\nexport type { CloudUploadResult } from './CloudImportService';\n\nexport { ENVIRONMENTS, detectEnvironment, getEndpoints } from './cloudConfig';\nexport type { CloudEnvironment, CloudEndpoints } from './cloudConfig';\n\nexport { multipartUpload } from './multipartUpload';\nexport type { MultipartUploadOptions, MultipartUploadResult } from './multipartUpload';\n\n// Re-export Uppy React hooks for use in custom UI components\nexport {\n  useDropzone,\n  useUppyState,\n  useUppyEvent,\n} from '@uppy/react';\n"],"mappings":"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","names":[]}

package/dist/_members/cloud-import/multipartUpload.d.ts

@@ -0,0 +1,12 @@
+export interface MultipartUploadOptions {
+    file: File;
+    signingUrl: string;
+    token: string;
+    metadata?: Record<string, string>;
+    onProgress?: (fraction: number) => void;
+}
+export interface MultipartUploadResult {
+    location: string;
+    mediaItemId: string;
+}
+export declare function multipartUpload(opts: MultipartUploadOptions): Promise<MultipartUploadResult>;

package/dist/_members/cloud-import/multipartUpload.js

@@ -0,0 +1,7 @@
+import {
+  multipartUpload
+} from "./chunk-XKO6ZSWI.js";
+export {
+  multipartUpload
+};
+//# sourceMappingURL=multipartUpload.js.map

package/dist/_members/cloud-import/multipartUpload.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"sourcesContent":[],"mappings":"","names":[]}

package/dist/_members/composition/ops/compositionOps.d.ts

@@ -4,7 +4,7 @@
  * All operations are side-effect-free: no persistence, no logging. Only
  * state mutations via set/get on the wire-shape Composition.
  *
- * Mirrors the desktop store's v2 ops (cueframe/src/store/compositionStore/
+ * Mirrors the desktop store's v2 ops (apps/studio/src/store/compositionStore/
  * compositionOps.ts). The OSS module drops desktop-only concerns
  * (corrections, transcriptDoc) — those live on the desktop envelope.
  */

package/dist/_members/composition/ops/types.d.ts

@@ -2,7 +2,7 @@
  * Composition types — v2 wire-shape.
  *
  * The OSS shared composition module mirrors the desktop store's v2
- * shape (cueframe/src/store/compositionStore/types.ts) minus desktop-only
+ * shape (apps/studio/src/store/compositionStore/types.ts) minus desktop-only
  * envelope concerns (corrections, transcriptDoc, isLoaded).
  *
  * Used by:

package/dist/_members/composition/timeline/placement.d.ts

@@ -1,7 +1,7 @@
 /**
  * WHERE A SOURCE GOES.
  *
- * Hoisted from `cueframe/src/components/Timeline/fabric/placement.ts` (2026-08-23)
+ * Hoisted from `apps/studio/src/components/Timeline/fabric/placement.ts` (2026-08-23)
  * for the reason the module's own header predicted and the repo rule requires:
  * the cloud director writes compositions too, so a placement rule that lives in
  * the desktop is a rule the cloud does not have. This is now the single home.

package/dist/_members/composition/validators/composition.d.ts

@@ -2320,7 +2320,7 @@ export declare const TimelineClip: z.ZodObject<{
      * does not select its audio, so every ripple, move and trim silently desyncs
      * sound from picture and the user finds out at playback. Every editor this
      * repo has been measured against carries the same field; ours had none
-     * (`grep linkGroup` returned nothing across `cueframe/src` and
+     * (`grep linkGroup` returned nothing across `apps/studio/src` and
      * `packages/composition/src` on 2026-08-23).
      *
      * Membership is the ONLY thing stored. What a link implies — expand the

package/dist/_members/composition-ops/index.d.ts

@@ -4888,7 +4888,7 @@ export declare function applyOp(composition: Composition, op: CompositionOp): Co
  *
  * So: `HeadlessStore` here is a STRUCTURAL contract (`CompositionOps` + a
  * `getState`), not a concrete class — `@cueframe/authoring`'s `CompositionStore`
- * and the desktop store satisfy it, and `LocalExecutor` (cueframe/src/llm) folds
+ * and the desktop store satisfy it, and `LocalExecutor` (apps/studio/src/llm) folds
  * a validated batch through it op-by-op. Writing a second switch for that lane
  * is what "one vocabulary" exists to prevent: it would drift silently the first
  * time an op is added here and forgotten there.

package/dist/_members/composition-ops/opRecorder.d.ts

@@ -3,7 +3,7 @@
  * recordingStore so it has exactly one home and two consumers:
  *
  *   - `createRecordingStore` (compose bench/eval): wraps the headless store.
- *   - the EDITOR's compositionOps delegate (cueframe/src/store): wraps the
+ *   - the EDITOR's compositionOps delegate (apps/studio/src/store): wraps the
  *     zustand-backed op surface, so every user gesture records the same wire
  *     op an agent would send — the P0.5 "editor writes are ops" seam.
  *

package/dist/_members/convex-api/api.d.ts

@@ -0,0 +1,5 @@
+import type { api as GeneratedApi } from "./api.generated.js";
+/** The client-facing function-reference proxy. Runtime-identical to the
+ *  backend's generated `api` (which IS `anyApi`); typed by the vendored
+ *  declarations with the internal.* surface stripped. */
+export declare const api: typeof GeneratedApi;

package/dist/_members/convex-api/dataModel.d.ts

@@ -0,0 +1,6 @@
+import type { GenericId } from "convex/values";
+import type { SystemTableNames } from "convex/server";
+/** Table NAMES only — the vendored surface deliberately omits document
+ *  shapes (Doc/DataModel). Public consumers use exclusively `Id<...>`. */
+export type TableNames = "agentMessages" | "agentThreads" | "apiAuditLog" | "billingPlanState" | "brandKits" | "briefs" | "checkpoints" | "clips" | "clipSuggestionRuns" | "componentVersions" | "composeJobs" | "compositionEvents" | "compositionRuns" | "compositions" | "compositionVersions" | "contextFiles" | "conversations" | "corrections" | "critics" | "dashboardInsights" | "directorProfiles" | "directorWorkflows" | "enrichmentCandidates" | "exports" | "idempotencyKeys" | "installedComponents" | "jobs" | "markers" | "mediaItems" | "mediaUnderstanding" | "overlays" | "pricingPolicy" | "processingEvents" | "projects" | "providerStates" | "renderJobs" | "resourceQueryCache" | "resourceRateBuckets" | "restorePoints" | "runs" | "searchQueries" | "sessions" | "sessionTokens" | "settings" | "socialAccounts" | "socialInsights" | "socialMediaItems" | "templateEmbeddings" | "templates" | "timelineClips" | "tracks" | "transcripts" | "uploadTokens" | "usageEvents" | "userSettings" | "videoChunkEmbeddings" | "webhookDeliveries" | "webhookProjectUpdateDebounce" | "webhooks" | "x402Payments";
+export type Id<TableName extends TableNames | SystemTableNames> = GenericId<TableName>;

package/dist/_members/core/render/exportSettings.d.ts

@@ -1,6 +1,6 @@
 /**
  * Export settings types and constants shared between desktop and cloud render paths.
- * Extracted from cueframe/src/store/exportStore.ts — pure functions, no store deps.
+ * Extracted from apps/studio/src/store/exportStore.ts — pure functions, no store deps.
  */
 import type { CaptionStyle } from './types.js';
 export type ExportQuality = 'maximum' | 'social' | 'web' | 'potato' | 'source';

package/dist/_members/mcp/curation.d.ts

@@ -52,7 +52,7 @@ export interface CuratedTool {
      * SSOT; this npm-shipped package can go stale, so it only controls listing):
      * 'expert' hides the tool from the public listing unless the expert layer is
      * on. Default 'stable'. Drift-gated against the server map in
-     * the backendapi/capabilities.drift.test.ts.
+     * the backend's capabilities drift test.
      */
     maturity?: 'stable' | 'expert';
     /**

package/dist/_members/plane/conformance.d.ts

@@ -2,7 +2,7 @@
  * THE LANE CONFORMANCE TABLE — one set of facts, executed by both lanes.
  *
  * WHY THIS FILE EXISTS. `preview_frame` is served twice: by the desktop plane
- * (`cueframe/src/plane/handlers.ts`, drawing through the webview) and by the
+ * (`apps/studio/src/plane/handlers.ts`, drawing through the webview) and by the
  * cloud route (`the `/v1/evidence` routes`, rendering through
  * Modal). Nothing made them agree. The only mechanism was review discipline —
  * comments like *"ALLOWED_KEYS TRACKS THAT SCHEMA … Add server-side keys here in

package/dist/_members/render-harness/localRender.d.ts

@@ -157,7 +157,7 @@ export interface RenderComponentAlphaOpts {
  * Bake an owned `.cueframe` component to an ALPHA (transparent) video via the
  * LOCAL Remotion bundle — the "trusted pixels" a cloud render later composites
  * (Task 2.6b) WITHOUT running the component's code in the shared render. Mirrors
- * the proven cueframe/scripts/spike-alpha renderMedia settings. Requires an
+ * the proven apps/studio/scripts/spike-alpha renderMedia settings. Requires an
  * installed Chrome via REMOTION_CHROME_EXECUTABLE. Output → the `.cueframe/` cache
  * (an R2-upload step for the cloud path is the 2.6b follow-up).
  */