@builder.io/ai-utils 0.87.1 → 0.89.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@builder.io/ai-utils",
-  "version": "0.87.1",
+  "version": "0.89.0",
   "description": "Builder.io AI utils",
   "files": [
     "src"

package/src/builder-config.d.ts

@@ -34,6 +34,22 @@ export declare const BuilderConfigHostingSchema: z.ZodObject<{
     }, z.core.$strip>>>;
 }, z.core.$strip>;
 export type BuilderConfigHosting = z.infer<typeof BuilderConfigHostingSchema>;
+/**
+ * `realtime` block in `builder.config.json` — selects the change-notification
+ * delivery transport. `"local"` (default) keeps sync on the app's own
+ * `/_agent-native/poll` + `/_agent-native/events`; `"hosted"` routes clients to
+ * the Builder Realtime Gateway. Read by the backend provisioning path only —
+ * it is never shipped to the browser (the client learns transport via the
+ * impersonal `window.__AGENT_NATIVE_CONFIG__` script). See the Agent-Native
+ * Realtime Sync spec.
+ */
+export declare const BuilderConfigRealtimeSchema: z.ZodObject<{
+    transport: z.ZodEnum<{
+        hosted: "hosted";
+        local: "local";
+    }>;
+}, z.core.$strip>;
+export type BuilderConfigRealtime = z.infer<typeof BuilderConfigRealtimeSchema>;
 export declare const BuilderConfigSchema: z.ZodObject<{
     database: z.ZodOptional<z.ZodObject<{
         kind: z.ZodLiteral<"postgres">;
@@ -49,5 +65,11 @@ export declare const BuilderConfigSchema: z.ZodObject<{
             prod: z.ZodCatch<z.ZodOptional<z.ZodPreprocess<z.ZodRecord<z.ZodString, z.ZodString>>>>;
         }, z.core.$strip>>>;
     }, z.core.$strip>>;
+    realtime: z.ZodCatch<z.ZodOptional<z.ZodObject<{
+        transport: z.ZodEnum<{
+            hosted: "hosted";
+            local: "local";
+        }>;
+    }, z.core.$strip>>>;
 }, z.core.$strip>;
 export type BuilderConfig = z.infer<typeof BuilderConfigSchema>;

package/src/builder-config.js

@@ -57,7 +57,23 @@ export const BuilderConfigHostingSchema = z.object({
     buildOutputDir: z.string().optional().catch(undefined),
     environment: BuilderConfigHostingEnvironmentSchema.optional().catch(undefined),
 });
+/**
+ * `realtime` block in `builder.config.json` — selects the change-notification
+ * delivery transport. `"local"` (default) keeps sync on the app's own
+ * `/_agent-native/poll` + `/_agent-native/events`; `"hosted"` routes clients to
+ * the Builder Realtime Gateway. Read by the backend provisioning path only —
+ * it is never shipped to the browser (the client learns transport via the
+ * impersonal `window.__AGENT_NATIVE_CONFIG__` script). See the Agent-Native
+ * Realtime Sync spec.
+ */
+export const BuilderConfigRealtimeSchema = z.object({
+    transport: z.enum(["local", "hosted"]),
+});
 export const BuilderConfigSchema = z.object({
     database: BuilderConfigDatabaseSchema.optional(),
     hosting: BuilderConfigHostingSchema.optional(),
+    // `.catch(undefined)` (like the `hosting` fields): a malformed `realtime`
+    // block degrades to "no realtime" rather than failing the whole parse and
+    // discarding a valid `database` block.
+    realtime: BuilderConfigRealtimeSchema.optional().catch(undefined),
 });

package/src/codegen.d.ts

@@ -2433,8 +2433,6 @@ export declare const CodeGenInputOptionsSchema: z.ZodObject<{
         planning: "planning";
     }>>;
     url: z.ZodOptional<z.ZodString>;
