@olane/o-leader 0.6.1

package/README.md

@@ -0,0 +1,86 @@
+TLDR; we created a forked MCP version that is faster, better, and cheaper. [Link to get started]
+
+## What is MCP Missing?
+
+### **Today / Problem Description**
+
+MCP servers are built to enable LLM / AI systems to synthesize workflows from complex tasks. This means MCPs will work great if…
+
+1. You have built your MCP well (example: *as an intention-based tool, not as an API wrapper)*
+    1. *You actively maintain* documentation to support *how* to use your services
+    2. LLM / AI understands how to synthesize plans around small workflows using the tools provided
+2. You pay for intelligent models that can reason / do chain of thought processing.
+
+Every LLM / AI system will need to rerun this, every time. Today it has no working memory on the workflows/plans it runs.
+
+We asked ourselves…”why are these plans and workflows being thrown out?”
+
+### **Olane + MCP = oMCP**
+
+We have forked the MCP client & server to capture and re-use these workflows, reducing intelligence requirements and improving MCP completion by X%. [Link to the repo]
+
+## How did we do this?
+
+We centered our focus on these problems:
+
+1. How can we enable smaller models to succeed just like bigger ones?
+2. How can we reduce waste / reduce token usage?
+3. How can we make AI - MCP usage more deterministic?
+4. How can we improve the speed of MCP usage?
+
+Like teaching a small child, we learned that by simply following the KISS model (KISS → “keep it simple stupid”), we achieved all of this and more. 
+
+> Smaller AI models need less noise and more clear instruction to succeed. In other words, “spell it out for them”
+> 
+
+<aside>
+💡
+
+*Engaging / thoughtful hook? Brendon scratchpad*
+
+How do you get the *right* context from an MCP server to complete your task?
+
+- Do you just throw everything at it? → No, this is wasteful
+- Do you try to condense the knowledge to cost optimize? → Maybe…but how without data loss
+- Do you try to organize MCP usage and learn from similar use-cases? Let’s try it and see what happens…
+</aside>
+
+![normal-mcp.png](./docs/assets/normal-mcp.png)
+
+![o-mcp-flow.png](./docs/assets/o-mcp-flow.png)
+
+### Breaking it down further…
+
+We combine large model successes + failures + a little search to help give small models a helping hand in achieving their dreams.
+
+<aside>
+💡
+
+We learn from past successes & failures to create few shot RL guidelines on how to best utilize the MCP server. 
+
+</aside>
+
+**Example**: 
+
+```
+“Get my latest pull requests”
+Results in the following steps:
+
+1. Client connects to MCP server with an “intent” + “model”
+2. The MCP server searches for past success, failure and relevant tool methods
+3. Client receives the package and creates new "workflow" tool uses
+4. Execute!
+```
+
+### So how does this meet our goals?
+
+1. Smaller model support → more relevant / clear context is now achieved
+2. Reduce token usage → avoid sending irrelevant context when possible / refine tool offerings & also reduce model size requirements
+3. More deterministic → by learning from past failures & successes, we know how to stay within the bounds of success with clear guardrails
+4. Speed improvement → less tokens to process = more speed
+
+### Examples
+
+1. Github example → what models can we test / prove to how it works?
+2. Figma example → same as above ^^
+3. Slack / more complex examples → same as above ^

package/dist/src/index.d.ts

@@ -0,0 +1,3 @@
+export * from './leader.node.js';
+export * from './registry/index.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/src/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,kBAAkB,CAAC;AACjC,cAAc,qBAAqB,CAAC"}

package/dist/src/index.js

@@ -0,0 +1,2 @@
+export * from './leader.node.js';
+export * from './registry/index.js';

package/dist/src/leader.node.d.ts

@@ -0,0 +1,10 @@
+import { oRequest } from '@olane/o-core';
+import { oServerTool, oToolConfig } from '@olane/o-tool';
+export declare class oLeaderNode extends oServerTool {
+    constructor(config: oToolConfig);
+    validateJoinRequest(request: oRequest): Promise<any>;
+    _tool_join_network(request: oRequest): Promise<any>;
+    _tool_save_plan(request: oRequest): Promise<any>;
+    _tool_index_network(request: oRequest): Promise<any>;
+}
+//# sourceMappingURL=leader.node.d.ts.map

