@jambonz/tools 0.1.2

package/dist/index.js

@@ -0,0 +1,450 @@
+// src/register.ts
+function registerTools(session, hookPath, tools, options) {
+  const toolMap = new Map(tools.map((t) => [t.schema.name, t]));
+  const log = options?.logger;
+  session.on(hookPath, async (evt) => {
+    const { tool_call_id, name, arguments: args } = evt;
+    const tool = toolMap.get(name);
+    if (!tool) {
+      log?.error({ name, args }, `unknown tool: ${name}`);
+      if (options?.onUnknownTool) {
+        options.onUnknownTool(session, evt);
+      } else {
+        session.sendToolOutput(tool_call_id, `Unknown tool: ${name}`);
+      }
+      return;
+    }
+    log?.info({ name, args }, "tool call");
+    try {
+      const result = await tool.execute(args);
+      session.sendToolOutput(tool_call_id, result);
+    } catch (err) {
+      log?.error({ err, name, args }, `tool execution failed: ${name}`);
+      session.sendToolOutput(tool_call_id, `Error executing ${name}: ${err}`);
+    }
+  });
+}
+
+// src/tools/tavily-search.ts
+var schema = {
+  name: "web_search",
+  description: "Search the web for current information on a given topic or question.",
+  parameters: {
+    type: "object",
+    properties: {
+      query: {
+        type: "string",
+        description: "The search query"
+      }
+    },
+    required: ["query"]
+  }
+};
+function createTavilySearch(options) {
+  const {
+    apiKey,
+    maxResults = 3,
+    searchDepth = "basic",
+    topic = "general",
+    includeDomains,
+    excludeDomains
+  } = options;
+  return {
+    schema,
+    async execute(args) {
+      const res = await fetch("https://api.tavily.com/search", {
+        method: "POST",
+        headers: { "Content-Type": "application/json" },
+        body: JSON.stringify({
+          api_key: apiKey,
+          query: args.query,
+          max_results: maxResults,
+          search_depth: searchDepth,
+          topic,
+          ...includeDomains && { include_domains: includeDomains },
+          ...excludeDomains && { exclude_domains: excludeDomains }
+        })
+      });
+      if (!res.ok) {
+        throw new Error(`Tavily API error: ${res.status} ${res.statusText}`);
+      }
+      const data = await res.json();
+      const results = (data.results || []).map((r) => `${r.title}: ${r.content}`).join("\n");
+      return results || "No results found.";
+    }
+  };
+}
+
+// src/tools/weather.ts
+var schema2 = {
+  name: "get_weather",
+  description: "Get the current temperature, wind speed, and conditions for a given location.",
+  parameters: {
+    type: "object",
+    properties: {
+      location: {
+        type: "string",
+        description: 'City name or location, e.g. "San Francisco" or "Paris, France"'
+      }
+    },
+    required: ["location"]
+  }
+};
+function createWeather(options) {
+  const scale = options?.scale ?? "celsius";
+  return {
+    schema: schema2,
+    async execute(args) {
+      const location = args.location;
+      const geoRes = await fetch(
+        `https://geocoding-api.open-meteo.com/v1/search?name=${encodeURIComponent(location)}&count=1&language=en&format=json`
+      );
+      if (!geoRes.ok) {
+        throw new Error(`Geocoding API error: ${geoRes.status}`);
+      }
+      const geoData = await geoRes.json();
+      if (!geoData.results?.length) {
+        return `Sorry, I could not find weather data for "${location}".`;
+      }
+      const { latitude, longitude, name, country } = geoData.results[0];
+      const wxRes = await fetch(
+        `https://api.open-meteo.com/v1/forecast?latitude=${latitude}&longitude=${longitude}&current=temperature_2m,relative_humidity_2m,apparent_temperature,weather_code,wind_speed_10m&temperature_unit=${scale}`
+      );
+      if (!wxRes.ok) {
+        throw new Error(`Weather API error: ${wxRes.status}`);
+      }
+      const wx = await wxRes.json();
+      const unit = scale === "fahrenheit" ? "\xB0F" : "\xB0C";
+      const { temperature_2m, apparent_temperature, relative_humidity_2m, weather_code, wind_speed_10m } = wx.current;
+      const condition = weatherCodeToText(weather_code);
+      return [
+        `Current weather in ${name}, ${country}:`,
+        `${condition}, ${temperature_2m}${unit} (feels like ${apparent_temperature}${unit}).`,
+        `Wind: ${wind_speed_10m} km/h. Humidity: ${relative_humidity_2m}%.`
+      ].join(" ");
+    }
+  };
+}
+function weatherCodeToText(code) {
+  const descriptions = {
+    0: "Clear sky",
+    1: "Mainly clear",
+    2: "Partly cloudy",
+    3: "Overcast",
+    45: "Foggy",
+    48: "Depositing rime fog",
+    51: "Light drizzle",
+    53: "Moderate drizzle",
+    55: "Dense drizzle",
+    61: "Slight rain",
+    63: "Moderate rain",
+    65: "Heavy rain",
+    71: "Slight snow",
+    73: "Moderate snow",
+    75: "Heavy snow",
+    77: "Snow grains",
+    80: "Slight rain showers",
+    81: "Moderate rain showers",
+    82: "Violent rain showers",
+    85: "Slight snow showers",
+    86: "Heavy snow showers",
+    95: "Thunderstorm",
+    96: "Thunderstorm with slight hail",
+    99: "Thunderstorm with heavy hail"
+  };
+  return descriptions[code] ?? "Unknown conditions";
+}
+
+// src/tools/wikipedia.ts
+var schema3 = {
+  name: "wikipedia",
+  description: "Look up a topic on Wikipedia to get a factual summary. Useful for answering questions about people, places, history, science, and general knowledge.",
+  parameters: {
+    type: "object",
+    properties: {
+      query: {
+        type: "string",
+        description: "The topic to look up on Wikipedia"
+      }
+    },
+    required: ["query"]
+  }
+};
+function createWikipedia(options) {
+  const maxSentences = options?.maxSentences ?? 5;
+  const lang = options?.language ?? "en";
+  return {
+    schema: schema3,
+    async execute(args) {
+      const query = args.query;
+      const searchRes = await fetch(
+        `https://${lang}.wikipedia.org/w/api.php?action=query&list=search&srsearch=${encodeURIComponent(query)}&srlimit=1&format=json&origin=*`
+      );
+      if (!searchRes.ok) {
+        throw new Error(`Wikipedia search error: ${searchRes.status}`);
+      }
+      const searchData = await searchRes.json();
+      if (!searchData.query.search.length) {
+        return `No Wikipedia article found for "${query}".`;
+      }
+      const { title } = searchData.query.search[0];
+      const summaryRes = await fetch(
+        `https://${lang}.wikipedia.org/api/rest_v1/page/summary/${encodeURIComponent(title)}`
+      );
+      if (!summaryRes.ok) {
+        throw new Error(`Wikipedia summary error: ${summaryRes.status}`);
+      }
+      const summary = await summaryRes.json();
+      const sentences = summary.extract.split(/(?<=\.)\s+/);
+      const trimmed = sentences.slice(0, maxSentences).join(" ");
+      return `${summary.title}: ${trimmed}`;
+    }
+  };
+}
+
+// src/tools/calculator.ts
+var schema4 = {
+  name: "calculator",
+  description: "Evaluate a mathematical expression and return the numeric result. Supports arithmetic (+, -, *, /, ^, %), parentheses, and functions (sqrt, abs, round, ceil, floor, sin, cos, tan, log, log10, exp). Also supports constants pi and e.",
+  parameters: {
+    type: "object",
+    properties: {
+      expression: {
+        type: "string",
+        description: 'The math expression to evaluate, e.g. "15% of 87.50" should be sent as "87.50 * 0.15"'
+      }
+    },
+    required: ["expression"]
+  }
+};
+function createCalculator() {
+  return {
+    schema: schema4,
+    async execute(args) {
+      const expression = args.expression.trim();
+      try {
+        const result = evaluate(expression);
+        const formatted = Number.isInteger(result) ? result.toString() : parseFloat(result.toFixed(10)).toString();
+        return `${expression} = ${formatted}`;
+      } catch (err) {
+        return `Could not evaluate "${expression}": ${err.message}`;
+      }
+    }
+  };
+}
+var FUNCTIONS = {
+  sqrt: Math.sqrt,
+  abs: Math.abs,
+  round: Math.round,
+  ceil: Math.ceil,
+  floor: Math.floor,
+  sin: Math.sin,
+  cos: Math.cos,
+  tan: Math.tan,
+  log: Math.log,
+  log10: Math.log10,
+  exp: Math.exp
+};
+var CONSTANTS = {
+  pi: Math.PI,
+  e: Math.E
+};
+function evaluate(expr) {
+  const parser = { expr, pos: 0 };
+  const result = parseExpression(parser);
+  skipWhitespace(parser);
+  if (parser.pos < parser.expr.length) {
+    throw new Error(`Unexpected character: '${parser.expr[parser.pos]}'`);
+  }
+  return result;
+}
+function skipWhitespace(p) {
+  while (p.pos < p.expr.length && p.expr[p.pos] === " ") p.pos++;
+}
+function parseExpression(p) {
+  let left = parseTerm(p);
+  skipWhitespace(p);
+  while (p.pos < p.expr.length && (p.expr[p.pos] === "+" || p.expr[p.pos] === "-")) {
+    const op = p.expr[p.pos++];
+    const right = parseTerm(p);
+    left = op === "+" ? left + right : left - right;
+    skipWhitespace(p);
+  }
+  return left;
+}
+function parseTerm(p) {
+  let left = parsePower(p);
+  skipWhitespace(p);
+  while (p.pos < p.expr.length && (p.expr[p.pos] === "*" || p.expr[p.pos] === "/" || p.expr[p.pos] === "%")) {
+    const op = p.expr[p.pos++];
+    const right = parsePower(p);
+    if (op === "*") left *= right;
+    else if (op === "/") left /= right;
+    else left %= right;
+    skipWhitespace(p);
+  }
+  return left;
+}
+function parsePower(p) {
+  const base = parseUnary(p);
+  skipWhitespace(p);
+  if (p.pos < p.expr.length && (p.expr[p.pos] === "^" || p.expr[p.pos] === "*" && p.expr[p.pos + 1] === "*")) {
+    if (p.expr[p.pos] === "*") p.pos += 2;
+    else p.pos++;
+    const exp = parsePower(p);
+    return Math.pow(base, exp);
+  }
+  return base;
+}
+function parseUnary(p) {
+  skipWhitespace(p);
+  if (p.pos < p.expr.length && p.expr[p.pos] === "-") {
+    p.pos++;
+    return -parseUnary(p);
+  }
+  if (p.pos < p.expr.length && p.expr[p.pos] === "+") {
+    p.pos++;
+    return parseUnary(p);
+  }
+  return parseAtom(p);
+}
+function parseAtom(p) {
+  skipWhitespace(p);
+  if (p.pos < p.expr.length && p.expr[p.pos] === "(") {
+    p.pos++;
+    const val = parseExpression(p);
+    skipWhitespace(p);
+    if (p.pos >= p.expr.length || p.expr[p.pos] !== ")") {
+      throw new Error("Missing closing parenthesis");
+    }
+    p.pos++;
+    return val;
+  }
+  if (p.pos < p.expr.length && (isDigit(p.expr[p.pos]) || p.expr[p.pos] === ".")) {
+    return parseNumber(p);
+  }
+  if (p.pos < p.expr.length && isAlpha(p.expr[p.pos])) {
+    const name = parseIdentifier(p);
+    const lower = name.toLowerCase();
+    skipWhitespace(p);
+    if (p.pos < p.expr.length && p.expr[p.pos] === "(") {
+      const fn = FUNCTIONS[lower];
+      if (!fn) throw new Error(`Unknown function: ${name}`);
+      p.pos++;
+      const arg = parseExpression(p);
+      skipWhitespace(p);
+      if (p.pos >= p.expr.length || p.expr[p.pos] !== ")") {
+        throw new Error(`Missing closing parenthesis for ${name}()`);
+      }
+      p.pos++;
+      return fn(arg);
+    }
+    if (lower in CONSTANTS) return CONSTANTS[lower];
+    throw new Error(`Unknown identifier: ${name}`);
+  }
+  throw new Error(
+    p.pos < p.expr.length ? `Unexpected character: '${p.expr[p.pos]}'` : "Unexpected end of expression"
+  );
+}
+function parseNumber(p) {
+  const start = p.pos;
+  while (p.pos < p.expr.length && (isDigit(p.expr[p.pos]) || p.expr[p.pos] === ".")) p.pos++;
+  const num = parseFloat(p.expr.slice(start, p.pos));
+  if (isNaN(num)) throw new Error(`Invalid number at position ${start}`);
+  return num;
+}
+function parseIdentifier(p) {
+  const start = p.pos;
+  while (p.pos < p.expr.length && (isAlpha(p.expr[p.pos]) || isDigit(p.expr[p.pos]))) p.pos++;
+  return p.expr.slice(start, p.pos);
+}
+function isDigit(ch) {
+  return ch >= "0" && ch <= "9";
+}
+function isAlpha(ch) {
+  return ch >= "a" && ch <= "z" || ch >= "A" && ch <= "Z" || ch === "_";
+}
+
+// src/tools/datetime.ts
+var schema5 = {
+  name: "get_datetime",
+  description: 'Get the current date and time, optionally for a specific timezone. Useful for answering "what time is it?" or "what is the date in Tokyo?"',
+  parameters: {
+    type: "object",
+    properties: {
+      timezone: {
+        type: "string",
+        description: 'IANA timezone name, e.g. "America/New_York", "Europe/London", "Asia/Tokyo". Omit for the default timezone.'
+      }
+    },
+    required: []
+  }
+};
+function createDateTime(options) {
+  const defaultTz = options?.defaultTimezone ?? "UTC";
+  return {
+    schema: schema5,
+    async execute(args) {
+      const input = args.timezone ?? defaultTz;
+      const tz = resolveTimezone(input);
+      try {
+        const now = /* @__PURE__ */ new Date();
+        const formatted = new Intl.DateTimeFormat("en-US", {
+          timeZone: tz,
+          weekday: "long",
+          year: "numeric",
+          month: "long",
+          day: "numeric",
+          hour: "numeric",
+          minute: "2-digit",
+          second: "2-digit",
+          timeZoneName: "short"
+        }).format(now);
+        return `Current date and time in ${tz}: ${formatted}`;
+      } catch {
+        return `Unknown timezone: "${input}". Please use an IANA timezone like "America/New_York" or "Asia/Tokyo".`;
+      }
+    }
+  };
+}
+var CITY_MAP = {
+  "new york": "America/New_York",
+  "nyc": "America/New_York",
+  "los angeles": "America/Los_Angeles",
+  "la": "America/Los_Angeles",
+  "chicago": "America/Chicago",
+  "denver": "America/Denver",
+  "london": "Europe/London",
+  "paris": "Europe/Paris",
+  "berlin": "Europe/Berlin",
+  "tokyo": "Asia/Tokyo",
+  "shanghai": "Asia/Shanghai",
+  "beijing": "Asia/Shanghai",
+  "mumbai": "Asia/Kolkata",
+  "delhi": "Asia/Kolkata",
+  "sydney": "Australia/Sydney",
+  "dubai": "Asia/Dubai",
+  "singapore": "Asia/Singapore",
+  "hong kong": "Asia/Hong_Kong",
+  "seoul": "Asia/Seoul",
+  "moscow": "Europe/Moscow",
+  "sao paulo": "America/Sao_Paulo",
+  "toronto": "America/Toronto",
+  "vancouver": "America/Vancouver",
+  "honolulu": "Pacific/Honolulu",
+  "anchorage": "America/Anchorage"
+};
+function resolveTimezone(input) {
+  if (input.includes("/")) return input;
+  const lower = input.toLowerCase().trim();
+  return CITY_MAP[lower] ?? input;
+}
+export {
+  createCalculator,
+  createDateTime,
+  createTavilySearch,
+  createWeather,
+  createWikipedia,
+  registerTools
+};
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/register.ts","../src/tools/tavily-search.ts","../src/tools/weather.ts","../src/tools/wikipedia.ts","../src/tools/calculator.ts","../src/tools/datetime.ts"],"sourcesContent":["import type { JambonzTool, SessionLike } from './types.js';\n\ninterface ToolCallEvent {\n  tool_call_id: string;\n  name: string;\n  arguments: Record<string, any>;\n}\n\n/**\n * Register one or more tools on a jambonz session.\n *\n * Listens on the given hook path for tool-call events, dispatches to the\n * matching tool's execute() method, and sends the result back via\n * session.sendToolOutput(). Unknown tool names are reported as errors.\n *\n * @param session  - A jambonz WebSocket session (or any object with .on() and .sendToolOutput())\n * @param hookPath - The toolHook path used in the pipeline verb (e.g. '/tool-call')\n * @param tools    - Array of JambonzTool instances to register\n * @param options  - Optional configuration\n * @param options.logger - A pino-compatible logger for debug/error output\n * @param options.onUnknownTool - Custom handler for unrecognized tool names\n */\nexport function registerTools(\n  session: SessionLike,\n  hookPath: string,\n  tools: JambonzTool[],\n  options?: {\n    logger?: { info: (...args: any[]) => void; error: (...args: any[]) => void };\n    onUnknownTool?: (session: SessionLike, evt: ToolCallEvent) => void;\n  }\n): void {\n  const toolMap = new Map(tools.map((t) => [t.schema.name, t]));\n  const log = options?.logger;\n\n  session.on(hookPath, async(evt: ToolCallEvent) => {\n    const { tool_call_id, name, arguments: args } = evt;\n    const tool = toolMap.get(name);\n\n    if (!tool) {\n      log?.error({ name, args }, `unknown tool: ${name}`);\n      if (options?.onUnknownTool) {\n        options.onUnknownTool(session, evt);\n      } else {\n        session.sendToolOutput(tool_call_id, `Unknown tool: ${name}`);\n      }\n      return;\n    }\n\n    log?.info({ name, args }, 'tool call');\n    try {\n      const result = await tool.execute(args);\n      session.sendToolOutput(tool_call_id, result);\n    } catch (err) {\n      log?.error({ err, name, args }, `tool execution failed: ${name}`);\n      session.sendToolOutput(tool_call_id, `Error executing ${name}: ${err}`);\n    }\n  });\n}\n","import type { JambonzTool, ToolSchema } from '../types.js';\n\nexport interface TavilySearchOptions {\n  /** Tavily API key (required) */\n  apiKey: string;\n  /** Maximum number of results to return (default: 3) */\n  maxResults?: number;\n  /** Search depth: 'basic' is faster, 'advanced' is more thorough (default: 'basic') */\n  searchDepth?: 'basic' | 'advanced';\n  /** Topic category (default: 'general') */\n  topic?: 'general' | 'news' | 'finance';\n  /** Only include results from these domains */\n  includeDomains?: string[];\n  /** Exclude results from these domains */\n  excludeDomains?: string[];\n}\n\nconst schema: ToolSchema = {\n  name: 'web_search',\n  description: 'Search the web for current information on a given topic or question.',\n  parameters: {\n    type: 'object',\n    properties: {\n      query: {\n        type: 'string',\n        description: 'The search query',\n      },\n    },\n    required: ['query'],\n  },\n};\n\n/**\n * Create a web search tool powered by the Tavily Search API.\n *\n * Useful for answering questions about current events, recent news,\n * or any topic that requires up-to-date information.\n *\n * Requires a Tavily API key — sign up at https://tavily.com\n */\nexport function createTavilySearch(options: TavilySearchOptions): JambonzTool {\n  const {\n    apiKey,\n    maxResults = 3,\n    searchDepth = 'basic',\n    topic = 'general',\n    includeDomains,\n    excludeDomains,\n  } = options;\n\n  return {\n    schema,\n    async execute(args: Record<string, any>): Promise<string> {\n      const res = await fetch('https://api.tavily.com/search', {\n        method: 'POST',\n        headers: { 'Content-Type': 'application/json' },\n        body: JSON.stringify({\n          api_key: apiKey,\n          query: args.query,\n          max_results: maxResults,\n          search_depth: searchDepth,\n          topic,\n          ...(includeDomains && { include_domains: includeDomains }),\n          ...(excludeDomains && { exclude_domains: excludeDomains }),\n        }),\n      });\n\n      if (!res.ok) {\n        throw new Error(`Tavily API error: ${res.status} ${res.statusText}`);\n      }\n\n      const data = await res.json() as {\n        results?: { title: string; content: string; url: string }[];\n      };\n\n      const results = (data.results || [])\n        .map((r) => `${r.title}: ${r.content}`)\n        .join('\\n');\n\n      return results || 'No results found.';\n    },\n  };\n}\n","import type { JambonzTool, ToolSchema } from '../types.js';\n\nexport interface WeatherOptions {\n  /** Temperature scale (default: 'celsius') */\n  scale?: 'celsius' | 'fahrenheit';\n}\n\nconst schema: ToolSchema = {\n  name: 'get_weather',\n  description: 'Get the current temperature, wind speed, and conditions for a given location.',\n  parameters: {\n    type: 'object',\n    properties: {\n      location: {\n        type: 'string',\n        description: 'City name or location, e.g. \"San Francisco\" or \"Paris, France\"',\n      },\n    },\n    required: ['location'],\n  },\n};\n\n/**\n * Create a weather lookup tool using the free Open-Meteo API.\n *\n * No API key required. Provides current temperature, wind speed,\n * and weather conditions for any location worldwide.\n */\nexport function createWeather(options?: WeatherOptions): JambonzTool {\n  const scale = options?.scale ?? 'celsius';\n\n  return {\n    schema,\n    async execute(args: Record<string, any>): Promise<string> {\n      const location = args.location as string;\n\n      /* geocode the location name */\n      const geoRes = await fetch(\n        'https://geocoding-api.open-meteo.com/v1/search'\n        + `?name=${encodeURIComponent(location)}&count=1&language=en&format=json`\n      );\n      if (!geoRes.ok) {\n        throw new Error(`Geocoding API error: ${geoRes.status}`);\n      }\n\n      const geoData = await geoRes.json() as {\n        results?: { latitude: number; longitude: number; name: string; country: string }[];\n      };\n      if (!geoData.results?.length) {\n        return `Sorry, I could not find weather data for \"${location}\".`;\n      }\n\n      const { latitude, longitude, name, country } = geoData.results[0];\n\n      /* fetch current weather */\n      const wxRes = await fetch(\n        'https://api.open-meteo.com/v1/forecast'\n        + `?latitude=${latitude}&longitude=${longitude}`\n        + '&current=temperature_2m,relative_humidity_2m,apparent_temperature,weather_code,wind_speed_10m'\n        + `&temperature_unit=${scale}`\n      );\n      if (!wxRes.ok) {\n        throw new Error(`Weather API error: ${wxRes.status}`);\n      }\n\n      const wx = await wxRes.json() as {\n        current: {\n          temperature_2m: number;\n          relative_humidity_2m: number;\n          apparent_temperature: number;\n          weather_code: number;\n          wind_speed_10m: number;\n        };\n      };\n\n      const unit = scale === 'fahrenheit' ? '°F' : '°C';\n      const { temperature_2m, apparent_temperature, relative_humidity_2m, weather_code, wind_speed_10m } = wx.current;\n      const condition = weatherCodeToText(weather_code);\n\n      return [\n        `Current weather in ${name}, ${country}:`,\n        `${condition}, ${temperature_2m}${unit} (feels like ${apparent_temperature}${unit}).`,\n        `Wind: ${wind_speed_10m} km/h. Humidity: ${relative_humidity_2m}%.`,\n      ].join(' ');\n    },\n  };\n}\n\n/** Map WMO weather codes to human-readable descriptions */\nfunction weatherCodeToText(code: number): string {\n  const descriptions: Record<number, string> = {\n    0: 'Clear sky',\n    1: 'Mainly clear', 2: 'Partly cloudy', 3: 'Overcast',\n    45: 'Foggy', 48: 'Depositing rime fog',\n    51: 'Light drizzle', 53: 'Moderate drizzle', 55: 'Dense drizzle',\n    61: 'Slight rain', 63: 'Moderate rain', 65: 'Heavy rain',\n    71: 'Slight snow', 73: 'Moderate snow', 75: 'Heavy snow',\n    77: 'Snow grains',\n    80: 'Slight rain showers', 81: 'Moderate rain showers', 82: 'Violent rain showers',\n    85: 'Slight snow showers', 86: 'Heavy snow showers',\n    95: 'Thunderstorm', 96: 'Thunderstorm with slight hail', 99: 'Thunderstorm with heavy hail',\n  };\n  return descriptions[code] ?? 'Unknown conditions';\n}\n","import type { JambonzTool, ToolSchema } from '../types.js';\n\nexport interface WikipediaOptions {\n  /** Maximum number of sentences to return from the article summary (default: 5) */\n  maxSentences?: number;\n  /** Wikipedia language edition (default: 'en') */\n  language?: string;\n}\n\nconst schema: ToolSchema = {\n  name: 'wikipedia',\n  description: 'Look up a topic on Wikipedia to get a factual summary. '\n    + 'Useful for answering questions about people, places, history, science, and general knowledge.',\n  parameters: {\n    type: 'object',\n    properties: {\n      query: {\n        type: 'string',\n        description: 'The topic to look up on Wikipedia',\n      },\n    },\n    required: ['query'],\n  },\n};\n\n/**\n * Create a Wikipedia lookup tool using the free Wikipedia REST API.\n *\n * No API key required. Searches Wikipedia and returns article summaries,\n * ideal for answering general knowledge questions in voice conversations.\n */\nexport function createWikipedia(options?: WikipediaOptions): JambonzTool {\n  const maxSentences = options?.maxSentences ?? 5;\n  const lang = options?.language ?? 'en';\n\n  return {\n    schema,\n    async execute(args: Record<string, any>): Promise<string> {\n      const query = args.query as string;\n\n      /* search for matching articles */\n      const searchRes = await fetch(\n        `https://${lang}.wikipedia.org/w/api.php`\n        + `?action=query&list=search&srsearch=${encodeURIComponent(query)}`\n        + '&srlimit=1&format=json&origin=*'\n      );\n      if (!searchRes.ok) {\n        throw new Error(`Wikipedia search error: ${searchRes.status}`);\n      }\n\n      const searchData = await searchRes.json() as {\n        query: { search: { title: string; pageid: number }[] };\n      };\n      if (!searchData.query.search.length) {\n        return `No Wikipedia article found for \"${query}\".`;\n      }\n\n      const { title } = searchData.query.search[0];\n\n      /* fetch the article summary */\n      const summaryRes = await fetch(\n        `https://${lang}.wikipedia.org/api/rest_v1/page/summary/${encodeURIComponent(title)}`\n      );\n      if (!summaryRes.ok) {\n        throw new Error(`Wikipedia summary error: ${summaryRes.status}`);\n      }\n\n      const summary = await summaryRes.json() as {\n        title: string;\n        extract: string;\n      };\n\n      /* trim to maxSentences */\n      const sentences = summary.extract.split(/(?<=\\.)\\s+/);\n      const trimmed = sentences.slice(0, maxSentences).join(' ');\n\n      return `${summary.title}: ${trimmed}`;\n    },\n  };\n}\n","import type { JambonzTool, ToolSchema } from '../types.js';\n\nconst schema: ToolSchema = {\n  name: 'calculator',\n  description: 'Evaluate a mathematical expression and return the numeric result. '\n    + 'Supports arithmetic (+, -, *, /, ^, %), parentheses, and functions '\n    + '(sqrt, abs, round, ceil, floor, sin, cos, tan, log, log10, exp). '\n    + 'Also supports constants pi and e.',\n  parameters: {\n    type: 'object',\n    properties: {\n      expression: {\n        type: 'string',\n        description: 'The math expression to evaluate, e.g. \"15% of 87.50\" should be sent as \"87.50 * 0.15\"',\n      },\n    },\n    required: ['expression'],\n  },\n};\n\n/**\n * Create a safe math calculator tool.\n *\n * Uses a recursive descent parser — no eval() — to safely evaluate\n * arithmetic expressions. Ideal for voice agents handling calculations\n * like tips, conversions, or simple math.\n */\nexport function createCalculator(): JambonzTool {\n  return {\n    schema,\n    async execute(args: Record<string, any>): Promise<string> {\n      const expression = (args.expression as string).trim();\n      try {\n        const result = evaluate(expression);\n        /* format nicely: avoid excessive decimals */\n        const formatted = Number.isInteger(result) ? result.toString() : parseFloat(result.toFixed(10)).toString();\n        return `${expression} = ${formatted}`;\n      } catch (err) {\n        return `Could not evaluate \"${expression}\": ${(err as Error).message}`;\n      }\n    },\n  };\n}\n\n/* ---------- Safe expression evaluator (recursive descent parser) ---------- */\n\nconst FUNCTIONS: Record<string, (x: number) => number> = {\n  sqrt: Math.sqrt,\n  abs: Math.abs,\n  round: Math.round,\n  ceil: Math.ceil,\n  floor: Math.floor,\n  sin: Math.sin,\n  cos: Math.cos,\n  tan: Math.tan,\n  log: Math.log,\n  log10: Math.log10,\n  exp: Math.exp,\n};\n\nconst CONSTANTS: Record<string, number> = {\n  pi: Math.PI,\n  e: Math.E,\n};\n\ninterface Parser {\n  expr: string;\n  pos: number;\n}\n\nfunction evaluate(expr: string): number {\n  const parser: Parser = { expr, pos: 0 };\n  const result = parseExpression(parser);\n  skipWhitespace(parser);\n  if (parser.pos < parser.expr.length) {\n    throw new Error(`Unexpected character: '${parser.expr[parser.pos]}'`);\n  }\n  return result;\n}\n\nfunction skipWhitespace(p: Parser): void {\n  while (p.pos < p.expr.length && p.expr[p.pos] === ' ') p.pos++;\n}\n\nfunction parseExpression(p: Parser): number {\n  let left = parseTerm(p);\n  skipWhitespace(p);\n  while (p.pos < p.expr.length && (p.expr[p.pos] === '+' || p.expr[p.pos] === '-')) {\n    const op = p.expr[p.pos++];\n    const right = parseTerm(p);\n    left = op === '+' ? left + right : left - right;\n    skipWhitespace(p);\n  }\n  return left;\n}\n\nfunction parseTerm(p: Parser): number {\n  let left = parsePower(p);\n  skipWhitespace(p);\n  while (p.pos < p.expr.length && (p.expr[p.pos] === '*' || p.expr[p.pos] === '/' || p.expr[p.pos] === '%')) {\n    const op = p.expr[p.pos++];\n    const right = parsePower(p);\n    if (op === '*') left *= right;\n    else if (op === '/') left /= right;\n    else left %= right;\n    skipWhitespace(p);\n  }\n  return left;\n}\n\nfunction parsePower(p: Parser): number {\n  const base = parseUnary(p);\n  skipWhitespace(p);\n  if (p.pos < p.expr.length && (p.expr[p.pos] === '^' || (p.expr[p.pos] === '*' && p.expr[p.pos + 1] === '*'))) {\n    if (p.expr[p.pos] === '*') p.pos += 2; else p.pos++;\n    const exp = parsePower(p); /* right-associative */\n    return Math.pow(base, exp);\n  }\n  return base;\n}\n\nfunction parseUnary(p: Parser): number {\n  skipWhitespace(p);\n  if (p.pos < p.expr.length && p.expr[p.pos] === '-') {\n    p.pos++;\n    return -parseUnary(p);\n  }\n  if (p.pos < p.expr.length && p.expr[p.pos] === '+') {\n    p.pos++;\n    return parseUnary(p);\n  }\n  return parseAtom(p);\n}\n\nfunction parseAtom(p: Parser): number {\n  skipWhitespace(p);\n\n  /* parenthesized expression */\n  if (p.pos < p.expr.length && p.expr[p.pos] === '(') {\n    p.pos++;\n    const val = parseExpression(p);\n    skipWhitespace(p);\n    if (p.pos >= p.expr.length || p.expr[p.pos] !== ')') {\n      throw new Error('Missing closing parenthesis');\n    }\n    p.pos++;\n    return val;\n  }\n\n  /* number */\n  if (p.pos < p.expr.length && (isDigit(p.expr[p.pos]) || p.expr[p.pos] === '.')) {\n    return parseNumber(p);\n  }\n\n  /* identifier: function or constant */\n  if (p.pos < p.expr.length && isAlpha(p.expr[p.pos])) {\n    const name = parseIdentifier(p);\n    const lower = name.toLowerCase();\n    skipWhitespace(p);\n\n    /* function call */\n    if (p.pos < p.expr.length && p.expr[p.pos] === '(') {\n      const fn = FUNCTIONS[lower];\n      if (!fn) throw new Error(`Unknown function: ${name}`);\n      p.pos++;\n      const arg = parseExpression(p);\n      skipWhitespace(p);\n      if (p.pos >= p.expr.length || p.expr[p.pos] !== ')') {\n        throw new Error(`Missing closing parenthesis for ${name}()`);\n      }\n      p.pos++;\n      return fn(arg);\n    }\n\n    /* constant */\n    if (lower in CONSTANTS) return CONSTANTS[lower];\n    throw new Error(`Unknown identifier: ${name}`);\n  }\n\n  throw new Error(\n    p.pos < p.expr.length\n      ? `Unexpected character: '${p.expr[p.pos]}'`\n      : 'Unexpected end of expression'\n  );\n}\n\nfunction parseNumber(p: Parser): number {\n  const start = p.pos;\n  while (p.pos < p.expr.length && (isDigit(p.expr[p.pos]) || p.expr[p.pos] === '.')) p.pos++;\n  const num = parseFloat(p.expr.slice(start, p.pos));\n  if (isNaN(num)) throw new Error(`Invalid number at position ${start}`);\n  return num;\n}\n\nfunction parseIdentifier(p: Parser): string {\n  const start = p.pos;\n  while (p.pos < p.expr.length && (isAlpha(p.expr[p.pos]) || isDigit(p.expr[p.pos]))) p.pos++;\n  return p.expr.slice(start, p.pos);\n}\n\nfunction isDigit(ch: string): boolean {\n  return ch >= '0' && ch <= '9';\n}\n\nfunction isAlpha(ch: string): boolean {\n  return (ch >= 'a' && ch <= 'z') || (ch >= 'A' && ch <= 'Z') || ch === '_';\n}\n","import type { JambonzTool, ToolSchema } from '../types.js';\n\nexport interface DateTimeOptions {\n  /** Default timezone when none is specified (default: 'UTC') */\n  defaultTimezone?: string;\n}\n\nconst schema: ToolSchema = {\n  name: 'get_datetime',\n  description: 'Get the current date and time, optionally for a specific timezone. '\n    + 'Useful for answering \"what time is it?\" or \"what is the date in Tokyo?\"',\n  parameters: {\n    type: 'object',\n    properties: {\n      timezone: {\n        type: 'string',\n        description:\n          'IANA timezone name, e.g. \"America/New_York\", \"Europe/London\", \"Asia/Tokyo\". '\n          + 'Omit for the default timezone.',\n      },\n    },\n    required: [],\n  },\n};\n\n/**\n * Create a date/time tool using the built-in Intl API.\n *\n * No API key required. Returns the current date, time, and timezone\n * for any IANA timezone. Handles common city-to-timezone mapping for\n * cases where the LLM sends a city name instead of an IANA zone.\n */\nexport function createDateTime(options?: DateTimeOptions): JambonzTool {\n  const defaultTz = options?.defaultTimezone ?? 'UTC';\n\n  return {\n    schema,\n    async execute(args: Record<string, any>): Promise<string> {\n      const input = (args.timezone as string | undefined) ?? defaultTz;\n      const tz = resolveTimezone(input);\n\n      try {\n        const now = new Date();\n        const formatted = new Intl.DateTimeFormat('en-US', {\n          timeZone: tz,\n          weekday: 'long',\n          year: 'numeric',\n          month: 'long',\n          day: 'numeric',\n          hour: 'numeric',\n          minute: '2-digit',\n          second: '2-digit',\n          timeZoneName: 'short',\n        }).format(now);\n\n        return `Current date and time in ${tz}: ${formatted}`;\n      } catch {\n        return `Unknown timezone: \"${input}\". Please use an IANA timezone like \"America/New_York\" or \"Asia/Tokyo\".`;\n      }\n    },\n  };\n}\n\n/**\n * Best-effort mapping from common city names to IANA timezones.\n * The LLM will usually send proper IANA names, but voice users\n * often say \"what time is it in London?\" and the LLM may forward that.\n */\nconst CITY_MAP: Record<string, string> = {\n  'new york': 'America/New_York',\n  'nyc': 'America/New_York',\n  'los angeles': 'America/Los_Angeles',\n  'la': 'America/Los_Angeles',\n  'chicago': 'America/Chicago',\n  'denver': 'America/Denver',\n  'london': 'Europe/London',\n  'paris': 'Europe/Paris',\n  'berlin': 'Europe/Berlin',\n  'tokyo': 'Asia/Tokyo',\n  'shanghai': 'Asia/Shanghai',\n  'beijing': 'Asia/Shanghai',\n  'mumbai': 'Asia/Kolkata',\n  'delhi': 'Asia/Kolkata',\n  'sydney': 'Australia/Sydney',\n  'dubai': 'Asia/Dubai',\n  'singapore': 'Asia/Singapore',\n  'hong kong': 'Asia/Hong_Kong',\n  'seoul': 'Asia/Seoul',\n  'moscow': 'Europe/Moscow',\n  'sao paulo': 'America/Sao_Paulo',\n  'toronto': 'America/Toronto',\n  'vancouver': 'America/Vancouver',\n  'honolulu': 'Pacific/Honolulu',\n  'anchorage': 'America/Anchorage',\n};\n\nfunction resolveTimezone(input: string): string {\n  /* already looks like an IANA zone? */\n  if (input.includes('/')) return input;\n  /* check the city map */\n  const lower = input.toLowerCase().trim();\n  return CITY_MAP[lower] ?? input;\n}\n"],"mappings":"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","names":["schema","schema","schema","schema"]}

