V1 docs (#329)

* Add v1 docs

* Fix context object usage

* Add (initial) training modules and examples

* Add some marketing terms

* Add remaining Training docs

* Update Training docs structure

* Fix dev training docs structure

* Update code block highlighting

* Tweaks

* Clarify context naming in routes vs agents

* Update docs structure

* Add version picker

* Update version tabs, fix sidebar spacing

* Reorder Agents docs

* Set v0 as current, update CLI commands

- Flip version picker: v0 is "Current", v1 is "Preview"
- Replace deprecation banner with preview banner
- Update install/quickstart to use agentuity CLI
- Remove TODOs and archived content

* Add remaining "Build" docs

* Add Reference (CLI) pages

* Update sidebar page names

* Tweaks

- Add Cookbook section with tutorials and patterns
- Update message in preview banner
- Align logo on sidebar

* Restructure Routes and APIs pages

- Update naming to Routes/ with expanded content
- Add more accurate callouts to route pages
- Add middleware sections to email, SSE, WebSocket docs
- Consolidate API pages (content moved to Routes)
- Fix cross-referenced links throughout

* Fix internal links in Routes docs

* Add @agentuity/schema examples

* Tweaks

* Add Bun S3/SQL storage pages, restructure CLI reference

* Fix v1 links

* Tweaks

* Update to latest SDK

* Update wrangler.jsonc

Signed-off-by: Matthew Congrove <mcongrove@agentuity.com>

* Show v1 preview first

* Fix install instructions, shorten migration guide

* Sync docs with v1 SDK, add Bun docs links

- Clean up pages, sidebar
- Point migration guide to Cookbook instead

* Fix state management docs

* Fix React hooks docs

- Update invoke signature
- Add missing return values

* Refine alpha docs

* Add more templates, web app links

* Fix agent file structure docs

* Add warnings for email/SMS (WIP)

* Clarify templates, email docs

* Clarify "get started" pages

* Fix agent file structure

* Tweaks

* SDK Reference rename + context access callouts

* Remove AgentContext imports (types now inferred), reduce callouts

* Tweak CLI overview page

* Add build config and Tailwind setup docs

* Add tutorials and workbench docs, update CLI reference

* Cookbook fixes and AGENTUITY_PUBLIC_* docs

- Fix route patterns and imports in examples
- Styling/consistency tweaks
- Add Summary table to rag-agent.mdx
- Add AGENTUITY_PUBLIC_* tip to build-configuration.mdx

* Fix evals docs

* Add authentication docs

* Add Vite docs

* Tweaks

* Clarify session and threads

* Add RPC client docs, update auth and CLI pages

* Fix useAPI import, add auth callout

* Update middleware patterns

* Enhance async state management in agents

* Fix auth middleware signature, remove old auth integrations

* Add access patterns tables for Agentuity APIs

* Update evals docs, add sandbox API docs

* Add standalone validator and direct SDK access docs

- Document standalone validator() for routes without agents
- Rewrite server-utilities to show direct SDK storage access pattern

* Add cross-ref links, route callouts

* Remove v0 docs, migrate to v1

* Tweaks

---------

Signed-off-by: Matthew Congrove <mcongrove@agentuity.com>
Co-authored-by: parteeksingh24 <parteek.singh24@gmail.com>

Author: mcongrove

.env.example

@@ -1,5 +1,6 @@
 # Agent Configuration
 AGENT_BASE_URL=http://127.0.0.1:3500
+AGENT_BEARER_TOKEN=
 
 # KV-store is hitting Agentuity Service API, this can be found in `agent-docs` after running `agentuity dev`
 AGENTUITY_API_KEY=

.gitignore

@@ -34,3 +34,9 @@ next-env.d.ts
 
 # this is generated by the build process
 content/docs.json
+public/**/*.md
+
+# Claude Code
+.claude/
+claude/
+CLAUDE.md

agent-docs/README.md

@@ -52,7 +52,7 @@ Run your project in development mode with:
 agentuity dev
 ```
 
-This will start your project and open a new browser window connecting your agent to the Agentuity Console in DevMode, allowing you to test and debug your agent in real-time.
+This will start your project and open a new browser window connecting your agent to the Agentuity App in DevMode, allowing you to test and debug your agent in real-time.
 
 ## 🌐 Deployment
 

agent-docs/src/agents/agent-pulse/index.ts

@@ -94,7 +94,7 @@ export default async function Agent(
 		];
 
 		let tools: any;
-		let systemPrompt: string = "";
+		let systemPrompt = "";
 		// Direct LLM access won't require any tools or system prompt
 		if (!parsedRequest.useDirectLLM) {
 			// Create tools with state context

agent-docs/src/agents/agent-pulse/request/parser.ts

@@ -6,9 +6,9 @@ export function parseAgentRequest(
 	ctx: AgentContext
 ): ParsedAgentRequest {
 	try {
-		let message: string = "";
+		let message = "";
 		let conversationHistory: any[] = [];
-		let tutorialData: any = undefined;
+		let tutorialData: any ;
 		let useDirectLLM = false;
 
 		if (jsonData && typeof jsonData === "object" && !Array.isArray(jsonData)) {

agent-docs/src/agents/agent-pulse/state/manager.ts

@@ -39,13 +39,12 @@ export async function handleTutorialState(
             state.clearAction();
             ctx.logger.info("Tutorial state processed successfully");
             return tutorialData;
-          } else {
+          }
             // Handle API errors gracefully
             ctx.logger.error("Failed to fetch tutorial step: %s", tutorialStep.error || 'Unknown error');
             if (tutorialStep.details) {
               ctx.logger.error("Error details: %s", JSON.stringify(tutorialStep.details));
             }
-          }
         }
         break;
       default:

agent-docs/src/agents/agent-pulse/streaming/processor.ts

@@ -11,7 +11,7 @@ export function createStreamingProcessor(
 	return new ReadableStream({
 		async start(controller) {
 			const encoder = new TextEncoder();
-			let accumulatedContent = "";
+			const accumulatedContent = "";
 
 			try {
 				// Stream only safe, user-facing content

agent-docs/src/agents/agent-pulse/tools.ts

@@ -33,7 +33,7 @@ export async function createTools(context: ToolContext) {
             // Validate tutorial exists before starting
             const tutorialResponse = await getTutorialMeta(tutorialId, agentContext);
             if (!tutorialResponse.success || !tutorialResponse.data) {
-                return `Error fetching tutorial information`;
+                return 'Error fetching tutorial information';
             }
 
             const data = tutorialResponse.data

app/(docs)/[[...slug]]/page.tsx

@@ -12,6 +12,7 @@ import { CLICommand } from '@/components/CLICommand';
 import { CodeExample } from '@/components/CodeExample';
 import { Mermaid } from '@/components/Mermaid';
 import { Sparkle } from '@/components/Sparkle';
+import { Tag } from '@/components/Tag';
 import { ThemeImage } from '@/components/ThemeImage';
 import { TypingAnimation } from '@/components/TypingAnimation';
 import { XButton } from '@/components/XButton';
@@ -44,7 +45,7 @@ export default async function Page(props: {
 				path: `content/${page.file.path}`,
 			}}
 		>
-			<div className="flex flex-col sm:flex-row sm:items-center sm:justify-between gap-3 sm:gap-0 mb-4">
+			<div className="flex flex-col sm:flex-row sm:items-center sm:justify-between gap-3 sm:gap-0">
 				<DocsTitle className="mb-0">{page.data.title}</DocsTitle>
 				<div className="hidden sm:flex justify-end">
 					<CopyPageDropdown enhanced={true} />
@@ -67,6 +68,7 @@ export default async function Page(props: {
 						Sparkle,
 						Tab,
 						Tabs,
+						Tag,
 						ThemeImage,
 						TutorialStep,
 						TypingAnimation,

app/(docs)/layout.tsx

@@ -4,6 +4,7 @@ import type { ReactNode } from 'react';
 import { baseOptions } from '@/app/layout.config';
 import { source } from '@/lib/source';
 import AISearchToggle from '../../components/AISearchToggle';
+import { SidebarFooter } from '../../components/SidebarFooter';
 
 export default function Layout({ children }: { children: ReactNode }) {
 	return (
@@ -20,6 +21,11 @@ export default function Layout({ children }: { children: ReactNode }) {
 					),
 				},
 			}}
+			sidebar={{
+				tabs: false,
+				// banner: <SidebarBanner />,
+				footer: <SidebarFooter />
+			}}
 		>
 			{children}
 		</DocsLayout>