Types

interface TaskResult {
  status: TaskStatus;
  output: string;
  steps: Step[];
  total_tokens: number;
  total_cost_usd: number;
  duration_ms: number;
}
 
type TaskStatus = "pending" | "running" | "completed" | "failed" | "cancelled";

interface Step {
  index: number;
  action: StepAction;
  result?: unknown;
  tokens_used: number;
  cost_usd: number;
  duration_ms: number;
}
 
type StepAction =
  | { type: "tool_call"; tool: string; input: Record<string, unknown>; tool_use_id: string }
  | { type: "response"; content: string }
  | { type: "error"; message: string };

interface ToolDefinition<TInput = unknown, TOutput = unknown> {
  name: string;
  description: string;
  parameters: Record<string, unknown>; // JSON Schema
  execute: (input: TInput, ctx: ExecutionContext) => Promise<TOutput>;
}

interface ExecutionContext {
  agent_name: string;
  task_id: string;
  step_index: number;
  mode: ExecutionMode;
  signal: AbortSignal;
}
 
type ExecutionMode = "local" | "cloud";

interface AgentConfig {
  name: string;
  description?: string;
  model: string;
  instructions: string | (() => string);
  max_steps: number;
  budget_usd?: number;
  tools: ToolDefinition[];
}

interface AgentDefinition {
  name: string;
  description?: string;
  model: string;
  instructions: string;
  max_steps: number;
  budget_usd?: number;
  tools: { name: string; description: string; parameters: Record<string, unknown> }[];
}

interface AgentMetadata {
  id: string;
  version: string;
  created_at: string;
  deployed_at?: string;
}

type RunStatus =
  | "queued"
  | "running"
  | "paused"
  | "completed"
  | "failed"
  | "cancelled"
  | "budget_exceeded";

interface CloudConfig {
  api_key: string;
  base_url: string; // default: "https://api.getpapayya.com"
}

interface LogEntry {
  timestamp: string;
  level: string;
  message: string;
}