@lusor/sdk 0.0.0-stage → 1.0.0

package/dist/api/resources/agents/client/requests/GetAgentsRequest.d.ts

@@ -0,0 +1,16 @@
+/**
+ * @example
+ *     {
+ *         id: "id"
+ *     }
+ */
+export interface GetAgentsRequest {
+    /** Agent UUID. Missing, inaccessible, and malformed IDs return an opaque 404. */
+    id: string;
+    /**
+     * Workspace the request is scoped to. Optional for API keys: a key is
+     * bound to one workspace when it is created, and naming any other
+     * workspace returns an opaque 404.
+     */
+    workspaceId?: string;
+}

package/dist/api/resources/agents/client/requests/GetAgentsRequest.js

@@ -0,0 +1,2 @@
+// This file was auto-generated by Fern from our API Definition.
+export {};

package/dist/api/resources/agents/client/requests/ListAgentsRequest.d.ts

@@ -0,0 +1,16 @@
+/**
+ * @example
+ *     {}
+ */
+export interface ListAgentsRequest {
+    /**
+     * Workspace the request is scoped to. Optional for API keys: a key is
+     * bound to one workspace when it is created, and naming any other
+     * workspace returns an opaque 404.
+     */
+    workspaceId?: string;
+    /** Opaque anchor from the previous page's `nextCursor`; a malformed cursor is a 400. Order is most-recent activity first; an agent that becomes active during a walk moves to the head and is returned by a fresh first-page read, not by later pages. */
+    cursor?: string;
+    /** Agents per page. Defaults to 50 when only `cursor` is given. Order is most-recent activity first; an agent that becomes active during a walk moves to the head and is returned by a fresh first-page read, not by later pages. */
+    limit?: number;
+}

package/dist/api/resources/agents/client/requests/ListAgentsRequest.js

@@ -0,0 +1,2 @@
+// This file was auto-generated by Fern from our API Definition.
+export {};

package/dist/api/resources/agents/client/requests/ListArchivedAgentsRequest.d.ts

@@ -0,0 +1,12 @@
+/**
+ * @example
+ *     {}
+ */
+export interface ListArchivedAgentsRequest {
+    /**
+     * Workspace the request is scoped to. Optional for API keys: a key is
+     * bound to one workspace when it is created, and naming any other
+     * workspace returns an opaque 404.
+     */
+    workspaceId?: string;
+}

package/dist/api/resources/agents/client/requests/ListArchivedAgentsRequest.js

@@ -0,0 +1,2 @@
+// This file was auto-generated by Fern from our API Definition.
+export {};

package/dist/api/resources/agents/client/requests/RestoreAgentsRequest.d.ts

@@ -0,0 +1,13 @@
+import * as Lusor from "../../../../index.js";
+/**
+ * @example
+ *     {
+ *         id: "id",
+ *         body: {}
+ *     }
+ */
+export interface RestoreAgentsRequest {
+    /** Agent UUID. Missing, inaccessible, and malformed IDs return an opaque 404. */
+    id: string;
+    body?: Lusor.WorkspaceScopeInput;
+}

package/dist/api/resources/agents/client/requests/RestoreAgentsRequest.js

@@ -0,0 +1,2 @@
+// This file was auto-generated by Fern from our API Definition.
+export {};

package/dist/api/resources/agents/client/requests/RetargetQueueAgentsRequest.d.ts

@@ -0,0 +1,13 @@
+import * as Lusor from "../../../../index.js";
+/**
+ * @example
+ *     {
+ *         id: "id",
+ *         body: {}
+ *     }
+ */
+export interface RetargetQueueAgentsRequest {
+    /** Agent UUID. Missing, inaccessible, and malformed IDs return an opaque 404. */
+    id: string;
+    body?: Lusor.WorkspaceScopeInput;
+}

package/dist/api/resources/agents/client/requests/RetargetQueueAgentsRequest.js

@@ -0,0 +1,2 @@
+// This file was auto-generated by Fern from our API Definition.
+export {};

package/dist/api/resources/agents/client/requests/UpdateAgentInput.d.ts

