@tryhamster/gerbil 1.0.0-rc.0

package/dist/skills-D3CEpgDc.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"skills-D3CEpgDc.mjs","names":["ctx: SkillContext<TInput>","loaded: string[]"],"sources":["../src/skills/registry.ts","../src/skills/loader.ts","../src/skills/builtin/commit.ts","../src/skills/builtin/explain.ts","../src/skills/builtin/extract.ts","../src/skills/builtin/review.ts","../src/skills/builtin/summarize.ts","../src/skills/builtin/test.ts","../src/skills/builtin/title.ts","../src/skills/builtin/translate.ts"],"sourcesContent":["/**\n * Skill Registry\n *\n * Central registry for all skills (built-in and custom).\n */\n\nimport type { Gerbil } from \"../core/gerbil.js\";\nimport { getInstance } from \"../core/one-liner.js\";\nimport type { Skill, SkillContext, SkillDefinition, SkillInfo } from \"./types.js\";\n\n// ============================================\n// Registry Storage\n// ============================================\n\nconst registry = new Map<string, Skill>();\nconst skillSources = new Map<string, string>(); // name -> source file\n\n// Reserved names that cannot be used for custom skills (CLI commands/views)\n// Note: Built-in skills like \"commit\", \"summarize\" ARE allowed because they\n// have dedicated CLI commands, but new skills cannot use these view names\nconst RESERVED_NAMES = new Set([\n  // REPL views (would conflict with CLI shortcuts)\n  \"repl\",\n  \"chat\",\n  \"skills\",\n  \"tools\",\n  \"model\",\n  \"integrate\",\n  \"benchmark\",\n  \"info\",\n  \"serve\",\n  \"cache\",\n  // CLI commands\n  \"generate\",\n  \"models\",\n  \"bench\",\n  // Aliases\n  \"r\",\n  \"c\",\n  \"g\",\n  // Other reserved\n  \"help\",\n  \"version\",\n  \"gerbil\",\n]);\n\n// ============================================\n// Define Skill\n// ============================================\n\n/**\n * Define and register a skill\n *\n * @example\n * ```ts\n * const sentiment = defineSkill({\n *   name: \"sentiment\",\n *   description: \"Analyze sentiment of text\",\n *   input: z.object({ text: z.string() }),\n *   output: z.object({ sentiment: z.enum([\"positive\", \"negative\", \"neutral\"]) }),\n *   async run({ input, gerbil }) {\n *     return gerbil.json(`Analyze sentiment: ${input.text}`, { schema: this.output });\n *   }\n * });\n * ```\n */\nexport function defineSkill<TInput, TOutput>(\n  definition: SkillDefinition<TInput, TOutput>,\n): Skill<TInput, TOutput> {\n  // Validate name format\n  if (!/^[a-z][a-z0-9-]*$/.test(definition.name)) {\n    throw new Error(`Skill name must be kebab-case starting with a letter: ${definition.name}`);\n  }\n\n  // Check for reserved names (CLI commands)\n  if (RESERVED_NAMES.has(definition.name)) {\n    throw new Error(\n      `Skill name \"${definition.name}\" is reserved for CLI commands. Choose a different name.`,\n    );\n  }\n\n  // Create the skill function\n  const execute = async (input: TInput): Promise<TOutput> => skill.run(input);\n\n  // Create the skill object\n  const skill = Object.assign(execute, {\n    definition,\n\n    async run(input: TInput, gerbil?: Gerbil): Promise<TOutput> {\n      // Get or create Gerbil instance\n      const g = gerbil ?? (await getInstance(definition.model));\n\n      // Validate input if schema provided\n      let validatedInput = input;\n      if (definition.input) {\n        const parsed = definition.input.safeParse(input);\n        if (!parsed.success) {\n          throw new Error(`Invalid input for skill \"${definition.name}\": ${parsed.error.message}`);\n        }\n        validatedInput = parsed.data;\n      }\n\n      // Create context\n      const ctx: SkillContext<TInput> = {\n        input: validatedInput,\n        gerbil: g,\n        rawInput: input,\n        definition: definition as SkillDefinition<TInput, unknown>,\n      };\n\n      // Run the skill\n      const result = await definition.run.call(definition, ctx);\n\n      // Validate output if schema provided\n      if (definition.output && typeof result !== \"string\") {\n        const parsed = definition.output.safeParse(result);\n        if (!parsed.success) {\n          throw new Error(\n            `Invalid output from skill \"${definition.name}\": ${parsed.error.message}`,\n          );\n        }\n        return parsed.data;\n      }\n\n      return result as TOutput;\n    },\n  }) as Skill<TInput, TOutput>;\n\n  // Register the skill\n  registry.set(definition.name, skill as Skill);\n\n  return skill;\n}\n\n// ============================================\n// Use Skill\n// ============================================\n\n/**\n * Get a skill by name\n *\n * @example\n * ```ts\n * const sentiment = useSkill(\"sentiment\");\n * const result = await sentiment({ text: \"I love this!\" });\n * ```\n */\nexport function useSkill<TInput = unknown, TOutput = unknown>(\n  name: string,\n): Skill<TInput, TOutput> {\n  const skill = registry.get(name);\n  if (!skill) {\n    throw new Error(`Skill not found: \"${name}\". Available: ${listSkills().join(\", \") || \"none\"}`);\n  }\n  return skill as Skill<TInput, TOutput>;\n}\n\n// ============================================\n// Registry Operations\n// ============================================\n\n/**\n * List all registered skill names\n */\nexport function listSkills(): string[] {\n  return Array.from(registry.keys()).sort();\n}\n\n/**\n * Get skill metadata\n */\nexport function getSkillInfo(name: string): SkillInfo | undefined {\n  const skill = registry.get(name);\n  if (!skill) {\n    return;\n  }\n\n  return {\n    name: skill.definition.name,\n    description: skill.definition.description,\n    version: skill.definition.version,\n    author: skill.definition.author,\n    builtin: !skillSources.has(name),\n    source: skillSources.get(name),\n  };\n}\n\n/**\n * Check if a skill exists\n */\nexport function hasSkill(name: string): boolean {\n  return registry.has(name);\n}\n\n/**\n * Remove a skill from registry\n */\nexport function removeSkill(name: string): boolean {\n  skillSources.delete(name);\n  return registry.delete(name);\n}\n\n/**\n * Clear all skills from registry\n */\nexport function clearSkills(): void {\n  registry.clear();\n  skillSources.clear();\n}\n\n/**\n * Get all skill info\n */\nexport function getAllSkillInfo(): SkillInfo[] {\n  return listSkills().map((name) => getSkillInfo(name)!);\n}\n\n/**\n * Check if a name is reserved (cannot be used for custom skills)\n */\nexport function isReservedName(name: string): boolean {\n  return RESERVED_NAMES.has(name);\n}\n\n/**\n * Get list of reserved names\n */\nexport function getReservedNames(): string[] {\n  return Array.from(RESERVED_NAMES).sort();\n}\n\n// ============================================\n// Internal: Register with source\n// ============================================\n\n/**\n * Register a skill with its source file (used by loader)\n * @internal\n */\nexport function registerSkillWithSource(skill: Skill, source: string): void {\n  registry.set(skill.definition.name, skill);\n  skillSources.set(skill.definition.name, source);\n}\n","/**\n * Skill Loader\n *\n * Load skills from files, directories, and packages.\n */\n\nimport { pathToFileURL } from \"url\";\nimport { registerSkillWithSource } from \"./registry.js\";\nimport type { LoadSkillsOptions, Skill } from \"./types.js\";\n\n// ============================================\n// Auto-Load Project Skills\n// ============================================\n\n/**\n * Load skills from the project's .gerbil/skills/ directory\n *\n * This is the standard location for project-specific skills.\n * Creates the directory structure if it doesn't exist.\n *\n * @example\n * ```ts\n * // Load from .gerbil/skills/ in current working directory\n * const loaded = await loadProjectSkills();\n * console.log(`Loaded ${loaded.length} project skills`);\n * ```\n */\nexport async function loadProjectSkills(cwd: string = process.cwd()): Promise<string[]> {\n  const path = await import(\"path\");\n  const fs = await import(\"fs\");\n\n  const gerbilDir = path.join(cwd, \".gerbil\");\n  const skillsDir = path.join(gerbilDir, \"skills\");\n\n  // If .gerbil/skills doesn't exist, that's fine - just return empty\n  if (!fs.existsSync(skillsDir)) {\n    return [];\n  }\n\n  return loadSkills(skillsDir);\n}\n\n// ============================================\n// Load from Directory\n// ============================================\n\n/**\n * Load all skills from a directory\n *\n * @example\n * ```ts\n * // Load all *.skill.ts and *.skill.js files\n * const loaded = await loadSkills(\"./skills\");\n * console.log(`Loaded ${loaded.length} skills`);\n * ```\n */\nexport async function loadSkills(dir: string, options: LoadSkillsOptions = {}): Promise<string[]> {\n  const { patterns = [\"*.skill.ts\", \"*.skill.js\"] } = options;\n  const loaded: string[] = [];\n\n  try {\n    const fs = await import(\"fs\");\n    const path = await import(\"path\");\n\n    const resolvedDir = path.resolve(dir);\n\n    if (!fs.existsSync(resolvedDir)) {\n      throw new Error(`Skills directory not found: ${dir}`);\n    }\n\n    const files = fs.readdirSync(resolvedDir);\n\n    for (const file of files) {\n      const matches = patterns.some((pattern) => {\n        const regex = new RegExp(`^${pattern.replace(/\\*/g, \".*\").replace(/\\./g, \"\\\\.\")}$`);\n        return regex.test(file);\n      });\n\n      if (matches) {\n        const filePath = path.join(resolvedDir, file);\n        const skill = await loadSkill(filePath);\n        if (skill) {\n          loaded.push(skill.definition.name);\n        }\n      }\n    }\n  } catch (error) {\n    if ((error as NodeJS.ErrnoException).code === \"MODULE_NOT_FOUND\") {\n      throw new Error(`Skills directory not found: ${dir}`);\n    }\n    throw error;\n  }\n\n  return loaded;\n}\n\n// ============================================\n// Load Single Skill\n// ============================================\n\n/**\n * Load a single skill from a file\n *\n * @example\n * ```ts\n * const skill = await loadSkill(\"./skills/sentiment.skill.ts\");\n * if (skill) {\n *   const result = await skill({ text: \"Hello\" });\n * }\n * ```\n */\nexport async function loadSkill(filePath: string): Promise<Skill | null> {\n  try {\n    const path = await import(\"path\");\n    const resolvedPath = path.resolve(filePath);\n\n    // Use dynamic import with file URL for ESM compatibility\n    const fileUrl = pathToFileURL(resolvedPath).href;\n    const module = await import(fileUrl);\n\n    // Get the default export\n    const skill = module.default as Skill;\n\n    if (!skill?.definition) {\n      console.warn(`No valid skill found in ${filePath}`);\n      return null;\n    }\n\n    // Register with source tracking\n    registerSkillWithSource(skill, resolvedPath);\n\n    return skill;\n  } catch (error) {\n    console.error(`Failed to load skill from ${filePath}:`, error);\n    return null;\n  }\n}\n\n// ============================================\n// Load from Package\n// ============================================\n\n/**\n * Load skills from an npm package\n *\n * @example\n * ```ts\n * // Load skills from a package\n * const loaded = await loadSkillPackage(\"gerbil-skills-extra\");\n * ```\n */\nexport async function loadSkillPackage(packageName: string): Promise<string[]> {\n  try {\n    const module = await import(packageName);\n    const loaded: string[] = [];\n\n    // Look for exported skills\n    for (const [_key, value] of Object.entries(module)) {\n      if (isSkill(value)) {\n        const skill = value as Skill;\n        registerSkillWithSource(skill, `npm:${packageName}`);\n        loaded.push(skill.definition.name);\n      }\n    }\n\n    // Also check default export if it's an object of skills\n    if (module.default && typeof module.default === \"object\") {\n      for (const [_key, value] of Object.entries(module.default)) {\n        if (isSkill(value)) {\n          const skill = value as Skill;\n          registerSkillWithSource(skill, `npm:${packageName}`);\n          loaded.push(skill.definition.name);\n        }\n      }\n    }\n\n    return loaded;\n  } catch (error) {\n    throw new Error(`Failed to load skill package \"${packageName}\": ${error}`);\n  }\n}\n\n// ============================================\n// Helpers\n// ============================================\n\n/**\n * Check if a value is a Skill\n */\nfunction isSkill(value: unknown): value is Skill {\n  return (\n    typeof value === \"function\" &&\n    typeof (value as Skill).definition === \"object\" &&\n    typeof (value as Skill).definition.name === \"string\" &&\n    typeof (value as Skill).definition.run === \"function\"\n  );\n}\n","/**\n * Commit Skill\n *\n * Generate git commit messages from staged changes.\n */\n\nimport { z } from \"zod\";\nimport { defineSkill } from \"../registry.js\";\n\nconst CommitInput = z.object({\n  /** Git diff (auto-detected if not provided) */\n  diff: z.string().optional(),\n\n  /** Commit style */\n  type: z.enum([\"conventional\", \"simple\", \"detailed\"]).default(\"conventional\"),\n\n  /** Max length for commit message */\n  maxLength: z.number().default(72),\n});\n\nexport type CommitInput = z.infer<typeof CommitInput>;\n\nasync function getGitDiff(): Promise<string> {\n  try {\n    const { execSync } = await import(\"child_process\");\n    return execSync(\"git diff --staged\", { encoding: \"utf-8\" });\n  } catch {\n    return \"\";\n  }\n}\n\nfunction getSystemPrompt(type: CommitInput[\"type\"]): string {\n  switch (type) {\n    case \"conventional\":\n      return `Generate a git commit message following the Conventional Commits format.\nUse one of these types: feat, fix, docs, style, refactor, perf, test, chore.\nFormat: type(scope): description\nKeep it under 72 characters.\nNo period at the end.\nOnly output the commit message, nothing else.`;\n\n    case \"detailed\":\n      return `Generate a detailed git commit message with a subject line and body.\nSubject: under 72 chars, imperative mood\nBody: explain what and why\nOnly output the commit message, nothing else.`;\n\n    default:\n      return `Generate a concise git commit message.\nUse imperative mood (e.g., \"Add\", \"Fix\", \"Update\").\nKeep it under 72 characters.\nNo period at the end.\nOnly output the commit message, nothing else.`;\n  }\n}\n\nexport const commit = defineSkill({\n  name: \"commit\",\n  description: \"Generate a git commit message from staged changes\",\n  version: \"1.0.0\",\n  input: CommitInput,\n  temperature: 0.3,\n  maxTokens: 100,\n\n  async run({ input, gerbil }) {\n    const { diff, type = \"conventional\", maxLength = 72 } = input;\n\n    // Get diff from git if not provided\n    const actualDiff = diff || (await getGitDiff());\n\n    if (!actualDiff || actualDiff.trim().length === 0) {\n      throw new Error(\"No changes staged. Run `git add` first.\");\n    }\n\n    const result = await gerbil.generate(\n      `Generate a commit message for the following diff:\\n\\n${actualDiff}`,\n      {\n        system: getSystemPrompt(type),\n        maxTokens: this.maxTokens,\n        temperature: this.temperature,\n      },\n    );\n\n    // Clean and truncate\n    let message = result.text.trim();\n    message = message.replace(/<think>[\\s\\S]*?<\\/think>/g, \"\").trim(); // Remove think tags\n    message = message.replace(/<\\/?think>/g, \"\").trim(); // Remove unclosed tags\n    message = message.replace(/^[\"']|[\"']$/g, \"\"); // Remove quotes\n    message = message.split(\"\\n\")[0]; // First line only\n    if (message.length > maxLength) {\n      message = `${message.substring(0, maxLength - 3)}...`;\n    }\n\n    return message;\n  },\n});\n","/**\n * Explain Skill\n *\n * Explain code or concepts at various levels.\n */\n\nimport { z } from \"zod\";\nimport { defineSkill } from \"../registry.js\";\n\nconst ExplainInput = z.object({\n  /** Content to explain */\n  content: z.string(),\n\n  /** Explanation level */\n  level: z.enum([\"beginner\", \"intermediate\", \"expert\"]).default(\"intermediate\"),\n\n  /** Programming language (for code) */\n  language: z.string().optional(),\n});\n\nexport type ExplainInput = z.infer<typeof ExplainInput>;\n\nconst levelGuide = {\n  beginner: \"Explain like I'm new to programming. Use simple terms and analogies.\",\n  intermediate: \"Explain for someone with programming experience.\",\n  expert: \"Explain with technical depth, including implementation details.\",\n};\n\nexport const explain = defineSkill({\n  name: \"explain\",\n  description: \"Explain code or concepts at various levels\",\n  version: \"1.0.0\",\n  input: ExplainInput,\n  temperature: 0.5,\n  maxTokens: 500,\n\n  async run({ input, gerbil }) {\n    const { content, level = \"intermediate\", language } = input;\n\n    let systemPrompt = `You are a patient teacher.\n${levelGuide[level]}`;\n\n    if (language) {\n      systemPrompt += `\\nThis is ${language} code.`;\n    }\n\n    systemPrompt += \"\\nBe clear and concise.\";\n\n    const result = await gerbil.generate(`Explain this:\\n\\n${content}`, {\n      system: systemPrompt,\n      maxTokens: this.maxTokens,\n      temperature: this.temperature,\n    });\n\n    return result.text;\n  },\n});\n","/**\n * Extract Skill\n *\n * Extract structured data from content.\n */\n\nimport { z } from \"zod\";\nimport { defineSkill } from \"../registry.js\";\n\nconst ExtractInput = z.object({\n  /** Content to extract from */\n  content: z.string(),\n\n  /** Zod schema for extraction (passed at runtime) */\n  schema: z.any(),\n\n  /** Additional context */\n  context: z.string().optional(),\n});\n\nexport type ExtractInput = z.infer<typeof ExtractInput>;\n\nexport const extract = defineSkill({\n  name: \"extract\",\n  description: \"Extract structured data from content\",\n  version: \"1.0.0\",\n  input: ExtractInput,\n  temperature: 0.3,\n\n  async run({ input, gerbil }) {\n    const { content, schema, context } = input;\n\n    let prompt = \"Extract structured data from the following content.\";\n\n    if (context) {\n      prompt += `\\nContext: ${context}`;\n    }\n\n    prompt += `\\n\\nContent:\\n${content}`;\n\n    return gerbil.json(prompt, { schema });\n  },\n});\n","/**\n * Review Skill\n *\n * Code review with configurable focus areas.\n */\n\nimport { z } from \"zod\";\nimport { defineSkill } from \"../registry.js\";\n\nconst ReviewInput = z.object({\n  /** Code to review */\n  code: z.string(),\n\n  /** Focus areas */\n  focus: z.array(z.enum([\"security\", \"performance\", \"style\", \"bugs\", \"all\"])).default([\"all\"]),\n\n  /** Output format */\n  format: z.enum([\"inline\", \"summary\", \"detailed\"]).default(\"summary\"),\n});\n\nexport type ReviewInput = z.infer<typeof ReviewInput>;\n\nexport const review = defineSkill({\n  name: \"review\",\n  description: \"Code review with configurable focus areas\",\n  version: \"1.0.0\",\n  input: ReviewInput,\n  temperature: 0.3,\n  maxTokens: 600,\n\n  async run({ input, gerbil }) {\n    const { code, focus = [\"all\"], format = \"summary\" } = input;\n\n    let systemPrompt = `You are a senior code reviewer.\nReview the code for:`;\n\n    if (focus.includes(\"all\")) {\n      systemPrompt +=\n        \"\\n- Security vulnerabilities\\n- Performance issues\\n- Code style and readability\\n- Potential bugs\";\n    } else {\n      if (focus.includes(\"security\")) {\n        systemPrompt += \"\\n- Security vulnerabilities\";\n      }\n      if (focus.includes(\"performance\")) {\n        systemPrompt += \"\\n- Performance issues\";\n      }\n      if (focus.includes(\"style\")) {\n        systemPrompt += \"\\n- Code style and readability\";\n      }\n      if (focus.includes(\"bugs\")) {\n        systemPrompt += \"\\n- Potential bugs\";\n      }\n    }\n\n    if (format === \"summary\") {\n      systemPrompt += \"\\n\\nProvide a brief summary of issues found.\";\n    } else if (format === \"detailed\") {\n      systemPrompt += \"\\n\\nProvide detailed feedback with suggestions.\";\n    } else {\n      systemPrompt += \"\\n\\nProvide inline-style comments.\";\n    }\n\n    const result = await gerbil.generate(`Review this code:\\n\\n${code}`, {\n      system: systemPrompt,\n      maxTokens: this.maxTokens,\n      temperature: this.temperature,\n    });\n\n    return result.text;\n  },\n});\n","/**\n * Summarize Skill\n *\n * Summarize content in various lengths and formats.\n */\n\nimport { z } from \"zod\";\nimport { defineSkill } from \"../registry.js\";\n\nconst SummarizeInput = z.object({\n  /** Content to summarize */\n  content: z.string(),\n\n  /** Summary length */\n  length: z.enum([\"short\", \"medium\", \"long\"]).default(\"medium\"),\n\n  /** Output format */\n  format: z.enum([\"paragraph\", \"bullets\"]).default(\"paragraph\"),\n\n  /** Focus areas */\n  focus: z.array(z.string()).optional(),\n});\n\nexport type SummarizeInput = z.infer<typeof SummarizeInput>;\n\nconst lengthGuide = {\n  short: \"2-3 sentences\",\n  medium: \"1 paragraph (4-6 sentences)\",\n  long: \"2-3 paragraphs\",\n};\n\nconst maxTokensGuide = {\n  short: 100,\n  medium: 200,\n  long: 400,\n};\n\nexport const summarize = defineSkill({\n  name: \"summarize\",\n  description: \"Summarize content in various lengths and formats\",\n  version: \"1.0.0\",\n  input: SummarizeInput,\n  temperature: 0.3,\n\n  async run({ input, gerbil }) {\n    const { content, length = \"medium\", format = \"paragraph\", focus } = input;\n\n    let systemPrompt = `You are a summarization expert.\nSummarize the content in ${lengthGuide[length]}.`;\n\n    if (format === \"bullets\") {\n      systemPrompt += \"\\nUse bullet points.\";\n    }\n\n    if (focus && focus.length > 0) {\n      systemPrompt += `\\nFocus on: ${focus.join(\", \")}.`;\n    }\n\n    systemPrompt += \"\\nOnly output the summary, nothing else.\";\n\n    const result = await gerbil.generate(`Summarize this:\\n\\n${content}`, {\n      system: systemPrompt,\n      maxTokens: maxTokensGuide[length],\n      temperature: this.temperature,\n    });\n\n    return result.text;\n  },\n});\n","/**\n * Test Skill\n *\n * Generate tests for code.\n */\n\nimport { z } from \"zod\";\nimport { defineSkill } from \"../registry.js\";\n\nconst TestInput = z.object({\n  /** Code to test */\n  code: z.string(),\n\n  /** Test framework */\n  framework: z.enum([\"jest\", \"vitest\", \"mocha\", \"playwright\"]).default(\"vitest\"),\n\n  /** Test style */\n  style: z.enum([\"unit\", \"integration\", \"e2e\"]).default(\"unit\"),\n});\n\nexport type TestInput = z.infer<typeof TestInput>;\n\nexport const test = defineSkill({\n  name: \"test\",\n  description: \"Generate tests for code\",\n  version: \"1.0.0\",\n  input: TestInput,\n  temperature: 0.3,\n  maxTokens: 800,\n\n  async run({ input, gerbil }) {\n    const { code, framework, style } = input;\n\n    const systemPrompt = `You are a test engineer.\nGenerate ${style} tests using ${framework} for the provided code.\nInclude edge cases and error scenarios.\nOnly output the test code, no explanations.`;\n\n    const result = await gerbil.generate(`Generate tests for:\\n\\n${code}`, {\n      system: systemPrompt,\n      maxTokens: this.maxTokens,\n      temperature: this.temperature,\n    });\n\n    return result.text;\n  },\n});\n","/**\n * Title Skill\n *\n * Generate titles for content.\n */\n\nimport { z } from \"zod\";\nimport { defineSkill } from \"../registry.js\";\n\nconst TitleInput = z.object({\n  /** Content to generate title for */\n  content: z.string(),\n\n  /** Title style */\n  style: z.enum([\"professional\", \"clickbait\", \"seo\", \"simple\"]).default(\"professional\"),\n\n  /** Max length */\n  maxLength: z.number().default(60),\n});\n\nexport type TitleInput = z.infer<typeof TitleInput>;\n\nconst styleGuide = {\n  professional: \"Clear, informative, and professional\",\n  clickbait: \"Engaging and curiosity-inducing\",\n  seo: \"SEO-optimized with relevant keywords\",\n  simple: \"Simple and straightforward\",\n};\n\nexport const title = defineSkill({\n  name: \"title\",\n  description: \"Generate titles for content\",\n  version: \"1.0.0\",\n  input: TitleInput,\n  temperature: 0.7,\n  maxTokens: 30,\n\n  async run({ input, gerbil }) {\n    const { content, style = \"professional\", maxLength = 60 } = input;\n\n    const systemPrompt = `Generate a title for the content.\nStyle: ${styleGuide[style]}\nMax length: ${maxLength} characters\nOnly output the title, nothing else.`;\n\n    const result = await gerbil.generate(`Generate a title for:\\n\\n${content.substring(0, 1000)}`, {\n      system: systemPrompt,\n      maxTokens: this.maxTokens,\n      temperature: this.temperature,\n    });\n\n    let generatedTitle = result.text.trim();\n    generatedTitle = generatedTitle.replace(/^[\"']|[\"']$/g, \"\");\n\n    if (generatedTitle.length > maxLength) {\n      generatedTitle = `${generatedTitle.substring(0, maxLength - 3)}...`;\n    }\n\n    return generatedTitle;\n  },\n});\n","/**\n * Translate Skill\n *\n * Translate text between languages.\n */\n\nimport { z } from \"zod\";\nimport { defineSkill } from \"../registry.js\";\n\nconst TranslateInput = z.object({\n  /** Text to translate */\n  text: z.string(),\n\n  /** Source language (auto-detected if not provided) */\n  from: z.string().optional(),\n\n  /** Target language */\n  to: z.string(),\n\n  /** Preserve formatting */\n  preserveFormatting: z.boolean().default(true),\n});\n\nexport type TranslateInput = z.infer<typeof TranslateInput>;\n\nexport const translate = defineSkill({\n  name: \"translate\",\n  description: \"Translate text between languages\",\n  version: \"1.0.0\",\n  input: TranslateInput,\n  temperature: 0.3,\n\n  async run({ input, gerbil }) {\n    const { text, from, to, preserveFormatting } = input;\n\n    let systemPrompt = `You are a professional translator.\nTranslate the text to ${to}.`;\n\n    if (from) {\n      systemPrompt += `\\nThe source language is ${from}.`;\n    }\n\n    if (preserveFormatting) {\n      systemPrompt += \"\\nPreserve the original formatting (paragraphs, lists, etc.).\";\n    }\n\n    systemPrompt += \"\\nOnly output the translation, nothing else.\";\n\n    const result = await gerbil.generate(`Translate:\\n\\n${text}`, {\n      system: systemPrompt,\n      maxTokens: Math.ceil(text.length / 2),\n      temperature: this.temperature,\n    });\n\n    return result.text;\n  },\n});\n"],"mappings":";;;;;AAcA,MAAM,2BAAW,IAAI,KAAoB;AACzC,MAAM,+BAAe,IAAI,KAAqB;AAK9C,MAAM,iBAAiB,IAAI,IAAI;CAE7B;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CAEA;CACA;CACA;CAEA;CACA;CACA;CAEA;CACA;CACA;CACD,CAAC;;;;;;;;;;;;;;;;;AAsBF,SAAgB,YACd,YACwB;AAExB,KAAI,CAAC,oBAAoB,KAAK,WAAW,KAAK,CAC5C,OAAM,IAAI,MAAM,yDAAyD,WAAW,OAAO;AAI7F,KAAI,eAAe,IAAI,WAAW,KAAK,CACrC,OAAM,IAAI,MACR,eAAe,WAAW,KAAK,0DAChC;CAIH,MAAM,UAAU,OAAO,UAAoC,MAAM,IAAI,MAAM;CAG3E,MAAM,QAAQ,OAAO,OAAO,SAAS;EACnC;EAEA,MAAM,IAAI,OAAe,QAAmC;GAE1D,MAAM,IAAI,UAAW,MAAM,YAAY,WAAW,MAAM;GAGxD,IAAI,iBAAiB;AACrB,OAAI,WAAW,OAAO;IACpB,MAAM,SAAS,WAAW,MAAM,UAAU,MAAM;AAChD,QAAI,CAAC,OAAO,QACV,OAAM,IAAI,MAAM,4BAA4B,WAAW,KAAK,KAAK,OAAO,MAAM,UAAU;AAE1F,qBAAiB,OAAO;;GAI1B,MAAMA,MAA4B;IAChC,OAAO;IACP,QAAQ;IACR,UAAU;IACE;IACb;GAGD,MAAM,SAAS,MAAM,WAAW,IAAI,KAAK,YAAY,IAAI;AAGzD,OAAI,WAAW,UAAU,OAAO,WAAW,UAAU;IACnD,MAAM,SAAS,WAAW,OAAO,UAAU,OAAO;AAClD,QAAI,CAAC,OAAO,QACV,OAAM,IAAI,MACR,8BAA8B,WAAW,KAAK,KAAK,OAAO,MAAM,UACjE;AAEH,WAAO,OAAO;;AAGhB,UAAO;;EAEV,CAAC;AAGF,UAAS,IAAI,WAAW,MAAM,MAAe;AAE7C,QAAO;;;;;;;;;;;AAgBT,SAAgB,SACd,MACwB;CACxB,MAAM,QAAQ,SAAS,IAAI,KAAK;AAChC,KAAI,CAAC,MACH,OAAM,IAAI,MAAM,qBAAqB,KAAK,gBAAgB,YAAY,CAAC,KAAK,KAAK,IAAI,SAAS;AAEhG,QAAO;;;;;AAUT,SAAgB,aAAuB;AACrC,QAAO,MAAM,KAAK,SAAS,MAAM,CAAC,CAAC,MAAM;;;;;AAM3C,SAAgB,aAAa,MAAqC;CAChE,MAAM,QAAQ,SAAS,IAAI,KAAK;AAChC,KAAI,CAAC,MACH;AAGF,QAAO;EACL,MAAM,MAAM,WAAW;EACvB,aAAa,MAAM,WAAW;EAC9B,SAAS,MAAM,WAAW;EAC1B,QAAQ,MAAM,WAAW;EACzB,SAAS,CAAC,aAAa,IAAI,KAAK;EAChC,QAAQ,aAAa,IAAI,KAAK;EAC/B;;;;;AAMH,SAAgB,SAAS,MAAuB;AAC9C,QAAO,SAAS,IAAI,KAAK;;;;;AAM3B,SAAgB,YAAY,MAAuB;AACjD,cAAa,OAAO,KAAK;AACzB,QAAO,SAAS,OAAO,KAAK;;;;;AAM9B,SAAgB,cAAoB;AAClC,UAAS,OAAO;AAChB,cAAa,OAAO;;;;;AAMtB,SAAgB,kBAA+B;AAC7C,QAAO,YAAY,CAAC,KAAK,SAAS,aAAa,KAAK,CAAE;;;;;;AAyBxD,SAAgB,wBAAwB,OAAc,QAAsB;AAC1E,UAAS,IAAI,MAAM,WAAW,MAAM,MAAM;AAC1C,cAAa,IAAI,MAAM,WAAW,MAAM,OAAO;;;;;;;;;;;;;;;;;;;;;;;ACtNjD,eAAsB,kBAAkB,MAAc,QAAQ,KAAK,EAAqB;CACtF,MAAM,OAAO,MAAM,OAAO;CAC1B,MAAM,KAAK,MAAM,OAAO;CAExB,MAAM,YAAY,KAAK,KAAK,KAAK,UAAU;CAC3C,MAAM,YAAY,KAAK,KAAK,WAAW,SAAS;AAGhD,KAAI,CAAC,GAAG,WAAW,UAAU,CAC3B,QAAO,EAAE;AAGX,QAAO,WAAW,UAAU;;;;;;;;;;;;AAiB9B,eAAsB,WAAW,KAAa,UAA6B,EAAE,EAAqB;CAChG,MAAM,EAAE,WAAW,CAAC,cAAc,aAAa,KAAK;CACpD,MAAMC,SAAmB,EAAE;AAE3B,KAAI;EACF,MAAM,KAAK,MAAM,OAAO;EACxB,MAAM,OAAO,MAAM,OAAO;EAE1B,MAAM,cAAc,KAAK,QAAQ,IAAI;AAErC,MAAI,CAAC,GAAG,WAAW,YAAY,CAC7B,OAAM,IAAI,MAAM,+BAA+B,MAAM;EAGvD,MAAM,QAAQ,GAAG,YAAY,YAAY;AAEzC,OAAK,MAAM,QAAQ,MAMjB,KALgB,SAAS,MAAM,YAAY;AAEzC,2BADc,IAAI,OAAO,IAAI,QAAQ,QAAQ,OAAO,KAAK,CAAC,QAAQ,OAAO,MAAM,CAAC,GAAG,EACtE,KAAK,KAAK;IACvB,EAEW;GAEX,MAAM,QAAQ,MAAM,UADH,KAAK,KAAK,aAAa,KAAK,CACN;AACvC,OAAI,MACF,QAAO,KAAK,MAAM,WAAW,KAAK;;UAIjC,OAAO;AACd,MAAK,MAAgC,SAAS,mBAC5C,OAAM,IAAI,MAAM,+BAA+B,MAAM;AAEvD,QAAM;;AAGR,QAAO;;;;;;;;;;;;;AAkBT,eAAsB,UAAU,UAAyC;AACvE,KAAI;EAEF,MAAM,gBADO,MAAM,OAAO,SACA,QAAQ,SAAS;EAO3C,MAAM,SAHS,MAAM,OADL,cAAc,aAAa,CAAC,OAIvB;AAErB,MAAI,CAAC,OAAO,YAAY;AACtB,WAAQ,KAAK,2BAA2B,WAAW;AACnD,UAAO;;AAIT,0BAAwB,OAAO,aAAa;AAE5C,SAAO;UACA,OAAO;AACd,UAAQ,MAAM,6BAA6B,SAAS,IAAI,MAAM;AAC9D,SAAO;;;;;;;;;;;;AAiBX,eAAsB,iBAAiB,aAAwC;AAC7E,KAAI;EACF,MAAM,SAAS,MAAM,OAAO;EAC5B,MAAMA,SAAmB,EAAE;AAG3B,OAAK,MAAM,CAAC,MAAM,UAAU,OAAO,QAAQ,OAAO,CAChD,KAAI,QAAQ,MAAM,EAAE;GAClB,MAAM,QAAQ;AACd,2BAAwB,OAAO,OAAO,cAAc;AACpD,UAAO,KAAK,MAAM,WAAW,KAAK;;AAKtC,MAAI,OAAO,WAAW,OAAO,OAAO,YAAY,UAC9C;QAAK,MAAM,CAAC,MAAM,UAAU,OAAO,QAAQ,OAAO,QAAQ,CACxD,KAAI,QAAQ,MAAM,EAAE;IAClB,MAAM,QAAQ;AACd,4BAAwB,OAAO,OAAO,cAAc;AACpD,WAAO,KAAK,MAAM,WAAW,KAAK;;;AAKxC,SAAO;UACA,OAAO;AACd,QAAM,IAAI,MAAM,iCAAiC,YAAY,KAAK,QAAQ;;;;;;AAW9E,SAAS,QAAQ,OAAgC;AAC/C,QACE,OAAO,UAAU,cACjB,OAAQ,MAAgB,eAAe,YACvC,OAAQ,MAAgB,WAAW,SAAS,YAC5C,OAAQ,MAAgB,WAAW,QAAQ;;;;;;;;;;ACzL/C,MAAM,cAAc,EAAE,OAAO;CAE3B,MAAM,EAAE,QAAQ,CAAC,UAAU;CAG3B,MAAM,EAAE,KAAK;EAAC;EAAgB;EAAU;EAAW,CAAC,CAAC,QAAQ,eAAe;CAG5E,WAAW,EAAE,QAAQ,CAAC,QAAQ,GAAG;CAClC,CAAC;AAIF,eAAe,aAA8B;AAC3C,KAAI;EACF,MAAM,EAAE,aAAa,MAAM,OAAO;AAClC,SAAO,SAAS,qBAAqB,EAAE,UAAU,SAAS,CAAC;SACrD;AACN,SAAO;;;AAIX,SAAS,gBAAgB,MAAmC;AAC1D,SAAQ,MAAR;EACE,KAAK,eACH,QAAO;;;;;;EAOT,KAAK,WACH,QAAO;;;;EAKT,QACE,QAAO;;;;;;;AAQb,MAAa,SAAS,YAAY;CAChC,MAAM;CACN,aAAa;CACb,SAAS;CACT,OAAO;CACP,aAAa;CACb,WAAW;CAEX,MAAM,IAAI,EAAE,OAAO,UAAU;EAC3B,MAAM,EAAE,MAAM,OAAO,gBAAgB,YAAY,OAAO;EAGxD,MAAM,aAAa,QAAS,MAAM,YAAY;AAE9C,MAAI,CAAC,cAAc,WAAW,MAAM,CAAC,WAAW,EAC9C,OAAM,IAAI,MAAM,0CAA0C;EAa5D,IAAI,WAVW,MAAM,OAAO,SAC1B,wDAAwD,cACxD;GACE,QAAQ,gBAAgB,KAAK;GAC7B,WAAW,KAAK;GAChB,aAAa,KAAK;GACnB,CACF,EAGoB,KAAK,MAAM;AAChC,YAAU,QAAQ,QAAQ,6BAA6B,GAAG,CAAC,MAAM;AACjE,YAAU,QAAQ,QAAQ,eAAe,GAAG,CAAC,MAAM;AACnD,YAAU,QAAQ,QAAQ,gBAAgB,GAAG;AAC7C,YAAU,QAAQ,MAAM,KAAK,CAAC;AAC9B,MAAI,QAAQ,SAAS,UACnB,WAAU,GAAG,QAAQ,UAAU,GAAG,YAAY,EAAE,CAAC;AAGnD,SAAO;;CAEV,CAAC;;;;;;;;;ACtFF,MAAM,eAAe,EAAE,OAAO;CAE5B,SAAS,EAAE,QAAQ;CAGnB,OAAO,EAAE,KAAK;EAAC;EAAY;EAAgB;EAAS,CAAC,CAAC,QAAQ,eAAe;CAG7E,UAAU,EAAE,QAAQ,CAAC,UAAU;CAChC,CAAC;AAIF,MAAM,aAAa;CACjB,UAAU;CACV,cAAc;CACd,QAAQ;CACT;AAED,MAAa,UAAU,YAAY;CACjC,MAAM;CACN,aAAa;CACb,SAAS;CACT,OAAO;CACP,aAAa;CACb,WAAW;CAEX,MAAM,IAAI,EAAE,OAAO,UAAU;EAC3B,MAAM,EAAE,SAAS,QAAQ,gBAAgB,aAAa;EAEtD,IAAI,eAAe;EACrB,WAAW;AAET,MAAI,SACF,iBAAgB,aAAa,SAAS;AAGxC,kBAAgB;AAQhB,UANe,MAAM,OAAO,SAAS,oBAAoB,WAAW;GAClE,QAAQ;GACR,WAAW,KAAK;GAChB,aAAa,KAAK;GACnB,CAAC,EAEY;;CAEjB,CAAC;;;;;;;;;AC/CF,MAAM,eAAe,EAAE,OAAO;CAE5B,SAAS,EAAE,QAAQ;CAGnB,QAAQ,EAAE,KAAK;CAGf,SAAS,EAAE,QAAQ,CAAC,UAAU;CAC/B,CAAC;AAIF,MAAa,UAAU,YAAY;CACjC,MAAM;CACN,aAAa;CACb,SAAS;CACT,OAAO;CACP,aAAa;CAEb,MAAM,IAAI,EAAE,OAAO,UAAU;EAC3B,MAAM,EAAE,SAAS,QAAQ,YAAY;EAErC,IAAI,SAAS;AAEb,MAAI,QACF,WAAU,cAAc;AAG1B,YAAU,iBAAiB;AAE3B,SAAO,OAAO,KAAK,QAAQ,EAAE,QAAQ,CAAC;;CAEzC,CAAC;;;;;;;;;ACjCF,MAAM,cAAc,EAAE,OAAO;CAE3B,MAAM,EAAE,QAAQ;CAGhB,OAAO,EAAE,MAAM,EAAE,KAAK;EAAC;EAAY;EAAe;EAAS;EAAQ;EAAM,CAAC,CAAC,CAAC,QAAQ,CAAC,MAAM,CAAC;CAG5F,QAAQ,EAAE,KAAK;EAAC;EAAU;EAAW;EAAW,CAAC,CAAC,QAAQ,UAAU;CACrE,CAAC;AAIF,MAAa,SAAS,YAAY;CAChC,MAAM;CACN,aAAa;CACb,SAAS;CACT,OAAO;CACP,aAAa;CACb,WAAW;CAEX,MAAM,IAAI,EAAE,OAAO,UAAU;EAC3B,MAAM,EAAE,MAAM,QAAQ,CAAC,MAAM,EAAE,SAAS,cAAc;EAEtD,IAAI,eAAe;;AAGnB,MAAI,MAAM,SAAS,MAAM,CACvB,iBACE;OACG;AACL,OAAI,MAAM,SAAS,WAAW,CAC5B,iBAAgB;AAElB,OAAI,MAAM,SAAS,cAAc,CAC/B,iBAAgB;AAElB,OAAI,MAAM,SAAS,QAAQ,CACzB,iBAAgB;AAElB,OAAI,MAAM,SAAS,OAAO,CACxB,iBAAgB;;AAIpB,MAAI,WAAW,UACb,iBAAgB;WACP,WAAW,WACpB,iBAAgB;MAEhB,iBAAgB;AASlB,UANe,MAAM,OAAO,SAAS,wBAAwB,QAAQ;GACnE,QAAQ;GACR,WAAW,KAAK;GAChB,aAAa,KAAK;GACnB,CAAC,EAEY;;CAEjB,CAAC;;;;;;;;;AC7DF,MAAM,iBAAiB,EAAE,OAAO;CAE9B,SAAS,EAAE,QAAQ;CAGnB,QAAQ,EAAE,KAAK;EAAC;EAAS;EAAU;EAAO,CAAC,CAAC,QAAQ,SAAS;CAG7D,QAAQ,EAAE,KAAK,CAAC,aAAa,UAAU,CAAC,CAAC,QAAQ,YAAY;CAG7D,OAAO,EAAE,MAAM,EAAE,QAAQ,CAAC,CAAC,UAAU;CACtC,CAAC;AAIF,MAAM,cAAc;CAClB,OAAO;CACP,QAAQ;CACR,MAAM;CACP;AAED,MAAM,iBAAiB;CACrB,OAAO;CACP,QAAQ;CACR,MAAM;CACP;AAED,MAAa,YAAY,YAAY;CACnC,MAAM;CACN,aAAa;CACb,SAAS;CACT,OAAO;CACP,aAAa;CAEb,MAAM,IAAI,EAAE,OAAO,UAAU;EAC3B,MAAM,EAAE,SAAS,SAAS,UAAU,SAAS,aAAa,UAAU;EAEpE,IAAI,eAAe;2BACI,YAAY,QAAQ;AAE3C,MAAI,WAAW,UACb,iBAAgB;AAGlB,MAAI,SAAS,MAAM,SAAS,EAC1B,iBAAgB,eAAe,MAAM,KAAK,KAAK,CAAC;AAGlD,kBAAgB;AAQhB,UANe,MAAM,OAAO,SAAS,sBAAsB,WAAW;GACpE,QAAQ;GACR,WAAW,eAAe;GAC1B,aAAa,KAAK;GACnB,CAAC,EAEY;;CAEjB,CAAC;;;;;;;;;AC3DF,MAAM,YAAY,EAAE,OAAO;CAEzB,MAAM,EAAE,QAAQ;CAGhB,WAAW,EAAE,KAAK;EAAC;EAAQ;EAAU;EAAS;EAAa,CAAC,CAAC,QAAQ,SAAS;CAG9E,OAAO,EAAE,KAAK;EAAC;EAAQ;EAAe;EAAM,CAAC,CAAC,QAAQ,OAAO;CAC9D,CAAC;AAIF,MAAa,OAAO,YAAY;CAC9B,MAAM;CACN,aAAa;CACb,SAAS;CACT,OAAO;CACP,aAAa;CACb,WAAW;CAEX,MAAM,IAAI,EAAE,OAAO,UAAU;EAC3B,MAAM,EAAE,MAAM,WAAW,UAAU;EAEnC,MAAM,eAAe;WACd,MAAM,eAAe,UAAU;;;AAUtC,UANe,MAAM,OAAO,SAAS,0BAA0B,QAAQ;GACrE,QAAQ;GACR,WAAW,KAAK;GAChB,aAAa,KAAK;GACnB,CAAC,EAEY;;CAEjB,CAAC;;;;;;;;;ACrCF,MAAM,aAAa,EAAE,OAAO;CAE1B,SAAS,EAAE,QAAQ;CAGnB,OAAO,EAAE,KAAK;EAAC;EAAgB;EAAa;EAAO;EAAS,CAAC,CAAC,QAAQ,eAAe;CAGrF,WAAW,EAAE,QAAQ,CAAC,QAAQ,GAAG;CAClC,CAAC;AAIF,MAAM,aAAa;CACjB,cAAc;CACd,WAAW;CACX,KAAK;CACL,QAAQ;CACT;AAED,MAAa,QAAQ,YAAY;CAC/B,MAAM;CACN,aAAa;CACb,SAAS;CACT,OAAO;CACP,aAAa;CACb,WAAW;CAEX,MAAM,IAAI,EAAE,OAAO,UAAU;EAC3B,MAAM,EAAE,SAAS,QAAQ,gBAAgB,YAAY,OAAO;EAE5D,MAAM,eAAe;SAChB,WAAW,OAAO;cACb,UAAU;;EASpB,IAAI,kBANW,MAAM,OAAO,SAAS,4BAA4B,QAAQ,UAAU,GAAG,IAAK,IAAI;GAC7F,QAAQ;GACR,WAAW,KAAK;GAChB,aAAa,KAAK;GACnB,CAAC,EAE0B,KAAK,MAAM;AACvC,mBAAiB,eAAe,QAAQ,gBAAgB,GAAG;AAE3D,MAAI,eAAe,SAAS,UAC1B,kBAAiB,GAAG,eAAe,UAAU,GAAG,YAAY,EAAE,CAAC;AAGjE,SAAO;;CAEV,CAAC;;;;;;;;;ACnDF,MAAM,iBAAiB,EAAE,OAAO;CAE9B,MAAM,EAAE,QAAQ;CAGhB,MAAM,EAAE,QAAQ,CAAC,UAAU;CAG3B,IAAI,EAAE,QAAQ;CAGd,oBAAoB,EAAE,SAAS,CAAC,QAAQ,KAAK;CAC9C,CAAC;AAIF,MAAa,YAAY,YAAY;CACnC,MAAM;CACN,aAAa;CACb,SAAS;CACT,OAAO;CACP,aAAa;CAEb,MAAM,IAAI,EAAE,OAAO,UAAU;EAC3B,MAAM,EAAE,MAAM,MAAM,IAAI,uBAAuB;EAE/C,IAAI,eAAe;wBACC,GAAG;AAEvB,MAAI,KACF,iBAAgB,4BAA4B,KAAK;AAGnD,MAAI,mBACF,iBAAgB;AAGlB,kBAAgB;AAQhB,UANe,MAAM,OAAO,SAAS,iBAAiB,QAAQ;GAC5D,QAAQ;GACR,WAAW,KAAK,KAAK,KAAK,SAAS,EAAE;GACrC,aAAa,KAAK;GACnB,CAAC,EAEY;;CAEjB,CAAC"}

