@onkernel/sdk 0.22.0 → 0.23.0

package/resources/agents/auth/auth.d.mts

@@ -0,0 +1,294 @@
+import { APIResource } from "../../../core/resource.mjs";
+import * as InvocationsAPI from "./invocations.mjs";
+import { InvocationCreateParams, InvocationDiscoverParams, InvocationExchangeParams, InvocationExchangeResponse, InvocationSubmitParams, Invocations } from "./invocations.mjs";
+import { APIPromise } from "../../../core/api-promise.mjs";
+import { OffsetPagination, type OffsetPaginationParams, PagePromise } from "../../../core/pagination.mjs";
+import { RequestOptions } from "../../../internal/request-options.mjs";
+export declare class Auth extends APIResource {
+    invocations: InvocationsAPI.Invocations;
+    /**
+     * Creates a new auth agent for the specified domain and profile combination, or
+     * returns an existing one if it already exists. This is idempotent - calling with
+     * the same domain and profile will return the same agent. Does NOT start an
+     * invocation - use POST /agents/auth/invocations to start an auth flow.
+     *
+     * @example
+     * ```ts
+     * const authAgent = await client.agents.auth.create({
+     *   profile_name: 'user-123',
+     *   target_domain: 'netflix.com',
+     * });
+     * ```
+     */
+    create(body: AuthCreateParams, options?: RequestOptions): APIPromise<AuthAgent>;
+    /**
+     * Retrieve an auth agent by its ID. Returns the current authentication status of
+     * the managed profile.
+     *
+     * @example
+     * ```ts
+     * const authAgent = await client.agents.auth.retrieve('id');
+     * ```
+     */
+    retrieve(id: string, options?: RequestOptions): APIPromise<AuthAgent>;
+    /**
+     * List auth agents with optional filters for profile_name and target_domain.
+     *
+     * @example
+     * ```ts
+     * // Automatically fetches more pages as needed.
+     * for await (const authAgent of client.agents.auth.list()) {
+     *   // ...
+     * }
+     * ```
+     */
+    list(query?: AuthListParams | null | undefined, options?: RequestOptions): PagePromise<AuthAgentsOffsetPagination, AuthAgent>;
+}
+export type AuthAgentsOffsetPagination = OffsetPagination<AuthAgent>;
+/**
+ * Response from discover endpoint matching AuthBlueprint schema
+ */
+export interface AgentAuthDiscoverResponse {
+    /**
+     * Whether discovery succeeded
+     */
+    success: boolean;
+    /**
+     * Error message if discovery failed
+     */
+    error_message?: string;
+    /**
+     * Discovered form fields (present when success is true)
+     */
+    fields?: Array<DiscoveredField>;
+    /**
+     * Whether user is already logged in
+     */
+    logged_in?: boolean;
+    /**
+     * URL of the discovered login page
+     */
+    login_url?: string;
+    /**
+     * Title of the login page
+     */
+    page_title?: string;
+}
+/**
+ * Response from get invocation endpoint
+ */
+export interface AgentAuthInvocationResponse {
+    /**
+     * App name (org name at time of invocation creation)
+     */
+    app_name: string;
+    /**
+     * When the handoff code expires
+     */
+    expires_at: string;
+    /**
+     * Invocation status
+     */
+    status: 'IN_PROGRESS' | 'SUCCESS' | 'EXPIRED' | 'CANCELED';
+    /**
+     * Target domain for authentication
+     */
+    target_domain: string;
+}
+/**
+ * Response from submit endpoint matching SubmitResult schema
+ */
+export interface AgentAuthSubmitResponse {
+    /**
+     * Whether submission succeeded
+     */
+    success: boolean;
+    /**
+     * Additional fields needed (e.g., OTP) - present when needs_additional_auth is
+     * true
+     */
+    additional_fields?: Array<DiscoveredField>;
+    /**
+     * App name (only present when logged_in is true)
+     */
+    app_name?: string;
+    /**
+     * Error message if submission failed
+     */
+    error_message?: string;
+    /**
+     * Whether user is now logged in
+     */
+    logged_in?: boolean;
+    /**
+     * Whether additional authentication fields are needed
+     */
+    needs_additional_auth?: boolean;
+    /**
+     * Target domain (only present when logged_in is true)
+     */
+    target_domain?: string;
+}
+/**
+ * An auth agent that manages authentication for a specific domain and profile
+ * combination
+ */
+export interface AuthAgent {
+    /**
+     * Unique identifier for the auth agent
+     */
+    id: string;
+    /**
+     * Target domain for authentication
+     */
+    domain: string;
+    /**
+     * Name of the profile associated with this auth agent
+     */
+    profile_name: string;
+    /**
+     * Current authentication status of the managed profile
+     */
+    status: 'AUTHENTICATED' | 'NEEDS_AUTH';
+    /**
+     * When the last authentication check was performed
+     */
+    last_auth_check_at?: string;
+}
+/**
+ * Request to create or find an auth agent
+ */
+export interface AuthAgentCreateRequest {
+    /**
+     * Name of the profile to use for this auth agent
+     */
+    profile_name: string;
+    /**
+     * Target domain for authentication
+     */
+    target_domain: string;
+    /**
+     * Optional login page URL. If provided, will be stored on the agent and used to
+     * skip discovery in future invocations.
+     */
+    login_url?: string;
+    /**
+     * Optional proxy configuration
+     */
+    proxy?: AuthAgentCreateRequest.Proxy;
+}
+export declare namespace AuthAgentCreateRequest {
+    /**
+     * Optional proxy configuration
+     */
+    interface Proxy {
+        /**
+         * ID of the proxy to use
+         */
+        proxy_id?: string;
+    }
+}
+/**
+ * Request to create an invocation for an existing auth agent
+ */
+export interface AuthAgentInvocationCreateRequest {
+    /**
+     * ID of the auth agent to create an invocation for
+     */
+    auth_agent_id: string;
+}
+/**
+ * Response from creating an auth agent invocation
+ */
+export interface AuthAgentInvocationCreateResponse {
+    /**
+     * When the handoff code expires
+     */
+    expires_at: string;
+    /**
+     * One-time code for handoff
+     */
+    handoff_code: string;
+    /**
+     * URL to redirect user to
+     */
+    hosted_url: string;
+    /**
+     * Unique identifier for the invocation
+     */
+    invocation_id: string;
+}
+/**
+ * A discovered form field
+ */
+export interface DiscoveredField {
+    /**
+     * Field label
+     */
+    label: string;
+    /**
+     * Field name
+     */
+    name: string;
+    /**
+     * CSS selector for the field
+     */
+    selector: string;
+    /**
+     * Field type
+     */
+    type: 'text' | 'email' | 'password' | 'tel' | 'number' | 'url' | 'code';
+    /**
+     * Field placeholder
+     */
+    placeholder?: string;
+    /**
+     * Whether field is required
+     */
+    required?: boolean;
+}
+export interface AuthCreateParams {
+    /**
+     * Name of the profile to use for this auth agent
+     */
+    profile_name: string;
+    /**
+     * Target domain for authentication
+     */
+    target_domain: string;
+    /**
+     * Optional login page URL. If provided, will be stored on the agent and used to
+     * skip discovery in future invocations.
+     */
+    login_url?: string;
+    /**
+     * Optional proxy configuration
+     */
+    proxy?: AuthCreateParams.Proxy;
+}
+export declare namespace AuthCreateParams {
+    /**
+     * Optional proxy configuration
+     */
+    interface Proxy {
+        /**
+         * ID of the proxy to use
+         */
+        proxy_id?: string;
+    }
+}
+export interface AuthListParams extends OffsetPaginationParams {
+    /**
+     * Filter by profile name
+     */
+    profile_name?: string;
+    /**
+     * Filter by target domain
+     */
+    target_domain?: string;
+}
+export declare namespace Auth {
+    export { type AgentAuthDiscoverResponse as AgentAuthDiscoverResponse, type AgentAuthInvocationResponse as AgentAuthInvocationResponse, type AgentAuthSubmitResponse as AgentAuthSubmitResponse, type AuthAgent as AuthAgent, type AuthAgentCreateRequest as AuthAgentCreateRequest, type AuthAgentInvocationCreateRequest as AuthAgentInvocationCreateRequest, type AuthAgentInvocationCreateResponse as AuthAgentInvocationCreateResponse, type DiscoveredField as DiscoveredField, type AuthAgentsOffsetPagination as AuthAgentsOffsetPagination, type AuthCreateParams as AuthCreateParams, type AuthListParams as AuthListParams, };
+    export { Invocations as Invocations, type InvocationExchangeResponse as InvocationExchangeResponse, type InvocationCreateParams as InvocationCreateParams, type InvocationDiscoverParams as InvocationDiscoverParams, type InvocationExchangeParams as InvocationExchangeParams, type InvocationSubmitParams as InvocationSubmitParams, };
+}
+//# sourceMappingURL=auth.d.mts.map

