march-start-cli 0.1.0

package/dist/template/env.example

@@ -0,0 +1,36 @@
+
+HOST=0.0.0.0
+PORT=8000
+
+GATEWAY_URL=your-gateway-url-here
+CONNECTION_SECURE=false 
+
+GATEWAY_API_KEY=your-gateway-key-here
+
+
+HEARTBEAT_INTERVAL=10
+
+AGENT_BASE_URL=http://localhost:8060
+
+
+OPENAI_API_KEY=your-open-api-key-here
+
+OPENAI_MODEL=gpt-4o-mini
+
+
+JWT_SECRET=your-secret-key-change-in-production
+
+JWT_ALGORITHM=HS256
+
+
+JWT_COOKIE_NAME=agent_token
+
+
+CORS_ORIGINS=*
+
+
+NEXT_PUBLIC_API_URL=http://localhost:8060
+
+
+
+DEBUG=true

package/dist/template/package.json

@@ -0,0 +1,27 @@
+{
+    "name": "march-agent-template-ts",
+    "version": "1.0.0",
+    "description": "TypeScript template agent for March AI platform",
+    "type": "module",
+    "main": "dist/agent.js",
+    "scripts": {
+        "dev": "tsx watch src/agent.ts",
+        "start": "node dist/agent.js",
+        "build": "tsc",
+        "typecheck": "tsc --noEmit"
+    },
+    "dependencies": {
+        "@langchain/openai": "^0.3.17",
+        "@langchain/langgraph": "^0.2.39",
+        "@langchain/langgraph-checkpoint": "^0.0.15",
+        "@langchain/core": "^0.3.30",
+        "ai": "^4.1.0",
+        "@ai-sdk/openai": "^1.1.0",
+        "dotenv": "^16.4.7"
+    },
+    "devDependencies": {
+        "@types/node": "^22.10.7",
+        "tsx": "^4.19.2",
+        "typescript": "^5.7.3"
+    }
+}

package/dist/template/src/agent.ts

@@ -0,0 +1,186 @@
+/**
+ * March Agent - TypeScript Template
+ *
+ * Run with: pnpm dev
+ *
+ * This template demonstrates:
+ * 1. Basic agent setup and message handling
+ * 2. Streaming responses with LangChain
+ * 3. Conversation history management
+ * 4. Attachment handling (images and files)
+ */
+
+import { config } from 'dotenv'
+import { resolve } from 'path'
+
+// Load environment variables from .env file
+const envPath = resolve(process.cwd(), '.env')
+config({ path: envPath, override: true })
+
+import { ChatOpenAI } from '@langchain/openai'
+import { HumanMessage, AIMessage, SystemMessage, type BaseMessage } from '@langchain/core/messages'
+
+// Import from local framework (change to 'march-ai-sdk' when published)
+import { MarchAgentApp, Message } from '../../ai-ts-framework/dist/index.js'
+
+// ============================================================================
+// CONFIGURATION
+// ============================================================================
+
+const AGENT_NAME = process.env.AGENT_NAME || 'my-agent'
+const AGENT_ABOUT = process.env.AGENT_ABOUT || 'A helpful AI assistant'
+
+const SYSTEM_PROMPT = `You are a helpful AI assistant. Your role is to assist users with their questions and tasks.
+
+Guidelines:
+1. Be helpful, accurate, and concise
+2. If you don't know something, say so honestly
+3. Provide clear explanations when needed
+4. Be friendly and professional`
+
+// ============================================================================
+// LLM SETUP
+// ============================================================================
+
+// Vision-capable model for image analysis
+const visionLlm = new ChatOpenAI({
+    model: process.env.OPENAI_VISION_MODEL || 'gpt-4o',
+    streaming: true,
+    openAIApiKey: process.env.OPENAI_API_KEY,
+})
+
+// Standard model for text-only interactions
+const llm = new ChatOpenAI({
+    model: process.env.OPENAI_MODEL || 'gpt-4o-mini',
+    streaming: true,
+    openAIApiKey: process.env.OPENAI_API_KEY,
+})
+
+// ============================================================================
+// APP INITIALIZATION
+// ============================================================================
+
+const app = new MarchAgentApp({
+    gatewayUrl: process.env.GATEWAY_URL || 'agent-gateway:8080',
+    apiKey: process.env.GATEWAY_API_KEY || 'agent-key',
+    heartbeatInterval: parseInt(process.env.HEARTBEAT_INTERVAL || '10'),
+    secure: process.env.CONNECTION_SECURE === 'true',
+})
+
+// ============================================================================
+// MAIN
+// ============================================================================
+
+async function main() {
+    const agent = await app.registerMe({
+        name: AGENT_NAME,
+        about: AGENT_ABOUT,
+        document: `${AGENT_NAME} is a helpful AI assistant built with the March Agent SDK.`,
+        representationName: AGENT_NAME,
+        baseUrl: process.env.AGENT_BASE_URL || 'http://localhost:8060',
+        metadata: { version: '1.0.0' },
+    })
+
+    // -------------------------------------------------------------------------
+    // MESSAGE HANDLER
+    // -------------------------------------------------------------------------
+
+    agent.onMessage(async (message: Message, sender: string) => {
+        const messages: BaseMessage[] = [new SystemMessage(SYSTEM_PROMPT)]
+
+        // Load conversation history
+        if (message.conversation) {
+            const history = await message.conversation.getAgentHistory({ limit: 20 })
+            for (const msg of history) {
+                if (msg.role === 'user') {
+                    messages.push(new HumanMessage(msg.content))
+                } else {
+                    messages.push(new AIMessage(msg.content))
+                }
+            }
+        }
+
+        // Check for attachments
+        let useVisionModel = false
+
+        if (message.hasAttachment() && message.attachment) {
+            const attachment = message.attachment
+            const isImage = attachment.contentType?.startsWith('image/')
+
+            if (isImage) {
+                // Handle image attachment with vision model
+                useVisionModel = true
+                try {
+                    const base64Image = await message.getAttachmentBase64()
+                    const userMessage = new HumanMessage({
+                        content: [
+                            { type: 'text', text: message.content || 'What do you see in this image?' },
+                            { type: 'image_url', image_url: { url: `data:${attachment.contentType};base64,${base64Image}` } },
+                        ],
+                    })
+                    messages.push(userMessage)
+                } catch (e) {
+                    // Fallback if image download fails
+                    messages.push(new HumanMessage(`${message.content}\n\n[Note: An image was attached but could not be processed]`))
+                }
+            } else {
+                // Other file types - mention them in the message
+                messages.push(new HumanMessage(`${message.content}\n\n[Attachment: ${attachment.filename}]`))
+            }
+        } else {
+            // Text-only message
+            messages.push(new HumanMessage(message.content))
+        }
+
+        // Select model based on content type
+        const selectedLlm = useVisionModel ? visionLlm : llm
+
+        // Create streamer for response
+        const streamer = agent.streamer(message)
+
+        // Set optional metadata
+        streamer.setMessageMetadata({
+            model: useVisionModel ? (process.env.OPENAI_VISION_MODEL || 'gpt-4o') : (process.env.OPENAI_MODEL || 'gpt-4o-mini'),
+            hasAttachment: message.hasAttachment(),
+        })
+
+        // Add artifacts for testing frontend rendering
+        streamer.addArtifact({
+            url: `/api/dashboard/${message.conversationId}`,
+            type: 'iframe',
+            title: 'Patient Dashboard',
+            description: 'Interactive dashboard showing conversation statistics',
+        })
+
+        streamer.addArtifact({
+            url: `/api/artifacts/document/${message.conversationId}`,
+            type: 'document',
+            title: 'Health Summary Report',
+            description: 'Comprehensive health summary document',
+        })
+
+        try {
+            // Stream response
+            const stream = await selectedLlm.stream(messages)
+            for await (const chunk of stream) {
+                if (chunk.content) {
+                    streamer.stream(chunk.content as string)
+                }
+            }
+        } catch (e) {
+            console.error('LLM error:', e)
+            streamer.stream('I apologize, but I encountered an error. Please try again.')
+        }
+
+        await streamer.finish()
+    })
+
+    // Start the agent
+    console.log(`Starting ${AGENT_NAME}...`)
+    await app.run()
+}
+
+main().catch((error: Error) => {
+    console.error('Failed to start agent:', error)
+    process.exit(1)
+})

