@diegopetrucci/pi-extensions 0.1.60 → 0.1.62

package/.pi-fleet-tested-version

@@ -1 +1 @@
-0.82.0
+0.83.0

package/extensions/agent-workflow-audit/.pi-fleet-tested-version

@@ -1 +1 @@
-0.82.0
+0.83.0

package/extensions/agent-workflow-audit/index.ts

@@ -1123,7 +1123,10 @@ export const __test__ = {
 };
 
 export default function agentWorkflowAuditExtension(pi: ExtensionAPI) {
-	pi.registerMessageRenderer(CUSTOM_TYPE, (message, { expanded }, theme) => {
+	pi.registerMessageRenderer(CUSTOM_TYPE, (message, options, theme) => {
+		const { expanded } = options;
+		const rendererOptions = options as { outputPad?: number };
+		const outputPad = rendererOptions.outputPad ?? 0;
 		const details = message.details as AuditDetails | undefined;
 		const report = messageContentToText(message.content) || "(no report)";
 		const status = details?.status ?? "done";
@@ -1143,15 +1146,15 @@ export default function agentWorkflowAuditExtension(pi: ExtensionAPI) {
 		const header = `${icon} ${theme.fg("toolTitle", theme.bold("agent-workflow-audit "))}${theme.fg("dim", meta)}`;
 
 		if (!expanded) {
-			return new Text(`${header}\n\n${theme.fg("toolOutput", renderCollapsedReport(report))}`, 0, 0);
+			return new Text(`${header}\n\n${theme.fg("toolOutput", renderCollapsedReport(report))}`, outputPad, 0);
 		}
 
 		const container = new Container();
-		container.addChild(new Text(header, 0, 0));
-		if (details?.cwd) container.addChild(new Text(theme.fg("dim", `cwd: ${details.cwd}`), 0, 0));
-		if (details?.focus) container.addChild(new Text(theme.fg("dim", `focus: ${details.focus}`), 0, 0));
+		container.addChild(new Text(header, outputPad, 0));
+		if (details?.cwd) container.addChild(new Text(theme.fg("dim", `cwd: ${details.cwd}`), outputPad, 0));
+		if (details?.focus) container.addChild(new Text(theme.fg("dim", `focus: ${details.focus}`), outputPad, 0));
 		container.addChild(new Spacer(1));
-		container.addChild(new Markdown(report, 0, 0, getMarkdownTheme()));
+		container.addChild(new Markdown(report, outputPad, 0, getMarkdownTheme()));
 		return container;
 	});
 

package/extensions/agent-workflow-audit/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@diegopetrucci/pi-agent-workflow-audit",
-  "version": "0.1.7",
+  "version": "0.1.9",
   "description": "A pi extension that runs an isolated repo workflow audit and returns only the final report to the main session.",
   "keywords": [
     "pi-package",

package/extensions/annotate-git-diff/.pi-fleet-tested-version

@@ -1 +1 @@
-0.82.0
+0.83.0

package/extensions/annotate-git-diff/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@diegopetrucci/pi-annotate-git-diff",
-  "version": "0.1.7",
+  "version": "0.1.9",
   "description": "A standalone pi extension that adds /annotate-git-diff, a native Glimpse UI for annotating git diffs and sending feedback to the editor.",
   "keywords": [
     "pi-package",

package/extensions/annotate-last-message/.pi-fleet-tested-version

@@ -1 +1 @@
-0.82.0
+0.83.0

package/extensions/annotate-last-message/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@diegopetrucci/pi-annotate-last-message",
-  "version": "0.1.5",
+  "version": "0.1.7",
   "description": "A standalone pi extension that adds /annotate-last-message, a native Glimpse UI for annotating the latest assistant reply.",
   "keywords": [
     "pi-package",

package/extensions/brrr/.pi-fleet-tested-version

@@ -1 +1 @@
-0.82.0
+0.83.0

package/extensions/brrr/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@diegopetrucci/pi-brrr",
-  "version": "0.1.10",
+  "version": "0.1.12",
   "description": "A pi extension that sends brrr push notifications when pi is ready for input.",
   "keywords": [
     "pi-package",

package/extensions/claude-fast/.pi-fleet-tested-version

@@ -1 +1 @@
-0.82.0
+0.83.0

package/extensions/claude-fast/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@diegopetrucci/pi-claude-fast",
-  "version": "0.1.10",
+  "version": "0.1.12",
   "description": "A pi extension that enables Anthropic Claude Fast mode for supported Claude Opus models by injecting speed=fast.",
   "keywords": [
     "pi-package",

package/extensions/code-reviewer/.pi-fleet-tested-version

@@ -1 +1 @@
-0.82.0
+0.83.0

package/extensions/code-reviewer/README.md

@@ -44,6 +44,7 @@ When called, it launches an isolated in-memory child agent with:
 
 - no inherited extensions, skills, prompt templates, themes, context files, or agents files;
 - an auto-selected review model that prefers contrarian-style opposite-provider and opposite-family candidates before same-provider fallbacks;
+- automatic model candidates constrained to the current Pi session's model scope when that scope is non-empty;
 - requested thinking taken from the active session when available, otherwise defaulting to `high` for reasoning models and `off` for non-reasoning models, then clamped to the selected model's supported level;
 - read-only tools only: `read`, `grep`, `find`, `ls`, and guarded `bash`;
 - a local-checkout path guard for file inspection;

package/extensions/code-reviewer/index.ts

@@ -27,6 +27,7 @@ const CODE_REVIEWER_MODEL_PREFERENCES = [
 	"gpt-5.6-terra",
 	"gpt-5.6-luna",
 	"gpt-5.5",
+	"claude-opus-5",
 	"claude-opus-4-8",
 	"claude-opus-4.8",
 	"claude-sonnet-5",
@@ -40,6 +41,7 @@ const CODE_REVIEWER_MODEL_PREFERENCES = [
 ];
 const PROVIDER_MODEL_PREFERENCES: Record<string, string[]> = {
 	"amazon-bedrock": [
+		"claude-opus-5",
 		"claude-fable-5",
 		"claude-opus-4-8",
 		"claude-sonnet-5",
@@ -47,6 +49,7 @@ const PROVIDER_MODEL_PREFERENCES: Record<string, string[]> = {
 		"claude-sonnet-4-5",
 	],
 	anthropic: [
+		"claude-opus-5",
 		"claude-fable-5",
 		"claude-opus-4-8",
 		"claude-sonnet-5",
@@ -64,6 +67,7 @@ const PROVIDER_MODEL_PREFERENCES: Record<string, string[]> = {
 		"gpt-5.3-codex-spark",
 	],
 	"vercel-ai-gateway": [
+		"anthropic/claude-opus-5",
 		"anthropic/claude-fable-5",
 		"anthropic/claude-opus-4.8",
 		"anthropic/claude-opus-4.7",
@@ -220,8 +224,28 @@ type PiModel = {
 type ModelRegistryContext = {
 	model?: PiModel;
 	modelRegistry: { getAvailable(): PiModel[] | Promise<PiModel[]> };
+	scopedModels?: ReadonlyArray<{ model: PiModel; thinkingLevel?: ThinkingLevel }>;
 };
 
+function modelKey(model: PiModel): string {
+	return `${model.provider}/${model.id}`.toLowerCase();
+}
+
+function hasModelScope(ctx: ModelRegistryContext): boolean {
+	return Array.isArray(ctx.scopedModels) && ctx.scopedModels.length > 0;
+}
+
+function isModelInScope(ctx: ModelRegistryContext, model: PiModel): boolean {
+	if (!hasModelScope(ctx)) return true;
+	const key = modelKey(model);
+	return ctx.scopedModels!.some((entry) => modelKey(entry.model) === key);
+}
+
+async function getAutoSelectableModels(ctx: ModelRegistryContext): Promise<PiModel[]> {
+	const available = await ctx.modelRegistry.getAvailable();
+	return hasModelScope(ctx) ? available.filter((model) => isModelInScope(ctx, model)) : available;
+}
+
 type CreateAgentSessionOptions = NonNullable<Parameters<typeof createAgentSession>[0]>;
 type CreateAgentSessionModel = CreateAgentSessionOptions["model"];
 
@@ -350,11 +374,13 @@ function appendOrderedCandidates(
 async function selectCodeReviewerModel(
 	ctx: ModelRegistryContext,
 ): Promise<{ ok: true; selection: PiModel; ordered: PiModel[] } | { ok: false; error: string }> {
-	const available = await ctx.modelRegistry.getAvailable();
+	const available = await getAutoSelectableModels(ctx);
 	if (available.length === 0) {
 		return {
 			ok: false,
-			error: "No authenticated models are available. Log in or configure an API key first.",
+			error: hasModelScope(ctx)
+				? "No authenticated models are available in the current session model scope. Adjust the scope, log in, or configure an API key."
+				: "No authenticated models are available. Log in or configure an API key first.",
 		};
 	}
 

package/extensions/code-reviewer/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@diegopetrucci/pi-code-reviewer",
-  "version": "0.1.5",
+  "version": "0.1.7",
   "description": "A standalone pi extension that adds a read-only code_reviewer subagent tool for isolated code reviews.",
   "keywords": [
     "pi-package",

package/extensions/confirm-destructive/.pi-fleet-tested-version

@@ -1 +1 @@
-0.82.0
+0.83.0

package/extensions/confirm-destructive/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@diegopetrucci/pi-confirm-destructive",
-  "version": "0.1.8",
+  "version": "0.1.10",
   "description": "A pi extension that confirms destructive session actions.",
   "keywords": [
     "pi-package",

package/extensions/context-cap/.pi-fleet-tested-version

@@ -1 +1 @@
-0.82.0
+0.83.0

package/extensions/context-cap/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@diegopetrucci/pi-context-cap",
-  "version": "0.1.7",
+  "version": "0.1.9",
   "description": "A pi extension that caps effective model context windows at 200k tokens for earlier auto-compaction.",
   "keywords": [
     "pi-package",

package/extensions/context-inspector/.pi-fleet-tested-version

@@ -1 +1 @@
-0.82.0
+0.83.0

package/extensions/context-inspector/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@diegopetrucci/pi-context-inspector",
-  "version": "0.1.9",
+  "version": "0.1.11",
   "description": "A pi extension that opens a local HTML dashboard explaining where the current session context is going.",
   "keywords": [
     "pi-package",

package/extensions/contrarian/.pi-fleet-tested-version

@@ -1 +1 @@
-0.82.0
+0.83.0

package/extensions/contrarian/README.md

@@ -77,6 +77,8 @@ Tool-call parameters still win over these defaults. `auto` clears the configured
 - `thinkingLevel` - optional reasoning/thinking override; falls back to the `/contrarian thinking` default, then built-in defaults
 - `cwd` - optional working directory override
 
+When the current Pi session has a non-empty model scope, Contrarian limits automatic model selection and automatic fallbacks to that scope. An explicit tool or `/contrarian model` override remains authoritative even when it is outside the session scope.
+
 ## Notes
 
 - The contrarian is intentionally **read-only**.

package/extensions/contrarian/index.ts

@@ -20,6 +20,31 @@ type PiModel = {
 	thinkingLevelMap?: ThinkingLevelMap;
 };
 
+type ModelSelectionContext = {
+	model?: PiModel;
+	modelRegistry: { getAvailable(): PiModel[] | Promise<PiModel[]> };
+	scopedModels?: ReadonlyArray<{ model: PiModel; thinkingLevel?: ThinkingLevel }>;
+};
+
+function modelKey(model: PiModel): string {
+	return `${model.provider}/${model.id}`.toLowerCase();
+}
+
+function hasModelScope(ctx: ModelSelectionContext): boolean {
+	return Array.isArray(ctx.scopedModels) && ctx.scopedModels.length > 0;
+}
+
+function isModelInScope(ctx: ModelSelectionContext, model: PiModel): boolean {
+	if (!hasModelScope(ctx)) return true;
+	const key = modelKey(model);
+	return ctx.scopedModels!.some((entry) => modelKey(entry.model) === key);
+}
+
+async function getAutoSelectableModels(ctx: ModelSelectionContext): Promise<PiModel[]> {
+	const available = await ctx.modelRegistry.getAvailable();
+	return hasModelScope(ctx) ? available.filter((model) => isModelInScope(ctx, model)) : available;
+}
+
 interface UsageStats {
 	input: number;
 	output: number;
@@ -84,6 +109,7 @@ const CONTRARIAN_MODEL_PREFERENCES = [
 	"gpt-5.6-terra",
 	"gpt-5.6-luna",
 	"gpt-5.5",
+	"claude-opus-5",
 	"claude-opus-4-8",
 	"claude-opus-4.8",
 	"claude-sonnet-5",
@@ -98,6 +124,7 @@ const CONTRARIAN_MODEL_PREFERENCES = [
 
 const PROVIDER_MODEL_PREFERENCES: Record<string, string[]> = {
 	"amazon-bedrock": [
+		"claude-opus-5",
 		"claude-fable-5",
 		"claude-opus-4-8",
 		"claude-opus-4-7",
@@ -117,6 +144,7 @@ const PROVIDER_MODEL_PREFERENCES: Record<string, string[]> = {
 		"zai.glm-5",
 	],
 	anthropic: [
+		"claude-opus-5",
 		"claude-fable-5",
 		"claude-opus-4-8",
 		"claude-opus-4-7",
@@ -141,13 +169,8 @@ const PROVIDER_MODEL_PREFERENCES: Record<string, string[]> = {
 		"gpt-5-chat-latest",
 		"gpt-5.2-pro",
 		"gpt-5.2",
-		"gpt-5.2-codex",
-		"gpt-5.1-codex-max",
-		"gpt-5.1-codex",
 		"gpt-5.1",
-		"gpt-5.1-chat-latest",
 		"o3-pro",
-		"o3-deep-research",
 		"o1-pro",
 		"gpt-5.4-mini",
 		"gpt-5-mini",
@@ -182,8 +205,6 @@ const PROVIDER_MODEL_PREFERENCES: Record<string, string[]> = {
 		"accounts/fireworks/models/glm-5p2",
 		"accounts/fireworks/routers/glm-5p2-fast",
 		"accounts/fireworks/models/minimax-m3",
-		"accounts/fireworks/models/glm-5p1",
-		"accounts/fireworks/routers/glm-5p1-fast",
 		"accounts/fireworks/models/kimi-k2p6",
 		"accounts/fireworks/routers/kimi-k2p6-turbo",
 		"accounts/fireworks/routers/kimi-k2p6-fast",
@@ -193,6 +214,7 @@ const PROVIDER_MODEL_PREFERENCES: Record<string, string[]> = {
 		"accounts/fireworks/models/gpt-oss-20b",
 	],
 	"github-copilot": [
+		"claude-opus-5",
 		"claude-fable-5",
 		"claude-opus-4.8",
 		"claude-opus-4.7",
@@ -282,13 +304,8 @@ const PROVIDER_MODEL_PREFERENCES: Record<string, string[]> = {
 		"gpt-5-chat-latest",
 		"gpt-5.2-pro",
 		"gpt-5.2",
-		"gpt-5.2-codex",
-		"gpt-5.1-codex-max",
-		"gpt-5.1-codex",
 		"gpt-5.1",
-		"gpt-5.1-chat-latest",
 		"o3-pro",
-		"o3-deep-research",
 		"o1-pro",
 		"gpt-5.4-mini",
 		"gpt-5-mini",
@@ -303,6 +320,7 @@ const PROVIDER_MODEL_PREFERENCES: Record<string, string[]> = {
 		"gpt-5.3-codex-spark",
 	],
 	opencode: [
+		"claude-opus-5",
 		"claude-fable-5",
 		"gpt-5.5-pro",
 		"gpt-5.5",
@@ -344,6 +362,7 @@ const PROVIDER_MODEL_PREFERENCES: Record<string, string[]> = {
 		"kimi-k2.6",
 	],
 	openrouter: [
+		"anthropic/claude-opus-5",
 		"anthropic/claude-fable-5",
 		"~anthropic/claude-fable-latest",
 		"anthropic/claude-opus-4.8",
@@ -417,6 +436,7 @@ const PROVIDER_MODEL_PREFERENCES: Record<string, string[]> = {
 		"google/gemma-4-31B-it",
 	],
 	"vercel-ai-gateway": [
+		"anthropic/claude-opus-5",
 		"anthropic/claude-fable-5",
 		"anthropic/claude-opus-4.8",
 		"anthropic/claude-opus-4.7",
@@ -921,7 +941,7 @@ function appendThinkingLevelClampReason(
 }
 
 async function findAvailableModel(
-	ctx: { model?: PiModel; modelRegistry: { getAvailable(): PiModel[] | Promise<PiModel[]> } },
+	ctx: ModelSelectionContext,
 	modelRef: string,
 ): Promise<PiModel | undefined> {
 	const available = await ctx.modelRegistry.getAvailable();
@@ -967,11 +987,11 @@ function toContrarianSelection(
 }
 
 function buildSessionFallbackSelection(
-	ctx: { model?: PiModel },
+	ctx: ModelSelectionContext,
 	thinkingLevelOverride: ThinkingLevel | undefined,
 ): ContrarianSelection | undefined {
 	const model = ctx.model;
-	if (!model) return undefined;
+	if (!model || !isModelInScope(ctx, model)) return undefined;
 	return toContrarianSelection(
 		model,
 		thinkingLevelOverride,
@@ -987,14 +1007,16 @@ function withFallbackReason(selection: ContrarianSelection, previous: Contrarian
 }
 
 async function selectContrarianModel(
-	ctx: { model?: PiModel; modelRegistry: { getAvailable(): PiModel[] | Promise<PiModel[]> } },
+	ctx: ModelSelectionContext,
 	thinkingLevelOverride?: ThinkingLevel,
 ): Promise<{ ok: true; selection: ContrarianSelection; ordered: ContrarianSelection[] } | { ok: false; error: string }> {
-	const available = await ctx.modelRegistry.getAvailable();
+	const available = await getAutoSelectableModels(ctx);
 	if (available.length === 0) {
 		return {
 			ok: false,
-			error: "No authenticated models are available. Log in or configure an API key first.",
+			error: hasModelScope(ctx)
+				? "No authenticated models are available in the current session model scope. Adjust the scope, log in, or configure an API key."
+				: "No authenticated models are available. Log in or configure an API key first.",
 		};
 	}
 
@@ -1343,6 +1365,7 @@ type ContrarianExtensionDeps = {
 };
 
 export const __test__ = {
+	buildSessionFallbackSelection,
 	createContrarianExtension,
 	findAvailableModel,
 	isModelAvailabilityError,

package/extensions/contrarian/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@diegopetrucci/pi-contrarian",
-  "version": "0.1.7",
+  "version": "0.1.9",
   "description": "A read-only contrarian subagent extension for pi that stress-tests plans, designs, assumptions, and conclusions.",
   "keywords": [
     "pi-package",

package/extensions/dirty-repo-guard/.pi-fleet-tested-version

@@ -1 +1 @@
-0.82.0
+0.83.0

package/extensions/dirty-repo-guard/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@diegopetrucci/pi-dirty-repo-guard",
-  "version": "0.1.7",
+  "version": "0.1.9",
   "description": "A pi extension that prompts before session changes when the current git repo has uncommitted changes.",
   "keywords": [
     "pi-package",

package/extensions/dynamic-context-pruning/.pi-fleet-tested-version

@@ -1 +1 @@
-0.82.0
+0.83.0

package/extensions/dynamic-context-pruning/package.json

@@ -1,6 +1,6 @@
 {
   "name": "pi-dynamic-context-pruning",
-  "version": "0.1.3",
+  "version": "0.1.5",
   "type": "module",
   "description": "A pi extension that dynamically prunes stale context to keep sessions lean.",
   "keywords": [

package/extensions/git-footer/.pi-fleet-tested-version

@@ -1 +1 @@
-0.82.0
+0.83.0

package/extensions/git-footer/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@diegopetrucci/pi-git-footer",
-  "version": "0.1.6",
+  "version": "0.1.8",
   "description": "A TLH-style git status add-on for pi's built-in footer.",
   "keywords": [
     "pi-package",

package/extensions/gnosis/.pi-fleet-tested-version

@@ -1 +1 @@
-0.82.0
+0.83.0

package/extensions/gnosis/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@diegopetrucci/pi-gnosis",
-  "version": "0.1.7",
+  "version": "0.1.9",
   "description": "A pi extension that exposes the gnosis repo-local knowledge base CLI as an agent tool.",
   "keywords": [
     "pi-package",

package/extensions/illustrations-to-explain-things/.pi-fleet-tested-version

@@ -1 +1 @@
-0.82.0
+0.83.0

package/extensions/illustrations-to-explain-things/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@diegopetrucci/pi-illustrations-to-explain-things",
-  "version": "0.1.5",
+  "version": "0.1.7",
   "description": "A pi skill for generating clean, absurd Xiaohei-style article illustrations, shot lists, and visual metaphors.",
   "keywords": [
     "pi-package",

package/extensions/inline-bash/.pi-fleet-tested-version

@@ -1 +1 @@
-0.82.0
+0.83.0

package/extensions/inline-bash/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@diegopetrucci/pi-inline-bash",
-  "version": "0.1.7",
+  "version": "0.1.9",
   "description": "A pi extension that expands inline bash commands in user prompts.",
   "keywords": [
     "pi-package",

package/extensions/librarian/.pi-fleet-tested-version

@@ -1 +1 @@
-0.82.0
+0.83.0

package/extensions/librarian/README.md

@@ -4,7 +4,7 @@ A pi GitHub research scout inspired by `pi-librarian`, with a local checkout cac
 
 When the `librarian` tool runs, it can cache/reuse repository checkouts locally. Use `/librarian-cache off` to force GitHub API/search and temporary fetched files only, or `/librarian-cache on` to re-enable cached local checkouts.
 
-The internal librarian subagent uses a fast auto-selected model by default, requests `low` thinking, and prompts its scout to batch independent GitHub probes in parallel. Use `/librarian-config` to set a persistent internal model or thinking-level preference.
+The internal librarian subagent uses a fast auto-selected model by default, requests `low` thinking, and prompts its scout to batch independent GitHub probes in parallel. Automatic candidates and fallbacks stay within the current Pi session's model scope when that scope is non-empty; an explicit tool or `/librarian-config` model remains authoritative. Use `/librarian-config` to set a persistent internal model or thinking-level preference.
 
 ## Install
 

package/extensions/librarian/index.ts

@@ -46,6 +46,31 @@ type PiModel = {
 	thinkingLevelMap?: ThinkingLevelMap;
 };
 
+type ModelSelectionContext = {
+	model?: any;
+	modelRegistry: { getAvailable(): any[] | Promise<any[]> };
+	scopedModels?: ReadonlyArray<{ model: any; thinkingLevel?: ThinkingLevel }>;
+};
+
+function modelKey(model: any): string {
+	return `${model.provider}/${model.id}`.toLowerCase();
+}
+
+function hasModelScope(ctx: ModelSelectionContext): boolean {
+	return Array.isArray(ctx.scopedModels) && ctx.scopedModels.length > 0;
+}
+
+function isModelInScope(ctx: ModelSelectionContext, model: any): boolean {
+	if (!hasModelScope(ctx)) return true;
+	const key = modelKey(model);
+	return ctx.scopedModels!.some((entry) => modelKey(entry.model) === key);
+}
+
+async function getAutoSelectableModels(ctx: ModelSelectionContext): Promise<any[]> {
+	const available = await ctx.modelRegistry.getAvailable();
+	return hasModelScope(ctx) ? available.filter((model) => isModelInScope(ctx, model)) : available;
+}
+
 type CreateAgentSessionOptions = NonNullable<Parameters<typeof createAgentSession>[0]>;
 
 function getModelRuntimeOption(ctx: { modelRegistry?: unknown }): Pick<CreateAgentSessionOptions, "modelRuntime"> {
@@ -677,7 +702,7 @@ function rankPreferredFastLibrarianModel(model: any): number {
 }
 
 async function findAvailableModel(
-	ctx: { model?: any; modelRegistry: { getAvailable(): any[] | Promise<any[]> } },
+	ctx: ModelSelectionContext,
 	modelPreference: string,
 ): Promise<any | undefined> {
 	const available = await ctx.modelRegistry.getAvailable();
@@ -732,7 +757,7 @@ function withLibrarianFallbackReason(candidate: LibrarianCandidate, previous: Li
 // these in order and skip ones that fail with a model-availability error,
 // ultimately falling back to the known-good current session model.
 async function buildLibrarianCandidates(
-	ctx: { model?: any; modelRegistry: { getAvailable(): any[] | Promise<any[]> } },
+	ctx: ModelSelectionContext,
 	modelPreference: string | undefined,
 	thinkingLevel: ThinkingLevel,
 ): Promise<LibrarianCandidate[]> {
@@ -762,7 +787,7 @@ async function buildLibrarianCandidates(
 		}
 	}
 
-	const available = await ctx.modelRegistry.getAvailable();
+	const available = await getAutoSelectableModels(ctx);
 	const preferred = available.filter(isPreferredFastLibrarianModel);
 	const ranked = preferred.length > 0
 		? [...preferred].sort((a, b) => rankPreferredFastLibrarianModel(a) - rankPreferredFastLibrarianModel(b))
@@ -785,7 +810,7 @@ async function buildLibrarianCandidates(
 	});
 
 	// Final fallback: the active session model is known to be servable.
-	if (ctx.model) {
+	if (ctx.model && isModelInScope(ctx, ctx.model)) {
 		push(ctx.model, {
 			modelRef: modelRef(ctx.model),
 			provider: ctx.model.provider,
@@ -797,7 +822,11 @@ async function buildLibrarianCandidates(
 	}
 
 	if (candidates.length === 0) {
-		throw new Error("No authenticated models are available for Librarian. Log in or configure an API key first.");
+		throw new Error(
+			hasModelScope(ctx)
+				? "No authenticated models are available for Librarian in the current session model scope. Adjust the scope, log in, or configure an API key."
+				: "No authenticated models are available for Librarian. Log in or configure an API key first.",
+		);
 	}
 
 	return candidates;

package/extensions/librarian/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@diegopetrucci/pi-librarian",
-  "version": "0.1.12",
+  "version": "0.1.14",
   "description": "A pi GitHub research scout with a toggleable local repo checkout cache under the user's OS cache directory.",
   "keywords": [
     "pi-package",

package/extensions/minimal-footer/.pi-fleet-tested-version

@@ -1 +1 @@
-0.82.0
+0.83.0

package/extensions/minimal-footer/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@diegopetrucci/pi-minimal-footer",
-  "version": "0.1.16",
+  "version": "0.1.18",
   "description": "A minimal custom footer for pi.",
   "keywords": [
     "pi-package",

package/extensions/notify/.pi-fleet-tested-version

@@ -1 +1 @@
-0.82.0
+0.83.0

package/extensions/notify/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@diegopetrucci/pi-notify",
-  "version": "0.1.13",
+  "version": "0.1.15",
   "description": "A pi extension that sends a notification when the agent is ready for input.",
   "keywords": [
     "pi-package",

package/extensions/openai-fast/.pi-fleet-tested-version

@@ -1 +1 @@
-0.82.0
+0.83.0

package/extensions/openai-fast/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@diegopetrucci/pi-openai-fast",
-  "version": "0.1.12",
+  "version": "0.1.14",
   "description": "A pi extension that enables OpenAI Codex Fast mode for ChatGPT-auth GPT-5.4, GPT-5.5, and GPT-5.6 Codex variants by injecting the priority service tier.",
   "keywords": [
     "pi-package",

package/extensions/oracle/.pi-fleet-tested-version

@@ -1 +1 @@
-0.82.0
+0.83.0

package/extensions/oracle/README.md

@@ -106,6 +106,8 @@ Tool-call parameters still win over these defaults. `auto` clears the configured
 - `thinkingLevel` - optional reasoning/thinking override; falls back to the `/oracle thinking` default, then built-in defaults
 - `cwd` - optional working directory override
 
+When the current Pi session has a non-empty model scope, Oracle limits automatic model selection and automatic fallbacks to that scope. An explicit tool or `/oracle model` override remains authoritative even when it is outside the session scope.
+
 ## Notes
 
 - The oracle is intentionally **read-only by default**.

package/extensions/oracle/index.ts

@@ -20,6 +20,31 @@ type PiModel = {
 	thinkingLevelMap?: ThinkingLevelMap;
 };
 
+type ModelSelectionContext = {
+	model?: PiModel;
+	modelRegistry: { getAvailable(): PiModel[] | Promise<PiModel[]> };
+	scopedModels?: ReadonlyArray<{ model: PiModel; thinkingLevel?: ThinkingLevel }>;
+};
+
+function modelKey(model: PiModel): string {
+	return `${model.provider}/${model.id}`.toLowerCase();
+}
+
+function hasModelScope(ctx: ModelSelectionContext): boolean {
+	return Array.isArray(ctx.scopedModels) && ctx.scopedModels.length > 0;
+}
+
+function isModelInScope(ctx: ModelSelectionContext, model: PiModel): boolean {
+	if (!hasModelScope(ctx)) return true;
+	const key = modelKey(model);
+	return ctx.scopedModels!.some((entry) => modelKey(entry.model) === key);
+}
+
+async function getAutoSelectableModels(ctx: ModelSelectionContext): Promise<PiModel[]> {
+	const available = await ctx.modelRegistry.getAvailable();
+	return hasModelScope(ctx) ? available.filter((model) => isModelInScope(ctx, model)) : available;
+}
+
 interface UsageStats {
 	input: number;
 	output: number;
@@ -82,6 +107,7 @@ const ORACLE_CONFIG_FILE = "oracle.json";
 
 const PROVIDER_MODEL_PREFERENCES: Record<string, string[]> = {
 	"amazon-bedrock": [
+		"claude-opus-5",
 		"claude-fable-5",
 		"claude-opus-4-8",
 		"claude-opus-4-7",
@@ -101,6 +127,7 @@ const PROVIDER_MODEL_PREFERENCES: Record<string, string[]> = {
 		"zai.glm-5",
 	],
 	anthropic: [
+		"claude-opus-5",
 		"claude-fable-5",
 		"claude-opus-4-8",
 		"claude-opus-4-7",
@@ -125,13 +152,8 @@ const PROVIDER_MODEL_PREFERENCES: Record<string, string[]> = {
 		"gpt-5-chat-latest",
 		"gpt-5.2-pro",
 		"gpt-5.2",
-		"gpt-5.2-codex",
-		"gpt-5.1-codex-max",
-		"gpt-5.1-codex",
 		"gpt-5.1",
-		"gpt-5.1-chat-latest",
 		"o3-pro",
-		"o3-deep-research",
 		"o1-pro",
 		"gpt-5.4-mini",
 		"gpt-5-mini",
@@ -166,8 +188,6 @@ const PROVIDER_MODEL_PREFERENCES: Record<string, string[]> = {
 		"accounts/fireworks/models/glm-5p2",
 		"accounts/fireworks/routers/glm-5p2-fast",
 		"accounts/fireworks/models/minimax-m3",
-		"accounts/fireworks/models/glm-5p1",
-		"accounts/fireworks/routers/glm-5p1-fast",
 		"accounts/fireworks/models/kimi-k2p6",
 		"accounts/fireworks/routers/kimi-k2p6-turbo",
 		"accounts/fireworks/routers/kimi-k2p6-fast",
@@ -177,6 +197,7 @@ const PROVIDER_MODEL_PREFERENCES: Record<string, string[]> = {
 		"accounts/fireworks/models/gpt-oss-20b",
 	],
 	"github-copilot": [
+		"claude-opus-5",
 		"claude-fable-5",
 		"claude-opus-4.8",
 		"claude-opus-4.7",
@@ -266,13 +287,8 @@ const PROVIDER_MODEL_PREFERENCES: Record<string, string[]> = {
 		"gpt-5-chat-latest",
 		"gpt-5.2-pro",
 		"gpt-5.2",
-		"gpt-5.2-codex",
-		"gpt-5.1-codex-max",
-		"gpt-5.1-codex",
 		"gpt-5.1",
-		"gpt-5.1-chat-latest",
 		"o3-pro",
-		"o3-deep-research",
 		"o1-pro",
 		"gpt-5.4-mini",
 		"gpt-5-mini",
@@ -287,6 +303,7 @@ const PROVIDER_MODEL_PREFERENCES: Record<string, string[]> = {
 		"gpt-5.3-codex-spark",
 	],
 	opencode: [
+		"claude-opus-5",
 		"claude-fable-5",
 		"gpt-5.5-pro",
 		"gpt-5.5",
@@ -328,6 +345,7 @@ const PROVIDER_MODEL_PREFERENCES: Record<string, string[]> = {
 		"kimi-k2.6",
 	],
 	openrouter: [
+		"anthropic/claude-opus-5",
 		"anthropic/claude-fable-5",
 		"~anthropic/claude-fable-latest",
 		"anthropic/claude-opus-4.8",
@@ -401,6 +419,7 @@ const PROVIDER_MODEL_PREFERENCES: Record<string, string[]> = {
 		"google/gemma-4-31B-it",
 	],
 	"vercel-ai-gateway": [
+		"anthropic/claude-opus-5",
 		"anthropic/claude-fable-5",
 		"anthropic/claude-opus-4.8",
 		"anthropic/claude-opus-4.7",
@@ -877,7 +896,7 @@ function appendThinkingLevelClampReason(
 }
 
 async function findAvailableModel(
-	ctx: { model?: PiModel; modelRegistry: { getAvailable(): PiModel[] | Promise<PiModel[]> } },
+	ctx: ModelSelectionContext,
 	modelRef: string,
 ): Promise<PiModel | undefined> {
 	const available = await ctx.modelRegistry.getAvailable();
@@ -923,11 +942,11 @@ function toOracleSelection(
 }
 
 function buildSessionFallbackSelection(
-	ctx: { model?: PiModel },
+	ctx: ModelSelectionContext,
 	thinkingLevelOverride: ThinkingLevel | undefined,
 ): OracleSelection | undefined {
 	const model = ctx.model;
-	if (!model) return undefined;
+	if (!model || !isModelInScope(ctx, model)) return undefined;
 	return toOracleSelection(
 		model,
 		thinkingLevelOverride,
@@ -943,14 +962,16 @@ function withFallbackReason(selection: OracleSelection, previous: OracleSelectio
 }
 
 async function selectOracleModel(
-	ctx: { model?: PiModel; modelRegistry: { getAvailable(): PiModel[] | Promise<PiModel[]> } },
+	ctx: ModelSelectionContext,
 	thinkingLevelOverride?: ThinkingLevel,
 ): Promise<{ ok: true; selection: OracleSelection; ordered: OracleSelection[] } | { ok: false; error: string }> {
-	const available = await ctx.modelRegistry.getAvailable();
+	const available = await getAutoSelectableModels(ctx);
 	if (available.length === 0) {
 		return {
 			ok: false,
-			error: "No authenticated models are available. Log in or configure an API key first.",
+			error: hasModelScope(ctx)
+				? "No authenticated models are available in the current session model scope. Adjust the scope, log in, or configure an API key."
+				: "No authenticated models are available. Log in or configure an API key first.",
 		};
 	}
 
@@ -1257,6 +1278,7 @@ type OracleExtensionDeps = {
 };
 
 export const __test__ = {
+	buildSessionFallbackSelection,
 	createOracleExtension,
 	findAvailableModel,
 	isModelAvailabilityError,

package/extensions/oracle/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@diegopetrucci/pi-oracle",
-  "version": "0.1.22",
+  "version": "0.1.24",
   "description": "An Amp-style oracle extension for pi that consults the strongest reasoning model on your current provider.",
   "keywords": [
     "pi-package",

package/extensions/permission-gate/.pi-fleet-tested-version

@@ -1 +1 @@
-0.82.0
+0.83.0

package/extensions/permission-gate/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@diegopetrucci/pi-permission-gate",
-  "version": "0.1.10",
+  "version": "0.1.12",
   "description": "A pi extension that prompts before dangerous bash commands and protected file writes.",
   "keywords": [
     "pi-package",

package/extensions/quiet-tools/.pi-fleet-tested-version

@@ -1 +1 @@
-0.82.0
+0.83.0

package/extensions/quiet-tools/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@diegopetrucci/pi-quiet-tools",
-  "version": "0.1.8",
+  "version": "0.1.10",
   "description": "A pi extension that visually compacts collapsed built-in tool rows in the TUI without changing tool results sent to the model.",
   "keywords": [
     "pi-package",

package/extensions/review/.pi-fleet-tested-version

@@ -1 +1 @@
-0.82.0
+0.83.0

package/extensions/review/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@diegopetrucci/pi-review",
-  "version": "0.1.10",
+  "version": "0.1.12",
   "description": "A standalone pi extension that adds /review and /end-review commands adapted from mitsuhiko/agent-stuff.",
   "keywords": [
     "pi-package",

package/extensions/todo/.pi-fleet-tested-version

@@ -1 +1 @@
-0.82.0
+0.83.0

package/extensions/todo/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@diegopetrucci/pi-todo",
-  "version": "0.1.7",
+  "version": "0.1.9",
   "description": "A pi extension that adds a branch-aware todo tool and /todos viewer.",
   "keywords": [
     "pi-package",

package/extensions/triage-comments/.pi-fleet-tested-version

@@ -1 +1 @@
-0.82.0
+0.83.0

package/extensions/triage-comments/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@diegopetrucci/pi-triage-comments",
-  "version": "0.1.8",
+  "version": "0.1.10",
   "description": "A pi extension that adds /triage-comments and a read-only triage_comments subagent tool for review-comment triage.",
   "keywords": [
     "pi-package",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@diegopetrucci/pi-extensions",
-  "version": "0.1.60",
+  "version": "0.1.62",
   "description": "A collection of pi extensions and skills for annotation UIs, context management, workflow audits, contrarian review, review-comment triage, notifications, brrr push alerts, safety guards, GitHub research, repo-local knowledge, todos, tool rendering, model/provider helpers, and Xiaohei-style article illustrations.",
   "keywords": [
     "pi-package",
@@ -72,9 +72,9 @@
     ]
   },
   "devDependencies": {
-    "@earendil-works/pi-ai": "^0.82.0",
-    "@earendil-works/pi-coding-agent": "^0.82.0",
-    "@earendil-works/pi-tui": "^0.82.0",
+    "@earendil-works/pi-ai": "^0.83.0",
+    "@earendil-works/pi-coding-agent": "^0.83.0",
+    "@earendil-works/pi-tui": "^0.83.0",
     "@types/node": "^25.9.1",
     "husky": "^9.1.7",
     "typebox": "^1.3.6",