@pulse-editor/cli 0.1.2 → 0.1.3

package/dist/app.js

@@ -14,6 +14,7 @@ import Start from './components/commands/start.js';
 import Clean from './components/commands/clean.js';
 import Upgrade from './components/commands/upgrade.js';
 import Skill from './components/commands/skill.js';
+import Code from './components/commands/code.js';
 export default function App({ cli }) {
     const [command, setCommand] = useState(undefined);
     if (cli.flags.stage) {
@@ -26,5 +27,5 @@ export default function App({ cli }) {
         const cmd = cli.input[0] ?? 'help';
         setCommand(cmd);
     }, [cli.input]);
-    return (_jsxs(_Fragment, { children: [cli.flags.stage && (_jsx(Text, { color: 'yellow', children: "\u26A0\uFE0F  You are in development mode." })), command === 'help' ? (_jsx(Help, { cli: cli })) : command === 'chat' ? (_jsx(Chat, { cli: cli })) : command === 'login' ? (_jsx(Login, { cli: cli })) : command === 'logout' ? (_jsx(Logout, { cli: cli })) : command === 'publish' ? (_jsx(Publish, { cli: cli })) : command === 'create' ? (_jsx(Create, { cli: cli })) : command === 'dev' ? (_jsx(Dev, { cli: cli })) : command === 'build' ? (_jsx(Build, { cli: cli })) : command === 'preview' ? (_jsx(Preview, { cli: cli })) : command === 'start' ? (_jsx(Start, { cli: cli })) : command === 'clean' ? (_jsx(Clean, { cli: cli })) : command === 'upgrade' ? (_jsx(Upgrade, { cli: cli })) : command === 'skill' ? (_jsx(Skill, { cli: cli })) : (command !== undefined && (_jsxs(_Fragment, { children: [_jsxs(Text, { color: 'redBright', children: ["Invalid command: ", command] }), _jsxs(Text, { children: ["Run ", _jsx(Text, { color: 'blueBright', children: "pulse help" }), " to see the list of available commands."] })] })))] }));
+    return (_jsxs(_Fragment, { children: [cli.flags.stage && (_jsx(Text, { color: 'yellow', children: "\u26A0\uFE0F  You are in development mode." })), command === 'help' ? (_jsx(Help, { cli: cli })) : command === 'chat' ? (_jsx(Chat, { cli: cli })) : command === 'login' ? (_jsx(Login, { cli: cli })) : command === 'logout' ? (_jsx(Logout, { cli: cli })) : command === 'publish' ? (_jsx(Publish, { cli: cli })) : command === 'create' ? (_jsx(Create, { cli: cli })) : command === 'dev' ? (_jsx(Dev, { cli: cli })) : command === 'build' ? (_jsx(Build, { cli: cli })) : command === 'preview' ? (_jsx(Preview, { cli: cli })) : command === 'start' ? (_jsx(Start, { cli: cli })) : command === 'clean' ? (_jsx(Clean, { cli: cli })) : command === 'upgrade' ? (_jsx(Upgrade, { cli: cli })) : command === 'skill' ? (_jsx(Skill, { cli: cli })) : command === 'code' ? (_jsx(Code, { cli: cli })) : (command !== undefined && (_jsxs(_Fragment, { children: [_jsxs(Text, { color: 'redBright', children: ["Invalid command: ", command] }), _jsxs(Text, { children: ["Run ", _jsx(Text, { color: 'blueBright', children: "pulse help" }), " to see the list of available commands."] })] })))] }));
 }

package/dist/components/commands/code.d.ts

@@ -0,0 +1,5 @@
+import { Result } from "meow";
+import { Flags } from "../../lib/cli-flags.js";
+export default function Code({ cli }: {
+    cli: Result<Flags>;
+}): import("react/jsx-runtime").JSX.Element;

package/dist/components/commands/code.js

