beddel 0.2.3 → 0.3.0

package/dist/runtime/workflowExecutor.js

@@ -1,10 +1,11 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.executeChatHandler = exports.executeRagHandler = exports.executeGitMcpHandler = exports.executeChromaDBHandler = exports.executeVectorizeHandler = exports.executeMcpToolHandler = exports.executeImageHandler = exports.executeTranslationHandler = exports.executeJokeHandler = void 0;
+exports.executeChatHandler = exports.executeLlmHandler = exports.executeRagHandler = exports.executeGitMcpHandler = exports.executeChromaDBHandler = exports.executeVectorizeHandler = exports.executeMcpToolHandler = exports.executeImageHandler = exports.executeTranslationHandler = exports.executeJokeHandler = void 0;
 exports.executeWorkflowStep = executeWorkflowStep;
 exports.getAvailableStepTypes = getAvailableStepTypes;
 exports.isStepTypeSupported = isStepTypeSupported;
 require("server-only");
+const agent_types_1 = require("../shared/types/agent.types");
 // Import handlers from each agent
 const joker_handler_1 = require("../agents/joker/joker.handler");
 Object.defineProperty(exports, "executeJokeHandler", { enumerable: true, get: function () { return joker_handler_1.executeJokeHandler; } });
@@ -22,14 +23,15 @@ const gitmcp_handler_1 = require("../agents/gitmcp/gitmcp.handler");
 Object.defineProperty(exports, "executeGitMcpHandler", { enumerable: true, get: function () { return gitmcp_handler_1.executeGitMcpHandler; } });
 const rag_handler_1 = require("../agents/rag/rag.handler");
 Object.defineProperty(exports, "executeRagHandler", { enumerable: true, get: function () { return rag_handler_1.executeRagHandler; } });
