@xopcai/xopc 0.0.105 → 0.0.107

package/dist/src/cli/commands/extension-create.js

@@ -0,0 +1,165 @@
+import { PACKAGE_VERSION, init_package_version } from "../../package-version.js";
+import { colors } from "../utils/colors.js";
+import { join, resolve } from "node:path";
+import { existsSync, mkdirSync, writeFileSync } from "node:fs";
+import { Command } from "commander";
+//#region src/cli/commands/extension-create.ts
+init_package_version();
+const TEMPLATE_TYPES = [
+	"tool",
+	"ui",
+	"provider",
+	"channel"
+];
+function toPackageName(name) {
+	return name.trim().toLowerCase().replace(/[^a-z0-9._-]+/g, "-").replace(/^-+|-+$/g, "");
+}
+function writeJson(path, value) {
+	writeFileSync(path, `${JSON.stringify(value, null, 2)}\n`);
+}
+function basePackageJson(id, template) {
+	const scripts = {
+		build: template === "ui" ? "tsc -p tsconfig.json && npm run build:ui" : "tsc -p tsconfig.json",
+		prepack: "npm run build"
+	};
+	if (template === "ui") scripts["build:ui"] = "node scripts/build-ui.mjs";
+	const devDependencies = {
+		"@xopcai/xopc": `^${PACKAGE_VERSION}`,
+		typescript: "^6.0.0"
+	};
+	if (template === "ui") {
+		devDependencies["@xopcai/extension-ui-sdk"] = `^${PACKAGE_VERSION}`;
+		devDependencies.esbuild = "^0.28.1";
+	}
+	return {
+		name: `xopc-extension-${id}`,
+		version: "0.1.0",
+		type: "module",
+		main: "dist/index.js",
+		files: [
+			"dist",
+			"ui",
+			"xopc.extension.json",
+			"README.md",
+			"LICENSE"
+		],
+		keywords: ["xopc", "xopc-extension"],
+		license: "MIT",
+		scripts,
+		devDependencies,
+		peerDependencies: { "@xopcai/xopc": `>=${PACKAGE_VERSION} <1.0.0` },
+		peerDependenciesMeta: { "@xopcai/xopc": { optional: true } }
+	};
+}
+function manifestFor(id, template) {
+	const base = {
+		id,
+		name: id.split("-").map((s) => s[0]?.toUpperCase() + s.slice(1)).join(" "),
+		description: `xopc ${template} extension`,
+		version: "0.1.0",
+		kind: template === "provider" ? "provider" : template === "channel" ? "channel" : template === "tool" ? "tool" : "utility",
+		main: "dist/index.js",
+		engines: { xopc: `>=${PACKAGE_VERSION} <1.0.0` }
+	};
+	if (template === "tool") base.contracts = { tools: [`${id.replace(/-/g, "_")}_echo`] };
+	else if (template === "provider") {
+		base.providers = [id];
+		base.contracts = { providers: [id] };
+	} else if (template === "channel") {
+		base.channels = [id];
+		base.contracts = { channels: [id] };
+		base.activation = { onChannels: [id] };
+		base.channelContributions = { [id]: {
+			label: base.name,
+			description: `Channel integration for ${base.name}`,
+			configPath: `channels.${id}`,
+			capabilities: {
+				multiAccount: false,
+				streaming: false,
+				media: false
+			},
+			configSchema: {
+				type: "object",
+				additionalProperties: true
+			}
+		} };
+	} else {
+		base.contracts = {};
+		base.ui = {
+			main: "ui/panel.html",
+			permissions: ["theme"],
+			contributions: { pages: [{
+				id: `${id}.page`,
+				title: base.name,
+				path: id,
+				entrypoint: "ui/panel.html",
+				showInNav: true
+			}] }
+		};
+	}
+	return base;
+}
+function buildUiScriptSource() {
+	return `import { build } from 'esbuild';\n\nawait build({\n  entryPoints: ['ui/panel-entry.ts'],\n  outfile: 'ui/panel.bundle.js',\n  bundle: true,\n  format: 'esm',\n  platform: 'browser',\n  target: ['es2022'],\n  sourcemap: false,\n});\n`;
+}
+function uiPanelEntrySource(id) {
+	return `import { createExtensionClient } from '@xopcai/extension-ui-sdk';\n\nconst root = document.getElementById('root');\nconst client = createExtensionClient();\n\nasync function main() {\n  await client.whenReady();\n  const theme = await client.theme.getTheme();\n  if (root) {\n    root.innerHTML = \`<main style="font-family: system-ui; padding: 16px">\n      <h1>${id}</h1>\n      <p>Theme mode: \${theme.mode}</p>\n      <button id="notify">Show notification</button>\n    </main>\`;\n    document.getElementById('notify')?.addEventListener('click', () => {\n      void client.ui.showNotification({ type: 'info', message: '${id} is ready' });\n    });\n  }\n}\n\nvoid main();\n`;
+}
+function sourceFor(id, template) {
+	const toolName = `${id.replace(/-/g, "_")}_echo`;
+	if (template === "provider") return `import type { ExtensionApi } from '@xopcai/xopc/extension-sdk';\n\nexport default function register(api: ExtensionApi) {\n  api.registerProvider({\n    id: '${id}',\n    name: '${id}',\n    models: [],\n    createStream: async function* () {\n      yield { type: 'text', text: 'Provider template: implement createStream().' };\n    },\n  } as any);\n}\n`;
+	if (template === "ui") return `import type { ExtensionApi } from '@xopcai/xopc/extension-sdk';\n\nexport default function register(api: ExtensionApi) {\n  api.logger.info('${id} UI extension loaded');\n}\n`;
+	if (template === "channel") return `import type { ExtensionApi } from '@xopcai/xopc/extension-sdk';\nimport type { ChannelPlugin } from '@xopcai/xopc/extension-sdk/channel';\n\nconst plugin: ChannelPlugin = {\n  id: '${id}' as any,\n  meta: { id: '${id}' as any, name: '${id}', description: '${id} channel' } as any,\n  capabilities: { inbound: true, outbound: true } as any,\n  async init() {},\n  async start() {},\n  async stop() {},\n  config: {\n    resolveAccounts() { return []; },\n  } as any,\n};\n\nexport default function register(api: ExtensionApi) {\n  api.registerChannel({ plugin });\n}\n`;
+	return `import type { ExtensionApi } from '@xopcai/xopc/extension-sdk';\n\nexport default function register(api: ExtensionApi) {\n  api.registerTool({\n    name: '${toolName}',\n    description: 'Echo input text',\n    parameters: {\n      type: 'object',\n      properties: { text: { type: 'string' } },\n      required: ['text'],\n    },\n    async execute(_toolCallId, params) {\n      return { content: [{ type: 'text', text: String((params as any).text) }] };\n    },\n  });\n}\n`;
+}
+function createExtensionCreateCommand() {
+	return new Command("create").description("Create a new independent extension package").argument("<name>", "Extension id / package suffix").option("--template <type>", `Template: ${TEMPLATE_TYPES.join(", ")}`, "tool").option("--dir <path>", "Output directory (default: ./<name>)").action((name, opts) => {
+		const id = toPackageName(name);
+		if (!id) {
+			console.error(colors.red("error:"), "Invalid extension name");
+			process.exit(1);
+		}
+		const template = opts.template;
+		if (!TEMPLATE_TYPES.includes(template)) {
+			console.error(colors.red("error:"), `Unknown template: ${opts.template}`);
+			process.exit(1);
+		}
+		const root = resolve(opts.dir?.trim() || id);
+		if (existsSync(root)) {
+			console.error(colors.red("error:"), `Directory already exists: ${root}`);
+			process.exit(1);
+		}
+		mkdirSync(join(root, "src"), { recursive: true });
+		writeJson(join(root, "package.json"), basePackageJson(id, template));
+		writeJson(join(root, "xopc.extension.json"), manifestFor(id, template));
+		writeJson(join(root, "tsconfig.json"), {
+			compilerOptions: {
+				target: "ES2022",
+				module: "NodeNext",
+				moduleResolution: "NodeNext",
+				declaration: true,
+				outDir: "dist",
+				rootDir: "src",
+				strict: true,
+				skipLibCheck: true
+			},
+			include: ["src/**/*.ts"]
+		});
+		writeFileSync(join(root, "src", "index.ts"), sourceFor(id, template));
+		if (template === "ui") {
+			mkdirSync(join(root, "ui"), { recursive: true });
+			mkdirSync(join(root, "scripts"), { recursive: true });
+			writeFileSync(join(root, "ui", "panel.html"), "<!doctype html><html><body><div id=\"root\"></div><script type=\"module\" src=\"./panel.bundle.js\"><\/script></body></html>\n");
+			writeFileSync(join(root, "ui", "panel-entry.ts"), uiPanelEntrySource(id));
+			writeFileSync(join(root, "scripts", "build-ui.mjs"), buildUiScriptSource());
+		}
+		writeFileSync(join(root, "README.md"), `# ${id}\n\nGenerated xopc extension.\n`);
+		writeFileSync(join(root, "LICENSE"), "MIT\n");
+		console.log(colors.green("✓"), `Created extension package at ${root}`);
+		console.log(colors.cyan("Next:"), `cd ${root} && npm install && npm run build && xopc extensions pack . --dry-run`);
+	});
+}
+//#endregion
+export { createExtensionCreateCommand };
+
+//# sourceMappingURL=extension-create.js.map

