@agent-foundry/studio 1.0.0

package/src/db/schema.sql

@@ -0,0 +1,156 @@
+-- =============================================================================
+-- Agent Foundry Studio Database Schema
+-- =============================================================================
+-- This schema defines tables for managing Studio projects and deployments.
+-- Run this migration against your Supabase PostgreSQL database.
+--
+-- Prerequisites:
+-- 1. Enable uuid-ossp extension: CREATE EXTENSION IF NOT EXISTS "uuid-ossp";
+-- 2. Supabase Auth must be configured (auth.users table exists)
+-- =============================================================================
+
+-- Enable UUID extension if not already enabled
+CREATE EXTENSION IF NOT EXISTS "uuid-ossp";
+
+-- =============================================================================
+-- Studio Projects
+-- =============================================================================
+-- Represents a React/Vite project created and managed in Build Studio.
+-- Each project belongs to a user and can optionally be forked from another project.
+
+CREATE TABLE IF NOT EXISTS studio_projects (
+    id UUID PRIMARY KEY DEFAULT uuid_generate_v4(),
+    
+    -- Owner (references Supabase Auth user)
+    user_id UUID NOT NULL REFERENCES auth.users(id) ON DELETE CASCADE,
+    
+    -- Project identity
+    name VARCHAR(255) NOT NULL,
+    slug VARCHAR(255) NOT NULL,
+    description TEXT,
+    
+    -- Local development
+    root_path TEXT NOT NULL,  -- Local filesystem path to project root
+    
+    -- Framework and configuration
+    framework VARCHAR(50) NOT NULL DEFAULT 'vite-react',
+    config JSONB NOT NULL DEFAULT '{}',
+    
+    -- Fork relationship
+    parent_project_id UUID REFERENCES studio_projects(id) ON DELETE SET NULL,
+    
+    -- Timestamps
+    created_at TIMESTAMPTZ NOT NULL DEFAULT NOW(),
+    updated_at TIMESTAMPTZ NOT NULL DEFAULT NOW(),
+    
+    -- Ensure slug is unique per user
+    CONSTRAINT unique_user_slug UNIQUE (user_id, slug)
+);
+
+-- Index for user's projects
+CREATE INDEX IF NOT EXISTS idx_studio_projects_user_id ON studio_projects(user_id);
+
+-- Index for finding forks
+CREATE INDEX IF NOT EXISTS idx_studio_projects_parent ON studio_projects(parent_project_id);
+
+-- Trigger to auto-update updated_at
+CREATE OR REPLACE FUNCTION update_studio_projects_updated_at()
+RETURNS TRIGGER AS $$
+BEGIN
+    NEW.updated_at = NOW();
+    RETURN NEW;
+END;
+$$ LANGUAGE plpgsql;
+
+DROP TRIGGER IF EXISTS trigger_studio_projects_updated_at ON studio_projects;
+CREATE TRIGGER trigger_studio_projects_updated_at
+    BEFORE UPDATE ON studio_projects
+    FOR EACH ROW
+    EXECUTE FUNCTION update_studio_projects_updated_at();
+
+-- =============================================================================
+-- Studio Deployments
+-- =============================================================================
+-- Represents a build and upload of a project to Alibaba Cloud OSS.
+-- Tracks the full lifecycle: pending -> building -> uploading -> published/failed
+
+CREATE TABLE IF NOT EXISTS studio_deployments (
+    id UUID PRIMARY KEY DEFAULT uuid_generate_v4(),
+    
+    -- References
+    project_id UUID NOT NULL REFERENCES studio_projects(id) ON DELETE CASCADE,
+    user_id UUID NOT NULL REFERENCES auth.users(id) ON DELETE CASCADE,
+    
+    -- Version info
+    version VARCHAR(50) NOT NULL,
+    
+    -- Deployment status
+    status VARCHAR(20) NOT NULL DEFAULT 'pending'
+        CHECK (status IN ('pending', 'building', 'uploading', 'published', 'failed')),
+    
+    -- OSS storage info (populated after successful upload)
+    oss_bucket VARCHAR(255),
+    oss_key TEXT,
+    oss_url TEXT,
+    
+    -- Metrics
+    bundle_size_bytes BIGINT,
+    
+    -- Logs and errors
+    build_log TEXT,
+    error_message TEXT,
+    
+    -- Additional metadata (commit hash, build duration, etc.)
+    metadata JSONB NOT NULL DEFAULT '{}',
+    
+    -- Timestamps
+    created_at TIMESTAMPTZ NOT NULL DEFAULT NOW(),
+    published_at TIMESTAMPTZ
+);
+
+-- Index for project's deployments
+CREATE INDEX IF NOT EXISTS idx_studio_deployments_project_id ON studio_deployments(project_id);
+
+-- Index for user's deployments
+CREATE INDEX IF NOT EXISTS idx_studio_deployments_user_id ON studio_deployments(user_id);
+
+-- Index for filtering by status
+CREATE INDEX IF NOT EXISTS idx_studio_deployments_status ON studio_deployments(status);
+
+-- Composite index for recent deployments by project
+CREATE INDEX IF NOT EXISTS idx_studio_deployments_project_created 
+    ON studio_deployments(project_id, created_at DESC);
+
+-- =============================================================================
+-- Row Level Security (RLS) Policies
+-- =============================================================================
+-- Enable RLS to ensure users can only access their own data.
+
+-- Enable RLS on both tables
+ALTER TABLE studio_projects ENABLE ROW LEVEL SECURITY;
+ALTER TABLE studio_deployments ENABLE ROW LEVEL SECURITY;
+
+-- Projects: Users can only see/modify their own projects
+DROP POLICY IF EXISTS studio_projects_user_policy ON studio_projects;
+CREATE POLICY studio_projects_user_policy ON studio_projects
+    FOR ALL
+    USING (auth.uid() = user_id)
+    WITH CHECK (auth.uid() = user_id);
+
+-- Deployments: Users can only see/modify their own deployments
+DROP POLICY IF EXISTS studio_deployments_user_policy ON studio_deployments;
+CREATE POLICY studio_deployments_user_policy ON studio_deployments
+    FOR ALL
+    USING (auth.uid() = user_id)
+    WITH CHECK (auth.uid() = user_id);
+
+-- =============================================================================
+-- Comments
+-- =============================================================================
+
+COMMENT ON TABLE studio_projects IS 'React/Vite projects created in Agent Foundry Build Studio';
+COMMENT ON COLUMN studio_projects.root_path IS 'Local filesystem path - only valid on the machine where project was created';
+COMMENT ON COLUMN studio_projects.config IS 'JSON config: buildCommand, outputDir, envVars, baseUrl, viteConfig';
+
+COMMENT ON TABLE studio_deployments IS 'Build and deployment history to Alibaba Cloud OSS';
+COMMENT ON COLUMN studio_deployments.metadata IS 'JSON metadata: commitHash, branch, buildDurationMs, uploadDurationMs, fileCount';

