@composio/client 0.1.0-alpha.15 → 0.1.0-alpha.16

package/resources/v3/auth/index.d.mts

@@ -0,0 +1,3 @@
+export { Auth } from "./auth.mjs";
+export { Session, type SessionRetrieveInfoResponse } from "./session.mjs";
+//# sourceMappingURL=index.d.mts.map

package/resources/v3/auth/index.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.mts","sourceRoot":"","sources":["../../../src/resources/v3/auth/index.ts"],"names":[],"mappings":"OAEO,EAAE,IAAI,EAAE;OACR,EAAE,OAAO,EAAE,KAAK,2BAA2B,EAAE"}

package/resources/v3/auth/index.d.ts

@@ -0,0 +1,3 @@
+export { Auth } from "./auth.js";
+export { Session, type SessionRetrieveInfoResponse } from "./session.js";
+//# sourceMappingURL=index.d.ts.map

package/resources/v3/auth/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/resources/v3/auth/index.ts"],"names":[],"mappings":"OAEO,EAAE,IAAI,EAAE;OACR,EAAE,OAAO,EAAE,KAAK,2BAA2B,EAAE"}

package/resources/v3/auth/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/resources/v3/auth/index.ts"],"names":[],"mappings":";AAAA,sFAAsF;;;AAEtF,kCAA8B;AAArB,4FAAA,IAAI,OAAA;AACb,wCAAsE;AAA7D,kGAAA,OAAO,OAAA"}

package/resources/v3/auth/index.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.mjs","sourceRoot":"","sources":["../../../src/resources/v3/auth/index.ts"],"names":[],"mappings":"AAAA,sFAAsF;OAE/E,EAAE,IAAI,EAAE;OACR,EAAE,OAAO,EAAoC"}

package/resources/{auth → v3/auth}/session.d.mts

@@ -1,6 +1,6 @@
-import { APIResource } from "../../core/resource.mjs";
-import { APIPromise } from "../../core/api-promise.mjs";
-import { RequestOptions } from "../../internal/request-options.mjs";
+import { APIResource } from "../../../core/resource.mjs";
+import { APIPromise } from "../../../core/api-promise.mjs";
+import { RequestOptions } from "../../../internal/request-options.mjs";
 export declare class Session extends APIResource {
     /**
      * Retrieves detailed information about the current authenticated user session,
@@ -8,28 +8,34 @@ export declare class Session extends APIResource {
      * applicable. This endpoint is useful for verifying authentication status and
      * retrieving contextual information about the authenticated user and their access
      * privileges.
+     *
+     * @example
+     * ```ts
+     * const response =
+     *   await client.v3.auth.session.retrieveInfo();
+     * ```
      */
-    retrieve(options?: RequestOptions): APIPromise<SessionRetrieveResponse>;
+    retrieveInfo(options?: RequestOptions): APIPromise<SessionRetrieveInfoResponse>;
 }
 /**
  * Response containing user session information
  */
