@gpt-platform/client 0.10.4 → 0.11.0

package/dist/base-client.d.ts

@@ -0,0 +1,199 @@
+import type { Client } from "./_internal/client/index";
+import { RetryConfig } from "./utils/retry";
+import { SdkEventEmitter } from "./events";
+import type { Logger, LogLevel } from "./logging";
+export { InsecureConnectionError, BrowserApiKeyError } from "./security";
+export type { Logger, LogLevel } from "./logging";
+/** SDK version and default API version — sourced from generated version.ts */
+import { SDK_VERSION, DEFAULT_API_VERSION } from "./version";
+export { SDK_VERSION, DEFAULT_API_VERSION };
+/** Security configuration options */
+export interface SecurityConfig {
+    /**
+     * Require HTTPS for all requests (except localhost).
+     * When true, throws an error instead of just warning.
+     * Recommended for production environments.
+     * Default: false (warning only)
+     */
+    requireHttps?: boolean;
+    /**
+     * Warn when using API keys in browser environment.
+     * API keys should only be used server-side.
+     * Default: true
+     * @deprecated Use `dangerouslyAllowBrowser` instead
+     */
+    warnBrowserApiKey?: boolean;
+}
+/** Application info for User-Agent (Stripe-style) */
+export interface AppInfo {
+    /** Application name */
+    name: string;
+    /** Application version */
+    version?: string;
+    /** Application URL */
+    url?: string;
+}
+/** Request options that can be passed to individual namespace methods */
+export interface RequestOptions {
+    /** AbortSignal for cancellation */
+    signal?: AbortSignal;
+    /** Idempotency key override */
+    idempotencyKey?: string;
+    /** Additional headers for this request */
+    headers?: Record<string, string>;
+}
+export interface BaseClientConfig {
+    /** Base URL of the GPT Core API */
+    baseUrl?: string;
+    /** User JWT token (Bearer auth) */
+    token?: string;
+    /** Application API key (x-application-key header) */
+    apiKey?: string;
+    /** Retry configuration, or `false` to disable retries */
+    retry?: Partial<RetryConfig> | false;
+    /**
+     * API version date to use for requests (e.g., "2025-12-03").
+     * Defaults to the version this SDK was built against.
+     * Pin this to a specific date to prevent breaking changes
+     * when upgrading the SDK.
+     */
+    apiVersion?: string;
+    /**
+     * Security configuration options.
+     * Controls HTTPS enforcement and browser warnings.
+     */
+    security?: SecurityConfig;
+    /**
+     * Request timeout in milliseconds.
+     * Applies to all requests made by this client.
+     * Default: no timeout (0 = disabled)
+     */
+    timeout?: number;
+    /**
+     * Custom fetch implementation.
+     * Useful for testing or custom network layers.
+     * Default: globalThis.fetch
+     */
+    fetch?: typeof fetch;
+    /**
+     * Default headers sent with every request.
+     * Auth headers and Content-Type are not overridden.
+     */
+    defaultHeaders?: Record<string, string>;
+    /**
+     * Default workspace ID appended as `?workspace_id=` to every request that
+     * doesn't already carry one.
+     *
+     * **When to use:**
+     * - Server-side service clients where ALL operations target a single known
+     *   workspace (e.g., a background job scoped to one tenant's workspace).
+     *
+     * **When NOT to use:**
+     * - Single-workspace apps (`workspace_mode: "single"`): the platform
+     *   auto-resolves the default workspace — this field is unnecessary.
+     * - Multi-workspace apps with per-user routing: set `workspace_id` on the
+     *   API key itself via the platform dashboard instead. The key-level
+     *   `workspace_id` takes precedence and correctly scopes each key to its
+     *   own workspace without leaking across users.
+     */
+    workspaceId?: string;
+    /**
+     * Allow API key usage in browser environments.
+     * By default, using an API key in a browser throws an error.
+     * Set to true to suppress this safety check.
+     * Default: false
+     */
+    dangerouslyAllowBrowser?: boolean;
+    /**
+     * Log level for SDK operations.
+     * Default: 'warn'
+     */
+    logLevel?: LogLevel;
+    /**
+     * Custom logger implementation.
+     * Default: console
+     */
+    logger?: Logger;
+    /**
+     * Application info for User-Agent header (Stripe-style).
+     * Used by platform integrators to identify their app.
+     */
+    appInfo?: AppInfo;
+}
+export declare abstract class BaseClient {
+    protected retryConfig: Partial<RetryConfig> | false;
+    protected config: BaseClientConfig;
+    /** Per-instance client from @hey-api/openapi-ts */
+    protected clientInstance: Client;
+    /** The effective API version used by this client instance */
+    readonly apiVersion: string;
+    /** SDK lifecycle event emitter */
+    readonly events: SdkEventEmitter;
+    /** WeakMap to track request start times without mutating Request objects */
+    private readonly requestTimings;
+    /** Structured logger */
+    protected log: {
+        debug: (...args: unknown[]) => void;
+        info: (...args: unknown[]) => void;
+        warn: (...args: unknown[]) => void;
+        error: (...args: unknown[]) => void;
+    };
+    constructor(config?: BaseClientConfig);
+    /** Get the per-instance client for use in namespace methods */
+    getClientInstance(): Client;
+    /** Get headers for requests (used by namespaces) */
+    protected getHeaders(): Record<string, string>;
+    /**
+     * Unwrap a JSON:API response envelope.
+     * Extracts nested data and flattens JSON:API resources:
+     *   { id, type, attributes, relationships } → { id, type, ...attributes, ...relationships }
+     * Also handles arrays of resources.
+     */
+    protected unwrap<T>(resource: unknown): T;
+    /**
+     * Flatten a single JSON:API resource: { id, type, attributes, relationships } → { id, type, ...attributes, ...relationships }
+     */
+    private flattenResource;
+    protected handleError(error: unknown): never;
+    /**
+     * Execute an API call with retry logic.
+     * Used by namespace methods to automatically retry on transient failures.
+     */
+    protected requestWithRetry<T>(fn: () => Promise<T>): Promise<T>;
+    /**
+     * Update the authentication token (e.g., after login or token refresh).
+     * The interceptor reads from this.config dynamically, so changes take effect immediately.
+     */
+    setToken(token: string): void;
+    /**
+     * Clear the authentication token (e.g., on logout).
+     */
+    clearToken(): void;
+    /**
+     * Switch the workspace context for all subsequent requests.
+     *
+     * Sets the `workspace_id` query parameter appended to every request.
+     * Use this after creating a new workspace or switching workspace context
+     * without constructing a new client instance.
+     *
+     * @param workspaceId - The workspace UUID to scope requests to, or
+     *   `undefined` to clear workspace scoping.
+     *
+     * @example
+     * ```typescript
+     * const org = await sdk.platform.tenants.createOrg({ name: 'Acme' });
+     * const workspaces = await sdk.platform.workspaces.mine();
+     * const ws = workspaces.find(w => w.tenant_id === org.id);
+     *
+     * sdk.setWorkspaceId(ws.id);
+     * // All subsequent calls are scoped to the new workspace
+     * await sdk.scheduling.events.create({ ... });
+     * ```
+     */
+    setWorkspaceId(workspaceId: string | undefined): void;
+    /**
+     * Get the current workspace ID, if set.
+     */
+    getWorkspaceId(): string | undefined;
+}
+//# sourceMappingURL=base-client.d.ts.map

