@cubos/agent-sdk 0.0.1136563

package/dist/admin/conversations.d.ts

@@ -0,0 +1,434 @@
+import type { Transport } from "../http.js";
+import type { Schemas } from "../schemas.js";
+/**
+ * The operator's view of conversations: the raw event log, sub-agent trees,
+ * workspace files and cost — everything an admin console renders.
+ *
+ * This is deliberately *not* the curated `Conversation`/`Message` surface an
+ * end-user app will get from the browser-safe client. These shapes come
+ * straight from the generated schema and move with the server.
+ */
+export declare function conversationsAdminApi(t: Transport, tenantSlug: string): {
+    list: (query?: {
+        before?: string;
+        limit?: number;
+        origin?: string;
+        user_id?: string;
+    }, signal?: AbortSignal) => Promise<{
+        agent: null | import("../generated/schema.js").components["schemas"]["AgentRef"];
+        archived_at: string | null;
+        channel: null | import("../generated/schema.js").components["schemas"]["ChannelRef"];
+        created_at: string;
+        generated_title: string | null;
+        has_pending_turn: boolean;
+        id: string;
+        is_processing: boolean;
+        last_activity_at: string;
+        last_error_at: string | null;
+        last_error_message: string | null;
+        metadata: Record<string, unknown>;
+        next_retry_at: string | null;
+        origin: string;
+        parent_conversation: null | import("../generated/schema.js").components["schemas"]["ConversationRef"];
+        retry_count: number;
+        title: string | null;
+        total_cost_usd: number;
+        updated_at: string;
+        user: null | import("../generated/schema.js").components["schemas"]["UserRef"];
+        user_identifier: string | null;
+        user_identifier_label: string | null;
+    }[]>;
+    get: (id: string, signal?: AbortSignal) => Promise<{
+        agent: null | import("../generated/schema.js").components["schemas"]["AgentRef"];
+        archived_at: string | null;
+        channel: null | import("../generated/schema.js").components["schemas"]["ChannelRef"];
+        created_at: string;
+        generated_title: string | null;
+        has_pending_turn: boolean;
+        id: string;
+        is_processing: boolean;
+        last_activity_at: string;
+        last_error_at: string | null;
+        last_error_message: string | null;
+        metadata: Record<string, unknown>;
+        next_retry_at: string | null;
+        origin: string;
+        parent_conversation: null | import("../generated/schema.js").components["schemas"]["ConversationRef"];
+        retry_count: number;
+        title: string | null;
+        total_cost_usd: number;
+        updated_at: string;
+        user: null | import("../generated/schema.js").components["schemas"]["UserRef"];
+        user_identifier: string | null;
+        user_identifier_label: string | null;
+    }>;
+    create: (input: Schemas["CreateConversationInput"]) => Promise<{
+        agent: null | import("../generated/schema.js").components["schemas"]["AgentRef"];
+        archived_at: string | null;
+        channel: null | import("../generated/schema.js").components["schemas"]["ChannelRef"];
+        created_at: string;
+        generated_title: string | null;
+        has_pending_turn: boolean;
+        id: string;
+        is_processing: boolean;
+        last_activity_at: string;
+        last_error_at: string | null;
+        last_error_message: string | null;
+        metadata: Record<string, unknown>;
+        next_retry_at: string | null;
+        origin: string;
+        parent_conversation: null | import("../generated/schema.js").components["schemas"]["ConversationRef"];
+        retry_count: number;
+        title: string | null;
+        total_cost_usd: number;
+        updated_at: string;
+        user: null | import("../generated/schema.js").components["schemas"]["UserRef"];
+        user_identifier: string | null;
+        user_identifier_label: string | null;
+    }>;
+    update: (id: string, input: Schemas["UpdateConversationInput"]) => Promise<{
+        agent: null | import("../generated/schema.js").components["schemas"]["AgentRef"];
+        archived_at: string | null;
+        channel: null | import("../generated/schema.js").components["schemas"]["ChannelRef"];
+        created_at: string;
+        generated_title: string | null;
+        has_pending_turn: boolean;
+        id: string;
+        is_processing: boolean;
+        last_activity_at: string;
+        last_error_at: string | null;
+        last_error_message: string | null;
+        metadata: Record<string, unknown>;
+        next_retry_at: string | null;
+        origin: string;
+        parent_conversation: null | import("../generated/schema.js").components["schemas"]["ConversationRef"];
+        retry_count: number;
+        title: string | null;
+        total_cost_usd: number;
+        updated_at: string;
+        user: null | import("../generated/schema.js").components["schemas"]["UserRef"];
+        user_identifier: string | null;
+        user_identifier_label: string | null;
+    }>;
+    archive: (id: string) => Promise<{
+        agent: null | import("../generated/schema.js").components["schemas"]["AgentRef"];
+        archived_at: string | null;
+        channel: null | import("../generated/schema.js").components["schemas"]["ChannelRef"];
+        created_at: string;
+        generated_title: string | null;
+        has_pending_turn: boolean;
+        id: string;
+        is_processing: boolean;
+        last_activity_at: string;
+        last_error_at: string | null;
+        last_error_message: string | null;
+        metadata: Record<string, unknown>;
+        next_retry_at: string | null;
+        origin: string;
+        parent_conversation: null | import("../generated/schema.js").components["schemas"]["ConversationRef"];
+        retry_count: number;
+        title: string | null;
+        total_cost_usd: number;
+        updated_at: string;
+        user: null | import("../generated/schema.js").components["schemas"]["UserRef"];
+        user_identifier: string | null;
+        user_identifier_label: string | null;
+    }>;
+    /** Clears the backoff and re-dispatches a conversation stuck after failures. */
+    retryNow: (id: string) => Promise<{
+        agent: null | import("../generated/schema.js").components["schemas"]["AgentRef"];
+        archived_at: string | null;
+        channel: null | import("../generated/schema.js").components["schemas"]["ChannelRef"];
+        created_at: string;
+        generated_title: string | null;
+        has_pending_turn: boolean;
+        id: string;
+        is_processing: boolean;
+        last_activity_at: string;
+        last_error_at: string | null;
+        last_error_message: string | null;
+        metadata: Record<string, unknown>;
+        next_retry_at: string | null;
+        origin: string;
+        parent_conversation: null | import("../generated/schema.js").components["schemas"]["ConversationRef"];
+        retry_count: number;
+        title: string | null;
+        total_cost_usd: number;
+        updated_at: string;
+        user: null | import("../generated/schema.js").components["schemas"]["UserRef"];
+        user_identifier: string | null;
+        user_identifier_label: string | null;
+    }>;
+    listEvents: (id: string, query?: {
+        before?: number;
+        limit?: number;
+    }, signal?: AbortSignal) => Promise<{
+        attachments: import("../generated/schema.js").components["schemas"]["ConversationEventAttachment"][];
+        blocks: import("../generated/schema.js").components["schemas"]["Block"][] | null;
+        change_seq: number;
+        compaction_summary_id: string | null;
+        content: string | null;
+        conversation_id: string;
+        cost_usd: number;
+        created_at: string;
+        delivered_at: string | null;
+        discarded_at: string | null;
+        duration_ms: number | null;
+        error: string | null;
+        id: string;
+        injected_by_conversation_id: string | null;
+        llm_call_data: null | import("../generated/schema.js").components["schemas"]["LlmCallData"];
+        model: string | null;
+        parent_tool_call_id: string | null;
+        provider: null | import("../generated/schema.js").components["schemas"]["ProviderRef"];
+        read_at: string | null;
+        result?: unknown;
+        seq: number;
+        sub_conversation_id: string | null;
+        tentative: boolean;
+        tool_call_id: string | null;
+        tool_name: string | null;
+        type: import("../generated/schema.js").components["schemas"]["EventType"];
+    }[]>;
+    /** Only for channel-less conversations: a channel-backed one receives the
+     * user's words through the channel, so injecting here would forge a message
+     * they never sent (409). */
+    sendUserMessage: (id: string, content: string) => Promise<{
+        attachments: import("../generated/schema.js").components["schemas"]["ConversationEventAttachment"][];
+        blocks: import("../generated/schema.js").components["schemas"]["Block"][] | null;
+        change_seq: number;
+        compaction_summary_id: string | null;
+        content: string | null;
+        conversation_id: string;
+        cost_usd: number;
+        created_at: string;
+        delivered_at: string | null;
+        discarded_at: string | null;
+        duration_ms: number | null;
+        error: string | null;
+        id: string;
+        injected_by_conversation_id: string | null;
+        llm_call_data: null | import("../generated/schema.js").components["schemas"]["LlmCallData"];
+        model: string | null;
+        parent_tool_call_id: string | null;
+        provider: null | import("../generated/schema.js").components["schemas"]["ProviderRef"];
+        read_at: string | null;
+        result?: unknown;
+        seq: number;
+        sub_conversation_id: string | null;
+        tentative: boolean;
+        tool_call_id: string | null;
+        tool_name: string | null;
+        type: import("../generated/schema.js").components["schemas"]["EventType"];
+    }>;
+    /** Voice message. Stored content-addressed and transcribed by the agent's
+     * STT model before the turn runs; the event itself carries empty content. */
+    sendUserAudio: (id: string, audio: Blob, filename?: string) => Promise<{
+        attachments: import("../generated/schema.js").components["schemas"]["ConversationEventAttachment"][];
+        blocks: import("../generated/schema.js").components["schemas"]["Block"][] | null;
+        change_seq: number;
+        compaction_summary_id: string | null;
+        content: string | null;
+        conversation_id: string;
+        cost_usd: number;
+        created_at: string;
+        delivered_at: string | null;
+        discarded_at: string | null;
+        duration_ms: number | null;
+        error: string | null;
+        id: string;
+        injected_by_conversation_id: string | null;
+        llm_call_data: null | import("../generated/schema.js").components["schemas"]["LlmCallData"];
+        model: string | null;
+        parent_tool_call_id: string | null;
+        provider: null | import("../generated/schema.js").components["schemas"]["ProviderRef"];
+        read_at: string | null;
+        result?: unknown;
+        seq: number;
+        sub_conversation_id: string | null;
+        tentative: boolean;
+        tool_call_id: string | null;
+        tool_name: string | null;
+        type: import("../generated/schema.js").components["schemas"]["EventType"];
+    }>;
+    /** Image message (png/jpeg/webp/gif). Shown to the model natively when the
+     * agent's chat model has vision, otherwise described by the agent's
+     * fallback vision model. The optional caption becomes the event content. */
+    sendUserImage: (id: string, image: Blob, opts?: {
+        filename?: string;
+        caption?: string;
+        label?: string;
+    }) => Promise<{
+        attachments: import("../generated/schema.js").components["schemas"]["ConversationEventAttachment"][];
+        blocks: import("../generated/schema.js").components["schemas"]["Block"][] | null;
+        change_seq: number;
+        compaction_summary_id: string | null;
+        content: string | null;
+        conversation_id: string;
+        cost_usd: number;
+        created_at: string;
+        delivered_at: string | null;
+        discarded_at: string | null;
+        duration_ms: number | null;
+        error: string | null;
+        id: string;
+        injected_by_conversation_id: string | null;
+        llm_call_data: null | import("../generated/schema.js").components["schemas"]["LlmCallData"];
+        model: string | null;
+        parent_tool_call_id: string | null;
+        provider: null | import("../generated/schema.js").components["schemas"]["ProviderRef"];
+        read_at: string | null;
+        result?: unknown;
+        seq: number;
+        sub_conversation_id: string | null;
+        tentative: boolean;
+        tool_call_id: string | null;
+        tool_name: string | null;
+        type: import("../generated/schema.js").components["schemas"]["EventType"];
+    }>;
+    /** Up to 10 images in ONE `user_message`, each with an optional label the
+     * model sees next to it (so it can refer to them by name), plus one
+     * caption shared by the whole set. */
+    sendUserImages: (id: string, images: Array<{
+        image: Blob;
+        filename?: string;
+        label?: string;
+    }>, opts?: {
+        caption?: string;
+    }) => Promise<{
+        attachments: import("../generated/schema.js").components["schemas"]["ConversationEventAttachment"][];
+        blocks: import("../generated/schema.js").components["schemas"]["Block"][] | null;
+        change_seq: number;
+        compaction_summary_id: string | null;
+        content: string | null;
+        conversation_id: string;
+        cost_usd: number;
+        created_at: string;
+        delivered_at: string | null;
+        discarded_at: string | null;
+        duration_ms: number | null;
+        error: string | null;
+        id: string;
+        injected_by_conversation_id: string | null;
+        llm_call_data: null | import("../generated/schema.js").components["schemas"]["LlmCallData"];
+        model: string | null;
+        parent_tool_call_id: string | null;
+        provider: null | import("../generated/schema.js").components["schemas"]["ProviderRef"];
+        read_at: string | null;
+        result?: unknown;
+        seq: number;
+        sub_conversation_id: string | null;
+        tentative: boolean;
+        tool_call_id: string | null;
+        tool_name: string | null;
+        type: import("../generated/schema.js").components["schemas"]["EventType"];
+    }>;
+    /** Works on any conversation, channel-backed included. */
+    steer: (id: string, content: string) => Promise<{
+        attachments: import("../generated/schema.js").components["schemas"]["ConversationEventAttachment"][];
+        blocks: import("../generated/schema.js").components["schemas"]["Block"][] | null;
+        change_seq: number;
+        compaction_summary_id: string | null;
+        content: string | null;
+        conversation_id: string;
+        cost_usd: number;
+        created_at: string;
+        delivered_at: string | null;
+        discarded_at: string | null;
+        duration_ms: number | null;
+        error: string | null;
+        id: string;
+        injected_by_conversation_id: string | null;
+        llm_call_data: null | import("../generated/schema.js").components["schemas"]["LlmCallData"];
+        model: string | null;
+        parent_tool_call_id: string | null;
+        provider: null | import("../generated/schema.js").components["schemas"]["ProviderRef"];
+        read_at: string | null;
+        result?: unknown;
+        seq: number;
+        sub_conversation_id: string | null;
+        tentative: boolean;
+        tool_call_id: string | null;
+        tool_name: string | null;
+        type: import("../generated/schema.js").components["schemas"]["EventType"];
+    }>;
+    listSubConversations: (id: string, signal?: AbortSignal) => Promise<{
+        agent_display_name: string | null;
+        agent_slug: string | null;
+        archived_at: string | null;
+        created_at: string;
+        id: string;
+        last_activity_at: string;
+    }[]>;
+    getSummary: (id: string, summaryId: string, signal?: AbortSignal) => Promise<{
+        anchor_event_seq: number;
+        conversation_id: string;
+        created_at: string;
+        id: string;
+        input_tokens: number | null;
+        output_tokens: number | null;
+        summary_text: string;
+    }>;
+    listKnowledgeBases: (id: string, signal?: AbortSignal) => Promise<{
+        created_at: string;
+        display_name: string;
+        id: string;
+        pending_count: number;
+        slug: string;
+        updated_at: string;
+    }[]>;
+    attachKnowledgeBase: (id: string, kbSlug: string) => Promise<void>;
+    detachKnowledgeBase: (id: string, kbSlug: string) => Promise<void>;
+    listSkills: (id: string, signal?: AbortSignal) => Promise<{
+        enabled: boolean;
+        skill: import("../generated/schema.js").components["schemas"]["SkillRef"];
+    }[]>;
+    addSkill: (id: string, skillSlug: string) => Promise<void>;
+    removeSkill: (id: string, skillSlug: string) => Promise<void>;
+    /** One directory, never recursive. `atSeq` browses the workspace as it
+     * stood at a given event, reaching history the agent no longer sees;
+     * without it you get the live tree, which is what the agent would be shown
+     * next turn — empty once the workspace has expired. */
+    workspaceDir: (id: string, atSeq?: number, path?: string, signal?: AbortSignal) => Promise<{
+        entries: import("../generated/schema.js").components["schemas"]["WorkspaceEntryDto"][];
+        path: string;
+        root_event_id: string | null;
+        root_seq: number | null;
+    }>;
+    /** Raw `Response`: the file's bytes, with the server's own filename in
+     * `Content-Disposition`. */
+    workspaceFile: (id: string, query: {
+        path: string;
+        at_seq?: number;
+    }) => Promise<Response>;
+    /** Create or replace one file. Starts no turn — the agent is told about it
+     * as part of its next request, so send a message if you want an answer. */
+    workspaceWrite: (id: string, path: string, file: Blob, filename?: string) => Promise<{
+        paths: string[];
+        root_event_id: string | null;
+    }>;
+    /** Write several files as **one** snapshot: the agent sees the upload as a
+     * single change rather than as N, and no reader ever observes half of it.
+     * Positional `path` parts pair with the files by index. */
+    workspaceWriteMany: (id: string, files: Array<{
+        path: string;
+        file: Blob;
+        filename?: string;
+    }>) => Promise<{
+        paths: string[];
+        root_event_id: string | null;
+    }>;
+    /** Remove a file, or a directory with everything under it. History keeps
+     * resolving through `atSeq`. */
+    workspaceDelete: (id: string, path: string) => Promise<{
+        paths: string[];
+        root_event_id: string | null;
+    }>;
+    workspaceMove: (id: string, from: string, to: string) => Promise<{
+        paths: string[];
+        root_event_id: string | null;
+    }>;
+    /** Raw `Response`: the bytes of an event's media attachment (voice note or
+     * image), `Content-Type` from the stored mime. */
+    eventAttachment: (id: string, eventId: string, attachmentId?: string) => Promise<Response>;
+};