-export interface SessionRetrieveResponse {
+export interface SessionRetrieveInfoResponse {
     /**
      * Details of the API key used for authentication (null if using session auth)
      */
-    api_key: SessionRetrieveResponse.APIKey | null;
+    api_key: SessionRetrieveInfoResponse.APIKey | null;
     /**
      * Information about the authenticated user
      */
-    org_member: SessionRetrieveResponse.OrgMember;
+    org_member: SessionRetrieveInfoResponse.OrgMember;
     /**
      * Details of the current active project (null if accessing with org-level
      * credentials)
      */
-    project: SessionRetrieveResponse.Project | null;
+    project: SessionRetrieveInfoResponse.Project | null;
 }
-export declare namespace SessionRetrieveResponse {
+export declare namespace SessionRetrieveInfoResponse {
     /**
      * Details of the API key used for authentication (null if using session auth)
      */
@@ -235,6 +241,6 @@ export declare namespace SessionRetrieveResponse {
     }
 }
 export declare namespace Session {
-    export { type SessionRetrieveResponse as SessionRetrieveResponse };
+    export { type SessionRetrieveInfoResponse as SessionRetrieveInfoResponse };
 }
 //# sourceMappingURL=session.d.mts.map

package/resources/v3/auth/session.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"session.d.mts","sourceRoot":"","sources":["../../../src/resources/v3/auth/session.ts"],"names":[],"mappings":"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"}

package/resources/{auth → v3/auth}/session.d.ts

@@ -1,6 +1,6 @@
-import { APIResource } from "../../core/resource.js";
-import { APIPromise } from "../../core/api-promise.js";
-import { RequestOptions } from "../../internal/request-options.js";
+import { APIResource } from "../../../core/resource.js";
+import { APIPromise } from "../../../core/api-promise.js";
+import { RequestOptions } from "../../../internal/request-options.js";
 export declare class Session extends APIResource {
     /**
      * Retrieves detailed information about the current authenticated user session,
@@ -8,28 +8,34 @@ export declare class Session extends APIResource {
      * applicable. This endpoint is useful for verifying authentication status and
      * retrieving contextual information about the authenticated user and their access
      * privileges.
+     *
+     * @example
+     * ```ts
+     * const response =
+     *   await client.v3.auth.session.retrieveInfo();
+     * ```
      */
-    retrieve(options?: RequestOptions): APIPromise<SessionRetrieveResponse>;
+    retrieveInfo(options?: RequestOptions): APIPromise<SessionRetrieveInfoResponse>;
 }
 /**
  * Response containing user session information
  */
-export interface SessionRetrieveResponse {
+export interface SessionRetrieveInfoResponse {
     /**
      * Details of the API key used for authentication (null if using session auth)
      */
-    api_key: SessionRetrieveResponse.APIKey | null;
+    api_key: SessionRetrieveInfoResponse.APIKey | null;
     /**
      * Information about the authenticated user
      */
-    org_member: SessionRetrieveResponse.OrgMember;
+    org_member: SessionRetrieveInfoResponse.OrgMember;
     /**
      * Details of the current active project (null if accessing with org-level
      * credentials)
      */
-    project: SessionRetrieveResponse.Project | null;
+    project: SessionRetrieveInfoResponse.Project | null;
 }
-export declare namespace SessionRetrieveResponse {
+export declare namespace SessionRetrieveInfoResponse {
     /**
      * Details of the API key used for authentication (null if using session auth)
      */
@@ -235,6 +241,6 @@ export declare namespace SessionRetrieveResponse {
     }
 }
 export declare namespace Session {
-    export { type SessionRetrieveResponse as SessionRetrieveResponse };
+    export { type SessionRetrieveInfoResponse as SessionRetrieveInfoResponse };
 }
 //# sourceMappingURL=session.d.ts.map

package/resources/v3/auth/session.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"session.d.ts","sourceRoot":"","sources":["../../../src/resources/v3/auth/session.ts"],"names":[],"mappings":"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"}

package/resources/{auth → v3/auth}/session.js

@@ -2,7 +2,7 @@
 // File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.Session = void 0;
-const resource_1 = require("../../core/resource.js");
+const resource_1 = require("../../../core/resource.js");
 class Session extends resource_1.APIResource {
     /**
      * Retrieves detailed information about the current authenticated user session,
@@ -10,8 +10,14 @@ class Session extends resource_1.APIResource {
      * applicable. This endpoint is useful for verifying authentication status and
      * retrieving contextual information about the authenticated user and their access
      * privileges.
+     *
+     * @example
+     * ```ts
+     * const response =
+     *   await client.v3.auth.session.retrieveInfo();
+     * ```
      */
-    retrieve(options) {
+    retrieveInfo(options) {
         return this._client.get('/api/v3/auth/session/info', options);
     }
 }

package/resources/v3/auth/session.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"session.js","sourceRoot":"","sources":["../../../src/resources/v3/auth/session.ts"],"names":[],"mappings":";AAAA,sFAAsF;;;AAEtF,wDAAqD;AAIrD,MAAa,OAAQ,SAAQ,sBAAW;IACtC;;;;;;;;;;;;OAYG;IACH,YAAY,CAAC,OAAwB;QACnC,OAAO,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,2BAA2B,EAAE,OAAO,CAAC,CAAC;IAChE,CAAC;CACF;AAjBD,0BAiBC"}

package/resources/{auth → v3/auth}/session.mjs

@@ -1,5 +1,5 @@
 // File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
-import { APIResource } from "../../core/resource.mjs";
+import { APIResource } from "../../../core/resource.mjs";
 export class Session extends APIResource {
     /**
      * Retrieves detailed information about the current authenticated user session,
@@ -7,8 +7,14 @@ export class Session extends APIResource {
      * applicable. This endpoint is useful for verifying authentication status and
      * retrieving contextual information about the authenticated user and their access
      * privileges.
+     *
+     * @example
+     * ```ts
+     * const response =
+     *   await client.v3.auth.session.retrieveInfo();
+     * ```
      */
-    retrieve(options) {
+    retrieveInfo(options) {
         return this._client.get('/api/v3/auth/session/info', options);
     }
 }

package/resources/v3/auth/session.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"session.mjs","sourceRoot":"","sources":["../../../src/resources/v3/auth/session.ts"],"names":[],"mappings":"AAAA,sFAAsF;OAE/E,EAAE,WAAW,EAAE;AAItB,MAAM,OAAO,OAAQ,SAAQ,WAAW;IACtC;;;;;;;;;;;;OAYG;IACH,YAAY,CAAC,OAAwB;QACnC,OAAO,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,2BAA2B,EAAE,OAAO,CAAC,CAAC;IAChE,CAAC;CACF"}

package/resources/{auth.d.mts.map → v3/auth.d.mts.map}

@@ -1 +1 @@
-{"version":3,"file":"auth.d.mts","sourceRoot":"","sources":["../src/resources/auth.ts"],"names":[],"mappings":""}
+{"version":3,"file":"auth.d.mts","sourceRoot":"","sources":["../../src/resources/v3/auth.ts"],"names":[],"mappings":""}

package/resources/v3/auth.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"auth.d.ts","sourceRoot":"","sources":["../../src/resources/v3/auth.ts"],"names":[],"mappings":""}

package/resources/{auth.js → v3/auth.js}

@@ -1,6 +1,6 @@
 "use strict";
 // File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
 Object.defineProperty(exports, "__esModule", { value: true });
-const tslib_1 = require("../internal/tslib.js");
+const tslib_1 = require("../../internal/tslib.js");
 tslib_1.__exportStar(require("./auth/index.js"), exports);
 //# sourceMappingURL=auth.js.map

package/resources/v3/auth.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"auth.js","sourceRoot":"","sources":["../../src/resources/v3/auth.ts"],"names":[],"mappings":";AAAA,sFAAsF;;;AAEtF,0DAA6B"}

