omni-pi 0.8.0 → 0.8.2

package/CHANGELOG.md

@@ -1,5 +1,28 @@
 # Changelog
 
+## 0.8.2 - 2026-04-07
+
+### Single-brain runtime
+
+- removed the legacy multi-agent execution path and deleted the dormant subagent runtime
+- simplified task execution to a single-brain retry flow with recovery notes instead of worker/expert escalation
+- removed outdated worker, expert, and planner role/config concepts so runtime, config, and tests now match the current brain-only architecture
+
+### Startup
+
+- defaulted first-run `omni` launcher installs to quiet startup so package resource listings do not appear unless the user opts in
+
+### Model setup and config
+
+- simplified Omni model configuration to a single `brain` model assignment
+- stopped offering automatic model discovery for `google-generative-ai`, which was not implemented
+- stopped persisting fake placeholder API keys for local or unauthenticated custom providers
+
+### Dependencies
+
+- removed the unused `pi-subagents` dependency
+- added npm overrides for `@mozilla/readability`, `brace-expansion`, `picomatch`, and `vite`
+
 ## 0.8.0 - 2026-04-06
 
 ### Runtime and UX

package/PROVIDERS.md

@@ -30,6 +30,8 @@ If a bundled provider already has valid auth in the Pi runtime, Omni-Pi may use
 
 Use `/manage-providers` to list bundled providers that currently have stored auth and remove that auth when needed.
 
+Anthropic is API-key-only in Omni-Pi. Anthropic OAuth login is intentionally disabled.
+
 The bundled-provider list below is expected to stay in sync with the exported provider setup list in `src/model-setup.ts`. The test suite checks that this section matches the code list.
 
 ### Bundled provider list

package/README.md

@@ -10,7 +10,7 @@ Requires Node.js 22 or newer.
 
 ## What It Does
 
-- Starts in normal Pi behavior by default while keeping Omni-Pi branding and UI.
+- Starts in normal Pi behavior with an opinionated setup.
 - `/omni-mode` turns on Omni's specialized interview, plan, build, and verify workflow for the current project.
 - Keeps durable standards and project context in `.omni/`, even when Omni mode is off.
 - Writes specs, tasks, and progress into `.omni/` once Omni mode is enabled.
@@ -96,6 +96,8 @@ Use it when you want to configure:
 
 Use `/manage-providers` to remove stored auth for bundled Pi providers.
 
+Anthropic is intentionally API-key-only in Omni-Pi. Anthropic OAuth login is disabled.
+
 See [PROVIDERS.md](PROVIDERS.md) for the current supported-provider list and auth-management split.
 
 ## Omni Mode

package/bin/omni.js

@@ -1,7 +1,8 @@
 #!/usr/bin/env node
 
 import { spawn } from "node:child_process";
-import { realpathSync } from "node:fs";
+import { mkdirSync, readFileSync, realpathSync, writeFileSync } from "node:fs";
+import os from "node:os";
 import path from "node:path";
 import { fileURLToPath } from "node:url";
 
@@ -26,6 +27,60 @@ export function buildOmniEnvironment(baseEnv = process.env) {
   };
 }
 
