lynkr/src/tools/stubs.js

Self-hosted LLM gateway and tier-routing proxy for Claude Code, Cursor, and Codex. Routes across Ollama, AWS Bedrock, OpenRouter, Databricks, Azure OpenAI, llama.cpp, and LM Studio with prompt caching, MCP tools, and 60-80% cost savings.

const { registerTool, hasTool } = require(".");

const STUB_TOOLS = [
  {
    name: "fs_read",
    description: "Read file contents from the active workspace.",
  },
  {
    name: "fs_write",
    description: "Write or create files within the active workspace.",
  },
  {
    name: "edit_patch",
    description: "Apply unified diff patches to workspace files.",
  },
  {
    name: "shell",
    description: "Execute shell commands inside the workspace sandbox.",
  },
  {
    name: "python_exec",
    description: "Run Python snippets in the managed runtime.",
  },
  {
    name: "web_search",
    description: "Perform a web search and return summarized results.",
  },
];

function createStubHandler(name, description) {
  return async ({ args }) => ({
    ok: false,
    status: 501,
    content: {
      error: "tool_not_implemented",
      tool: name,
      description,
      input: args,
      hint: "This is a stub tool. Implement a real handler to enable this capability.",
    },
  });
}

function registerStubTools() {
  STUB_TOOLS.forEach((tool) => {
    if (!hasTool(tool.name)) {
      registerTool(tool.name, createStubHandler(tool.name, tool.description), tool);
    }
  });
}

module.exports = {
  STUB_TOOLS,
  registerStubTools,
};