@@ -0,0 +1,30 @@
+import * as Lusor from "../../../../index.js";
+/**
+ * @example
+ *     {
+ *         id: "id"
+ *     }
+ */
+export interface UpdateAgentInput extends Lusor.WorkspaceScopeInput {
+    /** Agent UUID. Missing, inaccessible, and malformed IDs return an opaque 404. */
+    id: string;
+    name?: string;
+    color?: string;
+    /** Avatar id. Omit on create for a random emoji; `null` is rejected. */
+    avatar?: string;
+    description?: string | null;
+    /**
+     * Provider-qualified model id, for example `deepseek/deepseek-flash`
+     * (the default), `openai/gpt-6-luna` or `anthropic/claude-opus-5-5`.
+     * `auto` is accepted as an alias for the default model and is
+     * stored as `deepseek/deepseek-flash`.
+     */
+    model?: string;
+    /**
+     * An agent uses at most one device. Supplying the array
+     * replaces the current attachment atomically (single RPC) —
+     * this is the "move my agent to another phone" flow. At most
+     * one entry is accepted; a second is rejected with a 400.
+     */
+    devices?: Lusor.AgentDeviceInput[];
+}

package/dist/api/resources/agents/client/requests/UpdateAgentInput.js

@@ -0,0 +1,2 @@
+// This file was auto-generated by Fern from our API Definition.
+export {};

package/dist/api/resources/agents/client/requests/index.d.ts

@@ -0,0 +1,8 @@
+export type { ArchiveAgentsRequest } from "./ArchiveAgentsRequest.js";
+export type { CreateAgentInput } from "./CreateAgentInput.js";
+export type { GetAgentsRequest } from "./GetAgentsRequest.js";
+export type { ListAgentsRequest } from "./ListAgentsRequest.js";
+export type { ListArchivedAgentsRequest } from "./ListArchivedAgentsRequest.js";
+export type { RestoreAgentsRequest } from "./RestoreAgentsRequest.js";
+export type { RetargetQueueAgentsRequest } from "./RetargetQueueAgentsRequest.js";
+export type { UpdateAgentInput } from "./UpdateAgentInput.js";

package/dist/api/resources/agents/client/requests/index.js

@@ -0,0 +1 @@
+export {};

package/dist/api/resources/agents/exports.d.ts

@@ -0,0 +1,3 @@
+export { AgentsClient } from "./client/Client.js";
+export * from "./client/index.js";
+export * from "./resources/index.js";

package/dist/api/resources/agents/exports.js

@@ -0,0 +1,4 @@
+// This file was auto-generated by Fern from our API Definition.
+export { AgentsClient } from "./client/Client.js";
+export * from "./client/index.js";
+export * from "./resources/index.js";

package/dist/api/resources/agents/index.d.ts

@@ -0,0 +1,3 @@
+export * from "./client/index.js";
+export * from "./resources/index.js";
+export * from "./types/index.js";

package/dist/api/resources/agents/index.js

@@ -0,0 +1,3 @@
+export * from "./client/index.js";
+export * from "./resources/index.js";
+export * from "./types/index.js";

package/dist/api/resources/agents/resources/index.d.ts

@@ -0,0 +1,3 @@
+export * as turns from "./turns/index.js";
+export * from "./turns/client/requests/index.js";
+export * from "./turns/types/index.js";

package/dist/api/resources/agents/resources/index.js

@@ -0,0 +1,3 @@
+export * as turns from "./turns/index.js";
+export * from "./turns/client/requests/index.js";
+export * from "./turns/types/index.js";

package/dist/api/resources/agents/resources/turns/client/Client.d.ts

