expandai 0.0.4 → 0.0.6

package/src/Install/Opencode/Hook.ts

@@ -1,55 +0,0 @@
-import { homedir } from 'node:os'
-import { FileSystem, Path } from '@effect/platform'
-import { NodeFileSystem, NodePath } from '@effect/platform-node'
-import { Config, Console, Effect, Match } from 'effect'
-import type { InstallScope } from '../Mcp.js'
-
-/**
- * OpenCode hook = a JS plugin file at `.opencode/plugins/` (project) or
- * `~/.config/opencode/plugins/` (global). The plugin shells out to
- * `expandai hook opencode` so all fetch logic stays in the CLI.
- *
- * The plugin uses `tool.execute.after` (the only hook whose contract lets us
- * replace the rendered result via `output.output`); `tool.execute.before` is
- * limited to mutating tool args. See @opencode-ai/plugin's dist/index.d.ts.
- */
-
-export const PLUGIN_FILE = 'expandai-webfetch.js'
-
-export class OpencodeHook extends Effect.Service<OpencodeHook>()('@expandai/cli/Install/Opencode/Hook', {
-	dependencies: [NodeFileSystem.layer, NodePath.layer],
-	effect: Effect.gen(function* () {
-		const fs = yield* FileSystem.FileSystem
-		const path = yield* Path.Path
-		const source = path.join(path.dirname(yield* path.fromFileUrl(new URL(import.meta.url))), PLUGIN_FILE)
-
-		const home = yield* Config.string('HOME').pipe(Config.withDefault(homedir()))
-		const cwd = yield* Config.string('PWD').pipe(Config.withDefault(process.cwd()))
-
-		const pathFor = Effect.fn(function* (scope: InstallScope) {
-			return yield* Match.value(scope).pipe(
-				Match.when('global', () => Effect.succeed(`${home}/.config/opencode/plugins/${PLUGIN_FILE}`)),
-				Match.when('project', () => Effect.succeed(`${cwd}/.opencode/plugins/${PLUGIN_FILE}`)),
-				Match.exhaustive,
-			)
-		})
-
-		const install = Effect.fn('OpencodeHook.install')(function* (scope: InstallScope) {
-			const target = yield* pathFor(scope)
-			yield* fs.makeDirectory(path.dirname(target), { recursive: true })
-			yield* fs.copyFile(source, target)
-			yield* Console.log(`Installed expandai webfetch plugin at ${target}`)
-		})
-
-		const uninstall = Effect.fn('OpencodeHook.uninstall')(function* (scope: InstallScope) {
-			const target = yield* pathFor(scope)
-			const exists = yield* fs.exists(target)
-			if (exists) {
-				yield* fs.remove(target)
-				yield* Console.log(`Removed expandai webfetch plugin from ${target}`)
-			}
-		})
-
-		return { install, uninstall, pathFor } as const
-	}),
-}) {}

package/src/Install/Opencode/Mcp.ts

