topchester-ai 0.8.0 → 0.9.0

package/README.md

@@ -13,7 +13,7 @@ The current `topchester kb compile` command handles L1 file knowledge:
 - Requires `topchester kb init` to create the knowledge folders first.
 - Reads workspace `.gitignore` files, lists in-scope project files, and skips generated/cache folders such as `.git/`, `node_modules/`, `dist/`, `coverage/`, `topchester-kb/`, `.agents/topchester/`, and `.agents/topchester-kb-cache/`.
 - Queues L1 work at `.agents/topchester-kb-cache/l1-queue.json`.
-- Processes queued files with the configured `kb.summarize` model, or `fallback` when `kb.summarize` is not configured.
+- Processes queued files with the configured `kb.summarize` model, or the `default` model when `kb.summarize` is not configured.
 - Writes the manifest at `topchester-kb/manifest.json`.
 - Writes current L1 file entries under `topchester-kb/l1-files/`.
 - Exits successfully only when every in-scope file has a current L1 entry.
@@ -69,11 +69,19 @@ Model settings are loaded from YAML config files and merged in this order:
 
 Example configs live in `config/example.yaml` and `config/gemini.yaml`. OpenRouter configs expect `OPENROUTER_API_KEY` in the environment; do not commit API keys or other secrets.
 
+The smallest OpenRouter config uses one model for every Topchester purpose:
+
+```yaml
+models:
+  default: openrouter/google/gemini-3.1-flash-lite
+```
+
 ## Docs
 
 - [Architecture](docs/ARCHITECTURE.md)
 - [Knowledge System](docs/KNOWLEDGE.md)
 - [CLI Commands](docs/cli.md)
+- [Configuration](docs/config.md)
 - [TUI Guide](docs/tui.md)
 - [Model Configuration](docs/MODEL_CONFIG.md)
 - [Sessions](docs/SESSIONS.md)

package/dist/cli.mjs

@@ -2018,6 +2018,7 @@ const modelPurposeSchema = z.enum([
 	"kb.embed",
 	"fallback"
 ]);