@@ -0,0 +1,100 @@
+import type { BaseClientOptions, BaseRequestOptions } from "../../../../../../BaseClient.js";
+import { type NormalizedClientOptionsWithAuth } from "../../../../../../BaseClient.js";
+import * as core from "../../../../../../core/index.js";
+import * as Lusor from "../../../../../index.js";
+export declare namespace TurnsClient {
+    type Options = BaseClientOptions;
+    interface RequestOptions extends BaseRequestOptions {
+    }
+}
+export declare class TurnsClient {
+    protected readonly _options: NormalizedClientOptionsWithAuth<TurnsClient.Options>;
+    constructor(options?: TurnsClient.Options);
+    /**
+     * Cursor (keyset) pagination over the stable `(created_at, id)` session
+     * ordering, walking BACKWARDS from newest to oldest. Offsets are not
+     * supported on purpose: a turn arriving mid-scroll shifts every offset
+     * by one, so consecutive offset pages both duplicate and drop rows.
+     *
+     * The page unit is the session row, not the turn. A session bundles its
+     * markers and events, so a turn is never split across a page boundary;
+     * the turn count per page is therefore normally `limit` but can exceed
+     * it for older rows carrying several markers.
+     *
+     * Omitting `cursor` returns the newest page. `turns` is oldest-first,
+     * so a client prepends the array verbatim. `nextCursor` is null once
+     * history is exhausted.
+     *
+     * @param {Lusor.agents.ListTurnsRequest} request
+     * @param {TurnsClient.RequestOptions} requestOptions - Request-specific configuration.
+     *
+     * @throws {@link Lusor.BadRequestError}
+     * @throws {@link Lusor.UnauthorizedError}
+     * @throws {@link Lusor.NotFoundError}
+     * @throws {@link errors.LusorError}
+     * @throws {@link errors.LusorTimeoutError}
+     *
+     * @example
+     *     await client.agents.turns.list({
+     *         id: "id"
+     *     })
+     */
+    list(request: Lusor.agents.ListTurnsRequest, requestOptions?: TurnsClient.RequestOptions): core.HttpResponsePromise<Lusor.AgentTurnPageResponse>;
+    private __list;
+    /**
+     * Starts a run on the agent's phone, or queues it if the phone is busy
+     * (`queued: true`). An agent with no phone gets a turn that waits for
+     * one (`needsDevice: true`). Track the run with the returned
+     * `sessionId` under `/v1/sessions/{id}`.
+     *
+     * Send an `Idempotency-Key` header to make retries safe: the same key
+     * returns the original turn.
+     *
+     * @param {Lusor.agents.CreateAgentTurnInput} request
+     * @param {TurnsClient.RequestOptions} requestOptions - Request-specific configuration.
+     *
+     * @throws {@link Lusor.BadRequestError}
+     * @throws {@link Lusor.UnauthorizedError}
+     * @throws {@link Lusor.PaymentRequiredError}
+     * @throws {@link Lusor.NotFoundError}
+     * @throws {@link Lusor.ConflictError}
+     * @throws {@link errors.LusorError}
+     * @throws {@link errors.LusorTimeoutError}
+     *
+     * @example
+     *     await client.agents.turns.create({
+     *         id: "id",
+     *         prompt: "prompt"
+     *     })
+     */
+    create(request: Lusor.agents.CreateAgentTurnInput, requestOptions?: TurnsClient.RequestOptions): core.HttpResponsePromise<Lusor.AgentTurnDispatchResponse>;
+    private __create;
+    /**
+     * Retracts a queued turn before it starts. Idempotent: a turn that has
+     * already finished answers `200` with `cancelled: false`. A turn that
+     * has started returns `400`; stop it with
+     * `POST /v1/sessions/{id}/stop` instead. `409` means the cancel's
+     * outcome is not known yet; retry it.
+     *
+     * **Retries:** safe without an `Idempotency-Key`: a repeat converges on the same cancelled state.
+     *
+     * @param {Lusor.agents.CancelTurnsRequest} request
+     * @param {TurnsClient.RequestOptions} requestOptions - Request-specific configuration.
+     *
+     * @throws {@link Lusor.BadRequestError}
+     * @throws {@link Lusor.UnauthorizedError}
+     * @throws {@link Lusor.NotFoundError}
+     * @throws {@link Lusor.ConflictError}
+     * @throws {@link errors.LusorError}
+     * @throws {@link errors.LusorTimeoutError}
+     *
+     * @example
+     *     await client.agents.turns.cancel({
+     *         id: "id",
+     *         sessionId: "sessionId",
+     *         body: {}
+     *     })
+     */
+    cancel(request: Lusor.agents.CancelTurnsRequest, requestOptions?: TurnsClient.RequestOptions): core.HttpResponsePromise<Lusor.agents.CancelTurnsResponse>;
+    private __cancel;
+}

package/dist/api/resources/agents/resources/turns/client/Client.js