@@ -1,87 +0,0 @@
-import { homedir } from 'node:os'
-import { Config, Console, Effect, Match, Record, Schema } from 'effect'
-import { CliInvocation, ConfigIo, McpParseError, McpWriteError, OpencodeConfigSchema, SERVER_KEY } from '../Domain.js'
-import type { InstallScope } from '../Mcp.js'
-
-/**
- * OpenCode MCP descriptor — its own shape (per opencode.ai/docs/mcp-servers):
- * top-level key is `mcp` (not `mcpServers`), `command` is an array (no
- * separate args), env is called `environment`, and `type` uses
- * `local` / `remote` rather than `stdio` / `http`.
- *
- *   - global  → `~/.config/opencode/opencode.json`
- *   - project → `<cwd>/opencode.json`
- */
-export class Entry extends Schema.Class<Entry>('OpencodeMcpEntry')({
-	type: Schema.Literal('local'),
-	command: Schema.Array(Schema.String),
-	environment: Schema.optional(Schema.Record({ key: Schema.String, value: Schema.String })),
-	enabled: Schema.optional(Schema.Boolean),
-}) {}
-
-export class OpencodeMcp extends Effect.Service<OpencodeMcp>()('@expandai/cli/Install/Opencode/Mcp', {
-	dependencies: [ConfigIo.Default, CliInvocation.Default],
-	effect: Effect.gen(function* () {
-		const io = yield* ConfigIo
-		const cli = yield* CliInvocation
-		const home = yield* Config.string('HOME').pipe(Config.withDefault(homedir()))
-		const cwd = yield* Config.string('PWD').pipe(Config.withDefault(process.cwd()))
-
-		const pathFor = Effect.fn(function* (scope: InstallScope) {
-			return yield* Match.value(scope).pipe(
-				Match.when('global', () => Effect.succeed(`${home}/.config/opencode/opencode.json`)),
-				Match.when('project', () => Effect.succeed(`${cwd}/opencode.json`)),
-				Match.exhaustive,
-			)
-		})
-
-		const readConfig = Effect.fn(function* (file: string) {
-			return yield* io
-				.read(file, OpencodeConfigSchema)
-				.pipe(Effect.mapError((error) => new McpParseError({ path: file, error })))
-		})
-
-		const writeConfig = Effect.fn(function* (file: string, value: unknown) {
-			yield* io
-				.write(file, value, OpencodeConfigSchema)
-				.pipe(Effect.mapError((error) => new McpWriteError({ path: file, error })))
-		})
-
-		const install = Effect.fn(function* (scope: InstallScope) {
-			const file = yield* pathFor(scope)
-			const config = yield* readConfig(file)
-			const invocation = yield* cli.resolve()
-			yield* writeConfig(file, {
-				...config,
-				mcp: {
-					...config.mcp,
-					[SERVER_KEY]: new Entry({
-						type: 'local',
-						command: [invocation.command, ...invocation.args, 'mcp', 'run'],
-						environment: { EXPANDAI_HARNESS: 'opencode' },
-						enabled: true,
-					}),
-				},
-			})
-			yield* Console.log(`Installed expandai MCP server into ${file}`)
-		})
-
-		const uninstall = Effect.fn(function* (scope: InstallScope) {
-			const file = yield* pathFor(scope)
-			const config = yield* readConfig(file)
-			if (!(SERVER_KEY in config.mcp)) {
-				return
-			}
-			yield* writeConfig(file, { ...config, mcp: Record.remove(config.mcp, SERVER_KEY) })
-			yield* Console.log(`Removed expandai MCP server from ${file}`)
-		})
-
-		const isInstalled = Effect.fn(function* (scope: InstallScope) {
-			const file = yield* pathFor(scope)
-			const config = yield* readConfig(file)
-			return SERVER_KEY in config.mcp
-		})
-
-		return { install, uninstall, isInstalled, pathFor } as const
-	}),
-}) {}

package/src/Install/Opencode/Skill.ts

@@ -1,48 +0,0 @@
-import { homedir } from 'node:os'
-import { Config, Effect, Match } from 'effect'
-import { SkillIo } from '../Domain.js'
-import type { InstallScope } from '../Mcp.js'
-
-/**
- * OpenCode skills are Claude-Code-compatible Markdown files. Per
- * opencode.ai/docs/skills, OpenCode auto-discovers them under either
- * `.opencode/skills/<name>/`, `.claude/skills/<name>/`, or
- * `.agents/skills/<name>/` (and the `~/.config/opencode/...` equivalents
- * for global). We ship to OpenCode-native paths.
- *
- *   - global  → `~/.config/opencode/skills/expandai/SKILL.md`
- *   - project → `<cwd>/.opencode/skills/expandai/SKILL.md`
- */
-
-export const SKILL_NAME = 'expandai'
-
-export class OpencodeSkill extends Effect.Service<OpencodeSkill>()('@expandai/cli/Install/Opencode/Skill', {
-	dependencies: [SkillIo.Default],
-	effect: Effect.gen(function* () {
-		const io = yield* SkillIo
-		const home = yield* Config.string('HOME').pipe(Config.withDefault(homedir()))
-		const cwd = yield* Config.string('PWD').pipe(Config.withDefault(process.cwd()))
-
-		const pathFor = Effect.fn(function* (scope: InstallScope) {
-			return yield* Match.value(scope).pipe(
-				Match.when('global', () => Effect.succeed(`${home}/.config/opencode/skills/${SKILL_NAME}`)),
-				Match.when('project', () => Effect.succeed(`${cwd}/.opencode/skills/${SKILL_NAME}`)),
-				Match.exhaustive,
-			)
-		})
-
-		const install = Effect.fn(function* (scope: InstallScope) {
-			return yield* io.install(yield* pathFor(scope))
-		})
-
-		const uninstall = Effect.fn(function* (scope: InstallScope) {
-			return yield* io.uninstall(yield* pathFor(scope))
-		})
-
-		const isCurrent = Effect.fn(function* (scope: InstallScope) {
-			return yield* io.isCurrent(yield* pathFor(scope))
-		})
-
-		return { install, uninstall, isCurrent, pathFor } as const
-	}),
-}) {}