package/dist/src/leader.node.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"leader.node.d.ts","sourceRoot":"","sources":["../../src/leader.node.ts"],"names":[],"mappings":"AAAA,OAAO,EAIL,QAAQ,EAET,MAAM,eAAe,CAAC;AACvB,OAAO,EAAE,WAAW,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAGzD,qBAAa,WAAY,SAAQ,WAAW;gBAC9B,MAAM,EAAE,WAAW;IAWzB,mBAAmB,CAAC,OAAO,EAAE,QAAQ,GAAG,OAAO,CAAC,GAAG,CAAC;IAIpD,kBAAkB,CAAC,OAAO,EAAE,QAAQ,GAAG,OAAO,CAAC,GAAG,CAAC;IAuBnD,eAAe,CAAC,OAAO,EAAE,QAAQ,GAAG,OAAO,CAAC,GAAG,CAAC;IAUhD,mBAAmB,CAAC,OAAO,EAAE,QAAQ,GAAG,OAAO,CAAC,GAAG,CAAC;CA2B3D"}

package/dist/src/leader.node.js

@@ -0,0 +1,63 @@
+import { LEADER_ADRESS, NodeType, oAddress, } from '@olane/o-core';
+import { oServerTool } from '@olane/o-tool';
+import { START_METHOD } from './methods/start.method.js';
+export class oLeaderNode extends oServerTool {
+    constructor(config) {
+        super({
+            ...config,
+            address: new oAddress(LEADER_ADRESS),
+            type: NodeType.LEADER,
+            methods: {
+                start: START_METHOD,
+            },
+        });
+    }
+    async validateJoinRequest(request) {
+        return true;
+    }
+    async _tool_join_network(request) {
+        const { caller, parent, transports } = request.params;
+        this.logger.debug('Joining network: ' + caller);
+        if (!caller || !parent || !transports) {
+            throw new Error('Invalid parameters provided, cannot join network');
+        }
+        await this.validateJoinRequest(request);
+        await this.use(new oAddress(parent), {
+            method: 'add_child',
+            params: {
+                address: caller,
+                transports: transports,
+            },
+        });
+        return {
+            message: 'Network joined!',
+        };
+    }
+    async _tool_save_plan(request) {
+        const { plan } = request.params;
+        this.logger.debug('Adding plan to network: ' + plan);
+        if (!this.config.networkName) {
+            this.logger.warn('No network name provided, cannot update config');
+            return;
+        }
+    }
+    async _tool_index_network(request) {
+        // paginate through all the registered nodes and index them
+        const nodes = await this.use(new oAddress('o://leader/register'), {
+            method: 'find_all',
+            params: {},
+        });
+        const nodesArray = nodes.result.data;
+        for (let i = 0; i < nodesArray.length; i++) {
+            // first let's get the node's tools
+            const node = nodesArray[i];
+            const { result } = await this.use(new oAddress(node.address), {
+                method: 'index_network',
+                params: {},
+            });
+        }
+        return {
+            message: 'Network indexed!',
+        };
+    }
+}

package/dist/src/methods/start.method.d.ts

@@ -0,0 +1,3 @@
+import { oMethod } from '@olane/o-protocol';
+export declare const START_METHOD: oMethod;
+//# sourceMappingURL=start.method.d.ts.map

package/dist/src/methods/start.method.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"start.method.d.ts","sourceRoot":"","sources":["../../../src/methods/start.method.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,mBAAmB,CAAC;AAE5C,eAAO,MAAM,YAAY,EAAE,OAoB1B,CAAC"}

package/dist/src/methods/start.method.js

@@ -0,0 +1,21 @@
+export const START_METHOD = {
+    name: 'intent',
+    description: 'Resolve the intent of the task',
+    dependencies: [],
+    parameters: [
+        {
+            name: 'intent',
+            type: 'string',
+            value: 'string',
+            description: 'The intent of the task',
+            required: true,
+        },
+        {
+            name: 'context',
+            type: 'string',
+            value: 'string',
+            description: 'The user input to the task',
+            required: false,
+        },
+    ],
+};

package/dist/src/registry/index.d.ts

