oh-my-opencode-slim 2.1.0 → 2.2.0

package/dist/tui.js

@@ -131,7 +131,12 @@ var POLL_INTERVAL_BACKGROUND_MS = 2000;
 var MAX_POLL_TIME_MS = 5 * 60 * 1000;
 var DEFAULT_MAX_SUBAGENT_DEPTH = 3;
 var PHASE_REMINDER_TEXT = `!IMPORTANT! Scheduler workflow: plan lanes/dependencies → dispatch background specialists → track task IDs → wait for hook-driven completion → reconcile terminal results → verify. Do not poll running jobs, consume running-job output, or advance dependent work. !END!`;
-var PHASE_REMINDER = `<internal_reminder>${PHASE_REMINDER_TEXT}</internal_reminder>`;
+function formatSystemReminder(text) {
+  return `<system-reminder>
+${text}
+</system-reminder>`;
+}
+var PHASE_REMINDER = formatSystemReminder(PHASE_REMINDER_TEXT);
 var WRITABLE_FILE_OPERATIONS_RULES = `**File Operations Rules**:
 - Prefer dedicated file tools for normal code work: glob/grep/ast_grep_search for discovery, read for file contents, and edit/write/apply_patch for targeted source changes.
 - Use bash for execution and automation: git, package managers, tests, builds, scripts, diagnostics, and shell-native filesystem operations.
@@ -150,6 +155,13 @@ var NO_SHELL_READONLY_FILE_OPERATIONS_RULES = `**File Operations Rules**:
 var TMUX_SPAWN_DELAY_MS = 500;
 var COUNCILLOR_STAGGER_MS = 250;
 var DEFAULT_DISABLED_AGENTS = ["observer"];
+var DEFAULT_MAX_SESSIONS_PER_AGENT = 2;
+var DEFAULT_READ_CONTEXT_MIN_LINES = 10;
+var DEFAULT_READ_CONTEXT_MAX_FILES = 8;
+var DEFAULT_IMAGE_ROUTING = "auto";
+function resolveImageRouting(imageRouting) {
+  return imageRouting ?? DEFAULT_IMAGE_ROUTING;
+}
 
 // src/config/loader.ts
 import * as fs from "node:fs";
@@ -188,11 +200,35 @@ function getOpenCodeConfigPaths() {
 }
 // src/config/council-schema.ts
 import { z } from "zod";
