@agent-os-sdk/client 0.9.25 → 0.9.27

package/src/modules/files.ts

@@ -1,208 +0,0 @@
-/**
- * Files Module - Fully Typed
- */
-
-import type { RawClient, APIResponse, components } from "../client/raw.js";
-
-type FileListItem = components["schemas"]["FileListItem"];
-type FileDetail = components["schemas"]["FileDetail"];
-type CreatePresignedUploadRequest = components["schemas"]["CreatePresignedUploadRequest"];
-type PresignedUploadResponse = components["schemas"]["PresignedUploadResponse"];
-type ConfirmUploadRequest = components["schemas"]["ConfirmUploadRequest"];
-type FileConfirmResponse = components["schemas"]["FileConfirmResponse"];
-type PresignedDownloadResponse = components["schemas"]["PresignedDownloadResponse"];
-
-export interface StoredFile {
-    id: string;
-    filename: string;
-    content_type: string;
-    size_bytes: number;
-    sha256?: string;
-    status: "pending" | "confirmed" | "deleted";
-    created_at: string;
-    updated_at?: string;
-}
-
-export interface FileListResponse {
-    items: StoredFile[];
-    total: number;
-}
-
-export interface PresignedUpload {
-    file_id: string;
-    upload_url: string;
-    expires_in: number;
-    object_key: string;
-}
-
-export interface ConfirmedUpload {
-    file_id: string;
-    status: string;
-    size_bytes: number;
-    sha256?: string;
-}
-
-export interface PresignedDownload {
-    file_id: string;
-    download_url: string;
-    filename: string;
-    content_type: string;
-    size_bytes: number;
-    expires_in: number;
-}
-
-export class FilesModule {
-    constructor(private client: RawClient, private headers: () => Record<string, string>) { }
-
-    private resolveWorkspaceId(workspaceId?: string): string {
-        if (workspaceId && workspaceId.trim().length > 0) {
-            return workspaceId.trim();
-        }
-
-        const headers = this.headers();
-        const fromHeader = headers["X-Workspace-Id"] ?? headers["x-workspace-id"];
-        if (fromHeader && fromHeader.trim().length > 0) {
-            return fromHeader.trim();
-        }
-
-        throw new Error("workspace_id is required (pass workspaceId or set X-Workspace-Id in client headers)");
-    }
-
-    private static toStoredFile(item: FileListItem | FileDetail): StoredFile {
-        return {
-            id: item.id ?? "",
-            filename: item.filename ?? "",
-            content_type: item.content_type ?? "application/octet-stream",
-            size_bytes: item.size_bytes ?? 0,
-            sha256: "sha256" in item ? item.sha256 ?? undefined : undefined,
-            status: (item.status ?? "pending") as StoredFile["status"],
-            created_at: item.created_at ?? "",
-            updated_at: "updated_at" in item ? item.updated_at ?? undefined : undefined,
-        };
-    }
-
-    /**
-     * List files in a workspace.
-     */
-    async list(params?: {
-        workspace_id?: string;
-        status?: string;
-        limit?: number;
-        offset?: number;
-    }): Promise<APIResponse<FileListResponse>> {
-        const workspaceId = this.resolveWorkspaceId(params?.workspace_id);
-        const response = await this.client.GET<FileListItem[]>("/v1/api/workspaces/{workspaceId}/files", {
-            params: {
-                path: { workspaceId },
-                query: {
-                    status: params?.status,
-                    limit: params?.limit,
-                    offset: params?.offset,
-                },
-            },
-            headers: this.headers(),
-        });
-
-        const items = Array.isArray(response.data)
-            ? response.data.map((item) => FilesModule.toStoredFile(item))
-            : [];
-
-        return {
-            ...response,
-            data: {
-                items,
-                total: items.length,
-            },
-        };
-    }
-
-    /**
-     * Get a file by ID.
-     */
-    async get(fileId: string, workspaceId?: string): Promise<APIResponse<StoredFile>> {
-        const resolvedWorkspaceId = this.resolveWorkspaceId(workspaceId);
-        const response = await this.client.GET<FileDetail>("/v1/api/workspaces/{workspaceId}/files/{fileId}", {
-            params: { path: { workspaceId: resolvedWorkspaceId, fileId } },
-            headers: this.headers(),
-        });
-
-        if (!response.data) {
-            return response as APIResponse<StoredFile>;
-        }
-
-        return {
-            ...response,
-            data: FilesModule.toStoredFile(response.data),
-        };
-    }
-
-    /**
-     * Create a presigned upload URL.
-     */
-    async createUpload(body: {
-        filename: string;
-        content_type?: string;
-        size_bytes?: number;
-        expected_sha256?: string;
-    }, workspaceId?: string): Promise<APIResponse<PresignedUpload>> {
-        const resolvedWorkspaceId = this.resolveWorkspaceId(workspaceId);
-        const requestBody: CreatePresignedUploadRequest = {
-            filename: body.filename,
-            content_type: body.content_type,
-            size_bytes: body.size_bytes,
-            expected_sha256: body.expected_sha256,
-        };
-        return this.client.POST<PresignedUploadResponse>("/v1/api/workspaces/{workspaceId}/files/presign", {
-            params: { path: { workspaceId: resolvedWorkspaceId } },
-            body: requestBody,
-            headers: this.headers(),
-        }) as Promise<APIResponse<PresignedUpload>>;
-    }
-
-    /**
-     * Confirm an upload.
-     */
-    async confirmUpload(fileId: string, sha256?: string, workspaceId?: string): Promise<APIResponse<ConfirmedUpload>> {
-        const resolvedWorkspaceId = this.resolveWorkspaceId(workspaceId);
-        const requestBody: ConfirmUploadRequest = { sha256 };
-        return this.client.POST<FileConfirmResponse>("/v1/api/workspaces/{workspaceId}/files/{fileId}/confirm", {
-            params: { path: { workspaceId: resolvedWorkspaceId, fileId } },
-            body: requestBody,
-            headers: this.headers(),
-        }) as Promise<APIResponse<ConfirmedUpload>>;
-    }
-
-    /**
-     * Get a presigned download URL.
-     */
-    async getDownloadUrl(fileId: string, workspaceId?: string): Promise<APIResponse<PresignedDownload>> {
-        const resolvedWorkspaceId = this.resolveWorkspaceId(workspaceId);
-        return this.client.GET<PresignedDownloadResponse>("/v1/api/workspaces/{workspaceId}/files/{fileId}/download", {
-            params: { path: { workspaceId: resolvedWorkspaceId, fileId } },
-            headers: this.headers(),
-        }) as Promise<APIResponse<PresignedDownload>>;
-    }
-
-    /**
-     * Delete a file.
-     */
-    async delete(fileId: string, workspaceId?: string): Promise<APIResponse<void>> {
-        const resolvedWorkspaceId = this.resolveWorkspaceId(workspaceId);
-        return this.client.DELETE<void>("/v1/api/workspaces/{workspaceId}/files/{fileId}", {
-            params: { path: { workspaceId: resolvedWorkspaceId, fileId } },
-            headers: this.headers(),
-        });
-    }
-
-    /**
-     * Alias for createUpload with explicit semantic name.
-     */
-    async createPresignedUpload(body: {
-        filename: string;
-        content_type?: string;
-        size_bytes?: number;
-        expected_sha256?: string;
-    }, workspaceId?: string): Promise<APIResponse<PresignedUpload>> {
-        return this.createUpload(body, workspaceId);
-    }
-}

