Function chatTool

apps/api/src/agents/tools/helpers.ts:39–82

(
  config: {
    name: string;
    description: string;
    schema: z.ZodTypeAny;
  },
  handler: (
    // biome-ignore lint/suspicious/noExplicitAny: deliberate, see comment above
    input: any,
    ctx: ChatAgentContext,
    runCtx: ToolRunContext,
  ) => Promise<unknown>,
)

 *     decide whether to retry with narrower params or move on.
 */
export function chatTool(
  config: {
    name: string;
    description: string;
    schema: z.ZodTypeAny;
  },
  handler: (
    // biome-ignore lint/suspicious/noExplicitAny: deliberate, see comment above
    input: any,
    ctx: ChatAgentContext,
    runCtx: ToolRunContext,
  ) => Promise<unknown>,
): AgentToolDefinition {
  // biome-ignore lint/suspicious/noExplicitAny: see block comment above
  const contract: any = defineTool({
    name: config.name,
    description: config.description,
    schema: config.schema,
  });
  return contract.server(
    async (input: unknown, runCtx: ToolRunContext) => {
      const work = handler(
        input,
        runCtx.context as ChatAgentContext,
        runCtx,
      );
      let timer: NodeJS.Timeout | undefined;
      const timeout = new Promise<never>((_, reject) => {
        timer = setTimeout(() => {
          reject(
            new Error(
              `Tool "${config.name}" timed out after ${TOOL_TIMEOUT_MS / 1000}s`,
            ),
          );
        }, TOOL_TIMEOUT_MS);
      });
      try {
        return await Promise.race([work, timeout]);
      } finally {
        if (timer) clearTimeout(timer);
      }
    },
  ) as AgentToolDefinition;
}

/**
 * Cap an array result to `max` items and append a truncation marker so the