thoth-agents 0.11.0 → 0.12.0

package/README.md

@@ -46,7 +46,10 @@ verification you can follow—without manually coordinating every agent.
 - **Continuity between sessions.** Published installs include setup of
   [thoth-mem](https://github.com/EremesNG/thoth-mem), the independent memory
   companion for reusable decisions and project knowledge. thoth-mem owns its own
-  memory lifecycle, persistence, and storage; thoth-agents only invokes its setup.
+  memory lifecycle, persistence, and storage; thoth-agents only invokes
+  `npx -y "thoth-mem@>=0.7.0" setup <harness> --json` (adding `--plan` for
+  dry-run). Only exit 0 with `planned` for dry-run or `complete` for apply is
+  successful; see [provider outcomes](docs/installation.md#thoth-mem-companion-setup).
 
 > [!NOTE]
 > OpenCode is the CLI's default harness. Pi is our recommendation for the best
@@ -62,7 +65,7 @@ The commands below install at **global/user scope**.
 
 | Harness | What you get | Install command |
 | --- | --- | --- |
-| <a href="https://github.com/anomalyco/opencode"><picture><source media="(prefers-color-scheme: dark)" srcset="https://svgl.app/library/opencode-dark.svg"><img src="https://svgl.app/library/opencode.svg" alt="OpenCode logo" width="48" height="48"></picture></a><br>**OpenCode** | Native plugin, agent team, workflow skills, and memory setup. | `npx thoth-agents@latest install --agent=opencode` |
+| <a href="https://github.com/anomalyco/opencode"><picture><source media="(prefers-color-scheme: dark)" srcset="https://svgl.app/library/opencode-dark.svg"><img src="https://svgl.app/library/opencode.svg" alt="OpenCode logo" width="48" height="48"></picture></a><br>**OpenCode** | OpenCode >=2.2.6 native v2 plugin, package skills, agent team, and memory setup. | `npx thoth-agents@latest install --agent=opencode` |
 | <a href="https://github.com/openai/codex"><img src="https://github.com/openai.png?size=120" alt="OpenAI logo — Codex" width="48" height="48"></a><br>**Codex** | Native plugin plus the required global agent and instruction setup. **Close Codex first.** | `npx thoth-agents@latest install --agent=codex` |
 | <a href="https://claude.com/product/claude-code"><img src="https://github.com/anthropics.png?size=120" alt="Anthropic logo — Claude Code" width="48" height="48"></a><br>**Claude Code** | Marketplace agents and skills, completed by the CLI's external skills and memory setup. | `npx thoth-agents@latest install --agent=claude` |
 | <a href="https://github.com/earendil-works/pi"><img src="https://raw.githubusercontent.com/EremesNG/thoth-mem/master/img/pi.svg" alt="Pi logo" width="48" height="48"></a><br>**Pi** | Native package, five specialists, delegation, research, theme, sidebar and background-task extensions, workflow skills, and memory setup. **Recommended for the best experience.** | `npx thoth-agents@latest install --agent=pi` |
@@ -386,7 +389,6 @@ visible foreign-overlay focus. See [question controls](pi-packages/pi-questions-
 | [Codex Model Customization](docs/codex-model-customization.md) | Adjust Codex specialist models. |
 | [Claude Code Install](docs/claude-code-install.md) | Follow marketplace setup and activation. |
 | [Pi Setup](docs/installation.md#pi) | Check Pi dependencies, permissions, and recovery steps. |
-| [Tmux Integration](docs/tmux-integration.md) | Configure OpenCode's optional terminal-pane integration. |
 
 ### Technical guides
 

package/dist/agents/agent-config.d.ts

@@ -0,0 +1,13 @@
+/** Internal role-rendering input; translated to the host's v2 Agent.Info at registration. */
+export interface AgentConfig {
+    model?: string;
+    variant?: string;
+    temperature?: number;
+    prompt?: string;
+    description?: string;
+    mode?: 'primary' | 'subagent' | 'all';
+    hidden?: boolean;
+    color?: string;
+    steps?: number;
+    permission?: 'allow' | 'ask' | 'deny' | Record<string, 'allow' | 'ask' | 'deny' | Record<string, 'allow' | 'ask' | 'deny'>>;
+}

package/dist/agents/index.d.ts

@@ -1,5 +1,5 @@
-import type { AgentConfig as SDKAgentConfig } from '@opencode-ai/sdk/v2';
 import { type PluginConfig, SUBAGENT_NAMES } from '../config';
+import type { AgentConfig as SDKAgentConfig } from './agent-config';
 import { type AgentDefinition } from './orchestrator';
 export type { AgentDefinition } from './orchestrator';
 export type SubagentName = (typeof SUBAGENT_NAMES)[number];

package/dist/agents/orchestrator.d.ts

@@ -1,4 +1,4 @@
-import type { AgentConfig } from '@opencode-ai/sdk/v2';
+import type { AgentConfig } from './agent-config';
 export interface AgentDefinition {
     name: string;
     description?: string;

package/dist/{chunk-5WPP6IY7.js → chunk-7F33WUSD.js}

@@ -19,7 +19,7 @@ import {
   renderAgentRoutingDescription,
   renderPromptSection,
   renderRolePrompt
-} from "./chunk-DNPKVFOB.js";
+} from "./chunk-NY2IPJ7V.js";
 
 // src/harness/writers/pi-agent.ts
 var PI_MANAGED_OWNER = "thoth-agents";

package/dist/{chunk-RWQPMWEM.js → chunk-JLU3FSBT.js}

@@ -332,12 +332,27 @@ function checkExpectations(options, issue) {
       "Expected digest must be 64 lowercase hex characters."
     );
 }
+var isFenceLine = (line) => /^(?:`{3,}|~{3,})/.test(line);
+var isVerdictLine = (line) => line.startsWith("thoth-gate-verdict ");
+function unwrapSubagent(message, lines) {
+  if (!message.startsWith("<subagent ")) return message;
+  if (lines.at(-1) !== "</subagent>") return "";
+  const opener = lines.lastIndexOf("```thoth-result");
+  if (opener < 1) return "";
+  const header = lines.slice(0, opener).join("\n").trimEnd();
+  if (!header.includes('state="completed"') || lines.slice(0, opener).some((line) => isFenceLine(line) || isVerdictLine(line)))
+    return "";
+  return lines.slice(opener, -1).join("\n").trim();
+}
 function parseEnvelope(message) {
-  const trimmed = typeof message === "string" ? message.trim() : "";
+  const complete = typeof message === "string" ? message.trim() : "";
+  const lines = complete.split(/\r\n|\r|\n/);
+  const singleEnvelope = lines.filter(isFenceLine).length === 2 && !lines.some(isVerdictLine);
+  const trimmed = singleEnvelope ? unwrapSubagent(complete, lines) : "";
   const block = new RegExp(
     `^\`\`\`${result_contract_default.fence}\\r?\\n([\\s\\S]*?)\\r?\\n\`\`\`$`
   ).exec(trimmed);
-  if (!block || (trimmed.match(/^```.*$/gm) ?? []).length !== 2) {
+  if (!block) {
     return {
       issues: [
         {

package/dist/chunk-MIDGZE34.js

@@ -0,0 +1,107 @@
+// src/mcp/context7.ts
+var CONTEXT7_MCP_URL = "https://mcp.context7.com/mcp";
+var context7 = {
+  type: "remote",
+  url: CONTEXT7_MCP_URL,
+  headers: process.env.CONTEXT7_API_KEY ? { CONTEXT7_API_KEY: process.env.CONTEXT7_API_KEY } : void 0,
+  oauth: false
+};
+
+// src/mcp/exa.ts
+var exa = {
+  type: "local",
+  command: ["npx", "-y", "exa-mcp-server"]
+};
+
+// src/mcp/grep-app.ts
+var GREP_APP_MCP_URL = "https://mcp.grep.app";
+var grep_app = {
+  type: "remote",
+  url: GREP_APP_MCP_URL,
+  oauth: false
+};
+
+// src/utils/subprocess.ts
+import {
+  spawn as nodeSpawn,
+  spawnSync as nodeSpawnSync
+} from "child_process";
+import { Readable } from "stream";
+function emptyReadableStream() {
+  return new ReadableStream({
+    start(controller) {
+      controller.close();
+    }
+  });
+}
+function toWebReadable(stream) {
+  if (!stream) {
+    return emptyReadableStream();
+  }
+  return Readable.toWeb(
+    stream
+  );
+}
+function fallbackStdin() {
+  return {
+    write: () => void 0,
+    end: () => void 0
+  };
+}
+function spawn(command, options = {}) {
+  const child = nodeSpawn(command[0], command.slice(1), {
+    cwd: options.cwd,
+    env: options.env,
+    stdio: [
+      options.stdin ?? "pipe",
+      options.stdout ?? "pipe",
+      options.stderr ?? "pipe"
+    ],
+    shell: options.shell,
+    windowsHide: options.windowsHide ?? true
+  });
+  const managed = {
+    stdin: child.stdin ?? fallbackStdin(),
+    stdout: toWebReadable(child.stdout),
+    stderr: toWebReadable(child.stderr),
+    exited: new Promise((resolve) => {
+      child.on("exit", (code) => {
+        managed.exitCode = code;
+        resolve(code ?? 1);
+      });
+      child.on("error", () => {
+        managed.exitCode = 1;
+        resolve(1);
+      });
+    }),
+    exitCode: child.exitCode,
+    kill: () => {
+      child.kill();
+    }
+  };
+  return managed;
+}
+function spawnSync(command, options = {}) {
+  const result = nodeSpawnSync(command[0], command.slice(1), {
+    cwd: options.cwd,
+    env: options.env,
+    stdio: [
+      options.stdin ?? "ignore",
+      options.stdout ?? "pipe",
+      options.stderr ?? "pipe"
+    ],
+    shell: options.shell,
+    windowsHide: options.windowsHide ?? true
+  });
+  return { exitCode: result.status };
+}
+
+export {
+  CONTEXT7_MCP_URL,
+  context7,
+  exa,
+  GREP_APP_MCP_URL,
+  grep_app,
+  spawn,
+  spawnSync
+};

package/dist/{chunk-DNPKVFOB.js → chunk-NY2IPJ7V.js}

@@ -19,20 +19,6 @@ function findPackageRoot(startDir) {
   }
 }
 
-// src/config/loader.ts
-import * as fs from "fs";
-import * as path from "path";
-
-// src/cli/config-io.ts
-import {
-  copyFileSync,
-  existsSync as existsSync3,
-  readFileSync as readFileSync2,
-  renameSync,
-  statSync,
-  writeFileSync
-} from "fs";
-
 // src/config/constants.ts
 var SUBAGENT_NAMES = [
   "explorer",
@@ -99,7 +85,6 @@ function getDefaultOpenCodeVariant(name) {
   }
   return CONFIRMED_OPENAI_SUBAGENT_PRESET[name].effort;
 }
-var POLL_INTERVAL_BACKGROUND_MS = 2e3;
 var DEFAULT_TIMEOUT_MS = 2 * 60 * 1e3;
 var MAX_POLL_TIME_MS = 5 * 60 * 1e3;
 
@@ -195,27 +180,41 @@ function resolveExecutingPackageVersion(options = {}) {
   return { ok: true, version, packageRoot };
 }
 
+// src/config/loader.ts
+import * as fs from "fs";
+import * as path from "path";
+
+// src/cli/config-io.ts
+import {
+  copyFileSync,
+  existsSync as existsSync3,
+  readFileSync as readFileSync2,
+  renameSync,
+  statSync,
+  writeFileSync
+} from "fs";
+
 // src/cli/paths.ts
 import { existsSync as existsSync2, mkdirSync } from "fs";
 import { homedir } from "os";
 import { dirname as dirname3, join as join3 } from "path";
-function getDefaultOpenCodeConfigDir() {
-  const userConfigDir = process.env.XDG_CONFIG_HOME ? process.env.XDG_CONFIG_HOME : join3(homedir(), ".config");
+function getDefaultOpenCodeConfigDir(homeDir) {
+  const userConfigDir = process.env.XDG_CONFIG_HOME ? process.env.XDG_CONFIG_HOME : join3(homeDir, ".config");
   return join3(userConfigDir, "opencode");
 }
 function getCustomOpenCodeConfigDir() {
   const configDir = process.env.OPENCODE_CONFIG_DIR?.trim();
   return configDir || void 0;
 }
-function getConfigDir() {
+function getConfigDir(homeDir = homedir()) {
   const customConfigDir = getCustomOpenCodeConfigDir();
   if (customConfigDir) {
     return customConfigDir;
   }
-  return getDefaultOpenCodeConfigDir();
+  return getDefaultOpenCodeConfigDir(homeDir);
 }
 function getOpenCodeConfigPaths() {
-  const configDir = getDefaultOpenCodeConfigDir();
+  const configDir = getConfigDir();
   return [join3(configDir, "opencode.json"), join3(configDir, "opencode.jsonc")];
 }
 function getConfigJson() {
@@ -328,24 +327,6 @@ var AgentOverrideConfigSchema = z.object({
   steps: z.number().int().min(1).optional(),
   variant: z.string().optional().catch(void 0)
 });
-var TmuxLayoutSchema = z.enum([
-  "main-horizontal",
-  // Main pane on top, agents stacked below
-  "main-vertical",
-  // Main pane on left, agents stacked on right
-  "tiled",
-  // All panes equal size grid
-  "even-horizontal",
-  // All panes side by side
-  "even-vertical"
-  // All panes stacked vertically
-]);
-var TmuxConfigSchema = z.object({
-  enabled: z.boolean().default(false),
-  layout: TmuxLayoutSchema.default("main-vertical"),
-  main_pane_size: z.number().min(20).max(80).default(60)
-  // percentage for main pane
-});
 var PresetSchema = z.record(
   SupportedAgentRecordKeySchema,
   AgentOverrideConfigSchema
@@ -378,7 +359,6 @@ var PluginConfigSchema = z.object({
   presets: z.record(z.string(), PresetSchema).optional(),
   agents: z.record(SupportedAgentRecordKeySchema, AgentOverrideConfigSchema).optional(),
   disabled_mcps: z.array(z.string()).optional(),
-  tmux: TmuxConfigSchema.optional(),
   fallback: FailoverConfigSchema.optional(),
   codex: CodexGenerationConfigSchema.optional(),
   claudeCode: ClaudeCodeGenerationConfigSchema.optional()
@@ -418,7 +398,7 @@ function buildOpenAIModelMappings() {
 var MODEL_MAPPINGS = {
   openai: buildOpenAIModelMappings()
 };
-function generateLiteConfig(installConfig) {
+function generateLiteConfig(_installConfig) {
   const config = {
     $schema: THOTH_AGENTS_CONFIG_SCHEMA_URL,
     preset: "openai",
@@ -440,13 +420,6 @@ function generateLiteConfig(installConfig) {
     );
   };
   config.presets.openai = buildPreset("openai");
-  if (installConfig.hasTmux) {
-    config.tmux = {
-      enabled: true,
-      layout: "main-vertical",
-      main_pane_size: 60
-    };
-  }
   return config;
 }
 
@@ -500,24 +473,32 @@ function writeConfig(configPath, config) {
   writeFileSync(tmpPath, content);
   renameSync(tmpPath, configPath);
 }
+function pluginEntries(value) {
+  return Array.isArray(value) ? value : [];
+}
+function isManagedOpenCodePlugin(entry) {
+  const name = typeof entry === "string" ? entry : Array.isArray(entry) ? entry[0] : entry && typeof entry === "object" && "package" in entry ? entry.package : void 0;
+  return typeof name === "string" && (name === PACKAGE_NAME || name.startsWith(`${PACKAGE_NAME}@`));
+}
+function hasManagedPluginOptions(entry) {
+  if (!isManagedOpenCodePlugin(entry)) return false;
+  const options = Array.isArray(entry) ? entry[1] : entry && typeof entry === "object" && "options" in entry ? entry.options : void 0;
+  return !!options && typeof options === "object" && Object.keys(options).length > 0;
+}
 function mergeOpenCodeMainConfig(config, update) {
   if (update.ensurePlugin) {
-    const plugins = Array.isArray(config.plugin) ? config.plugin : [];
-    config.plugin = [
-      ...plugins.filter(
-        (plugin) => plugin !== PACKAGE_NAME && !plugin.startsWith(`${PACKAGE_NAME}@`)
+    const legacy = pluginEntries(config.plugin).filter(
+      (entry) => !isManagedOpenCodePlugin(entry)
+    );
+    if (legacy.length > 0) config.plugin = legacy;
+    else delete config.plugin;
+    config.plugins = [
+      ...pluginEntries(config.plugins).filter(
+        (entry) => !isManagedOpenCodePlugin(entry)
       ),
       `${PACKAGE_NAME}@${update.pluginVersion}`
     ];
   }
-  if (update.disableDefaults) {
-    const agent = config.agent && typeof config.agent === "object" ? { ...config.agent } : {};
-    const explore = agent.explore && typeof agent.explore === "object" ? { ...agent.explore } : {};
-    const general = agent.general && typeof agent.general === "object" ? { ...agent.general } : {};
-    agent.explore = { ...explore, disable: true };
-    agent.general = { ...general, disable: true };
-    config.agent = agent;
-  }
   return config;
 }
 function updateOpenCodeMainConfig(update) {
@@ -547,10 +528,19 @@ function updateOpenCodeMainConfig(update) {
         error: `Failed to parse config: ${error}`
       };
     }
+    const removedOptions = update.ensurePlugin && [
+      ...pluginEntries(parsedConfig?.plugin),
+      ...pluginEntries(parsedConfig?.plugins)
+    ].some(hasManagedPluginOptions);
     writeConfig(
       configPath,
       mergeOpenCodeMainConfig(parsedConfig ?? {}, update)
     );
+    if (removedOptions) {
+      console.warn(
+        `[config-manager] Removed non-empty thoth-agents plugin options while pinning the v2 plugin. Original entries are preserved in ${configPath}.bak; configure the plugin via thoth-agents.json instead.`
+      );
+    }
     return { success: true, configPath };
   } catch (err) {
     return {
@@ -634,13 +624,14 @@ function writeLiteConfig(installConfig, targetPath) {
 function detectCurrentConfig() {
   const result = {
     isInstalled: false,
-    hasOpenAI: false,
-    hasTmux: false
+    hasOpenAI: false
   };
   const { config } = parseConfig(getExistingConfigPath());
   if (!config) return result;
-  const plugins = config.plugin ?? [];
-  result.isInstalled = plugins.some((p) => p.startsWith(PACKAGE_NAME));
+  result.isInstalled = [
+    ...pluginEntries(config.plugin),
+    ...pluginEntries(config.plugins)
+  ].some(isManagedOpenCodePlugin);
   const { config: liteConfig } = parseConfig(getLiteConfig());
   if (liteConfig && typeof liteConfig === "object") {
     const configObj = liteConfig;
@@ -651,10 +642,6 @@ function detectCurrentConfig() {
       const models = Object.values(agents).map((a) => a?.model).filter(Boolean);
       result.hasOpenAI = models.some((m) => m?.startsWith("openai/"));
     }
-    if (configObj.tmux && typeof configObj.tmux === "object") {
-      const tmuxConfig = configObj.tmux;
-      result.hasTmux = tmuxConfig.enabled === true;
-    }
   }
   return result;
 }
@@ -727,7 +714,6 @@ function loadPluginConfig(directory) {
       ...config,
       ...projectConfig,
       agents: deepMerge(config.agents, projectConfig.agents),
-      tmux: deepMerge(config.tmux, projectConfig.tmux),
       fallback: deepMerge(config.fallback, projectConfig.fallback),
       codex: deepMerge(config.codex, projectConfig.codex),
       claudeCode: deepMerge(config.claudeCode, projectConfig.claudeCode)
@@ -1381,25 +1367,30 @@ function piCapabilityDisclosure(capability) {
 }
 var OPENCODE_PROMPT_DIALECT = {
   harness: "opencode",
-  gateDeliveryInstruction: "Delivery verdicts are appended to Oracle `task` output.",
+  gateDeliveryInstruction: "Foreground Oracle `subagent` gates get one `thoth-gate-verdict` line; background completions have none: use the explicit compact validator fallback.",
   tools: {
-    delegationTool: "task",
-    backgroundDelegationTool: "task(background=true)",
-    backgroundStatusTool: "task_status",
+    delegationTool: "subagent",
+    backgroundDelegationTool: "subagent(background:true)",
+    backgroundWaitInstruction: 'Native `<subagent sessionID=... state="completed">` completion wakes root. No status polling tool exists; never poll/sleep.',
     userQuestionTool: "question",
     progressTool: "todowrite",
-    hostStatusSurface: "task_status",
+    hostStatusSurface: "native subagent completion messages",
     lifecycle: {
-      freshDelegation: "`task` without `task_id`",
-      sameAssignmentContinuation: "`task` with the prior `task_id`",
-      independentContext: "omitting `task_id` creates an isolated child session",
-      statusAction: "wait, poll, and collect",
-      terminalState: "terminal task_status result",
-      nonterminalState: "nonterminal task_status result",
-      sameSessionProbe: "task_status on the same task session",
+      rootInstructions: [
+        "- New objectives, phases, work units, mutable surfaces or independent judgments require fresh specialist sessions via `subagent` (agent, description, prompt; omit sessionID). These are fresh-session boundaries, not permission for root execution; never pool completed agents.",
+        "- Use sessionID only to continue/clarify the same assignment, including while running. Optional model; background:true for independent work. Default nesting depth is 1.",
+        "- Every Oracle plan review, verification round, and PASS judgment uses a fresh Oracle instance. Existing ones only clarify their findings."
+      ].join("\n"),
+      freshDelegation: "`subagent` with agent, description and prompt, omitting sessionID",
+      sameAssignmentContinuation: "`subagent` with the prior sessionID, including while running",
+      independentContext: "omitting sessionID creates an isolated child session",
+      statusAction: "receive native completion automatically; never poll",
+      terminalState: "a completed subagent result/message",
+      nonterminalState: "a running placeholder",
+      sameSessionProbe: "continue or clarify with subagent and the same sessionID; never ask for status",
       enforcement: "runtime-supported"
     },
-    roleReference: (role) => `@${role}`
+    roleReference: (role) => `subagent agent:"${role}"`
   },
   capabilities: supportedCapabilityProfile(OPENCODE_CAPABILITIES),
   dispatchLabel(method) {
@@ -1407,11 +1398,11 @@ var OPENCODE_PROMPT_DIALECT = {
       case "root-coordinator":
         return "root coordinator";
       case "task":
-        return "task";
+        return "subagent";
     }
   },
   renderRoleInvocation(role) {
-    return `@${role}`;
+    return `subagent agent:"${role}"`;
   }
 };
 var CODEX_PROMPT_DIALECT = {
@@ -2231,7 +2222,7 @@ Use \`${dialect.tools.userQuestionTool}\` only for a blocking material choice, d
 }
 function renderSubagentRules(section, dialect) {
   const rules = [
-    dialect.tools.progressTool ? `- Do not delegate further or call \`${dialect.tools.progressTool}\`; root owns progress.` : "- Do not delegate further; root owns progress.",
+    dialect.harness === "opencode" ? "- Do not delegate further; no `todowrite` (root-owned)." : dialect.tools.progressTool ? `- Do not delegate further or call \`${dialect.tools.progressTool}\`; root owns progress.` : "- Do not delegate further; root owns progress.",
     "- Use terminating checks; avoid watch processes and indefinite waits.",
     "- Preserve operator-selected model/effort. Stop after the assigned outcome and checks; never expand scope to fill a timeout.",
     "- After two consecutive attempts without new evidence or progress, return partial evidence and the smallest blocker; do not repeat searches or unchanged failing commands.",
@@ -2428,19 +2419,19 @@ export {
   DEFAULT_MODELS,
   getDefaultOpenCodeModel,
   getDefaultOpenCodeVariant,
-  POLL_INTERVAL_BACKGROUND_MS,
   findPackageRoot,
   isValidPackageVersion,
   resolveExecutingPackageVersion,
-  getOpenCodeConfigPaths,
+  getConfigDir,
   getOpenCodeManagedModelStatePath,
   getExistingLiteConfigPath,
   getExistingConfigPath,
   ensureConfigDir,
   generateLiteConfig,
-  stripJsonComments,
   parseConfig,
   writeConfig,
+  pluginEntries,
+  isManagedOpenCodePlugin,
   updateOpenCodeMainConfig,
   writeLiteConfig,
   detectCurrentConfig,