@bubblelab/bubble-core 0.1.122 → 0.1.124

package/dist/bubbles/tool-bubble/list-bubbles-tool.d.ts

@@ -31,6 +31,7 @@ declare const ListBubblesToolResultSchema: z.ZodObject<{
 }, "strip", z.ZodTypeAny, {
     error: string;
     success: boolean;
+    totalCount: number;
     bubbles: {
         type: string;
         name: string;
@@ -38,10 +39,10 @@ declare const ListBubblesToolResultSchema: z.ZodObject<{
         useCase: string;
         alias?: string | undefined;
     }[];
-    totalCount: number;
 }, {
     error: string;
     success: boolean;
+    totalCount: number;
     bubbles: {
         type: string;
         name: string;
@@ -49,7 +50,6 @@ declare const ListBubblesToolResultSchema: z.ZodObject<{
         useCase: string;
         alias?: string | undefined;
     }[];
-    totalCount: number;
 }>;
 export declare class ListBubblesTool extends ToolBubble<ListBubblesToolParams, ListBubblesToolResult> {
     static readonly bubbleName = "list-bubbles-tool";
@@ -80,6 +80,7 @@ export declare class ListBubblesTool extends ToolBubble<ListBubblesToolParams, L
     }, "strip", z.ZodTypeAny, {
         error: string;
         success: boolean;
+        totalCount: number;
         bubbles: {
             type: string;
             name: string;
@@ -87,10 +88,10 @@ export declare class ListBubblesTool extends ToolBubble<ListBubblesToolParams, L
             useCase: string;
             alias?: string | undefined;
         }[];
-        totalCount: number;
     }, {
         error: string;
         success: boolean;
+        totalCount: number;
         bubbles: {
             type: string;
             name: string;
@@ -98,7 +99,6 @@ export declare class ListBubblesTool extends ToolBubble<ListBubblesToolParams, L
             useCase: string;
             alias?: string | undefined;
         }[];
-        totalCount: number;
     }>;
     static readonly shortDescription = "Lists all available bubbles in the registry";
     static readonly longDescription = "\n    A tool bubble that provides a comprehensive list of all registered bubbles in the NodeX system.\n    \n    Returns information about each bubble including:\n    - Bubble name and alias\n    - Short description\n    - Extracted use cases\n    - Bubble type (service, workflow, tool)\n    \n    Use cases:\n    - AI agent discovery of available capabilities\n    - System introspection and documentation\n    - Dynamic tool selection for workflow building\n  ";

package/dist/bubbles/tool-bubble/list-capabilities-tool.d.ts

@@ -0,0 +1,235 @@
+import { z } from 'zod';
+import { ToolBubble } from '../../types/tool-bubble-class.js';
+import type { BubbleContext } from '../../types/bubble.js';
+declare const ListCapabilitiesToolParamsSchema: z.ZodObject<{}, "strip", z.ZodTypeAny, {}, {}>;
+type ListCapabilitiesToolParamsInput = z.input<typeof ListCapabilitiesToolParamsSchema>;
+type ListCapabilitiesToolParams = z.output<typeof ListCapabilitiesToolParamsSchema>;
+type ListCapabilitiesToolResult = z.output<typeof ListCapabilitiesToolResultSchema>;
+declare const ListCapabilitiesToolResultSchema: z.ZodObject<{
+    capabilities: z.ZodArray<z.ZodObject<{
+        id: z.ZodString;
+        name: z.ZodString;
+        description: z.ZodString;
+        category: z.ZodOptional<z.ZodString>;
+        requiredCredentials: z.ZodArray<z.ZodString, "many">;
+        optionalCredentials: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+        inputs: z.ZodArray<z.ZodObject<{
+            name: z.ZodString;
+            description: z.ZodString;
+        }, "strip", z.ZodTypeAny, {
+            description: string;
+            name: string;
+        }, {
+            description: string;
+            name: string;
+        }>, "many">;
+        tools: z.ZodArray<z.ZodObject<{
+            name: z.ZodString;
+            description: z.ZodString;
+        }, "strip", z.ZodTypeAny, {
+            description: string;
+            name: string;
+        }, {
+            description: string;
+            name: string;
+        }>, "many">;
+        delegationHint: z.ZodOptional<z.ZodString>;
+    }, "strip", z.ZodTypeAny, {
+        description: string;
+        name: string;
+        id: string;
+        requiredCredentials: string[];
+        inputs: {
+            description: string;
+            name: string;
+        }[];
+        tools: {
+            description: string;
+            name: string;
+        }[];
+        category?: string | undefined;
+        optionalCredentials?: string[] | undefined;
+        delegationHint?: string | undefined;
+    }, {
+        description: string;
+        name: string;
+        id: string;
+        requiredCredentials: string[];
+        inputs: {
+            description: string;
+            name: string;
+        }[];
+        tools: {
+            description: string;
+            name: string;
+        }[];
+        category?: string | undefined;
+        optionalCredentials?: string[] | undefined;
+        delegationHint?: string | undefined;
+    }>, "many">;
+    totalCount: z.ZodNumber;
+    success: z.ZodBoolean;
+    error: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    error: string;
+    success: boolean;
+    capabilities: {
+        description: string;
+        name: string;
+        id: string;
+        requiredCredentials: string[];
+        inputs: {
+            description: string;
+            name: string;
+        }[];
+        tools: {
+            description: string;
+            name: string;
+        }[];
+        category?: string | undefined;
+        optionalCredentials?: string[] | undefined;
+        delegationHint?: string | undefined;
+    }[];
+    totalCount: number;
+}, {
+    error: string;
+    success: boolean;
+    capabilities: {
+        description: string;
+        name: string;
+        id: string;
+        requiredCredentials: string[];
+        inputs: {
+            description: string;
+            name: string;
+        }[];
+        tools: {
+            description: string;
+            name: string;
+        }[];
+        category?: string | undefined;
+        optionalCredentials?: string[] | undefined;
+        delegationHint?: string | undefined;
+    }[];
+    totalCount: number;
+}>;
+export declare class ListCapabilitiesTool extends ToolBubble<ListCapabilitiesToolParams, ListCapabilitiesToolResult> {
+    static readonly bubbleName = "list-capabilities-tool";
+    static readonly schema: z.ZodObject<{}, "strip", z.ZodTypeAny, {}, {}>;
+    static readonly resultSchema: z.ZodObject<{
+        capabilities: z.ZodArray<z.ZodObject<{
+            id: z.ZodString;
+            name: z.ZodString;
+            description: z.ZodString;
+            category: z.ZodOptional<z.ZodString>;
+            requiredCredentials: z.ZodArray<z.ZodString, "many">;
+            optionalCredentials: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+            inputs: z.ZodArray<z.ZodObject<{
+                name: z.ZodString;
+                description: z.ZodString;
+            }, "strip", z.ZodTypeAny, {
+                description: string;
+                name: string;
+            }, {
+                description: string;
+                name: string;
+            }>, "many">;
+            tools: z.ZodArray<z.ZodObject<{
+                name: z.ZodString;
+                description: z.ZodString;
+            }, "strip", z.ZodTypeAny, {
+                description: string;
+                name: string;
+            }, {
+                description: string;
+                name: string;
+            }>, "many">;
+            delegationHint: z.ZodOptional<z.ZodString>;
+        }, "strip", z.ZodTypeAny, {
+            description: string;
+            name: string;
+            id: string;
+            requiredCredentials: string[];
+            inputs: {
+                description: string;
+                name: string;
+            }[];
+            tools: {
+                description: string;
+                name: string;
+            }[];
+            category?: string | undefined;
+            optionalCredentials?: string[] | undefined;
+            delegationHint?: string | undefined;
+        }, {
+            description: string;
+            name: string;
+            id: string;
+            requiredCredentials: string[];
+            inputs: {
+                description: string;
+                name: string;
+            }[];
+            tools: {
+                description: string;
+                name: string;
+            }[];
+            category?: string | undefined;
+            optionalCredentials?: string[] | undefined;
+            delegationHint?: string | undefined;
+        }>, "many">;
+        totalCount: z.ZodNumber;
+        success: z.ZodBoolean;
+        error: z.ZodString;
+    }, "strip", z.ZodTypeAny, {
+        error: string;
+        success: boolean;
+        capabilities: {
+            description: string;
+            name: string;
+            id: string;
+            requiredCredentials: string[];
+            inputs: {
+                description: string;
+                name: string;
+            }[];
+            tools: {
+                description: string;
+                name: string;
+            }[];
+            category?: string | undefined;
+            optionalCredentials?: string[] | undefined;
+            delegationHint?: string | undefined;
+        }[];
+        totalCount: number;
+    }, {
+        error: string;
+        success: boolean;
+        capabilities: {
+            description: string;
+            name: string;
+            id: string;
+            requiredCredentials: string[];
+            inputs: {
+                description: string;
+                name: string;
+            }[];
+            tools: {
+                description: string;
+                name: string;
+            }[];
+            category?: string | undefined;
+            optionalCredentials?: string[] | undefined;
+            delegationHint?: string | undefined;
+        }[];
+        totalCount: number;
+    }>;
+    static readonly shortDescription = "Lists all available capabilities that can be attached to AI agents";
+    static readonly longDescription = "\n    A tool that lists all registered capabilities \u2014 pre-built skill packs for AIAgentBubble.\n\n    Capabilities bundle tools, system prompts, credential requirements, and user inputs\n    into a declarative config that can be attached to AI agents.\n\n    Returns information about each capability including:\n    - ID, name, description, and category\n    - Required and optional credentials\n    - User-configurable inputs\n    - Tools provided by the capability\n    - Delegation hint for when to use\n\n    Use cases:\n    - Discovering available capabilities before building AI agent workflows\n    - Checking if a pre-built capability exists instead of manually wiring tools\n    - Understanding what credentials and inputs a capability needs\n  ";
+    static readonly alias = "list-caps";
+    static readonly type = "tool";
+    constructor(params?: ListCapabilitiesToolParamsInput, context?: BubbleContext);
+    performAction(context?: BubbleContext): Promise<ListCapabilitiesToolResult>;
+}
+export {};
+//# sourceMappingURL=list-capabilities-tool.d.ts.map

package/dist/bubbles/tool-bubble/list-capabilities-tool.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"list-capabilities-tool.d.ts","sourceRoot":"","sources":["../../../src/bubbles/tool-bubble/list-capabilities-tool.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,UAAU,EAAE,MAAM,kCAAkC,CAAC;AAC9D,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,uBAAuB,CAAC;AAI3D,QAAA,MAAM,gCAAgC,gDAAe,CAAC;AAGtD,KAAK,+BAA+B,GAAG,CAAC,CAAC,KAAK,CAC5C,OAAO,gCAAgC,CACxC,CAAC;AACF,KAAK,0BAA0B,GAAG,CAAC,CAAC,MAAM,CACxC,OAAO,gCAAgC,CACxC,CAAC;AACF,KAAK,0BAA0B,GAAG,CAAC,CAAC,MAAM,CACxC,OAAO,gCAAgC,CACxC,CAAC;AAGF,QAAA,MAAM,gCAAgC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EA4CpC,CAAC;AAEH,qBAAa,oBAAqB,SAAQ,UAAU,CAClD,0BAA0B,EAC1B,0BAA0B,CAC3B;IAEC,MAAM,CAAC,QAAQ,CAAC,UAAU,4BAA4B;IACtD,MAAM,CAAC,QAAQ,CAAC,MAAM,iDAAoC;IAC1D,MAAM,CAAC,QAAQ,CAAC,YAAY;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OAAoC;IAChE,MAAM,CAAC,QAAQ,CAAC,gBAAgB,wEACuC;IACvE,MAAM,CAAC,QAAQ,CAAC,eAAe,8vBAiB7B;IACF,MAAM,CAAC,QAAQ,CAAC,KAAK,eAAe;IACpC,MAAM,CAAC,QAAQ,CAAC,IAAI,UAAU;gBAG5B,MAAM,GAAE,+BAAoC,EAC5C,OAAO,CAAC,EAAE,aAAa;IAKnB,aAAa,CACjB,OAAO,CAAC,EAAE,aAAa,GACtB,OAAO,CAAC,0BAA0B,CAAC;CAgCvC"}

package/dist/bubbles/tool-bubble/list-capabilities-tool.js

@@ -0,0 +1,105 @@
+import { z } from 'zod';
+import { ToolBubble } from '../../types/tool-bubble-class.js';
+import { getAllCapabilityMetadata } from '../../capabilities/index.js';
+// Define the parameters schema (no params needed)
+const ListCapabilitiesToolParamsSchema = z.object({});
+// Result schema for validation
+const ListCapabilitiesToolResultSchema = z.object({
+    capabilities: z
+        .array(z.object({
+        id: z.string().describe('Unique identifier for the capability'),
+        name: z.string().describe('Display name of the capability'),
+        description: z.string().describe('What the capability does'),
+        category: z
+            .string()
+            .optional()
+            .describe('Category grouping (e.g., knowledge, data)'),
+        requiredCredentials: z
+            .array(z.string())
+            .describe('Credential types that must be provided'),
+        optionalCredentials: z
+            .array(z.string())
+            .optional()
+            .describe('Credential types that can optionally be provided'),
+        inputs: z
+            .array(z.object({
+            name: z.string(),
+            description: z.string(),
+        }))
+            .describe('User-configurable input parameters'),
+        tools: z
+            .array(z.object({
+            name: z.string(),
+            description: z.string(),
+        }))
+            .describe('Tools provided by this capability'),
+        delegationHint: z
+            .string()
+            .optional()
+            .describe('Guidance on when to use this capability'),
+    }))
+        .describe('Array of capability summary objects'),
+    totalCount: z.number().describe('Total number of registered capabilities'),
+    success: z.boolean().describe('Whether the operation was successful'),
+    error: z.string().describe('Error message if operation failed'),
+});
+export class ListCapabilitiesTool extends ToolBubble {
+    // Required static metadata
+    static bubbleName = 'list-capabilities-tool';
+    static schema = ListCapabilitiesToolParamsSchema;
+    static resultSchema = ListCapabilitiesToolResultSchema;
+    static shortDescription = 'Lists all available capabilities that can be attached to AI agents';
+    static longDescription = `
+    A tool that lists all registered capabilities — pre-built skill packs for AIAgentBubble.
+
+    Capabilities bundle tools, system prompts, credential requirements, and user inputs
+    into a declarative config that can be attached to AI agents.
+
+    Returns information about each capability including:
+    - ID, name, description, and category
+    - Required and optional credentials
+    - User-configurable inputs
+    - Tools provided by the capability
+    - Delegation hint for when to use
+
+    Use cases:
+    - Discovering available capabilities before building AI agent workflows
+    - Checking if a pre-built capability exists instead of manually wiring tools
+    - Understanding what credentials and inputs a capability needs
+  `;
+    static alias = 'list-caps';
+    static type = 'tool';
+    constructor(params = {}, context) {
+        super(params, context);
+    }
+    async performAction(context) {
+        void context;
+        const allMetadata = getAllCapabilityMetadata();
+        const capabilities = allMetadata
+            .filter((meta) => !meta.hidden)
+            .map((meta) => ({
+            id: meta.id,
+            name: meta.name,
+            description: meta.description,
+            category: meta.category,
+            requiredCredentials: meta.requiredCredentials,
+            optionalCredentials: meta.optionalCredentials,
+            inputs: meta.inputs.map((input) => ({
+                name: input.name,
+                description: input.description,
+            })),
+            tools: meta.tools.map((tool) => ({
+                name: tool.name,
+                description: tool.description,
+            })),
+            delegationHint: meta.delegationHint,
+        }));
+        return {
+            capabilities,
+            totalCount: capabilities.length,
+            success: true,
+            error: '',
+        };
+    }
+}
+//# sourceMappingURL=list-capabilities-tool.js.map

package/dist/bubbles/tool-bubble/list-capabilities-tool.js.map

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