@agentbridgeai/core 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 AgentBridge
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/dist/action-executor.d.ts

@@ -0,0 +1,9 @@
+import type { ToolCall, ToolResult, Session } from './types.js';
+import { PluginRegistry } from './plugin-registry.js';
+export declare class ActionExecutor {
+    private registry;
+    constructor(registry: PluginRegistry);
+    execute(toolCall: ToolCall, session: Session, askUser: (question: string) => Promise<string>): Promise<ToolResult>;
+    executeAll(toolCalls: ToolCall[], session: Session, askUser: (question: string) => Promise<string>): Promise<ToolResult[]>;
+}
+//# sourceMappingURL=action-executor.d.ts.map

package/dist/action-executor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"action-executor.d.ts","sourceRoot":"","sources":["../src/action-executor.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAA+B,QAAQ,EAAE,UAAU,EAAE,OAAO,EAAE,MAAM,YAAY,CAAC;AAC7F,OAAO,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AAEtD,qBAAa,cAAc;IACb,OAAO,CAAC,QAAQ;gBAAR,QAAQ,EAAE,cAAc;IAEtC,OAAO,CACX,QAAQ,EAAE,QAAQ,EAClB,OAAO,EAAE,OAAO,EAChB,OAAO,EAAE,CAAC,QAAQ,EAAE,MAAM,KAAK,OAAO,CAAC,MAAM,CAAC,GAC7C,OAAO,CAAC,UAAU,CAAC;IA4ChB,UAAU,CACd,SAAS,EAAE,QAAQ,EAAE,EACrB,OAAO,EAAE,OAAO,EAChB,OAAO,EAAE,CAAC,QAAQ,EAAE,MAAM,KAAK,OAAO,CAAC,MAAM,CAAC,GAC7C,OAAO,CAAC,UAAU,EAAE,CAAC;CAKzB"}

package/dist/action-executor.js

@@ -0,0 +1,50 @@
+export class ActionExecutor {
+    registry;
+    constructor(registry) {
+        this.registry = registry;
+    }
+    async execute(toolCall, session, askUser) {
+        const action = this.registry.getAction(toolCall.pluginName, toolCall.actionName);
+        if (!action) {
+            return {
+                toolCallId: toolCall.id,
+                result: {
+                    success: false,
+                    message: `Unknown action: ${toolCall.pluginName}.${toolCall.actionName}`,
+                },
+            };
+        }
+        // Validate parameters against the action's zod schema
+        const parseResult = action.parameters.safeParse(toolCall.parameters);
+        if (!parseResult.success) {
+            return {
+                toolCallId: toolCall.id,
+                result: {
+                    success: false,
+                    message: `Invalid parameters: ${parseResult.error.issues.map(i => i.message).join(', ')}`,
+                },
+            };
+        }
+        const context = {
+            session,
+            ask: askUser,
+        };
+        try {
+            const result = await action.execute(parseResult.data, context);
+            return { toolCallId: toolCall.id, result };
+        }
+        catch (error) {
+            return {
+                toolCallId: toolCall.id,
+                result: {
+                    success: false,
+                    message: `Action failed: ${error.message}`,
+                },
+            };
+        }
+    }
+    async executeAll(toolCalls, session, askUser) {
+        return Promise.all(toolCalls.map(tc => this.execute(tc, session, askUser)));
+    }
+}
+//# sourceMappingURL=action-executor.js.map

