@kivox/client 0.1.0-beta.23 → 0.1.0-beta.25

package/dist/index.d.ts

@@ -1,247 +1,733 @@
+declare namespace exports_api {
+	export { updateTemplate, updateOrgMember, updateOrg, updateCurrentUserEmail, updateCurrentUser, updateAgentStatus, updateAgent, signup, revokeApiKey, removeOrgMember, logoutAll, logout, login, listUserTemplates, listUserAgents, listOrgs, listOrgTemplates, listOrgMembers, listOrgAgents, listMessages, listConversations, listApiKeys, getUser, getTemplate, getOrg, getCurrentUser, getConversation, getAgent, deleteTemplate, deleteOrg, deleteCurrentUser, deleteConversation, deleteAgent, createUserTemplate, createUserAgent, createOrgTemplate, createOrgAgent, createOrg, createApiKey, compileAgent, addOrgMember, User, UpdateTemplateResult, UpdateTemplateBody, UpdateStatusBodyStatus, UpdateStatusBody, UpdateOrgResult, UpdateOrgMemberResult, UpdateOrgBody, UpdateMemberBodyRole, UpdateMemberBody, UpdateCurrentUserResult, UpdateCurrentUserEmailResult, UpdateCurrentUserEmailBody, UpdateCurrentUserBody, UpdateAgentStatusResult, UpdateAgentResult, UpdateAgentBody, Template, SignupResult, SignupBody, SessionResponse, Secret, Safeguards, RevokeApiKeyResult, RemoveOrgMemberResult, PageResponseTemplate, PageResponseAgent, Org, Message, Member, LogoutResult, LogoutAllResult, LoginResult, LoginBody, ListUserTemplatesResult, ListUserTemplatesParams, ListUserAgentsResult, ListUserAgentsParams, ListOrgsResult, ListOrgTemplatesResult, ListOrgTemplatesParams, ListOrgMembersResult, ListOrgAgentsResult, ListOrgAgentsParams, ListMessagesResult, ListMessagesParams, ListConversationsResult, ListConversationsParams, ListApiKeysResult, GetUserResult, GetTemplateResult, GetOrgResult, GetCurrentUserResult, GetConversationResult, GetAgentResult, ErrorModel, ErrorDetail, DeleteTemplateResult, DeleteOrgResult, DeleteCurrentUserResult, DeleteConversationResult, DeleteAgentResult, CursorResponseMessage, CursorResponseConversation, CreateUserTemplateResult, CreateUserAgentResult, CreateTemplateBody, CreateOrgTemplateResult, CreateOrgResult, CreateOrgBody, CreateOrgAgentResult, CreateApiKeyResult, CreateAgentBody, CreateAPIKeyBody, Conversation, Config, CompileDiagnostics, CompileBody, CompileAgentResult, Agent, AddOrgMemberResult, AddMemberBodyRole, AddMemberBody, APIKeyResponse, APIKey };
+}
+import { AxiosRequestConfig, AxiosResponse } from "axios";
+type IfEquals<
+	X,
+	Y,
+	A = X,
+	B = never
+> = (<T>() => T extends X ? 1 : 2) extends <T>() => T extends Y ? 1 : 2 ? A : B;
+type WritableKeys<T> = { [P in keyof T]-? : IfEquals<{ [Q in P] : T[P] }, { -readonly [Q in P] : T[P] }, P> }[keyof T];
+type UnionToIntersection<U> = (U extends any ? (k: U) => void : never) extends ((k: infer I) => void) ? I : never;
+type DistributeReadOnlyOverUnions<T> = T extends any ? NonReadonly<T> : never;
+type Writable<T> = Pick<T, WritableKeys<T>>;
+type NonReadonly<T> = [T] extends [UnionToIntersection<T>] ? { [P in keyof Writable<T>] : T[P] extends object ? NonReadonly<NonNullable<T[P]>> : T[P] } : DistributeReadOnlyOverUnions<T>;
+interface APIKey {
+	created_at: string;
+	created_by_user_id: string;
+	/** @nullable */
+	expires_at: string | null;
+	id: string;
+	/** @nullable */
+	last_used_at: string | null;
+	name: string;
+	owner_org_id: string;
+	owner_user_id: string;
+	prefix: string;
+	/** @nullable */
+	scopes: string[] | null;
+}
+interface APIKeyResponse {
+	/** A URL to the JSON Schema for this object. */
+	readonly $schema?: string;
+	created_at: string;
+	/** @nullable */
+	expires_at: string | null;
+	id: string;
+	key: string;
+	name: string;
+	prefix: string;
+	/** @nullable */
+	scopes: string[] | null;
+}
 /**
-* Configuration for HTTP transport.
+* Role to assign
 */