-var ModelIdSchema = z.string().regex(/^[^/\s]+\/[^\s]+$/, 'Expected provider/model format (e.g. "openai/gpt-5.4-mini")');
+
+// src/utils/councillor-models.ts
+function normalizeCouncillorModels(model, fallbackVariant) {
+  const raw = Array.isArray(model) ? model : [model];
+  return raw.map((entry) => typeof entry === "string" ? { id: entry, variant: fallbackVariant } : { id: entry.id, variant: entry.variant ?? fallbackVariant });
+}
+
+// src/config/council-schema.ts
+var ModelIdSchema = z.string().regex(/^[^/\s]+\/[^\s]+$/, 'Expected provider/model format (e.g. "openai/gpt-5.6-luna")');
+var CouncillorModelEntrySchema = z.object({
+  id: ModelIdSchema,
+  variant: z.string().optional()
+});
+var CouncillorModelSchema = z.union([
+  ModelIdSchema,
+  z.array(z.union([ModelIdSchema, CouncillorModelEntrySchema])).min(1)
+]).describe('Model ID in provider/model format (e.g. "openai/gpt-5.6-luna"), or an ' + "ordered fallback chain (array of model IDs or { id, variant } entries) " + "tried in order until one responds.");
 var CouncillorConfigSchema = z.object({
-  model: ModelIdSchema.describe('Model ID in provider/model format (e.g. "openai/gpt-5.4-mini")'),
+  model: CouncillorModelSchema,
   variant: z.string().optional(),
   prompt: z.string().optional().describe("Optional role/guidance injected into the councillor user prompt")
+}).transform((c) => {
+  const models = normalizeCouncillorModels(c.model, c.variant);
+  return {
+    model: models[0].id,
+    variant: c.variant,
+    prompt: c.prompt,
+    models
+  };
 });
 var CouncilPresetSchema = z.record(z.string(), z.record(z.string(), z.unknown())).transform((entries, ctx) => {
   const councillors = {};
@@ -278,6 +314,33 @@ var ManualPlanSchema = z2.object({
   librarian: ManualAgentPlanSchema,
   fixer: ManualAgentPlanSchema
 }).strict();
+var PermissionActionSchema = z2.enum(["ask", "allow", "deny"]);
+var PermissionRuleSchema = z2.union([
+  PermissionActionSchema,
+  z2.record(z2.string(), PermissionActionSchema)
+]);
+var PermissionObjectSchema = z2.object({
+  read: PermissionRuleSchema.optional(),
+  edit: PermissionRuleSchema.optional(),
+  glob: PermissionRuleSchema.optional(),
+  grep: PermissionRuleSchema.optional(),
+  list: PermissionRuleSchema.optional(),
+  bash: PermissionRuleSchema.optional(),
+  task: PermissionRuleSchema.optional(),
+  external_directory: PermissionRuleSchema.optional(),
+  lsp: PermissionRuleSchema.optional(),
+  skill: PermissionRuleSchema.optional(),
+  todowrite: PermissionActionSchema.optional(),
+  question: PermissionActionSchema.optional(),
+  webfetch: PermissionActionSchema.optional(),
+  websearch: PermissionActionSchema.optional(),
+  codesearch: PermissionActionSchema.optional(),
+  doom_loop: PermissionActionSchema.optional()
+}).catchall(PermissionRuleSchema);
+var PermissionConfigSchema = z2.union([
+  PermissionActionSchema,
+  PermissionObjectSchema
+]);
 var AgentOverrideConfigSchema = z2.object({
   model: z2.union([
     z2.string(),
@@ -296,13 +359,15 @@ var AgentOverrideConfigSchema = z2.object({
   prompt: z2.string().min(1).optional(),
   orchestratorPrompt: z2.string().min(1).optional(),
   options: z2.record(z2.string(), z2.unknown()).optional(),
-  displayName: z2.string().min(1).optional()
+  displayName: z2.string().min(1).optional(),
+  permission: PermissionConfigSchema.optional()
 }).strict();
 var MultiplexerTypeSchema = z2.enum([
   "auto",
   "tmux",
   "zellij",
   "herdr",
+  "cmux",
   "none"
 ]);
 var MultiplexerLayoutSchema = z2.enum([
@@ -346,7 +411,9 @@ var FailoverConfigSchema = z2.object({
   enabled: z2.boolean().default(true),
   timeoutMs: z2.number().min(0).default(15000),
   retryDelayMs: z2.number().min(0).default(500),
-  retry_on_empty: z2.boolean().default(true).describe("When true (default), empty provider responses are treated as failures, " + "triggering fallback/retry. Set to false to treat them as successes.")
+  maxRetries: z2.number().int().min(0).default(3).describe("Number of consecutive 429/rate-limit responses tolerated on the " + "same model before aborting (or swapping to the next fallback " + "model when a chain is configured)."),
+  retry_on_empty: z2.boolean().default(true).describe("When true (default), empty provider responses are treated as failures, " + "triggering fallback/retry. Set to false to treat them as successes."),
+  runtimeOverride: z2.boolean().optional().describe("DEPRECATED: no longer used. Previously controlled whether out-of-chain " + "runtime model picks triggered fallback. Fallback is now always " + "disabled when a user explicitly selects a model via /model.")
 }).strict();
 var CompanionConfigSchema = z2.object({
   enabled: z2.boolean().optional(),
@@ -387,12 +454,14 @@ function rejectOrchestratorPromptOnOrchestrator(overrides, ctx, pathPrefix) {
 var PluginConfigSchema = z2.object({
   preset: z2.string().optional(),
   setDefaultAgent: z2.boolean().optional(),
-  compactSidebar: z2.boolean().optional().describe("Use the compact TUI sidebar layout when enabled."),
+  compactSidebar: z2.boolean().optional().describe("Use the compact TUI sidebar layout. Defaults to true; set false to use the expanded layout."),
+  stripOrchestratorModel: z2.boolean().optional().describe("When true, omit orchestrator.model and orchestrator.variant from the SDK config so OpenCode uses the session model selected with /model after subagent dispatch. An explicitly selected preset that sets orchestrator.model is preserved. Defaults to false."),
   autoUpdate: z2.boolean().optional().describe("Disable automatic installation of plugin updates when false. Defaults to true."),
   presets: z2.record(z2.string(), PresetSchema).optional(),
   agents: z2.record(z2.string(), AgentOverrideConfigSchema).optional(),
   disabled_agents: z2.array(z2.string()).optional().describe("Agent names to disable completely. " + "Disabled agents are not instantiated and cannot be delegated to. " + "Orchestrator and council internal agents (councillor) cannot be disabled. " + "By default, 'observer' is disabled. Remove it from this list and configure a vision-capable model to enable."),
-  disabled_mcps: z2.array(z2.string()).optional(),
+  image_routing: z2.enum(["auto", "direct"]).optional().describe("How image attachments are handled. " + "When omitted, preserves legacy conditional behavior: intercept " + 'attachments only when observer is enabled. "auto": requires ' + "observer to be enabled and saves attachments to disk before " + 'nudging delegation to @observer. "direct": always passes ' + "attachments to the orchestrator untouched."),
+  disabled_mcps: z2.array(z2.string()).optional().describe("MCP server names to disable completely. Disabled servers are not " + "started and cannot be used by agents."),
   disabled_tools: z2.array(z2.string()).optional().describe("Tool names to disable completely. Disabled tools are not registered with OpenCode and cannot be used by agents."),
   disabled_skills: z2.array(z2.string()).optional().describe("Skill names to disable completely. Disabled skills are not granted to agents, even when referenced by presets or agent overrides."),
   multiplexer: MultiplexerConfigSchema.optional(),
@@ -495,6 +564,12 @@ var CUSTOM_SKILLS = [
     allowedAgents: ["orchestrator"],
     sourcePath: "src/skills/deepwork"
   },
+  {
+    name: "verification-planning",
+    description: "Plan credible, proportionate evidence before non-trivial implementation",
+    allowedAgents: ["orchestrator"],
+    sourcePath: "src/skills/verification-planning"
+  },
   {
     name: "reflect",
     description: "Review repeated work and suggest reusable workflow improvements",
@@ -599,6 +674,23 @@ function findConfigPathInDirs(configDirs, baseName) {
   }
   return null;
 }
+function validateFinalImageRouting(config, configPath, options) {
+  if (config.image_routing !== "auto")
+    return true;
+  const disabledAgents = config.disabled_agents ?? DEFAULT_DISABLED_AGENTS;
+  if (!disabledAgents.includes("observer"))
+    return true;
+  const message = 'image_routing "auto" requires observer to be enabled. ' + 'Remove "observer" from disabled_agents.';
+  options?.onWarning?.({
+    path: configPath,
+    kind: "invalid-schema",
+    message
+  });
+  if (!options?.silent) {
+    console.warn(`[oh-my-opencode-slim] Invalid config: ${message}`);
+  }
+  return false;
+}
 function findPluginConfigPaths(directory) {
   const userConfigPath = findConfigPathInDirs(getConfigSearchDirs(), "oh-my-opencode-slim");
   const projectConfigBasePath = path.join(directory, ".opencode", "oh-my-opencode-slim");
@@ -680,6 +772,7 @@ function loadPluginConfig(directory, options) {
       debug: config.companion.debug ?? false
     };
   }
+  validateFinalImageRouting(config, projectConfigPath ?? userConfigPath ?? "", options);
   return config;
 }
 function loadAgentPrompt(agentName, optionsOrPreset) {
@@ -745,6 +838,7 @@ function migrateTmuxToMultiplexer(config) {
 }
 
 // src/tui-state.ts
+import { createHash } from "node:crypto";
 import * as fs2 from "node:fs";
 import * as os from "node:os";
 import * as path2 from "node:path";
@@ -753,8 +847,11 @@ var STATE_FILE = "tui-state.json";
 function dataDir() {
   return process.env.XDG_DATA_HOME ?? path2.join(os.homedir(), ".local", "share");
 }
-function getTuiStatePath() {
-  return path2.join(dataDir(), "opencode", "storage", STATE_DIR, STATE_FILE);
+function projectScope(projectDir) {
+  return createHash("sha256").update(path2.resolve(projectDir)).digest("hex").slice(0, 12);
+}
+function getTuiStatePath(projectDir) {
+  return path2.join(dataDir(), "opencode", "storage", STATE_DIR, projectScope(projectDir), STATE_FILE);
 }
 function emptySnapshot() {
   return {
@@ -775,42 +872,42 @@ function parseSnapshot(value) {
     agentVariants: parsed.agentVariants ?? {}
   };
 }
-function readTuiSnapshot() {
+function readTuiSnapshot(projectDir) {
   try {
-    return parseSnapshot(fs2.readFileSync(getTuiStatePath(), "utf8"));
+    return parseSnapshot(fs2.readFileSync(getTuiStatePath(projectDir), "utf8"));
   } catch {
     return emptySnapshot();
   }
 }
-async function readTuiSnapshotAsync() {
+async function readTuiSnapshotAsync(projectDir) {
   try {
-    return parseSnapshot(await fs2.promises.readFile(getTuiStatePath(), "utf8"));
+    return parseSnapshot(await fs2.promises.readFile(getTuiStatePath(projectDir), "utf8"));
   } catch {
     return emptySnapshot();
   }
 }
-function writeTuiSnapshot(snapshot) {
+function writeTuiSnapshot(snapshot, projectDir) {
   try {
-    const filePath = getTuiStatePath();
+    const filePath = getTuiStatePath(projectDir);
     fs2.mkdirSync(path2.dirname(filePath), { recursive: true });
     fs2.writeFileSync(filePath, `${JSON.stringify(snapshot)}
 `);
   } catch {}
 }
-function updateSnapshot(mutator) {
-  const snapshot = readTuiSnapshot();
+function updateSnapshot(projectDir, mutator) {
+  const snapshot = readTuiSnapshot(projectDir);
   mutator(snapshot);
   snapshot.updatedAt = Date.now();
-  writeTuiSnapshot(snapshot);
+  writeTuiSnapshot(snapshot, projectDir);
 }
-function recordTuiAgentModels(input) {
-  updateSnapshot((snapshot) => {
+function recordTuiAgentModels(input, projectDir) {
+  updateSnapshot(projectDir, (snapshot) => {
     snapshot.agentModels = { ...input.agentModels };
     snapshot.agentVariants = { ...input.agentVariants ?? {} };
   });
 }
-function recordTuiAgentModel(input) {
-  updateSnapshot((snapshot) => {
+function recordTuiAgentModel(input, projectDir) {
+  updateSnapshot(projectDir, (snapshot) => {
     snapshot.agentModels[input.agentName] = input.model;
     if (input.variant !== undefined) {
       if (input.variant === null) {
@@ -902,15 +999,15 @@ function agentRow(label, model, variant, theme) {
     ...detailRows
   ]);
 }
-function compactAgentRow(label, model, variant, theme) {
-  const value = variant ? `${model} (${variant})` : model;
+function compactAgentRow(label, model, _variant, theme) {
+  const modelName = splitSidebarModelId(model).model;
   return box({
     width: "100%",
     flexDirection: "row",
     justifyContent: "space-between"
   }, [
     text({ fg: theme.textMuted, width: 14 }, [label]),
-    text({ fg: theme.textMuted }, [value])
+    text({ fg: theme.textMuted }, [modelName])
   ]);
 }
 function renderSidebar(snapshot, version, theme, configInvalid, compactSidebar) {
@@ -931,7 +1028,7 @@ function renderSidebar(snapshot, version, theme, configInvalid, compactSidebar)
       justifyContent: "space-between",
       alignItems: "center"
     }, [
-      box({ paddingLeft: 1, paddingRight: 1, backgroundColor: theme.accent }, [text({ fg: theme.background }, ["OMO-Slim"])]),
+      box({ paddingLeft: 1, paddingRight: 1, backgroundColor: theme.accent }, [text({ fg: theme.text }, ["OMO-Slim"])]),
       text({ fg: theme.textMuted }, [`v${version}`])
     ]),
     configStatusRow,
@@ -969,12 +1066,15 @@ function readConfigState(directory) {
       configInvalid = true;
     }
   });
-  const compactSidebar = config.compactSidebar ?? false;
+  const compactSidebar = config.compactSidebar ?? true;
   return { configInvalid, compactSidebar };
 }
 function readConfigInvalid(directory) {
   return readConfigState(directory).configInvalid;
 }
+function readCompactSidebar(directory) {
+  return readConfigState(directory).compactSidebar;
+}
 var plugin = {
   id: `${PLUGIN_NAME}:tui`,
   tui: async (api, _options, meta) => {
@@ -983,11 +1083,11 @@ var plugin = {
     const version = meta.version ?? await readPackageVersion() ?? "dev";
     let configDirectory = getTuiDirectory(api);
     let { configInvalid, compactSidebar } = readConfigState(configDirectory);
-    let snapshot = readTuiSnapshot();
+    let snapshot = readTuiSnapshot(configDirectory);
     const renderTimer = setInterval(async () => {
       try {
-        snapshot = await readTuiSnapshotAsync();
         const currentDirectory = getTuiDirectory(api);
+        snapshot = await readTuiSnapshotAsync(currentDirectory);
         if (currentDirectory !== configDirectory) {
           configDirectory = currentDirectory;
           ({ configInvalid, compactSidebar } = readConfigState(configDirectory));
@@ -1012,6 +1112,7 @@ var tui_default = plugin;
 export {
   splitSidebarModelId,
   readConfigInvalid,
+  readCompactSidebar,
   getSidebarAgentNames,
   tui_default as default
 };

package/dist/utils/background-job-board.d.ts

@@ -1,3 +1,4 @@
+import type { BackgroundJobStore } from './background-job-store';
 import { type TaskOutputState } from './task';
 export interface ContextFile {
     path: string;
@@ -56,7 +57,7 @@ export interface BackgroundJobStatusInput {
     now?: number;
 }
 type TerminalStateListener = (taskID: string) => void;
-export declare class BackgroundJobBoard {
+export declare class BackgroundJobBoard implements BackgroundJobStore {
     private readonly jobs;
     private readonly counters;
     private terminalStateListeners;
@@ -97,6 +98,9 @@ export declare class BackgroundJobBoard {
     formatForPrompt(parentSessionID: string, now?: number): string | undefined;
     clearParent(parentSessionID: string): void;
     drop(taskID: string): void;
+    deferIfRunning(_sessionId: string): boolean;
+    retryDeferredClose(_sessionId: string): boolean;
+    clearDeferredClose(_sessionId: string): void;
     private trimReusable;
     private formatReusableJob;
     private nextAlias;

package/dist/utils/background-job-coordinator.d.ts

@@ -0,0 +1,72 @@
+import type { BackgroundJobBoard, BackgroundJobLaunchInput, BackgroundJobRecord, BackgroundJobStatusInput, ContextFile } from './background-job-board';
+import type { BackgroundJobStore } from './background-job-store';
+import type { TaskOutputState } from './task';
+type TerminalStateListener = (taskID: string) => void;
+/**
+ * BackgroundJobCoordinator owns the lifecycle policy for background jobs.
+ * It sits between the board and its consumers, providing:
+ * - Subscription interface for terminal state notifications (replaces fire-and-forget)
+ * - Lifecycle policy: determines when jobs are terminal, when closes should be deferred
+ * - Single-writer contract: coordinator is the sole writer to the board
+ *
+ * The board's guards prevent silent overwrites. The coordinator adds:
+ * - Centralized notification with guaranteed delivery
+ * - Re-checks board state before notifying (handles races)
+ */
+export declare class BackgroundJobCoordinator implements BackgroundJobStore {
+    private readonly board;
+    private terminalStateListeners;
+    private readonly deferredIdleCloses;
+    constructor(board: BackgroundJobBoard);
+    addTerminalStateListener(listener: TerminalStateListener): void;
+    removeTerminalStateListener(listener: TerminalStateListener): void;
+    /**
+     * Handle terminal state from board. Re-checks board state to handle races.
+     * This is the centralized lifecycle policy.
+     */
+    private handleTerminalState;
+    /**
+     * Evaluate close policy. Returns true if session should close now.
+     * Mutates deferred state: adds to deferred set if running, removes if not.
+     */
+    deferIfRunning(sessionId: string): boolean;
+    /**
+     * Retry closing a deferred session. Called when a background job completes.
+     * Returns true if the session should now close.
+     */
+    retryDeferredClose(sessionId: string): boolean;
+    /**
+     * Clear deferred close state for a session being deleted.
+     */
+    clearDeferredClose(sessionId: string): void;
+    registerLaunch(input: BackgroundJobLaunchInput): BackgroundJobRecord;
+    updateStatus(input: BackgroundJobStatusInput): BackgroundJobRecord | undefined;
+    updateFromStatusOutput(output: string): BackgroundJobRecord | undefined;
+    markRunningFromLiveSession(taskID: string, now?: number): BackgroundJobRecord | undefined;
+    markReconciled(taskID: string, now?: number): BackgroundJobRecord | undefined;
+    markCancelled(taskID: string, reason?: string, now?: number, options?: {
+        force?: boolean;
+    }): BackgroundJobRecord | undefined;
+    get(taskID: string): BackgroundJobRecord | undefined;
+    field<K extends keyof BackgroundJobRecord>(taskID: string, key: K): BackgroundJobRecord[K] | undefined;
+    isRunning(taskID: string): boolean;
+    isTerminalUnreconciled(taskID: string): boolean;
+    getResultSummary(taskID: string): string | undefined;
+    getLastLiveBusyAt(taskID: string): number | undefined;
+    getParentSessionID(taskID: string): string | undefined;
+    getState(taskID: string): TaskOutputState | 'reconciled' | undefined;
+    resolve(parentSessionID: string, taskIDOrAlias: string): BackgroundJobRecord | undefined;
+    resolveReusable(parentSessionID: string, taskIDOrAlias: string, agent?: string): BackgroundJobRecord | undefined;
+    resolveRecoverable(parentSessionID: string, taskIDOrAlias: string, agent?: string): BackgroundJobRecord | undefined;
+    markUsed(parentSessionID: string, key: string, now?: number): void;
+    taskIDs(): Set<string>;
+    addContext(taskID: string, files: ContextFile[]): void;
+    list(parentSessionID?: string): BackgroundJobRecord[];
+    hasRunning(parentSessionID: string): boolean;
+    hasTerminalUnreconciled(parentSessionID: string): boolean;
+    hasConvergenceSignals(taskID: string, threshold?: number): boolean;
+    formatForPrompt(parentSessionID: string, now?: number): string | undefined;
+    clearParent(parentSessionID: string): void;
+    drop(taskID: string): void;
+}
+export {};

package/dist/utils/background-job-store.d.ts

@@ -0,0 +1,46 @@
+import type { BackgroundJobLaunchInput, BackgroundJobRecord, BackgroundJobStatusInput, ContextFile } from './background-job-board';
+import type { TaskOutputState } from './task';
+/**
+ * Unified interface for background job operations.
+ * Both BackgroundJobBoard and BackgroundJobCoordinator satisfy this.
+ *
+ * ponytail: single interface, both board and coordinator implement it.
+ */
+export interface BackgroundJobStore {
+    registerLaunch(input: BackgroundJobLaunchInput): BackgroundJobRecord;
+    updateStatus(input: BackgroundJobStatusInput): BackgroundJobRecord | undefined;
+    updateFromStatusOutput(output: string): BackgroundJobRecord | undefined;
+    markRunningFromLiveSession(taskID: string, now?: number): BackgroundJobRecord | undefined;
+    markReconciled(taskID: string, now?: number): BackgroundJobRecord | undefined;
+    markCancelled(taskID: string, reason?: string, now?: number, options?: {
+        force?: boolean;
+    }): BackgroundJobRecord | undefined;
+    clearParent(parentSessionID: string): void;
+    drop(taskID: string): void;
+    addContext(taskID: string, files: ContextFile[]): void;
+    markUsed(parentSessionID: string, key: string, now?: number): void;
+    get(taskID: string): BackgroundJobRecord | undefined;
+    field<K extends keyof BackgroundJobRecord>(taskID: string, key: K): BackgroundJobRecord[K] | undefined;
+    isRunning(taskID: string): boolean;
+    isTerminalUnreconciled(taskID: string): boolean;
+    getResultSummary(taskID: string): string | undefined;
+    getLastLiveBusyAt(taskID: string): number | undefined;
+    getParentSessionID(taskID: string): string | undefined;
+    getState(taskID: string): TaskOutputState | 'reconciled' | undefined;
+    resolve(parentSessionID: string, taskIDOrAlias: string): BackgroundJobRecord | undefined;
+    resolveReusable(parentSessionID: string, taskIDOrAlias: string, agent?: string): BackgroundJobRecord | undefined;
+    resolveRecoverable(parentSessionID: string, taskIDOrAlias: string, agent?: string): BackgroundJobRecord | undefined;
+    taskIDs(): Set<string>;
+    list(parentSessionID?: string): BackgroundJobRecord[];
+    hasRunning(parentSessionID: string): boolean;
+    hasTerminalUnreconciled(parentSessionID: string): boolean;
+    hasConvergenceSignals(taskID: string, threshold?: number): boolean;
+    formatForPrompt(parentSessionID: string, now?: number): string | undefined;
+    /** Evaluate close policy. Returns true if session should close now.
+     *  Mutates deferred state: adds to deferred set if running, removes if not. */
+    deferIfRunning(sessionId: string): boolean;
+    /** Retry closing a deferred session. Returns true if session should now close. */
+    retryDeferredClose(sessionId: string): boolean;
+    /** Clear deferred close state for a session being deleted. */
+    clearDeferredClose(sessionId: string): void;
+}

package/dist/utils/councillor-models.d.ts

@@ -0,0 +1,20 @@
+/**
+ * Pure helpers for councillor model fallback chains.
+ *
+ * Kept free of any schema/validation library import so that runtime consumers
+ * (e.g. `CouncilManager`) can resolve a councillor's ordered model chain
+ * without pulling in zod or the config schema module.
+ */
+/** A single model in a councillor fallback chain, with optional variant. */
+export type CouncillorModelEntry = {
+    id: string;
+    variant?: string;
+};
+/**
+ * Flatten a councillor model config into an ordered list of model entries.
+ *
+ * Accepts either a single "provider/model" string or an ordered fallback
+ * chain (array of strings and/or `{ id, variant }` entries). Entries that
+ * don't carry their own variant fall back to the shared `fallbackVariant`.
+ */
+export declare function normalizeCouncillorModels(model: string | Array<string | CouncillorModelEntry>, fallbackVariant?: string): CouncillorModelEntry[];

package/dist/utils/escape-html.d.ts

@@ -0,0 +1 @@
+export declare function escapeHtml(value: string): string;

package/dist/utils/frontmatter.d.ts

@@ -0,0 +1,6 @@
+/**
+ * Parse `---` delimited frontmatter from a string.
+ * Handles both `\n` and `\r\n` line endings.
+ * Returns null if no frontmatter is found.
+ */
+export declare function parseFrontmatter(content: string): Record<string, string> | null;

package/dist/utils/index.d.ts

@@ -1,7 +1,9 @@
 export * from './agent-variant';
 export * from './background-job-board';
+export * from './background-job-coordinator';
+export * from './background-job-store';
 export * from './internal-initiator';
-export { getLogDir, initLogger, log } from './logger';
+export { initLogger, log } from './logger';
 export * from './polling';
 export * from './session';
 export * from './task';

package/dist/utils/internal-initiator.d.ts

@@ -1,6 +1,11 @@
 export declare const SLIM_INTERNAL_INITIATOR_MARKER = "<!-- SLIM_INTERNAL_INITIATOR -->";
+export declare const INTERNAL_INITIATOR_METADATA_KEY = "oh-my-opencode-slim.internalInitiator";
 export declare function createInternalAgentTextPart(text: string): {
     type: 'text';
     text: string;
+    synthetic: true;
+    metadata: {
+        'oh-my-opencode-slim.internalInitiator': true;
+    };
 };
-export declare function hasInternalInitiatorMarker(part: unknown): boolean;
+export declare function isInternalInitiatorPart(part: unknown): boolean;

package/dist/utils/logger.d.ts

@@ -1,6 +1,4 @@
-declare function getLogDir(): string;
 export declare function initLogger(sessionId: string): void;
-export { getLogDir };
 /** @internal Reset logger state for testing */
 export declare function resetLogger(): void;
 /** @internal Wait for queued log writes in tests. */

package/dist/utils/session.d.ts

@@ -11,7 +11,7 @@ export declare function withTimeout<T>(operation: Promise<T>, timeoutMs: number,
 export declare function abortSessionWithTimeout(client: OpencodeClient, sessionId: string, timeoutMs?: number): Promise<void>;
 /**
  * Extract the short model label from a "provider/model" string.
- * E.g. "openai/gpt-5.4-mini" → "gpt-5.4-mini"
+ * E.g. "openai/gpt-5.6-luna" → "gpt-5.6-luna"
  */
 export declare function shortModelLabel(model: string): string;
 export type PromptBody = {