@beeos-ai/bma-sdk 1.0.1 → 2.1.0

package/dist/errors.js

@@ -1,109 +1,15 @@
-/** Base class of every error thrown by the SDK. */
-export class BmaError extends Error {
-    constructor(message, options) {
-        super(message, options);
-        this.name = new.target.name;
-    }
-}
-/** An error response from the API, or a request that never got one. */
-export class BmaApiError extends BmaError {
-    /** HTTP status; undefined for connection errors and stream error frames. */
-    status;
-    headers;
-    /** Stable error code from the response body. */
-    code;
-    /** Parsed response body, if any. */
-    error;
-    /** Field-level problems for agent config validation errors. */
-    issues;
-    /** Current file digest for file_content_conflict / expected_digest_required. */
-    currentDigest;
-    /** Facade extensions only: the Anthropic-style `error.type`. */
-    type;
-    constructor(status, body, message, headers, options) {
-        const wire = (typeof body === "object" && body !== null ? body : {});
-        // Native API: {error: string, code}. Facade: {type: "error", error: {type, message, code}}.
-        const nested = typeof wire.error === "object" && wire.error !== null ? wire.error : undefined;
-        const code = str(nested ? nested.code : wire.code);
-        const type = nested ? str(nested.type) : undefined;
-        const detail = str(nested ? nested.message : wire.error) ?? message;
-        super(status === undefined
-            ? (message ?? detail ?? "bma: request failed")
-            : `bma: ${status} ${code ?? type ?? "unknown"}: ${detail ?? `HTTP ${status}`}`, options);
-        this.status = status;
-        this.headers = headers;
-        this.code = code;
-        this.type = type;
-        this.error = body;
-        this.issues = Array.isArray(wire.issues) ? wire.issues : undefined;
-        this.currentDigest = str(wire.current_digest);
-    }
-    /** @internal */
-    static generate(status, body, headers) {
-        const cls = STATUS_CLASSES.get(status) ?? (status >= 500 ? InternalServerError : BmaApiError);
-        return new cls(status, body, undefined, headers);
-    }
-}
-function str(value) {
-    return typeof value === "string" && value !== "" ? value : undefined;
-}
-export class APIConnectionError extends BmaApiError {
-    constructor({ message, cause } = {}) {
-        super(undefined, undefined, message ?? "bma: connection error", undefined, { cause });
-    }
-}
-export class APIConnectionTimeoutError extends APIConnectionError {
-    constructor({ message } = {}) {
-        super({ message: message ?? "bma: request timed out" });
-    }
-}
-export class APIUserAbortError extends BmaApiError {
-    constructor({ message } = {}) {
-        super(undefined, undefined, message ?? "bma: request was aborted", undefined);
-    }
-}
+import { APIError } from '@anthropic-ai/sdk';
 /**
- * An `error` frame on an event stream. The stream ends after it; frames with
- * code `service_unavailable` are retried by the SDK before this is thrown.
+ * BMA's reason for an API error (`error.code` of the Anthropic error envelope,
+ * e.g. "idempotency_key_reused"), or undefined when `error` is not an API
+ * error or has no code. Branch on it rather than on the message. (The
+ * official `errorCode` property is `error.details.error_code`, which BMA does
+ * not set.)
  */