@@ -0,0 +1,240 @@
+// This file was auto-generated by Fern from our API Definition.
+import { normalizeClientOptionsWithAuth } from "../../../../../../BaseClient.js";
+import * as core from "../../../../../../core/index.js";
+import { mergeHeaders, mergeOnlyDefinedHeaders } from "../../../../../../core/headers.js";
+import { mergeAdditionalBodyParameters } from "../../../../../../core/requestBody.js";
+import * as environments from "../../../../../../environments.js";
+import { handleNonStatusCodeError } from "../../../../../../errors/handleNonStatusCodeError.js";
+import * as errors from "../../../../../../errors/index.js";
+import * as Lusor from "../../../../../index.js";
+export class TurnsClient {
+    _options;
+    constructor(options = {}) {
+        this._options = normalizeClientOptionsWithAuth(options);
+    }
+    /**
+     * Cursor (keyset) pagination over the stable `(created_at, id)` session
+     * ordering, walking BACKWARDS from newest to oldest. Offsets are not
+     * supported on purpose: a turn arriving mid-scroll shifts every offset
+     * by one, so consecutive offset pages both duplicate and drop rows.
+     *
+     * The page unit is the session row, not the turn. A session bundles its
+     * markers and events, so a turn is never split across a page boundary;
+     * the turn count per page is therefore normally `limit` but can exceed
+     * it for older rows carrying several markers.
+     *
+     * Omitting `cursor` returns the newest page. `turns` is oldest-first,
+     * so a client prepends the array verbatim. `nextCursor` is null once
+     * history is exhausted.
+     *
+     * @param {Lusor.agents.ListTurnsRequest} request
+     * @param {TurnsClient.RequestOptions} requestOptions - Request-specific configuration.
+     *
+     * @throws {@link Lusor.BadRequestError}
+     * @throws {@link Lusor.UnauthorizedError}
+     * @throws {@link Lusor.NotFoundError}
+     * @throws {@link errors.LusorError}
+     * @throws {@link errors.LusorTimeoutError}
+     *
+     * @example
+     *     await client.agents.turns.list({
+     *         id: "id"
+     *     })
+     */
+    list(request, requestOptions) {
+        return core.HttpResponsePromise.fromPromise(this.__list(request, requestOptions));
+    }
+    async __list(request, requestOptions) {
+        const { id, workspaceId, cursor, limit } = request;
+        const _queryParams = {
+            workspaceId,
+            cursor,
+            limit,
+        };
+        const _authRequest = await this._options.authProvider.getAuthRequest();
+        let _headers = mergeHeaders(_authRequest.headers, this._options?.headers, requestOptions?.headers);
+        const _response = await core.fetcher({
+            url: core.url.join((await core.Supplier.get(this._options.baseUrl)) ??
+                (await core.Supplier.get(this._options.environment)) ??
+                environments.LusorEnvironment.Production, `v1/agents/${core.url.encodePathParam(id)}/turns`),
+            method: "GET",
+            headers: _headers,
+            queryString: core.url
+                .queryBuilder()
+                .addMany(_queryParams)
+                .mergeAdditional(requestOptions?.queryParams)
+                .build(),
+            timeoutMs: (requestOptions?.timeoutInSeconds ?? this._options?.timeoutInSeconds ?? 60) * 1000,
+            maxRetries: requestOptions?.maxRetries ?? this._options?.maxRetries,
+            abortSignal: requestOptions?.abortSignal,
+            fetchFn: this._options?.fetch,
+            logging: this._options.logging,
+        });
+        if (_response.ok) {
+            return { data: _response.body, rawResponse: _response.rawResponse };
+        }
+        if (_response.error.reason === "status-code") {
+            switch (_response.error.statusCode) {
+                case 400:
+                    throw new Lusor.BadRequestError(_response.error.body, _response.rawResponse);
+                case 401:
+                    throw new Lusor.UnauthorizedError(_response.error.body, _response.rawResponse);
+                case 404:
+                    throw new Lusor.NotFoundError(_response.error.body, _response.rawResponse);
+                default:
+                    throw new errors.LusorError({
+                        statusCode: _response.error.statusCode,
+                        body: _response.error.body,
+                        rawResponse: _response.rawResponse,
+                    });
+            }
+        }
+        return handleNonStatusCodeError(_response.error, _response.rawResponse, "GET", "/v1/agents/{id}/turns");
+    }
+    /**
+     * Starts a run on the agent's phone, or queues it if the phone is busy
+     * (`queued: true`). An agent with no phone gets a turn that waits for
+     * one (`needsDevice: true`). Track the run with the returned
+     * `sessionId` under `/v1/sessions/{id}`.
+     *
+     * Send an `Idempotency-Key` header to make retries safe: the same key
+     * returns the original turn.
+     *
+     * @param {Lusor.agents.CreateAgentTurnInput} request
+     * @param {TurnsClient.RequestOptions} requestOptions - Request-specific configuration.
+     *
+     * @throws {@link Lusor.BadRequestError}
+     * @throws {@link Lusor.UnauthorizedError}
+     * @throws {@link Lusor.PaymentRequiredError}
+     * @throws {@link Lusor.NotFoundError}
+     * @throws {@link Lusor.ConflictError}
+     * @throws {@link errors.LusorError}
+     * @throws {@link errors.LusorTimeoutError}
+     *
+     * @example
+     *     await client.agents.turns.create({
+     *         id: "id",
+     *         prompt: "prompt"
+     *     })
+     */
+    create(request, requestOptions) {
+        return core.HttpResponsePromise.fromPromise(this.__create(request, requestOptions));
+    }
+    async __create(request, requestOptions) {
+        const { id, "Idempotency-Key": idempotencyKey, ..._body } = request;
+        const _authRequest = await this._options.authProvider.getAuthRequest();
+        let _headers = mergeHeaders(_authRequest.headers, this._options?.headers, mergeOnlyDefinedHeaders({ "Idempotency-Key": idempotencyKey }), requestOptions?.headers);
+        const _response = await core.fetcher({
+            url: core.url.join((await core.Supplier.get(this._options.baseUrl)) ??
+                (await core.Supplier.get(this._options.environment)) ??
+                environments.LusorEnvironment.Production, `v1/agents/${core.url.encodePathParam(id)}/turns`),
+            method: "POST",
+            headers: _headers,
+            contentType: "application/json",
+            queryString: core.url.queryBuilder().mergeAdditional(requestOptions?.queryParams).build(),
+            requestType: "json",
+            body: mergeAdditionalBodyParameters(_body, requestOptions?.additionalBodyParameters),
+            timeoutMs: (requestOptions?.timeoutInSeconds ?? this._options?.timeoutInSeconds ?? 60) * 1000,
+            maxRetries: 0,
+            abortSignal: requestOptions?.abortSignal,
+            fetchFn: this._options?.fetch,
+            logging: this._options.logging,
+        });
+        if (_response.ok) {
+            return { data: _response.body, rawResponse: _response.rawResponse };
+        }
+        if (_response.error.reason === "status-code") {
+            switch (_response.error.statusCode) {
+                case 400:
+                    throw new Lusor.BadRequestError(_response.error.body, _response.rawResponse);
+                case 401:
+                    throw new Lusor.UnauthorizedError(_response.error.body, _response.rawResponse);
+                case 402:
+                    throw new Lusor.PaymentRequiredError(_response.error.body, _response.rawResponse);
+                case 404:
+                    throw new Lusor.NotFoundError(_response.error.body, _response.rawResponse);
+                case 409:
+                    throw new Lusor.ConflictError(_response.error.body, _response.rawResponse);
+                default:
+                    throw new errors.LusorError({
+                        statusCode: _response.error.statusCode,
+                        body: _response.error.body,
+                        rawResponse: _response.rawResponse,
+                    });
+            }
+        }
+        return handleNonStatusCodeError(_response.error, _response.rawResponse, "POST", "/v1/agents/{id}/turns");
+    }
+    /**
+     * Retracts a queued turn before it starts. Idempotent: a turn that has
+     * already finished answers `200` with `cancelled: false`. A turn that
+     * has started returns `400`; stop it with
+     * `POST /v1/sessions/{id}/stop` instead. `409` means the cancel's
+     * outcome is not known yet; retry it.
+     *
+     * **Retries:** safe without an `Idempotency-Key`: a repeat converges on the same cancelled state.
+     *
+     * @param {Lusor.agents.CancelTurnsRequest} request
+     * @param {TurnsClient.RequestOptions} requestOptions - Request-specific configuration.
+     *
+     * @throws {@link Lusor.BadRequestError}
+     * @throws {@link Lusor.UnauthorizedError}
+     * @throws {@link Lusor.NotFoundError}
+     * @throws {@link Lusor.ConflictError}
+     * @throws {@link errors.LusorError}
+     * @throws {@link errors.LusorTimeoutError}
+     *
+     * @example
+     *     await client.agents.turns.cancel({
+     *         id: "id",
+     *         sessionId: "sessionId",
+     *         body: {}
+     *     })
+     */
+    cancel(request, requestOptions) {
+        return core.HttpResponsePromise.fromPromise(this.__cancel(request, requestOptions));
+    }
+    async __cancel(request, requestOptions) {
+        const { id, sessionId, body: _body } = request;
+        const _authRequest = await this._options.authProvider.getAuthRequest();
+        let _headers = mergeHeaders(_authRequest.headers, this._options?.headers, requestOptions?.headers);
+        const _response = await core.fetcher({
+            url: core.url.join((await core.Supplier.get(this._options.baseUrl)) ??
+                (await core.Supplier.get(this._options.environment)) ??
+                environments.LusorEnvironment.Production, `v1/agents/${core.url.encodePathParam(id)}/turns/${core.url.encodePathParam(sessionId)}/cancel`),
+            method: "POST",
+            headers: _headers,
+            contentType: "application/json",
+            queryString: core.url.queryBuilder().mergeAdditional(requestOptions?.queryParams).build(),
+            requestType: "json",
+            body: mergeAdditionalBodyParameters(_body, requestOptions?.additionalBodyParameters),
+            timeoutMs: (requestOptions?.timeoutInSeconds ?? this._options?.timeoutInSeconds ?? 60) * 1000,
+            maxRetries: 0,
+            abortSignal: requestOptions?.abortSignal,
+            fetchFn: this._options?.fetch,
+            logging: this._options.logging,
+        });
+        if (_response.ok) {
+            return { data: _response.body, rawResponse: _response.rawResponse };
+        }
+        if (_response.error.reason === "status-code") {
+            switch (_response.error.statusCode) {
+                case 400:
+                    throw new Lusor.BadRequestError(_response.error.body, _response.rawResponse);
+                case 401:
+                    throw new Lusor.UnauthorizedError(_response.error.body, _response.rawResponse);
+                case 404:
+                    throw new Lusor.NotFoundError(_response.error.body, _response.rawResponse);
+                case 409:
+                    throw new Lusor.ConflictError(_response.error.body, _response.rawResponse);
+                default:
+                    throw new errors.LusorError({
+                        statusCode: _response.error.statusCode,
+                        body: _response.error.body,
+                        rawResponse: _response.rawResponse,
+                    });
+            }
+        }
+        return handleNonStatusCodeError(_response.error, _response.rawResponse, "POST", "/v1/agents/{id}/turns/{sessionId}/cancel");
+    }
+}

