@perstack/api-client 0.0.35 → 0.0.38

package/dist/index.d.ts

@@ -0,0 +1,438 @@
+import { ZodType, z } from 'zod';
+import { Skill } from '@perstack/core';
+
+type ApiResult<T> = {
+    ok: true;
+    data: T;
+} | {
+    ok: false;
+    error: ApiError;
+};
+interface ApiError {
+    code: number;
+    message: string;
+    reason?: unknown;
+    aborted?: boolean;
+}
+interface ApiClientConfig {
+    apiKey?: string;
+    baseUrl?: string;
+    timeout?: number;
+}
+interface RequestOptions {
+    signal?: AbortSignal;
+}
+interface PaginationParams {
+    take?: number;
+    skip?: number;
+    sort?: string;
+    order?: "asc" | "desc";
+    filter?: string;
+}
+interface PaginatedResult<T> {
+    data: T[];
+    meta: {
+        total: number;
+        take: number;
+        skip: number;
+    };
+}
+
+interface Fetcher {
+    get<T>(path: string, schema: ZodType<T>, options?: RequestOptions): Promise<ApiResult<T>>;
+    post<T>(path: string, body: unknown, schema: ZodType<T>, options?: RequestOptions): Promise<ApiResult<T>>;
+    delete<T>(path: string, schema: ZodType<T>, options?: RequestOptions): Promise<ApiResult<T>>;
+    getBlob(path: string, options?: RequestOptions): Promise<ApiResult<Blob>>;
+}
+declare function createFetcher(config?: ApiClientConfig): Fetcher;
+
+declare const registryExpertStatusSchema: z.ZodEnum<{
+    deprecated: "deprecated";
+    available: "available";
+    disabled: "disabled";
+}>;
+type RegistryExpertStatus = z.infer<typeof registryExpertStatusSchema>;
+declare const ownerSchema$1: z.ZodObject<{
+    name: z.ZodOptional<z.ZodString>;
+    organizationId: z.ZodString;
+    createdAt: z.ZodPipe<z.ZodString, z.ZodTransform<Date, string>>;
+}, z.core.$strip>;
+type Owner$1 = z.infer<typeof ownerSchema$1>;
+declare const registryExpertSchema: z.ZodObject<{
+    type: z.ZodLiteral<"registryExpert">;
+    id: z.ZodString;
+    key: z.ZodString;
+    name: z.ZodString;
+    minRuntimeVersion: z.ZodLiteral<"v1.0">;
+    description: z.ZodString;
+    owner: z.ZodObject<{
+        name: z.ZodOptional<z.ZodString>;
+        organizationId: z.ZodString;
+        createdAt: z.ZodPipe<z.ZodString, z.ZodTransform<Date, string>>;
+    }, z.core.$strip>;
+    createdAt: z.ZodPipe<z.ZodString, z.ZodTransform<Date, string>>;
+    updatedAt: z.ZodPipe<z.ZodString, z.ZodTransform<Date, string>>;
+    version: z.ZodString;
+    status: z.ZodEnum<{
+        deprecated: "deprecated";
+        available: "available";
+        disabled: "disabled";
+    }>;
+    instruction: z.ZodString;
+    skills: z.ZodPipe<z.ZodRecord<z.ZodString, z.ZodUnknown>, z.ZodTransform<Record<string, Skill>, Record<string, unknown>>>;
+    delegates: z.ZodArray<z.ZodString>;
+    tags: z.ZodArray<z.ZodString>;
+}, z.core.$strip>;
+type RegistryExpert = z.infer<typeof registryExpertSchema>;
+declare const expertDigestSchema$1: z.ZodObject<{
+    type: z.ZodLiteral<"expertDigest">;
+    id: z.ZodString;
+    key: z.ZodString;
+    name: z.ZodString;
+    minRuntimeVersion: z.ZodLiteral<"v1.0">;
+    description: z.ZodString;
+    owner: z.ZodObject<{
+        name: z.ZodOptional<z.ZodString>;
+        organizationId: z.ZodString;
+        createdAt: z.ZodPipe<z.ZodString, z.ZodTransform<Date, string>>;
+    }, z.core.$strip>;
+    createdAt: z.ZodPipe<z.ZodString, z.ZodTransform<Date, string>>;
+    updatedAt: z.ZodPipe<z.ZodString, z.ZodTransform<Date, string>>;
+    version: z.ZodOptional<z.ZodString>;
+    tags: z.ZodArray<z.ZodString>;
+}, z.core.$strip>;
+type ExpertDigest$1 = z.infer<typeof expertDigestSchema$1>;
+interface CreateExpertInput {
+    name: string;
+    version: string;
+    minRuntimeVersion: "v1.0";
+    description: string;
+    instruction: string;
+    skills: Record<string, unknown>;
+    delegates?: string[];
+    tags?: string[];
+}
+interface UpdateExpertInput {
+    status?: RegistryExpertStatus;
+    tags?: string[];
+}
+interface ListExpertsParams {
+    organizationId?: string;
+    filter?: string;
+    sort?: "name" | "version" | "createdAt" | "updatedAt";
+    order?: "asc" | "desc";
+    take?: number;
+    skip?: number;
+}
+
+/**
+ * Registry Experts API
+ *
+ * @see docs/api-reference/registry-v1/experts.md
+ */
+
+interface RegistryExpertsApi {
+    get(key: string, options?: RequestOptions): Promise<ApiResult<RegistryExpert>>;
+    list(params?: ListExpertsParams, options?: RequestOptions): Promise<ApiResult<PaginatedResult<RegistryExpert>>>;
+    create(input: CreateExpertInput, options?: RequestOptions): Promise<ApiResult<RegistryExpert>>;
+    update(key: string, input: UpdateExpertInput, options?: RequestOptions): Promise<ApiResult<RegistryExpert>>;
+    delete(key: string, options?: RequestOptions): Promise<ApiResult<void>>;
+    getVersions(key: string, options?: RequestOptions): Promise<ApiResult<{
+        versions: ExpertDigest$1[];
+        latest: string;
+        total: number;
+    }>>;
+}
+declare function createRegistryExpertsApi(fetcher: Fetcher): RegistryExpertsApi;
+
+declare const applicationSchema: z.ZodObject<{
+    id: z.ZodString;
+    name: z.ZodString;
+}, z.core.$strip>;
+type Application = z.infer<typeof applicationSchema>;
+declare const ownerSchema: z.ZodObject<{
+    name: z.ZodOptional<z.ZodString>;
+    organizationId: z.ZodString;
+    createdAt: z.ZodPipe<z.ZodString, z.ZodTransform<Date, string>>;
+}, z.core.$strip>;
+type Owner = z.infer<typeof ownerSchema>;
+declare const studioExpertSchema: z.ZodObject<{
+    type: z.ZodLiteral<"studioExpert">;
+    id: z.ZodString;
+    key: z.ZodString;
+    name: z.ZodString;
+    minRuntimeVersion: z.ZodLiteral<"v1.0">;
+    description: z.ZodString;
+    owner: z.ZodObject<{
+        name: z.ZodOptional<z.ZodString>;
+        organizationId: z.ZodString;
+        createdAt: z.ZodPipe<z.ZodString, z.ZodTransform<Date, string>>;
+    }, z.core.$strip>;
+    createdAt: z.ZodPipe<z.ZodString, z.ZodTransform<Date, string>>;
+    updatedAt: z.ZodPipe<z.ZodString, z.ZodTransform<Date, string>>;
+    instruction: z.ZodString;
+    skills: z.ZodPipe<z.ZodRecord<z.ZodString, z.ZodUnknown>, z.ZodTransform<Record<string, Skill>, Record<string, unknown>>>;
+    delegates: z.ZodArray<z.ZodString>;
+    forkFrom: z.ZodOptional<z.ZodString>;
+    application: z.ZodObject<{
+        id: z.ZodString;
+        name: z.ZodString;
+    }, z.core.$strip>;
+}, z.core.$strip>;
+type StudioExpert = z.infer<typeof studioExpertSchema>;
+declare const expertDigestSchema: z.ZodObject<{
+    type: z.ZodLiteral<"expertDigest">;
+    id: z.ZodString;
+    key: z.ZodString;
+    name: z.ZodString;
+    minRuntimeVersion: z.ZodLiteral<"v1.0">;
+    description: z.ZodString;
+    owner: z.ZodObject<{
+        name: z.ZodOptional<z.ZodString>;
+        organizationId: z.ZodString;
+        createdAt: z.ZodPipe<z.ZodString, z.ZodTransform<Date, string>>;
+    }, z.core.$strip>;
+    createdAt: z.ZodPipe<z.ZodString, z.ZodTransform<Date, string>>;
+    updatedAt: z.ZodPipe<z.ZodString, z.ZodTransform<Date, string>>;
+    version: z.ZodOptional<z.ZodString>;
+    tags: z.ZodArray<z.ZodString>;
+}, z.core.$strip>;
+type ExpertDigest = z.infer<typeof expertDigestSchema>;
+interface CreateStudioExpertInput {
+    name: string;
+    minRuntimeVersion: "v1.0";
+    description: string;
+    instruction: string;
+    skills: Record<string, unknown>;
+    delegates: string[];
+    forkFrom?: string;
+}
+interface UpdateStudioExpertInput {
+    minRuntimeVersion?: "v1.0";
+    description?: string;
+    instruction?: string;
+    skills?: Record<string, unknown>;
+    delegates?: string[];
+    forkFrom?: string;
+}
+interface ListStudioExpertsParams {
+    applicationId: string;
+    filter?: string;
+    sort?: "name" | "version" | "createdAt" | "updatedAt";
+    order?: "asc" | "desc";
+    take?: number;
+    skip?: number;
+}
+declare const expertJobStatusSchema: z.ZodEnum<{
+    completed: "completed";
+    queued: "queued";
+    processing: "processing";
+    requestInteractiveToolResult: "requestInteractiveToolResult";
+    requestDelegateResult: "requestDelegateResult";
+    exceededMaxSteps: "exceededMaxSteps";
+    failed: "failed";
+    canceling: "canceling";
+    canceled: "canceled";
+    expired: "expired";
+}>;
+type ExpertJobStatus = z.infer<typeof expertJobStatusSchema>;
+declare const expertJobSchema: z.ZodObject<{
+    id: z.ZodString;
+    expertKey: z.ZodString;
+    status: z.ZodEnum<{
+        completed: "completed";
+        queued: "queued";
+        processing: "processing";
+        requestInteractiveToolResult: "requestInteractiveToolResult";
+        requestDelegateResult: "requestDelegateResult";
+        exceededMaxSteps: "exceededMaxSteps";
+        failed: "failed";
+        canceling: "canceling";
+        canceled: "canceled";
+        expired: "expired";
+    }>;
+    query: z.ZodOptional<z.ZodString>;
+    createdAt: z.ZodPipe<z.ZodString, z.ZodTransform<Date, string>>;
+    updatedAt: z.ZodPipe<z.ZodString, z.ZodTransform<Date, string>>;
+    startedAt: z.ZodOptional<z.ZodPipe<z.ZodString, z.ZodTransform<Date, string>>>;
+    completedAt: z.ZodOptional<z.ZodPipe<z.ZodString, z.ZodTransform<Date, string>>>;
+}, z.core.$strip>;
+type ExpertJob = z.infer<typeof expertJobSchema>;
+interface StartExpertJobInput {
+    expertKey: string;
+    query: string;
+    workspaceInstanceId?: string;
+}
+interface ContinueExpertJobInput {
+    response: string;
+}
+interface UpdateExpertJobInput {
+    status?: ExpertJobStatus;
+}
+interface ListExpertJobsParams {
+    applicationId: string;
+    filter?: string;
+    sort?: "createdAt" | "updatedAt" | "status";
+    order?: "asc" | "desc";
+    take?: number;
+    skip?: number;
+}
+declare const checkpointSchema: z.ZodObject<{
+    id: z.ZodString;
+    expertJobId: z.ZodString;
+    sequence: z.ZodNumber;
+    createdAt: z.ZodPipe<z.ZodString, z.ZodTransform<Date, string>>;
+}, z.core.$strip>;
+type Checkpoint = z.infer<typeof checkpointSchema>;
+interface ListCheckpointsParams {
+    take?: number;
+    skip?: number;
+    sort?: "sequence" | "createdAt";
+    order?: "asc" | "desc";
+}
+declare const workspaceInstanceSchema: z.ZodObject<{
+    id: z.ZodString;
+    expertJobId: z.ZodString;
+    createdAt: z.ZodPipe<z.ZodString, z.ZodTransform<Date, string>>;
+}, z.core.$strip>;
+type WorkspaceInstance = z.infer<typeof workspaceInstanceSchema>;
+declare const workspaceItemSchema: z.ZodObject<{
+    id: z.ZodString;
+    path: z.ZodString;
+    type: z.ZodEnum<{
+        file: "file";
+        directory: "directory";
+    }>;
+    size: z.ZodOptional<z.ZodNumber>;
+    createdAt: z.ZodPipe<z.ZodString, z.ZodTransform<Date, string>>;
+    updatedAt: z.ZodPipe<z.ZodString, z.ZodTransform<Date, string>>;
+}, z.core.$strip>;
+type WorkspaceItem = z.infer<typeof workspaceItemSchema>;
+interface ListWorkspaceItemsParams {
+    take?: number;
+    skip?: number;
+    path?: string;
+}
+declare const workspaceSchema: z.ZodObject<{
+    id: z.ZodString;
+    applicationId: z.ZodString;
+    createdAt: z.ZodPipe<z.ZodString, z.ZodTransform<Date, string>>;
+    updatedAt: z.ZodPipe<z.ZodString, z.ZodTransform<Date, string>>;
+}, z.core.$strip>;
+type Workspace = z.infer<typeof workspaceSchema>;
+declare const workspaceVariableSchema: z.ZodObject<{
+    name: z.ZodString;
+    value: z.ZodString;
+}, z.core.$strip>;
+type WorkspaceVariable = z.infer<typeof workspaceVariableSchema>;
+declare const workspaceSecretSchema: z.ZodObject<{
+    name: z.ZodString;
+}, z.core.$strip>;
+type WorkspaceSecret = z.infer<typeof workspaceSecretSchema>;
+interface CreateWorkspaceVariableInput {
+    name: string;
+    value: string;
+}
+interface UpdateWorkspaceVariableInput {
+    value: string;
+}
+interface CreateWorkspaceSecretInput {
+    name: string;
+    value: string;
+}
+
+/**
+ * Studio Expert Jobs API
+ *
+ * @see docs/api-reference/studio-v1/expert-jobs.md
+ */
+
+interface StudioExpertJobsApi {
+    get(id: string, options?: RequestOptions): Promise<ApiResult<ExpertJob>>;
+    list(params: ListExpertJobsParams, options?: RequestOptions): Promise<ApiResult<PaginatedResult<ExpertJob>>>;
+    start(input: StartExpertJobInput, options?: RequestOptions): Promise<ApiResult<ExpertJob>>;
+    continue(id: string, input: ContinueExpertJobInput, options?: RequestOptions): Promise<ApiResult<ExpertJob>>;
+    update(id: string, input: UpdateExpertJobInput, options?: RequestOptions): Promise<ApiResult<ExpertJob>>;
+    checkpoints: CheckpointsApi;
+    workspaceInstance: WorkspaceInstanceApi;
+}
+interface CheckpointsApi {
+    get(jobId: string, checkpointId: string, options?: RequestOptions): Promise<ApiResult<Checkpoint>>;
+    list(jobId: string, params?: ListCheckpointsParams, options?: RequestOptions): Promise<ApiResult<PaginatedResult<Checkpoint>>>;
+    create(jobId: string, options?: RequestOptions): Promise<ApiResult<Checkpoint>>;
+}
+interface WorkspaceInstanceApi {
+    get(jobId: string, options?: RequestOptions): Promise<ApiResult<WorkspaceInstance>>;
+    items: WorkspaceInstanceItemsApi;
+}
+interface WorkspaceInstanceItemsApi {
+    get(jobId: string, itemId: string, options?: RequestOptions): Promise<ApiResult<WorkspaceItem>>;
+    list(jobId: string, params?: ListWorkspaceItemsParams, options?: RequestOptions): Promise<ApiResult<PaginatedResult<WorkspaceItem>>>;
+    create(jobId: string, path: string, content: Blob, options?: RequestOptions): Promise<ApiResult<WorkspaceItem>>;
+    update(jobId: string, itemId: string, content: Blob, options?: RequestOptions): Promise<ApiResult<WorkspaceItem>>;
+    delete(jobId: string, itemId: string, options?: RequestOptions): Promise<ApiResult<void>>;
+    download(jobId: string, itemId: string, options?: RequestOptions): Promise<ApiResult<Blob>>;
+    find(jobId: string, pattern: string, options?: RequestOptions): Promise<ApiResult<WorkspaceItem[]>>;
+}
+declare function createStudioExpertJobsApi(fetcher: Fetcher): StudioExpertJobsApi;
+
+/**
+ * Studio Experts API
+ *
+ * @see docs/api-reference/studio-v1/experts.md
+ */
+
+interface StudioExpertsApi {
+    get(key: string, options?: RequestOptions): Promise<ApiResult<StudioExpert>>;
+    list(params: ListStudioExpertsParams, options?: RequestOptions): Promise<ApiResult<PaginatedResult<ExpertDigest>>>;
+    create(input: CreateStudioExpertInput, options?: RequestOptions): Promise<ApiResult<StudioExpert>>;
+    update(key: string, input: UpdateStudioExpertInput, options?: RequestOptions): Promise<ApiResult<StudioExpert>>;
+    delete(key: string, options?: RequestOptions): Promise<ApiResult<void>>;
+}
+declare function createStudioExpertsApi(fetcher: Fetcher): StudioExpertsApi;
+
+/**
+ * Studio Workspace API
+ *
+ * @see docs/api-reference/studio-v1/workspace.md
+ */
+
+interface StudioWorkspaceApi {
+    get(options?: RequestOptions): Promise<ApiResult<Workspace>>;
+    items: WorkspaceItemsApi;
+    variables: WorkspaceVariablesApi;
+    secrets: WorkspaceSecretsApi;
+}
+interface WorkspaceItemsApi {
+    get(itemId: string, options?: RequestOptions): Promise<ApiResult<WorkspaceItem>>;
+    list(params?: ListWorkspaceItemsParams, options?: RequestOptions): Promise<ApiResult<PaginatedResult<WorkspaceItem>>>;
+    create(path: string, content: Blob, options?: RequestOptions): Promise<ApiResult<WorkspaceItem>>;
+    update(itemId: string, content: Blob, options?: RequestOptions): Promise<ApiResult<WorkspaceItem>>;
+    delete(itemId: string, options?: RequestOptions): Promise<ApiResult<void>>;
+    download(itemId: string, options?: RequestOptions): Promise<ApiResult<Blob>>;
+    find(pattern: string, options?: RequestOptions): Promise<ApiResult<WorkspaceItem[]>>;
+}
+interface WorkspaceVariablesApi {
+    create(input: CreateWorkspaceVariableInput, options?: RequestOptions): Promise<ApiResult<WorkspaceVariable>>;
+    update(name: string, input: UpdateWorkspaceVariableInput, options?: RequestOptions): Promise<ApiResult<WorkspaceVariable>>;
+    delete(name: string, options?: RequestOptions): Promise<ApiResult<void>>;
+}
+interface WorkspaceSecretsApi {
+    create(input: CreateWorkspaceSecretInput, options?: RequestOptions): Promise<ApiResult<WorkspaceSecret>>;
+    delete(name: string, options?: RequestOptions): Promise<ApiResult<void>>;
+}
+declare function createStudioWorkspaceApi(fetcher: Fetcher): StudioWorkspaceApi;
+
+interface ApiClient {
+    registry: {
+        experts: RegistryExpertsApi;
+    };
+    studio: {
+        experts: StudioExpertsApi;
+        expertJobs: StudioExpertJobsApi;
+        workspace: StudioWorkspaceApi;
+    };
+}
+declare function createApiClient(config?: ApiClientConfig): ApiClient;
+
+export { type ApiClient, type ApiClientConfig, type ApiError, type ApiResult, type Application, type Checkpoint, type CheckpointsApi, type ContinueExpertJobInput, type CreateExpertInput, type CreateStudioExpertInput, type CreateWorkspaceSecretInput, type CreateWorkspaceVariableInput, type ExpertDigest, type ExpertJob, type ExpertJobStatus, type Fetcher, type ListCheckpointsParams, type ListExpertJobsParams, type ListExpertsParams, type ListStudioExpertsParams, type ListWorkspaceItemsParams, type Owner, type PaginatedResult, type PaginationParams, type RegistryExpert, type ExpertDigest$1 as RegistryExpertDigest, type RegistryExpertStatus, type RegistryExpertsApi, type Owner$1 as RegistryOwner, type RequestOptions, type StartExpertJobInput, type StudioExpert, type StudioExpertJobsApi, type StudioExpertsApi, type StudioWorkspaceApi, type UpdateExpertInput, type UpdateExpertJobInput, type UpdateStudioExpertInput, type UpdateWorkspaceVariableInput, type Workspace, type WorkspaceInstance, type WorkspaceInstanceApi, type WorkspaceInstanceItemsApi, type WorkspaceItem, type WorkspaceItemsApi, type WorkspaceSecret, type WorkspaceSecretsApi, type WorkspaceVariable, type WorkspaceVariablesApi, createApiClient, createFetcher, createRegistryExpertsApi, createStudioExpertJobsApi, createStudioExpertsApi, createStudioWorkspaceApi };