-export class EventStreamError extends BmaApiError {
-    constructor(body) {
-        const wire = (body ?? {});
-        super(undefined, body, `bma: event stream error ${String(wire.code ?? "unknown")}: ${String(wire.error ?? "")}`, undefined);
-    }
-}
-export class BadRequestError extends BmaApiError {
-}
-export class AuthenticationError extends BmaApiError {
-}
-export class PermissionDeniedError extends BmaApiError {
-}
-export class NotFoundError extends BmaApiError {
-}
-export class RequestTimeoutError extends BmaApiError {
-}
-export class ConflictError extends BmaApiError {
-}
-export class ContentTooLargeError extends BmaApiError {
-}
-export class UnprocessableEntityError extends BmaApiError {
-}
-export class RateLimitError extends BmaApiError {
-}
-export class InternalServerError extends BmaApiError {
-}
-export class ServiceUnavailableError extends InternalServerError {
+export function errorCode(error) {
+    if (!(error instanceof APIError))
+        return undefined;
+    const code = error.error?.error?.code;
+    return typeof code === 'string' ? code : undefined;
 }
-const STATUS_CLASSES = new Map([
-    [400, BadRequestError],
-    [401, AuthenticationError],
-    [403, PermissionDeniedError],
-    [404, NotFoundError],
-    [408, RequestTimeoutError],
-    [409, ConflictError],
-    [413, ContentTooLargeError],
-    [422, UnprocessableEntityError],
-    [429, RateLimitError],
-    [503, ServiceUnavailableError],
-]);
 //# sourceMappingURL=errors.js.map

package/dist/errors.js.map

@@ -1 +1 @@
-{"version":3,"file":"errors.js","sourceRoot":"","sources":["../src/errors.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"errors.js","sourceRoot":"","sources":["../src/errors.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,mBAAmB,CAAC;AAE7C;;;;;;GAMG;AACH,MAAM,UAAU,SAAS,CAAC,KAAc;IACtC,IAAI,CAAC,CAAC,KAAK,YAAY,QAAQ,CAAC;QAAE,OAAO,SAAS,CAAC;IACnD,MAAM,IAAI,GAAI,KAAK,CAAC,KAAoD,EAAE,KAAK,EAAE,IAAI,CAAC;IACtF,OAAO,OAAO,IAAI,KAAK,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,SAAS,CAAC;AACrD,CAAC"}

package/dist/extensions.d.ts

@@ -0,0 +1,80 @@
+import type { components } from './generated/extensions.js';
+type Schemas = components['schemas'];
+export type AgentModelOverride = Schemas['AgentModelOverride'];
+export type AgentModelOverrideInput = Schemas['AgentModelOverrideInput'];
+export type AgentModelOverridePatch = Schemas['AgentModelOverridePatch'];
+/** bma_harness: a non-default brain for an agent or a session. */
+export interface Harness {
+    kind: string;
+    agent?: string;
+    /** Where the environment runs the brain (sessions only). */
+    placement?: string;
+}
+/** bma_desktop of an environment: the default wallpaper is a file of the Files API. */
+export interface EnvironmentDesktop {
+    wallpaper: {
+        file_id: string;
+    } | null;
+}
+/** bma_machine: present on the environment BMA projects from a machine. */
+export interface EnvironmentMachine {
+    machine_id: string;
+    source_kind: string;
+    /** Who runs on a persistent machine: sessions borrowing it run their turns one at a time. */
+    lease: {
+        session_id: string | null;
+        queued_sessions: number;
+    };
+}
+/** The BMA fields of a session. */
+export interface SessionExt {
+    /** The active model override (no key) or null. */
+    modelOverride: AgentModelOverride | null;
+    harness: Harness | null;
+}
+/** The BMA fields of an agent. */
+export interface AgentExt {
+    harness: Harness | null;
+}
+/** The BMA fields of an environment. */
+export interface EnvironmentExt {
+    desktop: EnvironmentDesktop | null;
+    machine: EnvironmentMachine | null;
+}
+/** The BMA fields of a session event, from a list or a stream. */
+export interface EventExt {
+    /** Orders the events of a session; Last-Event-ID and the history cursor use it (the SSE id stays the opaque event id). */
+    sequence: number | null;
+    /** The BMA input of a user.message. */
+    inputID: string | null;
+    /** BMA's reason on a session.error. */
+    errorCode: string | null;
+}
+/** The BMA fields of a session returned by client.beta.sessions. */
+export declare function sessionExtensions(session: object): SessionExt;
+/** The BMA fields of an agent returned by client.beta.agents. */
+export declare function agentExtensions(agent: object): AgentExt;
+/** The BMA fields of an environment returned by client.beta.environments. */
+export declare function environmentExtensions(environment: object): EnvironmentExt;
+/** The BMA fields of a session event: an item of client.beta.sessions.events.list or a frame of stream. */
+export declare function eventExtensions(event: object): EventExt;
+/** Request fields BMA adds to sessions.create. */
+export interface SessionCreateExt {
+    /** The override lasts for the session. `apiKey` is write-only. */
+    bma_model_override?: AgentModelOverrideInput;
+    bma_harness?: Harness;
+}
+/** Request fields BMA adds to sessions.update. */
+export interface SessionUpdateExt {
+    /** An input replaces the active override, a patch changes fields of it, null revokes it. */
+    bma_model_override?: AgentModelOverrideInput | AgentModelOverridePatch | null;
+}
+/** Request fields BMA adds to agents.create and agents.update. */
+export interface AgentExtParams {
+    bma_harness?: Harness;
+}
+/** Request fields BMA adds to environments.create and environments.update. */
+export interface EnvironmentExtParams {
+    bma_desktop?: EnvironmentDesktop;
+}
+export {};

package/dist/extensions.js

@@ -0,0 +1,24 @@
+function field(object, name) {
+    return object[name] ?? null;
+}
+/** The BMA fields of a session returned by client.beta.sessions. */
+export function sessionExtensions(session) {
+    return { modelOverride: field(session, 'bma_model_override'), harness: field(session, 'bma_harness') };
+}
+/** The BMA fields of an agent returned by client.beta.agents. */
+export function agentExtensions(agent) {
+    return { harness: field(agent, 'bma_harness') };
+}
+/** The BMA fields of an environment returned by client.beta.environments. */
+export function environmentExtensions(environment) {
+    return { desktop: field(environment, 'bma_desktop'), machine: field(environment, 'bma_machine') };
+}
+/** The BMA fields of a session event: an item of client.beta.sessions.events.list or a frame of stream. */
+export function eventExtensions(event) {
+    return {
+        sequence: field(event, 'bma_sequence'),
+        inputID: field(event, 'bma_input_id'),
+        errorCode: field(event, 'bma_error_code'),
+    };
+}
+//# sourceMappingURL=extensions.js.map

package/dist/extensions.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"extensions.js","sourceRoot":"","sources":["../src/extensions.ts"],"names":[],"mappings":"AAkEA,SAAS,KAAK,CAAI,MAAc,EAAE,IAAY;IAC5C,OAAS,MAAkC,CAAC,IAAI,CAA0B,IAAI,IAAI,CAAC;AACrF,CAAC;AAED,oEAAoE;AACpE,MAAM,UAAU,iBAAiB,CAAC,OAAe;IAC/C,OAAO,EAAE,aAAa,EAAE,KAAK,CAAC,OAAO,EAAE,oBAAoB,CAAC,EAAE,OAAO,EAAE,KAAK,CAAC,OAAO,EAAE,aAAa,CAAC,EAAE,CAAC;AACzG,CAAC;AAED,iEAAiE;AACjE,MAAM,UAAU,eAAe,CAAC,KAAa;IAC3C,OAAO,EAAE,OAAO,EAAE,KAAK,CAAC,KAAK,EAAE,aAAa,CAAC,EAAE,CAAC;AAClD,CAAC;AAED,6EAA6E;AAC7E,MAAM,UAAU,qBAAqB,CAAC,WAAmB;IACvD,OAAO,EAAE,OAAO,EAAE,KAAK,CAAC,WAAW,EAAE,aAAa,CAAC,EAAE,OAAO,EAAE,KAAK,CAAC,WAAW,EAAE,aAAa,CAAC,EAAE,CAAC;AACpG,CAAC;AAED,2GAA2G;AAC3G,MAAM,UAAU,eAAe,CAAC,KAAa;IAC3C,OAAO;QACL,QAAQ,EAAE,KAAK,CAAC,KAAK,EAAE,cAAc,CAAC;QACtC,OAAO,EAAE,KAAK,CAAC,KAAK,EAAE,cAAc,CAAC;QACrC,SAAS,EAAE,KAAK,CAAC,KAAK,EAAE,gBAAgB,CAAC;KAC1C,CAAC;AACJ,CAAC"}

package/dist/generated/extensions-resources.d.ts

@@ -0,0 +1,271 @@
+import { APIPromise } from '@anthropic-ai/sdk/core/api-promise';
+import { PageCursor, PagePromise } from '@anthropic-ai/sdk/core/pagination';
+import type { BaseAnthropic } from '@anthropic-ai/sdk/client';
+import { APIResource } from '@anthropic-ai/sdk/core/resource';
+import { type RequestOptions } from '../internal.js';
+import type { components } from './extensions.js';
+type S = components['schemas'];
+export type CheckMachinePoolConnectionRequest = S['CheckMachinePoolConnectionRequest'];
+export type CreateDesktopSessionExtensionRequest = S['CreateDesktopSessionExtensionRequest'];
+export type CreateDesktopTicketRequest = S['CreateDesktopTicketRequest'];
+export type CreateMachineExtensionRequest = S['CreateMachineExtensionRequest'];
+export type CreateMachinePoolGrantExtensionRequest = S['CreateMachinePoolGrantExtensionRequest'];
+export type CreateMachinePoolRequest = S['CreateMachinePoolRequest'];
+export type CreateProjectRequest = S['CreateProjectRequest'];
+export type CreateTerminalSessionExtensionRequest = S['CreateTerminalSessionExtensionRequest'];
+export type CreateTicketRequest = S['CreateTicketRequest'];
+export type DesktopActionRequest = S['DesktopActionRequest'];
+export type DesktopActionResult = S['DesktopActionResult'];
+export type DesktopControlLeaseRequest = S['DesktopControlLeaseRequest'];
+export type DesktopControlStatus = S['DesktopControlStatus'];
+export type DesktopEmptyRequest = S['DesktopEmptyRequest'];
+export type DesktopGenerationRequest = S['DesktopGenerationRequest'];
+export type DesktopScreenshot = S['DesktopScreenshot'];
+export type DesktopSession = S['DesktopSession'];
+export type DesktopSessionClosed = S['DesktopSessionClosed'];
+export type Machine = S['Machine'];
+export type MachineCapabilities = S['MachineCapabilities'];
+export type MachineDeleted = S['MachineDeleted'];
+export type MachinePool = S['MachinePool'];
+export type MachinePoolConnectionCheck = S['MachinePoolConnectionCheck'];
+export type MachinePoolDeleted = S['MachinePoolDeleted'];
+export type MachinePoolGrant = S['MachinePoolGrant'];
+export type MachinePoolGrantDeleted = S['MachinePoolGrantDeleted'];
+export type MachinePoolGrantsPageCursor = PageCursor<MachinePoolGrant>;
+export type MachinePoolsPageCursor = PageCursor<MachinePool>;
+export type MachinePowerStatus = S['MachinePowerStatus'];
+export type MachinesPageCursor = PageCursor<Machine>;
+export type OrganizationProjectsPageCursor = PageCursor<Project>;
+export type Project = S['Project'];
+export type TerminalSession = S['TerminalSession'];
+export type TerminalSessionsPageCursor = PageCursor<TerminalSession>;
+export type Ticket = S['Ticket'];
+export type UpdateMachinePoolRequest = S['UpdateMachinePoolRequest'];
+export type UpdateMachineRequest = S['UpdateMachineRequest'];
+export type UpdateProjectMachinePoolGrantRequest = S['UpdateProjectMachinePoolGrantRequest'];
+export interface OrganizationProjectListParams {
+    limit?: number;
+    /** Opaque cursor from `next_page`. */
+    page?: string;
+}
+export type OrganizationProjectCreateParams = CreateProjectRequest;
+export interface MachineListParams {
+    limit?: number;
+    /** Opaque cursor from `next_page`. */
+    page?: string;
+    sort?: string;
+    machine_pool_id?: string;
+    agent_id?: string;
+}
+export type MachineCreateParams = CreateMachineExtensionRequest;
+export type MachineUpdateParams = UpdateMachineRequest;
+export interface MachineDeleteParams {
+    agent_id?: string;
+}
+export interface MachinePoolListParams {
+    limit?: number;
+    /** Opaque cursor from `next_page`. */
+    page?: string;
+    sort?: string;
+}
+export type MachinePoolCreateParams = CreateMachinePoolRequest;
+export type MachinePoolCheckConnectionParams = CheckMachinePoolConnectionRequest;
+export type MachinePoolUpdateParams = UpdateMachinePoolRequest;
+export interface MachinePoolGrantListParams {
+    limit?: number;
+    /** Opaque cursor from `next_page`. */
+    page?: string;
+    sort?: string;
+}
+export type MachinePoolGrantCreateParams = CreateMachinePoolGrantExtensionRequest;
+export type MachinePoolGrantUpdateParams = UpdateProjectMachinePoolGrantRequest;
+export type DesktopSessionCreateParams = CreateDesktopSessionExtensionRequest;
+export type DesktopSessionAcquireControlParams = DesktopControlLeaseRequest;
+export type DesktopSessionRenewControlParams = DesktopControlLeaseRequest;
+export type DesktopSessionReleaseControlParams = DesktopEmptyRequest;
+export type DesktopSessionHandbackControlParams = DesktopEmptyRequest;
+export type DesktopSessionSendActionsParams = DesktopActionRequest;
+export type DesktopSessionScreenshotParams = DesktopEmptyRequest;
+export type DesktopSessionResumeAgentParams = DesktopGenerationRequest;
+export type DesktopSessionConfirmActionParams = DesktopGenerationRequest;
+export type DesktopSessionTicketCreateParams = CreateDesktopTicketRequest;
+export interface TerminalSessionListParams {
+    machine_id?: string;
+}
+export type TerminalSessionCreateParams = CreateTerminalSessionExtensionRequest;
+export type TerminalSessionTicketCreateParams = CreateTicketRequest;
+export declare class OrganizationProjects extends APIResource {
+    /**
+     * List the projects the key can see.
+     */
+    list(organizationID: string, params?: OrganizationProjectListParams | null | undefined, options?: RequestOptions): PagePromise<OrganizationProjectsPageCursor, Project>;
+    /**
+     * Create a project.
+     */
+    create(organizationID: string, params: OrganizationProjectCreateParams, options?: RequestOptions): APIPromise<Project>;
+}
+export declare class Machines extends APIResource {
+    /**
+     * List machines. `agent_id` lists that agent's machines (project scope, native listAgentMachines).
+     */
+    list(params?: MachineListParams | null | undefined, options?: RequestOptions): PagePromise<MachinesPageCursor, Machine>;
+    /**
+     * Create a machine. `agent_id` + `persistent: true` creates an agent persistent machine (createAgentPersistentMachine); `source: byo` connects a BYO machine (connectBYOMachine) and returns the one-time `token`; otherwise createMachine.
+     */
+    create(params?: MachineCreateParams, options?: RequestOptions): APIPromise<Machine>;
+    /**
+     * Retrieve a machine. Adds `capabilities` (getMachineCapabilities), null when the project cannot use the machine.
+     */
+    retrieve(machineID: string, options?: RequestOptions): APIPromise<Machine>;
+    /**
+     * Update a machine.
+     */
+    update(machineID: string, params?: MachineUpdateParams, options?: RequestOptions): APIPromise<Machine>;
+    /**
+     * Delete a machine. With `agent_id` it deletes that agent's persistent machine (deleteAgentMachine).
+     */
+    delete(machineID: string, params?: MachineDeleteParams | null | undefined, options?: RequestOptions): APIPromise<MachineDeleted>;
+    /**
+     * Resume a paused machine.
+     */
+    resume(machineID: string, options?: RequestOptions): APIPromise<MachinePowerStatus>;
+    /**
+     * Machine interaction capabilities.
+     */
+    getCapabilities(machineID: string, options?: RequestOptions): APIPromise<MachineCapabilities>;
+}
+export declare class MachinePools extends APIResource {
+    grants: MachinePoolGrants;
+    /**
+     * List machine pools.
+     */
+    list(params?: MachinePoolListParams | null | undefined, options?: RequestOptions): PagePromise<MachinePoolsPageCursor, MachinePool>;
+    /**
+     * Create a machine pool.
+     */
+    create(params: MachinePoolCreateParams, options?: RequestOptions): APIPromise<MachinePool>;
+    /**
+     * Check provider connectivity before creating a pool.
+     */
+    checkConnection(params: MachinePoolCheckConnectionParams, options?: RequestOptions): APIPromise<MachinePoolConnectionCheck>;
+    /**
+     * Retrieve a machine pool.
+     */
+    retrieve(poolID: string, options?: RequestOptions): APIPromise<MachinePool>;
+    /**
+     * Update a machine pool.
+     */
+    update(poolID: string, params?: MachinePoolUpdateParams, options?: RequestOptions): APIPromise<MachinePool>;
+    /**
+     * Delete a machine pool.
+     */
+    delete(poolID: string, options?: RequestOptions): APIPromise<MachinePoolDeleted>;
+}
+export declare class MachinePoolGrants extends APIResource {
+    /**
+     * List the pool grants of a project. The project is the `project_id` query parameter or `x-bma-project-id`.
+     */
+    list(poolID: string, params?: MachinePoolGrantListParams | null | undefined, options?: RequestOptions): PagePromise<MachinePoolGrantsPageCursor, MachinePoolGrant>;
+    /**
+     * Grant a project the use of a pool. The body may carry `project_id`; otherwise the project header selects it. `machine_pool_id` comes from the path.
+     */
+    create(poolID: string, params?: MachinePoolGrantCreateParams, options?: RequestOptions): APIPromise<MachinePoolGrant>;
+    /**
+     * Retrieve a pool grant.
+     */
+    retrieve(poolID: string, grantID: string, options?: RequestOptions): APIPromise<MachinePoolGrant>;
+    /**
+     * Update a pool grant.
+     */
+    update(poolID: string, grantID: string, params?: MachinePoolGrantUpdateParams, options?: RequestOptions): APIPromise<MachinePoolGrant>;
+    /**
+     * Delete a pool grant.
+     */
+    delete(poolID: string, grantID: string, options?: RequestOptions): APIPromise<MachinePoolGrantDeleted>;
+}
+export declare class DesktopSessions extends APIResource {
+    tickets: DesktopSessionTickets;
+    /**
+     * Create a desktop session.
+     */
+    create(params: DesktopSessionCreateParams, options?: RequestOptions): APIPromise<DesktopSession>;
+    /**
+     * Retrieve a desktop session (control state in `control`).
+     */
+    retrieve(desktopSessionID: string, options?: RequestOptions): APIPromise<DesktopSession>;
+    /**
+     * Close a desktop session.
+     */
+    close(desktopSessionID: string, options?: RequestOptions): APIPromise<DesktopSessionClosed>;
+    /**
+     * Take input control.
+     */
+    acquireControl(desktopSessionID: string, params?: DesktopSessionAcquireControlParams, options?: RequestOptions): APIPromise<DesktopControlStatus>;
+    /**
+     * Renew the control lease.
+     */
+    renewControl(desktopSessionID: string, params?: DesktopSessionRenewControlParams, options?: RequestOptions): APIPromise<DesktopControlStatus>;
+    /**
+     * Release control.
+     */
+    releaseControl(desktopSessionID: string, params?: DesktopSessionReleaseControlParams, options?: RequestOptions): APIPromise<DesktopControlStatus>;
+    /**
+     * Hand control back to the agent.
+     */
+    handbackControl(desktopSessionID: string, params?: DesktopSessionHandbackControlParams, options?: RequestOptions): APIPromise<DesktopControlStatus>;
+    /**
+     * Send input actions.
+     */
+    sendActions(desktopSessionID: string, params: DesktopSessionSendActionsParams, options?: RequestOptions): APIPromise<DesktopActionResult>;
+    /**
+     * Capture a screenshot.
+     */
+    screenshot(desktopSessionID: string, params?: DesktopSessionScreenshotParams, options?: RequestOptions): APIPromise<DesktopScreenshot>;
+    /**
+     * Resume the desktop agent.
+     */
+    resumeAgent(desktopSessionID: string, params: DesktopSessionResumeAgentParams, options?: RequestOptions): APIPromise<DesktopControlStatus>;
+    /**
+     * Confirm a pending agent action.
+     */
+    confirmAction(desktopSessionID: string, pendingID: string, params: DesktopSessionConfirmActionParams, options?: RequestOptions): APIPromise<DesktopActionResult>;
+}
+export declare class DesktopSessionTickets extends APIResource {
+    /**
+     * Mint a single-use ticket (purpose watch). D-7 unified ticket endpoint. `purpose` defaults to and must be `watch`; the response is a `ticket` object. `watch_tickets` is the deprecated alias that answers `desktop_watch_ticket`.
+     */
+    create(desktopSessionID: string, params?: DesktopSessionTicketCreateParams, options?: RequestOptions): APIPromise<Ticket>;
+}
+export declare class TerminalSessions extends APIResource {
+    tickets: TerminalSessionTickets;
+    /**
+     * List the terminal sessions of a machine.
+     */
+    list(params?: TerminalSessionListParams | null | undefined, options?: RequestOptions): PagePromise<TerminalSessionsPageCursor, TerminalSession>;
+    /**
+     * Open a terminal session (body machine_id).
+     */
+    create(params: TerminalSessionCreateParams, options?: RequestOptions): APIPromise<TerminalSession>;
+    /**
+     * Retrieve a terminal session.
+     */
+    retrieve(terminalSessionID: string, options?: RequestOptions): APIPromise<TerminalSession>;
+    /**
+     * Close a terminal session. Native answers 204; the facade returns the session.
+     */
+    close(terminalSessionID: string, options?: RequestOptions): APIPromise<TerminalSession>;
+}
+export declare class TerminalSessionTickets extends APIResource {
+    /**
+     * Mint a single-use ticket (purpose connect). D-7 unified ticket endpoint. `purpose` defaults to and must be `connect`; the response is a `ticket` object. `connection_tickets` is the deprecated alias that answers `terminal_connection_ticket`.
+     */
+    create(terminalSessionID: string, params?: TerminalSessionTicketCreateParams, options?: RequestOptions): APIPromise<Ticket>;
+}
+export interface ExtensionServices {
+    machines: Machines;
+    machinePools: MachinePools;
+    desktopSessions: DesktopSessions;
+    terminalSessions: TerminalSessions;
+}
+export declare function newExtensionServices(client: BaseAnthropic): ExtensionServices;
+export {};