package/dist/action-executor.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"action-executor.js","sourceRoot":"","sources":["../src/action-executor.ts"],"names":[],"mappings":"AAGA,MAAM,OAAO,cAAc;IACL;IAApB,YAAoB,QAAwB;QAAxB,aAAQ,GAAR,QAAQ,CAAgB;IAAG,CAAC;IAEhD,KAAK,CAAC,OAAO,CACX,QAAkB,EAClB,OAAgB,EAChB,OAA8C;QAE9C,MAAM,MAAM,GAAG,IAAI,CAAC,QAAQ,CAAC,SAAS,CAAC,QAAQ,CAAC,UAAU,EAAE,QAAQ,CAAC,UAAU,CAAC,CAAC;QAEjF,IAAI,CAAC,MAAM,EAAE,CAAC;YACZ,OAAO;gBACL,UAAU,EAAE,QAAQ,CAAC,EAAE;gBACvB,MAAM,EAAE;oBACN,OAAO,EAAE,KAAK;oBACd,OAAO,EAAE,mBAAmB,QAAQ,CAAC,UAAU,IAAI,QAAQ,CAAC,UAAU,EAAE;iBACzE;aACF,CAAC;QACJ,CAAC;QAED,sDAAsD;QACtD,MAAM,WAAW,GAAG,MAAM,CAAC,UAAU,CAAC,SAAS,CAAC,QAAQ,CAAC,UAAU,CAAC,CAAC;QACrE,IAAI,CAAC,WAAW,CAAC,OAAO,EAAE,CAAC;YACzB,OAAO;gBACL,UAAU,EAAE,QAAQ,CAAC,EAAE;gBACvB,MAAM,EAAE;oBACN,OAAO,EAAE,KAAK;oBACd,OAAO,EAAE,uBAAuB,WAAW,CAAC,KAAK,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE;iBAC1F;aACF,CAAC;QACJ,CAAC;QAED,MAAM,OAAO,GAAkB;YAC7B,OAAO;YACP,GAAG,EAAE,OAAO;SACb,CAAC;QAEF,IAAI,CAAC;YACH,MAAM,MAAM,GAAG,MAAM,MAAM,CAAC,OAAO,CAAC,WAAW,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC;YAC/D,OAAO,EAAE,UAAU,EAAE,QAAQ,CAAC,EAAE,EAAE,MAAM,EAAE,CAAC;QAC7C,CAAC;QAAC,OAAO,KAAU,EAAE,CAAC;YACpB,OAAO;gBACL,UAAU,EAAE,QAAQ,CAAC,EAAE;gBACvB,MAAM,EAAE;oBACN,OAAO,EAAE,KAAK;oBACd,OAAO,EAAE,kBAAkB,KAAK,CAAC,OAAO,EAAE;iBAC3C;aACF,CAAC;QACJ,CAAC;IACH,CAAC;IAED,KAAK,CAAC,UAAU,CACd,SAAqB,EACrB,OAAgB,EAChB,OAA8C;QAE9C,OAAO,OAAO,CAAC,GAAG,CAChB,SAAS,CAAC,GAAG,CAAC,EAAE,CAAC,EAAE,CAAC,IAAI,CAAC,OAAO,CAAC,EAAE,EAAE,OAAO,EAAE,OAAO,CAAC,CAAC,CACxD,CAAC;IACJ,CAAC;CACF"}

package/dist/conversation.d.ts

@@ -0,0 +1,10 @@
+import type { Session, Message } from './types.js';
+export declare class ConversationManager {
+    private sessions;
+    create(): Session;
+    get(sessionId: string): Session | undefined;
+    addMessage(sessionId: string, message: Message): void;
+    getMessages(sessionId: string): Message[];
+    destroy(sessionId: string): void;
+}
+//# sourceMappingURL=conversation.d.ts.map

package/dist/conversation.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"conversation.d.ts","sourceRoot":"","sources":["../src/conversation.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,OAAO,EAAE,OAAO,EAAE,MAAM,YAAY,CAAC;AAEnD,qBAAa,mBAAmB;IAC9B,OAAO,CAAC,QAAQ,CAAmC;IAEnD,MAAM,IAAI,OAAO;IAUjB,GAAG,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,GAAG,SAAS;IAI3C,UAAU,CAAC,SAAS,EAAE,MAAM,EAAE,OAAO,EAAE,OAAO,GAAG,IAAI;IAMrD,WAAW,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,EAAE;IAIzC,OAAO,CAAC,SAAS,EAAE,MAAM,GAAG,IAAI;CAGjC"}

package/dist/conversation.js

@@ -0,0 +1,29 @@
+import { randomUUID } from 'crypto';
+export class ConversationManager {
+    sessions = new Map();
+    create() {
+        const session = {
+            id: randomUUID(),
+            messages: [],
+            metadata: {},
+        };
+        this.sessions.set(session.id, session);
+        return session;
+    }
+    get(sessionId) {
+        return this.sessions.get(sessionId);
+    }
+    addMessage(sessionId, message) {
+        const session = this.sessions.get(sessionId);
+        if (!session)
+            throw new Error(`Session not found: ${sessionId}`);
+        session.messages.push(message);
+    }
+    getMessages(sessionId) {
+        return this.sessions.get(sessionId)?.messages ?? [];
+    }
+    destroy(sessionId) {
+        this.sessions.delete(sessionId);
+    }
+}
+//# sourceMappingURL=conversation.js.map

