beddel 0.2.2 → 0.3.0

package/dist/agents/chat/chat.yaml

@@ -0,0 +1,148 @@
+# Chat Agent - Native Builtin Orchestrator Agent for Beddel Runtime
+# Route: /agents/chat
+# Method: chat.execute
+
+agent:
+  id: chat
+  version: 1.0.0
+  protocol: beddel-declarative-protocol/v2.0
+
+metadata:
+  name: "Q&A Context Chat Agent"
+  description: "Orchestrates RAG pipeline or direct LLM chat based on mode selection"
+  category: "chat"
+  route: "/agents/chat"
+  knowledge_sources:
+    - "gitmcp-agent"
+  tags:
+    - "chat"
+    - "orchestrator"
+    - "rag"
+    - "llm"
+    - "qa"
+
+schema:
+  input:
+    type: "object"
+    properties:
+      messages:
+        type: "array"
+        items:
+          type: "object"
+          properties:
+            role:
+              type: "string"
+              enum: ["user", "assistant", "system"]
+            content:
+              type: "string"
+          required: ["role", "content"]
+        description: "Conversation messages"
+      query:
+        type: "string"
+        description: "Direct query (alternative to messages)"
+      mode:
+        type: "string"
+        enum: ["rag", "simple"]
+        default: "rag"
+        description: "Chat mode: 'rag' for knowledge-based answers, 'simple' for direct LLM chat"
+      knowledge_sources:
+        type: "array"
+        items:
+          type: "string"
+        description: "GitMCP URLs to use as knowledge sources"
+    required: ["messages"]
+
+  output:
+    type: "object"
+    properties:
+      response:
+        type: "string"
+        description: "Generated answer"
+      timestamp:
+        type: "string"
+        description: "ISO timestamp"
+      execution_steps:
+        type: "array"
+        description: "Detailed execution steps for observability"
+      total_duration:
+        type: "number"
+        description: "Total execution time in milliseconds"
+    required: ["response", "timestamp"]
+
+logic:
+  variables:
+    - name: "userQuery"
+      type: "string"
+      init: '""'
+    - name: "allDocuments"
+      type: "string"
+      init: '""'
+
+  workflow:
+    # Step 1: Extract user query from messages
+    - name: "extract-query"
+      type: "output-generator"
+      action:
+        type: "generate"
+        output:
+          _extracted: true
+
+    # Step 2: Mode branch - Simple LLM chat or RAG pipeline
+    - name: "mode-check"
+      type: "conditional"
+      condition: "$input.mode == 'simple'"
+      then:
+        # Simple mode: Direct LLM chat with conversation history (no documents)
+        - name: "simple-chat"
+          type: "llm"
+          action:
+            query: "$input.query"
+            history: "$input.messages"
+            result: "llmResult"
+      else:
+        # RAG mode: Full pipeline with knowledge base
+        - name: "vectorize-query"
+          type: "gemini-vectorize"
+          action:
+            action: "embedSingle"
+            text: "$input.query"
+            result: "queryVector"
+
+        - name: "check-knowledge"
+          type: "chromadb"
+          action:
+            action: "hasData"
+            collection_name: "beddel_knowledge"
+            min_count: 5
+            result: "hasDataResult"
+
+        - name: "search-knowledge"
+          type: "chromadb"
+          action:
+            action: "search"
+            collection_name: "beddel_knowledge"
+            query_vector: "$queryVector.vector"
+            limit: 5
+            result: "searchResult"
+
+        - name: "generate-answer"
+          type: "rag"
+          action:
+            query: "$input.query"
+            documents: "$searchResult.documents"
+            history: "$input.messages"
+            result: "ragResult"
+
+    # Step 3: Deliver final response
+    - name: "deliver-response"
+      type: "output-generator"
+      action:
+        type: "generate"
+        output:
+          response: "$ragResult.response"
+          timestamp: "$ragResult.timestamp"
+
+output:
+  schema:
+    response: "$ragResult.response"
+    timestamp: "$ragResult.timestamp"

package/dist/agents/chat/index.d.ts

