vibes-diy 2.6.1 → 2.6.3

package/LICENSE.md

@@ -1,32 +1,3 @@
-The contents of this repository are Copyright (c) corresponding authors and
-contributors, licensed under the `Permissive License Stack` meaning either of:
-
-- Apache-2.0 Software License: https://www.apache.org/licenses/LICENSE-2.0
-  ([...4tr2kfsq](https://dweb.link/ipfs/bafkreiankqxazcae4onkp436wag2lj3ccso4nawxqkkfckd6cg4tr2kfsq))
-
-- MIT Software License: https://opensource.org/licenses/MIT
-  ([...vljevcba](https://dweb.link/ipfs/bafkreiepofszg4gfe2gzuhojmksgemsub2h4uy2gewdnr35kswvljevcba))
-
-You may not use the contents of this repository except in compliance
-with one of the listed Licenses. For an extended clarification of the
-intent behind the choice of Licensing please refer to
-https://protocol.ai/blog/announcing-the-permissive-license-stack/
-
-Unless required by applicable law or agreed to in writing, software
-distributed under the terms listed in this notice is distributed on
-an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND,
-either express or implied. See each License for the specific language
-governing permissions and limitations under that License.
-
-<!--- SPDX-License-Identifier: Apache-2.0 OR MIT -->
-
-`SPDX-License-Identifier: Apache-2.0 OR MIT`
-
-Verbatim copies of both licenses are included below:
-
-<details><summary>Apache-2.0 Software License</summary>
-
-```
                                  Apache License
                            Version 2.0, January 2004
                         http://www.apache.org/licenses/
@@ -203,30 +174,28 @@ Verbatim copies of both licenses are included below:
       of your accepting any such warranty or additional liability.
 
    END OF TERMS AND CONDITIONS
-```
 
-</details>
+   APPENDIX: How to apply the Apache License to your work.
 
-<details><summary>MIT Software License</summary>
+      To apply the Apache License to your work, attach the following
+      boilerplate notice, with the fields enclosed by brackets "[]"
+      replaced with your own identifying information. (Don't include
+      the brackets!)  The text should be enclosed in the appropriate
+      comment syntax for the file format. We also recommend that a
+      file or class name and description of purpose be included on the
+      same "printed page" as the copyright notice for easier
+      identification within third-party archives.
 
-```
-Permission is hereby granted, free of charge, to any person obtaining a copy
-of this software and associated documentation files (the "Software"), to deal
-in the Software without restriction, including without limitation the rights
-to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
-copies of the Software, and to permit persons to whom the Software is
-furnished to do so, subject to the following conditions:
+   Copyright [yyyy] [name of copyright owner]
 
-The above copyright notice and this permission notice shall be included in
-all copies or substantial portions of the Software.
+   Licensed under the Apache License, Version 2.0 (the "License");
+   you may not use this file except in compliance with the License.
+   You may obtain a copy of the License at
 
-THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
-IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
-FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
-AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
-LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
-OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
-THE SOFTWARE.
-```
+       http://www.apache.org/licenses/LICENSE-2.0
 
-</details>
+   Unless required by applicable law or agreed to in writing, software
+   distributed under the License is distributed on an "AS IS" BASIS,
+   WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+   See the License for the specific language governing permissions and
+   limitations under the License.

package/README.md

@@ -1,23 +1,38 @@
 [![Join our
-  Discord](https://discord-badge.selem.workers.dev/i/weSgWt684k.svg)](https://discord.gg/weSgWt684k)
+  Discord](https://discord-badge.selem.workers.dev/i/vnpWycj4Ta.svg)](https://discord.gg/vnpWycj4Ta)
 
-# ✨ Build Mini Apps with AI Magic
+# ✨ Vibes DIY — make apps with your friends
 
-Turn your **ideas** into **interactive apps** instantly. [Try it now](https://vibes.diy/) or [fork on GitHub](https://github.com/VibesDIY/vibes.diy) to customize with your own AI account.
+Software is getting weird again. Describe what you want and get a real, live app — fun, done, and alive. [Try it now](https://vibes.diy/) or [fork on GitHub](https://github.com/VibesDIY/vibes.diy).
 
-Create beautiful, interactive mini apps with zero setup. Your creations are automatically saved and can be shared instantly.
+Make apps with your friends, so easy even AI can do it. Describe your app in plain words, it builds instantly, and you keep changing it just by talking to it. Share the link and your friends join right away — no setup, no "wait, let me send you the invite."
 
-## Features
+## Why it's different
 
-- Create interactive mini apps using AI
-- Browse and return to your previous creations
-- Auto-save your work securely
-- See your app changes in real-time
+- **Fun** — build for any reason, or no reason at all.
+- **Done** — it's a real app at its own live link, not a prototype. State is saved automatically.
+- **Alive** — keep talking to it and it keeps changing. So can anyone you share it with.
+
+Seeing a vibe makes you want to change it. Start from someone else's, tweak it to fit you, share it, and the people you share with remix their own version. You're not a user anymore — you're a maker.
+
+## What people make
+
+A character bot that answers in your voice. A neighborhood resource tracker you share at the next town meeting. A flashcard app remixed into collaborative trivia your students change live. A workout tracker a whole gym swaps routines on. Every one is the same move: start, tweak, share, remix.
+
+## Yours to control
+
+Private by default — or open to the world. You choose. Keep an app to the people you invite, or publish it so anyone can use and remix it. You set who can read, write, and open it.
+
+> Your app's data lives in a centralized cloud database. "Private" means access-gated from other people — not encrypted, and not hidden from the platform.
+
+## Open source
+
+The whole platform is open source under Apache 2.0. Read the code, open an issue, send a PR.
 
 ## Quick Start
 
-1. [Try the demo](https://vibes.diy/) - No setup required!
-2. Or set up your own:
+1. [Try the demo](https://vibes.diy/) — no setup required.
+2. Or run it yourself:
    - Clone the repository
    - Install with `pnpm i`
    - Run `pnpm dev`
@@ -28,11 +43,4 @@ We are committed to providing a welcoming and inclusive environment for all cont
 
 Interested in contributing? Check out our [Contributing Guide](CONTRIBUTING.md) to get started.
 
-## Your Work is Always Safe
-
-Every app you create is automatically saved, so you can:
-
-- Browse your creations in the sidebar
-- Return to previous work anytime
-- Keep track of your building history
-- Save screenshots of your apps
+Find us on [Discord](https://discord.gg/vnpWycj4Ta), [Substack](https://vibesdiy.substack.com/), [YouTube](https://www.youtube.com/@VibesDIY), and [Bluesky](https://bsky.app/profile/vibes.diy).

package/cli/cmds/chat-response-render.d.ts

@@ -0,0 +1,10 @@
+import { Result } from "@adviser/cement";
+import type { PromptAndBlockMsgs, ResChatResponseTurn, SectionEvent } from "@vibes.diy/api-types";
+import { type ResolveSectionStreamResult } from "./resolve-section-stream.js";
+export declare function turnBlocks(turn: ResChatResponseTurn): PromptAndBlockMsgs[];
+export declare function reconstructVerbatim(blocks: readonly PromptAndBlockMsgs[]): string;
+export declare function renderJsonl(blocks: readonly PromptAndBlockMsgs[]): string;
+export declare function extractRawText(blocks: readonly PromptAndBlockMsgs[]): string | undefined;
+export declare function extractUserPrompts(blocks: readonly PromptAndBlockMsgs[]): string[];
+export declare function buildSectionStream(turn: ResChatResponseTurn): ReadableStream<SectionEvent>;
+export declare function resolveTurnFiles(turns: readonly ResChatResponseTurn[], selectedPromptId: string): Promise<Result<ResolveSectionStreamResult>>;

package/cli/cmds/chat-response-render.js

@@ -0,0 +1,94 @@
+import { Result } from "@adviser/cement";
+import { isCodeBegin, isCodeEnd, isCodeLine, isToplevelLine } from "@vibes.diy/call-ai-v2";
+import { isPromptRaw, isPromptReq } from "@vibes.diy/api-types";
+import { resolveSectionStream } from "./resolve-section-stream.js";
+export function turnBlocks(turn) {
+    return turn.sections.flatMap((s) => s.blocks);
+}
+export function reconstructVerbatim(blocks) {
+    const out = [];
+    for (const b of blocks) {
+        if (isToplevelLine(b)) {
+            out.push(b.line);
+        }
+        else if (isCodeBegin(b)) {
+            const info = b.path ? `${b.lang} ${b.path}` : b.lang;
+            out.push("```" + info);
+        }
+        else if (isCodeLine(b)) {
+            out.push(b.line);
+        }
+        else if (isCodeEnd(b)) {
+            out.push("```");
+        }
+    }
+    return out.join("\n");
+}
+export function renderJsonl(blocks) {
+    return blocks.map((b) => JSON.stringify(b)).join("\n");
+}
+export function extractRawText(blocks) {
+    const parts = blocks.filter(isPromptRaw).map((b) => b.text);
+    return parts.length === 0 ? undefined : parts.join("");
+}
+export function extractUserPrompts(blocks) {
+    const prompts = [];
+    for (const b of blocks) {
+        if (!isPromptReq(b))
+            continue;
+        for (const m of b.request.messages) {
+            if (m.role !== "user")
+                continue;
+            const text = m.content
+                .filter((c) => c.type === "text")
+                .map((c) => c.text)
+                .join("\n");
+            if (text !== "")
+                prompts.push(text);
+        }
+    }
+    return prompts;
+}
+export function buildSectionStream(turn) {
+    const events = turn.sections.map((s) => ({
+        type: "vibes.diy.section-event",
+        chatId: turn.chatId,
+        promptId: turn.promptId,
+        blockSeq: s.blockSeq,
+        timestamp: new Date(0),
+        blocks: s.blocks,
+    }));
+    return new ReadableStream({
+        start(controller) {
+            for (const e of events)
+                controller.enqueue(e);
+            controller.close();
+        },
+    });
+}
+export async function resolveTurnFiles(turns, selectedPromptId) {
+    const selected = turns.find((t) => t.promptId === selectedPromptId);
+    if (selected === undefined) {
+        return Result.Err(new Error(`No turn with promptId ${selectedPromptId}`));
+    }
+    const chain = turns
+        .filter((t) => t.chatId === selected.chatId)
+        .slice()
+        .sort((a, b) => (a.created < b.created ? -1 : a.created > b.created ? 1 : 0));
+    let seed = new Map();
+    let last;
+    for (const t of chain) {
+        const r = await resolveSectionStream({ sectionStream: buildSectionStream(t), streamId: t.promptId, seed });
+        if (r.isErr())
+            return Result.Err(r.Err());
+        last = r.Ok();
+        seed = new Map(Object.entries(last.files));
+        if (t.promptId === selected.promptId)
+            break;
+    }
+    if (last === undefined) {
+        return Result.Ok({ files: {}, errors: [], snapshotCount: 0, applyErrorCount: 0, turnEndSeen: false, promptErrors: [] });
+    }
+    return Result.Ok(last);
+}
+//# sourceMappingURL=chat-response-render.js.map

package/cli/cmds/chat-response-render.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"chat-response-render.js","sourceRoot":"","sources":["../../../jsr/cli/cmds/chat-response-render.ts"],"names":[],"mappings":"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"}

package/cli/cmds/chat-response-render.test.d.ts

@@ -0,0 +1 @@
+export {};

package/cli/cmds/chat-response-render.test.js

@@ -0,0 +1,140 @@
+import { describe, expect, it } from "vitest";
+import { buildSectionStream, extractRawText, extractUserPrompts, reconstructVerbatim, renderJsonl, turnBlocks, } from "./chat-response-render.js";
+import { resolveSectionStream } from "./resolve-section-stream.js";
+const base = (seq) => ({
+    blockId: "blk",
+    streamId: "stream-1",
+    seq,
+    blockNr: 0,
+    timestamp: new Date(0),
+});
+function toplevelLine(seq, line) {
+    return { type: "block.toplevel.line", sectionId: "s", lineNr: seq, line, ...base(seq) };
+}
+function codeBegin(seq, lang, path) {
+    return { type: "block.code.begin", sectionId: "s", lang, path, ...base(seq) };
+}
+function codeLine(seq, lang, path, line) {
+    return { type: "block.code.line", sectionId: "s", lang, path, lineNr: seq, line, ...base(seq) };
+}
+function codeEnd(seq, lang, path) {
+    return {
+        type: "block.code.end",
+        sectionId: "s",
+        lang,
+        path,
+        stats: { lines: 1, bytes: 1 },
+        ...base(seq),
+    };
+}
+describe("reconstructVerbatim", () => {
+    it("renders prose, a fenced code block with its bound path, and close fence", () => {
+        const blocks = [
+            toplevelLine(0, "Here is the app:"),
+            codeBegin(1, "jsx", "App.jsx"),
+            codeLine(2, "jsx", "App.jsx", "export default function App() {}"),
+            codeEnd(3, "jsx", "App.jsx"),
+        ];
+        expect(reconstructVerbatim(blocks)).toBe(["Here is the app:", "```jsx App.jsx", "export default function App() {}", "```"].join("\n"));
+    });
+    it("surfaces a path clobber: an orphaned label as prose, then a fence bound to the wrong path", () => {
+        const blocks = [
+            codeBegin(0, "jsx", "App.jsx"),
+            codeLine(1, "jsx", "App.jsx", "const a = 1;"),
+            codeEnd(2, "jsx", "App.jsx"),
+            toplevelLine(3, "access.js"),
+            toplevelLine(4, ""),
+            codeBegin(5, "js", "App.jsx"),
+            codeLine(6, "js", "App.jsx", "export const x = 1;"),
+            codeEnd(7, "js", "App.jsx"),
+        ];
+        const out = reconstructVerbatim(blocks);
+        expect(out).toContain("access.js");
+        expect(out.match(/```js App\.jsx/g)).toHaveLength(1);
+        expect(out.match(/```jsx App\.jsx/g)).toHaveLength(1);
+    });
+    it("omits the path from the info-string when a fence carries none", () => {
+        const blocks = [{ type: "block.code.begin", sectionId: "s", lang: "txt", ...base(0) }];
+        expect(reconstructVerbatim(blocks)).toBe("```txt");
+    });
+});
+describe("renderJsonl", () => {
+    it("emits one JSON object per line", () => {
+        const blocks = [toplevelLine(0, "a"), codeBegin(1, "js", "x.js")];
+        const lines = renderJsonl(blocks).split("\n");
+        expect(lines).toHaveLength(2);
+        expect(JSON.parse(lines[0]).type).toBe("block.toplevel.line");
+        expect(JSON.parse(lines[1]).type).toBe("block.code.begin");
+    });
+});
+describe("extractRawText", () => {
+    const rawBlock = (text) => ({
+        type: "prompt.raw",
+        streamId: "stream-1",
+        chatId: "c",
+        seq: 9,
+        timestamp: new Date(0),
+        text,
+    });
+    it("returns the byte-faithful text from a prompt.raw block", () => {
+        const blocks = [toplevelLine(0, "App.jsx"), rawBlock("App.jsx\n\n```jsx\nconst a=1;\n```\n")];
+        expect(extractRawText(blocks)).toBe("App.jsx\n\n```jsx\nconst a=1;\n```\n");
+    });
+    it("returns undefined when no prompt.raw block is present (un-backfilled turn)", () => {
+        expect(extractRawText([toplevelLine(0, "hi"), codeBegin(1, "jsx", "App.jsx")])).toBeUndefined();
+    });
+});
+describe("extractUserPrompts", () => {
+    it("pulls user message text from prompt.req blocks", () => {
+        const promptReq = {
+            type: "prompt.req",
+            streamId: "stream-1",
+            chatId: "c",
+            seq: 0,
+            timestamp: new Date(0),
+            request: {
+                messages: [
+                    { role: "system", content: [{ type: "text", text: "ignore me" }] },
+                    { role: "user", content: [{ type: "text", text: "build a todo app" }] },
+                ],
+            },
+        };
+        expect(extractUserPrompts([promptReq])).toEqual(["build a todo app"]);
+    });
+});
+describe("buildSectionStream + resolveSectionStream", () => {
+    it("resolves files from a stored turn via the shared generate/edit resolver", async () => {
+        const blocks = [
+            { type: "block.begin", ...base(0) },
+            codeBegin(0, "jsx", "App.jsx"),
+            codeLine(1, "jsx", "App.jsx", "export default function App() { return null; }"),
+            codeEnd(2, "jsx", "App.jsx"),
+            {
+                type: "block.end",
+                stats: {
+                    toplevel: { lines: 0, bytes: 0 },
+                    code: { lines: 1, bytes: 1 },
+                    image: { lines: 0, bytes: 0 },
+                    total: { lines: 1, bytes: 1 },
+                },
+                usage: { given: [], calculated: {} },
+                ...base(3),
+            },
+        ];
+        const turn = {
+            chatId: "c",
+            promptId: "stream-1",
+            created: "2026-01-01T00:00:00Z",
+            sections: [{ blockSeq: 0, blocks }],
+        };
+        expect(turnBlocks(turn)).toHaveLength(blocks.length);
+        const rResolved = await resolveSectionStream({
+            sectionStream: buildSectionStream(turn),
+            streamId: "stream-1",
+        });
+        expect(rResolved.isOk()).toBe(true);
+        const files = rResolved.Ok().files;
+        expect(files["App.jsx"]).toContain("export default function App()");
+    });
+});
+//# sourceMappingURL=chat-response-render.test.js.map

package/cli/cmds/chat-response-render.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"chat-response-render.test.js","sourceRoot":"","sources":["../../../jsr/cli/cmds/chat-response-render.test.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,QAAQ,CAAC;AAE9C,OAAO,EACL,kBAAkB,EAClB,cAAc,EACd,kBAAkB,EAClB,mBAAmB,EACnB,WAAW,EACX,UAAU,GACX,MAAM,2BAA2B,CAAC;AACnC,OAAO,EAAE,oBAAoB,EAAE,MAAM,6BAA6B,CAAC;AAEnE,MAAM,IAAI,GAAG,CAAC,GAAW,EAAE,EAAE,CAAC,CAAC;IAC7B,OAAO,EAAE,KAAK;IACd,QAAQ,EAAE,UAAU;IACpB,GAAG;IACH,OAAO,EAAE,CAAC;IACV,SAAS,EAAE,IAAI,IAAI,CAAC,CAAC,CAAC;CACvB,CAAC,CAAC;AAEH,SAAS,YAAY,CAAC,GAAW,EAAE,IAAY;IAC7C,OAAO,EAAE,IAAI,EAAE,qBAAqB,EAAE,SAAS,EAAE,GAAG,EAAE,MAAM,EAAE,GAAG,EAAE,IAAI,EAAE,GAAG,IAAI,CAAC,GAAG,CAAC,EAAmC,CAAC;AAC3H,CAAC;AACD,SAAS,SAAS,CAAC,GAAW,EAAE,IAAY,EAAE,IAAY;IACxD,OAAO,EAAE,IAAI,EAAE,kBAAkB,EAAE,SAAS,EAAE,GAAG,EAAE,IAAI,EAAE,IAAI,EAAE,GAAG,IAAI,CAAC,GAAG,CAAC,EAAmC,CAAC;AACjH,CAAC;AACD,SAAS,QAAQ,CAAC,GAAW,EAAE,IAAY,EAAE,IAAY,EAAE,IAAY;IACrE,OAAO,EAAE,IAAI,EAAE,iBAAiB,EAAE,SAAS,EAAE,GAAG,EAAE,IAAI,EAAE,IAAI,EAAE,MAAM,EAAE,GAAG,EAAE,IAAI,EAAE,GAAG,IAAI,CAAC,GAAG,CAAC,EAAmC,CAAC;AACnI,CAAC;AACD,SAAS,OAAO,CAAC,GAAW,EAAE,IAAY,EAAE,IAAY;IACtD,OAAO;QACL,IAAI,EAAE,gBAAgB;QACtB,SAAS,EAAE,GAAG;QACd,IAAI;QACJ,IAAI;QACJ,KAAK,EAAE,EAAE,KAAK,EAAE,CAAC,EAAE,KAAK,EAAE,CAAC,EAAE;QAC7B,GAAG,IAAI,CAAC,GAAG,CAAC;KACoB,CAAC;AACrC,CAAC;AAED,QAAQ,CAAC,qBAAqB,EAAE,GAAG,EAAE;IACnC,EAAE,CAAC,yEAAyE,EAAE,GAAG,EAAE;QACjF,MAAM,MAAM,GAAG;YACb,YAAY,CAAC,CAAC,EAAE,kBAAkB,CAAC;YACnC,SAAS,CAAC,CAAC,EAAE,KAAK,EAAE,SAAS,CAAC;YAC9B,QAAQ,CAAC,CAAC,EAAE,KAAK,EAAE,SAAS,EAAE,kCAAkC,CAAC;YACjE,OAAO,CAAC,CAAC,EAAE,KAAK,EAAE,SAAS,CAAC;SAC7B,CAAC;QACF,MAAM,CAAC,mBAAmB,CAAC,MAAM,CAAC,CAAC,CAAC,IAAI,CACtC,CAAC,kBAAkB,EAAE,gBAAgB,EAAE,kCAAkC,EAAE,KAAK,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAC7F,CAAC;IACJ,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,2FAA2F,EAAE,GAAG,EAAE;QAGnG,MAAM,MAAM,GAAG;YACb,SAAS,CAAC,CAAC,EAAE,KAAK,EAAE,SAAS,CAAC;YAC9B,QAAQ,CAAC,CAAC,EAAE,KAAK,EAAE,SAAS,EAAE,cAAc,CAAC;YAC7C,OAAO,CAAC,CAAC,EAAE,KAAK,EAAE,SAAS,CAAC;YAC5B,YAAY,CAAC,CAAC,EAAE,WAAW,CAAC;YAC5B,YAAY,CAAC,CAAC,EAAE,EAAE,CAAC;YACnB,SAAS,CAAC,CAAC,EAAE,IAAI,EAAE,SAAS,CAAC;YAC7B,QAAQ,CAAC,CAAC,EAAE,IAAI,EAAE,SAAS,EAAE,qBAAqB,CAAC;YACnD,OAAO,CAAC,CAAC,EAAE,IAAI,EAAE,SAAS,CAAC;SAC5B,CAAC;QACF,MAAM,GAAG,GAAG,mBAAmB,CAAC,MAAM,CAAC,CAAC;QACxC,MAAM,CAAC,GAAG,CAAC,CAAC,SAAS,CAAC,WAAW,CAAC,CAAC;QAEnC,MAAM,CAAC,GAAG,CAAC,KAAK,CAAC,iBAAiB,CAAC,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC;QACrD,MAAM,CAAC,GAAG,CAAC,KAAK,CAAC,kBAAkB,CAAC,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC;IACxD,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,+DAA+D,EAAE,GAAG,EAAE;QACvE,MAAM,MAAM,GAAG,CAAC,EAAE,IAAI,EAAE,kBAAkB,EAAE,SAAS,EAAE,GAAG,EAAE,IAAI,EAAE,KAAK,EAAE,GAAG,IAAI,CAAC,CAAC,CAAC,EAAmC,CAAC,CAAC;QACxH,MAAM,CAAC,mBAAmB,CAAC,MAAM,CAAC,CAAC,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;IACrD,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC;AAEH,QAAQ,CAAC,aAAa,EAAE,GAAG,EAAE;IAC3B,EAAE,CAAC,gCAAgC,EAAE,GAAG,EAAE;QACxC,MAAM,MAAM,GAAG,CAAC,YAAY,CAAC,CAAC,EAAE,GAAG,CAAC,EAAE,SAAS,CAAC,CAAC,EAAE,IAAI,EAAE,MAAM,CAAC,CAAC,CAAC;QAClE,MAAM,KAAK,GAAG,WAAW,CAAC,MAAM,CAAC,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;QAC9C,MAAM,CAAC,KAAK,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC;QAC9B,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,qBAAqB,CAAC,CAAC;QAC9D,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,kBAAkB,CAAC,CAAC;IAC7D,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC;AAEH,QAAQ,CAAC,gBAAgB,EAAE,GAAG,EAAE;IAC9B,MAAM,QAAQ,GAAG,CAAC,IAAY,EAAsB,EAAE,CACpD,CAAC;QACC,IAAI,EAAE,YAAY;QAClB,QAAQ,EAAE,UAAU;QACpB,MAAM,EAAE,GAAG;QACX,GAAG,EAAE,CAAC;QACN,SAAS,EAAE,IAAI,IAAI,CAAC,CAAC,CAAC;QACtB,IAAI;KACL,CAAkC,CAAC;IAEtC,EAAE,CAAC,wDAAwD,EAAE,GAAG,EAAE;QAChE,MAAM,MAAM,GAAG,CAAC,YAAY,CAAC,CAAC,EAAE,SAAS,CAAC,EAAE,QAAQ,CAAC,sCAAsC,CAAC,CAAC,CAAC;QAC9F,MAAM,CAAC,cAAc,CAAC,MAAM,CAAC,CAAC,CAAC,IAAI,CAAC,sCAAsC,CAAC,CAAC;IAC9E,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,4EAA4E,EAAE,GAAG,EAAE;QACpF,MAAM,CAAC,cAAc,CAAC,CAAC,YAAY,CAAC,CAAC,EAAE,IAAI,CAAC,EAAE,SAAS,CAAC,CAAC,EAAE,KAAK,EAAE,SAAS,CAAC,CAAC,CAAC,CAAC,CAAC,aAAa,EAAE,CAAC;IAClG,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC;AAEH,QAAQ,CAAC,oBAAoB,EAAE,GAAG,EAAE;IAClC,EAAE,CAAC,gDAAgD,EAAE,GAAG,EAAE;QACxD,MAAM,SAAS,GAAG;YAChB,IAAI,EAAE,YAAY;YAClB,QAAQ,EAAE,UAAU;YACpB,MAAM,EAAE,GAAG;YACX,GAAG,EAAE,CAAC;YACN,SAAS,EAAE,IAAI,IAAI,CAAC,CAAC,CAAC;YACtB,OAAO,EAAE;gBACP,QAAQ,EAAE;oBACR,EAAE,IAAI,EAAE,QAAQ,EAAE,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,WAAW,EAAE,CAAC,EAAE;oBAClE,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,kBAAkB,EAAE,CAAC,EAAE;iBACxE;aACF;SAC+B,CAAC;QACnC,MAAM,CAAC,kBAAkB,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,kBAAkB,CAAC,CAAC,CAAC;IACxE,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC;AAEH,QAAQ,CAAC,2CAA2C,EAAE,GAAG,EAAE;IACzD,EAAE,CAAC,yEAAyE,EAAE,KAAK,IAAI,EAAE;QACvF,MAAM,MAAM,GAAyB;YACnC,EAAE,IAAI,EAAE,aAAa,EAAE,GAAG,IAAI,CAAC,CAAC,CAAC,EAAmC;YACpE,SAAS,CAAC,CAAC,EAAE,KAAK,EAAE,SAAS,CAAC;YAC9B,QAAQ,CAAC,CAAC,EAAE,KAAK,EAAE,SAAS,EAAE,gDAAgD,CAAC;YAC/E,OAAO,CAAC,CAAC,EAAE,KAAK,EAAE,SAAS,CAAC;YAC5B;gBACE,IAAI,EAAE,WAAW;gBACjB,KAAK,EAAE;oBACL,QAAQ,EAAE,EAAE,KAAK,EAAE,CAAC,EAAE,KAAK,EAAE,CAAC,EAAE;oBAChC,IAAI,EAAE,EAAE,KAAK,EAAE,CAAC,EAAE,KAAK,EAAE,CAAC,EAAE;oBAC5B,KAAK,EAAE,EAAE,KAAK,EAAE,CAAC,EAAE,KAAK,EAAE,CAAC,EAAE;oBAC7B,KAAK,EAAE,EAAE,KAAK,EAAE,CAAC,EAAE,KAAK,EAAE,CAAC,EAAE;iBAC9B;gBACD,KAAK,EAAE,EAAE,KAAK,EAAE,EAAE,EAAE,UAAU,EAAE,EAAE,EAAE;gBACpC,GAAG,IAAI,CAAC,CAAC,CAAC;aACsB;SACnC,CAAC;QACF,MAAM,IAAI,GAAwB;YAChC,MAAM,EAAE,GAAG;YACX,QAAQ,EAAE,UAAU;YACpB,OAAO,EAAE,sBAAsB;YAC/B,QAAQ,EAAE,CAAC,EAAE,QAAQ,EAAE,CAAC,EAAE,MAAM,EAAE,CAAC;SACpC,CAAC;QACF,MAAM,CAAC,UAAU,CAAC,IAAI,CAAC,CAAC,CAAC,YAAY,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;QACrD,MAAM,SAAS,GAAG,MAAM,oBAAoB,CAAC;YAC3C,aAAa,EAAE,kBAAkB,CAAC,IAAI,CAAC;YACvC,QAAQ,EAAE,UAAU;SACrB,CAAC,CAAC;QACH,MAAM,CAAC,SAAS,CAAC,IAAI,EAAE,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QACpC,MAAM,KAAK,GAAG,SAAS,CAAC,EAAE,EAAE,CAAC,KAAK,CAAC;QACnC,MAAM,CAAC,KAAK,CAAC,SAAS,CAAC,CAAC,CAAC,SAAS,CAAC,+BAA+B,CAAC,CAAC;IACtE,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC"}

package/cli/cmds/chats-cmd.d.ts

@@ -7,9 +7,21 @@ export declare const ReqChats: import("arktype/internal/variants/object.ts").Obj
     ownerHandle: string;
     chatId?: string | undefined;
     apiUrl: string;
+    response?: boolean | undefined;
+    raw?: boolean | undefined;
+    files?: boolean | undefined;
+    jsonl?: boolean | undefined;
+    user?: boolean | undefined;
+    promptId?: string | undefined;
 }, {}>;
 export type ReqChats = typeof ReqChats.infer;
 export declare function isReqChats(obj: unknown): obj is ReqChats;
+export declare const ResChatResponse: import("arktype/internal/variants/object.ts").ObjectType<{
+    type: "vibes-diy.cli.res-chat-response";
+    output: string;
+}, {}>;
+export type ResChatResponse = typeof ResChatResponse.infer;
+export declare function isResChatResponse(obj: unknown): obj is ResChatResponse;
 export declare const ResChatsList: import("arktype/internal/variants/object.ts").ObjectType<{
     type: "vibes-diy.cli.res-chats-list";
     items: {
@@ -34,7 +46,7 @@ export declare const ResChatDetail: import("arktype/internal/variants/object.ts"
 }, {}>;
 export type ResChatDetail = typeof ResChatDetail.infer;
 export declare function isResChatDetail(obj: unknown): obj is ResChatDetail;
-type ResChats = ResChatsList | ResChatDetail;
+type ResChats = ResChatsList | ResChatDetail | ResChatResponse;
 export declare const chatsEvento: EventoHandler<WrapCmdTSMsg<unknown>, ReqChats, ResChats>;
 export declare function chatsCmd(ctx: CliCtx): Partial<import("cmd-ts/dist/cjs/argparser.js").Register> & {
     parse(context: import("cmd-ts/dist/cjs/argparser.js").ParseContext): Promise<import("cmd-ts/dist/cjs/argparser.js").ParsingResult<{
@@ -42,6 +54,12 @@ export declare function chatsCmd(ctx: CliCtx): Partial<import("cmd-ts/dist/cjs/a
         chatId: string | undefined;
         vibe: string;
         handle: string;
+        response: boolean;
+        raw: boolean;
+        files: boolean;
+        jsonl: boolean;
+        user: boolean;
+        turn: string | undefined;
         apiUrl: string;
         json: boolean;
         text: boolean;
@@ -51,6 +69,12 @@ export declare function chatsCmd(ctx: CliCtx): Partial<import("cmd-ts/dist/cjs/a
     chatId: string | undefined;
     vibe: string;
     handle: string;
+    response: boolean;
+    raw: boolean;
+    files: boolean;
+    jsonl: boolean;
+    user: boolean;
+    turn: string | undefined;
     apiUrl: string;
     json: boolean;
     text: boolean;

package/cli/cmds/chats-cmd.js

@@ -1,4 +1,4 @@
-import { command, option, optional, positional, string } from "cmd-ts";
+import { command, flag, option, optional, positional, string } from "cmd-ts";
 import { Result, Option } from "@adviser/cement";
 import { type } from "arktype";
 import { resListApplicationChatsItem } from "@vibes.diy/api-types";
@@ -7,16 +7,30 @@ import { sendMsg } from "../cmd-evento.js";
 import { resolveHandle } from "../resolve-handle.js";
 import { formatErr } from "./format-err.js";
 import { resolveVibePositionals } from "../parse-vibe.js";
+import { extractRawText, extractUserPrompts, reconstructVerbatim, renderJsonl, resolveTurnFiles, turnBlocks, } from "./chat-response-render.js";
 export const ReqChats = type({
     type: "'vibes-diy.cli.chats'",
     appSlug: "string",
     ownerHandle: "string",
     "chatId?": "string",
     apiUrl: "string",
+    "response?": "boolean",
+    "raw?": "boolean",
+    "files?": "boolean",
+    "jsonl?": "boolean",
+    "user?": "boolean",
+    "promptId?": "string",
 });
 export function isReqChats(obj) {
     return !(ReqChats(obj) instanceof type.errors);
 }
+export const ResChatResponse = type({
+    type: "'vibes-diy.cli.res-chat-response'",
+    output: "string",
+});
+export function isResChatResponse(obj) {
+    return !(ResChatResponse(obj) instanceof type.errors);
+}
 export const ResChatsList = type({
     type: "'vibes-diy.cli.res-chats-list'",
     items: resListApplicationChatsItem.array(),
@@ -54,6 +68,69 @@ export const chatsEvento = {
         const args = ctx.validated;
         const api = ectx.vibesDiyApiFactory(args.apiUrl);
         const ownerHandle = await resolveHandle(api, args.ownerHandle === "" ? undefined : args.ownerHandle);
+        const wantResponse = args.response === true || args.raw === true || args.files === true || args.jsonl === true || args.user === true;
+        if (wantResponse) {
+            if (ownerHandle === undefined) {
+                return Result.Err("Could not resolve handle. Pass --handle or run 'vibes-diy login'.");
+            }
+            const rResp = await api.getChatResponse({
+                ownerHandle,
+                appSlug: args.appSlug,
+                ...(args.chatId !== undefined ? { chatId: args.chatId } : {}),
+            });
+            if (rResp.isErr()) {
+                return Result.Err(formatErr(rResp.Err()));
+            }
+            const turns = rResp.Ok().turns;
+            if (turns.length === 0) {
+                return sendMsg(ctx, {
+                    type: "vibes-diy.cli.res-chat-response",
+                    output: "(no response found for this chat)",
+                });
+            }
+            let turn = turns[0];
+            if (args.promptId !== undefined) {
+                turn = turns.find((t) => t.promptId === args.promptId);
+                if (turn === undefined) {
+                    return Result.Err(`No turn with promptId ${args.promptId} in this chat.`);
+                }
+            }
+            else if (turns.length > 1) {
+                ectx.output.stderr(`Showing newest turn ${turn.promptId} (${turns.length} turns total — use --turn <promptId> to pick another).\n`);
+            }
+            const blocks = turnBlocks(turn);
+            let body;
+            if (args.raw === true) {
+                const raw = extractRawText(blocks);
+                body =
+                    raw ??
+                        "(no raw capture for this turn — byte-faithful text is only stored for generations after raw capture shipped; try --jsonl or the default block-faithful view)";
+            }
+            else if (args.jsonl === true) {
+                body = renderJsonl(blocks);
+            }
+            else if (args.files === true) {
+                const rResolved = await resolveTurnFiles(turns, turn.promptId);
+                if (rResolved.isErr()) {
+                    return Result.Err(`Failed to resolve stored stream: ${rResolved.Err().message}`);
+                }
+                body = JSON.stringify(rResolved.Ok().files, null, 2);
+            }
+            else {
+                body = reconstructVerbatim(blocks);
+            }
+            let output = body;
+            if (args.user === true) {
+                const userBlock = extractUserPrompts(blocks)
+                    .map((p) => p
+                    .split("\n")
+                    .map((l) => `> ${l}`)
+                    .join("\n"))
+                    .join("\n>\n");
+                output = userBlock === "" ? body : `${userBlock}\n\n${body}`;
+            }
+            return sendMsg(ctx, { type: "vibes-diy.cli.res-chat-response", output });
+        }
         switch (true) {
             case args.chatId !== undefined: {
                 if (ownerHandle === undefined) {
@@ -128,8 +205,34 @@ export function chatsCmd(ctx) {
                 defaultValue: () => "",
                 defaultValueIsSerializable: true,
             }),
+            response: flag({
+                long: "response",
+                short: "r",
+                description: "Show the model's reply, block-faithfully reconstructed from stored block events, instead of the user prompt",
+            }),
+            raw: flag({
+                long: "raw",
+                description: "With --response: byte-faithful raw model text captured upstream of the parser (preserves consumed labels & blank lines; new generations only)",
+            }),
+            files: flag({
+                long: "files",
+                description: "With --response: the resolved path→content map (via the generate/edit resolver)",
+            }),
+            jsonl: flag({
+                long: "jsonl",
+                description: "With --response: the raw block events, one JSON object per line",
+            }),
+            user: flag({
+                long: "user",
+                description: "With --response: also print the user prompt(s) so the full transcript reads top-down",
+            }),
+            turn: option({
+                long: "turn",
+                description: "With --response: select a specific turn by promptId (default: newest)",
+                type: optional(string),
+            }),
         },
-        handler: ctx.cliStream.enqueue(({ handle, chatId, vibe, appSlug, ...rest }) => {
+        handler: ctx.cliStream.enqueue(({ handle, chatId, vibe, appSlug, turn, ...rest }) => {
             const resolved = resolveVibePositionals({ vibe, handle, positionals: [appSlug, chatId] });
             const resolvedChatId = resolved.trailing[0];
             const base = {
@@ -138,7 +241,8 @@ export function chatsCmd(ctx) {
                 appSlug: resolved.appSlug,
                 ownerHandle: resolved.handle,
             };
-            return resolvedChatId === undefined ? base : { ...base, chatId: resolvedChatId };
+            const withChat = resolvedChatId === undefined ? base : { ...base, chatId: resolvedChatId };
+            return turn === undefined ? withChat : { ...withChat, promptId: turn };
         }),
     });
 }