package/dist/base-client.d.ts.map

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

package/dist/errors/index.d.ts

@@ -0,0 +1,128 @@
+/**
+ * Base error class for all GPT Core SDK errors
+ */
+export declare class GptCoreError extends Error {
+    readonly name: string;
+    readonly statusCode?: number;
+    readonly code: string;
+    readonly requestId?: string;
+    readonly headers?: Record<string, string>;
+    readonly body?: unknown;
+    cause?: Error;
+    constructor(message: string, options?: {
+        statusCode?: number;
+        code?: string;
+        requestId?: string;
+        headers?: Record<string, string>;
+        body?: unknown;
+        cause?: Error;
+    });
+    /**
+     * Serialize error to plain object for logging/debugging
+     */
+    toJSON(): {
+        name: string;
+        message: string;
+        statusCode?: number;
+        code: string;
+        requestId?: string;
+    };
+}
+/**
+ * Authentication errors (401)
+ */
+export declare class AuthenticationError extends GptCoreError {
+    constructor(message?: string, options?: ConstructorParameters<typeof GptCoreError>[1]);
+}
+/**
+ * Authorization/Permission errors (403)
+ */
+export declare class AuthorizationError extends GptCoreError {
+    constructor(message?: string, options?: ConstructorParameters<typeof GptCoreError>[1]);
+}
+/**
+ * Resource not found errors (404)
+ */
+export declare class NotFoundError extends GptCoreError {
+    constructor(message?: string, options?: ConstructorParameters<typeof GptCoreError>[1]);
+}
+/**
+ * Validation errors (400, 422)
+ */
+export declare class ValidationError extends GptCoreError {
+    readonly errors?: Array<{
+        field?: string;
+        message: string;
+    }>;
+    constructor(message?: string, errors?: Array<{
+        field?: string;
+        message: string;
+    }>, options?: ConstructorParameters<typeof GptCoreError>[1]);
+}
+/**
+ * Rate limiting errors (429)
+ */
+export declare class RateLimitError extends GptCoreError {
+    readonly retryAfter?: number;
+    constructor(message?: string, retryAfter?: number, options?: ConstructorParameters<typeof GptCoreError>[1]);
+}
+/**
+ * Network/connection errors
+ */
+export declare class NetworkError extends GptCoreError {
+    constructor(message?: string, options?: ConstructorParameters<typeof GptCoreError>[1]);
+}
+/**
+ * Timeout errors
+ */
+export declare class TimeoutError extends GptCoreError {
+    constructor(message?: string, options?: ConstructorParameters<typeof GptCoreError>[1]);
+}
+/**
+ * Server errors (500+)
+ */
+export declare class ServerError extends GptCoreError {
+    constructor(message?: string, options?: ConstructorParameters<typeof GptCoreError>[1]);
+}
+/**
+ * Conflict errors (409)
+ */
+export declare class ConflictError extends GptCoreError {
+    constructor(message?: string, options?: ConstructorParameters<typeof GptCoreError>[1]);
+}
+/**
+ * Payment required errors (402) — insufficient balance or payment needed.
+ *
+ * Thrown when the workspace has insufficient credits for the requested operation.
+ * Prompt the user to purchase credits or upgrade their plan.
+ */
+export declare class PaymentRequiredError extends GptCoreError {
+    constructor(message?: string, options?: ConstructorParameters<typeof GptCoreError>[1]);
+}
+/**
+ * Card declined errors (402 with code "card_declined") — the payment gateway
+ * rejected the card.
+ *
+ * Check `declineCode` for the machine-readable reason (e.g., "insufficient_funds",
+ * "do_not_honor"). Display a user-friendly message and prompt for a different card.
+ */
+export declare class CardDeclinedError extends GptCoreError {
+    /** Machine-readable decline reason from the payment gateway, if available. */
+    readonly declineCode?: string;
+    constructor(message?: string, declineCode?: string, options?: ConstructorParameters<typeof GptCoreError>[1]);
+}
+/**
+ * Subscription conflict errors (409 with code "subscription_conflict") — a plan
+ * change was requested but conflicts with the current subscription state.
+ *
+ * This is distinct from a generic ConflictError. Occurs when attempting to
+ * downgrade while add-ons or usage exceed the target plan's limits.
+ */
+export declare class SubscriptionConflictError extends GptCoreError {
+    constructor(message?: string, options?: ConstructorParameters<typeof GptCoreError>[1]);
+}
+/**
+ * Parse error response and throw appropriate error class
+ */
+export declare function handleApiError(error: unknown): never;
+//# sourceMappingURL=index.d.ts.map