@@ -0,0 +1,16 @@
+/**
+ * Chat Agent - Public exports (client-safe)
+ */
+export { ChatInputSchema, ChatOutputSchema } from './chat.schema';
+export type { ChatInput, ChatOutput } from './chat.schema';
+export type { ChatHandlerParams, ChatHandlerResult, ChatMetadata } from './chat.types';
+export declare const chatMetadata: {
+    readonly id: "chat";
+    readonly name: "Q&A Context Chat Agent";
+    readonly description: "Orchestrates RAG pipeline: vectorization, storage, retrieval and answer generation";
+    readonly category: "chat";
+    readonly route: "/agents/chat";
+    readonly knowledge_sources: readonly ["gitmcp-agent"];
+    readonly tags: readonly ["chat", "orchestrator", "rag", "qa"];
+};
+//# sourceMappingURL=index.d.ts.map

package/dist/agents/chat/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/agents/chat/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAGH,OAAO,EAAE,eAAe,EAAE,gBAAgB,EAAE,MAAM,eAAe,CAAC;AAClE,YAAY,EAAE,SAAS,EAAE,UAAU,EAAE,MAAM,eAAe,CAAC;AAG3D,YAAY,EAAE,iBAAiB,EAAE,iBAAiB,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC;AAGvF,eAAO,MAAM,YAAY;;;;;;;;CAQf,CAAC"}

package/dist/agents/chat/index.js

@@ -0,0 +1,21 @@
+"use strict";
+/**
+ * Chat Agent - Public exports (client-safe)
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.chatMetadata = exports.ChatOutputSchema = exports.ChatInputSchema = void 0;
+// Schema exports (client-safe)
+var chat_schema_1 = require("./chat.schema");
+Object.defineProperty(exports, "ChatInputSchema", { enumerable: true, get: function () { return chat_schema_1.ChatInputSchema; } });
+Object.defineProperty(exports, "ChatOutputSchema", { enumerable: true, get: function () { return chat_schema_1.ChatOutputSchema; } });
+// Metadata (client-safe)
+exports.chatMetadata = {
+    id: 'chat',
+    name: 'Q&A Context Chat Agent',
+    description: 'Orchestrates RAG pipeline: vectorization, storage, retrieval and answer generation',
+    category: 'chat',
+    route: '/agents/chat',
+    knowledge_sources: ['gitmcp-agent'],
+    tags: ['chat', 'orchestrator', 'rag', 'qa'],
+};
+//# sourceMappingURL=index.js.map

package/dist/agents/chat/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/agents/chat/index.ts"],"names":[],"mappings":";AAAA;;GAEG;;;AAEH,+BAA+B;AAC/B,6CAAkE;AAAzD,8GAAA,eAAe,OAAA;AAAE,+GAAA,gBAAgB,OAAA;AAM1C,yBAAyB;AACZ,QAAA,YAAY,GAAG;IAC1B,EAAE,EAAE,MAAM;IACV,IAAI,EAAE,wBAAwB;IAC9B,WAAW,EAAE,oFAAoF;IACjG,QAAQ,EAAE,MAAM;IAChB,KAAK,EAAE,cAAc;IACrB,iBAAiB,EAAE,CAAC,cAAc,CAAC;IACnC,IAAI,EAAE,CAAC,MAAM,EAAE,cAAc,EAAE,KAAK,EAAE,IAAI,CAAC;CACnC,CAAC"}

package/dist/agents/chromadb/chromadb.handler.d.ts

@@ -0,0 +1,12 @@
+import 'server-only';
+/**
+ * ChromaDB Agent Handler - Server-only execution logic
+ * Vector storage and retrieval using ChromaDB
+ */
+import type { ExecutionContext } from '../../types/executionContext';
+import type { ChromaDBHandlerParams, ChromaDBHandlerResult } from './chromadb.types';
+/**
+ * Execute ChromaDB operations
+ */
+export declare function executeChromaDBHandler(params: ChromaDBHandlerParams, _props: Record<string, string>, context: ExecutionContext): Promise<ChromaDBHandlerResult>;
+//# sourceMappingURL=chromadb.handler.d.ts.map

