@bubblelab/shared-schemas 0.1.122 → 0.1.124

package/dist/generate-bubbleflow-schema.d.ts

@@ -342,6 +342,7 @@ export declare const generateBubbleFlowCodeSchema: z.ZodObject<{
                 bubblesUsed?: string[] | undefined;
             }>, "many">;
             estimatedBubbles: z.ZodArray<z.ZodString, "many">;
+            estimatedCapabilities: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
         }, "strip", z.ZodTypeAny, {
             summary: string;
             steps: {
@@ -350,6 +351,7 @@ export declare const generateBubbleFlowCodeSchema: z.ZodObject<{
                 bubblesUsed?: string[] | undefined;
             }[];
             estimatedBubbles: string[];
+            estimatedCapabilities?: string[] | undefined;
         }, {
             summary: string;
             steps: {
@@ -358,6 +360,7 @@ export declare const generateBubbleFlowCodeSchema: z.ZodObject<{
                 bubblesUsed?: string[] | undefined;
             }[];
             estimatedBubbles: string[];
+            estimatedCapabilities?: string[] | undefined;
         }>;
     }, "strip", z.ZodTypeAny, {
         type: "plan";
@@ -371,6 +374,7 @@ export declare const generateBubbleFlowCodeSchema: z.ZodObject<{
                 bubblesUsed?: string[] | undefined;
             }[];
             estimatedBubbles: string[];
+            estimatedCapabilities?: string[] | undefined;
         };
     }, {
         type: "plan";
@@ -384,6 +388,7 @@ export declare const generateBubbleFlowCodeSchema: z.ZodObject<{
                 bubblesUsed?: string[] | undefined;
             }[];
             estimatedBubbles: string[];
+            estimatedCapabilities?: string[] | undefined;
         };
     }>, z.ZodObject<{
         id: z.ZodString;
@@ -539,6 +544,7 @@ export declare const generateBubbleFlowCodeSchema: z.ZodObject<{
                 bubblesUsed?: string[] | undefined;
             }[];
             estimatedBubbles: string[];
+            estimatedCapabilities?: string[] | undefined;
         };
     } | {
         type: "plan_approval";
@@ -649,6 +655,7 @@ export declare const generateBubbleFlowCodeSchema: z.ZodObject<{
                 bubblesUsed?: string[] | undefined;
             }[];
             estimatedBubbles: string[];
+            estimatedCapabilities?: string[] | undefined;
         };
     } | {
         type: "plan_approval";

package/dist/generate-bubbleflow-schema.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"generate-bubbleflow-schema.d.ts","sourceRoot":"","sources":["../src/generate-bubbleflow-schema.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"generate-bubbleflow-schema.d.ts","sourceRoot":"","sources":["../src/generate-bubbleflow-schema.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,CAAC,EAAE,MAAM,mBAAmB,CAAC;AACtC,OAAO,EAAE,mBAAmB,EAAE,MAAM,4BAA4B,CAAC;AACjE,OAAO,EAAE,cAAc,EAAE,MAAM,SAAS,CAAC;AAKzC,eAAO,MAAM,4BAA4B;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAsBvC,CAAC;AAEH,eAAO,MAAM,oCAAoC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAe/C,CAAC;AAEH;;;GAGG;AACH,eAAO,MAAM,sBAAsB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAuCjC,CAAC;AAEH,eAAO,MAAM,gCAAgC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EA2CE,CAAC;AAGhD,eAAO,MAAM,wCAAwC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EA4FE,CAAC;AAGxD,eAAO,MAAM,gCAAgC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAkGL,CAAC;AACzC,MAAM,MAAM,8BAA8B,GAAG,CAAC,CAAC,KAAK,CAClD,OAAO,oCAAoC,CAC5C,CAAC;AACF,MAAM,MAAM,iCAAiC,GAAG,CAAC,CAAC,KAAK,CACrD,OAAO,gCAAgC,CACxC,CAAC;AACF,MAAM,MAAM,yCAAyC,GAAG,CAAC,CAAC,KAAK,CAC7D,OAAO,wCAAwC,CAChD,CAAC;AACF,MAAM,MAAM,0BAA0B,GAAG,CAAC,CAAC,KAAK,CAC9C,OAAO,gCAAgC,CACxC,CAAC;AACF,MAAM,MAAM,gBAAgB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,sBAAsB,CAAC,CAAC"}

package/dist/index.js

@@ -90,6 +90,14 @@ var googleOAuthMetadataSchema = z2.object({
   /** Human-readable display name for the credential (Google account email) */
   displayName: z2.string().optional()
 });
+var notionOAuthMetadataSchema = z2.object({
+  workspaceId: z2.string(),
+  workspaceName: z2.string().optional(),
+  workspaceIcon: z2.string().optional(),
+  botId: z2.string(),
+  /** Human-readable display name for the credential (workspace name) */
+  displayName: z2.string().optional()
+});
 var credentialPreferencesSchema = z2.object({
   /** Whether this credential is the user's default for its credential type */
   isDefault: z2.boolean().optional(),
@@ -128,6 +136,7 @@ var CredentialType = /* @__PURE__ */ ((CredentialType2) => {
   CredentialType2["GOOGLE_CALENDAR_CRED"] = "GOOGLE_CALENDAR_CRED";
   CredentialType2["FUB_CRED"] = "FUB_CRED";
   CredentialType2["NOTION_OAUTH_TOKEN"] = "NOTION_OAUTH_TOKEN";
+  CredentialType2["NOTION_API"] = "NOTION_API";
   CredentialType2["AIRTABLE_OAUTH"] = "AIRTABLE_OAUTH";
   CredentialType2["GITHUB_TOKEN"] = "GITHUB_TOKEN";
   CredentialType2["AGI_API_KEY"] = "AGI_API_KEY";
@@ -310,13 +319,20 @@ var CREDENTIAL_TYPE_CONFIG = {
     credentialConfigurations: {}
   },
   ["NOTION_OAUTH_TOKEN" /* NOTION_OAUTH_TOKEN */]: {
-    label: "Notion",
+    label: "Notion (OAuth)",
     description: "OAuth connection to your Notion workspace (pages, databases, search)",
     placeholder: "",
     // Not used for OAuth
     namePlaceholder: "My Notion Connection",
     credentialConfigurations: {}
   },
+  ["NOTION_API" /* NOTION_API */]: {
+    label: "Notion (API Key)",
+    description: "Internal Integration Token for Notion API access",
+    placeholder: "ntn_...",
+    namePlaceholder: "My Notion API Key",
+    credentialConfigurations: {}
+  },
   ["GITHUB_TOKEN" /* GITHUB_TOKEN */]: {
     label: "GitHub",
     description: "Personal Access Token for GitHub API (read repos, PRs, issues)",
@@ -483,6 +499,7 @@ var CREDENTIAL_ENV_MAP = {
   ["AIRTABLE_OAUTH" /* AIRTABLE_OAUTH */]: "",
   // OAuth credential, no env var
   ["NOTION_OAUTH_TOKEN" /* NOTION_OAUTH_TOKEN */]: "",
+  ["NOTION_API" /* NOTION_API */]: "NOTION_API_KEY",
   ["INSFORGE_BASE_URL" /* INSFORGE_BASE_URL */]: "INSFORGE_BASE_URL",
   ["INSFORGE_API_KEY" /* INSFORGE_API_KEY */]: "INSFORGE_API_KEY",
   ["CUSTOM_AUTH_KEY" /* CUSTOM_AUTH_KEY */]: "",
@@ -642,6 +659,9 @@ var OAUTH_PROVIDERS = {
         // Notion scopes are managed in the integration capabilities
         description: "Authorize access to your Notion workspace for searching and reading pages/databases"
       }
+    },
+    authorizationParams: {
+      owner: "user"
     }
   },
   jira: {
@@ -1393,6 +1413,7 @@ var BUBBLE_CREDENTIAL_OPTIONS = {
   "get-bubble-details-tool": [],
   "get-trigger-detail-tool": [],
   "list-bubbles-tool": [],
+  "list-capabilities-tool": [],
   "sql-query-tool": ["DATABASE_CRED" /* DATABASE_CRED */],
   "chart-js-tool": [],
   "bubbleflow-validation-tool": [],
@@ -1466,7 +1487,7 @@ var BUBBLE_CREDENTIAL_OPTIONS = {
   followupboss: ["FUB_CRED" /* FUB_CRED */],
   "agi-inc": ["AGI_API_KEY" /* AGI_API_KEY */],
   airtable: ["AIRTABLE_CRED" /* AIRTABLE_CRED */, "AIRTABLE_OAUTH" /* AIRTABLE_OAUTH */],
-  notion: ["NOTION_OAUTH_TOKEN" /* NOTION_OAUTH_TOKEN */],
+  notion: ["NOTION_OAUTH_TOKEN" /* NOTION_OAUTH_TOKEN */, "NOTION_API" /* NOTION_API */],
   firecrawl: ["FIRECRAWL_API_KEY" /* FIRECRAWL_API_KEY */],
   "insforge-db": [
     "INSFORGE_BASE_URL" /* INSFORGE_BASE_URL */,
@@ -1586,11 +1607,12 @@ var credentialResponseSchema = z3.object({
     slackOAuthMetadataSchema,
     airtableOAuthMetadataSchema,
     googleOAuthMetadataSchema,
+    notionOAuthMetadataSchema,
     confluenceOAuthMetadataSchema,
     stripeOAuthMetadataSchema,
     credentialPreferencesSchema
   ]).optional().openapi({
-    description: "Credential metadata (DatabaseMetadata, JiraOAuthMetadata, SlackOAuthMetadata, AirtableOAuthMetadata, GoogleOAuthMetadata, ConfluenceOAuthMetadata, StripeOAuthMetadata, or CredentialPreferences)"
+    description: "Credential metadata (DatabaseMetadata, JiraOAuthMetadata, SlackOAuthMetadata, AirtableOAuthMetadata, GoogleOAuthMetadata, NotionOAuthMetadata, ConfluenceOAuthMetadata, StripeOAuthMetadata, or CredentialPreferences)"
   }),
   createdAt: z3.string().openapi({ description: "Creation timestamp" }),
   // OAuth-specific fields
@@ -1721,6 +1743,7 @@ var CREDENTIAL_CONFIGURATION_MAP = {
   ["AIRTABLE_CRED" /* AIRTABLE_CRED */]: {},
   ["AIRTABLE_OAUTH" /* AIRTABLE_OAUTH */]: {},
   ["NOTION_OAUTH_TOKEN" /* NOTION_OAUTH_TOKEN */]: {},
+  ["NOTION_API" /* NOTION_API */]: {},
   ["INSFORGE_BASE_URL" /* INSFORGE_BASE_URL */]: {},
   ["INSFORGE_API_KEY" /* INSFORGE_API_KEY */]: {},
   ["CUSTOM_AUTH_KEY" /* CUSTOM_AUTH_KEY */]: {},
@@ -2632,6 +2655,9 @@ var createBubbleFlowResponseSchema = z8.object({
       "http-request": ["*" /* CREDENTIAL_WILDCARD */]
     }
   }),
+  optionalCredentials: z8.record(z8.string(), z8.array(z8.nativeEnum(CredentialType))).optional().openapi({
+    description: "Mapping of bubble names to their optional credential types (from capability optionalCredentials). Shown in UI but do not block execution."
+  }),
   eventType: z8.string().min(1).openapi({
     description: "Event type this BubbleFlow responds to",
     example: "webhook/http"
@@ -2724,6 +2750,9 @@ var bubbleFlowDetailsResponseSchema = z8.object({
     example: 123
   }),
   requiredCredentials: z8.record(z8.string(), z8.array(z8.nativeEnum(CredentialType))).openapi({ description: "Required credentials by bubble" }),
+  optionalCredentials: z8.record(z8.string(), z8.array(z8.nativeEnum(CredentialType))).optional().openapi({
+    description: "Optional credentials by bubble (from capability optionalCredentials)"
+  }),
   usedCredentials: z8.array(usedCredentialSchema).optional().openapi({
     description: "Credentials used in this flow with metadata (for shared workflow visibility)"
   }),
@@ -3204,7 +3233,10 @@ var PlanStepSchema = z10.object({
 var CoffeePlanEventSchema = z10.object({
   summary: z10.string().describe("Brief overview of the workflow"),
   steps: z10.array(PlanStepSchema).describe("Step-by-step implementation plan"),
-  estimatedBubbles: z10.array(z10.string()).describe("All bubbles that will be used in the workflow")
+  estimatedBubbles: z10.array(z10.string()).describe("All bubbles that will be used in the workflow"),
+  estimatedCapabilities: z10.array(z10.string()).optional().describe(
+    "Capability IDs to attach to AI agents (from list-capabilities-tool). Only pass the id, never inputs."
+  )
 });
 var BaseMessageSchema = z10.object({
   id: z10.string().describe("Unique message identifier"),
@@ -5329,6 +5361,12 @@ function buildParameterObjectLiteral(parameters, options) {
 
 // src/capability-schema.ts
 import { z as z20 } from "zod";
+var CapabilityProviderMetadataSchema = z20.object({
+  value: z20.string().min(1),
+  label: z20.string().min(1),
+  credentialType: z20.nativeEnum(CredentialType),
+  icon: z20.string().min(1)
+});
 var CapabilityInputSchema = z20.object({
   name: z20.string().min(1),
   type: z20.enum(["string", "number", "boolean", "string[]"]),
@@ -5361,7 +5399,17 @@ var CapabilityMetadataSchema = z20.object({
   inputs: z20.array(CapabilityInputSchema),
   tools: z20.array(CapabilityToolDefSchema),
   systemPromptAddition: z20.string().optional(),
-  modelConfigOverride: CapabilityModelConfigOverrideSchema.optional()
+  modelConfigOverride: CapabilityModelConfigOverrideSchema.optional(),
+  /**
+   * Short guidance for the main agent on when to delegate to this capability
+   * in multi-capability mode. E.g. "Delegate when the user asks to remember,
+   * save notes, or look up documents."
+   */
+  delegationHint: z20.string().optional(),
+  /** Hidden capabilities are registered for runtime use but not shown in the UI. */
+  hidden: z20.boolean().optional(),
+  /** Data-driven provider options for the wizard "Choose Providers" step. */
+  providers: z20.array(CapabilityProviderMetadataSchema).optional()
 });
 export {
   AIRTABLE_DELAY_LABELS,
@@ -5388,6 +5436,7 @@ export {
   CapabilityInputSchema,
   CapabilityMetadataSchema,
   CapabilityModelConfigOverrideSchema,
+  CapabilityProviderMetadataSchema,
   CapabilityToolDefSchema,
   ClarificationChoiceSchema,
   ClarificationQuestionSchema,
@@ -5525,6 +5574,7 @@ export {
   listMembersResponseSchema,
   listOrganizationsResponseSchema,
   listTrashResponseSchema,
+  notionOAuthMetadataSchema,
   oauthCallbackRequestSchema,
   oauthInitiateRequestSchema,
   oauthInitiateResponseSchema,