-type HttpTransportConfig = {
-	/** Base URL for all requests */
-	baseUrl: string
-	/** Optional default headers */
-	headers?: Record<string, string>
+type AddMemberBodyRole = typeof AddMemberBodyRole[keyof typeof AddMemberBodyRole];
+declare const AddMemberBodyRole: {
+	readonly admin: "admin"
+	readonly member: "member"
+	readonly viewer: "viewer"
 };
-/**
-* Error thrown by HTTP transport operations.
-*/
-declare class HttpTransportError extends Error {
-	readonly status: number;
-	readonly statusText: string;
-	readonly body?: unknown;
-	constructor(message: string, status: number, statusText: string, body?: unknown);
+interface AddMemberBody {
+	/** A URL to the JSON Schema for this object. */
+	readonly $schema?: string;
+	/** Role to assign */
+	role: AddMemberBodyRole;
+	/** User to add */
+	user_id: string;
 }
-/**
-* Shared HTTP transport layer for REST API requests.
-* Handles request/response cycles with automatic JSON parsing.
-*/
-declare class HttpTransport {
-	private readonly config;
-	constructor(config: HttpTransportConfig);
+interface Config {
+	allow_interruptions?: boolean;
+	avatar_url?: string;
+	description?: string;
+	global_system_prompt?: string;
+	language?: string;
+	llm_engine?: string;
+	llm_model?: string;
+	max_session_duration_minutes?: number;
+	max_silence_timeout_seconds?: number;
+	name: string;
+}
+interface Safeguards {
+	max_calls: number;
+	max_http_calls: number;
+	max_llm_calls: number;
+	max_transitions: number;
+}
+interface Agent {
+	/** A URL to the JSON Schema for this object. */
+	readonly $schema?: string;
+	config: Config;
+	created_at: string;
+	id: string;
+	ork_source: string;
+	owner_org_id?: string;
+	owner_user_id?: string;
+	safeguards: Safeguards;
+	status: string;
+	template_id?: string;
+	updated_at: string;
+}
+interface CompileBody {
+	/** A URL to the JSON Schema for this object. */
+	readonly $schema?: string;
+	/** Source to compile; defaults to the agent's stored source */
+	ork_source?: string;
+}
+interface CompileDiagnostics {
+	/** A URL to the JSON Schema for this object. */
+	readonly $schema?: string;
+	/** @nullable */
+	errors: string[] | null;
+	/** @nullable */
+	warnings: string[] | null;
+}
+interface Conversation {
+	/** A URL to the JSON Schema for this object. */
+	readonly $schema?: string;
+	agent_id: string;
+	end_reason?: string;
+	ended_at?: string;
+	id: string;
+	started_at: string;
+	status: string;
+	summary?: string;
+}
+interface CreateAPIKeyBody {
+	/** A URL to the JSON Schema for this object. */
+	readonly $schema?: string;
+	/** Optional expiration time */
+	expires_at?: string;
 	/**
-	* Makes an HTTP request to the specified path.
-	*
-	* @param path API path (e.g., '/agents')
-	* @param init Fetch request options
-	* @returns Parsed JSON response
-	* @throws {HttpTransportError} If request fails
+	* Human-readable key name
+	* @maxLength 50
+	*/
+	name: string;
+	/**
+	* Permission scopes (empty = full access)
+	* @nullable
+	*/
+	scopes?: string[] | null;
+}
+interface Secret {
+	description?: string;
+	key: string;
+	value: string;
+}
+interface CreateAgentBody {
+	/** A URL to the JSON Schema for this object. */
+	readonly $schema?: string;
+	/** Agent configuration */
+	config?: Config;
+	/** Orchestration source */
+	ork_source?: string;
+	/** Resource limits */
+	safeguards?: Safeguards;
+	/** Encrypted secrets */
+	secrets?: Secret[];
+	/** Optional source template */
+	template_id?: string;
+}
+interface CreateOrgBody {
+	/** A URL to the JSON Schema for this object. */
+	readonly $schema?: string;
+	/**
+	* Organization description
+	* @maxLength 2048
 	*/
-	request<T>(path: string, init?: RequestInit): Promise<T>;
+	description?: string;
 	/**
-	* Makes a GET request.
+	* Organization name
+	* @maxLength 256
 	*/
-	get<T>(path: string, params?: Record<string, string>): Promise<T>;
+	name: string;
 	/**
-	* Makes a POST request.
+	* URL-safe slug
+	* @pattern ^[a-z0-9][a-z0-9\-]{0,61}[a-z0-9]$
 	*/
-	post<T>(path: string, body?: unknown): Promise<T>;
+	slug: string;
+}
+interface CreateTemplateBody {
+	/** A URL to the JSON Schema for this object. */
+	readonly $schema?: string;
+	/** Agent configuration */
+	config?: Config;
 	/**
-	* Makes a PUT request.
+	* Template description
+	* @maxLength 2048
 	*/
-	put<T>(path: string, body?: unknown): Promise<T>;
+	description?: string;
 	/**
-	* Makes a PATCH request.
+	* Template name
+	* @maxLength 256
 	*/
-	patch<T>(path: string, body?: unknown): Promise<T>;
+	name: string;
+	/** Orchestration source */
+	ork_source?: string;
+	/** Resource limits */
+	safeguards?: Safeguards;
+	/** Encrypted secrets */
+	secrets?: Secret[];
+}
+interface CursorResponseConversation {
+	/** A URL to the JSON Schema for this object. */
+	readonly $schema?: string;
+	has_more: boolean;
+	/** @nullable */
+	items: Conversation[] | null;
+	next_cursor: string;
+}
+interface Message {
+	content: string;
+	conversation_id: string;
+	created_at: string;
+	id: string;
+	role: string;
+}
+interface CursorResponseMessage {
+	/** A URL to the JSON Schema for this object. */
+	readonly $schema?: string;
+	has_more: boolean;
+	/** @nullable */
+	items: Message[] | null;
+	next_cursor: string;
+}
+interface ErrorDetail {
+	/** Where the error occurred, e.g. 'body.items[3].tags' or 'path.thing-id' */
+	location?: string;
+	/** Error message text */
+	message?: string;
+	/** The value at the given location */
+	value?: unknown;
+}
+interface ErrorModel {
+	/** A URL to the JSON Schema for this object. */
+	readonly $schema?: string;
+	/** A human-readable explanation specific to this occurrence of the problem. */
+	detail?: string;
+	/**
+	* Optional list of individual error details
+	* @nullable
+	*/
+	errors?: ErrorDetail[] | null;
+	/** A URI reference that identifies the specific occurrence of the problem. */
+	instance?: string;
+	/** HTTP status code */
+	status?: number;
+	/** A short, human-readable summary of the problem type. This value should not change between occurrences of the error. */
+	title?: string;
+	/** A URI reference to human-readable documentation for the error. */
+	type?: string;
+}
+interface LoginBody {
+	/** A URL to the JSON Schema for this object. */
+	readonly $schema?: string;
+	/** Account email */
+	email: string;
 	/**
-	* Makes a DELETE request.
+	* Account password
+	* @minLength 8
 	*/
-	delete<T>(path: string): Promise<T>;
+	password: string;
+}
+interface Member {
+	/** A URL to the JSON Schema for this object. */
+	readonly $schema?: string;
+	created_at: string;
+	org_id: string;
+	role: string;
+	updated_at: string;
+	user_id: string;
+}
+interface Org {
+	/** A URL to the JSON Schema for this object. */
+	readonly $schema?: string;
+	/** @nullable */
+	avatar_url: string | null;
+	created_at: string;
+	created_by: string;
+	/** @nullable */
+	description: string | null;
+	id: string;
+	name: string;
+	slug: string;
+	tier: string;
+	updated_at: string;
+}
+interface PageResponseAgent {
+	/** A URL to the JSON Schema for this object. */
+	readonly $schema?: string;
+	/** @nullable */
+	items: Agent[] | null;
+	limit: number;
+	page: number;
+	total: number;
+}
+interface Template {
+	/** A URL to the JSON Schema for this object. */
+	readonly $schema?: string;
+	config: Config;
+	created_at: string;
+	description?: string;
+	id: string;
+	name: string;
+	ork_source: string;
+	owner_org_id?: string;
+	owner_user_id?: string;
+	safeguards: Safeguards;
+	updated_at: string;
+}
+interface PageResponseTemplate {
+	/** A URL to the JSON Schema for this object. */
+	readonly $schema?: string;
+	/** @nullable */
+	items: Template[] | null;
+	limit: number;
+	page: number;
+	total: number;
+}
+interface SessionResponse {
+	/** A URL to the JSON Schema for this object. */
+	readonly $schema?: string;
+	expires_at: string;
+}
+interface SignupBody {
+	/** A URL to the JSON Schema for this object. */
+	readonly $schema?: string;
+	/** Account email */
+	email: string;
+	/**
+	* Display name
+	* @maxLength 50
+	*/
+	name: string;
+	/**
+	* Account password
+	* @minLength 8
+	*/
+	password: string;
+}
+interface UpdateAgentBody {
+	/** A URL to the JSON Schema for this object. */
+	readonly $schema?: string;
+	/** Agent configuration */
+	config?: Config;
+	/** Orchestration source */
+	ork_source?: string;
+	/** Resource limits */
+	safeguards?: Safeguards;
+	/** Encrypted secrets */
+	secrets?: Secret[];
+}
+interface UpdateCurrentUserBody {
+	/** A URL to the JSON Schema for this object. */
+	readonly $schema?: string;
+	/** Avatar URL */
+	avatar_url?: string;
+	/**
+	* Display name
+	* @maxLength 256
+	*/
+	name?: string;
+}
+interface UpdateCurrentUserEmailBody {
+	/** A URL to the JSON Schema for this object. */
+	readonly $schema?: string;
+	/** New email address */
+	email: string;
 }
 /**
-* Paginated represents a paginated response containing items and metadata.
+* New role
 */
-type Paginated<T> = {
-	items: T
-	total: number
-	page: number
-	page_size: number
-	total_pages: number
-};
-type AgentStatus = "live" | "draft" | "archived";
-type Agent = {
-	id: string
-	template_id: string
-	config: AgentConfig
-	secrets: AgentSecret[]
-	ork_source: string
-	status: AgentStatus
-	created_at: Date
-	updated_at: Date
-};
-type AgentConfig = {
-	avatar_url?: string
-	name: string
-	description?: string
-	language?: string
-	global_system_prompt?: string
-	max_session_duration_minutes?: number
-	max_silence_timeout_seconds?: number
-	allow_interruptions?: boolean
-	llm_engine?: string
-	llm_model?: string
-};
-type AgentSecret = {
-	key: string
-	value: string
-	description: string
-};
-type AgentCreate = Partial<Pick<Agent, "config" | "secrets" | "ork_source" | "status" | "template_id">>;
-type AgentUpdate = Partial<Pick<AgentCreate, "config" | "secrets" | "ork_source">>;
-type AgentCompilationDiagnostic = {
-	errors: string[]
-	warnings: string[]
+type UpdateMemberBodyRole = typeof UpdateMemberBodyRole[keyof typeof UpdateMemberBodyRole];
+declare const UpdateMemberBodyRole: {
+	readonly owner: "owner"
+	readonly admin: "admin"
+	readonly member: "member"
+	readonly viewer: "viewer"
 };
+interface UpdateMemberBody {
+	/** A URL to the JSON Schema for this object. */
+	readonly $schema?: string;
+	/** New role */
+	role: UpdateMemberBodyRole;
+}
+interface UpdateOrgBody {
+	/** A URL to the JSON Schema for this object. */
+	readonly $schema?: string;
+	/** Avatar URL */
+	avatar_url?: string;
+	/**
+	* Organization description
+	* @maxLength 2048
+	*/
+	description?: string;
+	/**
+	* Organization name
+	* @maxLength 256
+	*/
+	name?: string;
+}
 /**
-* Configuration for listing agents.
+* Target lifecycle state
 */
-type AgentListParams = {
-	/** Number of results per page */
-	limit?: number
-	/** Page number (1-indexed) */
-	page?: number
-	/** Search query */
-	search?: string
+type UpdateStatusBodyStatus = typeof UpdateStatusBodyStatus[keyof typeof UpdateStatusBodyStatus];
+declare const UpdateStatusBodyStatus: {
+	readonly draft: "draft"
+	readonly live: "live"
+	readonly archived: "archived"
 };
-/**
-* Client for interacting with Kivox agents.
-*
-* @example
-* ```ts
-* const agents = await kivox.agents.list({ limit: 20 });
-* const agent = await kivox.agents.get('019bb51e-e45f-75e3-b828-94fdf231711e');
-* ```
-*/
-declare class AgentClient {
-	private readonly http;
-	constructor(http: HttpTransport);
+interface UpdateStatusBody {
+	/** A URL to the JSON Schema for this object. */
+	readonly $schema?: string;
+	/** Target lifecycle state */
+	status: UpdateStatusBodyStatus;
+}
+interface UpdateTemplateBody {
+	/** A URL to the JSON Schema for this object. */
+	readonly $schema?: string;
+	/** Agent configuration */
+	config?: Config;
 	/**
-	* Lists all agents with optional filtering and pagination.
-	*
-	* @param params List configuration
-	* @returns Paginated list of agents
+	* Template description
+	* @maxLength 2048
 	*/
-	list(params?: AgentListParams): Promise<Paginated<Agent[]>>;
+	description?: string;
 	/**
-	* Lists all live agents with optional filtering and pagination.
-	*
-	* @param params List configuration
-	* @returns Paginated list of live agents
+	* Template name
+	* @maxLength 256
 	*/
-	listLive(params?: AgentListParams): Promise<Paginated<Agent[]>>;
+	name?: string;
+	/** Orchestration source */
+	ork_source?: string;
+	/** Resource limits */
+	safeguards?: Safeguards;
+	/** Encrypted secrets */
+	secrets?: Secret[];
+}
+interface User {
+	/** A URL to the JSON Schema for this object. */
+	readonly $schema?: string;
+	/** @nullable */
+	avatar_url: string | null;
+	created_at: string;
+	email: string;
+	id: string;
+	name: string;
+	updated_at: string;
+}
+type ListConversationsParams = {
 	/**
-	* Lists all draft agents with optional filtering and pagination.
-	*
-	* @param params List configuration
-	* @returns Paginated list of draft agents
+	* Cursor from the previous page
 	*/
-	listDraft(params?: AgentListParams): Promise<Paginated<Agent[]>>;
+	after?: string
 	/**
-	* Lists all archived agents with optional filtering and pagination.
-	*
-	* @param params List configuration
-	* @returns Paginated list of archived agents
+	* Page size
+	* @minimum 1
+	* @maximum 100
 	*/
-	listArchived(params?: AgentListParams): Promise<Paginated<Agent[]>>;
+	limit?: number
+};
+type ListMessagesParams = {
 	/**
-	* Gets a single agent by ID.
-	*
-	* @param id Agent ID
-	* @returns Agent details
+	* Cursor from the previous page
 	*/
-	get(id: string): Promise<Agent>;
+	after?: string
 	/**
-	* Creates a new agent.
-	*
-	* @param data Agent data
-	* @returns Created agent
+	* Page size
+	* @minimum 1
+	* @maximum 100
 	*/
-	create(data: AgentCreate): Promise<Agent>;
+	limit?: number
+};
+type ListOrgAgentsParams = {
 	/**
-	* Updates an existing agent.
-	*
-	* @param id Agent ID
-	* @param data Updated agent data
-	* @returns Updated agent
+	* Page size
+	* @minimum 1
+	* @maximum 100
 	*/
-	update(id: string, data: AgentUpdate): Promise<Agent>;
+	limit?: number
 	/**
-	* Marks an agent as live.
-	*
-	* @param id Agent ID
-	* @returns Updated agent
+	* Page number
+	* @minimum 1
 	*/
-	markAsLive(id: string): Promise<Agent>;
+	page?: number
 	/**
-	* Marks an agent as draft.
-	*
-	* @param id Agent ID
-	* @returns Updated agent
+	* Search query
 	*/
-	markAsDraft(id: string): Promise<Agent>;
+	search?: string
+};
+type ListOrgTemplatesParams = {
 	/**
-	* Marks an agent as archived.
-	*
-	* @param id Agent ID
-	* @returns Updated agent
+	* Page size
+	* @minimum 1
+	* @maximum 100
 	*/
-	markAsArchived(id: string): Promise<Agent>;
+	limit?: number
 	/**
-	* Deletes an agent.
-	*
-	* @param id Agent ID
+	* Page number
+	* @minimum 1
 	*/
-	delete(id: string): Promise<Agent>;
+	page?: number
+};
+type ListUserAgentsParams = {
 	/**
-	* Compiles the Ork source code of an agent.
-	*
-	* @param id Agent ID
-	* @param orkSource Updated Ork source code. If not provided, the current Ork source code is used.
-	* @returns Compiled agent
+	* Page size
+	* @minimum 1
+	* @maximum 100
+	*/
+	limit?: number
+	/**
+	* Page number
+	* @minimum 1
 	*/
-	compile(id: string, orkSource?: string): Promise<AgentCompilationDiagnostic>;
+	page?: number
 	/**
-	* Parses a list of agents with stringified config and blueprint fields.
-	*
-	* @returns List of parsed agents.
+	* Search query
 	*/
-	private static parseAgents;
+	search?: string
+};
+type ListUserTemplatesParams = {
 	/**
-	* Parses an agent with stringified config and blueprint fields.
-	*
-	* @returns Agent with parsed config and blueprint.
+	* Page size
+	* @minimum 1
+	* @maximum 100
 	*/
-	private static parseAgent;
-}
+	limit?: number
+	/**
+	* Page number
+	* @minimum 1
+	*/
+	page?: number
+};
 /**
-* Configuration for WebSocket transport.
+* @summary Soft-delete an agent
 */
-type WebSocketTransportConfig = {
-	/** Base WebSocket URL */
-	baseUrl: string
-	/** Optional default headers (for protocol support) */
-	headers?: Record<string, string>
-};
+declare const deleteAgent: (agentID: string, options?: AxiosRequestConfig) => Promise<AxiosResponse<void>>;
 /**
-* Shared WebSocket transport layer.
-* Provides WebSocket connection creation.
+* @summary Get an agent by ID
 */
-declare class WebSocketTransport {
-	private readonly config;
-	constructor(config: WebSocketTransportConfig);
-	/**
-	* Creates a WebSocket connection to the specified path.
-	*
-	* @param path WebSocket path (e.g., '/conversations/websocket')
-	* @returns Raw WebSocket instance
-	*/
-	connect(path: string): WebSocket;
-}
+declare const getAgent: (agentID: string, options?: AxiosRequestConfig) => Promise<AxiosResponse<Agent>>;
+/**
+* @summary Update an agent
+*/
+declare const updateAgent: (agentID: string, updateAgentBody: NonReadonly<UpdateAgentBody>, options?: AxiosRequestConfig) => Promise<AxiosResponse<Agent>>;
+/**
+* Returns HTTP 200 with diagnostics regardless of compile outcome. Compile errors are domain results, not HTTP errors.
+* @summary Parse and validate an agent's orchestration source
+*/
+declare const compileAgent: (agentID: string, compileBody: NonReadonly<CompileBody>, options?: AxiosRequestConfig) => Promise<AxiosResponse<CompileDiagnostics>>;
+/**
+* @summary List conversations for an agent
+*/
+declare const listConversations: (agentID: string, params?: ListConversationsParams, options?: AxiosRequestConfig) => Promise<AxiosResponse<CursorResponseConversation>>;
+/**
+* @summary Transition an agent's lifecycle status
+*/
+declare const updateAgentStatus: (agentID: string, updateStatusBody: NonReadonly<UpdateStatusBody>, options?: AxiosRequestConfig) => Promise<AxiosResponse<Agent>>;
+/**
+* @summary List the authenticated user's API keys
+*/
+declare const listApiKeys: (options?: AxiosRequestConfig) => Promise<AxiosResponse<APIKey[] | null>>;
+/**
+* @summary Create a new API key
+*/
+declare const createApiKey: (createAPIKeyBody: NonReadonly<CreateAPIKeyBody>, options?: AxiosRequestConfig) => Promise<AxiosResponse<APIKeyResponse>>;
+/**
+* @summary Revoke an API key
+*/
+declare const revokeApiKey: (keyID: string, options?: AxiosRequestConfig) => Promise<AxiosResponse<void>>;
+/**
+* @summary Revoke all sessions for the authenticated user
+*/
+declare const logoutAll: (options?: AxiosRequestConfig) => Promise<AxiosResponse<void>>;
+/**
+* @summary Authenticate and create a session
+*/
+declare const login: (loginBody: NonReadonly<LoginBody>, options?: AxiosRequestConfig) => Promise<AxiosResponse<SessionResponse>>;
+/**
+* @summary Revoke the current session
+*/
+declare const logout: (options?: AxiosRequestConfig) => Promise<AxiosResponse<void>>;
+/**
+* @summary Create a new account and session
+*/
+declare const signup: (signupBody: NonReadonly<SignupBody>, options?: AxiosRequestConfig) => Promise<AxiosResponse<SessionResponse>>;
+/**
+* @summary Soft-delete a conversation
+*/
+declare const deleteConversation: (conversationID: string, options?: AxiosRequestConfig) => Promise<AxiosResponse<void>>;
+/**
+* @summary Get a conversation by ID
+*/
+declare const getConversation: (conversationID: string, options?: AxiosRequestConfig) => Promise<AxiosResponse<Conversation>>;
+/**
+* @summary List messages in a conversation
+*/
+declare const listMessages: (conversationID: string, params?: ListMessagesParams, options?: AxiosRequestConfig) => Promise<AxiosResponse<CursorResponseMessage>>;
+/**
+* @summary List organizations the authenticated user belongs to
+*/
+declare const listOrgs: (options?: AxiosRequestConfig) => Promise<AxiosResponse<Org[] | null>>;
+/**
+* @summary Create a new organization
+*/
+declare const createOrg: (createOrgBody: NonReadonly<CreateOrgBody>, options?: AxiosRequestConfig) => Promise<AxiosResponse<Org>>;
+/**
+* @summary Soft-delete an organization
+*/
+declare const deleteOrg: (orgSlug: string, options?: AxiosRequestConfig) => Promise<AxiosResponse<void>>;
+/**
+* @summary Get an organization by slug
+*/
+declare const getOrg: (orgSlug: string, options?: AxiosRequestConfig) => Promise<AxiosResponse<Org>>;
+/**
+* @summary Update an organization
+*/
+declare const updateOrg: (orgSlug: string, updateOrgBody: NonReadonly<UpdateOrgBody>, options?: AxiosRequestConfig) => Promise<AxiosResponse<Org>>;
+/**
+* @summary List agents owned by an organization
+*/
+declare const listOrgAgents: (orgSlug: string, params?: ListOrgAgentsParams, options?: AxiosRequestConfig) => Promise<AxiosResponse<PageResponseAgent>>;
+/**
+* @summary Create an agent owned by an organization
+*/
+declare const createOrgAgent: (orgSlug: string, createAgentBody: NonReadonly<CreateAgentBody>, options?: AxiosRequestConfig) => Promise<AxiosResponse<Agent>>;
+/**
+* @summary List organization members
+*/
+declare const listOrgMembers: (orgSlug: string, options?: AxiosRequestConfig) => Promise<AxiosResponse<Member[] | null>>;
+/**
+* @summary Add a member to an organization
+*/
+declare const addOrgMember: (orgSlug: string, addMemberBody: NonReadonly<AddMemberBody>, options?: AxiosRequestConfig) => Promise<AxiosResponse<Member>>;
+/**
+* @summary Remove a member from an organization
+*/
+declare const removeOrgMember: (orgSlug: string, userID: string, options?: AxiosRequestConfig) => Promise<AxiosResponse<void>>;
+/**
+* @summary Update a member's role
+*/
+declare const updateOrgMember: (orgSlug: string, userID: string, updateMemberBody: NonReadonly<UpdateMemberBody>, options?: AxiosRequestConfig) => Promise<AxiosResponse<Member>>;
+/**
+* @summary List templates owned by an organization
+*/
+declare const listOrgTemplates: (orgSlug: string, params?: ListOrgTemplatesParams, options?: AxiosRequestConfig) => Promise<AxiosResponse<PageResponseTemplate>>;
+/**
+* @summary Create a template owned by an organization
+*/
+declare const createOrgTemplate: (orgSlug: string, createTemplateBody: NonReadonly<CreateTemplateBody>, options?: AxiosRequestConfig) => Promise<AxiosResponse<Template>>;
+/**
+* @summary Soft-delete a template
+*/
+declare const deleteTemplate: (templateID: string, options?: AxiosRequestConfig) => Promise<AxiosResponse<void>>;
+/**
+* @summary Get a template by ID
+*/
+declare const getTemplate: (templateID: string, options?: AxiosRequestConfig) => Promise<AxiosResponse<Template>>;
+/**
+* @summary Update a template
+*/
+declare const updateTemplate: (templateID: string, updateTemplateBody: NonReadonly<UpdateTemplateBody>, options?: AxiosRequestConfig) => Promise<AxiosResponse<Template>>;
+/**
+* @summary Soft-delete the authenticated user's account
+*/
+declare const deleteCurrentUser: (options?: AxiosRequestConfig) => Promise<AxiosResponse<void>>;
+/**
+* @summary Get the authenticated user's profile
+*/
+declare const getCurrentUser: (options?: AxiosRequestConfig) => Promise<AxiosResponse<User>>;
+/**
+* @summary Update the authenticated user's profile
+*/
+declare const updateCurrentUser: (updateCurrentUserBody: NonReadonly<UpdateCurrentUserBody>, options?: AxiosRequestConfig) => Promise<AxiosResponse<User>>;
+/**
+* @summary List agents owned by the authenticated user
+*/
+declare const listUserAgents: (params?: ListUserAgentsParams, options?: AxiosRequestConfig) => Promise<AxiosResponse<PageResponseAgent>>;
+/**
+* @summary Create an agent owned by the authenticated user
+*/
+declare const createUserAgent: (createAgentBody: NonReadonly<CreateAgentBody>, options?: AxiosRequestConfig) => Promise<AxiosResponse<Agent>>;
+/**
+* @summary Update the authenticated user's email
+*/
+declare const updateCurrentUserEmail: (updateCurrentUserEmailBody: NonReadonly<UpdateCurrentUserEmailBody>, options?: AxiosRequestConfig) => Promise<AxiosResponse<User>>;
+/**
+* @summary List templates owned by the authenticated user
+*/
+declare const listUserTemplates: (params?: ListUserTemplatesParams, options?: AxiosRequestConfig) => Promise<AxiosResponse<PageResponseTemplate>>;
+/**
+* @summary Create a template owned by the authenticated user
+*/
+declare const createUserTemplate: (createTemplateBody: NonReadonly<CreateTemplateBody>, options?: AxiosRequestConfig) => Promise<AxiosResponse<Template>>;
+/**
+* @summary Get a user by ID
+*/
+declare const getUser: (userID: string, options?: AxiosRequestConfig) => Promise<AxiosResponse<User>>;
+type DeleteAgentResult = AxiosResponse<void>;
+type GetAgentResult = AxiosResponse<Agent>;
+type UpdateAgentResult = AxiosResponse<Agent>;
+type CompileAgentResult = AxiosResponse<CompileDiagnostics>;
+type ListConversationsResult = AxiosResponse<CursorResponseConversation>;
+type UpdateAgentStatusResult = AxiosResponse<Agent>;
+type ListApiKeysResult = AxiosResponse<APIKey[] | null>;
+type CreateApiKeyResult = AxiosResponse<APIKeyResponse>;
+type RevokeApiKeyResult = AxiosResponse<void>;
+type LogoutAllResult = AxiosResponse<void>;
+type LoginResult = AxiosResponse<SessionResponse>;
+type LogoutResult = AxiosResponse<void>;
+type SignupResult = AxiosResponse<SessionResponse>;
+type DeleteConversationResult = AxiosResponse<void>;
+type GetConversationResult = AxiosResponse<Conversation>;
+type ListMessagesResult = AxiosResponse<CursorResponseMessage>;
+type ListOrgsResult = AxiosResponse<Org[] | null>;
+type CreateOrgResult = AxiosResponse<Org>;
+type DeleteOrgResult = AxiosResponse<void>;
+type GetOrgResult = AxiosResponse<Org>;
+type UpdateOrgResult = AxiosResponse<Org>;
+type ListOrgAgentsResult = AxiosResponse<PageResponseAgent>;
+type CreateOrgAgentResult = AxiosResponse<Agent>;
+type ListOrgMembersResult = AxiosResponse<Member[] | null>;
+type AddOrgMemberResult = AxiosResponse<Member>;
+type RemoveOrgMemberResult = AxiosResponse<void>;
+type UpdateOrgMemberResult = AxiosResponse<Member>;
+type ListOrgTemplatesResult = AxiosResponse<PageResponseTemplate>;
+type CreateOrgTemplateResult = AxiosResponse<Template>;
+type DeleteTemplateResult = AxiosResponse<void>;
+type GetTemplateResult = AxiosResponse<Template>;
+type UpdateTemplateResult = AxiosResponse<Template>;
+type DeleteCurrentUserResult = AxiosResponse<void>;
+type GetCurrentUserResult = AxiosResponse<User>;
+type UpdateCurrentUserResult = AxiosResponse<User>;
+type ListUserAgentsResult = AxiosResponse<PageResponseAgent>;
+type CreateUserAgentResult = AxiosResponse<Agent>;
+type UpdateCurrentUserEmailResult = AxiosResponse<User>;
+type ListUserTemplatesResult = AxiosResponse<PageResponseTemplate>;
+type CreateUserTemplateResult = AxiosResponse<Template>;
+type GetUserResult = AxiosResponse<User>;
 /**
 * Initializes a new conversational session.
 * It must be the first message sent after connection establishment.
@@ -539,251 +1025,77 @@ declare class ConversationSession {
 	*/
 	close(): void;
 }
-type Conversation = {
-	id: string
-	agent_id: string
-	started_at: Date
-	ended_at?: Date
-};
-/**
-* Configuration parameters for fetching a list of past conversations.
-*/
-type ConversationListParams = {
-	/** Agent ID to filter the conversations by */
-	agentId: string
-	/** Number of results per page (defaults to 20) */
-	limit?: number
-	/** Page number, 1-indexed (defaults to 1) */
-	page?: number
-};
-/**
-* Configuration parameters for connecting to an agent and establishing a session.
-*/
 type ConversationConnectParams = ConversationSessionConfig & {
 	/** The unique ID of the agent to connect to */
 	agentId: string
-	/**
-	* Optional callback invoked during the initial handshake phase.
-	* Can be used to hook into successful or failed connection attempts before the session object is returned.
-	*/
+	/** Optional callback invoked during the initial handshake phase */
 	onConnection?: (event: ServerConnectionMessage) => void
 };
 /**
-* Client service for managing conversational records and establishing real-time WebSocket sessions.
+* Provides real-time WebSocket session management for Kivox agents.
+* REST operations (list, get) are handled directly via the Kiota client.
 *
 * @example
 * ```ts
-* // Connect to a Kivox agent
-* const session = await kivox.conversations.connect({
-* agentId: 'agent-123',
-* onEvent: (event) => {
-* if (event.type === 'text_delta') {
-* console.log(event.chunk);
-* } else if (event.type === 'audio_delta') {
-* audioPlayer.enqueue(event.audio);
-* }
-* }
+* const session = await kivox.realtime.connect({
+*   agentId: 'agent-123',
+*   onEvent: (event) => {
+*     if (event.type === 'text_delta') console.log(event.chunk);
+*   }
 * });
-*
 * session.sendText('Hello!');
 * ```
 */
-declare class ConversationClient {
-	private readonly http;
-	private readonly ws;
-	/**
-	* Instantiates a new ConversationClient.
-	* @param http The HTTP transport for REST endpoints.
-	* @param ws The WebSocket transport factory.
-	*/
-	constructor(http: HttpTransport, ws: WebSocketTransport);
-	/**
-	* Retrieves a paginated list of past conversations for a specific agent.
-	*
-	* @param params Query parameters for pagination and filtering.
-	* @returns A promise resolving to a paginated list of conversations.
-	*/
-	list(params: ConversationListParams): Promise<Paginated<Conversation[]>>;
-	/**
-	* Retrieves the details of a single conversation by its ID.
-	*
-	* @param id The unique identifier of the conversation.
-	* @returns A promise resolving to the conversation data.
-	*/
-	get(id: string): Promise<Conversation>;
+declare class RealtimeClient {
+	private;
+	/** @internal */
+	constructor(baseUrl: string);
 	/**
-	* Establishes a real-time WebSocket session with an agent.
-	* Handles the handshake protocol and returns an active session instance.
+	* Establishes a real-time WebSocket session with a Kivox agent.
+	* Authentication is passed as a query parameter since browser WebSockets
+	* do not support custom headers.
 	*
-	* @param params Configuration for the connection and subsequent session.
-	* @returns A promise resolving to an active `ConversationSession`.
+	* @param params - Connection and session configuration.
+	* @returns A promise resolving to an active {@link ConversationSession}.
 	* @throws {Error} If the handshake fails or the connection drops during negotiation.
 	*/
 	connect(params: ConversationConnectParams): Promise<ConversationSession>;
 }
-type MessageRole = "system" | "user" | "assistant";
-type Message = {
-	id: string
-	conversation_id: string
-	role: MessageRole
-	content: string
-	created_at: Date
+type KivoxClient = typeof exports_api & {
+	realtime: RealtimeClient
 };
-/**
-* Configuration for listing messages.
-*/
-type MessageListParams = {
-	/** Conversation ID to filter by */
-	conversationId?: string
-	/** Number of results per page */
-	limit?: number
-	/** Page number (1-indexed) */
-	page?: number
-};
-/**
-* Client for interacting with conversation messages.
-*
-* @example
-* ```ts
-* const messages = await kivox.messages.list({
-*   conversationId: 'conv-123'
-* });
-* ```
-*/
-declare class MessageClient {
-	private readonly http;
-	constructor(http: HttpTransport);
-	/**
-	* Lists messages with optional filtering and pagination.
-	*
-	* @param params List configuration
-	* @returns Paginated list of messages
-	*/
-	list(params?: MessageListParams): Promise<Paginated<Message[]>>;
-	/**
-	* Gets a single message by ID.
-	*
-	* @param id Message ID
-	* @returns Message details
-	*/
-	get(id: string): Promise<Message>;
-}
-type Template = {
-	id: string
-	name: string
-	description?: string
-	ork_source: string
-	created_at: Date
-	updated_at: Date
+type SessionClientOptions = {
+	/** Base URL of the Kivox API. Defaults to 'https://server.kivox.com.co'. */
+	baseUrl?: string
 };
-type TemplateCreate = Pick<Template, "name" | "description" | "ork_source">;
-type TemplateUpdate = Partial<TemplateCreate>;
-/**
-* Configuration for listing templates.
-*/
-type TemplateListParams = {
-	/** Number of results per page */
-	limit?: number
-	/** Page number (1-indexed) */
-	page?: number
+type ApiKeyClientOptions = {
+	/** API key used for Bearer token authentication. */
+	apiKey: string
+	/** Base URL of the Kivox API. Defaults to 'https://server.kivox.com.co'. */
+	baseUrl?: string
 };
 /**
-* Client for interacting with Kivox templates.
+* Creates a Kivox client for browser-based Studio usage.
+* Authenticates via HttpOnly session cookie — no token required in JS.
+* Requires the user to be logged in via `POST /auth/sessions` first.
 *
 * @example
 * ```ts
-* const templates = await kivox.templates.list();
-* const template = await kivox.templates.get('template-123');
+* const client = createSessionClient();
+* await client.postAuthSessions({ email, password });
+* const { data: agents } = await client.getUsersMeAgents();
 * ```
 */
-declare class TemplateClient {
-	private readonly http;
-	constructor(http: HttpTransport);
-	/**
-	* Lists all templates with optional filtering and pagination.
-	*
-	* @param params List configuration
-	* @returns Paginated list of templates
-	*/
-	list(params?: TemplateListParams): Promise<Paginated<Template[]>>;
-	/**
-	* Gets a single template by ID.
-	*
-	* @param id Template ID
-	* @returns Template details
-	*/
-	get(id: string): Promise<Template>;
-	/**
-	* Creates a new template.
-	*
-	* @param data Template data
-	* @returns Created template
-	*/
-	create(data: TemplateCreate): Promise<Template>;
-	/**
-	* Updates an existing template.
-	*
-	* @param id Template ID
-	* @param data Updated template data
-	* @returns Updated template
-	*/
-	update(id: string, data: TemplateUpdate): Promise<Template>;
-	/**
-	* Deletes a template.
-	*
-	* @param id Template ID
-	*/
-	delete(id: string): Promise<void>;
-}
-/**
-* Configuration for the Kivox client.
-*/
-type KivoxConfig = {
-	/**
-	* Base URL of your self-hosted Kivox instance.
-	* @example 'http://localhost:8787'
-	* @example 'https://api.kivox.io'
-	*/
-	baseUrl: string
-	/**
-	* Optional headers to include with all requests.
-	* @example { Authorization: 'Bearer token' }
-	*/
-	headers?: Record<string, string>
-};
+declare function createSessionClient({ baseUrl }?: SessionClientOptions): KivoxClient;
 /**
-* Main Kivox client.
-* Provides unified access to all Kivox resources.
+* Creates a Kivox client for programmatic / server-side usage.
+* Authenticates via `Authorization: Bearer <apiKey>` on every request.
 *
 * @example
 * ```ts
-* import { KivoxClient } from '@kivox/client';
-*
-* const kivox = new KivoxClient({
-*   baseUrl: 'http://localhost:8787',
-* });
-*
-* // List agents
-* const agents = await kivox.agents.list();
-*
-* // Start a conversation
-* const session = await kivox.conversations.connect({
-*   agentId: '019bb51e-e45f-75e3-b828-94fdf231711e',
-*   onEvent: (event) => {
-*     console.log(event);
-*   }
-* });
+* const client = createApiKeyClient({ apiKey: 'sk_live_...' });
+* const { data: agents } = await client.getUsersMeAgents();
 * ```
 */
-declare class KivoxClient {
-	/** Agent resource client */
-	readonly agents: AgentClient;
-	/** Conversation resource client */
-	readonly conversations: ConversationClient;
-	/** Template resource client */
-	readonly templates: TemplateClient;
-	/** Message resource client */
-	readonly messages: MessageClient;
-	constructor(config: KivoxConfig);
-}
-export { TemplateUpdate, TemplateCreate, Template, SessionConnectionLostEvent, ServerTurnComplete, ServerTick, ServerTextFull, ServerTextDelta, ServerSessionEvent, ServerSessionClosed, ServerMessage, ServerHandshakeOK, ServerHandshakeError, ServerFlowComplete, ServerError, ServerConnectionMessage, ServerAudioDelta, Paginated, MessageRole, Message, KivoxConfig, KivoxClient, HttpTransportError, ConversationTransportError, ConversationSessionConfig, ConversationSession, Conversation, ClientMessage, ClientInputText, ClientInputAudioStream, ClientInputAudio, ClientHandshake, ClientEndSession, ClientCancel, AgentUpdate, AgentStatus, AgentSecret, AgentCreate, AgentConfig, AgentCompilationDiagnostic, Agent };
+declare function createApiKeyClient({ apiKey, baseUrl }: ApiKeyClientOptions): KivoxClient;
+export { updateTemplate, updateOrgMember, updateOrg, updateCurrentUserEmail, updateCurrentUser, updateAgentStatus, updateAgent, signup, revokeApiKey, removeOrgMember, logoutAll, logout, login, listUserTemplates, listUserAgents, listOrgs, listOrgTemplates, listOrgMembers, listOrgAgents, listMessages, listConversations, listApiKeys, getUser, getTemplate, getOrg, getCurrentUser, getConversation, getAgent, deleteTemplate, deleteOrg, deleteCurrentUser, deleteConversation, deleteAgent, createUserTemplate, createUserAgent, createSessionClient, createOrgTemplate, createOrgAgent, createOrg, createApiKeyClient, createApiKey, compileAgent, addOrgMember, User, UpdateTemplateResult, UpdateTemplateBody, UpdateStatusBodyStatus, UpdateStatusBody, UpdateOrgResult, UpdateOrgMemberResult, UpdateOrgBody, UpdateMemberBodyRole, UpdateMemberBody, UpdateCurrentUserResult, UpdateCurrentUserEmailResult, UpdateCurrentUserEmailBody, UpdateCurrentUserBody, UpdateAgentStatusResult, UpdateAgentResult, UpdateAgentBody, Template, SignupResult, SignupBody, SessionResponse, SessionConnectionLostEvent, SessionClientOptions, ServerTurnComplete, ServerTick, ServerTextFull, ServerTextDelta, ServerSessionEvent, ServerSessionClosed, ServerMessage, ServerHandshakeOK, ServerHandshakeError, ServerFlowComplete, ServerError, ServerConnectionMessage, ServerAudioDelta, Secret, Safeguards, RevokeApiKeyResult, RemoveOrgMemberResult, PageResponseTemplate, PageResponseAgent, Org, Message, Member, LogoutResult, LogoutAllResult, LoginResult, LoginBody, ListUserTemplatesResult, ListUserTemplatesParams, ListUserAgentsResult, ListUserAgentsParams, ListOrgsResult, ListOrgTemplatesResult, ListOrgTemplatesParams, ListOrgMembersResult, ListOrgAgentsResult, ListOrgAgentsParams, ListMessagesResult, ListMessagesParams, ListConversationsResult, ListConversationsParams, ListApiKeysResult, KivoxClient, GetUserResult, GetTemplateResult, GetOrgResult, GetCurrentUserResult, GetConversationResult, GetAgentResult, ErrorModel, ErrorDetail, DeleteTemplateResult, DeleteOrgResult, DeleteCurrentUserResult, DeleteConversationResult, DeleteAgentResult, CursorResponseMessage, CursorResponseConversation, CreateUserTemplateResult, CreateUserAgentResult, CreateTemplateBody, CreateOrgTemplateResult, CreateOrgResult, CreateOrgBody, CreateOrgAgentResult, CreateApiKeyResult, CreateAgentBody, CreateAPIKeyBody, ConversationTransportError, ConversationSessionConfig, ConversationSession, Conversation, Config, CompileDiagnostics, CompileBody, CompileAgentResult, ClientMessage, ClientInputText, ClientInputAudioStream, ClientInputAudio, ClientHandshake, ClientEndSession, ClientCancel, ApiKeyClientOptions, Agent, AddOrgMemberResult, AddMemberBodyRole, AddMemberBody, APIKeyResponse, APIKey };