AI Agent

import { CMDOPClient } from '@cmdop/node';
import { z } from 'zod';
 
// Connect and select the target machine for agent tasks
const client = await CMDOPClient.remote({ apiKey: 'cmdop_xxx' });
await client.agent.setMachine('my-server');

// Define a Zod schema for the expected structured output
const ServerHealth = z.object({
  hostname: z.string(),
  cpuPercent: z.number(),
  memoryPercent: z.number(),
  issues: z.array(z.string()),
});
 
// Run the agent -- it executes the prompt and returns data matching the schema
const result = await client.agent.run({
  prompt: 'Check server health and report issues',
  outputSchema: ServerHealth,
});
 
// result.data is fully typed as { hostname: string; cpuPercent: number; ... }
console.log(result.data.cpuPercent);

// Run without a schema -- returns unstructured text output
const result = await client.agent.run({
  prompt: 'Describe the current server state',
});
 
console.log(result.text);

// Start a streaming agent task with real-time progress events
const stream = client.agent.stream({
  prompt: 'Analyze disk usage and suggest cleanup',
  outputSchema: DiskReport,
});
 
// Listen for progress events as the agent works
stream.onProgress((event) => {
  console.log(event.type, event.message);
});
 
// Await the final structured result when the agent completes
const result = await stream.completed;
console.log(result.data);

// Auto mode (default) -- agent decides which tools to use
const result = await client.agent.run({
  prompt: 'Check server health',
  mode: 'auto',
});
 
// Terminal mode -- agent can only execute shell commands
const result = await client.agent.run({
  prompt: 'Find large files',
  mode: 'terminal',
});
 
// Readonly mode -- agent can read files/state but cannot modify anything
const result = await client.agent.run({
  prompt: 'Audit the configuration',
  mode: 'readonly',
});

// Define a deeply nested schema with enums, optionals, and descriptions
const DeployReport = z.object({
  success: z.boolean(),
  version: z.string(),
  services: z.array(z.object({
    name: z.string(),
    status: z.enum(['running', 'stopped', 'error']),
    port: z.number().optional(),           // Port is optional for non-networked services
  })),
  errors: z.array(z.string()),
  duration: z.number().describe('Duration in seconds'),  // .describe() adds context for the AI
});
 
// The agent interprets the schema and returns matching structured data
const result = await client.agent.run({
  prompt: 'Deploy the latest version and report status',
  outputSchema: DeployReport,
});