+function resolveAgentDir(baseEnv = process.env) {
+  const envDir = baseEnv.PI_CODING_AGENT_DIR;
+  if (!envDir) {
+    return path.join(os.homedir(), ".pi", "agent");
+  }
+
+  if (envDir === "~") {
+    return os.homedir();
+  }
+
+  if (envDir.startsWith("~/")) {
+    return path.join(os.homedir(), envDir.slice(2));
+  }
+
+  return envDir;
+}
+
+export function ensureQuietStartupDefault(baseEnv = process.env) {
+  const agentDir = resolveAgentDir(baseEnv);
+  const settingsFile = path.join(agentDir, "settings.json");
+
+  try {
+    const raw = readFileSync(settingsFile, "utf8");
+    const parsed = JSON.parse(raw);
+    if (
+      parsed &&
+      typeof parsed === "object" &&
+      parsed.quietStartup === undefined
+    ) {
+      writeFileSync(
+        settingsFile,
+        `${JSON.stringify({ ...parsed, quietStartup: true }, null, 2)}\n`,
+        "utf8",
+      );
+    }
+  } catch (error) {
+    const code =
+      error && typeof error === "object" && "code" in error
+        ? error.code
+        : undefined;
+
+    if (code !== "ENOENT") {
+      return;
+    }
+
+    mkdirSync(agentDir, { recursive: true });
+    writeFileSync(
+      settingsFile,
+      `${JSON.stringify({ quietStartup: true }, null, 2)}\n`,
+      "utf8",
+    );
+  }
+}
+
 export function buildPiProcessSpec(
   argv = process.argv.slice(2),
   baseEnv = process.env,
@@ -38,6 +93,7 @@ export function buildPiProcessSpec(
 }
 
 export async function runOmni(argv = process.argv.slice(2), options = {}) {
+  ensureQuietStartupDefault(options.env);
   const spec = buildPiProcessSpec(argv, options.env);
 
   await new Promise((resolve, reject) => {

package/extensions/omni-providers/index.ts

@@ -1,5 +1,6 @@
 import type { ExtensionAPI } from "@mariozechner/pi-coding-agent";
 
+import { disableAnthropicOAuth } from "../../src/anthropic-auth-guard.js";
 import { refreshAuthenticatedProviderModels } from "../../src/model-setup.js";
 import { registerOmniProviders } from "../../src/providers.js";
 
@@ -9,6 +10,7 @@ export default async function omniProvidersExtension(
   await registerOmniProviders(api);
 
   api.on("session_start", async (_event, ctx) => {
+    disableAnthropicOAuth(ctx.modelRegistry);
     await refreshAuthenticatedProviderModels(ctx.modelRegistry);
   });
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "omni-pi",
-  "version": "0.8.0",
+  "version": "0.8.2",
   "description": "Single-agent Pi package that interviews the user, documents the spec, and implements work in bounded slices.",
   "type": "module",
   "license": "MIT",
@@ -83,8 +83,13 @@
     "@mariozechner/pi-coding-agent": "^0.65.2",
     "glimpseui": "^0.6.2",
     "pi-interview": "^0.5.5",
-    "pi-subagents": "^0.11.11",
     "pi-web-access": "^0.10.3",
     "zod": "^4.3.6"
+  },
+  "overrides": {
+    "@mozilla/readability": "0.6.0",
+    "brace-expansion": "5.0.5",
+    "picomatch": "4.0.4",
+    "vite": "7.3.2"
   }
 }

package/src/anthropic-auth-guard.ts

@@ -0,0 +1,95 @@
+interface AnthropicCredential {
+  type: "api_key";
+  key: string;
+}
+
+interface AuthStorageLike {
+  get?(provider: string): AnthropicCredential | { type: "oauth" } | undefined;
+  getApiKey?(
+    provider: string,
+    options?: { includeFallback?: boolean },
+  ): Promise<string | undefined>;
+  hasAuth?(provider: string): boolean;
+  getOAuthProviders?(): Array<{ id: string; name?: string }>;
+  login?(providerId: string, callbacks: unknown): Promise<void>;
+}
+
+interface ModelRegistryLike {
+  authStorage: AuthStorageLike;
+  refresh(): void;
+  __omniAnthropicAuthGuardInstalled?: boolean;
+}
+
+function getAnthropicApiKeyFromStorage(
+  authStorage: AuthStorageLike,
+): string | undefined {
+  const envApiKey = process.env.ANTHROPIC_API_KEY?.trim();
+  if (envApiKey) {
+    return envApiKey;
+  }
+
+  const stored = authStorage.get?.("anthropic");
+  if (stored?.type === "api_key" && stored.key.trim()) {
+    return stored.key.trim();
+  }
+
+  return undefined;
+}
+
+export function disableAnthropicOAuthInAuthStorage(
+  authStorage: AuthStorageLike,
+): void {
+  const originalGetApiKey = authStorage.getApiKey?.bind(authStorage);
+  const originalGetOAuthProviders =
+    authStorage.getOAuthProviders?.bind(authStorage);
+  authStorage.getApiKey = async (
+    provider: string,
+    options?: { includeFallback?: boolean },
+  ) => {
+    if (provider !== "anthropic") {
+      return originalGetApiKey?.(provider, options);
+    }
+
+    return getAnthropicApiKeyFromStorage(authStorage);
+  };
+
+  const originalHasAuth = authStorage.hasAuth?.bind(authStorage);
+  authStorage.hasAuth = (provider: string) => {
+    if (provider !== "anthropic") {
+      return originalHasAuth?.(provider) ?? false;
+    }
+
+    return getAnthropicApiKeyFromStorage(authStorage) !== undefined;
+  };
+
+  authStorage.getOAuthProviders = () =>
+    (originalGetOAuthProviders?.() ?? []).filter(
+      (provider) => provider.id !== "anthropic",
+    );
+
+  const originalLogin = authStorage.login?.bind(authStorage);
+  authStorage.login = async (providerId: string, callbacks: unknown) => {
+    if (providerId === "anthropic") {
+      throw new Error(
+        "Anthropic OAuth login is disabled in Omni-Pi. Use an Anthropic API key instead.",
+      );
+    }
+
+    await originalLogin?.(providerId, callbacks);
+  };
+}
+
+export function disableAnthropicOAuth(modelRegistry: ModelRegistryLike): void {
+  disableAnthropicOAuthInAuthStorage(modelRegistry.authStorage);
+
+  if (modelRegistry.__omniAnthropicAuthGuardInstalled) {
+    return;
+  }
+
+  const originalRefresh = modelRegistry.refresh.bind(modelRegistry);
+  modelRegistry.refresh = () => {
+    originalRefresh();
+    disableAnthropicOAuthInAuthStorage(modelRegistry.authStorage);
+  };
+  modelRegistry.__omniAnthropicAuthGuardInstalled = true;
+}

package/src/brain.ts

@@ -33,7 +33,7 @@ Your workflow is mandatory:
 
 Behavior rules:
 - Stay friendly, plain-spoken, direct, and efficient with tokens/context.
-- Do not expose planner/worker/expert role handoffs. Everything happens behind the scenes.
+- Do not expose internal handoffs or legacy role concepts. Everything happens behind the scenes.
 - If the request is not fully clear enough to implement safely without guessing, use the interview tool to ask targeted clarification questions instead of asking them in chat.
 - Do not start editing code until the spec is explicit enough to avoid guessing.
 - In this repo, treat direct user instructions as requested Omni app/product behavior by default unless the user explicitly marks them as meta instructions for the agent/session.

package/src/config.ts

@@ -6,13 +6,8 @@ import { AVAILABLE_MODELS } from "./providers.js";
 
 export const DEFAULT_CONFIG: OmniConfig = {
   models: {
-    worker: "anthropic/claude-sonnet-4-6",
-    expert: "openai/gpt-5.4",
-    planner: "openai/gpt-5.4",
     brain: "anthropic/claude-opus-4-6",
   },
-  retryLimit: 2,
-  chainEnabled: false,
   cleanupCompletedPlans: false,
 };
 
@@ -38,24 +33,14 @@ function parseModelTable(
     if (rowMatch) {
       const agent = rowMatch[1].trim().toLowerCase();
       const model = rowMatch[2].trim();
-      models[agent] = model;
+      if (model.length > 0) {
+        models[agent] = model;
+      }
     }
   }
   return models;
 }
 
-function parseRetryLimit(content: string): number {
-  const match = content.match(
-    /(?:Implementation retries before the plan must be tightened|Worker retries before expert takeover):\s*(\d+)/u,
-  );
-  return match ? Number.parseInt(match[1], 10) : DEFAULT_CONFIG.retryLimit;
-}
-
-function parseChainEnabled(content: string): boolean {
-  const match = content.match(/Chain execution enabled:\s*(true|false)/u);
-  return match ? match[1] === "true" : DEFAULT_CONFIG.chainEnabled;
-}
-
 function parseCleanupCompletedPlans(content: string): boolean {
   const match = content.match(/Delete completed plan files:\s*(true|false)/u);
   return match ? match[1] === "true" : DEFAULT_CONFIG.cleanupCompletedPlans;
@@ -66,17 +51,11 @@ export async function readConfig(rootDir: string): Promise<OmniConfig> {
   try {
     const content = await readFile(configPath, "utf8");
     const models = parseModelTable(content, "## Models");
-    const retryLimit = parseRetryLimit(content);
 
     return {
       models: {
-        worker: models.worker ?? DEFAULT_CONFIG.models.worker,
-        expert: models.expert ?? DEFAULT_CONFIG.models.expert,
-        planner: models.planner ?? DEFAULT_CONFIG.models.planner,
         brain: models.brain ?? DEFAULT_CONFIG.models.brain,
       },
-      retryLimit,
-      chainEnabled: parseChainEnabled(content),
       cleanupCompletedPlans: parseCleanupCompletedPlans(content),
     };
   } catch {
@@ -91,19 +70,8 @@ function renderConfigContent(config: OmniConfig): string {
 
 | Agent | Model |
 |-------|-------|
-| worker | ${config.models.worker} |
-| expert | ${config.models.expert} |
-| planner | ${config.models.planner} |
 | brain | ${config.models.brain} |
 
-## Retry Policy
-
-Implementation retries before the plan must be tightened: ${config.retryLimit}
-
-## Execution
-
-Chain execution enabled: ${config.chainEnabled}
-
 ## Memory
 
 Delete completed plan files: ${config.cleanupCompletedPlans}
@@ -125,7 +93,7 @@ export async function updateModelConfig(
   model: string,
 ): Promise<OmniConfig> {
   const config = await readConfig(rootDir);
-  const validAgents = ["worker", "expert", "planner", "brain"] as const;
+  const validAgents = ["brain"] as const;
   const normalizedAgent = agent.toLowerCase() as (typeof validAgents)[number];
 
   if (!validAgents.includes(normalizedAgent)) {

package/src/contracts.ts

@@ -32,7 +32,6 @@ export interface TaskBrief {
   contextFiles: string[];
   skills: string[];
   doneCriteria: string[];
-  role: "worker" | "expert";
   status: TaskStatus;
   dependsOn: string[];
 }
@@ -51,20 +50,6 @@ export interface TaskAttemptResult {
   modifiedFiles?: string[];
 }
 
-export interface EscalationBrief {
-  taskId: string;
-  priorAttempts: number;
-  failureLogs: string[];
-  expertObjective: string;
-  verificationResults?: Array<{
-    command: string;
-    passed: boolean;
-    stdout: string;
-    stderr: string;
-  }>;
-  modifiedFiles?: string[];
-}
-
 export interface SkillCandidate {
   name: string;
   reason: string;
@@ -94,7 +79,7 @@ export interface PresetConfig {
   maxTasks: number;
   skipInterview: boolean;
   requireVerification: boolean;
-  workerHint: string;
+  executionHint: string;
 }
 
 export const WORKFLOW_PRESETS: Record<WorkflowPreset, PresetConfig> = {
@@ -105,7 +90,7 @@ export const WORKFLOW_PRESETS: Record<WorkflowPreset, PresetConfig> = {
     maxTasks: 2,
     skipInterview: true,
     requireVerification: true,
-    workerHint:
+    executionHint:
       "Focus on the root cause. Write a regression test before fixing.",
   },
   feature: {
@@ -115,7 +100,7 @@ export const WORKFLOW_PRESETS: Record<WorkflowPreset, PresetConfig> = {
     maxTasks: 8,
     skipInterview: false,
     requireVerification: true,
-    workerHint: "Follow the spec. Keep tasks bounded and verifiable.",
+    executionHint: "Follow the spec. Keep tasks bounded and verifiable.",
   },
   refactor: {
     name: "refactor",
@@ -123,7 +108,7 @@ export const WORKFLOW_PRESETS: Record<WorkflowPreset, PresetConfig> = {
     maxTasks: 5,
     skipInterview: true,
     requireVerification: true,
-    workerHint:
+    executionHint:
       "Preserve all existing behavior. Run the full test suite after each change.",
   },
   spike: {
@@ -133,7 +118,7 @@ export const WORKFLOW_PRESETS: Record<WorkflowPreset, PresetConfig> = {
     maxTasks: 1,
     skipInterview: true,
     requireVerification: false,
-    workerHint: "Explore freely. Document findings in .omni/research/.",
+    executionHint: "Explore freely. Document findings in .omni/research/.",
   },
   "security-audit": {
     name: "security-audit",
@@ -141,7 +126,7 @@ export const WORKFLOW_PRESETS: Record<WorkflowPreset, PresetConfig> = {
     maxTasks: 3,
     skipInterview: true,
     requireVerification: false,
-    workerHint:
+    executionHint:
       "Analyze for OWASP Top 10, secrets in code, dependency vulnerabilities. Do not modify source code.",
   },
 };
@@ -162,13 +147,8 @@ export function detectPreset(
 
 export interface OmniConfig {
   models: {
-    worker: string;
-    expert: string;
-    planner: string;
     brain: string;
   };
-  retryLimit: number;
-  chainEnabled: boolean;
   cleanupCompletedPlans: boolean;
 }
 

package/src/doctor.ts

@@ -50,15 +50,12 @@ async function checkConfigParseable(
 ): Promise<DiagnosticResult> {
   try {
     const config = await readConfig(rootDir);
-    const roles = ["worker", "expert", "planner", "brain"] as const;
-    for (const role of roles) {
-      if (!config.models[role]) {
-        return {
-          name: "config",
-          level: "yellow",
-          message: `Model for ${role} is empty in CONFIG.md.`,
-        };
-      }
+    if (!config.models.brain) {
+      return {
+        name: "config",
+        level: "yellow",
+        message: "Model for brain is empty in CONFIG.md.",
+      };
     }
     return { name: "config", level: "green", message: "Config is valid." };
   } catch {

package/src/model-setup.ts

@@ -473,21 +473,32 @@ export async function setupCustomProviderModel(
     apiKey,
   };
 
+  const setupOptions =
+    apiChoice === "google-generative-ai"
+      ? [
+          {
+            label: "Add a single model manually",
+            value: "manual",
+            searchText: "manual single model",
+          },
+        ]
+      : [
+          {
+            label: "Discover models automatically",
+            value: "discover",
+            searchText: "discover automatic provider models",
+          },
+          {
+            label: "Add a single model manually",
+            value: "manual",
+            searchText: "manual single model",
+          },
+        ];
+
   const setupMode = await searchableSelect(
     ui,
     `How should Omni-Pi configure ${provider}?`,
-    [
-      {
-        label: "Discover models automatically",
-        value: "discover",
-        searchText: "discover automatic provider models",
-      },
-      {
-        label: "Add a single model manually",
-        value: "manual",
-        searchText: "manual single model",
-      },
-    ],
+    setupOptions,
   );
   if (!setupMode) {
     return { summary: "Custom provider setup cancelled." };
@@ -612,7 +623,7 @@ async function setupDiscoveredProvider(
 
 export function buildCustomProviderConfigUpdate(
   current: ModelsJsonProviderConfig,
-  provider: string,
+  _provider: string,
   submission: BrowserCustomModelSubmission,
 ): ModelsJsonProviderConfig {
   const modelId = submission.modelId.trim();
@@ -624,8 +635,11 @@ export function buildCustomProviderConfigUpdate(
     ...current,
     baseUrl: normalizeBaseUrl(submission.baseUrl),
     api: submission.api,
-    apiKey:
-      submission.apiKey?.trim() || current.apiKey || `${provider}-local-key`,
+    ...(submission.apiKey?.trim()
+      ? { apiKey: submission.apiKey.trim() }
+      : current.apiKey?.trim()
+        ? { apiKey: current.apiKey.trim() }
+        : {}),
     authHeader:
       submission.api === "openai-completions" ||
       submission.api === "openai-responses",
@@ -643,7 +657,7 @@ export function buildCustomProviderConfigUpdate(
 
 export function buildDiscoveredProviderConfigUpdate(
   current: ModelsJsonProviderConfig,
-  provider: string,
+  _provider: string,
   submission: ProviderConnectionSubmission,
   discovered: OmniProviderModel[],
 ): ModelsJsonProviderConfig {
@@ -656,8 +670,11 @@ export function buildDiscoveredProviderConfigUpdate(
     ...current,
     baseUrl: normalizeBaseUrl(submission.baseUrl),
     api: submission.api,
-    apiKey:
-      submission.apiKey?.trim() || current.apiKey || `${provider}-local-key`,
+    ...(submission.apiKey?.trim()
+      ? { apiKey: submission.apiKey.trim() }
+      : current.apiKey?.trim()
+        ? { apiKey: current.apiKey.trim() }
+        : {}),
     authHeader:
       submission.api === "openai-completions" ||
       submission.api === "openai-responses",
@@ -803,26 +820,8 @@ function renderBrowserModelSelectionPage(
     <main>
       <section class="panel">
         <h1>Configure Omni-Pi models</h1>
-        <p>Search Pi's available models for each role, then save all assignments in one pass.</p>
+        <p>Search Pi's available models, then save the single brain assignment.</p>
         <div class="grid">
-          <section class="role" data-role="worker">
-            <h2>worker</h2>
-            <label>Search<input id="search-worker" placeholder="Filter models" /></label>
-            <label>Selected model<input id="selected-worker" value="${escapeHtml(currentModels.worker)}" /></label>
-            <div id="results-worker" class="list"></div>
-          </section>
-          <section class="role" data-role="expert">
-            <h2>expert</h2>
-            <label>Search<input id="search-expert" placeholder="Filter models" /></label>
-            <label>Selected model<input id="selected-expert" value="${escapeHtml(currentModels.expert)}" /></label>
-            <div id="results-expert" class="list"></div>
-          </section>
-          <section class="role" data-role="planner">
-            <h2>planner</h2>
-            <label>Search<input id="search-planner" placeholder="Filter models" /></label>
-            <label>Selected model<input id="selected-planner" value="${escapeHtml(currentModels.planner)}" /></label>
-            <div id="results-planner" class="list"></div>
-          </section>
           <section class="role" data-role="brain">
             <h2>brain</h2>
             <label>Search<input id="search-brain" placeholder="Filter models" /></label>
@@ -830,13 +829,13 @@ function renderBrowserModelSelectionPage(
             <div id="results-brain" class="list"></div>
           </section>
         </div>
-        <button id="save">Save Model Assignments</button>
+        <button id="save">Save Brain Model</button>
       </section>
     </main>
     <script>
       const models = ${modelsJson};
       const currentModels = ${currentModelsJson};
-      const roles = ['worker', 'expert', 'planner', 'brain'];
+      const roles = ['brain'];
 
       const renderRole = (role) => {
         const searchEl = document.getElementById('search-' + role);
@@ -871,9 +870,6 @@ function renderBrowserModelSelectionPage(
           headers: { 'Content-Type': 'application/json' },
           body: JSON.stringify({
             selectedModels: {
-              worker: document.getElementById('selected-worker').value,
-              expert: document.getElementById('selected-expert').value,
-              planner: document.getElementById('selected-planner').value,
               brain: document.getElementById('selected-brain').value
             }
           })

package/src/planning.ts

@@ -119,7 +119,6 @@ function buildBootstrapTasks(repoSignals: RepoSignals): TaskBrief[] {
         "Constraints are captured.",
         "Success criteria are explicit.",
       ],
-      role: "worker",
       status: "todo",
       dependsOn: [],
     },
@@ -135,7 +134,6 @@ function buildBootstrapTasks(repoSignals: RepoSignals): TaskBrief[] {
         "Each task has explicit done criteria.",
         "Verification requirements are listed.",
       ],
-      role: "worker",
       status: "todo",
       dependsOn: ["T01"],
     },
@@ -156,7 +154,6 @@ function buildBootstrapTasks(repoSignals: RepoSignals): TaskBrief[] {
         "Browser testing expectations are documented.",
         "The verification plan names the browser toolchain.",
       ],
-      role: "worker",
       status: "todo",
       dependsOn: ["T02"],
     });
@@ -289,7 +286,7 @@ export function createInitialSpec(
   ];
 
   if (presetConfig) {
-    architecture.push(`Implementation hint: ${presetConfig.workerHint}`);
+    architecture.push(`Implementation hint: ${presetConfig.executionHint}`);
   }
 
   if (planningCtx?.existingDecisions.length) {
@@ -383,10 +380,6 @@ ${rows.join("\n")}
 export function renderTestsMarkdown(repoSignals: RepoSignals): string {
   const projectChecks = ["npm test"];
 
-  if (repoSignals.tools.includes("vitest")) {
-    projectChecks.push("npm run test");
-  }
-
   if (repoSignals.tools.includes("playwright")) {
     projectChecks.push("npx playwright test");
   }