package/dist/api/resources/agents/resources/turns/client/index.d.ts

@@ -0,0 +1 @@
+export * from "./requests/index.js";

package/dist/api/resources/agents/resources/turns/client/index.js

@@ -0,0 +1 @@
+export * from "./requests/index.js";

package/dist/api/resources/agents/resources/turns/client/requests/CancelTurnsRequest.d.ts

@@ -0,0 +1,16 @@
+import * as Lusor from "../../../../../../index.js";
+/**
+ * @example
+ *     {
+ *         id: "id",
+ *         sessionId: "sessionId",
+ *         body: {}
+ *     }
+ */
+export interface CancelTurnsRequest {
+    /** Agent UUID. Missing, inaccessible, and malformed IDs return an opaque 404. */
+    id: string;
+    /** The turn's `sessionId`, as returned by `POST /v1/agents/{id}/turns`. */
+    sessionId: string;
+    body?: Lusor.WorkspaceScopeInput;
+}

package/dist/api/resources/agents/resources/turns/client/requests/CancelTurnsRequest.js

@@ -0,0 +1,2 @@
+// This file was auto-generated by Fern from our API Definition.
+export {};

package/dist/api/resources/agents/resources/turns/client/requests/CreateAgentTurnInput.d.ts

@@ -0,0 +1,23 @@
+import * as Lusor from "../../../../../../index.js";
+/**
+ * @example
+ *     {
+ *         id: "id",
+ *         prompt: "prompt"
+ *     }
+ */
+export interface CreateAgentTurnInput extends Lusor.WorkspaceScopeInput {
+    /** Agent UUID. Missing, inaccessible, and malformed IDs return an opaque 404. */
+    id: string;
+    /**
+     * Caller-provided key for safe retries. The same key in the same
+     * workspace yields the same run id, and a duplicate POST within the
+     * retention window returns the original run instead of starting a
+     * second one.
+     */
+    "Idempotency-Key"?: string;
+    prompt: string;
+    device_id?: string;
+    /** Body fallback; Idempotency-Key header takes precedence. */
+    idempotencyKey?: string;
+}