package/src/index.ts

@@ -0,0 +1,18 @@
+/**
+ * @agent-foundry/studio
+ *
+ * Full SDK for Agent Foundry Build Studio.
+ * Provides types, Alibaba Cloud OSS upload utilities, and Supabase database client.
+ */
+
+// Re-export all types
+export * from './types';
+
+// Re-export OSS utilities
+export * from './oss';
+
+// Re-export database client
+export * from './db';
+
+// Re-export utilities
+export * from './utils';

package/src/oss/client.ts

@@ -0,0 +1,183 @@
+/**
+ * Alibaba Cloud OSS Client
+ *
+ * Wrapper around ali-oss SDK for browser/WebView usage.
+ */
+
+import OSS from 'ali-oss';
+import type { OSSClientConfig, STSCredentials, UploadFile } from './types';
+
+/**
+ * Progress callback type
+ */
+export type ProgressCallback = (percent: number, checkpoint?: unknown) => void;
+
+/**
+ * AliOSSClient - wrapper for ali-oss SDK
+ *
+ * Provides simplified interface for uploading files to Alibaba Cloud OSS
+ * using STS credentials.
+ */
+export class AliOSSClient {
+  private client: OSS;
+  private credentials: STSCredentials;
+
+  constructor(config: OSSClientConfig) {
+    this.credentials = config.credentials;
+
+    this.client = new OSS({
+      region: config.region,
+      bucket: config.bucket,
+      accessKeyId: config.credentials.accessKeyId,
+      accessKeySecret: config.credentials.accessKeySecret,
+      stsToken: config.credentials.securityToken,
+      timeout: config.timeout ?? 60000,
+      // Enable for browser usage
+      secure: true,
+    });
+  }
+
+  /**
+   * Check if credentials are expired
+   */
+  isExpired(): boolean {
+    const expiration = new Date(this.credentials.expiration);
+    // Consider expired 5 minutes before actual expiration
+    const buffer = 5 * 60 * 1000;
+    return Date.now() > expiration.getTime() - buffer;
+  }
+
+  /**
+   * Upload a single file
+   *
+   * @param key - Object key (path in bucket)
+   * @param content - File content
+   * @param contentType - MIME type
+   * @param _onProgress - Progress callback (not supported for simple uploads)
+   */
+  async uploadFile(
+    key: string,
+    content: Blob | ArrayBuffer | string,
+    contentType?: string,
+    _onProgress?: ProgressCallback
+  ): Promise<{ url: string; etag: string }> {
+    if (this.isExpired()) {
+      throw new Error('STS credentials have expired. Please refresh credentials.');
+    }
+
+    // Convert content to appropriate format
+    let body: Blob | Buffer | string;
+    if (content instanceof ArrayBuffer) {
+      body = new Blob([content]);
+    } else {
+      body = content;
+    }
+
+    const options: OSS.PutObjectOptions = {
+      headers: contentType ? { 'Content-Type': contentType } : undefined,
+    };
+
+    // Note: Progress callback is not supported for simple put operations
+    // Only multipart uploads support progress tracking
+
+    const result = await this.client.put(key, body, options);
+
+    return {
+      url: result.url,
+      etag: (result.res.headers as Record<string, string>)['etag'] as string,
+    };
+  }
+
+  /**
+   * Upload multiple files with progress tracking
+   *
+   * @param files - Array of files to upload
+   * @param keyPrefix - Prefix for all object keys
+   * @param onProgress - Progress callback for overall progress
+   */
+  async uploadFiles(
+    files: UploadFile[],
+    keyPrefix: string,
+    onProgress?: (uploadedCount: number, totalCount: number, currentFile: string) => void
+  ): Promise<{ url: string; totalBytes: number }> {
+    if (this.isExpired()) {
+      throw new Error('STS credentials have expired. Please refresh credentials.');
+    }
+
+    let totalBytes = 0;
+    const totalCount = files.length;
+
+    for (let i = 0; i < files.length; i++) {
+      const file = files[i];
+      const key = `${keyPrefix}/${file.path}`.replace(/\/+/g, '/');
+
+      // Get content size
+      let size = 0;
+      if (file.content instanceof Blob) {
+        size = file.content.size;
+      } else if (file.content instanceof ArrayBuffer) {
+        size = file.content.byteLength;
+      } else if (typeof file.content === 'string') {
+        size = new Blob([file.content]).size;
+      }
+
+      await this.uploadFile(key, file.content, file.contentType);
+      totalBytes += size;
+
+      if (onProgress) {
+        onProgress(i + 1, totalCount, file.path);
+      }
+    }
+
+    // Return URL to index.html or root
+    const baseUrl = this.getPublicUrl(keyPrefix);
+
+    return {
+      url: baseUrl,
+      totalBytes,
+    };
+  }
+
+  /**
+   * Get public URL for an object
+   */
+  getPublicUrl(key: string): string {
+    // Construct public URL based on bucket and region
+    const bucket = (this.client as unknown as { options: { bucket: string } }).options.bucket;
+    const region = (this.client as unknown as { options: { region: string } }).options.region;
+
+    // Standard OSS URL format
+    return `https://${bucket}.${region}.aliyuncs.com/${key}`;
+  }
+
+  /**
+   * Check if an object exists
+   */
+  async exists(key: string): Promise<boolean> {
+    try {
+      await this.client.head(key);
+      return true;
+    } catch {
+      return false;
+    }
+  }
+
+  /**
+   * Delete an object
+   */
+  async delete(key: string): Promise<void> {
+    await this.client.delete(key);
+  }
+
+  /**
+   * List objects with prefix
+   */
+  async list(prefix: string, maxKeys = 100): Promise<string[]> {
+    const result = await this.client.list({
+      prefix,
+      'max-keys': maxKeys,
+    }, {});
+
+    return (result.objects || []).map((obj) => obj.name);
+  }
+}