package/resources/agents/auth/auth.d.mts.map

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

package/resources/agents/auth/auth.d.ts

@@ -0,0 +1,294 @@
+import { APIResource } from "../../../core/resource.js";
+import * as InvocationsAPI from "./invocations.js";
+import { InvocationCreateParams, InvocationDiscoverParams, InvocationExchangeParams, InvocationExchangeResponse, InvocationSubmitParams, Invocations } from "./invocations.js";
+import { APIPromise } from "../../../core/api-promise.js";
+import { OffsetPagination, type OffsetPaginationParams, PagePromise } from "../../../core/pagination.js";
+import { RequestOptions } from "../../../internal/request-options.js";
+export declare class Auth extends APIResource {
+    invocations: InvocationsAPI.Invocations;
+    /**
+     * Creates a new auth agent for the specified domain and profile combination, or
+     * returns an existing one if it already exists. This is idempotent - calling with
+     * the same domain and profile will return the same agent. Does NOT start an
+     * invocation - use POST /agents/auth/invocations to start an auth flow.
+     *
+     * @example
+     * ```ts
+     * const authAgent = await client.agents.auth.create({
+     *   profile_name: 'user-123',
+     *   target_domain: 'netflix.com',
+     * });
+     * ```
+     */
+    create(body: AuthCreateParams, options?: RequestOptions): APIPromise<AuthAgent>;
+    /**
+     * Retrieve an auth agent by its ID. Returns the current authentication status of
+     * the managed profile.
+     *
+     * @example
+     * ```ts
+     * const authAgent = await client.agents.auth.retrieve('id');
+     * ```
+     */
+    retrieve(id: string, options?: RequestOptions): APIPromise<AuthAgent>;
+    /**
+     * List auth agents with optional filters for profile_name and target_domain.
+     *
+     * @example
+     * ```ts
+     * // Automatically fetches more pages as needed.
+     * for await (const authAgent of client.agents.auth.list()) {
+     *   // ...
+     * }
+     * ```
+     */
+    list(query?: AuthListParams | null | undefined, options?: RequestOptions): PagePromise<AuthAgentsOffsetPagination, AuthAgent>;
+}
+export type AuthAgentsOffsetPagination = OffsetPagination<AuthAgent>;
+/**
+ * Response from discover endpoint matching AuthBlueprint schema
+ */
+export interface AgentAuthDiscoverResponse {
+    /**
+     * Whether discovery succeeded
+     */
+    success: boolean;
+    /**
+     * Error message if discovery failed
+     */
+    error_message?: string;
+    /**
+     * Discovered form fields (present when success is true)
+     */
+    fields?: Array<DiscoveredField>;
+    /**
+     * Whether user is already logged in
+     */
+    logged_in?: boolean;
+    /**
+     * URL of the discovered login page
+     */
+    login_url?: string;
+    /**
+     * Title of the login page
+     */
+    page_title?: string;
+}
+/**
+ * Response from get invocation endpoint
+ */
+export interface AgentAuthInvocationResponse {
+    /**
+     * App name (org name at time of invocation creation)
+     */
+    app_name: string;
+    /**
+     * When the handoff code expires
+     */
+    expires_at: string;
+    /**
+     * Invocation status
+     */
+    status: 'IN_PROGRESS' | 'SUCCESS' | 'EXPIRED' | 'CANCELED';
+    /**
+     * Target domain for authentication
+     */
+    target_domain: string;
+}
+/**
+ * Response from submit endpoint matching SubmitResult schema
+ */
+export interface AgentAuthSubmitResponse {
+    /**
+     * Whether submission succeeded
+     */
+    success: boolean;
+    /**
+     * Additional fields needed (e.g., OTP) - present when needs_additional_auth is
+     * true
+     */
+    additional_fields?: Array<DiscoveredField>;
+    /**
+     * App name (only present when logged_in is true)
+     */
+    app_name?: string;
+    /**
+     * Error message if submission failed
+     */
+    error_message?: string;
+    /**
+     * Whether user is now logged in
+     */
+    logged_in?: boolean;
+    /**
+     * Whether additional authentication fields are needed
+     */
+    needs_additional_auth?: boolean;
+    /**
+     * Target domain (only present when logged_in is true)
+     */
+    target_domain?: string;
+}
+/**
+ * An auth agent that manages authentication for a specific domain and profile
+ * combination
+ */
+export interface AuthAgent {
+    /**
+     * Unique identifier for the auth agent
+     */
+    id: string;
+    /**
+     * Target domain for authentication
+     */
+    domain: string;
+    /**
+     * Name of the profile associated with this auth agent
+     */
+    profile_name: string;
+    /**
+     * Current authentication status of the managed profile
+     */
+    status: 'AUTHENTICATED' | 'NEEDS_AUTH';
+    /**
+     * When the last authentication check was performed
+     */
+    last_auth_check_at?: string;
+}
+/**
+ * Request to create or find an auth agent
+ */
+export interface AuthAgentCreateRequest {
+    /**
+     * Name of the profile to use for this auth agent
+     */
+    profile_name: string;
+    /**
+     * Target domain for authentication
+     */
+    target_domain: string;
+    /**
+     * Optional login page URL. If provided, will be stored on the agent and used to
+     * skip discovery in future invocations.
+     */
+    login_url?: string;
+    /**
+     * Optional proxy configuration
+     */
+    proxy?: AuthAgentCreateRequest.Proxy;
+}
+export declare namespace AuthAgentCreateRequest {
+    /**
+     * Optional proxy configuration
+     */
+    interface Proxy {
+        /**
+         * ID of the proxy to use
+         */
+        proxy_id?: string;
+    }
+}
+/**
+ * Request to create an invocation for an existing auth agent
+ */
+export interface AuthAgentInvocationCreateRequest {
+    /**
+     * ID of the auth agent to create an invocation for
+     */
+    auth_agent_id: string;
+}
+/**
+ * Response from creating an auth agent invocation
+ */
+export interface AuthAgentInvocationCreateResponse {
+    /**
+     * When the handoff code expires
+     */
+    expires_at: string;
+    /**
+     * One-time code for handoff
+     */
+    handoff_code: string;
+    /**
+     * URL to redirect user to
+     */
+    hosted_url: string;
+    /**
+     * Unique identifier for the invocation
+     */
+    invocation_id: string;
+}
+/**
+ * A discovered form field
+ */
+export interface DiscoveredField {
+    /**
+     * Field label
+     */
+    label: string;
+    /**
+     * Field name
+     */
+    name: string;
+    /**
+     * CSS selector for the field
+     */
+    selector: string;
+    /**
+     * Field type
+     */
+    type: 'text' | 'email' | 'password' | 'tel' | 'number' | 'url' | 'code';
+    /**
+     * Field placeholder
+     */
+    placeholder?: string;
+    /**
+     * Whether field is required
+     */
+    required?: boolean;
+}
+export interface AuthCreateParams {
+    /**
+     * Name of the profile to use for this auth agent
+     */
+    profile_name: string;
+    /**
+     * Target domain for authentication
+     */
+    target_domain: string;
+    /**
+     * Optional login page URL. If provided, will be stored on the agent and used to
+     * skip discovery in future invocations.
+     */
+    login_url?: string;
+    /**
+     * Optional proxy configuration
+     */
+    proxy?: AuthCreateParams.Proxy;
+}
+export declare namespace AuthCreateParams {
+    /**
+     * Optional proxy configuration
+     */
+    interface Proxy {
+        /**
+         * ID of the proxy to use
+         */
+        proxy_id?: string;
+    }
+}
+export interface AuthListParams extends OffsetPaginationParams {
+    /**
+     * Filter by profile name
+     */
+    profile_name?: string;
+    /**
+     * Filter by target domain
+     */
+    target_domain?: string;
+}
+export declare namespace Auth {
+    export { type AgentAuthDiscoverResponse as AgentAuthDiscoverResponse, type AgentAuthInvocationResponse as AgentAuthInvocationResponse, type AgentAuthSubmitResponse as AgentAuthSubmitResponse, type AuthAgent as AuthAgent, type AuthAgentCreateRequest as AuthAgentCreateRequest, type AuthAgentInvocationCreateRequest as AuthAgentInvocationCreateRequest, type AuthAgentInvocationCreateResponse as AuthAgentInvocationCreateResponse, type DiscoveredField as DiscoveredField, type AuthAgentsOffsetPagination as AuthAgentsOffsetPagination, type AuthCreateParams as AuthCreateParams, type AuthListParams as AuthListParams, };
+    export { Invocations as Invocations, type InvocationExchangeResponse as InvocationExchangeResponse, type InvocationCreateParams as InvocationCreateParams, type InvocationDiscoverParams as InvocationDiscoverParams, type InvocationExchangeParams as InvocationExchangeParams, type InvocationSubmitParams as InvocationSubmitParams, };
+}
+//# sourceMappingURL=auth.d.ts.map

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

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