package/dist/agents/chromadb/chromadb.handler.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"chromadb.handler.d.ts","sourceRoot":"","sources":["../../../src/agents/chromadb/chromadb.handler.ts"],"names":[],"mappings":"AAAA,OAAO,aAAa,CAAC;AAErB;;;GAGG;AAEH,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,8BAA8B,CAAC;AACrE,OAAO,KAAK,EAAE,qBAAqB,EAAE,qBAAqB,EAAwB,MAAM,kBAAkB,CAAC;AAK3G;;GAEG;AACH,wBAAsB,sBAAsB,CAC1C,MAAM,EAAE,qBAAqB,EAC7B,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,EAC9B,OAAO,EAAE,gBAAgB,GACxB,OAAO,CAAC,qBAAqB,CAAC,CA6GhC"}

package/dist/agents/chromadb/chromadb.handler.js

@@ -0,0 +1,139 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.executeChromaDBHandler = executeChromaDBHandler;
+require("server-only");
+// ChromaDB imports (lazy loaded)
+let chromaClient = null;
+/**
+ * Execute ChromaDB operations
+ */
+async function executeChromaDBHandler(params, _props, context) {
+    const action = params.action;
+    const collectionName = params.collection_name;
+    if (!collectionName) {
+        throw new Error('Missing required ChromaDB input: collection_name');
+    }
+    try {
+        // Lazy load ChromaDB
+        if (!chromaClient) {
+            const chromaModule = await Promise.resolve().then(() => __importStar(require('chromadb')));
+            if (process.env.CHROMADB_API_KEY) {
+                context.log('[ChromaDB] Initializing CloudClient...');
+                chromaClient = new chromaModule.CloudClient({
+                    apiKey: process.env.CHROMADB_API_KEY,
+                    tenant: process.env.CHROMADB_TENANT || 'default_tenant',
+                    database: process.env.CHROMADB_DATABASE || 'dev',
+                });
+            }
+            else {
+                context.log('[ChromaDB] Initializing Local ChromaClient...');
+                chromaClient = new chromaModule.ChromaClient({
+                    path: process.env.CHROMADB_URL || 'http://localhost:8000',
+                });
+            }
+        }
+        if (action === 'hasData') {
+            const minCount = params.min_count || 1;
+            context.log(`[ChromaDB] Checking data for collection: ${collectionName}`);
+            try {
+                const collection = await chromaClient.getCollection({
+                    name: collectionName,
+                    embeddingFunction: undefined,
+                });
+                const count = await collection.count();
+                const hasEnoughData = count >= minCount;
+                return { success: true, has_data: hasEnoughData, count };
+            }
+            catch {
+                return { success: true, has_data: false, count: 0 };
+            }
+        }
+        else if (action === 'store') {
+            const ids = params.ids;
+            const vectors = params.vectors;
+            const documents = params.documents;
+            const metadatas = params.metadatas;
+            context.log(`[ChromaDB] Storing ${ids?.length || 0} items in ${collectionName}...`);
+            const collection = await chromaClient.getOrCreateCollection({
+                name: collectionName,
+                embeddingFunction: undefined,
+            });
+            await collection.add({
+                ids,
+                embeddings: vectors,
+                documents,
+                metadatas,
+            });
+            return { success: true, stored_count: ids?.length || 0 };
+        }
+        else if (action === 'search') {
+            const queryVector = params.query_vector;
+            const limit = params.limit || 5;
+            context.log(`[ChromaDB] Searching ${collectionName}...`);
+            try {
+                const collection = await chromaClient.getCollection({
+                    name: collectionName,
+                    embeddingFunction: undefined,
+                });
+                const results = await collection.query({
+                    queryEmbeddings: [queryVector],
+                    nResults: limit,
+                });
+                const flatResults = (results.documents[0] || []).map((doc, idx) => ({
+                    text: doc,
+                    metadata: results.metadatas[0]?.[idx] || null,
+                    distance: results.distances?.[0]?.[idx] || null,
+                }));
+                const documentsString = flatResults.map((r) => r.text).join('\n\n---\n\n');
+                return { success: true, results: flatResults, documents: documentsString };
+            }
+            catch {
+                // Collection doesn't exist - return empty results
+                context.log(`[ChromaDB] Collection ${collectionName} not found, returning empty results`);
+                return { success: true, results: [], documents: '' };
+            }
+        }
+        else {
+            throw new Error(`Unknown ChromaDB action: ${action}`);
+        }
+    }
+    catch (error) {
+        const message = error instanceof Error ? error.message : String(error);
+        context.log(`[ChromaDB] Error: ${message}`);
+        return { success: false, error: message };
+    }
+}
+//# sourceMappingURL=chromadb.handler.js.map

