Function executablePromptFunction

src/prompts/processors/executable.ts:25–106

(
  scriptPath: string,
  context: {
    vars: Record<string, VarValue>;
    provider?: ApiProvider;
    config?: {
      basePath?: string;
      timeout?: number;
    };
  },
)

 * @returns The prompt output from the script.
 */
export const executablePromptFunction = async (
  scriptPath: string,
  context: {
    vars: Record<string, VarValue>;
    provider?: ApiProvider;
    config?: {
      basePath?: string;
      timeout?: number;
    };
  },
): Promise<string> => {
  invariant(context.provider?.id, 'provider.id is required');

  const transformedContext: PromptFunctionContext = {
    vars: context.vars,
    provider: {
      id:
        typeof context.provider?.id === 'function' ? context.provider?.id() : context.provider?.id,
      label: context.provider?.label,
    },
    config: context.config ?? {},
  };

  const scriptParts = parseScriptParts(scriptPath);
  const fileHashes = getFileHashes(scriptParts);

  const cacheKey = `exec-prompt:${scriptPath}:${fileHashes.join(':')}:${safeJsonStringify(transformedContext)}`;

  let cachedResult;
  if (fileHashes.length > 0 && isCacheEnabled()) {
    const cache = getCache();
    cachedResult = await cache.get(cacheKey);

    if (cachedResult) {
      logger.debug(`Returning cached result for executable prompt ${scriptPath}`);
      return cachedResult as string;
    }
  }

  return new Promise<string>((resolve, reject) => {
    const command = scriptParts.shift();
    invariant(command, 'No command found in script path');

    // Pass context as JSON argument to the script
    const scriptArgs = scriptParts.concat([safeJsonStringify(transformedContext) as string]);

    const options = {
      cwd: context.config?.basePath,
      timeout: context.config?.timeout || 60000, // Default 60 second timeout
    };

    logger.debug(`Executing prompt script: ${command} ${scriptArgs.join(' ')}`);

    execFile(command, scriptArgs, options, async (error, stdout, stderr) => {
      if (error) {
        logger.error(`Error running executable prompt ${scriptPath}: ${error.message}`);
        reject(error);
        return;