package/dist/src/cli/commands/extension-create.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"extension-create.js","names":[],"sources":["../../../../src/cli/commands/extension-create.ts"],"sourcesContent":["import { existsSync, mkdirSync, writeFileSync } from 'node:fs';\nimport { join, resolve } from 'node:path';\n\nimport { Command } from 'commander';\n\nimport { PACKAGE_VERSION } from '../../package-version.js';\nimport { colors } from '../utils/colors.js';\n\nconst TEMPLATE_TYPES = ['tool', 'ui', 'provider', 'channel'] as const;\ntype TemplateType = (typeof TEMPLATE_TYPES)[number];\n\nfunction toPackageName(name: string): string {\n  return name.trim().toLowerCase().replace(/[^a-z0-9._-]+/g, '-').replace(/^-+|-+$/g, '');\n}\n\nfunction writeJson(path: string, value: unknown): void {\n  writeFileSync(path, `${JSON.stringify(value, null, 2)}\\n`);\n}\n\nfunction basePackageJson(id: string, template: TemplateType): Record<string, unknown> {\n  const scripts: Record<string, string> = {\n    build: template === 'ui' ? 'tsc -p tsconfig.json && npm run build:ui' : 'tsc -p tsconfig.json',\n    prepack: 'npm run build',\n  };\n  if (template === 'ui') scripts['build:ui'] = 'node scripts/build-ui.mjs';\n  const devDependencies: Record<string, string> = {\n    '@xopcai/xopc': `^${PACKAGE_VERSION}`,\n    typescript: '^6.0.0',\n  };\n  if (template === 'ui') {\n    devDependencies['@xopcai/extension-ui-sdk'] = `^${PACKAGE_VERSION}`;\n    devDependencies.esbuild = '^0.28.1';\n  }\n  return {\n    name: `xopc-extension-${id}`,\n    version: '0.1.0',\n    type: 'module',\n    main: 'dist/index.js',\n    files: ['dist', 'ui', 'xopc.extension.json', 'README.md', 'LICENSE'],\n    keywords: ['xopc', 'xopc-extension'],\n    license: 'MIT',\n    scripts,\n    devDependencies,\n    peerDependencies: {\n      '@xopcai/xopc': `>=${PACKAGE_VERSION} <1.0.0`,\n    },\n    peerDependenciesMeta: {\n      '@xopcai/xopc': { optional: true },\n    },\n  };\n}\n\nfunction manifestFor(id: string, template: TemplateType): Record<string, unknown> {\n  const base: Record<string, unknown> = {\n    id,\n    name: id.split('-').map((s) => s[0]?.toUpperCase() + s.slice(1)).join(' '),\n    description: `xopc ${template} extension`,\n    version: '0.1.0',\n    kind: template === 'provider' ? 'provider' : template === 'channel' ? 'channel' : template === 'tool' ? 'tool' : 'utility',\n    main: 'dist/index.js',\n    engines: { xopc: `>=${PACKAGE_VERSION} <1.0.0` },\n  };\n  if (template === 'tool') {\n    base.contracts = { tools: [`${id.replace(/-/g, '_')}_echo`] };\n  } else if (template === 'provider') {\n    base.providers = [id];\n    base.contracts = { providers: [id] };\n  } else if (template === 'channel') {\n    base.channels = [id];\n    base.contracts = { channels: [id] };\n    base.activation = { onChannels: [id] };\n    base.channelContributions = {\n      [id]: {\n        label: base.name,\n        description: `Channel integration for ${base.name}`,\n        configPath: `channels.${id}`,\n        capabilities: { multiAccount: false, streaming: false, media: false },\n        configSchema: { type: 'object', additionalProperties: true },\n      },\n    };\n  } else {\n    base.contracts = {};\n    base.ui = {\n      main: 'ui/panel.html',\n      permissions: ['theme'],\n      contributions: {\n        pages: [{ id: `${id}.page`, title: base.name, path: id, entrypoint: 'ui/panel.html', showInNav: true }],\n      },\n    };\n  }\n  return base;\n}\n\nfunction buildUiScriptSource(): string {\n  return `import { build } from 'esbuild';\\n\\nawait build({\\n  entryPoints: ['ui/panel-entry.ts'],\\n  outfile: 'ui/panel.bundle.js',\\n  bundle: true,\\n  format: 'esm',\\n  platform: 'browser',\\n  target: ['es2022'],\\n  sourcemap: false,\\n});\\n`;\n}\n\nfunction uiPanelEntrySource(id: string): string {\n  return `import { createExtensionClient } from '@xopcai/extension-ui-sdk';\\n\\nconst root = document.getElementById('root');\\nconst client = createExtensionClient();\\n\\nasync function main() {\\n  await client.whenReady();\\n  const theme = await client.theme.getTheme();\\n  if (root) {\\n    root.innerHTML = \\`<main style=\"font-family: system-ui; padding: 16px\">\\n      <h1>${id}</h1>\\n      <p>Theme mode: \\${theme.mode}</p>\\n      <button id=\"notify\">Show notification</button>\\n    </main>\\`;\\n    document.getElementById('notify')?.addEventListener('click', () => {\\n      void client.ui.showNotification({ type: 'info', message: '${id} is ready' });\\n    });\\n  }\\n}\\n\\nvoid main();\\n`;\n}\n\nfunction sourceFor(id: string, template: TemplateType): string {\n  const toolName = `${id.replace(/-/g, '_')}_echo`;\n  if (template === 'provider') {\n    return `import type { ExtensionApi } from '@xopcai/xopc/extension-sdk';\\n\\nexport default function register(api: ExtensionApi) {\\n  api.registerProvider({\\n    id: '${id}',\\n    name: '${id}',\\n    models: [],\\n    createStream: async function* () {\\n      yield { type: 'text', text: 'Provider template: implement createStream().' };\\n    },\\n  } as any);\\n}\\n`;\n  }\n  if (template === 'ui') {\n    return `import type { ExtensionApi } from '@xopcai/xopc/extension-sdk';\\n\\nexport default function register(api: ExtensionApi) {\\n  api.logger.info('${id} UI extension loaded');\\n}\\n`;\n  }\n  if (template === 'channel') {\n    return `import type { ExtensionApi } from '@xopcai/xopc/extension-sdk';\\nimport type { ChannelPlugin } from '@xopcai/xopc/extension-sdk/channel';\\n\\nconst plugin: ChannelPlugin = {\\n  id: '${id}' as any,\\n  meta: { id: '${id}' as any, name: '${id}', description: '${id} channel' } as any,\\n  capabilities: { inbound: true, outbound: true } as any,\\n  async init() {},\\n  async start() {},\\n  async stop() {},\\n  config: {\\n    resolveAccounts() { return []; },\\n  } as any,\\n};\\n\\nexport default function register(api: ExtensionApi) {\\n  api.registerChannel({ plugin });\\n}\\n`;\n  }\n  return `import type { ExtensionApi } from '@xopcai/xopc/extension-sdk';\\n\\nexport default function register(api: ExtensionApi) {\\n  api.registerTool({\\n    name: '${toolName}',\\n    description: 'Echo input text',\\n    parameters: {\\n      type: 'object',\\n      properties: { text: { type: 'string' } },\\n      required: ['text'],\\n    },\\n    async execute(_toolCallId, params) {\\n      return { content: [{ type: 'text', text: String((params as any).text) }] };\\n    },\\n  });\\n}\\n`;\n}\n\nexport function createExtensionCreateCommand(): Command {\n  return new Command('create')\n    .description('Create a new independent extension package')\n    .argument('<name>', 'Extension id / package suffix')\n    .option('--template <type>', `Template: ${TEMPLATE_TYPES.join(', ')}`, 'tool')\n    .option('--dir <path>', 'Output directory (default: ./<name>)')\n    .action((name: string, opts: { template: string; dir?: string }) => {\n      const id = toPackageName(name);\n      if (!id) {\n        console.error(colors.red('error:'), 'Invalid extension name');\n        process.exit(1);\n      }\n      const template = opts.template as TemplateType;\n      if (!TEMPLATE_TYPES.includes(template)) {\n        console.error(colors.red('error:'), `Unknown template: ${opts.template}`);\n        process.exit(1);\n      }\n      const root = resolve(opts.dir?.trim() || id);\n      if (existsSync(root)) {\n        console.error(colors.red('error:'), `Directory already exists: ${root}`);\n        process.exit(1);\n      }\n      mkdirSync(join(root, 'src'), { recursive: true });\n      writeJson(join(root, 'package.json'), basePackageJson(id, template));\n      writeJson(join(root, 'xopc.extension.json'), manifestFor(id, template));\n      writeJson(join(root, 'tsconfig.json'), {\n        compilerOptions: {\n          target: 'ES2022',\n          module: 'NodeNext',\n          moduleResolution: 'NodeNext',\n          declaration: true,\n          outDir: 'dist',\n          rootDir: 'src',\n          strict: true,\n          skipLibCheck: true,\n        },\n        include: ['src/**/*.ts'],\n      });\n      writeFileSync(join(root, 'src', 'index.ts'), sourceFor(id, template));\n      if (template === 'ui') {\n        mkdirSync(join(root, 'ui'), { recursive: true });\n        mkdirSync(join(root, 'scripts'), { recursive: true });\n        writeFileSync(join(root, 'ui', 'panel.html'), '<!doctype html><html><body><div id=\"root\"></div><script type=\"module\" src=\"./panel.bundle.js\"></script></body></html>\\n');\n        writeFileSync(join(root, 'ui', 'panel-entry.ts'), uiPanelEntrySource(id));\n        writeFileSync(join(root, 'scripts', 'build-ui.mjs'), buildUiScriptSource());\n      }\n      writeFileSync(join(root, 'README.md'), `# ${id}\\n\\nGenerated xopc extension.\\n`);\n      writeFileSync(join(root, 'LICENSE'), 'MIT\\n');\n      console.log(colors.green('✓'), `Created extension package at ${root}`);\n      console.log(colors.cyan('Next:'), `cd ${root} && npm install && npm run build && xopc extensions pack . --dry-run`);\n    });\n}\n"],"mappings":"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"}

