@agent-foundry/studio 1.0.0 → 1.0.2

package/src/index.ts

@@ -2,7 +2,18 @@
  * @agent-foundry/studio
  *
  * Full SDK for Agent Foundry Build Studio.
- * Provides types, Alibaba Cloud OSS upload utilities, and Supabase database client.
+ * Provides types, Alibaba Cloud OSS upload utilities, BFF API client, and Supabase database client.
+ *
+ * ## Recommended Usage Pattern (Hybrid Approach)
+ *
+ * - **Write operations**: Use BFF client (`@agent-foundry/studio/bff`)
+ * - **Read operations**: Use Supabase client (`@agent-foundry/studio/db`)
+ * - **File uploads**: Use DirectUploader (`@agent-foundry/studio/oss`)
+ *
+ * This pattern ensures:
+ * - Security: Write operations go through BFF with service_role (bypasses RLS)
+ * - Performance: Read operations use direct Supabase connection
+ * - Consistency: All writes are validated server-side
  */
 
 // Re-export all types
@@ -11,7 +22,12 @@ export * from './types';
 // Re-export OSS utilities
 export * from './oss';
 
-// Re-export database client
+// Re-export BFF API client (recommended for write operations)
+// Note: Use '@agent-foundry/studio/bff' for full BFF types
+export { createBFFClient, BFFAPIError } from './bff';
+export type { BFFClient, BFFClientConfig } from './bff';
+
+// Re-export database client (recommended for read operations only)
 export * from './db';
 
 // Re-export utilities

package/src/types/deployment.ts

@@ -68,6 +68,12 @@ export interface Deployment {
   /** Public access URL for the deployed app */
   ossUrl?: string;
 
+  /**
+   * Artifact ID created when publishing to Feed.
+   * Set when user publishes deployment to AF ecosystem.
+   */
+  artifactId?: string;
+
   /** Total bundle size in bytes */
   bundleSizeBytes?: number;
 
@@ -104,6 +110,7 @@ export interface UpdateDeploymentInput {
   ossBucket?: string;
   ossKey?: string;
   ossUrl?: string;
+  artifactId?: string;
   bundleSizeBytes?: number;
   buildLog?: string;
   errorMessage?: string;
@@ -145,3 +152,71 @@ export interface DeploymentProgress {
   message?: string;
   timestamp: string;
 }
+
+// =============================================================================
+// Publish to Feed Types
+// =============================================================================
+
+/**
+ * App manifest for publishing to Feed
+ */
+export interface AppManifest {
+  /** App name */
+  name: string;
+
+  /** App version */
+  version: string;
+
+  /** Entry point path (default: "/index.html") */
+  entry?: string;
+
+  /** Minimum shell version required */
+  minShellVersion?: string;
+
+  /** App capabilities */
+  capabilities?: {
+    bridge?: string[];
+    network?: string[];
+    storage?: string[];
+  };
+
+  /** App permissions */
+  permissions?: Array<{
+    name: string;
+    reason: string;
+  }>;
+}
+
+/**
+ * Input for publishing a project to Feed
+ */
+export interface PublishInput {
+  /** Specific deployment ID to publish (defaults to latest) */
+  deploymentId?: string;
+
+  /** App manifest override */
+  manifest?: AppManifest;
+
+  /** App status in registry */
+  status?: 'canary' | 'stable';
+}
+
+/**
+ * Result of publishing to Feed
+ */
+export interface PublishResult {
+  /** Registered app ID */
+  appId: string;
+
+  /** Created artifact ID */
+  artifactId: string;
+
+  /** Deployment that was published */
+  deploymentId: string;
+
+  /** Share URL for the app */
+  shareUrl: string;
+
+  /** Direct entry URL (OSS) */
+  entryUrl: string;
+}

package/src/types/project.ts

@@ -49,6 +49,13 @@ export interface StudioProject {
   /** 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;