feat: add 90 line max prettier rule for code snippets

Author: Owen Kaplan

AGENTS.md

@@ -124,8 +124,10 @@ All checks must pass before commit is allowed.
 - No semicolons
 - Single quotes
 - Line length: 120 characters
+- Line length for doc snippet files under `src/content/docs/`: 90 characters
 - Tab width: 2 spaces
 - Trailing commas in ES5 style
+- Template literal contents in doc snippets must also stay under 90 characters per line. Prettier does not enforce this automatically.
 
 **Example**:
 ```typescript
@@ -288,8 +290,8 @@ const result = await agent.invoke('Hello')
 {
   "scripts": {
     "test": "tsc --noEmit",
-    "format": "prettier --write docs",
-    "format:check": "prettier --check docs"
+    "format": "prettier --write docs 'src/content/docs/**/*.ts'",
+    "format:check": "prettier --check docs 'src/content/docs/**/*.ts'"
   }
 }
 ```

package.json

@@ -9,8 +9,8 @@
     "test": "vitest run",
     "typecheck": "tsc --noEmit",
     "typecheck:snippets": "npm run typecheck --prefix test-snippets",
-    "format": "prettier --write docs",
-    "format:check": "prettier --check docs",
+    "format": "prettier --write docs 'src/content/docs/**/*.ts'",
+    "format:check": "prettier --check docs 'src/content/docs/**/*.ts'",
     "clean": "rm -rf .build && rm -rf .astro",
     "preview": "astro preview",
     "cms:build": "npm run build:all",
@@ -76,6 +76,14 @@
     "singleQuote": true,
     "printWidth": 120,
     "tabWidth": 2,
-    "trailingComma": "es5"
+    "trailingComma": "es5",
+    "overrides": [
+      {
+        "files": "src/content/docs/**/*.ts",
+        "options": {
+          "printWidth": 90
+        }
+      }
+    ]
   }
 }

src/content/docs/readme.ts

@@ -3,9 +3,9 @@
 import { Agent } from '@strands-agents/sdk'
 
 // Create an agent with default settings
-const agent = new Agent();
+const agent = new Agent()
 
 // Ask the agent a question
-const response = await agent.invoke("Tell me about agentic AI");
-console.log(response.lastMessage);
+const response = await agent.invoke('Tell me about agentic AI')
+console.log(response.lastMessage)
 // --8<-- [end:basicAgent]

src/content/docs/user-guide/concepts/agents/conversation-management.mdx