package/package.json

@@ -0,0 +1,64 @@
+{
+  "name": "@jambonz/tools",
+  "version": "0.1.2",
+  "description": "Pre-built, reusable tools for jambonz pipeline voice AI agents",
+  "type": "module",
+  "main": "./dist/index.cjs",
+  "module": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "import": {
+        "types": "./dist/index.d.ts",
+        "default": "./dist/index.js"
+      },
+      "require": {
+        "types": "./dist/index.d.cts",
+        "default": "./dist/index.cjs"
+      }
+    }
+  },
+  "files": [
+    "dist"
+  ],
+  "scripts": {
+    "build": "tsup",
+    "lint": "eslint src/",
+    "lint:fix": "eslint --fix src/",
+    "prepublishOnly": "npm run build",
+    "prepare": "husky"
+  },
+  "keywords": [
+    "jambonz",
+    "voice",
+    "ai",
+    "tools",
+    "pipeline",
+    "llm",
+    "function-calling"
+  ],
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/jambonz/tools"
+  },
+  "license": "MIT",
+  "engines": {
+    "node": ">=22.0.0"
+  },
+  "devDependencies": {
+    "@eslint/js": "^9.27.0",
+    "@typescript-eslint/eslint-plugin": "^8.33.0",
+    "@typescript-eslint/parser": "^8.33.0",
+    "eslint": "^9.27.0",
+    "eslint-plugin-promise": "^7.2.1",
+    "globals": "^16.1.0",
+    "husky": "^9.1.7",
+    "lint-staged": "^16.4.0",
+    "tsup": "^8.4.0",
+    "typescript": "^5.8.3",
+    "typescript-eslint": "^8.33.0"
+  },
+  "lint-staged": {
+    "*.ts": "eslint --max-warnings 0"
+  }
+}