@multiplayer-app/ai-agent-node 0.0.1

package/src/tools/generateChartTool.ts

@@ -0,0 +1,131 @@
+import { tool } from 'ai'
+import { z } from 'zod'
+
+export const generateChartToolName = 'generate-chart'
+
+/**
+ * Tool for generating chart visualizations from various data sources.
+ * The tool returns structured data that the frontend renderer can visualize.
+ */
+export const createGenerateChartTool = () =>
+  tool({
+    title: generateChartToolName,
+    description:
+      'Create visualizations from data sources. Supports stock prices, exchange rates, weather data, and custom datasets. Returns structured chart data for rendering.',
+    inputSchema: z.object({
+      chartType: z.enum(['line', 'bar', 'area', 'pie']).describe('Type of chart to generate'),
+      dataSource: z.enum(['stock', 'exchange', 'weather', 'custom']).describe('Source of data for the chart'),
+      symbol: z.string().optional().describe('Stock ticker, currency pair, or location identifier'),
+      timeframe: z.enum(['1d', '1w', '1m', '3m', '1y']).optional().describe('Time period for data')
+    }),
+    outputSchema: z.object({
+      chartType: z.enum(['line', 'bar', 'area', 'pie']),
+      dataSource: z.string(),
+      symbol: z.string().optional(),
+      timeframe: z.string().optional(),
+      title: z.string(),
+      yAxisLabel: z.string(),
+      data: z.array(
+        z.object({
+          date: z.string(),
+          value: z.number(),
+          label: z.string().optional()
+        })
+      )
+    }),
+    execute: async (input) => {
+      // Generate mock data based on data source
+      let data: Array<{ date: string; value: number; label?: string }> = []
+      let title = ''
+      let yAxisLabel = ''
+
+      if (input.dataSource === 'stock') {
+        title = `${input.symbol || 'AAPL'} Stock Price (${input.timeframe || '1m'})`
+        yAxisLabel = 'Price ($)'
+        const basePrice = input.symbol === 'AAPL' ? 175 : input.symbol === 'GOOGL' ? 140 : input.symbol === 'MSFT' ? 380 : 100
+        const days = input.timeframe === '1d' ? 24 : input.timeframe === '1w' ? 7 : input.timeframe === '1m' ? 30 : input.timeframe === '3m' ? 90 : 365
+        const interval = input.timeframe === '1d' ? 'hour' : 'day'
+
+        for (let i = days; i >= 0; i--) {
+          const date = new Date()
+          if (interval === 'hour') {
+            date.setHours(date.getHours() - i)
+          } else {
+            date.setDate(date.getDate() - i)
+          }
+          const variation = (Math.random() - 0.5) * 0.1
+          const trend = (days - i) / days * 0.15
+          const value = basePrice * (1 + trend + variation)
+          data.push({
+            date:
+              interval === 'hour'
+                ? date.toLocaleTimeString('en-US', { hour: '2-digit', minute: '2-digit' })
+                : date.toLocaleDateString('en-US', { month: 'short', day: 'numeric' }),
+            value: Math.round(value * 100) / 100
+          })
+        }
+      } else if (input.dataSource === 'exchange') {
+        title = `${input.symbol || 'EUR/USD'} Exchange Rate (${input.timeframe || '1m'})`
+        yAxisLabel = 'Rate'
+        const baseRate = input.symbol === 'EUR/USD' ? 1.08 : input.symbol === 'GBP/USD' ? 1.27 : input.symbol === 'JPY/USD' ? 0.0067 : 1.0
+        const days = input.timeframe === '1d' ? 24 : input.timeframe === '1w' ? 7 : input.timeframe === '1m' ? 30 : 90
+
+        for (let i = days; i >= 0; i--) {
+          const date = new Date()
+          date.setDate(date.getDate() - i)
+          const variation = (Math.random() - 0.5) * 0.02
+          const value = baseRate * (1 + variation)
+          data.push({
+            date: date.toLocaleDateString('en-US', { month: 'short', day: 'numeric' }),
+            value: Math.round(value * 10000) / 10000
+          })
+        }
+      } else if (input.dataSource === 'weather') {
+        title = `Weather in ${input.symbol || 'NYC'} (${input.timeframe || '1d'})`
+        yAxisLabel = 'Temperature (°F)'
+        const days = input.timeframe === '1d' ? 24 : input.timeframe === '1w' ? 7 : 30
+        const baseTemp = 65
+
+        for (let i = days; i >= 0; i--) {
+          const date = new Date()
+          if (input.timeframe === '1d') {
+            date.setHours(date.getHours() - i)
+          } else {
+            date.setDate(date.getDate() - i)
+          }
+          const hourOfDay = date.getHours()
+          const dailyVariation = Math.sin((hourOfDay / 24) * Math.PI * 2) * 15
+          const randomVariation = (Math.random() - 0.5) * 5
+          const value = baseTemp + dailyVariation + randomVariation
+          data.push({
+            date:
+              input.timeframe === '1d'
+                ? date.toLocaleTimeString('en-US', { hour: '2-digit', minute: '2-digit' })
+                : date.toLocaleDateString('en-US', { month: 'short', day: 'numeric' }),
+            value: Math.round(value)
+          })
+        }
+      } else {
+        // Custom data
+        title = 'Custom Dataset'
+        yAxisLabel = 'Value'
+        for (let i = 0; i < 10; i++) {
+          data.push({
+            date: `Item ${i + 1}`,
+            value: Math.round(Math.random() * 100),
+            label: `Category ${i + 1}`
+          })
+        }
+      }
+
+      return {
+        chartType: input.chartType,
+        dataSource: input.dataSource,
+        symbol: input.symbol,
+        timeframe: input.timeframe,
+        title,
+        yAxisLabel,
+        data
+      }
+    }
+  })