+const modelPurposes = modelPurposeSchema.options;
 const toolProtocolSchema = z.enum([
 	"auto",
 	"native",
@@ -2043,7 +2044,14 @@ const modelAssignmentSchema = z.object({
 	provider: z.string().optional(),
 	toolProtocol: toolProtocolSchema.optional()
 });
+const modelRefSchema = z.union([z.string(), modelAssignmentSchema]);
 const providersSchema = z.object({ default: z.string().optional() }).catchall(providerSchema.or(z.string()));
+const rawModelsSchema = z.object({
+	"default": modelRefSchema.optional(),
+	"fast": modelRefSchema.optional(),
+	"kb.summarize": modelRefSchema.optional(),
+	"providers": providersSchema.optional()
+}).strict();
 const ignorePathSchema = z.string().min(1).superRefine((value, context) => {
 	const pattern = value.startsWith("!") ? value.slice(1) : value;
 	if (!pattern) {
@@ -2071,7 +2079,11 @@ const topchesterConfigSchema = z.object({
 		defaultPurpose: modelPurposeSchema.optional(),
 		assignments: z.partialRecord(modelPurposeSchema, modelAssignmentSchema).optional(),
 		providers: providersSchema.optional()
-	}).optional(),
+	}).strict().optional(),
+	ignore: z.object({ paths: z.array(ignorePathSchema).optional() }).optional()
+});
+const rawTopchesterConfigSchema = z.object({
+	models: rawModelsSchema.optional(),
 	ignore: z.object({ paths: z.array(ignorePathSchema).optional() }).optional()
 });
 function loadTopchesterConfig(options) {
@@ -2102,10 +2114,94 @@ function readConfigFile(path) {
 	}
 }
 function parseConfigFile(path, value) {
-	const parsed = topchesterConfigSchema.safeParse(value ?? {});
+	const raw = rawTopchesterConfigSchema.safeParse(value ?? {});
+	if (!raw.success) throw new Error(`Invalid Topchester config at ${path}: ${raw.error.issues.map(formatZodIssue).join("; ")}`);
+	const parsed = topchesterConfigSchema.safeParse(normalizeConfigInput(raw.data));
 	if (!parsed.success) throw new Error(`Invalid Topchester config at ${path}: ${parsed.error.issues.map(formatZodIssue).join("; ")}`);
 	return parsed.data;
 }
+function normalizeConfigInput(value) {
+	if (!isPlainObject(value) || !isPlainObject(value.models)) return value;
+	const models = { ...value.models };
+	const providers = isPlainObject(models.providers) ? { ...models.providers } : {};
+	const assignments = {};
+	const defaultModelRef = normalizeModelRef(models.default, typeof providers.default === "string" ? providers.default : void 0);
+	const defaultProvider = typeof providers.default === "string" ? providers.default : defaultModelRef?.provider;
+	const fastModelRef = normalizeModelRef(models.fast, defaultProvider);
+	const kbSummarizeModelRef = normalizeModelRef(models["kb.summarize"], defaultProvider);
+	if (defaultModelRef) {
+		const assignment = modelRefToAssignment(defaultModelRef);
+		for (const purpose of modelPurposes) assignments[purpose] ??= assignment;
+		providers.default ??= defaultModelRef.provider;
+		ensureKnownProvider(providers, defaultModelRef.provider);
+		delete models.default;
+	}
+	if (fastModelRef) {
+		assignments["agent.fast"] = modelRefToAssignment(fastModelRef);
+		ensureKnownProvider(providers, fastModelRef.provider);
+		delete models.fast;
+	}
+	if (kbSummarizeModelRef) {
+		assignments["kb.summarize"] = modelRefToAssignment(kbSummarizeModelRef);
+		ensureKnownProvider(providers, kbSummarizeModelRef.provider);
+		delete models["kb.summarize"];
+	}
+	return {
+		...value,
+		models: {
+			...models,
+			assignments,
+			providers
+		}
+	};
+}
+function normalizeModelRef(ref, defaultProvider) {
+	if (typeof ref === "string") return parseModelRef(ref, defaultProvider);
+	if (!isPlainObject(ref) || typeof ref.name !== "string") return;
+	return {
+		model: ref.name,
+		...typeof ref.provider === "string" ? { provider: ref.provider } : defaultProvider ? { provider: defaultProvider } : {},
+		...typeof ref.toolProtocol === "string" && toolProtocolSchema.safeParse(ref.toolProtocol).success ? { toolProtocol: ref.toolProtocol } : {}
+	};
+}
+function modelRefToAssignment(ref) {
+	return {
+		name: ref.model,
+		...ref.provider ? { provider: ref.provider } : {},
+		...ref.toolProtocol ? { toolProtocol: ref.toolProtocol } : {}
+	};
+}
+function parseModelRef(ref, defaultProvider) {
+	if (defaultProvider) {
+		const providerPrefix = `${defaultProvider}/`;
+		return ref.startsWith(providerPrefix) ? {
+			provider: defaultProvider,
+			model: ref.slice(providerPrefix.length)
+		} : {
+			provider: defaultProvider,
+			model: ref
+		};
+	}
+	const [provider, ...modelParts] = ref.split("/");
+	if (provider && modelParts.length > 0) return {
+		provider,
+		model: modelParts.join("/")
+	};
+	return { model: ref };
+}
+function ensureKnownProvider(providers, provider) {
+	if (provider !== "openrouter" || providers.openrouter !== void 0) return;
+	providers.openrouter = {
+		type: "openai-compatible",
+		baseURL: "https://openrouter.ai/api/v1",
+		apiKeyEnv: "OPENROUTER_API_KEY",
+		supportsStructuredOutputs: true,
+		headers: {
+			"HTTP-Referer": "https://topchester.com",
+			"X-Title": "Topchester"
+		}
+	};
+}
 function deepMerge(base, override, path = []) {
 	if (Array.isArray(base) && Array.isArray(override)) return path.join(".") === "ignore.paths" ? [...base, ...override] : override;
 	if (!isPlainObject(base) || !isPlainObject(override)) return override;
@@ -4435,7 +4531,6 @@ var ChatLayout = class {
 	messages;
 	folderName;
 	modelLabel;
-	exitAgent;
 	input = new Input();
 	status = "ready";
 	knowledgeStatus;
@@ -4449,12 +4544,15 @@ var ChatLayout = class {
 	activeSlashSuggestionIndex = 0;
 	threadScrollOffset = 0;
 	promptHistory = new PromptHistory();
-	constructor(terminal, messages, folderName, modelLabel, exitAgent = () => {}) {
+	exitAgent;
+	transcriptMode;
+	constructor(terminal, messages, folderName, modelLabel, options = {}) {
 		this.terminal = terminal;
 		this.messages = messages;
 		this.folderName = folderName;
 		this.modelLabel = modelLabel;
-		this.exitAgent = exitAgent;
+		this.exitAgent = typeof options === "function" ? options : options.exitAgent ?? (() => {});
+		this.transcriptMode = typeof options === "function" ? "viewport" : options.transcriptMode ?? "viewport";
 		this.input.onSubmit = (value) => {
 			if (value.trim().length > 0) {
 				const message = value.trim();
@@ -4525,8 +4623,8 @@ var ChatLayout = class {
 		}
 		if (this.handleModalInput(data)) return;
 		if (this.handleSlashSuggestionInput(data)) return;
-		if (this.handlePromptHistoryInput(data)) return;
 		if (this.handleThreadScrollInput(data)) return;
+		if (this.handlePromptHistoryInput(data)) return;
 		const previousInput = this.input.getValue();
 		this.input.handleInput(data);
 		if (this.input.getValue() !== previousInput) this.promptHistory.resetBrowsing();
@@ -4539,6 +4637,10 @@ var ChatLayout = class {
 		const footerLines = this.getActiveModal() ? this.renderModalHelp(safeWidth) : this.renderPrompt(safeWidth);
 		const threadHeight = Math.max(1, this.terminal.rows - footerLines.length);
 		const allThreadLines = this.renderThread(safeWidth);
+		if (this.transcriptMode === "inline") {
+			this.threadScrollOffset = 0;
+			return [...allThreadLines.length < threadHeight ? padLines(allThreadLines, threadHeight, safeWidth) : allThreadLines, ...footerLines];
+		}
 		const maxScrollOffset = Math.max(0, allThreadLines.length - threadHeight);
 		this.threadScrollOffset = Math.min(this.threadScrollOffset, maxScrollOffset);
 		const end = allThreadLines.length - this.threadScrollOffset;
@@ -4639,6 +4741,7 @@ var ChatLayout = class {
 		return false;
 	}
 	handleThreadScrollInput(data) {
+		if (this.transcriptMode === "inline") return false;
 		const pageSize = Math.max(1, Math.floor(this.terminal.rows / 2));
 		const wheel = parseMouseWheel(data);
 		if (wheel === "up") {
@@ -5197,15 +5300,6 @@ function formatKbPathSource(status) {
 	return status.kbPathSource === "env" ? " (custom)" : "";
 }
 //#endregion
-//#region src/tui/terminal.ts
-function enterAlternateScreen(terminal) {
-	terminal.write("\x1B[?1049h");
-	terminal.clearScreen();
-}
-function exitAlternateScreen(terminal) {
-	terminal.write("\x1B[?1049l");
-}
-//#endregion
 //#region src/tui/shell.ts
 var TopchesterTuiShell = class {
 	context;
@@ -5232,19 +5326,20 @@ var TopchesterTuiShell = class {
 			return;
 		}
 		const terminal = new ProcessTerminal();
-		enterAlternateScreen(terminal);
 		const tui = new TUI(terminal, true);
 		let didExit = false;
 		const exit = () => {
 			if (didExit) return;
 			didExit = true;
 			tui.stop();
-			exitAlternateScreen(terminal);
 			printExitBanner(session.sessionId, Date.now() - startedAt);
 		};
-		const app = new ChatLayout(terminal, messages, folderName, modelLabel, () => {
-			exit();
-			process.exit(0);
+		const app = new ChatLayout(terminal, messages, folderName, modelLabel, {
+			transcriptMode: "inline",
+			exitAgent: () => {
+				exit();
+				process.exit(0);
+			}
 		});
 		app.setSubmitMessage((message) => {
 			this.submitChatMessage(app, tui, message);