agentstack-sdk 0.5.1-rc2 → 0.5.2-rc2

package/src/client/api/files/api.ts

@@ -0,0 +1,65 @@
+/**
+ * Copyright 2025 © BeeAI a Series of LF Projects, LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+
+import type { CallApi } from '../core/types';
+import { ApiMethod } from '../core/types';
+import {
+  createFileResponseSchema,
+  deleteFileResponseSchema,
+  readFileContentResponseSchema,
+  readFileResponseSchema,
+} from './schemas';
+import type { CreateFileRequest, DeleteFileRequest, ReadFileContentRequest, ReadFileRequest } from './types';
+
+export function createFilesApi(callApi: CallApi) {
+  const createFile = ({ context_id, file }: CreateFileRequest) => {
+    const body = new FormData();
+
+    if (file instanceof File) {
+      body.append('file', file);
+    } else {
+      body.append('file', file.blob, file.filename);
+    }
+
+    return callApi({
+      method: ApiMethod.Post,
+      path: '/api/v1/files',
+      schema: createFileResponseSchema,
+      query: { context_id },
+      body,
+    });
+  };
+
+  const readFile = ({ context_id, file_id }: ReadFileRequest) =>
+    callApi({
+      method: ApiMethod.Get,
+      path: `/api/v1/files/${file_id}`,
+      schema: readFileResponseSchema,
+      query: { context_id },
+    });
+
+  const deleteFile = ({ context_id, file_id }: DeleteFileRequest) =>
+    callApi({
+      method: ApiMethod.Delete,
+      path: `/api/v1/files/${file_id}`,
+      schema: deleteFileResponseSchema,
+      query: { context_id },
+    });
+
+  const readFileContent = ({ context_id, file_id }: ReadFileContentRequest) =>
+    callApi({
+      method: ApiMethod.Get,
+      path: `/api/v1/files/${file_id}/content`,
+      schema: readFileContentResponseSchema,
+      query: { context_id },
+    });
+
+  return {
+    createFile,
+    readFile,
+    deleteFile,
+    readFileContent,
+  };
+}

package/src/client/api/files/schemas.ts

@@ -0,0 +1,56 @@
+/**
+ * Copyright 2025 © BeeAI a Series of LF Projects, LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+
+import z from 'zod';
+
+import { FileType } from './types';
+
+export const fileTypeSchema = z.enum(FileType);
+
+export const fileSchema = z.object({
+  id: z.string(),
+  filename: z.string(),
+  content_type: z.string(),
+  file_type: fileTypeSchema,
+  created_by: z.string(),
+  created_at: z.string(),
+  context_id: z.string().nullish(),
+  file_size_bytes: z.number().nullish(),
+  parent_file_id: z.string().nullish(),
+});
+
+export const createFileRequestSchema = z.object({
+  context_id: z.string().nullable(),
+  file: z.union([
+    z.file(),
+    z.object({
+      blob: z.instanceof(Blob),
+      filename: z.string(),
+    }),
+  ]),
+});
+
+export const createFileResponseSchema = fileSchema;
+
+export const readFileRequestSchema = z.object({
+  context_id: z.string().nullable(),
+  file_id: z.string(),
+});
+
+export const readFileResponseSchema = fileSchema;
+
+export const deleteFileRequestSchema = z.object({
+  context_id: z.string().nullable(),
+  file_id: z.string(),
+});
+
+export const deleteFileResponseSchema = z.null();
+
+export const readFileContentRequestSchema = z.object({
+  context_id: z.string().nullable(),
+  file_id: z.string(),
+});
+
+export const readFileContentResponseSchema = z.unknown();

package/src/client/api/files/types.ts

@@ -0,0 +1,37 @@
+/**
+ * Copyright 2025 © BeeAI a Series of LF Projects, LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+
+import type z from 'zod';
+
+import type {
+  createFileRequestSchema,
+  createFileResponseSchema,
+  deleteFileRequestSchema,
+  deleteFileResponseSchema,
+  fileSchema,
+  readFileContentRequestSchema,
+  readFileContentResponseSchema,
+  readFileRequestSchema,
+  readFileResponseSchema,
+} from './schemas';
+
+export enum FileType {
+  UserUpload = 'user_upload',
+  ExtractedText = 'extracted_text',
+}
+
+export type File = z.infer<typeof fileSchema>;
+
+export type CreateFileRequest = z.infer<typeof createFileRequestSchema>;
+export type CreateFileResponse = z.infer<typeof createFileResponseSchema>;
+
+export type ReadFileRequest = z.infer<typeof readFileRequestSchema>;
+export type ReadFileResponse = z.infer<typeof readFileResponseSchema>;
+
+export type DeleteFileRequest = z.infer<typeof deleteFileRequestSchema>;
+export type DeleteFileResponse = z.infer<typeof deleteFileResponseSchema>;
+
+export type ReadFileContentRequest = z.infer<typeof readFileContentRequestSchema>;
+export type ReadFileContentResponse = z.infer<typeof readFileContentResponseSchema>;

package/src/client/api/index.ts

@@ -0,0 +1,8 @@
+/**
+ * Copyright 2025 © BeeAI a Series of LF Projects, LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+
+export * from './core';
+export * from './schemas';
+export * from './types';

package/src/client/api/model-providers/api.ts

@@ -0,0 +1,67 @@
+/**
+ * Copyright 2025 © BeeAI a Series of LF Projects, LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+
+import type { CallApi } from '../core/types';
+import { ApiMethod } from '../core/types';
+import {
+  createModelProviderResponseSchema,
+  deleteModelProviderResponseSchema,
+  listModelProvidersResponseSchema,
+  matchModelProvidersResponseSchema,
+  readModelProviderResponseSchema,
+} from './schemas';
+import type {
+  CreateModelProviderRequest,
+  DeleteModelProviderRequest,
+  MatchModelProvidersRequest,
+  ReadModelProviderRequest,
+} from './types';
+
+export function createModelProvidersApi(callApi: CallApi) {
+  const listModelProviders = () =>
+    callApi({
+      method: ApiMethod.Get,
+      path: '/api/v1/model_providers',
+      schema: listModelProvidersResponseSchema,
+    });
+
+  const createModelProvider = ({ ...body }: CreateModelProviderRequest) =>
+    callApi({
+      method: ApiMethod.Post,
+      path: '/api/v1/model_providers',
+      schema: createModelProviderResponseSchema,
+      body,
+    });
+
+  const readModelProvider = ({ model_provider_id }: ReadModelProviderRequest) =>
+    callApi({
+      method: ApiMethod.Get,
+      path: `/api/v1/model_providers/${model_provider_id}`,
+      schema: readModelProviderResponseSchema,
+    });
+
+  const deleteModelProvider = ({ model_provider_id }: DeleteModelProviderRequest) =>
+    callApi({
+      method: ApiMethod.Delete,
+      path: `/api/v1/model_providers/${model_provider_id}`,
+      schema: deleteModelProviderResponseSchema,
+    });
+
+  const matchModelProviders = ({ ...body }: MatchModelProvidersRequest) =>
+    callApi({
+      method: ApiMethod.Post,
+      path: '/api/v1/model_providers/match',
+      schema: matchModelProvidersResponseSchema,
+      body,
+    });
+
+  return {
+    listModelProviders,
+    createModelProvider,
+    readModelProvider,
+    deleteModelProvider,
+    matchModelProviders,
+  };
+}

package/src/client/api/model-providers/schemas.ts

@@ -0,0 +1,68 @@
+/**
+ * Copyright 2025 © BeeAI a Series of LF Projects, LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+
+import z from 'zod';
+
+import { paginatedResponseSchema } from '../core/schemas';
+import { ModelCapability, ModelProviderType } from './types';
+
+export const modelCapabilitySchema = z.enum(ModelCapability);
+
+export const modelProviderTypeSchema = z.enum(ModelProviderType);
+
+export const modelProviderSchema = z.object({
+  id: z.string(),
+  base_url: z.string(),
+  created_at: z.string(),
+  capabilities: z.array(modelCapabilitySchema),
+  name: z.string().nullish(),
+  description: z.string().nullish(),
+  type: modelProviderTypeSchema,
+});
+
+export const listModelProvidersRequestSchema = z.never();
+
+export const listModelProvidersResponseSchema = paginatedResponseSchema.extend({
+  items: z.array(modelProviderSchema),
+});
+
+export const createModelProviderRequestSchema = z.object({
+  api_key: z.string(),
+  base_url: z.string(),
+  type: modelProviderTypeSchema,
+  name: z.string().nullish(),
+  description: z.string().nullish(),
+  watsonx_project_id: z.string().nullish(),
+  watsonx_space_id: z.string().nullish(),
+});
+
+export const createModelProviderResponseSchema = modelProviderSchema;
+
+export const readModelProviderRequestSchema = z.object({
+  model_provider_id: z.string(),
+});
+
+export const readModelProviderResponseSchema = modelProviderSchema;
+
+export const deleteModelProviderRequestSchema = z.object({
+  model_provider_id: z.string(),
+});
+
+export const deleteModelProviderResponseSchema = z.null();
+
+export const matchModelProvidersRequestSchema = z.object({
+  suggested_models: z.array(z.string()).nullable(),
+  capability: modelCapabilitySchema,
+  score_cutoff: z.number(),
+});
+
+export const matchModelProvidersResponseSchema = paginatedResponseSchema.extend({
+  items: z.array(
+    z.object({
+      model_id: z.string(),
+      score: z.number(),
+    }),
+  ),
+});

package/src/client/api/model-providers/types.ts

@@ -0,0 +1,66 @@
+/**
+ * Copyright 2025 © BeeAI a Series of LF Projects, LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+
+import type z from 'zod';
+
+import type {
+  createModelProviderRequestSchema,
+  createModelProviderResponseSchema,
+  deleteModelProviderRequestSchema,
+  deleteModelProviderResponseSchema,
+  listModelProvidersRequestSchema,
+  listModelProvidersResponseSchema,
+  matchModelProvidersRequestSchema,
+  matchModelProvidersResponseSchema,
+  modelProviderSchema,
+  readModelProviderRequestSchema,
+  readModelProviderResponseSchema,
+} from './schemas';
+
+export enum ModelCapability {
+  Llm = 'llm',
+  Embedding = 'embedding',
+}
+
+export enum ModelProviderType {
+  Anthropic = 'anthropic',
+  Cerebras = 'cerebras',
+  Chutes = 'chutes',
+  Cohere = 'cohere',
+  DeepSeek = 'deepseek',
+  Gemini = 'gemini',
+  GitHub = 'github',
+  Groq = 'groq',
+  Watsonx = 'watsonx',
+  Jan = 'jan',
+  Mistral = 'mistral',
+  Moonshot = 'moonshot',
+  Nvidia = 'nvidia',
+  Ollama = 'ollama',
+  OpenAI = 'openai',
+  OpenRouter = 'openrouter',
+  Perplexity = 'perplexity',
+  Together = 'together',
+  Voyage = 'voyage',
+  Rits = 'rits',
+  Other = 'other',
+}
+
+export type ModelProvider = z.infer<typeof modelProviderSchema>;
+
+export type ListModelProvidersRequest = z.infer<typeof listModelProvidersRequestSchema>;
+export type ListModelProvidersResponse = z.infer<typeof listModelProvidersResponseSchema>;
+
+export type CreateModelProviderRequest = z.infer<typeof createModelProviderRequestSchema>;
+export type CreateModelProviderResponse = z.infer<typeof createModelProviderResponseSchema>;
+
+export type ReadModelProviderRequest = z.infer<typeof readModelProviderRequestSchema>;
+export type ReadModelProviderResponse = z.infer<typeof readModelProviderResponseSchema>;
+
+export type DeleteModelProviderRequest = z.infer<typeof deleteModelProviderRequestSchema>;
+export type DeleteModelProviderResponse = z.infer<typeof deleteModelProviderResponseSchema>;
+
+export type MatchModelProvidersRequest = z.infer<typeof matchModelProvidersRequestSchema>;
+export type MatchModelProvidersResponse = z.infer<typeof matchModelProvidersResponseSchema>;

package/src/client/api/provider-builds/api.ts

@@ -0,0 +1,80 @@
+/**
+ * Copyright 2025 © BeeAI a Series of LF Projects, LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+
+import type { CallApi } from '../core/types';
+import { ApiMethod } from '../core/types';
+import {
+  createProviderBuildResponseSchema,
+  deleteProviderBuildResponseSchema,
+  listProviderBuildsResponseSchema,
+  previewProviderBuildResponseSchema,
+  readProviderBuildLogsResponseSchema,
+  readProviderBuildResponseSchema,
+} from './schemas';
+import type {
+  CreateProviderBuildRequest,
+  DeleteProviderBuildRequest,
+  ListProviderBuildsRequest,
+  PreviewProviderBuildRequest,
+  ReadProviderBuildLogsRequest,
+  ReadProviderBuildRequest,
+} from './types';
+
+export function createProviderBuildsApi(callApi: CallApi) {
+  const listProviderBuilds = ({ query }: ListProviderBuildsRequest) =>
+    callApi({
+      method: ApiMethod.Get,
+      path: '/api/v1/provider_builds',
+      schema: listProviderBuildsResponseSchema,
+      query,
+    });
+
+  const createProviderBuild = ({ ...body }: CreateProviderBuildRequest) =>
+    callApi({
+      method: ApiMethod.Post,
+      path: '/api/v1/provider_builds',
+      schema: createProviderBuildResponseSchema,
+      body,
+    });
+
+  const readProviderBuild = ({ id }: ReadProviderBuildRequest) =>
+    callApi({
+      method: ApiMethod.Get,
+      path: `/api/v1/provider_builds/${id}`,
+      schema: readProviderBuildResponseSchema,
+    });
+
+  const deleteProviderBuild = ({ id }: DeleteProviderBuildRequest) =>
+    callApi({
+      method: ApiMethod.Delete,
+      path: `/api/v1/provider_builds/${id}`,
+      schema: deleteProviderBuildResponseSchema,
+    });
+
+  const readProviderBuildLogs = ({ id }: ReadProviderBuildLogsRequest) =>
+    callApi({
+      method: ApiMethod.Get,
+      path: `/api/v1/provider_builds/${id}/logs`,
+      schema: readProviderBuildLogsResponseSchema,
+      parseAsStream: true,
+    });
+
+  const previewProviderBuild = ({ ...body }: PreviewProviderBuildRequest) =>
+    callApi({
+      method: ApiMethod.Post,
+      path: '/api/v1/provider_builds/preview',
+      schema: previewProviderBuildResponseSchema,
+      body,
+    });
+
+  return {
+    listProviderBuilds,
+    createProviderBuild,
+    readProviderBuild,
+    deleteProviderBuild,
+    readProviderBuildLogs,
+    previewProviderBuild,
+  };
+}

package/src/client/api/provider-builds/schemas.ts

@@ -0,0 +1,98 @@
+/**
+ * Copyright 2025 © BeeAI a Series of LF Projects, LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+
+import z from 'zod';
+
+import { dockerImageIdSchema, readableStreamSchema, resolvedGitHubUrlSchema } from '../../api/common/schemas';
+import { paginatedResponseSchema, paginationQuerySchema } from '../core/schemas';
+import { ProviderBuildState } from './types';
+
+export const providerBuildStateSchema = z.enum(ProviderBuildState);
+
+export const providerBuildAddActionSchema = z.object({
+  type: z.literal('add_provider'),
+  auto_stop_timeout_sec: z.number().nullish(),
+  variables: z.record(z.string(), z.string()).nullish(),
+});
+
+export const providerBuildUpdateActionSchema = z.object({
+  type: z.literal('update_provider'),
+  provider_id: z.string(),
+});
+
+export const providerBuildNoActionSchema = z.object({
+  type: z.literal('no_action'),
+});
+
+export const providerBuildOnCompleteActionSchema = z.union([
+  providerBuildAddActionSchema,
+  providerBuildUpdateActionSchema,
+  providerBuildNoActionSchema,
+]);
+
+export const providerBuildConfigurationSchema = z.object({
+  dockerfile_path: z.string().nullish(),
+});
+
+export const providerBuildSchema = z.object({
+  id: z.string(),
+  created_at: z.string(),
+  created_by: z.string(),
+  provider_origin: z.string(),
+  status: providerBuildStateSchema,
+  source: resolvedGitHubUrlSchema,
+  destination: dockerImageIdSchema,
+  on_complete: providerBuildOnCompleteActionSchema,
+  build_configuration: providerBuildConfigurationSchema.nullish(),
+  provider_id: z.string().nullish(),
+  error_message: z.string().nullish(),
+});
+
+export const listProviderBuildsRequestSchema = z.object({
+  query: paginationQuerySchema
+    .extend({
+      status: providerBuildStateSchema.nullish(),
+      user_owned: z.boolean().nullish(),
+    })
+    .optional(),
+});
+
+export const listProviderBuildsResponseSchema = paginatedResponseSchema.extend({
+  items: z.array(providerBuildSchema),
+});
+
+export const createProviderBuildRequestSchema = z.object({
+  location: z.string(),
+  build_configuration: providerBuildConfigurationSchema.nullish(),
+  on_complete: providerBuildOnCompleteActionSchema.optional(),
+});
+
+export const createProviderBuildResponseSchema = providerBuildSchema;
+
+export const readProviderBuildRequestSchema = z.object({
+  id: z.string(),
+});
+
+export const readProviderBuildResponseSchema = providerBuildSchema;
+
+export const deleteProviderBuildRequestSchema = z.object({
+  id: z.string(),
+});
+
+export const deleteProviderBuildResponseSchema = z.null();
+
+export const readProviderBuildLogsRequestSchema = z.object({
+  id: z.string(),
+});
+
+export const readProviderBuildLogsResponseSchema = readableStreamSchema;
+
+export const previewProviderBuildRequestSchema = z.object({
+  location: z.string(),
+  build_configuration: providerBuildConfigurationSchema.nullish(),
+  on_complete: providerBuildOnCompleteActionSchema.optional(),
+});
+
+export const previewProviderBuildResponseSchema = providerBuildSchema;

package/src/client/api/provider-builds/types.ts

@@ -0,0 +1,61 @@
+/**
+ * Copyright 2025 © BeeAI a Series of LF Projects, LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+
+import type z from 'zod';
+
+import type {
+  createProviderBuildRequestSchema,
+  createProviderBuildResponseSchema,
+  deleteProviderBuildRequestSchema,
+  deleteProviderBuildResponseSchema,
+  listProviderBuildsRequestSchema,
+  listProviderBuildsResponseSchema,
+  previewProviderBuildRequestSchema,
+  previewProviderBuildResponseSchema,
+  providerBuildAddActionSchema,
+  providerBuildConfigurationSchema,
+  providerBuildNoActionSchema,
+  providerBuildOnCompleteActionSchema,
+  providerBuildSchema,
+  providerBuildUpdateActionSchema,
+  readProviderBuildLogsRequestSchema,
+  readProviderBuildLogsResponseSchema,
+  readProviderBuildRequestSchema,
+  readProviderBuildResponseSchema,
+} from './schemas';
+
+export enum ProviderBuildState {
+  Missing = 'missing',
+  InProgress = 'in_progress',
+  BuildCompleted = 'build_completed',
+  Completed = 'completed',
+  Failed = 'failed',
+}
+
+export type ProviderBuildAddAction = z.infer<typeof providerBuildAddActionSchema>;
+export type ProviderBuildUpdateAction = z.infer<typeof providerBuildUpdateActionSchema>;
+export type ProviderBuildNoAction = z.infer<typeof providerBuildNoActionSchema>;
+export type ProviderBuildOnCompleteAction = z.infer<typeof providerBuildOnCompleteActionSchema>;
+export type ProviderBuildConfiguration = z.infer<typeof providerBuildConfigurationSchema>;
+
+export type ProviderBuild = z.infer<typeof providerBuildSchema>;
+
+export type ListProviderBuildsRequest = z.infer<typeof listProviderBuildsRequestSchema>;
+export type ListProviderBuildsResponse = z.infer<typeof listProviderBuildsResponseSchema>;
+
+export type CreateProviderBuildRequest = z.infer<typeof createProviderBuildRequestSchema>;
+export type CreateProviderBuildResponse = z.infer<typeof createProviderBuildResponseSchema>;
+
+export type ReadProviderBuildRequest = z.infer<typeof readProviderBuildRequestSchema>;
+export type ReadProviderBuildResponse = z.infer<typeof readProviderBuildResponseSchema>;
+
+export type DeleteProviderBuildRequest = z.infer<typeof deleteProviderBuildRequestSchema>;
+export type DeleteProviderBuildResponse = z.infer<typeof deleteProviderBuildResponseSchema>;
+
+export type ReadProviderBuildLogsRequest = z.infer<typeof readProviderBuildLogsRequestSchema>;
+export type ReadProviderBuildLogsResponse = z.infer<typeof readProviderBuildLogsResponseSchema>;
+
+export type PreviewProviderBuildRequest = z.infer<typeof previewProviderBuildRequestSchema>;
+export type PreviewProviderBuildResponse = z.infer<typeof previewProviderBuildResponseSchema>;