@cf-vibesdk/sdk 0.0.1

package/dist/index.d.ts

@@ -0,0 +1,1562 @@
+// Generated by dts-bundle-generator v9.5.1
+
+import z from 'zod';
+
+declare const FileOutputSchema: z.ZodObject<{
+	filePath: z.ZodString;
+	fileContents: z.ZodString;
+	filePurpose: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+	filePath: string;
+	fileContents: string;
+	filePurpose: string;
+}, {
+	filePath: string;
+	fileContents: string;
+	filePurpose: string;
+}>;
+declare const FileConceptSchema: z.ZodObject<{
+	path: z.ZodString;
+	purpose: z.ZodString;
+	changes: z.ZodNullable<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+	path: string;
+	purpose: string;
+	changes: string | null;
+}, {
+	path: string;
+	purpose: string;
+	changes: string | null;
+}>;
+declare const PhaseConceptSchema: z.ZodObject<{
+	name: z.ZodString;
+	description: z.ZodString;
+	files: z.ZodArray<z.ZodObject<{
+		path: z.ZodString;
+		purpose: z.ZodString;
+		changes: z.ZodNullable<z.ZodString>;
+	}, "strip", z.ZodTypeAny, {
+		path: string;
+		purpose: string;
+		changes: string | null;
+	}, {
+		path: string;
+		purpose: string;
+		changes: string | null;
+	}>, "many">;
+	lastPhase: z.ZodBoolean;
+}, "strip", z.ZodTypeAny, {
+	name: string;
+	description: string;
+	files: {
+		path: string;
+		purpose: string;
+		changes: string | null;
+	}[];
+	lastPhase: boolean;
+}, {
+	name: string;
+	description: string;
+	files: {
+		path: string;
+		purpose: string;
+		changes: string | null;
+	}[];
+	lastPhase: boolean;
+}>;
+declare const CodeReviewOutput: z.ZodObject<{
+	dependenciesNotMet: z.ZodArray<z.ZodString, "many">;
+	issuesFound: z.ZodBoolean;
+	frontendIssues: z.ZodArray<z.ZodString, "many">;
+	backendIssues: z.ZodArray<z.ZodString, "many">;
+	filesToFix: z.ZodArray<z.ZodObject<{
+		filePath: z.ZodString;
+		issues: z.ZodArray<z.ZodString, "many">;
+		require_code_changes: z.ZodBoolean;
+	}, "strip", z.ZodTypeAny, {
+		issues: string[];
+		filePath: string;
+		require_code_changes: boolean;
+	}, {
+		issues: string[];
+		filePath: string;
+		require_code_changes: boolean;
+	}>, "many">;
+	commands: z.ZodArray<z.ZodString, "many">;
+}, "strip", z.ZodTypeAny, {
+	commands: string[];
+	dependenciesNotMet: string[];
+	issuesFound: boolean;
+	frontendIssues: string[];
+	backendIssues: string[];
+	filesToFix: {
+		issues: string[];
+		filePath: string;
+		require_code_changes: boolean;
+	}[];
+}, {
+	commands: string[];
+	dependenciesNotMet: string[];
+	issuesFound: boolean;
+	frontendIssues: string[];
+	backendIssues: string[];
+	filesToFix: {
+		issues: string[];
+		filePath: string;
+		require_code_changes: boolean;
+	}[];
+}>;
+declare const PhasicBlueprintSchema: z.ZodObject<{
+	title: z.ZodString;
+	projectName: z.ZodString;
+	description: z.ZodString;
+	colorPalette: z.ZodArray<z.ZodString, "many">;
+} & {
+	detailedDescription: z.ZodString;
+	views: z.ZodArray<z.ZodObject<{
+		name: z.ZodString;
+		description: z.ZodString;
+	}, "strip", z.ZodTypeAny, {
+		name: string;
+		description: string;
+	}, {
+		name: string;
+		description: string;
+	}>, "many">;
+	userFlow: z.ZodObject<{
+		uiLayout: z.ZodString;
+		uiDesign: z.ZodString;
+		userJourney: z.ZodString;
+	}, "strip", z.ZodTypeAny, {
+		uiLayout: string;
+		uiDesign: string;
+		userJourney: string;
+	}, {
+		uiLayout: string;
+		uiDesign: string;
+		userJourney: string;
+	}>;
+	dataFlow: z.ZodString;
+	architecture: z.ZodObject<{
+		dataFlow: z.ZodString;
+	}, "strip", z.ZodTypeAny, {
+		dataFlow: string;
+	}, {
+		dataFlow: string;
+	}>;
+	pitfalls: z.ZodArray<z.ZodString, "many">;
+	frameworks: z.ZodArray<z.ZodString, "many">;
+	implementationRoadmap: z.ZodArray<z.ZodObject<{
+		phase: z.ZodString;
+		description: z.ZodString;
+	}, "strip", z.ZodTypeAny, {
+		description: string;
+		phase: string;
+	}, {
+		description: string;
+		phase: string;
+	}>, "many">;
+	initialPhase: z.ZodObject<{
+		name: z.ZodString;
+		description: z.ZodString;
+		files: z.ZodArray<z.ZodObject<{
+			path: z.ZodString;
+			purpose: z.ZodString;
+			changes: z.ZodNullable<z.ZodString>;
+		}, "strip", z.ZodTypeAny, {
+			path: string;
+			purpose: string;
+			changes: string | null;
+		}, {
+			path: string;
+			purpose: string;
+			changes: string | null;
+		}>, "many">;
+		lastPhase: z.ZodBoolean;
+	}, "strip", z.ZodTypeAny, {
+		name: string;
+		description: string;
+		files: {
+			path: string;
+			purpose: string;
+			changes: string | null;
+		}[];
+		lastPhase: boolean;
+	}, {
+		name: string;
+		description: string;
+		files: {
+			path: string;
+			purpose: string;
+			changes: string | null;
+		}[];
+		lastPhase: boolean;
+	}>;
+}, "strip", z.ZodTypeAny, {
+	description: string;
+	title: string;
+	projectName: string;
+	colorPalette: string[];
+	frameworks: string[];
+	detailedDescription: string;
+	views: {
+		name: string;
+		description: string;
+	}[];
+	userFlow: {
+		uiLayout: string;
+		uiDesign: string;
+		userJourney: string;
+	};
+	dataFlow: string;
+	architecture: {
+		dataFlow: string;
+	};
+	pitfalls: string[];
+	implementationRoadmap: {
+		description: string;
+		phase: string;
+	}[];
+	initialPhase: {
+		name: string;
+		description: string;
+		files: {
+			path: string;
+			purpose: string;
+			changes: string | null;
+		}[];
+		lastPhase: boolean;
+	};
+}, {
+	description: string;
+	title: string;
+	projectName: string;
+	colorPalette: string[];
+	frameworks: string[];
+	detailedDescription: string;
+	views: {
+		name: string;
+		description: string;
+	}[];
+	userFlow: {
+		uiLayout: string;
+		uiDesign: string;
+		userJourney: string;
+	};
+	dataFlow: string;
+	architecture: {
+		dataFlow: string;
+	};
+	pitfalls: string[];
+	implementationRoadmap: {
+		description: string;
+		phase: string;
+	}[];
+	initialPhase: {
+		name: string;
+		description: string;
+		files: {
+			path: string;
+			purpose: string;
+			changes: string | null;
+		}[];
+		lastPhase: boolean;
+	};
+}>;
+declare const AgenticBlueprintSchema: z.ZodObject<{
+	title: z.ZodString;
+	projectName: z.ZodString;
+	description: z.ZodString;
+	colorPalette: z.ZodArray<z.ZodString, "many">;
+	frameworks: z.ZodArray<z.ZodString, "many">;
+} & {
+	plan: z.ZodArray<z.ZodString, "many">;
+}, "strip", z.ZodTypeAny, {
+	description: string;
+	title: string;
+	projectName: string;
+	colorPalette: string[];
+	frameworks: string[];
+	plan: string[];
+}, {
+	description: string;
+	title: string;
+	projectName: string;
+	colorPalette: string[];
+	frameworks: string[];
+	plan: string[];
+}>;
+type PhasicBlueprint = z.infer<typeof PhasicBlueprintSchema>;
+type AgenticBlueprint = z.infer<typeof AgenticBlueprintSchema>;
+type FileConceptType = z.infer<typeof FileConceptSchema>;
+type PhaseConceptType = z.infer<typeof PhaseConceptSchema>;
+type FileOutputType = z.infer<typeof FileOutputSchema>;
+type CodeReviewOutputType = z.infer<typeof CodeReviewOutput>;
+type Blueprint = z.infer<typeof PhasicBlueprintSchema> | z.infer<typeof AgenticBlueprintSchema>;
+type InferenceMetadata = {
+	agentId: string;
+	userId: string;
+};
+type CredentialsPayload = {
+	providers?: Record<string, {
+		apiKey: string;
+	}>;
+	aiGateway?: {
+		baseUrl: string;
+		token: string;
+	};
+};
+interface FileTreeNode {
+	path: string;
+	type: "file" | "directory";
+	children?: FileTreeNode[];
+}
+declare const RuntimeErrorSchema: z.ZodObject<{
+	timestamp: z.ZodString;
+	level: z.ZodNumber;
+	message: z.ZodString;
+	rawOutput: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+	message: string;
+	timestamp: string;
+	level: number;
+	rawOutput: string;
+}, {
+	message: string;
+	timestamp: string;
+	level: number;
+	rawOutput: string;
+}>;
+type RuntimeError = z.infer<typeof RuntimeErrorSchema>;
+declare const TemplateDetailsSchema: z.ZodObject<{
+	name: z.ZodString;
+	language: z.ZodOptional<z.ZodString>;
+	frameworks: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+	projectType: z.ZodDefault<z.ZodEnum<[
+		"app",
+		"workflow",
+		"presentation",
+		"general"
+	]>>;
+	description: z.ZodObject<{
+		selection: z.ZodString;
+		usage: z.ZodString;
+	}, "strip", z.ZodTypeAny, {
+		selection: string;
+		usage: string;
+	}, {
+		selection: string;
+		usage: string;
+	}>;
+	renderMode: z.ZodOptional<z.ZodEnum<[
+		"sandbox",
+		"browser"
+	]>>;
+	slideDirectory: z.ZodOptional<z.ZodString>;
+	disabled: z.ZodBoolean;
+} & {
+	fileTree: z.ZodType<FileTreeNode, z.ZodTypeDef, FileTreeNode>;
+	allFiles: z.ZodRecord<z.ZodString, z.ZodString>;
+	deps: z.ZodRecord<z.ZodString, z.ZodString>;
+	importantFiles: z.ZodArray<z.ZodString, "many">;
+	dontTouchFiles: z.ZodArray<z.ZodString, "many">;
+	redactedFiles: z.ZodArray<z.ZodString, "many">;
+}, "strip", z.ZodTypeAny, {
+	projectType: "app" | "workflow" | "presentation" | "general";
+	name: string;
+	description: {
+		selection: string;
+		usage: string;
+	};
+	disabled: boolean;
+	fileTree: FileTreeNode;
+	allFiles: Record<string, string>;
+	deps: Record<string, string>;
+	importantFiles: string[];
+	dontTouchFiles: string[];
+	redactedFiles: string[];
+	frameworks?: string[] | undefined;
+	language?: string | undefined;
+	renderMode?: "sandbox" | "browser" | undefined;
+	slideDirectory?: string | undefined;
+}, {
+	name: string;
+	description: {
+		selection: string;
+		usage: string;
+	};
+	disabled: boolean;
+	fileTree: FileTreeNode;
+	allFiles: Record<string, string>;
+	deps: Record<string, string>;
+	importantFiles: string[];
+	dontTouchFiles: string[];
+	redactedFiles: string[];
+	projectType?: "app" | "workflow" | "presentation" | "general" | undefined;
+	frameworks?: string[] | undefined;
+	language?: string | undefined;
+	renderMode?: "sandbox" | "browser" | undefined;
+	slideDirectory?: string | undefined;
+}>;
+export type TemplateDetails = z.infer<typeof TemplateDetailsSchema>;
+declare const PreviewSchema: z.ZodObject<{
+	runId: z.ZodOptional<z.ZodString>;
+	previewURL: z.ZodOptional<z.ZodString>;
+	tunnelURL: z.ZodOptional<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+	runId?: string | undefined;
+	previewURL?: string | undefined;
+	tunnelURL?: string | undefined;
+}, {
+	runId?: string | undefined;
+	previewURL?: string | undefined;
+	tunnelURL?: string | undefined;
+}>;
+type PreviewType = z.infer<typeof PreviewSchema>;
+declare const CodeIssueSchema: z.ZodObject<{
+	message: z.ZodString;
+	filePath: z.ZodString;
+	line: z.ZodNumber;
+	column: z.ZodOptional<z.ZodNumber>;
+	severity: z.ZodEnum<[
+		"error",
+		"warning",
+		"info"
+	]>;
+	ruleId: z.ZodOptional<z.ZodString>;
+	source: z.ZodOptional<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+	message: string;
+	filePath: string;
+	line: number;
+	severity: "error" | "warning" | "info";
+	source?: string | undefined;
+	column?: number | undefined;
+	ruleId?: string | undefined;
+}, {
+	message: string;
+	filePath: string;
+	line: number;
+	severity: "error" | "warning" | "info";
+	source?: string | undefined;
+	column?: number | undefined;
+	ruleId?: string | undefined;
+}>;
+type CodeIssue = z.infer<typeof CodeIssueSchema>;
+declare const StaticAnalysisResponseSchema: z.ZodObject<{
+	success: z.ZodBoolean;
+	lint: z.ZodObject<{
+		issues: z.ZodArray<z.ZodObject<{
+			message: z.ZodString;
+			filePath: z.ZodString;
+			line: z.ZodNumber;
+			column: z.ZodOptional<z.ZodNumber>;
+			severity: z.ZodEnum<[
+				"error",
+				"warning",
+				"info"
+			]>;
+			ruleId: z.ZodOptional<z.ZodString>;
+			source: z.ZodOptional<z.ZodString>;
+		}, "strip", z.ZodTypeAny, {
+			message: string;
+			filePath: string;
+			line: number;
+			severity: "error" | "warning" | "info";
+			source?: string | undefined;
+			column?: number | undefined;
+			ruleId?: string | undefined;
+		}, {
+			message: string;
+			filePath: string;
+			line: number;
+			severity: "error" | "warning" | "info";
+			source?: string | undefined;
+			column?: number | undefined;
+			ruleId?: string | undefined;
+		}>, "many">;
+		summary: z.ZodOptional<z.ZodObject<{
+			errorCount: z.ZodNumber;
+			warningCount: z.ZodNumber;
+			infoCount: z.ZodNumber;
+		}, "strip", z.ZodTypeAny, {
+			errorCount: number;
+			warningCount: number;
+			infoCount: number;
+		}, {
+			errorCount: number;
+			warningCount: number;
+			infoCount: number;
+		}>>;
+		rawOutput: z.ZodOptional<z.ZodString>;
+	}, "strip", z.ZodTypeAny, {
+		issues: {
+			message: string;
+			filePath: string;
+			line: number;
+			severity: "error" | "warning" | "info";
+			source?: string | undefined;
+			column?: number | undefined;
+			ruleId?: string | undefined;
+		}[];
+		rawOutput?: string | undefined;
+		summary?: {
+			errorCount: number;
+			warningCount: number;
+			infoCount: number;
+		} | undefined;
+	}, {
+		issues: {
+			message: string;
+			filePath: string;
+			line: number;
+			severity: "error" | "warning" | "info";
+			source?: string | undefined;
+			column?: number | undefined;
+			ruleId?: string | undefined;
+		}[];
+		rawOutput?: string | undefined;
+		summary?: {
+			errorCount: number;
+			warningCount: number;
+			infoCount: number;
+		} | undefined;
+	}>;
+	typecheck: z.ZodObject<{
+		issues: z.ZodArray<z.ZodObject<{
+			message: z.ZodString;
+			filePath: z.ZodString;
+			line: z.ZodNumber;
+			column: z.ZodOptional<z.ZodNumber>;
+			severity: z.ZodEnum<[
+				"error",
+				"warning",
+				"info"
+			]>;
+			ruleId: z.ZodOptional<z.ZodString>;
+			source: z.ZodOptional<z.ZodString>;
+		}, "strip", z.ZodTypeAny, {
+			message: string;
+			filePath: string;
+			line: number;
+			severity: "error" | "warning" | "info";
+			source?: string | undefined;
+			column?: number | undefined;
+			ruleId?: string | undefined;
+		}, {
+			message: string;
+			filePath: string;
+			line: number;
+			severity: "error" | "warning" | "info";
+			source?: string | undefined;
+			column?: number | undefined;
+			ruleId?: string | undefined;
+		}>, "many">;
+		summary: z.ZodOptional<z.ZodObject<{
+			errorCount: z.ZodNumber;
+			warningCount: z.ZodNumber;
+			infoCount: z.ZodNumber;
+		}, "strip", z.ZodTypeAny, {
+			errorCount: number;
+			warningCount: number;
+			infoCount: number;
+		}, {
+			errorCount: number;
+			warningCount: number;
+			infoCount: number;
+		}>>;
+		rawOutput: z.ZodOptional<z.ZodString>;
+	}, "strip", z.ZodTypeAny, {
+		issues: {
+			message: string;
+			filePath: string;
+			line: number;
+			severity: "error" | "warning" | "info";
+			source?: string | undefined;
+			column?: number | undefined;
+			ruleId?: string | undefined;
+		}[];
+		rawOutput?: string | undefined;
+		summary?: {
+			errorCount: number;
+			warningCount: number;
+			infoCount: number;
+		} | undefined;
+	}, {
+		issues: {
+			message: string;
+			filePath: string;
+			line: number;
+			severity: "error" | "warning" | "info";
+			source?: string | undefined;
+			column?: number | undefined;
+			ruleId?: string | undefined;
+		}[];
+		rawOutput?: string | undefined;
+		summary?: {
+			errorCount: number;
+			warningCount: number;
+			infoCount: number;
+		} | undefined;
+	}>;
+	error: z.ZodOptional<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+	success: boolean;
+	lint: {
+		issues: {
+			message: string;
+			filePath: string;
+			line: number;
+			severity: "error" | "warning" | "info";
+			source?: string | undefined;
+			column?: number | undefined;
+			ruleId?: string | undefined;
+		}[];
+		rawOutput?: string | undefined;
+		summary?: {
+			errorCount: number;
+			warningCount: number;
+			infoCount: number;
+		} | undefined;
+	};
+	typecheck: {
+		issues: {
+			message: string;
+			filePath: string;
+			line: number;
+			severity: "error" | "warning" | "info";
+			source?: string | undefined;
+			column?: number | undefined;
+			ruleId?: string | undefined;
+		}[];
+		rawOutput?: string | undefined;
+		summary?: {
+			errorCount: number;
+			warningCount: number;
+			infoCount: number;
+		} | undefined;
+	};
+	error?: string | undefined;
+}, {
+	success: boolean;
+	lint: {
+		issues: {
+			message: string;
+			filePath: string;
+			line: number;
+			severity: "error" | "warning" | "info";
+			source?: string | undefined;
+			column?: number | undefined;
+			ruleId?: string | undefined;
+		}[];
+		rawOutput?: string | undefined;
+		summary?: {
+			errorCount: number;
+			warningCount: number;
+			infoCount: number;
+		} | undefined;
+	};
+	typecheck: {
+		issues: {
+			message: string;
+			filePath: string;
+			line: number;
+			severity: "error" | "warning" | "info";
+			source?: string | undefined;
+			column?: number | undefined;
+			ruleId?: string | undefined;
+		}[];
+		rawOutput?: string | undefined;
+		summary?: {
+			errorCount: number;
+			warningCount: number;
+			infoCount: number;
+		} | undefined;
+	};
+	error?: string | undefined;
+}>;
+type StaticAnalysisResponse = z.infer<typeof StaticAnalysisResponseSchema>;
+type MessageRole = "system" | "user" | "assistant" | "function" | "tool";
+type TextContent = {
+	type: "text";
+	text: string;
+};
+type ImageContent = {
+	type: "image_url";
+	image_url: {
+		url: string;
+		detail?: "auto" | "low" | "high";
+	};
+};
+type MessageContent = string | (TextContent | ImageContent)[] | null;
+type ToolCall = {
+	id: string;
+	type: "function";
+	function: {
+		name: string;
+		arguments: string;
+	};
+};
+type Message = {
+	role: MessageRole;
+	content: MessageContent;
+	name?: string;
+	tool_calls?: ToolCall[];
+	tool_call_id?: string;
+};
+interface ConversationMessage extends Message {
+	conversationId: string;
+}
+interface ConversationState {
+	id: string;
+	runningHistory: ConversationMessage[];
+	fullHistory: ConversationMessage[];
+}
+declare const SUPPORTED_IMAGE_MIME_TYPES: readonly [
+	"image/png",
+	"image/jpeg",
+	"image/webp"
+];
+type SupportedImageMimeType = typeof SUPPORTED_IMAGE_MIME_TYPES[number];
+interface ImageAttachment {
+	/** Unique identifier for this attachment */
+	id: string;
+	/** Original filename */
+	filename: string;
+	/** MIME type of the image */
+	mimeType: SupportedImageMimeType;
+	/** Base64-encoded image data (without data URL prefix) */
+	base64Data: string;
+	/** Size of the original file in bytes */
+	size?: number;
+	/** Optional dimensions if available */
+	dimensions?: {
+		width: number;
+		height: number;
+	};
+}
+type BehaviorType = "phasic" | "agentic";
+type ProjectType = "app" | "workflow" | "presentation" | "general";
+type Plan = string;
+interface AllIssues {
+	runtimeErrors: RuntimeError[];
+	staticAnalysis: StaticAnalysisResponse;
+}
+interface FileState extends FileOutputType {
+	lastDiff: string;
+}
+interface FileServingToken {
+	token: string;
+	createdAt: number;
+}
+interface PhaseState extends PhaseConceptType {
+	completed: boolean;
+}
+declare enum CurrentDevState {
+	IDLE = 0,
+	PHASE_GENERATING = 1,
+	PHASE_IMPLEMENTING = 2,
+	REVIEWING = 3,
+	FINALIZING = 4
+}
+interface BaseProjectState {
+	behaviorType: BehaviorType;
+	projectType: ProjectType;
+	projectName: string;
+	query: string;
+	sessionId: string;
+	hostname: string;
+	blueprint: Blueprint;
+	templateName: string | "custom";
+	readonly metadata: InferenceMetadata;
+	shouldBeGenerating: boolean;
+	generatedFilesMap: Record<string, FileState>;
+	sandboxInstanceId?: string;
+	fileServingToken?: FileServingToken;
+	commandsHistory?: string[];
+	lastPackageJson?: string;
+	pendingUserInputs: string[];
+	projectUpdatesAccumulator: string[];
+	lastDeepDebugTranscript: string | null;
+	mvpGenerated: boolean;
+	reviewingInitiated: boolean;
+}
+interface PhasicState extends BaseProjectState {
+	behaviorType: "phasic";
+	blueprint: PhasicBlueprint;
+	generatedPhases: PhaseState[];
+	phasesCounter: number;
+	currentDevState: CurrentDevState;
+	reviewCycles?: number;
+	currentPhase?: PhaseConceptType;
+}
+interface AgenticState extends BaseProjectState {
+	behaviorType: "agentic";
+	blueprint: AgenticBlueprint;
+	currentPlan: Plan;
+}
+export type AgentState = PhasicState | AgenticState;
+interface FileObject {
+	filePath: string;
+	fileContents: string;
+}
+interface FixedIssue {
+	/** TypeScript error code (e.g., 'TS2307') */
+	issueCode: string;
+	/** File path where the issue was located */
+	filePath: string;
+	/** Line number of the issue */
+	line: number;
+	/** Column number of the issue (optional) */
+	column?: number;
+	/** Original error message from TypeScript */
+	originalMessage: string;
+	/** Description of the fix that was applied */
+	fixApplied: string;
+	/** Type of fix that was applied */
+	fixType: "import_fix" | "export_fix" | "stub_creation" | "declaration_fix";
+}
+interface UnfixableIssue {
+	/** TypeScript error code (e.g., 'TS2307') */
+	issueCode: string;
+	/** File path where the issue was located */
+	filePath: string;
+	/** Line number of the issue */
+	line: number;
+	/** Column number of the issue (optional) */
+	column?: number;
+	/** Original error message from TypeScript */
+	originalMessage: string;
+	/** Reason why the issue could not be fixed */
+	reason: string;
+}
+interface CodeFixResult {
+	/** Issues that were successfully fixed */
+	fixedIssues: FixedIssue[];
+	/** Issues that could not be fixed automatically */
+	unfixableIssues: UnfixableIssue[];
+	/** Files that were modified with fixes applied */
+	modifiedFiles: FileObject[];
+	/** New files that were created (e.g., stubs) */
+	newFiles?: FileObject[];
+}
+declare class IssueReport {
+	readonly runtimeErrors: RuntimeError[];
+	readonly staticAnalysis: StaticAnalysisResponse;
+	constructor(runtimeErrors: RuntimeError[], staticAnalysis: StaticAnalysisResponse);
+	/**
+	 * Create report from all issues
+	 */
+	static from(issues: AllIssues): IssueReport;
+	/**
+	 * Check if there are any issues
+	 */
+	hasIssues(): boolean;
+	/**
+	 * Check if there are runtime errors
+	 */
+	hasRuntimeErrors(): boolean;
+	/**
+	 * Check if there are static analysis issues
+	 */
+	hasStaticAnalysisIssues(): boolean;
+	/**
+	 * Get total issue count
+	 */
+	getTotalIssueCount(): number;
+	/**
+	 * Get a summary of all issues
+	 */
+	getSummary(): string;
+	/**
+	 * Create an empty issue report
+	 */
+	static empty(): IssueReport;
+}
+declare enum RateLimitType {
+	API_RATE_LIMIT = "apiRateLimit",
+	AUTH_RATE_LIMIT = "authRateLimit",
+	APP_CREATION = "appCreation",
+	LLM_CALLS = "llmCalls"
+}
+interface RateLimitError {
+	message: string;
+	limitType: RateLimitType;
+	limit?: number;
+	period?: number;
+	suggestions?: string[];
+}
+declare enum SecurityErrorType {
+	UNAUTHORIZED = "UNAUTHORIZED",
+	FORBIDDEN = "FORBIDDEN",
+	INVALID_TOKEN = "INVALID_TOKEN",
+	TOKEN_EXPIRED = "TOKEN_EXPIRED",
+	RATE_LIMITED = "RATE_LIMITED",
+	INVALID_INPUT = "INVALID_INPUT",
+	CSRF_VIOLATION = "CSRF_VIOLATION"
+}
+declare class SecurityError extends Error {
+	type: SecurityErrorType;
+	statusCode: number;
+	constructor(type: SecurityErrorType, message: string, statusCode?: number);
+}
+declare class RateLimitExceededError extends SecurityError {
+	limitType: RateLimitType;
+	limit?: number | undefined;
+	period?: number | undefined;
+	suggestions?: string[] | undefined;
+	details: RateLimitError;
+	constructor(message: string, limitType: RateLimitType, limit?: number | undefined, period?: number | undefined, suggestions?: string[] | undefined);
+	static fromRateLimitError(error: RateLimitError): RateLimitExceededError;
+}
+type ErrorMessage = {
+	type: "error";
+	error: string;
+};
+type StateMessage = {
+	type: "cf_agent_state";
+	state: AgentState;
+};
+type AgentConnectedMessage = {
+	type: "agent_connected";
+	state: AgentState;
+	templateDetails: TemplateDetails;
+	previewUrl?: string;
+};
+type TemplateUpdatedMessage = {
+	type: "template_updated";
+	templateDetails: TemplateDetails;
+};
+type ConversationStateMessage = {
+	type: "conversation_state";
+	state: ConversationState;
+	deepDebugSession?: {
+		conversationId: string;
+	} | null;
+};
+type RateLimitErrorMessage = {
+	type: "rate_limit_error";
+	error: RateLimitExceededError;
+};
+type GenerationStartedMessage = {
+	type: "generation_started";
+	message: string;
+	totalFiles: number;
+};
+type FileGeneratingMessage = {
+	type: "file_generating";
+	filePath: string;
+	filePurpose: string;
+};
+type FileRegeneratingMessage = {
+	type: "file_regenerating";
+	filePath: string;
+	original_issues?: string;
+};
+type FileChunkGeneratedMessage = {
+	type: "file_chunk_generated";
+	filePath: string;
+	chunk: string;
+};
+type FileGeneratedMessage = {
+	type: "file_generated";
+	file: FileOutputType;
+};
+type FileRegeneratedMessage = {
+	type: "file_regenerated";
+	file: FileOutputType;
+	original_issues: string;
+};
+type GenerationCompleteMessage = {
+	type: "generation_complete";
+	instanceId?: string;
+	previewURL?: string;
+};
+type DeploymentStartedMessage = {
+	type: "deployment_started";
+	message: string;
+	files: {
+		filePath: string;
+	}[];
+};
+type DeploymentFailedMessage = {
+	type: "deployment_failed";
+	error: string;
+};
+type DeploymentCompletedMessage = {
+	type: "deployment_completed";
+	previewURL: string;
+	tunnelURL: string;
+	instanceId: string;
+	message: string;
+};
+type PreviewForceRefreshMessage = {
+	type: "preview_force_refresh";
+};
+type CommandExecutingMessage = {
+	type: "command_executing";
+	message: string;
+	commands: string[];
+};
+type CommandExecutedMessage = {
+	type: "command_executed";
+	message: string;
+	commands: string[];
+	output?: string;
+};
+type CommandExecutionFailedMessage = {
+	type: "command_execution_failed";
+	message: string;
+	commands: string[];
+	error?: string;
+};
+type CodeReviewingMessage = {
+	type: "code_reviewing";
+	message: string;
+	staticAnalysis?: StaticAnalysisResponse;
+	runtimeErrors: RuntimeError[];
+};
+type CodeReviewedMessage = {
+	type: "code_reviewed";
+	message: string;
+	review: CodeReviewOutputType;
+};
+type RuntimeErrorFoundMessage = {
+	type: "runtime_error_found";
+	errors: RuntimeError[];
+	count: number;
+};
+type CodeFixEdits = {
+	type: "code_fix_edits";
+	filePath: string;
+	search: string;
+	replacement: string;
+};
+type StaticAnalysisResults = {
+	type: "static_analysis_results";
+	staticAnalysis: StaticAnalysisResponse;
+};
+type PhaseGeneratingMessage = {
+	type: "phase_generating";
+	message: string;
+	phase?: {
+		name: string;
+		description: string;
+		files: FileConceptType[];
+	};
+	issues?: IssueReport;
+	userSuggestions?: string[];
+};
+type PhaseGeneratedMessage = {
+	type: "phase_generated";
+	message: string;
+	phase: {
+		name: string;
+		description: string;
+		files: FileConceptType[];
+	};
+};
+type PhaseImplementingMessage = {
+	type: "phase_implementing";
+	message: string;
+	phase: {
+		name: string;
+		description: string;
+		files: FileConceptType[];
+	};
+	issues?: IssueReport;
+};
+type PhaseImplementedMessage = {
+	type: "phase_implemented";
+	message: string;
+	phase: {
+		name: string;
+		description: string;
+		files: FileConceptType[];
+	};
+};
+type PhaseValidatingMessage = {
+	type: "phase_validating";
+	message: string;
+	phase: {
+		name: string;
+		description: string;
+		files: FileConceptType[];
+	};
+};
+type PhaseValidatedMessage = {
+	type: "phase_validated";
+	message: string;
+	phase: {
+		name: string;
+		description: string;
+		files: FileConceptType[];
+	};
+};
+type GenerationStoppedMessage = {
+	type: "generation_stopped";
+	message: string;
+	instanceId: string;
+};
+type GenerationResumedMessage = {
+	type: "generation_resumed";
+	message: string;
+	instanceId: string;
+};
+type CloudflareDeploymentStartedMessage = {
+	type: "cloudflare_deployment_started";
+	message: string;
+	instanceId: string;
+};
+type CloudflareDeploymentCompletedMessage = {
+	type: "cloudflare_deployment_completed";
+	message: string;
+	instanceId: string;
+	deploymentUrl: string;
+	workersUrl?: string;
+};
+type CloudflareDeploymentErrorMessage = {
+	type: "cloudflare_deployment_error";
+	message: string;
+	instanceId: string;
+	error: string;
+};
+type ScreenshotCaptureStartedMessage = {
+	type: "screenshot_capture_started";
+	message: string;
+	url: string;
+	viewport: {
+		width: number;
+		height: number;
+	};
+};
+type ScreenshotCaptureSuccessMessage = {
+	type: "screenshot_capture_success";
+	message: string;
+	url: string;
+	viewport: {
+		width: number;
+		height: number;
+	};
+	screenshotSize: number;
+	timestamp: string;
+};
+type ScreenshotCaptureErrorMessage = {
+	type: "screenshot_capture_error";
+	error: string;
+	url: string;
+	viewport: {
+		width: number;
+		height: number;
+	};
+	statusCode?: number;
+	statusText?: string;
+	apiResponse?: unknown;
+	screenshotCaptured?: boolean;
+	databaseError?: boolean;
+	configurationError?: boolean;
+};
+type ScreenshotAnalysisResultMessage = {
+	type: "screenshot_analysis_result";
+	message: string;
+	analysis: {
+		hasIssues: boolean;
+		issues: string[];
+		suggestions: string[];
+		uiCompliance: {
+			matchesBlueprint: boolean;
+			deviations: string[];
+		};
+	};
+};
+type GitHubExportStartedMessage = {
+	type: "github_export_started";
+	message: string;
+	repositoryName: string;
+	isPrivate: boolean;
+};
+type GitHubExportProgressMessage = {
+	type: "github_export_progress";
+	message: string;
+	step: "creating_repository" | "uploading_files" | "finalizing";
+	progress: number;
+};
+type GitHubExportCompletedMessage = {
+	type: "github_export_completed";
+	message: string;
+	repositoryUrl: string;
+};
+type GitHubExportErrorMessage = {
+	type: "github_export_error";
+	message: string;
+	error: string;
+};
+type UserSuggestionsProcessingMessage = {
+	type: "user_suggestions_processing";
+	message: string;
+	suggestions: string[];
+};
+type ConversationResponseMessage = {
+	type: "conversation_response";
+	message: string;
+	conversationId?: string;
+	enhancedRequest?: string;
+	pendingInputsCount?: number;
+	isStreaming?: boolean;
+	tool?: {
+		name: string;
+		status: "start" | "success" | "error";
+		args?: Record<string, unknown>;
+		result?: string;
+	};
+};
+type ConversationClearedMessage = {
+	type: "conversation_cleared";
+	message: string;
+	clearedMessageCount: number;
+};
+type ProjectNameUpdatedMessage = {
+	type: "project_name_updated";
+	message: string;
+	projectName: string;
+};
+type BlueprintUpdatedMessage = {
+	type: "blueprint_updated";
+	message: string;
+	updatedKeys: string[];
+};
+type BlueprintChunkMessage = {
+	type: "blueprint_chunk";
+	chunk: string;
+};
+type DeterministicCodeFixStartedMessage = {
+	type: "deterministic_code_fix_started";
+	message: string;
+	issues: CodeIssue[];
+};
+type DeterministicCodeFixCompletedMessage = {
+	type: "deterministic_code_fix_completed";
+	message: string;
+	fixResult: CodeFixResult;
+	issues: CodeIssue[];
+};
+type ModelConfigsInfoMessage = {
+	type: "model_configs_info";
+	message: string;
+	configs: {
+		agents: Array<{
+			key: string;
+			name: string;
+			description: string;
+			constraint?: {
+				enabled: boolean;
+				allowedModels: string[];
+			};
+		}>;
+		userConfigs: Record<string, {
+			name?: string;
+			max_tokens?: number;
+			temperature?: number;
+			reasoning_effort?: string;
+			fallbackModel?: string;
+			isUserOverride?: boolean;
+		}>;
+		defaultConfigs: Record<string, {
+			name?: string;
+			max_tokens?: number;
+			temperature?: number;
+			reasoning_effort?: string;
+			fallbackModel?: string;
+		}>;
+	};
+};
+type TerminalCommandMessage = {
+	type: "terminal_command";
+	command: string;
+	timestamp: number;
+};
+type TerminalOutputMessage = {
+	type: "terminal_output";
+	output: string;
+	outputType: "stdout" | "stderr" | "info";
+	timestamp: number;
+};
+type ServerLogMessage = {
+	type: "server_log";
+	message: string;
+	level: "info" | "warn" | "error" | "debug";
+	timestamp: number;
+	source?: string;
+};
+type VaultUnlockedMessage = {
+	type: "vault_unlocked";
+};
+type VaultLockedMessage = {
+	type: "vault_locked";
+};
+type VaultRequiredMessage = {
+	type: "vault_required";
+	reason: string;
+	provider?: string;
+	envVarName?: string;
+	secretId?: string;
+};
+export type WebSocketMessage = StateMessage | AgentConnectedMessage | TemplateUpdatedMessage | ConversationStateMessage | GenerationStartedMessage | FileGeneratingMessage | FileRegeneratingMessage | FileChunkGeneratedMessage | FileGeneratedMessage | FileRegeneratedMessage | GenerationCompleteMessage | DeploymentStartedMessage | DeploymentCompletedMessage | DeploymentFailedMessage | PreviewForceRefreshMessage | CodeReviewingMessage | CodeReviewedMessage | CommandExecutingMessage | CommandExecutedMessage | CommandExecutionFailedMessage | RuntimeErrorFoundMessage | CodeFixEdits | StaticAnalysisResults | PhaseGeneratingMessage | PhaseGeneratedMessage | PhaseImplementingMessage | PhaseImplementedMessage | PhaseValidatingMessage | PhaseValidatedMessage | GenerationStoppedMessage | GenerationResumedMessage | CloudflareDeploymentStartedMessage | CloudflareDeploymentCompletedMessage | CloudflareDeploymentErrorMessage | ScreenshotCaptureStartedMessage | ScreenshotCaptureSuccessMessage | ScreenshotCaptureErrorMessage | ScreenshotAnalysisResultMessage | GitHubExportStartedMessage | GitHubExportProgressMessage | GitHubExportCompletedMessage | GitHubExportErrorMessage | ErrorMessage | RateLimitErrorMessage | UserSuggestionsProcessingMessage | ConversationResponseMessage | ConversationClearedMessage | ProjectNameUpdatedMessage | BlueprintUpdatedMessage | BlueprintChunkMessage | DeterministicCodeFixStartedMessage | DeterministicCodeFixCompletedMessage | ModelConfigsInfoMessage | TerminalCommandMessage | TerminalOutputMessage | ServerLogMessage | VaultUnlockedMessage | VaultLockedMessage | VaultRequiredMessage;
+type WebSocketMessageType = WebSocketMessage["type"];
+type WebSocketMessagePayload<T extends WebSocketMessageType> = Extract<WebSocketMessage, {
+	type: T;
+}>;
+export type WebSocketMessageData<T extends WebSocketMessageType> = Omit<WebSocketMessagePayload<T>, "type">;
+interface CodeGenArgs {
+	query: string;
+	language?: string;
+	frameworks?: string[];
+	selectedTemplate?: string;
+	behaviorType?: BehaviorType;
+	projectType?: ProjectType;
+	images?: ImageAttachment[];
+	/** Optional ephemeral credentials (BYOK / gateway override) for sdk */
+	credentials?: CredentialsPayload;
+}
+/**
+ * Data structure for connectToExistingAgent response
+ */
+export interface AgentConnectionData {
+	websocketUrl: string;
+	agentId: string;
+}
+export type AgentPreviewResponse = PreviewType;
+type BehaviorType$1 = BehaviorType;
+type ProjectType$1 = ProjectType;
+export type Credentials = NonNullable<CodeGenArgs["credentials"]>;
+type CodeGenArgs$1 = CodeGenArgs;
+export type BuildOptions = Omit<CodeGenArgs$1, "query"> & {
+	/**
+	 * If true (default), connect to the agent websocket immediately.
+	 */
+	autoConnect?: boolean;
+	/**
+	 * If true (default), send `{ type: 'generate_all' }` after websocket connection.
+	 */
+	autoGenerate?: boolean;
+	/**
+	 * Called for each blueprint chunk emitted by the create-agent stream.
+	 */
+	onBlueprintChunk?: (chunk: string) => void;
+};
+export type BuildStartEvent = {
+	message?: string;
+	agentId: string;
+	websocketUrl: string;
+	httpStatusUrl?: string;
+	behaviorType?: BehaviorType$1;
+	projectType?: string;
+	template?: {
+		name: string;
+		files?: unknown;
+	};
+};
+export type ApiResponse<T> = {
+	success: true;
+	data: T;
+	message?: string;
+} | {
+	success: false;
+	error: {
+		message: string;
+	};
+	message?: string;
+};
+export type PublicAppsQuery = {
+	limit?: number;
+	page?: number;
+	sort?: string;
+	order?: string;
+	period?: string;
+	framework?: string;
+	search?: string;
+};
+export type AppListItem = {
+	id: string;
+	title: string;
+	description?: string | null;
+	framework?: string | null;
+	updatedAt?: string | null;
+	createdAt?: string | null;
+	visibility?: "public" | "private";
+	previewUrl?: string;
+};
+export type AppDetails = Record<string, unknown> & {
+	id: string;
+	previewUrl?: string;
+	cloudflareUrl?: string;
+};
+type AgentWsServerMessage = WebSocketMessage;
+type AgentWsClientMessage = {
+	type: "session_init";
+	credentials: Credentials;
+} | {
+	type: "generate_all";
+} | {
+	type: "stop_generation";
+} | {
+	type: "resume_generation";
+} | {
+	type: "preview";
+} | {
+	type: "deploy";
+} | {
+	type: "get_conversation_state";
+} | {
+	type: "clear_conversation";
+} | {
+	type: "user_suggestion";
+	message: string;
+	images?: unknown[];
+};
+export type AgentWebSocketMessage = AgentWsServerMessage | AgentWsClientMessage;
+type WsMessageOf<TType extends AgentWsServerMessage["type"]> = Extract<AgentWsServerMessage, {
+	type: TType;
+}>;
+export type AgentEventMap = {
+	"ws:open": undefined;
+	"ws:close": {
+		code: number;
+		reason: string;
+	};
+	"ws:error": {
+		error: unknown;
+	};
+	/** Raw server->client message */
+	"ws:message": AgentWsServerMessage;
+	connected: WsMessageOf<"agent_connected">;
+	conversation: WsMessageOf<"conversation_response" | "conversation_state">;
+	phase: WsMessageOf<"phase_generating" | "phase_generated" | "phase_implementing" | "phase_implemented" | "phase_validating" | "phase_validated">;
+	file: WsMessageOf<"file_chunk_generated" | "file_generated" | "file_generating" | "file_regenerating" | "file_regenerated">;
+	preview: WsMessageOf<"deployment_completed" | "deployment_started" | "deployment_failed">;
+	/** User-friendly error derived from `{ type: 'error' }` message */
+	error: {
+		error: string;
+	};
+};
+type WebSocketLike = {
+	send: (data: string) => void;
+	close: () => void;
+	addEventListener?: (type: "open" | "close" | "error" | "message", listener: (event: unknown) => void) => void;
+	on?: (type: string, listener: (...args: unknown[]) => void) => void;
+};
+export type AgentConnectionOptions = {
+	/** Override Origin header for WS (browser-like security). */
+	origin?: string;
+	/** Optional per-connection ephemeral credentials (used by `session_init`). */
+	credentials?: Credentials;
+	/** Additional headers (Node/Bun via ws factory). */
+	headers?: Record<string, string>;
+	/** Optional WebSocket factory for Node/Bun runtimes. */
+	webSocketFactory?: (url: string, protocols?: string | string[], headers?: Record<string, string>) => WebSocketLike;
+};
+export type AgentConnection = {
+	send: (msg: AgentWsClientMessage) => void;
+	close: () => void;
+	on: <K extends keyof AgentEventMap>(event: K, cb: (payload: AgentEventMap[K]) => void) => () => void;
+	onAny: (cb: (event: keyof AgentEventMap, payload: AgentEventMap[keyof AgentEventMap]) => void) => () => void;
+	waitFor: <K extends keyof AgentEventMap>(event: K, predicate?: (payload: AgentEventMap[K]) => boolean, timeoutMs?: number) => Promise<AgentEventMap[K]>;
+};
+export type VibeClientOptions = {
+	baseUrl: string;
+	/**
+	 * Current platform requirement: JWT access token. In future this will be minted from `apiKey`.
+	 */
+	token?: string;
+	/** Future: VibeSDK API key. */
+	apiKey?: string;
+	defaultHeaders?: Record<string, string>;
+	/** Used as Origin header for WS (optional but often required). */
+	websocketOrigin?: string;
+	/** Optional WebSocket factory for Node/Bun runtimes. */
+	webSocketFactory?: AgentConnectionOptions["webSocketFactory"];
+	fetchFn?: typeof fetch;
+};
+type WaitUntilReadyOptions = {
+	timeoutMs?: number;
+};
+type BuildSessionInit = {
+	getAuthToken?: () => string | undefined;
+	defaultCredentials?: Credentials;
+};
+export declare class BuildSession {
+	private clientOptions;
+	private init;
+	readonly agentId: string;
+	readonly websocketUrl: string;
+	readonly behaviorType: BehaviorType$1 | undefined;
+	readonly projectType: ProjectType$1 | string | undefined;
+	private connection;
+	constructor(clientOptions: VibeClientOptions, start: BuildStartEvent, init?: BuildSessionInit);
+	isConnected(): boolean;
+	connect(options?: AgentConnectionOptions): AgentConnection;
+	startGeneration(): void;
+	stop(): void;
+	followUp(message: string, options?: {
+		images?: unknown[];
+	}): void;
+	requestConversationState(): void;
+	deployPreview(): void;
+	deployCloudflare(): void;
+	waitUntilReady(options?: WaitUntilReadyOptions): Promise<void>;
+	on: AgentConnection["on"];
+	onAny: AgentConnection["onAny"];
+	onMessageType<TType extends AgentWsServerMessage["type"]>(type: TType, cb: (message: WsMessageOf<TType>) => void): () => void;
+	waitForMessageType<TType extends AgentWsServerMessage["type"]>(type: TType, timeoutMs?: number): Promise<WsMessageOf<TType>>;
+	close(): void;
+	private assertConnected;
+}
+export declare class VibeClient {
+	private options;
+	private http;
+	constructor(options: VibeClientOptions);
+	get baseUrl(): string;
+	/**
+	 * Creates a new agent/app from a prompt and returns a BuildSession.
+	 *
+	 * Current platform requirement: `token` must be a valid JWT access token.
+	 * Later: `apiKey` will be exchanged for a short-lived JWT.
+	 */
+	build(prompt: string, options?: BuildOptions): Promise<BuildSession>;
+	/** Connect to an existing agent/app by id. */
+	connect(agentId: string, options?: {
+		credentials?: Credentials;
+	}): Promise<BuildSession>;
+	apps: {
+		listPublic: (query?: PublicAppsQuery) => Promise<ApiResponse<{
+			apps: AppListItem[];
+			pagination?: unknown;
+		}>>;
+		listMine: () => Promise<ApiResponse<{
+			apps: AppListItem[];
+		}>>;
+		get: (appId: string) => Promise<ApiResponse<AppDetails>>;
+		getGitCloneToken: (appId: string) => Promise<ApiResponse<{
+			token: string;
+			expiresIn: number;
+			expiresAt: string;
+			cloneUrl: string;
+		}>>;
+	};
+}
+export declare class AgenticClient extends VibeClient {
+	constructor(options: VibeClientOptions);
+	build(prompt: string, options?: Parameters<VibeClient["build"]>[1]): Promise<BuildSession>;
+}
+export declare class PhasicClient extends VibeClient {
+	constructor(options: VibeClientOptions);
+	build(prompt: string, options?: Parameters<VibeClient["build"]>[1]): Promise<BuildSession>;
+}
+
+export {
+	BehaviorType$1 as BehaviorType,
+	CodeGenArgs$1 as CodeGenArgs,
+	ProjectType$1 as ProjectType,
+};
+
+export {};