package/dist/errors/index.d.ts.map

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

package/dist/events.d.ts

@@ -0,0 +1,69 @@
+/**
+ * SDK lifecycle events.
+ * Stripe-style hooks for monitoring request/response/retry cycles.
+ */
+export interface SdkRequestEvent {
+    /** HTTP method */
+    method: string;
+    /** Request URL */
+    url: string;
+    /** Request headers (auth headers redacted) */
+    headers: Record<string, string>;
+    /** Timestamp when request was initiated */
+    timestamp: number;
+}
+export interface SdkResponseEvent {
+    /** HTTP method */
+    method: string;
+    /** Request URL */
+    url: string;
+    /** HTTP status code */
+    status: number;
+    /** Response headers */
+    headers: Record<string, string>;
+    /** Request ID from x-request-id header */
+    requestId?: string;
+    /** Duration in milliseconds */
+    duration: number;
+    /** API version from response */
+    apiVersion?: string;
+}
+export interface SdkRetryEvent {
+    /** Current retry attempt (1-based) */
+    attempt: number;
+    /** Maximum retries configured */
+    maxRetries: number;
+    /** Delay before next retry in ms */
+    delay: number;
+    /** The error that triggered the retry */
+    error: unknown;
+}
+export interface SdkErrorEvent {
+    /** HTTP method */
+    method: string;
+    /** Request URL */
+    url: string;
+    /** The error */
+    error: unknown;
+    /** Duration in milliseconds */
+    duration: number;
+}
+export type SdkEvents = {
+    request: SdkRequestEvent;
+    response: SdkResponseEvent;
+    retry: SdkRetryEvent;
+    error: SdkErrorEvent;
+};
+type EventHandler<T> = (event: T) => void;
+/**
+ * Type-safe event emitter for SDK lifecycle events.
+ */
+export declare class SdkEventEmitter {
+    private handlers;
+    on<K extends keyof SdkEvents>(event: K, handler: EventHandler<SdkEvents[K]>): () => void;
+    off<K extends keyof SdkEvents>(event: K, handler: EventHandler<SdkEvents[K]>): void;
+    emit<K extends keyof SdkEvents>(event: K, data: SdkEvents[K]): void;
+    removeAllListeners(event?: keyof SdkEvents): void;
+}
+export {};
+//# sourceMappingURL=events.d.ts.map