package/dist/api/resources/agents/resources/turns/client/requests/CreateAgentTurnInput.js

@@ -0,0 +1,2 @@
+// This file was auto-generated by Fern from our API Definition.
+export {};

package/dist/api/resources/agents/resources/turns/client/requests/ListTurnsRequest.d.ts

@@ -0,0 +1,20 @@
+/**
+ * @example
+ *     {
+ *         id: "id"
+ *     }
+ */
+export interface ListTurnsRequest {
+    /** Agent UUID. Missing, inaccessible, and malformed IDs return an opaque 404. */
+    id: string;
+    /**
+     * Workspace the request is scoped to. Optional for API keys: a key is
+     * bound to one workspace when it is created, and naming any other
+     * workspace returns an opaque 404.
+     */
+    workspaceId?: string;
+    /** Opaque anchor from the previous page, or `turnsCursor` from the agent detail. */
+    cursor?: string;
+    /** Sessions per page. Defaults to 20. */
+    limit?: number;
+}

package/dist/api/resources/agents/resources/turns/client/requests/ListTurnsRequest.js

@@ -0,0 +1,2 @@
+// This file was auto-generated by Fern from our API Definition.
+export {};

package/dist/api/resources/agents/resources/turns/client/requests/index.d.ts

@@ -0,0 +1,3 @@
+export type { CancelTurnsRequest } from "./CancelTurnsRequest.js";
+export type { CreateAgentTurnInput } from "./CreateAgentTurnInput.js";
+export type { ListTurnsRequest } from "./ListTurnsRequest.js";