package/dist/conversation.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"conversation.js","sourceRoot":"","sources":["../src/conversation.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,QAAQ,CAAC;AAGpC,MAAM,OAAO,mBAAmB;IACtB,QAAQ,GAAyB,IAAI,GAAG,EAAE,CAAC;IAEnD,MAAM;QACJ,MAAM,OAAO,GAAY;YACvB,EAAE,EAAE,UAAU,EAAE;YAChB,QAAQ,EAAE,EAAE;YACZ,QAAQ,EAAE,EAAE;SACb,CAAC;QACF,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,OAAO,CAAC,EAAE,EAAE,OAAO,CAAC,CAAC;QACvC,OAAO,OAAO,CAAC;IACjB,CAAC;IAED,GAAG,CAAC,SAAiB;QACnB,OAAO,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC;IACtC,CAAC;IAED,UAAU,CAAC,SAAiB,EAAE,OAAgB;QAC5C,MAAM,OAAO,GAAG,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC;QAC7C,IAAI,CAAC,OAAO;YAAE,MAAM,IAAI,KAAK,CAAC,sBAAsB,SAAS,EAAE,CAAC,CAAC;QACjE,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;IACjC,CAAC;IAED,WAAW,CAAC,SAAiB;QAC3B,OAAO,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,SAAS,CAAC,EAAE,QAAQ,IAAI,EAAE,CAAC;IACtD,CAAC;IAED,OAAO,CAAC,SAAiB;QACvB,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC;IAClC,CAAC;CACF"}

package/dist/engine.d.ts

@@ -0,0 +1,23 @@
+import type { AgentBridgeConfig, Plugin, ToolCall, ActionResult } from './types.js';
+export declare class AgentBridgeEngine {
+    private registry;
+    private executor;
+    private conversations;
+    private llm;
+    private systemPrompt;
+    constructor(config: AgentBridgeConfig);
+    registerPlugin(plugin: Plugin): Promise<void>;
+    getPlugins(): Plugin[];
+    createSession(): string;
+    private buildSystemPrompt;
+    /**
+     * Process a user message and return the assistant's response.
+     * Handles the full loop: LLM call → tool execution → follow-up LLM call.
+     */
+    chat(sessionId: string, userMessage: string, options?: {
+        askUser?: (question: string) => Promise<string>;
+        onToolCall?: (toolCall: ToolCall) => void;
+        onToolResult?: (actionName: string, result: ActionResult) => void;
+    }): Promise<string>;
+}
+//# sourceMappingURL=engine.d.ts.map

package/dist/engine.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"engine.d.ts","sourceRoot":"","sources":["../src/engine.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,iBAAiB,EACjB,MAAM,EAGN,QAAQ,EACR,YAAY,EACb,MAAM,YAAY,CAAC;AAapB,qBAAa,iBAAiB;IAC5B,OAAO,CAAC,QAAQ,CAAiB;IACjC,OAAO,CAAC,QAAQ,CAAiB;IACjC,OAAO,CAAC,aAAa,CAAsB;IAC3C,OAAO,CAAC,GAAG,CAAc;IACzB,OAAO,CAAC,YAAY,CAAS;gBAEjB,MAAM,EAAE,iBAAiB;IAc/B,cAAc,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAInD,UAAU,IAAI,MAAM,EAAE;IAItB,aAAa,IAAI,MAAM;IAUvB,OAAO,CAAC,iBAAiB;IAYzB;;;OAGG;IACG,IAAI,CACR,SAAS,EAAE,MAAM,EACjB,WAAW,EAAE,MAAM,EACnB,OAAO,CAAC,EAAE;QACR,OAAO,CAAC,EAAE,CAAC,QAAQ,EAAE,MAAM,KAAK,OAAO,CAAC,MAAM,CAAC,CAAC;QAChD,UAAU,CAAC,EAAE,CAAC,QAAQ,EAAE,QAAQ,KAAK,IAAI,CAAC;QAC1C,YAAY,CAAC,EAAE,CAAC,UAAU,EAAE,MAAM,EAAE,MAAM,EAAE,YAAY,KAAK,IAAI,CAAC;KACnE,GACA,OAAO,CAAC,MAAM,CAAC;CA8DnB"}