package/src/modules/improvements.ts

@@ -1,71 +0,0 @@
-import type { APIResponse, RawClient } from "../client/raw.js";
-
-export interface ImprovementCase {
-    id: string;
-    tenant_id: string;
-    workspace_id: string;
-    agent_id: string;
-    champion_bundle_id: string;
-    challenger_bundle_id: string;
-    eval_experiment_id?: string | null;
-    status: string;
-    trigger_kind: string;
-    improvement_policy_ref?: string | null;
-    summary?: string | null;
-    decision_comparison_id?: string | null;
-    approval_decision_reason?: string | null;
-    promotion_decision_reason?: string | null;
-    rejection_reason?: string | null;
-    rollback_reason?: string | null;
-    rollback_decision_comparison_id?: string | null;
-    rollback_source_bundle_id?: string | null;
-    rollback_target_bundle_id?: string | null;
-    created_by?: string | null;
-    approved_by?: string | null;
-    promoted_by?: string | null;
-    rejected_by?: string | null;
-    rolled_back_by?: string | null;
-    created_at: string;
-    updated_at: string;
-    approved_at?: string | null;
-    promoted_at?: string | null;
-    rejected_at?: string | null;
-    rolled_back_at?: string | null;
-}
-
-export interface ImprovementCaseListResponse {
-    items: ImprovementCase[];
-    total: number;
-    skip: number;
-    take: number;
-}
-
-export class ImprovementsModule {
-    constructor(private client: RawClient, private headers: () => Record<string, string>) {}
-
-    async list(params?: {
-        agentId?: string;
-        status?: string;
-        skip?: number;
-        take?: number;
-    }): Promise<APIResponse<ImprovementCaseListResponse>> {
-        return this.client.GET<ImprovementCaseListResponse>("/v1/api/improvements/cases", {
-            params: {
-                query: {
-                    agentId: params?.agentId,
-                    status: params?.status,
-                    skip: params?.skip,
-                    take: params?.take,
-                },
-            },
-            headers: this.headers(),
-        });
-    }
-
-    async get(caseId: string): Promise<APIResponse<ImprovementCase>> {
-        return this.client.GET<ImprovementCase>("/v1/api/improvements/cases/{caseId}", {
-            params: { path: { caseId } },
-            headers: this.headers(),
-        });
-    }
-}