@@ -302,7 +302,7 @@ agent = Agent(
 </Tab>
 </Tabs>
 
-Key features:
+#### Key Features
 
 - **Context Window Management**: Automatically reduces context when token limits are exceeded
 - **Intelligent Summarization**: Uses structured bullet-point summaries to capture key information

src/content/docs/user-guide/concepts/agents/conversation-management.ts

@@ -1,4 +1,12 @@
-import { Agent, ConversationManager, AfterInvocationEvent, NullConversationManager, SlidingWindowConversationManager, SummarizingConversationManager, BedrockModel } from '@strands-agents/sdk'
+import {
+  Agent,
+  ConversationManager,
+  AfterInvocationEvent,
+  NullConversationManager,
+  SlidingWindowConversationManager,
+  SummarizingConversationManager,
+  BedrockModel,
+} from '@strands-agents/sdk'
 import type { LocalAgent, ConversationManagerReduceOptions } from '@strands-agents/sdk'
 
 async function nullConversationManagerAgent() {
@@ -93,13 +101,16 @@ async function summarizingCustom() {
 async function summarizingSystemPrompt() {
   // --8<-- [start:summarizing_conversation_manager_system_prompt]
   // Custom system prompt for technical conversations
-  const customSystemPrompt = `You are summarizing a technical conversation. Create a concise bullet-point summary that:
+  const customSystemPrompt = `
+You are summarizing a technical conversation.
+Create a concise bullet-point summary that:
 - Focuses on code changes, architectural decisions, and technical solutions
 - Preserves specific function names, file paths, and configuration details
 - Omits conversational elements and focuses on actionable information
 - Uses technical terminology appropriate for software development
 
-Format as bullet points without conversational language.`
+Format as bullet points without conversational language.
+`
 
   const conversationManager = new SummarizingConversationManager({
     summarizationSystemPrompt: customSystemPrompt,

src/content/docs/user-guide/concepts/agents/conversation-management_imports.ts

@@ -9,11 +9,21 @@ import { Agent, SlidingWindowConversationManager } from '@strands-agents/sdk'
 // --8<-- [end:sliding_window_conversation_manager_imports]
 
 // --8<-- [start:custom_conversation_manager_imports]
-import { Agent, ConversationManager, type ConversationManagerReduceOptions } from '@strands-agents/sdk'
+import {
+  Agent,
+  ConversationManager,
+  type ConversationManagerReduceOptions,
+} from '@strands-agents/sdk'
 // --8<-- [end:custom_conversation_manager_imports]
 
 // --8<-- [start:custom_conversation_manager_proactive_imports]
-import { Agent, ConversationManager, AfterInvocationEvent, type AgentData, type ConversationManagerReduceOptions } from '@strands-agents/sdk'
+import {
+  Agent,
+  ConversationManager,
+  AfterInvocationEvent,
+  type AgentData,
+  type ConversationManagerReduceOptions,
+} from '@strands-agents/sdk'
 // --8<-- [end:custom_conversation_manager_proactive_imports]
 
 // --8<-- [start:summarizing_conversation_manager_basic_imports]

src/content/docs/user-guide/concepts/agents/hooks.ts

@@ -9,7 +9,12 @@ import {
   AfterModelCallEvent,
   MessageAddedEvent,
 } from '@strands-agents/sdk'
-import { Graph, Swarm, BeforeNodeCallEvent, AfterNodeCallEvent } from '@strands-agents/sdk/multiagent'
+import {
+  Graph,
+  Swarm,
+  BeforeNodeCallEvent,
+  AfterNodeCallEvent,
+} from '@strands-agents/sdk/multiagent'
 import type { MultiAgent, MultiAgentPlugin } from '@strands-agents/sdk/multiagent'
 
 // Mock tools for examples
@@ -108,7 +113,9 @@ async function resultModificationExample() {
     private processResult(event: AfterToolCallEvent): void {
       if (event.toolUse.name === 'calculator') {
         // Add formatting to calculator results
-        const textContent = event.result.content.find((block) => block.type === 'textBlock')
+        const textContent = event.result.content.find(
+          (block) => block.type === 'textBlock'
+        )
         if (textContent && textContent.type === 'textBlock') {
           // Note: In actual implementation, result modification may work differently
           console.log(`Would modify result: ${textContent.text}`)
@@ -162,7 +169,9 @@ async function loggingModificationsExample() {
 
     private processResult(event: AfterToolCallEvent): void {
       if (event.toolUse.name === 'calculator') {
-        const textContent = event.result.content.find((block) => block.type === 'textBlock')
+        const textContent = event.result.content.find(
+          (block) => block.type === 'textBlock'
+        )
         if (textContent && textContent.type === 'textBlock') {
           const originalContent = textContent.text
           console.log(`Modifying calculator result: ${originalContent}`)
@@ -230,8 +239,14 @@ async function fixedToolArgumentsExample() {
 
 async function orchestratorCallbackExample() {
   // --8<-- [start:orchestrator_callback]
-  const researcher = new Agent({ id: 'researcher', systemPrompt: 'You are a research specialist.' })
-  const writer = new Agent({ id: 'writer', systemPrompt: 'You are a writing specialist.' })
+  const researcher = new Agent({
+    id: 'researcher',
+    systemPrompt: 'You are a research specialist.',
+  })
+  const writer = new Agent({
+    id: 'writer',
+    systemPrompt: 'You are a writing specialist.',
+  })
 
   const graph = new Graph({
     nodes: [researcher, writer],
@@ -251,9 +266,18 @@ async function orchestratorCallbackExample() {
 
 async function conditionalNodeExecutionExample() {
   // --8<-- [start:conditional_node_execution]
-  const researcher = new Agent({ id: 'researcher', systemPrompt: 'You are a research specialist.' })
-  const writer = new Agent({ id: 'writer', systemPrompt: 'You are a writing specialist.' })
-  const reviewer = new Agent({ id: 'reviewer', systemPrompt: 'You are a review specialist.' })
+  const researcher = new Agent({
+    id: 'researcher',
+    systemPrompt: 'You are a research specialist.',
+  })
+  const writer = new Agent({
+    id: 'writer',
+    systemPrompt: 'You are a writing specialist.',
+  })
+  const reviewer = new Agent({
+    id: 'reviewer',
+    systemPrompt: 'You are a review specialist.',
+  })
 
   const graph = new Graph({
     nodes: [researcher, writer, reviewer],

src/content/docs/user-guide/concepts/agents/session-manager.ts

@@ -1,6 +1,11 @@
 import { Agent, SessionManager, FileStorage } from '@strands-agents/sdk'
 import { S3Storage } from '@strands-agents/sdk/session/s3-storage'
-import type { SnapshotStorage, SnapshotLocation, Snapshot, SnapshotManifest } from '@strands-agents/sdk'
+import type {
+  SnapshotStorage,
+  SnapshotLocation,
+  Snapshot,
+  SnapshotManifest,
+} from '@strands-agents/sdk'
 import { S3Client } from '@aws-sdk/client-s3'
 
 // =====================
@@ -61,8 +66,9 @@ async function s3StorageExample() {
     storage: {
       snapshot: new S3Storage({
         bucket: 'my-agent-sessions',
-        prefix: 'production',           // Optional key prefix
-        s3Client: new S3Client({        // Optional pre-configured client
+        prefix: 'production', // Optional key prefix
+        s3Client: new S3Client({
+          // Optional pre-configured client
           region: 'us-west-2',
         }),
         // Alternatively, use region directly (cannot be combined with s3Client):
@@ -104,8 +110,8 @@ async function snapshotTriggerExample() {
   })
 
   const agent = new Agent({ sessionManager: session })
-  await agent.invoke('First message')   // 2 messages — no snapshot
-  await agent.invoke('Second message')  // 4 messages — immutable snapshot created
+  await agent.invoke('First message') // 2 messages — no snapshot
+  await agent.invoke('Second message') // 4 messages — immutable snapshot created
   // --8<-- [end:snapshot_trigger]
 }
 
@@ -116,7 +122,11 @@ async function snapshotTriggerExample() {
 async function listAndRestoreExample() {
   // --8<-- [start:list_and_restore]
   const storage = new FileStorage('./sessions')
-  const location = { sessionId: 'my-session', scope: 'agent' as const, scopeId: 'default' }
+  const location = {
+    sessionId: 'my-session',
+    scope: 'agent' as const,
+    scopeId: 'default',
+  }
 
   // List all immutable snapshot IDs (chronological order)
   const snapshotIds = await storage.listSnapshotIds({ location })
@@ -129,7 +139,10 @@ async function listAndRestoreExample() {
   })
 
   // Restore agent to a specific checkpoint
-  const session = new SessionManager({ sessionId: 'my-session', storage: { snapshot: storage } })
+  const session = new SessionManager({
+    sessionId: 'my-session',
+    storage: { snapshot: storage },
+  })
   const agent = new Agent({ sessionManager: session })
   await agent.initialize()
   await session.restoreSnapshot({ target: agent, snapshotId: snapshotIds[0]! })
@@ -144,21 +157,36 @@ async function customStorageExample() {
   // --8<-- [start:custom_storage]
   // Implement SnapshotStorage to plug in any backend (database, Redis, etc.)
   class MyStorage implements SnapshotStorage {
-    async saveSnapshot({ location, snapshotId, snapshot }: {
-      location: SnapshotLocation; snapshotId: string; isLatest: boolean; snapshot: Snapshot
+    async saveSnapshot({
+      location,
+      snapshotId,
+      snapshot,
+    }: {
+      location: SnapshotLocation
+      snapshotId: string
+      isLatest: boolean
+      snapshot: Snapshot
     }) {
       // Store the snapshot JSON keyed by location + snapshotId
     }
 
-    async loadSnapshot({ location, snapshotId }: {
-      location: SnapshotLocation; snapshotId?: string
+    async loadSnapshot({
+      location,
+      snapshotId,
+    }: {
+      location: SnapshotLocation
+      snapshotId?: string
     }) {
       // Return the snapshot for the given location, or null if not found
       return null
     }
 
-    async listSnapshotIds({ location }: {
-      location: SnapshotLocation; limit?: number; startAfter?: string
+    async listSnapshotIds({
+      location,
+    }: {
+      location: SnapshotLocation
+      limit?: number
+      startAfter?: string
     }) {
       // Return immutable snapshot IDs sorted chronologically
       return []
@@ -168,13 +196,21 @@ async function customStorageExample() {
       // Remove all stored data for this session
     }
 
-    async loadManifest({ location }: { location: SnapshotLocation }): Promise<SnapshotManifest> {
+    async loadManifest({
+      location,
+    }: {
+      location: SnapshotLocation
+    }): Promise<SnapshotManifest> {
       // Return the manifest for the given location
       return { schemaVersion: '1', updatedAt: new Date().toISOString() }
     }
 
-    async saveManifest({ location, manifest }: {
-      location: SnapshotLocation; manifest: SnapshotManifest
+    async saveManifest({
+      location,
+      manifest,
+    }: {
+      location: SnapshotLocation
+      manifest: SnapshotManifest
     }) {
       // Persist the manifest
     }

src/content/docs/user-guide/concepts/agents/state.ts

@@ -44,11 +44,11 @@ async function conversationManagerExample() {
   // Create a conversation manager with custom window size
   // By default, SlidingWindowConversationManager is used even if not specified
   const conversationManager = new SlidingWindowConversationManager({
-    windowSize: 10
+    windowSize: 10,
   })
-  
+
   const agent = new Agent({
-    conversationManager
+    conversationManager,
   })
   // --8<-- [end:conversation_manager]
 }

src/content/docs/user-guide/concepts/agents/structured-output.ts

@@ -141,8 +141,12 @@ async function multipleOutputTypes() {
   const personAgent = new Agent({ structuredOutputSchema: PersonSchema })
   const taskAgent = new Agent({ structuredOutputSchema: TaskSchema })
 
-  const personResult = await personAgent.invoke('Extract person: John Doe, 35, john@test.com')
-  const taskResult = await taskAgent.invoke('Create task: Review code, high priority, completed')
+  const personResult = await personAgent.invoke(
+    'Extract person: John Doe, 35, john@test.com'
+  )
+  const taskResult = await taskAgent.invoke(
+    'Create task: Review code, high priority, completed'
+  )
   // --8<-- [end:multiple_types]
 }
 
@@ -164,7 +168,9 @@ async function conversationHistory() {
   await agent.invoke('Tell me about the weather there in spring.')
 
   // Extract structured information from the conversation
-  const result = await agent.invoke('Extract structured information about Paris from our conversation')
+  const result = await agent.invoke(
+    'Extract structured information about Paris from our conversation'
+  )
 
   const cityInfo = result.structuredOutput as CityInfo
   console.log(`City: ${cityInfo.city}`) // "Paris"
@@ -214,7 +220,9 @@ async function overridingDefaults() {
 
   // Create a new agent with CompanyInfo schema for this specific use case
   const companyAgent = new Agent({ structuredOutputSchema: CompanySchema })
-  const result = await companyAgent.invoke('TechCorp is a software company with 500 employees')
+  const result = await companyAgent.invoke(
+    'TechCorp is a software company with 500 employees'
+  )
 
   const company = result.structuredOutput as Company
   console.log(`Company: ${company.name}`) // "TechCorp"