-    diffActions: z.ZodOptional<z.ZodBoolean>;
-    planningPrompt: z.ZodOptional<z.ZodBoolean>;
     customInstructions: z.ZodOptional<z.ZodArray<z.ZodObject<{
         id: z.ZodString;
         name: z.ZodString;
@@ -2485,7 +2483,6 @@ export declare const CodeGenInputOptionsSchema: z.ZodObject<{
         wasIncluded: z.ZodOptional<z.ZodBoolean>;
         virtual: z.ZodOptional<z.ZodBoolean>;
     }, z.core.$strip>>>;
-    rerankFiles: z.ZodOptional<z.ZodNumber>;
     toolResults: z.ZodOptional<z.ZodArray<z.ZodObject<{
         type: z.ZodLiteral<"tool_result">;
         tool_use_id: z.ZodString;
@@ -2767,18 +2764,13 @@ export declare const CodeGenInputOptionsSchema: z.ZodObject<{
     maxAgentLoops: z.ZodOptional<z.ZodNumber>;
     maxAgentTiming: z.ZodOptional<z.ZodNumber>;
     maxTokens: z.ZodOptional<z.ZodNumber>;
-    maxPages: z.ZodOptional<z.ZodNumber>;
-    autoContinue: z.ZodOptional<z.ZodNumber>;
     isManualContinue: z.ZodOptional<z.ZodBoolean>;
-    llmSuggestions: z.ZodOptional<z.ZodBoolean>;
-    conclusionText: z.ZodOptional<z.ZodBoolean>;
     mcpServers: z.ZodOptional<z.ZodBoolean>;
     pingEvents: z.ZodOptional<z.ZodBoolean>;
     forceCompact: z.ZodOptional<z.ZodBoolean>;
     hadPagination: z.ZodOptional<z.ZodBoolean>;
     category: z.ZodOptional<z.ZodUnion<readonly [z.ZodTemplateLiteral<`repair-${string}`>, z.ZodLiteral<"user-normal">, z.ZodLiteral<"user-figma">, z.ZodLiteral<"user-pdf">, z.ZodLiteral<"user-image">, z.ZodLiteral<"setup-agent">, z.ZodTemplateLiteral<`background-${string}`>, z.ZodTemplateLiteral<`indexing-${string}`>]>>;
     metadata: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodAny>>;
-    searchResponse: z.ZodOptional<z.ZodNullable<z.ZodAny>>;
     prettierConfig: z.ZodOptional<z.ZodCustom<PrettierOptions, PrettierOptions>>;
     role: z.ZodOptional<z.ZodEnum<{
         agent: "agent";
@@ -2874,6 +2866,8 @@ export declare const CodeGenInputOptionsSchema: z.ZodObject<{
 export type CodeGenInputOptions = z.infer<typeof CodeGenInputOptionsSchema> & {
     /** @internal Derived from BuilderEditorState.components for editor AI. */
     _allowedComponentNames?: string[];
+    /** @internal Derived from BuilderEditorState.components for editor AI. */
+    _fieldShapeChecks?: FieldShapeCheck[];
     /**
      * Optional factory function to wrap the MCP client with custom behavior
      * Used by Editor AI to add permission checks for model operations
@@ -2883,6 +2877,11 @@ export type CodeGenInputOptions = z.infer<typeof CodeGenInputOptionsSchema> & {
      */
     _mcpClientWrapperFactory?: (realClient: any) => any;
 };
+export interface FieldShapeCheck {
+    component: string;
+    input: string;
+    subField: string;
+}
 export type CodeGenErrorCodes = "credits-limit-daily" | "credits-limit-monthly" | "credits-limit-user" | "credits-limit-other" | "cli-genetic-error" | "git-update-error" | "prompt-too-long" | "context-too-long" | "abrupt-end" | "unknown" | "failed-recover-state" | "completion-expired" | "ask-to-continue" | "bad-initial-url" | "bad-smart-export-payload" | "invalid-last-message" | "corrupted-session" | "privacy-mode-key-required" | "privacy-mode-key-invalid" | "privacy-mode-key-mismatch" | "privacy-mode-validation-unavailable" | "cli-network-error" | "invalid-credentials" | "model-restricted-too-large" | "org-no-models-enabled" | "assertion" | "rate-limit" | "unknown-design-system";
 export interface CodegenUsage {
     total: number;
@@ -2915,38 +2914,6 @@ export interface ActionItem {
     suggestions?: PromptSuggestion[];
     errors?: string[];
 }
-export interface RepoInfo {
-    remoteUrl: string;
-    defaultBranch: string;
-    currentBranch: string;
-    commit: string;
-}
-export interface CodebaseSearchOptions {
-    repoInfo?: RepoInfo;
-    query: string;
-    selectedFiles?: string[];
-    sessionId: string;
-    files?: string[];
-    packageJson?: string;
-    limit?: number;
-    includeContent?: boolean;
-}
-export interface CodebaseSearchResponse {
-    id: string;
-    relevantPaths: string[];
-    grepQueries: string[];
-    streamMeta: any;
-    ranked: RankedResult[];
-}
-export interface RankedResult {
-    index: number;
-    filePath: string;
-    startIndex: number;
-    endIndex: number;
-    score: number;
-    id: string;
-    content?: string;
-}
 export interface GenerateCompletionStepThinking {
     type: "thinking";
     content: string;
@@ -3768,9 +3735,6 @@ export interface UserInput {
     systemReminders: SystemReminder[];
     attachments: Attachment[];
     files: ProjectFile[];
-    searchResponse: CodebaseSearchResponse | null;
-    rerankFiles?: number;
-    mostRelevantFile: string | null;
     toolResults: ContentMessageItemToolResult[];
     user: UserSource;
     patchFusionConfig?: Partial<FusionConfig> | undefined;
@@ -4575,20 +4539,6 @@ export interface LaunchServerStatus {
     memoryUsage?: number;
     sessionId?: string;
 }
-/**
- * VS Code Tunnel status information
- */
-export interface TunnelStatusInfo {
-    enabled: boolean;
-    status: "stopped" | "starting" | "running" | "error";
-    name: string | null;
-    url: string | null;
-    vscodeUri: string | null;
-    cursorUri: string | null;
-    webUrl: string | null;
-    error: string | null;
-    workspacePath: string;
-}
 export interface FusionStatus {
     status: "ok";
     state: LaunchServerState;
@@ -4617,8 +4567,6 @@ export interface FusionStatus {
     containerStateTimestamp?: number;
     wsClients: number;
     httpClients: number;
-    /** VS Code Tunnel status for remote editor connections */
-    tunnel?: TunnelStatusInfo;
     /** Event loop delays collected every 5 seconds (in milliseconds) for percentile calculation */
     eventLoopDelays?: number[];
     /** Max memory pressure observed in the reporting period (0-1, where 1 is near OOM) */

package/src/codegen.js

@@ -1616,6 +1616,11 @@ export const SessionModeSchema = z
     .meta({ title: "SessionMode" });
 export const CodeGenModeSchema = z
     .enum([
+    /**
+     * @deprecated The legacy quality-v2 pipeline has been removed. Old
+     * dev-tools clients that still request this mode are served `quality-v4`.
+     * New code should not produce this value.
+     */
     "quality",
     "quality-v4",
     /**
@@ -1909,8 +1914,6 @@ export const CodeGenInputOptionsSchema = z
     codeGenMode: CodeGenModeSchema.optional(),
     sessionMode: SessionModeSchema.optional(),
     url: z.string().optional(),
-    diffActions: z.boolean().optional(),
-    planningPrompt: z.boolean().optional(),
     customInstructions: z.array(CustomInstructionSchema).optional(),
     customAgents: z.array(CustomAgentInfoSchema).optional(),
     systemPromptOverride: z.union([z.string(), z.array(z.string())]).optional(),
@@ -1920,7 +1923,6 @@ export const CodeGenInputOptionsSchema = z
     uiContextPrompt: z.string().optional(),
     displayUserPrompt: z.string().optional(),
     files: z.array(ProjectFileSchema).optional(),
-    rerankFiles: z.number().optional(),
     toolResults: z.array(ContentMessageItemToolResultSchema).optional(),
     attachments: z.array(AttachmentSchema).optional(),
     beforeCommit: GitSnapshotSchema.optional(),
@@ -1965,18 +1967,13 @@ export const CodeGenInputOptionsSchema = z
     maxTokens: z.number().optional().meta({
         description: "Maximum output tokens allowed in the LLM response. This will set the maximum token output for the LLM.",
     }),
-    maxPages: z.number().optional(),
-    autoContinue: z.number().optional(),
     isManualContinue: z.boolean().optional(),
-    llmSuggestions: z.boolean().optional(),
-    conclusionText: z.boolean().optional(),
     mcpServers: z.boolean().optional(),
     pingEvents: z.boolean().optional(),
     forceCompact: z.boolean().optional(),
     hadPagination: z.boolean().optional(),
     category: CodeGenCategorySchema.optional(),
     metadata: z.record(z.string(), z.any()).optional(),
-    searchResponse: z.any().nullish(),
     prettierConfig: z.custom().optional(),
     // Role
     role: z.enum(["user", "agent"]).optional(),

package/src/events.d.ts

@@ -3,6 +3,7 @@ import type { AssistantMessage, AssistantMessageAction } from "./messages.js";
 import type { AssistantSettings } from "./settings.js";
 import type { ExitState, UserSource, CodeGenPosition, ReviewSeverity, ReviewVerdict } from "./codegen.js";
 import type { FileUpload } from "./messages.js";
+import type { BuilderConfigRealtime } from "./builder-config.js";
 export type BuilderAssistantEventHandler = (ev: BuilderAssistantEvent) => void;
 export type BuilderAssistantEvent = AssistantCompletionResultEvent | AssistantErrorEvent | AssistantStreamErrorEvent | AppCloseEvent | AppMessagesClickEvent | AppMessagesGenerationEvent | AppMessageEditCustomInstructionsEvent | AppPromptAbortEvent | AppPromptFocusEvent | AppPromptSubmitEvent | AppReadyEvent | AppSettingsSetEvent | AppThreadNewEvent | AssistantStatsEvent | AssistantThemeEvent | BuilderEditorAuthEvent | BuilderEditorStateEvent | ContentUpdateEvent | ContentApplySnapshotEvent | ModelUndoEvent | ModelRedoEvent | ResultEvent | ThreadCreatedEvent | ThreadMessageCompletedEvent | ThreadMessageCreatedEvent | ThreadMessageDeltaEvent | ThreadMessageFeedbackEvent | ThreadRunStepCreatedEvent | ThreadRunStepDeltaEvent | AppAcceptChangeEvent | AppAcceptRejectEvent | AssistantTrackEvent | AssistantEditorAuthMessage | AppAttachmentTemplateEvent | AppPasteSmartExportEvent | ThreadMessageRetryEvent | AppFigmaImportEvent | AppWebImportEvent | AppMcpServersEvent | AssistantContentInitialEvent | ThreadMessageSummaryEvent | ThreadMessageSummaryCodegenDeltaEvent | ThreadMessageThinkingDeltaEvent | AssistantHeartbeatEvent | ShowUpgradeDialogEvent | AssistantFusionSuggestionEvent | AppNavigateToFusionEvent | ModelPermissionRequiredEvent | ModelPermissionResponseEvent;
 export interface AssistantCompletionResultEvent {
@@ -1271,6 +1272,15 @@ export type ClientDevtoolsBuildUploadedV1 = FusionEventVariant<"client.devtools.
      * directly in the handler and is not sent through the event.
      */
     prodEnvFromBuilderConfig?: Record<string, string>;
+    /**
+     * `realtime.transport` from the same `builder.config.json` read. Sent from
+     * the pod because the tree it built is the authoritative revision — the
+     * service would otherwise have to re-resolve the deployed commit through
+     * the git provider, which for template-backed projects can resolve against
+     * a different repo. Absent from pods predating this field; the handler
+     * falls back to reading the repo at the deployed commit.
+     */
+    realtimeTransport?: BuilderConfigRealtime["transport"];
 }, {
     projectId: string;
     deployId: string;

package/src/index.d.ts

@@ -13,7 +13,6 @@ export * from "./fusion-environment.js";
 export * from "./repo-indexing.js";
 export * from "./organization.js";
 export * from "./features.js";
-export * from "./vscode-tunnel.js";
 export * from "./claw.js";
 export * from "./kube-error.js";
 export * from "./connectivity/types.js";

package/src/index.js

@@ -13,7 +13,6 @@ export * from "./fusion-environment.js";
 export * from "./repo-indexing.js";
 export * from "./organization.js";
 export * from "./features.js";
-export * from "./vscode-tunnel.js";
 export * from "./claw.js";
 export * from "./kube-error.js";
 export * from "./connectivity/types.js";

package/src/organization.d.ts

@@ -1,4 +1,4 @@
-import type { PrivacyMode, ReviewEffort } from "./codegen";
+import type { PrivacyMode, ReasoningEffort, ReviewEffort } from "./codegen";
 import type { EnvironmentVariable } from "./common-schemas";
 export interface GitlabEnterpriseSetupValue {
     host: string;
@@ -103,6 +103,8 @@ interface OrganizationSettings {
     fusionPrQuietMode?: boolean;
     runInPty?: boolean;
     maxAgentCompletions?: number;
+    defaultBackgroundAgentModel?: string;
+    defaultBackgroundAgentEffort?: ReasoningEffort;
     privacyMode?: Pick<PrivacyMode, "mcpServers" | "redactUserMessages" | "redactLLMMessages"> & {
         enabled?: boolean;
     };
@@ -328,6 +330,7 @@ export interface FeatureMap {
     agentCreditsRollover?: boolean;
     selfHostedGitProviders?: boolean;
     reviewAgent?: boolean;
+    hosting?: boolean;
 }
 export interface SubscriptionInfo {
     price?: number;
@@ -420,6 +423,7 @@ export interface SubscriptionInfoMap {
     "vcp:v1:level1": SubscriptionInfo;
     "vcp:v1:level2": SubscriptionInfo;
     "vcp:v1:enterprise": SubscriptionInfo;
+    "vcp:v2:enterprise": SubscriptionInfo;
     "vcp:v2:level1": SubscriptionInfo;
     "vcp:v2:level2": SubscriptionInfo;
     "vcp:v3:level1": SubscriptionInfo;

package/src/projects.d.ts

@@ -616,9 +616,6 @@ export interface BranchSharedData {
     checkoutCommit?: string | null;
     /** Whether this branch is for a fork PR - affects git operations (read-only, can't push) */
     isFork?: boolean | null;
-    vscodeTunnelUrl?: string | null;
-    vscodeTunnelName?: string | null;
-    vscodeTunnelExpiresAt?: string | null;
     commitMode?: CommitMode;
     /** @internal When false, merging this branch's PR does not archive it. Seeded from project.settings at creation. */
     autoCloseBranchOnMerge?: boolean;
@@ -1610,6 +1607,15 @@ export interface ProjectDatabase {
     role: string;
     /** @internal Plaintext credential — Firestore IAM enforces access. Never serialize to client responses. */
     password: string;
+    /**
+     * @internal Per-project HMAC secret for signing/verifying Realtime Gateway
+     * subscribe tokens. Plaintext like `password`; Firestore IAM enforces access.
+     * Never serialize to client responses. Absent on projects provisioned before
+     * the Realtime Sync Gateway shipped — there is no backfill by design; such a
+     * project gets its secret on its next deploy. See the Agent-Native Realtime
+     * Sync spec.
+     */
+    realtimeHmacSecret?: string;
     /** Database name (white-labeled to "main"); needed to build connection URIs. */
     database: string;
     region: string;

package/src/vscode-tunnel.d.ts

@@ -1,89 +0,0 @@
-/**
- * VS Code Tunnel Deep Link Utilities
- *
- * Generates deep links for opening VS Code, Cursor, or web editor
- * connected to a VS Code tunnel.
- */
-/**
- * Default workspace path inside the container
- */
-export declare const DEFAULT_WORKSPACE_PATH = "/root/app/code";
-/**
- * Generate a VS Code deep link for a tunnel
- *
- * @param tunnelName - The name of the VS Code tunnel
- * @param workspacePath - The path to open in the editor (defaults to /root/app/code)
- * @returns A vscode:// URI that opens VS Code connected to the tunnel
- *
- * @example
- * generateVSCodeDeepLink("my-project-main")
- * // Returns: "vscode://vscode-remote/tunnel+my-project-main/root/app/code"
- */
-export declare function generateVSCodeDeepLink(tunnelName: string, workspacePath?: string): string;
-/**
- * Generate a Cursor deep link for a tunnel
- *
- * @param tunnelName - The name of the VS Code tunnel
- * @param workspacePath - The path to open in the editor (defaults to /root/app/code)
- * @returns A cursor:// URI that opens Cursor connected to the tunnel
- *
- * @example
- * generateCursorDeepLink("my-project-main")
- * // Returns: "cursor://cursor-remote/tunnel+my-project-main/root/app/code"
- */
-export declare function generateCursorDeepLink(tunnelName: string, workspacePath?: string): string;
-/**
- * Generate a web editor (vscode.dev) link for a tunnel
- *
- * @param tunnelName - The name of the VS Code tunnel
- * @param workspacePath - The path to open in the editor (defaults to /root/app/code)
- * @returns A https://vscode.dev URL that opens the web editor connected to the tunnel
- *
- * @example
- * generateWebEditorLink("my-project-main")
- * // Returns: "https://vscode.dev/tunnel/my-project-main/root/app/code"
- */
-export declare function generateWebEditorLink(tunnelName: string, workspacePath?: string): string;
-/**
- * Generate all deep links for a tunnel
- *
- * @param tunnelName - The name of the VS Code tunnel
- * @param workspacePath - The path to open in the editor (defaults to /root/app/code)
- * @returns An object containing all deep link variants
- *
- * @example
- * generateAllEditorLinks("my-project-main")
- * // Returns: {
- * //   vscode: "vscode://vscode-remote/tunnel+my-project-main/root/app/code",
- * //   cursor: "cursor://cursor-remote/tunnel+my-project-main/root/app/code",
- * //   web: "https://vscode.dev/tunnel/my-project-main/root/app/code"
- * // }
- */
-export declare function generateAllEditorLinks(tunnelName: string, workspacePath?: string): {
-    vscode: string;
-    cursor: string;
-    web: string;
-};
-/**
- * Generate a sanitized tunnel name from project and branch identifiers
- *
- * @param projectId - The project ID
- * @param branchName - The branch name
- * @returns A DNS-compatible tunnel name (max 63 chars, lowercase alphanumeric and hyphens)
- *
- * @example
- * generateTunnelName("abc123", "feature/my-branch")
- * // Returns: "abc123-feature-my-branch"
- */
-export declare function generateTunnelName(projectId: string, branchName: string): string;
-/**
- * Parse a tunnel URL to extract the tunnel name
- *
- * @param tunnelUrl - A vscode.dev tunnel URL
- * @returns The tunnel name, or null if the URL is invalid
- *
- * @example
- * parseTunnelUrl("https://vscode.dev/tunnel/my-project-main/root/app/code")
- * // Returns: "my-project-main"
- */
-export declare function parseTunnelUrl(tunnelUrl: string): string | null;

package/src/vscode-tunnel.js

@@ -1,109 +0,0 @@
-/**
- * VS Code Tunnel Deep Link Utilities
- *
- * Generates deep links for opening VS Code, Cursor, or web editor
- * connected to a VS Code tunnel.
- */
-/**
- * Default workspace path inside the container
- */
-export const DEFAULT_WORKSPACE_PATH = "/root/app/code";
-/**
- * Generate a VS Code deep link for a tunnel
- *
- * @param tunnelName - The name of the VS Code tunnel
- * @param workspacePath - The path to open in the editor (defaults to /root/app/code)
- * @returns A vscode:// URI that opens VS Code connected to the tunnel
- *
- * @example
- * generateVSCodeDeepLink("my-project-main")
- * // Returns: "vscode://vscode-remote/tunnel+my-project-main/root/app/code"
- */
-export function generateVSCodeDeepLink(tunnelName, workspacePath = DEFAULT_WORKSPACE_PATH) {
-    return `vscode://vscode-remote/tunnel+${tunnelName}${workspacePath}`;
-}
-/**
- * Generate a Cursor deep link for a tunnel
- *
- * @param tunnelName - The name of the VS Code tunnel
- * @param workspacePath - The path to open in the editor (defaults to /root/app/code)
- * @returns A cursor:// URI that opens Cursor connected to the tunnel
- *
- * @example
- * generateCursorDeepLink("my-project-main")
- * // Returns: "cursor://cursor-remote/tunnel+my-project-main/root/app/code"
- */
-export function generateCursorDeepLink(tunnelName, workspacePath = DEFAULT_WORKSPACE_PATH) {
-    return `cursor://cursor-remote/tunnel+${tunnelName}${workspacePath}`;
-}
-/**
- * Generate a web editor (vscode.dev) link for a tunnel
- *
- * @param tunnelName - The name of the VS Code tunnel
- * @param workspacePath - The path to open in the editor (defaults to /root/app/code)
- * @returns A https://vscode.dev URL that opens the web editor connected to the tunnel
- *
- * @example
- * generateWebEditorLink("my-project-main")
- * // Returns: "https://vscode.dev/tunnel/my-project-main/root/app/code"
- */
-export function generateWebEditorLink(tunnelName, workspacePath = DEFAULT_WORKSPACE_PATH) {
-    return `https://vscode.dev/tunnel/${tunnelName}${workspacePath}`;
-}
-/**
- * Generate all deep links for a tunnel
- *
- * @param tunnelName - The name of the VS Code tunnel
- * @param workspacePath - The path to open in the editor (defaults to /root/app/code)
- * @returns An object containing all deep link variants
- *
- * @example
- * generateAllEditorLinks("my-project-main")
- * // Returns: {
- * //   vscode: "vscode://vscode-remote/tunnel+my-project-main/root/app/code",
- * //   cursor: "cursor://cursor-remote/tunnel+my-project-main/root/app/code",
- * //   web: "https://vscode.dev/tunnel/my-project-main/root/app/code"
- * // }
- */
-export function generateAllEditorLinks(tunnelName, workspacePath = DEFAULT_WORKSPACE_PATH) {
-    return {
-        vscode: generateVSCodeDeepLink(tunnelName, workspacePath),
-        cursor: generateCursorDeepLink(tunnelName, workspacePath),
-        web: generateWebEditorLink(tunnelName, workspacePath),
-    };
-}
-/**
- * Generate a sanitized tunnel name from project and branch identifiers
- *
- * @param projectId - The project ID
- * @param branchName - The branch name
- * @returns A DNS-compatible tunnel name (max 63 chars, lowercase alphanumeric and hyphens)
- *
- * @example
- * generateTunnelName("abc123", "feature/my-branch")
- * // Returns: "abc123-feature-my-branch"
- */
-export function generateTunnelName(projectId, branchName) {
-    const combined = `${projectId}-${branchName}`;
-    const sanitized = combined
-        .toLowerCase()
-        .replace(/[^a-z0-9-]/g, "-")
-        .replace(/-+/g, "-")
-        .replace(/^-|-$/g, "")
-        .substring(0, 63);
-    return sanitized || "builder-tunnel";
-}
-/**
- * Parse a tunnel URL to extract the tunnel name
- *
- * @param tunnelUrl - A vscode.dev tunnel URL
- * @returns The tunnel name, or null if the URL is invalid
- *
- * @example
- * parseTunnelUrl("https://vscode.dev/tunnel/my-project-main/root/app/code")
- * // Returns: "my-project-main"
- */
-export function parseTunnelUrl(tunnelUrl) {
-    const match = tunnelUrl.match(/(?:vscode\.dev\/tunnel\/|tunnel\+)([a-zA-Z0-9_-]+)/);
-    return match ? match[1] : null;
-}