package/src/modules/info.ts

@@ -1,143 +0,0 @@
-/**
- * Info Module - Fully Typed
- */
-
-import type { RawClient, APIResponse } from "../client/raw.js";
-
-export interface ServerInfo {
-    name: string;
-    version: string;
-    environment: string;
-    features?: string[];
-    uptime_seconds?: number;
-    commit_hash?: string;
-    api_version?: string;
-}
-
-/** Normalized server capabilities (camelCase, with defaults) */
-export interface ServerCapabilities {
-    /** Server version */
-    version?: string;
-    /** Git commit hash */
-    commitHash?: string;
-    /** API version */
-    apiVersion?: string;
-    /** Environment (production, staging, development) */
-    environment?: string;
-    /** Feature flags - all default to false if not present */
-    features: {
-        sseResume: boolean;
-        cronTriggers: boolean;
-        batchRuns: boolean;
-        hitl: boolean;
-        traces: boolean;
-        vectorStores: boolean;
-        evaluations: boolean;
-        [key: string]: boolean;
-    };
-    /** Server limits */
-    limits?: {
-        maxBatchSize?: number;
-        maxFileSize?: number;
-        [key: string]: number | undefined;
-    };
-    /** SDK version that fetched this (useful for support) */
-    sdkVersion: string;
-}
-
-// SDK version from package (will be replaced at build time or use constant)
-const SDK_VERSION = "0.4.0";
-
-export class InfoModule {
-    constructor(private client: RawClient, private headers: () => Record<string, string>) { }
-
-    /**
-     * Get server information.
-     */
-    async get(): Promise<APIResponse<ServerInfo>> {
-        return this.client.GET<ServerInfo>("/v1/info", {
-            headers: this.headers(),
-        });
-    }
-
-    /**
-     * Health check endpoint.
-     */
-    async health(): Promise<APIResponse<{ status: string }>> {
-        return this.client.GET<{ status: string }>("/health", {
-            headers: this.headers(),
-        });
-    }
-
-    /**
-     * Get normalized server capabilities for feature detection.
-     * 
-     * This method never assumes feature availability - all features
-     * default to false unless explicitly enabled by the server.
-     * 
-     * @example
-     * ```ts
-     * const caps = await client.info.capabilities();
-     * if (caps.data?.features.sseResume) {
-     *     // Use follow() with resume
-     * } else {
-     *     // Fall back to polling
-     * }
-     * ```
-     */
-    async capabilities(): Promise<APIResponse<ServerCapabilities>> {
-        const response = await this.get();
-
-        if (response.error || !response.data) {
-            // Pass through error - construct proper response without data
-            return {
-                error: response.error,
-                response: response.response,
-                meta: response.meta,
-            };
-        }
-
-        const info = response.data;
-
-        // Transform snake_case features array to camelCase object
-        // CRITICAL: Never assume true - default everything to false
-        const featureArray = info.features ?? [];
-        const features: ServerCapabilities["features"] = {
-            sseResume: featureArray.includes("sse_resume"),
-            cronTriggers: featureArray.includes("cron_triggers"),
-            batchRuns: featureArray.includes("batch_runs"),
-            hitl: featureArray.includes("hitl"),
-            traces: featureArray.includes("traces"),
-            vectorStores: featureArray.includes("vector_stores"),
-            evaluations: featureArray.includes("evaluations"),
-        };
-
-        // Add any other features from array as snake_case → camelCase
-        for (const feature of featureArray) {
-            const camelCase = snakeToCamel(feature);
-            if (!(camelCase in features)) {
-                features[camelCase] = true;
-            }
-        }
-
-        const capabilities: ServerCapabilities = {
-            version: info.version,
-            commitHash: info.commit_hash,
-            apiVersion: info.api_version,
-            environment: info.environment,
-            features,
-            sdkVersion: SDK_VERSION,
-        };
-
-        return {
-            data: capabilities,
-            response: response.response,
-            meta: response.meta,
-        };
-    }
-}
-
-/** Convert snake_case to camelCase */
-function snakeToCamel(str: string): string {
-    return str.replace(/_([a-z])/g, (_, letter) => letter.toUpperCase());
-}

