chore

sanchitrk · Sep 1, 2026 · Aug 24, 2026 · Aug 24, 2026 · Aug 24, 2026 · Aug 24, 2026
commit 8aec00e380a6c1b6ec011df7f7d1b76a251169f9
diff --git a/packages/aikit/src/model/model.ts b/packages/aikit/src/model/model.ts
@@ -52,6 +52,7 @@ export const ActiveThinkingLevel = Type.Union([
 ]);
 export type ActiveThinkingLevel = Static<typeof ActiveThinkingLevel>;
 
+// Note: order of entries matters!
 const ACTIVE_THINKING_LEVELS = [
 	ThinkingLevelEnum.minimal,
 	ThinkingLevelEnum.low,
@@ -311,10 +312,13 @@ export function clampThinkingLevel<TProtocol extends KnownProviderEnum>(
 	const requestedIndex = MODEL_THINKING_LEVELS.indexOf(level);
 	if (requestedIndex === -1) return availableLevels[0] ?? "off";
 
+	// walk up the ladder from the point and pick first supported
+	// biased to avail more thinking, then less not round to nearest.
 	for (let i = requestedIndex; i < MODEL_THINKING_LEVELS.length; i++) {
 		const candidate = MODEL_THINKING_LEVELS[i]!;
 		if (availableLevels.includes(candidate)) return candidate;
 	}
+	// otherwise walk down from the point
 	for (let i = requestedIndex - 1; i >= 0; i--) {
 		const candidate = MODEL_THINKING_LEVELS[i]!;
 		if (availableLevels.includes(candidate)) return candidate;

diff --git a/packages/aikit/test/model.test.ts b/packages/aikit/test/model.test.ts
@@ -61,6 +61,7 @@ describe("Model.normalizeInput", () => {
 		expect(Model.normalizeInput(["text", "text", "image", "image"])).toEqual(["text", "image"]);
 	});
 
+	// FIXME: no fallback to known modalities; keep what's only supported.
 	it("falls back to text when only unknown modalities are given", () => {
 		expect(Model.normalizeInput(["audio"])).toEqual(["text"]);
 	});

diff --git a/packages/aikit/test/modelgen.test.ts b/packages/aikit/test/modelgen.test.ts
@@ -1,15 +1,15 @@
-import { describe, expect, it } from "vite-plus/test";
 import Value from "typebox/value";
+import { describe, expect, it } from "vite-plus/test";
 import { generateModels as generateModelsImplementation, openAICodexBuiltInModels } from "../src/cli/modelgen.ts";
-import { generateModels } from "../src/modelgen.ts";
 import * as Model from "../src/model/model.ts";
+import { generateModels } from "../src/modelgen.ts";
 
 describe("openAICodexBuiltInModels", () => {
 	it("exposes catalog generation through the public modelgen entry", () => {
 		expect(generateModels).toBe(generateModelsImplementation);
 	});
 
-	it("includes Pi's current explicit Codex model list", () => {
+	it("includes explicit Codex model list", () => {
 		const models = openAICodexBuiltInModels();
 
 		expect(Object.keys(models)).toEqual([
@@ -41,7 +41,7 @@ describe("openAICodexBuiltInModels", () => {
 		}
 	});
 
-	it("maps Pi's Codex deferred-tool capability flags", () => {
+	it("maps Codex deferred-tool capability flags", () => {
 		const models = openAICodexBuiltInModels();
 
 		expect(models["gpt-5.3-codex-spark"]?.compat).toEqual({ supportsOpenAIGrammarTools: true });