@plainconceptsplatform/agent-harness 2.2.1 → 2.4.0

package/{src → cli}/steps/copy/commands.js

@@ -1,95 +1,95 @@
-import fse from 'fs-extra'
-import path from 'path'
-import { fileURLToPath } from 'url'
-import { success } from '../../utils/exec.js'
-
-const __dirname = path.dirname(fileURLToPath(import.meta.url))
-
-const _archive = {
-  azure: await fse.readFile(path.resolve(__dirname, '../../fragments/archive/az.md'), 'utf-8'),
-  github: await fse.readFile(path.resolve(__dirname, '../../fragments/archive/gh.md'), 'utf-8'),
-  gitlab: await fse.readFile(path.resolve(__dirname, '../../fragments/archive/gl.md'), 'utf-8'),
-  none: await fse.readFile(path.resolve(__dirname, '../../fragments/archive/none.md'), 'utf-8'),
-}
-
-const _ship = {
-  github: await fse.readFile(path.resolve(__dirname, '../../fragments/ops-ship/gh.md'), 'utf-8'),
-  azure: await fse.readFile(path.resolve(__dirname, '../../fragments/ops-ship/az.md'), 'utf-8'),
-  gitlab: await fse.readFile(path.resolve(__dirname, '../../fragments/ops-ship/gl.md'), 'utf-8'),
-}
-
-const _review = {
-  github: await fse.readFile(path.resolve(__dirname, '../../fragments/ops-review/gh.md'), 'utf-8'),
-  azure: await fse.readFile(path.resolve(__dirname, '../../fragments/ops-review/az.md'), 'utf-8'),
-  gitlab: await fse.readFile(path.resolve(__dirname, '../../fragments/ops-review/gl.md'), 'utf-8'),
-}
-
-const _backlog = {
-  github: await fse.readFile(path.resolve(__dirname, '../../fragments/ops-backlog/gh.md'), 'utf-8'),
-  azure: await fse.readFile(path.resolve(__dirname, '../../fragments/ops-backlog/az.md'), 'utf-8'),
-  jira: await fse.readFile(path.resolve(__dirname, '../../fragments/ops-backlog/jira.md'), 'utf-8'),
-}
-
-// Evidence comments target the backlog platform (where the issue/work-item lives).
-const _evidence = {
-  github: await fse.readFile(path.resolve(__dirname, '../../fragments/ops-evidence/gh.md'), 'utf-8'),
-  azure: await fse.readFile(path.resolve(__dirname, '../../fragments/ops-evidence/az.md'), 'utf-8'),
-  jira: await fse.readFile(path.resolve(__dirname, '../../fragments/ops-evidence/jira.md'), 'utf-8'),
-}
-
-// relativePath is POSIX-style relative to the project root; commands live in
-// .opencode/commands/, skill-backed procedures (plan-archive, ops-ship) in
-// .agents/skills/<name>/SKILL.md.
-function patchFile(relativePath, startMarker, endMarker, content, platform, cwd = process.cwd()) {
-  const targetPath = path.join(cwd, ...relativePath.split('/'))
-  if (!fse.pathExistsSync(targetPath)) return
-
-  let fileContent = fse.readFileSync(targetPath, 'utf-8')
-  if (!fileContent.includes(startMarker) || !fileContent.includes(endMarker)) return
-
-  const pattern = new RegExp(`${startMarker.replace(/[.*+?^${}()|[\]\\]/g, '\\$&')}[\\s\\S]*?${endMarker.replace(/[.*+?^${}()|[\]\\]/g, '\\$&')}`)
-  // Replacer function, not a replacement string: the injected fragments contain
-  // shell quoting like $'...' and a string replacement expands $' as "everything
-  // after the match", silently truncating the command. That is how the ops-ship
-  // screenshot comment lost its entire --body argument.
-  fileContent = fileContent.replace(pattern, () => `${startMarker}\n${content.trim()}\n${endMarker}`)
-  fse.writeFileSync(targetPath, `${fileContent.replace(/\s*$/, '')}\n`, 'utf-8')
-  success(`${relativePath} content injected for platform: ${platform}`)
-}
-
-export async function patchArchiveCommand(platform, cwd = process.cwd()) {
-  const repoPlatform = typeof platform === 'object' ? (platform.repoPlatform ?? platform.backlogPlatform ?? 'github') : platform
-  const replacement = _archive[repoPlatform]
-  if (!replacement) return
-  patchFile('.agents/skills/pc-plan-archive/SKILL.md', '<!-- PC-PLATFORM-ARCHIVE-START -->', '<!-- PC-PLATFORM-ARCHIVE-END -->', replacement, repoPlatform, cwd)
-}
-
-export async function patchOpsShip(platform, cwd = process.cwd()) {
-  const repoPlatform = typeof platform === 'object' ? (platform.repoPlatform ?? 'github') : platform
-  const replacement = _ship[repoPlatform]
-  if (!replacement) return
-  patchFile('.agents/skills/pc-ops-ship/SKILL.md', '<!-- PC-PLATFORM-SHIP-START -->', '<!-- PC-PLATFORM-SHIP-END -->', replacement, repoPlatform, cwd)
-}
-
-export async function patchOpsReview(platform, cwd = process.cwd()) {
-  const repoPlatform = typeof platform === 'object' ? (platform.repoPlatform ?? 'github') : platform
-  const replacement = _review[repoPlatform]
-  if (!replacement) return
-  patchFile('.opencode/commands/ops-review.md', '<!-- PC-PLATFORM-REVIEW-START -->', '<!-- PC-PLATFORM-REVIEW-END -->', replacement, repoPlatform, cwd)
-}
-
-export async function patchOpsBacklog(platform, cwd = process.cwd()) {
-  const backlogPlatform = typeof platform === 'object' ? (platform.backlogPlatform ?? 'github') : platform
-  const replacement = _backlog[backlogPlatform]
-  if (!replacement) return
-  patchFile('.opencode/commands/ops-backlog.md', '<!-- PC-PLATFORM-BACKLOG-START -->', '<!-- PC-PLATFORM-BACKLOG-END -->', replacement, backlogPlatform, cwd)
-}
-
-export async function patchOpsEvidence(platform, cwd = process.cwd()) {
-  const backlogPlatform = typeof platform === 'object' ? (platform.backlogPlatform ?? 'github') : platform
-  const replacement = _evidence[backlogPlatform]
-  // browser/none have no CLI to post with: leave the markers empty (the skill skips commenting).
-  if (!replacement) return
-  patchFile('.agents/skills/pc-ops-evidence/SKILL.md', '<!-- PC-PLATFORM-EVIDENCE-START -->', '<!-- PC-PLATFORM-EVIDENCE-END -->', replacement, backlogPlatform, cwd)
-}
-
+import fse from 'fs-extra'
+import path from 'path'
+import { fileURLToPath } from 'url'
+import { success } from '../../utils/exec.js'
+
+const __dirname = path.dirname(fileURLToPath(import.meta.url))
+
+const _archive = {
+  azure: await fse.readFile(path.resolve(__dirname, '../../fragments/archive/az.md'), 'utf-8'),
+  github: await fse.readFile(path.resolve(__dirname, '../../fragments/archive/gh.md'), 'utf-8'),
+  gitlab: await fse.readFile(path.resolve(__dirname, '../../fragments/archive/gl.md'), 'utf-8'),
+  none: await fse.readFile(path.resolve(__dirname, '../../fragments/archive/none.md'), 'utf-8'),
+}
+
+const _ship = {
+  github: await fse.readFile(path.resolve(__dirname, '../../fragments/ops-ship/gh.md'), 'utf-8'),
+  azure: await fse.readFile(path.resolve(__dirname, '../../fragments/ops-ship/az.md'), 'utf-8'),
+  gitlab: await fse.readFile(path.resolve(__dirname, '../../fragments/ops-ship/gl.md'), 'utf-8'),
+}
+
+const _review = {
+  github: await fse.readFile(path.resolve(__dirname, '../../fragments/ops-review/gh.md'), 'utf-8'),
+  azure: await fse.readFile(path.resolve(__dirname, '../../fragments/ops-review/az.md'), 'utf-8'),
+  gitlab: await fse.readFile(path.resolve(__dirname, '../../fragments/ops-review/gl.md'), 'utf-8'),
+}
+
+const _backlog = {
+  github: await fse.readFile(path.resolve(__dirname, '../../fragments/ops-backlog/gh.md'), 'utf-8'),
+  azure: await fse.readFile(path.resolve(__dirname, '../../fragments/ops-backlog/az.md'), 'utf-8'),
+  jira: await fse.readFile(path.resolve(__dirname, '../../fragments/ops-backlog/jira.md'), 'utf-8'),
+}
+
+// Evidence comments target the backlog platform (where the issue/work-item lives).
+const _evidence = {
+  github: await fse.readFile(path.resolve(__dirname, '../../fragments/ops-evidence/gh.md'), 'utf-8'),
+  azure: await fse.readFile(path.resolve(__dirname, '../../fragments/ops-evidence/az.md'), 'utf-8'),
+  jira: await fse.readFile(path.resolve(__dirname, '../../fragments/ops-evidence/jira.md'), 'utf-8'),
+}
+
+// relativePath is POSIX-style relative to the project root; commands live in
+// .opencode/commands/, skill-backed procedures (plan-archive, ops-ship) in
+// .agents/skills/<name>/SKILL.md.
+function patchFile(relativePath, startMarker, endMarker, content, platform, cwd = process.cwd()) {
+  const targetPath = path.join(cwd, ...relativePath.split('/'))
+  if (!fse.pathExistsSync(targetPath)) return
+
+  let fileContent = fse.readFileSync(targetPath, 'utf-8')
+  if (!fileContent.includes(startMarker) || !fileContent.includes(endMarker)) return
+
+  const pattern = new RegExp(`${startMarker.replace(/[.*+?^${}()|[\]\\]/g, '\\$&')}[\\s\\S]*?${endMarker.replace(/[.*+?^${}()|[\]\\]/g, '\\$&')}`)
+  // Replacer function, not a replacement string: the injected fragments contain
+  // shell quoting like $'...' and a string replacement expands $' as "everything
+  // after the match", silently truncating the command. That is how the ops-ship
+  // screenshot comment lost its entire --body argument.
+  fileContent = fileContent.replace(pattern, () => `${startMarker}\n${content.trim()}\n${endMarker}`)
+  fse.writeFileSync(targetPath, `${fileContent.replace(/\s*$/, '')}\n`, 'utf-8')
+  success(`${relativePath} content injected for platform: ${platform}`)
+}
+
+export async function patchArchiveCommand(platform, cwd = process.cwd()) {
+  const repoPlatform = typeof platform === 'object' ? (platform.repoPlatform ?? platform.backlogPlatform ?? 'github') : platform
+  const replacement = _archive[repoPlatform]
+  if (!replacement) return
+  patchFile('.agents/skills/pc-plan-archive/SKILL.md', '<!-- PC-PLATFORM-ARCHIVE-START -->', '<!-- PC-PLATFORM-ARCHIVE-END -->', replacement, repoPlatform, cwd)
+}
+
+export async function patchOpsShip(platform, cwd = process.cwd()) {
+  const repoPlatform = typeof platform === 'object' ? (platform.repoPlatform ?? 'github') : platform
+  const replacement = _ship[repoPlatform]
+  if (!replacement) return
+  patchFile('.agents/skills/pc-ops-ship/SKILL.md', '<!-- PC-PLATFORM-SHIP-START -->', '<!-- PC-PLATFORM-SHIP-END -->', replacement, repoPlatform, cwd)
+}
+
+export async function patchOpsReview(platform, cwd = process.cwd()) {
+  const repoPlatform = typeof platform === 'object' ? (platform.repoPlatform ?? 'github') : platform
+  const replacement = _review[repoPlatform]
+  if (!replacement) return
+  patchFile('.opencode/commands/ops-review.md', '<!-- PC-PLATFORM-REVIEW-START -->', '<!-- PC-PLATFORM-REVIEW-END -->', replacement, repoPlatform, cwd)
+}
+
+export async function patchOpsBacklog(platform, cwd = process.cwd()) {
+  const backlogPlatform = typeof platform === 'object' ? (platform.backlogPlatform ?? 'github') : platform
+  const replacement = _backlog[backlogPlatform]
+  if (!replacement) return
+  patchFile('.opencode/commands/ops-backlog.md', '<!-- PC-PLATFORM-BACKLOG-START -->', '<!-- PC-PLATFORM-BACKLOG-END -->', replacement, backlogPlatform, cwd)
+}
+
+export async function patchOpsEvidence(platform, cwd = process.cwd()) {
+  const backlogPlatform = typeof platform === 'object' ? (platform.backlogPlatform ?? 'github') : platform
+  const replacement = _evidence[backlogPlatform]
+  // browser/none have no CLI to post with: leave the markers empty (the skill skips commenting).
+  if (!replacement) return
+  patchFile('.agents/skills/pc-ops-evidence/SKILL.md', '<!-- PC-PLATFORM-EVIDENCE-START -->', '<!-- PC-PLATFORM-EVIDENCE-END -->', replacement, backlogPlatform, cwd)
+}
+

