@cf-vibesdk/sdk 0.1.0 → 0.1.1

package/README.md

@@ -94,53 +94,6 @@ const session = await client.build('Build a weather dashboard', {
 });
 ```
 
-#### Blueprint Streaming
-
-The server streams blueprint chunks as the AI generates the project plan. By default, `build()` waits for all chunks before returning:
-
-```ts
-// Default behavior: waits for blueprint to complete
-const session = await client.build('Build a todo app', {
-  onBlueprintChunk: (chunk) => {
-    // Called in real-time as chunks arrive
-    blueprintText += chunk;
-  },
-});
-// Session returned after all blueprint chunks received
-```
-
-For faster startup, set `waitForBlueprint: false` to return immediately and stream chunks in the background:
-
-```ts
-const session = await client.build('Build a todo app', {
-  waitForBlueprint: false,  // Return immediately after start event
-  onBlueprintChunk: (chunk) => {
-    // Still called in real-time as chunks arrive
-    blueprintText += chunk;
-  },
-  onBlueprintError: (error) => {
-    // Called if streaming fails (session is auto-closed)
-    console.error('Blueprint streaming failed:', error);
-  },
-});
-// Session returned immediately, blueprint streams in background
-```
-
-Use the `BlueprintStreamParser` utility to convert chunks to readable Markdown:
-
-```ts
-import { BlueprintStreamParser } from '@cf-vibesdk/sdk';
-
-const parser = new BlueprintStreamParser();
-const session = await client.build('Build a todo app', {
-  waitForBlueprint: false,
-  onBlueprintChunk: (chunk) => {
-    const markdown = parser.append(chunk);
-    console.log(markdown);  // Rendered as Markdown
-  },
-});
-```
-
 ### `client.connect(agentId)`
 
 Connect to an existing app session. State is automatically restored from the agent, including:
@@ -369,14 +322,14 @@ session.workspace.onChange((change) => {
 
 ## WebSocket Reliability
 
-Connections automatically reconnect with exponential backoff. The first reconnect attempt is **immediate** (0ms delay) for fast recovery from brief network blips, followed by exponential backoff starting at 200ms.
+Connections automatically reconnect with exponential backoff.
 
 ```ts
 // Custom retry config
 await session.connect({
   retry: {
     enabled: true,        // Default: true
-    initialDelayMs: 200,  // Default: 200 (used from 2nd attempt onward)
+    initialDelayMs: 1000, // Default: 1000
     maxDelayMs: 30000,    // Default: 30000
     maxRetries: 10,       // Default: Infinity
   },
@@ -386,35 +339,6 @@ await session.connect({
 await session.connect({ retry: { enabled: false } });
 ```
 
-### Auto-Preview on Reconnect
-
-When connecting to an **existing app** (via `client.connect()`), the SDK automatically sends a `preview` message on connect and reconnect to ensure the preview deployment stays active:
-
-```ts
-// Existing app - auto-preview is enabled by default
-const session = await client.connect('agent-id');
-await session.connect();  // Sends preview message automatically
-
-// Override for new builds or disable
-await session.connect({ autoRequestPreview: false });
-
-// Force enable for new builds
-const session = await client.build('Build a todo app');
-await session.connect({ autoRequestPreview: true });
-```
-
-### Reconnect Events
-
-```ts
-session.on('ws:reconnecting', ({ attempt, delayMs, reason }) => {
-  console.log(`Reconnecting (attempt ${attempt}, delay ${delayMs}ms, reason: ${reason})`);
-});
-
-session.on('ws:reconnected', () => {
-  console.log('Reconnected successfully');
-});
-```
-
 ## HTTP Retry
 
 HTTP requests automatically retry on 5xx errors.

package/dist/index.d.ts

@@ -271,6 +271,16 @@ declare const AgenticBlueprintSchema: z.ZodObject<{
 	frameworks: z.ZodArray<z.ZodString, "many">;
 } & {
 	plan: z.ZodArray<z.ZodString, "many">;
+	preflightAnswers: z.ZodOptional<z.ZodArray<z.ZodObject<{
+		question: z.ZodString;
+		answer: z.ZodString;
+	}, "strip", z.ZodTypeAny, {
+		question: string;
+		answer: string;
+	}, {
+		question: string;
+		answer: string;
+	}>, "many">>;
 }, "strip", z.ZodTypeAny, {
 	description: string;
 	title: string;
@@ -278,6 +288,10 @@ declare const AgenticBlueprintSchema: z.ZodObject<{
 	colorPalette: string[];
 	frameworks: string[];
 	plan: string[];
+	preflightAnswers?: {
+		question: string;
+		answer: string;
+	}[] | undefined;
 }, {
 	description: string;
 	title: string;
@@ -285,6 +299,10 @@ declare const AgenticBlueprintSchema: z.ZodObject<{
 	colorPalette: string[];
 	frameworks: string[];
 	plan: string[];
+	preflightAnswers?: {
+		question: string;
+		answer: string;
+	}[] | undefined;
 }>;
 type PhasicBlueprint = z.infer<typeof PhasicBlueprintSchema>;
 type AgenticBlueprint = z.infer<typeof AgenticBlueprintSchema>;
@@ -783,6 +801,8 @@ interface BaseProjectState {
 	pendingUserInputs: string[];
 	projectUpdatesAccumulator: string[];
 	lastDeepDebugTranscript: string | null;
+	preflightQuestions?: string;
+	preflightCompleted?: boolean;
 	mvpGenerated: boolean;
 	reviewingInitiated: boolean;
 }
@@ -1145,6 +1165,7 @@ type ScreenshotCaptureSuccessMessage = {
 	};
 	screenshotSize: number;
 	timestamp: string;
+	screenshotUrl?: string;
 };
 type ScreenshotCaptureErrorMessage = {
 	type: "screenshot_capture_error";
@@ -1322,6 +1343,8 @@ interface CodeGenArgs {
 	images?: ImageAttachment[];
 	/** Optional ephemeral credentials (BYOK / gateway override) for sdk */
 	credentials?: CredentialsPayload;
+	/** Optional preflight questions prompt. When provided, the agent asks these questions one-by-one before building and stores answers in the blueprint. */
+	preflightQuestions?: string;
 }
 /**
  * Data structure for connectToExistingAgent response
@@ -2484,7 +2507,7 @@ declare const apps: import("drizzle-orm/sqlite-core").SQLiteTableWithColumns<{
 			tableName: "apps";
 			dataType: "string";
 			columnType: "SQLiteText";
-			data: "private" | "public";
+			data: "public" | "private";
 			driverParam: string;
 			notNull: true;
 			hasDefault: true;
@@ -2572,7 +2595,7 @@ declare const apps: import("drizzle-orm/sqlite-core").SQLiteTableWithColumns<{
 			tableName: "apps";
 			dataType: "string";
 			columnType: "SQLiteText";
-			data: "private" | "public";
+			data: "public" | "private";
 			driverParam: string;
 			notNull: false;
 			hasDefault: false;
@@ -5173,11 +5196,11 @@ type App = {
 	framework: string | null;
 	userId: string | null;
 	sessionToken: string | null;
-	visibility: "private" | "public";
+	visibility: "public" | "private";
 	status: "completed" | "generating";
 	deploymentId: string | null;
 	githubRepositoryUrl: string | null;
-	githubRepositoryVisibility: "private" | "public" | null;
+	githubRepositoryVisibility: "public" | "private" | null;
 	isArchived: boolean | null;
 	isFeatured: boolean | null;
 	version: number | null;
@@ -5453,21 +5476,7 @@ type CodeGenArgs$1 = CodeGenArgs;
 export type BuildOptions = Omit<CodeGenArgs$1, "query"> & {
 	autoConnect?: boolean;
 	autoGenerate?: boolean;
-	/**
-	 * Called for each blueprint chunk as it streams from the server.
-	 */
 	onBlueprintChunk?: (chunk: string) => void;
-	/**
-	 * Called if blueprint streaming fails. The session will be closed automatically.
-	 * Only relevant when `waitForBlueprint` is false.
-	 */
-	onBlueprintError?: (error: Error) => void;
-	/**
-	 * If true (default), `build()` waits for all blueprint chunks before returning.
-	 * If false, `build()` returns immediately after receiving the start event,
-	 * and blueprint chunks stream in the background via `onBlueprintChunk`.
-	 */
-	waitForBlueprint?: boolean;
 };
 type TemplateFiles = Record<string, string>;
 export type BuildStartEvent = {
@@ -5494,11 +5503,11 @@ type App$1 = {
 	framework: string | null;
 	userId: string | null;
 	sessionToken: string | null;
-	visibility: "private" | "public";
+	visibility: "public" | "private";
 	status: "completed" | "generating";
 	deploymentId: string | null;
 	githubRepositoryUrl: string | null;
-	githubRepositoryVisibility: "private" | "public" | null;
+	githubRepositoryVisibility: "public" | "private" | null;
 	isArchived: boolean | null;
 	isFeatured: boolean | null;
 	version: number | null;
@@ -5568,7 +5577,6 @@ export type AgentEventMap = {
 		delayMs: number;
 		reason: "close" | "error";
 	};
-	"ws:reconnected": undefined;
 	"ws:raw": {
 		raw: unknown;
 	};
@@ -5864,19 +5872,12 @@ type WaitUntilReadyOptions = WaitOptions;
 type BuildSessionConnectOptions = Omit<AgentConnectionOptions, "credentials"> & {
 	/** If true (default), send `get_conversation_state` on socket open. */
 	autoRequestConversationState?: boolean;
-	/**
-	 * If true, send `preview` message on connect and reconnect to ensure preview exists.
-	 * Defaults to true for existing apps (via `client.connect()`), false for new builds.
-	 */
-	autoRequestPreview?: boolean;
 	/** Credentials to send via session_init after connection. */
 	credentials?: Credentials;
 };
 type BuildSessionInit = {
 	httpClient: HttpClient;
 	defaultCredentials?: Credentials;
-	/** True if this session is for an existing app (via client.connect). */
-	isExistingApp?: boolean;
 };
 export declare class BuildSession {
 	private init;
@@ -5970,10 +5971,6 @@ export declare class VibeClient {
 	get baseUrl(): string;
 	/**
 	 * Creates a new agent/app from a prompt and returns a BuildSession.
-	 *
-	 * By default, waits for all blueprint chunks before returning. Set
-	 * `waitForBlueprint: false` to return immediately after the start event,
-	 * with blueprint chunks streaming in the background.
 	 */
 	build(prompt: string, options?: BuildOptions): Promise<BuildSession>;
 	/** Connect to an existing agent/app by id. */
@@ -6060,7 +6057,7 @@ export declare class VibeClient {
 			finalPrompt: string | null;
 			framework: string | null;
 			sessionToken: string | null;
-			visibility: "private" | "public";
+			visibility: "public" | "private";
 			githubRepositoryUrl: string | null;
 			githubRepositoryVisibility: string | null;
 			isArchived: string | boolean | null;
@@ -6122,6 +6119,10 @@ type Blueprint$1 = {
 		phase: string;
 		description: string;
 	}>;
+	preflightAnswers?: Array<{
+		question: string;
+		answer: string;
+	}>;
 };
 /**
  * Converts a Blueprint object to readable Markdown.

package/dist/index.js

@@ -409,7 +409,7 @@ class SessionStateStore {
         const m = msg;
         const phaseInfo = extractPhaseInfo(m);
         const phaseFiles = extractPhaseFiles(m);
-        const phases = this.updateOrAddPhase(phaseInfo, "completed", phaseFiles);
+        const phases = this.updateOrAddPhase(phaseInfo, "validating", phaseFiles);
         this.setState({
           phase: { status: "implemented", ...phaseInfo },
           phases
@@ -431,7 +431,7 @@ class SessionStateStore {
         const m = msg;
         const phaseInfo = extractPhaseInfo(m);
         const phaseFiles = extractPhaseFiles(m);
-        const phases = this.updateOrAddPhase(phaseInfo, "validating", phaseFiles);
+        const phases = this.updateOrAddPhase(phaseInfo, "completed", phaseFiles);
         this.setState({
           phase: { status: "validated", ...phaseInfo },
           phases
@@ -618,7 +618,7 @@ async function withTimeout(promise, ms, message = "Operation timed out") {
 // src/ws.ts
 var WS_RETRY_DEFAULTS = {
   enabled: true,
-  initialDelayMs: 200,
+  initialDelayMs: 1000,
   maxDelayMs: 30000,
   maxRetries: Infinity
 };
@@ -630,7 +630,6 @@ function createAgentConnection(getUrl, options = {}) {
   let closedByUser = false;
   let reconnectAttempts = 0;
   let reconnectTimer = null;
-  let hasConnectedBefore = false;
   const pendingSends = [];
   const maxPendingSends = 1000;
   function clearReconnectTimer() {
@@ -656,34 +655,22 @@ function createAgentConnection(getUrl, options = {}) {
       return;
     if (reconnectTimer)
       return;
-    const delayMs = reconnectAttempts === 0 ? 0 : computeBackoffMs(reconnectAttempts, retryCfg);
+    const delayMs = computeBackoffMs(reconnectAttempts, retryCfg);
     emitter.emit("ws:reconnecting", {
       attempt: reconnectAttempts + 1,
       delayMs,
       reason
     });
     reconnectAttempts += 1;
-    if (delayMs === 0) {
-      reconnectTimer = setTimeout(() => {
-        reconnectTimer = null;
-        connectNow();
-      }, 0);
-    } else {
-      reconnectTimer = setTimeout(() => {
-        reconnectTimer = null;
-        connectNow();
-      }, delayMs);
-    }
+    reconnectTimer = setTimeout(() => {
+      reconnectTimer = null;
+      connectNow();
+    }, delayMs);
   }
   function onOpen() {
-    const isReconnect = hasConnectedBefore;
-    hasConnectedBefore = true;
     isOpen = true;
     reconnectAttempts = 0;
     emitter.emit("ws:open", undefined);
-    if (isReconnect) {
-      emitter.emit("ws:reconnected", undefined);
-    }
     flushPendingSends();
   }
   function onClose(e) {
@@ -1018,7 +1005,7 @@ class BuildSession {
   async connect(options = {}) {
     if (this.connection)
       return this.connection;
-    const { autoRequestConversationState, autoRequestPreview, credentials, ...connectionOptions } = options;
+    const { autoRequestConversationState, credentials, ...connectionOptions } = options;
     const getUrl = async () => {
       const { ticket } = await this.init.httpClient.getWsTicket(this.agentId);
       const base = this.websocketUrl;
@@ -1039,7 +1026,6 @@ class BuildSession {
     });
     const sessionCredentials = credentials ?? this.init.defaultCredentials;
     const shouldRequestConversationState = autoRequestConversationState ?? true;
-    const shouldRequestPreview = autoRequestPreview ?? (this.init.isExistingApp ?? false);
     this.connection.on("ws:open", () => {
       if (sessionCredentials) {
         this.connection?.send({
@@ -1050,14 +1036,6 @@ class BuildSession {
       if (shouldRequestConversationState) {
         this.connection?.send({ type: "get_conversation_state" });
       }
-      if (shouldRequestPreview) {
-        this.connection?.send({ type: "preview" });
-      }
-    });
-    this.connection.on("ws:reconnected", () => {
-      if (shouldRequestPreview) {
-        this.connection?.send({ type: "preview" });
-      }
     });
     return this.connection;
   }
@@ -1210,7 +1188,8 @@ class VibeClient {
       behaviorType: options.behaviorType,
       projectType: options.projectType,
       images: options.images,
-      credentials: options.credentials
+      credentials: options.credentials,
+      preflightQuestions: options.preflightQuestions
     };
     const resp = await this.http.fetchRaw("/api/agent", {
       method: "POST",
@@ -1220,35 +1199,24 @@ class VibeClient {
     if (!resp.body) {
       throw new Error("Missing response body from /api/agent");
     }
-    const iterator = parseNdjsonStream(resp.body)[Symbol.asyncIterator]();
-    const { value: start, done } = await iterator.next();
-    if (done || !start) {
+    let start = null;
+    for await (const obj of parseNdjsonStream(resp.body)) {
+      if (!start) {
+        start = obj;
+        continue;
+      }
+      const o = obj;
+      if (typeof o.chunk === "string") {
+        options.onBlueprintChunk?.(o.chunk);
+      }
+    }
+    if (!start) {
       throw new Error("No start event received from /api/agent");
     }
     const session = new BuildSession(start, {
       httpClient: this.http,
       ...options.credentials ? { defaultCredentials: options.credentials } : {}
     });
-    const waitForBlueprint = options.waitForBlueprint ?? true;
-    const processChunks = async () => {
-      let result = await iterator.next();
-      while (!result.done) {
-        const obj = result.value;
-        if (typeof obj.chunk === "string") {
-          options.onBlueprintChunk?.(obj.chunk);
-        }
-        result = await iterator.next();
-      }
-    };
-    if (waitForBlueprint) {
-      await processChunks();
-    } else {
-      processChunks().catch((error) => {
-        const err = error instanceof Error ? error : new Error(String(error));
-        options.onBlueprintError?.(err);
-        session.close();
-      });
-    }
     if (options.autoConnect ?? true) {
       await session.connect();
       if (options.autoGenerate ?? true) {
@@ -1268,7 +1236,6 @@ class VibeClient {
     };
     return new BuildSession(start, {
       httpClient: this.http,
-      isExistingApp: true,
       ...options.credentials ? { defaultCredentials: options.credentials } : {}
     });
   }
@@ -1397,6 +1364,12 @@ function blueprintToMarkdown(bp) {
     for (const p of bp.implementationRoadmap)
       lines.push(`- **${p.phase}**: ${p.description}`);
   }
+  if (bp.preflightAnswers?.length) {
+    lines.push("");
+    lines.push("## Preflight Answers");
+    for (const a of bp.preflightAnswers)
+      lines.push(`- **${a.question}**: ${a.answer}`);
+  }
   return lines.join(`
 `);
 }

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@cf-vibesdk/sdk",
-	"version": "0.1.0",
+	"version": "0.1.1",
 	"type": "module",
 	"exports": {
 		".": {