package/resources/v3/auth.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"auth.mjs","sourceRoot":"","sources":["../../src/resources/v3/auth.ts"],"names":[],"mappings":"AAAA,sFAAsF"}

package/resources/v3/cli.d.mts

@@ -0,0 +1,167 @@
+import { APIResource } from "../../core/resource.mjs";
+import { APIPromise } from "../../core/api-promise.mjs";
+import { RequestOptions } from "../../internal/request-options.mjs";
+export declare class Cli extends APIResource {
+    /**
+     * Generates a new CLI session with a random 6-character code. This endpoint is the
+     * first step in the CLI authentication flow, creating a session that can later be
+     * linked to a user account. The generated code is displayed to the user in the CLI
+     * and should be entered in the web interface to complete authentication.
+     *
+     * @example
+     * ```ts
+     * const response = await client.v3.cli.createSession();
+     * ```
+     */
+    createSession(options?: RequestOptions): APIPromise<CliCreateSessionResponse>;
+    /**
+     * Links a pending CLI session to the currently authenticated user. This is the
+     * final step in the CLI authentication flow, where the user enters the code in the
+     * web interface and their account is associated with the CLI session, allowing the
+     * CLI to act on their behalf.
+     *
+     * @example
+     * ```ts
+     * const response = await client.v3.cli.linkSession({
+     *   id: 'ABC123',
+     * });
+     * ```
+     */
+    linkSession(body: CliLinkSessionParams, options?: RequestOptions): APIPromise<CliLinkSessionResponse>;
+    /**
+     * Retrieves the current state of a CLI session using either the session ID (UUID)
+     * or the 6-character code. This endpoint is used by both the CLI client to check
+     * if the session has been linked, and by the web interface to display session
+     * details before linking.
+     *
+     * @example
+     * ```ts
+     * const response = await client.v3.cli.retrieveSession({
+     *   id: 'ABC123',
+     * });
+     * ```
+     */
+    retrieveSession(query: CliRetrieveSessionParams, options?: RequestOptions): APIPromise<CliRetrieveSessionResponse>;
+}
+export interface CliCreateSessionResponse {
+    /**
+     * Unique identifier for the CLI session. UUID v4 format used for tracking and
+     * retrieval.
+     */
+    id: string;
+    /**
+     * The 6-character hexadecimal code used for CLI login
+     */
+    code: string;
+    /**
+     * The ISO timestamp when the session expires
+     */
+    expiresAt: string;
+    /**
+     * The current status of the session
+     */
+    status: 'pending' | 'linked';
+}
+export interface CliLinkSessionResponse {
+    /**
+     * The unique identifier for the CLI session
+     */
+    id: string;
+    /**
+     * Information about the linked account. Always present for successful responses
+     * from this endpoint.
+     */
+    account: CliLinkSessionResponse.Account;
+    /**
+     * The 6-character hexadecimal code used for CLI login
+     */
+    code: string;
+    /**
+     * The ISO timestamp when the session expires
+     */
+    expiresAt: string;
+    /**
+     * The current status of the session
+     */
+    status: 'pending' | 'linked';
+}
+export declare namespace CliLinkSessionResponse {
+    /**
+     * Information about the linked account. Always present for successful responses
+     * from this endpoint.
+     */
+    interface Account {
+        /**
+         * The ID of the linked account
+         */
+        id: string;
+        /**
+         * The email address of the linked account
+         */
+        email: string;
+        /**
+         * The display name of the linked account
+         */
+        name: string;
+    }
+}
+export interface CliRetrieveSessionResponse {
+    /**
+     * The unique identifier for the CLI session
+     */
+    id: string;
+    /**
+     * Information about the linked account, if any. Null if the session status is
+     * "pending".
+     */
+    account: CliRetrieveSessionResponse.Account | null;
+    /**
+     * The 6-character hexadecimal code used for CLI login
+     */
+    code: string;
+    /**
+     * The ISO timestamp when the session expires
+     */
+    expiresAt: string;
+    /**
+     * The current status of the session
+     */
+    status: 'pending' | 'linked';
+}
+export declare namespace CliRetrieveSessionResponse {
+    /**
+     * Information about the linked account, if any. Null if the session status is
+     * "pending".
+     */
+    interface Account {
+        /**
+         * The ID of the linked account
+         */
+        id: string;
+        /**
+         * The email address of the linked account
+         */
+        email: string;
+        /**
+         * The display name of the linked account
+         */
+        name: string;
+    }
+}
+export interface CliLinkSessionParams {
+    /**
+     * The CLI session ID or code to link to the current user
+     */
+    id: string;
+}
+export interface CliRetrieveSessionParams {
+    /**
+     * CLI session ID (UUID format) or 6-character code to check. Both formats are
+     * supported for flexibility in client implementations.
+     */
+    id: string;
+}
+export declare namespace Cli {
+    export { type CliCreateSessionResponse as CliCreateSessionResponse, type CliLinkSessionResponse as CliLinkSessionResponse, type CliRetrieveSessionResponse as CliRetrieveSessionResponse, type CliLinkSessionParams as CliLinkSessionParams, type CliRetrieveSessionParams as CliRetrieveSessionParams, };
+}
+//# sourceMappingURL=cli.d.mts.map