package/dist/tools-BsiEE6f2.mjs

@@ -0,0 +1,567 @@
+import { n as zodToJsonSchema } from "./utils-7vXqtq2Q.mjs";
+import { z } from "zod";
+
+//#region src/core/docs.ts
+/**
+* Gerbil Documentation Content
+*
+* Documentation strings used by the gerbil_docs tool
+* for answering questions about Gerbil features.
+*/
+const GERBIL_DOCS = {
+	quickstart: `Gerbil Quick Start:
+\`\`\`typescript
+import { Gerbil } from "gerbil";
+
+const g = new Gerbil();
+await g.loadModel("qwen3-0.6b");
+
+// Generate text
+const result = await g.generate("Write a haiku");
+console.log(result.text);
+
+// Stream responses
+for await (const chunk of g.stream("Tell me a story")) {
+  process.stdout.write(chunk);
+}
+\`\`\``,
+	generate: `Generate text with options:
+\`\`\`typescript
+const result = await gerbil.generate(prompt, {
+  maxTokens: 256,      // Max tokens to generate
+  temperature: 0.7,    // 0-2, higher = more creative
+  topP: 0.9,           // Nucleus sampling
+  topK: 50,            // Top-k sampling
+  thinking: false,     // Enable reasoning mode (Qwen3)
+  system: "You are...", // System prompt
+});
+
+// Result contains:
+result.text           // Generated text
+result.thinking       // Reasoning (if thinking=true)
+result.tokensGenerated
+result.tokensPerSecond
+result.totalTime
+\`\`\``,
+	stream: `Streaming responses:
+\`\`\`typescript
+for await (const chunk of gerbil.stream("Hello")) {
+  process.stdout.write(chunk);
+}
+
+// With options
+const stream = gerbil.stream("Explain React", {
+  maxTokens: 500,
+  onToken: (token) => console.log(token),
+});
+\`\`\``,
+	json: `Structured JSON output with Zod validation:
+\`\`\`typescript
+import { z } from "zod";
+
+const PersonSchema = z.object({
+  name: z.string(),
+  age: z.number(),
+  city: z.string(),
+});
+
+const data = await gerbil.json("Extract: John is 32 and lives in NYC", {
+  schema: PersonSchema,
+  retries: 3,          // Retry on validation failure
+  temperature: 0.3,    // Lower = more consistent
+});
+// { name: "John", age: 32, city: "NYC" }
+\`\`\``,
+	thinking: `Thinking mode (chain-of-thought reasoning) - Qwen3 models:
+\`\`\`typescript
+const result = await gerbil.generate("What is 127 × 43?", {
+  thinking: true,
+});
+
+console.log(result.thinking);
+// "Let me calculate step by step: 127 × 43 = 127 × 40 + 127 × 3..."
+
+console.log(result.text);
+// "5461"
+\`\`\`
+
+Enable in chat with /no_think or /think commands, or enable_thinking parameter.`,
+	embed: `Generate embeddings:
+\`\`\`typescript
+// Single text
+const { vector } = await gerbil.embed("Hello world");
+// vector: number[] (384 dimensions by default)
+
+// Batch
+const results = await gerbil.embedBatch(["Hello", "World"]);
+\`\`\``,
+	models: `Available models:
+
+| Model | Size | Best For |
+|-------|------|----------|
+| qwen3-0.6b | ~400MB | General use, reasoning (thinking mode) |
+| qwen2.5-0.5b | ~350MB | Fast and capable |
+| qwen2.5-coder-0.5b | ~400MB | Code generation |
+| smollm2-360m | ~250MB | Very fast, simple tasks |
+| smollm2-135m | ~100MB | Fastest, basic generation |
+| phi-3-mini | ~2.1GB | High quality, larger |
+
+Load any HuggingFace model:
+\`\`\`typescript
+await gerbil.loadModel("hf:org/model");
+await gerbil.loadModel("onnx-community/Qwen3-0.6B-ONNX");
+\`\`\``,
+	load: `Loading models:
+\`\`\`typescript
+await gerbil.loadModel("qwen3-0.6b", {
+  device: "auto",     // "auto" | "gpu" | "cpu"
+  dtype: "q4",        // "q4" | "q8" | "fp16" | "fp32"
+  onProgress: (p) => {
+    console.log(p.status, p.progress, p.file);
+  },
+});
+\`\`\``,
+	"ai-sdk": `Vercel AI SDK v5 integration:
+\`\`\`typescript
+import { generateText, streamText } from "ai";
+import { gerbil } from "gerbil/ai";
+
+// Generate
+const { text } = await generateText({
+  model: gerbil("qwen3-0.6b"),
+  prompt: "Write a commit message",
+});
+
+// Stream
+const stream = streamText({
+  model: gerbil("qwen3-0.6b"),
+  prompt: "Explain React hooks",
+});
+
+for await (const chunk of stream.textStream) {
+  process.stdout.write(chunk);
+}
+
+// With thinking mode
+const { text } = await generateText({
+  model: gerbil("qwen3-0.6b", { thinking: true }),
+  prompt: "What is 127 × 43?",
+});
+\`\`\``,
+	next: `Next.js App Router integration:
+\`\`\`typescript
+// app/api/chat/route.ts
+import { gerbil } from "gerbil/next";
+
+export const POST = gerbil.handler({ 
+  model: "qwen3-0.6b",
+  maxTokens: 500,
+});
+\`\`\``,
+	express: `Express.js integration:
+\`\`\`typescript
+import express from "express";
+import { gerbil } from "gerbil/express";
+
+const app = express();
+app.use("/ai", gerbil()());
+
+// Endpoints created:
+// POST /ai/generate - Generate text
+// POST /ai/stream   - Stream text
+// POST /ai/json     - Structured output
+// POST /ai/embed    - Embeddings
+\`\`\``,
+	react: `React hooks:
+\`\`\`typescript
+import { useGerbil, useChat } from "gerbil/react";
+
+function Chat() {
+  const { generate, isLoading } = useGerbil();
+  
+  const handleSubmit = async (prompt: string) => {
+    const result = await generate(prompt);
+    console.log(result.text);
+  };
+}
+\`\`\``,
+	hono: `Hono integration:
+\`\`\`typescript
+import { Hono } from "hono";
+import { gerbil } from "gerbil/hono";
+
+const app = new Hono();
+app.route("/ai", await gerbil()());
+\`\`\``,
+	langchain: `LangChain integration:
+\`\`\`typescript
+import { GerbilLLM, GerbilEmbeddings } from "gerbil/langchain";
+
+const llm = new GerbilLLM({ model: "qwen3-0.6b" });
+const embeddings = new GerbilEmbeddings();
+
+// Use with chains
+const chain = new LLMChain({ llm, prompt: template });
+\`\`\``,
+	mcp: `MCP Server for Claude Desktop & Cursor:
+\`\`\`bash
+gerbil serve --mcp
+\`\`\`
+
+Skills are automatically exposed as MCP tools:
+- gerbil_generate
+- gerbil_commit
+- gerbil_summarize
+- gerbil_explain
+- etc.`,
+	skills: `Skills are reusable AI tasks with Zod validation:
+\`\`\`typescript
+import { commit, summarize, explain, review } from "gerbil/skills";
+
+// Generate commit message
+const msg = await commit({ type: "conventional", maxLength: 72 });
+
+// Summarize content
+const summary = await summarize({ 
+  content: doc, 
+  length: "short",
+  format: "bullets" 
+});
+
+// Explain code
+const explanation = await explain({ 
+  content: code, 
+  level: "beginner" 
+});
+
+// Code review
+const feedback = await review({ 
+  code, 
+  focus: ["security", "performance"] 
+});
+\`\`\`
+
+Built-in skills: commit, summarize, explain, review, test, translate, extract, title`,
+	"define-skill": `Create custom skills:
+\`\`\`typescript
+import { defineSkill } from "gerbil/skills";
+import { z } from "zod";
+
+export const sentiment = defineSkill({
+  name: "sentiment",
+  description: "Analyze text sentiment",
+  input: z.object({ 
+    text: z.string(),
+    detailed: z.boolean().default(false)
+  }),
+  output: z.object({
+    sentiment: z.enum(["positive", "negative", "neutral"]),
+    confidence: z.number(),
+  }),
+  temperature: 0.3,
+  maxTokens: 100,
+  
+  async run({ input, gerbil }) {
+    return gerbil.json(\`Sentiment of: \${input.text}\`, {
+      schema: this.output,
+    });
+  },
+});
+\`\`\``,
+	"load-skills": `Load skills from files:
+\`\`\`typescript
+import { loadSkills, useSkill, listSkills } from "gerbil/skills";
+
+// Load from directory (*.skill.ts files)
+await loadSkills("./skills");
+
+// Use by name
+const skill = useSkill("my-skill");
+const result = await skill({ text: "Hello" });
+
+// List all
+console.log(listSkills()); // ["commit", "summarize", ...]
+\`\`\``,
+	cli: `CLI commands:
+\`\`\`bash
+gerbil "Write a haiku"              # Generate text
+gerbil -m qwen3-0.6b "prompt"       # Specify model
+gerbil --thinking "127 × 43"        # Enable reasoning
+
+gerbil commit                        # Git commit message
+gerbil summarize README.md           # Summarize file
+gerbil explain src/index.ts          # Explain code
+
+gerbil chat                          # Interactive chat
+gerbil chat --thinking               # With reasoning
+
+gerbil serve                         # HTTP server
+gerbil serve --mcp                   # MCP server
+
+gerbil models                        # List models
+gerbil cache                         # Show cached models
+gerbil bench                         # Benchmark
+gerbil info                          # System info
+
+gerbil repl                          # Interactive TUI
+\`\`\``,
+	tools: `Gerbil supports tool calling with Qwen3 models:
+\`\`\`typescript
+import { defineTool, executeToolCall } from "gerbil";
+
+const weatherTool = defineTool({
+  name: "get_weather",
+  description: "Get current weather for a city",
+  parameters: z.object({
+    city: z.string(),
+  }),
+  execute: async ({ city }) => {
+    return \`Weather in \${city}: 72°F, sunny\`;
+  },
+});
+\`\`\`
+
+In the REPL, use Agent mode (Tab → Agent) to enable tools.`
+};
+/**
+* Get all available documentation topics
+*/
+function getDocTopics() {
+	return Object.keys(GERBIL_DOCS);
+}
+/**
+* Search documentation by topic
+*/
+function searchDocs(query) {
+	const keyWords = query.toLowerCase().split(/\s+/).filter((w) => w.length > 2);
+	for (const [key, content] of Object.entries(GERBIL_DOCS)) {
+		const keyNorm = key.replace(/-/g, "");
+		for (const word of keyWords) if (keyNorm === word || key === word || keyNorm.includes(word)) return content;
+	}
+	for (const word of keyWords) for (const [key, content] of Object.entries(GERBIL_DOCS)) if (key.includes(word) || word.includes(key.replace(/-/g, ""))) return content;
+	const matches = [];
+	for (const [key, content] of Object.entries(GERBIL_DOCS)) for (const word of keyWords) if (content.toLowerCase().includes(word)) {
+		matches.push(`## ${key}\n${content}`);
+		break;
+	}
+	if (matches.length > 0) return matches.slice(0, 2).join("\n\n---\n\n");
+	return null;
+}
+
+//#endregion
+//#region src/core/tools.ts
+/**
+* Tool Calling System for Gerbil
+*
+* Enables LLMs to call functions/tools during generation.
+* Compatible with Qwen3's tool calling format.
+*/
+let toolContext = null;
+/**
+* Set the tool context (call this after loading a model)
+*/
+function setToolContext(ctx) {
+	toolContext = ctx;
+}
+const toolRegistry = /* @__PURE__ */ new Map();
+/**
+* Define a tool
+*/
+function defineTool(def) {
+	const tool = async (params) => {
+		if (def.parameters) {
+			const parsed = def.parameters.parse(params);
+			return def.execute(parsed, toolContext);
+		}
+		return def.execute(params, toolContext);
+	};
+	tool.definition = def;
+	toolRegistry.set(def.name, tool);
+	return tool;
+}
+/**
+* Get tool by name
+*/
+function getTool(name) {
+	return toolRegistry.get(name);
+}
+/**
+* Get all tool definitions for prompt injection
+*/
+function getToolDefinitions() {
+	return Array.from(toolRegistry.values()).map((t) => t.definition);
+}
+/**
+* Load tools from a directory
+* Tools are simple .ts files with a default export config object
+* No module imports - we eval the execute function directly
+*/
+async function loadTools(dir) {
+	const fs = await import("fs");
+	const pathModule = await import("path");
+	if (!fs.existsSync(dir)) return [];
+	const files = fs.readdirSync(dir).filter((f) => f.endsWith(".tool.ts") || f.endsWith(".tool.js"));
+	const results = [];
+	for (const file of files) {
+		const filePath = pathModule.join(dir, file);
+		const toolName = file.replace(/\.tool\.(ts|js)$/, "");
+		try {
+			const config = parseToolFile(fs.readFileSync(filePath, "utf-8"), toolName);
+			if (config) {
+				defineTool({
+					name: config.name,
+					description: config.description,
+					execute: async (params, ctx) => {
+						const executeFn = config.execute;
+						const result = await executeFn(params, ctx);
+						return typeof result === "string" ? result : String(result);
+					}
+				});
+				results.push({
+					name: config.name,
+					loaded: true,
+					path: filePath
+				});
+			} else results.push({
+				name: toolName,
+				loaded: false,
+				error: "Could not parse tool config",
+				path: filePath
+			});
+		} catch (e) {
+			const errorMsg = e instanceof Error ? e.message.split("\n")[0] : String(e);
+			results.push({
+				name: toolName,
+				loaded: false,
+				error: errorMsg,
+				path: filePath
+			});
+		}
+	}
+	return results;
+}
+/**
+* Parse a simple tool file and extract the config
+* Expected format:
+* ```
+* export default {
+*   name: "tool_name",
+*   description: "...",
+*   execute: async (params) => { ... }
+* }
+* ```
+*/
+function parseToolFile(content, fallbackName) {
+	try {
+		let cleaned = content.replace(/:\s*\{[^}]+\}/g, "").replace(/:\s*Record<[^>]+>/g, "").replace(/:\s*string\b/g, "").replace(/:\s*number\b/g, "").replace(/:\s*boolean\b/g, "").replace(/:\s*any\b/g, "").replace(/:\s*Promise<[^>]+>/g, "").replace(/export\s+default\s+/, "return ");
+		cleaned = cleaned.replace(/\/\/.*$/gm, "").replace(/\/\*[\s\S]*?\*\//g, "");
+		const config = new Function(cleaned)();
+		if (config && typeof config === "object" && config.name && config.execute) return {
+			name: config.name || fallbackName,
+			description: config.description || "No description",
+			execute: config.execute
+		};
+		return null;
+	} catch (e) {
+		console.error("Failed to parse tool file:", e);
+		return null;
+	}
+}
+/**
+* Load tools from project .gerbil/tools directory
+*/
+async function loadProjectTools() {
+	return loadTools((await import("path")).join(process.cwd(), ".gerbil", "tools"));
+}
+/**
+* Format tools for Qwen3 prompt
+*/
+function formatToolsForPrompt(tools) {
+	if (tools.length === 0) return "";
+	return `You are a helpful assistant with access to tools.
+
+# Tools
+
+${tools.map((t) => {
+		const params = t.parameters ? zodToJsonSchema(t.parameters) : {
+			type: "object",
+			properties: {}
+		};
+		return `## ${t.name}
+
+Description: ${t.description}
+Parameters: ${JSON.stringify(params, null, 2)}`;
+	}).join("\n\n")}
+
+## How to call tools
+
+To call a tool, use this exact format:
+<tool_call>
+{"name": "tool_name", "arguments": {"param": "value"}}
+</tool_call>
+
+When 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.
+
+For other questions, respond normally without calling tools.`;
+}
+/**
+* Parse tool call from response
+*/
+function parseToolCall(response) {
+	try {
+		const toolCallMatch = response.match(/<tool_call>\s*([\s\S]*?)\s*<\/tool_call>/);
+		if (toolCallMatch) {
+			const parsed = JSON.parse(toolCallMatch[1]);
+			if (parsed.name) return {
+				tool: parsed.name,
+				params: parsed.arguments || {}
+			};
+		}
+		const nameArgsMatch = response.match(/\{\s*"name"\s*:\s*"([^"]+)"[^}]*"arguments"\s*:\s*(\{[^}]*\})/);
+		if (nameArgsMatch) return {
+			tool: nameArgsMatch[1],
+			params: JSON.parse(nameArgsMatch[2])
+		};
+		const toolParamsMatch = response.match(/\{\s*"tool"\s*:\s*"([^"]+)"[^}]*"params"\s*:\s*(\{[^}]*\})/);
+		if (toolParamsMatch) return {
+			tool: toolParamsMatch[1],
+			params: JSON.parse(toolParamsMatch[2])
+		};
+		const simpleMatch = response.match(/\{\s*"(?:tool|name)"\s*:\s*"([^"]+)"/);
+		if (simpleMatch) return {
+			tool: simpleMatch[1],
+			params: {}
+		};
+	} catch {}
+	return null;
+}
+/**
+* Execute a tool call
+*/
+async function executeToolCall(toolName, params) {
+	const tool = getTool(toolName);
+	if (!tool) return `Error: Unknown tool "${toolName}"`;
+	try {
+		return await tool(params);
+	} catch (e) {
+		return `Error executing ${toolName}: ${e}`;
+	}
+}
+/**
+* Docs tool - searches gerbil documentation
+* Documentation content is in core/docs.ts
+*/
+const docsTool = defineTool({
+	name: "gerbil_docs",
+	description: "Search Gerbil documentation for information about features, API, integrations, skills, and usage examples",
+	parameters: z.object({ query: z.string().optional().default("quickstart").describe("Topic: quickstart, generate, stream, json, thinking, embed, models, ai-sdk, next, express, react, skills, define-skill, cli, tools") }),
+	execute: async ({ query = "quickstart" }) => {
+		const result = searchDocs(query);
+		if (result) return result;
+		return `No documentation found for "${query}". Available topics: ${getDocTopics().join(", ")}`;
+	}
+});
+
+//#endregion
+export { getToolDefinitions as a, setToolContext as c, getTool as i, executeToolCall as n, loadProjectTools as o, formatToolsForPrompt as r, parseToolCall as s, defineTool as t };
+//# sourceMappingURL=tools-BsiEE6f2.mjs.map