@bubblelab/shared-schemas 0.1.10 → 0.1.11

package/dist/coffee.d.ts.map

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

package/dist/coffee.js

@@ -0,0 +1,258 @@
+import { z } from 'zod';
+import { CredentialType } from './types.js';
+// ============================================================================
+// Coffee Agent - Planning Phase for BubbleFlow Generation
+// ============================================================================
+// Coffee runs BEFORE Boba to gather clarification and generate an
+// implementation plan. This helps reduce ambiguity in user requests.
+// Constants
+export const COFFEE_MAX_ITERATIONS = 30;
+export const COFFEE_MAX_QUESTIONS = 3;
+export const COFFEE_DEFAULT_MODEL = 'google/gemini-3-pro-preview';
+// ============================================================================
+// Clarification Schemas
+// ============================================================================
+/** A single choice option for a clarification question */
+export const ClarificationChoiceSchema = z.object({
+    id: z.string().describe('Unique identifier for this choice'),
+    label: z.string().describe('Short display label for the choice'),
+    description: z
+        .string()
+        .optional()
+        .describe('Optional longer description explaining the choice'),
+});
+/** A clarification question with multiple choices */
+export const ClarificationQuestionSchema = z.object({
+    id: z.string().describe('Unique identifier for this question'),
+    question: z.string().describe('The question text to display to the user'),
+    choices: z
+        .array(ClarificationChoiceSchema)
+        .min(2)
+        .max(4)
+        .describe('Available choices for the user (2-4 options)'),
+    context: z
+        .string()
+        .optional()
+        .describe('Optional context explaining why this question is being asked'),
+    allowMultiple: z
+        .boolean()
+        .optional()
+        .default(false)
+        .describe('If true, user can select multiple choices. Default is false (single selection)'),
+});
+/** Event sent to frontend containing clarification questions */
+export const CoffeeClarificationEventSchema = z.object({
+    questions: z
+        .array(ClarificationQuestionSchema)
+        .min(1)
+        .max(COFFEE_MAX_QUESTIONS)
+        .describe('List of clarification questions (1-3)'),
+});
+// ============================================================================
+// Context Gathering Schemas
+// ============================================================================
+/**
+ * Event sent when Coffee requests external context via running a BubbleFlow.
+ * This pauses the planning process until the user provides credentials and approves execution.
+ */
+export const CoffeeRequestExternalContextEventSchema = z.object({
+    flowId: z.string().describe('Unique ID for this context request'),
+    flowCode: z
+        .string()
+        .describe('Validated BubbleFlow TypeScript code to execute'),
+    requiredCredentials: z
+        .array(z.nativeEnum(CredentialType))
+        .describe('List of credential types needed to run this flow'),
+    description: z
+        .string()
+        .describe('User-friendly description of what this flow will do'),
+});
+/**
+ * Answer sent back to Coffee after user provides credentials and flow executes.
+ * This is used to resume the planning process with enriched context.
+ */
+export const CoffeeContextAnswerSchema = z.object({
+    flowId: z.string().describe('ID of the context request being answered'),
+    status: z
+        .enum(['success', 'rejected', 'error'])
+        .describe('Status: success (got context), rejected (user skipped), error (execution failed)'),
+    result: z
+        .unknown()
+        .optional()
+        .describe('The result data from running the context-gathering flow'),
+    error: z.string().optional().describe('Error message if status is error'),
+    originalRequest: CoffeeRequestExternalContextEventSchema.optional().describe('The original context request that triggered this answer'),
+});
+/**
+ * Context request info that the agent generates when it wants to run a flow.
+ */
+export const CoffeeContextRequestInfoSchema = z.object({
+    purpose: z.string().describe('Why this context is needed'),
+    flowDescription: z
+        .string()
+        .describe('User-facing description of what the flow will do'),
+});
+/** Legacy context gathering status (used in streaming events) */
+export const CoffeeContextEventSchema = z.object({
+    status: z.enum(['gathering', 'complete']),
+    miniFlowDescription: z.string().optional(),
+    result: z.string().optional(),
+});
+// ============================================================================
+// Plan Schemas
+// ============================================================================
+/** A single step in the implementation plan */
+export const PlanStepSchema = z.object({
+    title: z.string().describe('Short title for this step'),
+    description: z
+        .string()
+        .describe('Detailed description of what this step does'),
+    bubblesUsed: z
+        .array(z.string())
+        .optional()
+        .describe('Names of bubbles used in this step'),
+});
+/** The complete implementation plan generated by Coffee */
+export const CoffeePlanEventSchema = z.object({
+    summary: z.string().describe('Brief overview of the workflow'),
+    steps: z.array(PlanStepSchema).describe('Step-by-step implementation plan'),
+    estimatedBubbles: z
+        .array(z.string())
+        .describe('All bubbles that will be used in the workflow'),
+});
+// ============================================================================
+// Unified Message Types for Coffee Chat
+// ============================================================================
+// These message types allow Coffee interactions to be stored as persistent
+// messages in the chat history, rather than ephemeral state.
+/** Base message structure shared by all message types */
+const BaseMessageSchema = z.object({
+    id: z.string().describe('Unique message identifier'),
+    timestamp: z.string().describe('ISO timestamp of message creation'),
+});
+/** Regular user text message */
+export const UserMessageSchema = BaseMessageSchema.extend({
+    type: z.literal('user'),
+    content: z.string().describe('User message text'),
+});
+/** Regular assistant text message */
+export const AssistantMessageSchema = BaseMessageSchema.extend({
+    type: z.literal('assistant'),
+    content: z.string().describe('Assistant response text'),
+    code: z.string().optional().describe('Generated code if applicable'),
+    resultType: z
+        .enum(['code', 'question', 'answer', 'reject'])
+        .optional()
+        .describe('Type of assistant response'),
+    bubbleParameters: z
+        .record(z.string(), z.unknown())
+        .optional()
+        .describe('Bubble parameters for code responses'),
+});
+/** Coffee asking clarification questions */
+export const ClarificationRequestMessageSchema = BaseMessageSchema.extend({
+    type: z.literal('clarification_request'),
+    questions: z
+        .array(ClarificationQuestionSchema)
+        .describe('Questions being asked'),
+});
+/** User's answers to clarification questions */
+export const ClarificationResponseMessageSchema = BaseMessageSchema.extend({
+    type: z.literal('clarification_response'),
+    answers: z
+        .record(z.string(), z.array(z.string()))
+        .describe('questionId -> choiceIds'),
+    originalQuestions: z
+        .array(ClarificationQuestionSchema)
+        .optional()
+        .describe('The questions that were answered (for display purposes)'),
+});
+/** Coffee requesting external context */
+export const ContextRequestMessageSchema = BaseMessageSchema.extend({
+    type: z.literal('context_request'),
+    request: CoffeeRequestExternalContextEventSchema.describe('Context gathering request details'),
+});
+/** User's response to context request */
+export const ContextResponseMessageSchema = BaseMessageSchema.extend({
+    type: z.literal('context_response'),
+    answer: CoffeeContextAnswerSchema.describe('User response to context request'),
+    credentialTypes: z
+        .array(z.string())
+        .optional()
+        .describe('Credential types used (for display, not actual secrets)'),
+});
+/** Coffee's generated plan */
+export const PlanMessageSchema = BaseMessageSchema.extend({
+    type: z.literal('plan'),
+    plan: CoffeePlanEventSchema.describe('Generated implementation plan'),
+});
+/** User's plan approval with optional comment */
+export const PlanApprovalMessageSchema = BaseMessageSchema.extend({
+    type: z.literal('plan_approval'),
+    approved: z.boolean().describe('Whether the plan was approved'),
+    comment: z.string().optional().describe('Optional user comment on the plan'),
+});
+/** System message (for retries, errors, etc.) */
+export const SystemMessageSchema = BaseMessageSchema.extend({
+    type: z.literal('system'),
+    content: z.string().describe('System message content'),
+});
+/** Tool result message - persists successful tool call results */
+export const ToolResultMessageSchema = BaseMessageSchema.extend({
+    type: z.literal('tool_result'),
+    toolName: z.string().describe('Name of the tool that was called'),
+    toolCallId: z.string().describe('Unique ID for this tool call'),
+    input: z.unknown().describe('Input parameters passed to the tool'),
+    output: z.unknown().describe('Output/result from the tool'),
+    duration: z.number().describe('Duration of the tool call in milliseconds'),
+    success: z.boolean().describe('Whether the tool call succeeded'),
+});
+/** Union of all Coffee message types */
+export const CoffeeMessageSchema = z.discriminatedUnion('type', [
+    UserMessageSchema,
+    AssistantMessageSchema,
+    ClarificationRequestMessageSchema,
+    ClarificationResponseMessageSchema,
+    ContextRequestMessageSchema,
+    ContextResponseMessageSchema,
+    PlanMessageSchema,
+    PlanApprovalMessageSchema,
+    SystemMessageSchema,
+    ToolResultMessageSchema,
+]);
+// ============================================================================
+// Request/Response Schemas
+// ============================================================================
+/** Request to the Generate BubbleFlow */
+export const CoffeeRequestSchema = z.object({
+    prompt: z.string().min(1).describe('The user prompt describing the workflow'),
+    flowId: z
+        .number()
+        .optional()
+        .describe('Optional flow ID if updating existing flow'),
+    messages: z
+        .array(CoffeeMessageSchema)
+        .optional()
+        .describe('Full conversation history including clarification Q&A, context results, plan approvals'),
+});
+/** Response from the Coffee agent */
+export const CoffeeResponseSchema = z.object({
+    type: z
+        .enum(['clarification', 'plan', 'context_request', 'error'])
+        .describe('Response type'),
+    clarification: CoffeeClarificationEventSchema.optional(),
+    plan: CoffeePlanEventSchema.optional(),
+    contextRequest: CoffeeRequestExternalContextEventSchema.optional(),
+    error: z.string().optional(),
+    success: z.boolean().describe('Whether the operation completed successfully'),
+});
+/** Internal output format from the Coffee AI agent */
+export const CoffeeAgentOutputSchema = z.object({
+    action: z
+        .enum(['askClarification', 'generatePlan', 'requestContext'])
+        .describe('The action the agent wants to take'),
+    questions: z.array(ClarificationQuestionSchema).optional(),
+    plan: CoffeePlanEventSchema.optional(),
+    contextRequest: CoffeeContextRequestInfoSchema.optional(),
+});
+//# sourceMappingURL=coffee.js.map