package/dist/engine.js

@@ -0,0 +1,109 @@
+import { PluginRegistry } from './plugin-registry.js';
+import { ActionExecutor } from './action-executor.js';
+import { ConversationManager } from './conversation.js';
+const DEFAULT_SYSTEM_PROMPT = `You are AgentBridge, a helpful AI assistant that can interact with various apps and services on behalf of the user.
+
+You have access to tools provided by installed plugins. Use them when the user asks you to perform actions.
+
+When a tool call fails or parameters are missing, ask the user for the needed information.
+
+Be concise and helpful. When you perform an action, report the result clearly.`;
+export class AgentBridgeEngine {
+    registry;
+    executor;
+    conversations;
+    llm;
+    systemPrompt;
+    constructor(config) {
+        this.registry = new PluginRegistry();
+        this.executor = new ActionExecutor(this.registry);
+        this.conversations = new ConversationManager();
+        this.llm = config.llmProvider;
+        this.systemPrompt = config.systemPrompt ?? DEFAULT_SYSTEM_PROMPT;
+        if (config.plugins) {
+            for (const plugin of config.plugins) {
+                this.registerPlugin(plugin);
+            }
+        }
+    }
+    async registerPlugin(plugin) {
+        await this.registry.register(plugin);
+    }
+    getPlugins() {
+        return this.registry.getAllPlugins();
+    }
+    createSession() {
+        const session = this.conversations.create();
+        // Add system message
+        this.conversations.addMessage(session.id, {
+            role: 'system',
+            content: this.buildSystemPrompt(),
+        });
+        return session.id;
+    }
+    buildSystemPrompt() {
+        const plugins = this.registry.getAllPlugins();
+        const pluginList = plugins
+            .map(p => `- **${p.name}**: ${p.description}`)
+            .join('\n');
+        return `${this.systemPrompt}
+
+## Available Plugins
+${pluginList || 'No plugins installed.'}`;
+    }
+    /**
+     * Process a user message and return the assistant's response.
+     * Handles the full loop: LLM call → tool execution → follow-up LLM call.
+     */
+    async chat(sessionId, userMessage, options) {
+        const session = this.conversations.get(sessionId);
+        if (!session)
+            throw new Error(`Session not found: ${sessionId}`);
+        // Add user message
+        this.conversations.addMessage(sessionId, {
+            role: 'user',
+            content: userMessage,
+        });
+        const tools = this.registry.toLLMTools();
+        const maxIterations = 10; // prevent infinite tool-calling loops
+        for (let i = 0; i < maxIterations; i++) {
+            const messages = this.conversations.getMessages(sessionId);
+            const response = await this.llm.chat(messages, tools);
+            // If no tool calls, return the text response
+            if (!response.toolCalls || response.toolCalls.length === 0) {
+                const text = response.text ?? 'I have nothing to say.';
+                this.conversations.addMessage(sessionId, {
+                    role: 'assistant',
+                    content: text,
+                });
+                return text;
+            }
+            // Add assistant message with tool calls
+            this.conversations.addMessage(sessionId, {
+                role: 'assistant',
+                content: response.text ?? '',
+                toolCalls: response.toolCalls,
+            });
+            // Execute each tool call
+            const askUser = options?.askUser ?? (async () => '');
+            const toolResults = await this.executor.executeAll(response.toolCalls, session, askUser);
+            // Add tool results as messages
+            for (const tr of toolResults) {
+                const tc = response.toolCalls.find(t => t.id === tr.toolCallId);
+                if (options?.onToolCall && tc)
+                    options.onToolCall(tc);
+                if (options?.onToolResult && tc) {
+                    options.onToolResult(`${tc.pluginName}.${tc.actionName}`, tr.result);
+                }
+                this.conversations.addMessage(sessionId, {
+                    role: 'tool',
+                    content: JSON.stringify(tr.result),
+                    toolCallId: tr.toolCallId,
+                });
+            }
+            // Loop back so the LLM can process the tool results
+        }
+        return 'I got stuck in a loop. Please try again.';
+    }
+}
+//# sourceMappingURL=engine.js.map

