mirror of
https://github.com/waynesutton/markdown-site.git
synced 2026-01-12 04:09:14 +00:00
Add AI writing assistant (Agent) powered by Anthropic Claude API. Agent can be enabled on Write page (replaces textarea) and optionally in RightSidebar on posts/pages via frontmatter. Features: - AIChatView component with per-page chat history - Page content context support for AI responses - Markdown rendering for AI responses - User-friendly error handling for missing API keys - System prompt configurable via Convex environment variables - Anonymous session authentication using localStorage Environment variables required: - ANTHROPIC_API_KEY (required) - CLAUDE_PROMPT_STYLE, CLAUDE_PROMPT_COMMUNITY, CLAUDE_PROMPT_RULES (optional split prompts) - CLAUDE_SYSTEM_PROMPT (optional single prompt fallback) Configuration: - siteConfig.aiChat.enabledOnWritePage: Enable Agent toggle on /write page - siteConfig.aiChat.enabledOnContent: Allow Agent on posts/pages via frontmatter - Frontmatter aiChat: true (requires rightSidebar: true) Updated files: - src/components/AIChatView.tsx: AI chat interface component - src/components/RightSidebar.tsx: Conditional Agent rendering - src/pages/Write.tsx: Agent mode toggle (title changes to Agent) - convex/aiChats.ts: Chat history queries and mutations - convex/aiChatActions.ts: Claude API integration with error handling - convex/schema.ts: aiChats table with indexes - src/config/siteConfig.ts: AIChatConfig interface - Documentation updated across all files Documentation: - files.md: Updated component descriptions - changelog.md: Added v1.33.0 entry - TASK.md: Marked AI chat tasks as completed - README.md: Added AI Agent Chat section - content/pages/docs.md: Added AI Agent chat documentation - content/blog/setup-guide.md: Added AI Agent chat setup instructions - public/raw/changelog.md: Added v1.33.0 entry
256 lines
7.1 KiB
TypeScript
256 lines
7.1 KiB
TypeScript
import { query, mutation } from "./_generated/server";
|
|
import { v } from "convex/values";
|
|
|
|
// Get all published pages for navigation
|
|
export const getAllPages = query({
|
|
args: {},
|
|
returns: v.array(
|
|
v.object({
|
|
_id: v.id("pages"),
|
|
slug: v.string(),
|
|
title: v.string(),
|
|
published: v.boolean(),
|
|
order: v.optional(v.number()),
|
|
showInNav: v.optional(v.boolean()),
|
|
excerpt: v.optional(v.string()),
|
|
image: v.optional(v.string()),
|
|
featured: v.optional(v.boolean()),
|
|
featuredOrder: v.optional(v.number()),
|
|
authorName: v.optional(v.string()),
|
|
authorImage: v.optional(v.string()),
|
|
layout: v.optional(v.string()),
|
|
rightSidebar: v.optional(v.boolean()),
|
|
showFooter: v.optional(v.boolean()),
|
|
footer: v.optional(v.string()),
|
|
}),
|
|
),
|
|
handler: async (ctx) => {
|
|
const pages = await ctx.db
|
|
.query("pages")
|
|
.withIndex("by_published", (q) => q.eq("published", true))
|
|
.collect();
|
|
|
|
// Filter out pages where showInNav is explicitly false
|
|
// Default to true for backwards compatibility (undefined/null = show in nav)
|
|
const visiblePages = pages.filter(
|
|
(page) => page.showInNav !== false,
|
|
);
|
|
|
|
// Sort by order (lower numbers first), then by title
|
|
const sortedPages = visiblePages.sort((a, b) => {
|
|
const orderA = a.order ?? 999;
|
|
const orderB = b.order ?? 999;
|
|
if (orderA !== orderB) return orderA - orderB;
|
|
return a.title.localeCompare(b.title);
|
|
});
|
|
|
|
return sortedPages.map((page) => ({
|
|
_id: page._id,
|
|
slug: page.slug,
|
|
title: page.title,
|
|
published: page.published,
|
|
order: page.order,
|
|
showInNav: page.showInNav,
|
|
excerpt: page.excerpt,
|
|
image: page.image,
|
|
featured: page.featured,
|
|
featuredOrder: page.featuredOrder,
|
|
authorName: page.authorName,
|
|
authorImage: page.authorImage,
|
|
layout: page.layout,
|
|
rightSidebar: page.rightSidebar,
|
|
showFooter: page.showFooter,
|
|
}));
|
|
},
|
|
});
|
|
|
|
// Get featured pages for the homepage featured section
|
|
export const getFeaturedPages = query({
|
|
args: {},
|
|
returns: v.array(
|
|
v.object({
|
|
_id: v.id("pages"),
|
|
slug: v.string(),
|
|
title: v.string(),
|
|
excerpt: v.optional(v.string()),
|
|
image: v.optional(v.string()),
|
|
featuredOrder: v.optional(v.number()),
|
|
}),
|
|
),
|
|
handler: async (ctx) => {
|
|
const pages = await ctx.db
|
|
.query("pages")
|
|
.withIndex("by_featured", (q) => q.eq("featured", true))
|
|
.collect();
|
|
|
|
// Filter to only published pages and sort by featuredOrder
|
|
const featuredPages = pages
|
|
.filter((p) => p.published)
|
|
.sort((a, b) => {
|
|
const orderA = a.featuredOrder ?? 999;
|
|
const orderB = b.featuredOrder ?? 999;
|
|
return orderA - orderB;
|
|
});
|
|
|
|
return featuredPages.map((page) => ({
|
|
_id: page._id,
|
|
slug: page.slug,
|
|
title: page.title,
|
|
excerpt: page.excerpt,
|
|
image: page.image,
|
|
featuredOrder: page.featuredOrder,
|
|
}));
|
|
},
|
|
});
|
|
|
|
// Get a single page by slug
|
|
export const getPageBySlug = query({
|
|
args: {
|
|
slug: v.string(),
|
|
},
|
|
returns: v.union(
|
|
v.object({
|
|
_id: v.id("pages"),
|
|
slug: v.string(),
|
|
title: v.string(),
|
|
content: v.string(),
|
|
published: v.boolean(),
|
|
order: v.optional(v.number()),
|
|
showInNav: v.optional(v.boolean()),
|
|
excerpt: v.optional(v.string()),
|
|
image: v.optional(v.string()),
|
|
featured: v.optional(v.boolean()),
|
|
featuredOrder: v.optional(v.number()),
|
|
authorName: v.optional(v.string()),
|
|
authorImage: v.optional(v.string()),
|
|
layout: v.optional(v.string()),
|
|
rightSidebar: v.optional(v.boolean()),
|
|
showFooter: v.optional(v.boolean()),
|
|
footer: v.optional(v.string()),
|
|
aiChat: v.optional(v.boolean()),
|
|
}),
|
|
v.null(),
|
|
),
|
|
handler: async (ctx, args) => {
|
|
const page = await ctx.db
|
|
.query("pages")
|
|
.withIndex("by_slug", (q) => q.eq("slug", args.slug))
|
|
.first();
|
|
|
|
if (!page || !page.published) {
|
|
return null;
|
|
}
|
|
|
|
return {
|
|
_id: page._id,
|
|
slug: page.slug,
|
|
title: page.title,
|
|
content: page.content,
|
|
published: page.published,
|
|
order: page.order,
|
|
showInNav: page.showInNav,
|
|
excerpt: page.excerpt,
|
|
image: page.image,
|
|
featured: page.featured,
|
|
featuredOrder: page.featuredOrder,
|
|
authorName: page.authorName,
|
|
authorImage: page.authorImage,
|
|
layout: page.layout,
|
|
rightSidebar: page.rightSidebar,
|
|
showFooter: page.showFooter,
|
|
footer: page.footer,
|
|
aiChat: page.aiChat,
|
|
};
|
|
},
|
|
});
|
|
|
|
// Public mutation for syncing pages from markdown files
|
|
export const syncPagesPublic = mutation({
|
|
args: {
|
|
pages: v.array(
|
|
v.object({
|
|
slug: v.string(),
|
|
title: v.string(),
|
|
content: v.string(),
|
|
published: v.boolean(),
|
|
order: v.optional(v.number()),
|
|
showInNav: v.optional(v.boolean()),
|
|
excerpt: v.optional(v.string()),
|
|
image: v.optional(v.string()),
|
|
featured: v.optional(v.boolean()),
|
|
featuredOrder: v.optional(v.number()),
|
|
authorName: v.optional(v.string()),
|
|
authorImage: v.optional(v.string()),
|
|
layout: v.optional(v.string()),
|
|
rightSidebar: v.optional(v.boolean()),
|
|
showFooter: v.optional(v.boolean()),
|
|
footer: v.optional(v.string()),
|
|
aiChat: v.optional(v.boolean()),
|
|
}),
|
|
),
|
|
},
|
|
returns: v.object({
|
|
created: v.number(),
|
|
updated: v.number(),
|
|
deleted: v.number(),
|
|
}),
|
|
handler: async (ctx, args) => {
|
|
let created = 0;
|
|
let updated = 0;
|
|
let deleted = 0;
|
|
|
|
const now = Date.now();
|
|
const incomingSlugs = new Set(args.pages.map((p) => p.slug));
|
|
|
|
// Get all existing pages
|
|
const existingPages = await ctx.db.query("pages").collect();
|
|
const existingBySlug = new Map(existingPages.map((p) => [p.slug, p]));
|
|
|
|
// Upsert incoming pages
|
|
for (const page of args.pages) {
|
|
const existing = existingBySlug.get(page.slug);
|
|
|
|
if (existing) {
|
|
// Update existing page
|
|
await ctx.db.patch(existing._id, {
|
|
title: page.title,
|
|
content: page.content,
|
|
published: page.published,
|
|
order: page.order,
|
|
showInNav: page.showInNav,
|
|
excerpt: page.excerpt,
|
|
image: page.image,
|
|
featured: page.featured,
|
|
featuredOrder: page.featuredOrder,
|
|
authorName: page.authorName,
|
|
authorImage: page.authorImage,
|
|
layout: page.layout,
|
|
rightSidebar: page.rightSidebar,
|
|
showFooter: page.showFooter,
|
|
footer: page.footer,
|
|
aiChat: page.aiChat,
|
|
lastSyncedAt: now,
|
|
});
|
|
updated++;
|
|
} else {
|
|
// Create new page
|
|
await ctx.db.insert("pages", {
|
|
...page,
|
|
lastSyncedAt: now,
|
|
});
|
|
created++;
|
|
}
|
|
}
|
|
|
|
// Delete pages that no longer exist in the repo
|
|
for (const existing of existingPages) {
|
|
if (!incomingSlugs.has(existing.slug)) {
|
|
await ctx.db.delete(existing._id);
|
|
deleted++;
|
|
}
|
|
}
|
|
|
|
return { created, updated, deleted };
|
|
},
|
|
});
|