@rodrigocoliveira/agno-types

TypeScript type definitions for Agno client libraries.

Installation

npm install @rodrigocoliveira/agno-types

This package is automatically included when you install @rodrigocoliveira/agno-client or @rodrigocoliveira/agno-react.

Usage

import type {
  AgnoClientConfig,
  ChatMessage,
  ToolCall,
  SessionEntry,
  AgentDetails,
  TeamDetails,
  RunEvent,
} from '@rodrigocoliveira/agno-types';

Type Definitions

Configuration

AgnoClientConfig

Client configuration options.

interface AgnoClientConfig {
  endpoint: string;
  authToken?: string;
  mode?: 'agent' | 'team';
  agentId?: string;
  teamId?: string;
  dbId?: string;
  sessionId?: string;
}

Messages

ChatMessage

Chat message structure.

interface ChatMessage {
  role: 'user' | 'agent' | 'system' | 'tool';
  content: string;
  tool_calls?: ToolCall[];
  extra_data?: MessageExtraData;
  images?: ImageData[];
  videos?: VideoData[];
  audio?: AudioData[];
  response_audio?: ResponseAudioData;
  created_at: number;
  streamingError?: boolean;
}

ToolCall

Tool call information.

interface ToolCall {
  role: 'user' | 'tool' | 'system' | 'assistant';
  content: string | null;
  tool_call_id: string;
  tool_name: string;
  tool_args: Record<string, string>;
  tool_call_error: boolean;
  metrics: ToolMetrics;
  created_at: number;
}

API Types

AgentDetails

Agent configuration.

interface AgentDetails {
  id: string;
  name?: string;
  description?: string;
  model?: Model;
  db_id?: string;
  storage?: boolean;
}

TeamDetails

Team configuration.

interface TeamDetails {
  id: string;
  name?: string;
  description?: string;
  model?: Model;
  db_id?: string;
  storage?: boolean;
}

SessionEntry

Session information.

interface SessionEntry {
  session_id: string;
  session_name: string;
  created_at: string | null;  // ISO 8601 timestamp string
  updated_at?: string | null;  // ISO 8601 timestamp string
}

Events

RunEvent

Events emitted during an Agno agent run.

enum RunEvent {
  RunStarted = 'RunStarted',
  RunContent = 'RunContent',
  RunCompleted = 'RunCompleted',
  RunError = 'RunError',
  ToolCallStarted = 'ToolCallStarted',
  ToolCallCompleted = 'ToolCallCompleted',
  ReasoningStarted = 'ReasoningStarted',
  ReasoningStep = 'ReasoningStep',
  ReasoningCompleted = 'ReasoningCompleted',
  // ... and more
}

Publishing

To publish this package to npm:

# Login to npm (first time only)
npm login

# Build the package
bun run build

# Publish (use --access public for scoped packages)
npm publish --access public

Note: This package must be published before @rodrigocoliveira/agno-client and @rodrigocoliveira/agno-react since they depend on it.

License

MIT