package/resources/agents/auth/auth.js

@@ -0,0 +1,62 @@
+"use strict";
+// File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.Auth = void 0;
+const tslib_1 = require("../../../internal/tslib.js");
+const resource_1 = require("../../../core/resource.js");
+const InvocationsAPI = tslib_1.__importStar(require("./invocations.js"));
+const invocations_1 = require("./invocations.js");
+const pagination_1 = require("../../../core/pagination.js");
+const path_1 = require("../../../internal/utils/path.js");
+class Auth extends resource_1.APIResource {
+    constructor() {
+        super(...arguments);
+        this.invocations = new InvocationsAPI.Invocations(this._client);
+    }
+    /**
+     * Creates a new auth agent for the specified domain and profile combination, or
+     * returns an existing one if it already exists. This is idempotent - calling with
+     * the same domain and profile will return the same agent. Does NOT start an
+     * invocation - use POST /agents/auth/invocations to start an auth flow.
+     *
+     * @example
+     * ```ts
+     * const authAgent = await client.agents.auth.create({
+     *   profile_name: 'user-123',
+     *   target_domain: 'netflix.com',
+     * });
+     * ```
+     */
+    create(body, options) {
+        return this._client.post('/agents/auth', { body, ...options });
+    }
+    /**
+     * Retrieve an auth agent by its ID. Returns the current authentication status of
+     * the managed profile.
+     *
+     * @example
+     * ```ts
+     * const authAgent = await client.agents.auth.retrieve('id');
+     * ```
+     */
+    retrieve(id, options) {
+        return this._client.get((0, path_1.path) `/agents/auth/${id}`, options);
+    }
+    /**
+     * List auth agents with optional filters for profile_name and target_domain.
+     *
+     * @example
+     * ```ts
+     * // Automatically fetches more pages as needed.
+     * for await (const authAgent of client.agents.auth.list()) {
+     *   // ...
+     * }
+     * ```
+     */
+    list(query = {}, options) {
+        return this._client.getAPIList('/agents/auth', (pagination_1.OffsetPagination), { query, ...options });
+    }
+}
+exports.Auth = Auth;
+Auth.Invocations = invocations_1.Invocations;
+//# sourceMappingURL=auth.js.map