package/dist/coffee.js.map

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

package/dist/credential-schema.d.ts

@@ -9,7 +9,15 @@ export declare const SYSTEM_CREDENTIALS: Set<CredentialType>;
 /**
  * OAuth provider names - type-safe provider identifiers
  */
-export type OAuthProvider = 'google';
+export type OAuthProvider = 'google' | 'followupboss' | 'notion';
+/**
+ * Scope description mapping - maps OAuth scope URLs to human-readable descriptions
+ */
+export interface ScopeDescription {
+    scope: string;
+    description: string;
+    defaultEnabled: boolean;
+}
 /**
  * OAuth credential type configuration for a specific service under a provider
  */
@@ -17,6 +25,7 @@ export interface OAuthCredentialConfig {
     displayName: string;
     defaultScopes: string[];
     description: string;
+    scopeDescriptions?: ScopeDescription[];
 }
 /**
  * OAuth provider configuration shared between frontend and backend
@@ -41,6 +50,11 @@ export declare function getOAuthProvider(credentialType: CredentialType): OAuthP
  * Check if a credential type is OAuth-based
  */
 export declare function isOAuthCredential(credentialType: CredentialType): boolean;
+/**
+ * Get scope descriptions for a specific credential type
+ * Returns an array of scope descriptions that will be requested during OAuth
+ */
+export declare function getScopeDescriptions(credentialType: CredentialType): ScopeDescription[];
 /**
  * Maps bubble names to their accepted credential types
  */