@@ -0,0 +1,3 @@
+export * from './registry.tool.js';
+export * from './registry-memory.tool.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/src/registry/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/registry/index.ts"],"names":[],"mappings":"AAAA,cAAc,oBAAoB,CAAC;AACnC,cAAc,2BAA2B,CAAC"}

package/dist/src/registry/index.js

@@ -0,0 +1,2 @@
+export * from './registry.tool.js';
+export * from './registry-memory.tool.js';

package/dist/src/registry/interfaces/search.interface.d.ts

@@ -0,0 +1,6 @@
+export interface oRegistrySearchParams {
+    address?: string;
+    protocols?: string[];
+    staticAddress?: string;
+}
+//# sourceMappingURL=search.interface.d.ts.map

package/dist/src/registry/interfaces/search.interface.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"search.interface.d.ts","sourceRoot":"","sources":["../../../../src/registry/interfaces/search.interface.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,qBAAqB;IACpC,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,SAAS,CAAC,EAAE,MAAM,EAAE,CAAC;IACrB,aAAa,CAAC,EAAE,MAAM,CAAC;CACxB"}

package/dist/src/registry/interfaces/search.interface.js

@@ -0,0 +1 @@
+export {};

package/dist/src/registry/methods/registry.methods.d.ts

@@ -0,0 +1,5 @@
+import { oMethod } from '@olane/o-protocol';
+export declare const REGISTRY_PARAMS: {
+    [key: string]: oMethod;
+};
+//# sourceMappingURL=registry.methods.d.ts.map

package/dist/src/registry/methods/registry.methods.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"registry.methods.d.ts","sourceRoot":"","sources":["../../../../src/registry/methods/registry.methods.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,mBAAmB,CAAC;AAE5C,eAAO,MAAM,eAAe,EAAE;IAAE,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAA;CAyErD,CAAC"}

package/dist/src/registry/methods/registry.methods.js

@@ -0,0 +1,74 @@
+export const REGISTRY_PARAMS = {
+    commit: {
+        name: 'commit',
+        description: 'Commit a node to the registry',
+        dependencies: [],
+        parameters: [
+            {
+                name: 'peerId',
+                type: 'string',
+                value: 'string',
+                description: 'The peerId to commit',
+                required: true,
+            },
+            {
+                name: 'address',
+                type: 'string',
+                value: 'string',
+                description: 'The address to commit',
+            },
+            {
+                name: 'protocols',
+                type: 'array',
+                value: 'string[]',
+                description: 'The protocols to commit',
+            },
+            {
+                name: 'transports',
+                type: 'array',
+                value: 'string[]',
+                description: 'The transports to commit',
+            },
+            {
+                name: 'staticAddress',
+                type: 'string',
+                value: 'string',
+                description: 'The static address to commit',
+            },
+        ],
+    },
+    search: {
+        name: 'search',
+        description: 'Search for a node in the registry using simple query logic.',
+        dependencies: [],
+        parameters: [
+            {
+                name: 'staticAddress',
+                type: 'string',
+                value: 'string',
+                description: 'The static address to search for',
+                required: false,
+            },
+            {
+                name: 'protocols',
+                type: 'array',
+                value: 'string[]',
+                description: 'The protocols to search for',
+                required: false,
+            },
+            {
+                name: 'address',
+                type: 'string',
+                value: 'string',
+                description: 'The address to search for',
+                required: false,
+            },
+        ],
+    },
+    find_all: {
+        name: 'find_all',
+        description: 'Find all nodes in the registry',
+        dependencies: [],
+        parameters: [],
+    },
+};

package/dist/src/registry/registry-memory.tool.d.ts

@@ -0,0 +1,9 @@
+import { RegistryTool } from './registry.tool.js';
+import { oRequest } from '@olane/o-core';
+export declare class RegistryMemoryTool extends RegistryTool {
+    _tool_commit(request: oRequest): Promise<any>;
+    _tool_find_all(request: oRequest): Promise<any>;
+    _tool_search(request: oRequest): Promise<any>;
+    _tool_remove(request: oRequest): Promise<any>;
+}
+//# sourceMappingURL=registry-memory.tool.d.ts.map

