@agentuity/core 1.0.31 → 1.0.33

package/dist/api/api.d.ts

@@ -0,0 +1,226 @@
+/**
+ * API Client for Agentuity Platform
+ *
+ * Handles HTTP requests to the API with automatic error parsing and User-Agent headers.
+ */
+import { z } from 'zod';
+import type { Logger } from '../logger.ts';
+export interface APIClientConfig {
+    skipVersionCheck?: boolean;
+    userAgent?: string;
+    maxRetries?: number;
+    retryDelayMs?: number;
+    headers?: Record<string, string>;
+    /**
+     * Maximum time in milliseconds to keep retrying 502/503 responses.
+     * These indicate the service is restarting (hot-swap) and typically
+     * resolve within seconds. Defaults to 30000 (30 seconds).
+     */
+    serviceUnavailableTimeoutMs?: number;
+}
+export declare const ZodIssuesSchema: z.ZodArray<z.ZodObject<{
+    code: z.ZodString;
+    input: z.ZodOptional<z.ZodUnknown>;
+    path: z.ZodArray<z.ZodUnion<readonly [z.ZodString, z.ZodNumber]>>;
+    message: z.ZodString;
+}, z.core.$strip>>;
+export type IssuesType = z.infer<typeof ZodIssuesSchema>;
+export declare const APIErrorSchema: z.ZodObject<{
+    success: z.ZodBoolean;
+    code: z.ZodOptional<z.ZodString>;
+    message: z.ZodOptional<z.ZodString>;
+    error: z.ZodOptional<z.ZodUnion<readonly [z.ZodString, z.ZodObject<{
+        name: z.ZodOptional<z.ZodString>;
+        issues: z.ZodOptional<z.ZodArray<z.ZodObject<{
+            code: z.ZodString;
+            input: z.ZodOptional<z.ZodUnknown>;
+            path: z.ZodArray<z.ZodUnion<readonly [z.ZodString, z.ZodNumber]>>;
+            message: z.ZodString;
+        }, z.core.$strip>>>;
+    }, z.core.$strip>]>>;
+    details: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+}, z.core.$strip>;
+export declare const APIError: {
+    new (args?: ({
+        url: string;
+        status: number;
+        sessionId?: string | null;
+    } & {
+        message?: string;
+        cause?: unknown;
+    }) | undefined): import("../error.ts").RichError & {
+        readonly _tag: "APIErrorResponse";
+    } & Readonly<{
+        url: string;
+        status: number;
+        sessionId?: string | null;
+    }>;
+    readonly defaultMessage?: string;
+};
+export declare const ValidationInputError: {
+    new (args?: ({
+        url: string;
+        issues: IssuesType;
+    } & {
+        cause?: unknown;
+    }) | undefined): import("../error.ts").RichError & {
+        readonly _tag: "ValidationInputError";
+    } & Readonly<{
+        url: string;
+        issues: IssuesType;
+    }>;
+    readonly defaultMessage?: string;
+};
+export declare const ValidationOutputError: {
+    new (args?: ({
+        url: string;
+        issues: IssuesType;
+        sessionId?: string | null;
+    } & {
+        cause?: unknown;
+    }) | undefined): import("../error.ts").RichError & {
+        readonly _tag: "ValidationOutputError";
+    } & Readonly<{
+        url: string;
+        issues: IssuesType;
+        sessionId?: string | null;
+    }>;
+    readonly defaultMessage?: string;
+};
+export declare const UpgradeRequiredError: {
+    new (args?: ({
+        sessionId?: string | null;
+    } & {
+        cause?: unknown;
+    }) | undefined): import("../error.ts").RichError & {
+        readonly _tag: "UpgradeRequiredError";
+    } & Readonly<{
+        sessionId?: string | null;
+    }>;
+    readonly defaultMessage?: string;
+};
+export declare const MaxRetriesError: {
+    new (args?: {
+        cause?: unknown;
+    } | undefined): import("../error.ts").RichError & {
+        readonly _tag: "MaxRetriesError";
+    } & Readonly<Record<string, never>>;
+    readonly defaultMessage?: string;
+} & (<Shape extends {
+    [x: string]: any;
+} = Record<string, never>>() => {
+    new (args?: (Shape extends Record<string, never> ? {
+        cause?: unknown;
+    } : Shape & {
+        cause?: unknown;
+    }) | undefined): import("../error.ts").RichError & {
+        readonly _tag: "MaxRetriesError";
+    } & Readonly<Shape>;
+    readonly defaultMessage?: string;
+});
+export declare const MisdirectedRequestError: {
+    new (args?: ({
+        url: string;
+        region: string;
+        sessionId?: string | null;
+    } & {
+        cause?: unknown;
+    }) | undefined): import("../error.ts").RichError & {
+        readonly _tag: "MisdirectedRequestError";
+    } & Readonly<{
+        url: string;
+        region: string;
+        sessionId?: string | null;
+    }>;
+    readonly defaultMessage?: string;
+};
+export declare const PaymentRequiredError: {
+    new (args?: ({
+        url: string;
+        sessionId?: string | null;
+        upgradeUrl?: string;
+    } & {
+        cause?: unknown;
+    }) | undefined): import("../error.ts").RichError & {
+        readonly _tag: "PaymentRequiredError";
+    } & Readonly<{
+        url: string;
+        sessionId?: string | null;
+        upgradeUrl?: string;
+    }>;
+    readonly defaultMessage?: string;
+};
+export declare class APIClient {
+    #private;
+    constructor(baseUrl: string, logger: Logger, config?: APIClientConfig);
+    constructor(baseUrl: string, logger: Logger, apiKey: string, config?: APIClientConfig);
+    /**
+     * GET request
+     */
+    get<TResponse = void>(endpoint: string, responseSchema?: z.ZodType<TResponse>, signal?: AbortSignal, extraHeaders?: Record<string, string>): Promise<TResponse>;
+    /**
+     * POST request with optional body
+     */
+    post<TResponse = void, TBody = unknown>(endpoint: string, body?: TBody, responseSchema?: z.ZodType<TResponse>, bodySchema?: z.ZodType<TBody>, signal?: AbortSignal, extraHeaders?: Record<string, string>): Promise<TResponse>;
+    /**
+     * PUT request with optional body
+     */
+    put<TResponse = void, TBody = unknown>(endpoint: string, body?: TBody, responseSchema?: z.ZodType<TResponse>, bodySchema?: z.ZodType<TBody>, signal?: AbortSignal, extraHeaders?: Record<string, string>): Promise<TResponse>;
+    /**
+     * DELETE request
+     */
+    delete<TResponse = void>(endpoint: string, responseSchema?: z.ZodType<TResponse>, signal?: AbortSignal, extraHeaders?: Record<string, string>): Promise<TResponse>;
+    /**
+     * PATCH request with optional body
+     */
+    patch<TResponse = void, TBody = unknown>(endpoint: string, body?: TBody, responseSchema?: z.ZodType<TResponse>, bodySchema?: z.ZodType<TBody>, signal?: AbortSignal, extraHeaders?: Record<string, string>): Promise<TResponse>;
+    /**
+     * Raw GET request that returns the Response object directly.
+     * Useful for streaming responses where you need access to the body stream.
+     */
+    rawGet(endpoint: string, signal?: AbortSignal, extraHeaders?: Record<string, string>): Promise<Response>;
+    /**
+     * Raw POST request that returns the Response object directly.
+     * Useful for binary uploads where you need to pass raw body data.
+     */
+    rawPost(endpoint: string, body: Uint8Array | ArrayBuffer | ReadableStream<Uint8Array> | string, contentType: string, signal?: AbortSignal): Promise<Response>;
+    /**
+     * Raw PUT request that returns the Response object directly.
+     * Useful for binary uploads where you need to pass raw body data.
+     */
+    rawPut(endpoint: string, body: Uint8Array | ArrayBuffer | ReadableStream<Uint8Array> | string | Blob, contentType: string, signal?: AbortSignal, extraHeaders?: Record<string, string>): Promise<Response>;
+    /**
+     * Generic request method (prefer HTTP verb methods: get, post, put, delete, patch)
+     */
+    request<TResponse = void, TBody = unknown>(method: string, endpoint: string, responseSchema?: z.ZodType<TResponse>, body?: TBody, bodySchema?: z.ZodType<TBody>, signal?: AbortSignal, extraHeaders?: Record<string, string>): Promise<TResponse>;
+}
+export declare function getAPIBaseURL(region?: string, overrides?: {
+    api_url?: string;
+}): string;
+export declare function getAppBaseURL(region?: string, overrides?: {
+    app_url?: string;
+} | null): string;
+export declare const APIResponseSchema: <T extends z.ZodType>(dataSchema: T) => z.ZodDiscriminatedUnion<[z.ZodObject<{
+    success: z.ZodLiteral<false>;
+    message: z.ZodString;
+    code: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>, z.ZodObject<{
+    success: z.ZodLiteral<true>;
+    data: T;
+}, z.core.$strip>], "success">;
+export declare const APIResponseSchemaOptionalData: <T extends z.ZodType>(dataSchema: T) => z.ZodDiscriminatedUnion<[z.ZodObject<{
+    success: z.ZodLiteral<false>;
+    message: z.ZodString;
+    code: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>, z.ZodObject<{
+    success: z.ZodLiteral<true>;
+    data: z.ZodOptional<T>;
+}, z.core.$strip>], "success">;
+export declare const APIResponseSchemaNoData: () => z.ZodDiscriminatedUnion<[z.ZodObject<{
+    success: z.ZodLiteral<false>;
+    message: z.ZodString;
+    code: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>, z.ZodObject<{
+    success: z.ZodLiteral<true>;
+}, z.core.$strip>], "success">;
+//# sourceMappingURL=api.d.ts.map

package/dist/api/api.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"api.d.ts","sourceRoot":"","sources":["../../src/api/api.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,cAAc,CAAC;AAY3C,MAAM,WAAW,eAAe;IAC/B,gBAAgB,CAAC,EAAE,OAAO,CAAC;IAC3B,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACjC;;;;OAIG;IACH,2BAA2B,CAAC,EAAE,MAAM,CAAC;CACrC;AAED,eAAO,MAAM,eAAe;;;;;kBAO3B,CAAC;AAEF,MAAM,MAAM,UAAU,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,eAAe,CAAC,CAAC;AAWzD,eAAO,MAAM,cAAc;;;;;;;;;;;;;;iBAczB,CAAC;AAEH,eAAO,MAAM,QAAQ;;aACf,MAAM;gBACH,MAAM;oBACF,MAAM,GAAG,IAAI;;;;;;;aAFpB,MAAM;gBACH,MAAM;oBACF,MAAM,GAAG,IAAI;;;CACtB,CAAC;AAEL,eAAO,MAAM,oBAAoB;;aAI3B,MAAM;gBACH,UAAU;;;;;;aADb,MAAM;gBACH,UAAU;;;CACf,CAAC;AAEL,eAAO,MAAM,qBAAqB;;aAI5B,MAAM;gBACH,UAAU;oBACN,MAAM,GAAG,IAAI;;;;;;aAFpB,MAAM;gBACH,UAAU;oBACN,MAAM,GAAG,IAAI;;;CACtB,CAAC;AAEL,eAAO,MAAM,oBAAoB;;oBAIpB,MAAM,GAAG,IAAI;;;;;;oBAAb,MAAM,GAAG,IAAI;;;CACtB,CAAC;AAEL,eAAO,MAAM,eAAe;;;;;;;;;;;;;;;;;;EAG3B,CAAC;AAEF,eAAO,MAAM,uBAAuB;;aAI9B,MAAM;gBACH,MAAM;oBACF,MAAM,GAAG,IAAI;;;;;;aAFpB,MAAM;gBACH,MAAM;oBACF,MAAM,GAAG,IAAI;;;CACtB,CAAC;AAEL,eAAO,MAAM,oBAAoB;;aAI3B,MAAM;oBACC,MAAM,GAAG,IAAI;qBACZ,MAAM;;;;;;aAFd,MAAM;oBACC,MAAM,GAAG,IAAI;qBACZ,MAAM;;;CAChB,CAAC;AAEL,qBAAa,SAAS;;gBAMT,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,eAAe;gBACzD,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,eAAe;IA0BrF;;OAEG;IACG,GAAG,CAAC,SAAS,GAAG,IAAI,EACzB,QAAQ,EAAE,MAAM,EAChB,cAAc,CAAC,EAAE,CAAC,CAAC,OAAO,CAAC,SAAS,CAAC,EACrC,MAAM,CAAC,EAAE,WAAW,EACpB,YAAY,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GACnC,OAAO,CAAC,SAAS,CAAC;IAYrB;;OAEG;IACG,IAAI,CAAC,SAAS,GAAG,IAAI,EAAE,KAAK,GAAG,OAAO,EAC3C,QAAQ,EAAE,MAAM,EAChB,IAAI,CAAC,EAAE,KAAK,EACZ,cAAc,CAAC,EAAE,CAAC,CAAC,OAAO,CAAC,SAAS,CAAC,EACrC,UAAU,CAAC,EAAE,CAAC,CAAC,OAAO,CAAC,KAAK,CAAC,EAC7B,MAAM,CAAC,EAAE,WAAW,EACpB,YAAY,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GACnC,OAAO,CAAC,SAAS,CAAC;IAIrB;;OAEG;IACG,GAAG,CAAC,SAAS,GAAG,IAAI,EAAE,KAAK,GAAG,OAAO,EAC1C,QAAQ,EAAE,MAAM,EAChB,IAAI,CAAC,EAAE,KAAK,EACZ,cAAc,CAAC,EAAE,CAAC,CAAC,OAAO,CAAC,SAAS,CAAC,EACrC,UAAU,CAAC,EAAE,CAAC,CAAC,OAAO,CAAC,KAAK,CAAC,EAC7B,MAAM,CAAC,EAAE,WAAW,EACpB,YAAY,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GACnC,OAAO,CAAC,SAAS,CAAC;IAIrB;;OAEG;IACG,MAAM,CAAC,SAAS,GAAG,IAAI,EAC5B,QAAQ,EAAE,MAAM,EAChB,cAAc,CAAC,EAAE,CAAC,CAAC,OAAO,CAAC,SAAS,CAAC,EACrC,MAAM,CAAC,EAAE,WAAW,EACpB,YAAY,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GACnC,OAAO,CAAC,SAAS,CAAC;IAYrB;;OAEG;IACG,KAAK,CAAC,SAAS,GAAG,IAAI,EAAE,KAAK,GAAG,OAAO,EAC5C,QAAQ,EAAE,MAAM,EAChB,IAAI,CAAC,EAAE,KAAK,EACZ,cAAc,CAAC,EAAE,CAAC,CAAC,OAAO,CAAC,SAAS,CAAC,EACrC,UAAU,CAAC,EAAE,CAAC,CAAC,OAAO,CAAC,KAAK,CAAC,EAC7B,MAAM,CAAC,EAAE,WAAW,EACpB,YAAY,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GACnC,OAAO,CAAC,SAAS,CAAC;IAYrB;;;OAGG;IACG,MAAM,CACX,QAAQ,EAAE,MAAM,EAChB,MAAM,CAAC,EAAE,WAAW,EACpB,YAAY,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GACnC,OAAO,CAAC,QAAQ,CAAC;IAIpB;;;OAGG;IACG,OAAO,CACZ,QAAQ,EAAE,MAAM,EAChB,IAAI,EAAE,UAAU,GAAG,WAAW,GAAG,cAAc,CAAC,UAAU,CAAC,GAAG,MAAM,EACpE,WAAW,EAAE,MAAM,EACnB,MAAM,CAAC,EAAE,WAAW,GAClB,OAAO,CAAC,QAAQ,CAAC;IAIpB;;;OAGG;IACG,MAAM,CACX,QAAQ,EAAE,MAAM,EAChB,IAAI,EAAE,UAAU,GAAG,WAAW,GAAG,cAAc,CAAC,UAAU,CAAC,GAAG,MAAM,GAAG,IAAI,EAC3E,WAAW,EAAE,MAAM,EACnB,MAAM,CAAC,EAAE,WAAW,EACpB,YAAY,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GACnC,OAAO,CAAC,QAAQ,CAAC;IAIpB;;OAEG;IACG,OAAO,CAAC,SAAS,GAAG,IAAI,EAAE,KAAK,GAAG,OAAO,EAC9C,MAAM,EAAE,MAAM,EACd,QAAQ,EAAE,MAAM,EAChB,cAAc,CAAC,EAAE,CAAC,CAAC,OAAO,CAAC,SAAS,CAAC,EACrC,IAAI,CAAC,EAAE,KAAK,EACZ,UAAU,CAAC,EAAE,CAAC,CAAC,OAAO,CAAC,KAAK,CAAC,EAC7B,MAAM,CAAC,EAAE,WAAW,EACpB,YAAY,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GACnC,OAAO,CAAC,SAAS,CAAC;CAmjBrB;AAED,wBAAgB,aAAa,CAAC,MAAM,CAAC,EAAE,MAAM,EAAE,SAAS,CAAC,EAAE;IAAE,OAAO,CAAC,EAAE,MAAM,CAAA;CAAE,GAAG,MAAM,CAevF;AAED,wBAAgB,aAAa,CAAC,MAAM,CAAC,EAAE,MAAM,EAAE,SAAS,CAAC,EAAE;IAAE,OAAO,CAAC,EAAE,MAAM,CAAA;CAAE,GAAG,IAAI,GAAG,MAAM,CAe9F;AAED,eAAO,MAAM,iBAAiB,GAAI,CAAC,SAAS,CAAC,CAAC,OAAO,EAAE,YAAY,CAAC;;;;;;;8BAWjE,CAAC;AAEJ,eAAO,MAAM,6BAA6B,GAAI,CAAC,SAAS,CAAC,CAAC,OAAO,EAAE,YAAY,CAAC;;;;;;;8BAW7E,CAAC;AAEJ,eAAO,MAAM,uBAAuB;;;;;;8BAUjC,CAAC"}