package/src/oss/index.ts

@@ -0,0 +1,7 @@
+/**
+ * OSS module - Alibaba Cloud OSS upload utilities
+ */
+
+export * from './types';
+export { AliOSSClient } from './client';
+export { DirectUploader, type DirectUploaderConfig } from './uploader';

package/src/oss/types.ts

@@ -0,0 +1,126 @@
+/**
+ * OSS-specific types for Alibaba Cloud integration
+ */
+
+/**
+ * STS (Security Token Service) credentials for temporary access
+ */
+export interface STSCredentials {
+  /** Temporary access key ID */
+  accessKeyId: string;
+
+  /** Temporary access key secret */
+  accessKeySecret: string;
+
+  /** Security token */
+  securityToken: string;
+
+  /** Token expiration timestamp (ISO string) */
+  expiration: string;
+}
+
+/**
+ * Response from BFF when requesting upload credentials
+ */
+export interface UploadTokenResponse {
+  /** STS credentials for OSS access */
+  credentials: STSCredentials;
+
+  /** OSS bucket name */
+  bucket: string;
+
+  /** Region endpoint (e.g., "oss-cn-hangzhou.aliyuncs.com") */
+  region: string;
+
+  /** Object key prefix for this upload */
+  keyPrefix: string;
+
+  /** Deployment ID for tracking */
+  deploymentId: string;
+}
+
+/**
+ * File to upload
+ */
+export interface UploadFile {
+  /** Relative path within the bundle (e.g., "index.html", "assets/main.js") */
+  path: string;
+
+  /** File content */
+  content: Blob | ArrayBuffer | string;
+
+  /** Content type (MIME type) */
+  contentType?: string;
+}
+
+/**
+ * Upload progress event
+ */
+export interface UploadProgress {
+  /** Current file being uploaded */
+  currentFile: string;
+
+  /** Number of files uploaded so far */
+  uploadedCount: number;
+
+  /** Total number of files to upload */
+  totalCount: number;
+
+  /** Bytes uploaded for current file */
+  uploadedBytes: number;
+
+  /** Total bytes for current file */
+  totalBytes: number;
+
+  /** Overall progress percentage (0-100) */
+  percent: number;
+
+  /** Current stage */
+  stage: 'preparing' | 'uploading' | 'finalizing';
+}
+
+/**
+ * Upload result
+ */
+export interface UploadResult {
+  /** Whether upload was successful */
+  success: boolean;
+
+  /** Deployment ID */
+  deploymentId: string;
+
+  /** Public URL of the deployed app */
+  url?: string;
+
+  /** OSS bucket */
+  bucket?: string;
+
+  /** OSS key prefix */
+  keyPrefix?: string;
+
+  /** Total bytes uploaded */
+  totalBytes: number;
+
+  /** Number of files uploaded */
+  fileCount: number;
+
+  /** Error message if failed */
+  error?: string;
+}
+
+/**
+ * OSS client configuration
+ */
+export interface OSSClientConfig {
+  /** Region (e.g., "oss-cn-hangzhou") */
+  region: string;
+
+  /** Bucket name */
+  bucket: string;
+
+  /** STS credentials */
+  credentials: STSCredentials;
+
+  /** Request timeout in milliseconds */
+  timeout?: number;
+}