/** * Provider-agnostic event types for Managed Agent backends. * * Python parity: praisonaiagents/managed/events.py * * These classes mirror the event types used by Anthropic's Managed Agents API * but are provider-agnostic: any managed backend (Anthropic, local, OpenAI, * ...) emits them during execution. Pure data, no dependencies. * * Naming: Python's `EventType` and `StopReason` are exported as * `ManagedEventType` and `ManagedStopReason` because this package already * exports an unrelated `EventType` (trace) and `StopReason` (agent). */ /** * Standard event types for managed agent sessions. * Python parity: praisonaiagents/managed/events.py:19-29 (`EventType`) */ export declare enum ManagedEventType { AGENT_MESSAGE = "agent.message", AGENT_TOOL_USE = "agent.tool_use", AGENT_CUSTOM_TOOL_USE = "agent.custom_tool_use", TOOL_CONFIRMATION = "agent.tool_confirmation", SESSION_IDLE = "session.status_idle", SESSION_RUNNING = "session.status_running", SESSION_ERROR = "session.error", USAGE = "session.usage" } /** * Why a session went idle. * Python parity: praisonaiagents/managed/events.py:32-39 (`StopReason`) */ export declare enum ManagedStopReason { END_TURN = "end_turn", REQUIRES_ACTION = "requires_action", MAX_TURNS = "max_turns", INTERRUPTED = "interrupted", ERROR = "error" } /** * Constructor fields of `ManagedEvent`. * Python parity: praisonaiagents/managed/events.py:52-54 */ export interface ManagedEventInit { /** Event type string (e.g. `"agent.message"`). Default `""`. */ type?: string; /** Unix timestamp (seconds) when the event was created. Default: now. */ timestamp?: number; /** Arbitrary provider-specific metadata. Default `{}`. */ metadata?: Record; } /** * Base event emitted by a managed agent backend. * Python parity: praisonaiagents/managed/events.py:43-54 (`ManagedEvent`) */ export declare class ManagedEvent { type: string; timestamp: number; metadata: Record; constructor(init?: ManagedEventInit); } /** A content block of an `AgentMessageEvent`; at least `{type: "text", text}`. */ export interface ManagedContentBlock { type: string; text?: string; [key: string]: any; } /** * Constructor fields of `AgentMessageEvent`. * Python parity: praisonaiagents/managed/events.py:66 */ export interface AgentMessageEventInit extends ManagedEventInit { /** Content blocks. Default `[]`. */ content?: ManagedContentBlock[]; } /** * Text content produced by the agent. * Python parity: praisonaiagents/managed/events.py:58-81 (`AgentMessageEvent`) */ export declare class AgentMessageEvent extends ManagedEvent { content: ManagedContentBlock[]; constructor(init?: AgentMessageEventInit); /** Convenience: concatenate all text blocks. */ get text(): string; } /** * Constructor fields of `ToolUseEvent`. * Python parity: praisonaiagents/managed/events.py:94-97 */ export interface ToolUseEventInit extends ManagedEventInit { /** Tool name (e.g. `"bash"`, `"read"`, `"write"`). Default `""`. */ name?: string; /** Tool input parameters. Default `{}`. */ input?: Record; /** Unique ID for this tool invocation. Default `""`. */ toolUseId?: string; /** Whether the tool requires user confirmation. Default `false`. */ needsConfirmation?: boolean; } /** * Built-in tool invocation by the agent. * Python parity: praisonaiagents/managed/events.py:84-101 (`ToolUseEvent`) */ export declare class ToolUseEvent extends ManagedEvent { name: string; input: Record; toolUseId: string; needsConfirmation: boolean; constructor(init?: ToolUseEventInit); } /** * Constructor fields of `CustomToolUseEvent`. * Python parity: praisonaiagents/managed/events.py:114-116 */ export interface CustomToolUseEventInit extends ManagedEventInit { /** Custom tool name. Default `""`. */ name?: string; /** Tool input parameters. Default `{}`. */ input?: Record; /** Unique ID for this tool invocation. Default `""`. */ toolUseId?: string; } /** * Custom (user-defined) tool invocation by the agent. * Python parity: praisonaiagents/managed/events.py:105-120 (`CustomToolUseEvent`) */ export declare class CustomToolUseEvent extends ManagedEvent { name: string; input: Record; toolUseId: string; constructor(init?: CustomToolUseEventInit); } /** * Constructor fields of `ToolConfirmationEvent`. * Python parity: praisonaiagents/managed/events.py:133-135 */ export interface ToolConfirmationEventInit extends ManagedEventInit { /** Tool name requiring confirmation. Default `""`. */ name?: string; /** Tool input parameters. Default `{}`. */ input?: Record; /** Unique ID for this tool invocation. Default `""`. */ toolUseId?: string; } /** * Tool requires user confirmation before execution. * Python parity: praisonaiagents/managed/events.py:124-139 (`ToolConfirmationEvent`) */ export declare class ToolConfirmationEvent extends ManagedEvent { name: string; input: Record; toolUseId: string; constructor(init?: ToolConfirmationEventInit); } /** * Constructor fields of `SessionIdleEvent`. * Python parity: praisonaiagents/managed/events.py:152-153 */ export interface SessionIdleEventInit extends ManagedEventInit { /** Why the session stopped (see `ManagedStopReason`). Default `"end_turn"`. */ stopReason?: ManagedStopReason | string; /** Blocking event IDs if `stopReason` is `"requires_action"`. Default `[]`. */ eventIds?: string[]; } /** * Session has gone idle (turn complete or action required). * Python parity: praisonaiagents/managed/events.py:143-157 (`SessionIdleEvent`) */ export declare class SessionIdleEvent extends ManagedEvent { stopReason: string; eventIds: string[]; constructor(init?: SessionIdleEventInit); } /** * Session has transitioned to running state. * Python parity: praisonaiagents/managed/events.py:160-165 (`SessionRunningEvent`) */ export declare class SessionRunningEvent extends ManagedEvent { constructor(init?: ManagedEventInit); } /** * Constructor fields of `SessionErrorEvent`. * Python parity: praisonaiagents/managed/events.py:178-179 */ export interface SessionErrorEventInit extends ManagedEventInit { /** Human-readable error description. Default `""`. */ errorMessage?: string; /** Machine-readable error code (optional). Default `""`. */ errorCode?: string; } /** * Session encountered an error. * Python parity: praisonaiagents/managed/events.py:169-183 (`SessionErrorEvent`) */ export declare class SessionErrorEvent extends ManagedEvent { errorMessage: string; errorCode: string; constructor(init?: SessionErrorEventInit); } /** * Constructor fields of `UsageEvent`. * Python parity: praisonaiagents/managed/events.py:197-200 */ export interface UsageEventInit extends ManagedEventInit { /** Number of input tokens consumed. Default `0`. */ inputTokens?: number; /** Number of output tokens generated. Default `0`. */ outputTokens?: number; /** Tokens used for cache creation. Default `0`. */ cacheCreationInputTokens?: number; /** Tokens read from cache. Default `0`. */ cacheReadInputTokens?: number; } /** * Token usage update. * Python parity: praisonaiagents/managed/events.py:186-204 (`UsageEvent`) */ export declare class UsageEvent extends ManagedEvent { inputTokens: number; outputTokens: number; cacheCreationInputTokens: number; cacheReadInputTokens: number; constructor(init?: UsageEventInit); }