package/src/tools/proposeFormValuesTool.ts

@@ -0,0 +1,67 @@
+import { tool } from 'ai'
+import { z } from 'zod'
+
+export const proposeFormValuesToolName = 'propose_form_values'
+
+/**
+ * A no-side-effect tool: it exists to force the model to emit structured form fill proposals.
+ * The UI will render these proposals and the host app will decide what to apply.
+ */
+export const createProposeFormValuesTool = () =>
+  tool({
+    title: proposeFormValuesToolName,
+    description:
+      'Propose values to fill in a form. Use only allowed select options. Do not apply changes; just propose.',
+    inputSchema: z.object({
+      formId: z.string().min(1),
+      formName: z.string().min(1).optional(),
+      fields: z
+        .array(
+          z.object({
+            name: z.string().min(1),
+            label: z.string().min(1),
+            value: z.string(),
+            inputType: z
+              .enum(['text', 'textarea', 'number', 'select', 'radio', 'checkbox', 'date', 'email', 'tel'])
+              .optional(),
+            options: z
+              .array(
+                z.object({
+                  value: z.string(),
+                  label: z.string()
+                })
+              )
+              .optional()
+          })
+        )
+        .min(1),
+      notes: z.string().optional()
+    }),
+    outputSchema: z.object({
+      formId: z.string(),
+      formName: z.string().optional(),
+      fields: z.array(
+        z.object({
+          name: z.string(),
+          label: z.string(),
+          value: z.string(),
+          inputType: z
+            .enum(['text', 'textarea', 'number', 'select', 'radio', 'checkbox', 'date', 'email', 'tel'])
+            .optional(),
+          options: z
+            .array(
+              z.object({
+                value: z.string(),
+                label: z.string()
+              })
+            )
+            .optional()
+        })
+      ),
+      notes: z.string().optional()
+    }),
+    execute: async (input) => {
+      // Preserve structured output. No I/O, no mutations.
+      return input
+    }
+  })

package/tsconfig.json

@@ -0,0 +1,24 @@
+{
+  "extends": "../../tsconfig.base.json",
+  "compilerOptions": {
+    "composite": true,
+    "rootDir": "src",
+    "outDir": "dist",
+    "module": "ES2022",
+    "target": "ES2018",
+    "moduleResolution": "node",
+    "noImplicitAny": false
+  },
+  "include": ["src"],
+  "references": [
+    {
+      "path": "../ai-agent-types/tsconfig.json"
+    },
+    {
+      "path": "../ai-agent-db-mongo/tsconfig.json"
+    },
+    {
+      "path": "../ai-agent-db-lib/tsconfig.json"
+    }
+  ]
+}