package/{src → cli}/steps/copy/fullstack-engineer.js

@@ -1,6 +1,7 @@
 import fse from 'fs-extra'
 import path from 'path'
 import { success } from '../../utils/exec.js'
+import { agentColor, yamlColor } from '../../utils/agent-color.js'
 
 const FULLSTACK_FILE = 'fullstack-engineer.md'
 const FULLSTACK_DESCRIPTION = 'Default engineer that accumulates skills from all created persona engineers. Use as fallback when no specialist matches: but prefer spawning a specific engineer for deterministic results.'
@@ -59,7 +60,10 @@ export async function generateFullstackEngineer({ cwd = process.cwd(), updateMod
     // subagent, not primary: build.md and plan.md are the primaries, and
     // pc-subagent-tiers generates both from this file on every startup.
     'mode: subagent',
-    'color: warning',
+    // warning is reserved for plan, so fullstack takes its name-derived hex
+    // like every other subagent.
+    // Quoted: a bare #hex is a YAML comment, which opencode rejects.
+    `color: ${yamlColor(agentColor('fullstack-engineer'))}`,
     'permission:',
     '  edit: allow',
     '  bash: allow',

package/{src → cli}/steps/copy/index.js

@@ -11,7 +11,7 @@ import { generateFullstackEngineer, removeLegacyStartupDirectives } from "./full
 import { patchOpencodeJson, patchOpencodePackage } from "./opencode-json.js"
 
 const __dirname = path.dirname(fileURLToPath(import.meta.url))
-const CONTENT_DIR = path.resolve(__dirname, "../../content")
+const CONTENT_DIR = path.resolve(__dirname, "../../../harness")
 
 export async function copyContentStep(platform, ctx = {}) {
   header("Step 5, Copying agent-harness files")

package/{src → cli}/steps/copy/opencode-json.js

@@ -10,6 +10,15 @@ const SHARED_PERMISSIONS = [
   ['todowrite', 'allow'],
 ]
 
+// agent-browser replaced the @different-ai/opencode-browser plugin; any entry
+// with that prefix in the plugin array is stale and gets stripped on update.
+const STALE_BROWSER_PLUGIN_PREFIX = '@different-ai/opencode-browser'
+const AGENT_BROWSER_MCP = {
+  type: 'local',
+  command: ['agent-browser', 'mcp', '--tools', 'core'],
+  enabled: true,
+}
+
 function applyModify(text, jsonPath, value) {
   const edits = modify(text, jsonPath, value, {
     formattingOptions: { insertSpaces: true, tabSize: 2 },
@@ -47,6 +56,14 @@ export async function patchOpencodeJson(cwd = process.cwd()) {
     parsed?.agent?.plan?.mode === 'primary' &&
     parsed?.agent?.plan?.permission?.edit === 'deny'
   )
+
+  // default_agent pointing at fullstack-engineer is now invalid: it became a
+  // subagent when build and plan took over as the only primaries, so opencode
+  // has no valid default to open a session with. A deliberate choice of build
+  // or plan is left alone; anything else is repointed at plan, so a session
+  // starts read-only.
+  const currentDefault = parsed?.default_agent
+  const needsDefaultAgent = currentDefault !== 'plan' && currentDefault !== 'build'
   const needsSkillPermission = parsed?.permission?.skill !== 'allow'
   const missingSharedPermissions = SHARED_PERMISSIONS.filter(
     ([key, value]) => parsed?.permission?.[key] !== value,
@@ -60,8 +77,11 @@ export async function patchOpencodeJson(cwd = process.cwd()) {
     parsed?.compaction?.auto === true &&
     parsed?.compaction?.prune === true
   )
+  const staleBrowserPlugins = (Array.isArray(parsed?.plugin) ? parsed.plugin : [])
+    .filter(entry => typeof entry === 'string' && entry.startsWith(STALE_BROWSER_PLUGIN_PREFIX))
+  const needsBrowserMcp = JSON.stringify(parsed?.mcp?.['agent-browser']) !== JSON.stringify(AGENT_BROWSER_MCP)
 
-  if (!needsAgentOverride && !needsSkillPermission && missingSharedPermissions.length === 0 && !needsSkillsPaths && !needsCompaction) {
+  if (!needsAgentOverride && !needsDefaultAgent && !needsSkillPermission && missingSharedPermissions.length === 0 && !needsSkillsPaths && !needsCompaction && staleBrowserPlugins.length === 0 && !needsBrowserMcp) {
     return { patched: false }
   }
 
@@ -78,6 +98,9 @@ export async function patchOpencodeJson(cwd = process.cwd()) {
     text = applyModify(text, ['agent', 'plan', 'mode'], 'primary')
     text = applyModify(text, ['agent', 'plan', 'permission', 'edit'], 'deny')
   }
+  if (needsDefaultAgent) {
+    text = applyModify(text, ['default_agent'], 'plan')
+  }
   if (needsSkillPermission) text = applyModify(text, ['permission', 'skill'], 'allow')
   for (const [key, value] of missingSharedPermissions) {
     text = applyModify(text, ['permission', key], value)
@@ -99,10 +122,22 @@ export async function patchOpencodeJson(cwd = process.cwd()) {
     text = applyModify(text, ['compaction', 'reserved'], 10000)
   }
 
+  // Swap the retired opencode-browser plugin for the agent-browser MCP server
+  if (staleBrowserPlugins.length > 0) {
+    const keptPlugins = parsed.plugin.filter(entry => !staleBrowserPlugins.includes(entry))
+    text = applyModify(text, ['plugin'], keptPlugins)
+  }
+  if (needsBrowserMcp) {
+    text = applyModify(text, ['mcp', 'agent-browser'], AGENT_BROWSER_MCP)
+  }
+
   await fse.writeFile(opencodePath, text, 'utf-8')
   if (needsAgentOverride) {
     success('Set build/plan as the primary agents in opencode.jsonc (plan is read-only)')
   }
+  if (needsDefaultAgent) {
+    success(`default_agent -> plan${currentDefault ? ` (was ${currentDefault})` : ''}`)
+  }
   if (needsSkillPermission) {
     success('Allowed skill loading in opencode.jsonc')
   }
@@ -115,6 +150,12 @@ export async function patchOpencodeJson(cwd = process.cwd()) {
   if (needsCompaction) {
     success('Enabled context pruning (compaction.prune) in opencode.jsonc')
   }
+  if (staleBrowserPlugins.length > 0) {
+    success(`Removed ${staleBrowserPlugins.length} stale opencode-browser plugin entr${staleBrowserPlugins.length === 1 ? 'y' : 'ies'} in opencode.jsonc`)
+  }
+  if (needsBrowserMcp) {
+    success('Configured agent-browser MCP server in opencode.jsonc')
+  }
 
   return { patched: true }
 }
@@ -126,6 +167,9 @@ const OPENCODE_PACKAGE_DEPENDENCIES = {
   'solid-js': '1.9.12',
 }
 
+// agent-browser replaced this plugin; remove it from consumer installs on update
+const STALE_PACKAGE_DEPENDENCIES = ['@different-ai/opencode-browser']
+
 export async function patchOpencodePackage(cwd = process.cwd()) {
   const packagePath = path.join(cwd, '.opencode', 'package.json')
   if (!await fse.pathExists(packagePath)) return { patched: false }
@@ -139,6 +183,11 @@ export async function patchOpencodePackage(cwd = process.cwd()) {
     packageJson.dependencies[name] = version
     patched = true
   }
+  for (const name of STALE_PACKAGE_DEPENDENCIES) {
+    if (!(name in packageJson.dependencies)) continue
+    delete packageJson.dependencies[name]
+    patched = true
+  }
   if (!patched) return { patched: false }
 
   await fse.writeJson(packagePath, packageJson, { spaces: 2 })

package/{src → cli}/steps/copy/skills.js

@@ -5,8 +5,8 @@ import { info, success } from '../../utils/exec.js'
 import { canUpdateManagedFile, readUpdateManifest, recordManagedFile, writeUpdateManifest } from '../../utils/update-manifest.js'
 
 const __dirname = path.dirname(fileURLToPath(import.meta.url))
-const CONTENT_SKILLS_DIR = path.resolve(__dirname, '../../content/.agents/skills')
-const CONTENT_SKILLS_LOCK = path.resolve(__dirname, '../../content/skills-lock.json')
+const CONTENT_SKILLS_DIR = path.resolve(__dirname, '../../../harness/.agents/skills')
+const CONTENT_SKILLS_LOCK = path.resolve(__dirname, '../../../harness/skills-lock.json')
 
 // Userstory skills parse backlog work items: selected by backlogPlatform only.
 // Mixing the two axes here installs the wrong variant on mixed setups, because

package/{src → cli}/steps/metadata/index.js

@@ -59,6 +59,10 @@ export async function writeHarnessConfig(data) {
     ),
     codegraph: !!(optionalTools.codegraph?.optedIn ?? optionalTools.codegraph),
     memory: !!(optionalTools.memory?.optedIn ?? optionalTools.memory),
+    // humanizer was missing here, so a selection never survived a metadata
+    // write and patchGuardrails always saw it as off, leaving its marker
+    // section empty however the project was actually set up.
+    humanizer: !!(optionalTools.humanizer?.optedIn ?? optionalTools.humanizer),
   }
 
   const payload = {

package/{src → cli}/steps/models/format.js

@@ -1,88 +1,88 @@
-import { search, select } from '@inquirer/prompts'
-import fse from 'fs-extra'
-import path from 'path'
-import { fileURLToPath } from 'url'
-
-const __dirname = path.dirname(fileURLToPath(import.meta.url));
-const MODELS_PRESET_PATH = path.resolve(__dirname, '../../presets/models.json');
-const modelsPreset = await fse.readJson(MODELS_PRESET_PATH);
-
-function costTier(input) {
-  if (input === undefined || input === null) return '';
-  const tier = modelsPreset.costTiers.find(t => t.max === undefined || input <= t.max);
-  return tier ? ` ${tier.label}` : '';
-}
-
-function costTierDisplay(cost, canonicalCost) {
-  return costTier(canonicalCost !== undefined ? canonicalCost : cost);
-}
-
-function formatPrice(price) {
-  if (price === undefined || price === null) return '?';
-  if (price === 0) return '$0 (subscription)';
-  return `$${price}/M`;
-}
-
-export function buildDisplayModels(rawModels) {
-  return rawModels.map(m => {
-    const priceStr = formatPrice(m.cost);
-    const canonicalNote = m.canonicalCost !== undefined
-      ? ` · official price: ${formatPrice(m.canonicalCost)}/M`
-      : '';
-    const context = m.context ? `${m.context / 1000}k` : '?';
-    return {
-      ...m,
-      label: `${m.name}${costTierDisplay(m.cost, m.canonicalCost)}, ${m.id}`,
-      description: `${priceStr}${canonicalNote} · context: ${context}`,
-    };
-  });
-}
-
-export function buildModelChoices(input, models) {
-  const q = (input || '').toLowerCase();
-  const filtered = q
-    ? models.filter(m =>
-        m.label.toLowerCase().includes(q) ||
-        m.id.toLowerCase().includes(q)
-      )
-    : models;
-
-  return [
-    {
-      name: 'None',
-      value: null,
-      description: 'Leave this model unset',
-    },
-    {
-      name: '← Change provider',
-      value: '__back__',
-      description: 'Go back to provider selection',
-    },
-    ...filtered.slice(0, 50).map(m => ({
-      name: m.label,
-      value: m.id,
-      description: m.description,
-    })),
-  ];
-}
-
-export function pickModel(message, models) {
-  return search({
-    message,
-    source: input => buildModelChoices(input, models),
-  });
-}
-
-export function filterModelsByProvider(models, provider) {
-  if (!provider) return models
-  return models.filter(m => m.id.startsWith(`${provider}/`))
-}
-
-export function pickProvider(message) {
-  return select({
-    message,
-    choices: modelsPreset.providers.map(p => ({ value: p.value, name: p.name })),
-  })
-}
-
-export { modelsPreset };
+import { search, select } from '@inquirer/prompts'
+import fse from 'fs-extra'
+import path from 'path'
+import { fileURLToPath } from 'url'
+
+const __dirname = path.dirname(fileURLToPath(import.meta.url));
+const MODELS_PRESET_PATH = path.resolve(__dirname, '../../presets/models.json');
+const modelsPreset = await fse.readJson(MODELS_PRESET_PATH);
+
+function costTier(input) {
+  if (input === undefined || input === null) return '';
+  const tier = modelsPreset.costTiers.find(t => t.max === undefined || input <= t.max);
+  return tier ? ` ${tier.label}` : '';
+}
+
+function costTierDisplay(cost, canonicalCost) {
+  return costTier(canonicalCost !== undefined ? canonicalCost : cost);
+}
+
+function formatPrice(price) {
+  if (price === undefined || price === null) return '?';
+  if (price === 0) return '$0 (subscription)';
+  return `$${price}/M`;
+}
+
+export function buildDisplayModels(rawModels) {
+  return rawModels.map(m => {
+    const priceStr = formatPrice(m.cost);
+    const canonicalNote = m.canonicalCost !== undefined
+      ? ` · official price: ${formatPrice(m.canonicalCost)}/M`
+      : '';
+    const context = m.context ? `${m.context / 1000}k` : '?';
+    return {
+      ...m,
+      label: `${m.name}${costTierDisplay(m.cost, m.canonicalCost)}, ${m.id}`,
+      description: `${priceStr}${canonicalNote} · context: ${context}`,
+    };
+  });
+}
+
+export function buildModelChoices(input, models) {
+  const q = (input || '').toLowerCase();
+  const filtered = q
+    ? models.filter(m =>
+        m.label.toLowerCase().includes(q) ||
+        m.id.toLowerCase().includes(q)
+      )
+    : models;
+
+  return [
+    {
+      name: 'None',
+      value: null,
+      description: 'Leave this model unset',
+    },
+    {
+      name: '← Change provider',
+      value: '__back__',
+      description: 'Go back to provider selection',
+    },
+    ...filtered.slice(0, 50).map(m => ({
+      name: m.label,
+      value: m.id,
+      description: m.description,
+    })),
+  ];
+}
+
+export function pickModel(message, models) {
+  return search({
+    message,
+    source: input => buildModelChoices(input, models),
+  });
+}
+
+export function filterModelsByProvider(models, provider) {
+  if (!provider) return models
+  return models.filter(m => m.id.startsWith(`${provider}/`))
+}
+
+export function pickProvider(message) {
+  return select({
+    message,
+    choices: modelsPreset.providers.map(p => ({ value: p.value, name: p.name })),
+  })
+}
+
+export { modelsPreset };