Agent Runtime & Orchestration

// SkyAIApp Agent Runtime - Tool Definition & Execution
import { SkyAI, defineTool } from '@skyaiapp/sdk';

const client = new SkyAI({ apiKey: process.env.SKYAI_API_KEY });

// Define tools with type-safe schemas
const searchTool = defineTool({
  name: "web_search",
  description: "Search the web for current information",
  parameters: {
    query: { type: "string", description: "Search query" },
    maxResults: { type: "number", default: 5 },
  },
  // Sandboxed execution with timeout
  execute: async ({ query, maxResults }) => {
    const results = await searchAPI.search(query, maxResults);
    return results;
  },
  permissions: ["network:read"],  // Fine-grained permissions
  timeout: 10000,  // 10s timeout
  retries: 3,
});

// Create agent with tools
const response = await client.agents.run({
  model: "gpt-4o",
  tools: [searchTool, calculatorTool, databaseTool],
  messages: [
    { role: "user", content: "What's the latest news about AI?" }
  ],
  
  // Runtime configuration
  runtime: {
    maxSteps: 10,  // Max tool call iterations
    timeout: 60000,  // Overall timeout
    idempotencyKey: "user-123-request-456",  // Prevent duplicate execution
  },
  
  // Enable full observability
  tracing: {
    enabled: true,
    includeInputs: true,
    includeOutputs: true,
  },
});

// Access execution trace
console.log(response.trace);  // Full execution history
console.log(response.toolCalls);  // All tool invocations