package/dist/agents/chromadb/chromadb.handler.js.map

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

package/dist/agents/chromadb/chromadb.schema.d.ts

@@ -0,0 +1,36 @@
+/**
+ * ChromaDB Agent Schema - Zod validation schemas
+ * Safe for both client and server
+ */
+import { z } from 'zod';
+export declare const ChromaDBInputSchema: z.ZodObject<{
+    action: z.ZodEnum<{
+        search: "search";
+        hasData: "hasData";
+        store: "store";
+    }>;
+    collection_name: z.ZodString;
+    min_count: z.ZodOptional<z.ZodNumber>;
+    ids: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    vectors: z.ZodOptional<z.ZodArray<z.ZodArray<z.ZodNumber>>>;
+    documents: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    metadatas: z.ZodOptional<z.ZodArray<z.ZodRecord<z.ZodString, z.ZodUnknown>>>;
+    query_vector: z.ZodOptional<z.ZodArray<z.ZodNumber>>;
+    limit: z.ZodOptional<z.ZodNumber>;
+}, z.core.$strip>;
+export declare const ChromaDBOutputSchema: z.ZodObject<{
+    success: z.ZodBoolean;
+    has_data: z.ZodOptional<z.ZodBoolean>;
+    count: z.ZodOptional<z.ZodNumber>;
+    stored_count: z.ZodOptional<z.ZodNumber>;
+    results: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        text: z.ZodNullable<z.ZodString>;
+        metadata: z.ZodNullable<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+        distance: z.ZodNullable<z.ZodNumber>;
+    }, z.core.$strip>>>;
+    documents: z.ZodOptional<z.ZodString>;
+    error: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+export type ChromaDBInput = z.infer<typeof ChromaDBInputSchema>;
+export type ChromaDBOutput = z.infer<typeof ChromaDBOutputSchema>;
+//# sourceMappingURL=chromadb.schema.d.ts.map

package/dist/agents/chromadb/chromadb.schema.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"chromadb.schema.d.ts","sourceRoot":"","sources":["../../../src/agents/chromadb/chromadb.schema.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,eAAO,MAAM,mBAAmB;;;;;;;;;;;;;;iBAU9B,CAAC;AAEH,eAAO,MAAM,oBAAoB;;;;;;;;;;;;iBAY/B,CAAC;AAEH,MAAM,MAAM,aAAa,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,mBAAmB,CAAC,CAAC;AAChE,MAAM,MAAM,cAAc,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,oBAAoB,CAAC,CAAC"}

package/dist/agents/chromadb/chromadb.schema.js

