@tryhamster/gerbil 1.0.4 → 1.0.5

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (84) hide show
  1. package/dist/cli.mjs +10 -10
  2. package/dist/cli.mjs.map +1 -1
  3. package/dist/frameworks/express.d.mts +1 -1
  4. package/dist/frameworks/express.mjs +1 -1
  5. package/dist/frameworks/fastify.d.mts +1 -1
  6. package/dist/frameworks/fastify.mjs +1 -1
  7. package/dist/frameworks/hono.d.mts +1 -1
  8. package/dist/frameworks/hono.mjs +1 -1
  9. package/dist/frameworks/next.d.mts +3 -3
  10. package/dist/frameworks/next.mjs +1 -1
  11. package/dist/frameworks/react.d.mts +1 -1
  12. package/dist/frameworks/trpc.d.mts +1 -1
  13. package/dist/frameworks/trpc.mjs +1 -1
  14. package/dist/gerbil-BgppGzKa.mjs +4 -0
  15. package/dist/{gerbil-BPbJy0_f.mjs → gerbil-CZYYq4Sq.mjs} +4 -4
  16. package/dist/{gerbil-BPbJy0_f.mjs.map → gerbil-CZYYq4Sq.mjs.map} +1 -1
  17. package/dist/{gerbil-BetB5xb0.d.mts → gerbil-CvNqpVg0.d.mts} +3 -3
  18. package/dist/{gerbil-BetB5xb0.d.mts.map → gerbil-CvNqpVg0.d.mts.map} +1 -1
  19. package/dist/gpu/hooks.d.mts +2 -2
  20. package/dist/gpu/hooks.d.mts.map +1 -1
  21. package/dist/gpu/hooks.mjs +4 -5
  22. package/dist/gpu/hooks.mjs.map +1 -1
  23. package/dist/gpu/index.d.mts +1 -1
  24. package/dist/gpu/index.mjs +2 -3
  25. package/dist/{gpu-Dszu2rk-.mjs → gpu-Ch2VuLdN.mjs} +25 -4
  26. package/dist/gpu-Ch2VuLdN.mjs.map +1 -0
  27. package/dist/{index-Dgmb2kE3.d.mts → index-Dy_9rDd5.d.mts} +2 -2
  28. package/dist/{index-Dgmb2kE3.d.mts.map → index-Dy_9rDd5.d.mts.map} +1 -1
  29. package/dist/{index-DukkJRMj.d.mts → index-Nl40RdSs.d.mts} +1 -1
  30. package/dist/{index-DukkJRMj.d.mts.map → index-Nl40RdSs.d.mts.map} +1 -1
  31. package/dist/index.d.mts +5 -5
  32. package/dist/index.mjs +8 -9
  33. package/dist/index.mjs.map +1 -1
  34. package/dist/{indexeddb-store-BWIMtxxH.mjs → indexeddb-store-BEylGAex.mjs} +2 -2
  35. package/dist/{indexeddb-store-BWIMtxxH.mjs.map → indexeddb-store-BEylGAex.mjs.map} +1 -1
  36. package/dist/indexeddb-store-ClSHQxwz.mjs +4 -0
  37. package/dist/integrations/ai-sdk.d.mts +1 -1
  38. package/dist/integrations/ai-sdk.mjs +1 -1
  39. package/dist/integrations/langchain.d.mts +1 -1
  40. package/dist/integrations/langchain.mjs +1 -1
  41. package/dist/integrations/llamaindex.d.mts +1 -1
  42. package/dist/integrations/llamaindex.mjs +1 -1
  43. package/dist/integrations/mcp-client.mjs +1 -1
  44. package/dist/integrations/mcp.d.mts +3 -3
  45. package/dist/integrations/mcp.mjs +4 -4
  46. package/dist/{mcp-C8lTkR3D.mjs → mcp-DUgk28Kp.mjs} +3 -3
  47. package/dist/{mcp-C8lTkR3D.mjs.map → mcp-DUgk28Kp.mjs.map} +1 -1
  48. package/dist/memory/index.d.mts +2 -2
  49. package/dist/memory/index.mjs +4 -4
  50. package/dist/memory-CGRo6zY5.mjs +4 -0
  51. package/dist/{memory-DVN0MnIG.mjs → memory-Deo99oKh.mjs} +2 -2
  52. package/dist/{memory-DVN0MnIG.mjs.map → memory-Deo99oKh.mjs.map} +1 -1
  53. package/dist/{memory-Dj0J1v88.mjs → memory-wgo2ZK3M.mjs} +2 -2
  54. package/dist/{memory-Dj0J1v88.mjs.map → memory-wgo2ZK3M.mjs.map} +1 -1
  55. package/dist/moonshine-stt-DFIP4tIb.mjs +4 -0
  56. package/dist/{moonshine-stt-DNVw8v_Y.mjs → moonshine-stt-DR0-JbVW.mjs} +1 -1
  57. package/dist/{moonshine-stt-DNVw8v_Y.mjs.map → moonshine-stt-DR0-JbVW.mjs.map} +1 -1
  58. package/dist/{one-liner-VcUGmyTZ.mjs → one-liner-sTDG9Hum.mjs} +2 -2
  59. package/dist/{one-liner-VcUGmyTZ.mjs.map → one-liner-sTDG9Hum.mjs.map} +1 -1
  60. package/dist/repl-njlFQs4-.mjs +9 -0
  61. package/dist/skills/index.d.mts +14 -14
  62. package/dist/skills/index.d.mts.map +1 -1
  63. package/dist/skills/index.mjs +3 -3
  64. package/dist/{skills-B6Cor5wy.mjs → skills-CEUuOUlm.mjs} +2 -2
  65. package/dist/{skills-B6Cor5wy.mjs.map → skills-CEUuOUlm.mjs.map} +1 -1
  66. package/dist/{tools-DQ1mPUw5.mjs → tools-DbbNCJ5y.mjs} +1 -1
  67. package/dist/{tools-DQ1mPUw5.mjs.map → tools-DbbNCJ5y.mjs.map} +1 -1
  68. package/dist/{types-LlyYILII.d.mts → types-Bxwe_uS7.d.mts} +1 -1
  69. package/dist/{types-LlyYILII.d.mts.map → types-Bxwe_uS7.d.mts.map} +1 -1
  70. package/dist/{types-DQBe2lFo.d.mts → types-D7kn-0i2.d.mts} +1 -1
  71. package/dist/{types-DQBe2lFo.d.mts.map → types-D7kn-0i2.d.mts.map} +1 -1
  72. package/dist/{vector-B0panuy6.mjs → vector-C1U9vVVS.mjs} +1 -1
  73. package/dist/{vector-B0panuy6.mjs.map → vector-C1U9vVVS.mjs.map} +1 -1
  74. package/package.json +1 -1
  75. package/dist/defaults-9komdrbY.mjs +0 -24
  76. package/dist/defaults-9komdrbY.mjs.map +0 -1
  77. package/dist/gerbil-BoHXwcdY.mjs +0 -4
  78. package/dist/gpu-Dszu2rk-.mjs.map +0 -1
  79. package/dist/indexeddb-store-ClH12Xnl.mjs +0 -4
  80. package/dist/memory-D1P7Tmda.mjs +0 -4
  81. package/dist/moonshine-stt-rXESw8t8.mjs +0 -4
  82. package/dist/repl-WUbQ1UgU.mjs +0 -9
  83. /package/dist/{auto-update-BVaLXcDE.mjs → auto-update-DNbr3GLz.mjs} +0 -0
  84. /package/dist/{microphone-Bqmoz9_K.mjs → microphone-sj_bnRm-.mjs} +0 -0