+const llm_handler_1 = require("../agents/llm/llm.handler");
+Object.defineProperty(exports, "executeLlmHandler", { enumerable: true, get: function () { return llm_handler_1.executeLlmHandler; } });
 const chat_handler_1 = require("../agents/chat/chat.handler");
 Object.defineProperty(exports, "executeChatHandler", { enumerable: true, get: function () { return chat_handler_1.executeChatHandler; } });
 /**
  * Map of workflow step types to their handlers
- * Maps both legacy (Portuguese) and new (English) step type names
+ * Preferred step type names only - legacy names resolved via LEGACY_STEP_TYPE_MAP
  */
 const handlerMap = {
-    // English step types (preferred)
     'joke': joker_handler_1.executeJokeHandler,
     'translation': translator_handler_1.executeTranslationHandler,
     'image': image_handler_1.executeImageHandler,
@@ -38,18 +40,26 @@ const handlerMap = {
     'chromadb': chromadb_handler_1.executeChromaDBHandler,
     'gitmcp': gitmcp_handler_1.executeGitMcpHandler,
     'rag': rag_handler_1.executeRagHandler,
+    'llm': llm_handler_1.executeLlmHandler,
     'chat': chat_handler_1.executeChatHandler,
-    // Legacy step types (for backward compatibility)
-    'genkit-joke': joker_handler_1.executeJokeHandler,
-    'genkit-translation': translator_handler_1.executeTranslationHandler,
-    'genkit-image': image_handler_1.executeImageHandler,
-    'gemini-vectorize': gemini_vectorize_handler_1.executeVectorizeHandler,
 };
+/**
+ * Resolve step type, handling legacy names with deprecation warning
+ */
+function resolveStepType(stepType, context) {
+    if (stepType in agent_types_1.LEGACY_STEP_TYPE_MAP) {
+        const preferred = agent_types_1.LEGACY_STEP_TYPE_MAP[stepType];
+        context.log(`[DEPRECATION WARNING] Step type '${stepType}' is deprecated. Use '${preferred}' instead.`);
+        return preferred;
+    }
+    return stepType;
+}
 /**
  * Execute a workflow step by delegating to the appropriate handler
  */
 async function executeWorkflowStep(stepType, params, props, context) {
-    const handler = handlerMap[stepType];
+    const resolvedType = resolveStepType(stepType, context);
+    const handler = handlerMap[resolvedType];
     if (!handler) {
         throw new Error(`Unknown workflow step type: ${stepType}`);
     }
@@ -62,9 +72,9 @@ function getAvailableStepTypes() {
     return Object.keys(handlerMap);
 }
 /**
- * Check if a step type is supported
+ * Check if a step type is supported (including legacy names)
  */
 function isStepTypeSupported(stepType) {
-    return stepType in handlerMap;
+    return stepType in handlerMap || stepType in agent_types_1.LEGACY_STEP_TYPE_MAP;
 }
 //# sourceMappingURL=workflowExecutor.js.map

package/dist/runtime/workflowExecutor.js.map

@@ -1 +1 @@
-{"version":3,"file":"workflowExecutor.js","sourceRoot":"","sources":["../../src/runtime/workflowExecutor.ts"],"names":[],"mappings":";;;AAuDA,kDAWC;AAKD,sDAEC;AAKD,kDAEC;AAhFD,uBAAqB;AAUrB,kCAAkC;AAClC,iEAAmE;AAyEjE,mGAzEO,kCAAkB,OAyEP;AAxEpB,gFAAoF;AAyElF,0GAzEO,8CAAyB,OAyEP;AAxE3B,iEAAoE;AAyElE,oGAzEO,mCAAmB,OAyEP;AAxErB,0EAA4E;AAyE1E,sGAzEO,wCAAqB,OAyEP;AAxEvB,kGAA8F;AAyE5F,wGAzEO,kDAAuB,OAyEP;AAxEzB,0EAA6E;AAyE3E,uGAzEO,yCAAsB,OAyEP;AAxExB,oEAAuE;AAyErE,qGAzEO,qCAAoB,OAyEP;AAxEtB,2DAA8D;AAyE5D,kGAzEO,+BAAiB,OAyEP;AAxEnB,8DAAiE;AAyE/D,mGAzEO,iCAAkB,OAyEP;AA9DpB;;;GAGG;AACH,MAAM,UAAU,GAAoC;IAClD,iCAAiC;IACjC,MAAM,EAAE,kCAAkB;IAC1B,aAAa,EAAE,8CAAyB;IACxC,OAAO,EAAE,mCAAmB;IAC5B,UAAU,EAAE,wCAAqB;IACjC,WAAW,EAAE,kDAAuB;IACpC,UAAU,EAAE,yCAAsB;IAClC,QAAQ,EAAE,qCAAoB;IAC9B,KAAK,EAAE,+BAAiB;IACxB,MAAM,EAAE,iCAAkB;IAC1B,iDAAiD;IACjD,aAAa,EAAE,kCAAkB;IACjC,oBAAoB,EAAE,8CAAyB;IAC/C,cAAc,EAAE,mCAAmB;IACnC,kBAAkB,EAAE,kDAAuB;CAC5C,CAAC;AAEF;;GAEG;AACI,KAAK,UAAU,mBAAmB,CACvC,QAAmC,EACnC,MAA+B,EAC/B,KAA6B,EAC7B,OAAyB;IAEzB,MAAM,OAAO,GAAG,UAAU,CAAC,QAAQ,CAAC,CAAC;IACrC,IAAI,CAAC,OAAO,EAAE,CAAC;QACb,MAAM,IAAI,KAAK,CAAC,+BAA+B,QAAQ,EAAE,CAAC,CAAC;IAC7D,CAAC;IACD,OAAO,OAAO,CAAC,MAAM,EAAE,KAAK,EAAE,OAAO,CAAC,CAAC;AACzC,CAAC;AAED;;GAEG;AACH,SAAgB,qBAAqB;IACnC,OAAO,MAAM,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;AACjC,CAAC;AAED;;GAEG;AACH,SAAgB,mBAAmB,CAAC,QAAgB;IAClD,OAAO,QAAQ,IAAI,UAAU,CAAC;AAChC,CAAC"}
+{"version":3,"file":"workflowExecutor.js","sourceRoot":"","sources":["../../src/runtime/workflowExecutor.ts"],"names":[],"mappings":";;;AAkEA,kDAYC;AAKD,sDAEC;AAKD,kDAEC;AA5FD,uBAAqB;AASrB,6DAAmE;AAEnE,kCAAkC;AAClC,iEAAmE;AAoFjE,mGApFO,kCAAkB,OAoFP;AAnFpB,gFAAoF;AAoFlF,0GApFO,8CAAyB,OAoFP;AAnF3B,iEAAoE;AAoFlE,oGApFO,mCAAmB,OAoFP;AAnFrB,0EAA4E;AAoF1E,sGApFO,wCAAqB,OAoFP;AAnFvB,kGAA8F;AAoF5F,wGApFO,kDAAuB,OAoFP;AAnFzB,0EAA6E;AAoF3E,uGApFO,yCAAsB,OAoFP;AAnFxB,oEAAuE;AAoFrE,qGApFO,qCAAoB,OAoFP;AAnFtB,2DAA8D;AAoF5D,kGApFO,+BAAiB,OAoFP;AAnFnB,2DAA8D;AAoF5D,kGApFO,+BAAiB,OAoFP;AAnFnB,8DAAiE;AAoF/D,mGApFO,iCAAkB,OAoFP;AAzEpB;;;GAGG;AACH,MAAM,UAAU,GAAoC;IAClD,MAAM,EAAE,kCAAkB;IAC1B,aAAa,EAAE,8CAAyB;IACxC,OAAO,EAAE,mCAAmB;IAC5B,UAAU,EAAE,wCAAqB;IACjC,WAAW,EAAE,kDAAuB;IACpC,UAAU,EAAE,yCAAsB;IAClC,QAAQ,EAAE,qCAAoB;IAC9B,KAAK,EAAE,+BAAiB;IACxB,KAAK,EAAE,+BAAiB;IACxB,MAAM,EAAE,iCAAkB;CAC3B,CAAC;AAEF;;GAEG;AACH,SAAS,eAAe,CAAC,QAAgB,EAAE,OAAyB;IAClE,IAAI,QAAQ,IAAI,kCAAoB,EAAE,CAAC;QACrC,MAAM,SAAS,GAAG,kCAAoB,CAAC,QAAQ,CAAC,CAAC;QACjD,OAAO,CAAC,GAAG,CACT,oCAAoC,QAAQ,yBAAyB,SAAS,YAAY,CAC3F,CAAC;QACF,OAAO,SAAS,CAAC;IACnB,CAAC;IACD,OAAO,QAAQ,CAAC;AAClB,CAAC;AAED;;GAEG;AACI,KAAK,UAAU,mBAAmB,CACvC,QAAmC,EACnC,MAA+B,EAC/B,KAA6B,EAC7B,OAAyB;IAEzB,MAAM,YAAY,GAAG,eAAe,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC;IACxD,MAAM,OAAO,GAAG,UAAU,CAAC,YAAY,CAAC,CAAC;IACzC,IAAI,CAAC,OAAO,EAAE,CAAC;QACb,MAAM,IAAI,KAAK,CAAC,+BAA+B,QAAQ,EAAE,CAAC,CAAC;IAC7D,CAAC;IACD,OAAO,OAAO,CAAC,MAAM,EAAE,KAAK,EAAE,OAAO,CAAC,CAAC;AACzC,CAAC;AAED;;GAEG;AACH,SAAgB,qBAAqB;IACnC,OAAO,MAAM,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;AACjC,CAAC;AAED;;GAEG;AACH,SAAgB,mBAAmB,CAAC,QAAgB;IAClD,OAAO,QAAQ,IAAI,UAAU,IAAI,QAAQ,IAAI,kCAAoB,CAAC;AACpE,CAAC"}

package/dist/shared/types/agent.types.d.ts

@@ -40,9 +40,22 @@ export interface ExecutionStep {
 }
 /**
  * Workflow step types supported by the runtime
- * Includes both English (preferred) and legacy (Portuguese) names
+ *
+ * PREFERRED: Use the English step type names (joke, translation, image, vectorize)
+ *
+ * DEPRECATED: The following legacy names are supported for backward compatibility
+ * but will be removed in a future major version:
+ * - genkit-joke → use 'joke'
+ * - genkit-translation → use 'translation'
+ * - genkit-image → use 'image'
+ * - gemini-vectorize → use 'vectorize'
  */
-export type WorkflowStepType = 'joke' | 'translation' | 'image' | 'vectorize' | 'mcp-tool' | 'chromadb' | 'gitmcp' | 'rag' | 'chat' | 'output-generator' | 'builtin-agent' | 'custom-action' | 'genkit-joke' | 'genkit-translation' | 'genkit-image' | 'gemini-vectorize';
+export type WorkflowStepType = 'joke' | 'translation' | 'image' | 'vectorize' | 'mcp-tool' | 'chromadb' | 'gitmcp' | 'rag' | 'llm' | 'chat' | 'output-generator' | 'builtin-agent' | 'custom-action' | 'genkit-joke' | 'genkit-translation' | 'genkit-image' | 'gemini-vectorize';
+/**
+ * Maps legacy step type names to their preferred equivalents
+ * @deprecated Use preferred step type names directly
+ */
+export declare const LEGACY_STEP_TYPE_MAP: Record<string, WorkflowStepType>;
 /**
  * Agent categories for organization
  */

package/dist/shared/types/agent.types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"agent.types.d.ts","sourceRoot":"","sources":["../../../src/shared/types/agent.types.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH;;GAEG;AACH,MAAM,WAAW,aAAa;IAC5B,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,QAAQ,EAAE,MAAM,CAAC;IACjB,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;CACjB;AAED;;GAEG;AACH,MAAM,WAAW,aAAa,CAAC,CAAC,GAAG,OAAO;IACxC,OAAO,EAAE,OAAO,CAAC;IACjB,IAAI,CAAC,EAAE,CAAC,CAAC;IACT,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED;;GAEG;AACH,MAAM,WAAW,aAAa;IAC5B,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,SAAS,GAAG,SAAS,GAAG,OAAO,CAAC;IACxC,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,KAAK,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAChC,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACjC,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,KAAK,CAAC,EAAE,eAAe,GAAG,eAAe,GAAG,SAAS,GAAG,WAAW,GAAG,WAAW,GAAG,YAAY,CAAC;CAClG;AAED;;;GAGG;AACH,MAAM,MAAM,gBAAgB,GAExB,MAAM,GACN,aAAa,GACb,OAAO,GACP,WAAW,GACX,UAAU,GACV,UAAU,GACV,QAAQ,GACR,KAAK,GACL,MAAM,GACN,kBAAkB,GAClB,eAAe,GACf,eAAe,GAEf,aAAa,GACb,oBAAoB,GACpB,cAAc,GACd,kBAAkB,CAAC;AAEvB;;GAEG;AACH,MAAM,MAAM,aAAa,GACrB,SAAS,GACT,aAAa,GACb,OAAO,GACP,KAAK,GACL,eAAe,GACf,SAAS,GACT,WAAW,GACX,eAAe,CAAC"}
+{"version":3,"file":"agent.types.d.ts","sourceRoot":"","sources":["../../../src/shared/types/agent.types.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH;;GAEG;AACH,MAAM,WAAW,aAAa;IAC5B,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,QAAQ,EAAE,MAAM,CAAC;IACjB,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;CACjB;AAED;;GAEG;AACH,MAAM,WAAW,aAAa,CAAC,CAAC,GAAG,OAAO;IACxC,OAAO,EAAE,OAAO,CAAC;IACjB,IAAI,CAAC,EAAE,CAAC,CAAC;IACT,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED;;GAEG;AACH,MAAM,WAAW,aAAa;IAC5B,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,SAAS,GAAG,SAAS,GAAG,OAAO,CAAC;IACxC,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,KAAK,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAChC,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACjC,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,KAAK,CAAC,EAAE,eAAe,GAAG,eAAe,GAAG,SAAS,GAAG,WAAW,GAAG,WAAW,GAAG,YAAY,CAAC;CAClG;AAED;;;;;;;;;;;GAWG;AACH,MAAM,MAAM,gBAAgB,GAExB,MAAM,GACN,aAAa,GACb,OAAO,GACP,WAAW,GACX,UAAU,GACV,UAAU,GACV,QAAQ,GACR,KAAK,GACL,KAAK,GACL,MAAM,GACN,kBAAkB,GAClB,eAAe,GACf,eAAe,GAEf,aAAa,GACb,oBAAoB,GACpB,cAAc,GACd,kBAAkB,CAAC;AAEvB;;;GAGG;AACH,eAAO,MAAM,oBAAoB,EAAE,MAAM,CAAC,MAAM,EAAE,gBAAgB,CAKjE,CAAC;AAEF;;GAEG;AACH,MAAM,MAAM,aAAa,GACrB,SAAS,GACT,aAAa,GACb,OAAO,GACP,KAAK,GACL,eAAe,GACf,SAAS,GACT,WAAW,GACX,eAAe,CAAC"}

package/dist/shared/types/agent.types.js

@@ -4,4 +4,15 @@
  * These types contain no sensitive data and can be used in both environments
  */
 Object.defineProperty(exports, "__esModule", { value: true });
+exports.LEGACY_STEP_TYPE_MAP = void 0;
+/**
+ * Maps legacy step type names to their preferred equivalents
+ * @deprecated Use preferred step type names directly
+ */
+exports.LEGACY_STEP_TYPE_MAP = {
+    'genkit-joke': 'joke',
+    'genkit-translation': 'translation',
+    'genkit-image': 'image',
+    'gemini-vectorize': 'vectorize',
+};
 //# sourceMappingURL=agent.types.js.map

package/dist/shared/types/agent.types.js.map

@@ -1 +1 @@
-{"version":3,"file":"agent.types.js","sourceRoot":"","sources":["../../../src/shared/types/agent.types.ts"],"names":[],"mappings":";AAAA;;;GAGG"}
+{"version":3,"file":"agent.types.js","sourceRoot":"","sources":["../../../src/shared/types/agent.types.ts"],"names":[],"mappings":";AAAA;;;GAGG;;;AA0EH;;;GAGG;AACU,QAAA,oBAAoB,GAAqC;IACpE,aAAa,EAAE,MAAM;IACrB,oBAAoB,EAAE,aAAa;IACnC,cAAc,EAAE,OAAO;IACvB,kBAAkB,EAAE,WAAW;CAChC,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "beddel",
-  "version": "0.2.3",
+  "version": "0.3.0",
   "description": "Beddel - A secure YAML parser and OpenAPI endpoint manager for Node.js applications",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",
@@ -77,12 +77,12 @@
   "license": "MIT",
   "repository": {
     "type": "git",
-    "url": "https://github.com/botanarede/beddel.git"
+    "url": "https://github.com/botanarede/beddel-alpha.git"
   },
   "bugs": {
-    "url": "https://github.com/botanarede/beddel/issues"
+    "url": "https://github.com/botanarede/beddel-alpha/issues"
   },
-  "homepage": "https://github.com/botanarede/beddel#readme",
+  "homepage": "https://github.com/botanarede/beddel-alpha#readme",
   "dependencies": {
     "@ai-sdk/google": "^2.0.23",
     "@modelcontextprotocol/sdk": "^1.0.0",
@@ -106,6 +106,7 @@
     }
   },
   "devDependencies": {
+    "@eslint/js": "^9.39.2",
     "@types/eventsource": "^1.1.15",
     "@types/jest": "^29.5.12",
     "@types/js-yaml": "^4.0.9",
@@ -115,7 +116,8 @@
     "eslint": "^9.0.0",
     "jest": "^29.0.0",
     "ts-jest": "^29.0.0",
-    "typescript": "^5.0.0"
+    "typescript": "^5.0.0",
+    "typescript-eslint": "^8.50.0"
   },
   "engines": {
     "node": ">=18.0.0"

package/src/agents/chat/chat.handler.ts

@@ -2,7 +2,7 @@ import 'server-only';
 
 /**
  * Chat Agent Handler - Server-only execution logic
- * Orchestrates RAG pipeline or simple chat based on mode
+ * Orchestrates RAG pipeline or simple LLM chat based on mode
  */
 
 import type { ExecutionContext } from '../../types/executionContext';
@@ -11,11 +11,12 @@ import type { ChatHandlerParams, ChatHandlerResult, ChatMode } from './chat.type
 import { executeVectorizeHandler } from '../gemini-vectorize/gemini-vectorize.handler';
 import { executeChromaDBHandler } from '../chromadb/chromadb.handler';
 import { executeRagHandler } from '../rag/rag.handler';
+import { executeLlmHandler } from '../llm/llm.handler';
 
 const KNOWLEDGE_COLLECTION = 'beddel_knowledge';
 
 /**
- * Execute simple chat mode - direct LLM with conversation history
+ * Execute simple chat mode - direct LLM with conversation history (no documents)
  */
 async function executeSimpleChat(
   query: string,
@@ -29,7 +30,7 @@ async function executeSimpleChat(
   context.log(`[Chat:Simple] Processing query: "${query.substring(0, 50)}..."`);
 
   const chatStep: ExecutionStep = {
-    agent: 'rag',
+    agent: 'llm',
     action: 'chat',
     status: 'running',
     startTime: Date.now(),
@@ -37,8 +38,8 @@ async function executeSimpleChat(
   };
   executionSteps.push(chatStep);
 
-  const result = await executeRagHandler(
-    { query, history: messages, mode: 'simple' },
+  const result = await executeLlmHandler(
+    { query, history: messages },
     props,
     context
   );
@@ -139,7 +140,7 @@ async function executeRagChat(
   searchStep.endTime = Date.now();
   searchStep.duration = searchStep.endTime - searchStep.startTime;
 
-  // Step 4: Generate answer
+  // Step 4: Generate answer using RAG
   const ragStep: ExecutionStep = {
     agent: 'rag',
     action: 'generate',
@@ -150,14 +151,15 @@ async function executeRagChat(
   executionSteps.push(ragStep);
 
   const hasDocuments = searchResult.documents && searchResult.documents.trim().length > 0;
+  const documents = hasDocuments
+    ? searchResult.documents
+    : 'No specific documentation available. Answer based on general knowledge.';
 
-  const ragResult = hasDocuments
-    ? await executeRagHandler({ query, documents: searchResult.documents, history: messages }, props, context)
-    : await executeRagHandler(
-        { query, documents: 'No specific documentation available. Answer based on general knowledge.', history: messages },
-        props,
-        context
-      );
+  const ragResult = await executeRagHandler(
+    { query, documents, history: messages },
+    props,
+    context
+  );
 
   ragStep.status = ragResult.error ? 'error' : 'success';
   ragStep.endTime = Date.now();

package/src/agents/chat/chat.yaml

@@ -9,7 +9,7 @@ agent:
 
 metadata:
   name: "Q&A Context Chat Agent"
-  description: "Orchestrates RAG pipeline or simple chat based on mode selection"
+  description: "Orchestrates RAG pipeline or direct LLM chat based on mode selection"
   category: "chat"
   route: "/agents/chat"
   knowledge_sources:
@@ -18,8 +18,8 @@ metadata:
     - "chat"
     - "orchestrator"
     - "rag"
+    - "llm"
     - "qa"
-    - "simple"
 
 schema:
   input:
@@ -87,19 +87,18 @@ logic:
         output:
           _extracted: true
 
-    # Step 2: Mode branch - Simple chat or RAG pipeline
+    # 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
+        # Simple mode: Direct LLM chat with conversation history (no documents)
         - name: "simple-chat"
-          type: "rag"
+          type: "llm"
           action:
             query: "$input.query"
             history: "$input.messages"
-            mode: "simple"
-            result: "ragResult"
+            result: "llmResult"
       else:
         # RAG mode: Full pipeline with knowledge base
         - name: "vectorize-query"
@@ -132,7 +131,6 @@ logic:
             query: "$input.query"
             documents: "$searchResult.documents"
             history: "$input.messages"
-            mode: "rag"
             result: "ragResult"
 
     # Step 3: Deliver final response

package/src/agents/gemini-vectorize/gemini-vectorize.handler.ts

@@ -2,32 +2,35 @@ import 'server-only';
 
 /**
  * Gemini Vectorize Agent Handler - Server-only execution logic
- * Generates text embeddings using Google's Gemini text-embedding-004 model
+ * Generates text embeddings using Google's text-embedding-004 model
+ * 
+ * Note: Embeddings currently only support Google provider via Vercel AI SDK
  */
 
 import { embed, embedMany } from 'ai';
-import { google } from '@ai-sdk/google';
+import { createGoogleGenerativeAI } from '@ai-sdk/google';
+import { extractProviderConfig } from '../../runtime/llmProviderFactory';
 import type { ExecutionContext } from '../../types/executionContext';
 import type { VectorizeHandlerParams, VectorizeHandlerResult } from './gemini-vectorize.types';
 
-const GEMINI_EMBEDDING_MODEL = 'text-embedding-004';
+const EMBEDDING_MODEL = 'text-embedding-004';
 
 /**
- * Execute vectorization using Gemini embeddings
+ * Execute vectorization using embeddings
  */
 export async function executeVectorizeHandler(
   params: VectorizeHandlerParams,
   props: Record<string, string>,
   context: ExecutionContext
 ): Promise<VectorizeHandlerResult> {
-  const apiKey = props?.gemini_api_key?.trim();
-  if (!apiKey) {
-    throw new Error('Missing required prop: gemini_api_key');
+  const providerConfig = extractProviderConfig(props, 'google');
+  
+  // Currently only Google supports embeddings via Vercel AI SDK
+  if (providerConfig.provider !== 'google') {
+    throw new Error(`Embeddings are currently only supported with Google provider, got: ${providerConfig.provider}`);
   }
 
-  // Set API key in environment for google provider
-  process.env.GOOGLE_GENERATIVE_AI_API_KEY = apiKey;
-
+  const google = createGoogleGenerativeAI({ apiKey: providerConfig.apiKey });
   const action = params.action || 'embedSingle';
 
   try {
@@ -37,10 +40,10 @@ export async function executeVectorizeHandler(
         throw new Error('Text input is required for embedSingle');
       }
 
-      context.log(`[Gemini Vectorize] Embedding single text (${text.length} chars)...`);
+      context.log(`[Vectorize] Embedding single text (${text.length} chars)...`);
 
       const { embedding } = await embed({
-        model: google.textEmbeddingModel(GEMINI_EMBEDDING_MODEL),
+        model: google.textEmbeddingModel(EMBEDDING_MODEL),
         value: text,
       });
 
@@ -52,10 +55,10 @@ export async function executeVectorizeHandler(
         throw new Error('Texts array input is required for embedBatch');
       }
 
-      context.log(`[Gemini Vectorize] Embedding batch of ${texts.length} texts...`);
+      context.log(`[Vectorize] Embedding batch of ${texts.length} texts...`);
 
       const { embeddings } = await embedMany({
-        model: google.textEmbeddingModel(GEMINI_EMBEDDING_MODEL),
+        model: google.textEmbeddingModel(EMBEDDING_MODEL),
         values: texts,
       });
 
@@ -66,7 +69,7 @@ export async function executeVectorizeHandler(
     }
   } catch (error: unknown) {
     const message = error instanceof Error ? error.message : String(error);
-    context.log(`[Gemini Vectorize] Error: ${message}`);
+    context.log(`[Vectorize] Error: ${message}`);
     return { success: false, error: message };
   }
 }

package/src/agents/image/image.handler.ts

@@ -2,27 +2,30 @@ import 'server-only';
 
 /**
  * Image Agent Handler - Server-only execution logic
- * Generates images using Gemini Flash with curated styles
+ * Generates images using LLM providers (Google Gemini Imagen by default)
  */
 
 import { experimental_generateImage } from 'ai';
 import { createGoogleGenerativeAI } from '@ai-sdk/google';
+import { extractProviderConfig } from '../../runtime/llmProviderFactory';
 import type { ExecutionContext } from '../../types/executionContext';
 import type { ImageHandlerParams, ImageHandlerResult } from './image.types';
 
 const GEMINI_IMAGE_MODEL = 'imagen-4.0-fast-generate-001';
 
 /**
- * Execute image generation using Gemini
+ * Execute image generation using configured provider
  */
 export async function executeImageHandler(
   params: ImageHandlerParams,
   props: Record<string, string>,
   context: ExecutionContext
 ): Promise<ImageHandlerResult> {
-  const apiKey = props?.gemini_api_key?.trim();
-  if (!apiKey) {
-    throw new Error('Missing required prop: gemini_api_key');
+  const providerConfig = extractProviderConfig(props, 'google');
+  
+  // Currently only Google supports image generation via Vercel AI SDK
+  if (providerConfig.provider !== 'google') {
+    throw new Error(`Image generation is currently only supported with Google provider, got: ${providerConfig.provider}`);
   }
 
   const description = params.description?.trim();
@@ -47,7 +50,7 @@ export async function executeImageHandler(
     .replace(/{{style}}/g, style)
     .trim();
 
-  const google = createGoogleGenerativeAI({ apiKey });
+  const google = createGoogleGenerativeAI({ apiKey: providerConfig.apiKey });
   const model = google.image(GEMINI_IMAGE_MODEL);
   const startTime = Date.now();
 
@@ -74,6 +77,7 @@ export async function executeImageHandler(
     prompt_used: prompt,
     metadata: {
       model_used: GEMINI_IMAGE_MODEL,
+      provider: providerConfig.provider,
       processing_time: Date.now() - startTime,
       style,
       resolution,

package/src/agents/image/image.types.ts

@@ -27,6 +27,7 @@ export interface ImageHandlerResult {
   prompt_used: string;
   metadata: {
     model_used: string;
+    provider: string;
     processing_time: number;
     style: string;
     resolution: string;

package/src/agents/index.ts

@@ -19,6 +19,7 @@ export { geminiVectorizeMetadata } from './gemini-vectorize';
 export { chromadbMetadata } from './chromadb';
 export { gitmcpMetadata } from './gitmcp';
 export { ragMetadata } from './rag';
+export { llmMetadata } from './llm';
 export { chatMetadata } from './chat';
 
 // Schema exports (client-safe)
@@ -30,6 +31,7 @@ export { GeminiVectorizeInputSchema, GeminiVectorizeOutputSchema } from './gemin
 export { ChromaDBInputSchema, ChromaDBOutputSchema } from './chromadb';
 export { GitMcpInputSchema, GitMcpOutputSchema } from './gitmcp';
 export { RagInputSchema, RagOutputSchema } from './rag';
+export { LlmInputSchema, LlmOutputSchema } from './llm';
 export { ChatInputSchema, ChatOutputSchema } from './chat';
 
 // Type exports (client-safe)
@@ -41,6 +43,7 @@ export type { GeminiVectorizeInput, GeminiVectorizeOutput, VectorizeHandlerParam
 export type { ChromaDBInput, ChromaDBOutput, ChromaDBHandlerParams, ChromaDBHandlerResult, ChromaDBSearchResult } from './chromadb';
 export type { GitMcpInput, GitMcpOutput, GitMcpHandlerParams, GitMcpHandlerResult } from './gitmcp';
 export type { RagInput, RagOutput, RagHandlerParams, RagHandlerResult, ConversationMessage } from './rag';
+export type { LlmInput, LlmOutput, LlmHandlerParams, LlmHandlerResult } from './llm';
 export type { ChatInput, ChatOutput, ChatHandlerParams, ChatHandlerResult } from './chat';
 
 /**
@@ -54,6 +57,7 @@ export const allAgentMetadata = [
   { id: 'gemini-vectorize', name: 'Gemini Vectorize Agent', description: "Generates text embeddings using Google's Gemini text-embedding-004 model", category: 'ai-service', route: '/agents/gemini-vectorize' },
   { id: 'chromadb', name: 'ChromaDB Agent', description: 'Vector storage and retrieval using ChromaDB. Supports local and cloud deployments.', category: 'database', route: '/agents/chromadb' },
   { id: 'gitmcp', name: 'GitMCP Documentation Agent', description: 'Fetches and chunks GitHub repository documentation via gitmcp.io MCP servers', category: 'integration', route: '/agents/gitmcp' },
-  { id: 'rag', name: 'RAG Intelligence Agent', description: 'Generates natural language answers based on provided context using Gemini', category: 'intelligence', route: '/agents/rag' },
-  { id: 'chat', name: 'Q&A Context Chat Agent', description: 'Orchestrates RAG pipeline: vectorization, storage, retrieval and answer generation', category: 'chat', route: '/agents/chat' },
+  { id: 'rag', name: 'RAG Intelligence Agent', description: 'Generates natural language answers based on provided document context using Gemini', category: 'intelligence', route: '/agents/rag' },
+  { id: 'llm', name: 'LLM Chat Agent', description: 'Direct LLM interaction with conversation history support (non-RAG)', category: 'intelligence', route: '/agents/llm' },
+  { id: 'chat', name: 'Q&A Context Chat Agent', description: 'Orchestrates RAG pipeline or direct LLM chat based on mode selection', category: 'chat', route: '/agents/chat' },
 ] as const;

package/src/agents/joker/joker.handler.ts

@@ -2,35 +2,29 @@ import 'server-only';
 
 /**
  * Joker Agent Handler - Server-only execution logic
- * Generates jokes using Gemini Flash
+ * Generates jokes using LLM providers (Google Gemini by default)
  */
 
 import { generateText } from 'ai';
-import { createGoogleGenerativeAI } from '@ai-sdk/google';
+import { LLMProviderFactory, extractProviderConfig } from '../../runtime/llmProviderFactory';
 import type { ExecutionContext } from '../../types/executionContext';
 import type { JokeHandlerParams, JokeHandlerResult } from './joker.types';
 
-const GEMINI_MODEL = 'models/gemini-2.5-flash';
-
 /**
- * Execute joke generation using Gemini Flash
+ * Execute joke generation using configured LLM provider
  */
 export async function executeJokeHandler(
   params: JokeHandlerParams,
   props: Record<string, string>,
   context: ExecutionContext
 ): Promise<JokeHandlerResult> {
-  const apiKey = props?.gemini_api_key?.trim();
-  if (!apiKey) {
-    throw new Error('Missing required prop: gemini_api_key');
-  }
+  const providerConfig = extractProviderConfig(props, 'google');
+  const model = LLMProviderFactory.createLanguageModel(providerConfig);
 
   const prompt = params.prompt?.trim() || 'Tell a short and original joke that works for any audience.';
   const temperature = params.temperature ?? 0.8;
   const maxTokens = params.maxTokens;
 
-  const google = createGoogleGenerativeAI({ apiKey });
-  const model = google(GEMINI_MODEL);
   const startTime = Date.now();
 
   context.log(`[Joker] Generating joke with temperature=${temperature}`);
@@ -50,7 +44,8 @@ export async function executeJokeHandler(
   return {
     text: finalText,
     metadata: {
-      model_used: GEMINI_MODEL,
+      model_used: providerConfig.model || LLMProviderFactory.getDefaultModel(providerConfig.provider),
+      provider: providerConfig.provider,
       processing_time: Date.now() - startTime,
       temperature,
       max_tokens: maxTokens ?? null,

package/src/agents/joker/joker.types.ts

@@ -18,6 +18,7 @@ export interface JokeHandlerResult {
   text: string;
   metadata: {
     model_used: string;
+    provider: string;
     processing_time: number;
     temperature: number;
     max_tokens: number | null;

package/src/agents/llm/index.ts

@@ -0,0 +1,20 @@
+/**
+ * LLM Agent - Public exports (client-safe)
+ */
+
+// Schema exports (client-safe)
+export { LlmInputSchema, LlmOutputSchema } from './llm.schema';
+export type { LlmInput, LlmOutput } from './llm.schema';
+
+// Type exports (client-safe)
+export type { LlmHandlerParams, LlmHandlerResult, LlmMetadata } from './llm.types';
+
+// Metadata (client-safe)
+export const llmMetadata = {
+  id: 'llm',
+  name: 'LLM Chat Agent',
+  description: 'Direct LLM interaction with conversation history support (non-RAG)',
+  category: 'intelligence',
+  route: '/agents/llm',
+  tags: ['llm', 'chat', 'gemini', 'conversation'],
+} as const;

package/src/agents/llm/llm.handler.ts

@@ -0,0 +1,82 @@
+import 'server-only';
+
+/**
+ * LLM Agent Handler - Server-only execution logic
+ * Direct LLM interaction with conversation history support (non-RAG)
+ */
+
+import { generateText } from 'ai';
+import { LLMProviderFactory, extractProviderConfig } from '../../runtime/llmProviderFactory';
+import type { ExecutionContext } from '../../types/executionContext';
+import type { LlmHandlerParams, LlmHandlerResult } from './llm.types';
+import type { ConversationMessage } from '../rag/rag.types';
+
+/**
+ * Build prompt for direct LLM chat (no document context)
+ */
+function buildChatPrompt(
+  query: string,
+  history?: ConversationMessage[],
+  systemPrompt?: string
+): string {
+  const system = systemPrompt || 'You are a helpful, friendly assistant.';
+
+  const conversationContext = history?.length
+    ? `CONVERSATION HISTORY:\n${history.map((m) => `${m.role.toUpperCase()}: ${m.content}`).join('\n')}\n\n`
+    : '';
+
+  return `${system}
+
+${conversationContext}USER MESSAGE:
+${query}
+
+INSTRUCTIONS:
+1. Respond naturally to the user's message.
+2. Consider the conversation history for context continuity if available.
+3. Be concise but helpful.
+
+RESPONSE:`;
+}
+
+/**
+ * Execute direct LLM chat
+ */
+export async function executeLlmHandler(
+  params: LlmHandlerParams,
+  props: Record<string, string>,
+  context: ExecutionContext
+): Promise<LlmHandlerResult> {
+  const providerConfig = extractProviderConfig(props, 'google');
+  const model = LLMProviderFactory.createLanguageModel(providerConfig);
+
+  const { query, history, temperature = 0.7, systemPrompt } = params;
+
+  if (!query) {
+    throw new Error('Missing required LLM input: query');
+  }
+
+  const prompt = buildChatPrompt(query, history, systemPrompt);
+
+  try {
+    context.log(`[LLM] Generating response for: "${query.substring(0, 50)}..."`);
+
+    const { text } = await generateText({
+      model,
+      prompt,
+      temperature,
+    });
+
+    return {
+      response: text,
+      timestamp: new Date().toISOString(),
+    };
+  } catch (error: unknown) {
+    const message = error instanceof Error ? error.message : String(error);
+    context.log(`[LLM] Error: ${message}`);
+    return {
+      response: '',
+      timestamp: new Date().toISOString(),
+      error: message,
+    };
+  }
+}