/**
 * Gateway Protocol Types
 *
 * Defines the WebSocket message protocol between clients and the gateway.
 */
import type { ContentBlock, SendInput, StreamEvent } from "@agentick/shared";
/** Current protocol version */
export declare const PROTOCOL_VERSION = "1.0";
export interface ConnectMessage {
    type: "connect";
    clientId: string;
    token?: string;
    protocolVersion?: string;
    metadata?: Record<string, unknown>;
}
export interface RequestMessage {
    type: "req";
    id: string;
    method: GatewayMethod;
    params: Record<string, unknown>;
}
export interface PingMessage {
    type: "ping";
    timestamp: number;
}
export type ClientMessage = ConnectMessage | RequestMessage | PingMessage;
export interface ConnectedMessage {
    type: "connected";
    gatewayId: string;
    protocolVersion: string;
    apps: string[];
    sessions: string[];
}
export interface ResponseMessage {
    type: "res";
    id: string;
    ok: boolean;
    payload?: unknown;
    error?: {
        code: string;
        message: string;
        details?: unknown;
    };
}
export interface EventMessage {
    type: "event";
    event: GatewayEventType;
    sessionId: string;
    data: unknown;
}
export interface PongMessage {
    type: "pong";
    timestamp: number;
}
export interface ErrorMessage {
    type: "error";
    code: string;
    message: string;
}
export type GatewayMessage = ConnectedMessage | ResponseMessage | EventMessage | PongMessage | ErrorMessage;
/**
 * Built-in gateway methods with autocomplete support.
 */
export type BuiltInMethod = "send" | "abort" | "status" | "history" | "reset" | "close" | "apps" | "sessions" | "subscribe" | "unsubscribe" | "channel" | "channel-subscribe" | "schema" | "config" | "tool-catalog" | "tool-confirm" | "tool-dispatch";
/**
 * Gateway method - built-in methods or custom method strings.
 * The (string & {}) allows any string while preserving autocomplete for built-in methods.
 */
export type GatewayMethod = BuiltInMethod | (string & {});
export type GatewayEventType = StreamEvent["type"] | "channel" | "method:chunk" | "method:end" | "config:changed";
export interface SendParams {
    sessionId: string;
    input?: SendInput;
    message?: string;
}
export interface AbortParams {
    sessionId: string;
}
export interface StatusParams {
    sessionId?: string;
}
export interface HistoryParams {
    sessionId: string;
    limit?: number;
    before?: string;
}
export interface ResetParams {
    sessionId: string;
}
export interface CloseParams {
    sessionId: string;
}
export interface SubscribeParams {
    sessionId: string;
}
export interface UnsubscribeParams {
    sessionId: string;
}
export interface ToolCatalogParams {
    sessionId: string;
}
export interface ToolConfirmParams {
    sessionId: string;
    callId: string;
    confirmed: boolean;
    reason?: string;
    always?: boolean;
}
export interface ToolDispatchParams {
    sessionId: string;
    tool: string;
    input: Record<string, unknown>;
}
export interface StatusPayload {
    gateway: {
        id: string;
        uptime: number;
        clients: number;
        sessions: number;
        apps: string[];
    };
    session?: {
        id: string;
        appId: string;
        messageCount: number;
        createdAt: string;
        lastActivityAt: string;
        isActive: boolean;
    };
}
export interface HistoryPayload {
    messages: Array<{
        id: string;
        role: "user" | "assistant" | "system";
        content: ContentBlock[] | string;
        timestamp: string;
        toolCalls?: Array<{
            name: string;
            input: unknown;
            output?: unknown;
        }>;
    }>;
    hasMore: boolean;
}
export interface AppsPayload {
    apps: Array<{
        id: string;
        name: string;
        description?: string;
        isDefault: boolean;
    }>;
}
export interface SessionsPayload {
    sessions: Array<{
        id: string;
        appId: string;
        createdAt: string;
        lastActivityAt: string;
        messageCount: number;
    }>;
}
export interface MethodSchemaEntry {
    description: string;
    params?: Record<string, unknown>;
    response?: Record<string, unknown>;
    errors?: string[];
    roles?: string[];
    builtin: boolean;
}
export interface SchemaPayload {
    protocolVersion: string;
    methods: Record<string, MethodSchemaEntry>;
    events: Array<{
        type: string;
        category: string;
    }>;
    errors: Record<string, string>;
}
export interface ConfigPayload {
    config: Record<string, unknown>;
}
export interface ToolCatalogPayload {
    tools: Array<{
        name: string;
        description: string;
        input: Record<string, unknown>;
        output?: Record<string, unknown>;
        type?: string;
        intent?: string;
        audience?: string;
    }>;
}
/**
 * Session keys follow the format: [app:]name
 *
 * Examples:
 * - "main" → default app, "main" session
 * - "chat:main" → "chat" app, "main" session
 * - "research:task-123" → "research" app, "task-123" session
 * - "whatsapp:+1234567890" → WhatsApp channel session
 */
export interface SessionKey {
    appId: string;
    sessionName: string;
}
export declare function parseSessionKey(key: string, defaultApp: string): SessionKey;
export declare function formatSessionKey(key: SessionKey): string;
//# sourceMappingURL=transport-protocol.d.ts.map