@@ -1 +1 @@
1
- {"version":3,"file":"tools-DQ1mPUw5.mjs","names":["GERBIL_DOCS: Record<string, string>","matches: string[]","toolContext: ToolContext | null","results: LoadedToolResult[]"],"sources":["../src/core/docs.ts","../src/core/tools.ts"],"sourcesContent":["/**\n * Gerbil Documentation Content\n *\n * Documentation strings used by the gerbil_docs tool\n * for answering questions about Gerbil features.\n */\n\nexport const GERBIL_DOCS: Record<string, string> = {\n // Core\n quickstart: `Gerbil Quick Start:\n\\`\\`\\`typescript\nimport { Gerbil } from \"gerbil\";\n\nconst g = new Gerbil();\nawait g.loadModel(\"qwen3.5-0.8b\");\n\n// Generate text\nconst result = await g.generate(\"Write a haiku\");\nconsole.log(result.text);\n\n// Stream responses\nfor await (const chunk of g.stream(\"Tell me a story\")) {\n process.stdout.write(chunk);\n}\n\\`\\`\\``,\n\n generate: `Generate text with options:\n\\`\\`\\`typescript\nconst result = await gerbil.generate(prompt, {\n maxTokens: 256, // Max tokens to generate\n temperature: 0.7, // 0-2, higher = more creative\n topP: 0.9, // Nucleus sampling\n topK: 50, // Top-k sampling\n thinking: false, // Enable reasoning mode (Qwen3)\n system: \"You are...\", // System prompt\n});\n\n// Result contains:\nresult.text // Generated text\nresult.thinking // Reasoning (if thinking=true)\nresult.tokensGenerated\nresult.tokensPerSecond\nresult.totalTime\n\\`\\`\\``,\n\n stream: `Streaming responses:\n\\`\\`\\`typescript\nfor await (const chunk of gerbil.stream(\"Hello\")) {\n process.stdout.write(chunk);\n}\n\n// With options\nconst stream = gerbil.stream(\"Explain React\", {\n maxTokens: 500,\n onToken: (token) => console.log(token),\n});\n\\`\\`\\``,\n\n json: `Structured JSON output with Zod validation:\n\\`\\`\\`typescript\nimport { z } from \"zod\";\n\nconst PersonSchema = z.object({\n name: z.string(),\n age: z.number(),\n city: z.string(),\n});\n\nconst data = await gerbil.json(\"Extract: John is 32 and lives in NYC\", {\n schema: PersonSchema,\n retries: 3, // Retry on validation failure\n temperature: 0.3, // Lower = more consistent\n});\n// { name: \"John\", age: 32, city: \"NYC\" }\n\\`\\`\\``,\n\n \"generate-object\": `Structured object output with retries (generateObject):\n\\`\\`\\`typescript\nimport { generateObject } from \"@tryhamster/gerbil\";\n\n// Validate with a minimal { required } schema or a predicate; omit to accept any JSON.\nconst { object, attempts } = await generateObject(\n 'Extract {name, age} from: \"I am Sarah, 28\"',\n { schema: { required: [\"name\", \"age\"] }, maxRetries: 4 },\n);\n// object === { name: \"Sarah\", age: 28 }\n\\`\\`\\`\n\nAlso on the Gerbil class (g.generateObject), the engine\n(WebGPUEngine.generateObject), the useObject React hook, and the CLI\n(gerbil object \"...\" --schema person.json). Unlike json() (Zod), this uses a\npredicate/required-keys validator and retries with a corrective nudge.`,\n\n thinking: `Thinking mode (chain-of-thought reasoning) - Qwen3 models:\n\\`\\`\\`typescript\nconst result = await gerbil.generate(\"What is 127 × 43?\", {\n thinking: true,\n});\n\nconsole.log(result.thinking);\n// \"Let me calculate step by step: 127 × 43 = 127 × 40 + 127 × 3...\"\n\nconsole.log(result.text);\n// \"5461\"\n\\`\\`\\`\n\nEnable in chat with /no_think or /think commands, or enable_thinking parameter.`,\n\n embed: `Generate embeddings:\n\\`\\`\\`typescript\n// Single text\nconst { vector } = await gerbil.embed(\"Hello world\");\n// vector: number[] (384 dimensions by default)\n\n// Batch\nconst results = await gerbil.embedBatch([\"Hello\", \"World\"]);\n\\`\\`\\``,\n\n // Models\n models: `Available models (native WebGPU engine, INT4 on-device):\n\n| Model | Size | Best For |\n|-------|------|----------|\n| qwen3.5-0.8b | ~1.6GB | Default — fast, multimodal, 262k context, thinking mode |\n| qwen3.5-2b | ~4GB | Best quality, multimodal, 262k context, thinking mode |\n| lfm2.5-1.2b-thinking | ~2.4GB | Efficient reasoning, 128k context |\n\nLoad any HuggingFace model with a supported architecture (Qwen2/Qwen3/Qwen3.5/LFM2):\n\\`\\`\\`typescript\nawait gerbil.loadModel(\"hf:org/model\");\nawait gerbil.loadModel(\"Qwen/Qwen3.5-0.8B\");\n\\`\\`\\``,\n\n load: `Loading models:\n\\`\\`\\`typescript\nawait gerbil.loadModel(\"qwen3.5-0.8b\", {\n device: \"webgpu\", // native WebGPU engine (Dawn in Node, WebGPU in browser)\n onProgress: (p) => {\n console.log(p.status, p.progress, p.file);\n },\n});\n\\`\\`\\``,\n\n // AI SDK\n \"ai-sdk\": `Vercel AI SDK v5 integration:\n\\`\\`\\`typescript\nimport { generateText, streamText } from \"ai\";\nimport { gerbil } from \"gerbil/ai\";\n\n// Generate\nconst { text } = await generateText({\n model: gerbil(\"qwen3.5-0.8b\"),\n prompt: \"Write a commit message\",\n});\n\n// Stream\nconst stream = streamText({\n model: gerbil(\"qwen3.5-0.8b\"),\n prompt: \"Explain React hooks\",\n});\n\nfor await (const chunk of stream.textStream) {\n process.stdout.write(chunk);\n}\n\n// With thinking mode\nconst { text } = await generateText({\n model: gerbil(\"qwen3.5-0.8b\", { thinking: true }),\n prompt: \"What is 127 × 43?\",\n});\n\\`\\`\\``,\n\n // Frameworks\n next: `Next.js App Router integration:\n\\`\\`\\`typescript\n// app/api/chat/route.ts\nimport { gerbil } from \"gerbil/next\";\n\nexport const POST = gerbil.handler({ \n model: \"qwen3.5-0.8b\",\n maxTokens: 500,\n});\n\\`\\`\\``,\n\n express: `Express.js integration:\n\\`\\`\\`typescript\nimport express from \"express\";\nimport { gerbil } from \"gerbil/express\";\n\nconst app = express();\napp.use(\"/ai\", gerbil()());\n\n// Endpoints created:\n// POST /ai/generate - Generate text\n// POST /ai/stream - Stream text\n// POST /ai/json - Structured output\n// POST /ai/embed - Embeddings\n\\`\\`\\``,\n\n react: `React hooks:\n\\`\\`\\`typescript\nimport { useGerbil, useChat } from \"gerbil/react\";\n\nfunction Chat() {\n const { generate, isLoading } = useGerbil();\n \n const handleSubmit = async (prompt: string) => {\n const result = await generate(prompt);\n console.log(result.text);\n };\n}\n\\`\\`\\``,\n\n hono: `Hono integration:\n\\`\\`\\`typescript\nimport { Hono } from \"hono\";\nimport { gerbil } from \"gerbil/hono\";\n\nconst app = new Hono();\napp.route(\"/ai\", await gerbil()());\n\\`\\`\\``,\n\n langchain: `LangChain integration:\n\\`\\`\\`typescript\nimport { GerbilLLM, GerbilEmbeddings } from \"gerbil/langchain\";\n\nconst llm = new GerbilLLM({ model: \"qwen3.5-0.8b\" });\nconst embeddings = new GerbilEmbeddings();\n\n// Use with chains\nconst chain = new LLMChain({ llm, prompt: template });\n\\`\\`\\``,\n\n mcp: `MCP Server for Claude Desktop & Cursor:\n\\`\\`\\`bash\ngerbil serve --mcp\n\\`\\`\\`\n\nSkills are automatically exposed as MCP tools:\n- gerbil_generate\n- gerbil_commit\n- gerbil_summarize\n- gerbil_explain\n- etc.`,\n\n // Skills\n skills: `Skills are reusable AI tasks with Zod validation:\n\\`\\`\\`typescript\nimport { commit, summarize, explain, review } from \"gerbil/skills\";\n\n// Generate commit message\nconst msg = await commit({ type: \"conventional\", maxLength: 72 });\n\n// Summarize content\nconst summary = await summarize({ \n content: doc, \n length: \"short\",\n format: \"bullets\" \n});\n\n// Explain code\nconst explanation = await explain({ \n content: code, \n level: \"beginner\" \n});\n\n// Code review\nconst feedback = await review({ \n code, \n focus: [\"security\", \"performance\"] \n});\n\\`\\`\\`\n\nBuilt-in skills: commit, summarize, explain, review, test, translate, extract, title`,\n\n \"define-skill\": `Create custom skills:\n\\`\\`\\`typescript\nimport { defineSkill } from \"gerbil/skills\";\nimport { z } from \"zod\";\n\nexport const sentiment = defineSkill({\n name: \"sentiment\",\n description: \"Analyze text sentiment\",\n input: z.object({ \n text: z.string(),\n detailed: z.boolean().default(false)\n }),\n output: z.object({\n sentiment: z.enum([\"positive\", \"negative\", \"neutral\"]),\n confidence: z.number(),\n }),\n temperature: 0.3,\n maxTokens: 100,\n \n async run({ input, gerbil }) {\n return gerbil.json(\\`Sentiment of: \\${input.text}\\`, {\n schema: this.output,\n });\n },\n});\n\\`\\`\\``,\n\n \"load-skills\": `Load skills from files:\n\\`\\`\\`typescript\nimport { loadSkills, useSkill, listSkills } from \"gerbil/skills\";\n\n// Load from directory (*.skill.ts files)\nawait loadSkills(\"./skills\");\n\n// Use by name\nconst skill = useSkill(\"my-skill\");\nconst result = await skill({ text: \"Hello\" });\n\n// List all\nconsole.log(listSkills()); // [\"commit\", \"summarize\", ...]\n\\`\\`\\``,\n\n // CLI\n cli: `CLI commands:\n\\`\\`\\`bash\ngerbil \"Write a haiku\" # Generate text\ngerbil -m qwen3.5-0.8b \"prompt\" # Specify model\ngerbil --thinking \"127 × 43\" # Enable reasoning\n\ngerbil commit # Git commit message\ngerbil summarize README.md # Summarize file\ngerbil explain src/index.ts # Explain code\n\ngerbil chat # Interactive chat\ngerbil chat --thinking # With reasoning\n\ngerbil serve # HTTP server\ngerbil serve --mcp # MCP server\n\ngerbil models # List models\ngerbil cache # Show cached models\ngerbil bench # Benchmark\ngerbil info # System info\n\ngerbil repl # Interactive TUI\n\\`\\`\\``,\n\n // Tools/Agents\n tools: `Gerbil supports tool calling with Qwen3 models:\n\\`\\`\\`typescript\nimport { defineTool, executeToolCall } from \"gerbil\";\n\nconst weatherTool = defineTool({\n name: \"get_weather\",\n description: \"Get current weather for a city\",\n parameters: z.object({\n city: z.string(),\n }),\n execute: async ({ city }) => {\n return \\`Weather in \\${city}: 72°F, sunny\\`;\n },\n});\n\\`\\`\\`\n\nIn the REPL, use Agent mode (Tab → Agent) to enable tools.`,\n};\n\n/**\n * Get all available documentation topics\n */\nexport function getDocTopics(): string[] {\n return Object.keys(GERBIL_DOCS);\n}\n\n/**\n * Search documentation by topic\n */\nexport function searchDocs(query: string): string | null {\n const words = query.toLowerCase().split(/\\s+/);\n const keyWords = words.filter((w) => w.length > 2);\n\n // Direct key match first\n for (const [key, content] of Object.entries(GERBIL_DOCS)) {\n const keyNorm = key.replace(/-/g, \"\");\n for (const word of keyWords) {\n if (keyNorm === word || key === word || keyNorm.includes(word)) {\n return content;\n }\n }\n }\n\n // Try each word as a potential topic\n for (const word of keyWords) {\n for (const [key, content] of Object.entries(GERBIL_DOCS)) {\n if (key.includes(word) || word.includes(key.replace(/-/g, \"\"))) {\n return content;\n }\n }\n }\n\n // Fallback: search content\n const matches: string[] = [];\n for (const [key, content] of Object.entries(GERBIL_DOCS)) {\n for (const word of keyWords) {\n if (content.toLowerCase().includes(word)) {\n matches.push(`## ${key}\\n${content}`);\n break;\n }\n }\n }\n\n if (matches.length > 0) {\n return matches.slice(0, 2).join(\"\\n\\n---\\n\\n\");\n }\n\n return null;\n}\n","/**\n * Tool Calling System for Gerbil\n *\n * Enables LLMs to call functions/tools during generation.\n * Compatible with Qwen3's tool calling format.\n */\n\nimport { z } from \"zod\";\nimport { getDocTopics, searchDocs } from \"./docs.js\";\nimport { zodToJsonSchema } from \"./utils.js\";\n\n// ============================================\n// Tool Context (for passing gerbil to tools)\n// ============================================\n\nexport type ToolContext = {\n /** Generate text using the loaded model */\n generate: (prompt: string) => Promise<string>;\n};\n\nlet toolContext: ToolContext | null = null;\n\n/**\n * Set the tool context (call this after loading a model)\n */\nexport function setToolContext(ctx: ToolContext): void {\n toolContext = ctx;\n}\n\n/**\n * Get the tool context for use in tools\n */\nexport function getToolContext(): ToolContext | null {\n return toolContext;\n}\n\n// ============================================\n// Tool Definition\n// ============================================\n\nexport type ToolDefinition<TParams = unknown> = {\n /** Tool name (function name) */\n name: string;\n\n /** Description for the LLM */\n description: string;\n\n /** Zod schema for parameters */\n parameters?: z.ZodType<TParams>;\n\n /** The function to execute (receives params and optional context) */\n execute: (params: TParams, ctx?: ToolContext | null) => Promise<string>;\n};\n\nexport type Tool<TParams = unknown> = {\n definition: ToolDefinition<TParams>;\n (params: TParams): Promise<string>;\n};\n\n// ============================================\n// Tool Registry\n// ============================================\n\nconst toolRegistry = new Map<string, Tool<any>>();\n\n/**\n * Define a tool\n */\nexport function defineTool<TParams>(def: ToolDefinition<TParams>): Tool<TParams> {\n const tool = async (params: TParams): Promise<string> => {\n // Validate params if schema provided\n if (def.parameters) {\n const parsed = def.parameters.parse(params);\n return def.execute(parsed, toolContext);\n }\n return def.execute(params, toolContext);\n };\n\n (tool as Tool<TParams>).definition = def;\n\n // Auto-register\n toolRegistry.set(def.name, tool as Tool<any>);\n\n return tool as Tool<TParams>;\n}\n\n/**\n * Get tool by name\n */\nexport function getTool(name: string): Tool<any> | undefined {\n return toolRegistry.get(name);\n}\n\n/**\n * List all tools\n */\nexport function listTools(): string[] {\n return Array.from(toolRegistry.keys());\n}\n\n/**\n * Get all tool definitions for prompt injection\n */\nexport function getToolDefinitions(): ToolDefinition<any>[] {\n return Array.from(toolRegistry.values()).map((t) => t.definition);\n}\n\nexport type LoadedToolResult = {\n name: string;\n loaded: boolean;\n error?: string;\n path: string;\n};\n\n/**\n * Simple tool config (no imports needed in tool files)\n */\nexport type SimpleToolConfig = {\n name: string;\n description: string;\n execute: (params: Record<string, any>) => Promise<string> | string;\n};\n\n/**\n * Load tools from a directory\n * Tools are simple .ts files with a default export config object\n * No module imports - we eval the execute function directly\n */\nexport async function loadTools(dir: string): Promise<LoadedToolResult[]> {\n const fs = await import(\"node:fs\");\n const pathModule = await import(\"node:path\");\n\n if (!fs.existsSync(dir)) {\n return [];\n }\n\n const files = fs.readdirSync(dir).filter((f) => f.endsWith(\".tool.ts\") || f.endsWith(\".tool.js\"));\n const results: LoadedToolResult[] = [];\n\n for (const file of files) {\n const filePath = pathModule.join(dir, file);\n const toolName = file.replace(/\\.tool\\.(ts|js)$/, \"\");\n\n try {\n // Read file content directly\n const content = fs.readFileSync(filePath, \"utf-8\");\n\n // Extract the config object using simple parsing\n const config = parseToolFile(content, toolName);\n\n if (config) {\n // Register the tool\n defineTool({\n name: config.name,\n description: config.description,\n execute: async (params, ctx) => {\n // Project tools may or may not accept ctx parameter\n const executeFn = config.execute as any;\n const result = await executeFn(params, ctx);\n return typeof result === \"string\" ? result : String(result);\n },\n });\n results.push({ name: config.name, loaded: true, path: filePath });\n } else {\n results.push({\n name: toolName,\n loaded: false,\n error: \"Could not parse tool config\",\n path: filePath,\n });\n }\n } catch (e) {\n const errorMsg = e instanceof Error ? e.message.split(\"\\n\")[0] : String(e);\n results.push({ name: toolName, loaded: false, error: errorMsg, path: filePath });\n }\n }\n\n return results;\n}\n\n/**\n * Parse a simple tool file and extract the config\n * Expected format:\n * ```\n * export default {\n * name: \"tool_name\",\n * description: \"...\",\n * execute: async (params) => { ... }\n * }\n * ```\n */\nfunction parseToolFile(content: string, fallbackName: string): SimpleToolConfig | null {\n try {\n // Remove TypeScript type annotations for eval\n let cleaned = content\n .replace(/:\\s*\\{[^}]+\\}/g, \"\") // Remove type objects like : { theme?: string }\n .replace(/:\\s*Record<[^>]+>/g, \"\") // Remove Record types\n .replace(/:\\s*string\\b/g, \"\")\n .replace(/:\\s*number\\b/g, \"\")\n .replace(/:\\s*boolean\\b/g, \"\")\n .replace(/:\\s*any\\b/g, \"\")\n .replace(/:\\s*Promise<[^>]+>/g, \"\")\n .replace(/export\\s+default\\s+/, \"return \");\n\n // Remove comments\n cleaned = cleaned.replace(/\\/\\/.*$/gm, \"\").replace(/\\/\\*[\\s\\S]*?\\*\\//g, \"\");\n\n // Wrap in function and evaluate\n const fn = new Function(cleaned);\n const config = fn();\n\n if (config && typeof config === \"object\" && config.name && config.execute) {\n return {\n name: config.name || fallbackName,\n description: config.description || \"No description\",\n execute: config.execute,\n };\n }\n return null;\n } catch (_e) {\n return null;\n }\n}\n\n/**\n * Load tools from project .gerbil/tools directory\n */\nexport async function loadProjectTools(): Promise<LoadedToolResult[]> {\n const pathModule = await import(\"node:path\");\n const toolsDir = pathModule.join(process.cwd(), \".gerbil\", \"tools\");\n return loadTools(toolsDir);\n}\n\n// Re-export for backwards compatibility\nexport { zodToJsonSchema } from \"./utils.js\";\n\n/**\n * Format tools for Qwen3 prompt\n */\nexport function formatToolsForPrompt(tools: ToolDefinition<any>[]): string {\n if (tools.length === 0) {\n return \"\";\n }\n\n const toolDefs = tools\n .map((t) => {\n const params = t.parameters\n ? zodToJsonSchema(t.parameters)\n : { type: \"object\", properties: {} };\n return `## ${t.name}\n\nDescription: ${t.description}\nParameters: ${JSON.stringify(params, null, 2)}`;\n })\n .join(\"\\n\\n\");\n\n return `You are a helpful assistant with access to tools.\n\n# Tools\n\n${toolDefs}\n\n## How to call tools\n\nTo call a tool, use this exact format:\n<tool_call>\n{\"name\": \"tool_name\", \"arguments\": {\"param\": \"value\"}}\n</tool_call>\n\nWhen the user asks about Gerbil (documentation, features, how to use), call gerbil_docs with a topic like: tools, skills, ai-sdk, next, express, generate, stream, models, cli.\n\nFor other questions, respond normally without calling tools.`;\n}\n\n/**\n * Parse tool call from response\n */\nexport function parseToolCall(response: string): { tool: string; params: any } | null {\n try {\n // Try <tool_call> format first (Qwen style)\n const toolCallMatch = response.match(/<tool_call>\\s*([\\s\\S]*?)\\s*<\\/tool_call>/);\n if (toolCallMatch) {\n const parsed = JSON.parse(toolCallMatch[1]);\n if (parsed.name) {\n return { tool: parsed.name, params: parsed.arguments || {} };\n }\n }\n\n // Fallback: look for {\"name\": \"...\", \"arguments\": ...} pattern\n const nameArgsMatch = response.match(\n /\\{\\s*\"name\"\\s*:\\s*\"([^\"]+)\"[^}]*\"arguments\"\\s*:\\s*(\\{[^}]*\\})/,\n );\n if (nameArgsMatch) {\n return { tool: nameArgsMatch[1], params: JSON.parse(nameArgsMatch[2]) };\n }\n\n // Fallback: {\"tool\": \"...\", \"params\": ...} pattern\n const toolParamsMatch = response.match(\n /\\{\\s*\"tool\"\\s*:\\s*\"([^\"]+)\"[^}]*\"params\"\\s*:\\s*(\\{[^}]*\\})/,\n );\n if (toolParamsMatch) {\n return { tool: toolParamsMatch[1], params: JSON.parse(toolParamsMatch[2]) };\n }\n\n // Simple fallback\n const simpleMatch = response.match(/\\{\\s*\"(?:tool|name)\"\\s*:\\s*\"([^\"]+)\"/);\n if (simpleMatch) {\n return { tool: simpleMatch[1], params: {} };\n }\n } catch {}\n return null;\n}\n\n/**\n * Execute a tool call\n */\nexport async function executeToolCall(toolName: string, params: any): Promise<string> {\n const tool = getTool(toolName);\n if (!tool) {\n return `Error: Unknown tool \"${toolName}\"`;\n }\n\n try {\n return await tool(params);\n } catch (e) {\n return `Error executing ${toolName}: ${e}`;\n }\n}\n\n// ============================================\n// Built-in Tools\n// ============================================\n\n/**\n * Docs tool - searches gerbil documentation\n * Documentation content is in core/docs.ts\n */\nexport const docsTool = defineTool({\n name: \"gerbil_docs\",\n description:\n \"Search Gerbil documentation for information about features, API, integrations, skills, and usage examples\",\n parameters: z.object({\n query: z\n .string()\n .optional()\n .default(\"quickstart\")\n .describe(\n \"Topic: quickstart, generate, stream, json, thinking, embed, models, ai-sdk, next, express, react, skills, define-skill, cli, tools\",\n ),\n }),\n execute: async ({ query = \"quickstart\" }) => {\n const result = searchDocs(query);\n if (result) {\n return result;\n }\n const topics = getDocTopics().join(\", \");\n return `No documentation found for \"${query}\". Available topics: ${topics}`;\n },\n});\n"],"mappings":"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"}
1
+ {"version":3,"file":"tools-DbbNCJ5y.mjs","names":["GERBIL_DOCS: Record<string, string>","matches: string[]","toolContext: ToolContext | null","results: LoadedToolResult[]"],"sources":["../src/core/docs.ts","../src/core/tools.ts"],"sourcesContent":["/**\n * Gerbil Documentation Content\n *\n * Documentation strings used by the gerbil_docs tool\n * for answering questions about Gerbil features.\n */\n\nexport const GERBIL_DOCS: Record<string, string> = {\n // Core\n quickstart: `Gerbil Quick Start:\n\\`\\`\\`typescript\nimport { Gerbil } from \"gerbil\";\n\nconst g = new Gerbil();\nawait g.loadModel(\"qwen3.5-0.8b\");\n\n// Generate text\nconst result = await g.generate(\"Write a haiku\");\nconsole.log(result.text);\n\n// Stream responses\nfor await (const chunk of g.stream(\"Tell me a story\")) {\n process.stdout.write(chunk);\n}\n\\`\\`\\``,\n\n generate: `Generate text with options:\n\\`\\`\\`typescript\nconst result = await gerbil.generate(prompt, {\n maxTokens: 256, // Max tokens to generate\n temperature: 0.7, // 0-2, higher = more creative\n topP: 0.9, // Nucleus sampling\n topK: 50, // Top-k sampling\n thinking: false, // Enable reasoning mode (Qwen3)\n system: \"You are...\", // System prompt\n});\n\n// Result contains:\nresult.text // Generated text\nresult.thinking // Reasoning (if thinking=true)\nresult.tokensGenerated\nresult.tokensPerSecond\nresult.totalTime\n\\`\\`\\``,\n\n stream: `Streaming responses:\n\\`\\`\\`typescript\nfor await (const chunk of gerbil.stream(\"Hello\")) {\n process.stdout.write(chunk);\n}\n\n// With options\nconst stream = gerbil.stream(\"Explain React\", {\n maxTokens: 500,\n onToken: (token) => console.log(token),\n});\n\\`\\`\\``,\n\n json: `Structured JSON output with Zod validation:\n\\`\\`\\`typescript\nimport { z } from \"zod\";\n\nconst PersonSchema = z.object({\n name: z.string(),\n age: z.number(),\n city: z.string(),\n});\n\nconst data = await gerbil.json(\"Extract: John is 32 and lives in NYC\", {\n schema: PersonSchema,\n retries: 3, // Retry on validation failure\n temperature: 0.3, // Lower = more consistent\n});\n// { name: \"John\", age: 32, city: \"NYC\" }\n\\`\\`\\``,\n\n \"generate-object\": `Structured object output with retries (generateObject):\n\\`\\`\\`typescript\nimport { generateObject } from \"@tryhamster/gerbil\";\n\n// Validate with a minimal { required } schema or a predicate; omit to accept any JSON.\nconst { object, attempts } = await generateObject(\n 'Extract {name, age} from: \"I am Sarah, 28\"',\n { schema: { required: [\"name\", \"age\"] }, maxRetries: 4 },\n);\n// object === { name: \"Sarah\", age: 28 }\n\\`\\`\\`\n\nAlso on the Gerbil class (g.generateObject), the engine\n(WebGPUEngine.generateObject), the useObject React hook, and the CLI\n(gerbil object \"...\" --schema person.json). Unlike json() (Zod), this uses a\npredicate/required-keys validator and retries with a corrective nudge.`,\n\n thinking: `Thinking mode (chain-of-thought reasoning) - Qwen3 models:\n\\`\\`\\`typescript\nconst result = await gerbil.generate(\"What is 127 × 43?\", {\n thinking: true,\n});\n\nconsole.log(result.thinking);\n// \"Let me calculate step by step: 127 × 43 = 127 × 40 + 127 × 3...\"\n\nconsole.log(result.text);\n// \"5461\"\n\\`\\`\\`\n\nEnable in chat with /no_think or /think commands, or enable_thinking parameter.`,\n\n embed: `Generate embeddings:\n\\`\\`\\`typescript\n// Single text\nconst { vector } = await gerbil.embed(\"Hello world\");\n// vector: number[] (384 dimensions by default)\n\n// Batch\nconst results = await gerbil.embedBatch([\"Hello\", \"World\"]);\n\\`\\`\\``,\n\n // Models\n models: `Available models (native WebGPU engine, INT4 on-device):\n\n| Model | Size | Best For |\n|-------|------|----------|\n| qwen3.5-0.8b | ~1.6GB | Default — fast, multimodal, 262k context, thinking mode |\n| qwen3.5-2b | ~4GB | Best quality, multimodal, 262k context, thinking mode |\n| lfm2.5-1.2b-thinking | ~2.4GB | Efficient reasoning, 128k context |\n\nLoad any HuggingFace model with a supported architecture (Qwen2/Qwen3/Qwen3.5/LFM2):\n\\`\\`\\`typescript\nawait gerbil.loadModel(\"hf:org/model\");\nawait gerbil.loadModel(\"Qwen/Qwen3.5-0.8B\");\n\\`\\`\\``,\n\n load: `Loading models:\n\\`\\`\\`typescript\nawait gerbil.loadModel(\"qwen3.5-0.8b\", {\n device: \"webgpu\", // native WebGPU engine (Dawn in Node, WebGPU in browser)\n onProgress: (p) => {\n console.log(p.status, p.progress, p.file);\n },\n});\n\\`\\`\\``,\n\n // AI SDK\n \"ai-sdk\": `Vercel AI SDK v5 integration:\n\\`\\`\\`typescript\nimport { generateText, streamText } from \"ai\";\nimport { gerbil } from \"gerbil/ai\";\n\n// Generate\nconst { text } = await generateText({\n model: gerbil(\"qwen3.5-0.8b\"),\n prompt: \"Write a commit message\",\n});\n\n// Stream\nconst stream = streamText({\n model: gerbil(\"qwen3.5-0.8b\"),\n prompt: \"Explain React hooks\",\n});\n\nfor await (const chunk of stream.textStream) {\n process.stdout.write(chunk);\n}\n\n// With thinking mode\nconst { text } = await generateText({\n model: gerbil(\"qwen3.5-0.8b\", { thinking: true }),\n prompt: \"What is 127 × 43?\",\n});\n\\`\\`\\``,\n\n // Frameworks\n next: `Next.js App Router integration:\n\\`\\`\\`typescript\n// app/api/chat/route.ts\nimport { gerbil } from \"gerbil/next\";\n\nexport const POST = gerbil.handler({ \n model: \"qwen3.5-0.8b\",\n maxTokens: 500,\n});\n\\`\\`\\``,\n\n express: `Express.js integration:\n\\`\\`\\`typescript\nimport express from \"express\";\nimport { gerbil } from \"gerbil/express\";\n\nconst app = express();\napp.use(\"/ai\", gerbil()());\n\n// Endpoints created:\n// POST /ai/generate - Generate text\n// POST /ai/stream - Stream text\n// POST /ai/json - Structured output\n// POST /ai/embed - Embeddings\n\\`\\`\\``,\n\n react: `React hooks:\n\\`\\`\\`typescript\nimport { useGerbil, useChat } from \"gerbil/react\";\n\nfunction Chat() {\n const { generate, isLoading } = useGerbil();\n \n const handleSubmit = async (prompt: string) => {\n const result = await generate(prompt);\n console.log(result.text);\n };\n}\n\\`\\`\\``,\n\n hono: `Hono integration:\n\\`\\`\\`typescript\nimport { Hono } from \"hono\";\nimport { gerbil } from \"gerbil/hono\";\n\nconst app = new Hono();\napp.route(\"/ai\", await gerbil()());\n\\`\\`\\``,\n\n langchain: `LangChain integration:\n\\`\\`\\`typescript\nimport { GerbilLLM, GerbilEmbeddings } from \"gerbil/langchain\";\n\nconst llm = new GerbilLLM({ model: \"qwen3.5-0.8b\" });\nconst embeddings = new GerbilEmbeddings();\n\n// Use with chains\nconst chain = new LLMChain({ llm, prompt: template });\n\\`\\`\\``,\n\n mcp: `MCP Server for Claude Desktop & Cursor:\n\\`\\`\\`bash\ngerbil serve --mcp\n\\`\\`\\`\n\nSkills are automatically exposed as MCP tools:\n- gerbil_generate\n- gerbil_commit\n- gerbil_summarize\n- gerbil_explain\n- etc.`,\n\n // Skills\n skills: `Skills are reusable AI tasks with Zod validation:\n\\`\\`\\`typescript\nimport { commit, summarize, explain, review } from \"gerbil/skills\";\n\n// Generate commit message\nconst msg = await commit({ type: \"conventional\", maxLength: 72 });\n\n// Summarize content\nconst summary = await summarize({ \n content: doc, \n length: \"short\",\n format: \"bullets\" \n});\n\n// Explain code\nconst explanation = await explain({ \n content: code, \n level: \"beginner\" \n});\n\n// Code review\nconst feedback = await review({ \n code, \n focus: [\"security\", \"performance\"] \n});\n\\`\\`\\`\n\nBuilt-in skills: commit, summarize, explain, review, test, translate, extract, title`,\n\n \"define-skill\": `Create custom skills:\n\\`\\`\\`typescript\nimport { defineSkill } from \"gerbil/skills\";\nimport { z } from \"zod\";\n\nexport const sentiment = defineSkill({\n name: \"sentiment\",\n description: \"Analyze text sentiment\",\n input: z.object({ \n text: z.string(),\n detailed: z.boolean().default(false)\n }),\n output: z.object({\n sentiment: z.enum([\"positive\", \"negative\", \"neutral\"]),\n confidence: z.number(),\n }),\n temperature: 0.3,\n maxTokens: 100,\n \n async run({ input, gerbil }) {\n return gerbil.json(\\`Sentiment of: \\${input.text}\\`, {\n schema: this.output,\n });\n },\n});\n\\`\\`\\``,\n\n \"load-skills\": `Load skills from files:\n\\`\\`\\`typescript\nimport { loadSkills, useSkill, listSkills } from \"gerbil/skills\";\n\n// Load from directory (*.skill.ts files)\nawait loadSkills(\"./skills\");\n\n// Use by name\nconst skill = useSkill(\"my-skill\");\nconst result = await skill({ text: \"Hello\" });\n\n// List all\nconsole.log(listSkills()); // [\"commit\", \"summarize\", ...]\n\\`\\`\\``,\n\n // CLI\n cli: `CLI commands:\n\\`\\`\\`bash\ngerbil \"Write a haiku\" # Generate text\ngerbil -m qwen3.5-0.8b \"prompt\" # Specify model\ngerbil --thinking \"127 × 43\" # Enable reasoning\n\ngerbil commit # Git commit message\ngerbil summarize README.md # Summarize file\ngerbil explain src/index.ts # Explain code\n\ngerbil chat # Interactive chat\ngerbil chat --thinking # With reasoning\n\ngerbil serve # HTTP server\ngerbil serve --mcp # MCP server\n\ngerbil models # List models\ngerbil cache # Show cached models\ngerbil bench # Benchmark\ngerbil info # System info\n\ngerbil repl # Interactive TUI\n\\`\\`\\``,\n\n // Tools/Agents\n tools: `Gerbil supports tool calling with Qwen3 models:\n\\`\\`\\`typescript\nimport { defineTool, executeToolCall } from \"gerbil\";\n\nconst weatherTool = defineTool({\n name: \"get_weather\",\n description: \"Get current weather for a city\",\n parameters: z.object({\n city: z.string(),\n }),\n execute: async ({ city }) => {\n return \\`Weather in \\${city}: 72°F, sunny\\`;\n },\n});\n\\`\\`\\`\n\nIn the REPL, use Agent mode (Tab → Agent) to enable tools.`,\n};\n\n/**\n * Get all available documentation topics\n */\nexport function getDocTopics(): string[] {\n return Object.keys(GERBIL_DOCS);\n}\n\n/**\n * Search documentation by topic\n */\nexport function searchDocs(query: string): string | null {\n const words = query.toLowerCase().split(/\\s+/);\n const keyWords = words.filter((w) => w.length > 2);\n\n // Direct key match first\n for (const [key, content] of Object.entries(GERBIL_DOCS)) {\n const keyNorm = key.replace(/-/g, \"\");\n for (const word of keyWords) {\n if (keyNorm === word || key === word || keyNorm.includes(word)) {\n return content;\n }\n }\n }\n\n // Try each word as a potential topic\n for (const word of keyWords) {\n for (const [key, content] of Object.entries(GERBIL_DOCS)) {\n if (key.includes(word) || word.includes(key.replace(/-/g, \"\"))) {\n return content;\n }\n }\n }\n\n // Fallback: search content\n const matches: string[] = [];\n for (const [key, content] of Object.entries(GERBIL_DOCS)) {\n for (const word of keyWords) {\n if (content.toLowerCase().includes(word)) {\n matches.push(`## ${key}\\n${content}`);\n break;\n }\n }\n }\n\n if (matches.length > 0) {\n return matches.slice(0, 2).join(\"\\n\\n---\\n\\n\");\n }\n\n return null;\n}\n","/**\n * Tool Calling System for Gerbil\n *\n * Enables LLMs to call functions/tools during generation.\n * Compatible with Qwen3's tool calling format.\n */\n\nimport { z } from \"zod\";\nimport { getDocTopics, searchDocs } from \"./docs.js\";\nimport { zodToJsonSchema } from \"./utils.js\";\n\n// ============================================\n// Tool Context (for passing gerbil to tools)\n// ============================================\n\nexport type ToolContext = {\n /** Generate text using the loaded model */\n generate: (prompt: string) => Promise<string>;\n};\n\nlet toolContext: ToolContext | null = null;\n\n/**\n * Set the tool context (call this after loading a model)\n */\nexport function setToolContext(ctx: ToolContext): void {\n toolContext = ctx;\n}\n\n/**\n * Get the tool context for use in tools\n */\nexport function getToolContext(): ToolContext | null {\n return toolContext;\n}\n\n// ============================================\n// Tool Definition\n// ============================================\n\nexport type ToolDefinition<TParams = unknown> = {\n /** Tool name (function name) */\n name: string;\n\n /** Description for the LLM */\n description: string;\n\n /** Zod schema for parameters */\n parameters?: z.ZodType<TParams>;\n\n /** The function to execute (receives params and optional context) */\n execute: (params: TParams, ctx?: ToolContext | null) => Promise<string>;\n};\n\nexport type Tool<TParams = unknown> = {\n definition: ToolDefinition<TParams>;\n (params: TParams): Promise<string>;\n};\n\n// ============================================\n// Tool Registry\n// ============================================\n\nconst toolRegistry = new Map<string, Tool<any>>();\n\n/**\n * Define a tool\n */\nexport function defineTool<TParams>(def: ToolDefinition<TParams>): Tool<TParams> {\n const tool = async (params: TParams): Promise<string> => {\n // Validate params if schema provided\n if (def.parameters) {\n const parsed = def.parameters.parse(params);\n return def.execute(parsed, toolContext);\n }\n return def.execute(params, toolContext);\n };\n\n (tool as Tool<TParams>).definition = def;\n\n // Auto-register\n toolRegistry.set(def.name, tool as Tool<any>);\n\n return tool as Tool<TParams>;\n}\n\n/**\n * Get tool by name\n */\nexport function getTool(name: string): Tool<any> | undefined {\n return toolRegistry.get(name);\n}\n\n/**\n * List all tools\n */\nexport function listTools(): string[] {\n return Array.from(toolRegistry.keys());\n}\n\n/**\n * Get all tool definitions for prompt injection\n */\nexport function getToolDefinitions(): ToolDefinition<any>[] {\n return Array.from(toolRegistry.values()).map((t) => t.definition);\n}\n\nexport type LoadedToolResult = {\n name: string;\n loaded: boolean;\n error?: string;\n path: string;\n};\n\n/**\n * Simple tool config (no imports needed in tool files)\n */\nexport type SimpleToolConfig = {\n name: string;\n description: string;\n execute: (params: Record<string, any>) => Promise<string> | string;\n};\n\n/**\n * Load tools from a directory\n * Tools are simple .ts files with a default export config object\n * No module imports - we eval the execute function directly\n */\nexport async function loadTools(dir: string): Promise<LoadedToolResult[]> {\n const fs = await import(\"node:fs\");\n const pathModule = await import(\"node:path\");\n\n if (!fs.existsSync(dir)) {\n return [];\n }\n\n const files = fs.readdirSync(dir).filter((f) => f.endsWith(\".tool.ts\") || f.endsWith(\".tool.js\"));\n const results: LoadedToolResult[] = [];\n\n for (const file of files) {\n const filePath = pathModule.join(dir, file);\n const toolName = file.replace(/\\.tool\\.(ts|js)$/, \"\");\n\n try {\n // Read file content directly\n const content = fs.readFileSync(filePath, \"utf-8\");\n\n // Extract the config object using simple parsing\n const config = parseToolFile(content, toolName);\n\n if (config) {\n // Register the tool\n defineTool({\n name: config.name,\n description: config.description,\n execute: async (params, ctx) => {\n // Project tools may or may not accept ctx parameter\n const executeFn = config.execute as any;\n const result = await executeFn(params, ctx);\n return typeof result === \"string\" ? result : String(result);\n },\n });\n results.push({ name: config.name, loaded: true, path: filePath });\n } else {\n results.push({\n name: toolName,\n loaded: false,\n error: \"Could not parse tool config\",\n path: filePath,\n });\n }\n } catch (e) {\n const errorMsg = e instanceof Error ? e.message.split(\"\\n\")[0] : String(e);\n results.push({ name: toolName, loaded: false, error: errorMsg, path: filePath });\n }\n }\n\n return results;\n}\n\n/**\n * Parse a simple tool file and extract the config\n * Expected format:\n * ```\n * export default {\n * name: \"tool_name\",\n * description: \"...\",\n * execute: async (params) => { ... }\n * }\n * ```\n */\nfunction parseToolFile(content: string, fallbackName: string): SimpleToolConfig | null {\n try {\n // Remove TypeScript type annotations for eval\n let cleaned = content\n .replace(/:\\s*\\{[^}]+\\}/g, \"\") // Remove type objects like : { theme?: string }\n .replace(/:\\s*Record<[^>]+>/g, \"\") // Remove Record types\n .replace(/:\\s*string\\b/g, \"\")\n .replace(/:\\s*number\\b/g, \"\")\n .replace(/:\\s*boolean\\b/g, \"\")\n .replace(/:\\s*any\\b/g, \"\")\n .replace(/:\\s*Promise<[^>]+>/g, \"\")\n .replace(/export\\s+default\\s+/, \"return \");\n\n // Remove comments\n cleaned = cleaned.replace(/\\/\\/.*$/gm, \"\").replace(/\\/\\*[\\s\\S]*?\\*\\//g, \"\");\n\n // Wrap in function and evaluate\n const fn = new Function(cleaned);\n const config = fn();\n\n if (config && typeof config === \"object\" && config.name && config.execute) {\n return {\n name: config.name || fallbackName,\n description: config.description || \"No description\",\n execute: config.execute,\n };\n }\n return null;\n } catch (_e) {\n return null;\n }\n}\n\n/**\n * Load tools from project .gerbil/tools directory\n */\nexport async function loadProjectTools(): Promise<LoadedToolResult[]> {\n const pathModule = await import(\"node:path\");\n const toolsDir = pathModule.join(process.cwd(), \".gerbil\", \"tools\");\n return loadTools(toolsDir);\n}\n\n// Re-export for backwards compatibility\nexport { zodToJsonSchema } from \"./utils.js\";\n\n/**\n * Format tools for Qwen3 prompt\n */\nexport function formatToolsForPrompt(tools: ToolDefinition<any>[]): string {\n if (tools.length === 0) {\n return \"\";\n }\n\n const toolDefs = tools\n .map((t) => {\n const params = t.parameters\n ? zodToJsonSchema(t.parameters)\n : { type: \"object\", properties: {} };\n return `## ${t.name}\n\nDescription: ${t.description}\nParameters: ${JSON.stringify(params, null, 2)}`;\n })\n .join(\"\\n\\n\");\n\n return `You are a helpful assistant with access to tools.\n\n# Tools\n\n${toolDefs}\n\n## How to call tools\n\nTo call a tool, use this exact format:\n<tool_call>\n{\"name\": \"tool_name\", \"arguments\": {\"param\": \"value\"}}\n</tool_call>\n\nWhen the user asks about Gerbil (documentation, features, how to use), call gerbil_docs with a topic like: tools, skills, ai-sdk, next, express, generate, stream, models, cli.\n\nFor other questions, respond normally without calling tools.`;\n}\n\n/**\n * Parse tool call from response\n */\nexport function parseToolCall(response: string): { tool: string; params: any } | null {\n try {\n // Try <tool_call> format first (Qwen style)\n const toolCallMatch = response.match(/<tool_call>\\s*([\\s\\S]*?)\\s*<\\/tool_call>/);\n if (toolCallMatch) {\n const parsed = JSON.parse(toolCallMatch[1]);\n if (parsed.name) {\n return { tool: parsed.name, params: parsed.arguments || {} };\n }\n }\n\n // Fallback: look for {\"name\": \"...\", \"arguments\": ...} pattern\n const nameArgsMatch = response.match(\n /\\{\\s*\"name\"\\s*:\\s*\"([^\"]+)\"[^}]*\"arguments\"\\s*:\\s*(\\{[^}]*\\})/,\n );\n if (nameArgsMatch) {\n return { tool: nameArgsMatch[1], params: JSON.parse(nameArgsMatch[2]) };\n }\n\n // Fallback: {\"tool\": \"...\", \"params\": ...} pattern\n const toolParamsMatch = response.match(\n /\\{\\s*\"tool\"\\s*:\\s*\"([^\"]+)\"[^}]*\"params\"\\s*:\\s*(\\{[^}]*\\})/,\n );\n if (toolParamsMatch) {\n return { tool: toolParamsMatch[1], params: JSON.parse(toolParamsMatch[2]) };\n }\n\n // Simple fallback\n const simpleMatch = response.match(/\\{\\s*\"(?:tool|name)\"\\s*:\\s*\"([^\"]+)\"/);\n if (simpleMatch) {\n return { tool: simpleMatch[1], params: {} };\n }\n } catch {}\n return null;\n}\n\n/**\n * Execute a tool call\n */\nexport async function executeToolCall(toolName: string, params: any): Promise<string> {\n const tool = getTool(toolName);\n if (!tool) {\n return `Error: Unknown tool \"${toolName}\"`;\n }\n\n try {\n return await tool(params);\n } catch (e) {\n return `Error executing ${toolName}: ${e}`;\n }\n}\n\n// ============================================\n// Built-in Tools\n// ============================================\n\n/**\n * Docs tool - searches gerbil documentation\n * Documentation content is in core/docs.ts\n */\nexport const docsTool = defineTool({\n name: \"gerbil_docs\",\n description:\n \"Search Gerbil documentation for information about features, API, integrations, skills, and usage examples\",\n parameters: z.object({\n query: z\n .string()\n .optional()\n .default(\"quickstart\")\n .describe(\n \"Topic: quickstart, generate, stream, json, thinking, embed, models, ai-sdk, next, express, react, skills, define-skill, cli, tools\",\n ),\n }),\n execute: async ({ query = \"quickstart\" }) => {\n const result = searchDocs(query);\n if (result) {\n return result;\n }\n const topics = getDocTopics().join(\", \");\n return `No documentation found for \"${query}\". Available topics: ${topics}`;\n },\n});\n"],"mappings":"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"}
@@ -448,4 +448,4 @@ type ConcurrencyConfig = {
448
448
  };