package/resources/v3/cli.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli.d.mts","sourceRoot":"","sources":["../../src/resources/v3/cli.ts"],"names":[],"mappings":"OAEO,EAAE,WAAW,EAAE;OACf,EAAE,UAAU,EAAE;OACd,EAAE,cAAc,EAAE;AAEzB,qBAAa,GAAI,SAAQ,WAAW;IAClC;;;;;;;;;;OAUG;IACH,aAAa,CAAC,OAAO,CAAC,EAAE,cAAc,GAAG,UAAU,CAAC,wBAAwB,CAAC;IAI7E;;;;;;;;;;;;OAYG;IACH,WAAW,CAAC,IAAI,EAAE,oBAAoB,EAAE,OAAO,CAAC,EAAE,cAAc,GAAG,UAAU,CAAC,sBAAsB,CAAC;IAIrG;;;;;;;;;;;;OAYG;IACH,eAAe,CACb,KAAK,EAAE,wBAAwB,EAC/B,OAAO,CAAC,EAAE,cAAc,GACvB,UAAU,CAAC,0BAA0B,CAAC;CAG1C;AAED,MAAM,WAAW,wBAAwB;IACvC;;;OAGG;IACH,EAAE,EAAE,MAAM,CAAC;IAEX;;OAEG;IACH,IAAI,EAAE,MAAM,CAAC;IAEb;;OAEG;IACH,SAAS,EAAE,MAAM,CAAC;IAElB;;OAEG;IACH,MAAM,EAAE,SAAS,GAAG,QAAQ,CAAC;CAC9B;AAED,MAAM,WAAW,sBAAsB;IACrC;;OAEG;IACH,EAAE,EAAE,MAAM,CAAC;IAEX;;;OAGG;IACH,OAAO,EAAE,sBAAsB,CAAC,OAAO,CAAC;IAExC;;OAEG;IACH,IAAI,EAAE,MAAM,CAAC;IAEb;;OAEG;IACH,SAAS,EAAE,MAAM,CAAC;IAElB;;OAEG;IACH,MAAM,EAAE,SAAS,GAAG,QAAQ,CAAC;CAC9B;AAED,yBAAiB,sBAAsB,CAAC;IACtC;;;OAGG;IACH,UAAiB,OAAO;QACtB;;WAEG;QACH,EAAE,EAAE,MAAM,CAAC;QAEX;;WAEG;QACH,KAAK,EAAE,MAAM,CAAC;QAEd;;WAEG;QACH,IAAI,EAAE,MAAM,CAAC;KACd;CACF;AAED,MAAM,WAAW,0BAA0B;IACzC;;OAEG;IACH,EAAE,EAAE,MAAM,CAAC;IAEX;;;OAGG;IACH,OAAO,EAAE,0BAA0B,CAAC,OAAO,GAAG,IAAI,CAAC;IAEnD;;OAEG;IACH,IAAI,EAAE,MAAM,CAAC;IAEb;;OAEG;IACH,SAAS,EAAE,MAAM,CAAC;IAElB;;OAEG;IACH,MAAM,EAAE,SAAS,GAAG,QAAQ,CAAC;CAC9B;AAED,yBAAiB,0BAA0B,CAAC;IAC1C;;;OAGG;IACH,UAAiB,OAAO;QACtB;;WAEG;QACH,EAAE,EAAE,MAAM,CAAC;QAEX;;WAEG;QACH,KAAK,EAAE,MAAM,CAAC;QAEd;;WAEG;QACH,IAAI,EAAE,MAAM,CAAC;KACd;CACF;AAED,MAAM,WAAW,oBAAoB;IACnC;;OAEG;IACH,EAAE,EAAE,MAAM,CAAC;CACZ;AAED,MAAM,WAAW,wBAAwB;IACvC;;;OAGG;IACH,EAAE,EAAE,MAAM,CAAC;CACZ;AAED,MAAM,CAAC,OAAO,WAAW,GAAG,CAAC;IAC3B,OAAO,EACL,KAAK,wBAAwB,IAAI,wBAAwB,EACzD,KAAK,sBAAsB,IAAI,sBAAsB,EACrD,KAAK,0BAA0B,IAAI,0BAA0B,EAC7D,KAAK,oBAAoB,IAAI,oBAAoB,EACjD,KAAK,wBAAwB,IAAI,wBAAwB,GAC1D,CAAC;CACH"}