package/dist/src/registry/registry-memory.tool.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"registry-memory.tool.d.ts","sourceRoot":"","sources":["../../../src/registry/registry-memory.tool.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAElD,OAAO,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AAGzC,qBAAa,kBAAmB,SAAQ,YAAY;IAC5C,YAAY,CAAC,OAAO,EAAE,QAAQ,GAAG,OAAO,CAAC,GAAG,CAAC;IAuB7C,cAAc,CAAC,OAAO,EAAE,QAAQ,GAAG,OAAO,CAAC,GAAG,CAAC;IAI/C,YAAY,CAAC,OAAO,EAAE,QAAQ,GAAG,OAAO,CAAC,GAAG,CAAC;IA8B7C,YAAY,CAAC,OAAO,EAAE,QAAQ,GAAG,OAAO,CAAC,GAAG,CAAC;CAOpD"}

package/dist/src/registry/registry-memory.tool.js

@@ -0,0 +1,51 @@
+import { RegistryTool } from './registry.tool.js';
+export class RegistryMemoryTool extends RegistryTool {
+    async _tool_commit(request) {
+        const params = request.params;
+        this.logger.debug('Committing registration: ', params?.address, 'With num protocols: ', params?.protocols?.length);
+        // TODO: Implement TTL
+        this.registry.set(params.peerId, params);
+        if (params.protocols) {
+            params.protocols.forEach((protocol) => {
+                this.protocolMapping.set(protocol, [
+                    ...(this.protocolMapping.get(protocol) || []),
+                    params.peerId,
+                ]);
+            });
+        }
+        return {
+            success: true,
+        };
+    }
+    async _tool_find_all(request) {
+        return Array.from(this.registry.values());
+    }
+    async _tool_search(request) {
+        const params = request.params;
+        // iterate over the registry and find all the nodes that match the protocols
+        let result = [];
+        if (params.protocols) {
+            result = result.concat(Array.from(this.registry.values()).filter((node) => {
+                return params.protocols?.every((protocol) => node.protocols.includes(protocol));
+            }));
+        }
+        if (params.address) {
+            result = result.concat(Array.from(this.registry.values()).filter((node) => {
+                return node.address === params.address;
+            }));
+        }
+        if (params.staticAddress) {
+            result = result.concat(Array.from(this.registry.values()).filter((node) => {
+                return node.staticAddress === params.staticAddress;
+            }));
+        }
+        return result;
+    }
+    async _tool_remove(request) {
+        const params = request.params;
+        this.registry.delete(params.peerId);
+        return {
+            success: true,
+        };
+    }
+}

package/dist/src/registry/registry.tool.d.ts

@@ -0,0 +1,13 @@
+import { oToolConfig, oVirtualTool, ToolResult } from '@olane/o-tool';
+import { oRegistrationParams } from '@olane/o-protocol';
+import { oRequest } from '@olane/o-core';
+export declare abstract class RegistryTool extends oVirtualTool {
+    protected readonly registry: Map<string, oRegistrationParams>;
+    protected readonly protocolMapping: Map<string, string[]>;
+    constructor(config: oToolConfig);
+    abstract _tool_commit(request: oRequest): Promise<ToolResult>;
+    abstract _tool_search(request: oRequest): Promise<ToolResult>;
+    abstract _tool_find_all(request: oRequest): Promise<ToolResult>;
+    abstract _tool_remove(request: oRequest): Promise<ToolResult>;
+}
+//# sourceMappingURL=registry.tool.d.ts.map

package/dist/src/registry/registry.tool.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"registry.tool.d.ts","sourceRoot":"","sources":["../../../src/registry/registry.tool.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,YAAY,EAAE,UAAU,EAAE,MAAM,eAAe,CAAC;AACtE,OAAO,EAAE,mBAAmB,EAAE,MAAM,mBAAmB,CAAC;AACxD,OAAO,EAAY,QAAQ,EAAE,MAAM,eAAe,CAAC;AAGnD,8BAAsB,YAAa,SAAQ,YAAY;IACrD,SAAS,CAAC,QAAQ,CAAC,QAAQ,EAAE,GAAG,CAAC,MAAM,EAAE,mBAAmB,CAAC,CAAa;IAC1E,SAAS,CAAC,QAAQ,CAAC,eAAe,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,EAAE,CAAC,CAAa;gBAE1D,MAAM,EAAE,WAAW;IAS/B,QAAQ,CAAC,YAAY,CAAC,OAAO,EAAE,QAAQ,GAAG,OAAO,CAAC,UAAU,CAAC;IAC7D,QAAQ,CAAC,YAAY,CAAC,OAAO,EAAE,QAAQ,GAAG,OAAO,CAAC,UAAU,CAAC;IAC7D,QAAQ,CAAC,cAAc,CAAC,OAAO,EAAE,QAAQ,GAAG,OAAO,CAAC,UAAU,CAAC;IAC/D,QAAQ,CAAC,YAAY,CAAC,OAAO,EAAE,QAAQ,GAAG,OAAO,CAAC,UAAU,CAAC;CAC9D"}