package/dist/admin/global.d.ts

@@ -0,0 +1,137 @@
+import type { Transport } from "../http.js";
+import type { Schemas } from "../schemas.js";
+export declare function tenantsApi(t: Transport): {
+    list: (signal?: AbortSignal) => Promise<{
+        created_at: string;
+        display_name: string;
+        id: string;
+        slug: string;
+    }[]>;
+    create: (input: Schemas["CreateTenantInput"]) => Promise<{
+        created_at: string;
+        display_name: string;
+        id: string;
+        slug: string;
+    }>;
+    update: (currentSlug: string, input: Schemas["UpdateTenantInput"]) => Promise<{
+        created_at: string;
+        display_name: string;
+        id: string;
+        slug: string;
+    }>;
+    delete: (slug: string) => Promise<void>;
+};
+export declare function apiKeysApi(t: Transport): {
+    list: (signal?: AbortSignal) => Promise<({
+        created_at: string;
+        display_name: string;
+        id: string;
+        key_prefix: string;
+    } & {
+        visible_grant_count: number;
+    })[]>;
+    get: (id: string, signal?: AbortSignal) => Promise<{
+        created_at: string;
+        display_name: string;
+        id: string;
+        key_prefix: string;
+    } & {
+        grants: import("../generated/schema.js").components["schemas"]["GrantOut"][];
+    }>;
+    create: (input: Schemas["CreateApiKeyInput"]) => Promise<{
+        created_at: string;
+        display_name: string;
+        id: string;
+        key_prefix: string;
+    } & {
+        plaintext: string;
+    }>;
+    update: (id: string, input: Schemas["UpdateApiKeyInput"]) => Promise<{
+        created_at: string;
+        display_name: string;
+        id: string;
+        key_prefix: string;
+    }>;
+    delete: (id: string) => Promise<void>;
+    /** Returns a new plaintext secret; the previous one stops working at once. */
+    rotate: (id: string) => Promise<{
+        created_at: string;
+        display_name: string;
+        id: string;
+        key_prefix: string;
+    } & {
+        plaintext: string;
+    }>;
+    addGrant: (id: string, input: Schemas["AddGrantInput"]) => Promise<{
+        id: string;
+        permission: string;
+        tenant_slug: string;
+    }>;
+    removeGrant: (id: string, grantId: string) => Promise<void>;
+};
+/**
+ * Providers owned by the reserved `_root` system tenant and shared with every
+ * tenant's listing. Root-only, and a separate route family from a tenant's own
+ * providers — never reachable through a real tenant's URL.
+ */
+export declare function sharedProvidersApi(t: Transport): {
+    create: (input: Schemas["CreateAiProviderInput"]) => Promise<{
+        account_id: string | null;
+        base_url: string | null;
+        created_at: string;
+        has_api_key: boolean;
+        id: string;
+        last_reconcile_error: string | null;
+        last_reconciled_at: string | null;
+        model_count: number;
+        shared: boolean;
+        slug: string;
+        token_sku_directions: {
+            [key: string]: import("../generated/schema.js").components["schemas"]["SkuDirection"];
+        };
+        type: import("../generated/schema.js").components["schemas"]["ProviderType"];
+    }>;
+    update: (currentSlug: string, input: Schemas["UpdateAiProviderInput"]) => Promise<{
+        account_id: string | null;
+        base_url: string | null;
+        created_at: string;
+        has_api_key: boolean;
+        id: string;
+        last_reconcile_error: string | null;
+        last_reconciled_at: string | null;
+        model_count: number;
+        shared: boolean;
+        slug: string;
+        token_sku_directions: {
+            [key: string]: import("../generated/schema.js").components["schemas"]["SkuDirection"];
+        };
+        type: import("../generated/schema.js").components["schemas"]["ProviderType"];
+    }>;
+    delete: (slug: string) => Promise<void>;
+    refreshModels: (slug: string) => Promise<{
+        capabilities: import("../generated/schema.js").components["schemas"]["ModelCapabilities"];
+        context_window_tokens: number | null;
+        context_window_tokens_override: number | null;
+        disappeared_at: string | null;
+        display_name: string | null;
+        embedding_native_dimensions: number | null;
+        id: string;
+        last_reconciled_at: string;
+        max_input_tokens: number | null;
+        max_output_tokens: number | null;
+        model_id: string;
+        model_version: string | null;
+        pricing: {
+            [key: string]: number;
+        };
+        pricing_effective: {
+            [key: string]: number;
+        };
+        pricing_override: {
+            [key: string]: number;
+        };
+        pricing_skus: import("../generated/schema.js").components["schemas"]["SkuDisplayDto"][];
+        reasoning_options: null | import("../generated/schema.js").components["schemas"]["ReasoningOptions"];
+    }[]>;
+    updateModel: (slug: string, modelId: string, input: Schemas["UpdateProviderModelInput"]) => Promise<void>;
+};

