@convo-lang/convo-lang-cli/src/lib/convo-cli-types.d.ts

The language of AI

export type ConvoExecAllowMode = 'disable' | 'ask' | 'allow';
export interface ConvoCliConfig {
    env?: Record<string, string>;
    /**
     * Contains how shell command execution is allowed
     */
    allowExec?: ConvoExecAllowMode | ConvoExecConfirmCallback;
    /**
     * If true values of the env property with override process.env values
     */
    overrideEnv?: boolean;
    /**
     * @default "vision"
     */
    capabilities?: string;
    apiKey?: string;
    apiBaseUrl?: string;
    chatModel?: string;
    audioModel?: string;
    imageModel?: string;
    visionModel?: string;
    secrets?: string;
}
export interface ConvoCliOptions {
    /**
     * Path to a ConvoCliConfig file
     */
    config?: string;
    /**
     * Inline configuration as json
     */
    inlineConfig?: string;
    /**
     * Path to a source convo file
     */
    source?: string;
    /**
     * If true the source will be read from stdin
     */
    stdin?: boolean;
    /**
     * Inline convo code
     */
    inline?: string;
    /**
     * Used to set or overwrite the source path of executed files.
     */
    sourcePath?: string;
    /**
     * If true the CLI will operate in command mode which will allow function calling to be passed
     * though stdin and stdout
     */
    cmdMode?: boolean;
    /**
     * If true the CLI should enter REPL mode where the user can chat
     */
    repl?: boolean;
    /**
     * If true each line of output will be prefixed with characters to indicating what the output
     * is related to.
     */
    prefixOutput?: boolean;
    /**
     * If true the shared variable state will be printed
     */
    printState?: boolean;
    /**
     * If true the flattened messages will be printed
     */
    printFlat?: boolean;
    /**
     * If true the messages will be printed
     */
    printMessages?: boolean;
    /**
     * If true the give convo code will be parsed and output as JSON instead of executing the
     * code.
     */
    parse?: boolean;
    /**
     * JSON formatting used if the parse option is true
     */
    parseFormat?: number;
    /**
     * If true the input will be converted to input format of the target LLM and written as output.
     */
    convert?: boolean;
    /**
     * Either a function that will be called with each chunk of generated code or a path to write
     * output to. If out equals "." then the source path will be used. This allows you to run a
     * convo script then output the results back into the same file.
     */
    out?: ((...chunks: string[]) => void) | string;
    /**
     * If true the output of the executor is buffered to be used later.
     */
    bufferOutput?: boolean;
    /**
     * Contains how shell command execution is allowed
     */
    allowExec?: ConvoExecAllowMode | ConvoExecConfirmCallback;
    /**
     * Conversation content to prepend to source
     */
    prepend?: string;
    /**
     * The current working directory used for context execution
     */
    exeCwd?: string;
    /**
     * Path to tsconfig of a TypeScript project that will be synchronized by scanning for tagged
     * interfaces, types and components
     */
    syncTsConfig?: string[];
    /**
     * If TypeScript projects being scanned with be updated in real time as changes are made.
     */
    syncWatch?: boolean;
    /**
     * The directory where generated synchronization output files are written
     */
    syncOut?: string;
    /**
     * A command line that can be ran in parallel with actions such as sync watching
     */
    spawn?: string;
    /**
     * Directory where to run the spawn command
     */
    spawnDir?: string;
    /**
     * Creates a new next js app using the create-next-app npx command using the convo-lang-nextjs-template
     */
    createNextApp?: boolean;
    /**
     * The directory where apps will be created
     */
    createAppDir?: string;
    /**
     * The directory where the create app command will be ran
     */
    createAppWorkingDir?: string;
    /**
     * If true all known models will be listed as JSON
     */
    listModels?: boolean;
}
export type ConvoExecConfirmCallback = (command: string, commandIndex: number) => Promise<boolean> | boolean;