449
449
  //#endregion
450
450
  export { SpeakResult as A, PreloadOptions as C, SessionStats as D, SearchResult as E, TelemetryConfig as F, TranscribeOptions as I, TranscribeResult as L, StreamingTranscriptionSession as M, SystemInfo as N, SimilarityResult as O, TTSModelConfig as P, TranscribeSegment as R, ModelStats as S, STTModelConfig as T, LoadSTTOptions as _, EmbedResult as a, ModelLoadEvent as b, GenerateEvent as c, GerbilConfig as d, GerbilModelSettings as f, LoadOptions as g, JsonOptions as h, EmbedOptions as i, StreamingTranscriptionOptions as j, SpeakOptions as k, GenerateOptions as l, ImageInput as m, CacheConfig as n, ErrorContext as o, GerbilProviderSettings as p, ConcurrencyConfig as r, FallbackConfig as s, AudioChunk as t, GenerateResult as u, LoadTTSOptions as v, ProgressInfo as w, ModelSource as x, ModelConfig as y, VoiceInfo as z };
451
- //# sourceMappingURL=types-LlyYILII.d.mts.map
451
+ //# sourceMappingURL=types-Bxwe_uS7.d.mts.map
@@ -1 +1 @@
1
- {"version":3,"file":"types-LlyYILII.d.mts","names":[],"sources":["../src/core/types.ts"],"sourcesContent":[],"mappings":";;;;AAyBY,KAfA,WAAA,GAeW;EASX,EAAA,EAAA,MAAA;EAWA,IAAA,EAAA,MAAA;EAmCA,WAAA,EAAA,MAAc;EA8Bd,IAAA,EAAA,MAAA;EAkBA,aAAA,EAAY,MAAA;EAQZ,gBAAW,EAAA,OAAA;EAWX,YAAA,EAAA,OAAY;EAWZ;EAkBA,cAAW,CAAA,EAAA,OAAA;EAqBX;EAOA,iBAAY,CAAA,EAAA,MAAA;EAYZ,MAAA,EAAA,MAAA,GAAY,QAAA,GAAA,KAAA,GAAA,SAAA,GAAA,OAAA,GAAA,OAAA;CAWd;AAGG,KA7MD,WAAA,GA6MC;EAGC,IAAA,EAAA,SAAA,GAAA,aAAA,GAAA,OAAA;EAGE,IAAA,EAAA,MAAA;CAAiB;AAGrB,KA7MA,UAAA,GA6MW;EAiBX;EAqBA,MAAA,EAAA,MAAA;EAUA;EAOA,GAAA,CAAA,EAAA,MAAA;AAyBZ,CAAA;AAWY,KA7RA,eAAA,GA6RsB;EAYtB;EAeA,SAAA,CAAA,EAAA,MAAc;EAmBd;EAWA,WAAA,CAAA,EAAU,MAAA;EAWV;EAaA,IAAA,CAAA,EAAA,MAAA;EAWA;EAiBA,IAAA,CAAA,EAAA,MAAA;EASA;EASA,aAAA,CAAA,EAAA,MAAgB,EAAA;EAahB;EAWA,MAAA,CAAA,EAAA,MAAA;EAeA;EAES,QAAA,CAAA,EAAA,OAAA;EAEN;EAID,OAAA,CAAA,EAAA,CAAA,KAAA,EAAA,MAAA,EAAA,IAgCM,CAhCN,EAAA;IAAO,UAAA,EAAA,MAAA;IAqBT,GAAA,EAAA,MAAA;IAKW,SAAA,EAAA,MAAA;EAMH,CAAA,EAAA,GAAA,IAAA;EAAgB;EAKZ,MAAA,CAAA,EAtdb,UAsda,EAAA;EAAc;EAQ1B,KAAA,CAAA,EAAA,OAAA;EAeA;EAEA,QAAA,CAAA,EAAA,MAAc;AAmB1B,CAAA;KAzfY,cAAA;;;;;;;;;;;;;;;;;;KA8BA;;UAEF,CAAA,CAAE,QAAQ;;;;;;;;KAgBR,YAAA;;;;;;KAQA,WAAA;;;;;;;;KAWA,YAAA;;;;;;;;KAWA,gBAAA;;;;;;;;;;KAkBA,WAAA;;sBAEU;;;;;;;;;;;;;;;KAmBV,cAAA;;sBAEU;;;;KAKV,YAAA;;;;;;;KAYA,YAAA;;;;;;;;UAWF;;aAGG;;cAGC;;gBAGE;;KAGJ,WAAA;;;;;;;;;;;;KAiBA,cAAA;;;;;;;;;;;;KAqBA,YAAA;;;;;;;;;KAUA,UAAA;;;;;;KAOA,UAAA;;SAEH;;;;;;;;;;;;;;;;;;KAuBG,mBAAA;;;;;;;;KAWA,sBAAA;;;;;;KAYA,SAAA;;;;;;;;;;;;;;KAeA,cAAA;;;;;;;;;;;;UAYF;;;;;;KAOE,YAAA;;;;;;sBAMU;;yBAEG;;KAGb,UAAA;;WAED;;;;;;;;KASC,WAAA;;SAEH;;;;;;;;;;KAWG,cAAA;;sBAEU;;;;KASV,cAAA;;;;;;;;;;;;;;;;KAiBA,iBAAA;;;;;;sBAMU;;KAGV,iBAAA;;;;;;;;KASA,gBAAA;;;;;;aAMC;;;;;;KAOD,cAAA;;sBAEU;;;;KASV,6BAAA;;;;;;;;;;;;;;KAeA,6BAAA;;qBAES;;eAEN;;;;cAID;;;;;;;;;;;;;;;;KAqBF,eAAA;;;;;uBAKW;;;;;oBAMH,gBAAgB;;;;wBAKZ;;;;;;KAQZ,aAAA;;;;UAIF;;;;;;;;;;KAWE,YAAA,GAAe;KAEf,cAAA;;;;;;;;;;;;;;KAmBA,iBAAA"}
1
+ {"version":3,"file":"types-Bxwe_uS7.d.mts","names":[],"sources":["../src/core/types.ts"],"sourcesContent":[],"mappings":";;;;AAyBY,KAfA,WAAA,GAeW;EASX,EAAA,EAAA,MAAA;EAWA,IAAA,EAAA,MAAA;EAmCA,WAAA,EAAA,MAAc;EA8Bd,IAAA,EAAA,MAAA;EAkBA,aAAA,EAAY,MAAA;EAQZ,gBAAW,EAAA,OAAA;EAWX,YAAA,EAAA,OAAY;EAWZ;EAkBA,cAAW,CAAA,EAAA,OAAA;EAqBX;EAOA,iBAAY,CAAA,EAAA,MAAA;EAYZ,MAAA,EAAA,MAAA,GAAY,QAAA,GAAA,KAAA,GAAA,SAAA,GAAA,OAAA,GAAA,OAAA;CAWd;AAGG,KA7MD,WAAA,GA6MC;EAGC,IAAA,EAAA,SAAA,GAAA,aAAA,GAAA,OAAA;EAGE,IAAA,EAAA,MAAA;CAAiB;AAGrB,KA7MA,UAAA,GA6MW;EAiBX;EAqBA,MAAA,EAAA,MAAA;EAUA;EAOA,GAAA,CAAA,EAAA,MAAA;AAyBZ,CAAA;AAWY,KA7RA,eAAA,GA6RsB;EAYtB;EAeA,SAAA,CAAA,EAAA,MAAc;EAmBd;EAWA,WAAA,CAAA,EAAU,MAAA;EAWV;EAaA,IAAA,CAAA,EAAA,MAAA;EAWA;EAiBA,IAAA,CAAA,EAAA,MAAA;EASA;EASA,aAAA,CAAA,EAAA,MAAgB,EAAA;EAahB;EAWA,MAAA,CAAA,EAAA,MAAA;EAeA;EAES,QAAA,CAAA,EAAA,OAAA;EAEN;EAID,OAAA,CAAA,EAAA,CAAA,KAAA,EAAA,MAAA,EAAA,IAgCM,CAhCN,EAAA;IAAO,UAAA,EAAA,MAAA;IAqBT,GAAA,EAAA,MAAA;IAKW,SAAA,EAAA,MAAA;EAMH,CAAA,EAAA,GAAA,IAAA;EAAgB;EAKZ,MAAA,CAAA,EAtdb,UAsda,EAAA;EAAc;EAQ1B,KAAA,CAAA,EAAA,OAAA;EAeA;EAEA,QAAA,CAAA,EAAA,MAAc;AAmB1B,CAAA;KAzfY,cAAA;;;;;;;;;;;;;;;;;;KA8BA;;UAEF,CAAA,CAAE,QAAQ;;;;;;;;KAgBR,YAAA;;;;;;KAQA,WAAA;;;;;;;;KAWA,YAAA;;;;;;;;KAWA,gBAAA;;;;;;;;;;KAkBA,WAAA;;sBAEU;;;;;;;;;;;;;;;KAmBV,cAAA;;sBAEU;;;;KAKV,YAAA;;;;;;;KAYA,YAAA;;;;;;;;UAWF;;aAGG;;cAGC;;gBAGE;;KAGJ,WAAA;;;;;;;;;;;;KAiBA,cAAA;;;;;;;;;;;;KAqBA,YAAA;;;;;;;;;KAUA,UAAA;;;;;;KAOA,UAAA;;SAEH;;;;;;;;;;;;;;;;;;KAuBG,mBAAA;;;;;;;;KAWA,sBAAA;;;;;;KAYA,SAAA;;;;;;;;;;;;;;KAeA,cAAA;;;;;;;;;;;;UAYF;;;;;;KAOE,YAAA;;;;;;sBAMU;;yBAEG;;KAGb,UAAA;;WAED;;;;;;;;KASC,WAAA;;SAEH;;;;;;;;;;KAWG,cAAA;;sBAEU;;;;KASV,cAAA;;;;;;;;;;;;;;;;KAiBA,iBAAA;;;;;;sBAMU;;KAGV,iBAAA;;;;;;;;KASA,gBAAA;;;;;;aAMC;;;;;;KAOD,cAAA;;sBAEU;;;;KASV,6BAAA;;;;;;;;;;;;;;KAeA,6BAAA;;qBAES;;eAEN;;;;cAID;;;;;;;;;;;;;;;;KAqBF,eAAA;;;;;uBAKW;;;;;oBAMH,gBAAgB;;;;wBAKZ;;;;;;KAQZ,aAAA;;;;UAIF;;;;;;;;;;KAWE,YAAA,GAAe;KAEf,cAAA;;;;;;;;;;;;;;KAmBA,iBAAA"}
@@ -162,4 +162,4 @@ type MemoryOptions = {
162
162
  };