@@ -0,0 +1,33 @@
+"use strict";
+/**
+ * ChromaDB Agent Schema - Zod validation schemas
+ * Safe for both client and server
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ChromaDBOutputSchema = exports.ChromaDBInputSchema = void 0;
+const zod_1 = require("zod");
+exports.ChromaDBInputSchema = zod_1.z.object({
+    action: zod_1.z.enum(['hasData', 'store', 'search']),
+    collection_name: zod_1.z.string().min(1),
+    min_count: zod_1.z.number().optional(),
+    ids: zod_1.z.array(zod_1.z.string()).optional(),
+    vectors: zod_1.z.array(zod_1.z.array(zod_1.z.number())).optional(),
+    documents: zod_1.z.array(zod_1.z.string()).optional(),
+    metadatas: zod_1.z.array(zod_1.z.record(zod_1.z.string(), zod_1.z.unknown())).optional(),
+    query_vector: zod_1.z.array(zod_1.z.number()).optional(),
+    limit: zod_1.z.number().optional(),
+});
+exports.ChromaDBOutputSchema = zod_1.z.object({
+    success: zod_1.z.boolean(),
+    has_data: zod_1.z.boolean().optional(),
+    count: zod_1.z.number().optional(),
+    stored_count: zod_1.z.number().optional(),
+    results: zod_1.z.array(zod_1.z.object({
+        text: zod_1.z.string().nullable(),
+        metadata: zod_1.z.record(zod_1.z.string(), zod_1.z.unknown()).nullable(),
+        distance: zod_1.z.number().nullable(),
+    })).optional(),
+    documents: zod_1.z.string().optional(),
+    error: zod_1.z.string().optional(),
+});
+//# sourceMappingURL=chromadb.schema.js.map

package/dist/agents/chromadb/chromadb.schema.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"chromadb.schema.js","sourceRoot":"","sources":["../../../src/agents/chromadb/chromadb.schema.ts"],"names":[],"mappings":";AAAA;;;GAGG;;;AAEH,6BAAwB;AAEX,QAAA,mBAAmB,GAAG,OAAC,CAAC,MAAM,CAAC;IAC1C,MAAM,EAAE,OAAC,CAAC,IAAI,CAAC,CAAC,SAAS,EAAE,OAAO,EAAE,QAAQ,CAAC,CAAC;IAC9C,eAAe,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;IAClC,SAAS,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAChC,GAAG,EAAE,OAAC,CAAC,KAAK,CAAC,OAAC,CAAC,MAAM,EAAE,CAAC,CAAC,QAAQ,EAAE;IACnC,OAAO,EAAE,OAAC,CAAC,KAAK,CAAC,OAAC,CAAC,KAAK,CAAC,OAAC,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC,QAAQ,EAAE;IAChD,SAAS,EAAE,OAAC,CAAC,KAAK,CAAC,OAAC,CAAC,MAAM,EAAE,CAAC,CAAC,QAAQ,EAAE;IACzC,SAAS,EAAE,OAAC,CAAC,KAAK,CAAC,OAAC,CAAC,MAAM,CAAC,OAAC,CAAC,MAAM,EAAE,EAAE,OAAC,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC,QAAQ,EAAE;IAChE,YAAY,EAAE,OAAC,CAAC,KAAK,CAAC,OAAC,CAAC,MAAM,EAAE,CAAC,CAAC,QAAQ,EAAE;IAC5C,KAAK,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;CAC7B,CAAC,CAAC;AAEU,QAAA,oBAAoB,GAAG,OAAC,CAAC,MAAM,CAAC;IAC3C,OAAO,EAAE,OAAC,CAAC,OAAO,EAAE;IACpB,QAAQ,EAAE,OAAC,CAAC,OAAO,EAAE,CAAC,QAAQ,EAAE;IAChC,KAAK,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAC5B,YAAY,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IACnC,OAAO,EAAE,OAAC,CAAC,KAAK,CAAC,OAAC,CAAC,MAAM,CAAC;QACxB,IAAI,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;QAC3B,QAAQ,EAAE,OAAC,CAAC,MAAM,CAAC,OAAC,CAAC,MAAM,EAAE,EAAE,OAAC,CAAC,OAAO,EAAE,CAAC,CAAC,QAAQ,EAAE;QACtD,QAAQ,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;KAChC,CAAC,CAAC,CAAC,QAAQ,EAAE;IACd,SAAS,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAChC,KAAK,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;CAC7B,CAAC,CAAC"}

package/dist/agents/chromadb/chromadb.types.d.ts

@@ -0,0 +1,49 @@
+/**
+ * ChromaDB Agent Types - Shared between client and server
+ */
+/**
+ * Parameters for ChromaDB operations
+ */
+export interface ChromaDBHandlerParams {
+    action: 'hasData' | 'store' | 'search';
+    collection_name: string;
+    min_count?: number;
+    ids?: string[];
+    vectors?: number[][];
+    documents?: string[];
+    metadatas?: Record<string, unknown>[];
+    query_vector?: number[];
+    limit?: number;
+}
+/**
+ * Search result item
+ */
+export interface ChromaDBSearchResult {
+    text: string | null;
+    metadata: Record<string, unknown> | null;
+    distance: number | null;
+}
+/**
+ * Result from ChromaDB operations
+ */
+export interface ChromaDBHandlerResult {
+    success: boolean;
+    has_data?: boolean;
+    count?: number;
+    stored_count?: number;
+    results?: ChromaDBSearchResult[];
+    documents?: string;
+    error?: string;
+}
+/**
+ * ChromaDB agent metadata
+ */
+export interface ChromaDBMetadata {
+    id: 'chromadb';
+    name: string;
+    description: string;
+    category: 'database';
+    route: '/agents/chromadb';
+    tags: string[];
+}
+//# sourceMappingURL=chromadb.types.d.ts.map