package/dist/src/registry/registry.tool.js

@@ -0,0 +1,15 @@
+import { oVirtualTool } from '@olane/o-tool';
+import { oAddress } from '@olane/o-core';
+import { REGISTRY_PARAMS } from './methods/registry.methods.js';
+export class RegistryTool extends oVirtualTool {
+    constructor(config) {
+        super({
+            ...config,
+            address: new oAddress('o://register'),
+            methods: REGISTRY_PARAMS,
+            description: 'Network registry of tools and their respective addresses',
+        });
+        this.registry = new Map();
+        this.protocolMapping = new Map();
+    }
+}

package/dist/test/basic.spec.d.ts

@@ -0,0 +1 @@
+//# sourceMappingURL=basic.spec.d.ts.map

package/dist/test/basic.spec.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"basic.spec.d.ts","sourceRoot":"","sources":["../../test/basic.spec.ts"],"names":[],"mappings":""}

package/dist/test/basic.spec.js

@@ -0,0 +1 @@
+"use strict";

package/package.json

@@ -0,0 +1,71 @@
+{
+  "name": "@olane/o-leader",
+  "version": "0.6.1",
+  "type": "module",
+  "main": "dist/src/index.js",
+  "types": "dist/src/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/src/index.d.ts",
+      "default": "./dist/src/index.js"
+    }
+  },
+  "files": [
+    "dist/**/*",
+    "README.md",
+    "LICENSE"
+  ],
+  "scripts": {
+    "test": "aegir test",
+    "test:node": "aegir test -t node",
+    "test:browser": "aegir test -t browser",
+    "dev": "DEBUG=o-protocol:* npx tsx src/tests/index.ts",
+    "build": "tsc",
+    "deep:clean": "rm -rf node_modules && rm package-lock.json",
+    "start:prod": "node dist/index.js",
+    "prepublishOnly": "npm run build",
+    "update:lib": "npm install @olane/o-core@latest",
+    "lint": "eslint src/**/*.ts"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/olane-labs/olane.git"
+  },
+  "author": "oLane Inc.",
+  "license": "ISC",
+  "description": "oLane leader node used as the root node for a network",
+  "devDependencies": {
+    "@olane/o-config": "file:../o-config",
+    "@olane/o-core": "file:../..",
+    "@olane/o-protocol": "file:../o-protocol",
+    "@olane/o-tool": "file:../o-tool",
+    "@eslint/eslintrc": "^3.3.1",
+    "@eslint/js": "^9.29.0",
+    "@tsconfig/node20": "^20.1.6",
+    "@types/jest": "^30.0.0",
+    "@typescript-eslint/eslint-plugin": "^8.34.1",
+    "@typescript-eslint/parser": "^8.34.1",
+    "eslint": "^9.29.0",
+    "eslint-config-prettier": "^10.1.6",
+    "eslint-plugin-prettier": "^5.5.0",
+    "globals": "^16.2.0",
+    "jest": "^30.0.0",
+    "prettier": "^3.5.3",
+    "ts-jest": "^29.4.0",
+    "ts-node": "^10.9.2",
+    "tsconfig-paths": "^4.2.0",
+    "tsx": "^4.20.3",
+    "typescript": "5.4.5"
+  },
+  "peerDependencies": {
+    "@olane/o-config": "^0.6.1",
+    "@olane/o-core": "^0.6.1",
+    "@olane/o-protocol": "^0.6.1",
+    "@olane/o-tool": "^0.6.1",
+    "@modelcontextprotocol/sdk": "^1.13.0"
+  },
+  "dependencies": {
+    "debug": "^4.4.1",
+    "dotenv": "^16.5.0"
+  }
+}