package/dist/events.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"events.d.ts","sourceRoot":"","sources":["../src/events.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,MAAM,WAAW,eAAe;IAC9B,kBAAkB;IAClB,MAAM,EAAE,MAAM,CAAC;IACf,kBAAkB;IAClB,GAAG,EAAE,MAAM,CAAC;IACZ,8CAA8C;IAC9C,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAChC,2CAA2C;IAC3C,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,gBAAgB;IAC/B,kBAAkB;IAClB,MAAM,EAAE,MAAM,CAAC;IACf,kBAAkB;IAClB,GAAG,EAAE,MAAM,CAAC;IACZ,uBAAuB;IACvB,MAAM,EAAE,MAAM,CAAC;IACf,uBAAuB;IACvB,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAChC,0CAA0C;IAC1C,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,+BAA+B;IAC/B,QAAQ,EAAE,MAAM,CAAC;IACjB,gCAAgC;IAChC,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,WAAW,aAAa;IAC5B,sCAAsC;IACtC,OAAO,EAAE,MAAM,CAAC;IAChB,iCAAiC;IACjC,UAAU,EAAE,MAAM,CAAC;IACnB,oCAAoC;IACpC,KAAK,EAAE,MAAM,CAAC;IACd,yCAAyC;IACzC,KAAK,EAAE,OAAO,CAAC;CAChB;AAED,MAAM,WAAW,aAAa;IAC5B,kBAAkB;IAClB,MAAM,EAAE,MAAM,CAAC;IACf,kBAAkB;IAClB,GAAG,EAAE,MAAM,CAAC;IACZ,gBAAgB;IAChB,KAAK,EAAE,OAAO,CAAC;IACf,+BAA+B;IAC/B,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,MAAM,SAAS,GAAG;IACtB,OAAO,EAAE,eAAe,CAAC;IACzB,QAAQ,EAAE,gBAAgB,CAAC;IAC3B,KAAK,EAAE,aAAa,CAAC;IACrB,KAAK,EAAE,aAAa,CAAC;CACtB,CAAC;AAEF,KAAK,YAAY,CAAC,CAAC,IAAI,CAAC,KAAK,EAAE,CAAC,KAAK,IAAI,CAAC;AAE1C;;GAEG;AACH,qBAAa,eAAe;IAC1B,OAAO,CAAC,QAAQ,CAET;IAEP,EAAE,CAAC,CAAC,SAAS,MAAM,SAAS,EAC1B,KAAK,EAAE,CAAC,EACR,OAAO,EAAE,YAAY,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,GAClC,MAAM,IAAI;IAcb,GAAG,CAAC,CAAC,SAAS,MAAM,SAAS,EAC3B,KAAK,EAAE,CAAC,EACR,OAAO,EAAE,YAAY,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,GAClC,IAAI;IAIP,IAAI,CAAC,CAAC,SAAS,MAAM,SAAS,EAAE,KAAK,EAAE,CAAC,EAAE,IAAI,EAAE,SAAS,CAAC,CAAC,CAAC,GAAG,IAAI;IAkBnE,kBAAkB,CAAC,KAAK,CAAC,EAAE,MAAM,SAAS,GAAG,IAAI;CAOlD"}

package/dist/execution-events.d.ts