package/dist/agents/chromadb/chromadb.types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"chromadb.types.d.ts","sourceRoot":"","sources":["../../../src/agents/chromadb/chromadb.types.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH;;GAEG;AACH,MAAM,WAAW,qBAAqB;IACpC,MAAM,EAAE,SAAS,GAAG,OAAO,GAAG,QAAQ,CAAC;IACvC,eAAe,EAAE,MAAM,CAAC;IACxB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,GAAG,CAAC,EAAE,MAAM,EAAE,CAAC;IACf,OAAO,CAAC,EAAE,MAAM,EAAE,EAAE,CAAC;IACrB,SAAS,CAAC,EAAE,MAAM,EAAE,CAAC;IACrB,SAAS,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,CAAC;IACtC,YAAY,CAAC,EAAE,MAAM,EAAE,CAAC;IACxB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED;;GAEG;AACH,MAAM,WAAW,oBAAoB;IACnC,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;IACpB,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAAC;IACzC,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;CACzB;AAED;;GAEG;AACH,MAAM,WAAW,qBAAqB;IACpC,OAAO,EAAE,OAAO,CAAC;IACjB,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,OAAO,CAAC,EAAE,oBAAoB,EAAE,CAAC;IACjC,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B,EAAE,EAAE,UAAU,CAAC;IACf,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,QAAQ,EAAE,UAAU,CAAC;IACrB,KAAK,EAAE,kBAAkB,CAAC;IAC1B,IAAI,EAAE,MAAM,EAAE,CAAC;CAChB"}

package/dist/agents/chromadb/chromadb.types.js