package/resources/v3/cli.d.ts

@@ -0,0 +1,167 @@
+import { APIResource } from "../../core/resource.js";
+import { APIPromise } from "../../core/api-promise.js";
+import { RequestOptions } from "../../internal/request-options.js";
+export declare class Cli extends APIResource {
+    /**
+     * Generates a new CLI session with a random 6-character code. This endpoint is the
+     * first step in the CLI authentication flow, creating a session that can later be
+     * linked to a user account. The generated code is displayed to the user in the CLI
+     * and should be entered in the web interface to complete authentication.
+     *
+     * @example
+     * ```ts
+     * const response = await client.v3.cli.createSession();
+     * ```
+     */
+    createSession(options?: RequestOptions): APIPromise<CliCreateSessionResponse>;
+    /**
+     * Links a pending CLI session to the currently authenticated user. This is the
+     * final step in the CLI authentication flow, where the user enters the code in the
+     * web interface and their account is associated with the CLI session, allowing the
+     * CLI to act on their behalf.
+     *
+     * @example
+     * ```ts
+     * const response = await client.v3.cli.linkSession({
+     *   id: 'ABC123',
+     * });
+     * ```
+     */
+    linkSession(body: CliLinkSessionParams, options?: RequestOptions): APIPromise<CliLinkSessionResponse>;
+    /**
+     * Retrieves the current state of a CLI session using either the session ID (UUID)
+     * or the 6-character code. This endpoint is used by both the CLI client to check
+     * if the session has been linked, and by the web interface to display session
+     * details before linking.
+     *
+     * @example
+     * ```ts
+     * const response = await client.v3.cli.retrieveSession({
+     *   id: 'ABC123',
+     * });
+     * ```
+     */
+    retrieveSession(query: CliRetrieveSessionParams, options?: RequestOptions): APIPromise<CliRetrieveSessionResponse>;
+}
+export interface CliCreateSessionResponse {
+    /**
+     * Unique identifier for the CLI session. UUID v4 format used for tracking and
+     * retrieval.
+     */
+    id: string;
+    /**
+     * The 6-character hexadecimal code used for CLI login
+     */
+    code: string;
+    /**
+     * The ISO timestamp when the session expires
+     */
+    expiresAt: string;
+    /**
+     * The current status of the session
+     */
+    status: 'pending' | 'linked';
+}
+export interface CliLinkSessionResponse {
+    /**
+     * The unique identifier for the CLI session
+     */
+    id: string;
+    /**
+     * Information about the linked account. Always present for successful responses
+     * from this endpoint.
+     */
+    account: CliLinkSessionResponse.Account;
+    /**
+     * The 6-character hexadecimal code used for CLI login
+     */
+    code: string;
+    /**
+     * The ISO timestamp when the session expires
+     */
+    expiresAt: string;
+    /**
+     * The current status of the session
+     */
+    status: 'pending' | 'linked';
+}
+export declare namespace CliLinkSessionResponse {
+    /**
+     * Information about the linked account. Always present for successful responses
+     * from this endpoint.
+     */
+    interface Account {
+        /**
+         * The ID of the linked account
+         */
+        id: string;
+        /**
+         * The email address of the linked account
+         */
+        email: string;
+        /**
+         * The display name of the linked account
+         */
+        name: string;
+    }
+}
+export interface CliRetrieveSessionResponse {
+    /**
+     * The unique identifier for the CLI session
+     */
+    id: string;
+    /**
+     * Information about the linked account, if any. Null if the session status is
+     * "pending".
+     */
+    account: CliRetrieveSessionResponse.Account | null;
+    /**
+     * The 6-character hexadecimal code used for CLI login
+     */
+    code: string;
+    /**
+     * The ISO timestamp when the session expires
+     */
+    expiresAt: string;
+    /**
+     * The current status of the session
+     */
+    status: 'pending' | 'linked';
+}
+export declare namespace CliRetrieveSessionResponse {
+    /**
+     * Information about the linked account, if any. Null if the session status is
+     * "pending".
+     */
+    interface Account {
+        /**
+         * The ID of the linked account
+         */
+        id: string;
+        /**
+         * The email address of the linked account
+         */
+        email: string;
+        /**
+         * The display name of the linked account
+         */
+        name: string;
+    }
+}
+export interface CliLinkSessionParams {
+    /**
+     * The CLI session ID or code to link to the current user
+     */
+    id: string;
+}
+export interface CliRetrieveSessionParams {
+    /**
+     * CLI session ID (UUID format) or 6-character code to check. Both formats are
+     * supported for flexibility in client implementations.
+     */
+    id: string;
+}
+export declare namespace Cli {
+    export { type CliCreateSessionResponse as CliCreateSessionResponse, type CliLinkSessionResponse as CliLinkSessionResponse, type CliRetrieveSessionResponse as CliRetrieveSessionResponse, type CliLinkSessionParams as CliLinkSessionParams, type CliRetrieveSessionParams as CliRetrieveSessionParams, };
+}
+//# sourceMappingURL=cli.d.ts.map