package/src/Install/Opencode/expandai-webfetch.d.ts

@@ -1,23 +0,0 @@
-export interface OpencodeWebfetchPluginInput {
-	readonly tool: string
-	readonly sessionID?: string
-	readonly callID?: string
-	readonly args?: {
-		readonly url?: string
-	}
-}
-
-export interface OpencodeWebfetchPluginOutput {
-	title?: string
-	output?: string
-	metadata?: unknown
-}
-
-export interface OpencodeWebfetchPluginHooks {
-	readonly 'tool.execute.after': (
-		input: OpencodeWebfetchPluginInput,
-		output: OpencodeWebfetchPluginOutput,
-	) => Promise<void>
-}
-
-export declare const ExpandaiWebfetch: () => Promise<OpencodeWebfetchPluginHooks>

package/src/Install/Opencode/expandai-webfetch.js

@@ -1,56 +0,0 @@
-// expandai OpenCode plugin - routes webfetch through the expandai CLI.
-// Generated by `expandai hook install opencode <scope>`.
-//
-// We hook `tool.execute.after` rather than `.before` because OpenCode's plugin
-// contract only lets `before` mutate args (`output.args`); replacing the
-// rendered result is only possible from `after`, where `output` is the tool
-// output object (`{ title, output, metadata }`). See @opencode-ai/plugin's
-// dist/index.d.ts.
-import { spawn } from 'node:child_process'
-
-const runHook = (command, args, payload) =>
-	new Promise((resolve, reject) => {
-		const child = spawn(command, args, {
-			stdio: ['pipe', 'pipe', 'inherit'],
-			env: { ...process.env, EXPANDAI_CLI_CONTEXT: 'agent', EXPANDAI_HARNESS: 'opencode' },
-		})
-		let stdout = ''
-		child.stdout.setEncoding('utf8')
-		child.stdout.on('data', (chunk) => {
-			stdout += chunk
-		})
-		child.on('error', reject)
-		child.on('close', (exitCode) => resolve({ exitCode, stdout }))
-		// Writing to stdin of a binary that failed to spawn raises EPIPE; the
-		// spawn failure itself is reported through the 'error' handler above.
-		child.stdin.on('error', () => {})
-		child.stdin.end(payload)
-	})
-
-// Prefer the installed binary; fall back to `npx -y expandai` so the plugin
-// works for people who have not installed the expandai CLI globally.
-const runExpandai = (args, payload) =>
-	runHook('expandai', args, payload).catch((error) =>
-		error?.code === 'ENOENT' ? runHook('npx', ['-y', 'expandai', ...args], payload) : Promise.reject(error),
-	)
-
-export const ExpandaiWebfetch = async () => ({
-	'tool.execute.after': async (input, output) => {
-		if (input.tool !== 'webfetch') return
-		const url = input.args?.url
-		if (typeof url !== 'string' || url.length === 0) return
-
-		try {
-			const { exitCode, stdout } = await runExpandai(['hook', 'opencode'], JSON.stringify({ url }))
-			if (exitCode !== 0 || stdout.trim().length === 0) return
-
-			const { markdown } = JSON.parse(stdout)
-			if (typeof markdown !== 'string' || markdown.length === 0) return
-
-			output.output = markdown
-			output.title = url
-		} catch (error) {
-			console.error(`expandai-webfetch plugin failed: ${error?.message ?? error}`)
-		}
-	},
-})

package/src/Install/Skill.ts

