@applica-software-guru/persona-sdk 0.1.96 → 0.1.101

package/dist/index.d.ts

@@ -1,7 +1,1442 @@
-export * from './runtime';
-export * from './logging';
-export * from './protocol';
-export * from './types';
-export * from './tools';
-export * from './storage';
-//# sourceMappingURL=index.d.ts.map
+export declare interface AddProjectSubscriptionCreditsRequest {
+    credits: number;
+}
+
+export declare interface Agent {
+    id?: string;
+    projectId?: string;
+    apiKey?: string;
+    code?: string;
+    name?: string;
+    description?: string;
+    type?: AgentType;
+    synthesizer?: SynthesizerConfiguration;
+    transcriber?: TranscriberConfiguration;
+    model?: ModelConfiguration;
+    systemInstructions?: string;
+    variables?: Variable[];
+    enabledProtocols?: AgentProtocol[];
+    twilio?: TwilioConfiguration;
+    languageCode?: LanguageCode;
+    initialMessage?: string;
+    initialMessageMode?: "processed" | "static";
+    knowledge?: KnowledgeConfiguration;
+    wakeup?: WakeupConfiguration;
+    telegram?: TelegramConfiguration;
+    whatsapp?: WhatsAppConfiguration;
+    collaboration?: CollaborationConfiguration;
+    orchestration?: OrchestrationConfiguration;
+    network?: NetworkConfiguration;
+    features?: Feature[];
+    toolkit?: ToolkitConfiguration;
+    shortTermMemory?: StmConfiguration;
+    contextManagement?: ContextManagementConfiguration;
+    attachmentsPreprocessor?: AttachmentsPreprocessorConfiguration;
+    responseSchema?: Record<string, unknown>;
+    verboseErrors?: boolean;
+}
+
+export declare interface AgentContext {
+}
+
+export declare interface AgentCreateRequest {
+    projectId?: string;
+    code?: string;
+    name?: string;
+    description?: string;
+    type?: AgentType;
+    synthesizer?: SynthesizerConfiguration;
+    transcriber?: TranscriberConfiguration;
+    model?: ModelConfiguration;
+    systemInstructions?: string;
+    variables?: Variable[];
+    enabledProtocols?: AgentProtocol[];
+    twilio?: TwilioConfiguration;
+    languageCode?: LanguageCode;
+    initialMessage?: string;
+    initialMessageMode?: "processed" | "static";
+    knowledge?: KnowledgeConfiguration;
+    wakeup?: WakeupConfiguration;
+    telegram?: TelegramConfiguration;
+    whatsapp?: WhatsAppConfiguration;
+    collaboration?: CollaborationConfiguration;
+    orchestration?: OrchestrationConfiguration;
+    network?: NetworkConfiguration;
+    features?: Feature[];
+    toolkit?: ToolkitConfiguration;
+    shortTermMemory?: StmConfiguration;
+    contextManagement?: ContextManagementConfiguration;
+    attachmentsPreprocessor?: AttachmentsPreprocessorConfiguration;
+    responseSchema?: Record<string, unknown>;
+    verboseErrors?: boolean;
+}
+
+export declare type AgentProtocol = 'webrtc' | 'twilio' | 'rest' | 'websocket' | 'telegram';
+
+export declare interface AgentResponse {
+    messages?: Message[];
+    transfer?: TransferAction;
+}
+
+export declare class AgentsApi extends HttpApi {
+    constructor(baseUrl: string, auth: string | AuthenticationProvider);
+    list(keyword?: string | null, page?: number, size?: number, extraParams?: Record<string, string>): Promise<Paginated<Agent>>;
+    get(agentId: string): Promise<Agent>;
+    create(request: AgentCreateRequest): Promise<Agent>;
+    update(request: AgentUpdateRequest): Promise<Agent>;
+    remove(agentId: string): Promise<void>;
+    getSynthesizerSupportedVoices(synthesizerName: string): Promise<SynthesizerVoice[]>;
+    listRevisions(agentId: string): Promise<Revision[]>;
+    getRevision(agentId: string, revisionId: string): Promise<Revision>;
+    rollback(agentId: string, revisionId: string): Promise<Agent>;
+    generateSystemInstructions(prompt: string, sessionId?: string): Promise<string>;
+    getArchitect(): Promise<Agent>;
+}
+
+declare interface AgentStateInfo {
+    state: string;
+    sessionId?: string;
+    agentId?: string;
+    currentTurn?: number;
+    pendingSteers?: number;
+    eventCount?: number;
+    message?: string;
+}
+
+export declare type AgentType = 'agent';
+
+export declare interface AgentUpdateRequest extends Agent {
+}
+
+export declare interface AgentValue {
+    agentId?: string;
+    initialContext?: Record<string, unknown>;
+}
+
+export declare class ApiException extends Error {
+    readonly statusCode: number;
+    readonly body: string;
+    constructor(statusCode: number, body: string);
+}
+
+export declare class ApiKeyAuthenticationProvider implements AuthenticationProvider {
+    private readonly apiKey;
+    constructor(apiKey: string);
+    applyHeaders(headers: Headers): void;
+    getCredentials(): string;
+}
+
+export declare interface AttachmentsPreprocessorConfiguration {
+    enabled?: boolean;
+    imageHandling?: AttachmentsPreprocessorImageHandling;
+    standalonePassthrough?: boolean;
+    secondaryModel?: ModelConfiguration;
+    llmPrompt?: string;
+    pdfImageDpi?: number;
+    maxPages?: number;
+    failOpen?: boolean;
+}
+
+export declare type AttachmentsPreprocessorImageHandling = 'drop' | 'describe' | 'keep';
+
+export declare interface AuthenticationProvider {
+    applyHeaders(headers: Headers): void;
+    getCredentials(): string;
+}
+
+export declare interface AuthorizeRequest {
+    name?: string;
+    provider?: string;
+    clientId?: string;
+    clientSecret?: string;
+    scope?: string;
+    apiKey?: string;
+    apiSecret?: string;
+    token?: string;
+    successUrl?: string;
+    server?: string;
+    port?: number;
+    useSsl?: boolean;
+    username?: string;
+    password?: string;
+}
+
+export declare interface AuthorizeResponse {
+    credentials?: Credentials;
+    state?: OAuth2State;
+    redirectUrl?: string;
+}
+
+export declare class BearerTokenAuthenticationProvider implements AuthenticationProvider {
+    private readonly token;
+    constructor(token: string);
+    applyHeaders(headers: Headers): void;
+    getCredentials(): string;
+}
+
+export declare class BillingClient {
+    private readonly baseUrl;
+    private readonly authProvider;
+    constructor(baseUrl?: string, auth?: string | AuthenticationProvider | null);
+    private buildHeaders;
+    private request;
+    createCustomer(request: CreateCustomerRequest): Promise<Customer>;
+    updateCustomer(owner: string, request: UpdateCustomerRequest): Promise<Customer>;
+    getCustomer(owner: string): Promise<Customer>;
+    saveCustomer(customer: Customer): Promise<Customer>;
+    deleteCustomer(owner: string): Promise<void>;
+    createSubscription(request: CreateSubscriptionRequest): Promise<Subscription>;
+    getSubscription(owner: string): Promise<Subscription>;
+    getProjectSubscription(projectId: string): Promise<Subscription>;
+    changeProjectSubscriptionPlan(projectId: string, request: {
+        toPlanType: string;
+    }): Promise<Subscription>;
+    addProjectSubscriptionCredits(projectId: string, request: {
+        credits: number;
+    }): Promise<Subscription>;
+    beginUpgrade(owner: string, request: UpgradeSubscriptionRequest): Promise<Subscription>;
+    downgrade(owner: string, request: DowngradeSubscriptionRequest): Promise<Subscription>;
+    mentorize(owner: string, request: MentorizeSubscriptionRequest): Promise<Subscription>;
+    addCredits(owner: string, credits: number): Promise<Subscription>;
+    useCredits(owner: string, credits: number, services: string[], referenceId?: string, totalCost?: number, totalPrice?: number): Promise<Subscription>;
+    getCredits(owner: string): Promise<number>;
+    isValid(owner: string): Promise<boolean>;
+    listInvoices(owner: string, dateFrom?: string, dateTo?: string): Promise<Invoice[]>;
+    cancelSubscription(owner: string): Promise<Subscription>;
+    getUsageStats(projectId: string, dateFrom?: string, dateTo?: string, models?: string[]): Promise<UsageStats>;
+    listUsages(projectId: string, dateFrom?: string, dateTo?: string, models?: string[], sessionId?: string, page?: number, size?: number): Promise<UsagePage>;
+}
+
+export declare interface BillingUsage {
+    id?: string;
+    subscriptionId?: string;
+    creditsUsed?: number;
+    services?: string[];
+    totalCost?: number;
+    totalPrice?: number;
+    referenceId?: string;
+    sessionId?: string;
+    userId?: string;
+    details?: UsageDetail[];
+    createdAt?: string;
+}
+
+export declare interface ChangeProjectSubscriptionPlanRequest {
+    toPlanType: string;
+}
+
+export declare interface ChunkResult {
+    id?: string;
+    text?: string;
+    score?: number;
+    metadata?: Record<string, unknown>;
+    documentId?: string;
+}
+
+export declare interface CollaborationConfiguration {
+    enabled?: boolean;
+    collaborators?: Collaborator[];
+    mode?: CollaborationMode;
+    maxNumberOfIterations?: number;
+}
+
+export declare type CollaborationMode = 'delegate_and_return' | 'persistent_transfer' | 'consult_then_respond';
+
+export declare interface Collaborator {
+    name?: string;
+    agent?: string;
+    scope?: string;
+}
+
+export declare interface CommittedUsage {
+    id?: string;
+    committedAt?: string;
+    projectId?: string;
+    sessionId?: string;
+    creditsUsed?: number;
+    totalCost?: number;
+    totalPrice?: number;
+    userId?: string;
+    details?: UsageCost[];
+}
+
+export declare interface Connection {
+    id?: string;
+    sourceId?: string;
+    targetId?: string;
+    sourceHandle?: string;
+    targetHandle?: string;
+}
+
+export declare interface ContentItem {
+    text?: string | Ref;
+    file?: ContentItemFile | Ref;
+}
+
+export declare interface ContentItemFile {
+    content?: string;
+    contentType?: string;
+}
+
+export declare interface ContentValue {
+    content?: ContentItem[];
+}
+
+export declare interface ContextManagementConfiguration {
+    enabled?: boolean;
+    maxContextTokens?: number;
+    summarizationThreshold?: number;
+    keepLastNIterations?: number;
+    keepFirstMessage?: boolean;
+    maxToolCallsBeforeCompaction?: number;
+    useLlmCompaction?: boolean;
+    maxSummaryWords?: number;
+    truncationEnabled?: boolean;
+    maxObservationTokens?: number;
+    compactionModel?: ModelConfiguration;
+}
+
+export declare interface CreateCustomerRequest {
+    owner?: string;
+    name?: string;
+    email?: string;
+    phone?: string;
+}
+
+export declare interface CreateSubscriptionRequest {
+    owner: string;
+}
+
+export declare interface Credentials {
+    id?: string;
+    name?: string;
+    projectId?: string;
+    provider?: string;
+    obtainedAt?: string;
+    validUntil?: string;
+    data?: unknown;
+    clientId?: string;
+    clientSecret?: string;
+    apiKey?: string;
+    apiSecret?: string;
+    token?: string;
+    successUrl?: string;
+    active?: boolean;
+    server?: string;
+    port?: number;
+    useSsl?: boolean;
+    username?: string;
+    password?: string;
+}
+
+export declare class CredentialsApi extends HttpApi {
+    constructor(baseUrl: string, auth: string | AuthenticationProvider);
+    authorize(provider: string, request: AuthorizeRequest): Promise<AuthorizeResponse>;
+    handleOAuth2Callback(provider: string, code: string, state: string, scope?: string): Promise<OAuth2CallbackResponse>;
+    list(): Promise<Credentials[]>;
+    getByProvider(provider: string): Promise<Credentials[]>;
+    getById(credentialsId: string): Promise<Credentials>;
+    remove(credentialsId: string): Promise<void>;
+}
+
+export declare interface Customer {
+    id?: string;
+    owner?: string;
+    name?: string;
+    email?: string;
+    phone?: string;
+    address?: string;
+    stripeCustomerId?: string;
+}
+
+export declare type DocumentExtractorName = 'fitz' | 'document-ai' | 'gemini' | 'markdown';
+
+export declare interface DowngradeSubscriptionRequest {
+    toPlanType: string;
+}
+
+export declare type EmbeddingModelName = 'text-multilingual-embedding-002' | 'gemini-embedding-001';
+
+export declare interface ExecuteRequest {
+    userId?: string;
+    initialData?: Record<string, unknown>;
+    callbackUrl?: string;
+}
+
+export declare interface Execution {
+    id?: string;
+    workflowId?: string;
+    status?: string;
+    userId?: string;
+    steps?: Step[];
+    startedAt?: string;
+    endedAt?: string;
+    output?: Record<string, unknown>;
+    error?: string;
+}
+
+export declare type ExecutionStatus = 'running' | 'completed' | 'failed' | 'cancelled';
+
+export declare interface Feature {
+    id?: string;
+    templateId?: string;
+    credentialsId?: string;
+}
+
+export declare type FeatureConfiguration = McpServerConfiguration | FlagConfiguration | SkillConfiguration;
+
+export declare interface FeatureCredentialsConfiguration {
+    requireCredentials?: boolean;
+    credentialsType?: string;
+}
+
+export declare class FeaturesApi {
+    private readonly baseUrl;
+    private readonly auth;
+    constructor(baseUrl: string, auth: string | AuthenticationProvider);
+    templates(): FeatureTemplatesApi;
+}
+
+export declare interface FeatureTemplate {
+    id?: string;
+    projectId?: string;
+    type?: FeatureType;
+    name?: string;
+    description?: string;
+    logoUrl?: string;
+    configuration?: FeatureConfiguration;
+    credentialsConfiguration?: FeatureCredentialsConfiguration;
+}
+
+export declare class FeatureTemplatesApi extends HttpApi {
+    constructor(baseUrl: string, auth: string | AuthenticationProvider);
+    list(keyword?: string | null, page?: number, size?: number, extraParams?: Record<string, string>): Promise<Paginated<FeatureTemplate>>;
+    get(templateId: string): Promise<FeatureTemplate>;
+    create(template: FeatureTemplate): Promise<FeatureTemplate>;
+    update(templateId: string, template: FeatureTemplate): Promise<FeatureTemplate>;
+    patch(templateId: string, template: FeatureTemplate): Promise<FeatureTemplate>;
+    remove(templateId: string): Promise<void>;
+    getMcpAvailableTools(configuration: McpServerConfiguration, credentialsId?: string): Promise<McpToolsResponse>;
+}
+
+export declare type FeatureType = 'mcp' | 'flag' | 'skill';
+
+export declare interface FlagConfiguration {
+    type?: string;
+    flag?: string;
+}
+
+export declare interface FunctionCall {
+    name?: string;
+    args?: Record<string, unknown>;
+    id?: string;
+}
+
+export declare interface FunctionResponse {
+    name?: string;
+    result?: ToolResultItem | ToolResultItem[] | null;
+    functionCallId?: string;
+}
+
+export declare interface GenerationRequest {
+    agentId?: string;
+    userMessage?: unknown;
+    initialContext?: AgentContext;
+    responseSchema?: Record<string, unknown>;
+    parentSessionId?: string;
+    userId?: string;
+}
+
+export declare interface GenerationResponse {
+    json?: unknown;
+    response?: AgentResponse;
+    sessionId?: string;
+}
+
+export declare interface GmailTriggerSourceConfiguration {
+    event?: string;
+    query?: string;
+    credentialsId?: string;
+    userEmail?: string;
+    watchExpiration?: number;
+    lastHistoryId?: number;
+}
+
+export declare interface Handle {
+    name?: string;
+    description?: string;
+    type?: string;
+}
+
+declare abstract class HttpApi {
+    private readonly baseUrl;
+    private readonly authProvider;
+    constructor(baseUrl: string, apiKey: string | AuthenticationProvider);
+    protected getBaseUrl(): string;
+    protected getAuthProvider(): AuthenticationProvider;
+    protected normalizePageParams(page?: number, size?: number): {
+        page: number;
+        size: number;
+    };
+    private buildHeaders;
+    private buildUrl;
+    private handleResponse;
+    protected httpGet<T>(path: string, params?: Record<string, unknown>): Promise<T>;
+    protected httpPost<T>(path: string, body?: unknown, params?: Record<string, unknown>): Promise<T>;
+    protected httpPut<T>(path: string, body: unknown): Promise<T>;
+    protected httpPatch<T>(path: string, body: unknown): Promise<T>;
+    protected httpDelete(path: string): Promise<void>;
+}
+
+export declare interface HttpTransport {
+    url?: string;
+    enablePersonaAuth?: boolean;
+    headers?: Record<string, string>;
+}
+
+declare interface Image_2 {
+    content?: string;
+    contentType?: string;
+}
+export { Image_2 as Image }
+
+export declare interface ImapTriggerSourceConfiguration {
+    event?: string;
+    credentialsId?: string;
+    mailbox?: string;
+    searchCriteria?: string;
+    processAttachments?: boolean;
+    allowedMimeTypes?: string[];
+}
+
+export declare interface Invoice {
+    id?: string;
+    subscriptionId?: string;
+    status?: string;
+    amountDue?: number;
+    amountPaid?: number;
+    currency?: string;
+    customerEmail?: string;
+    customerName?: string;
+    hostedInvoiceUrl?: string;
+    invoicePdf?: string;
+    dueDate?: string;
+    createdAt?: string;
+    updatedAt?: string;
+    lines?: LineItem[];
+}
+
+export declare interface KnowledgeBase {
+    id?: string;
+    projectId?: string;
+    name?: string;
+    description?: string;
+    quality?: KnowledgeBaseQuality;
+    chunkSize?: KnowledgeBaseChunkSize;
+    embeddingModel?: EmbeddingModelName;
+}
+
+export declare type KnowledgeBaseChunkSize = 'small' | 'medium' | 'large';
+
+export declare interface KnowledgeBaseCreateRequest {
+    name?: string;
+    description?: string;
+    quality?: KnowledgeBaseQuality;
+    chunkSize?: KnowledgeBaseChunkSize;
+    embeddingModel?: EmbeddingModelName;
+}
+
+export declare interface KnowledgeBaseDocument {
+    id?: string;
+    knowledgeBaseId?: string;
+    path?: string;
+    name?: string;
+    size?: number;
+    contentType?: string;
+    status?: KnowledgeBaseDocumentStatus;
+    progress?: number;
+    extractor?: DocumentExtractorName;
+    error?: string;
+    metadata?: Record<string, unknown>;
+    totalPages?: number;
+    callbackUrl?: string;
+}
+
+export declare class KnowledgeBaseDocumentsApi extends HttpApi {
+    private readonly knowledgeBaseId;
+    constructor(baseUrl: string, auth: string | AuthenticationProvider, knowledgeBaseId: string);
+    list(keyword?: string | null, page?: number, size?: number): Promise<Paginated<KnowledgeBaseDocument>>;
+    upload(request: KnowledgeBaseDocumentUploadRequest): Promise<KnowledgeBaseDocument>;
+    get(documentId: string): Promise<KnowledgeBaseDocument>;
+    reprocess(documentId: string): Promise<KnowledgeBaseDocument>;
+    remove(documentId: string): Promise<void>;
+}
+
+export declare type KnowledgeBaseDocumentStatus = 'pending' | 'processing' | 'completed' | 'failed';
+
+export declare interface KnowledgeBaseDocumentUploadRequest {
+    uri?: string;
+    base64?: string;
+    name?: string;
+    extractor?: DocumentExtractorName;
+    callbackUrl?: string;
+}
+
+export declare type KnowledgeBaseQuality = 'extremely_high' | 'very_high' | 'high' | 'medium' | 'low';
+
+export declare class KnowledgeBasesApi extends HttpApi {
+    constructor(baseUrl: string, auth: string | AuthenticationProvider);
+    list(keyword?: string | null, page?: number, size?: number, extraParams?: Record<string, string>): Promise<Paginated<KnowledgeBase>>;
+    get(id: string): Promise<KnowledgeBase>;
+    create(request: KnowledgeBaseCreateRequest): Promise<KnowledgeBase>;
+    update(request: KnowledgeBaseUpdateRequest): Promise<KnowledgeBase>;
+    remove(id: string): Promise<void>;
+    documents(knowledgeBaseId: string): KnowledgeBaseDocumentsApi;
+    searchChunks(id: string, request: SearchChunksRequest): Promise<ChunkResult[]>;
+}
+
+export declare interface KnowledgeBaseUpdateRequest {
+    id?: string;
+    name?: string;
+    description?: string;
+}
+
+export declare interface KnowledgeConfiguration {
+    enabled?: boolean;
+    knowledgeType?: KnowledgeType;
+    namespace?: string[];
+    numberOfEntries?: number;
+    args?: Record<string, unknown>;
+    knowledgeBaseId?: string;
+}
+
+export declare type KnowledgeType = 'multi_hop' | 'simple';
+
+export declare interface KnownModel {
+    id?: string;
+    provider?: string;
+    modelName?: string;
+    label?: string;
+    deprecated?: boolean;
+}
+
+export declare class KnownModelsApi extends HttpApi {
+    constructor(baseUrl: string, auth: string | AuthenticationProvider);
+    list(keyword?: string | null, page?: number, size?: number, extraParams?: Record<string, string>): Promise<Paginated<KnownModel>>;
+    get(id: string): Promise<KnownModel>;
+    create(knownModel: KnownModel): Promise<KnownModel>;
+    update(id: string, knownModel: KnownModel): Promise<KnownModel>;
+    remove(id: string): Promise<void>;
+}
+
+export declare type LanguageCode = 'en-US' | 'it-IT' | 'es-ES' | 'fr-FR' | 'de-DE' | 'pt-BR';
+
+export declare interface LineItem {
+    description?: string;
+    amount?: number;
+    currency?: string;
+    quantity?: number;
+    periodStart?: string;
+    periodEnd?: string;
+}
+
+export declare interface McpServerConfiguration {
+    type?: string;
+    name?: string;
+    transport?: Transport;
+    enabledTools?: string[];
+    disabledTools?: string[];
+}
+
+export declare interface McpToolsResponse {
+    tools?: ToolDefinition[];
+    error?: string;
+}
+
+export declare interface MentorizeSubscriptionRequest {
+    endDate?: string;
+}
+
+export declare interface Message {
+    id?: string;
+    sessionId?: string;
+    text?: string;
+    image?: Image_2;
+    file?: SessionFile;
+    role?: string;
+    timestamp?: number;
+    createdAt?: string;
+    functionCalls?: FunctionCall[];
+    functionResponse?: FunctionResponse;
+    finishReason?: string;
+    sources?: Source[];
+    task?: Record<string, unknown>;
+    sender?: string;
+    thought?: boolean;
+}
+
+export declare interface Mission {
+    id?: string;
+    projectId?: string;
+    name?: string;
+    goal?: string;
+    status?: MissionStatus;
+    plannerAgentId?: string;
+    workerAgents?: Record<string, unknown>[];
+    steps?: Record<string, unknown>[];
+    currentStepId?: string;
+    version?: number;
+    userInstructions?: string[];
+    createdAt?: string;
+    updatedAt?: string;
+}
+
+export declare class MissionsApi extends HttpApi {
+    constructor(baseUrl: string, auth: string | AuthenticationProvider);
+    list(keyword?: string | null, page?: number, size?: number, status?: string | null): Promise<Paginated<Mission>>;
+    get(missionId: string): Promise<Mission>;
+    create(mission: Mission): Promise<Mission>;
+    update(missionId: string, mission: Mission): Promise<Mission>;
+    remove(missionId: string): Promise<void>;
+    generate(missionId: string): Promise<Mission>;
+    execute(missionId: string): Promise<Mission>;
+    retry(missionId: string): Promise<Mission>;
+    replan(missionId: string): Promise<Mission>;
+    sendInstruction(missionId: string, instruction: string): Promise<Mission>;
+    stop(missionId: string): Promise<Mission>;
+    resume(missionId: string): Promise<Mission>;
+}
+
+export declare type MissionStatus = 'draft' | 'planned' | 'active' | 'review' | 'paused' | 'completed' | 'failed' | 'cancelled';
+
+export declare interface ModelConfiguration {
+    /** litellm-style "<provider>/<model>" string (e.g. "fireworks/accounts/fireworks/models/minimax-m3"). Use the known-models API for the current list. */
+    modelName?: string;
+    temperature?: number;
+    reasoningEffort?: ReasoningEffort;
+    /** Maximum number of output tokens to generate. Undefined = provider default. */
+    maxOutputTokens?: number;
+    /** Override the per-provider default API key (env var) when set. */
+    apiKey?: string;
+    /** Override the per-provider default base URL when set. */
+    baseUrl?: string;
+    /** Passed verbatim as extra_body to the underlying LLM request (e.g. { service_tier: "priority" }). */
+    extraBody?: Record<string, unknown>;
+    /** @deprecated use `baseUrl`. Kept for backward compatibility. */
+    url?: string;
+    /** @deprecated use litellm `modelName` (e.g. "ollama/llama3.1"). */
+    ollamaModelName?: string;
+    /** @deprecated use litellm `modelName` (e.g. "openai_compatible/gpt-4o"). */
+    openaiCompatibleModelName?: string;
+    /** @deprecated use `apiKey`. */
+    openaiCompatibleApiKey?: string;
+    /** @deprecated use litellm `modelName` (e.g. "openrouter/anthropic/claude-3"). */
+    openrouterModelName?: string;
+}
+
+export declare type ModelProvider = 'google' | 'openai' | 'grok' | 'fireworks' | 'together' | 'ollama' | 'openai_compatible' | 'openrouter';
+
+export declare interface NetworkConfiguration {
+    allowedWebsites?: string[];
+    allowedIps?: string[];
+}
+
+declare interface Node_2 {
+    id?: string;
+    type?: NodeType;
+    name?: string;
+    description?: string;
+    position?: Position;
+    allowDynamicInputVariables?: boolean;
+    allowDynamicOutputVariables?: boolean;
+    allowDynamicHandles?: boolean;
+    staticVariables?: WorkflowVariable[];
+    variables?: WorkflowVariable[];
+    values?: Record<string, unknown>;
+    staticHandles?: Handle[];
+    handles?: Handle[];
+}
+export { Node_2 as Node }
+
+export declare interface NodeExecutionResult {
+    nextNodes?: Node_2[];
+    output?: Record<string, unknown>;
+}
+
+export declare type NodeType = 'start' | 'action' | 'condition' | 'loop' | 'tool' | 'agent' | 'set_var' | 'output' | 'workflow' | 'resource' | 'script';
+
+export declare interface OAuth2CallbackResponse {
+    id?: string;
+    successUrl?: string;
+    success?: boolean;
+    error?: string;
+}
+
+export declare interface OAuth2State {
+    id?: string;
+    credentialsName?: string;
+    projectId?: string;
+    provider?: string;
+    status?: string;
+    code?: string;
+    scope?: string;
+    clientId?: string;
+    clientSecret?: string;
+    apiKey?: string;
+    apiSecret?: string;
+    token?: string;
+    successUrl?: string;
+}
+
+export declare interface OrchestrationAgent {
+    name?: string;
+    agent?: string;
+    scope?: string;
+}
+
+export declare interface OrchestrationConfiguration {
+    enabled?: boolean;
+    agents?: OrchestrationAgent[];
+    maxParallelCalls?: number;
+}
+
+export declare interface Paginated<T> {
+    items: T[];
+    total: number;
+    page: number;
+    size: number;
+}
+
+export declare interface Payment {
+    id?: string;
+    subscriptionId?: string;
+    status?: string;
+    product?: string;
+    quantity?: number;
+    createdAt?: string;
+    updatedAt?: string;
+    checkoutUrl?: string;
+    stripeCheckoutSessionId?: string;
+    stripeCustomerId?: string;
+    stripeSubscriptionId?: string;
+}
+
+export declare class PersonaSdk {
+    private readonly baseUrl;
+    private readonly workflowsBaseUrl;
+    private readonly billingBaseUrl;
+    constructor(baseUrl: string, workflowsBaseUrl: string, billingBaseUrl?: string);
+    projects(apiKey: string): ProjectsApi;
+    projects(authProvider: AuthenticationProvider): ProjectsApi;
+    agents(apiKey: string): AgentsApi;
+    agents(authProvider: AuthenticationProvider): AgentsApi;
+    knowledgeBases(apiKey: string): KnowledgeBasesApi;
+    knowledgeBases(authProvider: AuthenticationProvider): KnowledgeBasesApi;
+    workflows(apiKey: string): WorkflowsApi;
+    workflows(authProvider: AuthenticationProvider): WorkflowsApi;
+    credentials(apiKey: string): CredentialsApi;
+    credentials(authProvider: AuthenticationProvider): CredentialsApi;
+    features(apiKey: string): FeaturesApi;
+    features(authProvider: AuthenticationProvider): FeaturesApi;
+    triggers(apiKey: string): TriggersApi;
+    triggers(authProvider: AuthenticationProvider): TriggersApi;
+    servicePrices(apiKey: string): ServicePricesApi;
+    servicePrices(authProvider: AuthenticationProvider): ServicePricesApi;
+    knownModels(apiKey: string): KnownModelsApi;
+    knownModels(authProvider: AuthenticationProvider): KnownModelsApi;
+    sessions(apiKey: string): SessionsApi;
+    sessions(authProvider: AuthenticationProvider): SessionsApi;
+    missions(apiKey: string): MissionsApi;
+    missions(authProvider: AuthenticationProvider): MissionsApi;
+    billing(apiKey: string): BillingClient;
+    billing(authProvider: AuthenticationProvider): BillingClient;
+    values(apiKey: string): ValuesApi;
+    values(authProvider: AuthenticationProvider): ValuesApi;
+}
+
+export declare interface Position {
+    x?: number;
+    y?: number;
+}
+
+export declare interface Project {
+    id?: string;
+    name?: string;
+    tag?: string;
+    apiKey?: string;
+}
+
+export declare interface ProjectCreateRequest {
+    name: string;
+    tag?: string;
+}
+
+export declare interface ProjectDuplicateRequest {
+    name: string;
+    tag?: string;
+}
+
+export declare class ProjectsApi extends HttpApi {
+    private readonly billingBaseUrl;
+    constructor(baseUrl: string, auth: string | AuthenticationProvider, billingBaseUrl?: string);
+    list(keyword: string | null, page: number, size: number): Promise<Paginated<Project>>;
+    get(projectId: string): Promise<Project>;
+    getMine(): Promise<Project>;
+    create(request: ProjectCreateRequest): Promise<Project>;
+    update(request: ProjectUpdateRequest): Promise<Project>;
+    remove(projectId: string): Promise<void>;
+    duplicate(projectId: string, request: ProjectDuplicateRequest): Promise<Project>;
+    getSubscription(projectId: string): Promise<ProjectSubscription>;
+    changeSubscriptionPlan(projectId: string, request: ChangeProjectSubscriptionPlanRequest): Promise<ProjectSubscription>;
+    addSubscriptionCredits(projectId: string, request: AddProjectSubscriptionCreditsRequest): Promise<ProjectSubscription>;
+    setInfiniteCredits(projectId: string, request: SetProjectSubscriptionInfiniteCreditsRequest): Promise<ProjectSubscription>;
+    private billingRequest;
+}
+
+export declare interface ProjectSubscription {
+    id?: string;
+    projectId?: string;
+    owner?: string;
+    planType?: string;
+    status?: string;
+    startDate?: string;
+    planCredits?: number;
+    extraCredits?: number;
+    keepCreditsOnRenew?: boolean;
+    infiniteCredits?: boolean;
+    endDate?: string;
+    createdAt?: string;
+    updatedAt?: string;
+    stripeCustomerId?: string;
+    stripeSubscriptionId?: string;
+}
+
+export declare interface ProjectUpdateRequest {
+    projectId: string;
+    name?: string;
+    tag?: string;
+}
+
+export declare type ReasoningEffort = 'minimal' | 'low' | 'medium' | 'high';
+
+export declare interface Ref {
+    nodeId?: string;
+    variableName?: string;
+}
+
+export declare interface Revision {
+    id?: string;
+    entityId?: string;
+    projectId?: string;
+    revisionNumber?: number;
+    createdAt?: string;
+    snapshot?: Record<string, unknown>;
+}
+
+export declare interface RevisionType {
+    id?: string;
+    entityId?: string;
+    entityType?: string;
+    timestamp?: string;
+    data?: Record<string, unknown>;
+    userId?: string;
+    comment?: string;
+}
+
+export declare interface RunResult {
+    source?: Node_2;
+    success?: boolean;
+    message?: string;
+    nextNodes?: string[];
+}
+
+export declare interface SearchChunksRequest {
+    query?: string;
+    limit?: number;
+}
+
+export declare interface ServicePrice {
+    id?: string;
+    service?: string;
+    cost?: number;
+    unit?: string;
+    markupPercentage?: number;
+    fixedPrice?: number;
+}
+
+export declare class ServicePricesApi extends HttpApi {
+    constructor(baseUrl: string, auth: string | AuthenticationProvider);
+    list(keyword?: string | null, page?: number, size?: number, extraParams?: Record<string, string>): Promise<Paginated<ServicePrice>>;
+    get(id: string): Promise<ServicePrice>;
+    create(servicePrice: ServicePrice): Promise<ServicePrice>;
+    update(id: string, servicePrice: ServicePrice): Promise<ServicePrice>;
+    remove(id: string): Promise<void>;
+}
+
+export declare interface Session {
+    id?: string;
+    code?: string;
+    name?: string;
+    projectId?: string;
+    agentId?: string;
+    currentAgentId?: string;
+    userId?: string;
+    status?: string;
+    visibility?: string;
+    type?: string;
+    createdAt?: string;
+    finishedAt?: string;
+    parentSessionId?: string;
+    protocol?: string;
+    extras?: Record<string, unknown>;
+    isNew?: boolean;
+}
+
+export declare type SessionCollaborationMode = 'delegate_and_return' | 'persistent_transfer' | 'consult_then_respond';
+
+export declare interface SessionFile {
+    name?: string;
+    url?: string;
+    base64?: string;
+    contentType?: string;
+}
+
+export declare class SessionsApi extends HttpApi {
+    constructor(baseUrl: string, auth: string | AuthenticationProvider);
+    list(keyword?: string | null, status?: string | null, agentId?: string | null, userId?: string | null, page?: number, size?: number): Promise<Paginated<Session>>;
+    get(sessionId: string): Promise<Session>;
+    getUsage(sessionId: string): Promise<CommittedUsage[]>;
+    generateMessage(code: string, request: GenerationRequest): Promise<GenerationResponse>;
+    findMessages(code: string, page?: number, size?: number): Promise<Paginated<Message>>;
+    remove(code: string): Promise<void>;
+    rename(sessionId: string, name: string): Promise<Session>;
+    /**
+     * Get the current state of the agent execution for a session.
+     */
+    getAgentState(code: string): Promise<AgentStateInfo>;
+    /**
+     * Cancel a running agent execution for a session.
+     */
+    cancelExecution(code: string): Promise<{
+        status: string;
+        sessionId: string;
+    }>;
+    /**
+     * Steer a running agent execution by injecting an instruction.
+     */
+    steerExecution(code: string, text: string): Promise<SteerAccepted>;
+}
+
+declare interface SetProjectSubscriptionInfiniteCreditsRequest {
+    enabled: boolean;
+}
+
+export declare interface SkillConfiguration {
+    name?: string;
+    description?: string;
+    instructions?: string;
+    allowedTools?: string[];
+    metadata?: Record<string, unknown>;
+    resources?: SkillResource[];
+}
+
+export declare interface SkillResource {
+    path?: string;
+    content?: string;
+    contentType?: string;
+}
+
+export declare interface Source {
+    type?: string;
+    url?: string;
+    documentId?: string;
+    pageId?: string;
+    pageNumber?: number;
+    chunks?: SourceChunk[];
+    mostRelevant?: boolean;
+}
+
+export declare interface SourceChunk {
+    start?: number;
+    end?: number;
+}
+
+export declare interface StartNode extends Node_2 {
+    trigger?: WorkflowTrigger;
+}
+
+export declare interface StdioTransport {
+    command?: string;
+    args?: string[];
+    env?: Record<string, string>;
+    cwd?: string;
+}
+
+declare interface SteerAccepted {
+    steerId: string;
+    text: string;
+    acceptedAt: string;
+    willProcessAfterTurn: number | null;
+}
+
+export declare interface Step {
+    id?: string;
+    nodeId?: string;
+    status?: string;
+    startedAt?: string;
+    endedAt?: string;
+    result?: Record<string, unknown>;
+    error?: string;
+    output?: Record<string, unknown>;
+}
+
+export declare interface StmConfiguration {
+    type?: StmType;
+    maxMessages?: number;
+    includeToolCalls?: boolean;
+    model?: ModelConfiguration;
+    maxNumberOfWords?: number;
+    keepLastNObservations?: number;
+    maskingThreshold?: number;
+    summaryThreshold?: number;
+    maxContextTokens?: number;
+}
+
+export declare type StmType = 'simple' | 'summary' | 'compact';
+
+export declare interface Subscription {
+    id?: string;
+    projectId?: string;
+    owner?: string;
+    planType?: string;
+    status?: string;
+    startDate?: string;
+    planCredits?: number;
+    extraCredits?: number;
+    keepCreditsOnRenew?: boolean;
+    endDate?: string;
+    createdAt?: string;
+    updatedAt?: string;
+    stripeCustomerId?: string;
+    stripeSubscriptionId?: string;
+}
+
+export declare interface SynthesizerConfiguration {
+    enabled?: boolean;
+    synthesizerName?: SynthesizerName;
+    languageCode?: LanguageCode;
+    voice?: string;
+    sampleRateHertz?: number;
+    speed?: number;
+    similarityBoost?: number;
+    stability?: number;
+    style?: number;
+    voiceInstructions?: string;
+}
+
+export declare type SynthesizerName = 'gcloud' | 'elevenlabs' | 'gtts' | 'openai';
+
+export declare interface SynthesizerVoice {
+    id?: string;
+    name?: string;
+    languageCodes?: string[];
+    gender?: string;
+}
+
+export declare interface TelegramConfiguration {
+    enabled?: boolean;
+    botToken?: string;
+    enabledUsers?: string[];
+}
+
+export declare interface Tool {
+    type?: ToolType;
+    name?: string;
+    description?: string;
+    config?: ToolConfig;
+}
+
+export declare type ToolConfig = ToolLocalConfig | ToolRemoteConfig;
+
+export declare interface ToolDefinition {
+    name?: string;
+    description?: string;
+    parameters?: Record<string, unknown>;
+    output?: Record<string, unknown>;
+}
+
+export declare interface ToolkitConfiguration {
+    tools?: Tool[];
+}
+
+export declare interface ToolLocalConfig {
+    parameters?: Record<string, unknown>;
+    output?: Record<string, unknown>;
+}
+
+export declare interface ToolRemoteConfig {
+    serviceUrl?: string;
+    secret?: string;
+    timeout?: number;
+}
+
+declare type ToolResultItem = string | SessionFile | Image_2 | Record<string, unknown>;
+
+export declare type ToolType = 'remote' | 'local';
+
+export declare interface TranscriberConfiguration {
+    enabled?: boolean;
+    transcriberName?: TranscriberName;
+    languageCode?: LanguageCode;
+    sampleRateHertz?: number;
+}
+
+export declare type TranscriberName = 'gcloud' | 'deepgram' | 'vosk';
+
+export declare interface TransferAction {
+    request?: string;
+    thought?: string;
+    agent?: string;
+    functionCallMessage?: Message;
+    functionResponseMessage?: Message;
+    collaborationMode?: SessionCollaborationMode;
+}
+
+export declare type Transport = HttpTransport | StdioTransport;
+
+export declare interface Trigger {
+    id?: string;
+    projectId?: string;
+    name?: string;
+    source?: TriggerSource;
+    destination?: TriggerDestination;
+    enabled?: boolean;
+    createdAt?: string;
+    processedAt?: string;
+}
+
+export declare interface TriggerDestination {
+    type?: string;
+    configuration?: Record<string, unknown>;
+}
+
+export declare interface TriggerExecutionResult {
+    id?: string;
+    triggerId?: string;
+    success?: boolean;
+    message?: string;
+    processedAt?: string;
+}
+
+export declare class TriggerExecutionsApi extends HttpApi {
+    constructor(baseUrl: string, auth: string | AuthenticationProvider);
+    list(triggerId: string, page?: number, size?: number): Promise<Paginated<TriggerExecutionResult>>;
+    execute(triggerId: string, execution: TriggerExecutionResult): Promise<TriggerExecutionResult>;
+    get(executionId: string): Promise<TriggerExecutionResult>;
+    remove(executionId: string): Promise<void>;
+}
+
+export declare class TriggersApi extends HttpApi {
+    constructor(baseUrl: string, auth: string | AuthenticationProvider);
+    list(keyword?: string | null, page?: number, size?: number, extraParams?: Record<string, string>): Promise<Paginated<Trigger>>;
+    create(trigger: Trigger): Promise<Trigger>;
+    update(triggerId: string, trigger: Trigger): Promise<Trigger>;
+    remove(triggerId: string): Promise<void>;
+    get(triggerId: string): Promise<Trigger>;
+    executions(): TriggerExecutionsApi;
+}
+
+export declare interface TriggerSource {
+    type?: TriggerSourceType;
+    configuration?: TriggerSourceConfiguration;
+}
+
+export declare type TriggerSourceConfiguration = GmailTriggerSourceConfiguration | ImapTriggerSourceConfiguration | Record<string, unknown>;
+
+export declare type TriggerSourceType = 'webhook' | 'schedule' | 'gmail' | 'imap';
+
+export declare interface TwilioConfiguration {
+    phoneNumber?: string;
+}
+
+export declare interface UpdateCustomerRequest {
+    name?: string;
+    email?: string;
+    phone?: string;
+}
+
+export declare interface UpgradeSubscriptionRequest {
+    toPlanType: string;
+}
+
+export declare interface UsageCost {
+    service?: string;
+    value?: number;
+    cost?: number;
+    price?: number;
+    credits?: number;
+    unit?: string;
+}
+
+export declare interface UsageDailyEntry {
+    date: string;
+    credits: number;
+    count: number;
+    totalCost?: number;
+    totalPrice?: number;
+}
+
+export declare interface UsageDetail {
+    service?: string;
+    value?: number;
+    cost?: number;
+    price?: number;
+    credits?: number;
+    unit?: string;
+    [key: string]: unknown;
+}
+
+export declare interface UsageModelEntry {
+    model: string;
+    credits: number;
+    count: number;
+    totalCost?: number;
+    totalPrice?: number;
+}
+
+export declare interface UsagePage {
+    content: BillingUsage[];
+    totalElements: number;
+    totalPages: number;
+    page: number;
+    size: number;
+}
+
+export declare interface UsageStats {
+    subscription: Subscription;
+    totals: UsageTotals;
+    daily: UsageDailyEntry[];
+    byModel: UsageModelEntry[];
+    availableModels: string[];
+    hasCostData?: boolean;
+    costDataMode?: 'actual' | 'estimated_price' | 'mixed' | 'none';
+    hasEstimatedPriceData?: boolean;
+    hasActualCostData?: boolean;
+    costDataWarningCode?: string | null;
+}
+
+export declare interface UsageTotals {
+    creditsUsed: number;
+    usageCount: number;
+    previousCreditsUsed: number;
+    totalCost?: number;
+    totalPrice?: number;
+    previousTotalCost?: number;
+    previousTotalPrice?: number;
+}
+
+export declare class ValuesApi extends HttpApi {
+    constructor(baseUrl: string, auth: string | AuthenticationProvider);
+    get(category: string): Promise<Record<string, unknown>[]>;
+    getLanguageCodes(): Promise<string[]>;
+    getModelNames(): Promise<string[]>;
+    getModelProviders(): Promise<string[]>;
+    getKnowledgeTypes(): Promise<string[]>;
+    getCollaborationModes(): Promise<string[]>;
+    getTranscriberNames(): Promise<string[]>;
+    getSynthesizerNames(): Promise<string[]>;
+    getSynthesizerVoices(synthesizerName: string): Promise<string[]>;
+    getStmTypes(): Promise<string[]>;
+    getDocumentExtractors(): Promise<string[]>;
+    getEmbeddingModels(): Promise<string[]>;
+    getQualityOptions(): Promise<string[]>;
+    getChunkSizeOptions(): Promise<string[]>;
+    getFeatureTypes(): Promise<string[]>;
+    getRoles(): Promise<string[]>;
+    getServiceUnits(): Promise<string[]>;
+    getTriggerSourceTypes(): Promise<string[]>;
+    getTriggerDestinationTypes(): Promise<string[]>;
+}
+
+export declare interface Variable {
+    name?: string;
+    source?: VariableSource;
+    defaultValue?: unknown;
+}
+
+export declare type VariableDirection = 'in' | 'out';
+
+export declare interface VariableSource {
+    type?: string;
+    tool?: string;
+    args?: Record<string, unknown>;
+    property?: string;
+    mcpServer?: string;
+    resourceUri?: string;
+}
+
+export declare type VariableType = 'string' | 'number' | 'boolean' | 'object' | 'file' | 'list';
+
+export declare interface WakeupConfiguration {
+    enabled?: boolean;
+    wakeupWords?: string[];
+    sleepWords?: string[];
+    sleepInEachRequest?: boolean;
+    sleepDelaySeconds?: number;
+}
+
+export declare interface WhatsAppConfiguration {
+    phoneNumberId?: string;
+    enabledUsers?: string[];
+}
+
+export declare interface Workflow {
+    id?: string;
+    projectId?: string;
+    name?: string;
+    description?: string;
+    rootNode?: StartNode;
+    nodes?: Node_2[];
+    connections?: Connection[];
+    features?: Feature[];
+}
+
+export declare class WorkflowExecutionsApi extends HttpApi {
+    constructor(baseUrl: string, auth: string | AuthenticationProvider);
+    list(workflowId: string, page?: number, size?: number): Promise<Paginated<Execution>>;
+    get(workflowId: string, executionId: string): Promise<Execution>;
+    run(workflowId: string, request: ExecuteRequest): Promise<Execution>;
+    queue(workflowId: string, request: ExecuteRequest): Promise<Execution>;
+}
+
+export declare interface WorkflowResult {
+    workflowId?: string;
+    steps?: RunResult[];
+}
+
+export declare class WorkflowsApi extends HttpApi {
+    constructor(baseUrl: string, auth: string | AuthenticationProvider);
+    list(keyword?: string | null, page?: number, size?: number, extraParams?: Record<string, string>): Promise<Paginated<Workflow>>;
+    create(workflow: Workflow): Promise<Workflow>;
+    update(workflowId: string, workflow: Workflow): Promise<Workflow>;
+    remove(workflowId: string): Promise<void>;
+    get(workflowId: string): Promise<Workflow>;
+    executions(): WorkflowExecutionsApi;
+    listRevisions(workflowId: string): Promise<RevisionType[]>;
+    getRevision(workflowId: string, revisionId: string): Promise<RevisionType>;
+    rollback(workflowId: string, revisionId: string): Promise<Workflow>;
+}
+
+export declare interface WorkflowTrigger {
+    type?: string;
+}
+
+export declare interface WorkflowVariable {
+    name?: string;
+    description?: string;
+    type?: VariableType;
+    direction?: VariableDirection;
+    defaultValue?: unknown;
+}
+
+export { }