package/resources/v3/cli.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli.d.ts","sourceRoot":"","sources":["../../src/resources/v3/cli.ts"],"names":[],"mappings":"OAEO,EAAE,WAAW,EAAE;OACf,EAAE,UAAU,EAAE;OACd,EAAE,cAAc,EAAE;AAEzB,qBAAa,GAAI,SAAQ,WAAW;IAClC;;;;;;;;;;OAUG;IACH,aAAa,CAAC,OAAO,CAAC,EAAE,cAAc,GAAG,UAAU,CAAC,wBAAwB,CAAC;IAI7E;;;;;;;;;;;;OAYG;IACH,WAAW,CAAC,IAAI,EAAE,oBAAoB,EAAE,OAAO,CAAC,EAAE,cAAc,GAAG,UAAU,CAAC,sBAAsB,CAAC;IAIrG;;;;;;;;;;;;OAYG;IACH,eAAe,CACb,KAAK,EAAE,wBAAwB,EAC/B,OAAO,CAAC,EAAE,cAAc,GACvB,UAAU,CAAC,0BAA0B,CAAC;CAG1C;AAED,MAAM,WAAW,wBAAwB;IACvC;;;OAGG;IACH,EAAE,EAAE,MAAM,CAAC;IAEX;;OAEG;IACH,IAAI,EAAE,MAAM,CAAC;IAEb;;OAEG;IACH,SAAS,EAAE,MAAM,CAAC;IAElB;;OAEG;IACH,MAAM,EAAE,SAAS,GAAG,QAAQ,CAAC;CAC9B;AAED,MAAM,WAAW,sBAAsB;IACrC;;OAEG;IACH,EAAE,EAAE,MAAM,CAAC;IAEX;;;OAGG;IACH,OAAO,EAAE,sBAAsB,CAAC,OAAO,CAAC;IAExC;;OAEG;IACH,IAAI,EAAE,MAAM,CAAC;IAEb;;OAEG;IACH,SAAS,EAAE,MAAM,CAAC;IAElB;;OAEG;IACH,MAAM,EAAE,SAAS,GAAG,QAAQ,CAAC;CAC9B;AAED,yBAAiB,sBAAsB,CAAC;IACtC;;;OAGG;IACH,UAAiB,OAAO;QACtB;;WAEG;QACH,EAAE,EAAE,MAAM,CAAC;QAEX;;WAEG;QACH,KAAK,EAAE,MAAM,CAAC;QAEd;;WAEG;QACH,IAAI,EAAE,MAAM,CAAC;KACd;CACF;AAED,MAAM,WAAW,0BAA0B;IACzC;;OAEG;IACH,EAAE,EAAE,MAAM,CAAC;IAEX;;;OAGG;IACH,OAAO,EAAE,0BAA0B,CAAC,OAAO,GAAG,IAAI,CAAC;IAEnD;;OAEG;IACH,IAAI,EAAE,MAAM,CAAC;IAEb;;OAEG;IACH,SAAS,EAAE,MAAM,CAAC;IAElB;;OAEG;IACH,MAAM,EAAE,SAAS,GAAG,QAAQ,CAAC;CAC9B;AAED,yBAAiB,0BAA0B,CAAC;IAC1C;;;OAGG;IACH,UAAiB,OAAO;QACtB;;WAEG;QACH,EAAE,EAAE,MAAM,CAAC;QAEX;;WAEG;QACH,KAAK,EAAE,MAAM,CAAC;QAEd;;WAEG;QACH,IAAI,EAAE,MAAM,CAAC;KACd;CACF;AAED,MAAM,WAAW,oBAAoB;IACnC;;OAEG;IACH,EAAE,EAAE,MAAM,CAAC;CACZ;AAED,MAAM,WAAW,wBAAwB;IACvC;;;OAGG;IACH,EAAE,EAAE,MAAM,CAAC;CACZ;AAED,MAAM,CAAC,OAAO,WAAW,GAAG,CAAC;IAC3B,OAAO,EACL,KAAK,wBAAwB,IAAI,wBAAwB,EACzD,KAAK,sBAAsB,IAAI,sBAAsB,EACrD,KAAK,0BAA0B,IAAI,0BAA0B,EAC7D,KAAK,oBAAoB,IAAI,oBAAoB,EACjD,KAAK,wBAAwB,IAAI,wBAAwB,GAC1D,CAAC;CACH"}

