oh-my-opencode-slim 1.1.0 → 1.1.2

package/dist/cli/background-subagents.d.ts

@@ -0,0 +1,13 @@
+export type BackgroundSubagentsMode = 'ask' | 'yes' | 'no';
+export type ShellKind = 'bash' | 'fish' | 'zsh';
+export declare function isBackgroundSubagentsEnabled(value: string | undefined): boolean;
+export declare function detectShellKind(shell: string | undefined): ShellKind | undefined;
+export declare function detectBackgroundSubagentsTarget(env?: NodeJS.ProcessEnv): string | undefined;
+export declare function getBackgroundSubagentsBlock(targetPath: string): string;
+export declare function manualBackgroundSubagentsInstructions(options?: {
+    targetPath?: string;
+    shell?: ShellKind;
+}): string;
+export declare function expandHomePath(targetPath: string): string;
+export declare function upsertBackgroundSubagentsBlock(content: string, block: string): string;
+export declare function writeBackgroundSubagentsBlock(targetPath: string): void;

package/dist/cli/index.js

@@ -100,7 +100,7 @@ function getConfigSearchDirs() {
   });
 }
 function getOpenCodeConfigPaths() {
-  const configDir = getDefaultOpenCodeConfigDir();
+  const configDir = getConfigDir();
   return [join(configDir, "opencode.json"), join(configDir, "opencode.jsonc")];
 }
 function getConfigJson() {
@@ -373,6 +373,9 @@ var TodoContinuationConfigSchema = z2.object({
   autoEnable: z2.boolean().default(false).describe("Automatically enable auto-continue when the orchestrator session has enough todos"),
   autoEnableThreshold: z2.number().int().min(1).max(50).default(4).describe("Number of todos that triggers auto-enable (only used when autoEnable is true)")
 });
+var SubtaskConfigSchema = z2.object({
+  timeoutMs: z2.number().int().min(0).max(24 * 60 * 60 * 1000).optional().describe("Subtask worker timeout in ms. 0 disables the timeout. Defaults to 300000 (5 minutes).")
+});
 var FailoverConfigSchema = z2.object({
   enabled: z2.boolean().default(true),
   timeoutMs: z2.number().min(0).default(15000),
@@ -420,6 +423,7 @@ var PluginConfigSchema = z2.object({
   sessionManager: SessionManagerConfigSchema.optional(),
   divoom: DivoomConfigSchema.optional(),
   todoContinuation: TodoContinuationConfigSchema.optional(),
+  subtask: SubtaskConfigSchema.optional(),
   fallback: FailoverConfigSchema.optional(),
   council: CouncilConfigSchema.optional()
 }).superRefine((value, ctx) => {
@@ -515,56 +519,6 @@ function installCustomSkill(skill) {
   }
 }
 
-// src/cli/skills.ts
-import { spawnSync } from "node:child_process";
-var RECOMMENDED_SKILLS = [
-  {
-    name: "agent-browser",
-    repo: "https://github.com/vercel-labs/agent-browser",
-    skillName: "agent-browser",
-    allowedAgents: ["designer"],
-    description: "High-performance browser automation",
-    postInstallCommands: [
-      "npm install -g agent-browser",
-      "agent-browser install"
-    ]
-  }
-];
-function installSkill(skill) {
-  const args = [
-    "skills",
-    "add",
-    skill.repo,
-    "--skill",
-    skill.skillName,
-    "-a",
-    "opencode",
-    "-y",
-    "--global"
-  ];
-  try {
-    const result = spawnSync("npx", args, { stdio: "inherit" });
-    if (result.status !== 0) {
-      return false;
-    }
-    if (skill.postInstallCommands && skill.postInstallCommands.length > 0) {
-      console.log(`Running post-install commands for ${skill.name}...`);
-      for (const cmd of skill.postInstallCommands) {
-        console.log(`> ${cmd}`);
-        const [command, ...cmdArgs] = cmd.split(" ");
-        const cmdResult = spawnSync(command, cmdArgs, { stdio: "inherit" });
-        if (cmdResult.status !== 0) {
-          console.warn(`Post-install command failed: ${cmd}`);
-        }
-      }
-    }
-    return true;
-  } catch (error) {
-    console.error(`Failed to install skill: ${skill.name}`, error);
-    return false;
-  }
-}
-
 // src/cli/providers.ts
 var SCHEMA_URL = "https://unpkg.com/oh-my-opencode-slim@latest/oh-my-opencode-slim.schema.json";
 var GENERATED_PRESETS = ["openai", "opencode-go"];
@@ -637,12 +591,8 @@ function generateLiteConfig(installConfig) {
   const createAgentConfig = (agentName, modelInfo) => {
     const isOrchestrator = agentName === "orchestrator";
     const skills = isOrchestrator ? ["*"] : [
-      ...RECOMMENDED_SKILLS.filter((s) => s.allowedAgents.includes("*") || s.allowedAgents.includes(agentName)).map((s) => s.skillName),
       ...CUSTOM_SKILLS.filter((s) => s.allowedAgents.includes("*") || s.allowedAgents.includes(agentName)).map((s) => s.name)
     ];
-    if (agentName === "designer" && !skills.includes("agent-browser")) {
-      skills.push("agent-browser");
-    }
     return {
       model: modelInfo.model,
       variant: modelInfo.variant,
@@ -673,6 +623,12 @@ function generateLiteConfig(installConfig) {
 
 // src/cli/config-io.ts
 var PACKAGE_NAME = "oh-my-opencode-slim";
+var DEFAULT_OPENCODE_AGENTS_TO_DISABLE = [
+  "build",
+  "explore",
+  "general",
+  "plan"
+];
 function isString(value) {
   return typeof value === "string";
 }
@@ -753,17 +709,49 @@ function getPluginEntry() {
     return PACKAGE_NAME;
   }
 }
-function getOpenCodePluginCacheDir() {
+function getPinnedVersionFromConfig() {
+  try {
+    const { config } = parseConfig(getExistingConfigPath());
+    if (!config)
+      return;
+    for (const entry of getPlugins(config)) {
+      const spec = getPluginSpec(entry);
+      if (!spec)
+        continue;
+      if (spec === PACKAGE_NAME)
+        return;
+      if (spec.startsWith(`${PACKAGE_NAME}@`)) {
+        const version = spec.slice(PACKAGE_NAME.length + 1);
+        if (version && version !== "latest")
+          return version;
+      }
+    }
+  } catch {}
+  return;
+}
+function getVersionFromPackageRoot(packageRoot) {
+  try {
+    const packageJsonPath = join3(packageRoot, "package.json");
+    if (!existsSync3(packageJsonPath))
+      return;
+    const pkg = JSON.parse(readFileSync(packageJsonPath, "utf-8"));
+    return pkg.version;
+  } catch {
+    return;
+  }
+}
+function getOpenCodePluginCacheDir(version) {
   const cacheDir = process.env.XDG_CACHE_HOME?.trim() || join3(homedir2(), ".cache");
-  return join3(cacheDir, "opencode", "packages", `${PACKAGE_NAME}@latest`);
+  const suffix = version ? `${PACKAGE_NAME}@${version}` : `${PACKAGE_NAME}@latest`;
+  return join3(cacheDir, "opencode", "packages", suffix);
 }
-function writeOpenCodePluginCacheManifest(cacheDir) {
+function writeOpenCodePluginCacheManifest(cacheDir, version = "latest") {
   try {
     writeFileSync(join3(cacheDir, "package.json"), JSON.stringify({
       name: `${PACKAGE_NAME}-cache`,
       private: true,
       dependencies: {
-        [PACKAGE_NAME]: "latest"
+        [PACKAGE_NAME]: version
       }
     }, null, 2));
     return null;
@@ -811,7 +799,10 @@ async function warmOpenCodePluginCache() {
   if (!packageRoot || !isPackageManagerInstall(packageRoot)) {
     return null;
   }
-  const cacheDir = getOpenCodePluginCacheDir();
+  const pinnedVersion = getPinnedVersionFromConfig();
+  const runningVersion = getVersionFromPackageRoot(packageRoot);
+  const cacheVersion = pinnedVersion ?? runningVersion;
+  const cacheDir = getOpenCodePluginCacheDir(cacheVersion);
   try {
     mkdirSync3(cacheDir, { recursive: true });
   } catch (err) {
@@ -821,7 +812,7 @@ async function warmOpenCodePluginCache() {
       error: `Failed to create OpenCode cache directory: ${err}`
     };
   }
-  const manifestError = writeOpenCodePluginCacheManifest(cacheDir);
+  const manifestError = writeOpenCodePluginCacheManifest(cacheDir, cacheVersion);
   if (manifestError)
     return manifestError;
   try {
@@ -1004,8 +995,13 @@ function disableDefaultAgents() {
     }
     const config = parsedConfig ?? {};
     const agent = config.agent ?? {};
-    agent.explore = { disable: true };
-    agent.general = { disable: true };
+    for (const agentName of DEFAULT_OPENCODE_AGENTS_TO_DISABLE) {
+      const existing = agent[agentName];
+      agent[agentName] = {
+        ...existing && typeof existing === "object" && !Array.isArray(existing) ? existing : {},
+        disable: true
+      };
+    }
     config.agent = agent;
     writeConfig(configPath, config);
     return { success: true, configPath };
@@ -1136,7 +1132,8 @@ function mergePluginConfigs(base, override) {
     sessionManager: deepMerge(base.sessionManager, override.sessionManager),
     divoom: deepMerge(base.divoom, override.divoom),
     fallback: deepMerge(base.fallback, override.fallback),
-    council: deepMerge(base.council, override.council)
+    council: deepMerge(base.council, override.council),
+    subtask: deepMerge(base.subtask, override.subtask)
   };
 }
 function deepMerge(base, override) {
@@ -1355,13 +1352,13 @@ Options:
 import { existsSync as existsSync5 } from "node:fs";
 import { createInterface } from "node:readline/promises";
 // src/cli/system.ts
-import { spawnSync as spawnSync2 } from "node:child_process";
+import { spawnSync } from "node:child_process";
 import { statSync as statSync4 } from "node:fs";
 var cachedOpenCodePath = null;
 function resolvePathCommand(command) {
   try {
     const resolver = process.platform === "win32" ? "where" : "which";
-    const result = spawnSync2(resolver, [command], {
+    const result = spawnSync(resolver, [command], {
       encoding: "utf-8",
       stdio: ["ignore", "pipe", "ignore"]
     });
@@ -1376,7 +1373,7 @@ function resolvePathCommand(command) {
 }
 function canExecute(command, args) {
   try {
-    const result = spawnSync2(command, args, {
+    const result = spawnSync(command, args, {
       stdio: "ignore"
     });
     return result.status === 0;
@@ -1578,8 +1575,6 @@ async function runInstall(config) {
   const isUpdate = detected.isInstalled;
   printHeader(isUpdate);
   let totalSteps = 6;
-  if (config.installSkills)
-    totalSteps += 1;
   if (config.installCustomSkills)
     totalSteps += 1;
   totalSteps += 1;
@@ -1658,27 +1653,6 @@ ${JSON.stringify(liteConfig, null, 2)}
         return 1;
     }
   }
-  if (config.installSkills) {
-    printStep(step++, totalSteps, "Installing recommended skills...");
-    if (config.dryRun) {
-      printInfo("Dry run mode - would install skills:");
-      for (const skill of RECOMMENDED_SKILLS) {
-        printInfo(`  - ${skill.name}`);
-      }
-    } else {
-      let skillsInstalled = 0;
-      for (const skill of RECOMMENDED_SKILLS) {
-        printInfo(`Installing ${skill.name}...`);
-        if (installSkill(skill)) {
-          printSuccess(`Installed: ${skill.name}`);
-          skillsInstalled++;
-        } else {
-          printInfo(`Skipped: ${skill.name} (already installed)`);
-        }
-      }
-      printSuccess(`${skillsInstalled}/${RECOMMENDED_SKILLS.length} skills processed`);
-    }
-  }
   if (config.installCustomSkills) {
     printStep(step++, totalSteps, "Installing custom skills...");
     if (config.dryRun) {
@@ -1735,7 +1709,6 @@ ${JSON.stringify(liteConfig, null, 2)}
 async function install(args) {
   const config = {
     hasTmux: false,
-    installSkills: args.skills === "yes",
     installCustomSkills: args.skills === "yes",
     preset: args.preset,
     promptForStar: args.tui,
@@ -1792,7 +1765,7 @@ Usage:
   bunx oh-my-opencode-slim doctor [OPTIONS]
 
 Options:
-  --skills=yes|no        Install recommended and bundled skills (default: yes)
+  --skills=yes|no        Install bundled skills (default: yes)
   --preset=<name>        Active generated config preset (default: openai)
   --no-tui               Non-interactive mode
   --dry-run              Simulate install without writing files

package/dist/cli/skills.d.ts

@@ -1,20 +1,3 @@
-/**
- * A recommended skill to install via `npx skills add`.
- */
-export interface RecommendedSkill {
-    /** Human-readable name for prompts */
-    name: string;
-    /** GitHub repo URL for `npx skills add` */
-    repo: string;
-    /** Skill name within the repo (--skill flag) */
-    skillName: string;
-    /** List of agents that should auto-allow this skill */
-    allowedAgents: string[];
-    /** Description shown to user during install */
-    description: string;
-    /** Optional commands to run after the skill is added */
-    postInstallCommands?: string[];
-}
 /**
  * A skill that is managed externally (e.g. user-installed) and needs
  * permission grants but is NOT installed by this plugin's CLI.
@@ -27,26 +10,15 @@ export interface PermissionOnlySkill {
     /** Human-readable description (for documentation only) */
     description: string;
 }
-/**
- * List of recommended skills.
- * Add new skills here to include them in the installation flow.
- */
-export declare const RECOMMENDED_SKILLS: RecommendedSkill[];
 /**
  * Skills managed externally (not installed by this plugin's CLI).
  * Entries here only affect agent permission grants — nothing is installed.
  */
 export declare const PERMISSION_ONLY_SKILLS: PermissionOnlySkill[];
 /**
- * Install a skill using `npx skills add`.
- * @param skill - The skill to install
- * @returns True if installation succeeded, false otherwise
- */
-export declare function installSkill(skill: RecommendedSkill): boolean;
-/**
- * Get permission presets for a specific agent based on recommended skills.
+ * Get permission presets for a specific agent based on bundled skills.
  * @param agentName - The name of the agent
- * @param skillList - Optional explicit list of skills to allow (overrides recommendations)
+ * @param skillList - Optional explicit list of skills to allow (overrides defaults)
  * @returns Permission rules for the skill permission type
  */
 export declare function getSkillPermissionsForAgent(agentName: string, skillList?: string[]): Record<string, 'allow' | 'ask' | 'deny'>;

package/dist/cli/types.d.ts

@@ -14,7 +14,6 @@ export interface OpenCodeConfig {
 }
 export interface InstallConfig {
     hasTmux: boolean;
-    installSkills: boolean;
     installCustomSkills: boolean;
     preset?: string;
     promptForStar?: boolean;

package/dist/config/fallback-chains.d.ts

@@ -0,0 +1 @@
+export declare function normalizeFallbackChainsForPreset(chains: Record<string, string[] | undefined>, presetName: string | null | undefined): Record<string, string[]>;

package/dist/config/schema.d.ts

@@ -183,6 +183,10 @@ export declare const TodoContinuationConfigSchema: z.ZodObject<{
     autoEnableThreshold: z.ZodDefault<z.ZodNumber>;
 }, z.core.$strip>;
 export type TodoContinuationConfig = z.infer<typeof TodoContinuationConfigSchema>;
+export declare const SubtaskConfigSchema: z.ZodObject<{
+    timeoutMs: z.ZodOptional<z.ZodNumber>;
+}, z.core.$strip>;
+export type SubtaskConfig = z.infer<typeof SubtaskConfigSchema>;
 export declare const FailoverConfigSchema: z.ZodObject<{
     enabled: z.ZodDefault<z.ZodBoolean>;
     timeoutMs: z.ZodDefault<z.ZodNumber>;
@@ -338,6 +342,9 @@ export declare const PluginConfigSchema: z.ZodObject<{
         autoEnable: z.ZodDefault<z.ZodBoolean>;
         autoEnableThreshold: z.ZodDefault<z.ZodNumber>;
     }, z.core.$strip>>;
+    subtask: z.ZodOptional<z.ZodObject<{
+        timeoutMs: z.ZodOptional<z.ZodNumber>;
+    }, z.core.$strip>>;
     fallback: z.ZodOptional<z.ZodObject<{
         enabled: z.ZodDefault<z.ZodBoolean>;
         timeoutMs: z.ZodDefault<z.ZodNumber>;

package/dist/hooks/auto-update-checker/checker.d.ts

@@ -1,4 +1,4 @@
-import type { PluginEntryInfo } from './types';
+import type { CompatibleVersionResult, PluginEntryInfo } from './types';
 /**
  * Extracts the update channel (latest, alpha, beta, etc.) from a version string.
  * @param version The version or tag to analyze.
@@ -30,3 +30,9 @@ export declare function updatePinnedVersion(configPath: string, oldEntry: string
  * Fetches the latest version for a specific channel from the NPM registry.
  */
 export declare function getLatestVersion(channel?: string): Promise<string | null>;
+/**
+ * Resolves the newest version that is safe for the current install to use.
+ * Auto-update never crosses major versions; newer majors are surfaced as a
+ * manual migration notification instead.
+ */
+export declare function getLatestCompatibleVersion(currentVersion: string, channel?: string): Promise<CompatibleVersionResult>;

package/dist/hooks/auto-update-checker/constants.d.ts

@@ -1,5 +1,6 @@
 export declare const PACKAGE_NAME = "oh-my-opencode-slim";
 export declare const NPM_REGISTRY_URL = "https://registry.npmjs.org/-/package/oh-my-opencode-slim/dist-tags";
+export declare const NPM_PACKAGE_URL = "https://registry.npmjs.org/oh-my-opencode-slim";
 export declare const NPM_FETCH_TIMEOUT = 5000;
 /** The directory used by OpenCode to cache node_modules for plugins. */
 export declare const CACHE_DIR: string;

package/dist/hooks/auto-update-checker/types.d.ts

@@ -2,6 +2,16 @@ export interface NpmDistTags {
     latest: string;
     [key: string]: string;
 }
+export interface NpmPackageMetadata {
+    'dist-tags'?: NpmDistTags;
+    versions?: Record<string, unknown>;
+}
+export interface CompatibleVersionResult {
+    latestVersion: string | null;
+    latestMajorVersion: string | null;
+    blockedByMajor: boolean;
+    unsafeReason?: 'unparseable-current-version';
+}
 export interface OpencodeConfig {
     plugin?: unknown[];
     [key: string]: unknown;

package/dist/hooks/deepwork/index.d.ts

@@ -0,0 +1,13 @@
+export declare function createDeepworkCommandHook(): {
+    registerCommand: (config: Record<string, unknown>) => void;
+    handleCommandExecuteBefore: (input: {
+        command: string;
+        sessionID: string;
+        arguments: string;
+    }, output: {
+        parts: Array<{
+            type: string;
+            text?: string;
+        }>;
+    }) => Promise<void>;
+};

package/dist/hooks/index.d.ts

@@ -9,5 +9,6 @@ export { processImageAttachments } from './image-hook';
 export { createJsonErrorRecoveryHook } from './json-error-recovery';
 export { createPhaseReminderHook } from './phase-reminder';
 export { createPostFileToolNudgeHook } from './post-file-tool-nudge';
+export { createSessionGoalHook } from './session-goal';
 export { createTaskSessionManagerHook } from './task-session-manager';
 export { createTodoContinuationHook } from './todo-continuation';

package/dist/hooks/session-goal/index.d.ts

@@ -0,0 +1,38 @@
+import type { PluginInput } from '@opencode-ai/plugin';
+import type { PluginConfig } from '../../config';
+interface GoalState {
+    text: string;
+    source?: 'manual' | 'interview';
+    sourcePath?: string;
+    inheritedFrom?: string;
+    createdAt: number;
+}
+interface SystemTransformOutput {
+    system: string[];
+}
+export declare function createSessionGoalHook(ctx: PluginInput, config: PluginConfig, options?: {
+    getAgentName?: (sessionID: string) => string | undefined;
+}): {
+    registerCommand: (config: Record<string, unknown>) => void;
+    handleCommandExecuteBefore: (input: {
+        command: string;
+        sessionID: string;
+        arguments: string;
+    }, output: {
+        parts: Array<{
+            type: string;
+            text?: string;
+        }>;
+    }) => Promise<void>;
+    handleEvent: (input: {
+        event: {
+            type: string;
+            properties?: Record<string, unknown>;
+        };
+    }) => void;
+    handleSystemTransform: (input: {
+        sessionID?: string;
+    }, output: SystemTransformOutput) => void;
+    getGoal: (sessionID: string) => GoalState | undefined;
+};
+export {};