BrainAPI is a knowledge graph–powered AI memory layer that transforms unstructured data into structured knowledge, enabling intelligent search, recommendations, and contextual memory for AI agents and applications.
Python ai-agentsai-memoryknowledge-graphknowledge-managementknowledge-representationreccomendation-system
Add hybrid non-interactive flags for brainapi init.
Christianb081bad0d619
diff --git a/tui/README.md b/tui/README.mdindex 373c64d..5cd5072 100644--- a/tui/README.md+++ b/tui/README.md@@ -18,6 +18,43 @@ brainapi start # start docker compose services + run the APIbrainapi doctor # check Python, Docker, Ollama, and configured services```+### Non-interactive / hybrid init++Any value you pass as a flag skips that wizard prompt; everything else is still asked.++```bash+brainapi init \+ --vector-db=postgresql \+ --data-db=postgresql \+ --graph-db=networkx \+ --models-mode=remote \+ --llm-small-provider=openai \+ --llm-large-provider=openai \+ --embeddings-provider=openai \+ --openai-api-key=sk-... \+ --llm-small=gpt-4o-mini \+ --llm-large=gpt-4o \+ --brainpat-token=brainpat_... \+ --no-plugins \+ --no-start-services+```++`brainapi --init ...` is an alias for `brainapi init ...`.++| Flag group | Examples |+| --- | --- |+| Defaults / DBs | `--defaults`, `--vector-db`, `--data-db`, `--graph-db` |+| Pipeline / runtime | `--ocr-mode`, `--services-runtime`, `--start-services`, `--no-start-services` |+| Models | `--models-mode`, `--llm-small-provider`, `--llm-large-provider`, `--embeddings-provider`, `--llm-small`, `--llm-large`, `--embedding-model`, `--embedding-dimensions` |+| Ollama | `--ollama-host`, `--ollama-port`, `--ollama-small`, `--ollama-large`, `--ollama-embeddings` |+| GCP | `--gcp-credentials`, `--gcp-project`, `--gcp-small`, `--gcp-large`, `--gcp-embedding` |+| Azure | `--azure-endpoint`, `--azure-api-version`, `--azure-key`, `--azure-small`, `--azure-large`, `--azure-embedding-endpoint`, `--azure-embedding-key`, `--azure-embedding` |+| OpenAI / Anthropic / DeepSeek | `--openai-api-key`, `--openai-base-url`, `--openai-small`, `--openai-large`, `--openai-embedding`, `--anthropic-api-key`, `--anthropic-small`, `--anthropic-large`, `--deepseek-api-key`, `--deepseek-small`, `--deepseek-large` |+| Bedrock | `--aws-region`, `--aws-access-key-id`, `--aws-secret-access-key`, `--aws-session-token`, `--bedrock-small`, `--bedrock-large`, `--bedrock-embedding` |+| Connections | `--redis-host`, `--redis-port`, `--postgres-*`, `--neo4j-*`, `--milvus-*`, `--mongo-*` |+| Auth / plugins | `--brainpat-token`, `--plugin <name[@version]>` (repeatable), `--no-plugins` |++If any config flag is present (or `--defaults`), the “Use default settings?” question is skipped.## Commands| Command | Description |diff --git a/tui/package-lock.json b/tui/package-lock.jsonindex 5b83b7c..3ff6c98 100644--- a/tui/package-lock.json+++ b/tui/package-lock.json@@ -1,12 +1,12 @@{"name": "brainapi-tui",- "version": "0.2.0",+ "version": "0.3.0","lockfileVersion": 3,"requires": true,"packages": {"": {"name": "brainapi-tui",- "version": "0.2.0",+ "version": "0.3.0","license": "MIT","dependencies": {"@clack/prompts": "^0.7.0",diff --git a/tui/package.json b/tui/package.jsonindex 7b8fc38..f4ce04c 100644--- a/tui/package.json+++ b/tui/package.json@@ -1,6 +1,6 @@{"name": "brainapi-tui",- "version": "0.2.0",+ "version": "0.3.0","description": "Interactive installer and runtime CLI for BrainAPI.","license": "MIT","type": "module",diff --git a/tui/src/commands/init.ts b/tui/src/commands/init.tsindex f637b44..172bf87 100644--- a/tui/src/commands/init.ts+++ b/tui/src/commands/init.ts@@ -26,6 +26,10 @@ import { bringUpServices, bringUpServicesManually } from "../lib/bring-up.js";import { targetFromConnections } from "../lib/service-target.js";import { askConfirm } from "../lib/prompts.js";import { installLocalPlugin, installRegistryPlugin } from "../lib/plugins.js";+import {+ hasConfigOverrides,+ type InitFlagOverrides,+} from "../lib/init-flags.js";import type {Connections,DbChoices,@@ -39,6 +43,7 @@ export interface InitOptions {repoUrl?: string;branch?: string;force?: boolean;+ flags?: InitFlagOverrides;}function intro(): void {@@ -117,12 +122,13 @@ async function installPhase(extras: string[]): Promise<void> {p.log.success("Dependencies installed");}-async function configurePhase(): Promise<InitChoices> {+async function configurePhase(flags?: InitFlagOverrides): Promise<InitChoices> {const draft: SetupDraft = {};await runSetupWizard(draft, {firstStepBack: "cancel",firstStepBackHint: "Cancel setup",stepBackHint: "Previous step",+ flags,});return toInitChoices(draft);}@@ -131,6 +137,7 @@ async function servicesPhase(dbs: DbChoices,connections: Connections,runtime: ServicesRuntime,+ startServices?: boolean,): Promise<void> {const services = pickedServices(dbs);const items = services.map((service) => ({@@ -149,10 +156,20 @@ async function servicesPhase(return;}- const startNow = await askConfirm({- message: "Start docker compose containers now for the services you picked?",- initialValue: true,- });+ let startNow: boolean;+ if (startServices !== undefined) {+ startNow = startServices;+ p.log.info(+ startNow+ ? "Starting docker compose containers (--start-services)."+ : "Skipping docker compose containers (--no-start-services).",+ );+ } else {+ startNow = await askConfirm({+ message: "Start docker compose containers now for the services you picked?",+ initialValue: true,+ });+ }if (!startNow) {p.log.info("Skipping. Start them later with " +@@ -221,6 +238,10 @@ export async function runInit(opts: InitOptions = {}): Promise<void> {await writeState(defaultState());}+ if (opts.flags && hasConfigOverrides(opts.flags)) {+ p.log.info("Using CLI flags for setup — skipping prompts for provided values.");+ }+let python = await ensurePython();await clonePhase(opts);@@ -232,7 +253,7 @@ export async function runInit(opts: InitOptions = {}): Promise<void> {await ensureVenv(python.bin);- const choices = await configurePhase();+ const choices = await configurePhase(opts.flags);const extras = [...ocrToExtras(choices.pipeline.ocrMode),...postgresBackendExtras(choices.dbs),@@ -250,6 +271,7 @@ export async function runInit(opts: InitOptions = {}): Promise<void> {choices.dbs,choices.connections,choices.servicesRuntime,+ opts.flags?.startServices,);outro();diff --git a/tui/src/flows/auth.ts b/tui/src/flows/auth.tsindex 01f919d..4ff4411 100644--- a/tui/src/flows/auth.ts+++ b/tui/src/flows/auth.ts@@ -8,15 +8,24 @@ function generateToken(): string {return `brainpat_${randomBytes(24).toString("hex")}`;}-export async function askAuth(opts?: { allowBack?: false }): Promise<AuthChoices>;+export async function askAuth(opts?: {+ allowBack?: false;+ prechosenToken?: string;+}): Promise<AuthChoices>;export async function askAuth(opts: {allowBack: true;backHint?: string;+ prechosenToken?: string;}): Promise<AuthChoices | PromptBack>;export async function askAuth(opts?: {allowBack?: boolean;backHint?: string;+ prechosenToken?: string;}): Promise<AuthChoices | PromptBack> {+ if (opts?.prechosenToken) {+ return { brainpatToken: opts.prechosenToken };+ }+p.log.step("Authentication token");const action = opts?.allowBackdiff --git a/tui/src/flows/connections.ts b/tui/src/flows/connections.tsindex 185c93e..9a1f5d4 100644--- a/tui/src/flows/connections.ts+++ b/tui/src/flows/connections.ts@@ -1,5 +1,6 @@import * as p from "@clack/prompts";import { SERVICE_DEFAULTS } from "../constants.js";+import type { InitFlagOverrides } from "../lib/init-flags.js";import { askPassword, askText, pickOne } from "../lib/prompts.js";import type {Connections,@@ -18,26 +19,31 @@ function portValidator(value: string): string | undefined {return undefined;}-async function askRedis(): Promise<RedisConnection> {+async function askRedis(flags?: InitFlagOverrides): Promise<RedisConnection> {p.log.step("Redis (required for cache + Celery)");- const host = await askText({- message: "Redis host",- placeholder: SERVICE_DEFAULTS.redis.host,- defaultValue: SERVICE_DEFAULTS.redis.host,- });- const port = await askText({- message: "Redis port",- placeholder: String(SERVICE_DEFAULTS.redis.port),- defaultValue: String(SERVICE_DEFAULTS.redis.port),- validate: portValidator,- });- return {- host: host.trim() || SERVICE_DEFAULTS.redis.host,- port: Number(port) || SERVICE_DEFAULTS.redis.port,- };+ let host = flags?.redisHost;+ if (host === undefined) {+ const raw = await askText({+ message: "Redis host",+ placeholder: SERVICE_DEFAULTS.redis.host,+ defaultValue: SERVICE_DEFAULTS.redis.host,+ });+ host = raw.trim() || SERVICE_DEFAULTS.redis.host;+ }+ let port = flags?.redisPort;+ if (port === undefined) {+ const raw = await askText({+ message: "Redis port",+ placeholder: String(SERVICE_DEFAULTS.redis.port),+ defaultValue: String(SERVICE_DEFAULTS.redis.port),+ validate: portValidator,+ });+ port = Number(raw) || SERVICE_DEFAULTS.redis.port;+ }+ return { host, port };}-async function askPostgres(): Promise<PostgresConnection> {+async function askPostgres(flags?: InitFlagOverrides): Promise<PostgresConnection> {p.log.step("PostgreSQL");p.note([@@ -47,162 +53,227 @@ async function askPostgres(): Promise<PostgresConnection> {].join("\n"),"Heads up");- const host = await askText({- message: "Postgres host",- placeholder: SERVICE_DEFAULTS.postgresql.host,- defaultValue: SERVICE_DEFAULTS.postgresql.host,- });- const port = await askText({- message: "Postgres port",- placeholder: String(SERVICE_DEFAULTS.postgresql.port),- defaultValue: String(SERVICE_DEFAULTS.postgresql.port),- validate: portValidator,- });- const username = await askText({- message: "Postgres username",- placeholder: SERVICE_DEFAULTS.postgresql.username,- defaultValue: SERVICE_DEFAULTS.postgresql.username,- });- const password = await askPassword({- message: "Postgres password (default is 'password')",- validate: (value) =>- value.length === 0 ? "Password is required" : undefined,- });- const systemDatabase = await askText({- message: `System database (brains registry, default ${SERVICE_DEFAULTS.postgresql.systemDatabase})`,- placeholder: SERVICE_DEFAULTS.postgresql.systemDatabase,- defaultValue: SERVICE_DEFAULTS.postgresql.systemDatabase,- });- const maintenanceDatabase = await askText({- message: `Maintenance database (for CREATE DATABASE, default ${SERVICE_DEFAULTS.postgresql.maintenanceDatabase})`,- placeholder: SERVICE_DEFAULTS.postgresql.maintenanceDatabase,- defaultValue: SERVICE_DEFAULTS.postgresql.maintenanceDatabase,- });+ let host = flags?.postgresHost;+ if (host === undefined) {+ const raw = await askText({+ message: "Postgres host",+ placeholder: SERVICE_DEFAULTS.postgresql.host,+ defaultValue: SERVICE_DEFAULTS.postgresql.host,+ });+ host = raw.trim() || SERVICE_DEFAULTS.postgresql.host;+ }+ let port = flags?.postgresPort;+ if (port === undefined) {+ const raw = await askText({+ message: "Postgres port",+ placeholder: String(SERVICE_DEFAULTS.postgresql.port),+ defaultValue: String(SERVICE_DEFAULTS.postgresql.port),+ validate: portValidator,+ });+ port = Number(raw) || SERVICE_DEFAULTS.postgresql.port;+ }+ let username = flags?.postgresUsername;+ if (username === undefined) {+ const raw = await askText({+ message: "Postgres username",+ placeholder: SERVICE_DEFAULTS.postgresql.username,+ defaultValue: SERVICE_DEFAULTS.postgresql.username,+ });+ username = raw.trim() || SERVICE_DEFAULTS.postgresql.username;+ }+ let password = flags?.postgresPassword;+ if (password === undefined) {+ password = await askPassword({+ message: "Postgres password (default is 'password')",+ validate: (value) =>+ value.length === 0 ? "Password is required" : undefined,+ });+ }+ let systemDatabase = flags?.postgresSystemDb;+ if (systemDatabase === undefined) {+ const raw = await askText({+ message: `System database (brains registry, default ${SERVICE_DEFAULTS.postgresql.systemDatabase})`,+ placeholder: SERVICE_DEFAULTS.postgresql.systemDatabase,+ defaultValue: SERVICE_DEFAULTS.postgresql.systemDatabase,+ });+ systemDatabase =+ raw.trim() || SERVICE_DEFAULTS.postgresql.systemDatabase;+ }+ let maintenanceDatabase = flags?.postgresMaintenanceDb;+ if (maintenanceDatabase === undefined) {+ const raw = await askText({+ message: `Maintenance database (for CREATE DATABASE, default ${SERVICE_DEFAULTS.postgresql.maintenanceDatabase})`,+ placeholder: SERVICE_DEFAULTS.postgresql.maintenanceDatabase,+ defaultValue: SERVICE_DEFAULTS.postgresql.maintenanceDatabase,+ });+ maintenanceDatabase =+ raw.trim() || SERVICE_DEFAULTS.postgresql.maintenanceDatabase;+ }return {- host: host.trim() || SERVICE_DEFAULTS.postgresql.host,- port: Number(port) || SERVICE_DEFAULTS.postgresql.port,- username: username.trim() || SERVICE_DEFAULTS.postgresql.username,+ host,+ port,+ username,password,- systemDatabase:- systemDatabase.trim() || SERVICE_DEFAULTS.postgresql.systemDatabase,- maintenanceDatabase:- maintenanceDatabase.trim() ||- SERVICE_DEFAULTS.postgresql.maintenanceDatabase,+ systemDatabase,+ maintenanceDatabase,};}-async function askNeo4j(): Promise<Neo4jConnection> {+async function askNeo4j(flags?: InitFlagOverrides): Promise<Neo4jConnection> {p.log.step("Neo4j");- const host = await askText({- message: "Neo4j host",- placeholder: SERVICE_DEFAULTS.neo4j.host,- defaultValue: SERVICE_DEFAULTS.neo4j.host,- });- const port = await askText({- message: "Neo4j Bolt port",- placeholder: String(SERVICE_DEFAULTS.neo4j.port),- defaultValue: String(SERVICE_DEFAULTS.neo4j.port),- validate: portValidator,- });- const username = await askText({- message: "Neo4j username",- placeholder: SERVICE_DEFAULTS.neo4j.username,- defaultValue: SERVICE_DEFAULTS.neo4j.username,- });- const password = await askPassword({- message: "Neo4j password (default is 'your_password')",- validate: (value) =>- value.length === 0 ? "Password is required" : undefined,- });- return {- host: host.trim() || SERVICE_DEFAULTS.neo4j.host,- port: Number(port) || SERVICE_DEFAULTS.neo4j.port,- username: username.trim() || SERVICE_DEFAULTS.neo4j.username,- password,- };+ let host = flags?.neo4jHost;+ if (host === undefined) {+ const raw = await askText({+ message: "Neo4j host",+ placeholder: SERVICE_DEFAULTS.neo4j.host,+ defaultValue: SERVICE_DEFAULTS.neo4j.host,+ });+ host = raw.trim() || SERVICE_DEFAULTS.neo4j.host;+ }+ let port = flags?.neo4jPort;+ if (port === undefined) {+ const raw = await askText({+ message: "Neo4j Bolt port",+ placeholder: String(SERVICE_DEFAULTS.neo4j.port),+ defaultValue: String(SERVICE_DEFAULTS.neo4j.port),+ validate: portValidator,+ });+ port = Number(raw) || SERVICE_DEFAULTS.neo4j.port;+ }+ let username = flags?.neo4jUsername;+ if (username === undefined) {+ const raw = await askText({+ message: "Neo4j username",+ placeholder: SERVICE_DEFAULTS.neo4j.username,+ defaultValue: SERVICE_DEFAULTS.neo4j.username,+ });+ username = raw.trim() || SERVICE_DEFAULTS.neo4j.username;+ }+ let password = flags?.neo4jPassword;+ if (password === undefined) {+ password = await askPassword({+ message: "Neo4j password (default is 'your_password')",+ validate: (value) =>+ value.length === 0 ? "Password is required" : undefined,+ });+ }+ return { host, port, username, password };}-async function askMilvus(): Promise<MilvusConnection> {+async function askMilvus(flags?: InitFlagOverrides): Promise<MilvusConnection> {p.log.step("Milvus");- const target = await pickOne<"local" | "managed">({- message: "Milvus deployment",- options: [- { value: "local", label: "Local docker compose" },- { value: "managed", label: "Managed (Zilliz Cloud) — uri + token" },- ],- initialValue: "local",- });- if (target === "managed") {- const uri = await askText({- message: "Milvus URI",- placeholder: "https://your-cluster.api.gcp-us-west1.zillizcloud.com",- validate: (value) =>- value.trim().length === 0 ? "URI is required" : undefined,- });- const token = await askPassword({- message: "Milvus token",- validate: (value) =>- value.length === 0 ? "Token is required" : undefined,+ let target = flags?.milvusDeployment;+ if (flags?.milvusUri || flags?.milvusToken) {+ target = "managed";+ }+ if (target === undefined) {+ target = await pickOne<"local" | "managed">({+ message: "Milvus deployment",+ options: [+ { value: "local", label: "Local docker compose" },+ { value: "managed", label: "Managed (Zilliz Cloud) — uri + token" },+ ],+ initialValue: "local",});+ }++ if (target === "managed") {+ let uri = flags?.milvusUri;+ if (uri === undefined) {+ uri = (+ await askText({+ message: "Milvus URI",+ placeholder: "https://your-cluster.api.gcp-us-west1.zillizcloud.com",+ validate: (value) =>+ value.trim().length === 0 ? "URI is required" : undefined,+ })+ ).trim();+ }+ let token = flags?.milvusToken;+ if (token === undefined) {+ token = await askPassword({+ message: "Milvus token",+ validate: (value) =>+ value.length === 0 ? "Token is required" : undefined,+ });+ }return {- host: SERVICE_DEFAULTS.milvus.host,- port: SERVICE_DEFAULTS.milvus.port,- uri: uri.trim(),+ host: flags?.milvusHost ?? SERVICE_DEFAULTS.milvus.host,+ port: flags?.milvusPort ?? SERVICE_DEFAULTS.milvus.port,+ uri,token,};}- const host = await askText({- message: "Milvus host",- placeholder: SERVICE_DEFAULTS.milvus.host,- defaultValue: SERVICE_DEFAULTS.milvus.host,- });- const port = await askText({- message: "Milvus port",- placeholder: String(SERVICE_DEFAULTS.milvus.port),- defaultValue: String(SERVICE_DEFAULTS.milvus.port),- validate: portValidator,- });- return {- host: host.trim() || SERVICE_DEFAULTS.milvus.host,- port: Number(port) || SERVICE_DEFAULTS.milvus.port,- };+ let host = flags?.milvusHost;+ if (host === undefined) {+ const raw = await askText({+ message: "Milvus host",+ placeholder: SERVICE_DEFAULTS.milvus.host,+ defaultValue: SERVICE_DEFAULTS.milvus.host,+ });+ host = raw.trim() || SERVICE_DEFAULTS.milvus.host;+ }+ let port = flags?.milvusPort;+ if (port === undefined) {+ const raw = await askText({+ message: "Milvus port",+ placeholder: String(SERVICE_DEFAULTS.milvus.port),+ defaultValue: String(SERVICE_DEFAULTS.milvus.port),+ validate: portValidator,+ });+ port = Number(raw) || SERVICE_DEFAULTS.milvus.port;+ }+ return { host, port };}-async function askMongo(): Promise<MongoConnection> {+async function askMongo(flags?: InitFlagOverrides): Promise<MongoConnection> {p.log.step("MongoDB");- const host = await askText({- message: "Mongo host",- placeholder: SERVICE_DEFAULTS.mongo.host,- defaultValue: SERVICE_DEFAULTS.mongo.host,- });- const port = await askText({- message: "Mongo port",- placeholder: String(SERVICE_DEFAULTS.mongo.port),- defaultValue: String(SERVICE_DEFAULTS.mongo.port),- validate: portValidator,- });- const username = await askText({- message: "Mongo username",- placeholder: SERVICE_DEFAULTS.mongo.username,- defaultValue: SERVICE_DEFAULTS.mongo.username,- });- const password = await askPassword({- message: "Mongo password (default is 'password')",- validate: (value) =>- value.length === 0 ? "Password is required" : undefined,- });- return {- host: host.trim() || SERVICE_DEFAULTS.mongo.host,- port: Number(port) || SERVICE_DEFAULTS.mongo.port,- username: username.trim() || SERVICE_DEFAULTS.mongo.username,- password,- };+ let host = flags?.mongoHost;+ if (host === undefined) {+ const raw = await askText({+ message: "Mongo host",+ placeholder: SERVICE_DEFAULTS.mongo.host,+ defaultValue: SERVICE_DEFAULTS.mongo.host,+ });+ host = raw.trim() || SERVICE_DEFAULTS.mongo.host;+ }+ let port = flags?.mongoPort;+ if (port === undefined) {+ const raw = await askText({+ message: "Mongo port",+ placeholder: String(SERVICE_DEFAULTS.mongo.port),+ defaultValue: String(SERVICE_DEFAULTS.mongo.port),+ validate: portValidator,+ });+ port = Number(raw) || SERVICE_DEFAULTS.mongo.port;+ }+ let username = flags?.mongoUsername;+ if (username === undefined) {+ const raw = await askText({+ message: "Mongo username",+ placeholder: SERVICE_DEFAULTS.mongo.username,+ defaultValue: SERVICE_DEFAULTS.mongo.username,+ });+ username = raw.trim() || SERVICE_DEFAULTS.mongo.username;+ }+ let password = flags?.mongoPassword;+ if (password === undefined) {+ password = await askPassword({+ message: "Mongo password (default is 'password')",+ validate: (value) =>+ value.length === 0 ? "Password is required" : undefined,+ });+ }+ return { host, port, username, password };}-export async function askConnections(dbs: DbChoices): Promise<Connections> {- const redis = await askRedis();+export async function askConnections(+ dbs: DbChoices,+ flags?: InitFlagOverrides,+): Promise<Connections> {+ const redis = await askRedis(flags);const result: Connections = { redis };const needsPostgres =@@ -210,16 +281,16 @@ export async function askConnections(dbs: DbChoices): Promise<Connections> {dbs.dataDb === "postgresql" ||dbs.graphDb === "networkx";if (needsPostgres) {- result.postgresql = await askPostgres();+ result.postgresql = await askPostgres(flags);}if (dbs.graphDb === "neo4j") {- result.neo4j = await askNeo4j();+ result.neo4j = await askNeo4j(flags);}if (dbs.vectorDb === "milvus") {- result.milvus = await askMilvus();+ result.milvus = await askMilvus(flags);}if (dbs.dataDb === "mongo") {- result.mongo = await askMongo();+ result.mongo = await askMongo(flags);}return result;diff --git a/tui/src/flows/embedding-dimensions.ts b/tui/src/flows/embedding-dimensions.tsindex 11da988..d37cae5 100644--- a/tui/src/flows/embedding-dimensions.ts+++ b/tui/src/flows/embedding-dimensions.ts@@ -53,8 +53,13 @@ export async function askEmbeddingDimensions(allowBack?: boolean;backHint?: string;initial?: EmbeddingDimensions;+ prechosenSize?: number;},): Promise<EmbeddingDimensions | PromptBack> {+ if (opts?.prechosenSize !== undefined) {+ return dimensionsFromSize(opts.prechosenSize);+ }+p.log.step("Embedding dimensions");const known = lookupEmbeddingDimensions(embeddingModel);const initialSize =@@ -132,6 +137,7 @@ export async function attachEmbeddingDimensions(allowBack?: boolean;backHint?: string;initial?: EmbeddingDimensions;+ prechosenSize?: number;},): Promise<ModelsChoices | PromptBack> {const embeddingModel = resolveActiveEmbeddingModel(models);diff --git a/tui/src/flows/models.ts b/tui/src/flows/models.tsindex 5867586..4db2259 100644--- a/tui/src/flows/models.ts+++ b/tui/src/flows/models.ts@@ -23,6 +23,7 @@ import {OPENAI_DEFAULT_LARGE_MODEL,OPENAI_DEFAULT_SMALL_MODEL,} from "../constants.js";+import type { InitFlagOverrides } from "../lib/init-flags.js";import {askPassword,askText,@@ -75,10 +76,21 @@ async function inspectGcpCredentials(filePath: string): Promise<GcpCredentialsCh}}-async function askGcp(opts: {- needLlm: boolean;- needEmbeddings: boolean;-}): Promise<GcpChoices> {+function pickModel(+ providerSpecific: string | undefined,+ generic: string | undefined,+ fallback: string,+): string {+ return providerSpecific ?? generic ?? fallback;+}++async function askGcp(+ opts: {+ needLlm: boolean;+ needEmbeddings: boolean;+ },+ flags?: InitFlagOverrides,+): Promise<GcpChoices> {p.log.step(opts.needLlm && opts.needEmbeddings? "Configure GCP Vertex"@@ -87,24 +99,36 @@ async function askGcp(opts: {: "Configure GCP Vertex LLMs",);- let credentialsPath = "";+ let credentialsPath = flags?.gcpCredentials+ ? expandHome(flags.gcpCredentials)+ : "";let projectIdFromFile: string | undefined;- while (true) {- const raw = await askText({- message: "Path to GCP service-account credentials JSON",- placeholder: "~/.config/gcloud/brainapi.json",- });- const result = await inspectGcpCredentials(raw);- if (!result.error) {- credentialsPath = expandHome(raw.trim());- projectIdFromFile = result.projectId;- break;+ if (credentialsPath) {+ const result = await inspectGcpCredentials(credentialsPath);+ if (result.error) {+ throw new Error(`--gcp-credentials: ${result.error}`);+ }+ projectIdFromFile = result.projectId;+ } else {+ while (true) {+ const raw = await askText({+ message: "Path to GCP service-account credentials JSON",+ placeholder: "~/.config/gcloud/brainapi.json",+ });+ const result = await inspectGcpCredentials(raw);+ if (!result.error) {+ credentialsPath = expandHome(raw.trim());+ projectIdFromFile = result.projectId;+ break;+ }+ p.log.error(result.error);}- p.log.error(result.error);}let projectId: string;- if (projectIdFromFile) {+ if (flags?.gcpProject) {+ projectId = flags.gcpProject;+ } else if (projectIdFromFile) {projectId = projectIdFromFile;p.log.info(`Using GCP project ${pc.cyan(projectId)} (from credentials file)`);} else {@@ -119,25 +143,37 @@ async function askGcp(opts: {projectId = entered.trim();}- let smallLlmModel = GCP_DEFAULT_SMALL_MODEL;- let largeLlmModel = GCP_DEFAULT_LARGE_MODEL;+ let smallLlmModel = pickModel(flags?.gcpSmall, flags?.llmSmall, GCP_DEFAULT_SMALL_MODEL);+ let largeLlmModel = pickModel(flags?.gcpLarge, flags?.llmLarge, GCP_DEFAULT_LARGE_MODEL);if (opts.needLlm) {- const smallModel = await askText({- message: "GCP small LLM model",- placeholder: GCP_DEFAULT_SMALL_MODEL,- defaultValue: GCP_DEFAULT_SMALL_MODEL,- });- const largeModel = await askText({- message: "GCP large LLM model",- placeholder: GCP_DEFAULT_LARGE_MODEL,- defaultValue: GCP_DEFAULT_LARGE_MODEL,- });- smallLlmModel = smallModel.trim() || GCP_DEFAULT_SMALL_MODEL;- largeLlmModel = largeModel.trim() || GCP_DEFAULT_LARGE_MODEL;+ if (flags?.gcpSmall === undefined && flags?.llmSmall === undefined) {+ const smallModel = await askText({+ message: "GCP small LLM model",+ placeholder: GCP_DEFAULT_SMALL_MODEL,+ defaultValue: GCP_DEFAULT_SMALL_MODEL,+ });+ smallLlmModel = smallModel.trim() || GCP_DEFAULT_SMALL_MODEL;+ }+ if (flags?.gcpLarge === undefined && flags?.llmLarge === undefined) {+ const largeModel = await askText({+ message: "GCP large LLM model",+ placeholder: GCP_DEFAULT_LARGE_MODEL,+ defaultValue: GCP_DEFAULT_LARGE_MODEL,+ });+ largeLlmModel = largeModel.trim() || GCP_DEFAULT_LARGE_MODEL;+ }}- let embeddingModel = GCP_DEFAULT_EMBEDDING_MODEL;- if (opts.needEmbeddings) {+ let embeddingModel = pickModel(+ flags?.gcpEmbedding,+ flags?.embeddingModel,+ GCP_DEFAULT_EMBEDDING_MODEL,+ );+ if (+ opts.needEmbeddings &&+ flags?.gcpEmbedding === undefined &&+ flags?.embeddingModel === undefined+ ) {const embedding = await askText({message: "GCP embedding model",placeholder: GCP_DEFAULT_EMBEDDING_MODEL,@@ -155,10 +191,13 @@ async function askGcp(opts: {};}-async function askAzure(opts: {- needLlm: boolean;- needEmbeddings: boolean;-}): Promise<AzureChoices> {+async function askAzure(+ opts: {+ needLlm: boolean;+ needEmbeddings: boolean;+ },+ flags?: InitFlagOverrides,+): Promise<AzureChoices> {p.log.step(opts.needLlm && opts.needEmbeddings? "Configure Azure OpenAI"@@ -167,80 +206,101 @@ async function askAzure(opts: {: "Configure Azure OpenAI LLMs",);- let llmEndpoint = "";- let llmApiVersion = AZURE_DEFAULT_LARGE_API_VERSION;- let llmSubscriptionKey = "";- let smallLlmModel = AZURE_DEFAULT_SMALL_MODEL;- let largeLlmModel = AZURE_DEFAULT_LARGE_MODEL;+ let llmEndpoint = flags?.azureEndpoint ?? "";+ let llmApiVersion = flags?.azureApiVersion ?? AZURE_DEFAULT_LARGE_API_VERSION;+ let llmSubscriptionKey = flags?.azureKey ?? "";+ let smallLlmModel = pickModel(flags?.azureSmall, flags?.llmSmall, AZURE_DEFAULT_SMALL_MODEL);+ let largeLlmModel = pickModel(flags?.azureLarge, flags?.llmLarge, AZURE_DEFAULT_LARGE_MODEL);if (opts.needLlm) {- llmEndpoint = (- await askText({- message: "Azure LLM endpoint",- placeholder: "https://yourproject.openai.azure.com",- validate: (value) =>- value.trim().length === 0 ? "Endpoint is required" : undefined,- })- ).trim();- llmApiVersion = (- await askText({- message: "Azure LLM API version",- placeholder: AZURE_DEFAULT_LARGE_API_VERSION,- defaultValue: AZURE_DEFAULT_LARGE_API_VERSION,- })- ).trim() || AZURE_DEFAULT_LARGE_API_VERSION;- llmSubscriptionKey = (- await askPassword({- message: "Azure LLM subscription key",- validate: (value) =>- value.trim().length === 0 ? "API key is required" : undefined,- })- ).trim();- smallLlmModel =- (+ if (flags?.azureEndpoint === undefined) {+ llmEndpoint = (await askText({- message: "Azure small LLM deployment/model",- placeholder: AZURE_DEFAULT_SMALL_MODEL,- defaultValue: AZURE_DEFAULT_SMALL_MODEL,+ message: "Azure LLM endpoint",+ placeholder: "https://yourproject.openai.azure.com",+ validate: (value) =>+ value.trim().length === 0 ? "Endpoint is required" : undefined,})- ).trim() || AZURE_DEFAULT_SMALL_MODEL;- largeLlmModel =- (- await askText({- message: "Azure large LLM deployment/model",- placeholder: AZURE_DEFAULT_LARGE_MODEL,- defaultValue: AZURE_DEFAULT_LARGE_MODEL,+ ).trim();+ }+ if (flags?.azureApiVersion === undefined) {+ llmApiVersion =+ (+ await askText({+ message: "Azure LLM API version",+ placeholder: AZURE_DEFAULT_LARGE_API_VERSION,+ defaultValue: AZURE_DEFAULT_LARGE_API_VERSION,+ })+ ).trim() || AZURE_DEFAULT_LARGE_API_VERSION;+ }+ if (flags?.azureKey === undefined) {+ llmSubscriptionKey = (+ await askPassword({+ message: "Azure LLM subscription key",+ validate: (value) =>+ value.trim().length === 0 ? "API key is required" : undefined,})- ).trim() || AZURE_DEFAULT_LARGE_MODEL;+ ).trim();+ }+ if (flags?.azureSmall === undefined && flags?.llmSmall === undefined) {+ smallLlmModel =+ (+ await askText({+ message: "Azure small LLM deployment/model",+ placeholder: AZURE_DEFAULT_SMALL_MODEL,+ defaultValue: AZURE_DEFAULT_SMALL_MODEL,+ })+ ).trim() || AZURE_DEFAULT_SMALL_MODEL;+ }+ if (flags?.azureLarge === undefined && flags?.llmLarge === undefined) {+ largeLlmModel =+ (+ await askText({+ message: "Azure large LLM deployment/model",+ placeholder: AZURE_DEFAULT_LARGE_MODEL,+ defaultValue: AZURE_DEFAULT_LARGE_MODEL,+ })+ ).trim() || AZURE_DEFAULT_LARGE_MODEL;+ }}- let embeddingEndpoint = "";- let embeddingKey = "";- let embeddingModel = AZURE_DEFAULT_EMBEDDING_MODEL;+ let embeddingEndpoint = flags?.azureEmbeddingEndpoint ?? "";+ let embeddingKey = flags?.azureEmbeddingKey ?? "";+ let embeddingModel = pickModel(+ flags?.azureEmbedding,+ flags?.embeddingModel,+ AZURE_DEFAULT_EMBEDDING_MODEL,+ );if (opts.needEmbeddings) {- embeddingEndpoint = (- await askText({- message: "Azure embeddings endpoint URL",- placeholder:- "https://yourproject.openai.azure.com/openai/deployments/text-embedding-3-large/embeddings?api-version=2023-05-15",- validate: (value) =>- value.trim().length === 0 ? "Endpoint URL is required" : undefined,- })- ).trim();- embeddingKey = (- await askPassword({- message: "Azure embeddings API key",- validate: (value) =>- value.trim().length === 0 ? "API key is required" : undefined,- })- ).trim();- embeddingModel =- (+ if (flags?.azureEmbeddingEndpoint === undefined) {+ embeddingEndpoint = (await askText({- message: "Azure embedding model/deployment",- placeholder: AZURE_DEFAULT_EMBEDDING_MODEL,- defaultValue: AZURE_DEFAULT_EMBEDDING_MODEL,+ message: "Azure embeddings endpoint URL",+ placeholder:+ "https://yourproject.openai.azure.com/openai/deployments/text-embedding-3-large/embeddings?api-version=2023-05-15",+ validate: (value) =>+ value.trim().length === 0 ? "Endpoint URL is required" : undefined,+ })+ ).trim();+ }+ if (flags?.azureEmbeddingKey === undefined) {+ embeddingKey = (+ await askPassword({+ message: "Azure embeddings API key",+ validate: (value) =>+ value.trim().length === 0 ? "API key is required" : undefined,})- ).trim() || AZURE_DEFAULT_EMBEDDING_MODEL;+ ).trim();+ }+ if (flags?.azureEmbedding === undefined && flags?.embeddingModel === undefined) {+ embeddingModel =+ (+ await askText({+ message: "Azure embedding model/deployment",+ placeholder: AZURE_DEFAULT_EMBEDDING_MODEL,+ defaultValue: AZURE_DEFAULT_EMBEDDING_MODEL,+ })+ ).trim() || AZURE_DEFAULT_EMBEDDING_MODEL;+ }}return {@@ -255,10 +315,13 @@ async function askAzure(opts: {};}-async function askBedrock(opts: {- needLlm: boolean;- needEmbeddings: boolean;-}): Promise<BedrockChoices> {+async function askBedrock(+ opts: {+ needLlm: boolean;+ needEmbeddings: boolean;+ },+ flags?: InitFlagOverrides,+): Promise<BedrockChoices> {p.log.step(opts.needLlm && opts.needEmbeddings? "Configure Amazon Bedrock"@@ -266,49 +329,91 @@ async function askBedrock(opts: {? "Configure Amazon Bedrock embeddings": "Configure Amazon Bedrock LLMs",);- const region = await askText({- message: "AWS region",- placeholder: BEDROCK_DEFAULT_REGION,- defaultValue: BEDROCK_DEFAULT_REGION,- });- const accessKeyId = await askText({- message: "AWS access key id",- validate: (value) =>- value.trim().length === 0 ? "Access key id is required" : undefined,- });- const secretAccessKey = await askPassword({- message: "AWS secret access key",- validate: (value) =>- value.trim().length === 0 ? "Secret access key is required" : undefined,- });- const sessionToken = await askPassword({- message: "AWS session token (optional)",- validate: () => undefined,- });- let smallLlmModel = BEDROCK_DEFAULT_SMALL_MODEL;- let largeLlmModel = BEDROCK_DEFAULT_LARGE_MODEL;+ let region = flags?.awsRegion ?? BEDROCK_DEFAULT_REGION;+ if (flags?.awsRegion === undefined) {+ const raw = await askText({+ message: "AWS region",+ placeholder: BEDROCK_DEFAULT_REGION,+ defaultValue: BEDROCK_DEFAULT_REGION,+ });+ region = raw.trim() || BEDROCK_DEFAULT_REGION;+ }++ let accessKeyId = flags?.awsAccessKeyId ?? "";+ if (flags?.awsAccessKeyId === undefined) {+ accessKeyId = (+ await askText({+ message: "AWS access key id",+ validate: (value) =>+ value.trim().length === 0 ? "Access key id is required" : undefined,+ })+ ).trim();+ }++ let secretAccessKey = flags?.awsSecretAccessKey ?? "";+ if (flags?.awsSecretAccessKey === undefined) {+ secretAccessKey = (+ await askPassword({+ message: "AWS secret access key",+ validate: (value) =>+ value.trim().length === 0 ? "Secret access key is required" : undefined,+ })+ ).trim();+ }++ let sessionToken = flags?.awsSessionToken;+ if (flags?.awsSessionToken === undefined) {+ const raw = await askPassword({+ message: "AWS session token (optional)",+ validate: () => undefined,+ });+ sessionToken = raw.trim() || undefined;+ }++ let smallLlmModel = pickModel(+ flags?.bedrockSmall,+ flags?.llmSmall,+ BEDROCK_DEFAULT_SMALL_MODEL,+ );+ let largeLlmModel = pickModel(+ flags?.bedrockLarge,+ flags?.llmLarge,+ BEDROCK_DEFAULT_LARGE_MODEL,+ );if (opts.needLlm) {- smallLlmModel =- (- await askText({- message: "Bedrock small LLM model id",- placeholder: BEDROCK_DEFAULT_SMALL_MODEL,- defaultValue: BEDROCK_DEFAULT_SMALL_MODEL,- })- ).trim() || BEDROCK_DEFAULT_SMALL_MODEL;- largeLlmModel =- (- await askText({- message: "Bedrock large LLM model id",- placeholder: BEDROCK_DEFAULT_LARGE_MODEL,- defaultValue: BEDROCK_DEFAULT_LARGE_MODEL,- })- ).trim() || BEDROCK_DEFAULT_LARGE_MODEL;+ if (flags?.bedrockSmall === undefined && flags?.llmSmall === undefined) {+ smallLlmModel =+ (+ await askText({+ message: "Bedrock small LLM model id",+ placeholder: BEDROCK_DEFAULT_SMALL_MODEL,+ defaultValue: BEDROCK_DEFAULT_SMALL_MODEL,+ })+ ).trim() || BEDROCK_DEFAULT_SMALL_MODEL;+ }+ if (flags?.bedrockLarge === undefined && flags?.llmLarge === undefined) {+ largeLlmModel =+ (+ await askText({+ message: "Bedrock large LLM model id",+ placeholder: BEDROCK_DEFAULT_LARGE_MODEL,+ defaultValue: BEDROCK_DEFAULT_LARGE_MODEL,+ })+ ).trim() || BEDROCK_DEFAULT_LARGE_MODEL;+ }}- let embeddingModel = BEDROCK_DEFAULT_EMBEDDING_MODEL;- if (opts.needEmbeddings) {+ let embeddingModel = pickModel(+ flags?.bedrockEmbedding,+ flags?.embeddingModel,+ BEDROCK_DEFAULT_EMBEDDING_MODEL,+ );+ if (+ opts.needEmbeddings &&+ flags?.bedrockEmbedding === undefined &&+ flags?.embeddingModel === undefined+ ) {embeddingModel =(await askText({@@ -320,20 +425,23 @@ async function askBedrock(opts: {}return {- region: region.trim() || BEDROCK_DEFAULT_REGION,- accessKeyId: accessKeyId.trim(),- secretAccessKey: secretAccessKey.trim(),- sessionToken: sessionToken.trim() || undefined,+ region,+ accessKeyId,+ secretAccessKey,+ sessionToken,smallLlmModel,largeLlmModel,embeddingModel,};}-async function askOpenAI(opts: {- needLlm: boolean;- needEmbeddings: boolean;-}): Promise<OpenAIChoices> {+async function askOpenAI(+ opts: {+ needLlm: boolean;+ needEmbeddings: boolean;+ },+ flags?: InitFlagOverrides,+): Promise<OpenAIChoices> {p.log.step(opts.needLlm && opts.needEmbeddings? "Configure OpenAI"@@ -342,36 +450,66 @@ async function askOpenAI(opts: {: "Configure OpenAI LLMs",);- const apiKey = await askPassword({- message: "OpenAI API key",- validate: (value) =>- value.trim().length === 0 ? "API key is required" : undefined,- });- const baseUrl = await askText({- message: "OpenAI base URL (optional)",- placeholder: "https://api.openai.com/v1",- defaultValue: "",- });+ let apiKey = flags?.openaiApiKey ?? "";+ if (flags?.openaiApiKey === undefined) {+ apiKey = (+ await askPassword({+ message: "OpenAI API key",+ validate: (value) =>+ value.trim().length === 0 ? "API key is required" : undefined,+ })+ ).trim();+ }- let smallLlmModel = OPENAI_DEFAULT_SMALL_MODEL;- let largeLlmModel = OPENAI_DEFAULT_LARGE_MODEL;- if (opts.needLlm) {- const small = await askText({- message: "OpenAI small LLM model",- placeholder: OPENAI_DEFAULT_SMALL_MODEL,- defaultValue: OPENAI_DEFAULT_SMALL_MODEL,- });- const large = await askText({- message: "OpenAI large LLM model",- placeholder: OPENAI_DEFAULT_LARGE_MODEL,- defaultValue: OPENAI_DEFAULT_LARGE_MODEL,+ let baseUrl = flags?.openaiBaseUrl;+ if (flags?.openaiBaseUrl === undefined) {+ const raw = await askText({+ message: "OpenAI base URL (optional)",+ placeholder: "https://api.openai.com/v1",+ defaultValue: "",});- smallLlmModel = small.trim() || OPENAI_DEFAULT_SMALL_MODEL;- largeLlmModel = large.trim() || OPENAI_DEFAULT_LARGE_MODEL;+ baseUrl = raw.trim() || undefined;}- let embeddingModel = OPENAI_DEFAULT_EMBEDDING_MODEL;- if (opts.needEmbeddings) {+ let smallLlmModel = pickModel(+ flags?.openaiSmall,+ flags?.llmSmall,+ OPENAI_DEFAULT_SMALL_MODEL,+ );+ let largeLlmModel = pickModel(+ flags?.openaiLarge,+ flags?.llmLarge,+ OPENAI_DEFAULT_LARGE_MODEL,+ );+ if (opts.needLlm) {+ if (flags?.openaiSmall === undefined && flags?.llmSmall === undefined) {+ const small = await askText({+ message: "OpenAI small LLM model",+ placeholder: OPENAI_DEFAULT_SMALL_MODEL,+ defaultValue: OPENAI_DEFAULT_SMALL_MODEL,+ });+ smallLlmModel = small.trim() || OPENAI_DEFAULT_SMALL_MODEL;+ }+ if (flags?.openaiLarge === undefined && flags?.llmLarge === undefined) {+ const large = await askText({+ message: "OpenAI large LLM model",+ placeholder: OPENAI_DEFAULT_LARGE_MODEL,+ defaultValue: OPENAI_DEFAULT_LARGE_MODEL,+ });+ largeLlmModel = large.trim() || OPENAI_DEFAULT_LARGE_MODEL;+ }+ }++ let embeddingModel = pickModel(+ flags?.openaiEmbedding,+ flags?.embeddingModel,+ OPENAI_DEFAULT_EMBEDDING_MODEL,+ );+ if (+ opts.needEmbeddings &&+ flags?.openaiEmbedding === undefined &&+ flags?.embeddingModel === undefined+ ) {const embedding = await askText({message: "OpenAI embedding model",placeholder: OPENAI_DEFAULT_EMBEDDING_MODEL,@@ -381,63 +519,100 @@ async function askOpenAI(opts: {}return {- apiKey: apiKey.trim(),- baseUrl: baseUrl.trim() || undefined,+ apiKey,+ baseUrl,smallLlmModel,largeLlmModel,embeddingModel,};}-async function askAnthropic(): Promise<AnthropicChoices> {+async function askAnthropic(flags?: InitFlagOverrides): Promise<AnthropicChoices> {p.log.step("Configure Anthropic");- const apiKey = await askPassword({- message: "Anthropic API key",- validate: (value) =>- value.trim().length === 0 ? "API key is required" : undefined,- });- const smallLlmModel = await askText({- message: "Anthropic small LLM model",- placeholder: ANTHROPIC_DEFAULT_SMALL_MODEL,- defaultValue: ANTHROPIC_DEFAULT_SMALL_MODEL,- });- const largeLlmModel = await askText({- message: "Anthropic large LLM model",- placeholder: ANTHROPIC_DEFAULT_LARGE_MODEL,- defaultValue: ANTHROPIC_DEFAULT_LARGE_MODEL,- });- return {- apiKey: apiKey.trim(),- smallLlmModel: smallLlmModel.trim() || ANTHROPIC_DEFAULT_SMALL_MODEL,- largeLlmModel: largeLlmModel.trim() || ANTHROPIC_DEFAULT_LARGE_MODEL,- };+ let apiKey = flags?.anthropicApiKey ?? "";+ if (flags?.anthropicApiKey === undefined) {+ apiKey = (+ await askPassword({+ message: "Anthropic API key",+ validate: (value) =>+ value.trim().length === 0 ? "API key is required" : undefined,+ })+ ).trim();+ }+ let smallLlmModel = pickModel(+ flags?.anthropicSmall,+ flags?.llmSmall,+ ANTHROPIC_DEFAULT_SMALL_MODEL,+ );+ let largeLlmModel = pickModel(+ flags?.anthropicLarge,+ flags?.llmLarge,+ ANTHROPIC_DEFAULT_LARGE_MODEL,+ );+ if (flags?.anthropicSmall === undefined && flags?.llmSmall === undefined) {+ const raw = await askText({+ message: "Anthropic small LLM model",+ placeholder: ANTHROPIC_DEFAULT_SMALL_MODEL,+ defaultValue: ANTHROPIC_DEFAULT_SMALL_MODEL,+ });+ smallLlmModel = raw.trim() || ANTHROPIC_DEFAULT_SMALL_MODEL;+ }+ if (flags?.anthropicLarge === undefined && flags?.llmLarge === undefined) {+ const raw = await askText({+ message: "Anthropic large LLM model",+ placeholder: ANTHROPIC_DEFAULT_LARGE_MODEL,+ defaultValue: ANTHROPIC_DEFAULT_LARGE_MODEL,+ });+ largeLlmModel = raw.trim() || ANTHROPIC_DEFAULT_LARGE_MODEL;+ }+ return { apiKey, smallLlmModel, largeLlmModel };}-async function askDeepSeek(): Promise<DeepSeekChoices> {+async function askDeepSeek(flags?: InitFlagOverrides): Promise<DeepSeekChoices> {p.log.step("Configure DeepSeek");- const apiKey = await askPassword({- message: "DeepSeek API key",- validate: (value) =>- value.trim().length === 0 ? "API key is required" : undefined,- });- const smallLlmModel = await askText({- message: "DeepSeek small LLM model",- placeholder: DEEPSEEK_DEFAULT_SMALL_MODEL,- defaultValue: DEEPSEEK_DEFAULT_SMALL_MODEL,- });- const largeLlmModel = await askText({- message: "DeepSeek large LLM model",- placeholder: DEEPSEEK_DEFAULT_LARGE_MODEL,- defaultValue: DEEPSEEK_DEFAULT_LARGE_MODEL,- });- return {- apiKey: apiKey.trim(),- smallLlmModel: smallLlmModel.trim() || DEEPSEEK_DEFAULT_SMALL_MODEL,- largeLlmModel: largeLlmModel.trim() || DEEPSEEK_DEFAULT_LARGE_MODEL,- };+ let apiKey = flags?.deepseekApiKey ?? "";+ if (flags?.deepseekApiKey === undefined) {+ apiKey = (+ await askPassword({+ message: "DeepSeek API key",+ validate: (value) =>+ value.trim().length === 0 ? "API key is required" : undefined,+ })+ ).trim();+ }+ let smallLlmModel = pickModel(+ flags?.deepseekSmall,+ flags?.llmSmall,+ DEEPSEEK_DEFAULT_SMALL_MODEL,+ );+ let largeLlmModel = pickModel(+ flags?.deepseekLarge,+ flags?.llmLarge,+ DEEPSEEK_DEFAULT_LARGE_MODEL,+ );+ if (flags?.deepseekSmall === undefined && flags?.llmSmall === undefined) {+ const raw = await askText({+ message: "DeepSeek small LLM model",+ placeholder: DEEPSEEK_DEFAULT_SMALL_MODEL,+ defaultValue: DEEPSEEK_DEFAULT_SMALL_MODEL,+ });+ smallLlmModel = raw.trim() || DEEPSEEK_DEFAULT_SMALL_MODEL;+ }+ if (flags?.deepseekLarge === undefined && flags?.llmLarge === undefined) {+ const raw = await askText({+ message: "DeepSeek large LLM model",+ placeholder: DEEPSEEK_DEFAULT_LARGE_MODEL,+ defaultValue: DEEPSEEK_DEFAULT_LARGE_MODEL,+ });+ largeLlmModel = raw.trim() || DEEPSEEK_DEFAULT_LARGE_MODEL;+ }+ return { apiKey, smallLlmModel, largeLlmModel };}-async function askLlmProvider(message: string, initialValue: ModelProvider): Promise<ModelProvider> {+async function askLlmProvider(+ message: string,+ initialValue: ModelProvider,+): Promise<ModelProvider> {return pickOne<ModelProvider>({message,options: [@@ -474,20 +649,24 @@ export async function askModels(options?: {prechosenMode?: ModelsMode;allowBack?: false;initialMode?: ModelsMode;+ flags?: InitFlagOverrides;}): Promise<ModelsChoices>;export async function askModels(options: {prechosenMode?: ModelsMode;allowBack: true;backHint?: string;initialMode?: ModelsMode;+ flags?: InitFlagOverrides;}): Promise<ModelsChoices | PromptBack>;export async function askModels(options?: {prechosenMode?: ModelsMode;allowBack?: boolean;backHint?: string;initialMode?: ModelsMode;+ flags?: InitFlagOverrides;}): Promise<ModelsChoices | PromptBack> {- let mode = options?.prechosenMode;+ const flags = options?.flags;+ let mode = options?.prechosenMode ?? flags?.modelsMode;if (!mode) {const picked = options?.allowBack? await pickOne<ModelsMode>({@@ -515,7 +694,7 @@ export async function askModels(options?: {}if (mode === "local") {- const ollama = await askOllama();+ const ollama = await askOllama(flags);return attachEmbeddingDimensions({mode,@@ -527,13 +706,20 @@ export async function askModels(options?: {{allowBack: options?.allowBack,backHint: options?.backHint,+ prechosenSize: flags?.embeddingDimensions,},);}- const llmSmallProvider = await askLlmProvider("Small LLM provider", "gcp_vertex");- const llmLargeProvider = await askLlmProvider("Large LLM provider", "azure");- const embeddingsProvider = await askEmbeddingsProvider("Embeddings provider", "azure");+ const llmSmallProvider =+ flags?.llmSmallProvider ??+ (await askLlmProvider("Small LLM provider", "gcp_vertex"));+ const llmLargeProvider =+ flags?.llmLargeProvider ??+ (await askLlmProvider("Large LLM provider", "azure"));+ const embeddingsProvider =+ flags?.embeddingsProvider ??+ (await askEmbeddingsProvider("Embeddings provider", "azure"));const providers = new Set([llmSmallProvider, llmLargeProvider, embeddingsProvider]);@@ -546,40 +732,52 @@ export async function askModels(options?: {let bedrock = undefined;if (providers.has("ollama")) {- ollama = await askOllama();+ ollama = await askOllama(flags);}if (providers.has("gcp_vertex")) {- gcp = await askGcp({- needLlm:- llmSmallProvider === "gcp_vertex" || llmLargeProvider === "gcp_vertex",- needEmbeddings: embeddingsProvider === "gcp_vertex",- });+ gcp = await askGcp(+ {+ needLlm:+ llmSmallProvider === "gcp_vertex" || llmLargeProvider === "gcp_vertex",+ needEmbeddings: embeddingsProvider === "gcp_vertex",+ },+ flags,+ );}if (providers.has("azure")) {- azure = await askAzure({- needLlm: llmSmallProvider === "azure" || llmLargeProvider === "azure",- needEmbeddings: embeddingsProvider === "azure",- });+ azure = await askAzure(+ {+ needLlm: llmSmallProvider === "azure" || llmLargeProvider === "azure",+ needEmbeddings: embeddingsProvider === "azure",+ },+ flags,+ );}if (providers.has("openai")) {- openai = await askOpenAI({- needLlm: llmSmallProvider === "openai" || llmLargeProvider === "openai",- needEmbeddings: embeddingsProvider === "openai",- });+ openai = await askOpenAI(+ {+ needLlm: llmSmallProvider === "openai" || llmLargeProvider === "openai",+ needEmbeddings: embeddingsProvider === "openai",+ },+ flags,+ );}if (providers.has("anthropic")) {- anthropic = await askAnthropic();+ anthropic = await askAnthropic(flags);}if (providers.has("deepseek")) {- deepseek = await askDeepSeek();+ deepseek = await askDeepSeek(flags);}if (providers.has("amazon_bedrock")) {- bedrock = await askBedrock({- needLlm:- llmSmallProvider === "amazon_bedrock" ||- llmLargeProvider === "amazon_bedrock",- needEmbeddings: embeddingsProvider === "amazon_bedrock",- });+ bedrock = await askBedrock(+ {+ needLlm:+ llmSmallProvider === "amazon_bedrock" ||+ llmLargeProvider === "amazon_bedrock",+ needEmbeddings: embeddingsProvider === "amazon_bedrock",+ },+ flags,+ );}return attachEmbeddingDimensions(@@ -599,6 +797,7 @@ export async function askModels(options?: {{allowBack: options?.allowBack,backHint: options?.backHint,+ prechosenSize: flags?.embeddingDimensions,},);}diff --git a/tui/src/flows/ollama.ts b/tui/src/flows/ollama.tsindex 2019ca9..e4a07f2 100644--- a/tui/src/flows/ollama.ts+++ b/tui/src/flows/ollama.ts@@ -8,6 +8,7 @@ import {OLLAMA_DEFAULT_SMALL_MODEL,EMBEDDINGS_DEFAULTS,} from "../constants.js";+import type { InitFlagOverrides } from "../lib/init-flags.js";import {hasOllamaModel,isOllamaRunning,@@ -106,54 +107,80 @@ async function askEmbeddingsLocal(defaultModel: string): Promise<string> {return raw.trim() || defaultModel;}-export async function askOllama(): Promise<OllamaChoices> {+export async function askOllama(+ flags?: InitFlagOverrides,+): Promise<OllamaChoices> {p.log.step("Configure Ollama");- const hostRaw = await askText({- message: "Ollama host",- placeholder: OLLAMA_DEFAULT_HOST,- defaultValue: OLLAMA_DEFAULT_HOST,- });- const portRaw = await askText({- message: "Ollama port",- placeholder: String(OLLAMA_DEFAULT_PORT),- defaultValue: String(OLLAMA_DEFAULT_PORT),- validate: (value) => {- const n = Number(value);- if (!Number.isInteger(n) || n <= 0 || n > 65535) return "Port must be 1-65535";- return undefined;- },- });- const target: OllamaTarget = {- host: hostRaw.trim() || OLLAMA_DEFAULT_HOST,- port: Number(portRaw) || OLLAMA_DEFAULT_PORT,- };+ let host = flags?.ollamaHost;+ if (host === undefined) {+ const hostRaw = await askText({+ message: "Ollama host",+ placeholder: OLLAMA_DEFAULT_HOST,+ defaultValue: OLLAMA_DEFAULT_HOST,+ });+ host = hostRaw.trim() || OLLAMA_DEFAULT_HOST;+ }++ let port = flags?.ollamaPort;+ if (port === undefined) {+ const portRaw = await askText({+ message: "Ollama port",+ placeholder: String(OLLAMA_DEFAULT_PORT),+ defaultValue: String(OLLAMA_DEFAULT_PORT),+ validate: (value) => {+ const n = Number(value);+ if (!Number.isInteger(n) || n <= 0 || n > 65535) return "Port must be 1-65535";+ return undefined;+ },+ });+ port = Number(portRaw) || OLLAMA_DEFAULT_PORT;+ }++ const target: OllamaTarget = { host, port };await waitForRunning(target);- const smallModelRaw = await askText({- message: "Small LLM model name (Ollama tag)",- placeholder: OLLAMA_DEFAULT_SMALL_MODEL,- defaultValue: OLLAMA_DEFAULT_SMALL_MODEL,- });- const smallModel = await waitForModel(- target,- smallModelRaw.trim() || OLLAMA_DEFAULT_SMALL_MODEL,- "small",- );-- const largeModelRaw = await askText({- message: "Large LLM model name (Ollama tag)",- placeholder: OLLAMA_DEFAULT_LARGE_MODEL,- defaultValue: OLLAMA_DEFAULT_LARGE_MODEL,- });- const largeModel = await waitForModel(- target,- largeModelRaw.trim() || OLLAMA_DEFAULT_LARGE_MODEL,- "large",- );+ let smallModel =+ flags?.ollamaSmall ?? flags?.llmSmall ?? OLLAMA_DEFAULT_SMALL_MODEL;+ if (+ flags?.ollamaSmall === undefined &&+ flags?.llmSmall === undefined+ ) {+ const smallModelRaw = await askText({+ message: "Small LLM model name (Ollama tag)",+ placeholder: OLLAMA_DEFAULT_SMALL_MODEL,+ defaultValue: OLLAMA_DEFAULT_SMALL_MODEL,+ });+ smallModel = smallModelRaw.trim() || OLLAMA_DEFAULT_SMALL_MODEL;+ }+ smallModel = await waitForModel(target, smallModel, "small");- const embeddingsLocalModel = await askEmbeddingsLocal(EMBEDDINGS_DEFAULTS.localModel);+ let largeModel =+ flags?.ollamaLarge ?? flags?.llmLarge ?? OLLAMA_DEFAULT_LARGE_MODEL;+ if (+ flags?.ollamaLarge === undefined &&+ flags?.llmLarge === undefined+ ) {+ const largeModelRaw = await askText({+ message: "Large LLM model name (Ollama tag)",+ placeholder: OLLAMA_DEFAULT_LARGE_MODEL,+ defaultValue: OLLAMA_DEFAULT_LARGE_MODEL,+ });+ largeModel = largeModelRaw.trim() || OLLAMA_DEFAULT_LARGE_MODEL;+ }+ largeModel = await waitForModel(target, largeModel, "large");++ let embeddingsLocalModel =+ flags?.ollamaEmbeddings ??+ flags?.embeddingModel ??+ EMBEDDINGS_DEFAULTS.localModel;+ if (+ flags?.ollamaEmbeddings === undefined &&+ flags?.embeddingModel === undefined+ ) {+ embeddingsLocalModel = await askEmbeddingsLocal(EMBEDDINGS_DEFAULTS.localModel);+ }return {host: target.host,diff --git a/tui/src/flows/plugins.ts b/tui/src/flows/plugins.tsindex 089e706..a1aaf91 100644--- a/tui/src/flows/plugins.ts+++ b/tui/src/flows/plugins.ts@@ -7,6 +7,9 @@ interface AskPluginsOptions {allowBack?: boolean;backHint?: string;initial?: PluginChoice[];+ /** When set, skip the interactive plugin search UI. */+ prechosen?: PluginChoice[];+ skip?: boolean;}function pluginLabel(plugin: {@@ -22,6 +25,10 @@ function pluginLabel(plugin: {export async function askPlugins(opts: AskPluginsOptions = {},): Promise<PluginChoice[] | typeof PROMPT_BACK> {+ if (opts.skip || opts.prechosen !== undefined) {+ return opts.prechosen ?? [];+ }+const selections = new Map<string, PluginChoice>();for (const plugin of opts.initial ?? []) {selections.set(`${plugin.source}:${plugin.name}:${plugin.path ?? ""}`, plugin);diff --git a/tui/src/flows/services-runtime.ts b/tui/src/flows/services-runtime.tsindex 67c4247..356096b 100644--- a/tui/src/flows/services-runtime.ts+++ b/tui/src/flows/services-runtime.ts@@ -20,7 +20,11 @@ function nonRedisPicked(dbs: DbChoices): string[] {export async function askServicesRuntime(dbs: DbChoices,- opts?: { allowBack?: false; initialValue?: ServicesRuntime },+ opts?: {+ allowBack?: false;+ initialValue?: ServicesRuntime;+ prechosen?: ServicesRuntime;+ },): Promise<ServicesRuntime>;export async function askServicesRuntime(dbs: DbChoices,@@ -28,6 +32,7 @@ export async function askServicesRuntime(allowBack: true;backHint?: string;initialValue?: ServicesRuntime;+ prechosen?: ServicesRuntime;},): Promise<ServicesRuntime | PromptBack>;export async function askServicesRuntime(@@ -36,8 +41,13 @@ export async function askServicesRuntime(allowBack?: boolean;backHint?: string;initialValue?: ServicesRuntime;+ prechosen?: ServicesRuntime;},): Promise<ServicesRuntime | PromptBack> {+ if (opts?.prechosen) {+ return opts.prechosen;+ }+const sidecars = ["Redis", ...nonRedisPicked(dbs)];p.note([diff --git a/tui/src/flows/services.ts b/tui/src/flows/services.tsindex b9ec497..f6b6c91 100644--- a/tui/src/flows/services.ts+++ b/tui/src/flows/services.ts@@ -1,30 +1,37 @@import * as p from "@clack/prompts";import { isPromptBack, pickOne, type PromptBack } from "../lib/prompts.js";-import type { DbChoices } from "../types.js";+import type { DbChoices, VectorDb, DataDb, GraphDb } from "../types.js";export async function askDatabases(opts?: {allowBack?: false;initial?: Partial<DbChoices>;+ prechosen?: Partial<DbChoices>;}): Promise<DbChoices>;export async function askDatabases(opts: {allowBack: true;backHint?: string;initial?: Partial<DbChoices>;+ prechosen?: Partial<DbChoices>;}): Promise<DbChoices | PromptBack>;export async function askDatabases(opts?: {allowBack?: boolean;backHint?: string;initial?: Partial<DbChoices>;+ prechosen?: Partial<DbChoices>;}): Promise<DbChoices | PromptBack> {p.log.step("Pick your databases");- let vectorDb = opts?.initial?.vectorDb ?? "postgresql";- let dataDb = opts?.initial?.dataDb ?? "postgresql";- let graphDb = opts?.initial?.graphDb ?? "networkx";+ let vectorDb: VectorDb = opts?.prechosen?.vectorDb ?? opts?.initial?.vectorDb ?? "postgresql";+ let dataDb: DataDb = opts?.prechosen?.dataDb ?? opts?.initial?.dataDb ?? "postgresql";+ let graphDb: GraphDb = opts?.prechosen?.graphDb ?? opts?.initial?.graphDb ?? "networkx";let step = 0;while (step < 3) {if (step === 0) {+ if (opts?.prechosen?.vectorDb) {+ step = 1;+ continue;+ }const picked = opts?.allowBack? await pickOne<"postgresql" | "milvus">({message: "Vector database",@@ -50,6 +57,10 @@ export async function askDatabases(opts?: {continue;}if (step === 1) {+ if (opts?.prechosen?.dataDb) {+ step = 2;+ continue;+ }const picked = await pickOne<"postgresql" | "mongo">({message: "Data database (text chunks, observations, structured data)",options: [@@ -68,6 +79,9 @@ export async function askDatabases(opts?: {step = 2;continue;}+ if (opts?.prechosen?.graphDb) {+ return { vectorDb, dataDb, graphDb };+ }const picked = await pickOne<"networkx" | "neo4j">({message: "Graph database",options: [diff --git a/tui/src/flows/setup-wizard.ts b/tui/src/flows/setup-wizard.tsindex b3e6690..e54993d 100644--- a/tui/src/flows/setup-wizard.ts+++ b/tui/src/flows/setup-wizard.ts@@ -8,6 +8,10 @@ import { askAuth } from "./auth.js";import { askServicesRuntime } from "./services-runtime.js";import { askPlugins } from "./plugins.js";import { isPromptBack } from "../lib/prompts.js";+import {+ hasConfigOverrides,+ type InitFlagOverrides,+} from "../lib/init-flags.js";import type {AuthChoices,Connections,@@ -34,6 +38,7 @@ export interface RunSetupWizardOptions {firstStepBack?: "return" | "cancel";stepBackHint?: string;firstStepBackHint?: string;+ flags?: InitFlagOverrides;}export function toInitChoices(draft: SetupDraft): InitChoices {@@ -49,16 +54,78 @@ export function toInitChoices(draft: SetupDraft): InitChoices {};}+function seedDraftFromFlags(+ draft: SetupDraft,+ flags: InitFlagOverrides | undefined,+): void {+ if (!flags) return;++ if (flags.defaults) {+ draft.usedDefaults = true;+ draft.dbs = { ...DEFAULT_DBS };+ draft.pipeline = { ocrMode: flags.ocrMode ?? "docparser" };+ }++ if (+ flags.vectorDb !== undefined ||+ flags.dataDb !== undefined ||+ flags.graphDb !== undefined+ ) {+ draft.dbs = {+ vectorDb: flags.vectorDb ?? draft.dbs?.vectorDb ?? DEFAULT_DBS.vectorDb,+ dataDb: flags.dataDb ?? draft.dbs?.dataDb ?? DEFAULT_DBS.dataDb,+ graphDb: flags.graphDb ?? draft.dbs?.graphDb ?? DEFAULT_DBS.graphDb,+ };+ }++ if (flags.ocrMode) {+ draft.pipeline = { ocrMode: flags.ocrMode };+ }++ if (flags.servicesRuntime) {+ draft.servicesRuntime = flags.servicesRuntime;+ }++ if (flags.brainpatToken) {+ draft.auth = { brainpatToken: flags.brainpatToken };+ }++ if (flags.noPlugins) {+ draft.plugins = [];+ } else if (flags.plugins) {+ draft.plugins = flags.plugins;+ }+}+export async function runSetupWizard(draft: SetupDraft,opts: RunSetupWizardOptions = {},): Promise<boolean> {+ const flags = opts.flags;+ seedDraftFromFlags(draft, flags);+const stepBackHint = opts.stepBackHint ?? "Previous step";const firstStepBackHint = opts.firstStepBackHint ?? stepBackHint;let step = 0;+ const skipUseDefaults =+ Boolean(flags?.defaults) || (flags !== undefined && hasConfigOverrides(flags));+while (step >= 0) {if (step === 0) {+ if (skipUseDefaults) {+ if (flags?.defaults) {+ draft.usedDefaults = true;+ draft.dbs = draft.dbs ?? { ...DEFAULT_DBS };+ draft.pipeline = draft.pipeline ?? { ocrMode: "docparser" };+ step = 2;+ continue;+ }+ draft.usedDefaults = false;+ step = 1;+ continue;+ }+const useDefaults = await askUseDefaults({allowBack: true,backHint: firstStepBackHint,@@ -82,10 +149,25 @@ export async function runSetupWizard(}if (step === 1) {+ const allDbsPrechosen =+ flags?.vectorDb !== undefined &&+ flags?.dataDb !== undefined &&+ flags?.graphDb !== undefined;+ if (allDbsPrechosen && draft.dbs) {+ step = 2;+ continue;+ }const dbs = await askDatabases({allowBack: true,backHint: stepBackHint,initial: draft.dbs,+ prechosen: flags+ ? {+ vectorDb: flags.vectorDb,+ dataDb: flags.dataDb,+ graphDb: flags.graphDb,+ }+ : undefined,});if (isPromptBack(dbs)) {step = 0;@@ -101,10 +183,16 @@ export async function runSetupWizard(step = 1;continue;}+ if (flags?.servicesRuntime) {+ draft.servicesRuntime = flags.servicesRuntime;+ step = 3;+ continue;+ }const runtime = await askServicesRuntime(draft.dbs, {allowBack: true,backHint: stepBackHint,initialValue: draft.servicesRuntime,+ prechosen: flags?.servicesRuntime,});if (isPromptBack(runtime)) {step = draft.usedDefaults ? 0 : 1;@@ -118,13 +206,16 @@ export async function runSetupWizard(if (step === 3) {const models = draft.usedDefaults? await askModels({- prechosenMode: "remote",+ prechosenMode: flags?.modelsMode ?? "remote",initialMode: draft.models?.mode,+ flags,}): await askModels({allowBack: true,backHint: stepBackHint,initialMode: draft.models?.mode,+ prechosenMode: flags?.modelsMode,+ flags,});if (isPromptBack(models)) {step = 2;@@ -140,6 +231,7 @@ export async function runSetupWizard(allowBack: true,backHint: stepBackHint,initialOcrMode: draft.pipeline?.ocrMode,+ prechosenOcrMode: flags?.ocrMode,});if (isPromptBack(pipeline)) {step = 3;@@ -155,15 +247,21 @@ export async function runSetupWizard(step = draft.usedDefaults ? 0 : 1;continue;}- draft.connections = await askConnections(draft.dbs);+ draft.connections = await askConnections(draft.dbs, flags);step = 6;continue;}if (step === 6) {+ if (flags?.brainpatToken) {+ draft.auth = { brainpatToken: flags.brainpatToken };+ step = 7;+ continue;+ }const auth = await askAuth({allowBack: true,backHint: stepBackHint,+ prechosenToken: flags?.brainpatToken,});if (isPromptBack(auth)) {step = 5;@@ -175,10 +273,16 @@ export async function runSetupWizard(}if (step === 7) {+ if (flags?.noPlugins || flags?.plugins !== undefined) {+ draft.plugins = flags.noPlugins ? [] : (flags.plugins ?? []);+ return true;+ }const plugins = await askPlugins({allowBack: true,backHint: stepBackHint,initial: draft.plugins,+ prechosen: flags?.plugins,+ skip: flags?.noPlugins,});if (isPromptBack(plugins)) {step = 6;diff --git a/tui/src/index.ts b/tui/src/index.tsindex e8d5c8e..048c574 100644--- a/tui/src/index.ts+++ b/tui/src/index.ts@@ -8,6 +8,10 @@ import { runUpdate } from "./commands/update.js";import { runPlugins, type PluginsOptions, type PluginsSubcommand } from "./commands/plugins.js";import { runReset, type ResetCommandOptions } from "./commands/reset.js";import { readState } from "./lib/state.js";+import {+ tryApplyInitFlag,+ type InitFlagOverrides,+} from "./lib/init-flags.js";import { isPipelineMode, type PipelineMode } from "./types.js";type Command =@@ -34,6 +38,8 @@ interface ParsedArgs {invalidPipeline?: string;plugins?: PluginsOptions;reset?: ResetCommandOptions;+ initFlags?: InitFlagOverrides;+ initFlagError?: string;unknown: string[];}@@ -54,6 +60,7 @@ function parseArgs(argv: string[]): ParsedArgs {let command: Command = "help";const unknown: string[] = [];const out: ParsedArgs = { command, unknown };+ let initFlags: InitFlagOverrides | undefined;while (args.length > 0) {const arg = args.shift()!;@@ -96,6 +103,8 @@ function parseArgs(argv: string[]): ParsedArgs {} else if (arg === "--version" || arg === "-v") {printVersion();process.exit(0);+ } else if (arg === "--init") {+ out.command = "init";} else if (out.command === "help" && !arg.startsWith("-")) {switch (arg) {case "init":@@ -111,6 +120,16 @@ function parseArgs(argv: string[]): ParsedArgs {default:unknown.push(arg);}+ } else if (out.command === "init") {+ if (!initFlags) initFlags = {};+ const result = tryApplyInitFlag(arg, args, initFlags);+ if (result.kind === "error") {+ out.initFlagError = result.error;+ return out;+ }+ if (result.kind === "unknown") {+ unknown.push(arg);+ }} else if (out.command === "reset") {if (!out.reset) out.reset = {};const reset = out.reset;@@ -156,6 +175,10 @@ function parseArgs(argv: string[]): ParsedArgs {unknown.push(arg);}}++ if (initFlags && Object.keys(initFlags).length > 0) {+ out.initFlags = initFlags;+ }return out;}@@ -179,6 +202,7 @@ function printHelp(): void {" -r, --repo <url> Git repo to clone (default $BRAINAPI_REPO_URL or upstream)"," -b, --branch <ref> Branch to checkout (default $BRAINAPI_BRANCH or 'main')"," -f, --force Re-run init even if state exists",+ " --init Alias for the init command"," --no-services For 'start': skip bringing backing services up"," --no-api For 'start': skip the API server"," --no-mcp For 'start': skip the MCP server",@@ -194,6 +218,13 @@ function printHelp(): void {" -v, --version Print the CLI version"," -h, --help Show this message","",+ pc.bold("Init flags:") + " " + pc.dim("(provided values skip that wizard prompt)"),+ " --defaults Use default DB stack (Postgres + pgvector + NetworkX)",+ " --vector-db|--data-db|--graph-db|--ocr-mode|--services-runtime",+ " --models-mode|--llm-*-provider|--llm-small|--llm-large|--embedding-model",+ " --start-services|--no-start-services|--brainpat-token|--plugin|--no-plugins",+ " …plus connection + provider credential flags (see README)",+ "",pc.dim("Environment overrides: BRAINAPI_HOME, BRAINAPI_REPO_URL, BRAINAPI_BRANCH"),];console.log(lines.join("\n"));@@ -215,6 +246,10 @@ async function autoInitIfNeeded(command: Command): Promise<Command> {async function main(): Promise<void> {const parsed = parseArgs(process.argv.slice(2));+ if (parsed.initFlagError) {+ p.log.error(parsed.initFlagError);+ process.exit(1);+ }if (parsed.invalidPipeline !== undefined) {p.log.error(`Invalid --pipeline value "${parsed.invalidPipeline}". Use accurate or lightweight.`,@@ -244,6 +279,7 @@ async function main(): Promise<void> {repoUrl: parsed.repo,branch: parsed.branch,force: parsed.force,+ flags: parsed.initFlags,});return;case "start": {diff --git a/tui/src/lib/init-flags.ts b/tui/src/lib/init-flags.tsnew file mode 100644index 0000000..4e9c899--- /dev/null+++ b/tui/src/lib/init-flags.ts@@ -0,0 +1,507 @@+import type {+ DataDb,+ GraphDb,+ ModelProvider,+ ModelsMode,+ OcrMode,+ PluginChoice,+ ServicesRuntime,+ VectorDb,+} from "../types.js";++export interface InitFlagOverrides {+ defaults?: boolean;+ vectorDb?: VectorDb;+ dataDb?: DataDb;+ graphDb?: GraphDb;+ ocrMode?: OcrMode;+ servicesRuntime?: ServicesRuntime;+ startServices?: boolean;++ modelsMode?: ModelsMode;+ llmSmallProvider?: ModelProvider;+ llmLargeProvider?: ModelProvider;+ embeddingsProvider?: Exclude<ModelProvider, "anthropic" | "deepseek">;+ llmSmall?: string;+ llmLarge?: string;+ embeddingModel?: string;+ embeddingDimensions?: number;++ ollamaHost?: string;+ ollamaPort?: number;+ ollamaSmall?: string;+ ollamaLarge?: string;+ ollamaEmbeddings?: string;++ gcpCredentials?: string;+ gcpProject?: string;+ gcpSmall?: string;+ gcpLarge?: string;+ gcpEmbedding?: string;++ azureEndpoint?: string;+ azureApiVersion?: string;+ azureKey?: string;+ azureSmall?: string;+ azureLarge?: string;+ azureEmbeddingEndpoint?: string;+ azureEmbeddingKey?: string;+ azureEmbedding?: string;++ openaiApiKey?: string;+ openaiBaseUrl?: string;+ openaiSmall?: string;+ openaiLarge?: string;+ openaiEmbedding?: string;++ anthropicApiKey?: string;+ anthropicSmall?: string;+ anthropicLarge?: string;++ deepseekApiKey?: string;+ deepseekSmall?: string;+ deepseekLarge?: string;++ awsRegion?: string;+ awsAccessKeyId?: string;+ awsSecretAccessKey?: string;+ awsSessionToken?: string;+ bedrockSmall?: string;+ bedrockLarge?: string;+ bedrockEmbedding?: string;++ redisHost?: string;+ redisPort?: number;+ postgresHost?: string;+ postgresPort?: number;+ postgresUsername?: string;+ postgresPassword?: string;+ postgresSystemDb?: string;+ postgresMaintenanceDb?: string;+ neo4jHost?: string;+ neo4jPort?: number;+ neo4jUsername?: string;+ neo4jPassword?: string;+ milvusDeployment?: "local" | "managed";+ milvusHost?: string;+ milvusPort?: number;+ milvusUri?: string;+ milvusToken?: string;+ mongoHost?: string;+ mongoPort?: number;+ mongoUsername?: string;+ mongoPassword?: string;++ brainpatToken?: string;+ plugins?: PluginChoice[];+ noPlugins?: boolean;+}++const VECTOR_DBS = new Set<VectorDb>(["postgresql", "milvus"]);+const DATA_DBS = new Set<DataDb>(["postgresql", "mongo"]);+const GRAPH_DBS = new Set<GraphDb>(["networkx", "neo4j"]);+const OCR_MODES = new Set<OcrMode>(["docparser", "docling"]);+const RUNTIMES = new Set<ServicesRuntime>(["docker", "manual"]);+const MODELS_MODES = new Set<ModelsMode>(["local", "remote"]);+const LLM_PROVIDERS = new Set<ModelProvider>([+ "ollama",+ "openai",+ "anthropic",+ "deepseek",+ "azure",+ "gcp_vertex",+ "amazon_bedrock",+]);+const EMBEDDING_PROVIDERS = new Set<Exclude<ModelProvider, "anthropic" | "deepseek">>([+ "ollama",+ "openai",+ "azure",+ "gcp_vertex",+ "amazon_bedrock",+]);++function splitFlag(arg: string): { name: string; inline?: string } {+ const eq = arg.indexOf("=");+ if (eq === -1) return { name: arg };+ return { name: arg.slice(0, eq), inline: arg.slice(eq + 1) };+}++function takeValue(+ inline: string | undefined,+ args: string[],+ flag: string,+): { ok: true; value: string } | { ok: false; error: string } {+ if (inline !== undefined) {+ if (inline.length === 0) {+ return { ok: false, error: `${flag} requires a value` };+ }+ return { ok: true, value: inline };+ }+ const next = args.shift();+ if (next === undefined || next.startsWith("-")) {+ if (next !== undefined) args.unshift(next);+ return { ok: false, error: `${flag} requires a value` };+ }+ return { ok: true, value: next };+}++function parsePort(+ raw: string,+ flag: string,+): { ok: true; value: number } | { ok: false; error: string } {+ const n = Number(raw);+ if (!Number.isInteger(n) || n <= 0 || n > 65535) {+ return { ok: false, error: `${flag} must be an integer port 1-65535` };+ }+ return { ok: true, value: n };+}++function parsePositiveInt(+ raw: string,+ flag: string,+): { ok: true; value: number } | { ok: false; error: string } {+ const n = Number(raw);+ if (!Number.isInteger(n) || n <= 0) {+ return { ok: false, error: `${flag} must be a positive integer` };+ }+ return { ok: true, value: n };+}++function parsePluginSpec(raw: string): PluginChoice {+ const at = raw.lastIndexOf("@");+ if (at > 0) {+ return {+ name: raw.slice(0, at),+ source: "registry",+ version: raw.slice(at + 1),+ };+ }+ return { name: raw, source: "registry" };+}++/** True when any wizard-config flag is present (skips “use defaults?”). */+export function hasConfigOverrides(flags: InitFlagOverrides): boolean {+ const {+ defaults: _defaults,+ startServices: _start,+ ...rest+ } = flags;+ return Object.values(rest).some((v) => v !== undefined);+}++export type ApplyInitFlagResult =+ | { kind: "applied" }+ | { kind: "unknown" }+ | { kind: "error"; error: string };++/** Apply a single init flag. Mutates `flags` and may shift `args` for the value. */+export function tryApplyInitFlag(+ raw: string,+ args: string[],+ flags: InitFlagOverrides,+): ApplyInitFlagResult {+ if (!raw.startsWith("-")) return { kind: "unknown" };++ const { name, inline } = splitFlag(raw);++ const setString = (key: keyof InitFlagOverrides, flagName: string): ApplyInitFlagResult => {+ const taken = takeValue(inline, args, flagName);+ if (!taken.ok) return { kind: "error", error: taken.error };+ (flags as Record<string, unknown>)[key] = taken.value;+ return { kind: "applied" };+ };++ const setPort = (key: keyof InitFlagOverrides, flagName: string): ApplyInitFlagResult => {+ const taken = takeValue(inline, args, flagName);+ if (!taken.ok) return { kind: "error", error: taken.error };+ const port = parsePort(taken.value, flagName);+ if (!port.ok) return { kind: "error", error: port.error };+ (flags as Record<string, unknown>)[key] = port.value;+ return { kind: "applied" };+ };++ switch (name) {+ case "--defaults":+ flags.defaults = true;+ return { kind: "applied" };+ case "--vector-db": {+ const taken = takeValue(inline, args, name);+ if (!taken.ok) return { kind: "error", error: taken.error };+ const v = taken.value.toLowerCase() as VectorDb;+ if (!VECTOR_DBS.has(v)) {+ return {+ kind: "error",+ error: `Invalid --vector-db "${taken.value}". Use postgresql or milvus.`,+ };+ }+ flags.vectorDb = v;+ return { kind: "applied" };+ }+ case "--data-db": {+ const taken = takeValue(inline, args, name);+ if (!taken.ok) return { kind: "error", error: taken.error };+ const v = taken.value.toLowerCase() as DataDb;+ if (!DATA_DBS.has(v)) {+ return {+ kind: "error",+ error: `Invalid --data-db "${taken.value}". Use postgresql or mongo.`,+ };+ }+ flags.dataDb = v;+ return { kind: "applied" };+ }+ case "--graph-db": {+ const taken = takeValue(inline, args, name);+ if (!taken.ok) return { kind: "error", error: taken.error };+ const v = taken.value.toLowerCase() as GraphDb;+ if (!GRAPH_DBS.has(v)) {+ return {+ kind: "error",+ error: `Invalid --graph-db "${taken.value}". Use networkx or neo4j.`,+ };+ }+ flags.graphDb = v;+ return { kind: "applied" };+ }+ case "--ocr-mode": {+ const taken = takeValue(inline, args, name);+ if (!taken.ok) return { kind: "error", error: taken.error };+ const v = taken.value.toLowerCase() as OcrMode;+ if (!OCR_MODES.has(v)) {+ return {+ kind: "error",+ error: `Invalid --ocr-mode "${taken.value}". Use docparser or docling.`,+ };+ }+ flags.ocrMode = v;+ return { kind: "applied" };+ }+ case "--services-runtime": {+ const taken = takeValue(inline, args, name);+ if (!taken.ok) return { kind: "error", error: taken.error };+ const v = taken.value.toLowerCase() as ServicesRuntime;+ if (!RUNTIMES.has(v)) {+ return {+ kind: "error",+ error: `Invalid --services-runtime "${taken.value}". Use docker or manual.`,+ };+ }+ flags.servicesRuntime = v;+ return { kind: "applied" };+ }+ case "--start-services":+ flags.startServices = true;+ return { kind: "applied" };+ case "--no-start-services":+ flags.startServices = false;+ return { kind: "applied" };+ case "--models-mode": {+ const taken = takeValue(inline, args, name);+ if (!taken.ok) return { kind: "error", error: taken.error };+ const v = taken.value.toLowerCase() as ModelsMode;+ if (!MODELS_MODES.has(v)) {+ return {+ kind: "error",+ error: `Invalid --models-mode "${taken.value}". Use local or remote.`,+ };+ }+ flags.modelsMode = v;+ return { kind: "applied" };+ }+ case "--llm-small-provider": {+ const taken = takeValue(inline, args, name);+ if (!taken.ok) return { kind: "error", error: taken.error };+ const v = taken.value.toLowerCase() as ModelProvider;+ if (!LLM_PROVIDERS.has(v)) {+ return {+ kind: "error",+ error: `Invalid --llm-small-provider "${taken.value}".`,+ };+ }+ flags.llmSmallProvider = v;+ return { kind: "applied" };+ }+ case "--llm-large-provider": {+ const taken = takeValue(inline, args, name);+ if (!taken.ok) return { kind: "error", error: taken.error };+ const v = taken.value.toLowerCase() as ModelProvider;+ if (!LLM_PROVIDERS.has(v)) {+ return {+ kind: "error",+ error: `Invalid --llm-large-provider "${taken.value}".`,+ };+ }+ flags.llmLargeProvider = v;+ return { kind: "applied" };+ }+ case "--embeddings-provider": {+ const taken = takeValue(inline, args, name);+ if (!taken.ok) return { kind: "error", error: taken.error };+ const v = taken.value.toLowerCase() as Exclude<+ ModelProvider,+ "anthropic" | "deepseek"+ >;+ if (!EMBEDDING_PROVIDERS.has(v)) {+ return {+ kind: "error",+ error: `Invalid --embeddings-provider "${taken.value}".`,+ };+ }+ flags.embeddingsProvider = v;+ return { kind: "applied" };+ }+ case "--llm-small":+ return setString("llmSmall", name);+ case "--llm-large":+ return setString("llmLarge", name);+ case "--embedding-model":+ return setString("embeddingModel", name);+ case "--embedding-dimensions": {+ const taken = takeValue(inline, args, name);+ if (!taken.ok) return { kind: "error", error: taken.error };+ const n = parsePositiveInt(taken.value, name);+ if (!n.ok) return { kind: "error", error: n.error };+ flags.embeddingDimensions = n.value;+ return { kind: "applied" };+ }+ case "--ollama-host":+ return setString("ollamaHost", name);+ case "--ollama-port":+ return setPort("ollamaPort", name);+ case "--ollama-small":+ return setString("ollamaSmall", name);+ case "--ollama-large":+ return setString("ollamaLarge", name);+ case "--ollama-embeddings":+ return setString("ollamaEmbeddings", name);+ case "--gcp-credentials":+ return setString("gcpCredentials", name);+ case "--gcp-project":+ return setString("gcpProject", name);+ case "--gcp-small":+ return setString("gcpSmall", name);+ case "--gcp-large":+ return setString("gcpLarge", name);+ case "--gcp-embedding":+ return setString("gcpEmbedding", name);+ case "--azure-endpoint":+ return setString("azureEndpoint", name);+ case "--azure-api-version":+ return setString("azureApiVersion", name);+ case "--azure-key":+ return setString("azureKey", name);+ case "--azure-small":+ return setString("azureSmall", name);+ case "--azure-large":+ return setString("azureLarge", name);+ case "--azure-embedding-endpoint":+ return setString("azureEmbeddingEndpoint", name);+ case "--azure-embedding-key":+ return setString("azureEmbeddingKey", name);+ case "--azure-embedding":+ return setString("azureEmbedding", name);+ case "--openai-api-key":+ return setString("openaiApiKey", name);+ case "--openai-base-url":+ return setString("openaiBaseUrl", name);+ case "--openai-small":+ return setString("openaiSmall", name);+ case "--openai-large":+ return setString("openaiLarge", name);+ case "--openai-embedding":+ return setString("openaiEmbedding", name);+ case "--anthropic-api-key":+ return setString("anthropicApiKey", name);+ case "--anthropic-small":+ return setString("anthropicSmall", name);+ case "--anthropic-large":+ return setString("anthropicLarge", name);+ case "--deepseek-api-key":+ return setString("deepseekApiKey", name);+ case "--deepseek-small":+ return setString("deepseekSmall", name);+ case "--deepseek-large":+ return setString("deepseekLarge", name);+ case "--aws-region":+ return setString("awsRegion", name);+ case "--aws-access-key-id":+ return setString("awsAccessKeyId", name);+ case "--aws-secret-access-key":+ return setString("awsSecretAccessKey", name);+ case "--aws-session-token":+ return setString("awsSessionToken", name);+ case "--bedrock-small":+ return setString("bedrockSmall", name);+ case "--bedrock-large":+ return setString("bedrockLarge", name);+ case "--bedrock-embedding":+ return setString("bedrockEmbedding", name);+ case "--redis-host":+ return setString("redisHost", name);+ case "--redis-port":+ return setPort("redisPort", name);+ case "--postgres-host":+ return setString("postgresHost", name);+ case "--postgres-port":+ return setPort("postgresPort", name);+ case "--postgres-username":+ return setString("postgresUsername", name);+ case "--postgres-password":+ return setString("postgresPassword", name);+ case "--postgres-system-db":+ return setString("postgresSystemDb", name);+ case "--postgres-maintenance-db":+ return setString("postgresMaintenanceDb", name);+ case "--neo4j-host":+ return setString("neo4jHost", name);+ case "--neo4j-port":+ return setPort("neo4jPort", name);+ case "--neo4j-username":+ return setString("neo4jUsername", name);+ case "--neo4j-password":+ return setString("neo4jPassword", name);+ case "--milvus-deployment": {+ const taken = takeValue(inline, args, name);+ if (!taken.ok) return { kind: "error", error: taken.error };+ const v = taken.value.toLowerCase();+ if (v !== "local" && v !== "managed") {+ return {+ kind: "error",+ error: `Invalid --milvus-deployment "${taken.value}". Use local or managed.`,+ };+ }+ flags.milvusDeployment = v;+ return { kind: "applied" };+ }+ case "--milvus-host":+ return setString("milvusHost", name);+ case "--milvus-port":+ return setPort("milvusPort", name);+ case "--milvus-uri":+ return setString("milvusUri", name);+ case "--milvus-token":+ return setString("milvusToken", name);+ case "--mongo-host":+ return setString("mongoHost", name);+ case "--mongo-port":+ return setPort("mongoPort", name);+ case "--mongo-username":+ return setString("mongoUsername", name);+ case "--mongo-password":+ return setString("mongoPassword", name);+ case "--brainpat-token":+ return setString("brainpatToken", name);+ case "--plugin": {+ const taken = takeValue(inline, args, name);+ if (!taken.ok) return { kind: "error", error: taken.error };+ if (!flags.plugins) flags.plugins = [];+ flags.plugins.push(parsePluginSpec(taken.value));+ return { kind: "applied" };+ }+ case "--no-plugins":+ flags.noPlugins = true;+ return { kind: "applied" };+ default:+ return { kind: "unknown" };+ }+}