mirror of
https://github.com/waynesutton/markdown-site.git
synced 2026-01-12 04:09:14 +00:00
bfe88d0217
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
625 lines
15 KiB
TypeScript
625 lines
15 KiB
TypeScript
/* eslint-disable */
|
|
/**
|
|
* Generated `api` utility.
|
|
*
|
|
* THIS CODE IS AUTOMATICALLY GENERATED.
|
|
*
|
|
* To regenerate, run `npx convex dev`.
|
|
* @module
|
|
*/
|
|
|
|
import type * as aiChatActions from "../aiChatActions.js";
|
|
import type * as aiChats from "../aiChats.js";
|
|
import type * as crons from "../crons.js";
|
|
import type * as http from "../http.js";
|
|
import type * as pages from "../pages.js";
|
|
import type * as posts from "../posts.js";
|
|
import type * as rss from "../rss.js";
|
|
import type * as search from "../search.js";
|
|
import type * as stats from "../stats.js";
|
|
|
|
import type {
|
|
ApiFromModules,
|
|
FilterApi,
|
|
FunctionReference,
|
|
} from "convex/server";
|
|
|
|
declare const fullApi: ApiFromModules<{
|
|
aiChatActions: typeof aiChatActions;
|
|
aiChats: typeof aiChats;
|
|
crons: typeof crons;
|
|
http: typeof http;
|
|
pages: typeof pages;
|
|
posts: typeof posts;
|
|
rss: typeof rss;
|
|
search: typeof search;
|
|
stats: typeof stats;
|
|
}>;
|
|
|
|
/**
|
|
* A utility for referencing Convex functions in your app's public API.
|
|
*
|
|
* Usage:
|
|
* ```js
|
|
* const myFunctionReference = api.myModule.myFunction;
|
|
* ```
|
|
*/
|
|
export declare const api: FilterApi<
|
|
typeof fullApi,
|
|
FunctionReference<any, "public">
|
|
>;
|
|
|
|
/**
|
|
* A utility for referencing Convex functions in your app's internal API.
|
|
*
|
|
* Usage:
|
|
* ```js
|
|
* const myFunctionReference = internal.myModule.myFunction;
|
|
* ```
|
|
*/
|
|
export declare const internal: FilterApi<
|
|
typeof fullApi,
|
|
FunctionReference<any, "internal">
|
|
>;
|
|
|
|
export declare const components: {
|
|
pageViewsByPath: {
|
|
btree: {
|
|
aggregateBetween: FunctionReference<
|
|
"query",
|
|
"internal",
|
|
{ k1?: any; k2?: any; namespace?: any },
|
|
{ count: number; sum: number }
|
|
>;
|
|
aggregateBetweenBatch: FunctionReference<
|
|
"query",
|
|
"internal",
|
|
{ queries: Array<{ k1?: any; k2?: any; namespace?: any }> },
|
|
Array<{ count: number; sum: number }>
|
|
>;
|
|
atNegativeOffset: FunctionReference<
|
|
"query",
|
|
"internal",
|
|
{ k1?: any; k2?: any; namespace?: any; offset: number },
|
|
{ k: any; s: number; v: any }
|
|
>;
|
|
atOffset: FunctionReference<
|
|
"query",
|
|
"internal",
|
|
{ k1?: any; k2?: any; namespace?: any; offset: number },
|
|
{ k: any; s: number; v: any }
|
|
>;
|
|
atOffsetBatch: FunctionReference<
|
|
"query",
|
|
"internal",
|
|
{
|
|
queries: Array<{
|
|
k1?: any;
|
|
k2?: any;
|
|
namespace?: any;
|
|
offset: number;
|
|
}>;
|
|
},
|
|
Array<{ k: any; s: number; v: any }>
|
|
>;
|
|
get: FunctionReference<
|
|
"query",
|
|
"internal",
|
|
{ key: any; namespace?: any },
|
|
null | { k: any; s: number; v: any }
|
|
>;
|
|
offset: FunctionReference<
|
|
"query",
|
|
"internal",
|
|
{ k1?: any; key: any; namespace?: any },
|
|
number
|
|
>;
|
|
offsetUntil: FunctionReference<
|
|
"query",
|
|
"internal",
|
|
{ k2?: any; key: any; namespace?: any },
|
|
number
|
|
>;
|
|
paginate: FunctionReference<
|
|
"query",
|
|
"internal",
|
|
{
|
|
cursor?: string;
|
|
k1?: any;
|
|
k2?: any;
|
|
limit: number;
|
|
namespace?: any;
|
|
order: "asc" | "desc";
|
|
},
|
|
{
|
|
cursor: string;
|
|
isDone: boolean;
|
|
page: Array<{ k: any; s: number; v: any }>;
|
|
}
|
|
>;
|
|
paginateNamespaces: FunctionReference<
|
|
"query",
|
|
"internal",
|
|
{ cursor?: string; limit: number },
|
|
{ cursor: string; isDone: boolean; page: Array<any> }
|
|
>;
|
|
validate: FunctionReference<
|
|
"query",
|
|
"internal",
|
|
{ namespace?: any },
|
|
any
|
|
>;
|
|
};
|
|
inspect: {
|
|
display: FunctionReference<"query", "internal", { namespace?: any }, any>;
|
|
dump: FunctionReference<"query", "internal", { namespace?: any }, string>;
|
|
inspectNode: FunctionReference<
|
|
"query",
|
|
"internal",
|
|
{ namespace?: any; node?: string },
|
|
null
|
|
>;
|
|
listTreeNodes: FunctionReference<
|
|
"query",
|
|
"internal",
|
|
{ take?: number },
|
|
Array<{
|
|
_creationTime: number;
|
|
_id: string;
|
|
aggregate?: { count: number; sum: number };
|
|
items: Array<{ k: any; s: number; v: any }>;
|
|
subtrees: Array<string>;
|
|
}>
|
|
>;
|
|
listTrees: FunctionReference<
|
|
"query",
|
|
"internal",
|
|
{ take?: number },
|
|
Array<{
|
|
_creationTime: number;
|
|
_id: string;
|
|
maxNodeSize: number;
|
|
namespace?: any;
|
|
root: string;
|
|
}>
|
|
>;
|
|
};
|
|
public: {
|
|
clear: FunctionReference<
|
|
"mutation",
|
|
"internal",
|
|
{ maxNodeSize?: number; namespace?: any; rootLazy?: boolean },
|
|
null
|
|
>;
|
|
delete_: FunctionReference<
|
|
"mutation",
|
|
"internal",
|
|
{ key: any; namespace?: any },
|
|
null
|
|
>;
|
|
deleteIfExists: FunctionReference<
|
|
"mutation",
|
|
"internal",
|
|
{ key: any; namespace?: any },
|
|
any
|
|
>;
|
|
init: FunctionReference<
|
|
"mutation",
|
|
"internal",
|
|
{ maxNodeSize?: number; namespace?: any; rootLazy?: boolean },
|
|
null
|
|
>;
|
|
insert: FunctionReference<
|
|
"mutation",
|
|
"internal",
|
|
{ key: any; namespace?: any; summand?: number; value: any },
|
|
null
|
|
>;
|
|
makeRootLazy: FunctionReference<
|
|
"mutation",
|
|
"internal",
|
|
{ namespace?: any },
|
|
null
|
|
>;
|
|
replace: FunctionReference<
|
|
"mutation",
|
|
"internal",
|
|
{
|
|
currentKey: any;
|
|
namespace?: any;
|
|
newKey: any;
|
|
newNamespace?: any;
|
|
summand?: number;
|
|
value: any;
|
|
},
|
|
null
|
|
>;
|
|
replaceOrInsert: FunctionReference<
|
|
"mutation",
|
|
"internal",
|
|
{
|
|
currentKey: any;
|
|
namespace?: any;
|
|
newKey: any;
|
|
newNamespace?: any;
|
|
summand?: number;
|
|
value: any;
|
|
},
|
|
any
|
|
>;
|
|
};
|
|
};
|
|
totalPageViews: {
|
|
btree: {
|
|
aggregateBetween: FunctionReference<
|
|
"query",
|
|
"internal",
|
|
{ k1?: any; k2?: any; namespace?: any },
|
|
{ count: number; sum: number }
|
|
>;
|
|
aggregateBetweenBatch: FunctionReference<
|
|
"query",
|
|
"internal",
|
|
{ queries: Array<{ k1?: any; k2?: any; namespace?: any }> },
|
|
Array<{ count: number; sum: number }>
|
|
>;
|
|
atNegativeOffset: FunctionReference<
|
|
"query",
|
|
"internal",
|
|
{ k1?: any; k2?: any; namespace?: any; offset: number },
|
|
{ k: any; s: number; v: any }
|
|
>;
|
|
atOffset: FunctionReference<
|
|
"query",
|
|
"internal",
|
|
{ k1?: any; k2?: any; namespace?: any; offset: number },
|
|
{ k: any; s: number; v: any }
|
|
>;
|
|
atOffsetBatch: FunctionReference<
|
|
"query",
|
|
"internal",
|
|
{
|
|
queries: Array<{
|
|
k1?: any;
|
|
k2?: any;
|
|
namespace?: any;
|
|
offset: number;
|
|
}>;
|
|
},
|
|
Array<{ k: any; s: number; v: any }>
|
|
>;
|
|
get: FunctionReference<
|
|
"query",
|
|
"internal",
|
|
{ key: any; namespace?: any },
|
|
null | { k: any; s: number; v: any }
|
|
>;
|
|
offset: FunctionReference<
|
|
"query",
|
|
"internal",
|
|
{ k1?: any; key: any; namespace?: any },
|
|
number
|
|
>;
|
|
offsetUntil: FunctionReference<
|
|
"query",
|
|
"internal",
|
|
{ k2?: any; key: any; namespace?: any },
|
|
number
|
|
>;
|
|
paginate: FunctionReference<
|
|
"query",
|
|
"internal",
|
|
{
|
|
cursor?: string;
|
|
k1?: any;
|
|
k2?: any;
|
|
limit: number;
|
|
namespace?: any;
|
|
order: "asc" | "desc";
|
|
},
|
|
{
|
|
cursor: string;
|
|
isDone: boolean;
|
|
page: Array<{ k: any; s: number; v: any }>;
|
|
}
|
|
>;
|
|
paginateNamespaces: FunctionReference<
|
|
"query",
|
|
"internal",
|
|
{ cursor?: string; limit: number },
|
|
{ cursor: string; isDone: boolean; page: Array<any> }
|
|
>;
|
|
validate: FunctionReference<
|
|
"query",
|
|
"internal",
|
|
{ namespace?: any },
|
|
any
|
|
>;
|
|
};
|
|
inspect: {
|
|
display: FunctionReference<"query", "internal", { namespace?: any }, any>;
|
|
dump: FunctionReference<"query", "internal", { namespace?: any }, string>;
|
|
inspectNode: FunctionReference<
|
|
"query",
|
|
"internal",
|
|
{ namespace?: any; node?: string },
|
|
null
|
|
>;
|
|
listTreeNodes: FunctionReference<
|
|
"query",
|
|
"internal",
|
|
{ take?: number },
|
|
Array<{
|
|
_creationTime: number;
|
|
_id: string;
|
|
aggregate?: { count: number; sum: number };
|
|
items: Array<{ k: any; s: number; v: any }>;
|
|
subtrees: Array<string>;
|
|
}>
|
|
>;
|
|
listTrees: FunctionReference<
|
|
"query",
|
|
"internal",
|
|
{ take?: number },
|
|
Array<{
|
|
_creationTime: number;
|
|
_id: string;
|
|
maxNodeSize: number;
|
|
namespace?: any;
|
|
root: string;
|
|
}>
|
|
>;
|
|
};
|
|
public: {
|
|
clear: FunctionReference<
|
|
"mutation",
|
|
"internal",
|
|
{ maxNodeSize?: number; namespace?: any; rootLazy?: boolean },
|
|
null
|
|
>;
|
|
delete_: FunctionReference<
|
|
"mutation",
|
|
"internal",
|
|
{ key: any; namespace?: any },
|
|
null
|
|
>;
|
|
deleteIfExists: FunctionReference<
|
|
"mutation",
|
|
"internal",
|
|
{ key: any; namespace?: any },
|
|
any
|
|
>;
|
|
init: FunctionReference<
|
|
"mutation",
|
|
"internal",
|
|
{ maxNodeSize?: number; namespace?: any; rootLazy?: boolean },
|
|
null
|
|
>;
|
|
insert: FunctionReference<
|
|
"mutation",
|
|
"internal",
|
|
{ key: any; namespace?: any; summand?: number; value: any },
|
|
null
|
|
>;
|
|
makeRootLazy: FunctionReference<
|
|
"mutation",
|
|
"internal",
|
|
{ namespace?: any },
|
|
null
|
|
>;
|
|
replace: FunctionReference<
|
|
"mutation",
|
|
"internal",
|
|
{
|
|
currentKey: any;
|
|
namespace?: any;
|
|
newKey: any;
|
|
newNamespace?: any;
|
|
summand?: number;
|
|
value: any;
|
|
},
|
|
null
|
|
>;
|
|
replaceOrInsert: FunctionReference<
|
|
"mutation",
|
|
"internal",
|
|
{
|
|
currentKey: any;
|
|
namespace?: any;
|
|
newKey: any;
|
|
newNamespace?: any;
|
|
summand?: number;
|
|
value: any;
|
|
},
|
|
any
|
|
>;
|
|
};
|
|
};
|
|
uniqueVisitors: {
|
|
btree: {
|
|
aggregateBetween: FunctionReference<
|
|
"query",
|
|
"internal",
|
|
{ k1?: any; k2?: any; namespace?: any },
|
|
{ count: number; sum: number }
|
|
>;
|
|
aggregateBetweenBatch: FunctionReference<
|
|
"query",
|
|
"internal",
|
|
{ queries: Array<{ k1?: any; k2?: any; namespace?: any }> },
|
|
Array<{ count: number; sum: number }>
|
|
>;
|
|
atNegativeOffset: FunctionReference<
|
|
"query",
|
|
"internal",
|
|
{ k1?: any; k2?: any; namespace?: any; offset: number },
|
|
{ k: any; s: number; v: any }
|
|
>;
|
|
atOffset: FunctionReference<
|
|
"query",
|
|
"internal",
|
|
{ k1?: any; k2?: any; namespace?: any; offset: number },
|
|
{ k: any; s: number; v: any }
|
|
>;
|
|
atOffsetBatch: FunctionReference<
|
|
"query",
|
|
"internal",
|
|
{
|
|
queries: Array<{
|
|
k1?: any;
|
|
k2?: any;
|
|
namespace?: any;
|
|
offset: number;
|
|
}>;
|
|
},
|
|
Array<{ k: any; s: number; v: any }>
|
|
>;
|
|
get: FunctionReference<
|
|
"query",
|
|
"internal",
|
|
{ key: any; namespace?: any },
|
|
null | { k: any; s: number; v: any }
|
|
>;
|
|
offset: FunctionReference<
|
|
"query",
|
|
"internal",
|
|
{ k1?: any; key: any; namespace?: any },
|
|
number
|
|
>;
|
|
offsetUntil: FunctionReference<
|
|
"query",
|
|
"internal",
|
|
{ k2?: any; key: any; namespace?: any },
|
|
number
|
|
>;
|
|
paginate: FunctionReference<
|
|
"query",
|
|
"internal",
|
|
{
|
|
cursor?: string;
|
|
k1?: any;
|
|
k2?: any;
|
|
limit: number;
|
|
namespace?: any;
|
|
order: "asc" | "desc";
|
|
},
|
|
{
|
|
cursor: string;
|
|
isDone: boolean;
|
|
page: Array<{ k: any; s: number; v: any }>;
|
|
}
|
|
>;
|
|
paginateNamespaces: FunctionReference<
|
|
"query",
|
|
"internal",
|
|
{ cursor?: string; limit: number },
|
|
{ cursor: string; isDone: boolean; page: Array<any> }
|
|
>;
|
|
validate: FunctionReference<
|
|
"query",
|
|
"internal",
|
|
{ namespace?: any },
|
|
any
|
|
>;
|
|
};
|
|
inspect: {
|
|
display: FunctionReference<"query", "internal", { namespace?: any }, any>;
|
|
dump: FunctionReference<"query", "internal", { namespace?: any }, string>;
|
|
inspectNode: FunctionReference<
|
|
"query",
|
|
"internal",
|
|
{ namespace?: any; node?: string },
|
|
null
|
|
>;
|
|
listTreeNodes: FunctionReference<
|
|
"query",
|
|
"internal",
|
|
{ take?: number },
|
|
Array<{
|
|
_creationTime: number;
|
|
_id: string;
|
|
aggregate?: { count: number; sum: number };
|
|
items: Array<{ k: any; s: number; v: any }>;
|
|
subtrees: Array<string>;
|
|
}>
|
|
>;
|
|
listTrees: FunctionReference<
|
|
"query",
|
|
"internal",
|
|
{ take?: number },
|
|
Array<{
|
|
_creationTime: number;
|
|
_id: string;
|
|
maxNodeSize: number;
|
|
namespace?: any;
|
|
root: string;
|
|
}>
|
|
>;
|
|
};
|
|
public: {
|
|
clear: FunctionReference<
|
|
"mutation",
|
|
"internal",
|
|
{ maxNodeSize?: number; namespace?: any; rootLazy?: boolean },
|
|
null
|
|
>;
|
|
delete_: FunctionReference<
|
|
"mutation",
|
|
"internal",
|
|
{ key: any; namespace?: any },
|
|
null
|
|
>;
|
|
deleteIfExists: FunctionReference<
|
|
"mutation",
|
|
"internal",
|
|
{ key: any; namespace?: any },
|
|
any
|
|
>;
|
|
init: FunctionReference<
|
|
"mutation",
|
|
"internal",
|
|
{ maxNodeSize?: number; namespace?: any; rootLazy?: boolean },
|
|
null
|
|
>;
|
|
insert: FunctionReference<
|
|
"mutation",
|
|
"internal",
|
|
{ key: any; namespace?: any; summand?: number; value: any },
|
|
null
|
|
>;
|
|
makeRootLazy: FunctionReference<
|
|
"mutation",
|
|
"internal",
|
|
{ namespace?: any },
|
|
null
|
|
>;
|
|
replace: FunctionReference<
|
|
"mutation",
|
|
"internal",
|
|
{
|
|
currentKey: any;
|
|
namespace?: any;
|
|
newKey: any;
|
|
newNamespace?: any;
|
|
summand?: number;
|
|
value: any;
|
|
},
|
|
null
|
|
>;
|
|
replaceOrInsert: FunctionReference<
|
|
"mutation",
|
|
"internal",
|
|
{
|
|
currentKey: any;
|
|
namespace?: any;
|
|
newKey: any;
|
|
newNamespace?: any;
|
|
summand?: number;
|
|
value: any;
|
|
},
|
|
any
|
|
>;
|
|
};
|
|
};
|
|
};
|