package/dist/engine.js.map

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

package/dist/index.d.ts

@@ -0,0 +1,6 @@
+export { AgentBridgeEngine } from './engine.js';
+export { PluginRegistry } from './plugin-registry.js';
+export { ActionExecutor } from './action-executor.js';
+export { ConversationManager } from './conversation.js';
+export type { Plugin, Action, ActionResult, ActionContext, AuthConfig, AuthField, Session, Message, ToolCall, ToolResult, LLMProvider, LLMTool, LLMResponse, AgentBridgeConfig, } from './types.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAC;AAChD,OAAO,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AACtD,OAAO,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AACtD,OAAO,EAAE,mBAAmB,EAAE,MAAM,mBAAmB,CAAC;AACxD,YAAY,EACV,MAAM,EACN,MAAM,EACN,YAAY,EACZ,aAAa,EACb,UAAU,EACV,SAAS,EACT,OAAO,EACP,OAAO,EACP,QAAQ,EACR,UAAU,EACV,WAAW,EACX,OAAO,EACP,WAAW,EACX,iBAAiB,GAClB,MAAM,YAAY,CAAC"}

package/dist/index.js

@@ -0,0 +1,5 @@
+export { AgentBridgeEngine } from './engine.js';
+export { PluginRegistry } from './plugin-registry.js';
+export { ActionExecutor } from './action-executor.js';
+export { ConversationManager } from './conversation.js';
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAC;AAChD,OAAO,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AACtD,OAAO,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AACtD,OAAO,EAAE,mBAAmB,EAAE,MAAM,mBAAmB,CAAC"}

package/dist/plugin-registry.d.ts

@@ -0,0 +1,23 @@
+import type { Plugin, Action, LLMTool } from './types.js';
+export declare class PluginRegistry {
+    private plugins;
+    register(plugin: Plugin): Promise<void>;
+    unregister(name: string): void;
+    getPlugin(name: string): Plugin | undefined;
+    getAction(pluginName: string, actionName: string): Action | undefined;
+    getAllPlugins(): Plugin[];
+    /**
+     * Convert all plugin actions into LLM tool definitions.
+     * Tool names are formatted as "pluginName__actionName" so the LLM
+     * can call them and we can route back to the right plugin.
+     */
+    toLLMTools(): LLMTool[];
+    /**
+     * Parse a tool name like "weather__get_weather" back into plugin + action names
+     */
+    static parseToolName(toolName: string): {
+        pluginName: string;
+        actionName: string;
+    };
+}
+//# sourceMappingURL=plugin-registry.d.ts.map

package/dist/plugin-registry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"plugin-registry.d.ts","sourceRoot":"","sources":["../src/plugin-registry.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,YAAY,CAAC;AAE1D,qBAAa,cAAc;IACzB,OAAO,CAAC,OAAO,CAAkC;IAE3C,QAAQ,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAU7C,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI;IAQ9B,SAAS,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS;IAI3C,SAAS,CAAC,UAAU,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS;IAKrE,aAAa,IAAI,MAAM,EAAE;IAIzB;;;;OAIG;IACH,UAAU,IAAI,OAAO,EAAE;IAqBvB;;OAEG;IACH,MAAM,CAAC,aAAa,CAAC,QAAQ,EAAE,MAAM,GAAG;QAAE,UAAU,EAAE,MAAM,CAAC;QAAC,UAAU,EAAE,MAAM,CAAA;KAAE;CAOnF"}

package/dist/plugin-registry.js

