@agent-os-sdk/client 0.9.25 → 0.9.27

package/src/errors/index.ts

@@ -1,365 +0,0 @@
-/**
- * Agent OS SDK - Typed Errors
- * 
- * Enterprise-grade error classification for predictable error handling.
- * All errors extend AgentOsError and include semantic information.
- */
-
-/**
- * Options for constructing typed errors
- */
-export interface ErrorOptions {
-    /** Request ID from x-request-id header */
-    requestId?: string;
-    /** Original error code from backend (preserves backend semantics) */
-    backendCode?: string;
-    /** Raw details object from backend response */
-    details?: unknown;
-}
-
-/**
- * Base class for all Agent OS SDK errors.
- * Provides consistent structure for error handling and classification.
- */
-export abstract class AgentOsError extends Error {
-    /** Error code for programmatic handling */
-    abstract readonly code: string;
-
-    /** HTTP status code (0 for network/timeout errors) */
-    abstract readonly status: number;
-
-    /** Request ID from x-request-id header */
-    readonly requestId?: string;
-
-    /** Original error code from backend (preserves backend semantics) */
-    readonly backendCode?: string;
-
-    /** Raw details object from backend response */
-    readonly details?: unknown;
-
-    /** Timestamp when error occurred */
-    readonly timestamp: string = new Date().toISOString();
-
-    constructor(message: string, options?: ErrorOptions) {
-        super(message);
-        this.name = this.constructor.name;
-        this.requestId = options?.requestId;
-        this.backendCode = options?.backendCode;
-        this.details = options?.details;
-
-        // Maintains proper stack trace (V8 engines only)
-        if ("captureStackTrace" in Error && typeof Error.captureStackTrace === "function") {
-            Error.captureStackTrace(this, this.constructor);
-        }
-    }
-
-    /** 
-     * Whether this error is retryable with the same request.
-     * Override in subclasses for specific behavior.
-     */
-    isRetryable(): boolean {
-        return false;
-    }
-
-    /** Convert to JSON for logging/serialization */
-    toJSON(): Record<string, unknown> {
-        return {
-            name: this.name,
-            code: this.code,
-            status: this.status,
-            message: this.message,
-            requestId: this.requestId,
-            backendCode: this.backendCode,
-            details: this.details,
-            timestamp: this.timestamp,
-        };
-    }
-}
-
-// ============================================================================
-// Authentication & Authorization Errors
-// ============================================================================
-
-/**
- * 401 Unauthorized - Invalid or missing authentication.
- * 
- * @example
- * if (error instanceof UnauthorizedError) {
- *     // Redirect to login
- * }
- */
-export class UnauthorizedError extends AgentOsError {
-    readonly code = "UNAUTHORIZED";
-    readonly status = 401;
-
-    constructor(message = "Authentication required", options?: ErrorOptions) {
-        super(message, options);
-    }
-}
-
-/**
- * 403 Forbidden - Valid auth but insufficient permissions.
- * 
- * @example
- * if (error instanceof ForbiddenError) {
- *     showToast("You don't have permission to perform this action");
- * }
- */
-export class ForbiddenError extends AgentOsError {
-    readonly code = "FORBIDDEN";
-    readonly status = 403;
-
-    constructor(message = "Access denied", options?: ErrorOptions) {
-        super(message, options);
-    }
-}
-
-// ============================================================================
-// Resource Errors
-// ============================================================================
-
-/**
- * 404 Not Found - Resource does not exist.
- * 
- * @example
- * if (error instanceof NotFoundError) {
- *     console.log(`Not found at: ${error.path}`);
- * }
- */
-export class NotFoundError extends AgentOsError {
-    readonly code = "NOT_FOUND";
-    readonly status = 404;
-
-    constructor(
-        message = "Resource not found",
-        /** The request path that returned 404 */
-        readonly path?: string,
-        options?: ErrorOptions
-    ) {
-        super(message, options);
-    }
-}
-
-/**
- * 409 Conflict - Resource already exists or state conflict.
- * 
- * @example
- * if (error instanceof ConflictError) {
- *     // Handle duplicate or version mismatch
- * }
- */
-export class ConflictError extends AgentOsError {
-    readonly code = "CONFLICT";
-    readonly status = 409;
-
-    constructor(message = "Resource conflict", options?: ErrorOptions) {
-        super(message, options);
-    }
-}
-
-// ============================================================================
-// Validation Errors
-// ============================================================================
-
-/**
- * Field-level validation error detail.
- */
-export interface FieldError {
-    field: string;
-    message: string;
-    code?: string;
-}
-
-/**
- * 400/422 Validation Error - Invalid request data.
- * 
- * @example
- * if (error instanceof ValidationError) {
- *     error.fieldErrors?.forEach(fe => {
- *         showFieldError(fe.field, fe.message);
- *     });
- * }
- */
-export class ValidationError extends AgentOsError {
-    readonly code = "VALIDATION_ERROR";
-    readonly status: 400 | 422;
-
-    constructor(
-        message = "Validation failed",
-        status: 400 | 422 = 400,
-        readonly fieldErrors?: FieldError[],
-        options?: ErrorOptions
-    ) {
-        super(message, options);
-        this.status = status;
-    }
-
-    /** Get error message for a specific field */
-    getFieldError(field: string): string | undefined {
-        return this.fieldErrors?.find(fe => fe.field === field)?.message;
-    }
-
-    /** Check if a specific field has an error */
-    hasFieldError(field: string): boolean {
-        return this.fieldErrors?.some(fe => fe.field === field) ?? false;
-    }
-}
-
-// ============================================================================
-// Rate Limiting
-// ============================================================================
-
-/**
- * 429 Too Many Requests - Rate limit exceeded.
- * 
- * @example
- * if (error instanceof RateLimitError) {
- *     if (error.retryAfterMs) {
- *         await sleep(error.retryAfterMs);
- *         // Retry request
- *     }
- * }
- */
-export class RateLimitError extends AgentOsError {
-    readonly code = "RATE_LIMITED";
-    readonly status = 429;
-
-    constructor(
-        message = "Rate limit exceeded",
-        /** Time to wait before retrying (milliseconds) */
-        readonly retryAfterMs?: number,
-        options?: ErrorOptions
-    ) {
-        super(message, options);
-    }
-
-    isRetryable(): boolean {
-        return true;
-    }
-
-    /** Get retry delay or default */
-    getRetryDelay(defaultMs = 1000): number {
-        return this.retryAfterMs ?? defaultMs;
-    }
-}
-
-// ============================================================================
-// Server Errors
-// ============================================================================
-
-/**
- * 5xx Server Error - Backend failure.
- * 
- * @example
- * if (error instanceof ServerError) {
- *     if (error.isRetryable()) {
- *         // Retry with backoff
- *     }
- * }
- */
-export class ServerError extends AgentOsError {
-    readonly code = "SERVER_ERROR";
-
-    constructor(
-        message = "Internal server error",
-        readonly status: number = 500,
-        options?: ErrorOptions
-    ) {
-        super(message, options);
-    }
-
-    isRetryable(): boolean {
-        // 500, 502, 503, 504 are typically retryable
-        return [500, 502, 503, 504].includes(this.status);
-    }
-}
-
-// ============================================================================
-// Network & Timeout Errors
-// ============================================================================
-
-/**
- * Network Error - Fetch failed (no response received).
- * 
- * @example
- * if (error instanceof NetworkError) {
- *     showToast("Network connection failed. Check your internet.");
- * }
- */
-export class NetworkError extends AgentOsError {
-    readonly code = "NETWORK_ERROR";
-    readonly status = 0;
-
-    constructor(
-        message = "Network request failed",
-        readonly cause?: Error
-    ) {
-        super(message);
-    }
-
-    isRetryable(): boolean {
-        return true;
-    }
-}
-
-/**
- * Timeout Error - Request exceeded time limit.
- * 
- * @example
- * if (error instanceof TimeoutError) {
- *     console.log(`Request timed out after ${error.timeoutMs}ms`);
- * }
- */
-export class TimeoutError extends AgentOsError {
-    readonly code = "TIMEOUT";
-    readonly status = 0;
-
-    constructor(
-        /** Timeout duration in milliseconds */
-        readonly timeoutMs: number
-    ) {
-        super(`Request timed out after ${timeoutMs}ms`);
-    }
-
-    isRetryable(): boolean {
-        return true;
-    }
-}
-
-// ============================================================================
-// Error Type Guards
-// ============================================================================
-
-/** Check if error is any Agent OS SDK error */
-export function isAgentOsError(error: unknown): error is AgentOsError {
-    return error instanceof AgentOsError;
-}
-
-/** Check if error is retryable */
-export function isRetryableError(error: unknown): boolean {
-    if (error instanceof AgentOsError) {
-        return error.isRetryable();
-    }
-    return false;
-}
-
-/** Check if error is an auth error (401 or 403) */
-export function isAuthError(error: unknown): error is UnauthorizedError | ForbiddenError {
-    return error instanceof UnauthorizedError || error instanceof ForbiddenError;
-}
-
-/** Check if error is a client error (4xx) */
-export function isClientError(error: unknown): boolean {
-    if (error instanceof AgentOsError) {
-        return error.status >= 400 && error.status < 500;
-    }
-    return false;
-}
-
-/** Check if error is a server error (5xx) */
-export function isServerError(error: unknown): boolean {
-    if (error instanceof AgentOsError) {
-        return error.status >= 500 && error.status < 600;
-    }
-    return false;
-}

package/src/generated/client.ts

@@ -1,32 +0,0 @@
-/**
- * Agent OS SDK - 100% Auto-Generated Client
- * 
- * This client is fully generated from the OpenAPI specification.
- * NO manual types, NO manual endpoints - everything comes from swagger.json.
- */
-
-// Re-export the generated types
-export type { paths, components } from "./openapi.js";
-
-// Re-export openapi-fetch createClient
-import _createClient, { type ClientOptions as OpenapiClientOptions } from "openapi-fetch";
-import type { paths } from "./openapi.js";
-
-export type ClientOptions = OpenapiClientOptions & {
-    baseUrl: string;
-};
-
-/**
- * Create a fully typed API client.
- * All endpoints and types are auto-generated from OpenAPI spec.
- */
-export function createClient(options: ClientOptions) {
-    return _createClient<paths>(options);
-}
-
-// Type alias for the generated client
-export type AgentOsClient = ReturnType<typeof createClient>;
-
-// Convenience type for extracting schema types
-export type Schema<T extends keyof import("./openapi.js").components["schemas"]> =
-    import("./openapi.js").components["schemas"][T];

package/src/generated/index.ts

@@ -1,2 +0,0 @@
-// Auto-generated - do not edit
-export type * from "./openapi.js";