@@ -0,0 +1,95 @@
+/**
+ * Typed events emitted by the agent execution SSE stream.
+ *
+ * Each event corresponds to a lifecycle stage of an agent execution.
+ * Use the `type` discriminant to narrow the union in switch statements.
+ *
+ * Field names match the backend SSE controller exactly:
+ * - token_delta → { content, index }
+ * - tool_call → { name, arguments }
+ * - tool_result → { name, summary }
+ * - iteration_complete → { iteration, tokens }
+ * - approval_required → { tool_name, arguments, classification }
+ * - done → { status, total_tokens, total_credits }
+ * - error → { error_type, message }
+ */
+/** Token fragment from LLM streaming output. */
+export interface TokenDeltaEvent {
+    type: "token_delta";
+    data: {
+        content: string;
+        index: number;
+    };
+}
+/** Tool invocation started. */
+export interface ToolCallEvent {
+    type: "tool_call";
+    data: {
+        name: string;
+        arguments: Record<string, unknown>;
+    };
+}
+/** Tool invocation completed. */
+export interface ToolResultEvent {
+    type: "tool_result";
+    data: {
+        name: string;
+        summary: string;
+    };
+}
+/** LLM loop iteration completed. */
+export interface IterationCompleteEvent {
+    type: "iteration_complete";
+    data: {
+        iteration: number;
+        tokens: number;
+    };
+}
+/** Human-in-the-loop approval required for a tool call. */
+export interface ApprovalRequiredEvent {
+    type: "approval_required";
+    data: {
+        tool_name: string;
+        arguments: Record<string, unknown>;
+        classification: string;
+    };
+}
+/** Execution completed successfully. */
+export interface DoneEvent {
+    type: "done";
+    data: {
+        status: string;
+        total_tokens: number;
+        total_credits: string;
+    };
+}
+/** Execution failed with an error. */
+export interface ErrorEvent {
+    type: "error";
+    data: {
+        error_type: string;
+        message: string;
+    };
+}
+/**
+ * Union of all execution SSE event types.
+ *
+ * @example
+ * ```typescript
+ * for await (const event of stream) {
+ *   switch (event.type) {
+ *     case "token_delta":
+ *       process.stdout.write(event.data.content);
+ *       break;
+ *     case "tool_call":
+ *       console.log(`Calling tool: ${event.data.name}`);
+ *       break;
+ *     case "done":
+ *       console.log(`Complete: ${event.data.status}, tokens: ${event.data.total_tokens}`);
+ *       break;
+ *   }
+ * }
+ * ```
+ */
+export type ExecutionEvent = TokenDeltaEvent | ToolCallEvent | ToolResultEvent | IterationCompleteEvent | ApprovalRequiredEvent | DoneEvent | ErrorEvent;
+//# sourceMappingURL=execution-events.d.ts.map

package/dist/execution-events.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"execution-events.d.ts","sourceRoot":"","sources":["../src/execution-events.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAEH,gDAAgD;AAChD,MAAM,WAAW,eAAe;IAC9B,IAAI,EAAE,aAAa,CAAC;IACpB,IAAI,EAAE;QAAE,OAAO,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,CAAC;CAC1C;AAED,+BAA+B;AAC/B,MAAM,WAAW,aAAa;IAC5B,IAAI,EAAE,WAAW,CAAC;IAClB,IAAI,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,SAAS,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;KAAE,CAAC;CAC5D;AAED,iCAAiC;AACjC,MAAM,WAAW,eAAe;IAC9B,IAAI,EAAE,aAAa,CAAC;IACpB,IAAI,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE,CAAC;CACzC;AAED,oCAAoC;AACpC,MAAM,WAAW,sBAAsB;IACrC,IAAI,EAAE,oBAAoB,CAAC;IAC3B,IAAI,EAAE;QAAE,SAAS,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE,CAAC;CAC7C;AAED,2DAA2D;AAC3D,MAAM,WAAW,qBAAqB;IACpC,IAAI,EAAE,mBAAmB,CAAC;IAC1B,IAAI,EAAE;QACJ,SAAS,EAAE,MAAM,CAAC;QAClB,SAAS,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;QACnC,cAAc,EAAE,MAAM,CAAC;KACxB,CAAC;CACH;AAED,wCAAwC;AACxC,MAAM,WAAW,SAAS;IACxB,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE;QACJ,MAAM,EAAE,MAAM,CAAC;QACf,YAAY,EAAE,MAAM,CAAC;QACrB,aAAa,EAAE,MAAM,CAAC;KACvB,CAAC;CACH;AAED,sCAAsC;AACtC,MAAM,WAAW,UAAU;IACzB,IAAI,EAAE,OAAO,CAAC;IACd,IAAI,EAAE;QAAE,UAAU,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE,CAAC;CAC/C;AAED;;;;;;;;;;;;;;;;;;;GAmBG;AACH,MAAM,MAAM,cAAc,GACtB,eAAe,GACf,aAAa,GACb,eAAe,GACf,sBAAsB,GACtB,qBAAqB,GACrB,SAAS,GACT,UAAU,CAAC"}