package/dist/admin/index.d.ts

@@ -0,0 +1,67 @@
+import { type Transport } from "../http.js";
+import type { Schemas } from "../schemas.js";
+import type { FetchLike } from "../sse.js";
+import { agentsApi } from "./agents.js";
+import { aiProvidersApi } from "./ai-providers.js";
+import { channelsApi } from "./channels.js";
+import { clientToolsApi } from "./client-tools.js";
+import { componentLibrariesApi } from "./component-libraries.js";
+import { conversationsAdminApi } from "./conversations.js";
+import { apiKeysApi, sharedProvidersApi, tenantsApi } from "./global.js";
+import { knowledgeBasesApi } from "./knowledge-bases.js";
+import { mcpsApi } from "./mcps.js";
+import { skillsApi } from "./skills.js";
+import { backgroundTasksApi, scheduledRunsApi, taskTemplatesApi } from "./task-templates.js";
+import { userRolesApi, usersApi, userTokensApi } from "./users.js";
+export interface AdminClientOptions {
+    /** Where the Cubos Agent core is reachable, e.g. `https://agent.acme.com`. */
+    baseUrl: string;
+    /** A tenant-wide api_key, or the root key. Pass a function when the key lives
+     * somewhere mutable and is read per request. Never ship one to a browser. */
+    apiKey: string | (() => string | Promise<string>);
+    fetch?: FetchLike;
+    /** Per-request ceiling in ms; `0` disables it. Defaults to 30s. */
+    timeoutMs?: number;
+    /** How many times a 429 is retried, honouring the server's `Retry-After`.
+     * Defaults to 2. */
+    maxRetries?: number;
+}
+/** Everything scoped to one tenant. Held rather than passed per call, so the
+ * slug appears once instead of in all ~120 signatures. */
+export interface TenantScope {
+    readonly slug: string;
+    agents: ReturnType<typeof agentsApi>;
+    aiProviders: ReturnType<typeof aiProvidersApi>;
+    mcps: ReturnType<typeof mcpsApi>;
+    skills: ReturnType<typeof skillsApi>;
+    componentLibraries: ReturnType<typeof componentLibrariesApi>;
+    channels: ReturnType<typeof channelsApi>;
+    users: ReturnType<typeof usersApi>;
+    userRoles: ReturnType<typeof userRolesApi>;
+    userTokens: ReturnType<typeof userTokensApi>;
+    knowledgeBases: ReturnType<typeof knowledgeBasesApi>;
+    taskTemplates: ReturnType<typeof taskTemplatesApi>;
+    scheduledRuns: ReturnType<typeof scheduledRunsApi>;
+    backgroundTasks: ReturnType<typeof backgroundTasksApi>;
+    conversations: ReturnType<typeof conversationsAdminApi>;
+    clientTools: ReturnType<typeof clientToolsApi>;
+}
+export interface AdminClient {
+    health(signal?: AbortSignal): Promise<Schemas["Health"]>;
+    me(signal?: AbortSignal): Promise<Schemas["WhoAmI"]>;
+    tenants: ReturnType<typeof tenantsApi>;
+    apiKeys: ReturnType<typeof apiKeysApi>;
+    sharedProviders: ReturnType<typeof sharedProvidersApi>;
+    tenant(slug: string): TenantScope;
+    /** Escape hatch for a route the SDK hasn't wrapped yet. Paths are absolute
+     * (`/api/v1/…`) and auth is applied for you. */
+    raw: Transport;
+}
+/**
+ * Full-surface client authenticated with an api_key: every route the key's
+ * grants allow, across every tenant it can reach.
+ *
+ * Server-side only: an api_key is tenant-wide, so it must never reach a
+ * browser.
+ */
+export declare function createAdminClient(options: AdminClientOptions): AdminClient;