Skip to content

Composio powers 1000+ toolkits, tool search, context management, authentication, and a sandboxed workbench to help you build AI agents that turn intent into action.

2.9 KB
Raw Blame
/**
 * Last-resort guess: the text before the first underscore. Multi-word toolkit
 * slugs (e.g. `google_analytics` in `GOOGLE_ANALYTICS_RUN_REPORT`) cannot be
 * recovered from the tool slug alone, so prefer `toolkitFromToolSlug` from
 * `src/effects/toolkit-from-tool-slug`, which matches against the known
 * toolkit list and only falls back to this guess when that list is
 * unavailable.
 */
export const guessToolkitFromToolSlug = (toolSlug: string): string | undefined => {
  const idx = toolSlug.indexOf('_');
  if (idx <= 0) return toolSlug.toLowerCase();
  const prefix = toolSlug.slice(0, idx).toLowerCase();
  return prefix === 'composio' ? undefined : prefix;
};

/**
 * Longest-prefix search over the tool slug's underscore boundaries: for
 * `A_B_C_D` the candidates are `a_b_c`, then `a_b`, then `a`, and the first
 * candidate present in the known toolkit list wins — so
 * `GOOGLE_ANALYTICS_RUN_REPORT` resolves to `google_analytics` even when
 * `google` is also a known toolkit. Returns undefined when no candidate is
 * known.
 */
export const longestPrefix = (
  toolSlug: string,
  knownToolkitSlugs: ReadonlyArray<string>
): string | undefined => makeLongestPrefixMatcher(knownToolkitSlugs)(toolSlug);

/**
 * {@link longestPrefix} against a list that does not change, with the lookup
 * set built once and closed over. The known list runs to a thousand-odd slugs
 * and a single command resolves several tool slugs against it, so callers that
 * hold onto the returned function pay for the set once instead of per lookup.
 */
export const makeLongestPrefixMatcher = (
  knownToolkitSlugs: ReadonlyArray<string>
): ((toolSlug: string) => string | undefined) => {
  const known = new Set(knownToolkitSlugs.map(slug => slug.toLowerCase()));

  return toolSlug => {
    const segments = toolSlug.toLowerCase().split('_');
    for (let end = segments.length - 1; end >= 1; end -= 1) {
      const candidate = segments.slice(0, end).join('_');
      if (known.has(candidate)) return candidate;
    }
    return undefined;
  };
};

/**
 * Bare `composio`-prefixed slugs are meta tools, not user-linkable toolkits;
 * longer matches such as `composio_search` are real toolkits. A `composio`
 * match is a resolved answer rather than a miss, so callers must not fall
 * through to a wider search on the `undefined` it returns.
 */
export const toolkitFromMatchedPrefix = (match: string): string | undefined =>
  match === 'composio' ? undefined : match;

/**
 * `longestPrefix` with the toolkit-resolution policy applied on top: the
 * `composio` meta guard, and `guessToolkitFromToolSlug` when no candidate is
 * known.
 */
export const matchToolkitFromToolSlug = (
  toolSlug: string,
  knownToolkitSlugs: ReadonlyArray<string>
): string | undefined => {
  const match = longestPrefix(toolSlug, knownToolkitSlugs);
  if (match !== undefined) {
    return toolkitFromMatchedPrefix(match);
  }
  return guessToolkitFromToolSlug(toolSlug);
};