@agent-os-sdk/client 0.9.26 → 0.9.28

package/src/modules/crons.ts

@@ -1,115 +0,0 @@
-/**
- * Crons Module - Fully Typed
- */
-
-import type { RawClient, APIResponse, components } from "../client/raw.js";
-
-type CreateCronJobRequest = components["schemas"]["CreateCronJobRequest"];
-type UpdateCronJobRequest = components["schemas"]["UpdateCronJobRequest"];
-
-export interface CronJob {
-    id: string;
-    workspace_id: string;
-    agent_id: string;
-    agent_version_id?: string;
-    schedule: string;
-    input?: unknown;
-    enabled: boolean;
-    last_run_at?: string;
-    next_run_at?: string;
-    created_at: string;
-    updated_at: string;
-}
-
-export interface CronJobListResponse {
-    items: CronJob[];
-    total: number;
-}
-
-export interface CronTriggerResponse {
-    run_id: string;
-    triggered_at: string;
-}
-
-export class CronsModule {
-    constructor(private client: RawClient, private headers: () => Record<string, string>) { }
-
-    /**
-     * List all cron jobs.
-     */
-    async list(params?: {
-        workspace_id?: string;
-        agent_id?: string;
-        enabled?: boolean;
-        limit?: number;
-        offset?: number;
-    }): Promise<APIResponse<CronJobListResponse>> {
-        return this.client.GET<CronJobListResponse>("/v1/api/crons", {
-            params: { query: params },
-            headers: this.headers(),
-        });
-    }
-
-    /**
-     * Get a cron job by ID.
-     */
-    async get(cronId: string): Promise<APIResponse<CronJob>> {
-        return this.client.GET<CronJob>("/v1/api/crons/{id}", {
-            params: { path: { id: cronId } },
-            headers: this.headers(),
-        });
-    }
-
-    /**
-     * Create a new cron job.
-     */
-    async create(body: {
-        workspace_id?: string;
-        agent_id: string;
-        agent_version_id?: string;
-        schedule: string;
-        input?: unknown;
-        enabled?: boolean;
-    }): Promise<APIResponse<CronJob>> {
-        return this.client.POST<CronJob>("/v1/api/crons", {
-            body,
-            headers: this.headers(),
-        });
-    }
-
-    /**
-     * Update a cron job.
-     * Uses PATCH per backend CronsController.
-     */
-    async update(cronId: string, body: {
-        schedule?: string;
-        enabled?: boolean;
-        input?: unknown;
-    }): Promise<APIResponse<CronJob>> {
-        return this.client.PATCH<CronJob>("/v1/api/crons/{id}", {
-            params: { path: { id: cronId } },
-            body,
-            headers: this.headers(),
-        });
-    }
-
-    /**
-     * Delete a cron job.
-     */
-    async delete(cronId: string): Promise<APIResponse<void>> {
-        return this.client.DELETE<void>("/v1/api/crons/{id}", {
-            params: { path: { id: cronId } },
-            headers: this.headers(),
-        });
-    }
-
-    /**
-     * Manually trigger a cron job.
-     */
-    async trigger(cronId: string): Promise<APIResponse<CronTriggerResponse>> {
-        return this.client.POST<CronTriggerResponse>("/v1/api/crons/{id}/trigger", {
-            params: { path: { id: cronId } },
-            headers: this.headers(),
-        });
-    }
-}

package/src/modules/datasets.ts