package/dist/api/resources/agents/resources/turns/client/requests/index.js

@@ -0,0 +1 @@
+export {};

package/dist/api/resources/agents/resources/turns/exports.d.ts

@@ -0,0 +1,2 @@
+export { TurnsClient } from "./client/Client.js";
+export * from "./client/index.js";

package/dist/api/resources/agents/resources/turns/exports.js

@@ -0,0 +1,3 @@
+// This file was auto-generated by Fern from our API Definition.
+export { TurnsClient } from "./client/Client.js";
+export * from "./client/index.js";

package/dist/api/resources/agents/resources/turns/index.d.ts

@@ -0,0 +1,2 @@
+export * from "./client/index.js";
+export * from "./types/index.js";

package/dist/api/resources/agents/resources/turns/index.js

@@ -0,0 +1,2 @@
+export * from "./client/index.js";
+export * from "./types/index.js";

package/dist/api/resources/agents/resources/turns/types/CancelTurnsResponse.d.ts

@@ -0,0 +1,14 @@
+export interface CancelTurnsResponse {
+    data: CancelTurnsResponse.Data;
+}
+export declare namespace CancelTurnsResponse {
+    interface Data {
+        sessionId: string;
+        /** The turn's status after the call. */
+        status: string;
+        /** `false` when the turn had already finished. */
+        cancelled: boolean;
+        invocationId: string | null;
+        invocationCancelled: boolean;
+    }
+}

package/dist/api/resources/agents/resources/turns/types/CancelTurnsResponse.js

@@ -0,0 +1,2 @@
+// This file was auto-generated by Fern from our API Definition.
+export {};

package/dist/api/resources/agents/resources/turns/types/index.d.ts

@@ -0,0 +1 @@
+export * from "./CancelTurnsResponse.js";