@@ -1,57 +0,0 @@
-import { Console, Effect, Match } from 'effect'
-import { ClaudeSkill } from './Claude/Skill.js'
-import { CodexSkill } from './Codex/Skill.js'
-import { CursorSkill } from './Cursor/Skill.js'
-import type { Host, InstallScope } from './Mcp.js'
-import { OpencodeSkill } from './Opencode/Skill.js'
-
-/**
- * Skill install dispatcher. Copies the bundled `SKILL.md` from the CLI's
- * own `skills/expandai/` source into the host-specific destination.
- *
- *   - claude-code: `~/.claude/skills/expandai/` (global) or
- *                  `<cwd>/.claude/skills/expandai/` (project)
- *   - cursor:      `~/.cursor/skills/expandai/` (global) or
- *                  `<cwd>/.cursor/skills/expandai/` (project)
- *   - opencode:    `~/.config/opencode/skills/expandai/` (global) or
- *                  `<cwd>/.opencode/skills/expandai/` (project)
- *   - codex:       `~/.agents/skills/expandai/` (global) or
- *                  `<cwd>/.agents/skills/expandai/` (project)
- *
- * All hosts use the same `SKILL.md` + YAML frontmatter open standard,
- * so the bundled skill directory copies in unchanged.
- */
-
-export class Skill extends Effect.Service<Skill>()('@expandai/cli/Install/Skill', {
-	dependencies: [ClaudeSkill.Default, CursorSkill.Default, OpencodeSkill.Default, CodexSkill.Default],
-	effect: Effect.gen(function* () {
-		const claude = yield* ClaudeSkill
-		const cursor = yield* CursorSkill
-		const opencode = yield* OpencodeSkill
-		const codex = yield* CodexSkill
-
-		const install = Effect.fn('Skill.install')(function* (host: Host, scope: InstallScope) {
-			const target = yield* Match.value(host).pipe(
-				Match.when('claude-code', () => claude.install(scope)),
-				Match.when('cursor', () => cursor.install(scope)),
-				Match.when('opencode', () => opencode.install(scope)),
-				Match.when('codex', () => codex.install(scope)),
-				Match.exhaustive,
-			)
-			yield* Console.log(`Installed expandai skill into ${target}`)
-		})
-
-		const uninstall = Effect.fn('Skill.uninstall')(function* (host: Host, scope: InstallScope) {
-			const target = yield* Match.value(host).pipe(
-				Match.when('claude-code', () => claude.uninstall(scope)),
-				Match.when('cursor', () => cursor.uninstall(scope)),
-				Match.when('opencode', () => opencode.uninstall(scope)),
-				Match.when('codex', () => codex.uninstall(scope)),
-				Match.exhaustive,
-			)
-			yield* Console.log(`Removed expandai skill from ${target}`)
-		})
-
-		return { install, uninstall } as const
-	}),
-}) {}

package/src/Install/Uninstall.ts

@@ -1,82 +0,0 @@
-import { Array, Effect, Match, Schema } from 'effect'
-import { type HookHost, HookInstaller } from './Hook.js'
-import { Host, InstallScope, Mcp } from './Mcp.js'
-import { Skill } from './Skill.js'
-
-export const UninstallTarget = Schema.Literal('all', 'hook', 'skill', 'mcp')
-
-export class UninstallOptions extends Schema.Class<UninstallOptions>('UninstallOptions')({
-	target: Schema.optional(UninstallTarget),
-	host: Schema.optional(Host),
-	scope: Schema.optional(InstallScope),
-}) {}
-
-const SCOPES: (typeof InstallScope.Type)[] = ['global', 'project']
-const HOSTS: (typeof Host.Type)[] = ['claude-code', 'cursor', 'opencode', 'codex']
-
-const isHookHost = (host: typeof Host.Type): host is HookHost => host === 'claude-code' || host === 'opencode'
-
-export class Uninstall extends Effect.Service<Uninstall>()('@expandai/cli/Install/Uninstall', {
-	dependencies: [HookInstaller.Default, Mcp.Default, Skill.Default],
-	effect: Effect.gen(function* () {
-		const hook = yield* HookInstaller
-		const mcp = yield* Mcp
-		const skill = yield* Skill
-
-		const uninstall = Effect.fn(function* (options: UninstallOptions = new UninstallOptions({})) {
-			const target = options.target ?? 'all'
-			const hosts = options.host ? [options.host] : HOSTS
-			const scopes = options.scope ? [options.scope] : SCOPES
-
-			// Sequential by default: a future change that merges any two `(host,
-			// scope)` config paths into the same file shouldn't silently race.
-			// Logout/uninstall happens once per session; throughput isn't the
-			// bottleneck.
-			const uninstallHooks = Effect.fnUntraced(function* () {
-				const hookHosts = Array.filter(hosts, isHookHost)
-				yield* Effect.forEach(
-					hookHosts,
-					(host) => Effect.forEach(scopes, (scope) => hook.uninstall(host, scope), { discard: true }),
-					{ discard: true },
-				)
-			})
-
-			const uninstallSkills = Effect.fnUntraced(function* () {
-				yield* Effect.forEach(
-					hosts,
-					(host) => Effect.forEach(scopes, (scope) => skill.uninstall(host, scope), { discard: true }),
-					{ discard: true },
-				)
-			})
-
-			const uninstallMcp = Effect.fnUntraced(function* () {
-				yield* Effect.forEach(
-					hosts,
-					(host) => Effect.forEach(scopes, (scope) => mcp.uninstall(host, scope), { discard: true }),
-					{ discard: true },
-				)
-			})
-
-			const uninstallMcpWithoutHooks = Effect.fnUntraced(function* () {
-				const mcpOnlyHosts = Array.filter(hosts, (host) => !isHookHost(host))
-				yield* Effect.forEach(
-					mcpOnlyHosts,
-					(host) => Effect.forEach(scopes, (scope) => mcp.uninstall(host, scope), { discard: true }),
-					{ discard: true },
-				)
-			})
-
-			yield* Match.value(target).pipe(
-				Match.when('all', () =>
-					uninstallHooks().pipe(Effect.zipRight(uninstallMcpWithoutHooks()), Effect.zipRight(uninstallSkills())),
-				),
-				Match.when('hook', () => uninstallHooks()),
-				Match.when('skill', () => uninstallSkills()),
-				Match.when('mcp', () => uninstallMcp()),
-				Match.exhaustive,
-			)
-		})
-
-		return { uninstall } as const
-	}),
-}) {}