package/resources/v3/cli.js

@@ -0,0 +1,55 @@
+"use strict";
+// File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.Cli = void 0;
+const resource_1 = require("../../core/resource.js");
+class Cli extends resource_1.APIResource {
+    /**
+     * Generates a new CLI session with a random 6-character code. This endpoint is the
+     * first step in the CLI authentication flow, creating a session that can later be
+     * linked to a user account. The generated code is displayed to the user in the CLI
+     * and should be entered in the web interface to complete authentication.
+     *
+     * @example
+     * ```ts
+     * const response = await client.v3.cli.createSession();
+     * ```
+     */
+    createSession(options) {
+        return this._client.post('/api/v3/cli/create-session', options);
+    }
+    /**
+     * Links a pending CLI session to the currently authenticated user. This is the
+     * final step in the CLI authentication flow, where the user enters the code in the
+     * web interface and their account is associated with the CLI session, allowing the
+     * CLI to act on their behalf.
+     *
+     * @example
+     * ```ts
+     * const response = await client.v3.cli.linkSession({
+     *   id: 'ABC123',
+     * });
+     * ```
+     */
+    linkSession(body, options) {
+        return this._client.put('/api/v3/cli/link-session', { body, ...options });
+    }
+    /**
+     * Retrieves the current state of a CLI session using either the session ID (UUID)
+     * or the 6-character code. This endpoint is used by both the CLI client to check
+     * if the session has been linked, and by the web interface to display session
+     * details before linking.
+     *
+     * @example
+     * ```ts
+     * const response = await client.v3.cli.retrieveSession({
+     *   id: 'ABC123',
+     * });
+     * ```
+     */
+    retrieveSession(query, options) {
+        return this._client.get('/api/v3/cli/get-session', { query, ...options });
+    }
+}
+exports.Cli = Cli;
+//# sourceMappingURL=cli.js.map

package/resources/v3/cli.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli.js","sourceRoot":"","sources":["../../src/resources/v3/cli.ts"],"names":[],"mappings":";AAAA,sFAAsF;;;AAEtF,qDAAkD;AAIlD,MAAa,GAAI,SAAQ,sBAAW;IAClC;;;;;;;;;;OAUG;IACH,aAAa,CAAC,OAAwB;QACpC,OAAO,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,4BAA4B,EAAE,OAAO,CAAC,CAAC;IAClE,CAAC;IAED;;;;;;;;;;;;OAYG;IACH,WAAW,CAAC,IAA0B,EAAE,OAAwB;QAC9D,OAAO,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,0BAA0B,EAAE,EAAE,IAAI,EAAE,GAAG,OAAO,EAAE,CAAC,CAAC;IAC5E,CAAC;IAED;;;;;;;;;;;;OAYG;IACH,eAAe,CACb,KAA+B,EAC/B,OAAwB;QAExB,OAAO,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,yBAAyB,EAAE,EAAE,KAAK,EAAE,GAAG,OAAO,EAAE,CAAC,CAAC;IAC5E,CAAC;CACF;AApDD,kBAoDC"}