V1 docs

.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>

app/api/sessions/[sessionId]/messages/route.ts

@@ -1,6 +1,6 @@
-import { NextRequest, NextResponse } from "next/server";
+import { type NextRequest, NextResponse } from "next/server";
 import { getKVValue, setKVValue } from "@/lib/kv-store";
-import {
+import type {
   Session,
   Message,
   StreamingChunk,
@@ -32,7 +32,7 @@ function sanitizeTitle(input: string): string {
   // Sentence case
   s = sentenceCase(s);
   // Trim trailing punctuation noise
-  s = s.replace(/[\s\-–—:;,\.]+$/g, '').trim();
+  s = s.replace(/[\s\-–—:;,.]+$/g, '').trim();
   // Enforce 60 chars
   if (s.length > 60) s = s.slice(0, 60).trim();
   return s;
@@ -99,7 +99,7 @@ export async function POST(
             content: (m.content || '').slice(0, MAX_CONTENT_LEN),
           }));
 
-        const prompt = `Generate a very short session title summarizing the conversation topic.\n\nRequirements:\n- sentence case\n- no emojis\n- <= 60 characters\n- no quotes or markdown\n- output the title only, no extra text`;
+        const prompt = 'Generate a very short session title summarizing the conversation topic.\n\nRequirements:\n- sentence case\n- no emojis\n- <= 60 characters\n- no quotes or markdown\n- output the title only, no extra text';
 
         const agentConfig = getAgentPulseConfig();
         const headers: Record<string, string> = { 'Content-Type': 'application/json' };
@@ -254,7 +254,7 @@ export async function POST(
 
     // Process streaming response
     let accumulatedContent = "";
-    let finalTutorialData: TutorialData | undefined = undefined;
+    let finalTutorialData: TutorialData | undefined ;
 
     const transformStream = new TransformStream({
       async transform(chunk, controller) {

app/api/sessions/[sessionId]/route.ts

@@ -1,6 +1,6 @@
-import { NextRequest, NextResponse } from 'next/server';
+import { type NextRequest, NextResponse } from 'next/server';
 import { getKVValue, setKVValue, deleteKVValue } from '@/lib/kv-store';
-import { Session, Message, SessionSchema } from '@/app/chat/types';
+import { type Session, type Message, SessionSchema } from '@/app/chat/types';
 import { toISOString } from '@/app/chat/utils/dateUtils';
 import { config } from '@/lib/config';
 import { parseAndValidateJSON, SessionMessageOnlyRequestSchema } from '@/lib/validation/middleware';

app/api/sessions/route.ts

@@ -1,6 +1,6 @@
-import { NextRequest, NextResponse } from 'next/server';
+import { type NextRequest, NextResponse } from 'next/server';
 import { getKVValue, setKVValue } from '@/lib/kv-store';
-import { Session, Message, SessionSchema } from '@/app/chat/types';
+import { type Session, type Message, SessionSchema } from '@/app/chat/types';
 import { toISOString } from '@/app/chat/utils/dateUtils';
 import { config } from '@/lib/config';
 import { parseAndValidateJSON } from '@/lib/validation/middleware';

app/api/tutorials/[id]/route.ts

@@ -1,4 +1,4 @@
-import { NextRequest, NextResponse } from 'next/server';
+import { type NextRequest, NextResponse } from 'next/server';
 import { join } from 'path';
 import { parseTutorialMDXCached } from '@/lib/tutorial/mdx-parser';
 import { TutorialIdParamsSchema } from '@/lib/tutorial/schemas';
@@ -39,7 +39,7 @@ export async function GET(request: NextRequest, { params }: RouteParams) {
       }
     });
   } catch (error) {
-    console.error(`Failed to load tutorial:`, error);
+    console.error('Failed to load tutorial:', error);
     return NextResponse.json(
       { success: false, error: 'Tutorial not found' },
       { status: 404 }

app/api/tutorials/[id]/steps/[stepNumber]/route.ts

@@ -1,4 +1,4 @@
-import { NextRequest, NextResponse } from 'next/server';
+import { type NextRequest, NextResponse } from 'next/server';
 import { join } from 'path';
 import { parseTutorialMDXCached } from '@/lib/tutorial/mdx-parser';
 import { StepParamsSchema } from '@/lib/tutorial/schemas';
@@ -49,7 +49,7 @@ export async function GET(request: NextRequest, { params }: RouteParams) {
       }
     });
   } catch (error) {
-    console.error(`Failed to load tutorial step:`, error);
+    console.error('Failed to load tutorial step:', error);
     return NextResponse.json(
       { success: false, error: 'Failed to load step' },
       { status: 500 }

app/api/users/tutorial-state/route.ts

@@ -1,4 +1,4 @@
-import { NextRequest, NextResponse } from 'next/server';
+import { type NextRequest, NextResponse } from 'next/server';
 import { TutorialStateManager } from '@/lib/tutorial/state-manager';
 import { setKVValue } from '@/lib/kv-store';
 import { config } from '@/lib/config';

app/chat/SessionContext.tsx

@@ -1,6 +1,6 @@
 'use client';
 import { createContext, useContext } from 'react';
-import { Session } from './types';
+import type { Session } from './types';
 
 interface SessionContextType {
   sessions: Session[];

app/chat/[sessionId]/page.tsx

@@ -7,7 +7,7 @@ import "allotment/dist/style.css";
 import { v4 as uuidv4 } from 'uuid';
 import { ChatMessagesArea } from '../components/ChatMessagesArea';
 import { CodeEditor } from '../components/CodeEditor';
-import { Session, Message } from '../types';
+import type { Session, Message } from '../types';
 import { useSessions } from '../SessionContext';
 import { sessionService } from '../services/sessionService';
 import { Skeleton } from '@/components/ui/skeleton';

app/chat/components/ChatInput.tsx

@@ -1,6 +1,6 @@
 'use client';
 
-import { useEffect, KeyboardEvent, useState } from 'react';
+import { useEffect, type KeyboardEvent, useState } from 'react';
 import { Send } from 'lucide-react';
 import { useAutoResize } from '../utils/useAutoResize';
 

app/chat/components/ChatMessage.tsx

@@ -6,7 +6,7 @@ import { AgentuityLogo } from '@/components/icons/AgentuityLogo';
 import { MarkdownRenderer } from './MarkdownRenderer';
 import type { TutorialSnippet } from '../types';
 import { formatTime } from '../utils/dateUtils';
-import { TutorialData } from '../types';
+import type { TutorialData } from '../types';
 
 function transformMdxWithSnippets(mdx: string, snippets: TutorialSnippet[] = []) {
     // Replace each <CodeFromFiles .../> by consuming the appropriate number of snippets

app/chat/components/ChatMessagesArea.tsx

@@ -3,7 +3,7 @@
 import React, { useRef, useEffect,useState } from 'react';
 import { ChatMessageComponent } from './ChatMessage';
 import { ChatInput } from './ChatInput';
-import { Session } from '../types';
+import type { Session } from '../types';
 
 export interface ChatMessagesAreaProps {
     session: Session

app/chat/components/CodeEditor.tsx

@@ -1,4 +1,5 @@
-import React, { useState } from 'react';
+import type React from 'react';
+import { useState } from 'react';
 import { Play, Terminal, Square, Power, Code, X } from 'lucide-react';
 
 enum TabType {

app/chat/components/SessionSidebar.tsx

@@ -9,7 +9,7 @@ import {
   ChevronRight
 } from 'lucide-react';
 import { AgentuityLogo } from '@/components/icons/AgentuityLogo';
-import { Session, SessionSidebarProps } from '../types';
+import type { Session, SessionSidebarProps } from '../types';
 
 // Helper function to format relative dates
 const formatRelativeDate = (date: Date): string => {

app/chat/components/TutorialFileChip.tsx

@@ -1,6 +1,6 @@
 import React from 'react';
 import { FileText } from 'lucide-react';
-import { CodeFile } from '../types';
+import type { CodeFile } from '../types';
 
 interface TutorialFileChipProps {
     codeBlock: CodeFile;

app/chat/layout.tsx

@@ -1,7 +1,7 @@
  'use client';
 
 import { usePathname, useRouter } from "next/navigation";
-import { Session } from "./types";
+import type { Session } from "./types";
 import { sessionService } from "./services/sessionService";
 import { SessionSidebar } from "./components/SessionSidebar";
  import { SessionSidebarSkeleton } from './components/SessionSidebarSkeleton';

app/chat/services/sessionService.ts

@@ -1,4 +1,4 @@
-import { Session, Message, TutorialData } from '../types';
+import type { Session, Message, TutorialData } from '../types';
 
 export interface SessionServiceResponse<T = any> {
   success: boolean;

app/chat/utils/useStreaming.ts

@@ -1,5 +1,5 @@
 import { useState, useCallback } from 'react';
-import { Message, TutorialData, StreamingChunk } from '../types';
+import type { Message, TutorialData, StreamingChunk } from '../types';
 import { getCurrentTimestamp } from './dateUtils';
 
 // Generate unique IDs
@@ -72,7 +72,7 @@ export function useStreaming({
       const reader = response.body?.getReader();
       const decoder = new TextDecoder();
       let accumulatedContent = '';
-      let finalTutorialData: TutorialData | undefined = undefined;
+      let finalTutorialData: TutorialData | undefined ;
 
       if (!reader) {
         throw new Error('No response body');

app/global.css

@@ -32,7 +32,7 @@
 	--color-gray-900: var(--color-zinc-900);
 	--color-gray-950: var(--color-zinc-950);
 
-	/* Cyan accents - using production's shades for readability */
+	/* Cyan accents */
 	--color-fd-primary: var(--color-cyan-700);
 	--color-fd-primary-foreground: var(--color-cyan-50);
 	--color-fd-ring: var(--color-cyan-500);
@@ -131,3 +131,12 @@ figure > div:nth-child(2) {
 article > p {
 	margin-bottom: 1rem;
 }
+
+/* Content links - cyan branding (700 light, 500 dark) */
+.prose a:not([data-card]) {
+	text-decoration-color: var(--color-cyan-700);
+}
+
+.dark .prose a:not([data-card]) {
+	text-decoration-color: var(--color-cyan-500);
+}

app/layout.config.tsx

@@ -8,9 +8,9 @@ import { XButton } from '../components/XButton';
  */
 export const baseOptions: BaseLayoutProps = {
 	nav: {
-		url: '/Introduction',
+		url: '/Get-Started/what-is-agentuity',
 		title: (
-			<div className="flex items-center gap-3 font-medium">
+			<div className="flex items-center gap-3 font-medium ml-2">
 				<svg
 					role="img"
 					aria-label="Agentuity"
@@ -54,7 +54,7 @@ export const baseOptions: BaseLayoutProps = {
 						target="_blank"
 						rel="noopener noreferrer"
 					>
-						Console
+						App
 					</NavButton>
 					<CommunityButton target="_blank" rel="noopener noreferrer" />
 					<XButton className="h-9" />