163
163
  //#endregion
164
164
  export { MemoryMetadata as a, MemorySearchResult as c, RecallOptions as d, RecallResult as f, StoreSearchOptions as g, SerializedRecord as h, MemoryExport as i, MemoryStore as l, SearchOptions as m, ChunkOptions as n, MemoryOptions as o, Redactor as p, Embedder as r, MemoryRecord as s, AddOptions as t, MetadataFilter as u };
165
- //# sourceMappingURL=types-DQBe2lFo.d.mts.map
165
+ //# sourceMappingURL=types-D7kn-0i2.d.mts.map
@@ -1 +1 @@
1
- {"version":3,"file":"types-DQBe2lFo.d.mts","names":[],"sources":["../src/memory/types.ts"],"sourcesContent":[],"mappings":";;AAUA;AAQA;AAmBA;AAQA;AAGA;AAQA;AAGA;AAgBA;AAEc,KAnEF,cAAA,GAAiB,MAmEf,CAAA,MAAA,EAAA,OAAA,CAAA;;;;;;;AAMgC,KAjElC,YAAA,GAiEkC;EAA6B;EAAR,EAAA,EAAA,MAAA;EAE7C;EAEN,IAAA,EAAA,MAAA;EAAyB;EAAR,SAAA,CAAA,EA/DnB,YA+DmB;EAEtB;EAED,QAAA,EAjEE,cAiEF;EAAO;EAIL,SAAA,EAAA,MAAY;AAQxB,CAAA;AASA;AAQA;AAaA;AAUA;AAcA;AAUA;AAES,KApIG,QAAA,GAoIH,CAAA,KAAA,EAAA,MAAA,EAAA,EAAA,GApImC,OAoInC,CApI2C,YAoI3C,EAAA,CAAA;;;;;;;KA5HG,QAAA,GAAW;;KAGX,kBAAA;;UAEF;;;;;KAME,cAAA,GAAiB;;KAGjB,kBAAA;;;;WAID;;;;;;;;;;;KAYC,WAAA;;cAEE,eAAe;;mBAEV,iBAAiB;;mBAEjB,QAAQ;;sBAEL,wBAAwB,qBAAqB,QAAQ;;sBAErD;;gBAEN,iBAAiB,QAAQ;;WAE9B;;UAED;;;KAIE,YAAA;;;;WAID;;;KAIC,gBAAA;;;;YAIA;;;;KAKA,YAAA;;;;;;;KAQA,UAAA;;aAEC;;;;;;;oBAOO;;;KAIR,aAAA;;;;WAID;;;;;KAMC,aAAA;;;;;;WAMD;;;;;;;KAQC,YAAA;;;;WAID;;;;;KAMC,aAAA;;SAEH;;UAEC;;WAEC;;UAED"}
1
+ {"version":3,"file":"types-D7kn-0i2.d.mts","names":[],"sources":["../src/memory/types.ts"],"sourcesContent":[],"mappings":";;AAUA;AAQA;AAmBA;AAQA;AAGA;AAQA;AAGA;AAgBA;AAEc,KAnEF,cAAA,GAAiB,MAmEf,CAAA,MAAA,EAAA,OAAA,CAAA;;;;;;;AAMgC,KAjElC,YAAA,GAiEkC;EAA6B;EAAR,EAAA,EAAA,MAAA;EAE7C;EAEN,IAAA,EAAA,MAAA;EAAyB;EAAR,SAAA,CAAA,EA/DnB,YA+DmB;EAEtB;EAED,QAAA,EAjEE,cAiEF;EAAO;EAIL,SAAA,EAAA,MAAY;AAQxB,CAAA;AASA;AAQA;AAaA;AAUA;AAcA;AAUA;AAES,KApIG,QAAA,GAoIH,CAAA,KAAA,EAAA,MAAA,EAAA,EAAA,GApImC,OAoInC,CApI2C,YAoI3C,EAAA,CAAA;;;;;;;KA5HG,QAAA,GAAW;;KAGX,kBAAA;;UAEF;;;;;KAME,cAAA,GAAiB;;KAGjB,kBAAA;;;;WAID;;;;;;;;;;;KAYC,WAAA;;cAEE,eAAe;;mBAEV,iBAAiB;;mBAEjB,QAAQ;;sBAEL,wBAAwB,qBAAqB,QAAQ;;sBAErD;;gBAEN,iBAAiB,QAAQ;;WAE9B;;UAED;;;KAIE,YAAA;;;;WAID;;;KAIC,gBAAA;;;;YAIA;;;;KAKA,YAAA;;;;;;;KAQA,UAAA;;aAEC;;;;;;;oBAOO;;;KAIR,aAAA;;;;WAID;;;;;KAMC,aAAA;;;;;;WAMD;;;;;;;KAQC,YAAA;;;;WAID;;;;;KAMC,aAAA;;SAEH;;UAEC;;WAEC;;UAED"}
@@ -92,4 +92,4 @@ function topK(query, candidates, k, minScore) {
92
92
 
93
93
  //#endregion
94
94
  export { deserializeRecord as a, topK as i, dot as n, matchesFilter as o, normalize as r, serializeRecord as s, cosine as t };
95
- //# sourceMappingURL=vector-B0panuy6.mjs.map
95
+ //# sourceMappingURL=vector-C1U9vVVS.mjs.map
@@ -1 +1 @@
1
- {"version":3,"file":"vector-B0panuy6.mjs","names":["scored: Scored<T>[]"],"sources":["../src/memory/serialize.ts","../src/memory/vector.ts"],"sourcesContent":["/**\n * (De)serialization helpers shared by stores and import/export.\n *\n * Embeddings are stored at runtime as {@link Float32Array} but serialized as\n * plain number arrays so records survive `JSON.stringify` and IndexedDB\n * structured clone round-trips.\n */\n\nimport type { MemoryRecord, SerializedRecord } from \"./types.js\";\n\n/** Convert a runtime record to its JSON-safe form. */\nexport function serializeRecord(record: MemoryRecord): SerializedRecord {\n return {\n id: record.id,\n text: record.text,\n embedding: record.embedding ? Array.from(record.embedding) : undefined,\n metadata: record.metadata,\n createdAt: record.createdAt,\n };\n}\n\n/** Rebuild a runtime record (with a {@link Float32Array}) from JSON form. */\nexport function deserializeRecord(record: SerializedRecord): MemoryRecord {\n return {\n id: record.id,\n text: record.text,\n embedding: record.embedding ? Float32Array.from(record.embedding) : undefined,\n metadata: record.metadata ?? {},\n createdAt: record.createdAt,\n };\n}\n\n/**\n * True when every key in `filter` is present on `metadata` with an equal\n * (strict ===) value. An empty/undefined filter matches everything.\n */\nexport function matchesFilter(\n metadata: Record<string, unknown>,\n filter?: Record<string, unknown>,\n): boolean {\n if (!filter) {\n return true;\n }\n for (const key of Object.keys(filter)) {\n if (metadata[key] !== filter[key]) {\n return false;\n }\n }\n return true;\n}\n","/**\n * Vector math for cosine similarity search.\n *\n * Vectors are stored L2-normalized so cosine similarity is a plain dot\n * product. Normalization happens once on insert via {@link normalize}.\n */\n\n/**\n * Return an L2-normalized copy of `vector`.\n *\n * A zero vector is returned unchanged (its norm is 0).\n */\nexport function normalize(vector: Float32Array): Float32Array {\n let sumSquares = 0;\n for (let i = 0; i < vector.length; i++) {\n sumSquares += vector[i] * vector[i];\n }\n const norm = Math.sqrt(sumSquares);\n if (norm === 0) {\n return vector;\n }\n const out = new Float32Array(vector.length);\n for (let i = 0; i < vector.length; i++) {\n out[i] = vector[i] / norm;\n }\n return out;\n}\n\n/**\n * Dot product of two equal-length vectors.\n *\n * For L2-normalized inputs this equals cosine similarity.\n */\nexport function dot(a: Float32Array, b: Float32Array): number {\n const length = Math.min(a.length, b.length);\n let sum = 0;\n for (let i = 0; i < length; i++) {\n sum += a[i] * b[i];\n }\n return sum;\n}\n\n/**\n * Cosine similarity of two vectors, normalizing on the fly.\n *\n * Prefer {@link dot} when both inputs are already normalized.\n */\nexport function cosine(a: Float32Array, b: Float32Array): number {\n return dot(normalize(a), normalize(b));\n}\n\n/** A scored item used by {@link topK}. */\nexport type Scored<T> = { item: T; score: number };\n\n/**\n * Score every candidate against `query` (dot product) and return the top `k`\n * by descending score, optionally filtering by a minimum score.\n *\n * Inputs are assumed normalized; this keeps the hot path branch-free.\n */\nexport function topK<T>(\n query: Float32Array,\n candidates: { item: T; vector: Float32Array }[],\n k: number,\n minScore?: number,\n): Scored<T>[] {\n const scored: Scored<T>[] = [];\n for (const candidate of candidates) {\n const score = dot(query, candidate.vector);\n if (minScore !== undefined && score < minScore) {\n continue;\n }\n scored.push({ item: candidate.item, score });\n }\n scored.sort((a, b) => b.score - a.score);\n return scored.slice(0, k);\n}\n"],"mappings":";;AAWA,SAAgB,gBAAgB,QAAwC;AACtE,QAAO;EACL,IAAI,OAAO;EACX,MAAM,OAAO;EACb,WAAW,OAAO,YAAY,MAAM,KAAK,OAAO,UAAU,GAAG;EAC7D,UAAU,OAAO;EACjB,WAAW,OAAO;EACnB;;;AAIH,SAAgB,kBAAkB,QAAwC;AACxE,QAAO;EACL,IAAI,OAAO;EACX,MAAM,OAAO;EACb,WAAW,OAAO,YAAY,aAAa,KAAK,OAAO,UAAU,GAAG;EACpE,UAAU,OAAO,YAAY,EAAE;EAC/B,WAAW,OAAO;EACnB;;;;;;AAOH,SAAgB,cACd,UACA,QACS;AACT,KAAI,CAAC,OACH,QAAO;AAET,MAAK,MAAM,OAAO,OAAO,KAAK,OAAO,CACnC,KAAI,SAAS,SAAS,OAAO,KAC3B,QAAO;AAGX,QAAO;;;;;;;;;;;;;;;;ACpCT,SAAgB,UAAU,QAAoC;CAC5D,IAAI,aAAa;AACjB,MAAK,IAAI,IAAI,GAAG,IAAI,OAAO,QAAQ,IACjC,eAAc,OAAO,KAAK,OAAO;CAEnC,MAAM,OAAO,KAAK,KAAK,WAAW;AAClC,KAAI,SAAS,EACX,QAAO;CAET,MAAM,MAAM,IAAI,aAAa,OAAO,OAAO;AAC3C,MAAK,IAAI,IAAI,GAAG,IAAI,OAAO,QAAQ,IACjC,KAAI,KAAK,OAAO,KAAK;AAEvB,QAAO;;;;;;;AAQT,SAAgB,IAAI,GAAiB,GAAyB;CAC5D,MAAM,SAAS,KAAK,IAAI,EAAE,QAAQ,EAAE,OAAO;CAC3C,IAAI,MAAM;AACV,MAAK,IAAI,IAAI,GAAG,IAAI,QAAQ,IAC1B,QAAO,EAAE,KAAK,EAAE;AAElB,QAAO;;;;;;;AAQT,SAAgB,OAAO,GAAiB,GAAyB;AAC/D,QAAO,IAAI,UAAU,EAAE,EAAE,UAAU,EAAE,CAAC;;;;;;;;AAYxC,SAAgB,KACd,OACA,YACA,GACA,UACa;CACb,MAAMA,SAAsB,EAAE;AAC9B,MAAK,MAAM,aAAa,YAAY;EAClC,MAAM,QAAQ,IAAI,OAAO,UAAU,OAAO;AAC1C,MAAI,aAAa,UAAa,QAAQ,SACpC;AAEF,SAAO,KAAK;GAAE,MAAM,UAAU;GAAM;GAAO,CAAC;;AAE9C,QAAO,MAAM,GAAG,MAAM,EAAE,QAAQ,EAAE,MAAM;AACxC,QAAO,OAAO,MAAM,GAAG,EAAE"}
1
+ {"version":3,"file":"vector-C1U9vVVS.mjs","names":["scored: Scored<T>[]"],"sources":["../src/memory/serialize.ts","../src/memory/vector.ts"],"sourcesContent":["/**\n * (De)serialization helpers shared by stores and import/export.\n *\n * Embeddings are stored at runtime as {@link Float32Array} but serialized as\n * plain number arrays so records survive `JSON.stringify` and IndexedDB\n * structured clone round-trips.\n */\n\nimport type { MemoryRecord, SerializedRecord } from \"./types.js\";\n\n/** Convert a runtime record to its JSON-safe form. */\nexport function serializeRecord(record: MemoryRecord): SerializedRecord {\n return {\n id: record.id,\n text: record.text,\n embedding: record.embedding ? Array.from(record.embedding) : undefined,\n metadata: record.metadata,\n createdAt: record.createdAt,\n };\n}\n\n/** Rebuild a runtime record (with a {@link Float32Array}) from JSON form. */\nexport function deserializeRecord(record: SerializedRecord): MemoryRecord {\n return {\n id: record.id,\n text: record.text,\n embedding: record.embedding ? Float32Array.from(record.embedding) : undefined,\n metadata: record.metadata ?? {},\n createdAt: record.createdAt,\n };\n}\n\n/**\n * True when every key in `filter` is present on `metadata` with an equal\n * (strict ===) value. An empty/undefined filter matches everything.\n */\nexport function matchesFilter(\n metadata: Record<string, unknown>,\n filter?: Record<string, unknown>,\n): boolean {\n if (!filter) {\n return true;\n }\n for (const key of Object.keys(filter)) {\n if (metadata[key] !== filter[key]) {\n return false;\n }\n }\n return true;\n}\n","/**\n * Vector math for cosine similarity search.\n *\n * Vectors are stored L2-normalized so cosine similarity is a plain dot\n * product. Normalization happens once on insert via {@link normalize}.\n */\n\n/**\n * Return an L2-normalized copy of `vector`.\n *\n * A zero vector is returned unchanged (its norm is 0).\n */\nexport function normalize(vector: Float32Array): Float32Array {\n let sumSquares = 0;\n for (let i = 0; i < vector.length; i++) {\n sumSquares += vector[i] * vector[i];\n }\n const norm = Math.sqrt(sumSquares);\n if (norm === 0) {\n return vector;\n }\n const out = new Float32Array(vector.length);\n for (let i = 0; i < vector.length; i++) {\n out[i] = vector[i] / norm;\n }\n return out;\n}\n\n/**\n * Dot product of two equal-length vectors.\n *\n * For L2-normalized inputs this equals cosine similarity.\n */\nexport function dot(a: Float32Array, b: Float32Array): number {\n const length = Math.min(a.length, b.length);\n let sum = 0;\n for (let i = 0; i < length; i++) {\n sum += a[i] * b[i];\n }\n return sum;\n}\n\n/**\n * Cosine similarity of two vectors, normalizing on the fly.\n *\n * Prefer {@link dot} when both inputs are already normalized.\n */\nexport function cosine(a: Float32Array, b: Float32Array): number {\n return dot(normalize(a), normalize(b));\n}\n\n/** A scored item used by {@link topK}. */\nexport type Scored<T> = { item: T; score: number };\n\n/**\n * Score every candidate against `query` (dot product) and return the top `k`\n * by descending score, optionally filtering by a minimum score.\n *\n * Inputs are assumed normalized; this keeps the hot path branch-free.\n */\nexport function topK<T>(\n query: Float32Array,\n candidates: { item: T; vector: Float32Array }[],\n k: number,\n minScore?: number,\n): Scored<T>[] {\n const scored: Scored<T>[] = [];\n for (const candidate of candidates) {\n const score = dot(query, candidate.vector);\n if (minScore !== undefined && score < minScore) {\n continue;\n }\n scored.push({ item: candidate.item, score });\n }\n scored.sort((a, b) => b.score - a.score);\n return scored.slice(0, k);\n}\n"],"mappings":";;AAWA,SAAgB,gBAAgB,QAAwC;AACtE,QAAO;EACL,IAAI,OAAO;EACX,MAAM,OAAO;EACb,WAAW,OAAO,YAAY,MAAM,KAAK,OAAO,UAAU,GAAG;EAC7D,UAAU,OAAO;EACjB,WAAW,OAAO;EACnB;;;AAIH,SAAgB,kBAAkB,QAAwC;AACxE,QAAO;EACL,IAAI,OAAO;EACX,MAAM,OAAO;EACb,WAAW,OAAO,YAAY,aAAa,KAAK,OAAO,UAAU,GAAG;EACpE,UAAU,OAAO,YAAY,EAAE;EAC/B,WAAW,OAAO;EACnB;;;;;;AAOH,SAAgB,cACd,UACA,QACS;AACT,KAAI,CAAC,OACH,QAAO;AAET,MAAK,MAAM,OAAO,OAAO,KAAK,OAAO,CACnC,KAAI,SAAS,SAAS,OAAO,KAC3B,QAAO;AAGX,QAAO;;;;;;;;;;;;;;;;ACpCT,SAAgB,UAAU,QAAoC;CAC5D,IAAI,aAAa;AACjB,MAAK,IAAI,IAAI,GAAG,IAAI,OAAO,QAAQ,IACjC,eAAc,OAAO,KAAK,OAAO;CAEnC,MAAM,OAAO,KAAK,KAAK,WAAW;AAClC,KAAI,SAAS,EACX,QAAO;CAET,MAAM,MAAM,IAAI,aAAa,OAAO,OAAO;AAC3C,MAAK,IAAI,IAAI,GAAG,IAAI,OAAO,QAAQ,IACjC,KAAI,KAAK,OAAO,KAAK;AAEvB,QAAO;;;;;;;AAQT,SAAgB,IAAI,GAAiB,GAAyB;CAC5D,MAAM,SAAS,KAAK,IAAI,EAAE,QAAQ,EAAE,OAAO;CAC3C,IAAI,MAAM;AACV,MAAK,IAAI,IAAI,GAAG,IAAI,QAAQ,IAC1B,QAAO,EAAE,KAAK,EAAE;AAElB,QAAO;;;;;;;AAQT,SAAgB,OAAO,GAAiB,GAAyB;AAC/D,QAAO,IAAI,UAAU,EAAE,EAAE,UAAU,EAAE,CAAC;;;;;;;;AAYxC,SAAgB,KACd,OACA,YACA,GACA,UACa;CACb,MAAMA,SAAsB,EAAE;AAC9B,MAAK,MAAM,aAAa,YAAY;EAClC,MAAM,QAAQ,IAAI,OAAO,UAAU,OAAO;AAC1C,MAAI,aAAa,UAAa,QAAQ,SACpC;AAEF,SAAO,KAAK;GAAE,MAAM,UAAU;GAAM;GAAO,CAAC;;AAE9C,QAAO,MAAM,GAAG,MAAM,EAAE,QAAQ,EAAE,MAAM;AACxC,QAAO,OAAO,MAAM,GAAG,EAAE"}
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@tryhamster/gerbil",
3
- "version": "1.0.4",
3
+ "version": "1.0.5",
4
4
  "description": "Local LLM inference for Node.js. GPU-accelerated. Zero config. Works standalone or with Vercel AI SDK.",
5
5
  "type": "module",
6
6
  "main": "dist/index.mjs",
@@ -1,24 +0,0 @@
1
- //#region src/gpu/defaults.ts
2
- /**
3
- * Default model per capability. Kept in its own tiny module (no heavy imports)
4
- * so the React hooks can resolve defaults without statically pulling in the GPU
5
- * engine — they import the engine dynamically to stay light.
6
- */
7
- const DEFAULT_MODELS = {
8
- text: "mlx-community/Qwen3.5-0.8B-4bit",
9
- vision: "mlx-community/Qwen3.5-0.8B-4bit",
10
- embedding: "mlx-community/embeddinggemma-300m-4bit",
11
- tts: "nineninesix/kani-tts-2-en",
12
- stt: "UsefulSensors/moonshine-base"
13
- };
14
- /** Resolve the model repo for a set of options, falling back to the defaults. */
15
- function resolveDefaultRepo(opts) {
16
- if (opts.repo) return opts.repo;
17
- if (opts.embedding) return DEFAULT_MODELS.embedding;
18
- if (opts.enableVision) return DEFAULT_MODELS.vision;
19
- return DEFAULT_MODELS.text;
20
- }
21
-
22
- //#endregion
23
- export { resolveDefaultRepo as n, DEFAULT_MODELS as t };
24
- //# sourceMappingURL=defaults-9komdrbY.mjs.map
@@ -1 +0,0 @@
1
- {"version":3,"file":"defaults-9komdrbY.mjs","names":[],"sources":["../src/gpu/defaults.ts"],"sourcesContent":["/**\n * Default model per capability. Kept in its own tiny module (no heavy imports)\n * so the React hooks can resolve defaults without statically pulling in the GPU\n * engine — they import the engine dynamically to stay light.\n */\nexport const DEFAULT_MODELS = {\n /** Text generation (also the vision-capable checkpoint). */\n text: \"mlx-community/Qwen3.5-0.8B-4bit\",\n /** Image understanding — same checkpoint, vision tower built on demand. */\n vision: \"mlx-community/Qwen3.5-0.8B-4bit\",\n /** Text embeddings. */\n embedding: \"mlx-community/embeddinggemma-300m-4bit\",\n /** Text-to-speech. */\n tts: \"nineninesix/kani-tts-2-en\",\n /** Speech-to-text. */\n stt: \"UsefulSensors/moonshine-base\",\n} as const;\n\n/** Resolve the model repo for a set of options, falling back to the defaults. */\nexport function resolveDefaultRepo(opts: {\n repo?: string;\n embedding?: boolean;\n enableVision?: boolean;\n}): string {\n if (opts.repo) return opts.repo;\n if (opts.embedding) return DEFAULT_MODELS.embedding;\n if (opts.enableVision) return DEFAULT_MODELS.vision;\n return DEFAULT_MODELS.text;\n}\n"],"mappings":";;;;;;AAKA,MAAa,iBAAiB;CAE5B,MAAM;CAEN,QAAQ;CAER,WAAW;CAEX,KAAK;CAEL,KAAK;CACN;;AAGD,SAAgB,mBAAmB,MAIxB;AACT,KAAI,KAAK,KAAM,QAAO,KAAK;AAC3B,KAAI,KAAK,UAAW,QAAO,eAAe;AAC1C,KAAI,KAAK,aAAc,QAAO,eAAe;AAC7C,QAAO,eAAe"}
@@ -1,4 +0,0 @@
1
- import { t as Gerbil } from "./gerbil-BPbJy0_f.mjs";
2
- import "./utils-DKO55ZmZ.mjs";
3
-
4
- export { Gerbil };