@@ -1,142 +0,0 @@
-/**
- * Datasets Module — Evaluation datasets and examples.
- * 
- * Endpoints: /v1/api/datasets
- */
-
-import type { RawClient, APIResponse } from "../client/raw.js";
-
-// =============================================================================
-// Types
-// =============================================================================
-
-export interface Dataset {
-    id: string;
-    name: string;
-    description?: string;
-    agent_id?: string;
-    example_count: number;
-    created_at: string;
-    updated_at: string;
-}
-
-export interface DatasetExample {
-    id: string;
-    dataset_id: string;
-    input: unknown;
-    expected_output?: unknown;
-    metadata?: unknown;
-    created_at: string;
-}
-
-export interface ExampleInput {
-    input: unknown;
-    expected_output?: unknown;
-    metadata?: unknown;
-}
-
-// =============================================================================
-// Module
-// =============================================================================
-
-export class DatasetsModule {
-    constructor(private client: RawClient, private headers: () => Record<string, string>) { }
-
-    /**
-     * List datasets in the workspace.
-     */
-    async list(params?: {
-        skip?: number;
-        take?: number;
-    }): Promise<APIResponse<Dataset[]>> {
-        return this.client.GET<Dataset[]>("/v1/api/datasets", {
-            params: { query: params },
-            headers: this.headers(),
-        });
-    }
-
-    /**
-     * Get a specific dataset by ID.
-     */
-    async get(datasetId: string): Promise<APIResponse<Dataset>> {
-        return this.client.GET<Dataset>("/v1/api/datasets/{id}", {
-            params: { path: { id: datasetId } },
-            headers: this.headers(),
-        });
-    }
-
-    /**
-     * Create a new evaluation dataset.
-     */
-    async create(body: {
-        name: string;
-        description?: string;
-        agent_id?: string;
-    }): Promise<APIResponse<Dataset>> {
-        return this.client.POST<Dataset>("/v1/api/datasets", {
-            body,
-            headers: this.headers(),
-        });
-    }
-
-    /**
-     * Update a dataset (partial update).
-     */
-    async update(datasetId: string, body: {
-        name?: string;
-        description?: string;
-        agent_id?: string;
-    }): Promise<APIResponse<Dataset>> {
-        return this.client.PATCH<Dataset>("/v1/api/datasets/{id}", {
-            params: { path: { id: datasetId } },
-            body,
-            headers: this.headers(),
-        });
-    }
-
-    /**
-     * Soft delete a dataset.
-     */
-    async delete(datasetId: string): Promise<APIResponse<void>> {
-        return this.client.DELETE<void>("/v1/api/datasets/{id}", {
-            params: { path: { id: datasetId } },
-            headers: this.headers(),
-        });
-    }
-
-    // ======================== Examples ========================
-
-    /**
-     * List examples for a dataset.
-     */
-    async listExamples(datasetId: string, params?: {
-        skip?: number;
-        take?: number;
-    }): Promise<APIResponse<DatasetExample[]>> {
-        return this.client.GET<DatasetExample[]>("/v1/api/datasets/{id}/examples", {
-            params: { path: { id: datasetId }, query: params },
-            headers: this.headers(),
-        });
-    }
-
-    /**
-     * Add examples to a dataset (batch).
-     */
-    async addExamples(datasetId: string, examples: ExampleInput[]): Promise<APIResponse<DatasetExample[]>> {
-        return this.client.POST<DatasetExample[]>("/v1/api/datasets/{id}/examples", {
-            params: { path: { id: datasetId } },
-            body: { examples },
-            headers: this.headers(),
-        });
-    }
-
-    /**
-     * Delete a specific example.
-     */
-    async deleteExample(datasetId: string, exampleId: string): Promise<APIResponse<void>> {
-        return this.client.DELETE<void>("/v1/api/datasets/{id}/examples/{exampleId}", {
-            params: { path: { id: datasetId, exampleId } },
-            headers: this.headers(),
-        });
-    }
-}

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/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(),
-        });
-    }
-}

package/src/modules/memberships.ts

@@ -1,42 +0,0 @@
-
-import type { RawClient, APIResponse } from "../client/raw.js";
-
-export interface MembershipResponse {
-    id: string;
-    user_id: string;
-    tenant_id: string;
-    role_id: string;
-    role_name?: string;
-    workspace_id?: string;
-    workspace_name?: string;
-    created_at: string;
-}
-
-export interface EnsureMembershipRequest {
-    tenant_id?: string;
-    workspace_id?: string;
-}
-
-export class MembershipsModule {
-    private client: RawClient;
-
-    constructor(client: RawClient) {
-        this.client = client;
-    }
-
-    private headers() {
-        return {
-            "Content-Type": "application/json",
-        };
-    }
-
-    /**
-     * Ensure the current user has a membership in a tenant (self-provisioning).
-     */
-    async ensure(body: EnsureMembershipRequest): Promise<APIResponse<MembershipResponse>> {
-        return this.client.POST<MembershipResponse>("/v1/api/memberships/ensure", {
-            body,
-            headers: this.headers(),
-        });
-    }
-}