package/dist/template/tsconfig.json

@@ -0,0 +1,27 @@
+{
+    "compilerOptions": {
+        "target": "ES2022",
+        "module": "ESNext",
+        "moduleResolution": "bundler",
+        "lib": [
+            "ES2022"
+        ],
+        "outDir": "./dist",
+        "rootDir": "./src",
+        "declaration": true,
+        "sourceMap": true,
+        "strict": true,
+        "esModuleInterop": true,
+        "skipLibCheck": true,
+        "forceConsistentCasingInFileNames": true,
+        "resolveJsonModule": true,
+        "isolatedModules": true
+    },
+    "include": [
+        "src/**/*"
+    ],
+    "exclude": [
+        "node_modules",
+        "dist"
+    ]
+}

package/package.json

@@ -0,0 +1,51 @@
+{
+    "name": "march-start-cli",
+    "version": "0.1.0",
+    "description": "CLI to scaffold new March AI agent projects",
+    "type": "module",
+    "bin": {
+        "march-start": "./dist/index.js"
+    },
+    "main": "./dist/index.js",
+    "files": [
+        "dist"
+    ],
+    "publishConfig": {
+        "access": "public"
+    },
+    "scripts": {
+        "build": "tsup",
+        "dev": "tsup --watch",
+        "typecheck": "tsc --noEmit",
+        "clean": "rm -rf dist",
+        "check-secrets": "tsx src/security.ts --check",
+        "prepublishOnly": "npm run check-secrets && npm run build"
+    },
+    "dependencies": {
+        "prompts": "^2.4.2",
+        "picocolors": "^1.1.1",
+        "fs-extra": "^11.2.0"
+    },
+    "devDependencies": {
+        "@types/fs-extra": "^11.0.4",
+        "@types/node": "^22.10.7",
+        "@types/prompts": "^2.4.9",
+        "tsup": "^8.3.5",
+        "tsx": "^4.19.2",
+        "typescript": "^5.7.3"
+    },
+    "engines": {
+        "node": ">=18"
+    },
+    "keywords": [
+        "march",
+        "agent",
+        "ai",
+        "sdk",
+        "cli",
+        "scaffold",
+        "generator"
+    ],
+    "author": "March Health",
+    "license": "MIT"
+}