@@ -0,0 +1,342 @@
+import { jsx as _jsx, jsxs as _jsxs, Fragment as _Fragment } from "react/jsx-runtime";
+import fs from "fs";
+import { Box, Text } from "ink";
+import Spinner from "ink-spinner";
+import TextInput from "ink-text-input";
+import JSZip from "jszip";
+import path from "path";
+import { useEffect, useMemo, useState } from "react";
+import { getBackendUrl } from "../../lib/backend-url.js";
+import { checkToken, getToken } from "../../lib/token.js";
+function readContinueData(cwd) {
+    const pkgPath = path.resolve(cwd, "package.json");
+    if (!fs.existsSync(pkgPath)) {
+        return null;
+    }
+    try {
+        const pkg = JSON.parse(fs.readFileSync(pkgPath, "utf8"));
+        const name = typeof pkg["name"] === "string" ? pkg["name"] : undefined;
+        const version = typeof pkg["version"] === "string" ? pkg["version"] : undefined;
+        const appId = typeof pkg["appId"] === "string" ? pkg["appId"] : name;
+        if (!appId || !version) {
+            return null;
+        }
+        return { appId, version, name: name ?? appId };
+    }
+    catch {
+        return null;
+    }
+}
+function makeAppName(prompt) {
+    const normalized = prompt
+        .toLowerCase()
+        .replaceAll(/[^a-z0-9\s-]/g, "")
+        .trim()
+        .split(/\s+/)
+        .filter(Boolean)
+        .slice(0, 5)
+        .join("_");
+    const suffix = Math.random().toString(36).slice(2, 8);
+    return `${normalized || "pulse_app"}_${suffix}`;
+}
+function parseArtifact(result) {
+    if (!result) {
+        return undefined;
+    }
+    try {
+        return JSON.parse(result);
+    }
+    catch {
+        return undefined;
+    }
+}
+export default function Code({ cli }) {
+    // ── Continue mode ────────────────────────────────────────────────────────
+    const continueData = useMemo(() => {
+        if (!cli.flags.continue)
+            return undefined;
+        return readContinueData(process.cwd());
+    }, [cli.flags.continue]);
+    // ── Resolved inputs ──────────────────────────────────────────────────────
+    const [appName, setAppName] = useState(() => {
+        if (cli.flags.name)
+            return cli.flags.name;
+        if (cli.flags.continue) {
+            const data = readContinueData(process.cwd());
+            return data?.name ?? undefined;
+        }
+        return undefined;
+    });
+    const [appNameInput, setAppNameInput] = useState("");
+    const [prompt, setPrompt] = useState(undefined);
+    const [promptInput, setPromptInput] = useState("");
+    // ── Auth ─────────────────────────────────────────────────────────────────
+    const [isCheckingAuth, setIsCheckingAuth] = useState(true);
+    const [isAuthenticated, setIsAuthenticated] = useState(false);
+    // ── Generation state ─────────────────────────────────────────────────────
+    const [isGenerating, setIsGenerating] = useState(false);
+    const [isGenerated, setIsGenerated] = useState(false);
+    const [error, setError] = useState(undefined);
+    const [statusLines, setStatusLines] = useState([]);
+    // Per-message live streaming buffers
+    const [liveBuffers, setLiveBuffers] = useState(new Map());
+    const [toolCallErrors, setToolCallErrors] = useState([]);
+    const [artifact, setArtifact] = useState(undefined);
+    const [isDownloading, setIsDownloading] = useState(false);
+    const [downloadedPath, setDownloadedPath] = useState(undefined);
+    const [downloadError, setDownloadError] = useState(undefined);
+    const token = useMemo(() => getToken(cli.flags.stage), [cli.flags.stage]);
+    // Pre-fill prompt from inline CLI args, e.g. `pulse code "my prompt"`
+    useEffect(() => {
+        const initialPrompt = cli.input.slice(1).join(" ").trim();
+        if (initialPrompt) {
+            setPrompt(initialPrompt);
+        }
+    }, [cli.input]);
+    useEffect(() => {
+        async function runAuthCheck() {
+            if (!token) {
+                setIsAuthenticated(false);
+                setIsCheckingAuth(false);
+                return;
+            }
+            const isValid = await checkToken(token, cli.flags.stage);
+            setIsAuthenticated(isValid);
+            setIsCheckingAuth(false);
+        }
+        runAuthCheck();
+    }, [token, cli.flags.stage]);
+    useEffect(() => {
+        async function runCodeGeneration(userPrompt, resolvedAppName) {
+            if (!token) {
+                setError("Missing access token. Please run pulse login first.");
+                return;
+            }
+            setError(undefined);
+            setStatusLines([]);
+            setLiveBuffers(new Map());
+            setToolCallErrors([]);
+            setArtifact(undefined);
+            setIsDownloading(false);
+            setDownloadedPath(undefined);
+            setDownloadError(undefined);
+            setIsGenerating(true);
+            const controller = new AbortController();
+            let didTimeout = false;
+            const timeoutId = setTimeout(() => {
+                didTimeout = true;
+                controller.abort("Generation timeout after 5 minutes");
+            }, 5 * 60 * 1000);
+            const collectedMessages = new Map();
+            // Per-message live streaming buffers
+            const localBuffers = new Map();
+            let _artifact = undefined;
+            try {
+                const response = await fetch(`${getBackendUrl(cli.flags.stage)}/api/server-function/vibe_dev_flow/latest/generate-code/v2/generate`, {
+                    method: "POST",
+                    headers: {
+                        Authorization: `Bearer ${token}`,
+                        "Content-Type": "application/json",
+                    },
+                    body: JSON.stringify({
+                        prompt: userPrompt,
+                        ...(continueData
+                            ? {
+                                appId: continueData.appId,
+                                version: continueData.version,
+                            }
+                            : {
+                                appName: resolvedAppName,
+                            }),
+                    }),
+                    signal: controller.signal,
+                });
+                if (!response.ok) {
+                    throw new Error(`Code generation failed: ${response.status} ${response.statusText} - ${await response.text()}`);
+                }
+                if (!response.body) {
+                    throw new Error("No stream returned from server.");
+                }
+                const reader = response.body.getReader();
+                const decoder = new TextDecoder();
+                let buffer = "";
+                while (true) {
+                    const { value, done } = await reader.read();
+                    if (done) {
+                        break;
+                    }
+                    buffer += decoder.decode(value, { stream: true });
+                    const parts = buffer.split("\n\n");
+                    buffer = parts.pop() ?? "";
+                    for (const part of parts) {
+                        if (!part.startsWith("data:")) {
+                            continue;
+                        }
+                        const json = part.replace(/^data:\s*/, "");
+                        let message;
+                        try {
+                            message = JSON.parse(json);
+                        }
+                        catch {
+                            continue;
+                        }
+                        if (message.type === "creation") {
+                            collectedMessages.set(message.messageId, message);
+                            if (message.data.type === "notification") {
+                                const text = [message.data.title, message.data.description]
+                                    .filter(Boolean)
+                                    .join(": ");
+                                if (text.length > 0) {
+                                    setStatusLines((previous) => [...previous, { text }]);
+                                }
+                            }
+                            if (message.data.type === "toolCall") {
+                                const label = message.data.title
+                                    ? `Tool call: ${message.data.title}`
+                                    : "Tool call executed";
+                                setStatusLines((previous) => [
+                                    ...previous,
+                                    {
+                                        text: label,
+                                        messageId: message.messageId,
+                                        toolTitle: message.data.title,
+                                    },
+                                ]);
+                                // Start tracking this tool call's buffer
+                                localBuffers.set(message.messageId, message.data.description
+                                    ? `${message.data.description}\n`
+                                    : "");
+                                setLiveBuffers(new Map(localBuffers));
+                            }
+                            if (message.data.type === "artifactOutput") {
+                                _artifact = parseArtifact(message.data.result);
+                                setArtifact(_artifact);
+                            }
+                        }
+                        else {
+                            // update message
+                            const existing = collectedMessages.get(message.messageId);
+                            if (!existing) {
+                                continue;
+                            }
+                            const deltaResult = message.delta.result ?? "";
+                            const deltaError = message.delta.error ?? "";
+                            existing.data.result = (existing.data.result ?? "") + deltaResult;
+                            existing.data.error = (existing.data.error ?? "") + deltaError;
+                            existing.isFinal = message.isFinal;
+                            // Accumulate delta into this message's own buffer
+                            if (localBuffers.has(message.messageId) &&
+                                deltaResult.length > 0) {
+                                const current = localBuffers.get(message.messageId) ?? "";
+                                localBuffers.set(message.messageId, current + deltaResult);
+                                setLiveBuffers(new Map(localBuffers));
+                            }
+                            // Surface tool-level errors when the message is finalized
+                            if (message.isFinal && existing.data.error) {
+                                const errText = existing.data.error.trim();
+                                if (errText.length > 0) {
+                                    setToolCallErrors((previous) => [...previous, errText]);
+                                }
+                            }
+                        }
+                    }
+                }
+                setIsGenerated(true);
+                // Download the source zip
+                if (_artifact && _artifact.appId) {
+                    setIsDownloading(true);
+                    try {
+                        // Step 1: exchange the archive endpoint for a SAS URL
+                        const sasEndpoint = `${getBackendUrl(cli.flags.stage)}/api/app/source?app=${encodeURIComponent(_artifact.appId)}`;
+                        const sasResponse = await fetch(sasEndpoint, {
+                            headers: {
+                                Accept: "application/zip",
+                                Authorization: `Bearer ${token}`,
+                            },
+                        });
+                        if (!sasResponse.ok) {
+                            throw new Error(`Failed to get download link for ${_artifact.appId}: ${sasResponse.status} ${sasResponse.statusText}`);
+                        }
+                        const { url: sasUrl } = (await sasResponse.json());
+                        console.log(`SAS URL for ${_artifact.appId}: ${sasUrl}`);
+                        // Step 2: download the actual zip from the SAS URL
+                        const downloadResponse = await fetch(sasUrl);
+                        if (!downloadResponse.ok) {
+                            throw new Error(`Failed to download archive: ${downloadResponse.status} ${downloadResponse.statusText}`);
+                        }
+                        const arrayBuffer = await downloadResponse.arrayBuffer();
+                        // Extract zip in-memory and write files one by one
+                        const zip = await JSZip.loadAsync(arrayBuffer);
+                        const destDir = process.cwd();
+                        for (const [relativePath, zipEntry] of Object.entries(zip.files)) {
+                            if (zipEntry.dir)
+                                continue;
+                            const filePath = path.join(destDir, relativePath);
+                            fs.mkdirSync(path.dirname(filePath), { recursive: true });
+                            const content = await zipEntry.async("nodebuffer");
+                            fs.writeFileSync(filePath, content);
+                        }
+                        setDownloadedPath(destDir);
+                    }
+                    catch (downloadErr) {
+                        setDownloadError(downloadErr instanceof Error
+                            ? downloadErr.message
+                            : "Failed to download source archive.");
+                    }
+                    finally {
+                        setIsDownloading(false);
+                    }
+                }
+            }
+            catch (generationError) {
+                if (controller.signal.aborted && didTimeout) {
+                    setError("Code generation timed out after 5 minutes.");
+                }
+                else {
+                    setError(generationError instanceof Error
+                        ? generationError.message
+                        : "Failed to generate code.");
+                }
+            }
+            finally {
+                clearTimeout(timeoutId);
+                setIsGenerating(false);
+            }
+        }
+        if (isAuthenticated && prompt && appName && continueData !== null) {
+            runCodeGeneration(prompt, appName);
+        }
+    }, [prompt, appName, cli.flags.stage, isAuthenticated, token, continueData]);
+    function getLiveLines(messageId, toolTitle) {
+        const text = liveBuffers.get(messageId);
+        if (!text)
+            return { lines: [], truncated: false };
+        const all = text.split("\n").filter((l) => l.length > 0);
+        if (toolTitle === "Agent Message") {
+            return { lines: all, truncated: false };
+        }
+        const truncated = all.length > 8;
+        return { lines: all.slice(-8), truncated };
+    }
+    return (_jsx(_Fragment, { children: isCheckingAuth ? (_jsxs(Box, { children: [_jsx(Spinner, { type: "dots" }), _jsx(Text, { children: " Checking authentication..." })] })) : !isAuthenticated ? (_jsx(Text, { color: "redBright", children: "\u26D4 You are not authenticated. Run pulse login and try again." })) : cli.flags.continue && continueData === null ? (_jsx(Text, { color: "redBright", children: "\u26D4 Could not read app name and version from package.json in the current directory. Make sure a valid package.json with \"name\", \"version\" (and optionally \"appId\") exists." })) : appName === undefined ? (
+        // Step 1 — app name
+        _jsxs(Box, { children: [_jsx(Text, { children: "App name: " }), _jsx(TextInput, { value: appNameInput, onChange: setAppNameInput, onSubmit: (value) => {
+                        const trimmed = value.trim();
+                        setAppName(trimmed.length > 0 ? trimmed : makeAppName(""));
+                    } })] })) : prompt === undefined ? (
+        // Step 2 — prompt
+        _jsxs(Box, { children: [_jsx(Text, { children: "Describe the Pulse app you want to generate: " }), _jsx(TextInput, { value: promptInput, onChange: setPromptInput, onSubmit: (value) => {
+                        const trimmed = value.trim();
+                        if (trimmed.length === 0) {
+                            return;
+                        }
+                        setPrompt(trimmed);
+                    } })] })) : (
+        // Step 3 — generating
+        _jsxs(_Fragment, { children: [cli.flags.continue && continueData && (_jsxs(Text, { dimColor: true, children: ["Continuing from v", continueData.version, " (", continueData.appId, ")"] })), _jsxs(Text, { children: ["App name: ", _jsx(Text, { color: "yellow", children: appName })] }), _jsxs(Text, { children: ["Prompt: ", _jsx(Text, { color: "cyan", children: prompt })] }), isGenerating && (_jsxs(Box, { children: [_jsx(Spinner, { type: "dots" }), _jsx(Text, { children: " Generating app..." })] })), statusLines.map((item, index) => {
+                    const { lines, truncated } = item.messageId !== undefined
+                        ? getLiveLines(item.messageId, item.toolTitle)
+                        : { lines: [], truncated: false };
+                    return (_jsxs(Box, { flexDirection: "column", children: [_jsxs(Text, { dimColor: index < statusLines.length - 1, children: ["\u2022 ", item.text] }), lines.length > 0 && (_jsxs(Box, { borderStyle: "round", borderColor: "gray", flexDirection: "column", paddingX: 1, children: [truncated && (_jsx(Text, { color: "gray", dimColor: true, children: "<truncated>" })), lines.map((line, lineIndex) => (_jsx(Text, { color: "gray", children: line }, lineIndex)))] }))] }, `${item.text}-${index}`));
+                }), toolCallErrors.map((err, index) => (_jsxs(Text, { color: "redBright", children: ["\u274C ", err] }, index))), error && _jsxs(Text, { color: "redBright", children: ["\u274C ", error] }), isGenerated && !error && (_jsx(Text, { color: "greenBright", children: "\u2705 Code generation completed." })), artifact?.publishedAppLink && (_jsxs(Text, { color: "greenBright", children: ["Preview: ", artifact.publishedAppLink] })), artifact?.sourceCodeArchiveLink && (_jsxs(Text, { color: "greenBright", children: ["Source (.zip): ", artifact.sourceCodeArchiveLink] })), isDownloading && (_jsxs(Box, { children: [_jsx(Spinner, { type: "dots" }), _jsx(Text, { children: " Downloading source archive..." })] })), downloadedPath && (_jsxs(Text, { color: "greenBright", children: ["Source extracted: ", downloadedPath] })), downloadError && (_jsxs(Text, { color: "redBright", children: ["\u274C Download failed: ", downloadError] }))] })) }));
+}