@@ -0,0 +1,64 @@
+import { zodToJsonSchema } from 'zod-to-json-schema';
+export class PluginRegistry {
+    plugins = new Map();
+    async register(plugin) {
+        if (this.plugins.has(plugin.name)) {
+            throw new Error(`Plugin "${plugin.name}" is already registered`);
+        }
+        if (plugin.setup) {
+            await plugin.setup();
+        }
+        this.plugins.set(plugin.name, plugin);
+    }
+    unregister(name) {
+        const plugin = this.plugins.get(name);
+        if (plugin?.teardown) {
+            plugin.teardown();
+        }
+        this.plugins.delete(name);
+    }
+    getPlugin(name) {
+        return this.plugins.get(name);
+    }
+    getAction(pluginName, actionName) {
+        const plugin = this.plugins.get(pluginName);
+        return plugin?.actions.find(a => a.name === actionName);
+    }
+    getAllPlugins() {
+        return Array.from(this.plugins.values());
+    }
+    /**
+     * Convert all plugin actions into LLM tool definitions.
+     * Tool names are formatted as "pluginName__actionName" so the LLM
+     * can call them and we can route back to the right plugin.
+     */
+    toLLMTools() {
+        const tools = [];
+        for (const plugin of this.plugins.values()) {
+            for (const action of plugin.actions) {
+                const jsonSchema = zodToJsonSchema(action.parameters, {
+                    target: 'openApi3',
+                });
+                // Remove the top-level $schema key that zodToJsonSchema adds
+                const { $schema, ...parameterSchema } = jsonSchema;
+                tools.push({
+                    name: `${plugin.name}__${action.name}`,
+                    description: `[${plugin.name}] ${action.description}`,
+                    parameters: parameterSchema,
+                });
+            }
+        }
+        return tools;
+    }
+    /**
+     * Parse a tool name like "weather__get_weather" back into plugin + action names
+     */
+    static parseToolName(toolName) {
+        const [pluginName, actionName] = toolName.split('__');
+        if (!pluginName || !actionName) {
+            throw new Error(`Invalid tool name format: "${toolName}". Expected "pluginName__actionName"`);
+        }
+        return { pluginName, actionName };
+    }
+}
+//# sourceMappingURL=plugin-registry.js.map

package/dist/plugin-registry.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"plugin-registry.js","sourceRoot":"","sources":["../src/plugin-registry.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAC;AAGrD,MAAM,OAAO,cAAc;IACjB,OAAO,GAAwB,IAAI,GAAG,EAAE,CAAC;IAEjD,KAAK,CAAC,QAAQ,CAAC,MAAc;QAC3B,IAAI,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,MAAM,CAAC,IAAI,CAAC,EAAE,CAAC;YAClC,MAAM,IAAI,KAAK,CAAC,WAAW,MAAM,CAAC,IAAI,yBAAyB,CAAC,CAAC;QACnE,CAAC;QACD,IAAI,MAAM,CAAC,KAAK,EAAE,CAAC;YACjB,MAAM,MAAM,CAAC,KAAK,EAAE,CAAC;QACvB,CAAC;QACD,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,MAAM,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC;IACxC,CAAC;IAED,UAAU,CAAC,IAAY;QACrB,MAAM,MAAM,GAAG,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;QACtC,IAAI,MAAM,EAAE,QAAQ,EAAE,CAAC;YACrB,MAAM,CAAC,QAAQ,EAAE,CAAC;QACpB,CAAC;QACD,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;IAC5B,CAAC;IAED,SAAS,CAAC,IAAY;QACpB,OAAO,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;IAChC,CAAC;IAED,SAAS,CAAC,UAAkB,EAAE,UAAkB;QAC9C,MAAM,MAAM,GAAG,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,UAAU,CAAC,CAAC;QAC5C,OAAO,MAAM,EAAE,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,UAAU,CAAC,CAAC;IAC1D,CAAC;IAED,aAAa;QACX,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,MAAM,EAAE,CAAC,CAAC;IAC3C,CAAC;IAED;;;;OAIG;IACH,UAAU;QACR,MAAM,KAAK,GAAc,EAAE,CAAC;QAC5B,KAAK,MAAM,MAAM,IAAI,IAAI,CAAC,OAAO,CAAC,MAAM,EAAE,EAAE,CAAC;YAC3C,KAAK,MAAM,MAAM,IAAI,MAAM,CAAC,OAAO,EAAE,CAAC;gBACpC,MAAM,UAAU,GAAG,eAAe,CAAC,MAAM,CAAC,UAAU,EAAE;oBACpD,MAAM,EAAE,UAAU;iBACnB,CAAC,CAAC;gBAEH,6DAA6D;gBAC7D,MAAM,EAAE,OAAO,EAAE,GAAG,eAAe,EAAE,GAAG,UAAiB,CAAC;gBAE1D,KAAK,CAAC,IAAI,CAAC;oBACT,IAAI,EAAE,GAAG,MAAM,CAAC,IAAI,KAAK,MAAM,CAAC,IAAI,EAAE;oBACtC,WAAW,EAAE,IAAI,MAAM,CAAC,IAAI,KAAK,MAAM,CAAC,WAAW,EAAE;oBACrD,UAAU,EAAE,eAAe;iBAC5B,CAAC,CAAC;YACL,CAAC;QACH,CAAC;QACD,OAAO,KAAK,CAAC;IACf,CAAC;IAED;;OAEG;IACH,MAAM,CAAC,aAAa,CAAC,QAAgB;QACnC,MAAM,CAAC,UAAU,EAAE,UAAU,CAAC,GAAG,QAAQ,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;QACtD,IAAI,CAAC,UAAU,IAAI,CAAC,UAAU,EAAE,CAAC;YAC/B,MAAM,IAAI,KAAK,CAAC,8BAA8B,QAAQ,sCAAsC,CAAC,CAAC;QAChG,CAAC;QACD,OAAO,EAAE,UAAU,EAAE,UAAU,EAAE,CAAC;IACpC,CAAC;CACF"}