package/dist/src/cli/commands/extension-dev.js

@@ -6,14 +6,13 @@ import { init_normalize_manifest, normalizeExtensionManifest } from "../../exten
 import { init_loader, loadConfig } from "../../config/loader.js";
 import { checkEngineCompatibility } from "../../extensions/engine-check.js";
 import { getContextWithOpts } from "../context.js";
-import { seedMainAgentProfileMarkdown } from "../../agent/context/workspace-seed.js";
 import { GatewayServer } from "../../gateway/server.js";
 import { runGatewayLoop } from "../../gateway/run-loop.js";
 import "../../gateway/index.js";
 import { colors } from "../utils/colors.js";
 import { initWorkspace } from "../utils/init-workspace.js";
-import { existsSync, mkdirSync, readFileSync, symlinkSync, unlinkSync, watch } from "node:fs";
 import { join, resolve } from "node:path";
+import { existsSync, mkdirSync, readFileSync, symlinkSync, unlinkSync, watch } from "node:fs";
 import { Command } from "commander";
 //#region src/cli/commands/extension-dev.ts
 init_loader();
@@ -40,7 +39,6 @@ async function ensureGatewayReady(configPath, workspacePath, gatewayPort) {
 		console.log(`   Config:    ${configPath}`);
 		console.log(`   Workspace: ${workspacePath}`);
 		console.log("");
-		seedMainAgentProfileMarkdown(result.config);
 	}
 }
 function loadAndValidateManifest(extensionDir) {

package/dist/src/cli/commands/extension-dev.js.map

@@ -1 +1 @@
-{"version":3,"file":"extension-dev.js","names":[],"sources":["../../../../src/cli/commands/extension-dev.ts"],"sourcesContent":["import {\n  existsSync,\n  mkdirSync,\n  readFileSync,\n  symlinkSync,\n  unlinkSync,\n  watch,\n  type FSWatcher,\n} from 'node:fs';\nimport { join, resolve } from 'node:path';\n\nimport { Command } from 'commander';\n\nimport { loadConfig } from '../../config/loader.js';\nimport { resolveConfigPath, resolveExtensionsDir } from '../../config/paths.js';\nimport { checkEngineCompatibility } from '../../extensions/engine-check.js';\nimport type { ExtensionManifest } from '../../extensions/types/index.js';\nimport { normalizeExtensionManifest } from '../../extensions/normalize-manifest.js';\nimport { GatewayServer } from '../../gateway/index.js';\nimport { runGatewayLoop } from '../../gateway/run-loop.js';\nimport { PACKAGE_VERSION } from '../../package-version.js';\nimport { createLogger } from '../../utils/logger.js';\nimport { colors } from '../utils/colors.js';\nimport { getContextWithOpts } from '../context.js';\nimport { initWorkspace } from '../utils/init-workspace.js';\nimport { seedMainAgentProfileMarkdown } from '../../agent/context/workspace-seed.js';\n\nconst log = createLogger('ExtensionDev');\nconst MANIFEST = 'xopc.extension.json';\n\nfunction isRecord(x: unknown): x is Record<string, unknown> {\n  return typeof x === 'object' && x !== null && !Array.isArray(x);\n}\n\nasync function ensureGatewayReady(\n  configPath: string,\n  workspacePath: string,\n  gatewayPort: number,\n): Promise<void> {\n  const result = await initWorkspace({\n    configPath,\n    workspacePath,\n    gatewayPort,\n  });\n\n  if (result.configCreated || result.workspaceCreated) {\n    console.log('');\n    console.log('👋 First-time setup before starting the gateway...');\n    console.log('');\n    console.log('✅ Setup complete.');\n    console.log(`   Config:    ${configPath}`);\n    console.log(`   Workspace: ${workspacePath}`);\n    console.log('');\n    seedMainAgentProfileMarkdown(result.config);\n  }\n}\n\nfunction loadAndValidateManifest(extensionDir: string): ExtensionManifest | null {\n  const manifestPath = join(extensionDir, MANIFEST);\n  if (!existsSync(manifestPath)) {\n    console.error(colors.red('error:'), `Missing ${MANIFEST} in ${extensionDir}`);\n    return null;\n  }\n  try {\n    const raw = JSON.parse(readFileSync(manifestPath, 'utf-8') as string) as unknown;\n    if (!isRecord(raw)) {\n      console.error(colors.red('error:'), 'Manifest must be a JSON object');\n      return null;\n    }\n    const manifest = normalizeExtensionManifest(raw);\n    if (!manifest.id?.trim()) {\n      console.error(colors.red('error:'), 'Manifest \"id\" is required');\n      return null;\n    }\n    if (manifest.engines?.xopc) {\n      const r = checkEngineCompatibility(PACKAGE_VERSION, manifest.engines.xopc);\n      if (r.parseWarning) {\n        console.log(\n          colors.yellow('warning:'),\n          r.reason ?? 'engines.xopc could not be fully parsed — continuing',\n        );\n      } else if (!r.compatible) {\n        console.log(\n          colors.yellow('warning:'),\n          r.reason ?? `engines.xopc may not match xopc ${PACKAGE_VERSION} — continuing`,\n        );\n      }\n    }\n    return manifest;\n  } catch (e) {\n    log.error({ err: e }, 'Failed to read manifest');\n    console.error(\n      colors.red('error:'),\n      e instanceof Error ? e.message : String(e),\n    );\n    return null;\n  }\n}\n\nfunction setupDevSymlink(extensionDir: string, extensionsDir: string, extensionId: string): string {\n  mkdirSync(extensionsDir, { recursive: true });\n  const symlinkPath = join(extensionsDir, extensionId);\n  if (existsSync(symlinkPath)) {\n    unlinkSync(symlinkPath);\n  }\n  symlinkSync(extensionDir, symlinkPath, 'dir');\n  return symlinkPath;\n}\n\nfunction cleanupSymlink(symlinkPath: string | null): void {\n  if (!symlinkPath) return;\n  try {\n    if (existsSync(symlinkPath)) {\n      unlinkSync(symlinkPath);\n    }\n  } catch (e) {\n    log.warn({ err: e, symlinkPath }, 'Failed to remove dev symlink');\n  }\n}\n\nfunction shouldIgnorePath(relativePath: string): boolean {\n  const parts = relativePath.split(/[/\\\\]/);\n  if (parts.some((p) => p === 'node_modules')) return true;\n  if (parts.some((p) => p.startsWith('.'))) return true;\n  return false;\n}\n\nexport function createExtensionDevCommand(): Command {\n  return new Command('dev')\n    .description('Symlink an extension into the workspace for live development (optional file watch + gateway)')\n    .argument('[dir]', 'Extension directory (default: current working directory)', '.')\n    .option('--port <number>', 'Gateway port', '18790')\n    .option('--bind <mode>', 'Gateway bind mode', 'loopback')\n    .option('--no-gateway', 'Do not start the gateway (symlink only)')\n    .option('--no-watch', 'Do not watch files for changes')\n    .action(\n      async (\n        dir: string,\n        options: { port: string; bind: string; gateway: boolean; watch: boolean },\n      ) => {\n        const extensionDir = resolve(dir || '.');\n        const manifest = loadAndValidateManifest(extensionDir);\n        if (!manifest) {\n          process.exit(1);\n        }\n\n        const ctx = getContextWithOpts();\n        loadConfig(ctx.configPath);\n        const extensionsDir = resolveExtensionsDir();\n        const symlinkPath = setupDevSymlink(extensionDir, extensionsDir, manifest.id);\n\n        console.log(\n          colors.green('✓'),\n          `Dev symlink: ${symlinkPath} → ${extensionDir}`,\n        );\n        console.log(\n          colors.cyan('Note:'),\n          'restart the gateway or trigger config hot-reload so the extension reload picks up changes.',\n        );\n\n        let debounce: ReturnType<typeof setTimeout> | null = null;\n        let watcher: FSWatcher | null = null;\n\n        if (options.watch) {\n          try {\n            watcher = watch(\n              extensionDir,\n              { recursive: true },\n              (_event, filename) => {\n                const rel = filename ? String(filename) : '';\n                if (rel && shouldIgnorePath(rel)) return;\n                if (debounce) clearTimeout(debounce);\n                debounce = setTimeout(() => {\n                  const label = rel || '(unknown)';\n                  if (/(^|[\\\\/])xopc\\.extension\\.json$/.test(rel) || rel === MANIFEST) {\n                    console.log(colors.cyan('[watch]'), `manifest: ${label}`);\n                  } else if (/\\.(html?|css|mjs|js|tsx?|jsx|json)$/i.test(label)) {\n                    if (/^ui[\\\\/]/.test(rel) || /[\\\\/]ui[\\\\/]/.test(label)) {\n                      console.log(colors.cyan('[watch]'), `ui: ${label}`);\n                    } else {\n                      console.log(colors.cyan('[watch]'), `source: ${label}`);\n                    }\n                  } else {\n                    console.log(colors.cyan('[watch]'), `changed: ${label}`);\n                  }\n                }, 300);\n              },\n            );\n          } catch (e) {\n            log.warn({ err: e }, 'fs.watch failed; continuing without watch');\n          }\n        }\n\n        let cleaned = false;\n        const cleanup = () => {\n          if (cleaned) return;\n          cleaned = true;\n          if (debounce) clearTimeout(debounce);\n          if (watcher) {\n            try {\n              watcher.close();\n            } catch (e) {\n              log.warn({ err: e }, 'watcher close failed');\n            }\n          }\n          cleanupSymlink(symlinkPath);\n        };\n\n        for (const sig of ['SIGINT', 'SIGTERM'] as const) {\n          process.on(sig, () => {\n            cleanup();\n            process.exit(0);\n          });\n        }\n\n        if (!options.gateway) {\n          if (options.watch) {\n            console.log(colors.cyan('Watching…'), 'Ctrl+C to stop and remove symlink');\n          } else {\n            console.log(\n              colors.cyan('Holding process…'),\n              'Ctrl+C to stop and remove symlink (no file watch)',\n            );\n          }\n          await new Promise(() => {\n            /* until SIGINT / SIGTERM */\n          });\n          return;\n        }\n\n        const port = parseInt(options.port, 10);\n        const bindModes = new Set(['auto', 'loopback', 'lan', 'tailnet', 'custom']);\n        const bindRaw = options.bind.trim().toLowerCase();\n        if (!bindModes.has(bindRaw)) {\n          console.error(colors.red('error:'), 'Invalid --bind mode');\n          cleanup();\n          process.exit(1);\n        }\n        const bind = bindRaw as import('../../config/schema.js').GatewayBindMode;\n        await ensureGatewayReady(ctx.configPath, ctx.workspacePath, port);\n        const cfg = loadConfig(ctx.configPath);\n        const { resolveGatewayListenPlan } = await import('../../gateway/listen.js');\n        const listenPlan = resolveGatewayListenPlan({ cfg, bindOverride: bind });\n\n        if (Number.isNaN(port)) {\n          console.error(colors.red('error:'), 'Invalid --port');\n          cleanup();\n          process.exit(1);\n        }\n\n        console.log('🚀 Starting gateway (extension dev)…');\n        console.log(`   Bind: ${bind} (${listenPlan.bindHost})`);\n        console.log(`   Port: ${port}`);\n        console.log('');\n\n        try {\n          await runGatewayLoop({\n            configPath: ctx.configPath || resolveConfigPath(),\n            port,\n            start: async () => {\n              const server = new GatewayServer({\n                bindHost: listenPlan.bindHost,\n                bind: listenPlan.bindMode,\n                customBindHost: listenPlan.customBindHost,\n                port,\n                token: cfg?.gateway?.auth?.token,\n                verbose: ctx.isVerbose,\n                configPath: ctx.configPath,\n                enableHotReload: true,\n              });\n              await server.start();\n              const displayHost = listenPlan.bindHost === '0.0.0.0' ? 'localhost' : listenPlan.bindHost;\n              const token = cfg?.gateway?.auth?.token;\n              console.log('✅ Gateway started');\n              console.log(`   URL: http://${displayHost}:${port}`);\n              if (token) {\n                console.log(\n                  `   Token: ${String(token).slice(0, 8)}...${String(token).slice(-8)}`,\n                );\n              }\n              console.log('');\n              return server;\n            },\n          });\n        } finally {\n          cleanup();\n        }\n      },\n    );\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;aAaoD;YAC4B;yBAGI;sBAGzB;aACN;AAMrD,MAAM,MAAM,aAAa,eAAe;AACxC,MAAM,WAAW;AAEjB,SAAS,SAAS,GAA0C;AAC1D,QAAO,OAAO,MAAM,YAAY,MAAM,QAAQ,CAAC,MAAM,QAAQ,EAAE;;AAGjE,eAAe,mBACb,YACA,eACA,aACe;CACf,MAAM,SAAS,MAAM,cAAc;EACjC;EACA;EACA;EACD,CAAC;AAEF,KAAI,OAAO,iBAAiB,OAAO,kBAAkB;AACnD,UAAQ,IAAI,GAAG;AACf,UAAQ,IAAI,qDAAqD;AACjE,UAAQ,IAAI,GAAG;AACf,UAAQ,IAAI,oBAAoB;AAChC,UAAQ,IAAI,iBAAiB,aAAa;AAC1C,UAAQ,IAAI,iBAAiB,gBAAgB;AAC7C,UAAQ,IAAI,GAAG;AACf,+BAA6B,OAAO,OAAO;;;AAI/C,SAAS,wBAAwB,cAAgD;CAC/E,MAAM,eAAe,KAAK,cAAc,SAAS;AACjD,KAAI,CAAC,WAAW,aAAa,EAAE;AAC7B,UAAQ,MAAM,OAAO,IAAI,SAAS,EAAE,WAAW,SAAS,MAAM,eAAe;AAC7E,SAAO;;AAET,KAAI;EACF,MAAM,MAAM,KAAK,MAAM,aAAa,cAAc,QAAQ,CAAW;AACrE,MAAI,CAAC,SAAS,IAAI,EAAE;AAClB,WAAQ,MAAM,OAAO,IAAI,SAAS,EAAE,iCAAiC;AACrE,UAAO;;EAET,MAAM,WAAW,2BAA2B,IAAI;AAChD,MAAI,CAAC,SAAS,IAAI,MAAM,EAAE;AACxB,WAAQ,MAAM,OAAO,IAAI,SAAS,EAAE,8BAA4B;AAChE,UAAO;;AAET,MAAI,SAAS,SAAS,MAAM;GAC1B,MAAM,IAAI,yBAAyB,iBAAiB,SAAS,QAAQ,KAAK;AAC1E,OAAI,EAAE,aACJ,SAAQ,IACN,OAAO,OAAO,WAAW,EACzB,EAAE,UAAU,sDACb;YACQ,CAAC,EAAE,WACZ,SAAQ,IACN,OAAO,OAAO,WAAW,EACzB,EAAE,UAAU,mCAAmC,gBAAgB,eAChE;;AAGL,SAAO;UACA,GAAG;AACV,MAAI,MAAM,EAAE,KAAK,GAAG,EAAE,0BAA0B;AAChD,UAAQ,MACN,OAAO,IAAI,SAAS,EACpB,aAAa,QAAQ,EAAE,UAAU,OAAO,EAAE,CAC3C;AACD,SAAO;;;AAIX,SAAS,gBAAgB,cAAsB,eAAuB,aAA6B;AACjG,WAAU,eAAe,EAAE,WAAW,MAAM,CAAC;CAC7C,MAAM,cAAc,KAAK,eAAe,YAAY;AACpD,KAAI,WAAW,YAAY,CACzB,YAAW,YAAY;AAEzB,aAAY,cAAc,aAAa,MAAM;AAC7C,QAAO;;AAGT,SAAS,eAAe,aAAkC;AACxD,KAAI,CAAC,YAAa;AAClB,KAAI;AACF,MAAI,WAAW,YAAY,CACzB,YAAW,YAAY;UAElB,GAAG;AACV,MAAI,KAAK;GAAE,KAAK;GAAG;GAAa,EAAE,+BAA+B;;;AAIrE,SAAS,iBAAiB,cAA+B;CACvD,MAAM,QAAQ,aAAa,MAAM,QAAQ;AACzC,KAAI,MAAM,MAAM,MAAM,MAAM,eAAe,CAAE,QAAO;AACpD,KAAI,MAAM,MAAM,MAAM,EAAE,WAAW,IAAI,CAAC,CAAE,QAAO;AACjD,QAAO;;AAGT,SAAgB,4BAAqC;AACnD,QAAO,IAAI,QAAQ,MAAM,CACtB,YAAY,+FAA+F,CAC3G,SAAS,SAAS,4DAA4D,IAAI,CAClF,OAAO,mBAAmB,gBAAgB,QAAQ,CAClD,OAAO,iBAAiB,qBAAqB,WAAW,CACxD,OAAO,gBAAgB,0CAA0C,CACjE,OAAO,cAAc,iCAAiC,CACtD,OACC,OACE,KACA,YACG;EACH,MAAM,eAAe,QAAQ,OAAO,IAAI;EACxC,MAAM,WAAW,wBAAwB,aAAa;AACtD,MAAI,CAAC,SACH,SAAQ,KAAK,EAAE;EAGjB,MAAM,MAAM,oBAAoB;AAChC,aAAW,IAAI,WAAW;EAE1B,MAAM,cAAc,gBAAgB,cADd,sBACyC,EAAE,SAAS,GAAG;AAE7E,UAAQ,IACN,OAAO,MAAM,IAAI,EACjB,gBAAgB,YAAY,KAAK,eAClC;AACD,UAAQ,IACN,OAAO,KAAK,QAAQ,EACpB,6FACD;EAED,IAAI,WAAiD;EACrD,IAAI,UAA4B;AAEhC,MAAI,QAAQ,MACV,KAAI;AACF,aAAU,MACR,cACA,EAAE,WAAW,MAAM,GAClB,QAAQ,aAAa;IACpB,MAAM,MAAM,WAAW,OAAO,SAAS,GAAG;AAC1C,QAAI,OAAO,iBAAiB,IAAI,CAAE;AAClC,QAAI,SAAU,cAAa,SAAS;AACpC,eAAW,iBAAiB;KAC1B,MAAM,QAAQ,OAAO;AACrB,SAAI,kCAAkC,KAAK,IAAI,IAAI,QAAQ,SACzD,SAAQ,IAAI,OAAO,KAAK,UAAU,EAAE,aAAa,QAAQ;cAChD,uCAAuC,KAAK,MAAM,CAC3D,KAAI,WAAW,KAAK,IAAI,IAAI,eAAe,KAAK,MAAM,CACpD,SAAQ,IAAI,OAAO,KAAK,UAAU,EAAE,OAAO,QAAQ;SAEnD,SAAQ,IAAI,OAAO,KAAK,UAAU,EAAE,WAAW,QAAQ;SAGzD,SAAQ,IAAI,OAAO,KAAK,UAAU,EAAE,YAAY,QAAQ;OAEzD,IAAI;KAEV;WACM,GAAG;AACV,OAAI,KAAK,EAAE,KAAK,GAAG,EAAE,4CAA4C;;EAIrE,IAAI,UAAU;EACd,MAAM,gBAAgB;AACpB,OAAI,QAAS;AACb,aAAU;AACV,OAAI,SAAU,cAAa,SAAS;AACpC,OAAI,QACF,KAAI;AACF,YAAQ,OAAO;YACR,GAAG;AACV,QAAI,KAAK,EAAE,KAAK,GAAG,EAAE,uBAAuB;;AAGhD,kBAAe,YAAY;;AAG7B,OAAK,MAAM,OAAO,CAAC,UAAU,UAAU,CACrC,SAAQ,GAAG,WAAW;AACpB,YAAS;AACT,WAAQ,KAAK,EAAE;IACf;AAGJ,MAAI,CAAC,QAAQ,SAAS;AACpB,OAAI,QAAQ,MACV,SAAQ,IAAI,OAAO,KAAK,YAAY,EAAE,oCAAoC;OAE1E,SAAQ,IACN,OAAO,KAAK,mBAAmB,EAC/B,oDACD;AAEH,SAAM,IAAI,cAAc,GAEtB;AACF;;EAGF,MAAM,OAAO,SAAS,QAAQ,MAAM,GAAG;EACvC,MAAM,YAAY,IAAI,IAAI;GAAC;GAAQ;GAAY;GAAO;GAAW;GAAS,CAAC;EAC3E,MAAM,UAAU,QAAQ,KAAK,MAAM,CAAC,aAAa;AACjD,MAAI,CAAC,UAAU,IAAI,QAAQ,EAAE;AAC3B,WAAQ,MAAM,OAAO,IAAI,SAAS,EAAE,sBAAsB;AAC1D,YAAS;AACT,WAAQ,KAAK,EAAE;;EAEjB,MAAM,OAAO;AACb,QAAM,mBAAmB,IAAI,YAAY,IAAI,eAAe,KAAK;EACjE,MAAM,MAAM,WAAW,IAAI,WAAW;EACtC,MAAM,EAAE,6BAA6B,MAAM,OAAO;EAClD,MAAM,aAAa,yBAAyB;GAAE;GAAK,cAAc;GAAM,CAAC;AAExE,MAAI,OAAO,MAAM,KAAK,EAAE;AACtB,WAAQ,MAAM,OAAO,IAAI,SAAS,EAAE,iBAAiB;AACrD,YAAS;AACT,WAAQ,KAAK,EAAE;;AAGjB,UAAQ,IAAI,uCAAuC;AACnD,UAAQ,IAAI,YAAY,KAAK,IAAI,WAAW,SAAS,GAAG;AACxD,UAAQ,IAAI,YAAY,OAAO;AAC/B,UAAQ,IAAI,GAAG;AAEf,MAAI;AACF,SAAM,eAAe;IACnB,YAAY,IAAI,cAAc,mBAAmB;IACjD;IACA,OAAO,YAAY;KACjB,MAAM,SAAS,IAAI,cAAc;MAC/B,UAAU,WAAW;MACrB,MAAM,WAAW;MACjB,gBAAgB,WAAW;MAC3B;MACA,OAAO,KAAK,SAAS,MAAM;MAC3B,SAAS,IAAI;MACb,YAAY,IAAI;MAChB,iBAAiB;MAClB,CAAC;AACF,WAAM,OAAO,OAAO;KACpB,MAAM,cAAc,WAAW,aAAa,YAAY,cAAc,WAAW;KACjF,MAAM,QAAQ,KAAK,SAAS,MAAM;AAClC,aAAQ,IAAI,oBAAoB;AAChC,aAAQ,IAAI,kBAAkB,YAAY,GAAG,OAAO;AACpD,SAAI,MACF,SAAQ,IACN,aAAa,OAAO,MAAM,CAAC,MAAM,GAAG,EAAE,CAAC,KAAK,OAAO,MAAM,CAAC,MAAM,GAAG,GACpE;AAEH,aAAQ,IAAI,GAAG;AACf,YAAO;;IAEV,CAAC;YACM;AACR,YAAS;;GAGd"}
+{"version":3,"file":"extension-dev.js","names":[],"sources":["../../../../src/cli/commands/extension-dev.ts"],"sourcesContent":["import {\n  existsSync,\n  mkdirSync,\n  readFileSync,\n  symlinkSync,\n  unlinkSync,\n  watch,\n  type FSWatcher,\n} from 'node:fs';\nimport { join, resolve } from 'node:path';\n\nimport { Command } from 'commander';\n\nimport { loadConfig } from '../../config/loader.js';\nimport { resolveConfigPath, resolveExtensionsDir } from '../../config/paths.js';\nimport { checkEngineCompatibility } from '../../extensions/engine-check.js';\nimport type { ExtensionManifest } from '../../extensions/types/index.js';\nimport { normalizeExtensionManifest } from '../../extensions/normalize-manifest.js';\nimport { GatewayServer } from '../../gateway/index.js';\nimport { runGatewayLoop } from '../../gateway/run-loop.js';\nimport { PACKAGE_VERSION } from '../../package-version.js';\nimport { createLogger } from '../../utils/logger.js';\nimport { colors } from '../utils/colors.js';\nimport { getContextWithOpts } from '../context.js';\nimport { initWorkspace } from '../utils/init-workspace.js';\n\nconst log = createLogger('ExtensionDev');\nconst MANIFEST = 'xopc.extension.json';\n\nfunction isRecord(x: unknown): x is Record<string, unknown> {\n  return typeof x === 'object' && x !== null && !Array.isArray(x);\n}\n\nasync function ensureGatewayReady(\n  configPath: string,\n  workspacePath: string,\n  gatewayPort: number,\n): Promise<void> {\n  const result = await initWorkspace({\n    configPath,\n    workspacePath,\n    gatewayPort,\n  });\n\n  if (result.configCreated || result.workspaceCreated) {\n    console.log('');\n    console.log('👋 First-time setup before starting the gateway...');\n    console.log('');\n    console.log('✅ Setup complete.');\n    console.log(`   Config:    ${configPath}`);\n    console.log(`   Workspace: ${workspacePath}`);\n    console.log('');\n  }\n}\n\nfunction loadAndValidateManifest(extensionDir: string): ExtensionManifest | null {\n  const manifestPath = join(extensionDir, MANIFEST);\n  if (!existsSync(manifestPath)) {\n    console.error(colors.red('error:'), `Missing ${MANIFEST} in ${extensionDir}`);\n    return null;\n  }\n  try {\n    const raw = JSON.parse(readFileSync(manifestPath, 'utf-8') as string) as unknown;\n    if (!isRecord(raw)) {\n      console.error(colors.red('error:'), 'Manifest must be a JSON object');\n      return null;\n    }\n    const manifest = normalizeExtensionManifest(raw);\n    if (!manifest.id?.trim()) {\n      console.error(colors.red('error:'), 'Manifest \"id\" is required');\n      return null;\n    }\n    if (manifest.engines?.xopc) {\n      const r = checkEngineCompatibility(PACKAGE_VERSION, manifest.engines.xopc);\n      if (r.parseWarning) {\n        console.log(\n          colors.yellow('warning:'),\n          r.reason ?? 'engines.xopc could not be fully parsed — continuing',\n        );\n      } else if (!r.compatible) {\n        console.log(\n          colors.yellow('warning:'),\n          r.reason ?? `engines.xopc may not match xopc ${PACKAGE_VERSION} — continuing`,\n        );\n      }\n    }\n    return manifest;\n  } catch (e) {\n    log.error({ err: e }, 'Failed to read manifest');\n    console.error(\n      colors.red('error:'),\n      e instanceof Error ? e.message : String(e),\n    );\n    return null;\n  }\n}\n\nfunction setupDevSymlink(extensionDir: string, extensionsDir: string, extensionId: string): string {\n  mkdirSync(extensionsDir, { recursive: true });\n  const symlinkPath = join(extensionsDir, extensionId);\n  if (existsSync(symlinkPath)) {\n    unlinkSync(symlinkPath);\n  }\n  symlinkSync(extensionDir, symlinkPath, 'dir');\n  return symlinkPath;\n}\n\nfunction cleanupSymlink(symlinkPath: string | null): void {\n  if (!symlinkPath) return;\n  try {\n    if (existsSync(symlinkPath)) {\n      unlinkSync(symlinkPath);\n    }\n  } catch (e) {\n    log.warn({ err: e, symlinkPath }, 'Failed to remove dev symlink');\n  }\n}\n\nfunction shouldIgnorePath(relativePath: string): boolean {\n  const parts = relativePath.split(/[/\\\\]/);\n  if (parts.some((p) => p === 'node_modules')) return true;\n  if (parts.some((p) => p.startsWith('.'))) return true;\n  return false;\n}\n\nexport function createExtensionDevCommand(): Command {\n  return new Command('dev')\n    .description('Symlink an extension into the workspace for live development (optional file watch + gateway)')\n    .argument('[dir]', 'Extension directory (default: current working directory)', '.')\n    .option('--port <number>', 'Gateway port', '18790')\n    .option('--bind <mode>', 'Gateway bind mode', 'loopback')\n    .option('--no-gateway', 'Do not start the gateway (symlink only)')\n    .option('--no-watch', 'Do not watch files for changes')\n    .action(\n      async (\n        dir: string,\n        options: { port: string; bind: string; gateway: boolean; watch: boolean },\n      ) => {\n        const extensionDir = resolve(dir || '.');\n        const manifest = loadAndValidateManifest(extensionDir);\n        if (!manifest) {\n          process.exit(1);\n        }\n\n        const ctx = getContextWithOpts();\n        loadConfig(ctx.configPath);\n        const extensionsDir = resolveExtensionsDir();\n        const symlinkPath = setupDevSymlink(extensionDir, extensionsDir, manifest.id);\n\n        console.log(\n          colors.green('✓'),\n          `Dev symlink: ${symlinkPath} → ${extensionDir}`,\n        );\n        console.log(\n          colors.cyan('Note:'),\n          'restart the gateway or trigger config hot-reload so the extension reload picks up changes.',\n        );\n\n        let debounce: ReturnType<typeof setTimeout> | null = null;\n        let watcher: FSWatcher | null = null;\n\n        if (options.watch) {\n          try {\n            watcher = watch(\n              extensionDir,\n              { recursive: true },\n              (_event, filename) => {\n                const rel = filename ? String(filename) : '';\n                if (rel && shouldIgnorePath(rel)) return;\n                if (debounce) clearTimeout(debounce);\n                debounce = setTimeout(() => {\n                  const label = rel || '(unknown)';\n                  if (/(^|[\\\\/])xopc\\.extension\\.json$/.test(rel) || rel === MANIFEST) {\n                    console.log(colors.cyan('[watch]'), `manifest: ${label}`);\n                  } else if (/\\.(html?|css|mjs|js|tsx?|jsx|json)$/i.test(label)) {\n                    if (/^ui[\\\\/]/.test(rel) || /[\\\\/]ui[\\\\/]/.test(label)) {\n                      console.log(colors.cyan('[watch]'), `ui: ${label}`);\n                    } else {\n                      console.log(colors.cyan('[watch]'), `source: ${label}`);\n                    }\n                  } else {\n                    console.log(colors.cyan('[watch]'), `changed: ${label}`);\n                  }\n                }, 300);\n              },\n            );\n          } catch (e) {\n            log.warn({ err: e }, 'fs.watch failed; continuing without watch');\n          }\n        }\n\n        let cleaned = false;\n        const cleanup = () => {\n          if (cleaned) return;\n          cleaned = true;\n          if (debounce) clearTimeout(debounce);\n          if (watcher) {\n            try {\n              watcher.close();\n            } catch (e) {\n              log.warn({ err: e }, 'watcher close failed');\n            }\n          }\n          cleanupSymlink(symlinkPath);\n        };\n\n        for (const sig of ['SIGINT', 'SIGTERM'] as const) {\n          process.on(sig, () => {\n            cleanup();\n            process.exit(0);\n          });\n        }\n\n        if (!options.gateway) {\n          if (options.watch) {\n            console.log(colors.cyan('Watching…'), 'Ctrl+C to stop and remove symlink');\n          } else {\n            console.log(\n              colors.cyan('Holding process…'),\n              'Ctrl+C to stop and remove symlink (no file watch)',\n            );\n          }\n          await new Promise(() => {\n            /* until SIGINT / SIGTERM */\n          });\n          return;\n        }\n\n        const port = parseInt(options.port, 10);\n        const bindModes = new Set(['auto', 'loopback', 'lan', 'tailnet', 'custom']);\n        const bindRaw = options.bind.trim().toLowerCase();\n        if (!bindModes.has(bindRaw)) {\n          console.error(colors.red('error:'), 'Invalid --bind mode');\n          cleanup();\n          process.exit(1);\n        }\n        const bind = bindRaw as import('../../config/schema.js').GatewayBindMode;\n        await ensureGatewayReady(ctx.configPath, ctx.workspacePath, port);\n        const cfg = loadConfig(ctx.configPath);\n        const { resolveGatewayListenPlan } = await import('../../gateway/listen.js');\n        const listenPlan = resolveGatewayListenPlan({ cfg, bindOverride: bind });\n\n        if (Number.isNaN(port)) {\n          console.error(colors.red('error:'), 'Invalid --port');\n          cleanup();\n          process.exit(1);\n        }\n\n        console.log('🚀 Starting gateway (extension dev)…');\n        console.log(`   Bind: ${bind} (${listenPlan.bindHost})`);\n        console.log(`   Port: ${port}`);\n        console.log('');\n\n        try {\n          await runGatewayLoop({\n            configPath: ctx.configPath || resolveConfigPath(),\n            port,\n            start: async () => {\n              const server = new GatewayServer({\n                bindHost: listenPlan.bindHost,\n                bind: listenPlan.bindMode,\n                customBindHost: listenPlan.customBindHost,\n                port,\n                token: cfg?.gateway?.auth?.token,\n                verbose: ctx.isVerbose,\n                configPath: ctx.configPath,\n                enableHotReload: true,\n              });\n              await server.start();\n              const displayHost = listenPlan.bindHost === '0.0.0.0' ? 'localhost' : listenPlan.bindHost;\n              const token = cfg?.gateway?.auth?.token;\n              console.log('✅ Gateway started');\n              console.log(`   URL: http://${displayHost}:${port}`);\n              if (token) {\n                console.log(\n                  `   Token: ${String(token).slice(0, 8)}...${String(token).slice(-8)}`,\n                );\n              }\n              console.log('');\n              return server;\n            },\n          });\n        } finally {\n          cleanup();\n        }\n      },\n    );\n}\n"],"mappings":"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"}

package/dist/src/cli/commands/extension-marketplace.js

@@ -1,33 +1,80 @@
 import { init_paths, resolveExtensionsDir } from "../../config/paths.js";
-import { init_normalize_manifest, normalizeExtensionManifest } from "../../extensions/normalize-manifest.js";
 import { init_loader, loadConfig } from "../../config/loader.js";
 import { getContextWithOpts } from "../context.js";
 import { getExtensionLockfileManager } from "../../extensions/lockfile.js";
-import { installExtensionFromStoreZip, installFromLocal, installFromNpm, peekExtensionIdFromStoreZip } from "../../extensions/install.js";
+import { installExtensionFromStoreZip, installFromLocal, installFromNpm, peekExtensionIdFromStoreZip, peekExtensionManifestFromStoreZip } from "../../extensions/install.js";
 import { fetchRegistry, findExtension, getExtensionMarketplaceStoreBaseUrl, listExtensions, searchExtensions } from "../../extensions/marketplace.js";
 import { downloadExtensionStoreZipBuffer, resolveExtensionZipDownloadUrl, resolveExtensionsStoreBaseUrl } from "../../agent/skills/marketplace/adapters/store/store-api-client.js";
 import { colors } from "../utils/colors.js";
-import { existsSync, readFileSync, rmSync, statSync } from "node:fs";
+import { validateExtensionPackageDirectory } from "./extension-pack.js";
 import { join, resolve } from "node:path";
+import { existsSync, readFileSync, rmSync, statSync } from "node:fs";
+import { createHash } from "node:crypto";
 import { execSync } from "node:child_process";
+import { confirm } from "@inquirer/prompts";
 import { Command } from "commander";
 import semver from "semver";
 //#region src/cli/commands/extension-marketplace.ts
 init_loader();
 init_paths();
-init_normalize_manifest();
 const MANIFEST = "xopc.extension.json";
-function isRecord(x) {
-	return typeof x === "object" && x !== null && !Array.isArray(x);
+function readJsonObject(path) {
+	try {
+		const raw = JSON.parse(readFileSync(path, "utf-8"));
+		return typeof raw === "object" && raw !== null && !Array.isArray(raw) ? raw : void 0;
+	} catch {
+		return;
+	}
 }
-function hasWorkspaceDeps(pkg) {
-	const deps = pkg.dependencies;
-	const dev = pkg.devDependencies;
-	const check = (d) => {
-		if (!isRecord(d)) return false;
-		return Object.values(d).some((v) => typeof v === "string" && v.startsWith("workspace:"));
+function readInstalledSnapshots(targetDir, extensionId) {
+	const root = join(targetDir, extensionId);
+	return {
+		manifest: readJsonObject(join(root, MANIFEST)),
+		packageJson: readJsonObject(join(root, "package.json"))
 	};
-	return check(deps) || check(dev);
+}
+function sha256Integrity(buffer) {
+	return `sha256-${createHash("sha256").update(buffer).digest("base64")}`;
+}
+function normalizeIntegrity(raw) {
+	const value = raw?.trim();
+	if (!value) return void 0;
+	if (value.startsWith("sha256-")) return value;
+	if (/^[a-f0-9]{64}$/i.test(value)) return `sha256-${Buffer.from(value, "hex").toString("base64")}`;
+	return value;
+}
+function printManifestSummary(params) {
+	const manifest = params.manifest;
+	console.log("");
+	console.log(colors.cyan("Extension install review"));
+	console.log(`  Source: ${params.source}`);
+	console.log(`  Package: ${params.packageName}${params.version ? `@${params.version}` : ""}`);
+	if (params.integrity) console.log(`  Integrity: ${params.integrity}`);
+	if (manifest) {
+		console.log(`  ID: ${String(manifest.id ?? "(unknown)")}`);
+		console.log(`  Name: ${String(manifest.name ?? manifest.id ?? "(unknown)")}`);
+		const engines = manifest.engines;
+		if (engines?.xopc) console.log(`  engines.xopc: ${String(engines.xopc)}`);
+		const permissions = manifest.permissions;
+		if (permissions) {
+			console.log("  Permissions:");
+			for (const [key, value] of Object.entries(permissions)) console.log(`    ${key}: ${Array.isArray(value) ? value.join(", ") : String(value)}`);
+		}
+		const contracts = manifest.contracts;
+		if (contracts) {
+			console.log("  Contracts:");
+			for (const [key, value] of Object.entries(contracts)) if (Array.isArray(value) && value.length > 0) console.log(`    ${key}: ${value.join(", ")}`);
+		}
+	}
+	console.log("");
+}
+async function confirmInstall(params) {
+	printManifestSummary(params);
+	if (params.yes || !process.stdin.isTTY) return true;
+	return await confirm({
+		message: "Install this extension?",
+		default: false
+	});
 }
 function parseNameAtVersion(raw) {
 	const t = raw.trim();
@@ -54,10 +101,6 @@ function looksLikeLocalPath(raw) {
 }
 /** xopc-store package names: lowercase letters, digits, hyphen (see xopc-store scan). */
 const STORE_NAME_RE = /^[a-z0-9-]{1,64}$/;
-function looksLikeStorePackageRef(raw) {
-	const { name } = parseNameAtVersion(raw);
-	return STORE_NAME_RE.test(name);
-}
 async function upsertNpmExtensionLock(lock, targetDir, result, spec) {
 	if (!result.extensionId) return;
 	const reg = await findExtension(result.extensionId);
@@ -73,14 +116,33 @@ async function upsertNpmExtensionLock(lock, targetDir, result, spec) {
 		name: result.extensionId,
 		version: ver,
 		resolved,
-		source: "npm"
+		source: "npm",
+		...readInstalledSnapshots(targetDir, result.extensionId)
 	});
 }
 async function installExtensionFromStoreWithLock(params) {
 	try {
-		const { downloadUrl, version } = await resolveExtensionZipDownloadUrl(params.storeBase, params.packageName, params.version);
+		const { downloadUrl, version, integrity: expectedIntegrityRaw } = await resolveExtensionZipDownloadUrl(params.storeBase, params.packageName, params.version);
 		console.log(colors.cyan("📦"), `Downloading ${params.packageName}@${version} from xopc-store (${params.storeBase})…`);
 		const buf = await downloadExtensionStoreZipBuffer(params.storeBase, downloadUrl);
+		const actualIntegrity = sha256Integrity(buf);
+		const expectedIntegrity = normalizeIntegrity(expectedIntegrityRaw);
+		if (expectedIntegrity && expectedIntegrity !== actualIntegrity) return {
+			ok: false,
+			error: `Extension artifact checksum mismatch: expected ${expectedIntegrity}, got ${actualIntegrity}`
+		};
+		const manifest = peekExtensionManifestFromStoreZip(buf);
+		if (!await confirmInstall({
+			source: "store",
+			packageName: params.packageName,
+			version,
+			integrity: actualIntegrity,
+			manifest,
+			yes: params.yes
+		})) return {
+			ok: false,
+			error: "Install cancelled"
+		};
 		if (params.force) {
 			const id = peekExtensionIdFromStoreZip(buf);
 			if (id && existsSync(join(params.targetDir, id))) rmSync(join(params.targetDir, id), {
@@ -97,7 +159,10 @@ async function installExtensionFromStoreWithLock(params) {
 			name: result.extensionId,
 			version,
 			resolved: params.packageName,
-			source: "store"
+			source: "store",
+			artifactUrl: downloadUrl,
+			integrity: actualIntegrity,
+			...readInstalledSnapshots(params.targetDir, result.extensionId)
 		});
 		return {
 			ok: true,
@@ -112,28 +177,21 @@ async function installExtensionFromStoreWithLock(params) {
 	}
 }
 function createExtensionInstallCommand() {
-	return new Command("install").description("Install extension from xopc-store (store.xopc.ai), npm, or a local directory into ~/.xopc/extensions").argument("<target>", "npm spec, path, store:id, or store-shaped id (npm is tried first; use --store / store: for store-only)").option("--store", "Install from xopc-store only (fail if not an extension package)", false).option("--npm", "Install from npm only", false).option("-f, --force", "Remove existing extension folder (manifest id) before store or local install", false).action(async (target, opts) => {
+	return new Command("install").description("Install extension from xopc-store (store.xopc.ai), npm, or a local directory into ~/.xopc/extensions").argument("<target>", "Explicit source spec: store:<id>, npm:<package>, or a local extension directory").option("-f, --force", "Remove existing extension folder (manifest id) before store or local install", false).option("-y, --yes", "Skip interactive install confirmation", false).action(async (target, opts) => {
 		const cfg = loadConfig(getContextWithOpts().configPath);
 		const targetDir = resolveExtensionsDir();
 		const lock = getExtensionLockfileManager();
 		let installTarget = target.trim();
 		const storeExplicit = /^store:/i.test(installTarget);
+		const npmExplicit = /^npm:/i.test(installTarget);
 		if (storeExplicit) installTarget = installTarget.replace(/^store:/i, "").trim();
+		else if (npmExplicit) installTarget = installTarget.replace(/^npm:/i, "").trim();
 		if (!installTarget) {
 			console.error(colors.red("error:"), "Missing target");
 			process.exit(1);
 		}
-		if (opts.store && opts.npm) {
-			console.error(colors.red("error:"), "Use only one of --store and --npm");
-			process.exit(1);
-		}
-		const storeOnly = opts.store || storeExplicit;
-		if (storeExplicit && opts.npm) {
-			console.error(colors.red("error:"), "Cannot combine store: prefix with --npm");
-			process.exit(1);
-		}
 		const storeBase = resolveExtensionsStoreBaseUrl(cfg);
-		if (storeOnly) {
+		if (storeExplicit) {
 			const { name: pkgName, version: ver } = parseNameAtVersion(installTarget);
 			if (!STORE_NAME_RE.test(pkgName)) {
 				console.error(colors.red("error:"), "Invalid store package name (lowercase letters, digits, hyphen only)");
@@ -145,7 +203,8 @@ function createExtensionInstallCommand() {
 				version: ver,
 				targetDir,
 				lock,
-				force: opts.force
+				force: opts.force,
+				yes: opts.yes
 			});
 			if (r.ok === false) {
 				console.error(colors.red("error:"), r.error);
@@ -154,7 +213,7 @@ function createExtensionInstallCommand() {
 			console.log(colors.green("✓"), `${r.extensionId}@${r.version} (store)`);
 			return;
 		}
-		if (opts.npm) {
+		if (npmExplicit) {
 			const spec = installTarget;
 			console.log(colors.cyan("📦"), `Installing from npm: ${spec}…`);
 			const result = await installFromNpm(spec, targetDir);
@@ -189,41 +248,8 @@ function createExtensionInstallCommand() {
 			console.log(colors.green("✓"), result.extensionId ?? "ok");
 			return;
 		}
-		if (looksLikeStorePackageRef(installTarget)) {
-			const spec = installTarget;
-			console.log(colors.cyan("📦"), `Trying npm: ${spec}…`);
-			const npmTry = await installFromNpm(spec, targetDir);
-			if (npmTry.ok) {
-				await upsertNpmExtensionLock(lock, targetDir, npmTry, spec);
-				console.log(colors.green("✓"), npmTry.extensionId ?? "ok", "(npm)");
-				return;
-			}
-			console.log(colors.yellow("npm:"), npmTry.error ?? "failed", "— trying xopc-store…");
-			const { name: pkgName, version: ver } = parseNameAtVersion(installTarget);
-			const r = await installExtensionFromStoreWithLock({
-				storeBase,
-				packageName: pkgName,
-				version: ver,
-				targetDir,
-				lock,
-				force: opts.force
-			});
-			if (r.ok === false) {
-				console.error(colors.red("error:"), r.error);
-				process.exit(1);
-			}
-			console.log(colors.green("✓"), `${r.extensionId}@${r.version} (store)`);
-			return;
-		}
-		const spec = installTarget;
-		console.log(colors.cyan("📦"), `Installing from npm: ${spec}…`);
-		const result = await installFromNpm(spec, targetDir);
-		if (!result.ok) {
-			console.error(colors.red("error:"), result.error ?? "install failed");
-			process.exit(1);
-		}
-		await upsertNpmExtensionLock(lock, targetDir, result, spec);
-		console.log(colors.green("✓"), result.extensionId ?? "ok", "(npm)");
+		console.error(colors.red("error:"), "Extension installs require an explicit source: store:<id>, npm:<package>, or a local directory path.");
+		process.exit(1);
 	});
 }
 function createExtensionSearchCommand() {
@@ -271,17 +297,13 @@ function createExtensionPublishCommand() {
 			console.error(colors.red("error:"), `Need ${MANIFEST} and package.json in ${root}`);
 			process.exit(1);
 		}
-		try {
-			if (hasWorkspaceDeps(JSON.parse(readFileSync(pkgPath, "utf-8")))) {
-				console.error(colors.red("error:"), "Remove workspace:* dependencies before publishing.");
-				process.exit(1);
-			}
-			if (!normalizeExtensionManifest(JSON.parse(readFileSync(manifestPath, "utf-8"))).id) {
-				console.error(colors.red("error:"), "Invalid manifest id");
-				process.exit(1);
-			}
-		} catch (e) {
-			console.error(colors.red("error:"), e instanceof Error ? e.message : String(e));
+		const validation = validateExtensionPackageDirectory(root);
+		for (const d of validation.diagnostics) {
+			const label = d.level === "error" ? colors.red("error") : d.level === "warning" ? colors.yellow("warning") : colors.cyan("info");
+			console.log(`${label}:`, d.message);
+		}
+		if (!validation.ok || !validation.manifest?.id) {
+			console.error(colors.red("error:"), "Package is not publishable as an independent extension.");
 			process.exit(1);
 		}
 		const args = ["publish", `--access=${opts.access}`];
@@ -326,7 +348,8 @@ function createExtensionUpdateCommand() {
 					storeBase,
 					packageName: pkgName,
 					targetDir,
-					lock
+					lock,
+					yes: true
 				});
 				if (r.ok === false) {
 					console.error(colors.red("error:"), r.error ?? id);
@@ -358,7 +381,8 @@ function createExtensionUpdateCommand() {
 				name: id,
 				version: entry.version,
 				resolved: spec,
-				source: "npm"
+				source: "npm",
+				...readInstalledSnapshots(targetDir, id)
 			});
 			console.log(colors.green("✓"), id);
 		}