package/src/modules/me.ts

@@ -1,74 +0,0 @@
-/**
- * Me Module - Identity & Context
- */
-
-import type { RawClient, APIResponse } from "../client/raw.js";
-
-// ── Lightweight identity (GET /me) ──────────────────────────────
-
-export interface MeResponse {
-    user_id: string;
-    email: string;
-    display_name?: string;
-    avatar_url?: string;
-    member_id?: string;
-    tenant_id?: string;
-    workspaces?: {
-        id: string;
-        name: string;
-        role: string;
-    }[];
-}
-
-// ── Full context (GET /me/context) ──────────────────────────────
-
-export interface UserContextResponse {
-    user: {
-        id: string;
-        email: string;
-    };
-    memberships: MembershipContext[];
-}
-
-export interface MembershipContext {
-    member_id: string;
-    tenant: {
-        id: string;
-        name: string;
-        slug: string;
-    };
-    role: {
-        id: string;
-        name: string;
-        is_system: boolean;
-        permissions: string[];
-    };
-    workspaces: {
-        id: string;
-        name: string;
-        slug: string;
-    }[];
-}
-
-export class MeModule {
-    constructor(private client: RawClient, private headers: () => Record<string, string>) { }
-
-    /**
-     * Get current user information (lightweight, backward compatible).
-     */
-    async get(): Promise<APIResponse<MeResponse>> {
-        return this.client.GET<MeResponse>("/v1/api/me", {
-            headers: this.headers(),
-        });
-    }
-
-    /**
-     * Get full user context: all tenants, workspaces, roles, and permissions.
-     * This is the canonical endpoint for populating frontend layouts.
-     */
-    async getContext(): Promise<APIResponse<UserContextResponse>> {
-        return this.client.GET<UserContextResponse>("/v1/api/me/context", {
-            headers: this.headers(),
-        });
-    }
-}

package/src/modules/members.ts