package/dist/types.d.ts

@@ -0,0 +1,78 @@
+import { z } from 'zod';
+export interface Plugin {
+    name: string;
+    description: string;
+    version: string;
+    actions: Action[];
+    auth?: AuthConfig;
+    setup?: () => Promise<void>;
+    teardown?: () => Promise<void>;
+}
+export interface Action {
+    name: string;
+    description: string;
+    parameters: z.ZodType<any>;
+    execute: (params: any, context: ActionContext) => Promise<ActionResult>;
+    confirm?: boolean;
+}
+export interface ActionResult {
+    success: boolean;
+    data?: any;
+    message: string;
+    followUp?: string;
+}
+export interface ActionContext {
+    session: Session;
+    auth?: Record<string, string>;
+    ask: (question: string) => Promise<string>;
+}
+export interface AuthConfig {
+    type: 'api_key' | 'oauth2' | 'custom';
+    fields: AuthField[];
+}
+export interface AuthField {
+    name: string;
+    description: string;
+    required: boolean;
+    secret?: boolean;
+}
+export interface Session {
+    id: string;
+    messages: Message[];
+    metadata: Record<string, any>;
+}
+export interface Message {
+    role: 'user' | 'assistant' | 'system' | 'tool';
+    content: string;
+    toolCallId?: string;
+    toolCalls?: ToolCall[];
+}
+export interface ToolCall {
+    id: string;
+    pluginName: string;
+    actionName: string;
+    parameters: Record<string, any>;
+}
+export interface ToolResult {
+    toolCallId: string;
+    result: ActionResult;
+}
+export interface LLMProvider {
+    name: string;
+    chat(messages: Message[], tools: LLMTool[]): Promise<LLMResponse>;
+}
+export interface LLMTool {
+    name: string;
+    description: string;
+    parameters: Record<string, any>;
+}
+export interface LLMResponse {
+    text?: string;
+    toolCalls?: ToolCall[];
+}
+export interface AgentBridgeConfig {
+    llmProvider: LLMProvider;
+    plugins?: Plugin[];
+    systemPrompt?: string;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

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

package/dist/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

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

package/package.json

@@ -0,0 +1,43 @@
+{
+  "name": "@agentbridgeai/core",
+  "version": "0.1.0",
+  "description": "Engine, plugin registry, and conversation manager for AgentBridge",
+  "type": "module",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/ranausmanai/AgentBridge.git",
+    "directory": "packages/core"
+  },
+  "homepage": "https://agentbridge.cc",
+  "files": [
+    "dist"
+  ],
+  "publishConfig": {
+    "access": "public"
+  },
+  "keywords": [
+    "ai",
+    "agents",
+    "api",
+    "llm",
+    "openapi",
+    "agentbridge"
+  ],
+  "dependencies": {
+    "zod": "^3.23.0",
+    "zod-to-json-schema": "^3.23.0",
+    "conf": "^13.0.0"
+  },
+  "devDependencies": {
+    "@types/node": "^22.0.0",
+    "typescript": "^5.5.0"
+  },
+  "scripts": {
+    "build": "tsc",
+    "dev": "tsc --watch",
+    "clean": "rm -rf dist"
+  }
+}