@agent-foundry/studio 1.0.0 → 1.0.2

package/dist/types/deployment.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"deployment.d.ts","sourceRoot":"","sources":["../../src/types/deployment.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"deployment.d.ts","sourceRoot":"","sources":["../../src/types/deployment.ts"],"names":[],"mappings":"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"}

package/dist/types/project.d.ts

@@ -37,6 +37,12 @@ export interface StudioProject {
     slug: string;
     /** Optional project description */
     description?: string;
+    /**
+     * Registered app ID after publishing to Feed.
+     * Format: com.agentfoundry.studio.{user_prefix}.{slug}
+     * Set after first successful publish.
+     */
+    appId?: string;
     /** Local filesystem path to project root */
     rootPath: string;
     /** Frontend framework used */

package/dist/types/project.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"project.d.ts","sourceRoot":"","sources":["../../src/types/project.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH;;GAEG;AACH,MAAM,MAAM,gBAAgB,GAAG,YAAY,GAAG,MAAM,GAAG,OAAO,GAAG,UAAU,GAAG,aAAa,CAAC;AAE5F;;GAEG;AACH,MAAM,WAAW,aAAa;IAC5B,uDAAuD;IACvD,YAAY,CAAC,EAAE,MAAM,CAAC;IAEtB,6DAA6D;IAC7D,SAAS,CAAC,EAAE,MAAM,CAAC;IAEnB,mDAAmD;IACnD,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAEjC,oCAAoC;IACpC,OAAO,CAAC,EAAE,MAAM,CAAC;IAEjB,mCAAmC;IACnC,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACtC;AAED;;GAEG;AACH,MAAM,WAAW,aAAa;IAC5B,uBAAuB;IACvB,EAAE,EAAE,MAAM,CAAC;IAEX,yCAAyC;IACzC,MAAM,EAAE,MAAM,CAAC;IAEf,kCAAkC;IAClC,IAAI,EAAE,MAAM,CAAC;IAEb,mDAAmD;IACnD,IAAI,EAAE,MAAM,CAAC;IAEb,mCAAmC;IACnC,WAAW,CAAC,EAAE,MAAM,CAAC;IAErB,4CAA4C;IAC5C,QAAQ,EAAE,MAAM,CAAC;IAEjB,8BAA8B;IAC9B,SAAS,EAAE,gBAAgB,CAAC;IAE5B,4BAA4B;IAC5B,MAAM,EAAE,aAAa,CAAC;IAEtB,+CAA+C;IAC/C,eAAe,CAAC,EAAE,MAAM,CAAC;IAEzB,gCAAgC;IAChC,SAAS,EAAE,MAAM,CAAC;IAElB,mCAAmC;IACnC,SAAS,EAAE,MAAM,CAAC;CACnB;AAED;;GAEG;AACH,MAAM,WAAW,kBAAkB;IACjC,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,CAAC,EAAE,gBAAgB,CAAC;IAC7B,MAAM,CAAC,EAAE,aAAa,CAAC;IACvB,eAAe,CAAC,EAAE,MAAM,CAAC;CAC1B;AAED;;GAEG;AACH,MAAM,WAAW,kBAAkB;IACjC,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,MAAM,CAAC,EAAE,OAAO,CAAC,aAAa,CAAC,CAAC;CACjC;AAED;;GAEG;AACH,MAAM,WAAW,kBAAkB;IACjC,0BAA0B;IAC1B,SAAS,CAAC,EAAE,gBAAgB,CAAC;IAE7B,wCAAwC;IACxC,MAAM,CAAC,EAAE,MAAM,CAAC;IAEhB,8BAA8B;IAC9B,KAAK,CAAC,EAAE,MAAM,CAAC;IAEf,4BAA4B;IAC5B,MAAM,CAAC,EAAE,MAAM,CAAC;IAEhB,qBAAqB;IACrB,OAAO,CAAC,EAAE,WAAW,GAAG,WAAW,GAAG,MAAM,CAAC;IAE7C,sBAAsB;IACtB,QAAQ,CAAC,EAAE,KAAK,GAAG,MAAM,CAAC;CAC3B"}
+{"version":3,"file":"project.d.ts","sourceRoot":"","sources":["../../src/types/project.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH;;GAEG;AACH,MAAM,MAAM,gBAAgB,GAAG,YAAY,GAAG,MAAM,GAAG,OAAO,GAAG,UAAU,GAAG,aAAa,CAAC;AAE5F;;GAEG;AACH,MAAM,WAAW,aAAa;IAC5B,uDAAuD;IACvD,YAAY,CAAC,EAAE,MAAM,CAAC;IAEtB,6DAA6D;IAC7D,SAAS,CAAC,EAAE,MAAM,CAAC;IAEnB,mDAAmD;IACnD,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAEjC,oCAAoC;IACpC,OAAO,CAAC,EAAE,MAAM,CAAC;IAEjB,mCAAmC;IACnC,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACtC;AAED;;GAEG;AACH,MAAM,WAAW,aAAa;IAC5B,uBAAuB;IACvB,EAAE,EAAE,MAAM,CAAC;IAEX,yCAAyC;IACzC,MAAM,EAAE,MAAM,CAAC;IAEf,kCAAkC;IAClC,IAAI,EAAE,MAAM,CAAC;IAEb,mDAAmD;IACnD,IAAI,EAAE,MAAM,CAAC;IAEb,mCAAmC;IACnC,WAAW,CAAC,EAAE,MAAM,CAAC;IAErB;;;;OAIG;IACH,KAAK,CAAC,EAAE,MAAM,CAAC;IAEf,4CAA4C;IAC5C,QAAQ,EAAE,MAAM,CAAC;IAEjB,8BAA8B;IAC9B,SAAS,EAAE,gBAAgB,CAAC;IAE5B,4BAA4B;IAC5B,MAAM,EAAE,aAAa,CAAC;IAEtB,+CAA+C;IAC/C,eAAe,CAAC,EAAE,MAAM,CAAC;IAEzB,gCAAgC;IAChC,SAAS,EAAE,MAAM,CAAC;IAElB,mCAAmC;IACnC,SAAS,EAAE,MAAM,CAAC;CACnB;AAED;;GAEG;AACH,MAAM,WAAW,kBAAkB;IACjC,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,CAAC,EAAE,gBAAgB,CAAC;IAC7B,MAAM,CAAC,EAAE,aAAa,CAAC;IACvB,eAAe,CAAC,EAAE,MAAM,CAAC;CAC1B;AAED;;GAEG;AACH,MAAM,WAAW,kBAAkB;IACjC,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,MAAM,CAAC,EAAE,OAAO,CAAC,aAAa,CAAC,CAAC;CACjC;AAED;;GAEG;AACH,MAAM,WAAW,kBAAkB;IACjC,0BAA0B;IAC1B,SAAS,CAAC,EAAE,gBAAgB,CAAC;IAE7B,wCAAwC;IACxC,MAAM,CAAC,EAAE,MAAM,CAAC;IAEhB,8BAA8B;IAC9B,KAAK,CAAC,EAAE,MAAM,CAAC;IAEf,4BAA4B;IAC5B,MAAM,CAAC,EAAE,MAAM,CAAC;IAEhB,qBAAqB;IACrB,OAAO,CAAC,EAAE,WAAW,GAAG,WAAW,GAAG,MAAM,CAAC;IAE7C,sBAAsB;IACtB,QAAQ,CAAC,EAAE,KAAK,GAAG,MAAM,CAAC;CAC3B"}

package/package.json

@@ -1,7 +1,7 @@
 {
     "name": "@agent-foundry/studio",
-    "version": "1.0.0",
-    "description": "Full SDK for Agent Foundry Build Studio - types, OSS upload, and Supabase client",
+    "version": "1.0.2",
+    "description": "Full SDK for Agent Foundry Build Studio - types, BFF API client, OSS upload, and Supabase client",
     "type": "module",
     "main": "./dist/index.js",
     "module": "./dist/index.js",
@@ -19,6 +19,10 @@
             "import": "./dist/oss/index.js",
             "types": "./dist/oss/index.d.ts"
         },
+        "./bff": {
+            "import": "./dist/bff/index.js",
+            "types": "./dist/bff/index.d.ts"
+        },
         "./db": {
             "import": "./dist/db/index.js",
             "types": "./dist/db/index.d.ts"
@@ -28,6 +32,9 @@
         "build": "tsc",
         "dev": "tsc --watch",
         "clean": "rimraf dist",
+        "test": "vitest run",
+        "test:watch": "vitest",
+        "test:integration": "vitest run --config vitest.integration.config.ts",
         "prepublishOnly": "pnpm run clean && pnpm run build"
     },
     "keywords": [
@@ -48,8 +55,11 @@
     "devDependencies": {
         "@types/ali-oss": "^6.16.0",
         "@types/node": "^20.10.0",
+        "dotenv": "^16.3.1",
+        "jose": "^5.2.0",
+        "rimraf": "^5.0.5",
         "typescript": "^5.3.3",
-        "rimraf": "^5.0.5"
+        "vitest": "^2.0.0"
     },
     "files": [
         "dist",
@@ -59,4 +69,4 @@
     "publishConfig": {
         "access": "public"
     }
-}
+}

package/src/bff/client.ts

@@ -0,0 +1,412 @@
+/**
+ * BFF API Client
+ *
+ * Client for interacting with the BFF Studio API endpoints.
+ * All write operations (create, update, delete) should go through this client.
+ *
+ * The BFF uses SQLAlchemy with service_role credentials, which bypasses RLS.
+ * This is the secure and recommended way to perform write operations.
+ *
+ * @example
+ * ```typescript
+ * import { createBFFClient } from '@agent-foundry/studio/bff';
+ *
+ * const client = createBFFClient({
+ *   baseUrl: 'http://localhost:11001',
+ *   authToken: 'your-supabase-jwt',
+ * });
+ *
+ * // Create a project
+ * const project = await client.projects.create({
+ *   name: 'My App',
+ *   slug: 'my-app',
+ *   rootPath: '/Users/me/projects/my-app',
+ * });
+ * ```
+ */
+
+import type { StudioProject, CreateProjectInput, UpdateProjectInput } from '../types/project';
+import type { Deployment, DeploymentMetadata } from '../types/deployment';
+import type {
+  BFFClientConfig,
+  CreateProjectRequest,
+  UpdateProjectRequest,
+  ForkProjectRequest,
+  ProjectResponse,
+  ProjectListResponse,
+  StartDeploymentRequest,
+  StartDeploymentResponse,
+  UpdateDeploymentStatusRequest,
+  CompleteDeploymentRequest,
+  CompleteDeploymentResponse,
+  FailDeploymentRequest,
+  DeploymentListResponse,
+  PublishRequest,
+  PublishResponse,
+  APIError,
+} from './types';
+
+/**
+ * Error thrown by BFF API client
+ */
+export class BFFAPIError extends Error {
+  constructor(
+    message: string,
+    public readonly status: number,
+    public readonly detail?: string,
+    public readonly code?: string
+  ) {
+    super(message);
+    this.name = 'BFFAPIError';
+  }
+}
+
+/**
+ * Projects API client
+ */
+export class ProjectsAPI {
+  constructor(
+    private readonly baseUrl: string,
+    private readonly authToken: string,
+    private readonly timeout: number
+  ) {}
+
+  private get headers(): HeadersInit {
+    return {
+      'Content-Type': 'application/json',
+      'Authorization': `Bearer ${this.authToken}`,
+    };
+  }
+
+  private async request<T>(
+    method: string,
+    path: string,
+    body?: unknown
+  ): Promise<T> {
+    const controller = new AbortController();
+    const timeoutId = setTimeout(() => controller.abort(), this.timeout);
+
+    try {
+      const response = await fetch(`${this.baseUrl}${path}`, {
+        method,
+        headers: this.headers,
+        body: body ? JSON.stringify(body) : undefined,
+        signal: controller.signal,
+      });
+
+      clearTimeout(timeoutId);
+
+      if (!response.ok) {
+        let detail: string | undefined;
+        let code: string | undefined;
+        try {
+          const error: APIError = await response.json();
+          detail = error.detail;
+          code = error.code;
+        } catch {
+          detail = await response.text();
+        }
+        throw new BFFAPIError(
+          `BFF API error: ${response.status}`,
+          response.status,
+          detail,
+          code
+        );
+      }
+
+      // Handle 204 No Content
+      if (response.status === 204) {
+        return undefined as T;
+      }
+
+      return response.json();
+    } finally {
+      clearTimeout(timeoutId);
+    }
+  }
+
+  /**
+   * Create a new project
+   */
+  async create(input: CreateProjectInput): Promise<StudioProject> {
+    const request: CreateProjectRequest = {
+      name: input.name,
+      slug: input.slug,
+      description: input.description,
+      rootPath: input.rootPath,
+      framework: input.framework,
+      config: input.config,
+      parentProjectId: input.parentProjectId,
+    };
+
+    return this.request<ProjectResponse>('POST', '/studio/projects', request);
+  }
+
+  /**
+   * Get a project by ID
+   */
+  async get(id: string): Promise<ProjectResponse> {
+    return this.request<ProjectResponse>('GET', `/studio/projects/${id}`);
+  }
+
+  /**
+   * List all projects with optional pagination
+   */
+  async list(options?: {
+    page?: number;
+    pageSize?: number;
+    framework?: string;
+    search?: string;
+  }): Promise<ProjectListResponse> {
+    const params = new URLSearchParams();
+    if (options?.page) params.set('page', String(options.page));
+    if (options?.pageSize) params.set('pageSize', String(options.pageSize));
+    if (options?.framework) params.set('framework', options.framework);
+    if (options?.search) params.set('search', options.search);
+
+    const query = params.toString();
+    const path = query ? `/studio/projects?${query}` : '/studio/projects';
+    return this.request<ProjectListResponse>('GET', path);
+  }
+
+  /**
+   * Update a project
+   */
+  async update(id: string, input: UpdateProjectInput): Promise<StudioProject> {
+    const request: UpdateProjectRequest = {
+      name: input.name,
+      description: input.description,
+      config: input.config,
+    };
+
+    return this.request<ProjectResponse>('PUT', `/studio/projects/${id}`, request);
+  }
+
+  /**
+   * Delete a project
+   */
+  async delete(id: string): Promise<void> {
+    return this.request<void>('DELETE', `/studio/projects/${id}`);
+  }
+
+  /**
+   * Fork a project
+   */
+  async fork(
+    id: string,
+    options: { newSlug: string; newRootPath: string; newName?: string }
+  ): Promise<StudioProject> {
+    const request: ForkProjectRequest = {
+      newSlug: options.newSlug,
+      newRootPath: options.newRootPath,
+      newName: options.newName,
+    };
+
+    return this.request<ProjectResponse>('POST', `/studio/projects/${id}/fork`, request);
+  }
+
+  /**
+   * Publish a project to Feed
+   */
+  async publish(
+    id: string,
+    options?: PublishRequest
+  ): Promise<PublishResponse> {
+    return this.request<PublishResponse>(
+      'POST',
+      `/studio/projects/${id}/publish`,
+      options ?? {}
+    );
+  }
+}
+
+/**
+ * Deployments API client
+ */
+export class DeploymentsAPI {
+  constructor(
+    private readonly baseUrl: string,
+    private readonly authToken: string,
+    private readonly timeout: number
+  ) {}
+
+  private get headers(): HeadersInit {
+    return {
+      'Content-Type': 'application/json',
+      'Authorization': `Bearer ${this.authToken}`,
+    };
+  }
+
+  private async request<T>(
+    method: string,
+    path: string,
+    body?: unknown
+  ): Promise<T> {
+    const controller = new AbortController();
+    const timeoutId = setTimeout(() => controller.abort(), this.timeout);
+
+    try {
+      const response = await fetch(`${this.baseUrl}${path}`, {
+        method,
+        headers: this.headers,
+        body: body ? JSON.stringify(body) : undefined,
+        signal: controller.signal,
+      });
+
+      clearTimeout(timeoutId);
+
+      if (!response.ok) {
+        let detail: string | undefined;
+        let code: string | undefined;
+        try {
+          const error: APIError = await response.json();
+          detail = error.detail;
+          code = error.code;
+        } catch {
+          detail = await response.text();
+        }
+        throw new BFFAPIError(
+          `BFF API error: ${response.status}`,
+          response.status,
+          detail,
+          code
+        );
+      }
+
+      return response.json();
+    } finally {
+      clearTimeout(timeoutId);
+    }
+  }
+
+  /**
+   * Start a new deployment (creates deployment record and returns STS credentials)
+   */
+  async start(input: {
+    projectId: string;
+    version?: string;
+    metadata?: Partial<DeploymentMetadata>;
+  }): Promise<StartDeploymentResponse> {
+    const request: StartDeploymentRequest = {
+      projectId: input.projectId,
+      version: input.version,
+      metadata: input.metadata,
+    };
+
+    return this.request<StartDeploymentResponse>(
+      'POST',
+      '/studio/deployments/start',
+      request
+    );
+  }
+
+  /**
+   * Get a deployment by ID
+   */
+  async get(id: string): Promise<Deployment> {
+    return this.request<Deployment>('GET', `/studio/deployments/${id}`);
+  }
+
+  /**
+   * List deployments for a project
+   */
+  async list(projectId: string, limit?: number): Promise<DeploymentListResponse> {
+    const params = new URLSearchParams();
+    if (limit) params.set('limit', String(limit));
+
+    const query = params.toString();
+    const path = query
+      ? `/studio/projects/${projectId}/deployments?${query}`
+      : `/studio/projects/${projectId}/deployments`;
+
+    return this.request<DeploymentListResponse>('GET', path);
+  }
+
+  /**
+   * Update deployment status
+   */
+  async updateStatus(
+    id: string,
+    input: UpdateDeploymentStatusRequest
+  ): Promise<{ status: string; deploymentId: string }> {
+    return this.request<{ status: string; deploymentId: string }>(
+      'PUT',
+      `/studio/deployments/${id}/status`,
+      input
+    );
+  }
+
+  /**
+   * Mark deployment as complete (after successful OSS upload)
+   */
+  async complete(
+    id: string,
+    input: CompleteDeploymentRequest
+  ): Promise<CompleteDeploymentResponse> {
+    return this.request<CompleteDeploymentResponse>(
+      'POST',
+      `/studio/deployments/${id}/complete`,
+      input
+    );
+  }
+
+  /**
+   * Mark deployment as failed
+   */
+  async fail(
+    id: string,
+    input: FailDeploymentRequest
+  ): Promise<{ status: string; deploymentId: string }> {
+    return this.request<{ status: string; deploymentId: string }>(
+      'POST',
+      `/studio/deployments/${id}/fail`,
+      input
+    );
+  }
+}
+
+/**
+ * BFF Client - main entry point for BFF API operations
+ */
+export interface BFFClient {
+  /** Projects API */
+  readonly projects: ProjectsAPI;
+
+  /** Deployments API */
+  readonly deployments: DeploymentsAPI;
+}
+
+/**
+ * Create a new BFF client
+ *
+ * @param config - Client configuration
+ * @returns BFFClient instance
+ *
+ * @example
+ * ```typescript
+ * const client = createBFFClient({
+ *   baseUrl: 'http://localhost:11001',
+ *   authToken: 'your-supabase-jwt',
+ * });
+ *
+ * // Create a project
+ * const project = await client.projects.create({
+ *   name: 'My App',
+ *   slug: 'my-app',
+ *   rootPath: '/Users/me/projects/my-app',
+ * });
+ *
+ * // Start a deployment
+ * const deployment = await client.deployments.start({
+ *   projectId: project.id,
+ * });
+ * ```
+ */
+export function createBFFClient(config: BFFClientConfig): BFFClient {
+  const timeout = config.timeout ?? 30000;
+
+  return {
+    projects: new ProjectsAPI(config.baseUrl, config.authToken, timeout),
+    deployments: new DeploymentsAPI(config.baseUrl, config.authToken, timeout),
+  };
+}

package/src/bff/index.ts

@@ -0,0 +1,32 @@
+/**
+ * BFF module - API client for BFF Studio endpoints
+ *
+ * Use this for all write operations (create, update, delete).
+ * The BFF uses SQLAlchemy with service_role credentials, which bypasses RLS.
+ *
+ * @example
+ * ```typescript
+ * import { createBFFClient } from '@agent-foundry/studio/bff';
+ *
+ * const client = createBFFClient({
+ *   baseUrl: 'http://localhost:11001',
+ *   authToken: 'your-supabase-jwt',
+ * });
+ *
+ * // Create a project (write operation via BFF)
+ * const project = await client.projects.create({
+ *   name: 'My App',
+ *   slug: 'my-app',
+ *   rootPath: '/path/to/project',
+ * });
+ * ```
+ */
+
+export * from './types';
+export {
+  createBFFClient,
+  BFFAPIError,
+  ProjectsAPI,
+  DeploymentsAPI,
+} from './client';
+export type { BFFClient } from './client';