package/src/MarkdownAnsi.ts

@@ -1,162 +0,0 @@
-/**
- * Zero-dependency ANSI syntax highlighting for markdown printed to an
- * interactive terminal.
- *
- * This is a highlighter, not a renderer: the input text is preserved
- * byte-for-byte and only wrapped in ANSI escape sequences, so copying
- * from the terminal or stripping the escapes yields the exact document
- * the API returned. Piped output (non-TTY) must stay unstyled — gate
- * calls with `shouldColorizeMarkdown`.
- */
-
-// Styling is intentionally limited to 4-bit SGR (bold/dim/underline + the 8
-// base colors): it renders on every color-capable terminal and inherits the
-// user's palette. Do NOT introduce 256-color (38;5;n) or truecolor (38;2;r;g;b)
-// sequences without adding capability detection first — truecolor needs
-// COLORTERM=truecolor|24bit (TERM alone is not enough: e.g. ghostty sets
-// TERM=xterm-ghostty), and 256-color needs TERM=*-256color; emitting either
-// tier on a lesser terminal produces garbage.
-const RESET = '\x1b[0m'
-const BOLD = '\x1b[1m'
-const DIM = '\x1b[2m'
-const CYAN = '\x1b[36m'
-const YELLOW = '\x1b[33m'
-const GREEN = '\x1b[32m'
-const BLUE_UNDERLINE = '\x1b[34;4m'
-const HEADING = '\x1b[1;36m'
-
-export interface ColorizeEnvironment {
-	readonly isTty: boolean
-	readonly env: Readonly<Record<string, string | undefined>>
-}
-
-/**
- * Standard CLI color negotiation: color only on an interactive terminal,
- * `NO_COLOR` (https://no-color.org) and `TERM=dumb` opt out, a non-zero
- * `FORCE_COLOR` opts in regardless of the terminal.
- */
-export function shouldColorizeMarkdown(
-	environment: ColorizeEnvironment = { isTty: process.stdout.isTTY === true, env: process.env },
-): boolean {
-	const { env, isTty } = environment
-	const forceColor = env.FORCE_COLOR?.trim()
-	if (forceColor !== undefined && forceColor !== '') return forceColor !== '0'
-	if (env.NO_COLOR !== undefined && env.NO_COLOR !== '') return false
-	if (env.TERM === 'dumb') return false
-	return isTty
-}
-
-function styleLine(style: string, line: string): string {
-	return line === '' ? line : `${style}${line}${RESET}`
-}
-
-// Inline code spans are styled first and must be shielded from the link,
-// bold, and table-pipe passes; ANSI escapes never contain \x00, so a
-// NUL-delimited stash is collision-free.
-function styleInline(line: string, options?: { readonly dimPipes: boolean }): string {
-	const stash: string[] = []
-	let out = line.replace(/`[^`\n]+`/g, (code) => {
-		stash.push(`${CYAN}${code}${RESET}`)
-		return `\x00${stash.length - 1}\x00`
-	})
-	if (options?.dimPipes) {
-		// While code spans are stashed, so pipes inside `...` keep their
-		// code styling instead of being re-wrapped in DIM.
-		out = out.replaceAll('|', `${DIM}|${RESET}`)
-	}
-	out = out.replace(
-		/\[([^\]\n]*)\]\(([^)\n]*)\)/g,
-		(_match, text: string, target: string) =>
-			`${DIM}[${RESET}${BLUE_UNDERLINE}${text}${RESET}${DIM}](${target})${RESET}`,
-	)
-	out = out.replace(/\*\*([^*\n]+)\*\*/g, (_match, text: string) => `${BOLD}**${text}**${RESET}`)
-	return out.replace(/\x00(\d+)\x00/g, (_match, index: string) => stash[Number(index)] ?? '')
-}
-
-const FENCE_PATTERN = /^(\s*)(`{3,}|~{3,})(.*)$/
-const HEADING_PATTERN = /^#{1,6}\s/
-const HR_PATTERN = /^ {0,3}(-{3,}|\*{3,}|_{3,})\s*$/
-const LIST_MARKER_PATTERN = /^(\s*)([-*+]|\d{1,9}[.)])(\s+)(.*)$/
-const FRONTMATTER_KEY_PATTERN = /^(\s*)([\w.-]+):(.*)$/
-
-/**
- * Wrap a markdown document in ANSI styles for terminal display. Line-based:
- * headings, fences, front matter, blockquotes, list markers, and table pipes
- * get block styling; plain text lines get inline code / link / bold styling.
- */
-export function highlightMarkdownAnsi(markdown: string): string {
-	const lines = markdown.split('\n')
-	const out: string[] = []
-	let inFrontmatter = false
-	let fenceClose: RegExp | undefined
-
-	lines.forEach((line, index) => {
-		if (fenceClose) {
-			if (FENCE_PATTERN.test(line) && fenceClose.test(line)) {
-				fenceClose = undefined
-				out.push(styleLine(DIM, line))
-			} else {
-				out.push(styleLine(YELLOW, line))
-			}
-			return
-		}
-
-		if (index === 0 && line === '---') {
-			inFrontmatter = true
-			out.push(styleLine(DIM, line))
-			return
-		}
-		if (inFrontmatter) {
-			if (line === '---') {
-				inFrontmatter = false
-				out.push(styleLine(DIM, line))
-				return
-			}
-			const keyMatch = line.match(FRONTMATTER_KEY_PATTERN)
-			out.push(
-				keyMatch ? `${keyMatch[1]}${CYAN}${keyMatch[2]}${RESET}${DIM}:${keyMatch[3]}${RESET}` : styleLine(DIM, line),
-			)
-			return
-		}
-
-		const fenceMatch = line.match(FENCE_PATTERN)
-		if (fenceMatch) {
-			const marker = fenceMatch[2] ?? '```'
-			fenceClose = new RegExp(`^\\s*${marker[0] === '`' ? '`' : '~'}{${marker.length},}\\s*$`)
-			out.push(styleLine(DIM, line))
-			return
-		}
-
-		if (HEADING_PATTERN.test(line)) {
-			out.push(styleLine(HEADING, line))
-			return
-		}
-		if (HR_PATTERN.test(line)) {
-			out.push(styleLine(DIM, line))
-			return
-		}
-		if (line.trimStart().startsWith('>')) {
-			out.push(styleLine(GREEN, line))
-			return
-		}
-		if (line.trimStart().startsWith('|')) {
-			out.push(styleInline(line, { dimPipes: true }))
-			return
-		}
-		const listMatch = line.match(LIST_MARKER_PATTERN)
-		if (listMatch) {
-			out.push(`${listMatch[1]}${YELLOW}${listMatch[2]}${RESET}${listMatch[3]}${styleInline(listMatch[4] ?? '')}`)
-			return
-		}
-		out.push(styleInline(line))
-	})
-
-	return out.join('\n')
-}
-
-/** Strip the escape sequences this module emits; used to verify lossless styling. */
-export function stripAnsi(text: string): string {
-	// Only SGR sequences are emitted by this module.
-	// biome-ignore lint/suspicious/noControlCharactersInRegex: ANSI escapes are control characters by definition.
-	return text.replace(/\x1b\[[0-9;]*m/g, '')
-}

package/src/Mcp/ExpandDocs.ts

@@ -1,62 +0,0 @@
-import { McpServer } from '@effect/ai'
-import { Effect, Layer, String } from 'effect'
-import { ConfigManager } from '../Config.js'
-
-/**
- * These resources are read by an agent that will follow their links, so every
- * URL must resolve to the stack this CLI is configured against — production by
- * default, or whatever `EXPAND_APP_URL` names for local and self-hosted setups.
- */
-export function makeAgentSetupPrompt(appUrl: string): string {
-	return `Read ${new URL('/start.md', appUrl).toString()} and set up Expand. Fetch it as raw text with curl — a summarizing web-fetch tool drops the exact commands.`
-}
-
-/**
- * Points at the hosted guide instead of restating it. A local copy of the setup
- * procedure drifts silently the moment the commands change, and this resource
- * is read by an agent that can fetch the current one itself.
- */
-export function makeStartGuideMarkdown(appUrl: string): string {
-	return String.stripMargin(`
-		|# Expand Start Guide
-		|
-		|The setup procedure is served as a single document. Fetch it and follow it:
-		|
-		|${new URL('/start.md', appUrl).toString()}
-		|
-		|## Agent Setup Prompt
-		|
-		|${makeAgentSetupPrompt(appUrl)}
-		|`)
-}
-
-export function makeAboutMarkdown(appUrl: string): string {
-	return String.stripMargin(`
-		|# expand.ai
-		|
-		|- Website: ${appUrl}
-		|- Quickstart: ${new URL('/docs', appUrl).toString()}
-		|- Dashboard: ${new URL('/dashboard', appUrl).toString()}
-		|`)
-}
-
-const appUrl = Effect.gen(function* () {
-	const configManager = yield* ConfigManager
-	return yield* configManager.getAppUrl()
-})
-
-export const ExpandDocs = McpServer.resource({
-	uri: 'expand://about',
-	name: 'About expand.ai',
-	description: 'Key links for the expand.ai platform',
-	content: Effect.map(appUrl, makeAboutMarkdown),
-})
-
-export const ExpandStartDocs = McpServer.resource({
-	uri: 'expand://start',
-	name: 'Expand Start Guide',
-	description: 'Where to find the Expand agent setup guide, and the prompt that runs it',
-	content: Effect.map(appUrl, makeStartGuideMarkdown),
-})
-
-export const ExpandDocsLayer = Layer.mergeAll(ExpandDocs, ExpandStartDocs).pipe(Layer.provide(ConfigManager.Default))

package/src/Mcp/RequestHeaders.ts

@@ -1,16 +0,0 @@
-import { Context, Layer } from 'effect'
-
-/**
- * Per-request HTTP headers (lowercase keys per WHATWG Headers).
- *
- * Consumers should read this via `Effect.serviceOption(CurrentRequestHeaders)`
- * so the requirement does not leak into their `R`. The API's MCP route
- * overlays a fresh `Context.make` per request; the stdio CLI path leaves
- * the option as `none`.
- */
-export class CurrentRequestHeaders extends Context.Tag('@expandai/cli/Mcp/RequestHeaders/CurrentRequestHeaders')<
-	CurrentRequestHeaders,
-	Record<string, string>
->() {
-	static readonly Default = Layer.succeed(this, {})
-}

package/src/Mcp/Server.ts

@@ -1,15 +0,0 @@
-import { Layer } from 'effect'
-import { SERVER_KEY } from '../Install/Domain.js'
-import { CLI_VERSION } from '../Version.js'
-import { ExpandDocsLayer } from './ExpandDocs.js'
-import { ExpandToolKit } from './Toolkit.js'
-
-export { CurrentRequestHeaders } from './RequestHeaders.js'
-
-export const ServerInfo = {
-	name: SERVER_KEY,
-	version: CLI_VERSION,
-} as const
-
-export const makeServerLayer = (options: { readonly includeDocs?: boolean } = {}) =>
-	options.includeDocs ? Layer.mergeAll(ExpandToolKit, ExpandDocsLayer) : ExpandToolKit