Draft
Conversation
Introduces a typed block system (markdown, recipe, code) that lets templates interleave prose and code between recipe steps instead of just concatenating recipes. Refactors all template pages and the markdown export API to use the new system, with a fallback to legacy concatenation for templates without custom blocks. Co-authored-by: Isaac
Add three new recipes for RAG chat application development: - embeddings-generation.md: Guide for generating embeddings from documents - lakebase-pgvector.md: PostgreSQL vector storage with pgvector extension - scaffold-rag-chat.md: Scaffolding a RAG chat application Update recipe registry (recipes.ts) to include new RAG chat recipes with proper metadata, prerequisites, and categorization. Update content-entries plugin to support new recipe structure. Fix tsconfig path mapping for improved type resolution. Co-authored-by: Isaac
- Add rag-chat-integration.md: complete capstone recipe covering document seeding, RAG-augmented chat route, sources API, chat persistence routes, server bootstrap, client sources display, and App.tsx root route setup - Delete scaffold-rag-chat.md (was just CLI scaffolding with no RAG logic) - Create rag-chat-app-template.tsx page component (fixes broken link) - Update recipes.ts registry (swap slug, update recipeIds) - Enhance template-content.ts with connecting text between recipe phases - Fix @ai-sdk/openai@3 version pin in ai-chat-model-serving recipe - Improve embeddings-generation, lakebase-pgvector, lakebase-chat-persistence recipes with fuller code blocks and setupChatTables/listChats/getChatMessages Verified: an agent can one-shot build a working RAG chat app from the cookbook markdown alone (tested via dv2 dispatch). Deploy to Databricks Apps blocked by npm proxy issues (package-lock.json resolved URLs point to npm-proxy.dev.databricks.com which is unreachable from app containers). Co-authored-by: Isaac
5 tasks
| "rag-chat-app-template": [ | ||
| { | ||
| type: "markdown", | ||
| content: `## What you are building |
Collaborator
There was a problem hiding this comment.
Could we move this into content/cookbooks/ or similar and instead link to the markdown file here? Much easier to author and manage markdown in .md files.
Collaborator
Author
There was a problem hiding this comment.
Yes working on that now
tsconfig.json
Outdated
| } | ||
| }, | ||
| "exclude": [".docusaurus", "build", "tests"] | ||
| "exclude": [".docusaurus", "build", "tests", "templates"] |
Collaborator
There was a problem hiding this comment.
Doesn't look like templates/ is part of this PR? 👀
No templates/ directory exists in the repo. Co-authored-by: Isaac
Extend the content-entries plugin to support a data-only mode (no routes) for loading cookbook markdown at build time, eliminating the fragile raw-loader webpack hack. Co-authored-by: Isaac
Collaborator
Author
|
Updated. To add a cookbook comprising recipes and connecting text, you now:
|
| return markdown.trim(); | ||
| } | ||
|
|
||
| export function buildLegacyTemplateRawMarkdown( |
Collaborator
There was a problem hiding this comment.
I would just move all templates to the new logic in this PR instead of creating two paths (legacy, new)
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
2 participants
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Summary
scaffold-rag-chatwithrag-chat-integrationcapstone recipe containing full RAG app coderag-chat-app-template.tsxpage component (fixes broken template link)@ai-sdk/openai@3version pin and improves several recipe code blockslakebase-chat-persistencewithsetupChatTables,listChats,getChatMessagesStatus: WIP - Cookbook content and template page are functional. Agent one-shot build verified via dv2 dispatch (cursor-coding agent successfully built working RAG chat app from cookbook markdown alone).
Deploy difficulties
Deployment to Databricks Apps is currently blocked:
package-lock.jsongenerated locally resolves all tarballs tonpm-proxy.dev.databricks.comnpm installto fail with ETIMEDOUT onthrottleit-2.1.0.tgzpackage-lock.jsonfrom deploy bundle + ship.npmrcpointing toregistry.npmjs.org— not yet verified end-to-enddist/,client/dist/, productionnode_modules/) so container skips install entirelyTest plan
/resources/rag-chat-app-templatewith all 8 recipes + connecting textnpm run buildsucceeds (no broken links)bun run testsmoke tests passThis pull request was AI-assisted by Isaac.