@@ -114,8 +128,6 @@ export declare const createCredentialSchema: z.ZodObject<{
     value: string;
     credentialType: CredentialType;
     name?: string | undefined;
-    skipValidation?: boolean | undefined;
-    credentialConfigurations?: Record<string, unknown> | undefined;
     metadata?: {
         tables: Record<string, Record<string, string>>;
         tableNotes?: Record<string, string> | undefined;
@@ -131,12 +143,12 @@ export declare const createCredentialSchema: z.ZodObject<{
         notes?: string | undefined;
         tags?: string[] | undefined;
     } | undefined;
+    skipValidation?: boolean | undefined;
+    credentialConfigurations?: Record<string, unknown> | undefined;
 }, {
     value: string;
     credentialType: CredentialType;
     name?: string | undefined;
-    skipValidation?: boolean | undefined;
-    credentialConfigurations?: Record<string, unknown> | undefined;
     metadata?: {
         tables: Record<string, Record<string, string>>;
         tableNotes?: Record<string, string> | undefined;
@@ -152,6 +164,8 @@ export declare const createCredentialSchema: z.ZodObject<{
         notes?: string | undefined;
         tags?: string[] | undefined;
     } | undefined;
+    skipValidation?: boolean | undefined;
+    credentialConfigurations?: Record<string, unknown> | undefined;
 }>;
 export declare const updateCredentialSchema: z.ZodObject<{
     value: z.ZodOptional<z.ZodString>;
@@ -214,10 +228,8 @@ export declare const updateCredentialSchema: z.ZodObject<{
         tags?: string[] | undefined;
     }>>;
 }, "strip", z.ZodTypeAny, {
-    value?: string | undefined;
     name?: string | undefined;
-    skipValidation?: boolean | undefined;
-    credentialConfigurations?: Record<string, unknown> | undefined;
+    value?: string | undefined;
     metadata?: {
         tables: Record<string, Record<string, string>>;
         tableNotes?: Record<string, string> | undefined;
@@ -233,11 +245,11 @@ export declare const updateCredentialSchema: z.ZodObject<{
         notes?: string | undefined;
         tags?: string[] | undefined;
     } | undefined;
-}, {
-    value?: string | undefined;
-    name?: string | undefined;
     skipValidation?: boolean | undefined;
     credentialConfigurations?: Record<string, unknown> | undefined;
+}, {
+    name?: string | undefined;
+    value?: string | undefined;
     metadata?: {
         tables: Record<string, Record<string, string>>;
         tableNotes?: Record<string, string> | undefined;
@@ -253,6 +265,8 @@ export declare const updateCredentialSchema: z.ZodObject<{
         notes?: string | undefined;
         tags?: string[] | undefined;
     } | undefined;
+    skipValidation?: boolean | undefined;
+    credentialConfigurations?: Record<string, unknown> | undefined;
 }>;
 export declare const credentialResponseSchema: z.ZodObject<{
     id: z.ZodNumber;
@@ -320,9 +334,9 @@ export declare const credentialResponseSchema: z.ZodObject<{
     oauthScopes: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
     oauthStatus: z.ZodOptional<z.ZodEnum<["active", "expired", "needs_refresh"]>>;
 }, "strip", z.ZodTypeAny, {
-    credentialType: string;
     id: number;
     createdAt: string;
+    credentialType: string;
     name?: string | undefined;
     metadata?: {
         tables: Record<string, Record<string, string>>;
@@ -345,9 +359,9 @@ export declare const credentialResponseSchema: z.ZodObject<{
     oauthScopes?: string[] | undefined;
     oauthStatus?: "active" | "expired" | "needs_refresh" | undefined;
 }, {
-    credentialType: string;
     id: number;
     createdAt: string;
+    credentialType: string;
     name?: string | undefined;
     metadata?: {
         tables: Record<string, Record<string, string>>;

package/dist/credential-schema.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"credential-schema.d.ts","sourceRoot":"","sources":["../src/credential-schema.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AACxD,OAAO,EAAE,CAAC,EAAE,MAAM,mBAAmB,CAAC;AAGtC;;GAEG;AACH,eAAO,MAAM,kBAAkB,EAAE,MAAM,CAAC,cAAc,EAAE,MAAM,CAiB7D,CAAC;AAEF,+BAA+B;AAC/B,eAAO,MAAM,kBAAkB,qBAa7B,CAAC;AAEH;;GAEG;AACH,MAAM,MAAM,aAAa,GAAG,QAAQ,CAAC;AAErC;;GAEG;AACH,MAAM,WAAW,qBAAqB;IACpC,WAAW,EAAE,MAAM,CAAC;IACpB,aAAa,EAAE,MAAM,EAAE,CAAC;IACxB,WAAW,EAAE,MAAM,CAAC;CACrB;AAED;;GAEG;AACH,MAAM,WAAW,mBAAmB;IAClC,IAAI,EAAE,aAAa,CAAC;IACpB,WAAW,EAAE,MAAM,CAAC;IACpB,eAAe,EAAE,OAAO,CAAC,MAAM,CAAC,cAAc,EAAE,qBAAqB,CAAC,CAAC,CAAC;IACxE,mBAAmB,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CAC9C;AAED;;;GAGG;AACH,eAAO,MAAM,eAAe,EAAE,MAAM,CAAC,aAAa,EAAE,mBAAmB,CAmCtE,CAAC;AAEF;;;GAGG;AACH,wBAAgB,gBAAgB,CAC9B,cAAc,EAAE,cAAc,GAC7B,aAAa,GAAG,IAAI,CAOtB;AAED;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,cAAc,EAAE,cAAc,GAAG,OAAO,CAEzE;AAED;;GAEG;AACH,MAAM,MAAM,iBAAiB,GAAG,OAAO,CAAC,MAAM,CAAC,cAAc,EAAE,MAAM,CAAC,CAAC,CAAC;AAExE;;GAEG;AACH,eAAO,MAAM,yBAAyB,EAAE,MAAM,CAAC,UAAU,EAAE,cAAc,EAAE,CAsF1E,CAAC;AAGF,eAAO,MAAM,sBAAsB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAkDE,CAAC;AAGtC,eAAO,MAAM,sBAAsB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAsCE,CAAC;AAEtC,eAAO,MAAM,wBAAwB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAgCL,CAAC;AAGjC,eAAO,MAAM,8BAA8B;;;;;;;;;EAKL,CAAC;AAGvC,eAAO,MAAM,8BAA8B;;;;;;;;;EAKL,CAAC;AAGvC,eAAO,MAAM,4BAA4B;;;;;;EAIL,CAAC;AAErC,MAAM,MAAM,uBAAuB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,sBAAsB,CAAC,CAAC;AAC7E,MAAM,MAAM,uBAAuB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,sBAAsB,CAAC,CAAC;AAC7E,MAAM,MAAM,kBAAkB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,wBAAwB,CAAC,CAAC;AAC1E,MAAM,MAAM,wBAAwB,GAAG,CAAC,CAAC,KAAK,CAC5C,OAAO,8BAA8B,CACtC,CAAC;AACF,MAAM,MAAM,wBAAwB,GAAG,CAAC,CAAC,KAAK,CAC5C,OAAO,8BAA8B,CACtC,CAAC"}
+{"version":3,"file":"credential-schema.d.ts","sourceRoot":"","sources":["../src/credential-schema.ts"],"names":[],"mappings":"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"}

package/dist/credential-schema.js

@@ -11,16 +11,25 @@ export const CREDENTIAL_ENV_MAP = {
     [CredentialType.FIRECRAWL_API_KEY]: 'FIRE_CRAWL_API_KEY',
     [CredentialType.DATABASE_CRED]: 'BUBBLE_CONNECTING_STRING_URL',
     [CredentialType.SLACK_CRED]: 'SLACK_TOKEN',
+    [CredentialType.TELEGRAM_BOT_TOKEN]: 'TELEGRAM_BOT_TOKEN',
     [CredentialType.RESEND_CRED]: 'RESEND_API_KEY',
     [CredentialType.OPENROUTER_CRED]: 'OPENROUTER_API_KEY',
     [CredentialType.CLOUDFLARE_R2_ACCESS_KEY]: 'CLOUDFLARE_R2_ACCESS_KEY',
     [CredentialType.CLOUDFLARE_R2_SECRET_KEY]: 'CLOUDFLARE_R2_SECRET_KEY',
     [CredentialType.CLOUDFLARE_R2_ACCOUNT_ID]: 'CLOUDFLARE_R2_ACCOUNT_ID',
     [CredentialType.APIFY_CRED]: 'APIFY_API_TOKEN',
+    [CredentialType.ELEVENLABS_API_KEY]: 'ELEVENLABS_API_KEY',
     [CredentialType.GOOGLE_DRIVE_CRED]: '',
     [CredentialType.GMAIL_CRED]: '',
     [CredentialType.GOOGLE_SHEETS_CRED]: '',
     [CredentialType.GOOGLE_CALENDAR_CRED]: '',
+    [CredentialType.FUB_CRED]: '',
+    [CredentialType.GITHUB_TOKEN]: 'GITHUB_TOKEN',
+    [CredentialType.AGI_API_KEY]: 'AGI_API_KEY',
+    [CredentialType.AIRTABLE_CRED]: 'AIRTABLE_API_KEY',
+    [CredentialType.NOTION_OAUTH_TOKEN]: '',
+    [CredentialType.INSFORGE_BASE_URL]: 'INSFORGE_BASE_URL',
+    [CredentialType.INSFORGE_API_KEY]: 'INSFORGE_API_KEY',
 };
 /** Used by bubblelab studio */
 export const SYSTEM_CREDENTIALS = new Set([
@@ -50,24 +59,77 @@ export const OAUTH_PROVIDERS = {
                 displayName: 'Google Drive',
                 defaultScopes: [
                     'https://www.googleapis.com/auth/drive.file',
+                    'https://www.googleapis.com/auth/documents',
+                    'https://www.googleapis.com/auth/spreadsheets',
                     'https://www.googleapis.com/auth/drive',
                 ],
                 description: 'Access Google Drive files and folders',
+                scopeDescriptions: [
+                    {
+                        scope: 'https://www.googleapis.com/auth/drive.file',
+                        description: 'View and manage Google Drive files and folders that you have created with Bubble Lab',
+                        defaultEnabled: true,
+                    },
+                    {
+                        scope: 'https://www.googleapis.com/auth/documents',
+                        description: 'View and manage your Google Docs documents',
+                        defaultEnabled: true,
+                    },
+                    {
+                        scope: 'https://www.googleapis.com/auth/spreadsheets',
+                        description: 'View and manage your Google Sheets spreadsheets',
+                        defaultEnabled: true,
+                    },
+                    {
+                        scope: 'https://www.googleapis.com/auth/drive',
+                        description: 'View and manage all ofyour Google Drive files and folders (will see a warning about an "untrusted app" during authentication. Choose only if you need extra permissions)',
+                        defaultEnabled: false,
+                    },
+                ],
             },
             [CredentialType.GMAIL_CRED]: {
                 displayName: 'Gmail',
-                defaultScopes: ['https://mail.google.com/'],
-                description: 'Access Gmail for reading, sending, and managing emails',
+                defaultScopes: [
+                    'https://www.googleapis.com/auth/gmail.send',
+                    'https://www.googleapis.com/auth/gmail.modify',
+                ],
+                description: 'Access Gmail for sending emails',
+                scopeDescriptions: [
+                    {
+                        scope: 'https://www.googleapis.com/auth/gmail.send',
+                        description: 'Send email on your behalf',
+                        defaultEnabled: true,
+                    },
+                    {
+                        scope: 'https://www.googleapis.com/auth/gmail.modify',
+                        description: 'View and manage all of your Gmail emails and labels (might see a warning about an "untrusted app" during authentication. Choose only if you need extra permissions)',
+                        defaultEnabled: false,
+                    },
+                ],
             },
             [CredentialType.GOOGLE_SHEETS_CRED]: {
                 displayName: 'Google Sheets',
                 defaultScopes: ['https://www.googleapis.com/auth/spreadsheets'],
                 description: 'Access Google Sheets for reading and writing spreadsheet data',
+                scopeDescriptions: [
+                    {
+                        scope: 'https://www.googleapis.com/auth/spreadsheets',
+                        description: 'View and manage your Google Sheets spreadsheets',
+                        defaultEnabled: true,
+                    },
+                ],
             },
             [CredentialType.GOOGLE_CALENDAR_CRED]: {
                 displayName: 'Google Calendar',
                 defaultScopes: ['https://www.googleapis.com/auth/calendar'],
                 description: 'Access Google Calendar for reading and managing events',
+                scopeDescriptions: [
+                    {
+                        scope: 'https://www.googleapis.com/auth/calendar',
+                        description: 'View and manage events on all your calendars',
+                        defaultEnabled: true,
+                    },
+                ],
             },
         },
         authorizationParams: {
@@ -75,6 +137,32 @@ export const OAUTH_PROVIDERS = {
             prompt: 'consent', // Force consent screen to ensure refresh token is issued
         },
     },
+    followupboss: {
+        name: 'followupboss',
+        displayName: 'Follow Up Boss',
+        credentialTypes: {
+            [CredentialType.FUB_CRED]: {
+                displayName: 'Follow Up Boss',
+                defaultScopes: [], // FUB doesn't use granular scopes
+                description: 'Access Follow Up Boss CRM for managing contacts, tasks, deals, and more',
+            },
+        },
+        authorizationParams: {
+            response_type: 'auth_code', // FUB uses 'auth_code' instead of standard 'code'
+            prompt: 'login', // FUB supports 'login' to force re-authentication
+        },
+    },
+    notion: {
+        name: 'notion',
+        displayName: 'Notion',
+        credentialTypes: {
+            [CredentialType.NOTION_OAUTH_TOKEN]: {
+                displayName: 'Notion Workspace',
+                defaultScopes: [], // Notion scopes are managed in the integration capabilities
+                description: 'Authorize access to your Notion workspace for searching and reading pages/databases',
+            },
+        },
+    },
 };
 /**
  * Get the OAuth provider for a specific credential type
@@ -94,6 +182,27 @@ export function getOAuthProvider(credentialType) {
 export function isOAuthCredential(credentialType) {
     return getOAuthProvider(credentialType) !== null;
 }
+/**
+ * Get scope descriptions for a specific credential type
+ * Returns an array of scope descriptions that will be requested during OAuth
+ */
+export function getScopeDescriptions(credentialType) {
+    const provider = getOAuthProvider(credentialType);
+    if (!provider) {
+        return [];
+    }
+    const providerConfig = OAUTH_PROVIDERS[provider];
+    const credentialConfig = providerConfig?.credentialTypes[credentialType];
+    if (!credentialConfig?.scopeDescriptions) {
+        // Fallback: create descriptions from scope URLs if not explicitly defined
+        return (credentialConfig?.defaultScopes.map((scope) => ({
+            scope,
+            description: `Access: ${scope}`,
+            defaultEnabled: true, // Default to enabled if in defaultScopes
+        })) || []);
+    }
+    return credentialConfig.scopeDescriptions;
+}
 /**
  * Collection of credential options for all bubbles
  */
@@ -107,6 +216,7 @@ export const BUBBLE_CREDENTIAL_OPTIONS = {
     ],
     postgresql: [CredentialType.DATABASE_CRED],
     slack: [CredentialType.SLACK_CRED],
+    telegram: [CredentialType.TELEGRAM_BOT_TOKEN],
     resend: [CredentialType.RESEND_CRED],
     'database-analyzer': [CredentialType.DATABASE_CRED],
     'slack-notifier': [
@@ -134,9 +244,13 @@ export const BUBBLE_CREDENTIAL_OPTIONS = {
     'sql-query-tool': [CredentialType.DATABASE_CRED],
     'chart-js-tool': [],
     'bubbleflow-validation-tool': [],
+    'code-edit-tool': [CredentialType.OPENROUTER_CRED],
     'web-search-tool': [CredentialType.FIRECRAWL_API_KEY],
     'web-scrape-tool': [CredentialType.FIRECRAWL_API_KEY],
-    'web-crawl-tool': [CredentialType.FIRECRAWL_API_KEY],
+    'web-crawl-tool': [
+        CredentialType.FIRECRAWL_API_KEY,
+        CredentialType.GOOGLE_GEMINI_CRED,
+    ],
     'web-extract-tool': [CredentialType.FIRECRAWL_API_KEY],
     'research-agent-tool': [
         CredentialType.FIRECRAWL_API_KEY,
@@ -148,7 +262,12 @@ export const BUBBLE_CREDENTIAL_OPTIONS = {
         CredentialType.GOOGLE_GEMINI_CRED,
         CredentialType.OPENROUTER_CRED,
     ],
-    'pdf-form-operations': [],
+    'pdf-form-operations': [
+        CredentialType.GOOGLE_GEMINI_CRED,
+        CredentialType.OPENAI_CRED,
+        CredentialType.ANTHROPIC_CRED,
+        CredentialType.OPENROUTER_CRED,
+    ],
     'pdf-ocr-workflow': [
         CredentialType.GOOGLE_GEMINI_CRED,
         CredentialType.OPENAI_CRED,
@@ -182,7 +301,21 @@ export const BUBBLE_CREDENTIAL_OPTIONS = {
     apify: [CredentialType.APIFY_CRED],
     'instagram-tool': [CredentialType.APIFY_CRED],
     'linkedin-tool': [CredentialType.APIFY_CRED],
+    'tiktok-tool': [CredentialType.APIFY_CRED],
+    'twitter-tool': [CredentialType.APIFY_CRED],
+    'google-maps-tool': [CredentialType.APIFY_CRED],
     'youtube-tool': [CredentialType.APIFY_CRED],
+    github: [CredentialType.GITHUB_TOKEN],
+    'eleven-labs': [CredentialType.ELEVENLABS_API_KEY],
+    followupboss: [CredentialType.FUB_CRED],
+    'agi-inc': [CredentialType.AGI_API_KEY],
+    airtable: [CredentialType.AIRTABLE_CRED],
+    notion: [CredentialType.NOTION_OAUTH_TOKEN],
+    firecrawl: [CredentialType.FIRECRAWL_API_KEY],
+    'insforge-db': [
+        CredentialType.INSFORGE_BASE_URL,
+        CredentialType.INSFORGE_API_KEY,
+    ],
 };
 // POST /credentials - Create credential schema
 export const createCredentialSchema = z