@@ -0,0 +1,6 @@
+"use strict";
+/**
+ * ChromaDB Agent Types - Shared between client and server
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=chromadb.types.js.map

package/dist/agents/chromadb/chromadb.types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"chromadb.types.js","sourceRoot":"","sources":["../../../src/agents/chromadb/chromadb.types.ts"],"names":[],"mappings":";AAAA;;GAEG"}

package/dist/agents/chromadb/chromadb.yaml

@@ -0,0 +1,128 @@
+# ChromaDB Agent - Native Builtin Agent for Beddel Runtime
+# Route: /agents/chromadb
+# Method: chromadb.execute
+
+agent:
+  id: chromadb
+  version: 1.0.0
+  protocol: beddel-declarative-protocol/v2.0
+
+metadata:
+  name: "ChromaDB Agent"
+  description: "Vector storage and retrieval using ChromaDB. Supports local and cloud deployments."
+  category: "database"
+  route: "/agents/chromadb"
+  tags:
+    - "chromadb"
+    - "storage"
+    - "vector-db"
+    - "rag"
+
+schema:
+  input:
+    type: "object"
+    properties:
+      action:
+        type: "string"
+        enum: ["hasData", "store", "search"]
+        description: "Action to perform"
+      collection_name:
+        type: "string"
+        description: "Name of the ChromaDB collection"
+      min_count:
+        type: "number"
+        description: "Minimum document count for hasData action (default: 1)"
+      ids:
+        type: "array"
+        items:
+          type: "string"
+        description: "Document IDs for store action"
+      vectors:
+        type: "array"
+        items:
+          type: "array"
+          items:
+            type: "number"
+        description: "Embedding vectors for store action"
+      documents:
+        type: "array"
+        items:
+          type: "string"
+        description: "Document texts for store action"
+      metadatas:
+        type: "array"
+        items:
+          type: "object"
+        description: "Metadata objects for store action"
+      query_vector:
+        type: "array"
+        items:
+          type: "number"
+        description: "Query embedding vector for search action"
+      limit:
+        type: "number"
+        description: "Maximum results for search action (default: 5)"
+    required: ["action", "collection_name"]
+
+  output:
+    type: "object"
+    properties:
+      success:
+        type: "boolean"
+      has_data:
+        type: "boolean"
+        description: "Whether collection has sufficient data (hasData action)"
+      count:
+        type: "number"
+        description: "Document count in collection (hasData action)"
+      stored_count:
+        type: "number"
+        description: "Number of documents stored (store action)"
+      results:
+        type: "array"
+        description: "Search results with text, metadata and distance (search action)"
+      documents:
+        type: "string"
+        description: "Concatenated document texts (search action)"
+      error:
+        type: "string"
+    required: ["success"]
+
+logic:
+  workflow:
+    - name: "chromadb-operation"
+      type: "chromadb"
+      action:
+        action: "$input.action"
+        collection_name: "$input.collection_name"
+        min_count: "$input.min_count"
+        ids: "$input.ids"
+        vectors: "$input.vectors"
+        documents: "$input.documents"
+        metadatas: "$input.metadatas"
+        query_vector: "$input.query_vector"
+        limit: "$input.limit"
+        result: "chromaResult"
+
+    - name: "deliver-response"
+      type: "output-generator"
+      action:
+        type: "generate"
+        output:
+          success: "$chromaResult.success"
+          has_data: "$chromaResult.has_data"
+          count: "$chromaResult.count"
+          stored_count: "$chromaResult.stored_count"
+          results: "$chromaResult.results"
+          documents: "$chromaResult.documents"
+          error: "$chromaResult.error"
+
+output:
+  schema:
+    success: "$chromaResult.success"
+    has_data: "$chromaResult.has_data"
+    count: "$chromaResult.count"
+    stored_count: "$chromaResult.stored_count"
+    results: "$chromaResult.results"
+    documents: "$chromaResult.documents"
+    error: "$chromaResult.error"

package/dist/agents/chromadb/index.d.ts

@@ -0,0 +1,15 @@
+/**
+ * ChromaDB Agent - Public exports (client-safe)
+ */
+export { ChromaDBInputSchema, ChromaDBOutputSchema } from './chromadb.schema';
+export type { ChromaDBInput, ChromaDBOutput } from './chromadb.schema';
+export type { ChromaDBHandlerParams, ChromaDBHandlerResult, ChromaDBSearchResult, ChromaDBMetadata } from './chromadb.types';
+export declare const chromadbMetadata: {
+    readonly id: "chromadb";
+    readonly name: "ChromaDB Agent";
+    readonly description: "Vector storage and retrieval using ChromaDB. Supports local and cloud deployments.";
+    readonly category: "database";
+    readonly route: "/agents/chromadb";
+    readonly tags: readonly ["chromadb", "storage", "vector-db", "rag"];
+};
+//# sourceMappingURL=index.d.ts.map

package/dist/agents/chromadb/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/agents/chromadb/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAGH,OAAO,EAAE,mBAAmB,EAAE,oBAAoB,EAAE,MAAM,mBAAmB,CAAC;AAC9E,YAAY,EAAE,aAAa,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAC;AAGvE,YAAY,EAAE,qBAAqB,EAAE,qBAAqB,EAAE,oBAAoB,EAAE,gBAAgB,EAAE,MAAM,kBAAkB,CAAC;AAG7H,eAAO,MAAM,gBAAgB;;;;;;;CAOnB,CAAC"}