@builder.io/ai-utils 0.13.4 → 0.14.1

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@builder.io/ai-utils",
-  "version": "0.13.4",
+  "version": "0.14.1",
   "description": "Builder.io AI utils",
   "type": "module",
   "main": "src/index.js",

package/src/codegen.d.ts

@@ -463,6 +463,13 @@ export interface GenerateCompletionStepText {
     type: "text";
     content: string;
 }
+export interface ContextWindow {
+    usage: number;
+    usedTokens: number;
+    cachedTokens: number;
+    totalTokens: number;
+    details: Record<string, any>;
+}
 export interface GenerateCompletionStepDone {
     type: "done";
     id: string;
@@ -470,6 +477,7 @@ export interface GenerateCompletionStepDone {
     actions: ActionItem[];
     creditsUsed: number;
     sessionUsage: number;
+    contextWindow: ContextWindow;
     model: string;
     usage: CodegenUsage | undefined;
     url?: string;
@@ -856,6 +864,7 @@ export interface GenerateCodeEventDone {
     usage?: CodegenUsage;
     messageIndex: number;
     sessionUsage: number;
+    contextWindow: ContextWindow;
     nextUrl: string;
     autoContinue: boolean;
     model: string;
@@ -1271,6 +1280,20 @@ export interface LaunchServerStatus {
     fusionConfig?: FusionConfig;
     fusionEnvironment: "cloud" | "cloud-v2" | "unknown";
 }
+/**
+ * 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;
@@ -1291,6 +1314,8 @@ export interface FusionStatus {
     fusionEnvironment: "cloud" | "cloud-v2" | "unknown";
     wsClients: number;
     httpClients: number;
+    /** VS Code Tunnel status for remote editor connections */
+    tunnel?: TunnelStatusInfo;
 }
 export interface FusionMetrics {
     counters: {

package/src/index.d.ts

@@ -8,3 +8,4 @@ export * from "./projects.js";
 export * from "./repo-indexing.js";
 export * from "./organization.js";
 export * from "./features.js";
+export * from "./vscode-tunnel.js";

package/src/index.js

@@ -8,3 +8,4 @@ export * from "./projects.js";
 export * from "./repo-indexing.js";
 export * from "./organization.js";
 export * from "./features.js";
+export * from "./vscode-tunnel.js";

package/src/messages.d.ts

@@ -11,6 +11,7 @@ export interface ContentMessageItemText {
     citations?: TextCitationParam[] | null;
     ephemeral?: boolean;
     thoughtSignature?: string;
+    tag?: string;
 }
 export interface ContentMessageItemImage {
     type: "image";

package/src/organization.d.ts

@@ -19,6 +19,11 @@ export interface GitlabEnterprisePATValue {
     botUsername: string;
     secondaryHost?: string;
 }
+export interface GitlabCloudFallbackToken {
+    token: string;
+    createdBy: string;
+    createdAt: number;
+}
 interface OrganizationSettings {
     attribution?: string[];
     visualEditorAiStyleInspirationURL?: string;
@@ -33,6 +38,7 @@ interface OrganizationSettings {
     shopify?: boolean;
     githubEnterpriseSetupValue?: GithubEnterpriseSetupValue;
     gitlabEnterprisePAT?: GitlabEnterprisePATValue;
+    gitlabCloudFallbackToken?: GitlabCloudFallbackToken;
     bitbucketEnterprisePAT?: BitbucketEnterprisePAT;
     useProxy?: boolean;
     fusionShareableUrlSuffix?: string;
@@ -44,7 +50,7 @@ interface OrganizationSettings {
     privacyMode?: Pick<PrivacyMode, "mcpServers" | "redactUserMessages" | "redactLLMMessages"> & {
         enabled?: boolean;
     };
-    blockFigmaImageUpload?: boolean;
+    disableFigmaImageUpload?: boolean;
 }
 interface RoleOptions {
     read?: boolean;
@@ -372,5 +378,6 @@ export interface Organization {
     enterpriseTrialEndDate?: number;
     fusionReferrals?: string;
     githubInstallationIds?: number[];
+    disableFigmaImageUpload?: boolean;
 }
 export {};

package/src/projects.d.ts

@@ -136,7 +136,7 @@ export interface ReadyMessage extends BaseMessage {
 export type MachineState = "unknown" | "created" | "starting" | "started" | "stopping" | "stopped" | "suspending" | "suspended" | "replacing" | "destroying" | "destroyed" | "not-found" | "running" | "failed";
 export type FlyVolumeState = "unknown" | "creating" | "created" | "extending" | "restoring" | "enabling_remote_export" | "hydrating" | "recovering" | "scheduling_destroy" | "pending_destroy" | "failed";
 export type GitAuthErrorCode = "git-auth-failed" | "git-auth-failed-root-repo" | "git-auth-failed-folder-added-by" | "git-auth-failed-folder-created-by" | "git-auth-failed-repo-not-found" | "git-auth-failed-repo-renamed" | "git-auth-failed-folder-server-token" | "git-auth-failed-root-repo-server-token" | "git-auth-failed-ghes-unreachable";
-export type EnsureContainerErrorCode = "FAILED_TO_START_MACHINE_ERROR" | "FLY_APP_CHECK_ERROR" | "FLY_CAPACITY_ERROR" | "FLY_PERMISSIONS_TOKEN_ERROR" | "FLY_VOLUME_CREATE_ERROR" | "FLY_VOLUME_FORK_ERROR" | "FLY_VOLUME_DELETE_RECENTLY_FORKED_ERROR" | "FLY_MACHINE_CREATE_ERROR" | "FLY_VOLUME_CHECK_ERROR" | "FLY_NON_MOUNTABLE_VOLUME_ERROR" | "FLY_DEPRECATED_REGION_ERROR" | "FLY_VOLUME_NOT_FOUND" | "FLY_MACHINE_LIMIT_ERROR" | "KUBE_CAPACITY_ERROR" | "KUBE_PERMISSIONS_ERROR" | "KUBE_POD_LIMIT_ERROR" | "KUBE_RESOURCE_QUOTA_ERROR" | "KUBE_NAMESPACE_CHECK_ERROR" | "KUBE_PVC_CREATE_ERROR" | "KUBE_PVC_CHECK_ERROR" | "KUBE_POD_CREATE_ERROR" | "KUBE_SERVICE_CREATE_ERROR" | "KUBE_INGRESS_CREATE_ERROR" | "KUBE_POD_FAILED_TO_START_ERROR" | "ensure-checking-existing-machines" | "found-multiple-failed-machine" | "maximun-retries-machine-creation" | GitAuthErrorCode | "unknown" | "project-bad-state" | "project-not-found" | "project-deleted" | "project-branch-not-found" | "project-branch-deleted" | "project-branch-no-session-id" | "project-repo-full-name-not-found" | "project-org-not-found" | "invalid-project-repo-url-already-in-use" | "no-available-regions" | "invalid-backup-without-volume-id" | "missing-app-with-machine-or-volume" | "update-branch-info-in-firebase" | "update-branch-app-name-in-firebase" | `machine-status-polling-${MachineState}` | `machine-image-exited-immediately` | `volume-not-found-${FlyVolumeState}` | "trying-to-remove-used-volume" | "timeout" | "fatal:zod-validation-error" | `fatal:${string}`;
+export type EnsureContainerErrorCode = "FAILED_TO_START_MACHINE_ERROR" | "FLY_APP_CHECK_ERROR" | "FLY_CAPACITY_ERROR" | "FLY_PERMISSIONS_TOKEN_ERROR" | "FLY_VOLUME_CREATE_ERROR" | "FLY_VOLUME_FORK_ERROR" | "FLY_VOLUME_DELETE_RECENTLY_FORKED_ERROR" | "FLY_MACHINE_CREATE_ERROR" | "FLY_VOLUME_CHECK_ERROR" | "FLY_NON_MOUNTABLE_VOLUME_ERROR" | "FLY_DEPRECATED_REGION_ERROR" | "FLY_VOLUME_NOT_FOUND" | "FLY_MACHINE_LIMIT_ERROR" | "KUBE_CAPACITY_ERROR" | "KUBE_PERMISSIONS_ERROR" | "KUBE_POD_LIMIT_ERROR" | "KUBE_RESOURCE_QUOTA_ERROR" | "KUBE_NAMESPACE_CHECK_ERROR" | "KUBE_PVC_CREATE_ERROR" | "KUBE_PVC_CHECK_ERROR" | "KUBE_POD_CREATE_ERROR" | "KUBE_SERVICE_CREATE_ERROR" | "KUBE_INGRESS_CREATE_ERROR" | "KUBE_POD_FAILED_TO_START_ERROR" | "ensure-checking-existing-machines" | "found-multiple-failed-machine" | "maximun-retries-machine-creation" | GitAuthErrorCode | "unknown" | "project-bad-state" | "project-not-found" | "project-deleted" | "project-branch-not-found" | "project-branch-deleted" | "project-branch-no-session-id" | "project-repo-full-name-not-found" | "project-org-not-found" | "invalid-project-repo-url-already-in-use" | "no-available-regions" | "invalid-backup-without-volume-id" | "missing-app-with-machine-or-volume" | "update-branch-info-in-firebase" | "update-branch-app-name-in-firebase" | `machine-status-polling-${MachineState}` | `machine-image-exited-immediately` | `volume-not-found-${FlyVolumeState}` | "trying-to-remove-used-volume" | "missing-container-url" | "timeout" | "fatal:zod-validation-error" | `fatal:${string}`;
 export interface ErrorStateMessage extends BaseMessage {
     state: "error";
     message: string;
@@ -319,6 +319,9 @@ interface BranchSharedData {
     kubePvcName?: string | null;
     kubeHostname?: string | null;
     checkoutBranch?: string | null;
+    vscodeTunnelUrl?: string | null;
+    vscodeTunnelName?: string | null;
+    vscodeTunnelExpiresAt?: string | null;
 }
 /**
  * fields that are required in the new branch format, but optional in the legacy branch format.
@@ -520,7 +523,7 @@ export interface OrganizationPrivate {
     updatedAt: number;
 }
 export interface CreateProjectOptions {
-    name: string;
+    name?: string;
     repoFullName: string;
     repoProvider: string;
     repoProtocol?: string;

package/src/vscode-tunnel.d.ts

@@ -0,0 +1,89 @@
+/**
+ * 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

@@ -0,0 +1,109 @@
+/**
+ * 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;
+}