package/dist/lib/cli-flags.d.ts

@@ -43,5 +43,9 @@ export declare const flags: {
         type: "string";
         shortFlag: string;
     };
+    continue: {
+        type: "boolean";
+        default: false;
+    };
 };
 export type Flags = typeof flags;

package/dist/lib/cli-flags.js

@@ -47,4 +47,8 @@ export const flags = defineFlags({
         type: 'string',
         shortFlag: 'd',
     },
+    continue: {
+        type: 'boolean',
+        default: false,
+    },
 });

package/dist/lib/manual.js

@@ -9,6 +9,17 @@ const chat = `\
                     --interactive, -i
                       Start an interactive chat session
 
+`;
+const code = `\
+  code            Generate a new Pulse App from a prompt using AI.
+
+                  Flags:
+                    --name, -n [app-name]
+                      Optional app name used for generation.
+                    --continue, -c
+                      Continue building on an existing app. Reads the app ID
+                      and version from the package.json in the current directory.
+
 `;
 const login = `\
   login           Login to the Pulse Editor Platform.
@@ -101,6 +112,7 @@ const skill = `\
 export const commandsManual = {
     help,
     chat,
+    code,
     login,
     logout,
     publish,

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@pulse-editor/cli",
-	"version": "0.1.2",
+	"version": "0.1.3",
 	"license": "MIT",
 	"bin": {
 		"pulse": "dist/cli.js"
@@ -37,6 +37,7 @@
 		"ink-select-input": "^6.2.0",
 		"ink-spinner": "^5.0.0",
 		"ink-text-input": "^6.0.0",
+		"jszip": "^3.10.1",
 		"livereload": "^0.10.3",
 		"meow": "^14.1.0",
 		"mini-css-extract-plugin": "^2.10.0",
@@ -52,6 +53,7 @@
 		"@types/connect-livereload": "^0.6.3",
 		"@types/cors": "^2.8.19",
 		"@types/express": "^5.0.6",
+		"@types/jszip": "^3.4.0",
 		"@types/livereload": "^0.9.5",
 		"@types/react": "^19.2.14",
 		"@types/react-dom": "^19.2.3",