@@ -1,199 +0,0 @@
-/**
- * Members Module - Fully Typed
- * 
- * Naming conventions:
- * - get* for singular items
- * - list* for collections
- * - create*, update*, delete* for mutations (NOT remove!)
- */
-
-import type { PaginatedResponse, PaginationParams } from "../client/helpers.js";
-import type { APIResponse, RawClient } from "../client/raw.js";
-
-export interface Member {
-    id: string;
-    tenant_id: string;
-    user_id?: string;
-    email?: string;
-    display_name?: string;
-    avatar_url?: string;
-    role_id?: string;
-    role_name?: string;
-    workspace_ids?: string[];
-    status: "active" | "pending" | "disabled";
-    created_at: string;
-    updated_at: string;
-}
-
-export interface Role {
-    id: string;
-    name: string;
-    is_system: boolean;
-    permissions?: string[];
-    created_at?: string;
-    members_count?: number;
-}
-
-export interface MemberInviteResponse {
-    member_id: string;
-    invite_token?: string;
-    email: string;
-}
-
-export type MemberListResponse = PaginatedResponse<Member>;
-
-export class MembersModule {
-    constructor(private client: RawClient, private headers: () => Record<string, string>) { }
-
-    /**
-     * List all members in the tenant.
-     */
-    async list(params?: PaginationParams & {
-        workspace_id?: string;
-        role_id?: string;
-        status?: string;
-    }): Promise<APIResponse<MemberListResponse>> {
-        return this.client.GET<MemberListResponse>("/v1/api/members", {
-            params: { query: params },
-            headers: this.headers(),
-        });
-    }
-
-    /**
-     * Get a member by ID.
-     */
-    async get(memberId: string): Promise<APIResponse<Member>> {
-        return this.client.GET<Member>("/v1/api/members/{id}", {
-            params: { path: { id: memberId } },
-            headers: this.headers(),
-        });
-    }
-
-
-    /**
-     * List all roles in the tenant.
-     */
-    async listRoles(): Promise<APIResponse<{ items: Role[] }>> {
-        return this.client.GET<{ items: Role[] }>("/v1/api/roles", {
-            headers: this.headers(),
-        });
-    }
-
-    /**
-     * Get a role by ID.
-     */
-    async getRole(roleId: string): Promise<APIResponse<Role>> {
-        return this.client.GET<Role>("/v1/api/roles/{id}", {
-            params: { path: { id: roleId } },
-            headers: this.headers(),
-        });
-    }
-
-    /**
-     * Create a new custom role.
-     */
-    async createRole(body: { name: string; permissions?: string[] }): Promise<APIResponse<Role>> {
-        return this.client.POST<Role>("/v1/api/roles", {
-            body,
-            headers: this.headers(),
-        });
-    }
-
-    /**
-     * Update a custom role.
-     */
-    async updateRole(roleId: string, body: { name?: string; permissions?: string[] }): Promise<APIResponse<Role>> {
-        return this.client.PUT<Role>("/v1/api/roles/{id}", {
-            params: { path: { id: roleId } },
-            body,
-            headers: this.headers(),
-        });
-    }
-
-    /**
-     * Delete a custom role.
-     */
-    async deleteRole(roleId: string): Promise<APIResponse<void>> {
-        return this.client.DELETE<void>("/v1/api/roles/{id}", {
-            params: { path: { id: roleId } },
-            headers: this.headers(),
-        });
-    }
-
-    /**
-     * List all available system permissions.
-     */
-    async listPermissions(): Promise<APIResponse<{ items: string[] }>> {
-        return this.client.GET<{ items: string[] }>("/v1/api/roles/permissions", {
-            headers: this.headers(),
-        });
-    }
-
-    /**
-     * Invite a new member.
-     */
-    async invite(body: {
-        email: string;
-        role_id?: string;
-        workspace_ids?: string[];
-    }): Promise<APIResponse<MemberInviteResponse>> {
-        return this.client.POST<MemberInviteResponse>("/v1/api/members/invite", {
-            body,
-            headers: this.headers(),
-        });
-    }
-
-    /**
-     * Update a member.
-     */
-    async update(memberId: string, body: {
-        role_id?: string;
-        workspace_ids?: string[];
-    }): Promise<APIResponse<Member>> {
-        return this.client.PUT<Member>("/v1/api/members/{id}", {
-            params: { path: { id: memberId } },
-            body,
-            headers: this.headers(),
-        });
-    }
-
-    /**
-     * Remove a member from the tenant.
-     */
-    async delete(memberId: string): Promise<APIResponse<void>> {
-        return this.client.DELETE<void>("/v1/api/members/{id}", {
-            params: { path: { id: memberId } },
-            headers: this.headers(),
-        });
-    }
-
-    /**
-     * Resend invitation email.
-     */
-    async resendInvite(memberId: string): Promise<APIResponse<void>> {
-        return this.client.POST<void>("/v1/api/members/{id}/resend-invite", {
-            params: { path: { id: memberId } },
-            headers: this.headers(),
-        });
-    }
-
-    /**
-     * Ensure membership exists (auto-create on first access).
-     * This is used by the frontend for onboarding.
-     */
-    async ensure(tenantId?: string): Promise<APIResponse<Member>> {
-        return this.client.POST<Member>("/v1/api/memberships/ensure", {
-            body: { tenant_id: tenantId ?? null },
-            headers: this.headers(),
-        });
-    }
-
-    /**
-     * Seed default permissions (Dev only)
-     */
-    async seedDefaults(): Promise<APIResponse<{ message: string }>> {
-        return this.client.POST<{ message: string }>("/v1/api/roles/seed-defaults", {
-            headers: this.headers(),
-        });
-    }
-}