package/resources/agents/auth/auth.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"auth.js","sourceRoot":"","sources":["../../../src/resources/agents/auth/auth.ts"],"names":[],"mappings":";AAAA,sFAAsF;;;;AAEtF,wDAAqD;AACrD,yEAAgD;AAChD,kDAOuB;AAEvB,4DAAsG;AAEtG,0DAAoD;AAEpD,MAAa,IAAK,SAAQ,sBAAW;IAArC;;QACE,gBAAW,GAA+B,IAAI,cAAc,CAAC,WAAW,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;IAkDzF,CAAC;IAhDC;;;;;;;;;;;;;OAaG;IACH,MAAM,CAAC,IAAsB,EAAE,OAAwB;QACrD,OAAO,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,cAAc,EAAE,EAAE,IAAI,EAAE,GAAG,OAAO,EAAE,CAAC,CAAC;IACjE,CAAC;IAED;;;;;;;;OAQG;IACH,QAAQ,CAAC,EAAU,EAAE,OAAwB;QAC3C,OAAO,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,IAAA,WAAI,EAAA,gBAAgB,EAAE,EAAE,EAAE,OAAO,CAAC,CAAC;IAC7D,CAAC;IAED;;;;;;;;;;OAUG;IACH,IAAI,CACF,QAA2C,EAAE,EAC7C,OAAwB;QAExB,OAAO,IAAI,CAAC,OAAO,CAAC,UAAU,CAAC,cAAc,EAAE,CAAA,6BAA2B,CAAA,EAAE,EAAE,KAAK,EAAE,GAAG,OAAO,EAAE,CAAC,CAAC;IACrG,CAAC;CACF;AAnDD,oBAmDC;AAmSD,IAAI,CAAC,WAAW,GAAG,yBAAW,CAAC"}